diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index a4aabe895..8db65b824 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -44,6 +44,8 @@ jobs:
             "passenger-portal"
             "passenger-backoffice"
             "payment-api"
+            "synapse"
+            "element-web"
           )
 
           if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
@@ -85,6 +87,10 @@ jobs:
           echo "$CHANGED" | grep -q "^apps/edr-passenger-web/portal/"     && SERVICES+=("passenger-portal")
           echo "$CHANGED" | grep -q "^apps/edr-passenger-web/backoffice/" && SERVICES+=("passenger-backoffice")
           echo "$CHANGED" | grep -q "^apps/edr-payment-api/"              && SERVICES+=("payment-api")
+          # synapse / element-web have no per-service filter line: their only
+          # source is infrastructure/matrix/, already caught by GLOBAL_PATTERN
+          # above (which redeploys every service), so a dedicated line here
+          # would never fire.
 
           SERVICES=($(printf '%s\n' "${SERVICES[@]}" | sort -u))
 
@@ -120,7 +126,7 @@ jobs:
       - name: Resolve project and build env file
         run: |
           case "${{ matrix.service }}" in
-            freight-api|freight-portal|freight-backoffice|gps-tracker)
+            freight-api|freight-portal|freight-backoffice|gps-tracker|synapse|element-web)
               echo "PROJECT=edr-freight"                      >> "$GITHUB_ENV"
               echo "BUILD_ENV_FILE=freight-web.build.env"    >> "$GITHUB_ENV"
               ;;
diff --git a/.gitignore b/.gitignore
index 63784b865..8fa8bca90 100644
--- a/.gitignore
+++ b/.gitignore
@@ -53,3 +53,12 @@ RUNNING_LOCALLY.md
 # Generated per-shard compose file for the integration suite (it.mjs).
 integration/.it-shards.yaml
 
+# private keys / certificates (EIMS INSA credentials and anything like them) — never commit
+*.key
+*.pem
+*.pem.txt
+*.p12
+*.pfx
+*.crt
+secrets/
+certs/
diff --git a/CLAUDE.md b/CLAUDE.md
index b90d3b1dd..a20fbaee7 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,102 +1,362 @@
 # 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.
+
+**Looking for where something lives? Read [`docs/MAP.md`](docs/MAP.md) first.** It routes
+you to the right module or page without a repo-wide grep.
+
 ## Overview
 
-Monorepo for the Ethio Djibouti Railway (EDR) digital platform. Contains the Freight Management and Passenger Management applications, plus shared types, NestJS utilities, and React component libraries.
+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                                            | 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 |
+The two domains are **not built the same way**. Check which stack you are in before
+copying a pattern across:
 
-`edr-freight-web` and `edr-passenger-web` are grouping folders, not workspace packages. Each holds a `portal/` and `backoffice/` sub-app, both of which are independent pnpm workspace packages (declared in `pnpm-workspace.yaml`). The existing `pnpm dev:freight` / `pnpm dev:passenger` turbo filters (`@edr/freight-*` / `@edr/passenger-*`) cover all four web apps + their APIs.
+| App                            | Package name                | Stack                  | Default port |
+| ------------------------------ | --------------------------- | ---------------------- | ------------ |
+| `edr-freight-api`              | `@edr/freight-api`          | NestJS + **TypeORM**   | 3001 |
+| `edr-freight-web/portal`       | `@edr/freight-portal`       | React + **Vite**       | 5273 |
+| `edr-freight-web/backoffice`   | `@edr/freight-backoffice`   | React + **Vite**       | 5283 |
+| `edr-passenger-api`            | `@edr/passenger-api`        | NestJS + **Prisma**    | 4000 |
+| `edr-passenger-web/portal`     | `@edr/passenger-portal`     | **Next.js**            | 5174 |
+| `edr-passenger-web/backoffice` | `@edr/passenger-backoffice` | **Next.js**            | 5184 |
+| `edr-payment-api`              | `@edr/payment-api`          | NestJS + **TypeORM**   | 3003 |
+
+Those are the **fallbacks compiled into the code**, not what you will be running. Every
+port is overridden by `PORT` in the app's `.env` / `.env.development`; the freight vite
+apps read it in `vite.config.ts` (`Number(env.PORT) || 5273`). This machine is shared by
+the whole team and the low ports are contested — see the workspace root `CLAUDE.md` and
+`./wt ports` for who currently holds what.
+
+`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.
+
+`apps/edr-gps-tracker/` is a separate service with its own `.env.example`.
 
 ## Packages
 
-| Package                | Purpose                                                                            |
-| ---------------------- | ---------------------------------------------------------------------------------- |
-| `@edr/types`           | Shared TypeScript interfaces and enums                                             |
-| `@edr/api-common`      | Shared NestJS decorators, filters, interceptors, pipes, BaseEntity, BaseRepository |
-| `@edr/iam-seed`        | IAM baseline seeder for the apps sharing the `iam` schema (freight + passenger)     |
-| `@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                                                      |
+| Package                 | Location                      | Purpose                                                       |
+| ----------------------- | ----------------------------- | ------------------------------------------------------------- |
+| `@edr/types`            | `packages/types`              | Shared TypeScript interfaces and enums                        |
+| `@edr/api-common`       | `packages/api-common`         | NestJS decorators, filters, interceptors, pipes, BaseEntity, BaseRepository |
+| `@edr/ui-common`        | `packages/ui-common`          | Shared React components and theme                             |
+| `@edr/iam-seed`         | `packages/iam-seed`           | IAM baseline seeder for apps sharing the `iam` schema         |
+| `@edr/payment-providers`| `packages/payment-providers`  | Payment gateway integrations                                  |
+| `@edr/eslint-config`    | `packages/config/eslint-config`   | Shared ESLint configs (base/nestjs/react)                 |
+| `@edr/tsconfig`         | `packages/config/tsconfig`        | Shared TypeScript configs                                 |
+| `@edr/prettier-config`  | `packages/config/prettier-config` | Shared Prettier config                                    |
+
+The three `config/*` packages are nested one level deeper than the rest — `packages/config`
+itself is not a package.
+
+**`@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`   | Run only freight API + web         |
-| `pnpm dev:passenger` | Run only passenger API + web       |
-| `pnpm build`         | Build every package and app        |
-| `pnpm test`          | Run all tests                      |
-| `pnpm lint`          | Lint everything                    |
-| `pnpm type-check`    | Type-check every package           |
-| `pnpm format`        | Format all files with Prettier     |
+| 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 type-check`             | Type-check every package                  |
+| `pnpm format`                 | Format all files with Prettier            |
+| `pnpm lint`                   | **Does not work** — see below             |
 
-## Standards
+**`pnpm lint` fails.** `eslint` is not installed anywhere in the workspace, so
+`turbo run lint` dies with `eslint: not found` even though every package declares a
+`lint` script and `@edr/eslint-config` exists. Until someone adds the dependency,
+tsc's `noUnusedLocals` is the only working unused-code check. Do not claim a change is
+"lint clean".
 
-- **TypeScript strict mode** is enabled in every package and app.
-- **pnpm** is the only supported package manager — never run `npm install` or `yarn`.
-- **Conventional commits** are enforced via commitlint on every commit.
-- **NestJS modules** follow the 4-layer pattern: `module → controller → service → repository` (entities and DTOs live alongside).
+`pnpm format` uses bare `prettier`, which ignores `@edr/prettier-config` — it is wired to
+nothing. On the single-quoted passenger apps it will re-quote the whole file. Pass
+`--config` explicitly there.
+
+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.
+- IAM tables live in their own `iam` schema (`iam.users`, `iam.user_credentials`),
+  freight tables in `freight`.
+- `psql` is not installed on the dev machine. To query the database, use the `edr-db`
+  skill (below) or write a short Node script using `pg` 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 migrations.
 - **All entities** use UUID primary keys (`@PrimaryGeneratedColumn('uuid')`).
-- **All entities** have `createdAt`, `updatedAt`, `deletedAt` (soft delete) via `@edr/api-common`'s `BaseEntity`.
-- **All columns** use `snake_case` in the database (`@Column({ name: 'snake_case' })`); TypeScript properties use `camelCase`.
-- **Never use `synchronize: true`** in production database config. All schema changes go through TypeORM migrations.
-- **ESLint + Prettier** run on pre-commit via Husky + lint-staged.
-- **Services** never inject TypeORM `Repository<T>` directly — they inject the custom repository class.
-- **Controllers** never contain business logic.
+- **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.
 
-## Auth
+## Architecture
 
-Authentication is handled by an external package (`@edr/iamui-common` or equivalent) that will be integrated later. **Do not** implement any auth, login, logout, JWT verification, password hashing, or user management code in this repo.
+### NestJS module shape
 
-When auth integration is needed, use placeholder TODO comments:
+`module → controller → service → repository`, with `entities/` and `dto/` alongside.
+`docs/MAP.md` lists the ~60 freight modules grouped by domain.
 
-- `// @UseGuards(JwtAuthGuard) — TODO: integrate @edr/auth`
-- `// TODO: integrate @edr/auth — replace stub @CurrentUser with real one`
+### Data access — the real model
 
-The `@CurrentUser`, `@Roles`, and `@Public` decorators in `@edr/api-common` are bare metadata setters with no guard wiring — they exist so controllers can be annotated correctly without depending on auth infrastructure yet.
+There are two sanctioned ways to read and write, and you must pick the right one:
 
-## Port Assignments
+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.
 
-- `edr-freight-api`: 3001
-- `edr-freight-web/portal`: 5173
-- `edr-freight-web/backoffice`: 5183
-- `edr-passenger-api`: 3002
-- `edr-payment-api`: 3003
-- `edr-passenger-web/portal`: 5174
-- `edr-passenger-web/backoffice`: 5184
+Raw SQL is normal here, not a smell — the warehouse and scheduling modules are built on it.
+It carries one obligation:
 
-## Database Layout
+> **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*).
 
-- `postgres-freight` (port 5433): database `edr_freight` — freight API only.
-- `postgres-passenger` (port 5434): database `edr_passenger` — passenger API only.
-- `edr_payment` schema — lives in the same Postgres database as the domain system (whatever the passenger `DATABASE_URL` points at) but is owned exclusively by `apps/edr-payment-api`. Dedicated DB user, no cross-schema FKs, domain apps have no grants on it (see `docs/payment-service/`).
-- Each app owns its own DB. No cross-database joins; cross-domain data flows through API calls or message queues.
+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. **Freight and payment use TypeORM migrations; passenger uses Prisma**
+(`apps/edr-passenger-api/prisma/migrations`) — the rules below are about the TypeORM side.
+
+- `migrationsRun: false` — **migrations do NOT run on API boot.** They run as a separate
+  one-shot step, via the Dockerfile's `migration` build target (`docker build --target
+  migration`), with `migrationsTransactionMode: 'each'`.
+  - CI: `.github/workflows/deploy.yml` builds the `migration` image and runs it
+    (`docker run --rm --env-file ...`) *before* building/deploying the app image.
+  - e2e: `docker-compose.e2e.yaml`'s `freight-migration-e2e` service runs once and
+    `freight-api-e2e` depends on it (`condition: service_completed_successfully`).
+  - Local dev (`docker-compose.yaml`) has no equivalent migration service yet — run
+    migrations yourself before `docker compose up freight-api`, e.g.
+    `docker build --target migration -f apps/edr-freight-api/Dockerfile -t freight-migration .`
+    then `docker run --rm --env-file apps/edr-freight-api/.env freight-migration`. Don't
+    use `pnpm run migrate` for this — it runs via `ts-node`, which never writes compiled
+    output to `dist/`, and the freight migrations glob only matches `dist/migrations/*.js`.
+    It silently applies zero freight migrations while exiting 0.
+- Consequences you must design for:
+  - 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.
+  - `apps/edr-freight-api/src/config/database.config.ts`'s `iamEntities` array is a
+    hand-maintained list of `@tria-plc/iamapi-common` entity classes. The live app never
+    notices when it's stale (`autoLoadEntities: true` papers over gaps via IAM's own
+    `forFeature()` registrations), but the standalone migration `DataSource`
+    (`data-source.ts`, no `autoLoadEntities`) does not have that fallback — a missing
+    entity throws `Entity metadata for X#y was not found` at `initialize()`, before a
+    single migration runs. **Every `@tria-plc/iamapi-common` version bump is a candidate
+    for this to break again** — diff the package's entity classes against `iamEntities`
+    when bumping it.
+- **Give every migration a unique timestamp.** `apps/edr-freight-api/src/migrations` holds
+  39 files, and 8 timestamps are shared by two or more of them. TypeORM orders by timestamp
+  and breaks ties non-deterministically. Check before adding one:
+
+  ```bash
+  ls apps/edr-freight-api/src/migrations | grep -oE '^[0-9]+' | sort | uniq -d
+  ```
+
+  The prefix must be unused *and* higher than the newest recorded row. Note the
+  `freight.migrations` table has far more rows (~309) than this folder has files — most
+  come from `@tria-plc/iamapi-common`'s own migrations, which run from the same data source.
+- **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.
+- Login is freight-api's own `POST /api/auth/login` (SharedAuthModule from
+  `@tria-plc/api-common`). Every login call needs an **`x-client-app` header** —
+  `backoffice` for employees, `portal` for customers. Without it the API 403s with
+  "Missing or unrecognized x-client-app header". Browsers send it; curl must add 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 **freight** web apps use **Mantine v9** (`^9.3.0`). 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.
+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.
+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).
+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` has been red on `dev`, so a
+   fully green suite is not the bar — but confirm that for yourself rather than assuming it,
+   then run the specs covering what you touched and confirm you introduced no new failure.
+5. **Formatting is clean** for the files you touched. Git hooks do **not** run automatically
+   (see below), and `pnpm lint` does not work at all, so `noUnusedLocals` from the
+   type-check is your only unused-code signal.
+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 |
+| Login 403 from curl | "Missing or unrecognized x-client-app header" | Send `x-client-app: backoffice` or `portal` |
+| Copying a passenger pattern into freight | Passenger is Prisma + Next.js, freight is TypeORM + Vite | Check which stack you are in first |
+
+## 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/CLAUDE_NEW.md b/CLAUDE_NEW.md
deleted file mode 100644
index a99f64d0a..000000000
--- a/CLAUDE_NEW.md
+++ /dev/null
@@ -1,313 +0,0 @@
-# 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: false` — **migrations do NOT run on API boot.** They run as a separate
-  one-shot step, via the Dockerfile's `migration` build target (`docker build --target
-  migration`), with `migrationsTransactionMode: 'each'`.
-  - CI: `.github/workflows/deploy.yml` builds the `migration` image and runs it
-    (`docker run --rm --env-file ...`) *before* building/deploying the app image.
-  - e2e: `docker-compose.e2e.yaml`'s `freight-migration-e2e` service runs once and
-    `freight-api-e2e` depends on it (`condition: service_completed_successfully`).
-  - Local dev (`docker-compose.yaml`) has no equivalent migration service yet — run
-    migrations yourself before `docker compose up freight-api`, e.g.
-    `docker build --target migration -f apps/edr-freight-api/Dockerfile -t freight-migration .`
-    then `docker run --rm --env-file apps/edr-freight-api/.env freight-migration`. Don't
-    use `pnpm run migrate` for this — it runs via `ts-node`, which never writes compiled
-    output to `dist/`, and the freight migrations glob only matches `dist/migrations/*.js`.
-    It silently applies zero freight migrations while exiting 0.
-- Consequences you must design for:
-  - 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.
-  - `apps/edr-freight-api/src/config/database.config.ts`'s `iamEntities` array is a
-    hand-maintained list of `@tria-plc/iamapi-common` entity classes. The live app never
-    notices when it's stale (`autoLoadEntities: true` papers over gaps via IAM's own
-    `forFeature()` registrations), but the standalone migration `DataSource`
-    (`data-source.ts`, no `autoLoadEntities`) does not have that fallback — a missing
-    entity throws `Entity metadata for X#y was not found` at `initialize()`, before a
-    single migration runs. **Every `@tria-plc/iamapi-common` version bump is a candidate
-    for this to break again** — diff the package's entity classes against `iamEntities`
-    when bumping it.
-- **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/apps/edr-freight-api/.env.example b/apps/edr-freight-api/.env.example
index 96af26034..930c8f1ca 100644
--- a/apps/edr-freight-api/.env.example
+++ b/apps/edr-freight-api/.env.example
@@ -1,4 +1,10 @@
 # Copy to .env for local/docker compose (not committed).
+
+# Set to "dev" or "staging" to bypass OTP (fixed code 000000 also accepted),
+# payment (invoice auto-marked paid on initiate, no gateway call) and Fayda
+# (canned verified profile, no eSignet call). Leave unset in production.
+ENV=
+
 PORT=3001
 # @tria-plc/auditlog's client interceptor stamps every AuditLog row's
 # `application` from this env var directly, bypassing MezgebModule.forRoot's
@@ -76,6 +82,12 @@ SEED_EDR_ORG=true
 SEED_FREIGHT_STAFF=true
 SEED_EXPORT_DJIBOUTI_INTERCHANGE_DEMO=false
 
+# Limits GET /staff/users to employees of this IAM organization (iam.organizations.key).
+# Unset = every employee. A key matching no organization returns no users.
+# Dev seed key: edr_freight
+# Production: ETHIO_DJIBOUTI_STANDARD_GAUGE_RAILWAY_SHARE_COMPANY_001
+FREIGHT_ORG_KEY=edr_freight
+
 # MinIO (used by @tria-plc/iamapi-common for file storage)
 MINIO_ENDPOINT=localhost
 MINIO_PORT=9000
@@ -126,3 +138,103 @@ EMAIL_QUEUE=email_queue
 # Shared secret for service-to-service calls (payment microservice <-> freight).
 # Required at boot; set ALLOW_UNAUTH_INTERNAL=true instead ONLY for local dev.
 SERVICE_AUTH_TOKEN=change-me
+
+# ── MoR EIMS e-invoicing (core.mor.gov.et) ─────────────────────────────────
+# Disabled by default; every EIMS call fails fast with EIMS_NOT_CONFIGURED until enabled.
+EIMS_ENABLED=false
+EIMS_BASE_URL=https://core.mor.gov.et
+EIMS_CLIENT_ID=
+EIMS_CLIENT_SECRET=
+EIMS_API_KEY=
+EIMS_TIN=
+# Source-system identity comes from the access token's systemNumber/systemType claims.
+# Setting these turns them into expected-value checks: a mismatch against the token fails
+# fast rather than one side silently winning. Leave empty to take the gateway's word.
+EIMS_SYSTEM_NUMBER=
+EIMS_SYSTEM_TYPE=
+# Absolute paths to the INSA-issued credentials. Keep them OUTSIDE the repo; the file
+# patterns are gitignored, but a path outside the working tree is safer still.
+# The certificate is transmitted as base64 of this file's exact bytes — do not convert it.
+EIMS_PRIVATE_KEY_PATH=
+EIMS_CERTIFICATE_PATH=
+# Optional tuning
+EIMS_HTTP_TIMEOUT_MS=30000
+EIMS_TOKEN_SKEW_SECONDS=45
+
+# ── EIMS invoice registration (required only to register invoices) ─────────
+# Seller identity: EDR's own legal details are not modelled anywhere in the DB.
+# Region and Wereda are MoR *codes* (e.g. 13 / 574), not names.
+EIMS_SELLER_LEGAL_NAME=
+EIMS_SELLER_VAT_NUMBER=
+EIMS_SELLER_PHONE=
+EIMS_SELLER_EMAIL=
+EIMS_SELLER_REGION=
+EIMS_SELLER_WEREDA=
+# Optional seller address parts; sent as null when unset.
+EIMS_SELLER_CITY=
+EIMS_SELLER_SUBCITY=
+EIMS_SELLER_HOUSE_NUMBER=
+EIMS_SELLER_LOCALITY=
+# Tax treatment — REQUIRES FINANCE SIGN-OFF. The application models no tax at all
+# (invoice.taxAmount is always 0), so nothing here is defaulted: registration fails
+# locally, naming the missing variables, until these are set.
+# Required, and deliberately unset here: the choice is a tax position, not a default.
+# MoR's enum (from its own 400): TOT10 TOT2 VAT15 VWHT TWHT VATEX VATWH WHOP2 WTHOI VAT0 VWTH
+# Finance confirmed 2026-08-12: VATEX (exempt) for EDR's freight business — set in .env.
+EIMS_TAX_CODE=
+EIMS_TAX_RATE_PERCENT=0
+EIMS_EXCISE_TAX_VALUE=0
+EIMS_INCOME_WITHHOLD_VALUE=0
+EIMS_TRANSACTION_WITHHOLD_VALUE=0
+# Per-chargeType override, for an invoice whose lines need different MoR tax treatment (e.g. a
+# zero-rated freight line next to a taxed accessorial) — IRC-P01 compliance-test material.
+# A charge type not listed here falls back to EIMS_TAX_CODE / EIMS_TAX_RATE_PERCENT above.
+# EIMS_TAX_CODE_BY_CHARGE_TYPE and EIMS_TAX_RATE_BY_CHARGE_TYPE must list the same charge types.
+EIMS_TAX_CODE_BY_CHARGE_TYPE=
+EIMS_TAX_RATE_BY_CHARGE_TYPE=
+# Same mechanism; charge types not listed fall back to EIMS_EXCISE_TAX_VALUE / 0 respectively.
+EIMS_EXCISE_BY_CHARGE_TYPE=
+EIMS_DISCOUNT_BY_CHARGE_TYPE=
+# Document classification and payment presentation.
+EIMS_TRANSACTION_TYPE=B2B
+# Lowercase constant: MoR's oneOf branches require exactly 'goods' or 'service'.
+EIMS_NATURE_OF_SUPPLIES=service
+EIMS_PAYMENT_MODE=CASH
+EIMS_PAYMENT_TERM=IMMIDIATE
+EIMS_UNIT_DEFAULT=PCS
+# MoR numeric country code for the buyer; our companies store the country name.
+EIMS_BUYER_COUNTRY_CODE=
+# Buyer region name -> MoR numeric code. companies.region holds names; MoR wants ^[0-9]{1,3}$.
+# An unmapped region fails locally rather than being filed with a guess.
+EIMS_BUYER_REGION_CODES=Addis Ababa=13
+# Same mechanism for Wereda. MoR has never named a Wereda regex in an error (only Region's is
+# confirmed), so this is precautionary — but an unmapped name still fails locally, not filed as a guess.
+EIMS_BUYER_WEREDA_CODES=
+EIMS_CASHIER_NAME=
+EIMS_SALESPERSON_NAME=
+# Automatic filing of issued invoices (@Cron sweep, one invoice per tick).
+# Independent of EIMS_ENABLED on purpose: authentication can be live long before
+# filing is. Both must be true before anything is submitted automatically.
+EIMS_AUTO_SUBMIT=false
+EIMS_AUTO_SUBMIT_CRON=0 */5 * * * *
+# MoR rejects documents older than 3 days; the sweep will not attempt those.
+EIMS_AUTO_SUBMIT_MAX_AGE_DAYS=3
+# ── Internal chat (Matrix/Element) ──────────────────────────────────────────
+# Disabled by default; /chat/sso and the nightly room/membership reconcile are
+# no-ops until enabled. See infrastructure/matrix/.
+MATRIX_ENABLED=false
+# Synapse URL reachable from this container (docker-compose service DNS in
+# prod, e.g. http://synapse:8008 — NOT the public https://matrix.edr.et).
+MATRIX_BASE_URL=http://localhost:8008
+# Synapse's own public_baseurl — what Element itself is configured to call.
+# Only used to seed the sso.html handoff page's localStorage.
+MATRIX_PUBLIC_BASE_URL=https://matrix.edr.et
+MATRIX_CHAT_WEB_URL=https://chat.edr.et
+MATRIX_SERVER_NAME=matrix.edr.et
+# Must exactly match infrastructure/matrix/synapse/.env's MATRIX_JWT_SECRET —
+# this is the whole trust boundary for the SSO handoff.
+MATRIX_JWT_SECRET=
+# access_token of a Synapse server-admin account. Bootstrap it once via
+# infrastructure/matrix/synapse's MATRIX_REGISTRATION_SHARED_SECRET (see that
+# file's comments) — this app never touches the shared secret itself.
+MATRIX_ADMIN_TOKEN=
diff --git a/apps/edr-freight-api/.q.mjs b/apps/edr-freight-api/.q.mjs
new file mode 100644
index 000000000..b2b454075
--- /dev/null
+++ b/apps/edr-freight-api/.q.mjs
@@ -0,0 +1,9 @@
+import pg from 'pg';
+import fs from 'fs';
+const env = Object.fromEntries(fs.readFileSync('.env','utf8').split('\n').filter(l=>/^[A-Z_]+=/.test(l)).map(l=>{const i=l.indexOf('=');return [l.slice(0,i),l.slice(i+1).replace(/^"|"$/g,'')]}));
+const c = new pg.Client({host:env.DB_HOST,port:+env.DB_PORT,database:env.DB_NAME,user:env.DB_USER,password:env.DB_PASSWORD});
+await c.connect();
+const sql = process.argv[2];
+const r = await c.query(sql);
+console.log(JSON.stringify(r.rows,null,1));
+await c.end();
diff --git a/apps/edr-freight-api/data/audit-endpoints.js b/apps/edr-freight-api/data/audit-endpoints.js
new file mode 100644
index 000000000..2c11ea95b
--- /dev/null
+++ b/apps/edr-freight-api/data/audit-endpoints.js
@@ -0,0 +1,639 @@
+/**
+ * Freight API — every state-changing endpoint (POST / PUT / PATCH / DELETE).
+ *
+ * Shape:  "<METHOD> <path>": [title, method, entity]
+ *
+ * Keyed by method + path rather than path alone: 50 paths serve more than one
+ * method (PATCH and DELETE on /api/contracts/:id, for example), so a path-only
+ * key would collide and drop those endpoints.
+ *
+ * Paths include the global prefix `api` (see app.setGlobalPrefix in src/main.ts).
+ * Titles come from each route's @ApiOperation summary, falling back to a
+ * humanized handler name where a route has none.
+ *
+ * Excludes the AI Assist and Account entities.
+ * Generated from the controllers under src/ — 488 endpoints.
+ */
+const AUDIT_ENDPOINTS = {
+  // Approval Rule
+  "POST /api/approval-rules": ["Create an approval rule step", "POST", "Approval Rule"],
+  "PATCH /api/approval-rules/:id": ["Update an approval rule", "PATCH", "Approval Rule"],
+  "DELETE /api/approval-rules/:id": ["Soft-delete an approval rule", "DELETE", "Approval Rule"],
+  "POST /api/approval-rules/:id/move-order": ["Move an approval step up or down within its chain", "POST", "Approval Rule"],
+  "POST /api/approval-rules/reorder": ["Bulk reorder approval steps within a chain", "POST", "Approval Rule"],
+
+  // Booking
+  "POST /api/bookings": ["Create a new freight booking (DRAFT)", "POST", "Booking"],
+  "POST /api/bookings/:bookingId/allocate-containers": ["Allocate containers to vehicles", "POST", "Booking"],
+  "PATCH /api/bookings/:id": ["Update booking", "PATCH", "Booking"],
+  "DELETE /api/bookings/:id": ["Soft-delete DRAFT booking", "DELETE", "Booking"],
+  "POST /api/bookings/:id/cancel": ["Cancel booking", "POST", "Booking"],
+  "POST /api/bookings/:id/cancel-hold": ["Customer cancels an unpaid hold (SELECTED_FOR_BATCH → CANCELLED);", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/declaration": ["GL ET uploads customs declaration on booking (GENERAL customs)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/delivery-order": ["Upload Booking Delivery Order", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/documents": ["Customer uploads clearance documents (fieldname = document key)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/draft-declaration": ["GL ET sends a draft customs declaration (multi-file) with an estimated price for the customer to review", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/draft-declaration/accept": ["Customer accepts the draft customs declaration — unlocks the real customs declaration step for GL Ethiopia", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/draft-declaration/change": ["Customer requests a change to the draft customs declaration with a reason — GL Ethiopia sends a corrected draft (repeatable)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/duty": ["GL ET sets duty/tax on booking with notice attachment", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/duty-slip": ["Customer uploads duty/tax payment slip on booking", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/export-release": ["Confirm Booking Export Release", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/finalize": ["GL finalizes clearance (requires 100% approved) → CLEARANCE_READY", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/finalize-pre-clearance": ["GL ET finalizes import pre-clearance on booking", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/output-documents": ["GL uploads customs output documents (IM4/EX3/…)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/proceed": ["Customer requests operation with a schedule day", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/release-order": ["Upload Booking Release Order", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/review": ["GL reviews a clearance document (Approve | Query)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/ro-amendment": ["Request Booking RO Amendment", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/transit-assignee/assign": ["GL Djibouti picks the transit officer from the roster — unblocks the customs declaration; calling again reassigns", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/transit-assignee/request": ["GL ET asks GL Djibouti to name the transit officer — required before the import customs declaration", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/transit-permit": ["Upload Booking Transit Permit", "POST", "Booking"],
+  "POST /api/bookings/:id/confirm-submit": ["Confirm submit after price change", "POST", "Booking"],
+  "POST /api/bookings/:id/consolidation": ["Request freight consolidation", "POST", "Booking"],
+  "DELETE /api/bookings/:id/consolidation": ["Remove consolidation pairing", "DELETE", "Booking"],
+  "POST /api/bookings/:id/contract/generate": ["Generate contract PDF from template", "POST", "Booking"],
+  "POST /api/bookings/:id/contract/sign": ["Apply digital signature (customer or staff)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-cancel": ["Customer cancels their own booking before payment — no cancellation fee", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-truck-assignment": ["Customer assigns external truck and driver for terminal pickup", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-trucks": ["Add a customer self-haul truck carrying 1–2 of the booking containers", "POST", "Booking"],
+  "PATCH /api/bookings/:id/customer-trucks/:assignmentId": ["Edit a not-yet-arrived customer truck (plate/driver/type + containers)", "PATCH", "Booking"],
+  "DELETE /api/bookings/:id/customer-trucks/:assignmentId": ["Remove a not-yet-arrived customer truck from a booking", "DELETE", "Booking"],
+  "POST /api/bookings/:id/customer-trucks/:assignmentId/depart": ["Register an import truck leaving: containers loaded + weighed gross (staff)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-trucks/:assignmentId/load": ["Truck_dispatch: load selected containers onto a truck (staff)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-trucks/bulk": ["Bulk add customer trucks from array payload (Excel parsed)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer/sign": ["Customer digital signature (deprecated — use POST contract/sign)", "POST", "Booking"],
+  "POST /api/bookings/:id/documents": ["Upload documents for a booking (DRAFT only)", "POST", "Booking"],
+  "PATCH /api/bookings/:id/export-handover-mode": ["Export only: choose direct truck-to-train (no warehouse, no GRN) or warehouse first", "PATCH", "Booking"],
+  "POST /api/bookings/:id/generate-grn": ["Generate a GRN over the received containers (all received, or a subset) — one GRN per batch", "POST", "Booking"],
+  "POST /api/bookings/:id/generate-price": ["Generate price preview (DRAFT or CHANGES_REQUESTED)", "POST", "Booking"],
+  "POST /api/bookings/:id/government-expedite": ["Expedite government booking to PAID / ELIGIBLE for scheduling", "POST", "Booking"],
+  "POST /api/bookings/:id/marketing/approve": ["Staff contract signature and fully execute (use contract/sign STAFF preferred)", "POST", "Booking"],
+  "POST /api/bookings/:id/operation/review": ["Operations reviews an operation request: ACCEPT (→ batch pool),", "POST", "Booking"],
+  "POST /api/bookings/:id/operations/complete": ["Mark completed", "POST", "Booking"],
+  "POST /api/bookings/:id/operations/start-transit": ["Mark in transit", "POST", "Booking"],
+  "POST /api/bookings/:id/reject": ["Customer reject price estimate", "POST", "Booking"],
+  "POST /api/bookings/:id/staff/accept": ["Staff accept intake → set contract validity window + start approval chain", "POST", "Booking"],
+  "POST /api/bookings/:id/staff/reject": ["Staff final reject", "POST", "Booking"],
+  "POST /api/bookings/:id/staff/request-changes": ["Staff return booking for customer updates", "POST", "Booking"],
+  "POST /api/bookings/:id/submit": ["Customer submit booking", "POST", "Booking"],
+  "POST /api/bookings/:id/wagon-cancellations": ["Request a partial wagon cancellation on a PAID booking — opens the cancellation-fee invoice; wagons are released only once the fee settles", "POST", "Booking"],
+  "POST /api/bookings/:id/wagon-cancellations/preview": ["Preview the fee/credit of a partial wagon cancellation (no writes)", "POST", "Booking"],
+  "POST /api/bookings/wagon-cancellations/:cancellationId/rebook": ["Rebook a wagon-cancellation credit: pick a shipment day only — the new booking is created under the contract and marked PAID (freight already paid; contract must still be valid)", "POST", "Booking"],
+  "POST /api/bookings/wagon-cancellations/:cancellationId/withdraw": ["Withdraw a fee-pending wagon cancellation (owner, or staff with the void permission)", "POST", "Booking"],
+
+  // Cargo
+  "POST /api/cargoes": ["Create a new cargo", "POST", "Cargo"],
+  "PATCH /api/cargoes/:id": ["Update a cargo", "PATCH", "Cargo"],
+  "DELETE /api/cargoes/:id": ["Delete a cargo", "DELETE", "Cargo"],
+  "POST /api/cargoes/:id/deliver": ["Mark cargo as delivered", "POST", "Cargo"],
+  "POST /api/cargoes/:id/load": ["Load cargo into a container", "POST", "Cargo"],
+  "POST /api/cargoes/:id/unload": ["Unload cargo from container", "POST", "Cargo"],
+
+  // Cargo Type
+  "POST /api/cargo-types": ["Create a cargo type", "POST", "Cargo Type"],
+  "PATCH /api/cargo-types/:id": ["Update a cargo type", "PATCH", "Cargo Type"],
+  "DELETE /api/cargo-types/:id": ["Soft-delete a cargo type", "DELETE", "Cargo Type"],
+  "POST /api/cargo-types/:id/move-order": ["Move a cargo type up or down in display order", "POST", "Cargo Type"],
+  "POST /api/cargo-types/reorder": ["Bulk reorder cargo types by ID list", "POST", "Cargo Type"],
+
+  // Company
+  "POST /api/companies": ["Create a new company (customer, freight_forwarder, dj_freight_forwarder, transporter)", "POST", "Company"],
+  "POST /api/companies/:companyId/documents": ["Upload documents for a company (onboarding)", "POST", "Company"],
+  "POST /api/companies/:companyId/profiles": ["Add a profile (employee) to a company", "POST", "Company"],
+  "PATCH /api/companies/:id": ["Update a company", "PATCH", "Company"],
+  "DELETE /api/companies/:id": ["Soft-delete a company", "DELETE", "Company"],
+  "POST /api/companies/change-requests/:id/approve": ["Approve a pending profile change request (applies the changes)", "POST", "Company"],
+  "POST /api/companies/change-requests/:id/reject": ["Reject a pending profile change request with a note", "POST", "Company"],
+  "POST /api/companies/change-requests/:id/request-changes": ["Ask for specific changes on a pending request without rejecting it (row stays open, next edit appends to it)", "POST", "Company"],
+  "POST /api/companies/company-profile": ["Create a single operational profile for the current user's company. The role starts pending and does not become the active mode", "POST", "Company"],
+  "POST /api/companies/company-profiles": ["Add operational profile(s) (importer/exporter/forwarder) to the current user's company", "POST", "Company"],
+  "POST /api/companies/company-profiles/:profileId/license": ["Add business-license document(s) to a profile. For an approved company", "POST", "Company"],
+  "DELETE /api/companies/company-profiles/:profileId/license/:fileId": ["Remove a business-license file (staged for review on an approved company)", "DELETE", "Company"],
+  "POST /api/companies/company-profiles/:profileId/license/:fileId/replace": ["Replace a business-license file with a newly uploaded one (staged for", "POST", "Company"],
+  "POST /api/companies/company-profiles/:profileId/reapply": ["Resubmit a rejected operational role for approval (→ pending)", "POST", "Company"],
+  "PATCH /api/companies/company-profiles/:profileId/status": ["Update a company profile's approval status", "PATCH", "Company"],
+  "POST /api/companies/create": ["Create a company with its associated external profile (onboarding)", "POST", "Company"],
+  "POST /api/companies/documents/:fileId/request-change": ["Ask the customer to correct one uploaded document", "POST", "Company"],
+  "POST /api/companies/fetch-etrade-info": ["Fetch company info from eTrade by TIN", "POST", "Company"],
+  "POST /api/companies/identity/fayda/complete": ["Bind a completed Fayda verification to the company's owner or Power of Attorney", "POST", "Company"],
+  "DELETE /api/companies/identity/fayda/poa": ["Remove the company's Power of Attorney — the verified identity, its details and the delegation paper together", "DELETE", "Company"],
+  "DELETE /api/companies/identity/gm": ["Clear the General Manager's identity — the \\\"same as owner\\\" declaration or a verification, and the details either wrote", "DELETE", "Company"],
+  "POST /api/companies/identity/gm/same-as-owner": ["Declare the General Manager is the company's owner, copying the owner's verified identity across", "POST", "Company"],
+  "POST /api/companies/identity/poa/same-as-owner": ["Declare the Power of Attorney is the company's owner, copying the owner's identity across", "POST", "Company"],
+  "DELETE /api/companies/identity/poa/same-as-owner": ["Undo the Power of Attorney \\\"same as owner\\\" declaration and the identity it copied, leaving the representative open to be verified in their own right", "DELETE", "Company"],
+  "PATCH /api/companies/onboarding-step": ["Persist the user's current onboarding wizard step", "PATCH", "Company"],
+  "POST /api/companies/onboarding/complete": ["Mark the current user's onboarding as complete", "POST", "Company"],
+  "POST /api/companies/onboarding/start": ["Begin onboarding: create a draft company + profile + role(s) so later steps can save incrementally", "POST", "Company"],
+  "POST /api/companies/poa-delegation": ["Upload the Power of Attorney delegation letter, replacing any existing one", "POST", "Company"],
+  "DELETE /api/companies/poa-delegation/:fileId": ["Remove the Power of Attorney delegation letter (staged for review on an approved company)", "DELETE", "Company"],
+  "PATCH /api/companies/profile": ["Update profile (flattened settings page)", "PATCH", "Company"],
+
+  // Compliance
+  "POST /api/compliance": ["Create a compliance record", "POST", "Compliance"],
+  "PATCH /api/compliance/:id": ["Update a compliance record", "PATCH", "Compliance"],
+  "DELETE /api/compliance/:id": ["Soft-delete a compliance record", "DELETE", "Compliance"],
+
+  // Consignment
+  "POST /api/consignments": ["Create a new consignment", "POST", "Consignment"],
+
+  // Container
+  "POST /api/containers": ["Create a new container", "POST", "Container"],
+  "PATCH /api/containers/:id": ["Update a container", "PATCH", "Container"],
+  "DELETE /api/containers/:id": ["Delete a container", "DELETE", "Container"],
+  "POST /api/containers/:id/assign-wagon": ["Assign container to a wagon", "POST", "Container"],
+  "POST /api/containers/:id/unassign-wagon": ["Unassign container from wagon", "POST", "Container"],
+
+  // Container Type
+  "POST /api/container-types": ["Create a container type", "POST", "Container Type"],
+  "PATCH /api/container-types/:id": ["Update a container type", "PATCH", "Container Type"],
+  "DELETE /api/container-types/:id": ["Soft-delete a container type", "DELETE", "Container Type"],
+  "POST /api/container-types/:id/move-order": ["Move a container type up or down in display order", "POST", "Container Type"],
+  "POST /api/container-types/reorder": ["Bulk reorder container types by ID list", "POST", "Container Type"],
+
+  // Contract
+  "POST /api/contracts": ["Create a new contract (DRAFT) with routes + cargo scope", "POST", "Contract"],
+  "PATCH /api/contracts/:id": ["Update contract", "PATCH", "Contract"],
+  "DELETE /api/contracts/:id": ["Soft-delete DRAFT contract", "DELETE", "Contract"],
+  "POST /api/contracts/:id/approval-steps/:stepId/approve": ["Approve one approval step in sequence", "POST", "Contract"],
+  "POST /api/contracts/:id/approval-steps/:stepId/reject": ["Reject one approval step — to the customer (terminal → REJECTED) or, via returnToStepId, back to an earlier approver (chain re-runs from there)", "POST", "Contract"],
+  "POST /api/contracts/:id/booking-requests": ["Customer submits a shipment request on a GENERAL customs contract", "POST", "Contract"],
+  "POST /api/contracts/:id/bookings": ["Create a shipment booking under a contract — Path A (customer) or Path B (GL Ethiopia)", "POST", "Contract"],
+  "POST /api/contracts/:id/bookings/:bookingId/complete": ["Complete an initiated booking after Operations finalized its clearance — cargo + binding day, window and departure checks, pricing and invoicing", "POST", "Contract"],
+  "POST /api/contracts/:id/bookings/initiate": ["Initiate a bare booking instance under an import/export contract (ONE_TIME or GENERAL) — no cargo, no date; enters per-booking clearance (AWAITING_DOCUMENTS). ONE_TIME customs instances are opened by the customer (or GL); GENERAL customs comes from a shipment request", "POST", "Contract"],
+  "POST /api/contracts/:id/cancel": ["Customer cancels their own contract (blocked while a booking is live)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/declaration": ["GL ET uploads customs declaration documents (multi-file)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/delivery-order": ["GL DJ uploads Delivery Order (import) with vessel arrival + DO collected dates", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/documents": ["Customer uploads clearance documents (fieldname = document key)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/documents/:fileKey/replace": ["GL replaces a clearance document in place (reason required) — the previous version is kept in the file history and the new one needs approving", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/duty": ["GL ET sets duty/tax requirement and advises amount with notice attachment", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/duty-slip": ["Customer uploads duty/tax payment slip on contract", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/duty/dispute": ["Customer disputes the advised duty/tax with a reason — reopens the step so GL Ethiopia can re-advise (repeatable)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/export-release": ["GL ET confirms export release after declaration", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/finalize": ["GL ET finalizes clearance → CLEARANCE_READY_FOR_BOOKING (legacy)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/finalize-export-clearance": ["GL ET finalizes export clearance after post-booking transit permit upload", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/finalize-pre-clearance": ["GL ET finalizes import pre-clearance — unlocks Djibouti DO upload", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/ops-finalize": ["Operations finalizes self-clearance → customer may create the booking", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/ops-review": ["Operations reviews a customer self-clearance document (Approve | Query)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/output-documents": ["GL uploads customs output documents (IM4/EX3/…) pre-booking", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/release-order": ["GL DJ uploads Release Order + vessel departure date (export)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/review": ["GL ET reviews a clearance document (Approve | Query)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/ro-amendment": ["GL DJ requests port amendment when RO vessel window is too short", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/transit-assignee/assign": ["GL Djibouti picks the transit officer from the roster — unblocks the customs declaration; calling again reassigns", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/transit-assignee/request": ["GL ET asks GL Djibouti to name the transit officer — required before the customs declaration", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/transit-permit": ["GL ET uploads import transit permit documents (multi-file)", "POST", "Contract"],
+  "POST /api/contracts/:id/confirm-submit": ["Confirm submit after a price change", "POST", "Contract"],
+  "POST /api/contracts/:id/contract/generate": ["Generate contract document → CONTRACT_READY", "POST", "Contract"],
+  "POST /api/contracts/:id/contract/send-signing-otp": ["Send the sudo-mode signing OTP to the contract company's registered phone (server picks the number)", "POST", "Contract"],
+  "POST /api/contracts/:id/contract/sign": ["Apply digital signature (customer or staff/director/ceo)", "POST", "Contract"],
+  "PUT /api/contracts/:id/document/articles": ["Edit this contract\\'s document articles only (per-contract; never touches the six shared templates)", "PUT", "Contract"],
+  "POST /api/contracts/:id/documents": ["Upload intake documents for a contract (DRAFT only)", "POST", "Contract"],
+  "POST /api/contracts/:id/generate-price": ["Generate unit-rate breakdown (no totals at contract phase)", "POST", "Contract"],
+  "POST /api/contracts/:id/milestones/:code/complete": ["GL marks a pre-booking (contract) milestone complete", "POST", "Contract"],
+  "POST /api/contracts/:id/renew": ["Create a renewal draft linked via renewalOfId", "POST", "Contract"],
+  "POST /api/contracts/:id/resume": ["Staff lift a suspension — contract returns to its prior status", "POST", "Contract"],
+  "POST /api/contracts/:id/staff/accept": ["Staff accept → set validity window + start approval chain", "POST", "Contract"],
+  "POST /api/contracts/:id/staff/reject": ["Staff reject contract", "POST", "Contract"],
+  "POST /api/contracts/:id/staff/request-changes": ["Staff return contract for customer updates", "POST", "Contract"],
+  "POST /api/contracts/:id/submit": ["Customer submit contract (freezes contract_rate_snapshots)", "POST", "Contract"],
+  "POST /api/contracts/:id/suspend": ["Staff freeze a signed contract (reversible, any post-signature step)", "POST", "Contract"],
+  "POST /api/contracts/:id/validate-shipment": ["Pre-create validation + authoritative price preview: full booking price breakdown (rail, first/last mile, surcharges), overweight lines and 20ft weight-pairing errors for a shipment payload (no booking created)", "POST", "Contract"],
+  "POST /api/contracts/booking-requests/:reqId/accept": ["GL marks a shipment request accepted + links the created booking", "POST", "Contract"],
+  "POST /api/contracts/booking-requests/:reqId/cancel": ["Customer cancels their own pending shipment request", "POST", "Contract"],
+  "POST /api/contracts/booking-requests/:reqId/reject": ["GL rejects a shipment request", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/documents": ["GL uploads post-booking operational documents (DO/RO/T1/…)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/duty": ["GL ET advises duty & tax amount + declaration serial", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/duty-slip": ["Customer uploads the duty/tax payment slip", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice": ["GL DJ raises the post-offload final invoice (amount + invoice document)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice-slip": ["Customer attaches the payment slip for the final invoice", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice/approve": ["Customer approves the drafted final invoice — unlocks the payment slip", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice/confirm": ["GL (ET or DJ) confirms the payment slip — settles the final invoice", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/incidents": ["GL DJ logs a cargo exception with photo evidence", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/milestones/:code/complete": ["GL / Ops / Terminal marks a post-booking milestone complete", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/risk": ["GL ET assigns a customs risk level (GREEN/YELLOW/RED)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/second-duty": ["GL ET advises (or skips) the post-arrival additional duty/tax round (import)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/second-duty-slip": ["Customer attaches the additional duty/tax payment slip", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/station-assign": ["GL station manager routes the shipment + binds staff", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/t1-close": ["Close (accept) the T1 set — GL ET after arrival (import) / GL DJ after gate pass (export)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/t1-documents": ["GL Djibouti uploads T1 transit documents (multi-file) after wagon allocation; locked once the train departs", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/transport-document": ["GL ET uploads export transit permit documents (multi-file)", "POST", "Contract"],
+  "POST /api/gl-exchange/:entityId": ["Share a document with the other GL desk", "POST", "Contract"],
+  "PATCH /api/gl-exchange/documents/:documentId": ["Uploader edits a shared document (title, visibility, file)", "PATCH", "Contract"],
+  "DELETE /api/gl-exchange/documents/:documentId": ["Uploader removes a shared document", "DELETE", "Contract"],
+
+  // Contract Template
+  "POST /api/contract-templates": ["Create a bulk contract template for a (cargo type, customs option) pair", "POST", "Contract Template"],
+  "PATCH /api/contract-templates/:code": ["Update template metadata (name, title, recitals, active flag)", "PATCH", "Contract Template"],
+  "DELETE /api/contract-templates/:code": ["Delete a staff-created bulk template (system templates refuse)", "DELETE", "Contract Template"],
+  "POST /api/contract-templates/:code/articles": ["Add an article to the template", "POST", "Contract Template"],
+  "PUT /api/contract-templates/:code/articles": ["Replace the full ordered article list (used for reorder)", "PUT", "Contract Template"],
+  "PATCH /api/contract-templates/:code/articles/:articleId": ["Update an article's title or body", "PATCH", "Contract Template"],
+  "DELETE /api/contract-templates/:code/articles/:articleId": ["Remove an article from the template", "DELETE", "Contract Template"],
+  "POST /api/contract-templates/:code/preview": ["Render an HTML preview of the template against mock contract data", "POST", "Contract Template"],
+
+  // Driver
+  "POST /api/drivers": ["Create a new driver", "POST", "Driver"],
+  "PATCH /api/drivers/:id": ["Update a driver", "PATCH", "Driver"],
+  "DELETE /api/drivers/:id": ["Delete a driver", "DELETE", "Driver"],
+  "POST /api/drivers/:id/documents": ["Upload driver documents (code driver_docs)", "POST", "Driver"],
+  "DELETE /api/drivers/:id/documents/:fileId": ["Delete a driver document", "DELETE", "Driver"],
+
+  // Dropdown Setting
+  "POST /api/dropdown-settings": ["Create a new dropdown setting", "POST", "Dropdown Setting"],
+  "PATCH /api/dropdown-settings/:id": ["Update a dropdown setting's metadata", "PATCH", "Dropdown Setting"],
+  "DELETE /api/dropdown-settings/:id": ["Soft-delete a dropdown setting", "DELETE", "Dropdown Setting"],
+  "POST /api/dropdown-settings/:id/options": ["Append a single option to a setting", "POST", "Dropdown Setting"],
+  "PUT /api/dropdown-settings/:id/options": ["Replace the full option list for a setting", "PUT", "Dropdown Setting"],
+  "PATCH /api/dropdown-settings/options/:optionId": ["Update a single option", "PATCH", "Dropdown Setting"],
+  "DELETE /api/dropdown-settings/options/:optionId": ["Soft-delete a single option", "DELETE", "Dropdown Setting"],
+
+  // EIMS Invoice
+  "POST /api/invoices/:id/eims/register": ["Register the invoice with MoR EIMS. Idempotent — an invoice that already has an IRN is returned unchanged", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/resolve": ["Resolve an unacknowledged submission: record the IRN confirmed with MoR, or discard it. Clears the system-wide block", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/verify": ["Verify the invoice's stored IRN against EIMS", "POST", "EIMS Invoice"],
+
+  // Exchange Setting
+  "PATCH /api/exchange-settings": ["Set the USD→ETB fallback by hand (used only while CBE is unreachable)", "PATCH", "Exchange Setting"],
+
+  // Facility
+  "POST /api/facilities": ["Create a new facility", "POST", "Facility"],
+  "PATCH /api/facilities/:id": ["Update a facility", "PATCH", "Facility"],
+  "DELETE /api/facilities/:id": ["Delete a facility (soft delete)", "DELETE", "Facility"],
+
+  // Fayda Verification
+  "POST /api/fayda/verification/start": ["Start a VeriFayda 2.0 verification session", "POST", "Fayda Verification"],
+
+  // File Upload Setting
+  "POST /api/file-upload-settings": ["Create a new file upload setting", "POST", "File Upload Setting"],
+  "PATCH /api/file-upload-settings/:id": ["Update a file upload setting's metadata", "PATCH", "File Upload Setting"],
+  "DELETE /api/file-upload-settings/:id": ["Soft-delete a file upload setting", "DELETE", "File Upload Setting"],
+  "POST /api/file-upload-settings/:id/fields": ["Append a single field to a setting", "POST", "File Upload Setting"],
+  "PUT /api/file-upload-settings/:id/fields": ["Replace the full field list for a setting", "PUT", "File Upload Setting"],
+  "PATCH /api/file-upload-settings/fields/:fieldId": ["Update a single field", "PATCH", "File Upload Setting"],
+  "DELETE /api/file-upload-settings/fields/:fieldId": ["Soft-delete a single field", "DELETE", "File Upload Setting"],
+
+  // First Mile
+  "POST /api/first-mile": ["Create a first-mile leg", "POST", "First Mile"],
+  "PATCH /api/first-mile/:id": ["Update a first-mile leg", "PATCH", "First Mile"],
+  "DELETE /api/first-mile/:id": ["Soft-delete a first-mile leg", "DELETE", "First Mile"],
+  "POST /api/first-mile/:id/distances": ["Set per-vehicle actual distances (does not generate an invoice)", "POST", "First Mile"],
+  "POST /api/first-mile/:id/invoice": ["Generate the first-mile delivery-fee invoice", "POST", "First Mile"],
+  "POST /api/first-mile/:id/vehicles": ["Set the vehicles assigned to a first-mile pickup (multi-truck)", "POST", "First Mile"],
+  "POST /api/first-mile/accept/:reference": ["Accept a paid booking and create a first-mile leg", "POST", "First Mile"],
+
+  // Fuel
+  "POST /api/fuel/purchases": ["Record fuel purchase", "POST", "Fuel"],
+
+  // GPS Tracking
+  "POST /api/gps/devices": ["Register a GPS tracker", "POST", "GPS Tracking"],
+  "PATCH /api/gps/devices/:id": ["Update a GPS tracker (name / assigned vehicle)", "PATCH", "GPS Tracking"],
+  "DELETE /api/gps/devices/:id": ["Delete a GPS tracker", "DELETE", "GPS Tracking"],
+
+  // Import Operation
+  "POST /api/import-operations/customs/:bookingId/declaration": ["Batch 12: record declaration serial number", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/documents": ["Batch 12: upload IM4/IM5/T1/permit/payment-slip documents", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/duties-taxes-paid": ["Batch 12: mark duties and taxes paid", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/notify-duties-taxes": ["Batch 12: notify duties and taxes", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/release-permitted": ["Batch 12: mark import release permitted", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/risk": ["Batch 12: assign customs risk", "POST", "Import Operation"],
+  "POST /api/import-operations/djibouti-incidents": ["Batch 8: report a Djibouti import incident / exception", "POST", "Import Operation"],
+  "POST /api/import-operations/empty-container-returns": ["Batch 16: create an empty container return record", "POST", "Import Operation"],
+  "POST /api/import-operations/empty-container-returns/:id/status": ["Batch 16: advance empty container return workflow", "POST", "Import Operation"],
+
+  // Incident
+  "POST /api/incidents": ["Report an incident", "POST", "Incident"],
+  "PATCH /api/incidents/:id": ["Update an incident", "PATCH", "Incident"],
+  "DELETE /api/incidents/:id": ["Delete an incident", "DELETE", "Incident"],
+
+  // Interchange Document
+  "PATCH /api/interchange-documents/:id/acknowledge": ["Acknowledge an interchange document", "PATCH", "Interchange Document"],
+  "PATCH /api/interchange-documents/:id/dispute": ["Dispute an interchange document", "PATCH", "Interchange Document"],
+  "POST /api/interchange-documents/generate-from-schedule": ["Generate interchange document from a train schedule handover", "POST", "Interchange Document"],
+
+  // Last Mile
+  "POST /api/last-mile": ["Create a last-mile leg", "POST", "Last Mile"],
+  "PATCH /api/last-mile/:id": ["Update a last-mile leg", "PATCH", "Last Mile"],
+  "DELETE /api/last-mile/:id": ["Soft-delete a last-mile leg", "DELETE", "Last Mile"],
+  "POST /api/last-mile/:id/detention-times": ["Set each truck\\'s own detention window (arrived at destination / returned)", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/distances": ["Set per-vehicle actual distances (does not generate an invoice)", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/invoice": ["Generate the delivery-fee invoice for a last-mile leg", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/proof-of-delivery": ["Record proof of delivery (signature + photos) and complete the leg", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/vehicles": ["Set the vehicles assigned to a last-mile delivery (multi-truck)", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/warehouse-gate-times": ["Set each truck\\'s warehouse gate arrival/departure times", "POST", "Last Mile"],
+  "POST /api/last-mile/accept/:reference": ["Accept a paid booking and create a last-mile leg", "POST", "Last Mile"],
+
+  // Last Mile Request
+  "POST /api/last-mile-requests/:id/approve": ["Truck & Machinery chief approves the request — the advance defaults to the live last-mile rate; LM contract becomes signable and the advance invoice follows the customer signature", "POST", "Last Mile Request"],
+  "POST /api/last-mile-requests/:id/contract/sign": ["Customer agrees and signs the LM contract — then the advance invoice is issued", "POST", "Last Mile Request"],
+  "POST /api/last-mile-requests/:id/reject": ["Truck & Machinery chief rejects the request with a reason", "POST", "Last Mile Request"],
+  "POST /api/last-mile-requests/:id/submit": ["Customer confirms which containers go via EDR last-mile", "POST", "Last Mile Request"],
+
+  // Locomotive
+  "POST /api/locomotives": ["Create a locomotive", "POST", "Locomotive"],
+  "PATCH /api/locomotives/:id": ["Update a locomotive", "PATCH", "Locomotive"],
+  "POST /api/locomotives/:id/decommission": ["Decommission a locomotive", "POST", "Locomotive"],
+  "DELETE /api/locomotives/:id/permanent": ["Permanently delete a locomotive (irreversible; refused if any train references it)", "DELETE", "Locomotive"],
+
+  // Maintenance
+  "POST /api/maintenance/costs": ["Record maintenance cost", "POST", "Maintenance"],
+  "POST /api/maintenance/intervals": ["Define/adjust a service interval (e.g. oil change every 10,000 km)", "POST", "Maintenance"],
+  "DELETE /api/maintenance/intervals/:id": ["Deactivate a service interval (stops auto-scheduling)", "DELETE", "Maintenance"],
+  "POST /api/maintenance/parts": ["Create part", "POST", "Maintenance"],
+  "PATCH /api/maintenance/parts/:id": ["Update part", "PATCH", "Maintenance"],
+  "DELETE /api/maintenance/parts/:id": ["Delete part", "DELETE", "Maintenance"],
+  "POST /api/maintenance/schedules": ["Schedule maintenance", "POST", "Maintenance"],
+  "PATCH /api/maintenance/schedules/:id": ["Update maintenance schedule", "PATCH", "Maintenance"],
+  "POST /api/maintenance/warranties": ["Create warranty", "POST", "Maintenance"],
+  "DELETE /api/maintenance/warranties/:id": ["Delete warranty", "DELETE", "Maintenance"],
+  "POST /api/maintenance/work-orders": ["Create work order", "POST", "Maintenance"],
+  "PATCH /api/maintenance/work-orders/:id": ["Update work order", "PATCH", "Maintenance"],
+  "DELETE /api/maintenance/work-orders/:id": ["Delete work order", "DELETE", "Maintenance"],
+
+  // Notification Inbox
+  "PATCH /api/notifications/:id/read": ["Mark one of my notifications as read", "PATCH", "Notification Inbox"],
+  "POST /api/notifications/read-all": ["Mark all my notifications as read", "POST", "Notification Inbox"],
+
+  // Organization User
+  "PUT /api/backoffice/organizations/:orgId/employee-users/:userId/roles": ["Replace org-scoped roles assigned to an employee user", "PUT", "Organization User"],
+  "POST /api/backoffice/organizations/:orgId/users": ["Create an organization user without assigning positions", "POST", "Organization User"],
+
+  // OTP
+  "POST /api/otp/send": ["Send OTP", "POST", "OTP"],
+  "POST /api/otp/verify": ["Verify OTP", "POST", "OTP"],
+
+  // Password Reset
+  "POST /api/auth/forgot-password/request": ["Send a password-reset code to the account's email AND phone", "POST", "Password Reset"],
+  "POST /api/auth/forgot-password/resolve-link": ["Validate a staff-issued reset link and return its set-password ticket", "POST", "Password Reset"],
+  "POST /api/auth/forgot-password/verify": ["Exchange a valid reset code for a single-use set-password ticket", "POST", "Password Reset"],
+  "POST /api/backoffice/customers/:companyId/reset-password": ["Send a password-reset link to a customer's primary contact", "POST", "Password Reset"],
+
+  // Payment
+  "POST /api/billing/invoices/:id/confirm-offline": ["Finance confirms a USD invoice paid by bank transfer — slip file required, settles the full balance", "POST", "Payment"],
+  "POST /api/billing/my-invoices/:id/confirm": ["Confirm an OTP-debit payment (CAC Bank) for one of the customer's invoices", "POST", "Payment"],
+  "POST /api/billing/my-invoices/:id/pay": ["Initiate payment for one of the customer's invoices", "POST", "Payment"],
+  "POST /api/internal/payments/bill-query": ["Live still-payable check + payer name for a CBE bill (called while CBE is on the line)", "POST", "Payment"],
+  "POST /api/internal/payments/mark-paid": ["Apply a payment.succeeded / payment.failed event from the payment service (idempotent)", "POST", "Payment"],
+  "POST /api/payments/initiate": ["Initiate payment for an invoice", "POST", "Payment"],
+  "POST /api/payments/redirect-success/:bookingId": ["Success-redirect ack: mark payment processing + invoice PAYMENT_PROCESSING (webhook remains source of truth)", "POST", "Payment"],
+
+  // Priority Config
+  "POST /api/priority-configs": ["Create a priority config", "POST", "Priority Config"],
+  "PATCH /api/priority-configs/:id": ["Update a priority config", "PATCH", "Priority Config"],
+  "DELETE /api/priority-configs/:id": ["Soft-delete a priority config", "DELETE", "Priority Config"],
+  "POST /api/priority-configs/:id/move-order": ["Move a priority config up or down in display order", "POST", "Priority Config"],
+  "POST /api/priority-configs/reorder": ["Bulk reorder priority configs by ID list", "POST", "Priority Config"],
+
+  // Priority Rule Change Request
+  "POST /api/priority-rule-change-requests": ["Submit a priority-rule change for approval", "POST", "Priority Rule Change Request"],
+  "POST /api/priority-rule-change-requests/:id/approve": ["Approve and apply a pending change", "POST", "Priority Rule Change Request"],
+  "POST /api/priority-rule-change-requests/:id/reject": ["Reject a pending change", "POST", "Priority Rule Change Request"],
+
+  // Procurement
+  "POST /api/procurement/acquisitions": ["Create an asset acquisition", "POST", "Procurement"],
+  "PATCH /api/procurement/acquisitions/:id": ["Update an asset acquisition", "PATCH", "Procurement"],
+  "DELETE /api/procurement/acquisitions/:id": ["Delete an asset acquisition", "DELETE", "Procurement"],
+  "POST /api/procurement/disposals": ["Create an asset disposal", "POST", "Procurement"],
+  "DELETE /api/procurement/disposals/:id": ["Delete an asset disposal", "DELETE", "Procurement"],
+  "POST /api/procurement/vendors": ["Create a vendor", "POST", "Procurement"],
+  "PATCH /api/procurement/vendors/:id": ["Update a vendor", "PATCH", "Procurement"],
+  "DELETE /api/procurement/vendors/:id": ["Delete a vendor", "DELETE", "Procurement"],
+
+  // Rate
+  "POST /api/rates": ["Create a rate (DRAFT)", "POST", "Rate"],
+  "PATCH /api/rates/:id": ["Update a DRAFT rate", "PATCH", "Rate"],
+  "DELETE /api/rates/:id": ["Soft-delete a rate", "DELETE", "Rate"],
+  "POST /api/rates/:id/approve": ["CEO approves a rate", "POST", "Rate"],
+  "POST /api/rates/:id/submit": ["Submit rate for CEO approval", "POST", "Rate"],
+
+  // Rate Change Request
+  "POST /api/rate-change-requests": ["Propose a change to a LIVE rate", "POST", "Rate Change Request"],
+  "POST /api/rate-change-requests/:id/approve": ["Approve a rate change and put it into effect", "POST", "Rate Change Request"],
+  "POST /api/rate-change-requests/:id/reject": ["Reject a rate change — the rate keeps its current value", "POST", "Rate Change Request"],
+
+  // Route
+  "POST /api/routes": ["Create route", "POST", "Route"],
+  "PATCH /api/routes/:id": ["Update route", "PATCH", "Route"],
+  "DELETE /api/routes/:id": ["Deactivate route", "DELETE", "Route"],
+  "DELETE /api/routes/:id/permanent": ["Permanently delete a route (irreversible; refused while any train schedule references it)", "DELETE", "Route"],
+
+  // Schedule
+  // NOTE: duplicate route — also declared in modules/scheduling-reschedule/scheduling-reschedule.controller.ts:52.
+  // Two controllers register this same path; Nest serves whichever module loads first.
+  "POST /api/train-scheduling/schedules/:id/maintenance": ["Reschedule train for maintenance (new departure + rebalance)", "POST", "Schedule"],
+  "POST /api/train-scheduling/schedules/:id/reschedule/execute": ["Execute a confirmed reschedule plan", "POST", "Schedule"],
+  "POST /api/train-scheduling/schedules/:id/reschedule/preview": ["Preview reschedule / government preempt plan", "POST", "Schedule"],
+
+  // Service Type
+  "POST /api/service-types": ["Create a service type", "POST", "Service Type"],
+  "PATCH /api/service-types/:id": ["Update a service type", "PATCH", "Service Type"],
+  "DELETE /api/service-types/:id": ["Soft-delete a service type", "DELETE", "Service Type"],
+  "POST /api/service-types/:id/move-order": ["Move a service type up or down in display order", "POST", "Service Type"],
+  "POST /api/service-types/reorder": ["Bulk reorder service types by ID list", "POST", "Service Type"],
+
+  // Shipping Line
+  "POST /api/shipping-lines": ["Create a shipping line", "POST", "Shipping Line"],
+  "PATCH /api/shipping-lines/:id": ["Update a shipping line", "PATCH", "Shipping Line"],
+  "DELETE /api/shipping-lines/:id": ["Soft-delete a shipping line", "DELETE", "Shipping Line"],
+
+  // Signature
+  "PUT /api/me/signature": ["Create or update the reusable saved signature", "PUT", "Signature"],
+
+  // Support Chat
+  "POST /api/support/agent/conversations": ["Start chatting with a company (returns the thread if one exists)", "POST", "Support Chat"],
+  "POST /api/support/agent/conversations/:id/messages": ["Reply as an agent, optionally with attachments", "POST", "Support Chat"],
+  "POST /api/support/agent/conversations/:id/read": ["Mark a thread read (agent side)", "POST", "Support Chat"],
+  "POST /api/support/conversation/messages": ["Send a message as the customer (optionally with attachments), opening the thread if needed", "POST", "Support Chat"],
+  "POST /api/support/conversation/read": ["Mark my company's thread read (customer side)", "POST", "Support Chat"],
+
+  // Support Content
+  "PATCH /api/support-content/documents/:slug": ["Replace a document's payload, recording a new version", "PATCH", "Support Content"],
+  "POST /api/support-content/documents/:slug/versions/:version/restore": ["Restore a version — re-saves it as a new version, never destructive", "POST", "Support Content"],
+  "POST /api/support-content/media": ["Upload an image or video for a help section", "POST", "Support Content"],
+
+  // Train
+  "POST /api/trains": ["Register a new train", "POST", "Train"],
+  "PATCH /api/trains/:id": ["Update a train", "PATCH", "Train"],
+  "DELETE /api/trains/:id": ["Delete a train", "DELETE", "Train"],
+
+  // Train Build
+  "POST /api/train-builder": ["Build a train: code + yard + 2+ locomotives (+ optional wagons)", "POST", "Train Build"],
+  "DELETE /api/train-builder/:id": ["Disband the train (release wagons and locomotives)", "DELETE", "Train Build"],
+  "POST /api/train-builder/:id/activate": ["Reactivate a deactivated train back to AVAILABLE", "POST", "Train Build"],
+  "POST /api/train-builder/:id/deactivate": ["Deactivate the train (park it) — only allowed with no active schedule", "POST", "Train Build"],
+  "PATCH /api/train-builder/:id/details": ["Edit the train's name and fixed import/export run numbers", "PATCH", "Train Build"],
+  "PUT /api/train-builder/:id/locomotives": ["Replace the locomotive set (minimum 1, same yard)", "PUT", "Train Build"],
+  "POST /api/train-builder/:id/reorder-wagons": ["Persist a drag-reorder of the full consist", "POST", "Train Build"],
+  "POST /api/train-builder/:id/wagons": ["Append AVAILABLE wagons from the train's yard to the consist", "POST", "Train Build"],
+  "DELETE /api/train-builder/:id/wagons/:wagonId": ["Detach one wagon from the consist", "DELETE", "Train Build"],
+  "POST /api/train-builder/:id/wagons/:wagonId/maintenance": ["Detach one wagon and move it to MAINTENANCE status", "POST", "Train Build"],
+  "PATCH /api/train-builder/:id/yard": ["Relocate the train — its locomotives and wagons move to the new yard with it", "PATCH", "Train Build"],
+
+  // Train Schedule
+  "POST /api/train-scheduling/bookings/:bookingId/allocate": ["Staff: place a paid booking onto a fitting train (notifies customer on date change)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bookings/:bookingId/expire": ["Staff: expire a reservation and free its capacity", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bookings/:bookingId/mark-paid": ["Staff: mark a reserved booking paid and allocate it now", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bookings/:bookingId/move-schedule": ["Re-point a booking to another OPEN same-route schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/preview": ["Preview a bulk train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/schedules": ["Create a bulk train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/schedules/:id/assign-bookings": ["Assign bulk bookings to a train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/schedules/:id/cancel": ["Cancel bulk train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/preview": ["Preview a container train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/schedules": ["Create a container train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/schedules/:id/assign-bookings": ["Assign container bookings to a train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/schedules/:id/cancel": ["Cancel container train schedule", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/global-rules": ["Update global train scheduling rules (singleton)", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/preview": ["Preview a mixed-capable train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/adjust-consist": ["Permanently trim free wagons off / couple yard wagons onto the schedule's built train (weight & length limits incl. tolerance enforced, every change logged)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/arrive": ["Mark a dispatched train arrived (move assets to destination yard, free assets)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/assign-bookings": ["Assign bookings to a train schedule (mixed-capable)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/assign-unassigned-booking": ["Assign one linked unallocated booking to wagons (preserves existing assignments)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/booking-window": ["Open or close a schedule booking window", "PATCH", "Train Schedule"],
+  "DELETE /api/train-scheduling/schedules/:id/bookings/:bookingId": ["Unassign a booking from a train schedule", "DELETE", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/bookings/:bookingId/load": ["Confirm a booking's cargo loaded at its origin yard (any direction; train must be at that yard)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/bookings/:bookingId/unload": ["Confirm a booking's cargo unloaded at its destination yard — per-booking arrival, may precede the train's final arrival", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/checkpoints": ["Log the train passing a station (final station triggers arrival)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/confirm-loading": ["Confirm cargo loaded on the train (any direction; unblocks import-Djibouti dispatch)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/container-items/:itemId": ["Update a container number on a wagon slot", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/dispatch": ["Dispatch a scheduled train", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/doc-review-complete": ["Staff finished document review early — run the batch/payment phase now (applies to the whole route-day group)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/finalize": ["Finalize a draft train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/depart": ["Depart loaded import train from Djibouti", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/documents": ["Upload/check an import Djibouti-side document", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/gatepass-granted": ["Mark import Djibouti gatepass permission granted", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/load-list": ["Generate import load list / marshalling document summary", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/loaded-on-train": ["Confirm import cargo loaded on train at Djibouti", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/ready-for-loading": ["Mark import train ready for loading at Djibouti", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/import-loading-status": ["Mark import bookings loaded/unloaded on this schedule (tracking only, does not affect dispatch)", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/intercity/:bookingId/load": ["Confirm intercity cargo loaded (train must be at the booking's origin yard)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/intercity/:bookingId/unload": ["Confirm intercity cargo unloaded at the booking's destination yard (completes the booking)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/intercity/accept": ["Accept intercity bookings onto this train (opens their pay window; capacity re-checked per booking)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/loading-status": ["Mark bookings loaded/unloaded on this schedule (any direction, pre-dispatch only)", "PATCH", "Train Schedule"],
+  // NOTE: duplicate route — also declared in modules/train-scheduling/controllers/train-scheduling.controller.ts:798.
+  // Two controllers register this same path; Nest serves whichever module loads first.
+  "POST /api/train-scheduling/schedules/:id/maintenance [modules/train-scheduling/controllers/train-scheduling.controller.ts]": ["Maintenance reschedule: move the train to a new departure with every allocated booking aboard — links, wagons and window settings unchanged", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/pin-wagons": ["Pin physical wagons to train set slots", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/run-allocation": ["Run wagon-level allocation for all eligible linked bookings", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/run-batch": ["Manually run the batch fill for a schedule", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/schedule-date": ["Reschedule a train's departure date — only before the booking window opens, and only if the new date still leaves room for the booking lead window", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/switch-government-booking": ["Switch out commercial bookings to allocate a government booking in their place", "POST", "Train Schedule"],
+  "DELETE /api/train-scheduling/schedules/:id/wagons/:trainSetWagonId": ["Remove an empty wagon slot from a train", "DELETE", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/wagons/:wagonId/move-load": ["Move a wagon's whole load to another wagon (empty → move/repin, loaded → swap loads)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/window-rule": ["Override the booking-window rule for one schedule (open/close hour, duration, doc-review, payment, lead days) — only before the window opens", "PATCH", "Train Schedule"],
+
+  // Transit Agent
+  "POST /api/transit-agents": ["Create a transit agent", "POST", "Transit Agent"],
+  "PATCH /api/transit-agents/:id": ["Update a transit agent", "PATCH", "Transit Agent"],
+  "DELETE /api/transit-agents/:id": ["Soft-delete a transit agent", "DELETE", "Transit Agent"],
+
+  // Truck Type
+  "POST /api/truck-types": ["Create a truck type", "POST", "Truck Type"],
+  "PATCH /api/truck-types/:id": ["Update a truck type", "PATCH", "Truck Type"],
+  "DELETE /api/truck-types/:id": ["Soft-delete a truck type", "DELETE", "Truck Type"],
+
+  // User Trade Access
+  "PUT /api/user-trade-access/:userId": ["Set the trade directions a backoffice user may see", "PUT", "User Trade Access"],
+
+  // Vehicle
+  "POST /api/vehicles": ["Create a new vehicle", "POST", "Vehicle"],
+  "PATCH /api/vehicles/:id": ["Update a vehicle", "PATCH", "Vehicle"],
+  "DELETE /api/vehicles/:id": ["Delete a vehicle", "DELETE", "Vehicle"],
+
+  // Wagon
+  "POST /api/wagons": ["Create a new wagon", "POST", "Wagon"],
+  "PATCH /api/wagons/:id": ["Update a wagon", "PATCH", "Wagon"],
+  "DELETE /api/wagons/:id": ["Delete a wagon", "DELETE", "Wagon"],
+  "POST /api/wagons/:id/assign-train": ["Assign wagon to a train", "POST", "Wagon"],
+  "DELETE /api/wagons/:id/permanent": ["Permanently delete a wagon (irreversible; refused if it has movements, containers or train-set slots)", "DELETE", "Wagon"],
+  "POST /api/wagons/:id/unassign-train": ["Unassign wagon from train", "POST", "Wagon"],
+  "POST /api/wagons/bulk-status": ["Set the status of multiple wagons (audited in wagon_status_logs)", "POST", "Wagon"],
+  "POST /api/wagons/bulk-transfer": ["Transfer multiple wagons to a destination yard", "POST", "Wagon"],
+
+  // Wagon Transfer Request
+  "POST /api/wagon-transfer-requests": ["File a count-only wagon-transfer request", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/:id/cancel": ["Withdraw a request that has not moved any wagon yet (use close-short once wagons have moved)", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/:id/close-short": ["OCC: end the request with fewer wagons than asked for — what moved stays, the requester is told the shortfall", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/:id/fulfill": ["OCC: pick wagons and execute the transfer", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/bulk-fulfill": ["OCC: accept-and-execute a subset of pending requests (auto-picks available wagons; the rest stay PENDING)", "POST", "Wagon Transfer Request"],
+
+  // Wagon Type
+  "POST /api/wagon-types": ["Create a wagon type", "POST", "Wagon Type"],
+  "PATCH /api/wagon-types/:id": ["Update a wagon type", "PATCH", "Wagon Type"],
+  "DELETE /api/wagon-types/:id": ["Soft-delete a wagon type", "DELETE", "Wagon Type"],
+
+  // Warehouse
+  "POST /api/warehouse-allocation-rules": ["Create a warehouse allocation rule", "POST", "Warehouse"],
+  "PATCH /api/warehouse-allocation-rules/:id": ["Update a warehouse allocation rule", "PATCH", "Warehouse"],
+  "DELETE /api/warehouse-allocation-rules/:id": ["Delete a warehouse allocation rule", "DELETE", "Warehouse"],
+  "POST /api/warehouse-allocation/preview": ["Preview the yard/warehouse/zone a booking would be allocated to", "POST", "Warehouse"],
+  "POST /api/warehouse-fee-rules": ["Create a storage / demurrage fee rule", "POST", "Warehouse"],
+  "PATCH /api/warehouse-fee-rules/:id": ["Update a fee rule", "PATCH", "Warehouse"],
+  "DELETE /api/warehouse-fee-rules/:id": ["Delete a fee rule", "DELETE", "Warehouse"],
+  "POST /api/warehouse-fees/accrual/:inventoryId/acknowledge": ["Acknowledge / snooze an item fee-accrual alert", "POST", "Warehouse"],
+  "DELETE /api/warehouse-fees/accrual/:inventoryId/acknowledge": ["Remove an accrual acknowledgement (re-surface for alerts)", "DELETE", "Warehouse"],
+  "POST /api/warehouses": ["Create warehouse", "POST", "Warehouse"],
+  "PATCH /api/warehouses/:id": ["Update warehouse", "PATCH", "Warehouse"],
+  "POST /api/warehouses/:warehouseId/yards": ["Create a yard within a warehouse", "POST", "Warehouse"],
+
+  // Warehouse Fee Invoice
+  "POST /api/last-mile/:id/generate-truck-detention-invoice": ["Generate a truck-detention invoice for a last-mile leg (per truck per day)", "POST", "Warehouse Fee Invoice"],
+  "PATCH /api/warehouse-fee-invoices/:id/cancel": ["Cancel a warehouse fee invoice", "PATCH", "Warehouse Fee Invoice"],
+  "POST /api/warehouse-fee-invoices/:id/pay": ["Record a payment against a warehouse fee invoice", "POST", "Warehouse Fee Invoice"],
+  "POST /api/warehouse-fee-invoices/:id/pay-online": ["Initiate Telebirr/Waafi payment for a warehouse fee invoice", "POST", "Warehouse Fee Invoice"],
+  "POST /api/warehouse-inventory/:id/generate-fee-invoice": ["Generate a warehouse fee invoice from Batch 5 fee calculation", "POST", "Warehouse Fee Invoice"],
+
+  // Warehouse Inspection Report
+  "PATCH /api/warehouse-inspection-reports/:id": ["Update an inspection report", "PATCH", "Warehouse Inspection Report"],
+  "POST /api/warehouse-inspection-reports/:id/attachments": ["Upload inspection images / documents", "POST", "Warehouse Inspection Report"],
+  "POST /api/warehouse-inventory/:inventoryId/inspection-reports": ["Create an inspection / damage report for an inventory item", "POST", "Warehouse Inspection Report"],
+
+  // Warehouse Inventory
+  "POST /api/warehouse-inventory/:id/deliver": ["Deliver import goods to the customer + capture proof of delivery", "POST", "Warehouse Inventory"],
+  "PATCH /api/warehouse-inventory/:id/dispatch": ["Mark loaded inventory DISPATCHED (left the terminal)", "PATCH", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/gate-clearance": ["Final terminal release / gate clearance (blocked while fees unpaid)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/load": ["Load READY_FOR_LOADING inventory onto a wagon", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/move": ["Move inventory to another warehouse/yard/zone", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/ready-for-loading": ["Mark reserved inventory READY_FOR_LOADING", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/ready-for-pickup": ["Mark inspected IMPORT inventory READY_FOR_PICKUP", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/release": ["Issue a DO / release order for ready-for-pickup inventory", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/store": ["Mark received inventory as STORED (optional explicit warehouse/yard/zone)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/auto-load-ready": ["Auto-load READY_FOR_LOADING inventory with PAID bookings", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/auto-unload-arrived": ["Bulk auto-unload all arrived bookings into the warehouse", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bookings/:bookingId/approve-delivery": ["Approve delivery — customer records their full name (signature optional)", "POST", "Warehouse Inventory"],
+  "PATCH /api/warehouse-inventory/bookings/:bookingId/double-handling": ["Record Yes/No double handling after unloading (Yes applies the double-handling fee rule)", "PATCH", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bookings/:bookingId/request-handover-signature": ["Ask the customer to sign the handover (creates one if none, then notifies)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bookings/:bookingId/unload": ["Unload a single arrived booking into a location", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bulk-dispatch-export": ["Bulk-dispatch loaded EXPORT inventory (LOADED → DISPATCHED)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bulk-mark-inspected": ["Bulk mark received inventory inspection PASSED (EXPORT → READY_FOR_LOADING)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/export/auto-unload-at-djibouti": ["Unload all eligible export items assigned to an arrived Djibouti-side train", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/handovers/:handoverId/sign": ["Customer signs one handover (EDR last-mile: one signature per truck)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/import/auto-unload-arrived-bookings": ["Unload all eligible assigned bookings of an ARRIVED import train (→ UNLOADED)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/receive": ["Receive inventory at a warehouse location", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/receive-bulk": ["Bulk-receive selected eligible PAID bookings into a location", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/reserve": ["Reserve stored inventory for a PAID booking", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/train/:scheduleId/load": ["Load selected inventory items onto their allocated wagons for a train", "POST", "Warehouse Inventory"],
+
+  // Warehouse Yard
+  "PATCH /api/warehouse-yards/:id": ["Update warehouse yard", "PATCH", "Warehouse Yard"],
+  "POST /api/warehouse-yards/:yardId/zones": ["Create a zone within a yard", "POST", "Warehouse Yard"],
+
+  // Warehouse Zone
+  "PATCH /api/warehouse-zones/:id": ["Update warehouse zone", "PATCH", "Warehouse Zone"],
+
+  // Weight Limit Rule
+  "POST /api/weight-limit-rules": ["Create a weight limit rule", "POST", "Weight Limit Rule"],
+  "PATCH /api/weight-limit-rules/:id": ["Update a weight limit rule", "PATCH", "Weight Limit Rule"],
+  "DELETE /api/weight-limit-rules/:id": ["Soft-delete a weight limit rule", "DELETE", "Weight Limit Rule"],
+
+  // Yard
+  "POST /api/yards": ["Create a yard", "POST", "Yard"],
+  "PATCH /api/yards/:id": ["Update a yard", "PATCH", "Yard"],
+  "DELETE /api/yards/:id": ["Soft-delete a yard", "DELETE", "Yard"],
+  "POST /api/yards/:id/move-order": ["Move a yard up or down in display order", "POST", "Yard"],
+  "POST /api/yards/reorder": ["Bulk reorder yards by ID list", "POST", "Yard"],
+
+  // Yard Distance
+  "POST /api/yard-distances": ["Create a yard distance", "POST", "Yard Distance"],
+  "PATCH /api/yard-distances/:id": ["Update a yard distance", "PATCH", "Yard Distance"],
+  "DELETE /api/yard-distances/:id": ["Soft-delete a yard distance", "DELETE", "Yard Distance"],
+};
+
+module.exports = AUDIT_ENDPOINTS;
diff --git a/apps/edr-freight-api/docs/audit-endpoints.md b/apps/edr-freight-api/docs/audit-endpoints.md
new file mode 100644
index 000000000..38e89e367
--- /dev/null
+++ b/apps/edr-freight-api/docs/audit-endpoints.md
@@ -0,0 +1,922 @@
+# Freight API — Mutating Endpoints (Audit Surface)
+
+Every state-changing route in `apps/edr-freight-api` — `POST`, `PUT`, `PATCH`, `DELETE`.
+This is the candidate surface for audit logging: each row is an action a user can take
+that changes persisted state and therefore needs a who / what / when trail.
+
+All paths include the global prefix `api` (`app.setGlobalPrefix("api")` in `src/main.ts`).
+Titles come from each route's `@ApiOperation({ summary })`; where a route has none,
+the title is derived from its handler name.
+
+> Generated by reading the `@Post` / `@Put` / `@Patch` / `@Delete` decorators in
+> `src/**/*.controller.ts`. Re-generate after adding routes so this stays complete.
+
+## Summary
+
+| Method | Count |
+| --- | ---: |
+| `POST` | 351 |
+| `PUT` | 8 |
+| `PATCH` | 72 |
+| `DELETE` | 61 |
+| **Total** | **492** |
+
+Across **66** entities.
+
+## Entity index
+
+| Entity | Endpoints |
+| --- | ---: |
+| [Account](#account) | 3 |
+| [AI Assist](#ai-assist) | 1 |
+| [Approval Rule](#approval-rule) | 5 |
+| [Booking](#booking) | 57 |
+| [Cargo](#cargo) | 6 |
+| [Cargo Type](#cargo-type) | 5 |
+| [Company](#company) | 30 |
+| [Compliance](#compliance) | 3 |
+| [Consignment](#consignment) | 1 |
+| [Container](#container) | 5 |
+| [Container Type](#container-type) | 5 |
+| [Contract](#contract) | 68 |
+| [Contract Template](#contract-template) | 8 |
+| [Driver](#driver) | 5 |
+| [Dropdown Setting](#dropdown-setting) | 7 |
+| [EIMS Invoice](#eims-invoice) | 3 |
+| [Exchange Setting](#exchange-setting) | 1 |
+| [Facility](#facility) | 3 |
+| [Fayda Verification](#fayda-verification) | 1 |
+| [File Upload Setting](#file-upload-setting) | 7 |
+| [First Mile](#first-mile) | 7 |
+| [Fuel](#fuel) | 1 |
+| [GPS Tracking](#gps-tracking) | 3 |
+| [Import Operation](#import-operation) | 9 |
+| [Incident](#incident) | 3 |
+| [Interchange Document](#interchange-document) | 3 |
+| [Last Mile](#last-mile) | 10 |
+| [Last Mile Request](#last-mile-request) | 4 |
+| [Locomotive](#locomotive) | 4 |
+| [Maintenance](#maintenance) | 13 |
+| [Notification Inbox](#notification-inbox) | 2 |
+| [Organization User](#organization-user) | 2 |
+| [OTP](#otp) | 2 |
+| [Password Reset](#password-reset) | 4 |
+| [Payment](#payment) | 7 |
+| [Priority Config](#priority-config) | 5 |
+| [Priority Rule Change Request](#priority-rule-change-request) | 3 |
+| [Procurement](#procurement) | 8 |
+| [Rate](#rate) | 5 |
+| [Rate Change Request](#rate-change-request) | 3 |
+| [Route](#route) | 4 |
+| [Schedule](#schedule) | 3 |
+| [Service Type](#service-type) | 5 |
+| [Shipping Line](#shipping-line) | 3 |
+| [Signature](#signature) | 1 |
+| [Support Chat](#support-chat) | 5 |
+| [Support Content](#support-content) | 3 |
+| [Train](#train) | 3 |
+| [Train Build](#train-build) | 11 |
+| [Train Schedule](#train-schedule) | 48 |
+| [Transit Agent](#transit-agent) | 3 |
+| [Truck Type](#truck-type) | 3 |
+| [User Trade Access](#user-trade-access) | 1 |
+| [Vehicle](#vehicle) | 3 |
+| [Wagon](#wagon) | 8 |
+| [Wagon Transfer Request](#wagon-transfer-request) | 5 |
+| [Wagon Type](#wagon-type) | 3 |
+| [Warehouse](#warehouse) | 12 |
+| [Warehouse Fee Invoice](#warehouse-fee-invoice) | 5 |
+| [Warehouse Inspection Report](#warehouse-inspection-report) | 3 |
+| [Warehouse Inventory](#warehouse-inventory) | 24 |
+| [Warehouse Yard](#warehouse-yard) | 2 |
+| [Warehouse Zone](#warehouse-zone) | 1 |
+| [Weight Limit Rule](#weight-limit-rule) | 3 |
+| [Yard](#yard) | 5 |
+| [Yard Distance](#yard-distance) | 3 |
+
+---
+
+## Endpoints by entity
+
+### Account
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Send a verification code to a new email/phone before changing it | `POST` | `/api/me/contact/otp` | `modules/auth/account.controller.ts:26` |
+| Change the account's email or phone, gated by a verification code | `PATCH` | `/api/me/contact` | `modules/auth/account.controller.ts:40` |
+| Change the account's display name | `PATCH` | `/api/me/name` | `modules/auth/account.controller.ts:54` |
+
+### AI Assist
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Mock AI: extract structured booking fields from free-text request | `POST` | `/api/ai/booking/extract` | `modules/ai/ai.controller.ts:16` |
+
+### Approval Rule
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create an approval rule step | `POST` | `/api/approval-rules` | `modules/rule-engine/controllers/approval-rules.controller.ts:66` |
+| Move an approval step up or down within its chain | `POST` | `/api/approval-rules/:id/move-order` | `modules/rule-engine/controllers/approval-rules.controller.ts:51` |
+| Bulk reorder approval steps within a chain | `POST` | `/api/approval-rules/reorder` | `modules/rule-engine/controllers/approval-rules.controller.ts:43` |
+| Update an approval rule | `PATCH` | `/api/approval-rules/:id` | `modules/rule-engine/controllers/approval-rules.controller.ts:73` |
+| Soft-delete an approval rule | `DELETE` | `/api/approval-rules/:id` | `modules/rule-engine/controllers/approval-rules.controller.ts:80` |
+
+### Booking
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new freight booking (DRAFT) | `POST` | `/api/bookings` | `modules/bookings/bookings.controller.ts:170` |
+| Allocate containers to vehicles | `POST` | `/api/bookings/:bookingId/allocate-containers` | `modules/bookings/booking-allocation.controller.ts:13` |
+| Cancel booking | `POST` | `/api/bookings/:id/cancel` | `modules/bookings/bookings.controller.ts:1544` |
+| Customer cancels an unpaid hold (SELECTED_FOR_BATCH → CANCELLED); | `POST` | `/api/bookings/:id/cancel-hold` | `modules/bookings/bookings.controller.ts:1568` |
+| GL ET uploads customs declaration on booking (GENERAL customs) | `POST` | `/api/bookings/:id/clearance/declaration` | `modules/bookings/bookings.controller.ts:1126` |
+| Upload Booking Delivery Order | `POST` | `/api/bookings/:id/clearance/delivery-order` | `modules/bookings/bookings.controller.ts:1268` |
+| Customer uploads clearance documents (fieldname = document key) | `POST` | `/api/bookings/:id/clearance/documents` | `modules/bookings/bookings.controller.ts:959` |
+| GL ET sends a draft customs declaration (multi-file) with an estimated price for the customer to review | `POST` | `/api/bookings/:id/clearance/draft-declaration` | `modules/bookings/bookings.controller.ts:1175` |
+| Customer accepts the draft customs declaration — unlocks the real customs declaration step for GL Ethiopia | `POST` | `/api/bookings/:id/clearance/draft-declaration/accept` | `modules/bookings/bookings.controller.ts:1200` |
+| Customer requests a change to the draft customs declaration with a reason — GL Ethiopia sends a corrected draft (repeatable) | `POST` | `/api/bookings/:id/clearance/draft-declaration/change` | `modules/bookings/bookings.controller.ts:1211` |
+| GL ET sets duty/tax on booking with notice attachment | `POST` | `/api/bookings/:id/clearance/duty` | `modules/bookings/bookings.controller.ts:1144` |
+| Customer uploads duty/tax payment slip on booking | `POST` | `/api/bookings/:id/clearance/duty-slip` | `modules/bookings/bookings.controller.ts:1238` |
+| Confirm Booking Export Release | `POST` | `/api/bookings/:id/clearance/export-release` | `modules/bookings/bookings.controller.ts:1326` |
+| GL finalizes clearance (requires 100% approved) → CLEARANCE_READY | `POST` | `/api/bookings/:id/clearance/finalize` | `modules/bookings/bookings.controller.ts:1087` |
+| GL ET finalizes import pre-clearance on booking | `POST` | `/api/bookings/:id/clearance/finalize-pre-clearance` | `modules/bookings/bookings.controller.ts:1230` |
+| GL uploads customs output documents (IM4/EX3/…) | `POST` | `/api/bookings/:id/clearance/output-documents` | `modules/bookings/bookings.controller.ts:1071` |
+| Customer requests operation with a schedule day | `POST` | `/api/bookings/:id/clearance/proceed` | `modules/bookings/bookings.controller.ts:979` |
+| Upload Booking Release Order | `POST` | `/api/bookings/:id/clearance/release-order` | `modules/bookings/bookings.controller.ts:1288` |
+| GL reviews a clearance document (Approve | Query) | `POST` | `/api/bookings/:id/clearance/review` | `modules/bookings/bookings.controller.ts:1051` |
+| Request Booking RO Amendment | `POST` | `/api/bookings/:id/clearance/ro-amendment` | `modules/bookings/bookings.controller.ts:1311` |
+| GL Djibouti picks the transit officer from the roster — unblocks the customs declaration; calling again reassigns | `POST` | `/api/bookings/:id/clearance/transit-assignee/assign` | `modules/bookings/bookings.controller.ts:1112` |
+| GL ET asks GL Djibouti to name the transit officer — required before the import customs declaration | `POST` | `/api/bookings/:id/clearance/transit-assignee/request` | `modules/bookings/bookings.controller.ts:1098` |
+| Upload Booking Transit Permit | `POST` | `/api/bookings/:id/clearance/transit-permit` | `modules/bookings/bookings.controller.ts:1251` |
+| Confirm submit after price change | `POST` | `/api/bookings/:id/confirm-submit` | `modules/bookings/bookings.controller.ts:906` |
+| Request freight consolidation | `POST` | `/api/bookings/:id/consolidation` | `modules/bookings/bookings.controller.ts:1583` |
+| Generate contract PDF from template | `POST` | `/api/bookings/:id/contract/generate` | `modules/bookings/bookings.controller.ts:1406` |
+| Apply digital signature (customer or staff) | `POST` | `/api/bookings/:id/contract/sign` | `modules/bookings/bookings.controller.ts:1452` |
+| Customer cancels their own booking before payment — no cancellation fee | `POST` | `/api/bookings/:id/customer-cancel` | `modules/bookings/bookings.controller.ts:1555` |
+| Customer assigns external truck and driver for terminal pickup | `POST` | `/api/bookings/:id/customer-truck-assignment` | `modules/bookings/bookings.controller.ts:460` |
+| Add a customer self-haul truck carrying 1–2 of the booking containers | `POST` | `/api/bookings/:id/customer-trucks` | `modules/bookings/bookings.controller.ts:686` |
+| Register an import truck leaving: containers loaded + weighed gross (staff) | `POST` | `/api/bookings/:id/customer-trucks/:assignmentId/depart` | `modules/bookings/bookings.controller.ts:788` |
+| Truck_dispatch: load selected containers onto a truck (staff) | `POST` | `/api/bookings/:id/customer-trucks/:assignmentId/load` | `modules/bookings/bookings.controller.ts:773` |
+| Bulk add customer trucks from array payload (Excel parsed) | `POST` | `/api/bookings/:id/customer-trucks/bulk` | `modules/bookings/bookings.controller.ts:701` |
+| Customer digital signature (deprecated — use POST contract/sign) | `POST` | `/api/bookings/:id/customer/sign` | `modules/bookings/bookings.controller.ts:1487` |
+| Upload documents for a booking (DRAFT only) | `POST` | `/api/bookings/:id/documents` | `modules/bookings/bookings.controller.ts:869` |
+| Generate a GRN over the received containers (all received, or a subset) — one GRN per batch | `POST` | `/api/bookings/:id/generate-grn` | `modules/bookings/bookings.controller.ts:820` |
+| Generate price preview (DRAFT or CHANGES_REQUESTED) | `POST` | `/api/bookings/:id/generate-price` | `modules/bookings/bookings.controller.ts:882` |
+| Expedite government booking to PAID / ELIGIBLE for scheduling | `POST` | `/api/bookings/:id/government-expedite` | `modules/bookings/bookings.controller.ts:1390` |
+| Staff contract signature and fully execute (use contract/sign STAFF preferred) | `POST` | `/api/bookings/:id/marketing/approve` | `modules/bookings/bookings.controller.ts:1505` |
+| Operations reviews an operation request: ACCEPT (→ batch pool), | `POST` | `/api/bookings/:id/operation/review` | `modules/bookings/bookings.controller.ts:1030` |
+| Mark completed | `POST` | `/api/bookings/:id/operations/complete` | `modules/bookings/bookings.controller.ts:1536` |
+| Mark in transit | `POST` | `/api/bookings/:id/operations/start-transit` | `modules/bookings/bookings.controller.ts:1528` |
+| Customer reject price estimate | `POST` | `/api/bookings/:id/reject` | `modules/bookings/bookings.controller.ts:918` |
+| Staff accept intake → set contract validity window + start approval chain | `POST` | `/api/bookings/:id/staff/accept` | `modules/bookings/bookings.controller.ts:1355` |
+| Staff final reject | `POST` | `/api/bookings/:id/staff/reject` | `modules/bookings/bookings.controller.ts:1374` |
+| Staff return booking for customer updates | `POST` | `/api/bookings/:id/staff/request-changes` | `modules/bookings/bookings.controller.ts:1339` |
+| Customer submit booking | `POST` | `/api/bookings/:id/submit` | `modules/bookings/bookings.controller.ts:894` |
+| Request a partial wagon cancellation on a PAID booking — opens the cancellation-fee invoice; wagons are released only once the fee settles | `POST` | `/api/bookings/:id/wagon-cancellations` | `modules/bookings/bookings.controller.ts:558` |
+| Preview the fee/credit of a partial wagon cancellation (no writes) | `POST` | `/api/bookings/:id/wagon-cancellations/preview` | `modules/bookings/bookings.controller.ts:544` |
+| Rebook a wagon-cancellation credit: pick a shipment day only — the new booking is created under the contract and marked PAID (freight already paid; contract must still be valid) | `POST` | `/api/bookings/wagon-cancellations/:cancellationId/rebook` | `modules/bookings/bookings.controller.ts:638` |
+| Withdraw a fee-pending wagon cancellation (owner, or staff with the void permission) | `POST` | `/api/bookings/wagon-cancellations/:cancellationId/withdraw` | `modules/bookings/bookings.controller.ts:624` |
+| Update booking | `PATCH` | `/api/bookings/:id` | `modules/bookings/bookings.controller.ts:211` |
+| Edit a not-yet-arrived customer truck (plate/driver/type + containers) | `PATCH` | `/api/bookings/:id/customer-trucks/:assignmentId` | `modules/bookings/bookings.controller.ts:716` |
+| Export only: choose direct truck-to-train (no warehouse, no GRN) or warehouse first | `PATCH` | `/api/bookings/:id/export-handover-mode` | `modules/bookings/bookings.controller.ts:761` |
+| Soft-delete DRAFT booking | `DELETE` | `/api/bookings/:id` | `modules/bookings/bookings.controller.ts:861` |
+| Remove consolidation pairing | `DELETE` | `/api/bookings/:id/consolidation` | `modules/bookings/bookings.controller.ts:1590` |
+| Remove a not-yet-arrived customer truck from a booking | `DELETE` | `/api/bookings/:id/customer-trucks/:assignmentId` | `modules/bookings/bookings.controller.ts:732` |
+
+### Cargo
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new cargo | `POST` | `/api/cargoes` | `modules/cargoes/cargoes.controller.ts:34` |
+| Mark cargo as delivered | `POST` | `/api/cargoes/:id/deliver` | `modules/cargoes/cargoes.controller.ts:81` |
+| Load cargo into a container | `POST` | `/api/cargoes/:id/load` | `modules/cargoes/cargoes.controller.ts:67` |
+| Unload cargo from container | `POST` | `/api/cargoes/:id/unload` | `modules/cargoes/cargoes.controller.ts:74` |
+| Update a cargo | `PATCH` | `/api/cargoes/:id` | `modules/cargoes/cargoes.controller.ts:53` |
+| Delete a cargo | `DELETE` | `/api/cargoes/:id` | `modules/cargoes/cargoes.controller.ts:60` |
+
+### Cargo Type
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a cargo type | `POST` | `/api/cargo-types` | `modules/rule-engine/controllers/cargo-types.controller.ts:51` |
+| Move a cargo type up or down in display order | `POST` | `/api/cargo-types/:id/move-order` | `modules/rule-engine/controllers/cargo-types.controller.ts:36` |
+| Bulk reorder cargo types by ID list | `POST` | `/api/cargo-types/reorder` | `modules/rule-engine/controllers/cargo-types.controller.ts:28` |
+| Update a cargo type | `PATCH` | `/api/cargo-types/:id` | `modules/rule-engine/controllers/cargo-types.controller.ts:58` |
+| Soft-delete a cargo type | `DELETE` | `/api/cargo-types/:id` | `modules/rule-engine/controllers/cargo-types.controller.ts:65` |
+
+### Company
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new company (customer, freight_forwarder, dj_freight_forwarder, transporter) | `POST` | `/api/companies` | `modules/companies/companies.controller.ts:565` |
+| Upload documents for a company (onboarding) | `POST` | `/api/companies/:companyId/documents` | `modules/companies/companies.controller.ts:728` |
+| Add a profile (employee) to a company | `POST` | `/api/companies/:companyId/profiles` | `modules/companies/companies.controller.ts:843` |
+| Approve a pending profile change request (applies the changes) | `POST` | `/api/companies/change-requests/:id/approve` | `modules/companies/companies.controller.ts:790` |
+| Reject a pending profile change request with a note | `POST` | `/api/companies/change-requests/:id/reject` | `modules/companies/companies.controller.ts:806` |
+| Ask for specific changes on a pending request without rejecting it (row stays open, next edit appends to it) | `POST` | `/api/companies/change-requests/:id/request-changes` | `modules/companies/companies.controller.ts:824` |
+| Create a single operational profile for the current user's company. The role starts pending and does not become the active mode | `POST` | `/api/companies/company-profile` | `modules/companies/companies.controller.ts:272` |
+| Add operational profile(s) (importer/exporter/forwarder) to the current user's company | `POST` | `/api/companies/company-profiles` | `modules/companies/companies.controller.ts:229` |
+| Add business-license document(s) to a profile. For an approved company | `POST` | `/api/companies/company-profiles/:profileId/license` | `modules/companies/companies.controller.ts:290` |
+| Replace a business-license file with a newly uploaded one (staged for | `POST` | `/api/companies/company-profiles/:profileId/license/:fileId/replace` | `modules/companies/companies.controller.ts:311` |
+| Resubmit a rejected operational role for approval (→ pending) | `POST` | `/api/companies/company-profiles/:profileId/reapply` | `modules/companies/companies.controller.ts:165` |
+| Create a company with its associated external profile (onboarding) | `POST` | `/api/companies/create` | `modules/companies/companies.controller.ts:539` |
+| Ask the customer to correct one uploaded document | `POST` | `/api/companies/documents/:fileId/request-change` | `modules/companies/companies.controller.ts:699` |
+| Fetch company info from eTrade by TIN | `POST` | `/api/companies/fetch-etrade-info` | `modules/companies/companies.controller.ts:197` |
+| Bind a completed Fayda verification to the company's owner or Power of Attorney | `POST` | `/api/companies/identity/fayda/complete` | `modules/companies/companies.controller.ts:414` |
+| Declare the General Manager is the company's owner, copying the owner's verified identity across | `POST` | `/api/companies/identity/gm/same-as-owner` | `modules/companies/companies.controller.ts:432` |
+| Declare the Power of Attorney is the company's owner, copying the owner's identity across | `POST` | `/api/companies/identity/poa/same-as-owner` | `modules/companies/companies.controller.ts:461` |
+| Mark the current user's onboarding as complete | `POST` | `/api/companies/onboarding/complete` | `modules/companies/companies.controller.ts:527` |
+| Begin onboarding: create a draft company + profile + role(s) so later steps can save incrementally | `POST` | `/api/companies/onboarding/start` | `modules/companies/companies.controller.ts:246` |
+| Upload the Power of Attorney delegation letter, replacing any existing one | `POST` | `/api/companies/poa-delegation` | `modules/companies/companies.controller.ts:380` |
+| Update a company | `PATCH` | `/api/companies/:id` | `modules/companies/companies.controller.ts:613` |
+| Update a company profile's approval status | `PATCH` | `/api/companies/company-profiles/:profileId/status` | `modules/companies/companies.controller.ts:748` |
+| Persist the user's current onboarding wizard step | `PATCH` | `/api/companies/onboarding-step` | `modules/companies/companies.controller.ts:504` |
+| Update profile (flattened settings page) | `PATCH` | `/api/companies/profile` | `modules/companies/companies.controller.ts:219` |
+| Soft-delete a company | `DELETE` | `/api/companies/:id` | `modules/companies/companies.controller.ts:634` |
+| Remove a business-license file (staged for review on an approved company) | `DELETE` | `/api/companies/company-profiles/:profileId/license/:fileId` | `modules/companies/companies.controller.ts:338` |
+| Remove the company's Power of Attorney — the verified identity, its details and the delegation paper together | `DELETE` | `/api/companies/identity/fayda/poa` | `modules/companies/companies.controller.ts:491` |
+| Clear the General Manager's identity — the \"same as owner\" declaration or a verification, and the details either wrote | `DELETE` | `/api/companies/identity/gm` | `modules/companies/companies.controller.ts:448` |
+| Undo the Power of Attorney \"same as owner\" declaration and the identity it copied, leaving the representative open to be verified in their own right | `DELETE` | `/api/companies/identity/poa/same-as-owner` | `modules/companies/companies.controller.ts:478` |
+| Remove the Power of Attorney delegation letter (staged for review on an approved company) | `DELETE` | `/api/companies/poa-delegation/:fileId` | `modules/companies/companies.controller.ts:401` |
+
+### Compliance
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a compliance record | `POST` | `/api/compliance` | `modules/compliance/compliance.controller.ts:23` |
+| Update a compliance record | `PATCH` | `/api/compliance/:id` | `modules/compliance/compliance.controller.ts:51` |
+| Soft-delete a compliance record | `DELETE` | `/api/compliance/:id` | `modules/compliance/compliance.controller.ts:58` |
+
+### Consignment
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new consignment | `POST` | `/api/consignments` | `modules/consignments/consignments.controller.ts:29` |
+
+### Container
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new container | `POST` | `/api/containers` | `modules/container-management/containers.controller.ts:33` |
+| Assign container to a wagon | `POST` | `/api/containers/:id/assign-wagon` | `modules/container-management/containers.controller.ts:66` |
+| Unassign container from wagon | `POST` | `/api/containers/:id/unassign-wagon` | `modules/container-management/containers.controller.ts:73` |
+| Update a container | `PATCH` | `/api/containers/:id` | `modules/container-management/containers.controller.ts:52` |
+| Delete a container | `DELETE` | `/api/containers/:id` | `modules/container-management/containers.controller.ts:59` |
+
+### Container Type
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a container type | `POST` | `/api/container-types` | `modules/rule-engine/controllers/container-types.controller.ts:51` |
+| Move a container type up or down in display order | `POST` | `/api/container-types/:id/move-order` | `modules/rule-engine/controllers/container-types.controller.ts:36` |
+| Bulk reorder container types by ID list | `POST` | `/api/container-types/reorder` | `modules/rule-engine/controllers/container-types.controller.ts:28` |
+| Update a container type | `PATCH` | `/api/container-types/:id` | `modules/rule-engine/controllers/container-types.controller.ts:58` |
+| Soft-delete a container type | `DELETE` | `/api/container-types/:id` | `modules/rule-engine/controllers/container-types.controller.ts:65` |
+
+### Contract
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new contract (DRAFT) with routes + cargo scope | `POST` | `/api/contracts` | `modules/contracts/contracts.controller.ts:188` |
+| Approve one approval step in sequence | `POST` | `/api/contracts/:id/approval-steps/:stepId/approve` | `modules/contracts/contracts.controller.ts:552` |
+| Reject one approval step — to the customer (terminal → REJECTED) or, via returnToStepId, back to an earlier approver (chain re-runs from there) | `POST` | `/api/contracts/:id/approval-steps/:stepId/reject` | `modules/contracts/contracts.controller.ts:571` |
+| Customer submits a shipment request on a GENERAL customs contract | `POST` | `/api/contracts/:id/booking-requests` | `modules/contracts/contracts.controller.ts:170` |
+| Create a shipment booking under a contract — Path A (customer) or Path B (GL Ethiopia) | `POST` | `/api/contracts/:id/bookings` | `modules/contracts/contracts.controller.ts:1076` |
+| Complete an initiated booking after Operations finalized its clearance — cargo + binding day, window and departure checks, pricing and invoicing | `POST` | `/api/contracts/:id/bookings/:bookingId/complete` | `modules/contracts/contracts.controller.ts:1133` |
+| Initiate a bare booking instance under an import/export contract (ONE_TIME or GENERAL) — no cargo, no date; enters per-booking clearance (AWAITING_DOCUMENTS). ONE_TIME customs instances are opened by the customer (or GL); GENERAL customs comes from a shipment request | `POST` | `/api/contracts/:id/bookings/initiate` | `modules/contracts/contracts.controller.ts:1105` |
+| Customer cancels their own contract (blocked while a booking is live) | `POST` | `/api/contracts/:id/cancel` | `modules/contracts/contracts.controller.ts:526` |
+| GL ET uploads customs declaration documents (multi-file) | `POST` | `/api/contracts/:id/clearance/declaration` | `modules/contracts/contracts.controller.ts:795` |
+| GL DJ uploads Delivery Order (import) with vessel arrival + DO collected dates | `POST` | `/api/contracts/:id/clearance/delivery-order` | `modules/contracts/contracts.controller.ts:957` |
+| Customer uploads clearance documents (fieldname = document key) | `POST` | `/api/contracts/:id/clearance/documents` | `modules/contracts/contracts.controller.ts:734` |
+| GL replaces a clearance document in place (reason required) — the previous version is kept in the file history and the new one needs approving | `POST` | `/api/contracts/:id/clearance/documents/:fileKey/replace` | `modules/contracts/contracts.controller.ts:894` |
+| GL ET sets duty/tax requirement and advises amount with notice attachment | `POST` | `/api/contracts/:id/clearance/duty` | `modules/contracts/contracts.controller.ts:808` |
+| Customer uploads duty/tax payment slip on contract | `POST` | `/api/contracts/:id/clearance/duty-slip` | `modules/contracts/contracts.controller.ts:932` |
+| Customer disputes the advised duty/tax with a reason — reopens the step so GL Ethiopia can re-advise (repeatable) | `POST` | `/api/contracts/:id/clearance/duty/dispute` | `modules/contracts/contracts.controller.ts:918` |
+| GL ET confirms export release after declaration | `POST` | `/api/contracts/:id/clearance/export-release` | `modules/contracts/contracts.controller.ts:1008` |
+| GL ET finalizes clearance → CLEARANCE_READY_FOR_BOOKING (legacy) | `POST` | `/api/contracts/:id/clearance/finalize` | `modules/contracts/contracts.controller.ts:788` |
+| GL ET finalizes export clearance after post-booking transit permit upload | `POST` | `/api/contracts/:id/clearance/finalize-export-clearance` | `modules/contracts/contracts.controller.ts:1018` |
+| GL ET finalizes import pre-clearance — unlocks Djibouti DO upload | `POST` | `/api/contracts/:id/clearance/finalize-pre-clearance` | `modules/contracts/contracts.controller.ts:838` |
+| Operations finalizes self-clearance → customer may create the booking | `POST` | `/api/contracts/:id/clearance/ops-finalize` | `modules/contracts/contracts.controller.ts:1051` |
+| Operations reviews a customer self-clearance document (Approve | Query) | `POST` | `/api/contracts/:id/clearance/ops-review` | `modules/contracts/contracts.controller.ts:1032` |
+| GL uploads customs output documents (IM4/EX3/…) pre-booking | `POST` | `/api/contracts/:id/clearance/output-documents` | `modules/contracts/contracts.controller.ts:776` |
+| GL DJ uploads Release Order + vessel departure date (export) | `POST` | `/api/contracts/:id/clearance/release-order` | `modules/contracts/contracts.controller.ts:978` |
+| GL ET reviews a clearance document (Approve | Query) | `POST` | `/api/contracts/:id/clearance/review` | `modules/contracts/contracts.controller.ts:756` |
+| GL DJ requests port amendment when RO vessel window is too short | `POST` | `/api/contracts/:id/clearance/ro-amendment` | `modules/contracts/contracts.controller.ts:997` |
+| GL Djibouti picks the transit officer from the roster — unblocks the customs declaration; calling again reassigns | `POST` | `/api/contracts/:id/clearance/transit-assignee/assign` | `modules/contracts/contracts.controller.ts:863` |
+| GL ET asks GL Djibouti to name the transit officer — required before the customs declaration | `POST` | `/api/contracts/:id/clearance/transit-assignee/request` | `modules/contracts/contracts.controller.ts:845` |
+| GL ET uploads import transit permit documents (multi-file) | `POST` | `/api/contracts/:id/clearance/transit-permit` | `modules/contracts/contracts.controller.ts:944` |
+| Confirm submit after a price change | `POST` | `/api/contracts/:id/confirm-submit` | `modules/contracts/contracts.controller.ts:380` |
+| Generate contract document → CONTRACT_READY | `POST` | `/api/contracts/:id/contract/generate` | `modules/contracts/contracts.controller.ts:596` |
+| Send the sudo-mode signing OTP to the contract company's registered phone (server picks the number) | `POST` | `/api/contracts/:id/contract/send-signing-otp` | `modules/contracts/contracts.controller.ts:667` |
+| Apply digital signature (customer or staff/director/ceo) | `POST` | `/api/contracts/:id/contract/sign` | `modules/contracts/contracts.controller.ts:680` |
+| Upload intake documents for a contract (DRAFT only) | `POST` | `/api/contracts/:id/documents` | `modules/contracts/contracts.controller.ts:354` |
+| Generate unit-rate breakdown (no totals at contract phase) | `POST` | `/api/contracts/:id/generate-price` | `modules/contracts/contracts.controller.ts:366` |
+| GL marks a pre-booking (contract) milestone complete | `POST` | `/api/contracts/:id/milestones/:code/complete` | `modules/contracts/contracts.controller.ts:1222` |
+| Create a renewal draft linked via renewalOfId | `POST` | `/api/contracts/:id/renew` | `modules/contracts/contracts.controller.ts:705` |
+| Staff lift a suspension — contract returns to its prior status | `POST` | `/api/contracts/:id/resume` | `modules/contracts/contracts.controller.ts:510` |
+| Staff accept → set validity window + start approval chain | `POST` | `/api/contracts/:id/staff/accept` | `modules/contracts/contracts.controller.ts:387` |
+| Staff reject contract | `POST` | `/api/contracts/:id/staff/reject` | `modules/contracts/contracts.controller.ts:476` |
+| Staff return contract for customer updates | `POST` | `/api/contracts/:id/staff/request-changes` | `modules/contracts/contracts.controller.ts:460` |
+| Customer submit contract (freezes contract_rate_snapshots) | `POST` | `/api/contracts/:id/submit` | `modules/contracts/contracts.controller.ts:373` |
+| Staff freeze a signed contract (reversible, any post-signature step) | `POST` | `/api/contracts/:id/suspend` | `modules/contracts/contracts.controller.ts:492` |
+| Pre-create validation + authoritative price preview: full booking price breakdown (rail, first/last mile, surcharges), overweight lines and 20ft weight-pairing errors for a shipment payload (no booking created) | `POST` | `/api/contracts/:id/validate-shipment` | `modules/contracts/contracts.controller.ts:1162` |
+| GL marks a shipment request accepted + links the created booking | `POST` | `/api/contracts/booking-requests/:reqId/accept` | `modules/contracts/contracts.controller.ts:134` |
+| Customer cancels their own pending shipment request | `POST` | `/api/contracts/booking-requests/:reqId/cancel` | `modules/contracts/contracts.controller.ts:160` |
+| GL rejects a shipment request | `POST` | `/api/contracts/booking-requests/:reqId/reject` | `modules/contracts/contracts.controller.ts:149` |
+| GL uploads post-booking operational documents (DO/RO/T1/…) | `POST` | `/api/contracts/bookings/:bookingId/documents` | `modules/contracts/contracts.controller.ts:1441` |
+| GL ET advises duty & tax amount + declaration serial | `POST` | `/api/contracts/bookings/:bookingId/duty` | `modules/contracts/contracts.controller.ts:1260` |
+| Customer uploads the duty/tax payment slip | `POST` | `/api/contracts/bookings/:bookingId/duty-slip` | `modules/contracts/contracts.controller.ts:1455` |
+| GL DJ raises the post-offload final invoice (amount + invoice document) | `POST` | `/api/contracts/bookings/:bookingId/final-invoice` | `modules/contracts/contracts.controller.ts:1332` |
+| Customer attaches the payment slip for the final invoice | `POST` | `/api/contracts/bookings/:bookingId/final-invoice-slip` | `modules/contracts/contracts.controller.ts:1374` |
+| Customer approves the drafted final invoice — unlocks the payment slip | `POST` | `/api/contracts/bookings/:bookingId/final-invoice/approve` | `modules/contracts/contracts.controller.ts:1359` |
+| GL (ET or DJ) confirms the payment slip — settles the final invoice | `POST` | `/api/contracts/bookings/:bookingId/final-invoice/confirm` | `modules/contracts/contracts.controller.ts:1386` |
+| GL DJ logs a cargo exception with photo evidence | `POST` | `/api/contracts/bookings/:bookingId/incidents` | `modules/contracts/contracts.controller.ts:1479` |
+| GL / Ops / Terminal marks a post-booking milestone complete | `POST` | `/api/contracts/bookings/:bookingId/milestones/:code/complete` | `modules/contracts/contracts.controller.ts:1205` |
+| GL ET assigns a customs risk level (GREEN/YELLOW/RED) | `POST` | `/api/contracts/bookings/:bookingId/risk` | `modules/contracts/contracts.controller.ts:1241` |
+| GL ET advises (or skips) the post-arrival additional duty/tax round (import) | `POST` | `/api/contracts/bookings/:bookingId/second-duty` | `modules/contracts/contracts.controller.ts:1399` |
+| Customer attaches the additional duty/tax payment slip | `POST` | `/api/contracts/bookings/:bookingId/second-duty-slip` | `modules/contracts/contracts.controller.ts:1429` |
+| GL station manager routes the shipment + binds staff | `POST` | `/api/contracts/bookings/:bookingId/station-assign` | `modules/contracts/contracts.controller.ts:1276` |
+| Close (accept) the T1 set — GL ET after arrival (import) / GL DJ after gate pass (export) | `POST` | `/api/contracts/bookings/:bookingId/t1-close` | `modules/contracts/contracts.controller.ts:1316` |
+| GL Djibouti uploads T1 transit documents (multi-file) after wagon allocation; locked once the train departs | `POST` | `/api/contracts/bookings/:bookingId/t1-documents` | `modules/contracts/contracts.controller.ts:1301` |
+| GL ET uploads export transit permit documents (multi-file) | `POST` | `/api/contracts/bookings/:bookingId/transport-document` | `modules/contracts/contracts.controller.ts:1289` |
+| Share a document with the other GL desk | `POST` | `/api/gl-exchange/:entityId` | `modules/contracts/gl-exchange.controller.ts:59` |
+| Edit this contract\'s document articles only (per-contract; never touches the six shared templates) | `PUT` | `/api/contracts/:id/document/articles` | `modules/contracts/contracts.controller.ts:441` |
+| Update contract | `PATCH` | `/api/contracts/:id` | `modules/contracts/contracts.controller.ts:327` |
+| Uploader edits a shared document (title, visibility, file) | `PATCH` | `/api/gl-exchange/documents/:documentId` | `modules/contracts/gl-exchange.controller.ts:79` |
+| Soft-delete DRAFT contract | `DELETE` | `/api/contracts/:id` | `modules/contracts/contracts.controller.ts:346` |
+| Uploader removes a shared document | `DELETE` | `/api/gl-exchange/documents/:documentId` | `modules/contracts/gl-exchange.controller.ts:105` |
+
+### Contract Template
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a bulk contract template for a (cargo type, customs option) pair | `POST` | `/api/contract-templates` | `modules/contract-templates/contract-templates.controller.ts:56` |
+| Add an article to the template | `POST` | `/api/contract-templates/:code/articles` | `modules/contract-templates/contract-templates.controller.ts:118` |
+| Render an HTML preview of the template against mock contract data | `POST` | `/api/contract-templates/:code/preview` | `modules/contract-templates/contract-templates.controller.ts:97` |
+| Replace the full ordered article list (used for reorder) | `PUT` | `/api/contract-templates/:code/articles` | `modules/contract-templates/contract-templates.controller.ts:111` |
+| Update template metadata (name, title, recitals, active flag) | `PATCH` | `/api/contract-templates/:code` | `modules/contract-templates/contract-templates.controller.ts:77` |
+| Update an article's title or body | `PATCH` | `/api/contract-templates/:code/articles/:articleId` | `modules/contract-templates/contract-templates.controller.ts:125` |
+| Delete a staff-created bulk template (system templates refuse) | `DELETE` | `/api/contract-templates/:code` | `modules/contract-templates/contract-templates.controller.ts:84` |
+| Remove an article from the template | `DELETE` | `/api/contract-templates/:code/articles/:articleId` | `modules/contract-templates/contract-templates.controller.ts:136` |
+
+### Driver
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new driver | `POST` | `/api/drivers` | `modules/drivers/drivers.controller.ts:41` |
+| Upload driver documents (code driver_docs) | `POST` | `/api/drivers/:id/documents` | `modules/drivers/drivers.controller.ts:80` |
+| Update a driver | `PATCH` | `/api/drivers/:id` | `modules/drivers/drivers.controller.ts:128` |
+| Delete a driver | `DELETE` | `/api/drivers/:id` | `modules/drivers/drivers.controller.ts:138` |
+| Delete a driver document | `DELETE` | `/api/drivers/:id/documents/:fileId` | `modules/drivers/drivers.controller.ts:121` |
+
+### Dropdown Setting
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new dropdown setting | `POST` | `/api/dropdown-settings` | `modules/dropdown-settings/dropdown-settings.controller.ts:61` |
+| Append a single option to a setting | `POST` | `/api/dropdown-settings/:id/options` | `modules/dropdown-settings/dropdown-settings.controller.ts:98` |
+| Replace the full option list for a setting | `PUT` | `/api/dropdown-settings/:id/options` | `modules/dropdown-settings/dropdown-settings.controller.ts:88` |
+| Update a dropdown setting's metadata | `PATCH` | `/api/dropdown-settings/:id` | `modules/dropdown-settings/dropdown-settings.controller.ts:68` |
+| Update a single option | `PATCH` | `/api/dropdown-settings/options/:optionId` | `modules/dropdown-settings/dropdown-settings.controller.ts:108` |
+| Soft-delete a dropdown setting | `DELETE` | `/api/dropdown-settings/:id` | `modules/dropdown-settings/dropdown-settings.controller.ts:78` |
+| Soft-delete a single option | `DELETE` | `/api/dropdown-settings/options/:optionId` | `modules/dropdown-settings/dropdown-settings.controller.ts:118` |
+
+### EIMS Invoice
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Register the invoice with MoR EIMS. Idempotent — an invoice that already has an IRN is returned unchanged | `POST` | `/api/invoices/:id/eims/register` | `modules/eims/eims-invoice.controller.ts:32` |
+| Resolve an unacknowledged submission: record the IRN confirmed with MoR, or discard it. Clears the system-wide block | `POST` | `/api/invoices/:id/eims/resolve` | `modules/eims/eims-invoice.controller.ts:49` |
+| Verify the invoice's stored IRN against EIMS | `POST` | `/api/invoices/:id/eims/verify` | `modules/eims/eims-invoice.controller.ts:42` |
+
+### Exchange Setting
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Set the USD→ETB fallback by hand (used only while CBE is unreachable) | `PATCH` | `/api/exchange-settings` | `modules/exchange-settings/exchange-settings.controller.ts:35` |
+
+### Facility
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new facility | `POST` | `/api/facilities` | `modules/facilities/facilities.controller.ts:22` |
+| Update a facility | `PATCH` | `/api/facilities/:id` | `modules/facilities/facilities.controller.ts:41` |
+| Delete a facility (soft delete) | `DELETE` | `/api/facilities/:id` | `modules/facilities/facilities.controller.ts:48` |
+
+### Fayda Verification
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Start a VeriFayda 2.0 verification session | `POST` | `/api/fayda/verification/start` | `modules/verifayda/verifayda.controller.ts:44` |
+
+### File Upload Setting
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new file upload setting | `POST` | `/api/file-upload-settings` | `modules/file-upload-settings/file-upload-settings.controller.ts:56` |
+| Append a single field to a setting | `POST` | `/api/file-upload-settings/:id/fields` | `modules/file-upload-settings/file-upload-settings.controller.ts:93` |
+| Replace the full field list for a setting | `PUT` | `/api/file-upload-settings/:id/fields` | `modules/file-upload-settings/file-upload-settings.controller.ts:83` |
+| Update a file upload setting's metadata | `PATCH` | `/api/file-upload-settings/:id` | `modules/file-upload-settings/file-upload-settings.controller.ts:63` |
+| Update a single field | `PATCH` | `/api/file-upload-settings/fields/:fieldId` | `modules/file-upload-settings/file-upload-settings.controller.ts:103` |
+| Soft-delete a file upload setting | `DELETE` | `/api/file-upload-settings/:id` | `modules/file-upload-settings/file-upload-settings.controller.ts:73` |
+| Soft-delete a single field | `DELETE` | `/api/file-upload-settings/fields/:fieldId` | `modules/file-upload-settings/file-upload-settings.controller.ts:113` |
+
+### First Mile
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a first-mile leg | `POST` | `/api/first-mile` | `modules/first-mile/first-mile.controller.ts:84` |
+| Set per-vehicle actual distances (does not generate an invoice) | `POST` | `/api/first-mile/:id/distances` | `modules/first-mile/first-mile.controller.ts:124` |
+| Generate the first-mile delivery-fee invoice | `POST` | `/api/first-mile/:id/invoice` | `modules/first-mile/first-mile.controller.ts:100` |
+| Set the vehicles assigned to a first-mile pickup (multi-truck) | `POST` | `/api/first-mile/:id/vehicles` | `modules/first-mile/first-mile.controller.ts:114` |
+| Accept a paid booking and create a first-mile leg | `POST` | `/api/first-mile/accept/:reference` | `modules/first-mile/first-mile.controller.ts:77` |
+| Update a first-mile leg | `PATCH` | `/api/first-mile/:id` | `modules/first-mile/first-mile.controller.ts:91` |
+| Soft-delete a first-mile leg | `DELETE` | `/api/first-mile/:id` | `modules/first-mile/first-mile.controller.ts:134` |
+
+### Fuel
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Record fuel purchase | `POST` | `/api/fuel/purchases` | `modules/fuel/fuel.controller.ts:22` |
+
+### GPS Tracking
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Register a GPS tracker | `POST` | `/api/gps/devices` | `modules/gps-tracking/gps-tracking.controller.ts:52` |
+| Update a GPS tracker (name / assigned vehicle) | `PATCH` | `/api/gps/devices/:id` | `modules/gps-tracking/gps-tracking.controller.ts:59` |
+| Delete a GPS tracker | `DELETE` | `/api/gps/devices/:id` | `modules/gps-tracking/gps-tracking.controller.ts:66` |
+
+### Import Operation
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Batch 12: record declaration serial number | `POST` | `/api/import-operations/customs/:bookingId/declaration` | `modules/import-operations/import-operations.controller.ts:53` |
+| Batch 12: upload IM4/IM5/T1/permit/payment-slip documents | `POST` | `/api/import-operations/customs/:bookingId/documents` | `modules/import-operations/import-operations.controller.ts:44` |
+| Batch 12: mark duties and taxes paid | `POST` | `/api/import-operations/customs/:bookingId/duties-taxes-paid` | `modules/import-operations/import-operations.controller.ts:71` |
+| Batch 12: notify duties and taxes | `POST` | `/api/import-operations/customs/:bookingId/notify-duties-taxes` | `modules/import-operations/import-operations.controller.ts:62` |
+| Batch 12: mark import release permitted | `POST` | `/api/import-operations/customs/:bookingId/release-permitted` | `modules/import-operations/import-operations.controller.ts:86` |
+| Batch 12: assign customs risk | `POST` | `/api/import-operations/customs/:bookingId/risk` | `modules/import-operations/import-operations.controller.ts:80` |
+| Batch 8: report a Djibouti import incident / exception | `POST` | `/api/import-operations/djibouti-incidents` | `modules/import-operations/import-operations.controller.ts:32` |
+| Batch 16: create an empty container return record | `POST` | `/api/import-operations/empty-container-returns` | `modules/import-operations/import-operations.controller.ts:101` |
+| Batch 16: advance empty container return workflow | `POST` | `/api/import-operations/empty-container-returns/:id/status` | `modules/import-operations/import-operations.controller.ts:107` |
+
+### Incident
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Report an incident | `POST` | `/api/incidents` | `modules/incidents/incidents.controller.ts:36` |
+| Update an incident | `PATCH` | `/api/incidents/:id` | `modules/incidents/incidents.controller.ts:72` |
+| Delete an incident | `DELETE` | `/api/incidents/:id` | `modules/incidents/incidents.controller.ts:79` |
+
+### Interchange Document
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Generate interchange document from a train schedule handover | `POST` | `/api/interchange-documents/generate-from-schedule` | `modules/interchange-documents/interchange-documents.controller.ts:41` |
+| Acknowledge an interchange document | `PATCH` | `/api/interchange-documents/:id/acknowledge` | `modules/interchange-documents/interchange-documents.controller.ts:48` |
+| Dispute an interchange document | `PATCH` | `/api/interchange-documents/:id/dispute` | `modules/interchange-documents/interchange-documents.controller.ts:58` |
+
+### Last Mile
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a last-mile leg | `POST` | `/api/last-mile` | `modules/last-mile/last-mile.controller.ts:97` |
+| Set each truck\'s own detention window (arrived at destination / returned) | `POST` | `/api/last-mile/:id/detention-times` | `modules/last-mile/last-mile.controller.ts:142` |
+| Set per-vehicle actual distances (does not generate an invoice) | `POST` | `/api/last-mile/:id/distances` | `modules/last-mile/last-mile.controller.ts:132` |
+| Generate the delivery-fee invoice for a last-mile leg | `POST` | `/api/last-mile/:id/invoice` | `modules/last-mile/last-mile.controller.ts:179` |
+| Record proof of delivery (signature + photos) and complete the leg | `POST` | `/api/last-mile/:id/proof-of-delivery` | `modules/last-mile/last-mile.controller.ts:166` |
+| Set the vehicles assigned to a last-mile delivery (multi-truck) | `POST` | `/api/last-mile/:id/vehicles` | `modules/last-mile/last-mile.controller.ts:122` |
+| Set each truck\'s warehouse gate arrival/departure times | `POST` | `/api/last-mile/:id/warehouse-gate-times` | `modules/last-mile/last-mile.controller.ts:154` |
+| Accept a paid booking and create a last-mile leg | `POST` | `/api/last-mile/accept/:reference` | `modules/last-mile/last-mile.controller.ts:90` |
+| Update a last-mile leg | `PATCH` | `/api/last-mile/:id` | `modules/last-mile/last-mile.controller.ts:104` |
+| Soft-delete a last-mile leg | `DELETE` | `/api/last-mile/:id` | `modules/last-mile/last-mile.controller.ts:113` |
+
+### Last Mile Request
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Truck & Machinery chief approves the request — the advance defaults to the live last-mile rate; LM contract becomes signable and the advance invoice follows the customer signature | `POST` | `/api/last-mile-requests/:id/approve` | `modules/last-mile-requests/last-mile-requests.controller.ts:119` |
+| Customer agrees and signs the LM contract — then the advance invoice is issued | `POST` | `/api/last-mile-requests/:id/contract/sign` | `modules/last-mile-requests/last-mile-requests.controller.ts:83` |
+| Truck & Machinery chief rejects the request with a reason | `POST` | `/api/last-mile-requests/:id/reject` | `modules/last-mile-requests/last-mile-requests.controller.ts:130` |
+| Customer confirms which containers go via EDR last-mile | `POST` | `/api/last-mile-requests/:id/submit` | `modules/last-mile-requests/last-mile-requests.controller.ts:108` |
+
+### Locomotive
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a locomotive | `POST` | `/api/locomotives` | `modules/locomotives/locomotives.controller.ts:58` |
+| Decommission a locomotive | `POST` | `/api/locomotives/:id/decommission` | `modules/locomotives/locomotives.controller.ts:72` |
+| Update a locomotive | `PATCH` | `/api/locomotives/:id` | `modules/locomotives/locomotives.controller.ts:65` |
+| Permanently delete a locomotive (irreversible; refused if any train references it) | `DELETE` | `/api/locomotives/:id/permanent` | `modules/locomotives/locomotives.controller.ts:82` |
+
+### Maintenance
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Record maintenance cost | `POST` | `/api/maintenance/costs` | `modules/maintenance/maintenance.controller.ts:38` |
+| Define/adjust a service interval (e.g. oil change every 10,000 km) | `POST` | `/api/maintenance/intervals` | `modules/maintenance/maintenance.controller.ts:59` |
+| Create part | `POST` | `/api/maintenance/parts` | `modules/maintenance/maintenance.controller.ts:150` |
+| Schedule maintenance | `POST` | `/api/maintenance/schedules` | `modules/maintenance/maintenance.controller.ts:31` |
+| Create warranty | `POST` | `/api/maintenance/warranties` | `modules/maintenance/maintenance.controller.ts:186` |
+| Create work order | `POST` | `/api/maintenance/work-orders` | `modules/maintenance/maintenance.controller.ts:110` |
+| Update part | `PATCH` | `/api/maintenance/parts/:id` | `modules/maintenance/maintenance.controller.ts:170` |
+| Update maintenance schedule | `PATCH` | `/api/maintenance/schedules/:id` | `modules/maintenance/maintenance.controller.ts:45` |
+| Update work order | `PATCH` | `/api/maintenance/work-orders/:id` | `modules/maintenance/maintenance.controller.ts:134` |
+| Deactivate a service interval (stops auto-scheduling) | `DELETE` | `/api/maintenance/intervals/:id` | `modules/maintenance/maintenance.controller.ts:73` |
+| Delete part | `DELETE` | `/api/maintenance/parts/:id` | `modules/maintenance/maintenance.controller.ts:177` |
+| Delete warranty | `DELETE` | `/api/maintenance/warranties/:id` | `modules/maintenance/maintenance.controller.ts:200` |
+| Delete work order | `DELETE` | `/api/maintenance/work-orders/:id` | `modules/maintenance/maintenance.controller.ts:141` |
+
+### Notification Inbox
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Mark all my notifications as read | `POST` | `/api/notifications/read-all` | `modules/notification-inbox/notification-inbox.controller.ts:53` |
+| Mark one of my notifications as read | `PATCH` | `/api/notifications/:id/read` | `modules/notification-inbox/notification-inbox.controller.ts:44` |
+
+### Organization User
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create an organization user without assigning positions | `POST` | `/api/backoffice/organizations/:orgId/users` | `modules/backoffice/backoffice.controller.ts:24` |
+| Replace org-scoped roles assigned to an employee user | `PUT` | `/api/backoffice/organizations/:orgId/employee-users/:userId/roles` | `modules/backoffice/backoffice.controller.ts:58` |
+
+### OTP
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Send OTP | `POST` | `/api/otp/send` | `modules/otp/otp.controller.ts:41` |
+| Verify OTP | `POST` | `/api/otp/verify` | `modules/otp/otp.controller.ts:62` |
+
+### Password Reset
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Send a password-reset code to the account's email AND phone | `POST` | `/api/auth/forgot-password/request` | `modules/auth/forgot-password.controller.ts:30` |
+| Validate a staff-issued reset link and return its set-password ticket | `POST` | `/api/auth/forgot-password/resolve-link` | `modules/auth/forgot-password.controller.ts:73` |
+| Exchange a valid reset code for a single-use set-password ticket | `POST` | `/api/auth/forgot-password/verify` | `modules/auth/forgot-password.controller.ts:62` |
+| Send a password-reset link to a customer's primary contact | `POST` | `/api/backoffice/customers/:companyId/reset-password` | `modules/auth/customer-reset.controller.ts:49` |
+
+### Payment
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Finance confirms a USD invoice paid by bank transfer — slip file required, settles the full balance | `POST` | `/api/billing/invoices/:id/confirm-offline` | `modules/billing/billing.controller.ts:81` |
+| Confirm an OTP-debit payment (CAC Bank) for one of the customer's invoices | `POST` | `/api/billing/my-invoices/:id/confirm` | `modules/billing/portal-billing.controller.ts:102` |
+| Initiate payment for one of the customer's invoices | `POST` | `/api/billing/my-invoices/:id/pay` | `modules/billing/portal-billing.controller.ts:86` |
+| Live still-payable check + payer name for a CBE bill (called while CBE is on the line) | `POST` | `/api/internal/payments/bill-query` | `modules/payment/internal-payment.controller.ts:56` |
+| Apply a payment.succeeded / payment.failed event from the payment service (idempotent) | `POST` | `/api/internal/payments/mark-paid` | `modules/payment/internal-payment.controller.ts:45` |
+| Initiate payment for an invoice | `POST` | `/api/payments/initiate` | `modules/billing/payment.controller.ts:39` |
+| Success-redirect ack: mark payment processing + invoice PAYMENT_PROCESSING (webhook remains source of truth) | `POST` | `/api/payments/redirect-success/:bookingId` | `modules/payment/payment.controller.ts:89` |
+
+### Priority Config
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a priority config | `POST` | `/api/priority-configs` | `modules/rule-engine/controllers/priority-configs.controller.ts:51` |
+| Move a priority config up or down in display order | `POST` | `/api/priority-configs/:id/move-order` | `modules/rule-engine/controllers/priority-configs.controller.ts:66` |
+| Bulk reorder priority configs by ID list | `POST` | `/api/priority-configs/reorder` | `modules/rule-engine/controllers/priority-configs.controller.ts:58` |
+| Update a priority config | `PATCH` | `/api/priority-configs/:id` | `modules/rule-engine/controllers/priority-configs.controller.ts:74` |
+| Soft-delete a priority config | `DELETE` | `/api/priority-configs/:id` | `modules/rule-engine/controllers/priority-configs.controller.ts:81` |
+
+### Priority Rule Change Request
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Submit a priority-rule change for approval | `POST` | `/api/priority-rule-change-requests` | `modules/rule-engine/controllers/priority-rule-change-requests.controller.ts:34` |
+| Approve and apply a pending change | `POST` | `/api/priority-rule-change-requests/:id/approve` | `modules/rule-engine/controllers/priority-rule-change-requests.controller.ts:52` |
+| Reject a pending change | `POST` | `/api/priority-rule-change-requests/:id/reject` | `modules/rule-engine/controllers/priority-rule-change-requests.controller.ts:65` |
+
+### Procurement
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create an asset acquisition | `POST` | `/api/procurement/acquisitions` | `modules/procurement/procurement.controller.ts:56` |
+| Create an asset disposal | `POST` | `/api/procurement/disposals` | `modules/procurement/procurement.controller.ts:90` |
+| Create a vendor | `POST` | `/api/procurement/vendors` | `modules/procurement/procurement.controller.ts:28` |
+| Update an asset acquisition | `PATCH` | `/api/procurement/acquisitions/:id` | `modules/procurement/procurement.controller.ts:75` |
+| Update a vendor | `PATCH` | `/api/procurement/vendors/:id` | `modules/procurement/procurement.controller.ts:41` |
+| Delete an asset acquisition | `DELETE` | `/api/procurement/acquisitions/:id` | `modules/procurement/procurement.controller.ts:82` |
+| Delete an asset disposal | `DELETE` | `/api/procurement/disposals/:id` | `modules/procurement/procurement.controller.ts:103` |
+| Delete a vendor | `DELETE` | `/api/procurement/vendors/:id` | `modules/procurement/procurement.controller.ts:48` |
+
+### Rate
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a rate (DRAFT) | `POST` | `/api/rates` | `modules/rule-engine/controllers/rates.controller.ts:46` |
+| CEO approves a rate | `POST` | `/api/rates/:id/approve` | `modules/rule-engine/controllers/rates.controller.ts:70` |
+| Submit rate for CEO approval | `POST` | `/api/rates/:id/submit` | `modules/rule-engine/controllers/rates.controller.ts:63` |
+| Update a DRAFT rate | `PATCH` | `/api/rates/:id` | `modules/rule-engine/controllers/rates.controller.ts:56` |
+| Soft-delete a rate | `DELETE` | `/api/rates/:id` | `modules/rule-engine/controllers/rates.controller.ts:82` |
+
+### Rate Change Request
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Propose a change to a LIVE rate | `POST` | `/api/rate-change-requests` | `modules/rule-engine/controllers/rate-change-requests.controller.ts:23` |
+| Approve a rate change and put it into effect | `POST` | `/api/rate-change-requests/:id/approve` | `modules/rule-engine/controllers/rate-change-requests.controller.ts:37` |
+| Reject a rate change — the rate keeps its current value | `POST` | `/api/rate-change-requests/:id/reject` | `modules/rule-engine/controllers/rate-change-requests.controller.ts:48` |
+
+### Route
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create route | `POST` | `/api/routes` | `modules/routes/routes.controller.ts:61` |
+| Update route | `PATCH` | `/api/routes/:id` | `modules/routes/routes.controller.ts:68` |
+| Deactivate route | `DELETE` | `/api/routes/:id` | `modules/routes/routes.controller.ts:90` |
+| Permanently delete a route (irreversible; refused while any train schedule references it) | `DELETE` | `/api/routes/:id/permanent` | `modules/routes/routes.controller.ts:79` |
+
+### Schedule
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Reschedule train for maintenance (new departure + rebalance) | `POST` | `/api/train-scheduling/schedules/:id/maintenance` | `modules/scheduling-reschedule/scheduling-reschedule.controller.ts:52` |
+| Execute a confirmed reschedule plan | `POST` | `/api/train-scheduling/schedules/:id/reschedule/execute` | `modules/scheduling-reschedule/scheduling-reschedule.controller.ts:30` |
+| Preview reschedule / government preempt plan | `POST` | `/api/train-scheduling/schedules/:id/reschedule/preview` | `modules/scheduling-reschedule/scheduling-reschedule.controller.ts:20` |
+
+### Service Type
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a service type | `POST` | `/api/service-types` | `modules/rule-engine/controllers/service-types.controller.ts:51` |
+| Move a service type up or down in display order | `POST` | `/api/service-types/:id/move-order` | `modules/rule-engine/controllers/service-types.controller.ts:36` |
+| Bulk reorder service types by ID list | `POST` | `/api/service-types/reorder` | `modules/rule-engine/controllers/service-types.controller.ts:28` |
+| Update a service type | `PATCH` | `/api/service-types/:id` | `modules/rule-engine/controllers/service-types.controller.ts:58` |
+| Soft-delete a service type | `DELETE` | `/api/service-types/:id` | `modules/rule-engine/controllers/service-types.controller.ts:65` |
+
+### Shipping Line
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a shipping line | `POST` | `/api/shipping-lines` | `modules/rule-engine/controllers/shipping-lines.controller.ts:33` |
+| Update a shipping line | `PATCH` | `/api/shipping-lines/:id` | `modules/rule-engine/controllers/shipping-lines.controller.ts:40` |
+| Soft-delete a shipping line | `DELETE` | `/api/shipping-lines/:id` | `modules/rule-engine/controllers/shipping-lines.controller.ts:47` |
+
+### Signature
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create or update the reusable saved signature | `PUT` | `/api/me/signature` | `modules/signatures/signatures.controller.ts:23` |
+
+### Support Chat
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Start chatting with a company (returns the thread if one exists) | `POST` | `/api/support/agent/conversations` | `modules/support-chat/support-chat-agent.controller.ts:49` |
+| Reply as an agent, optionally with attachments | `POST` | `/api/support/agent/conversations/:id/messages` | `modules/support-chat/support-chat-agent.controller.ts:74` |
+| Mark a thread read (agent side) | `POST` | `/api/support/agent/conversations/:id/read` | `modules/support-chat/support-chat-agent.controller.ts:114` |
+| Send a message as the customer (optionally with attachments), opening the thread if needed | `POST` | `/api/support/conversation/messages` | `modules/support-chat/support-chat.controller.ts:65` |
+| Mark my company's thread read (customer side) | `POST` | `/api/support/conversation/read` | `modules/support-chat/support-chat.controller.ts:102` |
+
+### Support Content
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Restore a version — re-saves it as a new version, never destructive | `POST` | `/api/support-content/documents/:slug/versions/:version/restore` | `modules/support-content/support-content.controller.ts:123` |
+| Upload an image or video for a help section | `POST` | `/api/support-content/media` | `modules/support-content/support-content.controller.ts:55` |
+| Replace a document's payload, recording a new version | `PATCH` | `/api/support-content/documents/:slug` | `modules/support-content/support-content.controller.ts:93` |
+
+### Train
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Register a new train | `POST` | `/api/trains` | `modules/trains/trains.controller.ts:33` |
+| Update a train | `PATCH` | `/api/trains/:id` | `modules/trains/trains.controller.ts:52` |
+| Delete a train | `DELETE` | `/api/trains/:id` | `modules/trains/trains.controller.ts:59` |
+
+### Train Build
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Build a train: code + yard + 2+ locomotives (+ optional wagons) | `POST` | `/api/train-builder` | `modules/trains/train-builder.controller.ts:50` |
+| Reactivate a deactivated train back to AVAILABLE | `POST` | `/api/train-builder/:id/activate` | `modules/trains/train-builder.controller.ts:158` |
+| Deactivate the train (park it) — only allowed with no active schedule | `POST` | `/api/train-builder/:id/deactivate` | `modules/trains/train-builder.controller.ts:149` |
+| Persist a drag-reorder of the full consist | `POST` | `/api/train-builder/:id/reorder-wagons` | `modules/trains/train-builder.controller.ts:142` |
+| Append AVAILABLE wagons from the train's yard to the consist | `POST` | `/api/train-builder/:id/wagons` | `modules/trains/train-builder.controller.ts:109` |
+| Detach one wagon and move it to MAINTENANCE status | `POST` | `/api/train-builder/:id/wagons/:wagonId/maintenance` | `modules/trains/train-builder.controller.ts:131` |
+| Replace the locomotive set (minimum 1, same yard) | `PUT` | `/api/train-builder/:id/locomotives` | `modules/trains/train-builder.controller.ts:78` |
+| Edit the train's name and fixed import/export run numbers | `PATCH` | `/api/train-builder/:id/details` | `modules/trains/train-builder.controller.ts:88` |
+| Relocate the train — its locomotives and wagons move to the new yard with it | `PATCH` | `/api/train-builder/:id/yard` | `modules/trains/train-builder.controller.ts:100` |
+| Disband the train (release wagons and locomotives) | `DELETE` | `/api/train-builder/:id` | `modules/trains/train-builder.controller.ts:165` |
+| Detach one wagon from the consist | `DELETE` | `/api/train-builder/:id/wagons/:wagonId` | `modules/trains/train-builder.controller.ts:120` |
+
+### Train Schedule
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Staff: place a paid booking onto a fitting train (notifies customer on date change) | `POST` | `/api/train-scheduling/bookings/:bookingId/allocate` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:880` |
+| Staff: expire a reservation and free its capacity | `POST` | `/api/train-scheduling/bookings/:bookingId/expire` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:845` |
+| Staff: mark a reserved booking paid and allocate it now | `POST` | `/api/train-scheduling/bookings/:bookingId/mark-paid` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:835` |
+| Re-point a booking to another OPEN same-route schedule | `POST` | `/api/train-scheduling/bookings/:bookingId/move-schedule` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:855` |
+| Preview a bulk train schedule | `POST` | `/api/train-scheduling/bulk/preview` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:302` |
+| Create a bulk train schedule | `POST` | `/api/train-scheduling/bulk/schedules` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:316` |
+| Assign bulk bookings to a train schedule | `POST` | `/api/train-scheduling/bulk/schedules/:id/assign-bookings` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:349` |
+| Cancel bulk train schedule | `POST` | `/api/train-scheduling/bulk/schedules/:id/cancel` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:976` |
+| Preview a container train schedule | `POST` | `/api/train-scheduling/container/preview` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:295` |
+| Create a container train schedule | `POST` | `/api/train-scheduling/container/schedules` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:309` |
+| Assign container bookings to a train schedule | `POST` | `/api/train-scheduling/container/schedules/:id/assign-bookings` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:335` |
+| Cancel container train schedule | `POST` | `/api/train-scheduling/container/schedules/:id/cancel` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:969` |
+| Preview a mixed-capable train schedule | `POST` | `/api/train-scheduling/preview` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:288` |
+| Permanently trim free wagons off / couple yard wagons onto the schedule's built train (weight & length limits incl. tolerance enforced, every change logged) | `POST` | `/api/train-scheduling/schedules/:id/adjust-consist` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:197` |
+| Mark a dispatched train arrived (move assets to destination yard, free assets) | `POST` | `/api/train-scheduling/schedules/:id/arrive` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:915` |
+| Assign bookings to a train schedule (mixed-capable) | `POST` | `/api/train-scheduling/schedules/:id/assign-bookings` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:323` |
+| Assign one linked unallocated booking to wagons (preserves existing assignments) | `POST` | `/api/train-scheduling/schedules/:id/assign-unassigned-booking` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:423` |
+| Confirm a booking's cargo loaded at its origin yard (any direction; train must be at that yard) | `POST` | `/api/train-scheduling/schedules/:id/bookings/:bookingId/load` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:564` |
+| Confirm a booking's cargo unloaded at its destination yard — per-booking arrival, may precede the train's final arrival | `POST` | `/api/train-scheduling/schedules/:id/bookings/:bookingId/unload` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:577` |
+| Log the train passing a station (final station triggers arrival) | `POST` | `/api/train-scheduling/schedules/:id/checkpoints` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:903` |
+| Confirm cargo loaded on the train (any direction; unblocks import-Djibouti dispatch) | `POST` | `/api/train-scheduling/schedules/:id/confirm-loading` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:662` |
+| Dispatch a scheduled train | `POST` | `/api/train-scheduling/schedules/:id/dispatch` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:514` |
+| Staff finished document review early — run the batch/payment phase now (applies to the whole route-day group) | `POST` | `/api/train-scheduling/schedules/:id/doc-review-complete` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:824` |
+| Finalize a draft train schedule | `POST` | `/api/train-scheduling/schedules/:id/finalize` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:507` |
+| Depart loaded import train from Djibouti | `POST` | `/api/train-scheduling/schedules/:id/import-djibouti/depart` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:675` |
+| Upload/check an import Djibouti-side document | `POST` | `/api/train-scheduling/schedules/:id/import-djibouti/documents` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:622` |
+| Mark import Djibouti gatepass permission granted | `POST` | `/api/train-scheduling/schedules/:id/import-djibouti/gatepass-granted` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:632` |
+| Generate import load list / marshalling document summary | `POST` | `/api/train-scheduling/schedules/:id/import-djibouti/load-list` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:685` |
+| Confirm import cargo loaded on train at Djibouti | `POST` | `/api/train-scheduling/schedules/:id/import-djibouti/loaded-on-train` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:652` |
+| Mark import train ready for loading at Djibouti | `POST` | `/api/train-scheduling/schedules/:id/import-djibouti/ready-for-loading` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:642` |
+| Confirm intercity cargo loaded (train must be at the booking's origin yard) | `POST` | `/api/train-scheduling/schedules/:id/intercity/:bookingId/load` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:590` |
+| Confirm intercity cargo unloaded at the booking's destination yard (completes the booking) | `POST` | `/api/train-scheduling/schedules/:id/intercity/:bookingId/unload` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:602` |
+| Accept intercity bookings onto this train (opens their pay window; capacity re-checked per booking) | `POST` | `/api/train-scheduling/schedules/:id/intercity/accept` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:541` |
+| Maintenance reschedule: move the train to a new departure with every allocated booking aboard — links, wagons and window settings unchanged | `POST` | `/api/train-scheduling/schedules/:id/maintenance` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:798` |
+| Pin physical wagons to train set slots | `POST` | `/api/train-scheduling/schedules/:id/pin-wagons` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:500` |
+| Run wagon-level allocation for all eligible linked bookings | `POST` | `/api/train-scheduling/schedules/:id/run-allocation` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:747` |
+| Manually run the batch fill for a schedule | `POST` | `/api/train-scheduling/schedules/:id/run-batch` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:739` |
+| Switch out commercial bookings to allocate a government booking in their place | `POST` | `/api/train-scheduling/schedules/:id/switch-government-booking` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:439` |
+| Move a wagon's whole load to another wagon (empty → move/repin, loaded → swap loads) | `POST` | `/api/train-scheduling/schedules/:id/wagons/:wagonId/move-load` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:402` |
+| Update global train scheduling rules (singleton) | `PATCH` | `/api/train-scheduling/global-rules` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:124` |
+| Open or close a schedule booking window | `PATCH` | `/api/train-scheduling/schedules/:id/booking-window` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:756` |
+| Update a container number on a wagon slot | `PATCH` | `/api/train-scheduling/schedules/:id/container-items/:itemId` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:391` |
+| Mark import bookings loaded/unloaded on this schedule (tracking only, does not affect dispatch) | `PATCH` | `/api/train-scheduling/schedules/:id/import-loading-status` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:474` |
+| Mark bookings loaded/unloaded on this schedule (any direction, pre-dispatch only) | `PATCH` | `/api/train-scheduling/schedules/:id/loading-status` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:487` |
+| Reschedule a train's departure date — only before the booking window opens, and only if the new date still leaves room for the booking lead window | `PATCH` | `/api/train-scheduling/schedules/:id/schedule-date` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:784` |
+| Override the booking-window rule for one schedule (open/close hour, duration, doc-review, payment, lead days) — only before the window opens | `PATCH` | `/api/train-scheduling/schedules/:id/window-rule` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:770` |
+| Unassign a booking from a train schedule | `DELETE` | `/api/train-scheduling/schedules/:id/bookings/:bookingId` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:363` |
+| Remove an empty wagon slot from a train | `DELETE` | `/api/train-scheduling/schedules/:id/wagons/:trainSetWagonId` | `modules/train-scheduling/controllers/train-scheduling.controller.ts:378` |
+
+### Transit Agent
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a transit agent | `POST` | `/api/transit-agents` | `modules/transit-agents/transit-agents.controller.ts:66` |
+| Update a transit agent | `PATCH` | `/api/transit-agents/:id` | `modules/transit-agents/transit-agents.controller.ts:73` |
+| Soft-delete a transit agent | `DELETE` | `/api/transit-agents/:id` | `modules/transit-agents/transit-agents.controller.ts:80` |
+
+### Truck Type
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a truck type | `POST` | `/api/truck-types` | `modules/truck-types/truck-types.controller.ts:58` |
+| Update a truck type | `PATCH` | `/api/truck-types/:id` | `modules/truck-types/truck-types.controller.ts:65` |
+| Soft-delete a truck type | `DELETE` | `/api/truck-types/:id` | `modules/truck-types/truck-types.controller.ts:72` |
+
+### User Trade Access
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Set the trade directions a backoffice user may see | `PUT` | `/api/user-trade-access/:userId` | `modules/user-trade-access/user-trade-access.controller.ts:45` |
+
+### Vehicle
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new vehicle | `POST` | `/api/vehicles` | `modules/vehicles/vehicles.controller.ts:37` |
+| Update a vehicle | `PATCH` | `/api/vehicles/:id` | `modules/vehicles/vehicles.controller.ts:78` |
+| Delete a vehicle | `DELETE` | `/api/vehicles/:id` | `modules/vehicles/vehicles.controller.ts:88` |
+
+### Wagon
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a new wagon | `POST` | `/api/wagons` | `modules/wagons/wagons.controller.ts:39` |
+| Assign wagon to a train | `POST` | `/api/wagons/:id/assign-train` | `modules/wagons/wagons.controller.ts:100` |
+| Unassign wagon from train | `POST` | `/api/wagons/:id/unassign-train` | `modules/wagons/wagons.controller.ts:107` |
+| Set the status of multiple wagons (audited in wagon_status_logs) | `POST` | `/api/wagons/bulk-status` | `modules/wagons/wagons.controller.ts:121` |
+| Transfer multiple wagons to a destination yard | `POST` | `/api/wagons/bulk-transfer` | `modules/wagons/wagons.controller.ts:114` |
+| Update a wagon | `PATCH` | `/api/wagons/:id` | `modules/wagons/wagons.controller.ts:71` |
+| Delete a wagon | `DELETE` | `/api/wagons/:id` | `modules/wagons/wagons.controller.ts:93` |
+| Permanently delete a wagon (irreversible; refused if it has movements, containers or train-set slots) | `DELETE` | `/api/wagons/:id/permanent` | `modules/wagons/wagons.controller.ts:82` |
+
+### Wagon Transfer Request
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| File a count-only wagon-transfer request | `POST` | `/api/wagon-transfer-requests` | `modules/wagons/wagon-transfer-requests.controller.ts:50` |
+| Withdraw a request that has not moved any wagon yet (use close-short once wagons have moved) | `POST` | `/api/wagon-transfer-requests/:id/cancel` | `modules/wagons/wagon-transfer-requests.controller.ts:167` |
+| OCC: end the request with fewer wagons than asked for — what moved stays, the requester is told the shortfall | `POST` | `/api/wagon-transfer-requests/:id/close-short` | `modules/wagons/wagon-transfer-requests.controller.ts:153` |
+| OCC: pick wagons and execute the transfer | `POST` | `/api/wagon-transfer-requests/:id/fulfill` | `modules/wagons/wagon-transfer-requests.controller.ts:142` |
+| OCC: accept-and-execute a subset of pending requests (auto-picks available wagons; the rest stay PENDING) | `POST` | `/api/wagon-transfer-requests/bulk-fulfill` | `modules/wagons/wagon-transfer-requests.controller.ts:73` |
+
+### Wagon Type
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a wagon type | `POST` | `/api/wagon-types` | `modules/wagon-types/wagon-types.controller.ts:53` |
+| Update a wagon type | `PATCH` | `/api/wagon-types/:id` | `modules/wagon-types/wagon-types.controller.ts:60` |
+| Soft-delete a wagon type | `DELETE` | `/api/wagon-types/:id` | `modules/wagon-types/wagon-types.controller.ts:67` |
+
+### Warehouse
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a warehouse allocation rule | `POST` | `/api/warehouse-allocation-rules` | `modules/warehouses/warehouse-rules.controller.ts:33` |
+| Preview the yard/warehouse/zone a booking would be allocated to | `POST` | `/api/warehouse-allocation/preview` | `modules/warehouses/warehouse-rules.controller.ts:55` |
+| Create a storage / demurrage fee rule | `POST` | `/api/warehouse-fee-rules` | `modules/warehouses/warehouse-rules.controller.ts:70` |
+| Acknowledge / snooze an item fee-accrual alert | `POST` | `/api/warehouse-fees/accrual/:inventoryId/acknowledge` | `modules/warehouses/warehouse-rules.controller.ts:106` |
+| Create warehouse | `POST` | `/api/warehouses` | `modules/warehouses/warehouses.controller.ts:51` |
+| Create a yard within a warehouse | `POST` | `/api/warehouses/:warehouseId/yards` | `modules/warehouses/warehouses.controller.ts:78` |
+| Update a warehouse allocation rule | `PATCH` | `/api/warehouse-allocation-rules/:id` | `modules/warehouses/warehouse-rules.controller.ts:40` |
+| Update a fee rule | `PATCH` | `/api/warehouse-fee-rules/:id` | `modules/warehouses/warehouse-rules.controller.ts:77` |
+| Update warehouse | `PATCH` | `/api/warehouses/:id` | `modules/warehouses/warehouses.controller.ts:64` |
+| Delete a warehouse allocation rule | `DELETE` | `/api/warehouse-allocation-rules/:id` | `modules/warehouses/warehouse-rules.controller.ts:47` |
+| Delete a fee rule | `DELETE` | `/api/warehouse-fee-rules/:id` | `modules/warehouses/warehouse-rules.controller.ts:84` |
+| Remove an accrual acknowledgement (re-surface for alerts) | `DELETE` | `/api/warehouse-fees/accrual/:inventoryId/acknowledge` | `modules/warehouses/warehouse-rules.controller.ts:119` |
+
+### Warehouse Fee Invoice
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Generate a truck-detention invoice for a last-mile leg (per truck per day) | `POST` | `/api/last-mile/:id/generate-truck-detention-invoice` | `modules/warehouses/warehouse-invoice.controller.ts:28` |
+| Record a payment against a warehouse fee invoice | `POST` | `/api/warehouse-fee-invoices/:id/pay` | `modules/warehouses/warehouse-invoice.controller.ts:109` |
+| Initiate Telebirr/Waafi payment for a warehouse fee invoice | `POST` | `/api/warehouse-fee-invoices/:id/pay-online` | `modules/warehouses/warehouse-invoice.controller.ts:116` |
+| Generate a warehouse fee invoice from Batch 5 fee calculation | `POST` | `/api/warehouse-inventory/:id/generate-fee-invoice` | `modules/warehouses/warehouse-invoice.controller.ts:20` |
+| Cancel a warehouse fee invoice | `PATCH` | `/api/warehouse-fee-invoices/:id/cancel` | `modules/warehouses/warehouse-invoice.controller.ts:102` |
+
+### Warehouse Inspection Report
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Upload inspection images / documents | `POST` | `/api/warehouse-inspection-reports/:id/attachments` | `modules/warehouses/warehouse-inspection.controller.ts:68` |
+| Create an inspection / damage report for an inventory item | `POST` | `/api/warehouse-inventory/:inventoryId/inspection-reports` | `modules/warehouses/warehouse-inspection.controller.ts:37` |
+| Update an inspection report | `PATCH` | `/api/warehouse-inspection-reports/:id` | `modules/warehouses/warehouse-inspection.controller.ts:61` |
+
+### Warehouse Inventory
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Deliver import goods to the customer + capture proof of delivery | `POST` | `/api/warehouse-inventory/:id/deliver` | `modules/warehouses/warehouse-inventory.controller.ts:594` |
+| Final terminal release / gate clearance (blocked while fees unpaid) | `POST` | `/api/warehouse-inventory/:id/gate-clearance` | `modules/warehouses/warehouse-inventory.controller.ts:219` |
+| Load READY_FOR_LOADING inventory onto a wagon | `POST` | `/api/warehouse-inventory/:id/load` | `modules/warehouses/warehouse-inventory.controller.ts:384` |
+| Move inventory to another warehouse/yard/zone | `POST` | `/api/warehouse-inventory/:id/move` | `modules/warehouses/warehouse-inventory.controller.ts:359` |
+| Mark reserved inventory READY_FOR_LOADING | `POST` | `/api/warehouse-inventory/:id/ready-for-loading` | `modules/warehouses/warehouse-inventory.controller.ts:373` |
+| Mark inspected IMPORT inventory READY_FOR_PICKUP | `POST` | `/api/warehouse-inventory/:id/ready-for-pickup` | `modules/warehouses/warehouse-inventory.controller.ts:391` |
+| Issue a DO / release order for ready-for-pickup inventory | `POST` | `/api/warehouse-inventory/:id/release` | `modules/warehouses/warehouse-inventory.controller.ts:402` |
+| Mark received inventory as STORED (optional explicit warehouse/yard/zone) | `POST` | `/api/warehouse-inventory/:id/store` | `modules/warehouses/warehouse-inventory.controller.ts:366` |
+| Auto-load READY_FOR_LOADING inventory with PAID bookings | `POST` | `/api/warehouse-inventory/auto-load-ready` | `modules/warehouses/warehouse-inventory.controller.ts:125` |
+| Bulk auto-unload all arrived bookings into the warehouse | `POST` | `/api/warehouse-inventory/auto-unload-arrived` | `modules/warehouses/warehouse-inventory.controller.ts:118` |
+| Approve delivery — customer records their full name (signature optional) | `POST` | `/api/warehouse-inventory/bookings/:bookingId/approve-delivery` | `modules/warehouses/warehouse-inventory.controller.ts:470` |
+| Ask the customer to sign the handover (creates one if none, then notifies) | `POST` | `/api/warehouse-inventory/bookings/:bookingId/request-handover-signature` | `modules/warehouses/warehouse-inventory.controller.ts:509` |
+| Unload a single arrived booking into a location | `POST` | `/api/warehouse-inventory/bookings/:bookingId/unload` | `modules/warehouses/warehouse-inventory.controller.ts:209` |
+| Bulk-dispatch loaded EXPORT inventory (LOADED → DISPATCHED) | `POST` | `/api/warehouse-inventory/bulk-dispatch-export` | `modules/warehouses/warehouse-inventory.controller.ts:195` |
+| Bulk mark received inventory inspection PASSED (EXPORT → READY_FOR_LOADING) | `POST` | `/api/warehouse-inventory/bulk-mark-inspected` | `modules/warehouses/warehouse-inventory.controller.ts:202` |
+| Unload all eligible export items assigned to an arrived Djibouti-side train | `POST` | `/api/warehouse-inventory/export/auto-unload-at-djibouti` | `modules/warehouses/warehouse-inventory.controller.ts:294` |
+| Customer signs one handover (EDR last-mile: one signature per truck) | `POST` | `/api/warehouse-inventory/handovers/:handoverId/sign` | `modules/warehouses/warehouse-inventory.controller.ts:493` |
+| Unload all eligible assigned bookings of an ARRIVED import train (→ UNLOADED) | `POST` | `/api/warehouse-inventory/import/auto-unload-arrived-bookings` | `modules/warehouses/warehouse-inventory.controller.ts:244` |
+| Receive inventory at a warehouse location | `POST` | `/api/warehouse-inventory/receive` | `modules/warehouses/warehouse-inventory.controller.ts:322` |
+| Bulk-receive selected eligible PAID bookings into a location | `POST` | `/api/warehouse-inventory/receive-bulk` | `modules/warehouses/warehouse-inventory.controller.ts:140` |
+| Reserve stored inventory for a PAID booking | `POST` | `/api/warehouse-inventory/reserve` | `modules/warehouses/warehouse-inventory.controller.ts:330` |
+| Load selected inventory items onto their allocated wagons for a train | `POST` | `/api/warehouse-inventory/train/:scheduleId/load` | `modules/warehouses/warehouse-inventory.controller.ts:184` |
+| Mark loaded inventory DISPATCHED (left the terminal) | `PATCH` | `/api/warehouse-inventory/:id/dispatch` | `modules/warehouses/warehouse-inventory.controller.ts:602` |
+| Record Yes/No double handling after unloading (Yes applies the double-handling fee rule) | `PATCH` | `/api/warehouse-inventory/bookings/:bookingId/double-handling` | `modules/warehouses/warehouse-inventory.controller.ts:556` |
+
+### Warehouse Yard
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a zone within a yard | `POST` | `/api/warehouse-yards/:yardId/zones` | `modules/warehouses/warehouse-yards.controller.ts:50` |
+| Update warehouse yard | `PATCH` | `/api/warehouse-yards/:id` | `modules/warehouses/warehouse-yards.controller.ts:36` |
+
+### Warehouse Zone
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Update warehouse zone | `PATCH` | `/api/warehouse-zones/:id` | `modules/warehouses/warehouse-zones.controller.ts:37` |
+
+### Weight Limit Rule
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a weight limit rule | `POST` | `/api/weight-limit-rules` | `modules/rule-engine/controllers/weight-limit-rules.controller.ts:32` |
+| Update a weight limit rule | `PATCH` | `/api/weight-limit-rules/:id` | `modules/rule-engine/controllers/weight-limit-rules.controller.ts:39` |
+| Soft-delete a weight limit rule | `DELETE` | `/api/weight-limit-rules/:id` | `modules/rule-engine/controllers/weight-limit-rules.controller.ts:46` |
+
+### Yard
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a yard | `POST` | `/api/yards` | `modules/rule-engine/controllers/yards.controller.ts:53` |
+| Move a yard up or down in display order | `POST` | `/api/yards/:id/move-order` | `modules/rule-engine/controllers/yards.controller.ts:38` |
+| Bulk reorder yards by ID list | `POST` | `/api/yards/reorder` | `modules/rule-engine/controllers/yards.controller.ts:30` |
+| Update a yard | `PATCH` | `/api/yards/:id` | `modules/rule-engine/controllers/yards.controller.ts:60` |
+| Soft-delete a yard | `DELETE` | `/api/yards/:id` | `modules/rule-engine/controllers/yards.controller.ts:67` |
+
+### Yard Distance
+
+| Title | Method | Endpoint | Source |
+| --- | --- | --- | --- |
+| Create a yard distance | `POST` | `/api/yard-distances` | `modules/rule-engine/controllers/yard-distances.controller.ts:42` |
+| Update a yard distance | `PATCH` | `/api/yard-distances/:id` | `modules/rule-engine/controllers/yard-distances.controller.ts:49` |
+| Soft-delete a yard distance | `DELETE` | `/api/yard-distances/:id` | `modules/rule-engine/controllers/yard-distances.controller.ts:56` |
+
diff --git a/apps/edr-freight-api/package.json b/apps/edr-freight-api/package.json
index c4837c8a7..e10e5dcb7 100644
--- a/apps/edr-freight-api/package.json
+++ b/apps/edr-freight-api/package.json
@@ -37,7 +37,8 @@
     "iam:migration:revert": "pnpm run iam:typeorm:cli migration:revert",
     "iam:migration:show": "pnpm run iam:typeorm:cli migration:show",
     "migration:run": "nest build && node dist/scripts/migrate.js",
-    "script": "ts-node -r tsconfig-paths/register src/scripts/main.ts"
+    "script": "ts-node -r tsconfig-paths/register src/scripts/main.ts",
+    "eims:login": "ts-node -r tsconfig-paths/register src/scripts/eims-login.ts"
   },
   "dependencies": {
     "@edr/api-common": "workspace:*",
@@ -59,7 +60,6 @@
     "@nestjs/typeorm": "^11.0.1",
     "@nestjs/websockets": "^11.1.27",
     "@tria-plc/api-common": "file:../../local-packages/tria-plc-api-common-1.6.0.tgz",
-    "@tria-plc/auditlog": "file:../../local-packages/tria-plc-auditlog-1.1.2.tgz",
     "@tria-plc/iamapi-common": "file:../../local-packages/tria-plc-iamapi-common-1.0.0.tgz",
     "amqp-connection-manager": "^5.0.0",
     "amqplib": "^2.0.1",
@@ -69,6 +69,7 @@
     "cross-env": "^10.1.0",
     "dotenv": "^17.4.2",
     "dotenv-cli": "^11.0.0",
+    "exceljs": "^4.4.0",
     "handlebars": "^4.7.9",
     "jose": "^5.10.0",
     "libphonenumber-js": "^1.13.6",
diff --git a/apps/edr-freight-api/src/app.module.ts b/apps/edr-freight-api/src/app.module.ts
index c98990d25..4ec11e082 100644
--- a/apps/edr-freight-api/src/app.module.ts
+++ b/apps/edr-freight-api/src/app.module.ts
@@ -16,13 +16,14 @@ import {
 import { IamBaselineSeeder, IamSeedModule } from "@edr/iam-seed";
 import { IamModule } from "@tria-plc/iamapi-common";
 import { SharedAuthModule } from "@tria-plc/api-common/modules/auth/shared-auth.module";
-import { MezgebModule } from "@tria-plc/auditlog";
 
 import appConfig from "./config/app.config";
 import databaseConfig from "./config/database.config";
 import telebirrConfig from "./config/telebirr.config";
 import rabbitmqConfig from "./config/rabbitmq.config";
 import faydaConfig from "./config/fayda.config";
+import eimsConfig from "./config/eims.config";
+import chatConfig from "./config/chat.config";
 
 import { BookingsModule } from "./modules/bookings/bookings.module";
 import { ContractsModule } from "./modules/contracts/contracts.module";
@@ -40,6 +41,8 @@ import { TrainSchedulesModule } from "./modules/train-schedules/train-schedules.
 import { TrainSchedulingModule } from "./modules/train-scheduling/train-scheduling.module";
 import { SchedulingRescheduleModule } from "./modules/scheduling-reschedule/scheduling-reschedule.module";
 import { CompaniesModule } from "./modules/companies/companies.module";
+import { ShippingLineBookingCompletionModule } from "./modules/shipping-lines/shipping-line-booking-completion.module";
+import { ShippingLineCompaniesModule } from "./modules/shipping-lines/shipping-line-companies.module";
 import { TrackingModule } from "./modules/tracking/tracking.module";
 import { BillingModule } from "./modules/billing/billing.module";
 import { NotificationsModule } from "./modules/notifications/notifications.module";
@@ -48,7 +51,11 @@ import { SupportChatModule } from "./modules/support-chat/support-chat.module";
 import { FileUploadSettingsModule } from "./modules/file-upload-settings/file-upload-settings.module";
 import { DropdownSettingsModule } from "./modules/dropdown-settings/dropdown-settings.module";
 import { ExchangeSettingsModule } from "./modules/exchange-settings/exchange-settings.module";
+import { PaymentSettingsModule } from "./modules/payment-settings/payment-settings.module";
+import { StampSettingsModule } from "./modules/stamp-settings/stamp-settings.module";
+import { LogoSettingsModule } from "./modules/logo-settings/logo-settings.module";
 import { ContractTemplatesModule } from "./modules/contract-templates/contract-templates.module";
+import { SupportContentModule } from "./modules/support-content/support-content.module";
 import { OtpModule } from "./modules/otp/otp.module";
 import { HealthModule } from "./modules/health/health.module";
 import { RuleEngineModule } from "./modules/rule-engine/rule-engine.module";
@@ -66,6 +73,7 @@ import { FreightPositionsSeeder } from "./seed/freight-positions.seeder";
 import { PaymentModule } from "./modules/payment/payment.module";
 // import { PricingDataSeeder } from "./seed/pricing-data.seeder";
 import { FileUploadSettingsSeeder } from "./seed/file-upload-settings.seeder";
+import { SupportContentSeeder } from "./seed/support-content.seeder";
 // import { YardFacilitiesSeeder } from "./seed/yard-facilities.seeder";
 // import { IndodeFacilitySeeder } from "./seed/indode-facility.seeder";
 // import { Batch14TestDataSeeder } from "./seed/batch1-4-test-data.seeder";
@@ -76,13 +84,15 @@ import { FileUploadSettingsSeeder } from "./seed/file-upload-settings.seeder";
 // import { ExportDjiboutiInterchangeDemoSeeder } from "./seed/export-djibouti-interchange-demo.seeder";
 // import { MarshallingDemoTrainsSeeder } from "./seed/marshalling-demo-trains.seeder";
 import { FreightPermissionKeyMigrationSeeder } from "./seed/freight-permission-key-migration.seeder";
+import { FreightNotificationPermissionsSeeder } from "./seed/freight-notification-permissions.seeder";
 // import { DemoFreightDataSeeder } from "./seed/demo-freight-data.seeder";
 // import { GovCompaniesSeeder } from "./seed/gov-companies.seeder";
-import { ApprovedFirstLastMileDemoBookingsSeeder } from "./seed/approved-first-lastmile-demo-bookings.seeder";
-import { PaidImportExportMileDemoSeeder } from "./seed/paid-import-export-mile-demo.seeder";
+// import { ApprovedFirstLastMileDemoBookingsSeeder } from "./seed/approved-first-lastmile-demo-bookings.seeder";
+// import { PaidImportExportMileDemoSeeder } from "./seed/paid-import-export-mile-demo.seeder";
 //New Trains, Wagons, Container and Cargo management modules
 import { TrainsModule } from "./modules/trains/trains.module";
 import { VerifaydaModule } from "./modules/verifayda/verifayda.module";
+import { EimsModule } from "./modules/eims/eims.module";
 import { FleetHistoryModule } from "./modules/fleet-history/fleet-history.module";
 import { WagonsModule } from "./modules/wagons/wagons.module";
 import { ContainersModule } from "./modules/container-management/containers.module";
@@ -108,7 +118,10 @@ import { InterchangeDocumentsModule } from "./modules/interchange-documents/inte
 import { ImportOperationsModule } from "./modules/import-operations/import-operations.module";
 import { AiModule } from "./modules/ai/ai.module";
 import { AuditModule } from "./modules/audit/audit.module";
-import { LoggerMiddleware } from "./logger.middleware";
+// dev replaced the local LoggerMiddleware with the shared RequestLogMiddleware
+// and deleted ./logger.middleware, so the branch's import is dropped here.
+import { RequestLogMiddleware } from "@edr/api-common";
+import { ChatModule } from "./modules/chat/chat.module";
 import { LoginAudienceMiddleware } from "./modules/auth/login-audience.middleware";
 import { PositionTypePermissionsCache } from "./common/position-type-permissions.cache";
 
@@ -126,6 +139,8 @@ if (!process.env.APPLICATION_NAME) {
         telebirrConfig,
         rabbitmqConfig,
         faydaConfig,
+        eimsConfig,
+        chatConfig,
       ],
     }),
     ScheduleModule.forRoot(),
@@ -163,19 +178,6 @@ if (!process.env.APPLICATION_NAME) {
         return dataSource;
       },
     }),
-    // Request + entity-level audit logging over RabbitMQ (@tria-plc/auditlog).
-    // Must come after TypeOrmModule above so it picks up this app's DataSource.
-    // rmqUrl falls back the same way notifications.module.ts's RABBITMQ_URL
-    // does: the dev broker only provisions the `edr` user on the `payment`
-    // vhost (docker-compose's RABBITMQ_DEFAULT_USER/VHOST), so an unset
-    // RABBITMQ_URL must land there too, not on guest@'/' (403 ACCESS_REFUSED).
-    MezgebModule.forRoot({
-      applicationName: "freight-api",
-      rmqUrl:
-        process.env.RABBITMQ_URL ??
-        process.env.PAYMENT_RABBITMQ_URL ??
-        "amqp://localhost:5672",
-    }),
     SharedAuthModule,
     IamModule.forRoot({
       applications: [EDR_FREIGHT_APPLICATION],
@@ -207,6 +209,8 @@ if (!process.env.APPLICATION_NAME) {
     TrainSchedulingModule,
     SchedulingRescheduleModule,
     CompaniesModule,
+    ShippingLineCompaniesModule,
+    ShippingLineBookingCompletionModule,
     TrackingModule,
     BillingModule,
     NotificationsModule,
@@ -215,7 +219,11 @@ if (!process.env.APPLICATION_NAME) {
     FileUploadSettingsModule,
     DropdownSettingsModule,
     ExchangeSettingsModule,
+    PaymentSettingsModule,
+    StampSettingsModule,
+    LogoSettingsModule,
     ContractTemplatesModule,
+    SupportContentModule,
     OtpModule,
     HealthModule,
     RuleEngineModule,
@@ -247,16 +255,20 @@ if (!process.env.APPLICATION_NAME) {
     InterchangeDocumentsModule,
     ImportOperationsModule,
     VerifaydaModule,
+    EimsModule,
     FleetHistoryModule,
     AiModule,
     AuditModule,
+    ChatModule,
   ],
   providers: [
     EdrOrgSeeder,
     FreightPositionsSeeder,
     FileUploadSettingsSeeder,
+    SupportContentSeeder,
     // YardFacilitiesSeeder,
     FreightPermissionKeyMigrationSeeder,
+    FreightNotificationPermissionsSeeder,
     // Disabled seeds — providers commented out (imports/injection/run too):
     // DemoUsersSeeder,
     // FreightStaffUsersSeeder,
@@ -271,8 +283,8 @@ if (!process.env.APPLICATION_NAME) {
     // WarehouseDemoSeeder,
     // ExportDjiboutiInterchangeDemoSeeder,
     // MarshallingDemoTrainsSeeder,
-    ApprovedFirstLastMileDemoBookingsSeeder,
-    PaidImportExportMileDemoSeeder,
+    // ApprovedFirstLastMileDemoBookingsSeeder,
+    // PaidImportExportMileDemoSeeder,
     LoginAudienceMiddleware,
     // Feeds position-TYPE grants to the synchronous permission checks — without
     // it, staff whose permissions live on their position type resolve to none.
@@ -285,8 +297,10 @@ export class AppModule implements OnApplicationBootstrap {
     private readonly edrOrgSeeder: EdrOrgSeeder,
     private readonly freightPositionsSeeder: FreightPositionsSeeder,
     private readonly fileUploadSettingsSeeder: FileUploadSettingsSeeder,
+    private readonly supportContentSeeder: SupportContentSeeder,
     // private readonly yardFacilitiesSeeder: YardFacilitiesSeeder,
     private readonly freightPermissionKeyMigrationSeeder: FreightPermissionKeyMigrationSeeder,
+    private readonly freightNotificationPermissionsSeeder: FreightNotificationPermissionsSeeder,
     // Disabled seeds — injections commented out (imports/provider/run too):
     // private readonly demoUsersSeeder: DemoUsersSeeder,
     // private readonly freightStaffUsersSeeder: FreightStaffUsersSeeder,
@@ -328,10 +342,24 @@ export class AppModule implements OnApplicationBootstrap {
     await this.edrOrgSeeder.run();
     await this.iamBaselineSeeder.run();
     await this.freightPositionsSeeder.run();
+    //   freightNotificationPermissions → seeds the <module>:get_notification
+    //                                   keys and backfills them onto whoever
+    //                                   already holds each desk's anchor
+    //                                   permission. Runs LAST in this block so
+    //                                   it sees a freshly-seeded catalog and
+    //                                   freshly-seeded positions. Unlike the
+    //                                   seeders above it is NOT gated behind
+    //                                   SEED_EDR_ORG — without it every staff
+    //                                   notification resolves to no one.
+    await this.freightNotificationPermissionsSeeder.run();
 
     // File upload settings — keep enabled.
     await this.fileUploadSettingsSeeder.run();
 
+    // Portal help/FAQ/legal copy — keep enabled. Idempotent by emptiness, so
+    // it fills an empty table once and never touches admin edits afterwards.
+    await this.supportContentSeeder.run();
+
     // Flags which yards can load/unload cargo (Indode, Sebeta, Modjo, Adama,
     // Dire Dawa). Idempotent; creates no yards.
     // await this.yardFacilitiesSeeder.run();
@@ -364,7 +392,9 @@ export class AppModule implements OnApplicationBootstrap {
   }
 
   configure(consumer: MiddlewareConsumer) {
-    consumer.apply(LoggerMiddleware).forRoutes("*");
+    // FIRST: opens the request log context every later middleware/guard/service
+    // writes into via logCtx(). Anything applied above it logs into the void.
+    consumer.apply(RequestLogMiddleware).forRoutes("*");
     consumer
       .apply(LoginAudienceMiddleware)
       .forRoutes(
diff --git a/apps/edr-freight-api/src/common/booking-guards.ts b/apps/edr-freight-api/src/common/booking-guards.ts
index d1b5364c3..f9eab4d39 100644
--- a/apps/edr-freight-api/src/common/booking-guards.ts
+++ b/apps/edr-freight-api/src/common/booking-guards.ts
@@ -49,6 +49,8 @@ export const MixedAudience = (permission: string | string[]) =>
 
 export const BookingView = () => BookingStaff(FREIGHT_PERMS.bookings.view);
 
+export const ChatSync = () => BookingStaff(FREIGHT_PERMS.chat.sync);
+
 /**
  * The document-review countdown in the backoffice header. Its own permission so
  * it can be granted to exactly the position types that decide operation
@@ -90,6 +92,10 @@ export const TrainSchedulingReschedule = () =>
 export const TrainSchedulingRulesManage = () =>
   BookingStaff(FREIGHT_PERMS.trainScheduling.rulesManage);
 
+/** Edit a schedule's operational run numbers (train + voyage) before dispatch. */
+export const TrainSchedulingEditTrainNumber = () =>
+  BookingStaff(FREIGHT_PERMS.trainScheduling.editTrainNumber);
+
 /**
  * Fleet guards take an optional granular per-resource key (locomotives:create,
  * wagons:delete, …). The legacy coarse fleet:view / fleet:manage keys remain
diff --git a/apps/edr-freight-api/src/common/dev-bypass.util.ts b/apps/edr-freight-api/src/common/dev-bypass.util.ts
new file mode 100644
index 000000000..5e6e39e8d
--- /dev/null
+++ b/apps/edr-freight-api/src/common/dev-bypass.util.ts
@@ -0,0 +1,13 @@
+/**
+ * Dev/staging bypass gate for OTP, payment and Fayda verification.
+ *
+ * Gated purely on `ENV` (dev|staging) — never on NODE_ENV, so it can't be
+ * mistaken for a prod-vs-non-prod switch. `ENV` is simply left unset in
+ * production, so this is always false there.
+ */
+export function isBypassEnv(): boolean {
+  return ["dev", "staging"].includes(process.env.ENV ?? "");
+}
+
+/** Fixed code accepted in addition to the real one when isBypassEnv(). */
+export const DEV_BYPASS_OTP = "000000";
diff --git a/apps/edr-freight-api/src/common/document-upload.options.ts b/apps/edr-freight-api/src/common/document-upload.options.ts
new file mode 100644
index 000000000..736d8099b
--- /dev/null
+++ b/apps/edr-freight-api/src/common/document-upload.options.ts
@@ -0,0 +1,30 @@
+import { MulterOptions } from "@nestjs/platform-express/multer/interfaces/multer-options.interface";
+
+/**
+ * Ceiling for a single uploaded document, in bytes.
+ *
+ * Mirrors the 50MB `max_size_mb` the file-upload settings hand the portal, so
+ * the client-side gate and the server-side cap agree. Raising this alone is not
+ * enough to accept a 50MB upload: the reverse proxy in front of the API applies
+ * its own `client_max_body_size`, and nginx's 1MB default rejects the request
+ * with a 413 before it ever reaches Nest (see docs/uploads.md).
+ */
+export const DOCUMENT_UPLOAD_MAX_BYTES = 50 * 1024 * 1024;
+
+/** Upper bound on parts in one multipart document post. */
+export const DOCUMENT_UPLOAD_MAX_FILES = 20;
+
+/**
+ * Multer caps for the document upload routes.
+ *
+ * Without an explicit `fileSize`, multer's default is unlimited and every byte
+ * is buffered in memory, so an oversized post is absorbed in full before
+ * anything can reject it. With the limit set, multer stops reading the socket
+ * at the ceiling instead.
+ */
+export const documentUploadMulterOptions: MulterOptions = {
+  limits: {
+    fileSize: DOCUMENT_UPLOAD_MAX_BYTES,
+    files: DOCUMENT_UPLOAD_MAX_FILES,
+  },
+};
diff --git a/apps/edr-freight-api/src/common/dto/pagination-query.dto.ts b/apps/edr-freight-api/src/common/dto/pagination-query.dto.ts
index 997ced76d..e705b019d 100644
--- a/apps/edr-freight-api/src/common/dto/pagination-query.dto.ts
+++ b/apps/edr-freight-api/src/common/dto/pagination-query.dto.ts
@@ -41,4 +41,16 @@ export class PaginationQueryDto {
   @Transform(({ value }) => String(value).toUpperCase())
   @IsIn(['ASC', 'DESC'])
   sortOrder?: 'ASC' | 'DESC';
+
+  /**
+   * Column to sort by, as a public field name (not a raw SQL column). The
+   * actual whitelist lives in `applySort`'s `sortable` map at each call site,
+   * not here — a per-DTO `@IsIn` is opt-in and has been forgotten before.
+   * An unrecognized value falls back silently rather than 400ing, so a stale
+   * bookmark or shared link never breaks.
+   */
+  @ApiPropertyOptional({ description: 'Public field name; unknown values fall back to the endpoint default.' })
+  @IsOptional()
+  @Transform(({ value }) => (typeof value === 'string' && value.trim() ? value.trim() : undefined))
+  sortBy?: string;
 }
diff --git a/apps/edr-freight-api/src/common/export-received-gate.spec.ts b/apps/edr-freight-api/src/common/export-received-gate.spec.ts
index 6aaa24a26..62e7c758c 100644
--- a/apps/edr-freight-api/src/common/export-received-gate.spec.ts
+++ b/apps/edr-freight-api/src/common/export-received-gate.spec.ts
@@ -36,4 +36,27 @@ describe('assertExportReceivedWithGrn', () => {
       assertExportReceivedWithGrn(db([]), { id: 'b-1', tradeDirection: 'DOMESTIC' }),
     ).resolves.toBeUndefined();
   });
+
+  it('never blocks direct truck-to-train export — that cargo has no GRN by design', async () => {
+    const source = db([]);
+    await expect(
+      assertExportReceivedWithGrn(source, {
+        id: 'b-1',
+        tradeDirection: 'EXPORT',
+        exportHandoverMode: 'DIRECT_TO_TRAIN',
+      }),
+    ).resolves.toBeUndefined();
+    // Direct short-circuits before querying — there is no inventory to look for.
+    expect(source.query as jest.Mock).not.toHaveBeenCalled();
+  });
+
+  it('still gates a warehouse export booking', async () => {
+    await expect(
+      assertExportReceivedWithGrn(db([]), {
+        id: 'b-1',
+        tradeDirection: 'EXPORT',
+        exportHandoverMode: 'WAREHOUSE',
+      }),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
 });
diff --git a/apps/edr-freight-api/src/common/export-received-gate.ts b/apps/edr-freight-api/src/common/export-received-gate.ts
index 0e1728800..5fd97480a 100644
--- a/apps/edr-freight-api/src/common/export-received-gate.ts
+++ b/apps/edr-freight-api/src/common/export-received-gate.ts
@@ -5,8 +5,15 @@ import type { DataSource, EntityManager } from 'typeorm';
 export interface ExportLoadGateBooking {
   id: string;
   tradeDirection?: string | null;
+  /** 'DIRECT_TO_TRAIN' skips the gate entirely; null/'WAREHOUSE' keeps it. */
+  exportHandoverMode?: string | null;
 }
 
+/** Direct truck-to-train: the cargo never sees a warehouse, so it never has a GRN. */
+export const DIRECT_TO_TRAIN = 'DIRECT_TO_TRAIN';
+/** Warehouse-then-train: the existing flow. Also what a null mode means. */
+export const WAREHOUSE = 'WAREHOUSE';
+
 /**
  * Export cargo may not be loaded onto its train until it has physically reached
  * the warehouse and been issued a GRN — whether it got there by first-mile or by
@@ -21,12 +28,18 @@ export interface ExportLoadGateBooking {
  * "Received with a GRN" = an inventory row that has reached the warehouse
  * (RECEIVED or any later stage) and carries a GRN, in the column or the notes
  * fallback older rows use.
+ *
+ * Export has a second, warehouse-free shape: the customer's truck loads straight
+ * onto the wagon. That cargo is never received and never GRN'd, so a booking
+ * marked DIRECT_TO_TRAIN is outside this gate by definition — its custody is
+ * attested by the carriage acceptance sheet instead.
  */
 export async function assertExportReceivedWithGrn(
   db: DataSource | EntityManager,
   booking: ExportLoadGateBooking,
 ): Promise<void> {
   if (booking.tradeDirection !== 'EXPORT') return;
+  if (booking.exportHandoverMode === DIRECT_TO_TRAIN) return;
 
   const [row] = await db.query(
     `SELECT 1
diff --git a/apps/edr-freight-api/src/common/request-log-context.spec.ts b/apps/edr-freight-api/src/common/request-log-context.spec.ts
new file mode 100644
index 000000000..e898cb930
--- /dev/null
+++ b/apps/edr-freight-api/src/common/request-log-context.spec.ts
@@ -0,0 +1,199 @@
+import { Logger } from "@nestjs/common";
+import type { Repository } from "typeorm";
+import {
+  BaseRepository,
+  RequestLogMiddleware,
+  getLogContext,
+  logCtx,
+  runWithLogContext,
+} from "@edr/api-common";
+
+describe("logCtx", () => {
+  it("is a no-op outside a request", () => {
+    expect(() => logCtx({ bookingId: "b1" })).not.toThrow();
+    expect(getLogContext()).toBeUndefined();
+  });
+
+  it("collects data points across the request and isolates concurrent ones", async () => {
+    const collect = async (id: string) =>
+      runWithLogContext({ requestId: id }, async () => {
+        logCtx({ bookingId: id });
+        await Promise.resolve();
+        logCtx({ from: "DRAFT", to: "SUBMITTED" }, { path: "booking.status" });
+        logCtx({ wagonId: "w1" }, { path: "wagons", mode: "push" });
+        logCtx({ wagonId: "w2" }, { path: "wagons", mode: "push" });
+        logCtx(1, { path: "smsSent", mode: "count" });
+        logCtx(1, { path: "smsSent", mode: "count" });
+        logCtx("PAID", { path: "payment.state", mode: "set" });
+        logCtx({ ignored: true }, (ctx) => {
+          ctx.custom = "yes";
+        });
+        return getLogContext();
+      });
+
+    const [a, b] = await Promise.all([collect("r1"), collect("r2")]);
+
+    expect(a).toEqual({
+      requestId: "r1",
+      bookingId: "r1",
+      booking: { status: { from: "DRAFT", to: "SUBMITTED" } },
+      wagons: [{ wagonId: "w1" }, { wagonId: "w2" }],
+      smsSent: 2,
+      payment: { state: "PAID" },
+      custom: "yes",
+    });
+    expect(b?.requestId).toBe("r2");
+    expect(b?.bookingId).toBe("r2");
+  });
+});
+
+describe("RequestLogMiddleware", () => {
+  it("emits one canonical JSON line carrying the collected context", () => {
+    // Raw stdout, not the Nest logger — the line must be parsable JSON with no
+    // "[Nest] … LOG [request]" prefix in front of it.
+    const lines: string[] = [];
+    jest.spyOn(process.stdout, "write").mockImplementation((chunk) => {
+      lines.push(String(chunk));
+      return true;
+    });
+    jest.spyOn(Logger.prototype, "log").mockImplementation(() => undefined);
+
+    const listeners: Record<string, () => void> = {};
+    const req = {
+      method: "POST",
+      url: "/api/bookings/1/submit",
+      originalUrl: "/api/bookings/1/submit?dry=1",
+      baseUrl: "/api/bookings",
+      route: { path: "/:id/submit" },
+      headers: {
+        "user-agent": "jest",
+        "x-request-id": "req-42",
+        authorization: "Bearer tok",
+        "x-client-app": "freight-backoffice",
+        "current-project-id": "proj-3",
+      },
+      ip: "10.0.0.1",
+      query: { dry: "1" },
+      user: {
+        id: "u-7",
+        sessionId: "sess-9",
+        userType: "STAFF",
+        status: "ACTIVE",
+        username: "nati",
+        email: "nati@example.com",
+        phoneNumber: "0911000000",
+        name: { en: "Nati" },
+        roles: [{ key: "freight_operations" }],
+        permissions: [{ key: "a" }, { key: "b" }],
+        employee: {
+          id: "emp-1",
+          organizationId: "org-1",
+          unitId: "unit-2",
+          position: {
+            id: "pos-5",
+            key: "ops_officer",
+            employeePositionId: "ep-6",
+            isDelegate: true,
+            delegatorId: "pos-1",
+            positionType: { key: "operations" },
+          },
+        },
+      },
+    };
+    const res = {
+      statusCode: 409,
+      writableEnded: true,
+      setHeader: jest.fn(),
+      on: (event: string, fn: () => void) => {
+        listeners[event] = fn;
+      },
+    };
+
+    new RequestLogMiddleware().use(req, res, () => {
+      logCtx({ bookingId: "b-1" });
+      logCtx("REJECTED", { path: "booking.outcome", mode: "set" });
+    });
+    listeners.finish();
+    listeners.close(); // aborts/close after finish must not double-log
+
+    expect(lines).toHaveLength(1);
+    expect(lines[0].endsWith("\n")).toBe(true);
+    expect(lines[0].startsWith("{")).toBe(true);
+    expect(JSON.parse(lines[0])).toMatchObject({
+      level: "warn",
+      logger: "request",
+      type: "http_request",
+      requestId: "req-42",
+      method: "POST",
+      route: "/api/bookings/:id/submit",
+      url: "/api/bookings/1/submit?dry=1",
+      status: 409,
+      userId: "u-7",
+      ip: "10.0.0.1",
+      userAgent: "jest",
+      query: { dry: "1" },
+      bookingId: "b-1",
+      booking: { outcome: "REJECTED" },
+    });
+    expect(JSON.parse(lines[0]).auth).toEqual({
+      authenticated: true,
+      hasBearer: true,
+      clientApp: "freight-backoffice",
+      userId: "u-7",
+      sessionId: "sess-9",
+      userType: "STAFF",
+      userStatus: "ACTIVE",
+      roles: ["freight_operations"],
+      permissionCount: 2,
+      employeeId: "emp-1",
+      organizationId: "org-1",
+      unitId: "unit-2",
+      positionId: "pos-5",
+      positionKey: "ops_officer",
+      positionType: "operations",
+      employeePositionId: "ep-6",
+      isDelegate: true,
+      delegatorId: "pos-1",
+      projectId: "proj-3",
+    });
+    // No personal data reaches the line, whatever the token carried.
+    expect(lines[0]).not.toMatch(/nati|example\.com|0911000000/);
+    expect(res.setHeader).toHaveBeenCalledWith("x-request-id", "req-42");
+    jest.restoreAllMocks();
+  });
+});
+
+describe("BaseRepository write trail", () => {
+  class TestRepo extends BaseRepository<{ id: string; status?: string }> {
+    constructor(repo: Repository<{ id: string; status?: string }>) {
+      super(repo);
+    }
+  }
+
+  const typeormRepo = {
+    metadata: { tableName: "booking" },
+    create: (data: unknown) => data,
+    save: async (data: unknown) => data,
+    update: async () => undefined,
+    findOne: async () => ({ id: "b-1", status: "SUBMITTED" }),
+    softDelete: async () => undefined,
+    delete: async () => undefined,
+  } as unknown as Repository<{ id: string; status?: string }>;
+
+  it("records creates, status changes and deletes without any service opting in", async () => {
+    const ctx = await runWithLogContext({}, async () => {
+      const repo = new TestRepo(typeormRepo);
+      await repo.create({ id: "b-1" });
+      await repo.update("b-1", { status: "SUBMITTED" });
+      await repo.update("b-1", { id: "b-1" }); // no status → no transition entry
+      await repo.softDelete("b-1");
+      return getLogContext();
+    });
+
+    expect(ctx).toEqual({
+      db: { created: { booking: 1 }, updated: { booking: 2 } },
+      statusChanges: [{ entity: "booking", id: "b-1", status: "SUBMITTED" }],
+      deleted: [{ entity: "booking", id: "b-1" }],
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/common/utils/facets.util.ts b/apps/edr-freight-api/src/common/utils/facets.util.ts
new file mode 100644
index 000000000..bc80c4b93
--- /dev/null
+++ b/apps/edr-freight-api/src/common/utils/facets.util.ts
@@ -0,0 +1,48 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+export interface FacetBucket {
+  value: string;
+  count: number;
+}
+
+/**
+ * One `GROUP BY` query per faceted column, each with every OTHER active
+ * filter applied but its OWN predicate omitted. That omission is the point:
+ * with `status=SUBMITTED` selected, the status facet still reports
+ * `APPROVED: 8` so the user can switch, while the freightType facet reflects
+ * only the SUBMITTED-scoped set. Omit `search` from nothing — it's a scope,
+ * not a pill, and stays applied in every facet.
+ *
+ * Capped at 50 buckets per column — FK-id facets (warehouseId, yardId) can
+ * have real cardinality; beyond 50 the frontend should fall back to a
+ * typeahead instead of a checkbox list. Never facet a column whose popover
+ * would need its own search box (references, plate numbers, free text).
+ *
+ * @param base          builds a FRESH query builder (soft-delete guard only,
+ *                       no filters) — called once per facet column.
+ * @param applyFilters  applies every filter to `qb`, using `omit` to skip
+ *                       one column's own predicate.
+ * @param columns       facet key -> "alias.column" SQL reference.
+ */
+export async function computeFacets<T extends ObjectLiteral>(
+  base: () => SelectQueryBuilder<T>,
+  applyFilters: (qb: SelectQueryBuilder<T>, omit?: string) => void,
+  columns: Record<string, string>,
+): Promise<Record<string, FacetBucket[]>> {
+  const entries = await Promise.all(
+    Object.entries(columns).map(async ([key, column]) => {
+      const qb = base();
+      applyFilters(qb, key);
+      const rows = await qb
+        .select(column, 'value')
+        .addSelect('COUNT(*)::int', 'count')
+        .andWhere(`${column} IS NOT NULL`)
+        .groupBy(column)
+        .orderBy('count', 'DESC')
+        .limit(50)
+        .getRawMany<{ value: string; count: number }>();
+      return [key, rows.map((r) => ({ value: String(r.value), count: Number(r.count) }))] as const;
+    }),
+  );
+  return Object.fromEntries(entries);
+}
diff --git a/apps/edr-freight-api/src/common/utils/iam-user-name.util.ts b/apps/edr-freight-api/src/common/utils/iam-user-name.util.ts
new file mode 100644
index 000000000..e4a3465d0
--- /dev/null
+++ b/apps/edr-freight-api/src/common/utils/iam-user-name.util.ts
@@ -0,0 +1,49 @@
+import { DataSource } from "typeorm";
+
+/**
+ * `iam.users.name` is a localized object ({ en, am, … }), not a string — a
+ * plain `String(name)` there yields "[object Object]" in an audit trail.
+ */
+export interface IamUserRow {
+  name?: Record<string, string> | string | null;
+  username?: string | null;
+  email?: string | null;
+}
+
+/** Best display name for a user row: English label → any locale → login → email. */
+export function pickUserName(user: IamUserRow): string | null {
+  const { name } = user;
+  if (typeof name === "string" && name.trim()) return name.trim();
+  if (name && typeof name === "object") {
+    const localized =
+      name.en ??
+      Object.values(name).find((v) => typeof v === "string" && v.trim());
+    if (localized?.trim()) return localized.trim();
+  }
+  return user.username?.trim() || user.email?.trim() || null;
+}
+
+/**
+ * Display names for a set of IAM user ids — one query for the whole set.
+ * `iam.users` is owned by the auth system and has no entity here, so it is read
+ * directly. A miss is not an error: the caller still holds the id and can fall
+ * back to it.
+ */
+export async function resolveIamUserNames(
+  dataSource: DataSource,
+  userIds: (string | null | undefined)[],
+): Promise<Map<string, string>> {
+  const resolved = new Map<string, string>();
+  const ids = [...new Set(userIds.filter((id): id is string => Boolean(id)))];
+  if (ids.length === 0) return resolved;
+
+  const rows = (await dataSource.query(
+    `SELECT id, name, username, email FROM iam.users WHERE id = ANY($1::uuid[])`,
+    [ids],
+  )) as Array<IamUserRow & { id: string }>;
+  for (const row of rows) {
+    const name = pickUserName(row);
+    if (name) resolved.set(row.id, name);
+  }
+  return resolved;
+}
diff --git a/apps/edr-freight-api/src/common/utils/pagination.util.spec.ts b/apps/edr-freight-api/src/common/utils/pagination.util.spec.ts
new file mode 100644
index 000000000..05bfe7585
--- /dev/null
+++ b/apps/edr-freight-api/src/common/utils/pagination.util.spec.ts
@@ -0,0 +1,76 @@
+import { SelectQueryBuilder } from 'typeorm';
+import { applySort, buildPaginationMeta, normalizePagination } from './pagination.util';
+
+/** Minimal fake — just enough of the SelectQueryBuilder chain applySort touches. */
+function fakeQb() {
+  const calls: Array<{ method: string; args: unknown[] }> = [];
+  const qb = {
+    alias: 'contract',
+    orderBy(...args: unknown[]) {
+      calls.push({ method: 'orderBy', args });
+      return qb;
+    },
+    addOrderBy(...args: unknown[]) {
+      calls.push({ method: 'addOrderBy', args });
+      return qb;
+    },
+  };
+  return { qb: qb as unknown as SelectQueryBuilder<any>, calls };
+}
+
+const SORTABLE = {
+  createdAt: 'contract.createdAt',
+  contractValidUntil: 'contract.contractValidUntil',
+};
+
+describe('applySort', () => {
+  it('resolves a whitelisted sortBy to its column', () => {
+    const { qb, calls } = fakeQb();
+    applySort(qb, { sortBy: 'contractValidUntil', sortOrder: 'ASC' }, SORTABLE, 'createdAt');
+    expect(calls[0]).toEqual({
+      method: 'orderBy',
+      args: ['contract.contractValidUntil', 'ASC'],
+    });
+  });
+
+  it('falls back to the default column for an unknown sortBy instead of throwing', () => {
+    const { qb, calls } = fakeQb();
+    // A stale bookmark or shared link naming a removed/renamed column must
+    // never 400 — it should silently behave as if sortBy were absent.
+    expect(() =>
+      applySort(qb, { sortBy: "id; DROP TABLE contracts; --" }, SORTABLE, 'createdAt'),
+    ).not.toThrow();
+    expect(calls[0]).toEqual({ method: 'orderBy', args: ['contract.createdAt', 'DESC'] });
+  });
+
+  it('defaults sortOrder to DESC when absent or not ASC', () => {
+    const { qb, calls } = fakeQb();
+    applySort(qb, {}, SORTABLE, 'createdAt');
+    expect(calls[0]).toEqual({ method: 'orderBy', args: ['contract.createdAt', 'DESC'] });
+  });
+
+  it('always appends an id ASC tiebreaker', () => {
+    const { qb, calls } = fakeQb();
+    applySort(qb, { sortBy: 'createdAt' }, SORTABLE, 'createdAt');
+    expect(calls[1]).toEqual({ method: 'addOrderBy', args: ['contract.id', 'ASC'] });
+  });
+});
+
+describe('normalizePagination / buildPaginationMeta', () => {
+  it('clamps page to >= 1 and pageSize to the configured max', () => {
+    const p = normalizePagination({ page: 0, pageSize: 999 }, { maxPageSize: 100 });
+    expect(p).toEqual({ page: 1, pageSize: 100, skip: 0, take: 100 });
+  });
+
+  it('computes hasNextPage/hasPreviousPage from total', () => {
+    const meta = buildPaginationMeta(45, 2, 20);
+    expect(meta).toEqual({
+      page: 2,
+      pageSize: 20,
+      total: 45,
+      totalPages: 3,
+      hasNextPage: true,
+      hasPreviousPage: true,
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/common/utils/pagination.util.ts b/apps/edr-freight-api/src/common/utils/pagination.util.ts
index 310b2da6d..ca4ed35a1 100644
--- a/apps/edr-freight-api/src/common/utils/pagination.util.ts
+++ b/apps/edr-freight-api/src/common/utils/pagination.util.ts
@@ -83,3 +83,32 @@ export function paginateArray<T>(
     meta: buildPaginationMeta(rows.length, page, pageSize),
   };
 }
+
+/**
+ * Apply `ORDER BY` from a query DTO's `sortBy`/`sortOrder`, resolved against a
+ * whitelist — never interpolate `sortBy` into a query builder directly, it is
+ * unvalidated user input and an unwhitelisted `orderBy(\`alias.${sortBy}\`)`
+ * is a SQL-injection primitive (see the deleted `findAllWithFilters` methods
+ * on drivers/vehicles repositories, which had exactly that bug).
+ *
+ * An unknown `sortBy` falls back to `fallback` instead of throwing — a stale
+ * bookmark or shared link should never 400.
+ *
+ * Always appends `id ASC` as a tiebreaker: sorting by a non-unique column
+ * (status, createdAt on bulk-imported rows) without one can drop or
+ * duplicate rows across pages once LIMIT/OFFSET is involved.
+ *
+ * @param sortable  public sort key -> "alias.column" SQL reference. Also
+ *   doubles as the Swagger enum / frontend's sortable-column list.
+ * @param fallback  a key that must exist in `sortable`.
+ */
+export function applySort<T extends ObjectLiteral>(
+  qb: SelectQueryBuilder<T>,
+  query: { sortBy?: string; sortOrder?: 'ASC' | 'DESC' },
+  sortable: Record<string, string>,
+  fallback: string,
+): SelectQueryBuilder<T> {
+  const column = (query.sortBy && sortable[query.sortBy]) || sortable[fallback];
+  qb.orderBy(column, query.sortOrder === 'ASC' ? 'ASC' : 'DESC');
+  return qb.addOrderBy(`${qb.alias}.id`, 'ASC');
+}
diff --git a/apps/edr-freight-api/src/config/chat.config.ts b/apps/edr-freight-api/src/config/chat.config.ts
new file mode 100644
index 000000000..ce20b610b
--- /dev/null
+++ b/apps/edr-freight-api/src/config/chat.config.ts
@@ -0,0 +1,59 @@
+import { registerAs } from '@nestjs/config';
+
+export interface ChatConfig {
+  enabled: boolean;
+  /** Synapse base URL reachable from this container (client + admin APIs). */
+  baseUrl: string;
+  /** Synapse's public_baseurl — what Element itself is configured to call. Only
+   *  used to seed the sso.html handoff; server-to-server calls use {@link baseUrl}. */
+  publicBaseUrl: string;
+  /** Public Element Web origin — the SSO handoff link points here. */
+  webUrl: string;
+  /** Matrix server_name — the `:domain` half of every MXID. */
+  serverName: string;
+  /** HS256 secret. Must exactly match Synapse's jwt_config.secret. */
+  jwtSecret: string;
+  /** Bearer token for a Synapse server admin account (room/user provisioning). */
+  adminToken: string;
+}
+
+const REQUIRED_VARS = [
+  'MATRIX_BASE_URL',
+  'MATRIX_PUBLIC_BASE_URL',
+  'MATRIX_CHAT_WEB_URL',
+  'MATRIX_SERVER_NAME',
+  'MATRIX_JWT_SECRET',
+  'MATRIX_ADMIN_TOKEN',
+] as const;
+
+export default registerAs('chat', (): ChatConfig => {
+  const enabled = (process.env.MATRIX_ENABLED ?? 'false').toLowerCase() === 'true';
+  if (!enabled) {
+    return {
+      enabled: false,
+      baseUrl: '',
+      publicBaseUrl: '',
+      webUrl: '',
+      serverName: '',
+      jwtSecret: '',
+      adminToken: '',
+    };
+  }
+
+  const missing = REQUIRED_VARS.filter((name) => !process.env[name]);
+  if (missing.length > 0) {
+    throw new Error(
+      `Internal chat is enabled (MATRIX_ENABLED=true) but the following env vars are missing: ${missing.join(', ')}`,
+    );
+  }
+
+  return {
+    enabled: true,
+    baseUrl: process.env.MATRIX_BASE_URL!.replace(/\/$/, ''),
+    publicBaseUrl: process.env.MATRIX_PUBLIC_BASE_URL!.replace(/\/$/, ''),
+    webUrl: process.env.MATRIX_CHAT_WEB_URL!.replace(/\/$/, ''),
+    serverName: process.env.MATRIX_SERVER_NAME!,
+    jwtSecret: process.env.MATRIX_JWT_SECRET!,
+    adminToken: process.env.MATRIX_ADMIN_TOKEN!,
+  };
+});
diff --git a/apps/edr-freight-api/src/config/database.config.ts b/apps/edr-freight-api/src/config/database.config.ts
index 5de529d15..77f4b37e4 100644
--- a/apps/edr-freight-api/src/config/database.config.ts
+++ b/apps/edr-freight-api/src/config/database.config.ts
@@ -56,11 +56,6 @@ import { EmployeePositionActivePeriod } from "@tria-plc/iamapi-common/entities/i
 import { UnitConfiguration } from "@tria-plc/iamapi-common/entities/iam/organization-structure/unit-configuration.entity";
 import { Site } from "@tria-plc/iamapi-common/entities/iam/site/site.entity";
 import { SiteSetting } from "@tria-plc/iamapi-common/entities/iam/site/site-setting.entity";
-import { AuditLog, AuditLogCommand } from "@tria-plc/auditlog";
-
-// @tria-plc/auditlog's entities live in node_modules, same as the iam ones —
-// the glob below only matches this app's own src/**/*.entity.ts.
-const auditEntities = [AuditLog, AuditLogCommand];
 
 const iamEntities = [
   UnitSetting,
@@ -185,7 +180,6 @@ export function buildDataSourceOptions(): DataSourceOptions {
     entities: [
       __dirname + "/../**/*.entity.{ts,js}",
       ...iamEntities,
-      ...auditEntities,
     ],
     migrations: [],
   };
@@ -215,8 +209,11 @@ export function buildFreightMigrationDataSourceOptions(): DataSourceOptions {
   };
 }
 
-export default registerAs("database", (): TypeOrmModuleOptions => ({
-  ...buildDataSourceOptions(),
-  autoLoadEntities: true,
-  migrationsRun: false,
-}));
+export default registerAs(
+  "database",
+  (): TypeOrmModuleOptions => ({
+    ...buildDataSourceOptions(),
+    autoLoadEntities: true,
+    migrationsRun: false,
+  }),
+);
diff --git a/apps/edr-freight-api/src/config/eims.config.spec.ts b/apps/edr-freight-api/src/config/eims.config.spec.ts
new file mode 100644
index 000000000..127b3ea62
--- /dev/null
+++ b/apps/edr-freight-api/src/config/eims.config.spec.ts
@@ -0,0 +1,131 @@
+import eimsConfigFactory from "./eims.config";
+
+const REQUIRED = {
+  EIMS_ENABLED: "true",
+  EIMS_CLIENT_ID: "cid",
+  EIMS_CLIENT_SECRET: "secret",
+  EIMS_API_KEY: "apikey",
+  EIMS_TIN: "0000000000",
+};
+
+const withEnv = (vars: Record<string, string | undefined>, fn: () => void) => {
+  const prior: Record<string, string | undefined> = {};
+  for (const [key, value] of Object.entries(vars)) {
+    prior[key] = process.env[key];
+    if (value === undefined) delete process.env[key];
+    else process.env[key] = value;
+  }
+  try {
+    fn();
+  } finally {
+    for (const [key, value] of Object.entries(prior)) {
+      if (value === undefined) delete process.env[key];
+      else process.env[key] = value;
+    }
+  }
+};
+
+describe("eims.config — private key / certificate resolution", () => {
+  it("unescapes a literal \\n when the PEM was pasted without real newlines", () => {
+    withEnv(
+      { ...REQUIRED, EIMS_PRIVATE_KEY: "line1\\nline2", EIMS_CERTIFICATE_PATH: "/dev/null" },
+      () => {
+        expect(eimsConfigFactory().privateKeyPem).toBe("line1\nline2");
+      },
+    );
+  });
+
+  it("leaves a PEM with real newlines untouched", () => {
+    withEnv(
+      { ...REQUIRED, EIMS_PRIVATE_KEY: "line1\nline2", EIMS_CERTIFICATE_PATH: "/dev/null" },
+      () => {
+        expect(eimsConfigFactory().privateKeyPem).toBe("line1\nline2");
+      },
+    );
+  });
+
+  it("throws naming all three key/cert options when none are set", () => {
+    withEnv(
+      {
+        ...REQUIRED,
+        EIMS_PRIVATE_KEY_PATH: undefined,
+        EIMS_PRIVATE_KEY_BASE64: undefined,
+        EIMS_PRIVATE_KEY: undefined,
+        EIMS_CERTIFICATE_PATH: "/dev/null",
+      },
+      () => {
+        expect(() => eimsConfigFactory()).toThrow(
+          /EIMS_PRIVATE_KEY_PATH or EIMS_PRIVATE_KEY_BASE64 or EIMS_PRIVATE_KEY/,
+        );
+      },
+    );
+  });
+
+  it("is satisfied by any single one of the three key options", () => {
+    withEnv(
+      { ...REQUIRED, EIMS_PRIVATE_KEY: "x", EIMS_CERTIFICATE_PATH: "/dev/null" },
+      () => {
+        expect(() => eimsConfigFactory()).not.toThrow();
+      },
+    );
+  });
+});
+
+describe("eims.config — baked-in Ethiopia region/zone/woreda codes", () => {
+  it("resolves a known region/wereda/zone with no env var set at all", () => {
+    withEnv(
+      { ...REQUIRED, EIMS_PRIVATE_KEY: "x", EIMS_CERTIFICATE_PATH: "/dev/null" },
+      () => {
+        const cfg = eimsConfigFactory();
+        expect(cfg.invoice.buyerRegionCodes.Somali).toBe("05");
+        expect(cfg.invoice.buyerWeredaCodes["Jijiga Town"]).toBe("02");
+        expect(cfg.invoice.buyerCityCodes.Fafan).toBe("01");
+      },
+    );
+  });
+
+  it("an env var entry overrides the baked-in code for the same name", () => {
+    withEnv(
+      {
+        ...REQUIRED,
+        EIMS_PRIVATE_KEY: "x",
+        EIMS_CERTIFICATE_PATH: "/dev/null",
+        EIMS_BUYER_REGION_CODES: "Somali=99",
+      },
+      () => {
+        expect(eimsConfigFactory().invoice.buyerRegionCodes.Somali).toBe("99");
+      },
+    );
+  });
+
+  it("an env var still adds a name the baked-in table doesn't have (a spelling variant)", () => {
+    withEnv(
+      {
+        ...REQUIRED,
+        EIMS_PRIVATE_KEY: "x",
+        EIMS_CERTIFICATE_PATH: "/dev/null",
+        EIMS_BUYER_CITY_CODES: "Fafen=01",
+      },
+      () => {
+        const codes = eimsConfigFactory().invoice.buyerCityCodes;
+        expect(codes.Fafen).toBe("01");
+        expect(codes.Fafan).toBe("01"); // baked-in entry still present alongside it
+      },
+    );
+  });
+
+  it("resolves the bare Addis Ababa sub-city name a buyer profile actually stores, not the CSV's example-woreda name", () => {
+    withEnv(
+      { ...REQUIRED, EIMS_PRIVATE_KEY: "x", EIMS_CERTIFICATE_PATH: "/dev/null" },
+      () => {
+        const codes = eimsConfigFactory().invoice.buyerWeredaCodes;
+        expect(codes.Bole).toBe("01");
+        expect(codes.Arada).toBe("01");
+        expect(codes.Kirkos).toBe("01");
+        expect(codes.Yeka).toBe("01");
+        expect(codes["Nifas Silk Lafto"]).toBe("13");
+        expect(codes["Nefas Silk-Lafto"]).toBe("13");
+      },
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/config/eims.config.ts b/apps/edr-freight-api/src/config/eims.config.ts
new file mode 100644
index 000000000..e5530eaf2
--- /dev/null
+++ b/apps/edr-freight-api/src/config/eims.config.ts
@@ -0,0 +1,291 @@
+import { registerAs } from "@nestjs/config";
+
+import { ETHIOPIA_REGION_CODES, ETHIOPIA_WOREDA_CODES, ETHIOPIA_ZONE_CODES } from "./ethiopia-geo-codes";
+
+/**
+ * Ethiopian MoR EIMS e-invoicing gateway.
+ *
+ * Disabled by default: with `EIMS_ENABLED=false` the config resolves to a stub and every EIMS
+ * service throws a clear error on use, so a deployment without credentials still boots.
+ *
+ * Secrets (client secret, API key) and the credential file paths live only here and are never
+ * logged — validation reports missing variable *names*, never their values.
+ */
+export interface EimsConfig {
+  enabled: boolean;
+  baseUrl: string;
+  clientId: string;
+  clientSecret: string;
+  apiKey: string;
+  tin: string;
+  /**
+   * Optional *expectations* for the source-system identity, not inputs.
+   *
+   * The access token MoR issues carries `systemNumber` and `systemType` claims for the credentials
+   * that authenticated, and those are what registration uses. When these are set they are compared
+   * against the token and a mismatch fails fast — neither side silently wins. Leave them empty to
+   * take whatever the gateway says.
+   */
+  systemNumber: string;
+  systemType: string;
+  /** Filesystem path to the INSA-issued RSA private key (PEM). Never leaves the server. */
+  privateKeyPath: string;
+  /** Filesystem path to the INSA-issued certificate bundle; sent as base64 of its exact bytes. */
+  certificatePath: string;
+  /**
+   * Inline alternative to `privateKeyPath` — the key file's own bytes, base64-encoded, so a
+   * container that can't be given a host bind mount can still receive it as a plain env var.
+   * Either one must be present when EIMS is enabled. Precedence: `privateKeyPem` > `privateKeyBase64`
+   * > `privateKeyPath`.
+   */
+  privateKeyBase64: string;
+  /** Inline alternative to `certificatePath`, same precedence rule as the key. */
+  certificateBase64: string;
+  /**
+   * The PEM key pasted directly into the env var, no encoding step at all — the most direct of the
+   * three inline forms, and the hardest for a broken transport step to mangle since there's no
+   * decode stage to get wrong. Wins over `privateKeyBase64`/`privateKeyPath` when set.
+   */
+  privateKeyPem: string;
+  /** Inline alternative to `certificateBase64`, same precedence rule. */
+  certificatePem: string;
+  httpTimeoutMs: number;
+  /** Re-authenticate this many ms before the access token actually expires. */
+  tokenSkewMs: number;
+  /**
+   * Automatic submission of issued invoices, off by default.
+   *
+   * Invoices are produced by the workflow, so the production path is a sweep rather than a human
+   * action — but enabling it starts filing real documents with the tax authority, which is
+   * irreversible from our side. It therefore needs its own deliberate switch, separate from
+   * `EIMS_ENABLED`, so that authentication can be live long before filing is.
+   */
+  autoSubmit: boolean;
+  autoSubmitCron: string;
+  /** MoR rejects a document whose date is more than 3 days old; the sweep will not attempt those. */
+  autoSubmitMaxAgeDays: number;
+  /**
+   * Seller identity and tax/business treatment for the invoice document.
+   *
+   * None of this is derivable from the database: EDR's own legal identity exists nowhere in the
+   * codebase, and the app models no tax at all. Values are required at registration time and are
+   * validated there rather than at boot, so a deployment can run with EIMS enabled for
+   * authentication before finance has signed off on the tax treatment.
+   */
+  invoice: EimsInvoiceConfig;
+}
+
+export interface EimsInvoiceConfig {
+  sellerLegalName: string;
+  sellerVatNumber: string;
+  sellerPhone: string;
+  sellerEmail: string;
+  /** MoR *codes*, not names (e.g. "13" for Addis Ababa, "574"). */
+  sellerRegion: string;
+  sellerWereda: string;
+  sellerCity: string | null;
+  sellerSubCity: string | null;
+  sellerHouseNumber: string | null;
+  sellerLocality: string | null;
+  /** REQUIRES_BUSINESS_CONFIRMATION — no tax model exists in this application. */
+  taxCode: string;
+  taxRatePercent: number | null;
+  exciseTaxValue: number | null;
+  incomeWithholdValue: number | null;
+  transactionWithholdValue: number | null;
+  /** B2B / B2C — a tax classification, so it is configured, not inferred. */
+  transactionType: string;
+  natureOfSupplies: string;
+  paymentMode: string;
+  paymentTerm: string;
+  unitDefault: string;
+  /**
+   * Domestic fallback only — used when the buyer's `Company.country` is empty or "Ethiopia" (the
+   * column's own default) and not already listed in `buyerCountryCodes`. A genuinely foreign
+   * buyer must be in `buyerCountryCodes` by name or the mapping fails locally; this value is never
+   * applied to them, so an unconfigured foreign country can't silently be filed as Ethiopia.
+   */
+  buyerCountryCode: string | null;
+  /**
+   * Country name → MoR code, from `EIMS_BUYER_COUNTRY_CODES` ("Ethiopia=231,Djibouti=071"). Format
+   * unconfirmed (unlike Region/Wereda, MoR has never named a Country regex), so — unlike them —
+   * this is not validated against a fixed digit pattern, only looked up by name.
+   */
+  buyerCountryCodes: Record<string, string>;
+  /**
+   * Buyer region name → MoR numeric code, from `EIMS_BUYER_REGION_CODES`
+   * ("Addis Ababa=13,Oromia=4"). A buyer whose region is neither a code nor in this map fails
+   * locally rather than being filed with a guessed one.
+   */
+  buyerRegionCodes: Record<string, string>;
+  /** Same mechanism as `buyerRegionCodes`, for `EIMS_BUYER_WEREDA_CODES` ("Yeka=574"). */
+  buyerWeredaCodes: Record<string, string>;
+  /**
+   * Buyer *zone* name → MoR City code, from `EIMS_BUYER_CITY_CODES` ("Kirkos=101"). `Company` has
+   * no dedicated city column — Zone is the closest match in EDR's own data. Optional, unlike
+   * Region/Wereda: MoR has never required City on a live buyer (confirmed — filing already
+   * succeeds with it null), so an unmapped zone falls back to null rather than failing the
+   * mapping.
+   */
+  buyerCityCodes: Record<string, string>;
+  /**
+   * Per-`chargeType` tax treatment, e.g. `EIMS_TAX_CODE_BY_CHARGE_TYPE=RAIL_FREIGHT=VAT0` +
+   * `EIMS_TAX_RATE_BY_CHARGE_TYPE=RAIL_FREIGHT=0`. A charge type not listed here falls back to
+   * `taxCode`/`taxRatePercent`. Needed for an invoice whose lines carry different MoR tax
+   * treatment (e.g. zero-rated freight next to a taxed accessorial) — the flat `taxCode` above
+   * cannot express that. Values are raw strings; the context builder parses/validates them.
+   */
+  taxCodeByChargeType: Record<string, string>;
+  taxRateByChargeType: Record<string, string>;
+  /** Same mechanism, for `EIMS_EXCISE_BY_CHARGE_TYPE` / `EIMS_DISCOUNT_BY_CHARGE_TYPE`. Charge
+   *  types not listed fall back to `exciseTaxValue` / 0 respectively. */
+  exciseByChargeType: Record<string, string>;
+  discountByChargeType: Record<string, string>;
+  cashierName: string | null;
+  salesPersonName: string | null;
+  /**
+   * TEMPORARY / experimental — `EIMS_BUYER_ID_TYPE` + `EIMS_BUYER_ID_NUMBER`, applied to every
+   * buyer regardless of who they are. Only exists to test whether rule 7004 ("Id types should be
+   * one of NID, KID, SID, WID, PST, DLS, MRS") is satisfied by *any* IdType/IdNumber pair, ahead
+   * of MoR's answer on whether it's required for a TIN-only corporate buyer and which value fits.
+   * Wrong for a real, non-self buyer — remove once MoR answers and a real per-buyer field exists.
+   */
+  buyerIdType: string | null;
+  buyerIdNumber: string | null;
+}
+
+const REQUIRED_VARS = ["EIMS_CLIENT_ID", "EIMS_CLIENT_SECRET", "EIMS_API_KEY", "EIMS_TIN"] as const;
+
+// Key/cert each have three ways in (file path, inline base64, or raw PEM) — checked separately
+// from REQUIRED_VARS since it's "at least one of", not "this exact var".
+const REQUIRED_ANY_OF: string[][] = [
+  ["EIMS_PRIVATE_KEY_PATH", "EIMS_PRIVATE_KEY_BASE64", "EIMS_PRIVATE_KEY"],
+  ["EIMS_CERTIFICATE_PATH", "EIMS_CERTIFICATE_BASE64", "EIMS_CERTIFICATE"],
+];
+
+const positiveInt = (raw: string | undefined, fallback: number, name: string): number => {
+  if (raw === undefined || raw === "") return fallback;
+  const value = Number.parseInt(raw, 10);
+  if (Number.isNaN(value) || value <= 0) {
+    throw new Error(`${name} must be a positive integer`);
+  }
+  return value;
+};
+
+/** "Addis Ababa=13,Oromia=4" → { "Addis Ababa": "13", Oromia: "4" }. */
+const parseCodeMap = (raw: string | undefined): Record<string, string> => {
+  const map: Record<string, string> = {};
+  for (const pair of (raw ?? "").split(",")) {
+    const [name, code] = pair.split("=");
+    if (name?.trim() && code?.trim()) map[name.trim()] = code.trim();
+  }
+  return map;
+};
+
+// Some env stores (single-line .env files, certain secret managers) can't hold a literal newline
+// and expect the caller to write "\n" as two characters instead. If the raw value already has a
+// real newline, leave it alone; otherwise unescape "\n" so a PEM pasted that way still parses.
+const normalizePem = (raw: string | undefined): string => {
+  if (!raw) return "";
+  return raw.includes("\n") ? raw : raw.replace(/\\n/g, "\n");
+};
+
+/** Unset stays null so the registration-time check can name it; a set-but-bogus value throws. */
+const optionalNumber = (raw: string | undefined, name: string): number | null => {
+  if (raw === undefined || raw === "") return null;
+  const value = Number(raw);
+  if (!Number.isFinite(value)) throw new Error(`${name} must be a number`);
+  return value;
+};
+
+export default registerAs("eims", (): EimsConfig => {
+  const enabled = (process.env.EIMS_ENABLED ?? "false").toLowerCase() === "true";
+  const baseUrl = (process.env.EIMS_BASE_URL ?? "https://core.mor.gov.et").replace(/\/+$/, "");
+  const httpTimeoutMs = positiveInt(process.env.EIMS_HTTP_TIMEOUT_MS, 30_000, "EIMS_HTTP_TIMEOUT_MS");
+  const tokenSkewMs =
+    positiveInt(process.env.EIMS_TOKEN_SKEW_SECONDS, 45, "EIMS_TOKEN_SKEW_SECONDS") * 1000;
+
+  const base: EimsConfig = {
+    enabled,
+    baseUrl,
+    clientId: process.env.EIMS_CLIENT_ID ?? "",
+    clientSecret: process.env.EIMS_CLIENT_SECRET ?? "",
+    apiKey: process.env.EIMS_API_KEY ?? "",
+    tin: process.env.EIMS_TIN ?? "",
+    systemNumber: process.env.EIMS_SYSTEM_NUMBER ?? "",
+    systemType: process.env.EIMS_SYSTEM_TYPE ?? "",
+    privateKeyPath: process.env.EIMS_PRIVATE_KEY_PATH ?? "",
+    certificatePath: process.env.EIMS_CERTIFICATE_PATH ?? "",
+    privateKeyBase64: process.env.EIMS_PRIVATE_KEY_BASE64 ?? "",
+    privateKeyPem: normalizePem(process.env.EIMS_PRIVATE_KEY),
+    certificatePem: normalizePem(process.env.EIMS_CERTIFICATE),
+    certificateBase64: process.env.EIMS_CERTIFICATE_BASE64 ?? "",
+    httpTimeoutMs,
+    tokenSkewMs,
+    autoSubmit: (process.env.EIMS_AUTO_SUBMIT ?? "false").toLowerCase() === "true",
+    // Every 5 minutes by default: filing is not latency-sensitive, and a slow cadence keeps a
+    // misconfiguration from filing a burst of bad documents before anyone notices.
+    autoSubmitCron: process.env.EIMS_AUTO_SUBMIT_CRON || "0 */5 * * * *",
+    autoSubmitMaxAgeDays: positiveInt(
+      process.env.EIMS_AUTO_SUBMIT_MAX_AGE_DAYS,
+      3,
+      "EIMS_AUTO_SUBMIT_MAX_AGE_DAYS",
+    ),
+    invoice: {
+      sellerLegalName: process.env.EIMS_SELLER_LEGAL_NAME ?? "",
+      sellerVatNumber: process.env.EIMS_SELLER_VAT_NUMBER ?? "",
+      sellerPhone: process.env.EIMS_SELLER_PHONE ?? "",
+      sellerEmail: process.env.EIMS_SELLER_EMAIL ?? "",
+      sellerRegion: process.env.EIMS_SELLER_REGION ?? "",
+      sellerWereda: process.env.EIMS_SELLER_WEREDA ?? "",
+      sellerCity: process.env.EIMS_SELLER_CITY || null,
+      sellerSubCity: process.env.EIMS_SELLER_SUBCITY || null,
+      sellerHouseNumber: process.env.EIMS_SELLER_HOUSE_NUMBER || null,
+      sellerLocality: process.env.EIMS_SELLER_LOCALITY || null,
+      taxCode: process.env.EIMS_TAX_CODE ?? "",
+      taxRatePercent: optionalNumber(process.env.EIMS_TAX_RATE_PERCENT, "EIMS_TAX_RATE_PERCENT"),
+      exciseTaxValue: optionalNumber(process.env.EIMS_EXCISE_TAX_VALUE, "EIMS_EXCISE_TAX_VALUE"),
+      incomeWithholdValue: optionalNumber(
+        process.env.EIMS_INCOME_WITHHOLD_VALUE,
+        "EIMS_INCOME_WITHHOLD_VALUE",
+      ),
+      transactionWithholdValue: optionalNumber(
+        process.env.EIMS_TRANSACTION_WITHHOLD_VALUE,
+        "EIMS_TRANSACTION_WITHHOLD_VALUE",
+      ),
+      transactionType: process.env.EIMS_TRANSACTION_TYPE ?? "",
+      natureOfSupplies: process.env.EIMS_NATURE_OF_SUPPLIES ?? "",
+      paymentMode: process.env.EIMS_PAYMENT_MODE ?? "",
+      paymentTerm: process.env.EIMS_PAYMENT_TERM ?? "",
+      unitDefault: process.env.EIMS_UNIT_DEFAULT ?? "",
+      buyerCountryCode: process.env.EIMS_BUYER_COUNTRY_CODE || null,
+      buyerCountryCodes: parseCodeMap(process.env.EIMS_BUYER_COUNTRY_CODES),
+      // Baked-in Ethiopia reference table first, env var entries win on a name collision — lets a
+      // deployment override or add to it without a redeploy. See ethiopia-geo-codes.ts.
+      buyerRegionCodes: { ...ETHIOPIA_REGION_CODES, ...parseCodeMap(process.env.EIMS_BUYER_REGION_CODES) },
+      buyerWeredaCodes: { ...ETHIOPIA_WOREDA_CODES, ...parseCodeMap(process.env.EIMS_BUYER_WEREDA_CODES) },
+      buyerCityCodes: { ...ETHIOPIA_ZONE_CODES, ...parseCodeMap(process.env.EIMS_BUYER_CITY_CODES) },
+      taxCodeByChargeType: parseCodeMap(process.env.EIMS_TAX_CODE_BY_CHARGE_TYPE),
+      taxRateByChargeType: parseCodeMap(process.env.EIMS_TAX_RATE_BY_CHARGE_TYPE),
+      exciseByChargeType: parseCodeMap(process.env.EIMS_EXCISE_BY_CHARGE_TYPE),
+      discountByChargeType: parseCodeMap(process.env.EIMS_DISCOUNT_BY_CHARGE_TYPE),
+      cashierName: process.env.EIMS_CASHIER_NAME || null,
+      salesPersonName: process.env.EIMS_SALESPERSON_NAME || null,
+      buyerIdType: process.env.EIMS_BUYER_ID_TYPE || null,
+      buyerIdNumber: process.env.EIMS_BUYER_ID_NUMBER || null,
+    },
+  };
+
+  if (!enabled) return base;
+
+  const missing: string[] = REQUIRED_VARS.filter((name) => !process.env[name]);
+  for (const vars of REQUIRED_ANY_OF) {
+    if (vars.every((name) => !process.env[name])) missing.push(vars.join(" or "));
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `EIMS integration is enabled (EIMS_ENABLED=true) but the following env vars are missing: ${missing.join(", ")}`,
+    );
+  }
+  return base;
+});
diff --git a/apps/edr-freight-api/src/config/ethiopia-geo-codes.ts b/apps/edr-freight-api/src/config/ethiopia-geo-codes.ts
new file mode 100644
index 000000000..ca48a7c5f
--- /dev/null
+++ b/apps/edr-freight-api/src/config/ethiopia-geo-codes.ts
@@ -0,0 +1,160 @@
+/**
+ * MoR EIMS region/zone/woreda codes, by name — the baked-in fallback under
+ * `EIMS_BUYER_REGION_CODES`/`EIMS_BUYER_WEREDA_CODES`/`EIMS_BUYER_CITY_CODES` (zone is the closest
+ * match to EIMS's "City", per `eims-invoice.mapper.ts`).
+ *
+ * Before this existed, every buyer from a not-yet-seen region/zone/woreda crashed EIMS filing until
+ * someone hunted down the code and added it to an env var by hand — happened three times in one
+ * afternoon (2026-08-17: Somali region, Fafan zone, Jigjiga woreda, even the Ethiopia country code
+ * itself were all unset). Ethiopia's administrative divisions are fixed, known, reference data, not
+ * something that should be maintained reactively per buyer. Source: `ethiopia_administrative_
+ * hierarchy_master.csv`, supplied 2026-08-17 — NOT exhaustive (a representative sample per region,
+ * not all ~1000 real woredas), extend as new gaps surface.
+ *
+ * The env vars stay wired in ahead of this table (see `eims.config.ts`) — for a quick correction
+ * without a redeploy, or a name spelled differently in a buyer's profile than in this table (already
+ * hit live: DB has zone "Fafen", this table's official spelling is "Fafan" — same zone, matching is
+ * case/space-insensitive but not spelling-tolerant, so the env var override is still how that buyer
+ * actually resolves; this table mainly helps the *next* buyer whose profile spelling matches).
+ *
+ * ponytail: region names are unique nationwide (only ~15), safe as a flat map. Zone and woreda names
+ * are not always unique across different regions (e.g. "North Shewa" is both an Amhara zone and an
+ * Oromia zone, different codes) — `Company` stores region/zone/woreda as three independent strings,
+ * no parent linkage, so a flat name lookup can't disambiguate. First occurrence in the source data
+ * wins on a collision. Only affects the optional `City` field (zone) — never blocks filing, unlike
+ * Region/Wereda. A correct fix needs `Company` to store a linked hierarchy, not just three strings;
+ * out of scope here. Upgrade path: key this by `${region}/${zone}` once that linkage exists.
+ */
+const ROWS: Array<[region: string, zone: string, woreda: string, regionCode: string, zoneCode: string, woredaCode: string]> = [
+  ["Tigray", "Western Tigray", "Humera", "01", "01", "01"],
+  ["Tigray", "Western Tigray", "Kafta Humera", "01", "01", "02"],
+  ["Tigray", "Western Tigray", "Tsegede", "01", "01", "03"],
+  ["Tigray", "North Western Tigray", "Shire Endaselassie", "01", "02", "01"],
+  ["Tigray", "North Western Tigray", "Sheraro", "01", "02", "02"],
+  ["Tigray", "Central Tigray", "Axum", "01", "03", "01"],
+  ["Tigray", "Central Tigray", "Adwa", "01", "03", "02"],
+  ["Tigray", "Eastern Tigray", "Adigrat", "01", "04", "01"],
+  ["Tigray", "Southern Tigray", "Maychew", "01", "05", "01"],
+  ["Tigray", "Mekelle Special Zone", "Mekelle City", "01", "06", "01"],
+  ["Afar", "Awusi Rasu (Zone 1)", "Asayita", "02", "01", "01"],
+  ["Afar", "Awusi Rasu (Zone 1)", "Semera-Logiya", "02", "01", "02"],
+  ["Afar", "Kilbet Rasu (Zone 2)", "Abala", "02", "02", "01"],
+  ["Afar", "Gabi Rasu (Zone 3)", "Awash Fentale", "02", "03", "01"],
+  ["Afar", "Fantena Rasu (Zone 4)", "Yalo", "02", "04", "01"],
+  ["Afar", "Hari Rasu (Zone 5)", "Telalak", "02", "05", "01"],
+  ["Amhara", "North Gondar", "Debark", "03", "01", "01"],
+  ["Amhara", "South Gondar", "Debre Tabor", "03", "02", "01"],
+  ["Amhara", "North Wollo", "Woldiya", "03", "03", "01"],
+  ["Amhara", "South Wollo", "Dessie Town", "03", "04", "01"],
+  ["Amhara", "North Shewa", "Debre Berhan", "03", "05", "01"],
+  ["Amhara", "East Gojjam", "Debre Markos", "03", "06", "01"],
+  ["Amhara", "West Gojjam", "Finote Selam", "03", "07", "01"],
+  ["Amhara", "Wag Hemra", "Sekota", "03", "08", "01"],
+  ["Amhara", "Awi", "Injibara", "03", "09", "01"],
+  ["Amhara", "Oromia Special Zone", "Kemise", "03", "10", "01"],
+  ["Amhara", "Bahir Dar Special Zone", "Bahir Dar City", "03", "11", "01"],
+  ["Amhara", "Gondar Special Zone", "Gondar City", "03", "12", "01"],
+  ["Oromia", "North Shewa", "Fiche", "04", "01", "01"],
+  ["Oromia", "South West Shewa", "Waliso", "04", "02", "01"],
+  ["Oromia", "East Shewa", "Adama Town", "04", "03", "01"],
+  ["Oromia", "East Shewa", "Bishoftu Town", "04", "03", "02"],
+  ["Oromia", "West Shewa", "Ambo", "04", "04", "01"],
+  ["Oromia", "Arsi", "Asella", "04", "05", "01"],
+  ["Oromia", "West Arsi", "Shashemene", "04", "06", "01"],
+  ["Oromia", "Bale", "Robe", "04", "07", "01"],
+  ["Oromia", "East Hararghe", "Harar Outskirts", "04", "08", "01"],
+  ["Oromia", "West Hararghe", "Chiro", "04", "09", "01"],
+  ["Oromia", "Jimma", "Jimma Town", "04", "10", "01"],
+  ["Oromia", "Illubabor", "Mettu", "04", "11", "01"],
+  ["Oromia", "Buno Bedele", "Bedele", "04", "12", "01"],
+  ["Oromia", "Welega (West)", "Gimbi", "04", "13", "01"],
+  ["Oromia", "Welega (East)", "Nekemte", "04", "14", "01"],
+  ["Oromia", "Horo Guduru Welega", "Shambu", "04", "15", "01"],
+  ["Oromia", "Kelam Welega", "Dembidolo", "04", "16", "01"],
+  ["Oromia", "Borena", "Yabelo", "04", "17", "01"],
+  ["Oromia", "Guji", "Negele Borana", "04", "18", "01"],
+  ["Oromia", "West Guji", "Bule Hora", "04", "19", "01"],
+  ["Oromia", "East Bale", "Ginir", "04", "20", "01"],
+  ["Oromia", "Sheger City", "Sululta", "04", "21", "01"],
+  ["Somali", "Fafan", "Jijiga Woreda", "05", "01", "01"],
+  ["Somali", "Fafan", "Jijiga Town", "05", "01", "02"],
+  ["Somali", "Fafan", "Awbare", "05", "01", "03"],
+  ["Somali", "Sitti", "Shinile", "05", "02", "01"],
+  ["Somali", "Erer", "Fiq", "05", "03", "01"],
+  ["Somali", "Jarar", "Degehabur", "05", "04", "01"],
+  ["Somali", "Nogob", "Segeg", "05", "05", "01"],
+  ["Somali", "Korahe", "Kebridehar", "05", "06", "01"],
+  ["Somali", "Shabelle", "Gode", "05", "07", "01"],
+  ["Somali", "Afder", "Afder Woreda", "05", "08", "01"],
+  ["Somali", "Liben", "Filtu", "05", "09", "01"],
+  ["Somali", "Dhawa", "Mubarak", "05", "10", "01"],
+  ["Somali", "Dollo", "Warder", "05", "11", "01"],
+  ["Benishangul-Gumuz", "Asosa", "Asosa Woreda", "06", "01", "01"],
+  ["Benishangul-Gumuz", "Kamasashi", "Kamasashi Woreda", "06", "02", "01"],
+  ["Benishangul-Gumuz", "Metekel", "Gilgel Beles", "06", "03", "01"],
+  ["Southern Ethiopia", "Wolayta", "Sodo Zuria", "07", "01", "01"],
+  ["Southern Ethiopia", "Wolayta", "Sodo Town", "07", "01", "02"],
+  ["Southern Ethiopia", "Gamo", "Arba Minch Town", "07", "02", "01"],
+  ["Southern Ethiopia", "Gofa", "Sawla", "07", "03", "01"],
+  ["Southern Ethiopia", "Konso", "Konso Woreda", "07", "04", "01"],
+  ["Southern Ethiopia", "South Omo", "Jinka", "07", "05", "01"],
+  ["Gambela", "Anywaa", "Gambela Zuria", "08", "01", "01"],
+  ["Gambela", "Nuer", "Lare", "08", "02", "01"],
+  ["Gambela", "Majang", "Metu Zuria part", "08", "03", "01"],
+  ["Harari", "Harar Hundanee", "Amir Nur Woreda", "09", "01", "01"],
+  ["Harari", "Harar Hundanee", "Abadir Woreda", "09", "01", "02"],
+  ["Addis Ababa", "Bole Sub-City", "Bole Woreda 01", "10", "01", "01"],
+  ["Addis Ababa", "Kirkos Sub-City", "Kirkos Woreda 01", "10", "02", "01"],
+  ["Addis Ababa", "Nifas Silk Lafto", "NSL Woreda 13", "10", "03", "13"],
+  ["Addis Ababa", "Yeka Sub-City", "Yeka Woreda 01", "10", "04", "01"],
+  ["Addis Ababa", "Arada Sub-City", "Arada Woreda 01", "10", "05", "01"],
+  ["Dire Dawa", "Dire Dawa Urban", "Melka Jebdu", "11", "01", "01"],
+  ["Dire Dawa", "Dire Dawa Rural", "Gurgura", "11", "02", "01"],
+  ["Sidama", "Hawassa City Admin", "Hayek Chereka", "12", "01", "01"],
+  ["Sidama", "Sidama Zuria", "Yirgalem Town", "12", "02", "01"],
+  ["Sidama", "Sidama Zuria", "Aleta Wendo", "12", "02", "02"],
+  ["Southwest Ethiopia", "Keffa", "Bonga Town", "13", "01", "01"],
+  ["Southwest Ethiopia", "Sheka", "Mappi Zuria", "13", "02", "01"],
+  ["Southwest Ethiopia", "Bench Sheko", "Mizan Aman", "13", "03", "01"],
+  ["Central Ethiopia", "Gurage", "Wolkite", "14", "01", "01"],
+  ["Central Ethiopia", "Hadiya", "Hosaina", "14", "02", "01"],
+  ["Central Ethiopia", "Silte", "Worabe", "14", "03", "01"],
+  ["Gedeo State", "Gedeo Zone", "Dilla Zuria", "15", "01", "01"],
+  ["Gedeo State", "Gedeo Zone", "Yirgacheffe", "15", "01", "02"],
+];
+
+/** First occurrence wins on a name collision — see the class comment. */
+const buildMap = (pick: (row: (typeof ROWS)[number]) => [string, string]): Record<string, string> => {
+  const map: Record<string, string> = {};
+  for (const row of ROWS) {
+    const [name, code] = pick(row);
+    if (!(name in map)) map[name] = code;
+  }
+  return map;
+};
+
+export const ETHIOPIA_REGION_CODES: Record<string, string> = buildMap((r) => [r[0], r[3]]);
+/** Zone name → code. Fed into `buyerCityCodes` — EIMS's "City" is really the buyer's zone. */
+export const ETHIOPIA_ZONE_CODES: Record<string, string> = buildMap((r) => [r[1], r[4]]);
+export const ETHIOPIA_WOREDA_CODES: Record<string, string> = buildMap((r) => [r[2], r[5]]);
+
+/**
+ * Buyer records commonly store just the bare Addis Ababa sub-city name ("Bole", "Arada") as their
+ * woreda, not the source CSV's specific example-woreda name ("Bole Woreda 01") — confirmed live
+ * 2026-08-17 across three different buyers before any of them actually got past this check. Since
+ * the CSV lists exactly one representative woreda per Addis sub-city, alias the bare name to that
+ * same code rather than wait on a fuller table.
+ */
+const ADDIS_SUBCITY_ALIASES: Array<[bareName: string, csvZoneName: string]> = [
+  ["Bole", "Bole Sub-City"],
+  ["Kirkos", "Kirkos Sub-City"],
+  ["Nifas Silk Lafto", "Nifas Silk Lafto"],
+  // Matches EIMS_BUYER_WEREDA_CODES' own existing spelling in .env — same zone, different hyphenation.
+  ["Nefas Silk-Lafto", "Nifas Silk Lafto"],
+  ["Yeka", "Yeka Sub-City"],
+  ["Arada", "Arada Sub-City"],
+];
+for (const [bareName, csvZoneName] of ADDIS_SUBCITY_ALIASES) {
+  const row = ROWS.find((r) => r[1] === csvZoneName);
+  if (row && !(bareName in ETHIOPIA_WOREDA_CODES)) ETHIOPIA_WOREDA_CODES[bareName] = row[5];
+}
diff --git a/apps/edr-freight-api/src/contracts/contract-document-view-model.builder.ts b/apps/edr-freight-api/src/contracts/contract-document-view-model.builder.ts
index d4f0c4039..36e4e34d0 100644
--- a/apps/edr-freight-api/src/contracts/contract-document-view-model.builder.ts
+++ b/apps/edr-freight-api/src/contracts/contract-document-view-model.builder.ts
@@ -120,6 +120,8 @@ export class ContractDocumentViewModelBuilder {
         contract.tradeDirection,
         contract.freightType,
         contract.customsClearingEnabled,
+        // Bulk templates are keyed by the contract's cargo type.
+        (contract.cargoScope ?? []).find((c) => c.cargoTypeId)?.cargoTypeId,
       );
       dynamicTemplate = dynamicSource
         ? {
diff --git a/apps/edr-freight-api/src/contracts/contract-provider-stamp.spec.ts b/apps/edr-freight-api/src/contracts/contract-provider-stamp.spec.ts
new file mode 100644
index 000000000..023e4ac8c
--- /dev/null
+++ b/apps/edr-freight-api/src/contracts/contract-provider-stamp.spec.ts
@@ -0,0 +1,99 @@
+import { ContractViewModelBuilder, ContractSignatureView } from "./contract-view-model.builder";
+
+/**
+ * The EDR side of a contract is sealed with the ONE global company stamp, read
+ * live at render time; the client side keeps whatever stamp the customer
+ * uploaded. These specs pin that asymmetry — the standing rule is that
+ * centralizing the EDR seal must not touch customer stamps.
+ */
+describe("ContractViewModelBuilder.attachProviderStamp", () => {
+  const STAMP = "data:image/png;base64,RURS";
+
+  const build = (stampImageUrl: string | null = STAMP) => {
+    const getStampImageUrl = jest.fn().mockResolvedValue(stampImageUrl);
+    const builder = Object.create(
+      ContractViewModelBuilder.prototype,
+    ) as ContractViewModelBuilder;
+    Object.assign(builder, { stampSettings: { getStampImageUrl } });
+    return { builder, getStampImageUrl };
+  };
+
+  const sig = (role: "STAFF" | "CUSTOMER", extra: Partial<ContractSignatureView> = {}) =>
+    ({
+      role,
+      signerDisplayName: `${role} signer`,
+      signedAt: "1 January 2026",
+      signatureImageUrl: "https://minio.local/sig.png",
+      ...extra,
+    }) as ContractSignatureView;
+
+  it("stamps the EDR side with the global stamp", async () => {
+    const { builder } = build();
+    const signatures = [sig("STAFF")];
+
+    await builder.attachProviderStamp(signatures);
+
+    expect(signatures[0]!.stampImageUrl).toBe(STAMP);
+  });
+
+  it("leaves the customer side untouched", async () => {
+    const { builder } = build();
+    const customerStamp = "data:image/png;base64,Q1VTVA==";
+    const signatures = [
+      sig("CUSTOMER", { stampImageUrl: customerStamp }),
+      sig("STAFF"),
+    ];
+
+    await builder.attachProviderStamp(signatures);
+
+    expect(signatures[0]!.stampImageUrl).toBe(customerStamp);
+    expect(signatures[1]!.stampImageUrl).toBe(STAMP);
+  });
+
+  it("does not read the stamp at all when EDR has not signed yet", async () => {
+    const { builder, getStampImageUrl } = build();
+    const signatures = [sig("CUSTOMER")];
+
+    await builder.attachProviderStamp(signatures);
+
+    expect(getStampImageUrl).not.toHaveBeenCalled();
+    expect(signatures[0]!.stampImageUrl).toBeUndefined();
+  });
+
+  it("renders unstamped rather than failing when no stamp is configured", async () => {
+    const { builder } = build(null);
+    const signatures = [sig("STAFF")];
+
+    await expect(builder.attachProviderStamp(signatures)).resolves.toBeUndefined();
+    expect(signatures[0]!.stampImageUrl).toBeNull();
+  });
+
+  it("reads the stamp once for every EDR signature row", async () => {
+    const { builder, getStampImageUrl } = build();
+    const signatures = [sig("STAFF"), sig("STAFF")];
+
+    await builder.attachProviderStamp(signatures);
+
+    expect(getStampImageUrl).toHaveBeenCalledTimes(1);
+    expect(signatures.map((s) => s.stampImageUrl)).toEqual([STAMP, STAMP]);
+  });
+
+  it("is applied by loadSignatures, so the HTML view and the PDF agree", async () => {
+    const { builder } = build();
+    Object.assign(builder, {
+      bookingsRepository: {
+        findContractSignatures: jest.fn().mockResolvedValue([
+          { signerRole: "STAFF", signerDisplayName: "EDR", signedAt: new Date() },
+        ]),
+      },
+    });
+
+    const views = await (
+      builder as unknown as {
+        loadSignatures(id: string): Promise<ContractSignatureView[]>;
+      }
+    ).loadSignatures("b-1");
+
+    expect(views[0]!.stampImageUrl).toBe(STAMP);
+  });
+});
diff --git a/apps/edr-freight-api/src/contracts/contract-rate-schedule.builder.ts b/apps/edr-freight-api/src/contracts/contract-rate-schedule.builder.ts
index c62a875bf..2f1991df2 100644
--- a/apps/edr-freight-api/src/contracts/contract-rate-schedule.builder.ts
+++ b/apps/edr-freight-api/src/contracts/contract-rate-schedule.builder.ts
@@ -44,6 +44,7 @@ const UNIT_LABELS: Record<string, string> = {
   PER_CONTAINER: 'per container',
   PER_KM: 'per km',
   PER_TON_KM: 'per ton per km',
+  PER_LITER: 'per liter',
   PER_INVOICE: 'per invoice',
   FLAT: 'flat',
 };
@@ -66,6 +67,7 @@ const TRIGGER_ROUTE_LABELS: Partial<Record<Rate['trigger'], string>> = {
   DEMURRAGE: 'Demurrage / wagon detention',
   PIL_EXTRA_FEE: 'PIL shipping line extra fee',
   CUSTOMS_CLEARANCE: 'Customs clearance service',
+  FUEL: 'Fuel surcharge',
 };
 
 @Injectable()
@@ -101,6 +103,15 @@ export class ContractRateScheduleBuilder {
         continue;
       }
 
+      // Fuel is sold per lane + commodity — only lanes matching the contract's
+      // direction belong on its schedule, labeled with their leg.
+      if (rate.trigger === 'FUEL') {
+        if (this.fuelDirectionMatches(rate, direction)) {
+          surcharges.push(this.fuelRow(rate));
+        }
+        continue;
+      }
+
       // Everything left is a trigger-based charge (surcharge / demurrage / customs).
       surcharges.push(this.surchargeRow(rate));
     }
@@ -176,6 +187,35 @@ export class ContractRateScheduleBuilder {
     };
   }
 
+  private fuelDirectionMatches(rate: Rate, direction: ContractDirection): boolean {
+    const want =
+      direction === 'IMP' ? 'IMPORT' : direction === 'EXP' ? 'EXPORT' : 'DOMESTIC';
+    return rate.tradeDirection === want;
+  }
+
+  /**
+   * Fuel row — the lane matters, so it rides along in the charge label.
+   * Per-liter collapses to one flat total (base liters × rate value); the
+   * customer only ever sees the final price.
+   */
+  private fuelRow(rate: Rate): RateScheduleRow {
+    const origin = rate.originYard?.label ?? rate.originYard?.code ?? '—';
+    const destination =
+      rate.destinationYard?.label ?? rate.destinationYard?.code ?? '—';
+    const perLiter = rate.rateUnit === 'PER_LITER';
+    return {
+      route: `Fuel surcharge (${origin} → ${destination})`,
+      cargo: this.cargoLabel(rate),
+      currency: rate.currency,
+      amount: this.formatAmount(
+        perLiter
+          ? Number(rate.baseLiters ?? 0) * Number(rate.rateValue)
+          : rate.rateValue,
+      ),
+      unit: perLiter ? 'flat' : this.unitLabel(rate.rateUnit),
+    };
+  }
+
   private surchargeRow(rate: Rate): RateScheduleRow {
     return {
       route: TRIGGER_ROUTE_LABELS[rate.trigger] ?? this.titleCase(rate.trigger),
diff --git a/apps/edr-freight-api/src/contracts/contract-view-model.builder.ts b/apps/edr-freight-api/src/contracts/contract-view-model.builder.ts
index d1158d035..517934bb9 100644
--- a/apps/edr-freight-api/src/contracts/contract-view-model.builder.ts
+++ b/apps/edr-freight-api/src/contracts/contract-view-model.builder.ts
@@ -9,6 +9,8 @@ import {
 import { ContractPricingScheduleBuilder, PricingSchedule } from './contract-pricing-schedule.builder';
 import { ContractRateScheduleBuilder, RateSchedule } from './contract-rate-schedule.builder';
 import { ContractTemplateResolver } from './contract-template.resolver';
+import { StampSettingsService } from '../modules/stamp-settings/stamp-settings.service';
+import { LogoSettingsService } from '../modules/logo-settings/logo-settings.service';
 import { ContractTemplateMeta, getTemplateMeta } from './contract-template.registry';
 
 export interface ContractSignatureView {
@@ -16,6 +18,11 @@ export interface ContractSignatureView {
   signerDisplayName: string;
   signedAt: string;
   signatureImageUrl?: string | null;
+  /**
+   * Round company seal shown beside the signature. Populated for the EDR
+   * (STAFF) side only, from the single global stamp — see attachProviderStamp.
+   */
+  stampImageUrl?: string | null;
 }
 
 /**
@@ -105,6 +112,8 @@ export interface ContractViewModel {
   hasCustomerSignature: boolean;
   hasStaffSignature: boolean;
   dynamicTemplate?: ContractDynamicTemplateView;
+  /** Company logo for the cover-page header (LogoSettingsService); null renders the "EDR" mark. */
+  logoImageUrl?: string | null;
 }
 
 @Injectable()
@@ -114,6 +123,8 @@ export class ContractViewModelBuilder {
     private readonly templateResolver: ContractTemplateResolver,
     private readonly pricingBuilder: ContractPricingScheduleBuilder,
     private readonly rateScheduleBuilder: ContractRateScheduleBuilder,
+    private readonly stampSettings: StampSettingsService,
+    private readonly logoSettings: LogoSettingsService,
   ) {}
 
   async build(bookingId: string): Promise<{ booking: Booking; view: ContractViewModel }> {
@@ -131,6 +142,7 @@ export class ContractViewModelBuilder {
       template.freight,
     );
     const signatures = await this.loadSignatures(bookingId);
+    const logoImageUrl = await this.logoSettings.getLogoImageUrl();
 
     const hasCustomer = signatures.some((s) => s.role === 'CUSTOMER');
     const hasStaff = signatures.some((s) => s.role === 'STAFF');
@@ -187,6 +199,7 @@ export class ContractViewModelBuilder {
       hasContractDocument: hasContractFile,
       hasCustomerSignature: hasCustomer,
       hasStaffSignature: hasStaff,
+      logoImageUrl,
     };
 
     return { booking, view };
@@ -194,7 +207,30 @@ export class ContractViewModelBuilder {
 
   private async loadSignatures(bookingId: string): Promise<ContractSignatureView[]> {
     const rows = await this.bookingsRepository.findContractSignatures(bookingId);
-    return rows.map((s) => this.toSignatureView(s));
+    const views = rows.map((s) => this.toSignatureView(s));
+    await this.attachProviderStamp(views);
+    return views;
+  }
+
+  /**
+   * Stamp the EDR side of the contract with the ONE global company stamp
+   * (StampSettingsService) — staff never upload or pick a stamp, so nothing is
+   * stored per signature and the seal is read live at render time. The client
+   * side is left alone: a customer's own stamp is their business.
+   *
+   * Read live and deliberately not snapshotted, so replacing the company stamp
+   * re-seals contracts on their next render. `getStampImageUrl()` never throws
+   * and returns a data URL, which `signatures_block.hbs` renders as-is and the
+   * signature inliner skips.
+   */
+  async attachProviderStamp(signatures: ContractSignatureView[]): Promise<void> {
+    const staff = signatures.filter((s) => s.role === 'STAFF');
+    if (staff.length === 0) return;
+
+    const stampImageUrl = await this.stampSettings.getStampImageUrl();
+    for (const sig of staff) {
+      sig.stampImageUrl = stampImageUrl;
+    }
   }
 
   toSignatureView(row: BookingContractSignature): ContractSignatureView {
diff --git a/apps/edr-freight-api/src/contracts/templates/_partials/styles.hbs b/apps/edr-freight-api/src/contracts/templates/_partials/styles.hbs
index d9bc9927f..09bf3031e 100644
--- a/apps/edr-freight-api/src/contracts/templates/_partials/styles.hbs
+++ b/apps/edr-freight-api/src/contracts/templates/_partials/styles.hbs
@@ -77,6 +77,12 @@
     letter-spacing: 0.08em;
     width: 72px;
   }
+  .logo-mark img {
+    display: block;
+    max-height: 100%;
+    max-width: 100%;
+    object-fit: contain;
+  }
   .kicker {
     color: #0e5b45;
     font-family: Arial, sans-serif;
diff --git a/apps/edr-freight-api/src/contracts/templates/edr-dynamic.hbs b/apps/edr-freight-api/src/contracts/templates/edr-dynamic.hbs
index 6ba7c1610..81631e5d2 100644
--- a/apps/edr-freight-api/src/contracts/templates/edr-dynamic.hbs
+++ b/apps/edr-freight-api/src/contracts/templates/edr-dynamic.hbs
@@ -11,7 +11,7 @@
     {{!-- ─────────────────────────── Cover page ─────────────────────────── --}}
     <section class="cover page-section">
       <div class="brand-row">
-        <div class="logo-mark">EDR</div>
+        <div class="logo-mark">{{#if logoImageUrl}}<img src="{{logoImageUrl}}" alt="Company logo" />{{else}}EDR{{/if}}</div>
         <div>
           <p class="kicker">Ethio-Djibouti Standard Gauge Railway Share Company</p>
           <p class="muted">Freight Transport Services</p>
diff --git a/apps/edr-freight-api/src/contracts/templates/generic.hbs b/apps/edr-freight-api/src/contracts/templates/generic.hbs
index 75f795bce..f576c99ce 100644
--- a/apps/edr-freight-api/src/contracts/templates/generic.hbs
+++ b/apps/edr-freight-api/src/contracts/templates/generic.hbs
@@ -9,7 +9,7 @@
   <main class="contract">
     <section class="cover page-section">
       <div class="brand-row">
-        <div class="logo-mark">EDR</div>
+        <div class="logo-mark">{{#if logoImageUrl}}<img src="{{logoImageUrl}}" alt="Company logo" />{{else}}EDR{{/if}}</div>
         <div>
           <p class="kicker">Ethio-Djibouti Standard Gauge Railway Share Company</p>
           <p class="muted">Freight Transport Contract</p>
diff --git a/apps/edr-freight-api/src/contracts/templates/last-mile.hbs b/apps/edr-freight-api/src/contracts/templates/last-mile.hbs
index 9437bb18b..0cfef51d5 100644
--- a/apps/edr-freight-api/src/contracts/templates/last-mile.hbs
+++ b/apps/edr-freight-api/src/contracts/templates/last-mile.hbs
@@ -9,6 +9,7 @@
     main { padding: 32px 40px; }
     .brand-row { display: flex; align-items: center; gap: 14px; border-bottom: 3px solid #1a5632; padding-bottom: 14px; }
     .logo-mark { background: #1a5632; color: #fff; font-weight: 700; font-size: 18px; padding: 10px 14px; border-radius: 6px; }
+    .logo-mark img { display: block; max-height: 32px; max-width: 100px; object-fit: contain; }
     .kicker { margin: 0; font-weight: 700; }
     .muted { margin: 0; color: #666; }
     h1 { font-size: 20px; margin: 24px 0 4px; }
@@ -32,7 +33,7 @@
 <body>
   <main>
     <div class="brand-row">
-      <div class="logo-mark">EDR</div>
+      <div class="logo-mark">{{#if logoImageUrl}}<img src="{{logoImageUrl}}" alt="Company logo" />{{else}}EDR{{/if}}</div>
       <div>
         <p class="kicker">Ethio-Djibouti Standard Gauge Railway Share Company</p>
         <p class="muted">Last-Mile Delivery Contract</p>
diff --git a/apps/edr-freight-api/src/logger.middleware.ts b/apps/edr-freight-api/src/logger.middleware.ts
deleted file mode 100644
index dd7532ec8..000000000
--- a/apps/edr-freight-api/src/logger.middleware.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { Injectable, NestMiddleware, Logger } from "@nestjs/common";
-import { Request, Response, NextFunction } from "express";
-
-@Injectable()
-export class LoggerMiddleware implements NestMiddleware {
-  private readonly logger = new Logger("HTTP");
-
-  use(req: Request, res: Response, next: NextFunction) {
-    const start = Date.now();
-
-    res.on("finish", () => {
-      const duration = Date.now() - start;
-
-      this.logger.log(
-        `${req.method} ${req.originalUrl} ${res.statusCode} ${duration}ms`,
-      );
-    });
-
-    next();
-  }
-}
diff --git a/apps/edr-freight-api/src/main.ts b/apps/edr-freight-api/src/main.ts
index c9a718f5d..98fed950e 100644
--- a/apps/edr-freight-api/src/main.ts
+++ b/apps/edr-freight-api/src/main.ts
@@ -10,17 +10,25 @@ import {
   ResponseTransformInterceptor,
   createValidationPipe,
 } from "@edr/api-common";
-import { getAuditLoggerConfig } from "@tria-plc/auditlog";
 
 import { AppModule } from "./app.module";
 
 /**
- * JSON body ceiling. Signing posts the signature AND the company stamp as
- * base64 in one JSON body, and base64 inflates bytes by ~4/3 — a 10MB stamp is
- * ~13.4MB on the wire. Express defaults to 100kb, which rejected any real stamp
- * image with a 413 "request entity too large".
+ * JSON body ceiling. Customer signing posts the signature AND the customer's
+ * own company stamp as base64 in one JSON body, and base64 inflates bytes by
+ * ~4/3 — a 50MB asset is ~67MB on the wire. Express defaults to 100kb, which
+ * rejected any real stamp image with a 413 "request entity too large".
+ * (Staff signing posts only a signature: EDR's seal is the one global stamp,
+ * read server-side. Uploading that stamp under Settings goes through this same
+ * ceiling, so the headroom is still needed on both counts.)
+ *
+ * Sized to clear the 50MB per-document ceiling
+ * (`DOCUMENT_UPLOAD_MAX_BYTES`) after base64 inflation, with room for the
+ * surrounding JSON. Note that the reverse proxy applies its own
+ * `client_max_body_size` and rejects oversized bodies before Nest sees them —
+ * raising this alone does not lift the limit end to end (see docs/uploads.md).
  */
-const JSON_BODY_LIMIT = "20mb";
+const JSON_BODY_LIMIT = "100mb";
 
 /**
  * Static /etc/hosts-style overrides from `DNS_HOST_OVERRIDES`, formatted as
@@ -161,11 +169,6 @@ export async function createFreightApp(): Promise<NestExpressApplication> {
   app.useGlobalFilters(new HttpExceptionFilter());
   app.useGlobalInterceptors(new ResponseTransformInterceptor());
 
-  // Audit listener: consumes the RMQ events MezgebModule's client interceptor
-  // (app.module.ts) emits and persists them via the AuditLogController /
-  // AuditLogCommandController @EventPattern handlers. Same queue config the
-  // client side uses, reused from the package so the two never drift apart.
-  app.connectMicroservice(getAuditLoggerConfig());
   await app.startAllMicroservices();
 
   const config = new DocumentBuilder()
diff --git a/apps/edr-freight-api/src/migrations/3320000000000-BulkContractTemplates.ts b/apps/edr-freight-api/src/migrations/3320000000000-BulkContractTemplates.ts
new file mode 100644
index 000000000..39a10ca90
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3320000000000-BulkContractTemplates.ts
@@ -0,0 +1,100 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+const CONTAINER_CODES = [
+  'IMPORT_CONTAINER_CUSTOMS',
+  'IMPORT_CONTAINER_NO_CUSTOMS',
+  'EXPORT_CONTAINER_CUSTOMS',
+  'EXPORT_CONTAINER_NO_CUSTOMS',
+  'INTERCITY_CONTAINER',
+];
+
+const BULK_CODES = [
+  'IMPORT_BULK_CUSTOMS',
+  'IMPORT_BULK_NO_CUSTOMS',
+  'EXPORT_BULK_CUSTOMS',
+  'EXPORT_BULK_NO_CUSTOMS',
+  'INTERCITY_BULK',
+];
+
+/**
+ * Bulk contract templates become staff-created, keyed by (cargo type, customs
+ * clearing) instead of the fixed direction codes. The five container templates
+ * stay seeded and become undeletable system rows; the five seeded bulk rows are
+ * retired (soft-deleted). cargo_types gains has_contract_template, marking
+ * which bulk commodities may carry their own template.
+ */
+export class BulkContractTemplates3320000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.cargo_types
+        ADD COLUMN IF NOT EXISTS has_contract_template boolean NOT NULL DEFAULT false
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        ADD COLUMN IF NOT EXISTS cargo_type_id uuid REFERENCES freight.cargo_types(id),
+        ADD COLUMN IF NOT EXISTS with_customs boolean,
+        ADD COLUMN IF NOT EXISTS is_system boolean NOT NULL DEFAULT false
+    `);
+
+    // Generated bulk codes (BULK_<cargo code>_NO_CUSTOMS) outgrow varchar(40).
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        ALTER COLUMN code TYPE varchar(80)
+    `);
+
+    await queryRunner.query(
+      `UPDATE freight.contract_templates SET is_system = true WHERE code = ANY($1)`,
+      [CONTAINER_CODES],
+    );
+
+    // Retire the fixed bulk templates; staff recreate them per cargo type.
+    await queryRunner.query(
+      `UPDATE freight.contract_templates SET deleted_at = now()
+        WHERE code = ANY($1) AND deleted_at IS NULL`,
+      [BULK_CODES],
+    );
+
+    // Code stays unique among live rows only, so a deleted combo can be
+    // recreated under the same generated code.
+    await queryRunner.query(
+      `ALTER TABLE freight.contract_templates DROP CONSTRAINT IF EXISTS uq_contract_templates_code`,
+    );
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_contract_templates_code
+        ON freight.contract_templates (code) WHERE deleted_at IS NULL
+    `);
+
+    // One template per (bulk cargo type, customs option) — the "same
+    // combination" rule, enforced even under concurrent creates.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_contract_templates_cargo_customs
+        ON freight.contract_templates (cargo_type_id, with_customs)
+        WHERE deleted_at IS NULL AND cargo_type_id IS NOT NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP INDEX IF EXISTS freight.uq_contract_templates_cargo_customs`,
+    );
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.uq_contract_templates_code`);
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        ADD CONSTRAINT uq_contract_templates_code UNIQUE (code)
+    `);
+    await queryRunner.query(
+      `UPDATE freight.contract_templates SET deleted_at = NULL WHERE code = ANY($1)`,
+      [BULK_CODES],
+    );
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        DROP COLUMN IF EXISTS cargo_type_id,
+        DROP COLUMN IF EXISTS with_customs,
+        DROP COLUMN IF EXISTS is_system
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.cargo_types DROP COLUMN IF EXISTS has_contract_template
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3330000000000-EimsInvoiceRegistration.ts b/apps/edr-freight-api/src/migrations/3330000000000-EimsInvoiceRegistration.ts
new file mode 100644
index 000000000..1ff9bab35
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3330000000000-EimsInvoiceRegistration.ts
@@ -0,0 +1,73 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * EIMS registration state.
+ *
+ * `freight.invoices` gains the per-invoice registration outcome: which EIMS counter the invoice
+ * consumed, the returned IRN, and the last failure. The partial unique index on `eims_irn` is the
+ * database-level guarantee that one IRN can never be recorded against two invoices, independent of
+ * application logic.
+ *
+ * `freight.eims_system_state` is a single row per MoR system number holding the sequence the
+ * gateway expects: the next `SourceSystem.InvoiceCounter` and the `ReferenceDetails.PreviousIrn`
+ * of the last successful registration. Registration takes `FOR UPDATE` on this row, so the counter
+ * and the IRN chain stay consistent under concurrent submissions.
+ *
+ * The `in_flight_*` columns make a submission a *durable reservation*: the counter is consumed and
+ * the holder recorded in a committed transaction before the HTTP call, so a crash mid-flight leaves
+ * evidence instead of silently freeing the slot for a blind resubmission. `blocked_reason` is set
+ * when a submission ends ambiguously (timeout, network, 5xx) — the IRN is unknown, so every later
+ * document for this system number would chain to a stale `PreviousIrn` and registration stops until
+ * a human resolves it.
+ *
+ * `eims_ack_date` is varchar, not timestamptz: EIMS returns a Java ZonedDateTime string
+ * ("2025-03-21T08:33:32.707753413Z[Etc/UTC]") that no JS date parser accepts. It is stored
+ * verbatim so a compliance value is never mangled by a parse.
+ */
+export class EimsInvoiceRegistration3330000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        ADD COLUMN IF NOT EXISTS eims_status          varchar(20) NOT NULL DEFAULT 'NOT_SUBMITTED',
+        ADD COLUMN IF NOT EXISTS eims_irn             varchar(64),
+        ADD COLUMN IF NOT EXISTS eims_invoice_counter bigint,
+        ADD COLUMN IF NOT EXISTS eims_submitted_at    timestamptz,
+        ADD COLUMN IF NOT EXISTS eims_ack_date        varchar(64),
+        ADD COLUMN IF NOT EXISTS eims_last_error      jsonb
+    `);
+
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS ux_invoices_eims_irn
+        ON freight.invoices (eims_irn) WHERE eims_irn IS NOT NULL
+    `);
+
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.eims_system_state (
+        id                   uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        system_number        varchar(32)  NOT NULL UNIQUE,
+        next_invoice_counter bigint       NOT NULL DEFAULT 1,
+        previous_irn         varchar(64),
+        in_flight_invoice_id uuid,
+        in_flight_counter    bigint,
+        blocked_reason       text,
+        created_at           timestamptz  NOT NULL DEFAULT now(),
+        updated_at           timestamptz  NOT NULL DEFAULT now(),
+        deleted_at           timestamptz
+      )
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.eims_system_state`);
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.ux_invoices_eims_irn`);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        DROP COLUMN IF EXISTS eims_status,
+        DROP COLUMN IF EXISTS eims_irn,
+        DROP COLUMN IF EXISTS eims_invoice_counter,
+        DROP COLUMN IF EXISTS eims_submitted_at,
+        DROP COLUMN IF EXISTS eims_ack_date,
+        DROP COLUMN IF EXISTS eims_last_error
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3340000000000-EimsDocumentNumberSequence.ts b/apps/edr-freight-api/src/migrations/3340000000000-EimsDocumentNumberSequence.ts
new file mode 100644
index 000000000..481b7489c
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3340000000000-EimsDocumentNumberSequence.ts
@@ -0,0 +1,34 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * EIMS document numbering.
+ *
+ * MoR validates `DocumentDetails.DocumentNumber` against `^(0|[1-9][0-9]{0,8})$` — a plain integer
+ * of at most nine digits. Our own `INV-YYYYMMDD-NNNNN` can therefore never be sent, so EIMS needs
+ * its own sequence, allocated from the same locked state row as the invoice counter and recorded
+ * on the invoice so a filed document can be traced back to it.
+ */
+export class EimsDocumentNumberSequence3340000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.eims_system_state
+        ADD COLUMN IF NOT EXISTS next_document_number bigint NOT NULL DEFAULT 1,
+        ADD COLUMN IF NOT EXISTS in_flight_document_number bigint
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        ADD COLUMN IF NOT EXISTS eims_document_number varchar(16)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices DROP COLUMN IF EXISTS eims_document_number
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.eims_system_state
+        DROP COLUMN IF EXISTS next_document_number,
+        DROP COLUMN IF EXISTS in_flight_document_number
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3350000000000-SupportContent.ts b/apps/edr-freight-api/src/migrations/3350000000000-SupportContent.ts
new file mode 100644
index 000000000..168ee2c6d
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3350000000000-SupportContent.ts
@@ -0,0 +1,73 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Editable customer-facing copy for the portal's public pages (/help, /faq,
+ * /terms, /privacy) plus the shared support-contact block, with an append-only
+ * version log behind it.
+ *
+ * `payload` is opaque jsonb: the five documents have genuinely different shapes
+ * and the help page's blocks change with the copy, so typed columns would mean
+ * a migration per wording tweak. The shape is enforced by per-slug DTOs on
+ * write instead.
+ *
+ * No rows are inserted here — `SupportContentSeeder` fills the table on first
+ * boot and skips whenever it is non-empty, so a redeploy never overwrites
+ * admin edits the way a migration-embedded INSERT eventually would.
+ */
+export class SupportContent3350000000000 implements MigrationInterface {
+  name = "SupportContent3350000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.support_documents (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        slug varchar(32) NOT NULL,
+        payload jsonb NOT NULL DEFAULT '{}'::jsonb,
+        version integer NOT NULL DEFAULT 1,
+        updated_by_id uuid,
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      );
+    `);
+
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_support_documents_slug
+        ON freight.support_documents (slug);
+    `);
+
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.support_document_versions (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        document_id uuid NOT NULL
+          REFERENCES freight.support_documents(id) ON DELETE CASCADE,
+        version integer NOT NULL,
+        payload jsonb NOT NULL,
+        actor_id uuid,
+        note varchar(255),
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      );
+    `);
+
+    // Closes the concurrent-save race: two editors saving at once cannot both
+    // claim the same version number.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_support_doc_version
+        ON freight.support_document_versions (document_id, version);
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_support_doc_versions_document
+        ON freight.support_document_versions (document_id);
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS freight.support_document_versions;`,
+    );
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.support_documents;`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3360000000000-SupportHelpSections.ts b/apps/edr-freight-api/src/migrations/3360000000000-SupportHelpSections.ts
new file mode 100644
index 000000000..5220d3a6c
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3360000000000-SupportHelpSections.ts
@@ -0,0 +1,112 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Converts the HELP document from its original fixed-block shape
+ * (`video` / `chat` / `channels` / `topics` / `checklist`) to the free-form
+ * `sections[]` builder, where every block is a heading plus markdown plus
+ * attached media.
+ *
+ * Only rows still in the old shape are touched — detected by the presence of a
+ * `channels` key — so this is a no-op on any environment seeded after the
+ * change, and re-running it does nothing.
+ *
+ * The payload literal is inlined rather than imported from
+ * `SUPPORT_CONTENT_DEFAULTS`: a migration must keep doing the same thing
+ * forever, and that constant will keep moving.
+ *
+ * The rewrite also bumps `version` and writes a matching history row. The live
+ * row's version always having a matching entry in
+ * `support_document_versions` is the invariant the history list and rollback
+ * both depend on, and a silent payload swap would break it.
+ */
+const HELP_SECTIONS = [
+  {
+    id: "help-walkthrough",
+    heading: "Portal walkthrough",
+    body: "A guided tour of the portal — registering your company, raising a booking against a contract, and settling an invoice.",
+    media: [
+      {
+        id: "help-walkthrough-video",
+        kind: "video",
+        src: "/assets/edr-portal-guide.webm",
+        caption: null,
+      },
+    ],
+  },
+  {
+    id: "help-chat",
+    heading: "Chat with our team",
+    body: "Signed-in customers can open a support conversation from the headset button at the bottom right of every portal page. You can send screenshots and documents in the chat, and replies appear there and as a notification.\n\n[Open the portal](/portal)",
+    media: [],
+  },
+  {
+    id: "help-contact",
+    heading: "Contact us",
+    body: "- **Email** — [{{supportEmail}}](mailto:{{supportEmail}}). Best for document issues and anything needing an attachment.\n- **Phone** — [{{supportPhone}}](tel:{{supportPhoneTel}}). Best for urgent problems with cargo already in transit.\n- **Head office** — {{supportOffice}}. Walk-in support during working hours.\n- **Support hours** — {{supportHours}}. Outside these hours, email us and we reply the next working day.",
+    media: [],
+  },
+  {
+    id: "help-topics",
+    heading: "Common topics",
+    body: "- **[Account & onboarding](/faq)** — registering your company, uploading your trade licence and TIN, and getting an operational profile approved.\n- **[Contracts](/faq)** — requesting a freight contract, reviewing its terms and signing it with your saved signature and stamp.\n- **[Bookings & tracking](/faq)** — raising a booking against a contract, adding last-mile transport and following the consignment along the corridor.\n- **[Invoices & payments](/faq)** — finding invoices, paying through the bank channels and confirming a payment that has not yet settled.",
+    media: [],
+  },
+  {
+    id: "help-checklist",
+    heading: "What to include when you contact us",
+    body: "- Your company name and the email you sign in with.\n- The reference of the contract, booking or invoice involved.\n- What you expected to happen and what happened instead.\n- A screenshot of any error message the portal showed.",
+    media: [],
+  },
+];
+
+export class SupportHelpSections3360000000000 implements MigrationInterface {
+  name = "SupportHelpSections3360000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    const rows: { id: string; version: number; payload: Record<string, unknown> }[] =
+      await queryRunner.query(`
+        SELECT id, version, payload
+        FROM freight.support_documents
+        WHERE slug = 'HELP' AND payload ? 'channels'
+      `);
+
+    for (const row of rows) {
+      const payload = {
+        title: row.payload.title ?? "Help & Support",
+        subtitle:
+          row.payload.subtitle ??
+          "Get answers fast — watch the walkthrough, browse the common topics, check the FAQ, or reach our team directly.",
+        sections: HELP_SECTIONS,
+      };
+      const version = row.version + 1;
+
+      await queryRunner.query(
+        `UPDATE freight.support_documents
+         SET payload = $1::jsonb, version = $2, updated_at = now()
+         WHERE id = $3`,
+        [JSON.stringify(payload), version, row.id],
+      );
+
+      await queryRunner.query(
+        `INSERT INTO freight.support_document_versions
+           (document_id, version, payload, actor_id, note)
+         VALUES ($1, $2, $3::jsonb, NULL, $4)`,
+        [
+          row.id,
+          version,
+          JSON.stringify(payload),
+          "Converted help page to free-form sections",
+        ],
+      );
+    }
+  }
+
+  /**
+   * Not reversible: the old fixed blocks cannot be recovered from markdown
+   * sections an editor may since have rewritten. The version history holds the
+   * pre-conversion payload if it is ever genuinely needed.
+   */
+  public async down(): Promise<void> {
+    // no-op
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3370000000000-BookingExportHandoverMode.ts b/apps/edr-freight-api/src/migrations/3370000000000-BookingExportHandoverMode.ts
new file mode 100644
index 000000000..42acfc8f9
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3370000000000-BookingExportHandoverMode.ts
@@ -0,0 +1,28 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Export cargo reaches a train two ways, and until now only one was modelled.
+ *
+ * DIRECT_TO_TRAIN — the customer's truck pulls alongside and the cargo goes
+ * straight onto the wagon. It never enters a warehouse, so no GRN is ever
+ * raised; the Carriage Acceptance Sheet is the only document handed over.
+ *
+ * WAREHOUSE — cargo is received into the warehouse, GRN'd, then loaded. This is
+ * the existing flow and stays gated on the GRN.
+ *
+ * NULL means WAREHOUSE, so existing rows keep today's behaviour with no backfill.
+ */
+export class BookingExportHandoverMode3370000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings
+        ADD COLUMN IF NOT EXISTS export_handover_mode varchar(20)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings DROP COLUMN IF EXISTS export_handover_mode
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3370000000000-SupportHelpInlineMedia.ts b/apps/edr-freight-api/src/migrations/3370000000000-SupportHelpInlineMedia.ts
new file mode 100644
index 000000000..3301056e4
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3370000000000-SupportHelpInlineMedia.ts
@@ -0,0 +1,91 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Folds each help section's `media[]` array into its markdown body.
+ *
+ * Attachments used to hang off the section as a separate list, rendered after
+ * the text — which meant an author could not put a picture next to the sentence
+ * it illustrates, and had two different places to manage media. They are now
+ * embedded with markdown's image syntax, and the renderer picks `<img>` or
+ * `<video>` from the file extension.
+ *
+ * Existing entries are converted rather than dropped: an uploaded object
+ * becomes `![caption](minio:<key>)`, and a shipped asset path or external URL
+ * is kept verbatim. Sections are left alone once they have no `media` key, so
+ * re-running does nothing.
+ */
+interface LegacyMedia {
+  src: string;
+  caption?: string | null;
+}
+
+interface LegacySection {
+  id: string;
+  heading: string;
+  body: string;
+  media?: LegacyMedia[];
+}
+
+/** Uploaded objects are stored as keys; the `minio:` ref is signed on read. */
+function toMarkdown(item: LegacyMedia): string {
+  const isStoredObject = !/^(https?:\/\/|\/)/.test(item.src);
+  const target = isStoredObject ? `minio:${item.src}` : item.src;
+  return `![${item.caption ?? ""}](${target})`;
+}
+
+export class SupportHelpInlineMedia3370000000000 implements MigrationInterface {
+  name = "SupportHelpInlineMedia3370000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    const rows: {
+      id: string;
+      version: number;
+      payload: { sections?: LegacySection[] } & Record<string, unknown>;
+    }[] = await queryRunner.query(`
+      SELECT id, version, payload
+      FROM freight.support_documents
+      WHERE slug = 'HELP'
+    `);
+
+    for (const row of rows) {
+      const sections = row.payload.sections ?? [];
+      if (!sections.some((section) => section.media !== undefined)) continue;
+
+      const payload = {
+        ...row.payload,
+        sections: sections.map(({ media, ...section }) => {
+          const embeds = (media ?? []).map(toMarkdown);
+          return {
+            ...section,
+            body: [section.body, ...embeds].filter(Boolean).join("\n\n"),
+          };
+        }),
+      };
+      const version = row.version + 1;
+
+      await queryRunner.query(
+        `UPDATE freight.support_documents
+         SET payload = $1::jsonb, version = $2, updated_at = now()
+         WHERE id = $3`,
+        [JSON.stringify(payload), version, row.id],
+      );
+
+      await queryRunner.query(
+        `INSERT INTO freight.support_document_versions
+           (document_id, version, payload, actor_id, note)
+         VALUES ($1, $2, $3::jsonb, NULL, $4)`,
+        [
+          row.id,
+          version,
+          JSON.stringify(payload),
+          "Moved attachments inline into the section text",
+        ],
+      );
+    }
+  }
+
+  /** Not reversible — see the note on SupportHelpSections3360000000000. */
+  public async down(): Promise<void> {
+    // no-op
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3380000000000-RaiseDocumentUploadSizeLimit.ts b/apps/edr-freight-api/src/migrations/3380000000000-RaiseDocumentUploadSizeLimit.ts
new file mode 100644
index 000000000..99d949e2e
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3380000000000-RaiseDocumentUploadSizeLimit.ts
@@ -0,0 +1,44 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Raises the per-field document ceiling from 10MB to 50MB.
+ *
+ * `max_size_mb` is what the portal enforces client-side (SmartFileInput blocks
+ * the file and shows "File size exceeds the limit of NMB"), so the seeded 10
+ * was the visible limit for every existing form even after the server-side caps
+ * were lifted. The seeder only writes these rows on first insert, so deployed
+ * environments keep their old value until this runs.
+ *
+ * Only rows still sitting at the old default are touched — a field an admin has
+ * deliberately tuned to something else keeps that value.
+ */
+export class RaiseDocumentUploadSizeLimit3380000000000
+  implements MigrationInterface
+{
+  name = "RaiseDocumentUploadSizeLimit3380000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.file_upload_fields
+      ALTER COLUMN max_size_mb SET DEFAULT 50
+    `);
+    await queryRunner.query(`
+      UPDATE freight.file_upload_fields
+      SET max_size_mb = 50
+      WHERE max_size_mb = 10
+    `);
+  }
+
+  /**
+   * Restores the column default only. The old per-row values are not
+   * recoverable (10 and an admin-chosen 10 are indistinguishable after `up`),
+   * and shrinking a customer's limit back down would reject documents they have
+   * already uploaded, so the rows are deliberately left at 50.
+   */
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.file_upload_fields
+      ALTER COLUMN max_size_mb SET DEFAULT 10
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3390000000000-CreateAuditLogs.ts b/apps/edr-freight-api/src/migrations/3390000000000-CreateAuditLogs.ts
new file mode 100644
index 000000000..b5b865ad7
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3390000000000-CreateAuditLogs.ts
@@ -0,0 +1,81 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Backoffice audit trail for every state-changing freight endpoint.
+ *
+ * No `updated_at` / `deleted_at` columns, unlike every other table here: audit
+ * rows are insert-only evidence. A soft-delete column would let an actor erase
+ * their own trail and TypeORM would then hide those rows from default queries
+ * silently — see the entity comment.
+ *
+ * `user_id` intentionally carries NO foreign key to the `iam` schema.
+ * Cross-schema FKs are forbidden platform-wide, and one here would let user
+ * deletion cascade away the record of what that user did.
+ *
+ * DDL is idempotent (`IF NOT EXISTS`) because watch-mode API instances race
+ * `migrationsRun` against each other on the shared dev database.
+ */
+export class CreateAuditLogs3390000000000 implements MigrationInterface {
+  name = "CreateAuditLogs3390000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.audit_logs (
+        id            uuid         NOT NULL DEFAULT gen_random_uuid(),
+        title         varchar(255) NOT NULL,
+        method        varchar(10)  NOT NULL,
+        url           text         NOT NULL,
+        route_path    varchar(255),
+        type          varchar(50)  NOT NULL,
+        is_success    boolean      NOT NULL,
+        user_id       uuid,
+        resource_id   varchar(64),
+        request       jsonb,
+        status_code   smallint,
+        error_message text,
+        user_name     varchar(150),
+        user_role     varchar(100),
+        ip_address    inet,
+        user_agent    text,
+        request_id    varchar(64),
+        duration_ms   integer,
+        created_at    timestamptz  NOT NULL DEFAULT now(),
+        CONSTRAINT "PK_audit_logs" PRIMARY KEY (id)
+      )
+    `);
+
+    // Every audit query is time-bounded, so created_at leads each index.
+    // DESC matches the "newest first" read path the controller exposes.
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_audit_logs_created_at"
+        ON freight.audit_logs (created_at DESC)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_audit_logs_user_id_created_at"
+        ON freight.audit_logs (user_id, created_at DESC)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_audit_logs_type_created_at"
+        ON freight.audit_logs (type, created_at DESC)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_audit_logs_type_resource_id"
+        ON freight.audit_logs (type, resource_id)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_audit_logs_route_path_created_at"
+        ON freight.audit_logs (route_path, created_at DESC)
+    `);
+    // Failures are a small slice of the table but carry the security signal
+    // (403s especially), so they get their own partial index.
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_audit_logs_failures"
+        ON freight.audit_logs (created_at DESC)
+        WHERE is_success = false
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.audit_logs`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3390000000000-RemoveGeneralManager.ts b/apps/edr-freight-api/src/migrations/3390000000000-RemoveGeneralManager.ts
new file mode 100644
index 000000000..055c3771b
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3390000000000-RemoveGeneralManager.ts
@@ -0,0 +1,210 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Onboarding revamp: one company, one verified identity.
+ *
+ * The general manager is removed outright — it named who to talk to and gated
+ * nothing — and the company's people become its **owner** (whoever the eTrade
+ * licence names as the business's manager) and its **Power of Attorney**.
+ * Exactly one of them is identity-verified, chosen by the company's own answer
+ * to "does anyone hold power of attorney for you?", stored as
+ * `attributes.poaDeclared`.
+ *
+ * The order below matters — each step depends on data a later step destroys:
+ *
+ * 1. Rescue notification addresses. `companyNotifyEmailExpr` used to fall
+ *    through to `attributes->>'generalManagerEmail'`, and `companies.email` was
+ *    only ever written for a Fayda-verified owner — so every foreign company
+ *    had none and was reached solely through that fallback. Promote it to the
+ *    column before the key is stripped, or those companies stop receiving mail
+ *    in silence.
+ * 2. Backfill the owner. `ownerName`/`ownerEmail`/`ownerPhone` are now required
+ *    onboarding fields; without this every already-onboarded company would
+ *    report three missing fields the moment it opened its settings page.
+ * 3. Resolve `poaSameAsOwner`. That flag waived the DARS delegation paper. It
+ *    is gone, so the companies holding it must be re-expressed:
+ *      - NOT a freight forwarder → "no PoA" (the owner represents themselves,
+ *        nothing to delegate). Their PoA details are cleared.
+ *      - A freight forwarder → "yes" and details KEPT. A forwarder signs on
+ *        other companies' behalf, so a representative is non-negotiable and the
+ *        waiver no longer exists. These companies will be asked for a
+ *        delegation paper they were previously excused — an intentional,
+ *        visible consequence, not an oversight. Count them before deploying.
+ * 4. Derive the declaration for everyone else, from whether PoA details exist.
+ * 5. Move drafts off the deleted "personnel" wizard step.
+ * 6. Only now drop the columns and strip the retired attribute keys.
+ *
+ * Irreversible by design: `down()` restores the columns' shape but cannot
+ * recover the values, and re-deriving `poaSameAsOwner` from `poaDeclared` would
+ * be a guess.
+ */
+export class RemoveGeneralManager3390000000000 implements MigrationInterface {
+  name = "RemoveGeneralManager3390000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    // 1. Rescue the notification address before the key it lives under is gone.
+    await queryRunner.query(`
+      UPDATE freight.companies
+      SET email = COALESCE(
+        NULLIF(email, ''),
+        NULLIF(attributes->>'ownerEmail', ''),
+        NULLIF(attributes->>'generalManagerEmail', ''),
+        NULLIF(attributes->>'contactPersonEmail', '')
+      )
+      WHERE COALESCE(email, '') = ''
+    `);
+
+    // 2. Backfill the owner from the best source each company actually has:
+    // its Fayda-verified owner claims (already under owner*), then the general
+    // manager it named, then its contact person. A company with none of these
+    // never finished onboarding, and will be asked on its next visit.
+    await queryRunner.query(`
+      UPDATE freight.companies
+      SET attributes = attributes
+        || jsonb_strip_nulls(jsonb_build_object(
+             'ownerName', COALESCE(
+               NULLIF(attributes->>'ownerName', ''),
+               NULLIF(attributes->>'generalManagerName', ''),
+               NULLIF(attributes->>'contactPersonName', '')
+             ),
+             'ownerEmail', COALESCE(
+               NULLIF(attributes->>'ownerEmail', ''),
+               NULLIF(attributes->>'generalManagerEmail', ''),
+               NULLIF(attributes->>'contactPersonEmail', ''),
+               NULLIF(email, '')
+             ),
+             'ownerPhone', COALESCE(
+               NULLIF(attributes->>'ownerPhone', ''),
+               NULLIF(attributes->>'generalManagerPhone', ''),
+               NULLIF(attributes->>'contactPersonPhone', ''),
+               NULLIF(phone, '')
+             )
+           ))
+      WHERE attributes IS NOT NULL
+    `);
+
+    // 2b. Capture eTrade's manager for the owner-vs-licence check the
+    // backoffice now makes. Nothing stored it before, so the best we have is
+    // the owner name itself — which makes existing companies read as "matches"
+    // rather than as a false mismatch on data nobody ever compared. The value
+    // is refreshed for real on the company's next eTrade lookup.
+    await queryRunner.query(`
+      UPDATE freight.companies
+      SET attributes = jsonb_set(
+            attributes, '{etradeManagerName}', to_jsonb(attributes->>'ownerName')
+          )
+      WHERE COALESCE(attributes->>'ownerName', '') <> ''
+        AND attributes->>'etradeManagerName' IS NULL
+        AND COALESCE(licence_number, '') <> ''
+    `);
+
+    // 3a. Owner-represents-themselves, and NOT a forwarder → "no PoA".
+    await queryRunner.query(`
+      UPDATE freight.companies c
+      SET attributes = (c.attributes - 'poaName' - 'poaPhone' - 'poaEmail'
+                        - 'poaLocation' - 'poaAddress' - 'poaFaydaSub'
+                        - 'poaFaydaVerifiedAt' - 'poaBirthdate' - 'poaGender')
+                       || jsonb_build_object('poaDeclared', 'no')
+      WHERE (c.attributes->>'poaSameAsOwner')::boolean IS TRUE
+        AND NOT EXISTS (
+          SELECT 1 FROM freight.company_profiles cp
+          WHERE cp.company_id = c.id
+            AND cp.type = 'freight_forwarder'
+            AND cp.deleted_at IS NULL
+        )
+    `);
+
+    // 3b. Forwarders keep their representative and lose the waiver.
+    await queryRunner.query(`
+      UPDATE freight.companies c
+      SET attributes = c.attributes || jsonb_build_object('poaDeclared', 'yes')
+      WHERE (c.attributes->>'poaSameAsOwner')::boolean IS TRUE
+        AND EXISTS (
+          SELECT 1 FROM freight.company_profiles cp
+          WHERE cp.company_id = c.id
+            AND cp.type = 'freight_forwarder'
+            AND cp.deleted_at IS NULL
+        )
+    `);
+
+    // 4. Everyone else: "yes" if a representative was named or the company is a
+    // forwarder, "no" if it finished onboarding without one. A company still
+    // mid-onboarding is left unanswered — it will be asked, which is the point.
+    await queryRunner.query(`
+      UPDATE freight.companies c
+      SET attributes = COALESCE(c.attributes, '{}'::jsonb)
+                       || jsonb_build_object('poaDeclared', 'yes')
+      WHERE c.attributes->>'poaDeclared' IS NULL
+        AND (
+          COALESCE(c.attributes->>'poaName', '') <> ''
+          OR COALESCE(c.attributes->>'poaPhone', '') <> ''
+          OR COALESCE(c.attributes->>'poaEmail', '') <> ''
+          OR COALESCE(c.attributes->>'poaLocation', '') <> ''
+          OR COALESCE(c.attributes->>'poaAddress', '') <> ''
+          OR EXISTS (
+            SELECT 1 FROM freight.company_profiles cp
+            WHERE cp.company_id = c.id
+              AND cp.type = 'freight_forwarder'
+              AND cp.deleted_at IS NULL
+          )
+        )
+    `);
+    await queryRunner.query(`
+      UPDATE freight.companies c
+      SET attributes = COALESCE(c.attributes, '{}'::jsonb)
+                       || jsonb_build_object('poaDeclared', 'no')
+      WHERE c.attributes->>'poaDeclared' IS NULL
+        AND EXISTS (
+          SELECT 1 FROM freight.external_profiles ep
+          WHERE ep.company_id = c.id
+            AND ep.onboarding_completed = true
+            AND ep.deleted_at IS NULL
+        )
+    `);
+
+    // 5. The "personnel" (general manager) wizard step no longer exists; a
+    // draft resting on it would fall back to the very first step and make the
+    // customer walk the whole wizard again.
+    await queryRunner.query(`
+      UPDATE freight.external_profiles
+      SET onboarding_step = 'owner'
+      WHERE onboarding_step = 'personnel'
+    `);
+
+    // 6. Retire the general manager and the flag it shared the model with.
+    await queryRunner.query(`
+      UPDATE freight.companies
+      SET attributes = attributes - 'generalManagerName' - 'generalManagerEmail'
+                       - 'generalManagerPhone' - 'gmSameAsOwner' - 'gmFaydaSub'
+                       - 'gmFaydaVerifiedAt' - 'gmName' - 'gmEmail' - 'gmPhone'
+                       - 'gmAddress' - 'gmBirthdate' - 'gmGender'
+                       - 'poaSameAsOwner'
+      WHERE attributes IS NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.companies
+        DROP COLUMN IF EXISTS general_manager_name,
+        DROP COLUMN IF EXISTS general_manager_email,
+        DROP COLUMN IF EXISTS general_manager_phone
+    `);
+  }
+
+  /**
+   * Restores the columns' shape only. The values, the `gm*` attributes and the
+   * `poaSameAsOwner` flag are not recoverable — this migration folded them into
+   * `ownerEmail` / `poaDeclared`, and there is no way back that isn't a guess.
+   */
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.companies
+        ADD COLUMN IF NOT EXISTS general_manager_name varchar(100),
+        ADD COLUMN IF NOT EXISTS general_manager_email varchar(150),
+        ADD COLUMN IF NOT EXISTS general_manager_phone varchar(20)
+    `);
+    await queryRunner.query(`
+      UPDATE freight.external_profiles
+      SET onboarding_step = 'personnel'
+      WHERE onboarding_step = 'owner'
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3400000000000-StampSettings.ts b/apps/edr-freight-api/src/migrations/3400000000000-StampSettings.ts
new file mode 100644
index 000000000..9556318f9
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3400000000000-StampSettings.ts
@@ -0,0 +1,28 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Single-row table holding the one company stamp/seal image stamped onto
+ * generated invoice/receipt PDFs (see StampSettingsService /
+ * InvoiceDocumentService). Same single-row shape as exchange_settings; the
+ * app never inserts more than one row.
+ */
+export class StampSettings3400000000000 implements MigrationInterface {
+  name = "StampSettings3400000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.stamp_settings (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        stamp_file_id uuid REFERENCES freight.files(id),
+        updated_by_id uuid,
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      );
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.stamp_settings;`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3400000000000-TransferRequestPreferredWagons.ts b/apps/edr-freight-api/src/migrations/3400000000000-TransferRequestPreferredWagons.ts
new file mode 100644
index 000000000..b86327147
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3400000000000-TransferRequestPreferredWagons.ts
@@ -0,0 +1,29 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Wagons the requester specifically asked for. A transfer request stays
+ * count-driven (`quantity` is what must be delivered), but a requester who
+ * picked wagons off the yard desk now records WHICH ones — OCC sees the numbers
+ * on the queue and the fulfil picker pre-selects them.
+ *
+ * Stored as a uuid[] column rather than a join table: the list is read and
+ * written whole, never queried by wagon, and a preference carries no lifecycle
+ * of its own (no FK — a purged wagon simply drops out of the display).
+ */
+export class TransferRequestPreferredWagons3400000000000
+  implements MigrationInterface
+{
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.wagon_transfer_requests
+        ADD COLUMN IF NOT EXISTS preferred_wagon_ids uuid[]
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.wagon_transfer_requests
+        DROP COLUMN IF EXISTS preferred_wagon_ids
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3410000000000-ScheduleVoyageNumber.ts b/apps/edr-freight-api/src/migrations/3410000000000-ScheduleVoyageNumber.ts
new file mode 100644
index 000000000..dd62276d8
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3410000000000-ScheduleVoyageNumber.ts
@@ -0,0 +1,28 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Voyage number for one departure.
+ *
+ * `train_number` already exists on a schedule (the run number), but operations
+ * also quote a VOYAGE number — the sailing/run identifier yards and customs use
+ * for a specific departure. It belongs on the schedule, not the built train: one
+ * train serves many departures and each carries its own voyage.
+ *
+ * Nullable and un-indexed: it is display/reference data typed by staff, not a
+ * lookup key, and older schedules simply have none.
+ */
+export class ScheduleVoyageNumber3410000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.train_schedules
+        ADD COLUMN IF NOT EXISTS voyage_number varchar(20)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.train_schedules
+        DROP COLUMN IF EXISTS voyage_number
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3420000000000-BulkTemplateTradeDirection.ts b/apps/edr-freight-api/src/migrations/3420000000000-BulkTemplateTradeDirection.ts
new file mode 100644
index 000000000..e76591205
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3420000000000-BulkTemplateTradeDirection.ts
@@ -0,0 +1,69 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Bulk contract templates gain trade direction, so the unique key becomes
+ * (cargo type, direction, customs option) instead of (cargo type, customs).
+ *
+ * Intercity is domestic and crosses no border, so it has no customs variant at
+ * all: with_customs stays NULL there, enforced by ck_bulk_intercity_no_customs.
+ * The unique index coalesces that NULL so two intercity templates for the same
+ * cargo type still collide (plain NULLs never do).
+ *
+ * No backfill: staff-created bulk templates are keyed by cargo_type_id and no
+ * such row exists yet — the seeded direction-keyed bulk rows were retired by
+ * 3320000000000 and carry a NULL cargo_type_id. The five system container
+ * templates are untouched: cargo_type_id IS NULL keeps them out of both the
+ * index and the check.
+ */
+export class BulkTemplateTradeDirection3420000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        ADD COLUMN IF NOT EXISTS trade_direction varchar(20)
+    `);
+
+    await queryRunner.query(
+      `DROP INDEX IF EXISTS freight.uq_contract_templates_cargo_customs`,
+    );
+
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_contract_templates_cargo_dir_customs
+        ON freight.contract_templates
+           (cargo_type_id, trade_direction, COALESCE(with_customs, false))
+        WHERE deleted_at IS NULL AND cargo_type_id IS NOT NULL
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        DROP CONSTRAINT IF EXISTS ck_bulk_intercity_no_customs
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        ADD CONSTRAINT ck_bulk_intercity_no_customs CHECK (
+          cargo_type_id IS NULL
+          OR (
+            trade_direction IN ('IMPORT', 'EXPORT', 'INTERCITY')
+            AND (trade_direction = 'INTERCITY') = (with_customs IS NULL)
+          )
+        )
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates
+        DROP CONSTRAINT IF EXISTS ck_bulk_intercity_no_customs
+    `);
+    await queryRunner.query(
+      `DROP INDEX IF EXISTS freight.uq_contract_templates_cargo_dir_customs`,
+    );
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_contract_templates_cargo_customs
+        ON freight.contract_templates (cargo_type_id, with_customs)
+        WHERE deleted_at IS NULL AND cargo_type_id IS NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.contract_templates DROP COLUMN IF EXISTS trade_direction
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3430000000000-FuelSurcharge.ts b/apps/edr-freight-api/src/migrations/3430000000000-FuelSurcharge.ts
new file mode 100644
index 000000000..dfd0d25cf
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3430000000000-FuelSurcharge.ts
@@ -0,0 +1,62 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Fuel surcharge, sold per lane + commodity:
+ *
+ * - cargo_types.has_fuel marks the commodities that incur it (same shape as
+ *   has_lashing — the booking's cargo type flag is what fires the charge).
+ * - rates.base_liters carries the liters a PER_LITER fuel rate bills
+ *   (price = base_liters × rate_value, once per booking). NULL on every other
+ *   rate shape, including PER_WAGON fuel rates (wagons × rate_value).
+ * - CK_rates_yard_scope gains FUEL in its yard-carrying branch: fuel is priced
+ *   per origin → destination leg like customs clearance and container return.
+ */
+export class FuelSurcharge3430000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.cargo_types
+        ADD COLUMN IF NOT EXISTS has_fuel boolean NOT NULL DEFAULT false
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        ADD COLUMN IF NOT EXISTS base_liters numeric(14,4)
+    `);
+
+    await queryRunner.query(
+      `ALTER TABLE freight.rates DROP CONSTRAINT IF EXISTS "CK_rates_yard_scope"`,
+    );
+    await queryRunner.query(`
+      ALTER TABLE freight.rates ADD CONSTRAINT "CK_rates_yard_scope" CHECK (
+        deleted_at IS NOT NULL OR status = 'SUPERSEDED' OR
+        CASE
+          WHEN (trigger = 'ALWAYS' AND applies_to IN ('BULK', 'CONTAINER', 'INTERCITY'))
+            OR trigger IN ('CUSTOMS_CLEARANCE', 'WITH_RETURN', 'FUEL')
+          THEN origin_yard_id IS NOT NULL AND destination_yard_id IS NOT NULL
+          ELSE origin_yard_id IS NULL AND destination_yard_id IS NULL
+        END
+      )
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `ALTER TABLE freight.rates DROP CONSTRAINT IF EXISTS "CK_rates_yard_scope"`,
+    );
+    await queryRunner.query(`
+      ALTER TABLE freight.rates ADD CONSTRAINT "CK_rates_yard_scope" CHECK (
+        deleted_at IS NOT NULL OR status = 'SUPERSEDED' OR
+        CASE
+          WHEN (trigger = 'ALWAYS' AND applies_to IN ('BULK', 'CONTAINER', 'INTERCITY'))
+            OR trigger IN ('CUSTOMS_CLEARANCE', 'WITH_RETURN')
+          THEN origin_yard_id IS NOT NULL AND destination_yard_id IS NOT NULL
+          ELSE origin_yard_id IS NULL AND destination_yard_id IS NULL
+        END
+      )
+    `);
+    await queryRunner.query(`ALTER TABLE freight.rates DROP COLUMN IF EXISTS base_liters`);
+    await queryRunner.query(
+      `ALTER TABLE freight.cargo_types DROP COLUMN IF EXISTS has_fuel`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3440000000000-ShippingLineCompany.ts b/apps/edr-freight-api/src/migrations/3440000000000-ShippingLineCompany.ts
new file mode 100644
index 000000000..91e78ab14
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3440000000000-ShippingLineCompany.ts
@@ -0,0 +1,78 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Shipping lines — carriers registered by backoffice staff who sign in to the
+ * portal directly.
+ *
+ * Separate from `freight.companies` on purpose: a shipping line has no TIN,
+ * business licence, eTrade record, operational profile or onboarding state, so
+ * it shares none of the customer columns. `user_id` sits on the company row
+ * itself because the company IS the account — there is no contact-person row.
+ *
+ * No FK on `user_id`: `iam.users` belongs to the IAM service's schema, which
+ * this API reads but never owns.
+ */
+export class ShippingLineCompany3440000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DO $$ BEGIN
+        CREATE TYPE freight.shipping_line_companies_status_enum
+          AS ENUM ('active', 'suspended');
+      EXCEPTION WHEN duplicate_object THEN NULL;
+      END $$
+    `);
+
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.shipping_line_companies (
+        id            uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        user_id       uuid NOT NULL,
+        name          varchar(200) NOT NULL,
+        scac_code     varchar(4),
+        imo_number    varchar(20),
+        bic_code      varchar(20),
+        email         varchar(150) NOT NULL,
+        phone_number  varchar(30),
+        status        freight.shipping_line_companies_status_enum
+                        NOT NULL DEFAULT 'active',
+        created_at    timestamptz NOT NULL DEFAULT now(),
+        updated_at    timestamptz NOT NULL DEFAULT now(),
+        deleted_at    timestamptz
+      )
+    `);
+
+    // One login per shipping line. Partial so a soft-deleted row frees its
+    // account for re-registration rather than blocking it forever.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS "UQ_shipping_line_companies_user"
+        ON freight.shipping_line_companies (user_id)
+        WHERE deleted_at IS NULL
+    `);
+
+    // SCAC identifies the carrier globally — two live lines cannot share one.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS "UQ_shipping_line_companies_scac"
+        ON freight.shipping_line_companies (scac_code)
+        WHERE scac_code IS NOT NULL AND deleted_at IS NULL
+    `);
+
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS "UQ_shipping_line_companies_email"
+        ON freight.shipping_line_companies (lower(email))
+        WHERE deleted_at IS NULL
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "IDX_shipping_line_companies_status"
+        ON freight.shipping_line_companies (status)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS freight.shipping_line_companies`,
+    );
+    await queryRunner.query(
+      `DROP TYPE IF EXISTS freight.shipping_line_companies_status_enum`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3450000000000-BookingShippingLine.ts b/apps/edr-freight-api/src/migrations/3450000000000-BookingShippingLine.ts
new file mode 100644
index 000000000..d53914ef3
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3450000000000-BookingShippingLine.ts
@@ -0,0 +1,117 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Shipping lines book rail capacity directly, without a contract.
+ *
+ * A booking has always been owned by `company_id` (a customer `companies` row),
+ * but a shipping line is a `shipping_line_companies` row and deliberately NOT a
+ * company — it carries no TIN, licence or operational profiles. So it gets its
+ * own nullable owner column rather than a synthetic company row.
+ *
+ * Exactly one of the two is set: `company_id` for a customer booking,
+ * `shipping_line_company_id` for a shipping-line one. Existing rows keep
+ * `company_id` and a NULL `shipping_line_company_id`, so nothing needs
+ * backfilling and every customer query filtering on `company_id` behaves
+ * exactly as before. Government bookings already bill to a seeded government
+ * company, so they satisfy the CHECK unchanged.
+ *
+ * NOTE: not to be confused with the existing `bookings.shipping_line_id`, which
+ * is cargo metadata naming the carrier line that moves the goods
+ * (`freight.shipping_lines`, reference data). This column points at
+ * `freight.shipping_line_companies` — the portal account — and is unrelated.
+ */
+export class BookingShippingLine3450000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings
+        ADD COLUMN IF NOT EXISTS shipping_line_company_id uuid
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_bookings_shipping_line_company_id
+        ON freight.bookings (shipping_line_company_id)
+    `);
+
+    // `company_id` / `company_profile_id` are NOT NULL and point at the customer
+    // tables, so a shipping-line booking could not be inserted at all. Relax
+    // them to nullable; their foreign keys are left in place and keep validating
+    // every non-NULL value, so a customer booking is constrained exactly as
+    // before. The CHECK below is what now guarantees an owner is present.
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings ALTER COLUMN company_id DROP NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings ALTER COLUMN company_profile_id DROP NOT NULL
+    `);
+
+    // Route and service are inherited from the contract on a customer booking.
+    // A shipping line initiates before any of that is known — the bare booking
+    // exists only to hang documents off — so these are relaxed too and filled
+    // in when the booking is completed. Existing rows all have values, and the
+    // customer paths still always set them.
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings ALTER COLUMN origin_yard_id DROP NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings ALTER COLUMN destination_yard_id DROP NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings ALTER COLUMN service_type_id DROP NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings ALTER COLUMN freight_type DROP NOT NULL
+    `);
+
+    // No FK: kept consistent with how the column is populated at the service
+    // layer, and avoids a lock on shipping_line_companies during deploy.
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings
+        DROP CONSTRAINT IF EXISTS chk_bookings_single_owner
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings
+        ADD CONSTRAINT chk_bookings_single_owner
+        CHECK (
+          (company_id IS NOT NULL AND shipping_line_company_id IS NULL)
+          OR (company_id IS NULL AND shipping_line_company_id IS NOT NULL)
+        )
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings
+        DROP CONSTRAINT IF EXISTS chk_bookings_single_owner
+    `);
+
+    // Only reinstate NOT NULL if no shipping-line booking exists; those rows
+    // have a NULL company_id by design and would make the ALTER fail. Leaving
+    // the columns nullable is the safe outcome — the constraint is additive.
+    const [{ count }] = (await queryRunner.query(`
+      SELECT COUNT(*)::int AS count FROM freight.bookings
+      WHERE shipping_line_company_id IS NOT NULL
+    `)) as Array<{ count: number }>;
+
+    if (count === 0) {
+      for (const column of [
+        "company_id",
+        "company_profile_id",
+        "origin_yard_id",
+        "destination_yard_id",
+        "service_type_id",
+        "freight_type",
+      ]) {
+        await queryRunner.query(`
+          ALTER TABLE freight.bookings ALTER COLUMN ${column} SET NOT NULL
+        `);
+      }
+    }
+
+    await queryRunner.query(`
+      DROP INDEX IF EXISTS freight.idx_bookings_shipping_line_company_id
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.bookings DROP COLUMN IF EXISTS shipping_line_company_id
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3450000000000-WidenEimsIrn.ts b/apps/edr-freight-api/src/migrations/3450000000000-WidenEimsIrn.ts
new file mode 100644
index 000000000..ec3faf9eb
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3450000000000-WidenEimsIrn.ts
@@ -0,0 +1,33 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * `eims_irn varchar(64)` was sized for a guess; the real value MoR returns is longer. Confirmed
+ * live 2026-08-12 — a genuine `POST /v1/register` acceptance came back as
+ * `test-aeedcbf496f0b63bb035ba3ca1dc674e3c81c980cafeb1c5038421999a23a215` (69 chars: a `test-`
+ * prefix + a 64-hex-char body), which overflowed the column and threw *after* MoR had already
+ * accepted the document — `settleSuccess` never committed, leaving the invoice stuck `SUBMITTING`
+ * and the system-wide reservation stuck in-flight with no block/alert (see
+ * `EimsInvoiceRegistrationService` for the accompanying code fix).
+ *
+ * Widened to `text` rather than a new fixed length: MoR has never documented an IRN format or
+ * length, and a `test-` prefix on a *production* endpoint suggests this may not even be MoR's
+ * real production shape — guessing another fixed bound risks the exact same failure again.
+ */
+export class WidenEimsIrn3450000000000 implements MigrationInterface {
+  name = "WidenEimsIrn3450000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      ALTER COLUMN eims_irn TYPE text
+    `);
+  }
+
+  /** Only safe if nothing stored so far exceeds 64 chars — true only until this migration ran. */
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      ALTER COLUMN eims_irn TYPE varchar(64)
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3460000000000-AddEimsSignedQr.ts b/apps/edr-freight-api/src/migrations/3460000000000-AddEimsSignedQr.ts
new file mode 100644
index 000000000..dedf2d05f
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3460000000000-AddEimsSignedQr.ts
@@ -0,0 +1,20 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/** `DocumentDetails`/register-response field `signedQR`, persisted alongside `eims_irn`. */
+export class AddEimsSignedQr3460000000000 implements MigrationInterface {
+  name = "AddEimsSignedQr3460000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      ADD COLUMN IF NOT EXISTS eims_signed_qr text
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      DROP COLUMN IF EXISTS eims_signed_qr
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3460000000000-ShippingLineCredits.ts b/apps/edr-freight-api/src/migrations/3460000000000-ShippingLineCredits.ts
new file mode 100644
index 000000000..5a59d9d80
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3460000000000-ShippingLineCredits.ts
@@ -0,0 +1,201 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Shipping lines consume services before paying for them.
+ *
+ * A shipping line books rail capacity and the booking proceeds with no payment
+ * gate at all — unlike a customer booking, which cannot advance until its
+ * PREPAID invoice settles. What the line owes is instead recorded here as a
+ * credit: one row per booking, priced once and never recalculated. Finance
+ * later selects a batch of unbilled credits, generates a single invoice for
+ * them, and the line pays that invoice through the normal CBE flow. When the
+ * invoice settles, its credits are marked paid and stop counting as debt.
+ *
+ * This is deliberately NOT a wallet or a stored balance. There is no money in
+ * the system to draw down: a credit is a debt the line already incurred, so
+ * the outstanding figure is always derived (`SUM(amount) WHERE status <>
+ * 'PAID'`) rather than kept in a column that UPDATEs can drift out of sync.
+ *
+ * `invoices.company_id` / `company_profile_id` are relaxed to nullable for the
+ * same reason `bookings` was in {@link BookingShippingLine3450000000000}: a
+ * shipping line is not a `companies` row and never will be, so an invoice
+ * billed to one has no customer to point at. Both FKs stay in place and keep
+ * validating every non-NULL value, so a customer invoice is constrained
+ * exactly as before; the CHECK below is what now guarantees a payer exists.
+ */
+export class ShippingLineCredits3460000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    // ── Invoices: allow a shipping-line payer ────────────────────────────────
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        ADD COLUMN IF NOT EXISTS shipping_line_company_id uuid
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_invoices_shipping_line_company_id
+        ON freight.invoices (shipping_line_company_id)
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices ALTER COLUMN company_id DROP NOT NULL
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices ALTER COLUMN company_profile_id DROP NOT NULL
+    `);
+
+    // Exactly one payer. Mirrors chk_bookings_single_owner so the two tables
+    // answer "who owes this?" the same way. Existing rows all have company_id
+    // and a NULL shipping_line_company_id, so nothing needs backfilling.
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        DROP CONSTRAINT IF EXISTS chk_invoices_single_payer
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        ADD CONSTRAINT chk_invoices_single_payer
+        CHECK (
+          (company_id IS NOT NULL AND shipping_line_company_id IS NULL)
+          OR (company_id IS NULL AND shipping_line_company_id IS NOT NULL)
+        )
+    `);
+
+    // ── The credit ledger ────────────────────────────────────────────────────
+    await queryRunner.query(`
+      DO $$ BEGIN
+        CREATE TYPE freight.shipping_line_credits_status_enum AS ENUM (
+          'UNBILLED', 'BILLED', 'PAID', 'CANCELLED'
+        );
+      EXCEPTION WHEN duplicate_object THEN NULL; END $$
+    `);
+
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.shipping_line_credits (
+        id uuid DEFAULT gen_random_uuid() NOT NULL,
+        shipping_line_company_id uuid NOT NULL,
+        booking_id uuid NOT NULL,
+        amount numeric(14,2) NOT NULL,
+        currency character varying(8) DEFAULT 'ETB'::character varying NOT NULL,
+        status freight.shipping_line_credits_status_enum
+          DEFAULT 'UNBILLED'::freight.shipping_line_credits_status_enum NOT NULL,
+        description character varying(255),
+        invoice_id uuid,
+        billed_at timestamp with time zone,
+        paid_at timestamp with time zone,
+        cancelled_at timestamp with time zone,
+        cancellation_reason character varying(255),
+        created_at timestamp with time zone DEFAULT now() NOT NULL,
+        updated_at timestamp with time zone DEFAULT now() NOT NULL,
+        deleted_at timestamp with time zone,
+        CONSTRAINT pk_shipping_line_credits PRIMARY KEY (id),
+        CONSTRAINT chk_shipping_line_credits_amount CHECK (amount >= 0),
+        -- The state machine, enforced in the DB rather than trusted to the
+        -- service: an UNBILLED credit has no invoice, and anything past
+        -- UNBILLED must name the invoice it was billed on. Without this a
+        -- half-applied batch could leave BILLED rows with a NULL invoice_id
+        -- and silently vanish from both the unbilled list and the invoice.
+        CONSTRAINT chk_shipping_line_credits_invoice_link CHECK (
+          (status = 'UNBILLED' AND invoice_id IS NULL)
+          OR (status IN ('BILLED', 'PAID') AND invoice_id IS NOT NULL)
+          OR status = 'CANCELLED'
+        )
+      )
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.shipping_line_credits
+        DROP CONSTRAINT IF EXISTS fk_shipping_line_credits_shipping_line
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.shipping_line_credits
+        ADD CONSTRAINT fk_shipping_line_credits_shipping_line
+        FOREIGN KEY (shipping_line_company_id)
+        REFERENCES freight.shipping_line_companies(id) ON DELETE RESTRICT
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.shipping_line_credits
+        DROP CONSTRAINT IF EXISTS fk_shipping_line_credits_booking
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.shipping_line_credits
+        ADD CONSTRAINT fk_shipping_line_credits_booking
+        FOREIGN KEY (booking_id)
+        REFERENCES freight.bookings(id) ON DELETE RESTRICT
+    `);
+
+    // SET NULL rather than CASCADE: deleting an invoice must never delete the
+    // record of what was owed. The row would then violate the link CHECK, so a
+    // credit whose invoice is removed has to be walked back to UNBILLED
+    // explicitly — which is the correct, visible outcome.
+    await queryRunner.query(`
+      ALTER TABLE freight.shipping_line_credits
+        DROP CONSTRAINT IF EXISTS fk_shipping_line_credits_invoice
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.shipping_line_credits
+        ADD CONSTRAINT fk_shipping_line_credits_invoice
+        FOREIGN KEY (invoice_id)
+        REFERENCES freight.invoices(id) ON DELETE SET NULL
+    `);
+
+    // One live credit per booking. Partial so a soft-deleted or cancelled row
+    // does not block re-pricing a booking that was voided and rebooked.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_shipping_line_credits_booking
+        ON freight.shipping_line_credits (booking_id)
+        WHERE deleted_at IS NULL AND status <> 'CANCELLED'
+    `);
+
+    // Drives the two hot reads: finance's unbilled worklist per line, and the
+    // outstanding total on the shipping-line detail page.
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_shipping_line_credits_line_status
+        ON freight.shipping_line_credits (shipping_line_company_id, status)
+        WHERE deleted_at IS NULL
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_shipping_line_credits_invoice_id
+        ON freight.shipping_line_credits (invoice_id)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DROP TABLE IF EXISTS freight.shipping_line_credits
+    `);
+    await queryRunner.query(`
+      DROP TYPE IF EXISTS freight.shipping_line_credits_status_enum
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        DROP CONSTRAINT IF EXISTS chk_invoices_single_payer
+    `);
+
+    // Only reinstate NOT NULL if no shipping-line invoice exists; those rows
+    // have a NULL company_id by design and would make the ALTER fail. Leaving
+    // the columns nullable is the safe outcome — the constraint is additive.
+    const [{ count }] = (await queryRunner.query(`
+      SELECT COUNT(*)::int AS count FROM freight.invoices
+      WHERE shipping_line_company_id IS NOT NULL
+    `)) as Array<{ count: number }>;
+
+    if (count === 0) {
+      await queryRunner.query(`
+        ALTER TABLE freight.invoices ALTER COLUMN company_id SET NOT NULL
+      `);
+      await queryRunner.query(`
+        ALTER TABLE freight.invoices ALTER COLUMN company_profile_id SET NOT NULL
+      `);
+    }
+
+    await queryRunner.query(`
+      DROP INDEX IF EXISTS freight.idx_invoices_shipping_line_company_id
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+        DROP COLUMN IF EXISTS shipping_line_company_id
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3470000000000-EimsCancellation.ts b/apps/edr-freight-api/src/migrations/3470000000000-EimsCancellation.ts
new file mode 100644
index 000000000..7092e5518
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3470000000000-EimsCancellation.ts
@@ -0,0 +1,26 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/** Columns for `POST /v1/cancel` — see `EimsCancellationService`. */
+export class EimsCancellation3470000000000 implements MigrationInterface {
+  name = "EimsCancellation3470000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      ADD COLUMN IF NOT EXISTS eims_cancelled_at timestamptz,
+      ADD COLUMN IF NOT EXISTS eims_cancellation_date varchar(64),
+      ADD COLUMN IF NOT EXISTS eims_cancellation_reason_code varchar(8),
+      ADD COLUMN IF NOT EXISTS eims_cancellation_remark text
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      DROP COLUMN IF EXISTS eims_cancelled_at,
+      DROP COLUMN IF EXISTS eims_cancellation_date,
+      DROP COLUMN IF EXISTS eims_cancellation_reason_code,
+      DROP COLUMN IF EXISTS eims_cancellation_remark
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3470000000000-ShippingLineRates.ts b/apps/edr-freight-api/src/migrations/3470000000000-ShippingLineRates.ts
new file mode 100644
index 000000000..05e0bb799
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3470000000000-ShippingLineRates.ts
@@ -0,0 +1,127 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Per-shipping-line rates.
+ *
+ * A shipping line books rail capacity directly (see BookingShippingLine3450000000000)
+ * and negotiates its own prices, so the rate table gains an owner column:
+ * `shipping_line_company_id` NULL = the standard rate every customer pays,
+ * NOT NULL = a rate that only that line's bookings resolve.
+ *
+ * Points at `freight.shipping_line_companies` (the portal account that owns the
+ * booking), NOT `freight.shipping_lines` — the latter is carrier reference data
+ * naming who physically moves the goods, and the existing SHIPPING_LINE trigger
+ * already keys off it. Both stay independent.
+ *
+ * Line rates OVERRIDE rather than stack: a booking owned by a line prices off
+ * that line's rate for the lane, and is hard-blocked when none exists (the
+ * standard rate is deliberately not a fallback — see RuleEngineService).
+ *
+ * Every existing row keeps a NULL owner, so nothing needs backfilling and the
+ * standard-rate lookups behave exactly as before.
+ */
+export class ShippingLineRates3470000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        ADD COLUMN IF NOT EXISTS shipping_line_company_id uuid
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        DROP CONSTRAINT IF EXISTS "FK_rates_shipping_line_company"
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        ADD CONSTRAINT "FK_rates_shipping_line_company"
+        FOREIGN KEY (shipping_line_company_id)
+        REFERENCES freight.shipping_line_companies (id)
+        ON DELETE RESTRICT
+    `);
+
+    // Rate resolution always filters by owner, so the lookups this column
+    // participates in are (owner, lane) — indexed together with rate_type,
+    // which every lookup also pins.
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_rates_shipping_line_company_id
+        ON freight.rates (shipping_line_company_id)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_rates_shipping_line_lane
+        ON freight.rates (shipping_line_company_id, rate_type, origin_yard_id, destination_yard_id)
+        WHERE shipping_line_company_id IS NOT NULL
+    `);
+
+    // A shipping line sells import freight only — the export leg is contracted
+    // through the customer, not the carrier. Enforced here so a line rate can
+    // never be filed against an export lane regardless of which API path wrote
+    // it. Surcharges carry no direction and are unaffected.
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        DROP CONSTRAINT IF EXISTS "CK_rates_shipping_line_import_only"
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        ADD CONSTRAINT "CK_rates_shipping_line_import_only" CHECK (
+          deleted_at IS NOT NULL OR status = 'SUPERSEDED' OR
+          shipping_line_company_id IS NULL OR
+          trade_direction IS NULL OR trade_direction = 'IMPORT'
+        )
+    `);
+
+    // The owner joins the rate's identity. Without it MSC's 20ft Djibouti→Modjo
+    // rate collides with the standard rate for the same lane — same rate_type,
+    // same scope, same unit — and the insert fails on UQ_rates_pattern. NULL
+    // (the standard rate) collapses to the zero uuid like every other nullable
+    // scope column, so existing rows keep their current uniqueness exactly.
+    await queryRunner.query(`DROP INDEX IF EXISTS freight."UQ_rates_pattern"`);
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS "UQ_rates_pattern" ON freight.rates USING btree (
+        rate_type,
+        COALESCE(shipping_line_company_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(container_type_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(cargo_type_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(trade_direction, ''::character varying),
+        COALESCE(origin_yard_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(destination_yard_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        rate_unit,
+        COALESCE(min_km, '-1'::numeric)
+      ) WHERE ((deleted_at IS NULL) AND ((status)::text <> 'SUPERSEDED'::text))
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    // Restore the pre-owner pattern index (as left by LastMileRateBands).
+    await queryRunner.query(`DROP INDEX IF EXISTS freight."UQ_rates_pattern"`);
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS "UQ_rates_pattern" ON freight.rates USING btree (
+        rate_type,
+        COALESCE(container_type_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(cargo_type_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(trade_direction, ''::character varying),
+        COALESCE(origin_yard_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        COALESCE(destination_yard_id, '00000000-0000-0000-0000-000000000000'::uuid),
+        rate_unit,
+        COALESCE(min_km, '-1'::numeric)
+      ) WHERE ((deleted_at IS NULL) AND ((status)::text <> 'SUPERSEDED'::text))
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        DROP CONSTRAINT IF EXISTS "CK_rates_shipping_line_import_only"
+    `);
+    await queryRunner.query(
+      `DROP INDEX IF EXISTS freight.idx_rates_shipping_line_lane`,
+    );
+    await queryRunner.query(
+      `DROP INDEX IF EXISTS freight.idx_rates_shipping_line_company_id`,
+    );
+    await queryRunner.query(`
+      ALTER TABLE freight.rates
+        DROP CONSTRAINT IF EXISTS "FK_rates_shipping_line_company"
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.rates DROP COLUMN IF EXISTS shipping_line_company_id
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3480000000000-WidenPreviousIrn.ts b/apps/edr-freight-api/src/migrations/3480000000000-WidenPreviousIrn.ts
new file mode 100644
index 000000000..15a343f06
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3480000000000-WidenPreviousIrn.ts
@@ -0,0 +1,24 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Same bug as `3450000000000-WidenEimsIrn`, same fix: `previous_irn` stores a real MoR IRN too
+ * (fed into the next registration's `ReferenceDetails.PreviousIrn`) and would overflow the same
+ * varchar(64) on the next successful registration.
+ */
+export class WidenPreviousIrn3480000000000 implements MigrationInterface {
+  name = "WidenPreviousIrn3480000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.eims_system_state
+      ALTER COLUMN previous_irn TYPE text
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.eims_system_state
+      ALTER COLUMN previous_irn TYPE varchar(64)
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3490000000000-EimsReceipts.ts b/apps/edr-freight-api/src/migrations/3490000000000-EimsReceipts.ts
new file mode 100644
index 000000000..3d5ab02e9
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3490000000000-EimsReceipts.ts
@@ -0,0 +1,34 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/** `freight.eims_receipts` — see `EimsReceipt` entity. */
+export class EimsReceipts3490000000000 implements MigrationInterface {
+  name = "EimsReceipts3490000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.eims_receipts (
+        id            uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        invoice_id    uuid NOT NULL REFERENCES freight.invoices(id),
+        kind          varchar(16) NOT NULL,
+        status        varchar(20) NOT NULL DEFAULT 'NOT_SUBMITTED',
+        receipt_number varchar(64) NOT NULL,
+        rrn           text,
+        qr            text,
+        ack_status    varchar(8),
+        submitted_at  timestamptz,
+        last_error    jsonb,
+        request       jsonb,
+        created_at    timestamptz NOT NULL DEFAULT now(),
+        updated_at    timestamptz NOT NULL DEFAULT now(),
+        deleted_at    timestamptz
+      )
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_eims_receipts_invoice_id ON freight.eims_receipts (invoice_id)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.eims_receipts`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3500000000000-LogoSettings.ts b/apps/edr-freight-api/src/migrations/3500000000000-LogoSettings.ts
new file mode 100644
index 000000000..36d70906f
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3500000000000-LogoSettings.ts
@@ -0,0 +1,27 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Single-row table holding the one company logo image stamped onto every
+ * generated document (see LogoSettingsService). Same single-row shape as
+ * stamp_settings; the app never inserts more than one row.
+ */
+export class LogoSettings3500000000000 implements MigrationInterface {
+  name = "LogoSettings3500000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.logo_settings (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        logo_file_id uuid REFERENCES freight.files(id),
+        updated_by_id uuid,
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      );
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.logo_settings;`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3510000000000-TrainScheduleShippingLine.ts b/apps/edr-freight-api/src/migrations/3510000000000-TrainScheduleShippingLine.ts
new file mode 100644
index 000000000..e1713db94
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3510000000000-TrainScheduleShippingLine.ts
@@ -0,0 +1,34 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * A train schedule can be dedicated to one shipping line.
+ *
+ * NULL = a normal train, visible and bookable to customers as before. Set =
+ * the departure exists for that shipping line alone: it is excluded from every
+ * customer-facing read (booking windows, day pools, portal home cards) and
+ * surfaces only in the assigned line's portal (home page + booking detail).
+ */
+export class TrainScheduleShippingLine3510000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.train_schedules
+        ADD COLUMN IF NOT EXISTS shipping_line_company_id uuid
+        REFERENCES freight.shipping_line_companies (id)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_train_schedules_shipping_line_company_id
+        ON freight.train_schedules (shipping_line_company_id)
+        WHERE shipping_line_company_id IS NOT NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DROP INDEX IF EXISTS freight.idx_train_schedules_shipping_line_company_id
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.train_schedules
+        DROP COLUMN IF EXISTS shipping_line_company_id
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3520000000000-DefaultDeskHours24h.ts b/apps/edr-freight-api/src/migrations/3520000000000-DefaultDeskHours24h.ts
new file mode 100644
index 000000000..8cd71eff9
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3520000000000-DefaultDeskHours24h.ts
@@ -0,0 +1,31 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Default the daily booking desk to 24 hours: window_close_hour equal to
+ * window_open_hour means the desk never pauses overnight. Aligns the column
+ * default and the existing global-rules row; per-schedule overrides keep
+ * whatever staff set on them.
+ */
+export class DefaultDeskHours24h3520000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.train_scheduling_global_rules
+        ALTER COLUMN window_close_hour SET DEFAULT 8
+    `);
+    await queryRunner.query(`
+      UPDATE freight.train_scheduling_global_rules
+        SET window_close_hour = window_open_hour
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.train_scheduling_global_rules
+        ALTER COLUMN window_close_hour SET DEFAULT 17
+    `);
+    await queryRunner.query(`
+      UPDATE freight.train_scheduling_global_rules
+        SET window_close_hour = 17
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3530000000000-ShippingLineInvoiceApprovals.ts b/apps/edr-freight-api/src/migrations/3530000000000-ShippingLineInvoiceApprovals.ts
new file mode 100644
index 000000000..4183be8ff
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3530000000000-ShippingLineInvoiceApprovals.ts
@@ -0,0 +1,78 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Maker–checker for manual actions on shipping-line credit invoices.
+ *
+ * A shipping-line credit invoice is normally settled by the CBE webhook. Two
+ * manual paths exist for finance: recording an offline payment (MARK_PAID)
+ * and voiding an invoice raised in error (CANCEL, which releases its credits
+ * back to the unbilled pool). Both erase or move real debt, so neither is a
+ * single-person action: one permission raises the request, a different
+ * permission — held by a chief, and never the requester themselves — approves
+ * or rejects it. Rows are never deleted; decided requests are the audit trail.
+ *
+ * One PENDING row per invoice at a time (partial unique index): a second
+ * request while one is undecided is a coordination failure, not a workflow.
+ */
+export class ShippingLineInvoiceApprovals3530000000000
+  implements MigrationInterface
+{
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DO $$ BEGIN
+        CREATE TYPE freight.shipping_line_invoice_approvals_action_enum
+          AS ENUM ('MARK_PAID', 'CANCEL');
+      EXCEPTION WHEN duplicate_object THEN NULL; END $$
+    `);
+
+    await queryRunner.query(`
+      DO $$ BEGIN
+        CREATE TYPE freight.shipping_line_invoice_approvals_status_enum
+          AS ENUM ('PENDING', 'APPROVED', 'REJECTED');
+      EXCEPTION WHEN duplicate_object THEN NULL; END $$
+    `);
+
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.shipping_line_invoice_approvals (
+        id uuid PRIMARY KEY DEFAULT uuid_generate_v4(),
+        invoice_id uuid NOT NULL REFERENCES freight.invoices (id),
+        action freight.shipping_line_invoice_approvals_action_enum NOT NULL,
+        status freight.shipping_line_invoice_approvals_status_enum NOT NULL DEFAULT 'PENDING',
+        requested_by uuid NOT NULL,
+        reason varchar(500) NOT NULL,
+        payment_reference varchar(255),
+        decided_by uuid,
+        decided_at timestamptz,
+        decision_note varchar(500),
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      )
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_sl_invoice_approvals_invoice_status
+        ON freight.shipping_line_invoice_approvals (invoice_id, status)
+    `);
+
+    // The workflow invariant, enforced where it cannot race: at most one
+    // undecided request per invoice.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_sl_invoice_approvals_one_pending
+        ON freight.shipping_line_invoice_approvals (invoice_id)
+        WHERE status = 'PENDING' AND deleted_at IS NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS freight.shipping_line_invoice_approvals`,
+    );
+    await queryRunner.query(
+      `DROP TYPE IF EXISTS freight.shipping_line_invoice_approvals_status_enum`,
+    );
+    await queryRunner.query(
+      `DROP TYPE IF EXISTS freight.shipping_line_invoice_approvals_action_enum`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3540000000000-EmptyReturnTrainLoad.ts b/apps/edr-freight-api/src/migrations/3540000000000-EmptyReturnTrainLoad.ts
new file mode 100644
index 000000000..55ef08262
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3540000000000-EmptyReturnTrainLoad.ts
@@ -0,0 +1,35 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Empty containers ride an export departure back to Djibouti, so a return now
+ * records which train schedule carries it and on which wagon slot. Size is
+ * captured too: the wagon rule is one 40ft OR two 20ft per wagon, which cannot
+ * be enforced without knowing the box size.
+ */
+export class EmptyReturnTrainLoad3540000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.empty_container_returns
+        ADD COLUMN IF NOT EXISTS container_size character varying(10),
+        ADD COLUMN IF NOT EXISTS train_schedule_id uuid,
+        ADD COLUMN IF NOT EXISTS wagon_sequence_no integer
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_empty_container_returns_train_schedule_id
+        ON freight.empty_container_returns (train_schedule_id)
+        WHERE train_schedule_id IS NOT NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DROP INDEX IF EXISTS freight.idx_empty_container_returns_train_schedule_id
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.empty_container_returns
+        DROP COLUMN IF EXISTS container_size,
+        DROP COLUMN IF EXISTS train_schedule_id,
+        DROP COLUMN IF EXISTS wagon_sequence_no
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3540000000000-FilterableListIndexes.ts b/apps/edr-freight-api/src/migrations/3540000000000-FilterableListIndexes.ts
new file mode 100644
index 000000000..1569b13d0
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3540000000000-FilterableListIndexes.ts
@@ -0,0 +1,56 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Supports the Stripe-style pill filter bar: every list it lands on filters
+ * and sorts server-side now. `@Index` decorators alone do nothing —
+ * `synchronize: false` means an index exists only if a migration created it
+ * (see the `RepairSynchronizeDrift`-style gaps this closes).
+ *
+ * `idx_warehouse_inventory_status` already exists (FreightBaseline). Bookings
+ * and wagons have no plain `status` index — `idx_bookings_route_day` and
+ * `idx_wagons_readiness` only cover `status` as a trailing/partial column,
+ * not a standalone `WHERE status = $1`, and `status` is the single
+ * most-filtered column on both lists (bookings: 37 values).
+ *
+ * `(created_at DESC, id ASC)` partials match the default sort + id
+ * tiebreaker `applySort` now appends everywhere, and none of these tables
+ * had a created_at index at all.
+ */
+export class FilterableListIndexes3540000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_bookings_status
+        ON freight.bookings USING btree (status)
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_wagons_status
+        ON freight.wagons USING btree (status)
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_contracts_created_at_id
+        ON freight.contracts (created_at DESC, id ASC) WHERE deleted_at IS NULL
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_bookings_created_at_id
+        ON freight.bookings (created_at DESC, id ASC) WHERE deleted_at IS NULL
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_warehouse_inventory_created_at_id
+        ON freight.warehouse_inventory (created_at DESC, id ASC) WHERE deleted_at IS NULL
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_wagons_created_at_id
+        ON freight.wagons (created_at DESC, id ASC) WHERE deleted_at IS NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.idx_wagons_created_at_id`);
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.idx_warehouse_inventory_created_at_id`);
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.idx_bookings_created_at_id`);
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.idx_contracts_created_at_id`);
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.idx_wagons_status`);
+    await queryRunner.query(`DROP INDEX IF EXISTS freight.idx_bookings_status`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3550000000000-EimsDebitCreditNotes.ts b/apps/edr-freight-api/src/migrations/3550000000000-EimsDebitCreditNotes.ts
new file mode 100644
index 000000000..cf36df757
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3550000000000-EimsDebitCreditNotes.ts
@@ -0,0 +1,28 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Debit/credit note filing — confirmed directly by MoR support: same `/v1/register` endpoint,
+ * distinguished by `DocumentDetails.Type` ("DEB"/"CRE") + a `Reason`, linked to the original
+ * invoice via `ReferenceDetails.RelatedDocument`. See `Invoice.eimsDocumentType`.
+ */
+export class EimsDebitCreditNotes3550000000000 implements MigrationInterface {
+  name = "EimsDebitCreditNotes3550000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      ADD COLUMN IF NOT EXISTS eims_document_type varchar(8) NOT NULL DEFAULT 'INV',
+      ADD COLUMN IF NOT EXISTS eims_reason text,
+      ADD COLUMN IF NOT EXISTS related_invoice_id uuid REFERENCES freight.invoices(id)
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      DROP COLUMN IF EXISTS eims_document_type,
+      DROP COLUMN IF EXISTS eims_reason,
+      DROP COLUMN IF EXISTS related_invoice_id
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3560000000000-ManualPaymentSettings.ts b/apps/edr-freight-api/src/migrations/3560000000000-ManualPaymentSettings.ts
new file mode 100644
index 000000000..0c4f5698f
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3560000000000-ManualPaymentSettings.ts
@@ -0,0 +1,36 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Single-row table controlling whether Finance may settle invoices by hand,
+ * per currency (see ManualPaymentSettingsService). Defaults preserve the
+ * pre-toggle behaviour: USD was always bank-transfer-only (ON), ETB manual
+ * settlement is the new capability and must be switched on deliberately (OFF).
+ */
+export class ManualPaymentSettings3560000000000 implements MigrationInterface {
+  name = "ManualPaymentSettings3560000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.manual_payment_settings (
+        id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        etb_enabled boolean NOT NULL DEFAULT false,
+        usd_enabled boolean NOT NULL DEFAULT true,
+        updated_by_id uuid,
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      );
+    `);
+    await queryRunner.query(`
+      INSERT INTO freight.manual_payment_settings (etb_enabled, usd_enabled)
+      SELECT false, true
+      WHERE NOT EXISTS (SELECT 1 FROM freight.manual_payment_settings);
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS freight.manual_payment_settings;`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3560000000000-YardPositions.ts b/apps/edr-freight-api/src/migrations/3560000000000-YardPositions.ts
new file mode 100644
index 000000000..102a5b85d
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3560000000000-YardPositions.ts
@@ -0,0 +1,47 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Which desks work at which yard — the input to yard access scoping.
+ *
+ * Many-to-many: a position (what the user-management tree calls a department)
+ * can cover several yards, and a yard is staffed by several positions. The
+ * scope resolver reads it to answer "which yards may this caller touch?".
+ *
+ * `yard_id` carries a real FK; `position_id` deliberately does NOT. Positions
+ * live in `iam`, which is owned by the vendored @tria-plc/iamapi-common package
+ * and shared with the passenger app: a hard FK would let freight block an IAM
+ * delete, and would have to be dropped the day IAM moves to its own database.
+ * Reads join `iam.positions … WHERE deleted_at IS NULL` instead, so a
+ * soft-deleted position silently drops out of scope rather than granting it.
+ *
+ * The unique index is PARTIAL — soft-deleted rows must not block re-adding the
+ * same pair later.
+ */
+export class YardPositions3560000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.yard_positions (
+        id          uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+        yard_id     uuid NOT NULL REFERENCES freight.yards(id) ON DELETE CASCADE,
+        position_id uuid NOT NULL,
+        created_at  timestamptz NOT NULL DEFAULT now(),
+        updated_at  timestamptz NOT NULL DEFAULT now(),
+        deleted_at  timestamptz
+      )
+    `);
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS ux_yard_positions_pair
+        ON freight.yard_positions (yard_id, position_id)
+        WHERE deleted_at IS NULL
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS ix_yard_positions_position
+        ON freight.yard_positions (position_id)
+        WHERE deleted_at IS NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE IF EXISTS freight.yard_positions`);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3570000000000-ConsolidationApprovals.ts b/apps/edr-freight-api/src/migrations/3570000000000-ConsolidationApprovals.ts
new file mode 100644
index 000000000..879c9b472
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3570000000000-ConsolidationApprovals.ts
@@ -0,0 +1,89 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Approval gate for consolidated (shared-wagon) bookings.
+ *
+ * A booking that fills its own wagons goes straight from GL completion to the
+ * operations queue. A CONSOLIDATED booking does not: it shares one physical
+ * wagon with another customer's booking, which means two customers' cargo, two
+ * invoices and two liabilities riding the same wagon. That pairing is a
+ * commercial decision, so it is reviewed by a person before Operations sees it.
+ *
+ * The pair is approved as a UNIT — one row covers both halves (booking_id +
+ * partner_booking_id) so an approver can never approve one side of a shared
+ * wagon and leave the other pending. Rows are never deleted; decided rows are
+ * the audit trail of who approved which pairing and when.
+ *
+ * One PENDING row per booking at a time (partial unique index on each side of
+ * the pair): a second request while one is undecided is a coordination failure,
+ * not a workflow.
+ */
+export class ConsolidationApprovals3570000000000 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DO $$ BEGIN
+        CREATE TYPE freight.consolidation_approvals_status_enum
+          AS ENUM ('PENDING', 'APPROVED', 'REJECTED');
+      EXCEPTION WHEN duplicate_object THEN NULL; END $$
+    `);
+
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS freight.consolidation_approvals (
+        id uuid PRIMARY KEY DEFAULT uuid_generate_v4(),
+        booking_id uuid NOT NULL REFERENCES freight.bookings (id),
+        partner_booking_id uuid NOT NULL REFERENCES freight.bookings (id),
+        status freight.consolidation_approvals_status_enum NOT NULL DEFAULT 'PENDING',
+        -- Who put the pairing up for review (the GL user who completed it) and
+        -- who decided it. Both are recorded: the point of the gate is that they
+        -- are different people.
+        requested_by uuid,
+        requested_at timestamptz NOT NULL DEFAULT now(),
+        decided_by uuid,
+        decided_at timestamptz,
+        decision_note varchar(500),
+        -- Snapshot of what was approved, so the audit trail still reads
+        -- correctly after the bookings themselves move on.
+        scheduled_date timestamptz,
+        booking_reference varchar(50),
+        partner_booking_reference varchar(50),
+        created_at timestamptz NOT NULL DEFAULT now(),
+        updated_at timestamptz NOT NULL DEFAULT now(),
+        deleted_at timestamptz
+      )
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_consolidation_approvals_booking_status
+        ON freight.consolidation_approvals (booking_id, status)
+    `);
+
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS idx_consolidation_approvals_status
+        ON freight.consolidation_approvals (status)
+    `);
+
+    // The workflow invariant, enforced where it cannot race: at most one
+    // undecided request per booking — on EITHER side of the pair, so the same
+    // wagon can never collect two pending requests from its two halves.
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_consolidation_approvals_one_pending
+        ON freight.consolidation_approvals (booking_id)
+        WHERE status = 'PENDING' AND deleted_at IS NULL
+    `);
+
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS uq_consolidation_approvals_one_pending_partner
+        ON freight.consolidation_approvals (partner_booking_id)
+        WHERE status = 'PENDING' AND deleted_at IS NULL
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS freight.consolidation_approvals`,
+    );
+    await queryRunner.query(
+      `DROP TYPE IF EXISTS freight.consolidation_approvals_status_enum`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3570000000000-YardViewAllPermission.ts b/apps/edr-freight-api/src/migrations/3570000000000-YardViewAllPermission.ts
new file mode 100644
index 000000000..0a53bd530
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3570000000000-YardViewAllPermission.ts
@@ -0,0 +1,54 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Seed `edr_freight_app:yards:view_all` — the cross-yard bypass for yard access
+ * scoping.
+ *
+ * The permission catalog is otherwise written by `EdrOrgSeeder`, which skips
+ * itself unless `SEED_EDR_ORG` is set. That flag is off in normal environments,
+ * so a key added to the registry never reaches `iam.permissions` and cannot be
+ * granted to anyone — the bypass would exist in code and be unusable in the
+ * database. A migration is the one path that runs everywhere.
+ *
+ * Idempotent on `key`, which is the identity every consumer resolves by (the
+ * registry's uuid is only used where a seed row needs one). Skips silently when
+ * the freight application row is absent, since there is nothing to attach to.
+ */
+export class YardViewAllPermission3570000000000 implements MigrationInterface {
+  private static readonly KEY = 'edr_freight_app:yards:view_all';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `INSERT INTO iam.permissions (id, key, name, application_id)
+       SELECT gen_random_uuid(),
+              $1::varchar,
+              '{"am": "Access every yard (bypass yard scoping)", "en": "Access every yard (bypass yard scoping)"}'::jsonb,
+              a.id
+         FROM iam.application a
+        WHERE a.key = 'edr_freight_app'
+          AND NOT EXISTS (SELECT 1 FROM iam.permissions p WHERE p.key = $1::varchar)`,
+      [YardViewAllPermission3570000000000.KEY],
+    );
+  }
+
+  /**
+   * Removes only the permission row itself. Any grant of it goes first, or the
+   * delete trips the position/role permission foreign keys — and a half-removed
+   * permission is worse than one left in place.
+   */
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DELETE FROM iam.position_permissions
+        WHERE permission_id IN (SELECT id FROM iam.permissions WHERE key = $1)`,
+      [YardViewAllPermission3570000000000.KEY],
+    );
+    await queryRunner.query(
+      `DELETE FROM iam.role_permissions
+        WHERE permission_id IN (SELECT id FROM iam.permissions WHERE key = $1)`,
+      [YardViewAllPermission3570000000000.KEY],
+    );
+    await queryRunner.query(`DELETE FROM iam.permissions WHERE key = $1`, [
+      YardViewAllPermission3570000000000.KEY,
+    ]);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3580000000000-EimsBulkRegistration.ts b/apps/edr-freight-api/src/migrations/3580000000000-EimsBulkRegistration.ts
new file mode 100644
index 000000000..140a7ad6a
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3580000000000-EimsBulkRegistration.ts
@@ -0,0 +1,35 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+/**
+ * Columns for `POST /v1/bulkRegister` — see `EimsBulkRegistrationService`.
+ *
+ * `eims_system_state.in_flight_conversation_id` is the bulk equivalent of `in_flight_invoice_id`:
+ * a whole batch, not one invoice, is what's outstanding while MoR processes it asynchronously.
+ * `invoices.eims_bulk_conversation_id` tags which batch an invoice was submitted in, so a stuck
+ * batch (webhook never arrived) can be found and reconciled by conversation id.
+ */
+export class EimsBulkRegistration3580000000000 implements MigrationInterface {
+  name = "EimsBulkRegistration3580000000000";
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.eims_system_state
+      ADD COLUMN IF NOT EXISTS in_flight_conversation_id text
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      ADD COLUMN IF NOT EXISTS eims_bulk_conversation_id text
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE freight.eims_system_state
+      DROP COLUMN IF EXISTS in_flight_conversation_id
+    `);
+    await queryRunner.query(`
+      ALTER TABLE freight.invoices
+      DROP COLUMN IF EXISTS eims_bulk_conversation_id
+    `);
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3590000000000-BookingClearanceCharge.ts b/apps/edr-freight-api/src/migrations/3590000000000-BookingClearanceCharge.ts
new file mode 100644
index 000000000..042e47554
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3590000000000-BookingClearanceCharge.ts
@@ -0,0 +1,46 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Post-finalization clearance charges billed to the customer: one PORT_CHARGES
+ * and one MISCELLANEOUS row max per booking, each carrying a document, amount,
+ * currency and its own payable invoice.
+ */
+export class BookingClearanceCharge3590000000000 implements MigrationInterface {
+  name = 'BookingClearanceCharge3590000000000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS "freight"."booking_clearance_charge" (
+        "id" uuid NOT NULL DEFAULT uuid_generate_v4(),
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz,
+        "booking_id" uuid NOT NULL,
+        "type" character varying(20) NOT NULL,
+        "status" character varying(20) NOT NULL DEFAULT 'DOC_UPLOADED',
+        "file_record_id" uuid,
+        "amount" numeric(14,2),
+        "currency" character varying(8),
+        "invoice_id" uuid,
+        "uploaded_by_staff_id" uuid,
+        "uploaded_at" timestamptz,
+        "billed_by_staff_id" uuid,
+        "billed_at" timestamptz,
+        "paid_at" timestamptz,
+        CONSTRAINT "pk_booking_clearance_charge" PRIMARY KEY ("id"),
+        CONSTRAINT "fk_booking_clearance_charge_booking" FOREIGN KEY ("booking_id")
+          REFERENCES "freight"."bookings"("id") ON DELETE CASCADE
+      )
+    `);
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX IF NOT EXISTS "uq_booking_clearance_charge_booking_type"
+        ON "freight"."booking_clearance_charge" ("booking_id", "type")
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS "freight"."booking_clearance_charge"`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/migrations/3600000000000-BookingClearanceEvent.ts b/apps/edr-freight-api/src/migrations/3600000000000-BookingClearanceEvent.ts
new file mode 100644
index 000000000..ce7ef49ed
--- /dev/null
+++ b/apps/edr-freight-api/src/migrations/3600000000000-BookingClearanceEvent.ts
@@ -0,0 +1,37 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/** Per-booking clearance action history — drives the History tab. */
+export class BookingClearanceEvent3600000000000 implements MigrationInterface {
+  name = 'BookingClearanceEvent3600000000000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS "freight"."booking_clearance_event" (
+        "id" uuid NOT NULL DEFAULT uuid_generate_v4(),
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz,
+        "booking_id" uuid NOT NULL,
+        "action" character varying(64) NOT NULL,
+        "label" character varying(500) NOT NULL,
+        "actor_type" character varying(16) NOT NULL DEFAULT 'STAFF',
+        "actor_id" uuid,
+        "actor_name" character varying(150),
+        "metadata" jsonb,
+        CONSTRAINT "pk_booking_clearance_event" PRIMARY KEY ("id"),
+        CONSTRAINT "fk_booking_clearance_event_booking" FOREIGN KEY ("booking_id")
+          REFERENCES "freight"."bookings"("id") ON DELETE CASCADE
+      )
+    `);
+    await queryRunner.query(`
+      CREATE INDEX IF NOT EXISTS "idx_booking_clearance_event_booking_created"
+        ON "freight"."booking_clearance_event" ("booking_id", "created_at")
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(
+      `DROP TABLE IF EXISTS "freight"."booking_clearance_event"`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/audit/audit-actor.ts b/apps/edr-freight-api/src/modules/audit/audit-actor.ts
new file mode 100644
index 000000000..f89a7ee26
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/audit-actor.ts
@@ -0,0 +1,84 @@
+/**
+ * Who acted, and does this API audit them?
+ *
+ * The staff/customer split reuses the exact discriminator the permission guards
+ * already apply (`freight-permission.guard.ts`): `userType === 'employee'` is
+ * backoffice, `individual` / `external_organization` are customers. Restating
+ * the rule instead of importing it would let the two drift apart silently.
+ */
+
+const EMPLOYEE_USER_TYPE = 'employee';
+const SUPER_ADMIN_ROLE = 'super_admin';
+
+/** The subset of the JWT payload this module reads. */
+export interface AuditActorSource {
+  id?: string;
+  sub?: string;
+  userType?: string;
+  username?: string;
+  name?: string | { en?: string; am?: string };
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  roles?: { key?: string; name?: string }[];
+  employee?: unknown;
+}
+
+export interface AuditActor {
+  userId: string | null;
+  userName: string | null;
+  userRole: string | null;
+}
+
+function isSuperAdmin(user: AuditActorSource): boolean {
+  return Boolean(user.roles?.some((role) => role.key === SUPER_ADMIN_ROLE));
+}
+
+/**
+ * Is this caller a backoffice user whose actions are audited?
+ *
+ * Only employees qualify. Customers are excluded by request, and unauthenticated
+ * callers are excluded too — which means failed logins, OTP sends and password
+ * resets produce no audit rows. That was a deliberate call: those endpoints are
+ * not backoffice actions. Note the trade-off, since failed-auth attempts are
+ * often what an incident review looks for first.
+ */
+export function isAuditableActor(user: AuditActorSource | null | undefined): boolean {
+  if (!user) return false;
+  // Super admins may not carry an `employee` userType on every token, but are
+  // unambiguously staff — the permission guards treat them the same way.
+  return user.userType === EMPLOYEE_USER_TYPE || isSuperAdmin(user);
+}
+
+/** Best-effort display name, tolerating the several shapes tokens use. */
+function resolveUserName(user: AuditActorSource): string | null {
+  if (typeof user.name === 'string' && user.name.trim()) return user.name.trim();
+
+  if (user.name && typeof user.name === 'object') {
+    const localized = user.name.en ?? user.name.am;
+    if (localized?.trim()) return localized.trim();
+  }
+
+  const composed = [user.firstName, user.lastName].filter(Boolean).join(' ').trim();
+  if (composed) return composed;
+
+  return user.username?.trim() || user.email?.trim() || null;
+}
+
+/**
+ * Snapshot the actor at the moment of the action.
+ *
+ * Name and role are copied, never referenced: resolving them from IAM at read
+ * time would rewrite history whenever someone is renamed, changes role or is
+ * deleted. An audit row from last year must still say who acted and with what
+ * authority *then*.
+ */
+export function resolveAuditActor(user: AuditActorSource): AuditActor {
+  const roleKey = user.roles?.[0]?.key ?? user.roles?.[0]?.name ?? null;
+
+  return {
+    userId: user.id ?? user.sub ?? null,
+    userName: resolveUserName(user),
+    userRole: roleKey,
+  };
+}
diff --git a/apps/edr-freight-api/src/modules/audit/audit-endpoint-matcher.ts b/apps/edr-freight-api/src/modules/audit/audit-endpoint-matcher.ts
new file mode 100644
index 000000000..75ae51fa6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/audit-endpoint-matcher.ts
@@ -0,0 +1,140 @@
+import { AUDIT_ENDPOINTS, type AuditEndpointMeta } from './audit-endpoints';
+
+/** What a matched request resolved to. */
+export interface MatchedAuditEndpoint {
+  /** Human-readable action, e.g. "Approve contract". */
+  title: string;
+  /** Primary entity, e.g. "Contract". */
+  type: string;
+  /** The route template, e.g. `/api/contracts/:id/cancel`. */
+  routePath: string;
+  /** First path parameter of the template, when the route has one. */
+  resourceId: string | null;
+}
+
+interface CompiledRoute {
+  regex: RegExp;
+  /** Param names in capture-group order, e.g. ['id', 'stepId']. */
+  paramNames: string[];
+  routePath: string;
+  meta: AuditEndpointMeta;
+  /** Literal (non-parameter) segment count — used to rank specificity. */
+  staticSegments: number;
+}
+
+const ESCAPE_REGEX = /[.*+?^${}()|[\]\\]/g;
+
+/**
+ * Two keys in AUDIT_ENDPOINTS point at the same path: one route is declared by
+ * two different controllers, so the generator suffixed the second with
+ * ` [modules/...controller.ts]` to keep both entries. Only the path itself is
+ * matchable, so the suffix is stripped here.
+ */
+function stripSourceSuffix(key: string): string {
+  const bracket = key.indexOf(' [');
+  return bracket === -1 ? key : key.slice(0, bracket);
+}
+
+/**
+ * Compile one `"/api/contracts/:id/cancel"` template into an anchored regex.
+ *
+ * A parameter matches a single path segment only (`[^/]+`), so
+ * `/api/contracts/:id` cannot swallow `/api/contracts/:id/cancel`.
+ */
+function compileTemplate(path: string): { regex: RegExp; paramNames: string[] } {
+  const paramNames: string[] = [];
+  const pattern = path
+    .split('/')
+    .map((segment) => {
+      if (!segment.startsWith(':')) {
+        return segment.replace(ESCAPE_REGEX, '\\$&');
+      }
+      paramNames.push(segment.slice(1));
+      return '([^/]+)';
+    })
+    .join('/');
+
+  return { regex: new RegExp(`^${pattern}$`), paramNames };
+}
+
+/**
+ * Method-bucketed lookup table for the audited routes.
+ *
+ * A direct `AUDIT_ENDPOINTS[url]` lookup cannot work: the keys are templates
+ * with `:params` while a live request carries real ids and a query string, so
+ * every parameterized route — most of the 488 — would miss. Templates are
+ * compiled to regexes once at module load and matched per request.
+ *
+ * Within a method, routes are ordered by literal-segment count descending, so
+ * a specific route always wins over a parameterized one that could also match
+ * (`/api/routes/:id/permanent` before `/api/routes/:id`).
+ */
+class AuditEndpointMatcher {
+  private readonly byMethod = new Map<string, CompiledRoute[]>();
+
+  constructor() {
+    for (const [key, meta] of Object.entries(AUDIT_ENDPOINTS)) {
+      const [method, rawPath] = stripSourceSuffix(key).split(' ');
+      if (!method || !rawPath) continue;
+
+      const { regex, paramNames } = compileTemplate(rawPath);
+      const bucket = this.byMethod.get(method) ?? [];
+      bucket.push({
+        regex,
+        paramNames,
+        routePath: rawPath,
+        meta,
+        staticSegments: rawPath
+          .split('/')
+          .filter((s) => s && !s.startsWith(':')).length,
+      });
+      this.byMethod.set(method, bucket);
+    }
+
+    for (const bucket of this.byMethod.values()) {
+      bucket.sort((a, b) => b.staticSegments - a.staticSegments);
+    }
+  }
+
+  /**
+   * Resolve a live request to its audit metadata, or null when the route is
+   * not audited (every GET, and anything absent from AUDIT_ENDPOINTS).
+   *
+   * `url` may include a query string; it is ignored for matching.
+   */
+  match(method: string, url: string): MatchedAuditEndpoint | null {
+    const bucket = this.byMethod.get(method.toUpperCase());
+    if (!bucket) return null;
+
+    const path = stripQuery(url);
+
+    for (const route of bucket) {
+      const result = route.regex.exec(path);
+      if (!result) continue;
+
+      const [title, , type] = route.meta;
+      return {
+        title,
+        type,
+        routePath: route.routePath,
+        // The first path parameter is the affected record in this API's
+        // conventions (`/api/contracts/:id/...`). Routes with no parameter
+        // (a create) legitimately have no resource id yet.
+        resourceId: route.paramNames.length > 0 ? result[1] : null,
+      };
+    }
+
+    return null;
+  }
+}
+
+/** Strip query string and hash from a URL, leaving the path. */
+export function stripQuery(url: string): string {
+  const queryIndex = url.indexOf('?');
+  const path = queryIndex === -1 ? url : url.slice(0, queryIndex);
+  const hashIndex = path.indexOf('#');
+  return hashIndex === -1 ? path : path.slice(0, hashIndex);
+}
+
+/** Compiled once at module load and shared by the interceptor. */
+export const auditEndpointMatcher = new AuditEndpointMatcher();
diff --git a/apps/edr-freight-api/src/modules/audit/audit-endpoints.ts b/apps/edr-freight-api/src/modules/audit/audit-endpoints.ts
new file mode 100644
index 000000000..deda35e1c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/audit-endpoints.ts
@@ -0,0 +1,689 @@
+/**
+ * Freight API — every state-changing endpoint (POST / PUT / PATCH / DELETE).
+ *
+ * Shape:  "<METHOD> <path>": [title, method, entity]
+ *
+ * Keyed by method + path rather than path alone: 50 paths serve more than one
+ * method (PATCH and DELETE on /api/contracts/:id, for example), so a path-only
+ * key would collide and drop those endpoints.
+ *
+ * Paths include the global prefix `api` (see app.setGlobalPrefix in src/main.ts).
+ * Titles come from each route's @ApiOperation summary, falling back to a
+ * humanized handler name where a route has none.
+ *
+ * Excludes the AI Assist and Account entities.
+ * Generated from the controllers under src/ — 517 endpoints.
+ */
+/** [title, method, entity] for one auditable route. */
+export type AuditEndpointMeta = readonly [title: string, method: string, entity: string];
+
+export const AUDIT_ENDPOINTS: Readonly<Record<string, AuditEndpointMeta>> = {
+  // Approval Rule
+  "POST /api/approval-rules": ["Create an approval rule step", "POST", "Approval Rule"],
+  "PATCH /api/approval-rules/:id": ["Update an approval rule", "PATCH", "Approval Rule"],
+  "DELETE /api/approval-rules/:id": ["Soft-delete an approval rule", "DELETE", "Approval Rule"],
+  "POST /api/approval-rules/:id/move-order": ["Move an approval step up or down within its chain", "POST", "Approval Rule"],
+  "POST /api/approval-rules/reorder": ["Bulk reorder approval steps within a chain", "POST", "Approval Rule"],
+
+  // Booking
+  "POST /api/bookings": ["Create a new freight booking (DRAFT)", "POST", "Booking"],
+  "POST /api/bookings/:bookingId/allocate-containers": ["Allocate containers to vehicles", "POST", "Booking"],
+  "PATCH /api/bookings/:id": ["Update booking", "PATCH", "Booking"],
+  "DELETE /api/bookings/:id": ["Soft-delete DRAFT booking", "DELETE", "Booking"],
+  "POST /api/bookings/:id/cancel": ["Cancel booking", "POST", "Booking"],
+  "POST /api/bookings/:id/cancel-hold": ["Customer cancels an unpaid hold (SELECTED_FOR_BATCH → CANCELLED);", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/declaration": ["GL ET uploads customs declaration on booking (GENERAL customs)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/delivery-order": ["Upload Booking Delivery Order", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/documents": ["Customer uploads clearance documents (fieldname = document key)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/draft-declaration": ["GL ET sends a draft customs declaration (multi-file) with an estimated price for the customer to review", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/draft-declaration/accept": ["Customer accepts the draft customs declaration — unlocks the real customs declaration step for GL Ethiopia", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/draft-declaration/change": ["Customer requests a change to the draft customs declaration with a reason — GL Ethiopia sends a corrected draft (repeatable)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/duty": ["GL ET sets duty/tax on booking with notice attachment", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/duty-slip": ["Customer uploads duty/tax payment slip on booking", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/export-release": ["Confirm Booking Export Release", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/finalize": ["GL finalizes clearance (requires 100% approved) → CLEARANCE_READY", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/finalize-pre-clearance": ["GL ET finalizes import pre-clearance on booking", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/output-documents": ["GL uploads customs output documents (IM4/EX3/…)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/proceed": ["Customer requests operation with a schedule day", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/release-order": ["Upload Booking Release Order", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/review": ["GL reviews a clearance document (Approve | Query)", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/charges/port-document": ["GL Djibouti uploads the port-charges document", "POST", "Booking"],
+  "PATCH /api/bookings/:id/clearance/charges/:chargeId/bill": ["GL Ethiopia sets or revises a clearance charge's amount + currency", "PATCH", "Booking"],
+  "POST /api/bookings/:id/clearance/charges/:chargeId/send": ["GL Ethiopia issues the clearance charge invoice to the customer", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/charges/miscellaneous": ["GL Ethiopia creates the miscellaneous clearance charge", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/ro-amendment": ["Request Booking RO Amendment", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/transit-assignee/assign": ["GL Djibouti picks the transit officer from the roster — unblocks the customs declaration; calling again reassigns", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/transit-assignee/request": ["GL ET asks GL Djibouti to name the transit officer — required before the import customs declaration", "POST", "Booking"],
+  "POST /api/bookings/:id/clearance/transit-permit": ["Upload Booking Transit Permit", "POST", "Booking"],
+  "POST /api/bookings/:id/confirm-submit": ["Confirm submit after price change", "POST", "Booking"],
+  "POST /api/bookings/:id/consolidation": ["Request freight consolidation", "POST", "Booking"],
+  "DELETE /api/bookings/:id/consolidation": ["Remove consolidation pairing", "DELETE", "Booking"],
+  "POST /api/bookings/:id/contract/generate": ["Generate contract PDF from template", "POST", "Booking"],
+  "POST /api/bookings/:id/contract/sign": ["Apply digital signature (customer or staff)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-cancel": ["Customer cancels their own booking before payment — no cancellation fee", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-truck-assignment": ["Customer assigns external truck and driver for terminal pickup", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-trucks": ["Add a customer self-haul truck carrying 1–2 of the booking containers", "POST", "Booking"],
+  "PATCH /api/bookings/:id/customer-trucks/:assignmentId": ["Edit a not-yet-arrived customer truck (plate/driver/type + containers)", "PATCH", "Booking"],
+  "DELETE /api/bookings/:id/customer-trucks/:assignmentId": ["Remove a not-yet-arrived customer truck from a booking", "DELETE", "Booking"],
+  "POST /api/bookings/:id/customer-trucks/:assignmentId/depart": ["Register an import truck leaving: containers loaded + weighed gross (staff)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-trucks/:assignmentId/load": ["Truck_dispatch: load selected containers onto a truck (staff)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer-trucks/bulk": ["Bulk add customer trucks from array payload (Excel parsed)", "POST", "Booking"],
+  "POST /api/bookings/:id/customer/sign": ["Customer digital signature (deprecated — use POST contract/sign)", "POST", "Booking"],
+  "POST /api/bookings/:id/documents": ["Upload documents for a booking (DRAFT only)", "POST", "Booking"],
+  "PATCH /api/bookings/:id/export-handover-mode": ["Export only: choose direct truck-to-train (no warehouse, no GRN) or warehouse first", "PATCH", "Booking"],
+  "POST /api/bookings/:id/generate-grn": ["Generate a GRN over the received containers (all received, or a subset) — one GRN per batch", "POST", "Booking"],
+  "POST /api/bookings/:id/generate-price": ["Generate price preview (DRAFT or CHANGES_REQUESTED)", "POST", "Booking"],
+  "POST /api/bookings/:id/government-expedite": ["Expedite government booking to PAID / ELIGIBLE for scheduling", "POST", "Booking"],
+  "POST /api/bookings/:id/marketing/approve": ["Staff contract signature and fully execute (use contract/sign STAFF preferred)", "POST", "Booking"],
+  "POST /api/bookings/:id/operation/review": ["Operations reviews an operation request: ACCEPT (→ batch pool),", "POST", "Booking"],
+  "POST /api/bookings/:id/operations/complete": ["Mark completed", "POST", "Booking"],
+  "POST /api/bookings/:id/operations/start-transit": ["Mark in transit", "POST", "Booking"],
+  "POST /api/bookings/:id/reject": ["Customer reject price estimate", "POST", "Booking"],
+  "POST /api/bookings/:id/staff/accept": ["Staff accept intake → set contract validity window + start approval chain", "POST", "Booking"],
+  "POST /api/bookings/:id/staff/reject": ["Staff final reject", "POST", "Booking"],
+  "POST /api/bookings/:id/staff/request-changes": ["Staff return booking for customer updates", "POST", "Booking"],
+  "POST /api/bookings/:id/submit": ["Customer submit booking", "POST", "Booking"],
+  "POST /api/bookings/:id/wagon-cancellations": ["Request a partial wagon cancellation on a PAID booking — opens the cancellation-fee invoice; wagons are released only once the fee settles", "POST", "Booking"],
+  "POST /api/bookings/:id/wagon-cancellations/preview": ["Preview the fee/credit of a partial wagon cancellation (no writes)", "POST", "Booking"],
+  "POST /api/bookings/wagon-cancellations/:cancellationId/rebook": ["Rebook a wagon-cancellation credit: pick a shipment day only — the new booking is created under the contract and marked PAID (freight already paid; contract must still be valid)", "POST", "Booking"],
+  "POST /api/bookings/wagon-cancellations/:cancellationId/withdraw": ["Withdraw a fee-pending wagon cancellation (owner, or staff with the void permission)", "POST", "Booking"],
+  "POST /api/bookings/consolidation-approvals/:approvalId/approve": ["Approve a shared wagon: both bookings leave the gate and continue to Operations together.", "POST", "Booking"],
+  "POST /api/bookings/consolidation-approvals/:approvalId/reject": ["Reject a shared wagon: both bookings go back to GL for changes with the reason.", "POST", "Booking"],
+  "POST /api/bookings/:id/paired-decision": ["Apply a staff decision (accept / cancel / operationAccept / requestChanges) to BOTH halves of a consolidated pair, all-or-nothing.", "POST", "Booking"],
+
+  // Cargo
+  "POST /api/cargoes": ["Create a new cargo", "POST", "Cargo"],
+  "PATCH /api/cargoes/:id": ["Update a cargo", "PATCH", "Cargo"],
+  "DELETE /api/cargoes/:id": ["Delete a cargo", "DELETE", "Cargo"],
+  "POST /api/cargoes/:id/deliver": ["Mark cargo as delivered", "POST", "Cargo"],
+  "POST /api/cargoes/:id/load": ["Load cargo into a container", "POST", "Cargo"],
+  "POST /api/cargoes/:id/unload": ["Unload cargo from container", "POST", "Cargo"],
+
+  // Cargo Type
+  "POST /api/cargo-types": ["Create a cargo type", "POST", "Cargo Type"],
+  "PATCH /api/cargo-types/:id": ["Update a cargo type", "PATCH", "Cargo Type"],
+  "DELETE /api/cargo-types/:id": ["Soft-delete a cargo type", "DELETE", "Cargo Type"],
+  "POST /api/cargo-types/:id/move-order": ["Move a cargo type up or down in display order", "POST", "Cargo Type"],
+  "POST /api/cargo-types/reorder": ["Bulk reorder cargo types by ID list", "POST", "Cargo Type"],
+
+  // Chat
+  "POST /api/chat/sync": ["Re-run the chat room/membership reconcile immediately (normally nightly)", "POST", "Chat"],
+
+  // Company
+  "POST /api/companies": ["Create a new company (customer, freight_forwarder, dj_freight_forwarder, transporter)", "POST", "Company"],
+  "POST /api/companies/:companyId/documents": ["Upload documents for a company (onboarding)", "POST", "Company"],
+  "POST /api/companies/:companyId/profiles": ["Add a profile (employee) to a company", "POST", "Company"],
+  "PATCH /api/companies/:id": ["Update a company", "PATCH", "Company"],
+  "DELETE /api/companies/:id": ["Soft-delete a company", "DELETE", "Company"],
+  "POST /api/companies/change-requests/:id/approve": ["Approve a pending profile change request (applies the changes)", "POST", "Company"],
+  "POST /api/companies/change-requests/:id/reject": ["Reject a pending profile change request with a note", "POST", "Company"],
+  "POST /api/companies/change-requests/:id/request-changes": ["Ask for specific changes on a pending request without rejecting it (row stays open, next edit appends to it)", "POST", "Company"],
+  "POST /api/companies/company-profile": ["Create a single operational profile for the current user's company. The role starts pending and does not become the active mode", "POST", "Company"],
+  "POST /api/companies/company-profiles": ["Add operational profile(s) (importer/exporter/forwarder) to the current user's company", "POST", "Company"],
+  "POST /api/companies/company-profiles/:profileId/license": ["Add business-license document(s) to a profile. For an approved company", "POST", "Company"],
+  "DELETE /api/companies/company-profiles/:profileId/license/:fileId": ["Remove a business-license file (staged for review on an approved company)", "DELETE", "Company"],
+  "POST /api/companies/company-profiles/:profileId/license/:fileId/replace": ["Replace a business-license file with a newly uploaded one (staged for", "POST", "Company"],
+  "POST /api/companies/company-profiles/:profileId/reapply": ["Resubmit a rejected operational role for approval (→ pending)", "POST", "Company"],
+  "PATCH /api/companies/company-profiles/:profileId/status": ["Update a company profile's approval status", "PATCH", "Company"],
+  "POST /api/companies/create": ["Create a company with its associated external profile (onboarding)", "POST", "Company"],
+  "POST /api/companies/documents/:fileId/request-change": ["Ask the customer to correct one uploaded document", "POST", "Company"],
+  "POST /api/companies/fetch-etrade-info": ["Fetch company info from eTrade by TIN", "POST", "Company"],
+  "POST /api/companies/identity/fayda/complete": ["Bind a completed Fayda verification to the company's owner or Power of Attorney", "POST", "Company"],
+  "PATCH /api/companies/onboarding-step": ["Persist the user's current onboarding wizard step", "PATCH", "Company"],
+  "POST /api/companies/onboarding/complete": ["Mark the current user's onboarding as complete", "POST", "Company"],
+  "POST /api/companies/onboarding/start": ["Begin onboarding: create a draft company + profile + role(s) so later steps can save incrementally", "POST", "Company"],
+  "POST /api/companies/poa-delegation": ["Upload the Power of Attorney delegation letter, replacing any existing one", "POST", "Company"],
+  "DELETE /api/companies/poa-delegation/:fileId": ["Remove the Power of Attorney delegation letter (staged for review on an approved company)", "DELETE", "Company"],
+  "PATCH /api/companies/profile": ["Update profile (flattened settings page)", "PATCH", "Company"],
+  "PATCH /api/companies/identity/poa-declared": ["Answer whether anyone holds power of attorney for this company — the question that decides whose identity is verified.", "PATCH", "Company"],
+  "POST /api/companies/onboarding/revert-to-etrade": ["Drop the manual-registration route (co-operative or foreign investment licence): clear the typed registration and reopen onboarding so the TIN is verified against eTrade", "POST", "Company"],
+
+  // Compliance
+  "POST /api/compliance": ["Create a compliance record", "POST", "Compliance"],
+  "PATCH /api/compliance/:id": ["Update a compliance record", "PATCH", "Compliance"],
+  "DELETE /api/compliance/:id": ["Soft-delete a compliance record", "DELETE", "Compliance"],
+
+  // Consignment
+  "POST /api/consignments": ["Create a new consignment", "POST", "Consignment"],
+
+  // Container
+  "POST /api/containers": ["Create a new container", "POST", "Container"],
+  "PATCH /api/containers/:id": ["Update a container", "PATCH", "Container"],
+  "DELETE /api/containers/:id": ["Delete a container", "DELETE", "Container"],
+  "POST /api/containers/:id/assign-wagon": ["Assign container to a wagon", "POST", "Container"],
+  "POST /api/containers/:id/unassign-wagon": ["Unassign container from wagon", "POST", "Container"],
+
+  // Container Type
+  "POST /api/container-types": ["Create a container type", "POST", "Container Type"],
+  "PATCH /api/container-types/:id": ["Update a container type", "PATCH", "Container Type"],
+  "DELETE /api/container-types/:id": ["Soft-delete a container type", "DELETE", "Container Type"],
+  "POST /api/container-types/:id/move-order": ["Move a container type up or down in display order", "POST", "Container Type"],
+  "POST /api/container-types/reorder": ["Bulk reorder container types by ID list", "POST", "Container Type"],
+
+  // Contract
+  "POST /api/contracts": ["Create a new contract (DRAFT) with routes + cargo scope", "POST", "Contract"],
+  "PATCH /api/contracts/:id": ["Update contract", "PATCH", "Contract"],
+  "DELETE /api/contracts/:id": ["Soft-delete DRAFT contract", "DELETE", "Contract"],
+  "POST /api/contracts/:id/approval-steps/:stepId/approve": ["Approve one approval step in sequence", "POST", "Contract"],
+  "POST /api/contracts/:id/approval-steps/:stepId/reject": ["Reject one approval step — to the customer (terminal → REJECTED) or, via returnToStepId, back to an earlier approver (chain re-runs from there)", "POST", "Contract"],
+  "POST /api/contracts/:id/booking-requests": ["Customer submits a shipment request on a GENERAL customs contract", "POST", "Contract"],
+  "POST /api/contracts/:id/bookings": ["Create a shipment booking under a contract — Path A (customer) or Path B (GL Ethiopia)", "POST", "Contract"],
+  "POST /api/contracts/:id/bookings/:bookingId/complete": ["Complete an initiated booking after Operations finalized its clearance — cargo + binding day, window and departure checks, pricing and invoicing", "POST", "Contract"],
+  "POST /api/contracts/:id/bookings/initiate": ["Initiate a bare booking instance under an import/export contract (ONE_TIME or GENERAL) — no cargo, no date; enters per-booking clearance (AWAITING_DOCUMENTS). ONE_TIME customs instances are opened by the customer (or GL); GENERAL customs comes from a shipment request", "POST", "Contract"],
+  "POST /api/contracts/:id/cancel": ["Customer cancels their own contract (blocked while a booking is live)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/declaration": ["GL ET uploads customs declaration documents (multi-file)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/delivery-order": ["GL DJ uploads Delivery Order (import) with vessel arrival + DO collected dates", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/documents": ["Customer uploads clearance documents (fieldname = document key)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/documents/:fileKey/replace": ["GL replaces a clearance document in place (reason required) — the previous version is kept in the file history and the new one needs approving", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/duty": ["GL ET sets duty/tax requirement and advises amount with notice attachment", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/duty-slip": ["Customer uploads duty/tax payment slip on contract", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/duty/dispute": ["Customer disputes the advised duty/tax with a reason — reopens the step so GL Ethiopia can re-advise (repeatable)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/export-release": ["GL ET confirms export release after declaration", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/finalize": ["GL ET finalizes clearance → CLEARANCE_READY_FOR_BOOKING (legacy)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/finalize-export-clearance": ["GL ET finalizes export clearance after post-booking transit permit upload", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/finalize-pre-clearance": ["GL ET finalizes import pre-clearance — unlocks Djibouti DO upload", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/ops-finalize": ["Operations finalizes self-clearance → customer may create the booking", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/ops-review": ["Operations reviews a customer self-clearance document (Approve | Query)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/output-documents": ["GL uploads customs output documents (IM4/EX3/…) pre-booking", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/release-order": ["GL DJ uploads Release Order + vessel departure date (export)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/review": ["GL ET reviews a clearance document (Approve | Query)", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/ro-amendment": ["GL DJ requests port amendment when RO vessel window is too short", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/transit-assignee/assign": ["GL Djibouti picks the transit officer from the roster — unblocks the customs declaration; calling again reassigns", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/transit-assignee/request": ["GL ET asks GL Djibouti to name the transit officer — required before the customs declaration", "POST", "Contract"],
+  "POST /api/contracts/:id/clearance/transit-permit": ["GL ET uploads import transit permit documents (multi-file)", "POST", "Contract"],
+  "POST /api/contracts/:id/confirm-submit": ["Confirm submit after a price change", "POST", "Contract"],
+  "POST /api/contracts/:id/contract/generate": ["Generate contract document → CONTRACT_READY", "POST", "Contract"],
+  "POST /api/contracts/:id/contract/send-signing-otp": ["Send the sudo-mode signing OTP to the contract company's registered phone (server picks the number)", "POST", "Contract"],
+  "POST /api/contracts/:id/contract/sign": ["Apply digital signature (customer or staff/director/ceo)", "POST", "Contract"],
+  "PUT /api/contracts/:id/document/articles": ["Edit this contract\\'s document articles only (per-contract; never touches the six shared templates)", "PUT", "Contract"],
+  "POST /api/contracts/:id/documents": ["Upload intake documents for a contract (DRAFT only)", "POST", "Contract"],
+  "POST /api/contracts/:id/generate-price": ["Generate unit-rate breakdown (no totals at contract phase)", "POST", "Contract"],
+  "POST /api/contracts/:id/milestones/:code/complete": ["GL marks a pre-booking (contract) milestone complete", "POST", "Contract"],
+  "POST /api/contracts/:id/renew": ["Create a renewal draft linked via renewalOfId", "POST", "Contract"],
+  "POST /api/contracts/:id/resume": ["Staff lift a suspension — contract returns to its prior status", "POST", "Contract"],
+  "POST /api/contracts/:id/staff/accept": ["Staff accept → set validity window + start approval chain", "POST", "Contract"],
+  "POST /api/contracts/:id/staff/reject": ["Staff reject contract", "POST", "Contract"],
+  "POST /api/contracts/:id/staff/request-changes": ["Staff return contract for customer updates", "POST", "Contract"],
+  "POST /api/contracts/:id/submit": ["Customer submit contract (freezes contract_rate_snapshots)", "POST", "Contract"],
+  "POST /api/contracts/:id/suspend": ["Staff freeze a signed contract (reversible, any post-signature step)", "POST", "Contract"],
+  "POST /api/contracts/:id/validate-shipment": ["Pre-create validation + authoritative price preview: full booking price breakdown (rail, first/last mile, surcharges), overweight lines and 20ft weight-pairing errors for a shipment payload (no booking created)", "POST", "Contract"],
+  "POST /api/contracts/booking-requests/:reqId/accept": ["GL marks a shipment request accepted + links the created booking", "POST", "Contract"],
+  "POST /api/contracts/booking-requests/:reqId/cancel": ["Customer cancels their own pending shipment request", "POST", "Contract"],
+  "POST /api/contracts/booking-requests/:reqId/reject": ["GL rejects a shipment request", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/documents": ["GL uploads post-booking operational documents (DO/RO/T1/…)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/duty": ["GL ET advises duty & tax amount + declaration serial", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/duty-slip": ["Customer uploads the duty/tax payment slip", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice": ["GL DJ raises the post-offload final invoice (amount + invoice document)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice-slip": ["Customer attaches the payment slip for the final invoice", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice/approve": ["Customer approves the drafted final invoice — unlocks the payment slip", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/final-invoice/confirm": ["GL (ET or DJ) confirms the payment slip — settles the final invoice", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/incidents": ["GL DJ logs a cargo exception with photo evidence", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/milestones/:code/complete": ["GL / Ops / Terminal marks a post-booking milestone complete", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/risk": ["GL ET assigns a customs risk level (GREEN/YELLOW/RED)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/second-duty": ["GL ET advises (or skips) the post-arrival additional duty/tax round (import)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/second-duty-slip": ["Customer attaches the additional duty/tax payment slip", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/station-assign": ["GL station manager routes the shipment + binds staff", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/t1-close": ["Close (accept) the T1 set — GL ET after arrival (import) / GL DJ after gate pass (export)", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/t1-documents": ["GL Djibouti uploads T1 transit documents (multi-file) after wagon allocation; locked once the train departs", "POST", "Contract"],
+  "POST /api/contracts/bookings/:bookingId/transport-document": ["GL ET uploads export transit permit documents (multi-file)", "POST", "Contract"],
+  "POST /api/gl-exchange/:entityId": ["Share a document with the other GL desk", "POST", "Contract"],
+  "PATCH /api/gl-exchange/documents/:documentId": ["Uploader edits a shared document (title, visibility, file)", "PATCH", "Contract"],
+  "DELETE /api/gl-exchange/documents/:documentId": ["Uploader removes a shared document", "DELETE", "Contract"],
+  "POST /api/contracts/:id/bookings/:bookingId/complete-consolidated": ["Complete this booking and its chosen shared-wagon partner together (all-or-nothing). Each booking is priced and invoiced separately — only the wagon is shared.", "POST", "Contract"],
+
+  // Contract Template
+  "POST /api/contract-templates": ["Create a bulk contract template for a (cargo type, customs option) pair", "POST", "Contract Template"],
+  "PATCH /api/contract-templates/:code": ["Update template metadata (name, title, recitals, active flag)", "PATCH", "Contract Template"],
+  "DELETE /api/contract-templates/:code": ["Delete a staff-created bulk template (system templates refuse)", "DELETE", "Contract Template"],
+  "POST /api/contract-templates/:code/articles": ["Add an article to the template", "POST", "Contract Template"],
+  "PUT /api/contract-templates/:code/articles": ["Replace the full ordered article list (used for reorder)", "PUT", "Contract Template"],
+  "PATCH /api/contract-templates/:code/articles/:articleId": ["Update an article's title or body", "PATCH", "Contract Template"],
+  "DELETE /api/contract-templates/:code/articles/:articleId": ["Remove an article from the template", "DELETE", "Contract Template"],
+  "POST /api/contract-templates/:code/preview": ["Render an HTML preview of the template against mock contract data", "POST", "Contract Template"],
+
+  // Driver
+  "POST /api/drivers": ["Create a new driver", "POST", "Driver"],
+  "PATCH /api/drivers/:id": ["Update a driver", "PATCH", "Driver"],
+  "DELETE /api/drivers/:id": ["Delete a driver", "DELETE", "Driver"],
+  "POST /api/drivers/:id/documents": ["Upload driver documents (code driver_docs)", "POST", "Driver"],
+  "DELETE /api/drivers/:id/documents/:fileId": ["Delete a driver document", "DELETE", "Driver"],
+
+  // Dropdown Setting
+  "POST /api/dropdown-settings": ["Create a new dropdown setting", "POST", "Dropdown Setting"],
+  "PATCH /api/dropdown-settings/:id": ["Update a dropdown setting's metadata", "PATCH", "Dropdown Setting"],
+  "DELETE /api/dropdown-settings/:id": ["Soft-delete a dropdown setting", "DELETE", "Dropdown Setting"],
+  "POST /api/dropdown-settings/:id/options": ["Append a single option to a setting", "POST", "Dropdown Setting"],
+  "PUT /api/dropdown-settings/:id/options": ["Replace the full option list for a setting", "PUT", "Dropdown Setting"],
+  "PATCH /api/dropdown-settings/options/:optionId": ["Update a single option", "PATCH", "Dropdown Setting"],
+  "DELETE /api/dropdown-settings/options/:optionId": ["Soft-delete a single option", "DELETE", "Dropdown Setting"],
+
+  // EIMS Invoice
+  "POST /api/invoices/:id/eims/register": ["Register the invoice with MoR EIMS. Idempotent — an invoice that already has an IRN is returned unchanged", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/resolve": ["Resolve an unacknowledged submission: record the IRN confirmed with MoR, or discard it. Clears the system-wide block", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/verify": ["Verify the invoice's stored IRN against EIMS", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/cancel": ["Cancel the invoice", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/receipt/sales": ["Register a sales receipt with MoR EIMS against a registered invoice", "POST", "EIMS Invoice"],
+  "POST /api/invoices/:id/eims/receipt/withholding": ["Register a withholding receipt with MoR EIMS against a registered invoice", "POST", "EIMS Invoice"],
+  "POST /api/invoices/eims/bulk-cancel": ["Cancel multiple invoices", "POST", "EIMS Invoice"],
+
+  // Exchange Setting
+  "PATCH /api/exchange-settings": ["Set the USD→ETB fallback by hand (used only while CBE is unreachable)", "PATCH", "Exchange Setting"],
+
+  // Facility
+  "POST /api/facilities": ["Create a new facility", "POST", "Facility"],
+  "PATCH /api/facilities/:id": ["Update a facility", "PATCH", "Facility"],
+  "DELETE /api/facilities/:id": ["Delete a facility (soft delete)", "DELETE", "Facility"],
+
+  // Fayda Verification
+  "POST /api/fayda/verification/start": ["Start a VeriFayda 2.0 verification session", "POST", "Fayda Verification"],
+
+  // File Upload Setting
+  "POST /api/file-upload-settings": ["Create a new file upload setting", "POST", "File Upload Setting"],
+  "PATCH /api/file-upload-settings/:id": ["Update a file upload setting's metadata", "PATCH", "File Upload Setting"],
+  "DELETE /api/file-upload-settings/:id": ["Soft-delete a file upload setting", "DELETE", "File Upload Setting"],
+  "POST /api/file-upload-settings/:id/fields": ["Append a single field to a setting", "POST", "File Upload Setting"],
+  "PUT /api/file-upload-settings/:id/fields": ["Replace the full field list for a setting", "PUT", "File Upload Setting"],
+  "PATCH /api/file-upload-settings/fields/:fieldId": ["Update a single field", "PATCH", "File Upload Setting"],
+  "DELETE /api/file-upload-settings/fields/:fieldId": ["Soft-delete a single field", "DELETE", "File Upload Setting"],
+
+  // First Mile
+  "POST /api/first-mile": ["Create a first-mile leg", "POST", "First Mile"],
+  "PATCH /api/first-mile/:id": ["Update a first-mile leg", "PATCH", "First Mile"],
+  "DELETE /api/first-mile/:id": ["Soft-delete a first-mile leg", "DELETE", "First Mile"],
+  "POST /api/first-mile/:id/distances": ["Set per-vehicle actual distances (does not generate an invoice)", "POST", "First Mile"],
+  "POST /api/first-mile/:id/invoice": ["Generate the first-mile delivery-fee invoice", "POST", "First Mile"],
+  "POST /api/first-mile/:id/vehicles": ["Set the vehicles assigned to a first-mile pickup (multi-truck)", "POST", "First Mile"],
+  "POST /api/first-mile/accept/:reference": ["Accept a paid booking and create a first-mile leg", "POST", "First Mile"],
+
+  // Fuel
+  "POST /api/fuel/purchases": ["Record fuel purchase", "POST", "Fuel"],
+
+  // GPS Tracking
+  "POST /api/gps/devices": ["Register a GPS tracker", "POST", "GPS Tracking"],
+  "PATCH /api/gps/devices/:id": ["Update a GPS tracker (name / assigned vehicle)", "PATCH", "GPS Tracking"],
+  "DELETE /api/gps/devices/:id": ["Delete a GPS tracker", "DELETE", "GPS Tracking"],
+
+  // Import Operation
+  "POST /api/import-operations/customs/:bookingId/declaration": ["Batch 12: record declaration serial number", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/documents": ["Batch 12: upload IM4/IM5/T1/permit/payment-slip documents", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/duties-taxes-paid": ["Batch 12: mark duties and taxes paid", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/notify-duties-taxes": ["Batch 12: notify duties and taxes", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/release-permitted": ["Batch 12: mark import release permitted", "POST", "Import Operation"],
+  "POST /api/import-operations/customs/:bookingId/risk": ["Batch 12: assign customs risk", "POST", "Import Operation"],
+  "POST /api/import-operations/djibouti-incidents": ["Batch 8: report a Djibouti import incident / exception", "POST", "Import Operation"],
+  "POST /api/import-operations/empty-container-returns": ["Batch 16: create an empty container return record", "POST", "Import Operation"],
+  "POST /api/import-operations/empty-container-returns/:id/status": ["Batch 16: advance empty container return workflow", "POST", "Import Operation"],
+  "POST /api/import-operations/empty-container-returns/load-on-train": ["Load returned empties onto an export train (1×40ft or 2×20ft per wagon)", "POST", "Import Operation"],
+
+  // Incident
+  "POST /api/incidents": ["Report an incident", "POST", "Incident"],
+  "PATCH /api/incidents/:id": ["Update an incident", "PATCH", "Incident"],
+  "DELETE /api/incidents/:id": ["Delete an incident", "DELETE", "Incident"],
+
+  // Interchange Document
+  "PATCH /api/interchange-documents/:id/acknowledge": ["Acknowledge an interchange document", "PATCH", "Interchange Document"],
+  "PATCH /api/interchange-documents/:id/dispute": ["Dispute an interchange document", "PATCH", "Interchange Document"],
+  "POST /api/interchange-documents/generate-from-schedule": ["Generate interchange document from a train schedule handover", "POST", "Interchange Document"],
+
+  // Last Mile
+  "POST /api/last-mile": ["Create a last-mile leg", "POST", "Last Mile"],
+  "PATCH /api/last-mile/:id": ["Update a last-mile leg", "PATCH", "Last Mile"],
+  "DELETE /api/last-mile/:id": ["Soft-delete a last-mile leg", "DELETE", "Last Mile"],
+  "POST /api/last-mile/:id/detention-times": ["Set each truck\\'s own detention window (arrived at destination / returned)", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/distances": ["Set per-vehicle actual distances (does not generate an invoice)", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/invoice": ["Generate the delivery-fee invoice for a last-mile leg", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/proof-of-delivery": ["Record proof of delivery (signature + photos) and complete the leg", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/vehicles": ["Set the vehicles assigned to a last-mile delivery (multi-truck)", "POST", "Last Mile"],
+  "POST /api/last-mile/:id/warehouse-gate-times": ["Set each truck\\'s warehouse gate arrival/departure times", "POST", "Last Mile"],
+  "POST /api/last-mile/accept/:reference": ["Accept a paid booking and create a last-mile leg", "POST", "Last Mile"],
+
+  // Last Mile Request
+  "POST /api/last-mile-requests/:id/approve": ["Truck & Machinery chief approves the request — the advance defaults to the live last-mile rate; LM contract becomes signable and the advance invoice follows the customer signature", "POST", "Last Mile Request"],
+  "POST /api/last-mile-requests/:id/contract/sign": ["Customer agrees and signs the LM contract — then the advance invoice is issued", "POST", "Last Mile Request"],
+  "POST /api/last-mile-requests/:id/reject": ["Truck & Machinery chief rejects the request with a reason", "POST", "Last Mile Request"],
+  "POST /api/last-mile-requests/:id/submit": ["Customer confirms which containers go via EDR last-mile", "POST", "Last Mile Request"],
+
+  // Locomotive
+  "POST /api/locomotives": ["Create a locomotive", "POST", "Locomotive"],
+  "PATCH /api/locomotives/:id": ["Update a locomotive", "PATCH", "Locomotive"],
+  "POST /api/locomotives/:id/decommission": ["Decommission a locomotive", "POST", "Locomotive"],
+  "DELETE /api/locomotives/:id/permanent": ["Permanently delete a locomotive (irreversible; refused if any train references it)", "DELETE", "Locomotive"],
+
+  // Logo Setting
+  "PUT /api/logo-settings": ["Replace the company logo", "PUT", "Logo Setting"],
+  "DELETE /api/logo-settings": ["Clear the company logo (documents fall back to their text mark)", "DELETE", "Logo Setting"],
+
+  // Maintenance
+  "POST /api/maintenance/costs": ["Record maintenance cost", "POST", "Maintenance"],
+  "POST /api/maintenance/intervals": ["Define/adjust a service interval (e.g. oil change every 10,000 km)", "POST", "Maintenance"],
+  "DELETE /api/maintenance/intervals/:id": ["Deactivate a service interval (stops auto-scheduling)", "DELETE", "Maintenance"],
+  "POST /api/maintenance/parts": ["Create part", "POST", "Maintenance"],
+  "PATCH /api/maintenance/parts/:id": ["Update part", "PATCH", "Maintenance"],
+  "DELETE /api/maintenance/parts/:id": ["Delete part", "DELETE", "Maintenance"],
+  "POST /api/maintenance/schedules": ["Schedule maintenance", "POST", "Maintenance"],
+  "PATCH /api/maintenance/schedules/:id": ["Update maintenance schedule", "PATCH", "Maintenance"],
+  "POST /api/maintenance/warranties": ["Create warranty", "POST", "Maintenance"],
+  "DELETE /api/maintenance/warranties/:id": ["Delete warranty", "DELETE", "Maintenance"],
+  "POST /api/maintenance/work-orders": ["Create work order", "POST", "Maintenance"],
+  "PATCH /api/maintenance/work-orders/:id": ["Update work order", "PATCH", "Maintenance"],
+  "DELETE /api/maintenance/work-orders/:id": ["Delete work order", "DELETE", "Maintenance"],
+
+  // Notification Inbox
+  "PATCH /api/notifications/:id/read": ["Mark one of my notifications as read", "PATCH", "Notification Inbox"],
+  "POST /api/notifications/read-all": ["Mark all my notifications as read", "POST", "Notification Inbox"],
+
+  // Organization User
+  "PUT /api/backoffice/organizations/:orgId/employee-users/:userId/roles": ["Replace org-scoped roles assigned to an employee user", "PUT", "Organization User"],
+  "POST /api/backoffice/organizations/:orgId/users": ["Create an organization user without assigning positions", "POST", "Organization User"],
+
+  // OTP
+  "POST /api/otp/send": ["Send OTP", "POST", "OTP"],
+  "POST /api/otp/verify": ["Verify OTP", "POST", "OTP"],
+
+  // Password Reset
+  "POST /api/auth/forgot-password/request": ["Send a password-reset code to the account's email AND phone", "POST", "Password Reset"],
+  "POST /api/auth/forgot-password/resolve-link": ["Validate a staff-issued reset link and return its set-password ticket", "POST", "Password Reset"],
+  "POST /api/auth/forgot-password/verify": ["Exchange a valid reset code for a single-use set-password ticket", "POST", "Password Reset"],
+  "POST /api/backoffice/customers/:companyId/reset-password": ["Send a password-reset link to a customer's primary contact", "POST", "Password Reset"],
+
+  // Payment
+  "POST /api/billing/invoices/:id/confirm-offline": ["Finance confirms a USD invoice paid by bank transfer — slip file required, settles the full balance", "POST", "Payment"],
+  "POST /api/billing/my-invoices/:id/confirm": ["Confirm an OTP-debit payment (CAC Bank) for one of the customer's invoices", "POST", "Payment"],
+  "POST /api/billing/my-invoices/:id/pay": ["Initiate payment for one of the customer's invoices", "POST", "Payment"],
+  "POST /api/internal/payments/bill-query": ["Live still-payable check + payer name for a CBE bill (called while CBE is on the line)", "POST", "Payment"],
+  "POST /api/internal/payments/mark-paid": ["Apply a payment.succeeded / payment.failed event from the payment service (idempotent)", "POST", "Payment"],
+  "POST /api/payments/initiate": ["Initiate payment for an invoice", "POST", "Payment"],
+  "POST /api/payments/redirect-success/:bookingId": ["Success-redirect ack: mark payment processing + invoice PAYMENT_PROCESSING (webhook remains source of truth)", "POST", "Payment"],
+  "POST /api/billing/invoices/:id/memo": ["Issue a credit or debit memo against a registered invoice (MoR DEB/CRE). Filing-equivalent — the auto-submit sweep picks it up like any other issued invoice.", "POST", "Payment"],
+
+  // Payment Setting
+  "PATCH /api/payment-settings/manual": ["Enable or disable manual invoice settlement for ETB and/or USD", "PATCH", "Payment Setting"],
+
+  // Priority Config
+  "POST /api/priority-configs": ["Create a priority config", "POST", "Priority Config"],
+  "PATCH /api/priority-configs/:id": ["Update a priority config", "PATCH", "Priority Config"],
+  "DELETE /api/priority-configs/:id": ["Soft-delete a priority config", "DELETE", "Priority Config"],
+  "POST /api/priority-configs/:id/move-order": ["Move a priority config up or down in display order", "POST", "Priority Config"],
+  "POST /api/priority-configs/reorder": ["Bulk reorder priority configs by ID list", "POST", "Priority Config"],
+
+  // Priority Rule Change Request
+  "POST /api/priority-rule-change-requests": ["Submit a priority-rule change for approval", "POST", "Priority Rule Change Request"],
+  "POST /api/priority-rule-change-requests/:id/approve": ["Approve and apply a pending change", "POST", "Priority Rule Change Request"],
+  "POST /api/priority-rule-change-requests/:id/reject": ["Reject a pending change", "POST", "Priority Rule Change Request"],
+
+  // Procurement
+  "POST /api/procurement/acquisitions": ["Create an asset acquisition", "POST", "Procurement"],
+  "PATCH /api/procurement/acquisitions/:id": ["Update an asset acquisition", "PATCH", "Procurement"],
+  "DELETE /api/procurement/acquisitions/:id": ["Delete an asset acquisition", "DELETE", "Procurement"],
+  "POST /api/procurement/disposals": ["Create an asset disposal", "POST", "Procurement"],
+  "DELETE /api/procurement/disposals/:id": ["Delete an asset disposal", "DELETE", "Procurement"],
+  "POST /api/procurement/vendors": ["Create a vendor", "POST", "Procurement"],
+  "PATCH /api/procurement/vendors/:id": ["Update a vendor", "PATCH", "Procurement"],
+  "DELETE /api/procurement/vendors/:id": ["Delete a vendor", "DELETE", "Procurement"],
+
+  // Rate
+  "POST /api/rates": ["Create a rate (DRAFT)", "POST", "Rate"],
+  "PATCH /api/rates/:id": ["Update a DRAFT rate", "PATCH", "Rate"],
+  "DELETE /api/rates/:id": ["Soft-delete a rate", "DELETE", "Rate"],
+  "POST /api/rates/:id/approve": ["CEO approves a rate", "POST", "Rate"],
+  "POST /api/rates/:id/submit": ["Submit rate for CEO approval", "POST", "Rate"],
+
+  // Rate Change Request
+  "POST /api/rate-change-requests": ["Propose a change to a LIVE rate", "POST", "Rate Change Request"],
+  "POST /api/rate-change-requests/:id/approve": ["Approve a rate change and put it into effect", "POST", "Rate Change Request"],
+  "POST /api/rate-change-requests/:id/reject": ["Reject a rate change — the rate keeps its current value", "POST", "Rate Change Request"],
+
+  // Route
+  "POST /api/routes": ["Create route", "POST", "Route"],
+  "PATCH /api/routes/:id": ["Update route", "PATCH", "Route"],
+  "DELETE /api/routes/:id": ["Deactivate route", "DELETE", "Route"],
+  "DELETE /api/routes/:id/permanent": ["Permanently delete a route (irreversible; refused while any train schedule references it)", "DELETE", "Route"],
+
+  // Schedule
+  // NOTE: duplicate route — also declared in modules/scheduling-reschedule/scheduling-reschedule.controller.ts:52.
+  // Two controllers register this same path; Nest serves whichever module loads first.
+  "POST /api/train-scheduling/schedules/:id/maintenance": ["Reschedule train for maintenance (new departure + rebalance)", "POST", "Schedule"],
+  "POST /api/train-scheduling/schedules/:id/reschedule/execute": ["Execute a confirmed reschedule plan", "POST", "Schedule"],
+  "POST /api/train-scheduling/schedules/:id/reschedule/preview": ["Preview reschedule / government preempt plan", "POST", "Schedule"],
+
+  // Service Type
+  "POST /api/service-types": ["Create a service type", "POST", "Service Type"],
+  "PATCH /api/service-types/:id": ["Update a service type", "PATCH", "Service Type"],
+  "DELETE /api/service-types/:id": ["Soft-delete a service type", "DELETE", "Service Type"],
+  "POST /api/service-types/:id/move-order": ["Move a service type up or down in display order", "POST", "Service Type"],
+  "POST /api/service-types/reorder": ["Bulk reorder service types by ID list", "POST", "Service Type"],
+
+  // Shipping Line (rule-engine lookup list — a code/label bookings reference,
+  // not an account)
+  "POST /api/shipping-lines": ["Create a shipping line", "POST", "Shipping Line"],
+  "PATCH /api/shipping-lines/:id": ["Update a shipping line", "PATCH", "Shipping Line"],
+  "DELETE /api/shipping-lines/:id": ["Soft-delete a shipping line", "DELETE", "Shipping Line"],
+
+  // Shipping Line Booking
+  "POST /api/shipping-line-bookings/initiate": ["Initiate a bare booking (no contract). Starts at AWAITING_DOCUMENTS so the shipping line can upload its documents for Operations to approve.", "POST", "Shipping Line Booking"],
+  "POST /api/shipping-line-bookings/:id/cancel": ["Cancel one of the signed-in shipping line's own bookings. Allowed only before the booking is priced.", "POST", "Shipping Line Booking"],
+  "POST /api/shipping-line-bookings/:id/price-preview": ["Authoritative price quote for the completion payload — same compute as /complete, saved as the booking's breakdown + rate snapshots (refreshed on every re-preview). Persists nothing else.", "POST", "Shipping Line Booking"],
+  "POST /api/shipping-line-bookings/:id/complete": ["Complete an approved (CLEARANCE_READY) booking: cargo + binding shipment day.", "POST", "Shipping Line Booking"],
+
+  // Shipping Line Credit
+  "POST /api/shipping-line-credits/invoice": ["Bill a batch of unbilled credits as one invoice. All credits must belong to the same shipping line.", "POST", "Shipping Line Credit"],
+  "POST /api/shipping-line-credits/:creditId/cancel": ["Write off an unbilled credit. Once billed, cancel the invoice instead.", "POST", "Shipping Line Credit"],
+  "POST /api/shipping-line-credits/invoices/:invoiceId/mark-paid-request": ["Request recording a full offline payment against a credit invoice (awaits chief approval).", "POST", "Shipping Line Credit"],
+  "POST /api/shipping-line-credits/invoices/:invoiceId/cancel-request": ["Request voiding a credit invoice — its credits return to the unbilled pool (awaits chief approval).", "POST", "Shipping Line Credit"],
+  "POST /api/shipping-line-credits/invoice-actions/:approvalId/approve": ["Approve a pending invoice request — executes the offline settlement or the cancellation.", "POST", "Shipping Line Credit"],
+  "POST /api/shipping-line-credits/invoice-actions/:approvalId/reject": ["Reject a pending invoice request — nothing is changed.", "POST", "Shipping Line Credit"],
+
+  // Shipping Line Company (carrier with a portal login, registered by staff)
+  "POST /api/shipping-line-companies": ["Register a shipping line company and send its activation link", "POST", "Shipping Line Company"],
+  "POST /api/shipping-line-companies/:id/resend-activation": ["Resend a shipping line company's activation link", "POST", "Shipping Line Company"],
+
+  // Signature
+  "PUT /api/me/signature": ["Create or update the reusable saved signature", "PUT", "Signature"],
+
+  // Stamp Setting
+  "PUT /api/stamp-settings": ["Replace the company stamp", "PUT", "Stamp Setting"],
+  "DELETE /api/stamp-settings": ["Clear the company stamp (invoices fall back to the plain seal)", "DELETE", "Stamp Setting"],
+
+  // Support Chat
+  "POST /api/support/agent/conversations": ["Start chatting with a company (returns the thread if one exists)", "POST", "Support Chat"],
+  "POST /api/support/agent/conversations/:id/messages": ["Reply as an agent, optionally with attachments", "POST", "Support Chat"],
+  "POST /api/support/agent/conversations/:id/read": ["Mark a thread read (agent side)", "POST", "Support Chat"],
+  "POST /api/support/conversation/messages": ["Send a message as the customer (optionally with attachments), opening the thread if needed", "POST", "Support Chat"],
+  "POST /api/support/conversation/read": ["Mark my company's thread read (customer side)", "POST", "Support Chat"],
+
+  // Support Content
+  "PATCH /api/support-content/documents/:slug": ["Replace a document's payload, recording a new version", "PATCH", "Support Content"],
+  "POST /api/support-content/documents/:slug/versions/:version/restore": ["Restore a version — re-saves it as a new version, never destructive", "POST", "Support Content"],
+  "POST /api/support-content/media": ["Upload an image or video for a help section", "POST", "Support Content"],
+
+  // Train
+  "POST /api/trains": ["Register a new train", "POST", "Train"],
+  "PATCH /api/trains/:id": ["Update a train", "PATCH", "Train"],
+  "DELETE /api/trains/:id": ["Delete a train", "DELETE", "Train"],
+
+  // Train Build
+  "POST /api/train-builder": ["Build a train: code + yard + 2+ locomotives (+ optional wagons)", "POST", "Train Build"],
+  "DELETE /api/train-builder/:id": ["Disband the train (release wagons and locomotives)", "DELETE", "Train Build"],
+  "POST /api/train-builder/:id/activate": ["Reactivate a deactivated train back to AVAILABLE", "POST", "Train Build"],
+  "POST /api/train-builder/:id/deactivate": ["Deactivate the train (park it) — only allowed with no active schedule", "POST", "Train Build"],
+  "PATCH /api/train-builder/:id/details": ["Edit the train's name and fixed import/export run numbers", "PATCH", "Train Build"],
+  "PUT /api/train-builder/:id/locomotives": ["Replace the locomotive set (minimum 1, same yard)", "PUT", "Train Build"],
+  "POST /api/train-builder/:id/reorder-wagons": ["Persist a drag-reorder of the full consist", "POST", "Train Build"],
+  "POST /api/train-builder/:id/wagons": ["Append AVAILABLE wagons from the train's yard to the consist", "POST", "Train Build"],
+  "DELETE /api/train-builder/:id/wagons/:wagonId": ["Detach one wagon from the consist", "DELETE", "Train Build"],
+  "POST /api/train-builder/:id/wagons/:wagonId/maintenance": ["Detach one wagon and move it to MAINTENANCE status", "POST", "Train Build"],
+  "PATCH /api/train-builder/:id/yard": ["Relocate the train — its locomotives and wagons move to the new yard with it", "PATCH", "Train Build"],
+
+  // Train Schedule
+  "POST /api/train-scheduling/bookings/:bookingId/allocate": ["Staff: place a paid booking onto a fitting train (notifies customer on date change)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bookings/:bookingId/expire": ["Staff: expire a reservation and free its capacity", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bookings/:bookingId/mark-paid": ["Staff: mark a reserved booking paid and allocate it now", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bookings/:bookingId/move-schedule": ["Re-point a booking to another OPEN same-route schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/preview": ["Preview a bulk train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/schedules": ["Create a bulk train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/schedules/:id/assign-bookings": ["Assign bulk bookings to a train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/bulk/schedules/:id/cancel": ["Cancel bulk train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/preview": ["Preview a container train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/schedules": ["Create a container train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/schedules/:id/assign-bookings": ["Assign container bookings to a train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/container/schedules/:id/cancel": ["Cancel container train schedule", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/global-rules": ["Update global train scheduling rules (singleton)", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/preview": ["Preview a mixed-capable train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/adjust-consist": ["Permanently trim free wagons off / couple yard wagons onto the schedule's built train (weight & length limits incl. tolerance enforced, every change logged)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/arrive": ["Mark a dispatched train arrived (move assets to destination yard, free assets)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/assign-bookings": ["Assign bookings to a train schedule (mixed-capable)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/assign-unassigned-booking": ["Assign one linked unallocated booking to wagons (preserves existing assignments)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/booking-window": ["Open or close a schedule booking window", "PATCH", "Train Schedule"],
+  "DELETE /api/train-scheduling/schedules/:id/bookings/:bookingId": ["Unassign a booking from a train schedule", "DELETE", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/bookings/:bookingId/load": ["Confirm a booking's cargo loaded at its origin yard (any direction; train must be at that yard)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/bookings/:bookingId/unload": ["Confirm a booking's cargo unloaded at its destination yard — per-booking arrival, may precede the train's final arrival", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/checkpoints": ["Log the train passing a station (final station triggers arrival)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/confirm-loading": ["Confirm cargo loaded on the train (any direction; unblocks import-Djibouti dispatch)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/container-items/:itemId": ["Update a container number on a wagon slot", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/dispatch": ["Dispatch a scheduled train", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/doc-review-complete": ["Staff finished document review early — run the batch/payment phase now (applies to the whole route-day group)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/finalize": ["Finalize a draft train schedule", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/depart": ["Depart loaded import train from Djibouti", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/documents": ["Upload/check an import Djibouti-side document", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/gatepass-granted": ["Mark import Djibouti gatepass permission granted", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/load-list": ["Generate import load list / marshalling document summary", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/loaded-on-train": ["Confirm import cargo loaded on train at Djibouti", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/import-djibouti/ready-for-loading": ["Mark import train ready for loading at Djibouti", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/import-loading-status": ["Mark import bookings loaded/unloaded on this schedule (tracking only, does not affect dispatch)", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/intercity/:bookingId/load": ["Confirm intercity cargo loaded (train must be at the booking's origin yard)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/intercity/:bookingId/unload": ["Confirm intercity cargo unloaded at the booking's destination yard (completes the booking)", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/intercity/accept": ["Accept intercity bookings onto this train (opens their pay window; capacity re-checked per booking)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/loading-status": ["Mark bookings loaded/unloaded on this schedule (any direction, pre-dispatch only)", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/pin-wagons": ["Pin physical wagons to train set slots", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/run-allocation": ["Run wagon-level allocation for all eligible linked bookings", "POST", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/run-batch": ["Manually run the batch fill for a schedule", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/schedule-date": ["Reschedule a train's departure date — only before the booking window opens, and only if the new date still leaves room for the booking lead window", "PATCH", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/train-number": ["Edit a departure's train number and voyage number — allowed only until the train is dispatched", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/switch-government-booking": ["Switch out commercial bookings to allocate a government booking in their place", "POST", "Train Schedule"],
+  "DELETE /api/train-scheduling/schedules/:id/wagons/:trainSetWagonId": ["Remove an empty wagon slot from a train", "DELETE", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/wagons/:wagonId/move-load": ["Move a wagon's whole load to another wagon (empty → move/repin, loaded → swap loads)", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/window-rule": ["Override the booking-window rule for one schedule (open/close hour, duration, doc-review, payment, lead days) — only before the window opens", "PATCH", "Train Schedule"],
+  "POST /api/train-scheduling/schedules/:id/merge": ["Merge another train into this schedule: its wagons join this consist, a same-day schedule on it is absorbed, and the emptied train is deactivated", "POST", "Train Schedule"],
+  "PATCH /api/train-scheduling/schedules/:id/checkpoints/:sequenceNo": ["Edit a logged leg", "PATCH", "Train Schedule"],
+
+  // Transit Agent
+  "POST /api/transit-agents": ["Create a transit agent", "POST", "Transit Agent"],
+  "PATCH /api/transit-agents/:id": ["Update a transit agent", "PATCH", "Transit Agent"],
+  "DELETE /api/transit-agents/:id": ["Soft-delete a transit agent", "DELETE", "Transit Agent"],
+
+  // Truck Type
+  "POST /api/truck-types": ["Create a truck type", "POST", "Truck Type"],
+  "PATCH /api/truck-types/:id": ["Update a truck type", "PATCH", "Truck Type"],
+  "DELETE /api/truck-types/:id": ["Soft-delete a truck type", "DELETE", "Truck Type"],
+
+  // User Trade Access
+  "PUT /api/user-trade-access/:userId": ["Set the trade directions a backoffice user may see", "PUT", "User Trade Access"],
+
+  // Vehicle
+  "POST /api/vehicles": ["Create a new vehicle", "POST", "Vehicle"],
+  "PATCH /api/vehicles/:id": ["Update a vehicle", "PATCH", "Vehicle"],
+  "DELETE /api/vehicles/:id": ["Delete a vehicle", "DELETE", "Vehicle"],
+
+  // Wagon
+  "POST /api/wagons": ["Create a new wagon", "POST", "Wagon"],
+  "PATCH /api/wagons/:id": ["Update a wagon", "PATCH", "Wagon"],
+  "DELETE /api/wagons/:id": ["Delete a wagon", "DELETE", "Wagon"],
+  "POST /api/wagons/:id/assign-train": ["Assign wagon to a train", "POST", "Wagon"],
+  "DELETE /api/wagons/:id/permanent": ["Permanently delete a wagon (irreversible; refused if it has movements, containers or train-set slots)", "DELETE", "Wagon"],
+  "POST /api/wagons/:id/unassign-train": ["Unassign wagon from train", "POST", "Wagon"],
+  "POST /api/wagons/bulk-status": ["Set the status of multiple wagons (audited in wagon_status_logs)", "POST", "Wagon"],
+  "POST /api/wagons/bulk-transfer": ["Transfer multiple wagons to a destination yard", "POST", "Wagon"],
+
+  // Wagon Transfer Request
+  "POST /api/wagon-transfer-requests": ["File a count-only wagon-transfer request", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/:id/cancel": ["Withdraw a request that has not moved any wagon yet (use close-short once wagons have moved)", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/:id/close-short": ["OCC: end the request with fewer wagons than asked for — what moved stays, the requester is told the shortfall", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/:id/fulfill": ["OCC: pick wagons and execute the transfer", "POST", "Wagon Transfer Request"],
+  "POST /api/wagon-transfer-requests/bulk-fulfill": ["OCC: accept-and-execute a subset of pending requests (auto-picks available wagons; the rest stay PENDING)", "POST", "Wagon Transfer Request"],
+
+  // Wagon Type
+  "POST /api/wagon-types": ["Create a wagon type", "POST", "Wagon Type"],
+  "PATCH /api/wagon-types/:id": ["Update a wagon type", "PATCH", "Wagon Type"],
+  "DELETE /api/wagon-types/:id": ["Soft-delete a wagon type", "DELETE", "Wagon Type"],
+
+  // Warehouse
+  "POST /api/warehouse-allocation-rules": ["Create a warehouse allocation rule", "POST", "Warehouse"],
+  "PATCH /api/warehouse-allocation-rules/:id": ["Update a warehouse allocation rule", "PATCH", "Warehouse"],
+  "DELETE /api/warehouse-allocation-rules/:id": ["Delete a warehouse allocation rule", "DELETE", "Warehouse"],
+  "POST /api/warehouse-allocation/preview": ["Preview the yard/warehouse/zone a booking would be allocated to", "POST", "Warehouse"],
+  "POST /api/warehouse-fee-rules": ["Create a storage / demurrage fee rule", "POST", "Warehouse"],
+  "PATCH /api/warehouse-fee-rules/:id": ["Update a fee rule", "PATCH", "Warehouse"],
+  "DELETE /api/warehouse-fee-rules/:id": ["Delete a fee rule", "DELETE", "Warehouse"],
+  "POST /api/warehouse-fees/accrual/:inventoryId/acknowledge": ["Acknowledge / snooze an item fee-accrual alert", "POST", "Warehouse"],
+  "DELETE /api/warehouse-fees/accrual/:inventoryId/acknowledge": ["Remove an accrual acknowledgement (re-surface for alerts)", "DELETE", "Warehouse"],
+  "POST /api/warehouses": ["Create warehouse", "POST", "Warehouse"],
+  "PATCH /api/warehouses/:id": ["Update warehouse", "PATCH", "Warehouse"],
+  "POST /api/warehouses/:warehouseId/yards": ["Create a yard within a warehouse", "POST", "Warehouse"],
+
+  // Warehouse Fee Invoice
+  "POST /api/last-mile/:id/generate-truck-detention-invoice": ["Generate a truck-detention invoice for a last-mile leg (per truck per day)", "POST", "Warehouse Fee Invoice"],
+  "PATCH /api/warehouse-fee-invoices/:id/cancel": ["Cancel a warehouse fee invoice", "PATCH", "Warehouse Fee Invoice"],
+  "POST /api/warehouse-fee-invoices/:id/pay": ["Record a payment against a warehouse fee invoice", "POST", "Warehouse Fee Invoice"],
+  "POST /api/warehouse-fee-invoices/:id/pay-online": ["Initiate Telebirr/Waafi payment for a warehouse fee invoice", "POST", "Warehouse Fee Invoice"],
+  "POST /api/warehouse-inventory/:id/generate-fee-invoice": ["Generate a warehouse fee invoice from Batch 5 fee calculation", "POST", "Warehouse Fee Invoice"],
+
+  // Warehouse Inspection Report
+  "PATCH /api/warehouse-inspection-reports/:id": ["Update an inspection report", "PATCH", "Warehouse Inspection Report"],
+  "POST /api/warehouse-inspection-reports/:id/attachments": ["Upload inspection images / documents", "POST", "Warehouse Inspection Report"],
+  "POST /api/warehouse-inventory/:inventoryId/inspection-reports": ["Create an inspection / damage report for an inventory item", "POST", "Warehouse Inspection Report"],
+
+  // Warehouse Inventory
+  "POST /api/warehouse-inventory/:id/deliver": ["Deliver import goods to the customer + capture proof of delivery", "POST", "Warehouse Inventory"],
+  "PATCH /api/warehouse-inventory/:id/dispatch": ["Mark loaded inventory DISPATCHED (left the terminal)", "PATCH", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/gate-clearance": ["Final terminal release / gate clearance (blocked while fees unpaid)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/load": ["Load READY_FOR_LOADING inventory onto a wagon", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/move": ["Move inventory to another warehouse/yard/zone", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/ready-for-loading": ["Mark reserved inventory READY_FOR_LOADING", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/ready-for-pickup": ["Mark inspected IMPORT inventory READY_FOR_PICKUP", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/release": ["Issue a DO / release order for ready-for-pickup inventory", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/:id/store": ["Mark received inventory as STORED (optional explicit warehouse/yard/zone)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/auto-load-ready": ["Auto-load READY_FOR_LOADING inventory with PAID bookings", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/auto-unload-arrived": ["Bulk auto-unload all arrived bookings into the warehouse", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bookings/:bookingId/approve-delivery": ["Approve delivery — customer records their full name (signature optional)", "POST", "Warehouse Inventory"],
+  "PATCH /api/warehouse-inventory/bookings/:bookingId/double-handling": ["Record Yes/No double handling after unloading (Yes applies the double-handling fee rule)", "PATCH", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bookings/:bookingId/request-handover-signature": ["Ask the customer to sign the handover (creates one if none, then notifies)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bookings/:bookingId/unload": ["Unload a single arrived booking into a location", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bulk-dispatch-export": ["Bulk-dispatch loaded EXPORT inventory (LOADED → DISPATCHED)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/bulk-mark-inspected": ["Bulk mark received inventory inspection PASSED (EXPORT → READY_FOR_LOADING)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/export/auto-unload-at-djibouti": ["Unload all eligible export items assigned to an arrived Djibouti-side train", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/handovers/:handoverId/sign": ["Customer signs one handover (EDR last-mile: one signature per truck)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/import/auto-unload-arrived-bookings": ["Unload all eligible assigned bookings of an ARRIVED import train (→ UNLOADED)", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/receive": ["Receive inventory at a warehouse location", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/receive-bulk": ["Bulk-receive selected eligible PAID bookings into a location", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/reserve": ["Reserve stored inventory for a PAID booking", "POST", "Warehouse Inventory"],
+  "POST /api/warehouse-inventory/train/:scheduleId/load": ["Load selected inventory items onto their allocated wagons for a train", "POST", "Warehouse Inventory"],
+
+  // Warehouse Yard
+  "PATCH /api/warehouse-yards/:id": ["Update warehouse yard", "PATCH", "Warehouse Yard"],
+  "POST /api/warehouse-yards/:yardId/zones": ["Create a zone within a yard", "POST", "Warehouse Yard"],
+
+  // Warehouse Zone
+  "PATCH /api/warehouse-zones/:id": ["Update warehouse zone", "PATCH", "Warehouse Zone"],
+
+  // Weight Limit Rule
+  "POST /api/weight-limit-rules": ["Create a weight limit rule", "POST", "Weight Limit Rule"],
+  "PATCH /api/weight-limit-rules/:id": ["Update a weight limit rule", "PATCH", "Weight Limit Rule"],
+  "DELETE /api/weight-limit-rules/:id": ["Soft-delete a weight limit rule", "DELETE", "Weight Limit Rule"],
+
+  // Yard
+  // Yard Position (desk↔yard mapping — an input to yard access scoping, so
+  // every change to it is evidence of who widened or narrowed someone's reach)
+  "PUT /api/yard-positions/yard/:yardId": ["Replace a yard's whole position set", "PUT", "Yard Position"],
+  "PUT /api/yard-positions/position/:positionId": ["Replace a position's whole yard set", "PUT", "Yard Position"],
+
+  "POST /api/yards": ["Create a yard", "POST", "Yard"],
+  "PATCH /api/yards/:id": ["Update a yard", "PATCH", "Yard"],
+  "DELETE /api/yards/:id": ["Soft-delete a yard", "DELETE", "Yard"],
+  "POST /api/yards/:id/move-order": ["Move a yard up or down in display order", "POST", "Yard"],
+  "POST /api/yards/reorder": ["Bulk reorder yards by ID list", "POST", "Yard"],
+
+  // Yard Distance
+  "POST /api/yard-distances": ["Create a yard distance", "POST", "Yard Distance"],
+  "PATCH /api/yard-distances/:id": ["Update a yard distance", "PATCH", "Yard Distance"],
+  "DELETE /api/yard-distances/:id": ["Soft-delete a yard distance", "DELETE", "Yard Distance"],
+};
diff --git a/apps/edr-freight-api/src/modules/audit/audit-log.repository.ts b/apps/edr-freight-api/src/modules/audit/audit-log.repository.ts
new file mode 100644
index 000000000..91d6c9901
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/audit-log.repository.ts
@@ -0,0 +1,79 @@
+import { Injectable } from '@nestjs/common';
+import { BaseRepository } from '@edr/api-common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Between, FindOptionsWhere, LessThanOrEqual, MoreThanOrEqual, Repository } from 'typeorm';
+import type { QueryDeepPartialEntity } from 'typeorm/query-builder/QueryPartialEntity';
+
+import { AuditLog } from './entities/audit-log.entity';
+
+export interface AuditLogQuery {
+  type?: string;
+  userId?: string;
+  method?: string;
+  isSuccess?: boolean;
+  resourceId?: string;
+  from?: Date;
+  to?: Date;
+  skip: number;
+  take: number;
+}
+
+@Injectable()
+export class AuditLogRepository extends BaseRepository<AuditLog> {
+  constructor(
+    @InjectRepository(AuditLog)
+    private readonly auditLogRepository: Repository<AuditLog>,
+  ) {
+    super(auditLogRepository);
+  }
+
+  /**
+   * Insert one audit row.
+   *
+   * `insert` rather than `save`: save would issue a SELECT first to decide
+   * between insert and update, which is wasted work for a table that is only
+   * ever appended to.
+   */
+  async record(entry: Partial<AuditLog>): Promise<void> {
+    await this.auditLogRepository.insert(
+      entry as QueryDeepPartialEntity<AuditLog>,
+    );
+  }
+
+  /**
+   * Paginated, filtered read. Newest first — every index on this table is
+   * ordered `created_at DESC` to match.
+   */
+  async search(query: AuditLogQuery): Promise<[AuditLog[], number]> {
+    const where: FindOptionsWhere<AuditLog> = {};
+
+    if (query.type) where.type = query.type;
+    if (query.userId) where.userId = query.userId;
+    if (query.method) where.method = query.method;
+    if (query.resourceId) where.resourceId = query.resourceId;
+    if (query.isSuccess !== undefined) where.isSuccess = query.isSuccess;
+
+    // Date range: either bound may be supplied alone.
+    if (query.from && query.to) where.createdAt = Between(query.from, query.to);
+    else if (query.from) where.createdAt = MoreThanOrEqual(query.from);
+    else if (query.to) where.createdAt = LessThanOrEqual(query.to);
+
+    return this.auditLogRepository.findAndCount({
+      where,
+      order: { createdAt: 'DESC' },
+      skip: query.skip,
+      take: query.take,
+    });
+  }
+
+  /** Distinct entity types present, for populating a filter dropdown. */
+  async distinctTypes(): Promise<string[]> {
+    const rows = await this.auditLogRepository
+      .createQueryBuilder('audit_log')
+      .select('DISTINCT audit_log.type', 'type')
+      .orderBy('audit_log.type', 'ASC')
+      .getRawMany<{ type: string }>();
+
+    return rows.map((row) => row.type);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/audit/audit.controller.ts b/apps/edr-freight-api/src/modules/audit/audit.controller.ts
index a7c8782b2..1a07a5fe5 100644
--- a/apps/edr-freight-api/src/modules/audit/audit.controller.ts
+++ b/apps/edr-freight-api/src/modules/audit/audit.controller.ts
@@ -1,32 +1,46 @@
-import { Controller, Get, Query } from "@nestjs/common";
-import { ApiOperation, ApiQuery, ApiTags } from "@nestjs/swagger";
+import { Controller, Get, Query } from '@nestjs/common';
+import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';
+import { PaginatedResponse } from '@edr/types';
 
-import { BookingStaff } from "../../common/booking-guards";
-import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
-import { AuditService } from "./audit.service";
+import { BookingStaff } from '../../common/booking-guards';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
+import { AuditService } from './audit.service';
+import { AuditLog } from './entities/audit-log.entity';
+import { AuditLogQueryDto } from './dto/audit-log-query.dto';
 
-@ApiTags("audit")
-@Controller("audit")
-@BookingStaff(FREIGHT_PERMS.audit.view)
+/**
+ * Read-only view over the audit trail.
+ *
+ * Gated on `edr_freight_app:audit_log:view` — a dedicated view key rather than
+ * the broad `admin` key, so reading the trail can be granted without also
+ * granting write access to everything else.
+ *
+ * There is deliberately no write, update or delete endpoint here — rows are
+ * created only by `AuditInterceptor`, and an audit trail that can be edited
+ * through the API is not an audit trail.
+ */
+@ApiTags('audit')
+@ApiBearerAuth()
+@Controller('audit')
 export class AuditController {
   constructor(private readonly auditService: AuditService) {}
 
-  @Get("logs")
-  @ApiOperation({ summary: "List freight-api audit log commands" })
-  @ApiQuery({ name: "skip", type: Number, required: false })
-  @ApiQuery({ name: "take", type: Number, required: false })
-  list(@Query("skip") skip?: string, @Query("take") take?: string) {
-    // Same fallback chain @tria-plc/auditlog's client interceptor uses to
-    // stamp AuditLog.application (mezgeb/client/client-audit.interceptor.js)
-    // — reading it here instead of a hardcoded literal means this can't
-    // silently drift out of sync with whatever APPLICATION_NAME/APP_NAME
-    // actually is at runtime.
-    const application =
-      process.env.APPLICATION_NAME ?? process.env.APP_NAME ?? "DEFAULT";
-    return this.auditService.list(
-      application,
-      skip !== undefined ? parseInt(skip, 10) : undefined,
-      take !== undefined ? parseInt(take, 10) : undefined,
-    );
+  @Get('logs')
+  @BookingStaff(FREIGHT_PERMS.auditLog.view)
+  @ApiOperation({
+    summary:
+      'List backoffice audit logs — filter by entity type, user, method, outcome and date range',
+  })
+  list(@Query() query: AuditLogQueryDto): Promise<PaginatedResponse<AuditLog>> {
+    return this.auditService.search(query);
+  }
+
+  @Get('types')
+  @BookingStaff(FREIGHT_PERMS.auditLog.view)
+  @ApiOperation({
+    summary: 'Distinct entity types present in the audit log (filter dropdown)',
+  })
+  types(): Promise<string[]> {
+    return this.auditService.listTypes();
   }
 }
diff --git a/apps/edr-freight-api/src/modules/audit/audit.interceptor.ts b/apps/edr-freight-api/src/modules/audit/audit.interceptor.ts
new file mode 100644
index 000000000..cf12fd4d3
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/audit.interceptor.ts
@@ -0,0 +1,189 @@
+import {
+  CallHandler,
+  ExecutionContext,
+  HttpException,
+  Injectable,
+  NestInterceptor,
+} from '@nestjs/common';
+import { Observable, tap } from 'rxjs';
+import type { Request, Response } from 'express';
+
+import { AuditService } from './audit.service';
+import {
+  auditEndpointMatcher,
+  type MatchedAuditEndpoint,
+} from './audit-endpoint-matcher';
+import {
+  isAuditableActor,
+  resolveAuditActor,
+  type AuditActorSource,
+} from './audit-actor';
+import { redactUrlQuery, sanitizeRequestPayload } from './audit.sanitizer';
+
+/** Methods that can change state. Everything else is never audited. */
+const AUDITED_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
+
+/** `error_message` ceiling — stack traces do not belong in this column. */
+const MAX_ERROR_LENGTH = 2_000;
+
+type RequestWithUser = Request & {
+  user?: AuditActorSource;
+  files?: unknown;
+  file?: unknown;
+  id?: string;
+};
+
+/**
+ * Writes one `audit_logs` row per state-changing backoffice request.
+ *
+ * An interceptor rather than the two middlewares originally sketched, for one
+ * decisive reason: Express middleware runs BEFORE guards, so `req.user` is not
+ * populated yet. Both the backoffice-only rule and `user_id` would be
+ * unavailable there. Interceptors run after guards and wrap the handler's
+ * result, so a single class covers both halves — request context on the way in,
+ * outcome on the way out — sharing one timer for `duration_ms`.
+ *
+ * Registered globally (see `audit.module.ts`), so new routes are covered
+ * automatically as long as they appear in `AUDIT_ENDPOINTS`.
+ */
+@Injectable()
+export class AuditInterceptor implements NestInterceptor {
+  constructor(private readonly auditService: AuditService) {}
+
+  intercept(context: ExecutionContext, next: CallHandler): Observable<unknown> {
+    // Non-HTTP contexts (the RabbitMQ microservice transport) have no request.
+    if (context.getType() !== 'http') return next.handle();
+
+    const httpContext = context.switchToHttp();
+    const request = httpContext.getRequest<RequestWithUser>();
+
+    if (!AUDITED_METHODS.has(request.method)) return next.handle();
+
+    // Backoffice only. Customers and unauthenticated callers are skipped
+    // outright — decided in `audit-actor.ts`, which reuses the same
+    // `userType` discriminator as the permission guards.
+    if (!isAuditableActor(request.user)) return next.handle();
+
+    const matched = auditEndpointMatcher.match(request.method, request.originalUrl);
+    // Not in AUDIT_ENDPOINTS means the route is not a known auditable action;
+    // recording it would produce rows with no title or entity.
+    if (!matched) return next.handle();
+
+    const startedAt = Date.now();
+    // The body is captured up front: handlers are free to mutate the DTO they
+    // are given, so reading it after the fact can record post-mutation values.
+    const requestPayload = sanitizeRequestPayload(
+      request.body,
+      request.files ?? request.file,
+    );
+
+    return next.handle().pipe(
+      tap({
+        next: () => {
+          const response = httpContext.getResponse<Response>();
+          void this.write(request, matched, requestPayload, startedAt, {
+            isSuccess: true,
+            // Nest has not applied the handler's @HttpCode yet at this point
+            // for some routes; statusCode on the response object is the value
+            // actually being sent.
+            statusCode: response.statusCode,
+            errorMessage: null,
+          });
+        },
+        error: (error: unknown) => {
+          void this.write(request, matched, requestPayload, startedAt, {
+            isSuccess: false,
+            statusCode: resolveErrorStatus(error),
+            errorMessage: resolveErrorMessage(error),
+          });
+        },
+      }),
+    );
+  }
+
+  /**
+   * Build and persist the row.
+   *
+   * Deliberately not awaited by `intercept`: the audit write must not add
+   * latency to the request, and `AuditService.record` already swallows its own
+   * failures so a rejected promise cannot surface as an unhandled rejection.
+   */
+  private async write(
+    request: RequestWithUser,
+    matched: MatchedAuditEndpoint,
+    requestPayload: Record<string, unknown> | null,
+    startedAt: number,
+    outcome: {
+      isSuccess: boolean;
+      statusCode: number | null;
+      errorMessage: string | null;
+    },
+  ): Promise<void> {
+    const actor = resolveAuditActor(request.user as AuditActorSource);
+
+    await this.auditService.record({
+      title: matched.title,
+      method: request.method,
+      // Full URL including query string, with sensitive query values redacted.
+      url: redactUrlQuery(request.originalUrl),
+      routePath: matched.routePath,
+      type: matched.type,
+      isSuccess: outcome.isSuccess,
+      statusCode: outcome.statusCode,
+      errorMessage: outcome.errorMessage,
+      userId: actor.userId,
+      userName: actor.userName,
+      userRole: actor.userRole,
+      resourceId: matched.resourceId,
+      request: requestPayload,
+      ipAddress: resolveIp(request),
+      userAgent: request.headers['user-agent'] ?? null,
+      requestId: resolveRequestId(request),
+      durationMs: Date.now() - startedAt,
+    });
+  }
+}
+
+/** HTTP status for the failure, falling back to 500 for non-HTTP errors. */
+function resolveErrorStatus(error: unknown): number {
+  return error instanceof HttpException ? error.getStatus() : 500;
+}
+
+/** Message only — stack traces belong in application logs, not this column. */
+function resolveErrorMessage(error: unknown): string | null {
+  if (error instanceof HttpException) {
+    const response = error.getResponse();
+    const message =
+      typeof response === 'string'
+        ? response
+        : ((response as { message?: unknown })?.message ?? error.message);
+    const text = Array.isArray(message) ? message.join('; ') : String(message);
+    return text.slice(0, MAX_ERROR_LENGTH);
+  }
+
+  if (error instanceof Error) return error.message.slice(0, MAX_ERROR_LENGTH);
+  return error ? String(error).slice(0, MAX_ERROR_LENGTH) : null;
+}
+
+/**
+ * Client IP. The API sits behind a reverse proxy, so `req.ip` is the proxy
+ * unless `trust proxy` is set; the forwarded header is preferred and its first
+ * entry (the original client) taken.
+ */
+function resolveIp(request: Request): string | null {
+  const forwarded = request.headers['x-forwarded-for'];
+  const raw = Array.isArray(forwarded) ? forwarded[0] : forwarded;
+  const candidate = raw?.split(',')[0]?.trim() || request.ip;
+  if (!candidate) return null;
+
+  // Normalize IPv4-mapped IPv6 (`::ffff:10.0.0.1`), which the `inet` column
+  // accepts but which reads badly and breaks grouping by address.
+  return candidate.startsWith('::ffff:') ? candidate.slice(7) : candidate;
+}
+
+/** Correlation id from the proxy/tracing layer, when present. */
+function resolveRequestId(request: RequestWithUser): string | null {
+  const header = request.headers['x-request-id'] ?? request.headers['x-correlation-id'];
+  const value = Array.isArray(header) ? header[0] : header;
+  return (value ?? request.id ?? null)?.toString().slice(0, 64) ?? null;
+}
diff --git a/apps/edr-freight-api/src/modules/audit/audit.module.ts b/apps/edr-freight-api/src/modules/audit/audit.module.ts
index 635973fc6..608af3672 100644
--- a/apps/edr-freight-api/src/modules/audit/audit.module.ts
+++ b/apps/edr-freight-api/src/modules/audit/audit.module.ts
@@ -1,13 +1,34 @@
-import { Module } from "@nestjs/common";
-import { TypeOrmModule } from "@nestjs/typeorm";
-import { AuditLogCommand } from "@tria-plc/auditlog";
+import { Global, Module } from '@nestjs/common';
+import { APP_INTERCEPTOR } from '@nestjs/core';
+import { TypeOrmModule } from '@nestjs/typeorm';
 
-import { AuditController } from "./audit.controller";
-import { AuditService } from "./audit.service";
+import { AuditController } from './audit.controller';
+import { AuditInterceptor } from './audit.interceptor';
+import { AuditLog } from './entities/audit-log.entity';
+import { AuditLogRepository } from './audit-log.repository';
+import { AuditService } from './audit.service';
 
+/**
+ * Backoffice audit trail.
+ *
+ * `AuditInterceptor` is bound through `APP_INTERCEPTOR`, so it applies to every
+ * route in the application without touching the 488 mutating handlers
+ * individually. Coverage therefore follows `AUDIT_ENDPOINTS`: a new route is
+ * audited as soon as it appears in that map, and unknown routes are skipped
+ * rather than recorded with an empty title.
+ *
+ * Global so other modules can inject `AuditService` to record domain events
+ * that do not map cleanly onto an HTTP request.
+ */
+@Global()
 @Module({
-  imports: [TypeOrmModule.forFeature([AuditLogCommand])],
+  imports: [TypeOrmModule.forFeature([AuditLog])],
   controllers: [AuditController],
-  providers: [AuditService],
+  providers: [
+    AuditLogRepository,
+    AuditService,
+    { provide: APP_INTERCEPTOR, useClass: AuditInterceptor },
+  ],
+  exports: [AuditService, AuditLogRepository],
 })
 export class AuditModule {}
diff --git a/apps/edr-freight-api/src/modules/audit/audit.sanitizer.ts b/apps/edr-freight-api/src/modules/audit/audit.sanitizer.ts
new file mode 100644
index 000000000..3a934beea
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/audit.sanitizer.ts
@@ -0,0 +1,195 @@
+/**
+ * Redaction and shrinking for anything copied into `audit_logs.request`.
+ *
+ * This matters more here than in a typical audit log. `main.ts` raises the JSON
+ * body ceiling to 100MB so contract signing can post a signature AND a company
+ * stamp as base64 in one request. Copying a body like that verbatim would put
+ * both a credential-grade artefact and a 100MB blob into the audit table, on
+ * the write path of every audited endpoint.
+ */
+
+const REDACTED = '[REDACTED]';
+
+/**
+ * Substring-matched against lower-cased key names, so `newPassword`,
+ * `otpCode` and `x-authorization` are all caught without enumerating variants.
+ *
+ * `signature` and `stamp` are here because contract signing posts both as
+ * base64 — they are simultaneously the largest and the most sensitive fields
+ * this API accepts.
+ */
+const SENSITIVE_KEY_PATTERNS = [
+  'password',
+  'otp',
+  'token',
+  'secret',
+  'pin',
+  'authorization',
+  'signature',
+  'stamp',
+  'apikey',
+  'api_key',
+  'credential',
+  'ssn',
+];
+
+/** Serialized `request` ceiling. Beyond this the payload is dropped for a marker. */
+const MAX_REQUEST_BYTES = 64 * 1024;
+
+/** Depth guard: deep nesting is never worth the recursion cost here. */
+const MAX_DEPTH = 6;
+
+/** Long strings (base64 blobs) are truncated rather than stored whole. */
+const MAX_STRING_LENGTH = 2_000;
+
+function isSensitiveKey(key: string): boolean {
+  const lower = key.toLowerCase();
+  return SENSITIVE_KEY_PATTERNS.some((pattern) => lower.includes(pattern));
+}
+
+/**
+ * Multer file shape, reduced to a descriptor. The buffer is never stored —
+ * Postgres is the wrong home for file bytes, and `audit_logs` doubly so.
+ */
+function isMulterFile(value: unknown): boolean {
+  if (typeof value !== 'object' || value === null) return false;
+  const candidate = value as Record<string, unknown>;
+  return (
+    typeof candidate.originalname === 'string' &&
+    (typeof candidate.mimetype === 'string' || typeof candidate.size === 'number')
+  );
+}
+
+function describeFile(value: Record<string, unknown>): Record<string, unknown> {
+  return {
+    __file: true,
+    originalName: value.originalname ?? null,
+    mimeType: value.mimetype ?? null,
+    size: typeof value.size === 'number' ? value.size : null,
+    fieldName: value.fieldname ?? null,
+  };
+}
+
+function sanitizeValue(value: unknown, depth: number): unknown {
+  if (value === null || value === undefined) return value ?? null;
+
+  if (typeof value === 'string') {
+    return value.length > MAX_STRING_LENGTH
+      ? `${value.slice(0, MAX_STRING_LENGTH)}…[truncated ${value.length} chars]`
+      : value;
+  }
+
+  if (typeof value === 'number' || typeof value === 'boolean') return value;
+  if (value instanceof Date) return value.toISOString();
+  // Buffers are file bytes by definition — never persisted, only described.
+  if (Buffer.isBuffer(value)) return { __buffer: true, size: value.length };
+
+  if (depth >= MAX_DEPTH) return '[MAX_DEPTH]';
+
+  if (Array.isArray(value)) {
+    // Cap array length: bulk endpoints post large collections.
+    const capped = value.slice(0, 50).map((item) => sanitizeValue(item, depth + 1));
+    if (value.length > 50) capped.push(`…[${value.length - 50} more items]`);
+    return capped;
+  }
+
+  if (typeof value === 'object') {
+    if (isMulterFile(value)) return describeFile(value as Record<string, unknown>);
+
+    const out: Record<string, unknown> = {};
+    for (const [key, nested] of Object.entries(value as Record<string, unknown>)) {
+      out[key] = isSensitiveKey(key) ? REDACTED : sanitizeValue(nested, depth + 1);
+    }
+    return out;
+  }
+
+  // Functions, symbols and anything else are not audit data.
+  return null;
+}
+
+/**
+ * Sanitize a request body (or query object) for storage.
+ *
+ * Returns null when there is nothing worth keeping, so empty bodies do not
+ * occupy jsonb rows.
+ */
+export function sanitizeRequestPayload(
+  body: unknown,
+  files?: unknown,
+): Record<string, unknown> | null {
+  const payload: Record<string, unknown> = {};
+
+  if (body && typeof body === 'object' && Object.keys(body).length > 0) {
+    const sanitizedBody = sanitizeValue(body, 0);
+    if (sanitizedBody && typeof sanitizedBody === 'object') {
+      Object.assign(payload, sanitizedBody as Record<string, unknown>);
+    }
+  }
+
+  // Multer puts uploads on `req.files`, outside `req.body`, so they are folded
+  // in explicitly — otherwise a pure-upload request records an empty payload.
+  if (files) {
+    const sanitizedFiles = sanitizeValue(files, 0);
+    if (
+      sanitizedFiles &&
+      (Array.isArray(sanitizedFiles) || typeof sanitizedFiles === 'object')
+    ) {
+      const hasEntries = Array.isArray(sanitizedFiles)
+        ? sanitizedFiles.length > 0
+        : Object.keys(sanitizedFiles as object).length > 0;
+      if (hasEntries) payload.__uploads = sanitizedFiles;
+    }
+  }
+
+  if (Object.keys(payload).length === 0) return null;
+
+  // Final size guard. A body can stay under every per-field cap and still be
+  // enormous in aggregate, so the serialized form is measured before storing.
+  const serialized = JSON.stringify(payload);
+  if (serialized && Buffer.byteLength(serialized, 'utf8') > MAX_REQUEST_BYTES) {
+    return {
+      __truncated: true,
+      reason: 'Payload exceeded the audit size limit',
+      bytes: Buffer.byteLength(serialized, 'utf8'),
+      keys: Object.keys(payload).slice(0, 50),
+    };
+  }
+
+  return payload;
+}
+
+/**
+ * Rebuild a URL with sensitive query values redacted.
+ *
+ * `url` is stored with its full query string, and query strings are a common
+ * place for one-time tokens and signed links, so the same deny-list that
+ * protects the body is applied to the query.
+ */
+export function redactUrlQuery(url: string): string {
+  const queryIndex = url.indexOf('?');
+  if (queryIndex === -1) return url;
+
+  const path = url.slice(0, queryIndex);
+  const query = url.slice(queryIndex + 1);
+  if (!query) return path;
+
+  const redacted = query
+    .split('&')
+    .map((pair) => {
+      const eq = pair.indexOf('=');
+      if (eq === -1) return pair;
+      const key = pair.slice(0, eq);
+      // Keys arrive percent-encoded; decode before matching so `api%2Dkey`
+      // is not treated as harmless.
+      let decodedKey = key;
+      try {
+        decodedKey = decodeURIComponent(key);
+      } catch {
+        /* malformed encoding — fall back to the raw key */
+      }
+      return isSensitiveKey(decodedKey) ? `${key}=${REDACTED}` : pair;
+    })
+    .join('&');
+
+  return `${path}?${redacted}`;
+}
diff --git a/apps/edr-freight-api/src/modules/audit/audit.service.ts b/apps/edr-freight-api/src/modules/audit/audit.service.ts
index 04ea4beed..de7dfd956 100644
--- a/apps/edr-freight-api/src/modules/audit/audit.service.ts
+++ b/apps/edr-freight-api/src/modules/audit/audit.service.ts
@@ -1,70 +1,71 @@
-import { Injectable } from "@nestjs/common";
-import { InjectRepository } from "@nestjs/typeorm";
-import { Repository } from "typeorm";
-import { AuditLogCommand } from "@tria-plc/auditlog";
+import { BadRequestException, Injectable, Logger } from '@nestjs/common';
+import { PaginatedResponse } from '@edr/types';
 
-import { CLIENT_APP_HEADER } from "../auth/login-audience.middleware";
+import { AuditLog } from './entities/audit-log.entity';
+import { AuditLogRepository } from './audit-log.repository';
+import { AuditLogQueryDto } from './dto/audit-log-query.dto';
+import {
+  buildPaginationMeta,
+  normalizePagination,
+} from '../../common/utils/pagination.util';
 
-export interface AuditLogListResult {
-  count: number;
-  items: AuditLogCommand[];
-}
-
-/**
- * Own read path onto @tria-plc/auditlog's tables, gated by AuditController's
- * @BookingStaff — the package's own AuditLogCommandController (mounted at
- * /api/audit-log-commands) ships with no guards at all, so it can't be used
- * directly for a permission-gated UI. Query mirrors the package's
- * AuditLogCommandService.buildAuditLogQuery/getAllAuditLogs exactly.
- */
 @Injectable()
 export class AuditService {
-  constructor(
-    @InjectRepository(AuditLogCommand)
-    private readonly auditLogCommandRepository: Repository<AuditLogCommand>,
-  ) {}
+  private readonly logger = new Logger(AuditService.name);
 
-  async list(
-    application: string,
-    skip = 0,
-    take = 10,
-  ): Promise<AuditLogListResult> {
-    const [items, count] = await this.auditLogCommandRepository
-      .createQueryBuilder("audit_log_commands")
-      .leftJoinAndSelect("audit_log_commands.auditLog", "auditLog")
-      .andWhere(
-        "(audit_log_commands.auditLogId IS NULL OR auditLog.application = :application)",
-        { application },
-      )
-      .andWhere(
-        "(audit_log_commands.auditLogId IS NULL OR auditLog.status = :status)",
-        { status: "Commit" },
-      )
-      // Backoffice-only view: portal (customer-facing) writes carry the same
-      // request-header set by every axios call from that app — see
-      // login-audience.middleware.ts. Rows with no linked auditLog (child/
-      // event commands with no request context) stay visible; they aren't
-      // attributable to any frontend, so they're not portal noise either.
-      .andWhere(
-        "(audit_log_commands.auditLogId IS NULL OR auditLog.requestHeader ->> :clientAppHeader = :clientApp)",
-        { clientAppHeader: CLIENT_APP_HEADER, clientApp: "backoffice" },
-      )
-      .select([
-        "audit_log_commands.id",
-        "audit_log_commands.createdAt",
-        "audit_log_commands.deletedAt",
-        "audit_log_commands.entityName",
-        "audit_log_commands.queryMethod",
-        "audit_log_commands.changes",
-        "audit_log_commands.payload",
-        "auditLog.id",
-        "auditLog.user",
-      ])
-      .addOrderBy("audit_log_commands.createdAt", "DESC")
-      .skip(skip)
-      .take(take)
-      .getManyAndCount();
+  constructor(private readonly auditLogRepository: AuditLogRepository) {}
 
-    return { count, items };
+  /**
+   * Persist one audit row, swallowing any failure.
+   *
+   * An audit write must never turn a successful business action into an error
+   * for the user: if this table is full, misconfigured or mid-migration,
+   * contract approvals still need to work. Failures are logged so the gap is
+   * visible in application logs rather than silent.
+   */
+  async record(entry: Partial<AuditLog>): Promise<void> {
+    try {
+      await this.auditLogRepository.record(entry);
+    } catch (error) {
+      this.logger.error(
+        `Failed to write audit log for ${entry.method} ${entry.routePath}: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      );
+    }
+  }
+
+  /** Paginated, filtered audit history, newest first. */
+  async search(query: AuditLogQueryDto): Promise<PaginatedResponse<AuditLog>> {
+    const { page, pageSize, skip, take } = normalizePagination(query);
+
+    const from = query.from ? new Date(query.from) : undefined;
+    const to = query.to ? new Date(query.to) : undefined;
+
+    // A reversed range silently returns zero rows, which reads as "nothing
+    // happened" rather than "your filter is wrong" — reject it explicitly.
+    if (from && to && from > to) {
+      throw new BadRequestException('`from` must be earlier than `to`');
+    }
+
+    const [items, total] = await this.auditLogRepository.search({
+      type: query.type,
+      userId: query.userId,
+      method: query.method,
+      resourceId: query.resourceId,
+      isSuccess:
+        query.isSuccess === undefined ? undefined : query.isSuccess === 'true',
+      from,
+      to,
+      skip,
+      take,
+    });
+
+    return { items, meta: buildPaginationMeta(total, page, pageSize) };
+  }
+
+  /** Distinct entity types, for the filter dropdown on the audit screen. */
+  async listTypes(): Promise<string[]> {
+    return this.auditLogRepository.distinctTypes();
   }
 }
diff --git a/apps/edr-freight-api/src/modules/audit/dto/audit-log-query.dto.ts b/apps/edr-freight-api/src/modules/audit/dto/audit-log-query.dto.ts
new file mode 100644
index 000000000..5a5199538
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/dto/audit-log-query.dto.ts
@@ -0,0 +1,64 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Transform } from 'class-transformer';
+import { IsBooleanString, IsIn, IsISO8601, IsOptional, IsString, IsUUID, MaxLength } from 'class-validator';
+
+import { PaginationQueryDto } from '../../../common/dto/pagination-query.dto';
+
+const AUDITED_METHODS = ['POST', 'PUT', 'PATCH', 'DELETE'] as const;
+
+/**
+ * Filters for the audit log read endpoint.
+ *
+ * Extends the shared pagination DTO so page/pageSize behave (and are capped)
+ * exactly as they do on every other list endpoint.
+ */
+export class AuditLogQueryDto extends PaginationQueryDto {
+  @ApiPropertyOptional({
+    description: 'Entity type, e.g. "Contract", "Booking", "Locomotive".',
+    example: 'Contract',
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  type?: string;
+
+  @ApiPropertyOptional({ description: 'IAM id of the acting backoffice user.' })
+  @IsOptional()
+  @IsUUID()
+  userId?: string;
+
+  @ApiPropertyOptional({ enum: AUDITED_METHODS })
+  @IsOptional()
+  @Transform(({ value }) => String(value).toUpperCase())
+  @IsIn([...AUDITED_METHODS])
+  method?: string;
+
+  @ApiPropertyOptional({ description: 'Id of the affected record.' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(64)
+  resourceId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filter by outcome: true = succeeded, false = failed.',
+  })
+  @IsOptional()
+  @IsBooleanString()
+  isSuccess?: string;
+
+  @ApiPropertyOptional({
+    description: 'Inclusive start of the range (ISO 8601).',
+    example: '2026-01-01T00:00:00.000Z',
+  })
+  @IsOptional()
+  @IsISO8601()
+  from?: string;
+
+  @ApiPropertyOptional({
+    description: 'Inclusive end of the range (ISO 8601).',
+    example: '2026-01-31T23:59:59.999Z',
+  })
+  @IsOptional()
+  @IsISO8601()
+  to?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/audit/entities/audit-log.entity.ts b/apps/edr-freight-api/src/modules/audit/entities/audit-log.entity.ts
new file mode 100644
index 000000000..0ff7727ff
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/audit/entities/audit-log.entity.ts
@@ -0,0 +1,132 @@
+import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
+
+/**
+ * One backoffice action against a state-changing endpoint.
+ *
+ * Deliberately does NOT extend `BaseEntity`, which is the repo standard
+ * everywhere else. `BaseEntity` carries `updatedAt` and `deletedAt`, and both
+ * are wrong here:
+ *
+ *  - `updatedAt` implies an audit row can be edited. A record that can be
+ *    rewritten after the fact is not evidence.
+ *  - `deletedAt` (soft delete) would let anyone who can delete erase their own
+ *    trail, and TypeORM would then hide those rows from every default query —
+ *    the failure would be silent, which is the worst property an audit log can
+ *    have.
+ *
+ * Rows are insert-only: nothing in this module updates or deletes them.
+ *
+ * `userId` is a bare uuid with NO foreign key into the `iam` schema. Two
+ * reasons: cross-schema FKs are forbidden platform-wide, and a FK would let
+ * deleting a user cascade away the record of what that user did — exactly
+ * backwards. `userName` / `userRole` are point-in-time snapshots for the same
+ * reason: resolving them at read time would rewrite history whenever somebody
+ * is renamed or changes role.
+ */
+@Entity({ schema: 'freight', name: 'audit_logs' })
+// Every audit query is time-bounded, so created_at leads most indexes.
+@Index('IDX_audit_logs_created_at', ['createdAt'])
+@Index('IDX_audit_logs_user_id_created_at', ['userId', 'createdAt'])
+@Index('IDX_audit_logs_type_created_at', ['type', 'createdAt'])
+@Index('IDX_audit_logs_type_resource_id', ['type', 'resourceId'])
+@Index('IDX_audit_logs_route_path_created_at', ['routePath', 'createdAt'])
+export class AuditLog {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string;
+
+  /**
+   * Human-readable action, e.g. "Approve contract" — taken from the matched
+   * entry in `AUDIT_ENDPOINTS`, which sources it from each route's
+   * `@ApiOperation` summary.
+   */
+  @Column({ name: 'title', type: 'varchar', length: 255 })
+  title!: string;
+
+  @Column({ name: 'method', type: 'varchar', length: 10 })
+  method!: string;
+
+  /**
+   * The URL as actually called, real ids and query string included
+   * (`/api/contracts/abc-123/cancel?force=true`). Query values run through the
+   * same redaction pass as the body, so a `?token=` never lands here.
+   */
+  @Column({ name: 'url', type: 'text' })
+  url!: string;
+
+  /**
+   * The route template (`/api/contracts/:id/cancel`).
+   *
+   * `url` alone cannot be grouped — every contract cancel is a distinct string.
+   * This column is the join key back to `AUDIT_ENDPOINTS` and makes
+   * "every contract cancellation" one indexed query instead of a regex scan.
+   */
+  @Column({ name: 'route_path', type: 'varchar', length: 255, nullable: true })
+  routePath?: string | null;
+
+  /** Primary entity the action touched: `Contract`, `Booking`, `Locomotive`. */
+  @Column({ name: 'type', type: 'varchar', length: 50 })
+  type!: string;
+
+  @Column({ name: 'is_success', type: 'boolean' })
+  isSuccess!: boolean;
+
+  /** IAM user id. Nullable by design — see the class comment. */
+  @Column({ name: 'user_id', type: 'uuid', nullable: true })
+  userId?: string | null;
+
+  /**
+   * Id of the affected record, recovered from the first path parameter of the
+   * matched template.
+   *
+   * `varchar`, not `uuid`: not every identifier is a uuid
+   * (`/api/contract-templates/:code`), and a create has no id at all until it
+   * succeeds. A `uuid NOT NULL` column would throw during the write and lose
+   * the audit row rather than the id.
+   */
+  @Column({ name: 'resource_id', type: 'varchar', length: 64, nullable: true })
+  resourceId?: string | null;
+
+  /**
+   * Sanitized request body. Secrets are replaced with `[REDACTED]` and uploads
+   * are reduced to `{ __file, originalName, mimeType, size }` descriptors —
+   * never raw bytes. See `audit.sanitizer.ts`.
+   */
+  @Column({ name: 'request', type: 'jsonb', nullable: true })
+  request?: Record<string, unknown> | null;
+
+  /**
+   * `isSuccess` alone cannot separate 403 (denied — the security signal worth
+   * alerting on) from 500 (broke). Both are simply `false`.
+   */
+  @Column({ name: 'status_code', type: 'smallint', nullable: true })
+  statusCode?: number | null;
+
+  @Column({ name: 'error_message', type: 'text', nullable: true })
+  errorMessage?: string | null;
+
+  /** Snapshot of the actor's display name at the time of the action. */
+  @Column({ name: 'user_name', type: 'varchar', length: 150, nullable: true })
+  userName?: string | null;
+
+  /** Snapshot of the actor's role at the time of the action. */
+  @Column({ name: 'user_role', type: 'varchar', length: 100, nullable: true })
+  userRole?: string | null;
+
+  /** Non-repudiation: the first thing asked in any incident review. */
+  @Column({ name: 'ip_address', type: 'inet', nullable: true })
+  ipAddress?: string | null;
+
+  /** Helps separate a real browser session from a script using a stolen token. */
+  @Column({ name: 'user_agent', type: 'text', nullable: true })
+  userAgent?: string | null;
+
+  /** Correlates this row with application logs/traces for the same request. */
+  @Column({ name: 'request_id', type: 'varchar', length: 64, nullable: true })
+  requestId?: string | null;
+
+  @Column({ name: 'duration_ms', type: 'integer', nullable: true })
+  durationMs?: number | null;
+
+  @CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
+  createdAt!: Date;
+}
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
index 4eb6ecc31..0a7ed942e 100644
--- a/apps/edr-freight-api/src/modules/auth/customer-reset.service.ts
+++ b/apps/edr-freight-api/src/modules/auth/customer-reset.service.ts
@@ -10,9 +10,10 @@ import { ResetChannel } from "./dto/forgot-password.dto";
 import {
   ForgotPasswordService,
   RESET_LINK_TTL_MS,
+  type ResetTicket,
 } from "./forgot-password.service";
 import { maskOtpTarget } from "./mask-target.util";
-import { isDomesticPhone } from "../otp/otp.service";
+import { isDomesticPhone, type OtpTarget } from "../otp/otp.service";
 
 /** The account a staff-triggered reset would land on. */
 export interface CustomerResetTarget {
@@ -86,28 +87,113 @@ export class CustomerResetService {
     const resolved = await this.resolvePrimaryContactUser(companyId);
     if (!resolved) return null;
 
-    const { user, userId } = resolved;
-    const target = this.forgotPasswordService.targetFor(user, channel);
-    if (!target) return null;
+    return this.sendResetLinkToUser(resolved.userId, channel, {
+      scope: `company ${companyId}`,
+    });
+  }
+
+  /**
+   * Mint and deliver a reset link to a specific IAM account.
+   *
+   * The delivery half of {@link sendResetLinkToCustomer}, split out so callers
+   * that resolve their target differently can reuse it: a customer is found via
+   * the company's primary contact, while a shipping line has no contact row at
+   * all and resolves straight off its own record. Everything below the lookup —
+   * active-account gating, the domestic-SMS rule, mint-before-send, the
+   * undelivered-link diagnostic — is identical for both and must stay that way.
+   *
+   * `scope` only labels the log line with whatever the caller resolved from.
+   *
+   * `allowWithoutCredential` relaxes the lookup for first-time activation:
+   * the default gate requires an existing active credential (so a reset cannot
+   * revive a suspended account), but an account that has never set a password
+   * has no credential row yet and would be excluded from its own activation
+   * link. Callers pass it only when the account is expected to be
+   * password-less — see ShippingLineCompaniesService.
+   */
+  async sendResetLinkToUser(
+    userId: string,
+    channel: ResetChannel,
+    options?: { scope?: string; allowWithoutCredential?: boolean },
+  ): Promise<SentResetLink | null> {
+    const sent = await this.sendResetLinkToUserOnChannels(userId, [channel], options);
+    return sent[0] ?? null;
+  }
+
+  /**
+   * One ticket, several channels. Minting retires every earlier ticket for the
+   * user (`mintResetTicket`), so sending email and SMS as two separate mints
+   * makes the first link dead on arrival — the same link must go to both.
+   * Returns one entry per channel that was actually sent (unreachable channels
+   * are skipped, not errors).
+   */
+  async sendResetLinkToUserOnChannels(
+    userId: string,
+    channels: ResetChannel[],
+    options?: { scope?: string; allowWithoutCredential?: boolean },
+  ): Promise<SentResetLink[]> {
+    const user = options?.allowWithoutCredential
+      ? await this.forgotPasswordService.resolveActivatableUserById(userId)
+      : await this.forgotPasswordService.resolveActiveUserById(userId);
+
+    if (!user?.id) {
+      this.logger.warn(
+        `User ${userId} is not an active account${
+          options?.allowWithoutCredential
+            ? ""
+            : " (or has no active credential — pass allowWithoutCredential for first-time activation)"
+        }`,
+      );
+      return [];
+    }
+
+    // Mint once, before any send: a failed send leaves an unused ticket that
+    // simply expires, whereas sending a link before the ticket exists would
+    // hand the customer a URL that is dead on arrival.
+    let ticket: ResetTicket | null = null;
+    const sent: SentResetLink[] = [];
+    for (const channel of channels) {
+      const target = this.forgotPasswordService.targetFor(user, channel);
+      if (!target) continue;
+      // The gateway silently drops foreign numbers — treat like a missing phone
+      // rather than reporting "link sent" for a message that will never arrive.
+      // The backoffice disables the channel up front via `phoneIsDomestic`; this
+      // guards direct API calls.
+      if (channel === "phone" && target.phone && !isDomesticPhone(target.phone)) {
+        this.logger.warn(
+          `Staff reset via SMS refused for user ${userId} — non-domestic phone`,
+        );
+        continue;
+      }
+      ticket ??= await this.forgotPasswordService.mintResetTicket(
+        user.id,
+        RESET_LINK_TTL_MS,
+      );
+      const result = await this.deliverResetLink(
+        target,
+        user.id,
+        channel,
+        ticket,
+        options?.scope,
+      );
+      if (result) sent.push(result);
+    }
+    return sent;
+  }
+
+  /**
+   * Shared tail: send the already-minted ticket to a resolved target → report.
+   */
+  private async deliverResetLink(
+    target: OtpTarget,
+    userId: string,
+    channel: ResetChannel,
+    ticket: ResetTicket,
+    scope?: string,
+  ): Promise<SentResetLink | null> {
 
     // A foreign number is unreachable by the domestic-only SMS gateway — treat
     // it like a missing phone rather than reporting "link sent" for a message
-    // that will never arrive. The backoffice disables the channel up front via
-    // `phoneIsDomestic`; this guards direct API calls.
-    if (channel === "phone" && target.phone && !isDomesticPhone(target.phone)) {
-      this.logger.warn(
-        `Staff reset via SMS refused for user ${userId} — non-domestic phone`,
-      );
-      return null;
-    }
-
-    // Mint first, send second: a failed send leaves an unused ticket that simply
-    // expires, whereas sending a link before the ticket exists would hand the
-    // customer a URL that is dead on arrival.
-    const ticket = await this.forgotPasswordService.mintResetTicket(
-      userId,
-      RESET_LINK_TTL_MS,
-    );
     const link = this.buildResetLink(ticket.userId, ticket.verificationCode);
     const expiresAt = new Date(Date.now() + RESET_LINK_TTL_MS);
 
@@ -127,7 +213,22 @@ export class CustomerResetService {
         });
 
     this.logger.log(
-      `Staff-triggered ${channel} reset link sent to user ${userId} (company ${companyId}) queued=${queued}`,
+      `Staff-triggered shipping line ${channel} reset link sent to user ${userId}${
+        scope ? ` (${scope})` : ""
+      } queued=${queued}`,
+    );
+
+    // SECURITY: logs a live password-reset credential in cleartext. Anyone with
+    // read access to the log stream can set the password for the account named
+    // on the same line — including on sends that succeeded, not just failures.
+    // Kept deliberately: log aggregation is the debugging path for flaky
+    // email/SMS here, the same tradeoff otp.service.ts makes for OTP codes. If
+    // that is ever revisited, gate this on an env flag rather than deleting it,
+    // so dev keeps its workflow.
+    this.logger.warn(
+      `reset-link.cleartext channel=${channel} user=${userId}${
+        scope ? ` (${scope})` : ""
+      } link=${link}`,
     );
 
     if (!queued) {
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
index a3dbf1061..673541747 100644
--- a/apps/edr-freight-api/src/modules/auth/forgot-password.service.ts
+++ b/apps/edr-freight-api/src/modules/auth/forgot-password.service.ts
@@ -89,6 +89,28 @@ export class ForgotPasswordService {
       .getOne();
   }
 
+  /**
+   * Active account by id, WITHOUT requiring an existing credential.
+   *
+   * {@link activeUserQuery} inner-joins an active `user_credentials` row, which
+   * is right for a *reset*: it stops a staff-triggered link from reactivating a
+   * suspended account. But an account that has never set a password has no
+   * credential row yet, so that join excludes exactly the accounts a first-time
+   * *activation* link is for — shipping lines are created deliberately without
+   * one (see ShippingLineCompaniesService.register).
+   *
+   * The `isActive` gate is kept; only the credential requirement is dropped.
+   */
+  async resolveActivatableUserById(userId: string): Promise<User | null> {
+    if (!userId) return null;
+    return await this.userRepository
+      .createQueryBuilder("u")
+      .where("u.isActive = true")
+      .andWhere("u.id = :userId", { userId })
+      .orderBy("u.createdAt", "DESC")
+      .getOne();
+  }
+
   /**
    * Base query for accounts eligible to reset. `.where()` is claimed here so
    * callers must use `.andWhere()` — TypeORM's `.where()` resets the clause,
@@ -190,7 +212,9 @@ export class ForgotPasswordService {
    * is the proof).
    */
   async mintResetTicket(userId: string, ttlMs: number): Promise<ResetTicket> {
-    const code = randomBytes(24).toString("base64url");
+    // Hex, not base64url: the token rides in an SMS, and the GSM-7 alphabet has
+    // no "_" — gateways substitute a space and the link arrives broken.
+    const code = randomBytes(24).toString("hex");
     const verificationCode = await hashPassword(code);
 
     await this.dataSource.transaction(async (manager) => {
@@ -233,9 +257,22 @@ export class ForgotPasswordService {
       "This password-reset link is invalid or has expired. Request a new one.",
     );
 
-    const user = await this.resolveActiveUserById(userId);
+    // Credential-less on purpose: this resolves links for *setting* a password,
+    // which includes first-time activation of an account that has never had one
+    // (shipping lines are created without a credential row). Requiring one here
+    // rejected a perfectly valid activation link before its token was ever
+    // checked. The ticket checks below are what actually authorise the reset.
+    const user = await this.resolveActivatableUserById(userId);
     const identifier = user && this.identifierFor(user);
-    if (!user || !identifier) throw invalid;
+    if (!user || !identifier) {
+      // Logged because the early return above bypasses the rejection warning
+      // below — without this, an account that fails the lookup produces no
+      // diagnostic at all and looks identical to a bad token.
+      this.logger.warn(
+        `Reset link rejected for user ${userId} — no active account or no usable identifier`,
+      );
+      throw invalid;
+    }
 
     const verification = await this.dataSource
       .getRepository(UserVerification)
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 ff8f803b9..557e50fb3 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
@@ -51,5 +51,8 @@ import { ListUsersService } from './list-users.service';
     ForgotPasswordService,
     CustomerResetService,
   ],
+  // Shipping-line registration mints activation links through the same
+  // staff-triggered reset path customers use.
+  exports: [CustomerResetService],
 })
 export class FreightAuthModule {}
diff --git a/apps/edr-freight-api/src/modules/auth/list-users.service.ts b/apps/edr-freight-api/src/modules/auth/list-users.service.ts
index cf7e22be2..c598e105a 100644
--- a/apps/edr-freight-api/src/modules/auth/list-users.service.ts
+++ b/apps/edr-freight-api/src/modules/auth/list-users.service.ts
@@ -1,4 +1,5 @@
 import { Injectable } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
 import { InjectRepository } from '@nestjs/typeorm';
 import { PaginatedResponse } from '@edr/types';
 import { User } from '@tria-plc/iamapi-common/entities/iam/user/user.entity';
@@ -19,6 +20,7 @@ import { paginateQuery } from '../../common/utils/pagination.util';
 export class ListUsersService {
   constructor(
     @InjectRepository(User) private readonly users: Repository<User>,
+    private readonly config: ConfigService,
   ) {}
 
   findAll(query: ListUsersQueryDto): Promise<PaginatedResponse<User>> {
@@ -40,6 +42,29 @@ export class ListUsersService {
       ])
       .orderBy(`user.${sortBy}`, query.sortOrder ?? 'ASC');
 
+    // Restrict to one IAM organization when configured. The org key differs per
+    // environment (dev seeds `edr_freight`, production uses the registered
+    // company key), so this is config rather than a constant. An unset key
+    // means no restriction; a key matching no organization matches no user —
+    // failing closed rather than silently widening to every org.
+    const orgKey = this.config.get<string>('FREIGHT_ORG_KEY');
+    if (orgKey) {
+      // EXISTS, not a join: a user with several employee rows would otherwise
+      // be returned once per row, duplicating them in the list and inflating
+      // `getManyAndCount`'s total.
+      qb.andWhere(
+        `EXISTS (
+           SELECT 1
+           FROM iam.employees emp
+           JOIN iam.organizations org ON org.id = emp.organization_id
+           WHERE emp.user_id = "user".id
+             AND org.key = :orgKey
+             AND org.deleted_at IS NULL
+         )`,
+        { orgKey },
+      );
+    }
+
     if (query.userType) {
       qb.andWhere('user.userType = :userType', { userType: query.userType });
     }
diff --git a/apps/edr-freight-api/src/modules/backoffice/backoffice.service.ts b/apps/edr-freight-api/src/modules/backoffice/backoffice.service.ts
index 49384922e..f47b5e8b1 100644
--- a/apps/edr-freight-api/src/modules/backoffice/backoffice.service.ts
+++ b/apps/edr-freight-api/src/modules/backoffice/backoffice.service.ts
@@ -46,7 +46,8 @@ export class BackofficeService {
 
   /**
    * IAM user ids of every current employee across all organizations — used by
-   * the notification recipients resolver's `allBackoffice` selector.
+   * support chat for staff room membership. Notifications deliberately do NOT
+   * use this: they target a desk via `getEmployeeUserIdsByPermission`.
    */
   async getAllCurrentEmployeeUserIds(): Promise<string[]> {
     const employees = await this.employeeRepository.find({
@@ -63,24 +64,67 @@ export class BackofficeService {
    * IAM user ids of current employees (any org) holding ANY of the given
    * permission keys — used by the notification recipients resolver's
    * `permissionKeys` selector for department/role-scoped targeting.
+   *
+   * This MUST agree with the request-time guard (`hasFreightPermission`,
+   * common/freight-permission.util.ts), which counts four grant carriers plus
+   * the super_admin bypass. Counting fewer silently drops legitimate
+   * recipients: an earlier version joined only direct position permissions, on
+   * which `bookings:view` resolved to 2 users — against 21 through position
+   * TYPES, which is where admin-created positions actually keep their grants.
+   *
+   * Raw SQL rather than QueryBuilder because `Position.positionTypePermissions`
+   * declares its inverse side against PositionType, so a relation join emits
+   * `ptp.position_type_id = position.id` and silently matches nothing. Same
+   * approach as FreightMeService's position-type lookups.
    */
   async getEmployeeUserIdsByPermission(
     permissionKeys: string[],
   ): Promise<string[]> {
     if (!permissionKeys.length) return [];
-    const rows: { userId: string | null }[] = await this.employeeRepository
-      .createQueryBuilder("employee")
-      .innerJoin("employee.employeePositions", "employeePosition")
-      .innerJoin("employeePosition.position", "position")
-      .innerJoin("position.positionPermission", "positionPermission")
-      .innerJoin("positionPermission.permission", "permission")
-      .where("employee.isCurrent = :isCurrent", { isCurrent: true })
-      .andWhere("permission.key IN (:...permissionKeys)", { permissionKeys })
-      .select("DISTINCT employee.user_id", "userId")
-      .getRawMany();
-    return rows
-      .map((r) => r.userId)
-      .filter((id): id is string => Boolean(id));
+    const rows: { userId: string }[] = await this.dataSource.query(
+      `WITH target AS (SELECT id FROM iam.permissions WHERE key = ANY($1))
+       -- 1. IAM role grants (user_roles -> role_permissions).
+       SELECT e.user_id AS "userId"
+         FROM iam.employees e
+         JOIN iam.user_roles ur ON ur.user_id = e.user_id
+         JOIN iam.role_permissions rp ON rp.role_id = ur.role_id
+        WHERE e.is_current AND e.user_id IS NOT NULL
+          AND rp.permission_id IN (SELECT id FROM target)
+       UNION
+       -- 2. Direct position grants. A delegate keeps their own position AND
+       --    gains the one they stand in for, so both columns count.
+       SELECT e.user_id
+         FROM iam.employees e
+         JOIN iam.employee_positions ep
+           ON ep.employee_id = e.id AND ep.is_current
+         JOIN iam.position_permissions pp
+           ON pp.position_id IN (ep.position_id, ep.delegatee_position_id)
+        WHERE e.is_current AND e.user_id IS NOT NULL
+          AND pp.permission_id IN (SELECT id FROM target)
+       UNION
+       -- 3. Position TYPE grants — where admin-created positions keep theirs.
+       SELECT e.user_id
+         FROM iam.employees e
+         JOIN iam.employee_positions ep
+           ON ep.employee_id = e.id AND ep.is_current
+         JOIN iam.positions p
+           ON p.id IN (ep.position_id, ep.delegatee_position_id)
+         JOIN iam.position_type_permissions ptp
+           ON ptp.position_type_id = p.position_type_id
+        WHERE e.is_current AND e.user_id IS NOT NULL
+          AND ptp.permission_id IN (SELECT id FROM target)
+       UNION
+       -- 4. super_admin passes every freight permission check, so mirror that
+       --    here or admins go blind on desks nobody else has been granted yet.
+       SELECT e.user_id
+         FROM iam.employees e
+         JOIN iam.user_roles ur ON ur.user_id = e.user_id
+         JOIN iam.roles r ON r.id = ur.role_id
+        WHERE e.is_current AND e.user_id IS NOT NULL
+          AND r.key = 'super_admin'`,
+      [permissionKeys],
+    );
+    return rows.map((r) => r.userId);
   }
 
   async createOrganizationUser(
diff --git a/apps/edr-freight-api/src/modules/billing/billing.controller.ts b/apps/edr-freight-api/src/modules/billing/billing.controller.ts
index ea43c9c74..810c1a55a 100644
--- a/apps/edr-freight-api/src/modules/billing/billing.controller.ts
+++ b/apps/edr-freight-api/src/modules/billing/billing.controller.ts
@@ -1,22 +1,36 @@
 import {
+  BadRequestException,
+  Body,
   Controller,
   Get,
   Param,
   ParseUUIDPipe,
+  Post,
   Query,
   Res,
+  UploadedFile,
+  UseInterceptors,
 } from "@nestjs/common";
-import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+import { FileInterceptor } from "@nestjs/platform-express";
+import {
+  ApiBearerAuth,
+  ApiConsumes,
+  ApiOperation,
+  ApiTags,
+} from "@nestjs/swagger";
 import type { Response } from "express";
 
 import { CurrentUser } from "@edr/api-common";
 import type { TCurrentUser } from "@tria-plc/api-common/modules/auth/types/current-user.type";
 
 import { BookingStaff } from "../../common/booking-guards";
+import { resolveAuthUserId } from "../../common/resolve-auth-user-id";
 import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { actorLabel } from "../warehouses/current-actor.util";
 import { UserTradeAccessService } from "../user-trade-access/user-trade-access.service";
 import { BillingService } from "./billing.service";
 import { FilterInvoiceDto } from "./dto/filter-invoice.dto";
+import { IssueMemoDto } from "./dto/issue-memo.dto";
 
 @ApiTags("billing")
 @Controller("billing")
@@ -25,6 +39,8 @@ import { FilterInvoiceDto } from "./dto/filter-invoice.dto";
 @BookingStaff([
   FREIGHT_PERMS.invoices.view,
   FREIGHT_PERMS.invoices.export,
+  FREIGHT_PERMS.invoices.confirmOffline,
+  FREIGHT_PERMS.invoices.memoIssue,
 ])
 @ApiBearerAuth()
 export class BillingController {
@@ -50,17 +66,84 @@ export class BillingController {
     });
   }
 
+  @Get("invoices/summary")
+  @ApiOperation({
+    summary:
+      "Total collected (paidAmount) across every filtered invoice, grouped by currency",
+  })
+  async collectedSummary(
+    @Query() query: FilterInvoiceDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    const allowed =
+      await this.userTradeAccessService.resolveAllowedDirections(user);
+    return this.billingService.collectedSummary({
+      ...query,
+      tradeDirections: allowed ?? undefined,
+    });
+  }
+
   @Get("invoices/:id")
   @ApiOperation({ summary: "Get an invoice with its line items" })
   findById(@Param("id", ParseUUIDPipe) id: string) {
     return this.billingService.findById(id);
   }
 
+  @Get("offline-usd")
+  @ApiOperation({
+    summary:
+      "Finance worklist: USD and ETB invoices settled manually (bank transfer / counter), with booking pay-window context",
+  })
+  findOfflineUsd(@Query() query: FilterInvoiceDto) {
+    return this.billingService.findOfflineUsdPaginated(query);
+  }
+
+  @Post("invoices/:id/confirm-offline")
+  @BookingStaff(FREIGHT_PERMS.invoices.confirmOffline)
+  @UseInterceptors(FileInterceptor("file"))
+  @ApiConsumes("multipart/form-data")
+  @ApiOperation({
+    summary:
+      "Finance confirms an invoice (USD or ETB) paid manually — slip file required, settles the full balance",
+  })
+  confirmOffline(
+    @Param("id", ParseUUIDPipe) id: string,
+    @UploadedFile() file: Express.Multer.File | undefined,
+    @Body("reference") reference: string | undefined,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.billingService.confirmOfflinePayment(id, file, {
+      reference: reference?.trim() || null,
+      userId: resolveAuthUserId(user),
+      userName: actorLabel(user) ?? null,
+    });
+  }
+
+  @Post("invoices/:id/memo")
+  @BookingStaff(FREIGHT_PERMS.invoices.memoIssue)
+  @ApiOperation({
+    summary:
+      "Issue a credit or debit memo against a registered invoice (MoR DEB/CRE). Filing-equivalent — the auto-submit sweep picks it up like any other issued invoice.",
+  })
+  issueMemo(@Param("id", ParseUUIDPipe) id: string, @Body() dto: IssueMemoDto) {
+    return this.billingService.issueMemo(id, dto);
+  }
+
   @Get("invoices/:id/document")
   @BookingStaff(FREIGHT_PERMS.invoices.export)
-  @ApiOperation({ summary: "Download the sealed invoice PDF" })
-  async document(@Param("id", ParseUUIDPipe) id: string, @Res() res: Response) {
-    const { filename, buffer } = await this.billingService.document(id);
+  @ApiOperation({
+    summary:
+      'Download the sealed invoice PDF. ?format=a4 (default) or ?format=thermal for the 80mm thermal layout (ADD-P001).',
+  })
+  async document(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Query("format") format: string | undefined,
+    @Res() res: Response,
+  ) {
+    if (format !== undefined && format !== "a4" && format !== "thermal") {
+      throw new BadRequestException(`Unsupported format "${format}" — use "a4" or "thermal".`);
+    }
+    const { filename, buffer } = await this.billingService.document(id, format === "thermal" ? "thermal" : "a4");
     sendPdf(res, filename, buffer);
   }
 
diff --git a/apps/edr-freight-api/src/modules/billing/billing.module.ts b/apps/edr-freight-api/src/modules/billing/billing.module.ts
index a67e6f6ba..06849d560 100644
--- a/apps/edr-freight-api/src/modules/billing/billing.module.ts
+++ b/apps/edr-freight-api/src/modules/billing/billing.module.ts
@@ -13,17 +13,21 @@ import { InvoiceRepository } from "./invoice.repository";
 import { InvoiceLineRepository } from "./invoice-line.repository";
 import { PaymentModule } from "../payment/payment.module";
 import { CompaniesModule } from "../companies/companies.module";
+import { FilesModule } from "../files/files.module";
 
 @Module({
   imports: [
     TypeOrmModule.forFeature([Invoice, InvoiceLine]),
     forwardRef(() => PaymentModule),
-    CompaniesModule,
+    // Cycles back via ShippingLineCompaniesModule, which imports this module.
+    forwardRef(() => CompaniesModule),
     DocumentsModule,
     UserTradeAccessModule,
+    FilesModule,
   ],
   controllers: [BillingController, PortalBillingController, PaymentController],
   providers: [BillingService, InvoiceRepository, InvoiceLineRepository],
   exports: [BillingService],
 })
 export class BillingModule {}
+  
\ No newline at end of file
diff --git a/apps/edr-freight-api/src/modules/billing/billing.service.spec.ts b/apps/edr-freight-api/src/modules/billing/billing.service.spec.ts
index 6e25c72aa..c5cc9a81e 100644
--- a/apps/edr-freight-api/src/modules/billing/billing.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/billing/billing.service.spec.ts
@@ -79,6 +79,9 @@ describe("BillingService.generateInvoice", () => {
       {} as never, // payment
       {} as never, // companies
       {} as never, // invoiceDocuments
+      {} as never, // files
+      { get: () => undefined } as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
   });
 
@@ -117,6 +120,160 @@ describe("BillingService.generateInvoice", () => {
   });
 });
 
+describe("BillingService.issueMemo", () => {
+  const ORIGINAL_ID = "original-invoice-1";
+
+  function originalInvoice(overrides: Record<string, unknown> = {}) {
+    return {
+      id: ORIGINAL_ID,
+      invoiceNumber: "INV-20260807-00042",
+      eimsIrn: "irn-value",
+      eimsDocumentType: "INV",
+      eimsStatus: "REGISTERED",
+      source: Freight.InvoiceSource.Booking,
+      sourceId: "booking-1",
+      companyId: "company-1",
+      companyProfileId: "profile-1",
+      shippingLineCompanyId: null,
+      currency: "ETB",
+      totalAmount: 1500,
+      lines: [
+        { chargeType: "RAIL_FREIGHT", description: "Rail freight", quantity: 2, unitRate: 500, amount: 1000, currency: "ETB", metadata: null },
+        { chargeType: "HAZARD_SURCHARGE", description: "Hazard surcharge", quantity: 2, unitRate: 250, amount: 500, currency: "ETB", metadata: null },
+      ],
+      ...overrides,
+    };
+  }
+
+  function build(original: ReturnType<typeof originalInvoice>) {
+    const savedLines: unknown[] = [];
+    const manager = makeManager(savedLines);
+    const dataSource = {
+      transaction: jest.fn().mockImplementation((cb: (mg: unknown) => unknown) => cb(manager)),
+      manager,
+    };
+    const invoices = { findById: jest.fn().mockResolvedValue(original) };
+    const invoiceLines = { findAll: jest.fn().mockResolvedValue(original.lines) };
+    const service = new BillingService(
+      dataSource as never,
+      invoices as never,
+      invoiceLines as never,
+      makeEvents() as never,
+      {} as never,
+      {} as never,
+      {} as never,
+      {} as never,
+      { get: () => undefined } as never,
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
+    );
+    return { service, manager, savedLines };
+  }
+
+  it("creates a settled credit memo copying the original's lines, linked via relatedInvoiceId", async () => {
+    const { service, savedLines } = build(originalInvoice());
+
+    const memo = await service.issueMemo(ORIGINAL_ID, { type: "CRE", reason: "Overbilled freight charge" });
+
+    expect(memo.invoiceNumber).toMatch(/^CRE-\d{8}-00001$/);
+    expect(memo.totalAmount).toBe(1500);
+    expect(memo.status).toBe(Freight.InvoiceStatus.Paid);
+    expect((memo as unknown as Record<string, unknown>).eimsDocumentType).toBe("CRE");
+    expect((memo as unknown as Record<string, unknown>).eimsReason).toBe("Overbilled freight charge");
+    expect((memo as unknown as Record<string, unknown>).relatedInvoiceId).toBe(ORIGINAL_ID);
+    expect((memo as unknown as Record<string, unknown>).paidAmount).toBe(1500);
+    expect((memo as unknown as Record<string, unknown>).balanceAmount).toBe(0);
+    expect(savedLines).toHaveLength(2);
+  });
+
+  it("creates an open, unpaid debit memo — a genuine new receivable, not force-settled", async () => {
+    const { service } = build(originalInvoice());
+
+    const memo = await service.issueMemo(ORIGINAL_ID, { type: "DEB", reason: "Additional handling fee" });
+
+    expect(memo.invoiceNumber).toMatch(/^DEB-\d{8}-00001$/);
+    expect(memo.status).toBe(Freight.InvoiceStatus.Pending);
+    expect(memo.balanceAmount).toBe(1500);
+    expect(memo.paidAmount).toBe(0);
+  });
+
+  it("keys the memo's sourceId to the original invoice's own id, not the original's sourceId", async () => {
+    const { service } = build(originalInvoice());
+
+    const memo = await service.issueMemo(ORIGINAL_ID, { type: "CRE", reason: "test" });
+
+    expect(memo.sourceId).toBe(ORIGINAL_ID);
+    expect(memo.sourceId).not.toBe("booking-1");
+  });
+
+  it("allows a partial memo with explicit lines instead of copying the original", async () => {
+    const { service } = build(originalInvoice());
+
+    const memo = await service.issueMemo(ORIGINAL_ID, {
+      type: "CRE",
+      reason: "Partial credit",
+      lines: [{ chargeType: "RAIL_FREIGHT", quantity: 1, unitRate: 200, amount: 200 }],
+    });
+
+    expect(memo.totalAmount).toBe(200);
+  });
+
+  it("refuses a memo against an invoice never registered with EIMS", async () => {
+    const { service } = build(originalInvoice({ eimsIrn: null }));
+
+    await expect(service.issueMemo(ORIGINAL_ID, { type: "CRE", reason: "x" })).rejects.toMatchObject({
+      response: expect.objectContaining({ code: "EIMS_RELATED_INVOICE_NOT_REGISTERED" }),
+    });
+  });
+
+  it("refuses a memo against a memo", async () => {
+    const { service } = build(originalInvoice({ eimsDocumentType: "CRE" }));
+
+    await expect(service.issueMemo(ORIGINAL_ID, { type: "DEB", reason: "x" })).rejects.toThrow(
+      "cannot issue a memo against a memo",
+    );
+  });
+
+  it("refuses a memo against an EIMS-cancelled invoice", async () => {
+    const { service } = build(originalInvoice({ eimsStatus: "CANCELLED" }));
+
+    await expect(service.issueMemo(ORIGINAL_ID, { type: "CRE", reason: "x" })).rejects.toThrow(
+      "cancelled with EIMS",
+    );
+  });
+
+  it("refuses a credit memo whose total exceeds the original", async () => {
+    const { service } = build(originalInvoice({ totalAmount: 1500 }));
+
+    await expect(
+      service.issueMemo(ORIGINAL_ID, {
+        type: "CRE",
+        reason: "too much",
+        lines: [{ chargeType: "RAIL_FREIGHT", quantity: 1, unitRate: 2000, amount: 2000 }],
+      }),
+    ).rejects.toThrow(/exceeds/);
+  });
+
+  it("does NOT bound a debit memo by the original's total — it is a new charge, not a refund", async () => {
+    const { service } = build(originalInvoice({ totalAmount: 1500 }));
+
+    const memo = await service.issueMemo(ORIGINAL_ID, {
+      type: "DEB",
+      reason: "additional charge",
+      lines: [{ chargeType: "RAIL_FREIGHT", quantity: 1, unitRate: 5000, amount: 5000 }],
+    });
+
+    expect(memo.totalAmount).toBe(5000);
+  });
+
+  it("refuses a blank reason", async () => {
+    const { service } = build(originalInvoice());
+
+    await expect(service.issueMemo(ORIGINAL_ID, { type: "CRE", reason: "   " })).rejects.toThrow(
+      "requires a reason",
+    );
+  });
+});
+
 describe("BillingService.markInvoiceAsPaid", () => {
   it("marks the invoice PAID, stamps amounts/paidAt, links the payment, and emits ${source}.invoice.paid", async () => {
     const open = {
@@ -140,6 +297,9 @@ describe("BillingService.markInvoiceAsPaid", () => {
       {} as never, // payment
       {} as never, // companies
       {} as never, // invoiceDocuments
+      {} as never, // files
+      { get: () => undefined } as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
 
     await service.markInvoiceAsPaid("inv-1", "pay-1", mg as never);
@@ -193,6 +353,9 @@ describe("BillingService.markInvoiceAsPaid", () => {
       {} as never, // payment
       {} as never, // companies
       {} as never, // invoiceDocuments
+      {} as never, // files
+      { get: () => undefined } as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
 
     await service.markInvoiceAsPaid("inv-1", "pay-1", mg as never);
@@ -236,6 +399,9 @@ describe("BillingService.settleByPaymentId", () => {
       {} as never, // payment
       {} as never, // companies
       {} as never, // invoiceDocuments
+      {} as never, // files
+      { get: () => undefined } as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
     return { service, mg, events };
   }
@@ -347,6 +513,9 @@ describe("BillingService.recordPayment", () => {
       {} as never, // payment
       {} as never, // companies
       {} as never, // invoiceDocuments
+      {} as never, // files
+      { get: () => undefined } as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
     return { service, mg, events };
   }
@@ -462,6 +631,9 @@ describe("BillingService.expirePayable — locked write runs in a transaction",
       {} as never,
       {} as never,
       {} as never,
+      {} as never,
+      {} as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
     return { service, defaultManager, txManager, transaction };
   };
@@ -533,6 +705,9 @@ describe("BillingService.issuePayable", () => {
       {} as never,
       {} as never,
       {} as never,
+      {} as never,
+      {} as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
     return { service, manager };
   };
@@ -622,6 +797,9 @@ describe("BillingService — CAC Bank (OTP debit)", () => {
       payment as never,
       {} as never,
       {} as never,
+      {} as never,
+      {} as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
     return { service, repo };
   };
@@ -669,11 +847,11 @@ describe("BillingService — CAC Bank (OTP debit)", () => {
   });
 });
 
-describe("BillingService — CBE bill amounts round UP to whole birr", () => {
-  // CBE bills whole birr. Ceil, never Math.round: a .40 balance rounded down
-  // settles 0.40 short while markInvoiceAsPaid still writes paidAmount =
-  // totalAmount — money missing from the bank with the books saying paid.
-  // payInvoice and billQuery must agree, or /cbe/payment sees a mismatch.
+describe("BillingService — CBE bill amounts carry cents, never rounded", () => {
+  // CBE settles to the cent (/cbe/payment gates on amountsMatchToTheCent), so the
+  // bill must quote the exact balance. Rounding UP overcharged the payer by up to
+  // a birr; rounding DOWN underpaid while markInvoiceAsPaid still wrote paidAmount
+  // = totalAmount. payInvoice and billQuery must agree, or /cbe/payment mismatches.
   const invoice = {
     id: "inv-1",
     status: Freight.InvoiceStatus.Pending,
@@ -682,9 +860,9 @@ describe("BillingService — CBE bill amounts round UP to whole birr", () => {
     type: "PREPAID",
     invoiceNumber: "INV-20260101-00001",
     currency: "ETB",
-    // .40 — the case Math.round gets wrong (rounds down, underpays).
-    balanceAmount: 12345.4,
-    totalAmount: 12345.4,
+    // .43 — cents that must survive all the way to the bill.
+    balanceAmount: 12345.43,
+    totalAmount: 12345.43,
     company: { name: "Acme PLC" },
     paymentId: null,
     dueAt: null,
@@ -703,11 +881,14 @@ describe("BillingService — CBE bill amounts round UP to whole birr", () => {
       payment as never,
       {} as never,
       {} as never,
+      {} as never,
+      {} as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
     );
     return { service, repo };
   };
 
-  it("opens the intent for the ceiled balance, never below it", async () => {
+  it("opens the intent for the exact balance, cents included", async () => {
     const initiate = jest.fn().mockResolvedValue({
       intentId: "intent-1",
       immediateSuccess: false,
@@ -718,16 +899,137 @@ describe("BillingService — CBE bill amounts round UP to whole birr", () => {
     await service.payInvoice("inv-1", { method: "CBE_BILL" });
 
     expect(initiate).toHaveBeenCalledWith(
-      expect.objectContaining({ amountMinor: 12346 }),
+      expect.objectContaining({ amountMinor: 12345.43 }),
     );
   });
 
-  it("quotes the same ceiled amount on bill-query as payInvoice opened", async () => {
+  it("quotes the same exact amount on bill-query as payInvoice opened", async () => {
     const { service } = build();
 
     await expect(service.billQuery("booking-1")).resolves.toMatchObject({
       stillPayable: true,
-      currentAmountMinor: 12346,
+      currentAmountMinor: 12345.43,
     });
   });
 });
+
+describe("BillingService.document", () => {
+  const invoiceRow = (over: Record<string, unknown> = {}) => ({
+    id: "inv-1",
+    invoiceNumber: "INV-20260812-00001",
+    source: "booking",
+    sourceId: "booking-1",
+    status: Freight.InvoiceStatus.Pending,
+    type: "freight",
+    currency: "ETB",
+    subtotalAmount: 100,
+    taxAmount: 0,
+    totalAmount: 100,
+    paidAmount: 0,
+    balanceAmount: 100,
+    issuedAt: new Date(2026, 7, 12),
+    dueAt: new Date(2026, 7, 19),
+    eimsIrn: null,
+    eimsSignedQr: null,
+    company: { name: "ABC Trading PLC", tin: "0999930000", vatNumber: "123475885858" },
+    ...over,
+  });
+
+  const build = (invoice: Record<string, unknown>) => {
+    const render = jest.fn().mockResolvedValue({ filename: "x.pdf", buffer: Buffer.from("") });
+    const renderThermal = jest.fn().mockResolvedValue({ filename: "x-thermal.pdf", buffer: Buffer.from("") });
+    const service = new BillingService(
+      {} as never,
+      { findById: jest.fn().mockResolvedValue(invoice) } as never,
+      { findAll: jest.fn().mockResolvedValue([]) } as never,
+      {} as never,
+      {} as never,
+      {} as never,
+      { render, renderThermal } as never,
+      {} as never,
+      {
+        get: (key: string) =>
+          key === "eims"
+            ? { tin: "0053481357", invoice: { sellerVatNumber: "43256663343256663322" } }
+            : undefined,
+      } as never, // config
+      { isEnabled: async () => true, enabledCurrencies: async () => ["ETB", "USD"] } as never, // manualPaymentSettings
+    );
+    return { service, render, renderThermal };
+  };
+
+  it("adds no EIMS IRN row and no QR for an unregistered invoice", async () => {
+    const { service, render } = build(invoiceRow());
+
+    await service.document("inv-1");
+
+    const model = render.mock.calls[0][0];
+    expect(model.summary.find((r: { label: string }) => r.label === "EIMS IRN")).toBeUndefined();
+    expect(model.qrImageUrl).toBeNull();
+  });
+
+  it("shows the buyer's name, TIN and VAT number on every invoice", async () => {
+    const { service, render } = build(invoiceRow());
+
+    await service.document("inv-1");
+
+    const model = render.mock.calls[0][0];
+    expect(model.summary).toContainEqual({ label: "Buyer", value: "ABC Trading PLC" });
+    expect(model.summary).toContainEqual({ label: "Buyer TIN", value: "0999930000" });
+    expect(model.summary).toContainEqual({ label: "Buyer VAT No.", value: "123475885858" });
+  });
+
+  it("omits the VAT row when the buyer company has none", async () => {
+    const { service, render } = build(invoiceRow({ company: { name: "Acme", tin: "0011223344" } }));
+
+    await service.document("inv-1");
+
+    const model = render.mock.calls[0][0];
+    expect(model.summary.find((r: { label: string }) => r.label === "Buyer VAT No.")).toBeUndefined();
+  });
+
+  it("shows EDR's own seller TIN and VAT number from EIMS config", async () => {
+    const { service, render } = build(invoiceRow());
+
+    await service.document("inv-1");
+
+    const model = render.mock.calls[0][0];
+    expect(model.summary).toContainEqual({ label: "Seller TIN", value: "0053481357" });
+    expect(model.summary).toContainEqual({
+      label: "Seller VAT No.",
+      value: "43256663343256663322",
+    });
+  });
+
+  it("adds the EIMS IRN to the summary and renders the QR for a registered invoice", async () => {
+    const { service, render } = build(
+      invoiceRow({ eimsIrn: "IRN-123", eimsSignedQr: "signed-payload" }),
+    );
+
+    await service.document("inv-1");
+
+    const model = render.mock.calls[0][0];
+    expect(model.summary).toContainEqual({ label: "EIMS IRN", value: "IRN-123" });
+    expect(model.qrImageUrl).toBe("data:image/png;base64,signed-payload");
+  });
+
+  it("calls render (not renderThermal) for the default format", async () => {
+    const { service, render, renderThermal } = build(invoiceRow());
+    jest.spyOn(service as never, "toDocumentModel").mockResolvedValue({} as never);
+
+    await service.document("inv-1");
+
+    expect(render).toHaveBeenCalledTimes(1);
+    expect(renderThermal).not.toHaveBeenCalled();
+  });
+
+  it("calls renderThermal (not render) for format 'thermal'", async () => {
+    const { service, render, renderThermal } = build(invoiceRow());
+    jest.spyOn(service as never, "toDocumentModel").mockResolvedValue({} as never);
+
+    await service.document("inv-1", "thermal");
+
+    expect(renderThermal).toHaveBeenCalledTimes(1);
+    expect(render).not.toHaveBeenCalled();
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/billing/billing.service.ts b/apps/edr-freight-api/src/modules/billing/billing.service.ts
index 5051afd6e..d64361bf8 100644
--- a/apps/edr-freight-api/src/modules/billing/billing.service.ts
+++ b/apps/edr-freight-api/src/modules/billing/billing.service.ts
@@ -1,4 +1,5 @@
 import { Freight, PaymentReferenceType } from "@edr/types";
+import { ConfigService } from "@nestjs/config";
 import {
   BadRequestException,
   forwardRef,
@@ -8,16 +9,26 @@ import {
   NotFoundException,
 } from "@nestjs/common";
 import { EventEmitter2 } from "@nestjs/event-emitter";
-import { DataSource, EntityManager, In } from "typeorm";
+import { logCtx } from "@edr/api-common";
+import { DataSource, EntityManager, In, SelectQueryBuilder } from "typeorm";
 
 import { Booking } from "../bookings/entities/booking.entity";
+// Entity-only import (no module edge): portal reads resolve shipping-line
+// payers straight off the table.
+import { ShippingLineCompany } from "../shipping-lines/entities/shipping-line-company.entity";
+import { ShippingLineCredit } from "../shipping-lines/entities/shipping-line-credit.entity";
+import { ManualPaymentSettingsService } from "../payment-settings/manual-payment-settings.service";
+import { EimsConfig } from "../../config/eims.config";
 import { CompaniesService } from "../companies/companies.service";
+import { EimsInvoiceStatus } from "../eims/eims-registration.types";
+import { FilesService } from "../files/files.service";
 import { applyBookingRefDirectionScope } from "../user-trade-access/trade-scope.util";
 import { PaymentService } from "../payment/payment.service";
 import { InitiateResponseDto, IntentStatusDto } from "../payment/payments.dto";
 import {
   InvoiceDocumentModel,
   InvoiceDocumentService,
+  pngDataUrl,
 } from "./documents/invoice-document.service";
 import { InvoiceLine } from "./entities/invoice-line.entity";
 import { Invoice, InvoicePayment } from "./entities/invoice.entity";
@@ -35,6 +46,22 @@ export interface PayInvoiceOptions {
   failureUrl?: string;
 }
 
+/** Booking context attached to a finance offline-USD invoice row. */
+export interface OfflineUsdBookingInfo {
+  id: string;
+  reference: string;
+  tradeDirection: string | null;
+  paymentDeadline: Date | null;
+  paymentStatus: string;
+}
+
+/** Row shape of the manual-payments worklist. */
+export type OfflineUsdInvoiceRow = Invoice & {
+  booking: OfflineUsdBookingInfo | null;
+  /** Shipping-line credit invoices span many bookings — one entry per credit. */
+  bookings: { id: string; reference: string; tradeDirection: string | null }[];
+};
+
 /** A single manual/offline settlement to record against an invoice. */
 export interface RecordPaymentInput {
   /** Amount settled by this payment; must be > 0. */
@@ -102,8 +129,16 @@ export interface GenerateInvoiceInput {
   sourceId: string;
   /** What the invoice is for (e.g. "prepaid", "credit"). */
   type: string;
-  companyId: string;
-  companyProfileId: string;
+  /** The customer billed. Omit only when billing a shipping line instead. */
+  companyId?: string | null;
+  companyProfileId?: string | null;
+  /**
+   * The shipping line billed, for an invoice covering batched shipping-line
+   * credits. Mutually exclusive with `companyId` — the DB enforces this via
+   * `chk_invoices_single_payer`, and {@link createInvoice} rejects a payload
+   * setting both or neither before it ever reaches the constraint.
+   */
+  shippingLineCompanyId?: string | null;
   lines: InvoiceLineInput[];
   currency?: string;
   /** Explicit pre-tax subtotal; defaults to the sum of line amounts. */
@@ -122,6 +157,18 @@ export interface GenerateInvoiceInput {
   status?: Freight.InvoiceStatus;
 }
 
+/** MoR `DocumentDetails.Type` for a memo — see `EIMS_DOCUMENT_TYPES` in `eims-invoice.mapper.ts`. */
+export type MemoType = "CRE" | "DEB";
+
+/** Everything needed to issue a credit or debit memo against an already-registered invoice. */
+export interface IssueMemoInput {
+  type: MemoType;
+  /** Why the memo was issued — required by MoR as `DocumentDetails.Reason`. */
+  reason: string;
+  /** Omit to copy every line of the original verbatim (a full reversal/charge, the common case). */
+  lines?: InvoiceLineInput[];
+}
+
 /** Payload broadcast on `${source}.invoice.<event>`. */
 export interface InvoiceEventPayload {
   invoiceId: string;
@@ -129,8 +176,11 @@ export interface InvoiceEventPayload {
   source: Freight.InvoiceSource;
   sourceId: string;
   type: string;
-  companyId: string;
-  companyProfileId: string;
+  /** Null when the payer is a shipping line rather than a customer company. */
+  companyId: string | null;
+  companyProfileId: string | null;
+  /** Set only on shipping-line invoices; mutually exclusive with `companyId`. */
+  shippingLineCompanyId?: string | null;
   totalAmount: number;
   currency: string;
   status: Freight.InvoiceStatus;
@@ -150,6 +200,9 @@ export class BillingService {
     private readonly payment: PaymentService,
     private readonly companies: CompaniesService,
     private readonly invoiceDocuments: InvoiceDocumentService,
+    private readonly files: FilesService,
+    private readonly config: ConfigService,
+    private readonly manualPaymentSettings: ManualPaymentSettingsService,
   ) { }
 
   // ── Reads ──────────────────────────────────────────────────────────────────
@@ -164,6 +217,40 @@ export class BillingService {
    * company (customer detail "Invoices" tab) and/or status/search (global
    * invoices page).
    */
+  /** Same list filters `findAllPaginated` and `collectedSummary` both narrow by. */
+  private applyInvoiceFilters(
+    qb: SelectQueryBuilder<Invoice>,
+    filter: {
+      companyId?: string;
+      status?: Freight.InvoiceStatus;
+      search?: string;
+      tradeDirections?: string[];
+    },
+  ) {
+    if (filter.companyId) {
+      qb.andWhere("invoice.companyId = :companyId", {
+        companyId: filter.companyId,
+      });
+    }
+    if (filter.status) {
+      qb.andWhere("invoice.status = :status", { status: filter.status });
+    }
+    if (filter.search) {
+      qb.andWhere(
+        "(invoice.invoiceNumber ILIKE :search OR invoice.sourceId ILIKE :search)",
+        { search: `%${filter.search}%` },
+      );
+    }
+    if (filter.tradeDirections) {
+      applyBookingRefDirectionScope(
+        qb,
+        "invoice.source_id",
+        filter.tradeDirections,
+      );
+    }
+    return qb;
+  }
+
   async findAllPaginated(
     filter: {
       companyId?: string;
@@ -187,13 +274,126 @@ export class BillingService {
       .skip((page - 1) * pageSize)
       .take(pageSize);
 
-    if (filter.companyId) {
-      qb.andWhere("invoice.companyId = :companyId", {
-        companyId: filter.companyId,
-      });
-    }
+    this.applyInvoiceFilters(qb, filter);
+
+    const [items, total] = await qb.getManyAndCount();
+    return { items: await this.attachShippingLineCompanies(items), total };
+  }
+
+  /**
+   * Batch-hydrate `shippingLineCompany` for any invoice billed to a shipping
+   * line (`companyId` null). No relation on `Invoice` to eager-load — see the
+   * entity's doc comment — so this is a second query keyed off the ids
+   * already loaded, same shape as `company`.
+   */
+  private async attachShippingLineCompanies<T extends Invoice>(
+    invoices: T[],
+  ): Promise<T[]> {
+    const ids = [
+      ...new Set(
+        invoices
+          .map((i) => i.shippingLineCompanyId)
+          .filter((id): id is string => id != null),
+      ),
+    ];
+    if (!ids.length) return invoices;
+    const lines = await this.dataSource
+      .getRepository(ShippingLineCompany)
+      .find({ where: { id: In(ids) } });
+    const byId = new Map(lines.map((l) => [l.id, l]));
+    return invoices.map((invoice) => {
+      const line = invoice.shippingLineCompanyId
+        ? byId.get(invoice.shippingLineCompanyId)
+        : undefined;
+      return line
+        ? ({
+            ...invoice,
+            shippingLineCompany: {
+              id: line.id,
+              name: line.name,
+              email: line.email,
+              phoneNumber: line.phoneNumber,
+            },
+          } as T)
+        : invoice;
+    });
+  }
+
+  /**
+   * Total collected (`paidAmount`) across every invoice matching the same
+   * filters as `findAllPaginated`, grouped by currency — unpaginated, so the
+   * invoices summary card reflects the whole filtered set, not just the
+   * visible page.
+   */
+  async collectedSummary(
+    filter: {
+      companyId?: string;
+      status?: Freight.InvoiceStatus;
+      search?: string;
+      tradeDirections?: string[];
+    } = {},
+  ): Promise<Record<string, number>> {
+    const qb = this.dataSource
+      .getRepository(Invoice)
+      .createQueryBuilder("invoice")
+      .select("invoice.currency", "currency")
+      .addSelect("SUM(invoice.paidAmount)", "collected")
+      .groupBy("invoice.currency");
+
+    this.applyInvoiceFilters(qb, filter);
+
+    const rows: { currency: string; collected: string }[] =
+      await qb.getRawMany();
+
+    return Object.fromEntries(
+      rows.map((row) => [row.currency, Number(row.collected) || 0]),
+    );
+  }
+
+  /**
+   * Finance's manual-settlement worklist: USD invoices (paid by bank transfer,
+   * never through the gateway) and ETB invoices Finance settles by hand (bank
+   * transfer / counter) instead of the customer paying online. Open ones by
+   * default or a single status when filtered; both currencies unless
+   * `currency` narrows it. Booking-sourced rows carry the booking's reference,
+   * trade direction and pay-window deadline so the UI can show the countdown
+   * and link to the booking.
+   */
+  async findOfflineUsdPaginated(
+    filter: {
+      status?: Freight.InvoiceStatus;
+      search?: string;
+      currency?: "USD" | "ETB";
+      page?: number;
+      pageSize?: number;
+    } = {},
+  ): Promise<{ items: OfflineUsdInvoiceRow[]; total: number }> {
+    const page = filter.page && filter.page > 0 ? filter.page : 1;
+    const pageSize =
+      filter.pageSize && filter.pageSize > 0 ? filter.pageSize : 20;
+
+    // Only currencies whose manual-payment channel is switched on are listed:
+    // a row Finance cannot act on is noise, and the confirm endpoint would
+    // refuse it anyway. All off → nothing to work.
+    const enabled = await this.manualPaymentSettings.enabledCurrencies();
+    if (!enabled.length) return { items: [], total: 0 };
+    const currencies = filter.currency
+      ? enabled.filter((c) => c === filter.currency)
+      : enabled;
+    if (!currencies.length) return { items: [], total: 0 };
+
+    const qb = this.dataSource
+      .getRepository(Invoice)
+      .createQueryBuilder("invoice")
+      .leftJoinAndSelect("invoice.company", "company")
+      .where("UPPER(invoice.currency) IN (:...currencies)", { currencies })
+      .orderBy("invoice.issuedAt", "DESC")
+      .skip((page - 1) * pageSize)
+      .take(pageSize);
     if (filter.status) {
       qb.andWhere("invoice.status = :status", { status: filter.status });
+    } else {
+      qb.andWhere("invoice.status IN (:...open)", { open: OPEN_STATUSES });
     }
     if (filter.search) {
       qb.andWhere(
@@ -202,16 +402,141 @@ export class BillingService {
       );
     }
 
-    if (filter.tradeDirections) {
-      applyBookingRefDirectionScope(
-        qb,
-        "invoice.source_id",
-        filter.tradeDirections,
-      );
+    const [rawItems, total] = await qb.getManyAndCount();
+    const items = await this.attachShippingLineCompanies(rawItems);
+
+    const bookingIds = items
+      .filter((i) => i.source === "booking")
+      .map((i) => i.sourceId);
+    const bookings = bookingIds.length
+      ? await this.dataSource.getRepository(Booking).find({
+          where: { id: In(bookingIds) },
+          select: [
+            "id",
+            "reference",
+            "tradeDirection",
+            "paymentDeadline",
+            "paymentStatus",
+          ],
+        })
+      : [];
+    const byId = new Map(bookings.map((b) => [b.id, b]));
+
+    // Shipping-line credit invoices bill many bookings at once; each credit
+    // keeps its own booking link, so collect them per invoice.
+    const creditInvoiceIds = items
+      .filter((i) => i.source === Freight.InvoiceSource.ShippingLineCredit)
+      .map((i) => i.id);
+    const credits = creditInvoiceIds.length
+      ? await this.dataSource.getRepository(ShippingLineCredit).find({
+          where: { invoiceId: In(creditInvoiceIds) },
+          relations: { booking: true },
+        })
+      : [];
+    const bookingsByInvoice = new Map<
+      string,
+      OfflineUsdInvoiceRow["bookings"]
+    >();
+    for (const c of credits) {
+      if (!c.invoiceId || !c.booking) continue;
+      const list = bookingsByInvoice.get(c.invoiceId) ?? [];
+      list.push({
+        id: c.booking.id,
+        reference: c.booking.reference,
+        tradeDirection: c.booking.tradeDirection ?? null,
+      });
+      bookingsByInvoice.set(c.invoiceId, list);
     }
 
-    const [items, total] = await qb.getManyAndCount();
-    return { items, total };
+    return {
+      items: items.map((inv) => {
+        const b = byId.get(inv.sourceId);
+        return {
+          ...inv,
+          booking: b
+            ? {
+                id: b.id,
+                reference: b.reference,
+                tradeDirection: b.tradeDirection ?? null,
+                paymentDeadline: b.paymentDeadline ?? null,
+                paymentStatus: b.paymentStatus,
+              }
+            : null,
+          bookings: bookingsByInvoice.get(inv.id) ?? [],
+        } as OfflineUsdInvoiceRow;
+      }),
+      total,
+    };
+  }
+
+  /**
+   * Finance confirms an invoice (USD or ETB) as paid manually — bank transfer
+   * or counter payment. Refused when that currency's manual-payment channel is
+   * switched off in settings. Stores the slip against the invoice and settles the
+   * FULL outstanding balance through
+   * {@link recordPayment}, which flips the invoice to PAID and (for bookings)
+   * emits `booking.invoice.paid` — the same event an online payment fires, so
+   * the booking advances exactly as if it had been paid through the gateway.
+   *
+   * Guarded by the booking's pay window: past the deadline the booking expires
+   * like any unpaid one, so confirmation is refused.
+   */
+  async confirmOfflinePayment(
+    invoiceId: string,
+    file: Express.Multer.File | undefined,
+    input: {
+      reference?: string | null;
+      userId?: string | null;
+      userName?: string | null;
+    },
+  ): Promise<Invoice> {
+    const invoice = await this.invoices.findById(invoiceId);
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    // The channel is a setting, not a role: even a permitted user cannot
+    // settle by hand in a currency whose channel is switched off.
+    if (!(await this.manualPaymentSettings.isEnabled(invoice.currency))) {
+      throw new BadRequestException(
+        `Manual payment is disabled for ${invoice.currency ?? "this"} invoices. Enable it in Configuration → Manual payments first.`,
+      );
+    }
+    if (!file) {
+      throw new BadRequestException("The bank payment slip file is required.");
+    }
+
+    if (invoice.source === "booking") {
+      const booking = await this.dataSource.getRepository(Booking).findOne({
+        where: { id: invoice.sourceId },
+        select: ["id", "paymentDeadline"],
+      });
+      const deadline = booking?.paymentDeadline;
+      if (deadline && new Date(deadline).getTime() < Date.now()) {
+        throw new BadRequestException(
+          "The payment window has closed — this booking can no longer be confirmed as paid.",
+        );
+      }
+    }
+
+    const slip = await this.files.upload({
+      resource: "invoice",
+      resourceId: invoice.id,
+      code: "OFFLINE_PAYMENT_SLIP",
+      file,
+      title: "Bank payment slip",
+      uploadedByUserId: input.userId ?? null,
+      uploadedByName: input.userName ?? null,
+    });
+
+    return this.recordPayment(invoiceId, {
+      amount: Number(invoice.balanceAmount),
+      method: "BANK_TRANSFER",
+      reference: input.reference || slip.name,
+      metadata: {
+        offline: true,
+        slipFileId: slip.id,
+        confirmedByUserId: input.userId ?? null,
+        confirmedByName: input.userName ?? null,
+      },
+    });
   }
 
   /** Invoice header plus its line items. */
@@ -220,21 +545,30 @@ export class BillingService {
       relations: { company: true, companyProfile: true },
     });
     if (!invoice) throw new NotFoundException(`Invoice ${id} not found`);
+    const [hydrated] = await this.attachShippingLineCompanies([invoice]);
     const lines = await this.invoiceLines.findAll({
       where: { invoiceId: id },
       order: { createdAt: "ASC" },
     });
-    return { ...invoice, lines } as Invoice & { lines: InvoiceLine[] };
+    return { ...hydrated, lines } as Invoice & { lines: InvoiceLine[] };
   }
 
   // ── Documents (central PDF) ──────────────────────────────────────────────────
 
-  /** Sealed PDF invoice for any source, rendered by the shared document service. */
-  async document(id: string): Promise<{ filename: string; buffer: Buffer }> {
+  /**
+   * Sealed PDF invoice for any source, rendered by the shared document service. `format`
+   * validation (rejecting anything but `"a4"`/`"thermal"`) is the controller's job — an input
+   * boundary check, not a business rule.
+   */
+  async document(
+    id: string,
+    format: "a4" | "thermal" = "a4",
+  ): Promise<{ filename: string; buffer: Buffer }> {
     const invoice = await this.findById(id);
-    return this.invoiceDocuments.render(
-      this.toDocumentModel(invoice, "INVOICE"),
-    );
+    const model = await this.toDocumentModel(invoice, "INVOICE");
+    return format === "thermal"
+      ? this.invoiceDocuments.renderThermal(model)
+      : this.invoiceDocuments.render(model);
   }
 
   /** Sealed PDF receipt; available once any payment has been recorded. */
@@ -246,15 +580,41 @@ export class BillingService {
       );
     }
     return this.invoiceDocuments.render(
-      this.toDocumentModel(invoice, "RECEIPT"),
+      await this.toDocumentModel(invoice, "RECEIPT"),
     );
   }
 
+  /** Route + wagon count summary rows for a booking-sourced invoice; empty for every other source. */
+  private async bookingSummaryRows(
+    invoice: Invoice,
+  ): Promise<InvoiceDocumentModel["summary"]> {
+    if (invoice.source !== Freight.InvoiceSource.Booking) return [];
+    const booking = await this.dataSource.getRepository(Booking).findOne({
+      where: { id: invoice.sourceId },
+      relations: { originYard: true, destinationYard: true },
+    });
+    if (!booking) return [];
+    return [
+      {
+        label: "Route",
+        value:
+          booking.originYard && booking.destinationYard
+            ? `${booking.originYard.label} → ${booking.destinationYard.label}`
+            : null,
+      },
+      {
+        label: "Wagons",
+        value:
+          booking.wagonsRequired != null ? String(booking.wagonsRequired) : null,
+      },
+    ];
+  }
+
   /** Map a global invoice (+ lines) onto the source-agnostic document model. */
-  private toDocumentModel(
+  private async toDocumentModel(
     invoice: Invoice & { lines: InvoiceLine[] },
     kind: "INVOICE" | "RECEIPT",
-  ): InvoiceDocumentModel {
+  ): Promise<InvoiceDocumentModel> {
     const title = invoice.source
       ? invoice.source.charAt(0).toUpperCase() + invoice.source.slice(1)
       : "EDR";
@@ -272,6 +632,55 @@ export class BillingService {
     totals.push({ label: "Paid", amount: Number(invoice.paidAmount) });
     totals.push({ label: "Balance", amount: Number(invoice.balanceAmount) });
 
+    const summary: InvoiceDocumentModel["summary"] = [
+      // Buyer identity — was missing entirely; a MoR-registered invoice must show who it was
+      // filed against, not just the seller. VatNumber shown only when the company has one.
+      { label: "Buyer", value: invoice.company?.name ?? null },
+      { label: "Buyer TIN", value: invoice.company?.tin ?? null },
+      ...(invoice.company?.vatNumber
+        ? [{ label: "Buyer VAT No.", value: invoice.company.vatNumber }]
+        : []),
+      { label: "Status", value: invoice.status },
+      { label: "Type", value: invoice.type },
+      { label: "Reference", value: invoice.sourceId },
+      ...(await this.bookingSummaryRows(invoice)),
+      { label: "Currency", value: invoice.currency },
+      {
+        label: "Issued",
+        value: invoice.issuedAt
+          ? new Date(invoice.issuedAt).toLocaleDateString("en-GB")
+          : null,
+      },
+      {
+        label: "Due",
+        value: invoice.dueAt
+          ? new Date(invoice.dueAt).toLocaleDateString("en-GB")
+          : null,
+      },
+    ];
+
+    // Seller identity — EDR's own legal TIN/VAT live only in EIMS config (nowhere else in this
+    // codebase). Shown only when actually configured, same as the buyer VAT row.
+    const eimsCfg = this.config.get<EimsConfig>("eims");
+    if (eimsCfg?.tin) summary.push({ label: "Seller TIN", value: eimsCfg.tin });
+    if (eimsCfg?.invoice?.sellerVatNumber) {
+      summary.push({ label: "Seller VAT No.", value: eimsCfg.invoice.sellerVatNumber });
+    }
+
+    // MoR EIMS reference — only once actually registered, never a placeholder row.
+    if (invoice.eimsIrn) summary.push({ label: "EIMS IRN", value: invoice.eimsIrn });
+
+    // PNR — the CBE_BILL reference the customer pays against, written onto the booking at
+    // payment-initiation time (see initiatePayment()). Not a column on Invoice/Payment, so
+    // look it up by source id; only shown once a payment actually generated one.
+    if (invoice.source === Freight.InvoiceSource.Booking) {
+      const booking = await this.dataSource.getRepository(Booking).findOne({
+        where: { id: invoice.sourceId },
+        select: ["id", "pnrCode"],
+      });
+      if (booking?.pnrCode) summary.push({ label: "PNR", value: booking.pnrCode });
+    }
+
     return {
       kind,
       title,
@@ -279,24 +688,7 @@ export class BillingService {
       issuedAt: invoice.issuedAt ?? invoice.createdAt,
       status: invoice.status,
       currency: invoice.currency,
-      summary: [
-        { label: "Status", value: invoice.status },
-        { label: "Type", value: invoice.type },
-        { label: "Reference", value: invoice.sourceId },
-        { label: "Currency", value: invoice.currency },
-        {
-          label: "Issued",
-          value: invoice.issuedAt
-            ? new Date(invoice.issuedAt).toLocaleDateString("en-GB")
-            : null,
-        },
-        {
-          label: "Due",
-          value: invoice.dueAt
-            ? new Date(invoice.dueAt).toLocaleDateString("en-GB")
-            : null,
-        },
-      ],
+      summary,
       categoryHeader: "Charge type",
       lines: invoice.lines.map((l) => ({
         description: l.description ?? l.chargeType,
@@ -307,6 +699,7 @@ export class BillingService {
         currency: l.currency,
       })),
       totals,
+      qrImageUrl: invoice.eimsSignedQr ? pngDataUrl(invoice.eimsSignedQr) : null,
     };
   }
 
@@ -352,23 +745,61 @@ export class BillingService {
     });
   }
 
-  /** Invoices for the signed-in customer; empty when they have no company. */
+  /**
+   * Resolve a shipping-line company from the signed-in user (null for ordinary
+   * customers). Queried straight off the entity rather than through
+   * ShippingLineCompaniesService — that module already imports billing, so a
+   * service edge back would deepen the forwardRef cycle for one lookup.
+   */
+  private async resolveShippingLineCompanyId(
+    userId: string,
+  ): Promise<string | null> {
+    const line = await this.dataSource
+      .getRepository(ShippingLineCompany)
+      .findOne({ where: { userId } });
+    return line?.id ?? null;
+  }
+
+  /**
+   * Invoices for the signed-in portal user; empty when they have no company.
+   * A payer is either a customer company or a shipping line (enforced by the
+   * DB's single-payer check), so the two lookups cannot both match.
+   */
   async findForUser(
     userId: string,
     filter: { source?: string; sourceId?: string } = {},
   ): Promise<Invoice[]> {
     const companyId = await this.resolveCompanyId(userId);
-    return companyId ? this.findByCompany(companyId, filter) : [];
+    if (companyId) return this.findByCompany(companyId, filter);
+
+    const shippingLineCompanyId =
+      await this.resolveShippingLineCompanyId(userId);
+    if (!shippingLineCompanyId) return [];
+    return this.invoices.findAll({
+      where: {
+        shippingLineCompanyId,
+        ...(filter.source ? { source: filter.source } : {}),
+        ...(filter.sourceId ? { sourceId: filter.sourceId } : {}),
+      },
+      order: { createdAt: "DESC" },
+    });
   }
 
-  /** Company-scoped invoice detail (+ lines); 404 when not owned by the user. */
+  /** Payer-scoped invoice detail (+ lines); 404 when not owned by the user. */
   async findByIdForUser(
     id: string,
     userId: string,
   ): Promise<Invoice & { lines: InvoiceLine[] }> {
-    const companyId = await this.resolveCompanyId(userId);
     const invoice = await this.findById(id);
-    if (!companyId || invoice.companyId !== companyId) {
+    const ownedByCompany =
+      invoice.companyId != null &&
+      invoice.companyId === (await this.resolveCompanyId(userId));
+    const ownedByShippingLine =
+      !ownedByCompany &&
+      invoice.shippingLineCompanyId != null &&
+      invoice.shippingLineCompanyId ===
+        (await this.resolveShippingLineCompanyId(userId));
+    if (!ownedByCompany && !ownedByShippingLine) {
       throw new NotFoundException(`Invoice ${id} not found`);
     }
     return invoice;
@@ -435,11 +866,16 @@ export class BillingService {
 
   // ── Generation ───────────────────────────────────────────────────────────────
 
-  /** `<CODE>-YYYYMMDD-00001` — sequential per day & prefix, within the active transaction. */
-  private nextInvoiceNumber(mg: EntityManager): Promise<string> {
+  /**
+   * `<CODE>-YYYYMMDD-00001` — sequential per day & prefix, within the active transaction. `code`
+   * defaults to `INV`; a memo (`issueMemo`) uses `CRE`/`DEB` instead, which is its own independent
+   * daily sequence (different prefix hashes to a different advisory lock, see
+   * `nextDailyInvoiceNumber`) — not a collision risk with ordinary invoice numbers.
+   */
+  private nextInvoiceNumber(mg: EntityManager, code = "INV"): Promise<string> {
     return nextDailyInvoiceNumber(mg, {
       table: "freight.invoices",
-      code: "INV",
+      code,
     });
   }
 
@@ -458,19 +894,147 @@ export class BillingService {
     input: GenerateInvoiceInput,
     manager?: EntityManager,
   ): Promise<Invoice & { lines: InvoiceLine[] }> {
-    console.log("oooooooooo", input);
     const run = (mg: EntityManager) => this.createInvoice(input, mg);
     return manager ? run(manager) : this.dataSource.transaction(run);
   }
 
+  /**
+   * Issue a credit or debit memo against an already-registered invoice, per MoR's confirmed
+   * DEB/CRE filing mechanism (same `/v1/register` endpoint, `DocumentDetails.Type` + `Reason`,
+   * `ReferenceDetails.RelatedDocument` — see `eims-invoice.mapper.ts`). Reuses `createInvoice`
+   * unchanged: it has no side effects (no events, no notifications, no payment records — every
+   * event in this service fires from `runTransition` on a *transition*, not on create), so a memo
+   * is just an ordinary invoice with three extra columns set.
+   *
+   * `sourceId` is deliberately the *original invoice's own id*, not the original's `sourceId`
+   * (e.g. a booking id): `findPayable`, `expirePayable` and `billQuery` all resolve by
+   * `sourceId` with no `type` filter, so a memo sharing the booking's `sourceId` would be the
+   * newest matching row and could hijack a payer's balance at a CBE teller. An invoice's own
+   * `id` is never a value those lookups are ever queried with, so this isolates a memo from all
+   * of them regardless of its status — no `type`-based exclusion needed anywhere else.
+   *
+   * A credit note is created settled (PAID, balance 0) — nothing is ever collected against it, so
+   * leaving it payable would only add a phantom receivable that no payment flow will ever close.
+   * A debit note genuinely IS a new receivable and is created open/unpaid like any ordinary
+   * invoice (`createInvoice`'s own defaults: PENDING, `balanceAmount = totalAmount`) — it is
+   * findable and collectible through the normal invoice list/detail/payment tooling, safe from
+   * the CBE/booking-linked lookups above for the `sourceId` reason just given.
+   */
+  async issueMemo(
+    originalId: string,
+    input: IssueMemoInput,
+  ): Promise<Invoice & { lines: InvoiceLine[] }> {
+    const reason = input.reason?.trim();
+    if (!reason) {
+      throw new BadRequestException("A memo requires a reason.");
+    }
+
+    const original = await this.findById(originalId);
+    if (!original.eimsIrn) {
+      throw new BadRequestException({
+        code: "EIMS_RELATED_INVOICE_NOT_REGISTERED",
+        message: `Invoice ${original.invoiceNumber} was never registered with EIMS — nothing to reference.`,
+      });
+    }
+    if (original.eimsDocumentType && original.eimsDocumentType !== "INV") {
+      throw new BadRequestException(
+        `Invoice ${original.invoiceNumber} is itself a ${original.eimsDocumentType} — cannot issue a memo against a memo.`,
+      );
+    }
+    if (original.eimsStatus === EimsInvoiceStatus.Cancelled) {
+      throw new BadRequestException(
+        `Invoice ${original.invoiceNumber} was cancelled with EIMS — nothing to adjust.`,
+      );
+    }
+
+    const sourceLines = input.lines?.length ? input.lines : original.lines;
+    const lines: InvoiceLineInput[] = sourceLines.map((l) => ({
+      chargeType: l.chargeType,
+      description: l.description,
+      quantity: Number(l.quantity),
+      unitRate: Number(l.unitRate),
+      amount: Number(l.amount),
+      currency: l.currency,
+      metadata: l.metadata ?? null,
+    }));
+
+    const total = round2(lines.reduce((sum, l) => sum + Number(l.amount ?? 0), 0));
+    if (!(total > 0)) {
+      throw new BadRequestException("A memo must have a positive total.");
+    }
+    // Only a credit note is bounded by the original — it can only give back what was charged. A
+    // debit note is an additional charge, not a refund, so no such ceiling applies to it (do not
+    // assume the credit-note ceiling is correct for DEB).
+    if (input.type === "CRE" && total > Number(original.totalAmount)) {
+      throw new BadRequestException(
+        `Credit memo total (${total}) exceeds invoice ${original.invoiceNumber}'s total (${original.totalAmount}).`,
+      );
+    }
+
+    const code = input.type === "CRE" ? "CRE" : "DEB";
+    const settled = input.type === "CRE";
+
+    return this.dataSource.transaction(async (mg) => {
+      const memo = await this.createInvoice(
+        {
+          source: original.source as Freight.InvoiceSource,
+          sourceId: original.id,
+          type: input.type === "CRE" ? "credit_note" : "debit_note",
+          companyId: original.companyId,
+          companyProfileId: original.companyProfileId,
+          shippingLineCompanyId: original.shippingLineCompanyId,
+          lines,
+          currency: original.currency,
+          subtotalAmount: total,
+          taxAmount: 0,
+          totalAmount: total,
+          ...(settled ? { status: Freight.InvoiceStatus.Paid, dueAt: new Date() } : {}),
+        },
+        mg,
+        code,
+      );
+
+      const patch: Record<string, unknown> = {
+        eimsDocumentType: input.type,
+        eimsReason: reason,
+        relatedInvoiceId: original.id,
+        ...(settled
+          ? { paidAmount: memo.totalAmount, balanceAmount: 0, paidAt: new Date() }
+          : {}),
+      };
+      await mg.update(Invoice, memo.id, patch);
+
+      this.logger.log(
+        `Issued ${input.type} memo ${memo.invoiceNumber} (${memo.id}) against invoice ${original.invoiceNumber}`,
+      );
+      return { ...memo, ...patch } as Invoice & { lines: InvoiceLine[] };
+    });
+  }
+
   private async createInvoice(
     input: GenerateInvoiceInput,
     mg: EntityManager,
+    code = "INV",
   ): Promise<Invoice & { lines: InvoiceLine[] }> {
     const currency = input.currency ?? "ETB";
     const status = input.status ?? Freight.InvoiceStatus.Pending;
     const issued = status !== Freight.InvoiceStatus.Draft;
 
+    // Exactly one payer, checked here so a bad payload fails with a clear
+    // message instead of a raw `chk_invoices_single_payer` violation.
+    const billsCompany = Boolean(input.companyId);
+    const billsShippingLine = Boolean(input.shippingLineCompanyId);
+    if (billsCompany === billsShippingLine) {
+      throw new BadRequestException(
+        "An invoice must be billed to exactly one payer: either companyId or shippingLineCompanyId.",
+      );
+    }
+    if (billsCompany && !input.companyProfileId) {
+      throw new BadRequestException(
+        "companyProfileId is required when billing a company.",
+      );
+    }
+
     const lines = input.lines.map((l) => {
       const quantity = l.quantity ?? 1;
       const unitRate = l.unitRate ?? 0;
@@ -498,7 +1062,7 @@ export class BillingService {
         (input.dueInDays ?? DEFAULT_DUE_DAYS) * 24 * 60 * 60 * 1000,
       );
 
-    const invoiceNumber = await this.nextInvoiceNumber(mg);
+    const invoiceNumber = await this.nextInvoiceNumber(mg, code);
 
     const invoice = await mg.save(
       mg.create(Invoice, {
@@ -506,8 +1070,9 @@ export class BillingService {
         source: input.source,
         sourceId: input.sourceId,
         type: input.type,
-        companyId: input.companyId,
-        companyProfileId: input.companyProfileId,
+        companyId: input.companyId ?? null,
+        companyProfileId: input.companyProfileId ?? null,
+        shippingLineCompanyId: input.shippingLineCompanyId ?? null,
         subtotalAmount: round2(subtotalAmount),
         taxAmount: round2(taxAmount),
         totalAmount: round2(totalAmount),
@@ -801,6 +1366,24 @@ export class BillingService {
 
       await mg.update(Invoice, { id: invoice.id }, { status, ...extra });
 
+      // Every invoice status move in the app funnels through here — money
+      // changing state is the single most-asked question in support.
+      logCtx(
+        {
+          invoiceId: invoice.id,
+          invoiceNumber: invoice.invoiceNumber,
+          source: invoice.source,
+          sourceId: invoice.sourceId,
+          from: invoice.status,
+          to: status,
+          event,
+          amount: Number(invoice.totalAmount),
+          currency: invoice.currency,
+          paymentId: extra.paymentId ?? invoice.paymentId ?? undefined,
+        },
+        { path: "invoiceTransitions", mode: "push" },
+      );
+
       const updated = { ...invoice, ...extra, status } as Invoice;
       return {
         result: updated,
@@ -819,6 +1402,7 @@ export class BillingService {
       type: invoice.type,
       companyId: invoice.companyId,
       companyProfileId: invoice.companyProfileId,
+      shippingLineCompanyId: invoice.shippingLineCompanyId ?? null,
       totalAmount: invoice.totalAmount,
       currency: invoice.currency,
       status: invoice.status,
@@ -1170,6 +1754,21 @@ export class BillingService {
       throw new BadRequestException("Invoice has no outstanding balance.");
     }
 
+    logCtx(
+      {
+        invoiceId: invoice.id,
+        invoiceNumber: invoice.invoiceNumber,
+        source: invoice.source,
+        sourceId: invoice.sourceId,
+        companyId: invoice.companyId,
+        amountDue,
+        currency: invoice.currency,
+        method: opts.method ?? "TELEBIRR",
+        platform: opts.platform,
+      },
+      { path: "payment.payInvoice" },
+    );
+
     // CAC Bank is an OTP debit — the bank SMSes the code to this number, so it is
     // required up front (the payment service rejects it otherwise, as a 502 here).
     if (
@@ -1191,11 +1790,11 @@ export class BillingService {
       // service branches on a domain-specific reference type.
       referenceType: PaymentReferenceType.SHIPMENT,
       orderRef: invoice.invoiceNumber.replace(/-/g, "_"),
-      // Whole birr, always UP. CBE bills this amount verbatim, so it must never
-      // land below the outstanding balance — Math.round would let a .40 balance
-      // settle 0.40 short. Ceil overcharges by <1 birr instead, and the same
-      // ceil in billQuery keeps the quoted and debited amounts identical.
-      amountMinor: Math.ceil(Number(invoice.balanceAmount)),
+      // Exact balance, cents included. CBE bills this verbatim and /cbe/payment
+      // matches the debited amount to the cent (amountsMatchToTheCent), so any
+      // rounding here would overcharge the payer and leave the invoice balance
+      // non-zero. billQuery quotes the same unrounded value.
+      amountMinor: round2(Number(invoice.balanceAmount)),
       currency: invoice.currency,
       reason: `Payment for invoice ${invoice.invoiceNumber}`,
       method: opts.method ?? "TELEBIRR",
@@ -1293,7 +1892,24 @@ export class BillingService {
       // first on DESC, which would hand back an unissued invoice.
       order: { issuedAt: { direction: "DESC", nulls: "LAST" } },
     });
-    if (!invoice) return null;
+    if (!invoice) {
+      logCtx(
+        { paymentId, outcome: "no-invoice-for-payment" },
+        { path: "payment.settleInvoice" },
+      );
+      return null;
+    }
+
+    logCtx(
+      {
+        paymentId,
+        providerTxnId,
+        invoiceId: invoice.id,
+        invoiceNumber: invoice.invoiceNumber,
+        invoiceStatus: invoice.status,
+      },
+      { path: "payment.settleInvoice" },
+    );
 
     const settleable: Freight.InvoiceStatus[] = [
       ...OPEN_STATUSES,
@@ -1303,6 +1919,12 @@ export class BillingService {
       // Already PAID is the ordinary idempotent no-op (redelivery, or settled
       // inline by payInvoice). Anything else means money was captured with
       // nowhere to land — that needs a person, so say so loudly.
+      logCtx(
+        invoice.status === Freight.InvoiceStatus.Paid
+          ? "already-paid"
+          : "captured-with-nowhere-to-land",
+        { path: "payment.settleInvoice.outcome", mode: "set" },
+      );
       if (invoice.status !== Freight.InvoiceStatus.Paid) {
         this.logger.error(
           `Payment ${paymentId} succeeded but invoice ${invoice.invoiceNumber} ` +
@@ -1340,9 +1962,10 @@ export class BillingService {
     });
 
     if (open) {
-      // Ceil, matching payInvoice — the amount CBE quotes at the counter has to
-      // be the amount the intent was opened for, or /cbe/payment sees a mismatch.
-      const balance = Math.ceil(Number(open.balanceAmount ?? open.totalAmount));
+      // Unrounded, matching payInvoice — the amount CBE quotes at the counter has
+      // to be the amount the intent was opened for, to the cent, or /cbe/payment
+      // sees a mismatch.
+      const balance = round2(Number(open.balanceAmount ?? open.totalAmount));
       const expired = open.dueAt && open.dueAt.getTime() < Date.now();
       return {
         stillPayable: balance > 0 && !expired,
@@ -1377,7 +2000,7 @@ export class BillingService {
     return {
       stillPayable: false,
       payerName: latest.company?.name ?? null,
-      currentAmountMinor: Math.ceil(Number(latest.totalAmount)),
+      currentAmountMinor: round2(Number(latest.totalAmount)),
       currency: latest.currency,
       paymentReason: `Freight invoice ${latest.invoiceNumber}`,
       reason: closedInvoiceReason(latest.status),
diff --git a/apps/edr-freight-api/src/modules/billing/documents/documents.module.ts b/apps/edr-freight-api/src/modules/billing/documents/documents.module.ts
index c320a5d44..363cda3f0 100644
--- a/apps/edr-freight-api/src/modules/billing/documents/documents.module.ts
+++ b/apps/edr-freight-api/src/modules/billing/documents/documents.module.ts
@@ -7,7 +7,9 @@ import { PdfRenderService } from "./pdf-render.service";
  * Standalone document infrastructure — generic HTML→PDF plus the shared
  * invoice/receipt renderer. Has no domain dependencies, so any module (billing,
  * warehouses, …) can import it to print invoices without coupling to the
- * billing payment graph.
+ * billing payment graph. StampSettingsService is @Global (see
+ * StampSettingsModule) so InvoiceDocumentService can inject it without this
+ * module declaring an explicit import.
  */
 @Module({
   providers: [PdfRenderService, InvoiceDocumentService],
diff --git a/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.spec.ts b/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.spec.ts
new file mode 100644
index 000000000..ebdf51be1
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.spec.ts
@@ -0,0 +1,89 @@
+import { InvoiceDocumentModel, InvoiceDocumentService } from "./invoice-document.service";
+
+const model = (over: Partial<InvoiceDocumentModel> = {}): InvoiceDocumentModel => ({
+  kind: "INVOICE",
+  title: "Freight",
+  documentNumber: "INV-20260812-00001",
+  issuedAt: new Date(2026, 7, 12),
+  status: "PENDING",
+  currency: "ETB",
+  summary: [{ label: "Status", value: "PENDING" }],
+  lines: [],
+  totals: [{ label: "Total", amount: 100, grand: true }],
+  ...over,
+});
+
+describe("InvoiceDocumentService.buildHtml — EIMS QR", () => {
+  const service = new InvoiceDocumentService({} as never, {} as never, {} as never);
+
+  it("renders no QR block when qrImageUrl is unset", () => {
+    const html = service.buildHtml(model());
+    expect(html).not.toContain('class="qr"');
+  });
+
+  it("renders the QR image when qrImageUrl is set", () => {
+    const html = service.buildHtml(model({ qrImageUrl: "data:image/png;base64,QR" }));
+    expect(html).toContain('class="qr"');
+    expect(html).toContain('src="data:image/png;base64,QR"');
+  });
+
+  it("still shows the IRN text row via the ordinary summary grid", () => {
+    const html = service.buildHtml(
+      model({ summary: [{ label: "EIMS IRN", value: "IRN-123" }] }),
+    );
+    expect(html).toContain("EIMS IRN");
+    expect(html).toContain("IRN-123");
+  });
+
+  it("widens the summary's right margin only when a QR is present, to clear the QR block", () => {
+    // "summary-with-qr" also appears in the always-present <style> rule, so the check has to be
+    // the actual div's class attribute, not a bare substring match.
+    expect(service.buildHtml(model())).not.toContain('class="summary summary-with-qr"');
+    expect(service.buildHtml(model({ qrImageUrl: "data:image/png;base64,QR" }))).toContain(
+      'class="summary summary-with-qr"',
+    );
+  });
+});
+
+describe("InvoiceDocumentService.buildThermalHtml", () => {
+  const service = new InvoiceDocumentService({} as never, {} as never, {} as never);
+
+  it("renders no seal markup at all — dropped for thermal, not shrunk", () => {
+    const html = service.buildThermalHtml(model());
+    expect(html).not.toContain('class="seal"');
+    expect(html).not.toContain("seal-image");
+  });
+
+  it("renders the QR image when qrImageUrl is set, centered rather than absolutely positioned", () => {
+    const html = service.buildThermalHtml(model({ qrImageUrl: "data:image/png;base64,QR" }));
+    expect(html).toContain('class="qr"');
+    expect(html).toContain('src="data:image/png;base64,QR"');
+    expect(html).not.toContain("position: absolute");
+  });
+
+  it("wraps a long IRN summary value rather than truncating it", () => {
+    const irn = "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0";
+    const html = service.buildThermalHtml(model({ summary: [{ label: "EIMS IRN", value: irn }] }));
+    expect(html).toContain(irn);
+    expect(html).toContain("overflow-wrap: anywhere");
+  });
+
+  it("renders a line item as stacked description + qty x rate = amount, not a table row", () => {
+    const html = service.buildThermalHtml(
+      model({
+        lines: [{ description: "40ft container rail freight", quantity: 12, unitRate: 245683.95, amount: 2948207.4 }],
+      }),
+    );
+    expect(html).not.toContain("<table");
+    expect(html).not.toContain("<td");
+    expect(html).toContain("40ft container rail freight");
+    expect(html).toContain("12 x");
+    expect(html).toContain("2,948,207.4 Birr (ETB)");
+  });
+
+  it("uses fluid, full-width layout — no fixed-px A4 geometry", () => {
+    const html = service.buildThermalHtml(model());
+    expect(html).not.toContain("width: 330px");
+    expect(html).not.toContain("right: 160px");
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.ts b/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.ts
index 06d164bbd..0f8e4ee71 100644
--- a/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.ts
+++ b/apps/edr-freight-api/src/modules/billing/documents/invoice-document.service.ts
@@ -1,6 +1,10 @@
 import { Injectable } from "@nestjs/common";
 
+import { StampSettingsService } from "../../stamp-settings/stamp-settings.service";
+import { LogoSettingsService } from "../../logo-settings/logo-settings.service";
 import { PdfRenderService } from "./pdf-render.service";
+import { sealClass, sealImageCss, sealMarkup } from "./seal-markup.util";
+import { logoImageCss, logoMarkup } from "./logo-markup.util";
 import {
   PdfColor,
   assembleSinglePagePdf,
@@ -14,6 +18,36 @@ import {
 
 export type InvoiceDocumentKind = "INVOICE" | "RECEIPT";
 
+/**
+ * MoR returns `signedQR`/`qr` as a base64 PNG already rendered server-side — confirmed against the
+ * Postman collection's `register` response (`signedQR` decodes to a PNG magic-byte header), not a
+ * payload we encode ourselves. Wrap, don't encode. Shared by `Invoice.eimsSignedQr`
+ * (`BillingService`) and `EimsReceipt.qr` (`eims-receipt-document.mapper.ts`) — same convention,
+ * same gateway.
+ */
+export const pngDataUrl = (base64: string): string => `data:image/png;base64,${base64}`;
+
+// ── Shared HTML-builder helpers (buildHtml + buildThermalHtml) ──────────────────────────────────
+// `buildFallbackPdf`'s own currency/money/date closures are a deliberately different, already-
+// established convention (bare "ETB" vs "Birr (ETB)") for the vector renderer — not touched here.
+
+function esc(value: unknown): string {
+  return String(value ?? "-")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+function money(amount: unknown, currency: string): string {
+  return `${Number(amount ?? 0).toLocaleString()} ${currency === "ETB" ? "Birr (ETB)" : currency}`;
+}
+
+function formatDate(value: unknown): string {
+  return value ? new Date(value as string | Date).toLocaleDateString("en-GB") : "-";
+}
+
 /** One billed line on the document (charge type / fee type agnostic). */
 export interface InvoiceDocumentLine {
   description: string | null;
@@ -53,6 +87,20 @@ export interface InvoiceDocumentModel {
   totals: InvoiceDocumentTotal[];
   /** Override the round seal text; defaults from kind/status. */
   sealText?: string;
+  /**
+   * Company stamp image (data URL) to render instead of the plain text seal.
+   * Callers normally leave this unset — `InvoiceDocumentService.render()`
+   * fills it in from the single global stamp in StampSettingsService; set it
+   * explicitly only to override that default for one document.
+   */
+  stampImageUrl?: string | null;
+  logoImageUrl?: string | null;
+  /**
+   * MoR EIMS verification QR (data URL, pre-rendered by the caller from `Invoice.eimsSignedQr` —
+   * see that column's comment). Set only once an invoice is actually registered; the IRN text
+   * itself goes through the ordinary `summary` rows, not a dedicated field.
+   */
+  qrImageUrl?: string | null;
 }
 
 /**
@@ -63,12 +111,26 @@ export interface InvoiceDocumentModel {
  */
 @Injectable()
 export class InvoiceDocumentService {
-  constructor(private readonly pdf: PdfRenderService) {}
+  constructor(
+    private readonly pdf: PdfRenderService,
+    private readonly stampSettings: StampSettingsService,
+    private readonly logoSettings: LogoSettingsService,
+  ) {}
 
   async render(
     model: InvoiceDocumentModel,
   ): Promise<{ filename: string; buffer: Buffer }> {
-    const html = this.buildHtml(model);
+    const stampImageUrl =
+      model.stampImageUrl !== undefined
+        ? model.stampImageUrl
+        : await this.stampSettings.getStampImageUrl();
+    const logoImageUrl =
+      model.logoImageUrl !== undefined
+        ? model.logoImageUrl
+        : await this.logoSettings.getLogoImageUrl();
+    const resolvedModel: InvoiceDocumentModel = { ...model, stampImageUrl, logoImageUrl };
+
+    const html = this.buildHtml(resolvedModel);
     const kindLabel = model.kind === "RECEIPT" ? "receipt" : "invoice";
     return {
       filename: `${this.safeFilename(model.documentNumber)}-${kindLabel}.pdf`,
@@ -77,11 +139,128 @@ export class InvoiceDocumentService {
         // Chromium-less fallback: draw a genuine styled invoice (header, seal,
         // summary grid, line-item table, totals) from the model — not a flat
         // plain-text dump — so it still reads as a proper invoice document.
-        fallback: () => this.buildFallbackPdf(model),
+        // ponytail: still draws the plain vector seal, not the uploaded stamp
+        // image, and omits the EIMS QR entirely — embedding a raster image
+        // needs a new PDF XObject primitive in styled-pdf.util.ts. Upgrade
+        // when the Chromium-less path needs to carry the real stamp/QR too;
+        // today it's a rare degraded fallback. The IRN text itself still
+        // comes through (buildFallbackPdf renders model.summary same as HTML).
+        fallback: () => this.buildFallbackPdf(resolvedModel),
       }),
     };
   }
 
+  /**
+   * 80mm thermal invoice (ADD-P001) — physical page is the 80mm roll width; content stays within
+   * `THERMAL_MARGIN_MM` of each edge via `PdfRenderService`'s margin, not a narrower page, since
+   * thermal print mechanisms have a dead zone at the roll edge they can't reach either way.
+   *
+   * A genuinely different template from `buildHtml`, not a CSS variant of it: the A4 layout is
+   * absolutely-positioned and fixed-px (`.seal{right:28px}`, `.qr{right:160px}`,
+   * `.totals{width:330px}`), tuned for a 210mm page — none of it reflows at 72mm printable width.
+   * No seal here at all (a decorative wet-ink-style stamp is an A4/laser convention; no real POS
+   * thermal receipt carries one, and thermal heads render rotated circles badly) and line items
+   * are stacked (description, then `qty x rate = amount` below it) rather than a table — a real
+   * multi-column table leaves ~10-14 chars for description at this width, truncating almost every
+   * line, which stacking avoids entirely. No Chromium-less fallback — see `renderThermal`.
+   */
+  async renderThermal(model: InvoiceDocumentModel): Promise<{ filename: string; buffer: Buffer }> {
+    const logoImageUrl =
+      model.logoImageUrl !== undefined ? model.logoImageUrl : await this.logoSettings.getLogoImageUrl();
+    // Seal deliberately dropped — never fetched, so no stampSettings call either.
+    const resolvedModel: InvoiceDocumentModel = { ...model, logoImageUrl, stampImageUrl: null };
+
+    const html = this.buildThermalHtml(resolvedModel);
+    return {
+      filename: `${this.safeFilename(model.documentNumber)}-thermal.pdf`,
+      buffer: await this.pdf.htmlToPdfBuffer(html, {
+        label: `${model.title} thermal invoice`,
+        thermal: true,
+        // A generic A4-shaped, QR-less fallback is not an acceptable stand-in for "the thermal
+        // printer output" — fail loudly instead; the caller has the A4 download to fall back to.
+        noFallback: true,
+      }),
+    };
+  }
+
+  buildThermalHtml(model: InvoiceDocumentModel): string {
+    const heading = `${model.title} ${model.kind === "RECEIPT" ? "Receipt" : "Invoice"}`;
+    const logoInner = logoMarkup(model.logoImageUrl, "thermal-logo");
+
+    const summaryRows = model.summary
+      .map(
+        (row) =>
+          `<div class="row"><span class="label">${esc(row.label)}</span><span class="value">${esc(row.value)}</span></div>`,
+      )
+      .join("");
+
+    const itemBlocks = model.lines
+      .map((item) => {
+        const currency = item.currency ?? model.currency;
+        return `<div class="item">
+        <div class="item-desc">${esc(item.description)}</div>
+        <div class="item-calc">${esc(item.quantity ?? 0)} x ${esc(money(item.unitRate, currency))} = <strong>${esc(money(item.amount, currency))}</strong></div>
+      </div>`;
+      })
+      .join("");
+
+    const totalRows = model.totals
+      .map(
+        (total) =>
+          `<div class="total-row${total.grand ? " grand" : ""}"><span>${esc(total.label)}</span><strong>${esc(money(total.amount, model.currency))}</strong></div>`,
+      )
+      .join("");
+
+    const qrMarkup = model.qrImageUrl
+      ? `<div class="qr"><img src="${esc(model.qrImageUrl)}" alt="EIMS verification QR" /><div class="qr-caption">Scan to verify (MoR EIMS)</div></div>`
+      : "";
+
+    return `<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>${esc(heading)}</title>
+  <style>
+    body { font-family: Arial, sans-serif; font-size: 9px; color: #0f172a; margin: 0; }
+    .doc { width: 100%; box-sizing: border-box; }
+    .thermal-logo { display: block; max-height: 28px; max-width: 100%; object-fit: contain; margin: 0 auto 4px; }
+    .brand { text-align: center; font-size: 9px; text-transform: uppercase; letter-spacing: .05em; }
+    .title { text-align: center; font-size: 13px; font-weight: 800; margin: 2px 0; }
+    .meta { text-align: center; font-size: 8px; color: #475569; margin-bottom: 4px; }
+    .rule { border-top: 1px dashed #334155; margin: 6px 0; }
+    .row { display: flex; justify-content: space-between; gap: 6px; font-family: monospace; font-size: 8.5px; padding: 1px 0; }
+    .row .label { color: #64748b; white-space: nowrap; }
+    .row .value { text-align: right; overflow-wrap: anywhere; }
+    .item { margin: 4px 0; }
+    .item-desc { font-size: 9px; overflow-wrap: anywhere; }
+    .item-calc { text-align: right; font-family: monospace; font-size: 8.5px; }
+    .total-row { display: flex; justify-content: space-between; font-size: 9px; padding: 2px 0; }
+    .total-row.grand { font-size: 11px; font-weight: 800; border-top: 1px solid #0f172a; margin-top: 3px; padding-top: 4px; }
+    .qr { text-align: center; margin: 8px 0; }
+    .qr img { width: 150px; height: 150px; }
+    .qr-caption { font-size: 7px; color: #64748b; margin-top: 2px; }
+    .footer { text-align: center; font-size: 7px; color: #94a3b8; margin-top: 8px; }
+  </style>
+</head>
+<body>
+  <div class="doc">
+    ${logoInner}
+    <div class="brand">Ethio-Djibouti Railway S.C.</div>
+    <div class="title">${esc(heading)}</div>
+    <div class="meta">${esc(model.documentNumber)} &middot; ${esc(formatDate(model.issuedAt))}</div>
+    <div class="rule"></div>
+    ${summaryRows}
+    <div class="rule"></div>
+    ${itemBlocks}
+    <div class="rule"></div>
+    ${totalRows}
+    ${qrMarkup}
+    <div class="footer">Thank you</div>
+  </div>
+</body>
+</html>`;
+  }
+
   /**
    * Vector-drawn styled invoice/receipt used when headless Chromium is
    * unavailable. Mirrors the HTML layout closely enough to pass as the same
@@ -203,21 +382,17 @@ export class InvoiceDocumentService {
   }
 
   buildHtml(model: InvoiceDocumentModel): string {
-    const esc = (value: unknown) =>
-      String(value ?? "-")
-        .replace(/&/g, "&amp;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;")
-        .replace(/'/g, "&#39;");
-    const money = (amount: unknown, currency = model.currency) =>
-      `${Number(amount ?? 0).toLocaleString()} ${currency === "ETB" ? "Birr (ETB)" : currency}`;
-    const date = (value: unknown) =>
-      value ? new Date(value as string | Date).toLocaleDateString("en-GB") : "-";
-
+    const date = formatDate;
     const showCategory = Boolean(model.categoryHeader);
     const sealText =
       model.sealText ?? (model.kind === "RECEIPT" || model.status === "PAID" ? "EDR PAID" : "EDR");
+    const sealInner = sealMarkup(model.stampImageUrl, sealText);
+    const sealCssClass = sealClass(model.stampImageUrl);
+    const logoInner = logoMarkup(model.logoImageUrl);
+
+    const qrMarkup = model.qrImageUrl
+      ? `<div class="qr"><img src="${esc(model.qrImageUrl)}" alt="EIMS verification QR" /><span>Scan to verify (MoR EIMS)</span></div>`
+      : "";
 
     const summaryRows = model.summary
       .map((row) => `<div><span>${esc(row.label)}</span>${esc(row.value)}</div>`)
@@ -238,7 +413,7 @@ export class InvoiceDocumentService {
     const totalRows = model.totals
       .map(
         (total) =>
-          `<div class="total-row${total.grand ? " grand" : ""}"><span>${esc(total.label)}</span><strong>${esc(money(total.amount))}</strong></div>`,
+          `<div class="total-row${total.grand ? " grand" : ""}"><span>${esc(total.label)}</span><strong>${esc(money(total.amount, model.currency))}</strong></div>`,
       )
       .join("");
 
@@ -256,8 +431,21 @@ export class InvoiceDocumentService {
     .meta { text-align: right; font-size: 12px; color: #475569; }
     .meta strong { display: block; color: #0f172a; font-size: 17px; margin-top: 5px; }
     .seal { position: absolute; right: 28px; top: 118px; width: 116px; height: 116px; border: 4px double #0f766e; border-radius: 999px; color: #0f766e; display: flex; align-items: center; justify-content: center; text-align: center; font-weight: 800; font-size: 18px; transform: rotate(-14deg); opacity: .82; }
+    ${sealImageCss()}
+    ${logoImageCss()}
+    .qr { position: absolute; right: 160px; top: 118px; width: 90px; text-align: center; }
+    .qr img { width: 90px; height: 90px; }
+    .qr span { display: block; font-size: 7px; color: #64748b; margin-top: 3px; }
     .summary { display: grid; grid-template-columns: 1fr 1fr; gap: 12px 28px; margin: 24px 150px 16px 0; font-size: 13px; }
-    .summary div { border-bottom: 1px solid #e2e8f0; padding: 7px 0; }
+    /* The QR block (right:160px, width:90px) sits further inward than the seal alone did — the
+       150px margin above only ever cleared the seal, so a QR-bearing invoice needs more room. */
+    .summary.summary-with-qr { margin-right: 270px; }
+    /* min-width: 0 overrides Grid's default min-width:auto on grid items — without it, a long
+       unbroken value (a 20-digit VAT number) forces its column wider to fit un-wrapped rather than
+       honouring overflow-wrap, which is what actually let text bleed into the seal/QR overlay
+       (confirmed by isolating the two: margin-right alone already positioned the box correctly;
+       the text itself was still escaping the box's own right edge until this was added). */
+    .summary div { border-bottom: 1px solid #e2e8f0; padding: 7px 0; overflow-wrap: break-word; min-width: 0; }
     .summary span { color: #64748b; display: block; font-size: 11px; margin-bottom: 3px; }
     table { width: 100%; border-collapse: collapse; margin-top: 18px; }
     th { text-align: left; background: #f8fafc; color: #475569; }
@@ -274,6 +462,7 @@ export class InvoiceDocumentService {
   <div class="doc">
     <div class="top">
       <div>
+        ${logoInner}
         <div class="brand">Ethio-Djibouti Railway S.C.</div>
         <h1>${esc(model.title)} ${model.kind === "RECEIPT" ? "Receipt" : "Invoice"}</h1>
       </div>
@@ -283,8 +472,9 @@ export class InvoiceDocumentService {
         Issued: ${esc(date(model.issuedAt))}
       </div>
     </div>
-    <div class="seal">${esc(sealText)}</div>
-    <div class="summary">${summaryRows}</div>
+    <div class="${sealCssClass}">${sealInner}</div>
+    ${qrMarkup}
+    <div class="summary${model.qrImageUrl ? " summary-with-qr" : ""}">${summaryRows}</div>
     <table>
       <thead>
         <tr>
diff --git a/apps/edr-freight-api/src/modules/billing/documents/logo-markup.util.ts b/apps/edr-freight-api/src/modules/billing/documents/logo-markup.util.ts
new file mode 100644
index 000000000..f78109855
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/documents/logo-markup.util.ts
@@ -0,0 +1,35 @@
+/**
+ * The single decision every EDR document makes about its header logo: draw
+ * the one uploaded company logo when configured (LogoSettingsService), or
+ * render nothing — the existing "Ethio-Djibouti Railway S.C." text brand next
+ * to it already covers the no-logo case, so there is no text fallback here
+ * (contrast seal-markup.util.ts, whose seal has no text of its own).
+ */
+
+function escapeHtml(value: unknown): string {
+  return String(value ?? "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+/**
+ * `<img>` markup for the header logo, or "" when unset. `logoImageUrl` is
+ * expected to be a data URL from LogoSettingsService.getLogoImageUrl().
+ * `className` defaults to "doc-logo" — each document supplies that class's
+ * sizing in its own <style> block (see logoImageCss()).
+ */
+export function logoMarkup(
+  logoImageUrl: string | null | undefined,
+  className = "doc-logo",
+): string {
+  if (!logoImageUrl) return "";
+  return `<img class="${className}" src="${escapeHtml(logoImageUrl)}" alt="Company logo" />`;
+}
+
+/** Default CSS for the header logo — append inside a document's <style> block. */
+export function logoImageCss(className = "doc-logo"): string {
+  return `.${className} { display: block; max-height: 48px; max-width: 180px; margin-bottom: 6px; object-fit: contain; }`;
+}
diff --git a/apps/edr-freight-api/src/modules/billing/documents/pdf-render.service.ts b/apps/edr-freight-api/src/modules/billing/documents/pdf-render.service.ts
index 447bc2516..3767637a7 100644
--- a/apps/edr-freight-api/src/modules/billing/documents/pdf-render.service.ts
+++ b/apps/edr-freight-api/src/modules/billing/documents/pdf-render.service.ts
@@ -15,13 +15,43 @@ const PDF_PRINT_STYLES = `
   }
 </style>`;
 
+/**
+ * Physical roll width. Content stays within `THERMAL_MARGIN_MM` of each edge — every mainstream
+ * ESC/POS thermal head (Epson TM-T88, Star, Bixolon) has a dead zone near the edge of an 80mm roll
+ * it physically can't reach, so the page itself must stay 80mm (matching the roll the printer
+ * driver expects) with the safe area carved out by margin, not by shrinking the page.
+ */
+const THERMAL_PAGE_WIDTH_MM = 80;
+const THERMAL_MARGIN_MM = 4;
+/** Extra length past the measured content, so the cut isn't flush against the last line. */
+const THERMAL_FEED_MM = 6;
+/** Guard against a runaway line-item list producing an absurd page. */
+const THERMAL_MAX_HEIGHT_MM = 1500;
+
 export interface PdfRenderOptions {
   /** Label used in logs to identify the document kind. */
   label?: string;
+  /** Landscape A4 instead of the default portrait — wide tables need it. */
+  landscape?: boolean;
+  /**
+   * Render as an 80mm continuous thermal receipt instead of a fixed A4 page: content width is
+   * measured and the page height grows to fit it, rather than a fixed page with the format's
+   * `format: "A4"`.
+   */
+  thermal?: boolean;
+  /**
+   * Refuse to degrade to a fallback PDF on failure — throw instead. For a thermal request, a
+   * generic A4-shaped, QR-less fallback is not an acceptable stand-in for "the thermal printer
+   * output" (it silently hands back a different document shape than what was asked for); the
+   * caller has an existing A4 download to point the user at instead. Ignored when `fallback` is
+   * also supplied — an explicit fallback always wins.
+   */
+  noFallback?: boolean;
   /**
    * Degraded renderer used when Chromium is unavailable. Receives the
    * print-prepared HTML and must return a valid PDF buffer (≥ 2KB, `%PDF-`
-   * header). When omitted, a generic single-page fallback is produced.
+   * header). When omitted (and `noFallback` is not set), a generic single-page fallback is
+   * produced.
    */
   fallback?: (preparedHtml: string) => Buffer;
 }
@@ -52,16 +82,37 @@ export class PdfRenderService {
       const browser = await puppeteer.default.launch(launchOptions);
       try {
         const page = await browser.newPage();
-        await page.setViewport({ width: 794, height: 1123, deviceScaleFactor: 1 });
+        const thermal = opts.thermal ?? false;
+        const viewportWidth = thermal ? Math.round((THERMAL_PAGE_WIDTH_MM / 25.4) * 96) : 794;
+        // Thermal viewport height is deliberately tiny (not a real page height at all): scrollHeight
+        // is defined as the LARGER of the content's height and the viewport's own height, so a
+        // receipt shorter than the viewport would otherwise report the viewport height back, not
+        // its true content height — a real page-length trailing blank space bug, not theoretical
+        // (confirmed by actually rendering one). A short viewport forces content to overflow it,
+        // so scrollHeight always reflects the content, never the viewport.
+        await page.setViewport({ width: viewportWidth, height: thermal ? 100 : 1123, deviceScaleFactor: 1 });
         await page.setContent(preparedHtml, { waitUntil: "load", timeout: 60_000 });
         await page.emulateMediaType("print");
         await new Promise((resolve) => setTimeout(resolve, 250));
 
-        const pdf = await page.pdf({
-          format: "A4",
-          printBackground: true,
-          margin: { top: "16mm", bottom: "18mm", left: "14mm", right: "14mm" },
-        });
+        const pdf = thermal
+          ? await page.pdf({
+              width: `${THERMAL_PAGE_WIDTH_MM}mm`,
+              height: `${await this.thermalContentHeightMm(page)}mm`,
+              printBackground: true,
+              margin: {
+                top: `${THERMAL_MARGIN_MM}mm`,
+                bottom: `${THERMAL_MARGIN_MM + THERMAL_FEED_MM}mm`,
+                left: `${THERMAL_MARGIN_MM}mm`,
+                right: `${THERMAL_MARGIN_MM}mm`,
+              },
+            })
+          : await page.pdf({
+              format: "A4",
+              landscape: opts.landscape ?? false,
+              printBackground: true,
+              margin: { top: "16mm", bottom: "18mm", left: "14mm", right: "14mm" },
+            });
 
         const buffer = Buffer.from(pdf);
         if (!this.isValidPdf(buffer)) {
@@ -76,6 +127,15 @@ export class PdfRenderService {
       }
     } catch (error) {
       this.logger.error(`${label} PDF failed (executable=${executablePath ?? "default"}): ${error}`);
+      if (!opts.fallback && opts.noFallback) {
+        // A generic A4-shaped, QR-less fallback is not an acceptable stand-in for "the thermal
+        // printer output" — it silently hands back a different document than what was asked for.
+        // Fail loudly instead; the caller already has a working A4 download to fall back to.
+        throw new InternalServerErrorException(
+          `${label} could not be generated — thermal rendering requires Chromium. ` +
+            "Ensure Chromium is installed or set PUPPETEER_EXECUTABLE_PATH, or download the A4 PDF instead.",
+        );
+      }
       const fallback = (opts.fallback ?? ((h) => this.genericFallbackPdf(h)))(preparedHtml);
       if (this.isValidPdf(fallback)) {
         this.logger.warn(
@@ -89,6 +149,20 @@ export class PdfRenderService {
     }
   }
 
+  /**
+   * Thermal receipts are continuous-roll — there is no fixed page height. Measures the rendered
+   * content's actual height and adds feed clearance, so the PDF page is exactly as long as the
+   * receipt, not a fixed A4-length page with blank space at the bottom.
+   */
+  private async thermalContentHeightMm(page: import("puppeteer").Page): Promise<number> {
+    // String form, not a typed closure: this project's tsconfig has no `dom` lib, so `document`
+    // isn't a known global to type-check against — the string is evaluated in the page's own
+    // browser context regardless, same as the closure form would be.
+    const scrollPx = (await page.evaluate("document.documentElement.scrollHeight")) as number;
+    const contentMm = (scrollPx / 96) * 25.4 + THERMAL_MARGIN_MM * 2 + THERMAL_FEED_MM;
+    return Math.min(THERMAL_MAX_HEIGHT_MM, Math.round(contentMm * 100) / 100);
+  }
+
   private injectPdfPrintStyles(html: string): string {
     if (html.includes("edr-pdf-print-fix")) return html;
     if (html.includes("</head>")) {
diff --git a/apps/edr-freight-api/src/modules/billing/documents/seal-markup.util.spec.ts b/apps/edr-freight-api/src/modules/billing/documents/seal-markup.util.spec.ts
new file mode 100644
index 000000000..d07f8ebf6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/documents/seal-markup.util.spec.ts
@@ -0,0 +1,78 @@
+import { sealClass, sealImageCss, sealMarkup } from "./seal-markup.util";
+
+/**
+ * These three helpers are the single image-vs-text branch shared by every
+ * EDR document's round seal, so a regression here silently unstamps invoices,
+ * warehouse release papers and handover papers at once.
+ */
+describe("seal markup helpers", () => {
+  const STAMP = "data:image/png;base64,QUJD";
+
+  describe("sealMarkup", () => {
+    it("renders the stamp image when one is configured", () => {
+      expect(sealMarkup(STAMP, ["EDR", "Warehouse"])).toBe(
+        `<img src="${STAMP}" alt="Company stamp" />`,
+      );
+    });
+
+    it("falls back to text rings when no stamp is configured", () => {
+      expect(sealMarkup(null, ["EDR", "Warehouse", "Cleared"])).toBe(
+        "<span>EDR<br />Warehouse<br />Cleared</span>",
+      );
+    });
+
+    it("treats undefined as unset", () => {
+      expect(sealMarkup(undefined, "EDR")).toBe("<span>EDR</span>");
+    });
+
+    it("accepts a bare string as a single line", () => {
+      expect(sealMarkup(null, "EDR")).toBe("<span>EDR</span>");
+    });
+
+    it("escapes text lines so document data cannot inject markup", () => {
+      expect(sealMarkup(null, ['<script>alert("x")</script>'])).toBe(
+        "<span>&lt;script&gt;alert(&quot;x&quot;)&lt;/script&gt;</span>",
+      );
+    });
+
+    it("escapes the image src so it cannot break out of the attribute", () => {
+      expect(sealMarkup('data:image/png;base64,A" onerror="x', "EDR")).toBe(
+        '<img src="data:image/png;base64,A&quot; onerror=&quot;x" alt="Company stamp" />',
+      );
+    });
+  });
+
+  describe("sealClass", () => {
+    it("adds the image modifier only when stamped", () => {
+      expect(sealClass(STAMP)).toBe("seal seal-image");
+      expect(sealClass(null)).toBe("seal");
+    });
+
+    it("honours a document's own seal selector", () => {
+      expect(sealClass(STAMP, "sig-stamp-box")).toBe(
+        "sig-stamp-box sig-stamp-box-image",
+      );
+      expect(sealClass(null, "sig-stamp-box")).toBe("sig-stamp-box");
+    });
+  });
+
+  describe("sealImageCss", () => {
+    it("neutralizes the drawn ring and rotation for a real stamp image", () => {
+      const css = sealImageCss();
+
+      expect(css).toContain(".seal.seal-image { border: none;");
+      expect(css).toContain("transform: none;");
+      // The ::before pseudo-element draws the inner ring of the text seal.
+      expect(css).toContain(".seal.seal-image::before { content: none; }");
+      expect(css).toContain(".seal img { max-width: 100%;");
+    });
+
+    it("scopes every rule to the given selector", () => {
+      const css = sealImageCss("sig-stamp-box");
+
+      expect(css).not.toContain(".seal");
+      expect(css).toContain(".sig-stamp-box.sig-stamp-box-image");
+      expect(css).toContain(".sig-stamp-box img");
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/billing/documents/seal-markup.util.ts b/apps/edr-freight-api/src/modules/billing/documents/seal-markup.util.ts
new file mode 100644
index 000000000..2dd9c4715
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/documents/seal-markup.util.ts
@@ -0,0 +1,64 @@
+/**
+ * The single decision every EDR document makes about its round seal: draw the
+ * one uploaded company stamp when one is configured (StampSettingsService), or
+ * fall back to the plain text rings the document styles itself.
+ *
+ * Only the image-vs-text branch and the image overrides live here — each
+ * document keeps its own `.seal` geometry (the invoice's seal is absolutely
+ * positioned top-right, the warehouse papers' sit inline above the signature
+ * lines), so centralizing the source of the stamp does not relayout anything.
+ *
+ * These helpers are for the HTML/Chromium render path. The hand-built vector
+ * fallbacks in styled-pdf.util.ts cannot embed a raster image and continue to
+ * draw their vector seal — see InvoiceDocumentService for that caveat.
+ */
+
+/** Escape a value for interpolation into HTML text or a quoted attribute. */
+function escapeHtml(value: unknown): string {
+  return String(value ?? "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
+
+/**
+ * CSS overrides that neutralize a document's own ring/rotation styling when the
+ * seal is a real stamp image. Append inside a document's <style> block, after
+ * its own `.seal` rules. `selector` is the document's seal class ("seal").
+ */
+export function sealImageCss(selector = "seal"): string {
+  return [
+    `.${selector}.${selector}-image { border: none; border-radius: 0; opacity: 1; transform: none; }`,
+    `.${selector}.${selector}-image::before { content: none; }`,
+    `.${selector} img { max-width: 100%; max-height: 100%; object-fit: contain; }`,
+  ].join("\n    ");
+}
+
+/**
+ * Inner markup for the seal element: the stamp image, or the given text lines
+ * wrapped in a <span> (matching the `.seal span { position: relative }` rule
+ * the ring-drawing documents rely on).
+ *
+ * `stampImageUrl` is expected to be a data URL from
+ * StampSettingsService.getStampImageUrl(); null renders the text fallback.
+ */
+export function sealMarkup(
+  stampImageUrl: string | null | undefined,
+  textLines: string | string[],
+): string {
+  if (stampImageUrl) {
+    return `<img src="${escapeHtml(stampImageUrl)}" alt="Company stamp" />`;
+  }
+  const lines = Array.isArray(textLines) ? textLines : [textLines];
+  return `<span>${lines.map(escapeHtml).join("<br />")}</span>`;
+}
+
+/** Class attribute for the seal element — adds the image modifier when stamped. */
+export function sealClass(
+  stampImageUrl: string | null | undefined,
+  selector = "seal",
+): string {
+  return stampImageUrl ? `${selector} ${selector}-image` : selector;
+}
diff --git a/apps/edr-freight-api/src/modules/billing/dto/filter-invoice.dto.ts b/apps/edr-freight-api/src/modules/billing/dto/filter-invoice.dto.ts
index e8942d586..91327946c 100644
--- a/apps/edr-freight-api/src/modules/billing/dto/filter-invoice.dto.ts
+++ b/apps/edr-freight-api/src/modules/billing/dto/filter-invoice.dto.ts
@@ -39,4 +39,11 @@ export class FilterInvoiceDto {
   @IsOptional()
   @IsIn(Object.values(Freight.InvoiceStatus))
   status?: Freight.InvoiceStatus;
+
+  /** Manual-payments worklist only: restrict to one currency. */
+  @ApiPropertyOptional({ enum: ["USD", "ETB"] })
+  @IsOptional()
+  @Transform(({ value }: { value: unknown }) => String(value).toUpperCase())
+  @IsIn(["USD", "ETB"])
+  currency?: "USD" | "ETB";
 }
diff --git a/apps/edr-freight-api/src/modules/billing/dto/issue-memo.dto.ts b/apps/edr-freight-api/src/modules/billing/dto/issue-memo.dto.ts
new file mode 100644
index 000000000..c80657155
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/dto/issue-memo.dto.ts
@@ -0,0 +1,71 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import {
+  IsArray,
+  IsIn,
+  IsNumber,
+  IsObject,
+  IsOptional,
+  IsString,
+  Length,
+  ValidateNested,
+} from "class-validator";
+
+/** One line on a memo; omit the whole `lines` array on the parent DTO to copy the original's. */
+export class MemoLineDto {
+  @ApiProperty()
+  @IsString()
+  chargeType!: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  description?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsNumber()
+  quantity?: number;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsNumber()
+  unitRate?: number;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsNumber()
+  amount?: number;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  currency?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, unknown>;
+}
+
+/** `POST billing/invoices/:id/memo` body — see `BillingService.issueMemo`. */
+export class IssueMemoDto {
+  @ApiProperty({ enum: ["CRE", "DEB"], description: "MoR DocumentDetails.Type for the memo." })
+  @IsIn(["CRE", "DEB"])
+  type!: "CRE" | "DEB";
+
+  @ApiProperty({ description: "Why the memo was issued — MoR DocumentDetails.Reason." })
+  @IsString()
+  @Length(1, 500)
+  reason!: string;
+
+  @ApiPropertyOptional({
+    type: [MemoLineDto],
+    description: "Omit to copy every line of the original invoice verbatim.",
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => MemoLineDto)
+  lines?: MemoLineDto[];
+}
diff --git a/apps/edr-freight-api/src/modules/billing/eims-invoice.mapper.spec.ts b/apps/edr-freight-api/src/modules/billing/eims-invoice.mapper.spec.ts
new file mode 100644
index 000000000..75d39a500
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/eims-invoice.mapper.spec.ts
@@ -0,0 +1,407 @@
+import {
+  EimsMapperContext,
+  EimsMapperInvoice,
+  EimsSellerDetails,
+  formatEimsDate,
+  toEimsInvoice,
+} from "./eims-invoice.mapper";
+
+const seller: EimsSellerDetails = {
+  City: null,
+  Email: "finance@edr.et",
+  HouseNumber: null,
+  LegalName: "Ethio-Djibouti Railway S.C.",
+  Locality: null,
+  Phone: "0911223344",
+  Region: "13",
+  SubCity: null,
+  Tin: "0016324478",
+  VatNumber: "3215840010",
+  Wereda: "574",
+};
+
+const invoice = (over: Partial<EimsMapperInvoice> = {}): EimsMapperInvoice => ({
+  invoiceNumber: "INV-20260807-00042",
+  currency: "ETB",
+  issuedAt: new Date(2026, 7, 7, 9, 5, 3),
+  totalAmount: "11000.00",
+  company: {
+    name: "ABC Trading PLC",
+    tin: "0999930000",
+    vatNumber: "123475885858",
+    phone: "0912345678",
+    email: "buyer@abc.et",
+    region: "13",
+    zone: "SHA",
+    woreda: "574",
+    kebele: "03",
+    houseNo: "NEW",
+    country: "Ethiopia",
+  },
+  lines: [
+    { chargeType: "RAIL_FREIGHT", description: "Addis → Djibouti", quantity: "1.00", unitRate: "10000.00", amount: "10000.00" },
+    { chargeType: "HAZARD_SURCHARGE", description: null, quantity: "2.00", unitRate: "500.00", amount: "1000.00", metadata: { unit: "CTR" } },
+  ],
+  ...over,
+});
+
+const context = (over: Partial<EimsMapperContext> = {}): EimsMapperContext => ({
+  systemNumber: "B0360154BA",
+  systemType: "SYS",
+  documentNumber: "24",
+  invoiceCounter: 7,
+  previousIrn: "",
+  cashierName: null,
+  salesPersonName: null,
+  transactionType: "B2B",
+  payment: { mode: "CASH", term: "IMMIDIATE" },
+  taxForLine: () => ({ code: "VAT15", ratePercent: 15, exciseTaxValue: 0, discount: 0 }),
+  natureOfSupplies: "Service",
+  unitDefault: "PCS",
+  incomeWithholdValue: 0,
+  transactionWithholdValue: 0,
+  buyerCountryCode: "231", // test-only, not a confirmed real MoR code
+  buyerCountryCodes: {},
+  buyerRegionCodes: { "Addis Ababa": "13" },
+  buyerWeredaCodes: {},
+  buyerCityCodes: {},
+  ...over,
+});
+
+describe("toEimsInvoice", () => {
+  it("emits the ten EIMS sections with the collection's field names", () => {
+    const doc = toEimsInvoice(invoice(), seller, context());
+
+    expect(Object.keys(doc)).toEqual([
+      "BuyerDetails",
+      "DocumentDetails",
+      "ItemList",
+      "PaymentDetails",
+      "ReferenceDetails",
+      "SellerDetails",
+      "SourceSystem",
+      "TransactionType",
+      "ValueDetails",
+      "Version",
+    ]);
+    expect(doc.Version).toBe("1");
+    expect(doc.DocumentDetails).toEqual({ DocumentNumber: "24", Date: "07-08-2026T09:05:03", Type: "INV" });
+    expect(doc.SourceSystem.InvoiceCounter).toBe(7);
+    expect(doc.SellerDetails).toBe(seller);
+  });
+
+  it("maps the buyer from the company row and leaves unmodelled fields null", () => {
+    const doc = toEimsInvoice(invoice(), seller, context());
+
+    expect(doc.BuyerDetails).toEqual({
+      City: null,
+      // company.country is "Ethiopia" (the domestic default) — resolves to context's flat
+      // buyerCountryCode fallback, not null, per resolveCountryCode.
+      Country: "231",
+      Email: "buyer@abc.et",
+      HouseNumber: "NEW",
+      IdNumber: null,
+      IdType: null,
+      Tin: "0999930000",
+      LegalName: "ABC Trading PLC",
+      Phone: "0912345678",
+      Region: "13",
+      Zone: "SHA",
+      Kebele: "03",
+      VatNumber: "123475885858",
+      Wereda: "574",
+    });
+  });
+
+  it("applies per-line tax and totals it into ValueDetails", () => {
+    const doc = toEimsInvoice(
+      invoice(),
+      seller,
+      context({
+        taxForLine: (line) =>
+          line.chargeType === "RAIL_FREIGHT"
+            ? { code: "VAT15", ratePercent: 15, exciseTaxValue: 0, discount: 0 }
+            : { code: "EXEMPT", ratePercent: 0, exciseTaxValue: 50, discount: 25 },
+      }),
+    );
+
+    expect(doc.ItemList[0]).toMatchObject({
+      LineNumber: 1,
+      ItemCode: "RAIL_FREIGHT",
+      ProductDescription: "Addis → Djibouti",
+      Quantity: 1,
+      UnitPrice: 10000,
+      PreTaxValue: 10000,
+      TaxCode: "VAT15",
+      TaxAmount: 1500,
+      ExciseTaxValue: 0,
+      Discount: 0,
+      TotalLineAmount: 11500,
+      Unit: "PCS",
+      NatureOfSupplies: "service",
+      HarmonizationCode: null,
+    });
+    expect(doc.ItemList[1]).toMatchObject({
+      LineNumber: 2,
+      ProductDescription: "HAZARD_SURCHARGE",
+      TaxCode: "EXEMPT",
+      TaxAmount: 0,
+      ExciseTaxValue: 50,
+      // Discount is carried on the line but does not (yet) reduce TotalLineAmount — see the
+      // EimsLineTax.discount comment in eims-invoice.mapper.ts.
+      Discount: 25,
+      TotalLineAmount: 1050,
+      // Not "CTR" from the line's metadata.unit — that's our internal fee-basis tag, not a MoR
+      // unit of measure, and is never read for this field (see the mapper's own comment).
+      Unit: "PCS",
+    });
+    expect(doc.ValueDetails).toEqual({
+      Discount: null,
+      ExciseValue: 50,
+      IncomeWithholdValue: 0,
+      TaxValue: 1500,
+      TotalValue: 12550,
+      TransactionWithholdValue: 0,
+      InvoiceCurrency: "ETB",
+    });
+  });
+
+  it("passes PreviousIrn through verbatim and defaults RelatedDocument to null", () => {
+    expect(toEimsInvoice(invoice(), seller, context()).ReferenceDetails).toEqual({
+      PreviousIrn: "",
+      RelatedDocument: null,
+    });
+    expect(
+      toEimsInvoice(invoice(), seller, context({ previousIrn: null, relatedDocument: "CN-9" }))
+        .ReferenceDetails,
+    ).toEqual({ PreviousIrn: null, RelatedDocument: "CN-9" });
+  });
+
+  it("emits ExchangeRate only when supplied", () => {
+    expect(toEimsInvoice(invoice(), seller, context()).ValueDetails.ExchangeRate).toBeUndefined();
+
+    const usd = toEimsInvoice(
+      invoice({ currency: "USD" }),
+      seller,
+      context({ exchangeRate: 132.5 }),
+    );
+    expect(usd.ValueDetails).toMatchObject({ InvoiceCurrency: "USD", ExchangeRate: 132.5 });
+  });
+
+  it("honours a caller-supplied date formatter", () => {
+    const doc = toEimsInvoice(invoice(), seller, context({ formatDate: () => "2026-08-07T09:05:03Z" }));
+    expect(doc.DocumentDetails.Date).toBe("2026-08-07T09:05:03Z");
+  });
+
+  it("throws when tax treatment cannot be resolved for a line", () => {
+    expect(() =>
+      toEimsInvoice(
+        invoice(),
+        seller,
+        context({ taxForLine: () => ({ code: "", ratePercent: 15, exciseTaxValue: 0, discount: 0 }) }),
+      ),
+    ).toThrow(/unresolved tax treatment for line 1/);
+
+    expect(() =>
+      toEimsInvoice(
+        invoice(),
+        seller,
+        context({
+          taxForLine: () => ({ code: "VAT15", ratePercent: 15, exciseTaxValue: 0, discount: NaN }),
+        }),
+      ),
+    ).toThrow(/unresolved tax treatment for line 1/);
+  });
+
+  it("throws on a missing buyer TIN, no lines, or an unissued invoice", () => {
+    expect(() => toEimsInvoice(invoice({ company: null }), seller, context())).toThrow(/buyer company TIN/);
+    expect(() => toEimsInvoice(invoice({ lines: [] }), seller, context())).toThrow(/has no lines/);
+    expect(() => toEimsInvoice(invoice({ issuedAt: null }), seller, context())).toThrow(/not issued/);
+  });
+
+  describe("debit/credit notes — confirmed by MoR support, same /v1/register endpoint", () => {
+    it("defaults DocumentDetails.Type to INV with no Reason field", () => {
+      const doc = toEimsInvoice(invoice(), seller, context());
+      expect(doc.DocumentDetails.Type).toBe("INV");
+      expect(doc.DocumentDetails).not.toHaveProperty("Reason");
+    });
+
+    it("files a credit note with Type, Reason and RelatedDocument", () => {
+      const doc = toEimsInvoice(
+        invoice(),
+        seller,
+        context({
+          documentType: "CRE",
+          reason: "Overbilled freight charge",
+          relatedDocument: "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0",
+        }),
+      );
+      expect(doc.DocumentDetails).toMatchObject({ Type: "CRE", Reason: "Overbilled freight charge" });
+      expect(doc.ReferenceDetails.RelatedDocument).toBe(
+        "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0",
+      );
+    });
+
+    it("files a debit note the same way", () => {
+      const doc = toEimsInvoice(
+        invoice(),
+        seller,
+        context({ documentType: "DEB", reason: "Additional handling fee", relatedDocument: "IRN-1" }),
+      );
+      expect(doc.DocumentDetails).toMatchObject({ Type: "DEB", Reason: "Additional handling fee" });
+    });
+
+    it("throws when a credit/debit note has no reason", () => {
+      expect(() =>
+        toEimsInvoice(
+          invoice(),
+          seller,
+          context({ documentType: "CRE", reason: null, relatedDocument: "IRN-1" }),
+        ),
+      ).toThrow(/needs a reason/);
+    });
+
+    it("throws when a credit/debit note has no relatedDocument", () => {
+      expect(() =>
+        toEimsInvoice(
+          invoice(),
+          seller,
+          context({ documentType: "CRE", reason: "Overbilled", relatedDocument: null }),
+        ),
+      ).toThrow(/needs.*relatedDocument/);
+    });
+  });
+
+  it("throws when the lines do not sum to the invoice total", () => {
+    expect(() => toEimsInvoice(invoice({ totalAmount: "9000.00" }), seller, context())).toThrow(
+      /lines sum to 11000 but the invoice total is 9000/,
+    );
+  });
+
+  it("throws on a non-ETB invoice with no exchange rate", () => {
+    expect(() => toEimsInvoice(invoice({ currency: "USD" }), seller, context())).toThrow(/needs an exchangeRate/);
+  });
+});
+
+describe("toEimsInvoice — MoR field constraints", () => {
+  it("passes a buyer region through when it is already a MoR code", () => {
+    const doc = toEimsInvoice(invoice(), seller, context());
+    expect(doc.BuyerDetails.Region).toBe("13");
+  });
+
+  it("maps a region name to its code, ignoring case and spacing", () => {
+    const doc = toEimsInvoice(
+      invoice({ company: { ...invoice().company!, region: "  addis   ababa " } }),
+      seller,
+      context({ buyerRegionCodes: { "Addis Ababa": "13" } }),
+    );
+    expect(doc.BuyerDetails.Region).toBe("13");
+  });
+
+  it("refuses to file a buyer whose region has no mapping", () => {
+    expect(() =>
+      toEimsInvoice(
+        invoice({ company: { ...invoice().company!, region: "Somewhere Else" } }),
+        seller,
+        context(),
+      ),
+    ).toThrow(/not a MoR Region code and has no mapping/);
+  });
+
+  it("refuses a buyer with no region at all rather than guessing one", () => {
+    expect(() =>
+      toEimsInvoice(
+        invoice({ company: { ...invoice().company!, region: null } }),
+        seller,
+        context(),
+      ),
+    ).toThrow(/buyer Region \(unset\)/);
+  });
+
+  it("passes a buyer wereda through when it is already a MoR code", () => {
+    const doc = toEimsInvoice(invoice(), seller, context());
+    expect(doc.BuyerDetails.Wereda).toBe("574");
+  });
+
+  it("maps a wereda name to its code", () => {
+    const doc = toEimsInvoice(
+      invoice({ company: { ...invoice().company!, woreda: "Yeka" } }),
+      seller,
+      context({ buyerWeredaCodes: { Yeka: "99" } }),
+    );
+    expect(doc.BuyerDetails.Wereda).toBe("99");
+  });
+
+  it("refuses to file a buyer whose wereda has no mapping", () => {
+    expect(() =>
+      toEimsInvoice(
+        invoice({ company: { ...invoice().company!, woreda: "Yeka" } }),
+        seller,
+        context({ buyerWeredaCodes: {} }),
+      ),
+    ).toThrow(/buyer Wereda "Yeka".*EIMS_BUYER_WEREDA_CODES/);
+  });
+
+  it("derives City from the buyer's zone via the city code map", () => {
+    const doc = toEimsInvoice(
+      invoice({ company: { ...invoice().company!, zone: "Kirkos" } }),
+      seller,
+      context({ buyerCityCodes: { Kirkos: "101" } }),
+    );
+    expect(doc.BuyerDetails.City).toBe("101");
+  });
+
+  it("leaves City null (not a throw) when the buyer's zone has no city mapping — City is optional", () => {
+    const doc = toEimsInvoice(
+      invoice({ company: { ...invoice().company!, zone: "Somewhere Else" } }),
+      seller,
+      context({ buyerCityCodes: {} }),
+    );
+    expect(doc.BuyerDetails.City).toBeNull();
+  });
+
+  it("maps a buyer country name to its code via the country code map", () => {
+    const doc = toEimsInvoice(
+      invoice({ company: { ...invoice().company!, country: "Djibouti" } }),
+      seller,
+      context({ buyerCountryCodes: { Djibouti: "071" } }),
+    );
+    expect(doc.BuyerDetails.Country).toBe("071");
+  });
+
+  it("falls back to the flat domestic country code only for Ethiopia, not any unmapped country", () => {
+    const doc = toEimsInvoice(
+      invoice({ company: { ...invoice().company!, country: "Ethiopia" } }),
+      seller,
+      context({ buyerCountryCode: "231", buyerCountryCodes: {} }),
+    );
+    expect(doc.BuyerDetails.Country).toBe("231");
+  });
+
+  it("refuses a genuinely foreign buyer country with no mapping — never silently files it as Ethiopia", () => {
+    expect(() =>
+      toEimsInvoice(
+        invoice({ company: { ...invoice().company!, country: "Kenya" } }),
+        seller,
+        context({ buyerCountryCode: "231", buyerCountryCodes: {} }),
+      ),
+    ).toThrow(/buyer Country "Kenya".*EIMS_BUYER_COUNTRY_CODES/);
+  });
+
+  it("emits NatureOfSupplies lowercase, whatever case it was configured in", () => {
+    const doc = toEimsInvoice(invoice(), seller, context({ natureOfSupplies: "Service" }));
+    expect(doc.ItemList[0].NatureOfSupplies).toBe("service");
+  });
+
+  it("rejects a NatureOfSupplies MoR does not accept", () => {
+    expect(() =>
+      toEimsInvoice(invoice(), seller, context({ natureOfSupplies: "Services" })),
+    ).toThrow(/must be one of goods, service/);
+  });
+});
+
+describe("formatEimsDate", () => {
+  it("renders the observed dd-MM-yyyyTHH:mm:ss shape with zero padding", () => {
+    expect(formatEimsDate(new Date(2025, 2, 21, 0, 0, 0))).toBe("21-03-2025T00:00:00");
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/billing/eims-invoice.mapper.ts b/apps/edr-freight-api/src/modules/billing/eims-invoice.mapper.ts
new file mode 100644
index 000000000..c72e61c7a
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/billing/eims-invoice.mapper.ts
@@ -0,0 +1,579 @@
+/**
+ * Pure mapper from an EDR invoice onto the Ethiopian MoR EIMS registration document
+ * (`POST https://core.mor.gov.et/v1/register`).
+ *
+ * Field names, casing and section layout are taken verbatim from the supplied
+ * `EimsCoreApiMockCollection2.postman_collection.json`. Note the payload spells the district
+ * `Wereda` even though the collection *variable* is named `sellerWoreda`.
+ *
+ * Scope: mapping only — no HTTP, no signing, no persistence, no counter allocation. Everything
+ * that does not live on the invoice (document number, counters, previous IRN, seller identity,
+ * tax treatment) is supplied by the caller and is never guessed here.
+ *
+ * Values that the collection only *demonstrates* by example — the date format, the meaning of an
+ * empty `PreviousIrn`, the `SystemType` enum, `PaymentTerm` values — are treated as observed, not
+ * authoritative: they are passed through or overridable rather than validated against a fixed set.
+ */
+
+import { round2 } from "./invoice-settlement.util";
+
+/** Only proven-required constant: the 400 SCHEMA ERROR sample rejects a payload without it. */
+const EIMS_VERSION = "1";
+
+/**
+ * `DocumentDetails.Type`. `"INV"` is the only value observed in the collection; `"DEB"`/`"CRE"`
+ * (debit/credit note) were confirmed directly by MoR support — same `/v1/register` endpoint, no
+ * separate API. MoR's answer, verbatim: "the same endpoint used for registration should be used
+ * ... within the Document Detail object, you should specify DEB for a debit note, CRE for a
+ * credit note... add a Reason attribute under document detail object".
+ */
+export const EIMS_DOCUMENT_TYPES = ["INV", "DEB", "CRE"] as const;
+export type EimsDocumentType = (typeof EIMS_DOCUMENT_TYPES)[number];
+
+export interface EimsBuyerDetails {
+  City: string | null;
+  Email: string | null;
+  HouseNumber: string | null;
+  IdNumber: string | null;
+  IdType: string | null;
+  Tin: string;
+  LegalName: string;
+  Phone: string | null;
+  Region: string | null;
+  Country: string | null;
+  Zone: string | null;
+  Kebele: string | null;
+  VatNumber: string | null;
+  Wereda: string | null;
+}
+
+export interface EimsSellerDetails {
+  City: string | null;
+  Email: string | null;
+  HouseNumber: string | null;
+  LegalName: string;
+  Locality: string | null;
+  Phone: string | null;
+  /** MoR region *code* (e.g. "13"), not a region name. */
+  Region: string | null;
+  SubCity: string | null;
+  Tin: string;
+  VatNumber: string | null;
+  /** MoR wereda *code* (e.g. "574"). */
+  Wereda: string | null;
+}
+
+export interface EimsDocumentDetails {
+  DocumentNumber: string;
+  /** Observed format `dd-MM-yyyyTHH:mm:ss`. Rule seen in the collection: within 3 days of now. */
+  Date: string;
+  Type: EimsDocumentType;
+  /** Only for DEB/CRE, per MoR support — why the debit/credit note was issued. Absent for INV. */
+  Reason?: string;
+}
+
+export interface EimsInvoiceItem {
+  Discount: number;
+  ExciseTaxValue: number;
+  HarmonizationCode: string | null;
+  NatureOfSupplies: string;
+  ItemCode: string;
+  ProductDescription: string;
+  PreTaxValue: number;
+  Quantity: number;
+  LineNumber: number;
+  TaxAmount: number;
+  TaxCode: string;
+  TotalLineAmount: number;
+  Unit: string;
+  UnitPrice: number;
+}
+
+export interface EimsPaymentDetails {
+  Mode: string;
+  PaymentTerm: string;
+}
+
+export interface EimsReferenceDetails {
+  PreviousIrn: string | null;
+  RelatedDocument: string | null;
+}
+
+export interface EimsSourceSystem {
+  CashierName: string | null;
+  InvoiceCounter: number;
+  SalesPersonName: string | null;
+  SystemNumber: string;
+  SystemType: string;
+}
+
+export interface EimsValueDetails {
+  Discount: number | null;
+  ExciseValue: number;
+  IncomeWithholdValue: number;
+  TaxValue: number;
+  TotalValue: number;
+  TransactionWithholdValue: number;
+  InvoiceCurrency: string;
+  /** Absent from the register sample, present on the verify response. Emitted only when supplied. */
+  ExchangeRate?: number;
+}
+
+export interface EimsInvoiceRequest {
+  BuyerDetails: EimsBuyerDetails;
+  DocumentDetails: EimsDocumentDetails;
+  ItemList: EimsInvoiceItem[];
+  PaymentDetails: EimsPaymentDetails;
+  ReferenceDetails: EimsReferenceDetails;
+  SellerDetails: EimsSellerDetails;
+  SourceSystem: EimsSourceSystem;
+  TransactionType: string;
+  ValueDetails: EimsValueDetails;
+  Version: string;
+}
+
+/** `body` of a successful `POST /v1/register`, as observed in the collection. */
+export interface EimsRegisterResponseBody {
+  irn: string;
+  ackDate: string;
+  signedQR: string;
+  signedInvoice: string;
+  status: string;
+  documentNumber: string;
+  errorMessage: string | null;
+}
+
+/** Numeric columns arrive from pg as strings; every money field is normalised through `num`. */
+export interface EimsMapperLine {
+  chargeType: string;
+  description?: string | null;
+  quantity: number | string;
+  unitRate: number | string;
+  amount: number | string;
+  metadata?: Record<string, unknown> | null;
+}
+
+export interface EimsMapperCompany {
+  name: string;
+  tin: string;
+  vatNumber?: string | null;
+  phone?: string | null;
+  email?: string | null;
+  region?: string | null;
+  zone?: string | null;
+  woreda?: string | null;
+  kebele?: string | null;
+  houseNo?: string | null;
+  country?: string | null;
+}
+
+/**
+ * Structurally what `BillingService.findById` returns — the only read path that loads the header,
+ * the buyer company and the lines together.
+ */
+export interface EimsMapperInvoice {
+  invoiceNumber: string;
+  currency: string;
+  issuedAt?: Date | string | null;
+  totalAmount: number | string;
+  company?: EimsMapperCompany | null;
+  lines: EimsMapperLine[];
+}
+
+/**
+ * Tax treatment for a single line. EIMS models `TaxCode`/`TaxAmount`/`ExciseTaxValue` per item, and
+ * different charge types may eventually be treated differently, so this is resolved per line.
+ *
+ * Nothing in this repo can supply it: `Invoice.taxAmount` is hardcoded to 0 with no caller ever
+ * setting it, `invoice_lines` has no tax column, and the rate catalogue has no fiscal field. That
+ * is the absence of a tax model, not evidence of zero-rating — hence no default here.
+ */
+export interface EimsLineTax {
+  code: string;
+  ratePercent: number;
+  exciseTaxValue: number;
+  /**
+   * Line-level `Discount`. Its effect on `TotalLineAmount` has never been observed live (every
+   * prior test ran it at 0), so the total below still sums PreTax + Tax + Excise only — do not
+   * start subtracting this without a confirmed MoR example.
+   */
+  discount: number;
+}
+
+export interface EimsMapperContext {
+  systemNumber: string;
+  /** Observed values: POS, MAN, CRM, EFD, SYS (the collection prose also mentions ERP). */
+  systemType: string;
+  /** Caller decides the source — our own `invoiceNumber` or a dedicated EIMS sequence. */
+  documentNumber: string;
+  invoiceCounter: number;
+  /** Passed through verbatim; the collection shows `""` used for an unchained document. */
+  previousIrn: string | null;
+  cashierName: string | null;
+  salesPersonName: string | null;
+  /** B2B / B2C — a tax classification, so the caller states it. */
+  transactionType: string;
+  payment: { mode: string; term: string };
+  /** Must return a treatment for every line, or throw. */
+  taxForLine: (line: EimsMapperLine, lineNumber: number) => EimsLineTax;
+  natureOfSupplies: string;
+  /** Used when a line carries no `metadata.unit`. */
+  unitDefault: string;
+  incomeWithholdValue: number;
+  transactionWithholdValue: number;
+  /**
+   * `DocumentDetails.Type`. Defaults to `"INV"`. For `"DEB"`/`"CRE"` both `reason` and
+   * `relatedDocument` become required — confirmed directly by MoR support, not the collection.
+   */
+  documentType?: EimsDocumentType;
+  /** Required when `documentType` is `"DEB"`/`"CRE"` — why the note was issued. Unused for INV. */
+  reason?: string | null;
+  /**
+   * `ReferenceDetails.RelatedDocument`. Null for an ordinary invoice; required for a DEB/CRE —
+   * the original registered invoice's IRN, per MoR's own IRC-P06/P07 checklist ("credit memo
+   * from a registered invoice").
+   */
+  relatedDocument?: string | null;
+  /**
+   * Domestic fallback only, applied when `company.country` is empty or "Ethiopia" and not already
+   * in `buyerCountryCodes` — see that field. Never applied to a genuinely foreign buyer.
+   */
+  buyerCountryCode?: string | null;
+  /** Country name → MoR code. Format unconfirmed, so looked up by name only, not digit-validated. */
+  buyerCountryCodes: Record<string, string>;
+  /**
+   * Region name → MoR numeric code, for buyers whose stored region is free text.
+   *
+   * `companies.region` holds names ("Addis Ababa") while MoR validates `BuyerDetails.Region`
+   * against `^[0-9]{1,3}$`. A stored value that is already a code passes through; anything else
+   * must be in this map or the mapping **fails locally** — sending a guessed region code onto a
+   * tax document is worse than refusing to file.
+   */
+  buyerRegionCodes: Record<string, string>;
+  /**
+   * Wereda name → MoR code, same shape as `buyerRegionCodes`. `companies.woreda` holds names
+   * ("Yeka") or codes inconsistently; unlike Region, MoR has never named a Wereda regex in an
+   * error, so this is precautionary rather than confirmed — but the fix is identical either way:
+   * fail locally on an unmapped name rather than file a guess.
+   */
+  buyerWeredaCodes: Record<string, string>;
+  /**
+   * Buyer *zone* name → MoR City code. `Company` has no dedicated city column; Zone is the
+   * closest match in EDR's own data. Unlike Region/Wereda, City is optional — MoR has already
+   * accepted a live filing with it null — so an unmapped zone resolves to null, it does not fail
+   * the mapping.
+   */
+  buyerCityCodes: Record<string, string>;
+  buyerIdType?: string | null;
+  buyerIdNumber?: string | null;
+  /** Required when the invoice currency is not ETB. */
+  exchangeRate?: number | null;
+  invoiceDiscount?: number | null;
+  /** Override while the observed `dd-MM-yyyyTHH:mm:ss` format is unconfirmed by MoR. */
+  formatDate?: (issuedAt: Date) => string;
+}
+
+/**
+ * MoR's own constraint on `Region`: one to three digits, confirmed by its 400 SCHEMA ERROR. Reused
+ * as the pass-through test for `Wereda` too — every Wereda value MoR has actually shown us (seller
+ * "12"/"13", the collection's "574") fits the same shape, though MoR has not named a Wereda regex
+ * the way it named Region's.
+ */
+const LOCATION_CODE = /^[0-9]{1,3}$/;
+
+/**
+ * The only two values MoR accepts for `NatureOfSupplies`, lowercase.
+ *
+ * Its schema branches on this as a `oneOf` with a `const` per branch, so `"Service"` fails the
+ * whole `ItemList` — the error reads "must be the constant value 'service'".
+ */
+const NATURE_OF_SUPPLIES = ["goods", "service"] as const;
+
+const num = (v: number | string): number => {
+  const n = Number(v);
+  if (!Number.isFinite(n)) throw new Error(`EIMS mapping: expected a numeric value, got ${String(v)}`);
+  return n;
+};
+
+const pad = (n: number, width = 2): string => String(n).padStart(width, "0");
+
+/** Observed EIMS document-date format: `dd-MM-yyyyTHH:mm:ss`, no timezone marker. */
+export const formatEimsDate = (issuedAt: Date): string =>
+  `${pad(issuedAt.getDate())}-${pad(issuedAt.getMonth() + 1)}-${issuedAt.getFullYear()}` +
+  `T${pad(issuedAt.getHours())}:${pad(issuedAt.getMinutes())}:${pad(issuedAt.getSeconds())}`;
+
+/**
+ * Map one loaded invoice onto an EIMS registration document.
+ *
+ * Throws rather than emitting a payload EIMS would reject opaquely: missing buyer TIN, no lines,
+ * an unissued invoice, unresolved line tax, a line/total mismatch, or a non-ETB invoice with no
+ * exchange rate.
+ */
+/**
+ * A buyer's location value (Region, Wereda or City) as a MoR code: passed through when already
+ * numeric, otherwise looked up by name (case- and space-insensitive).
+ *
+ * Region/Wereda are required: an unmapped value throws — sending a guessed code onto a tax
+ * document is worse than refusing to file. City is optional (`required: false`, City's own
+ * caller) — MoR has already accepted a live filing with it null, so an unmapped zone resolves to
+ * null instead of blocking the invoice.
+ */
+function resolveLocationCode(
+  field: "Region" | "Wereda" | "City",
+  value: string | null | undefined,
+  codes: Record<string, string>,
+  envVar: string,
+  invoiceNumber: string,
+  opts: { required?: boolean } = {},
+): string | null {
+  const raw = (value ?? "").trim();
+  if (LOCATION_CODE.test(raw)) return raw;
+
+  const key = raw.toLowerCase().replace(/\s+/g, " ");
+  const mapped = Object.entries(codes).find(
+    ([name]) => name.trim().toLowerCase().replace(/\s+/g, " ") === key,
+  )?.[1];
+  if (mapped && LOCATION_CODE.test(mapped)) return mapped;
+
+  if (opts.required === false) return null;
+
+  throw new Error(
+    `EIMS mapping: invoice ${invoiceNumber} has buyer ${field} ${raw ? `"${raw}"` : "(unset)"}, ` +
+      `which is not a MoR ${field} code and has no mapping. Add it to ${envVar}.`,
+  );
+}
+
+/**
+ * A buyer's `Country` as a MoR code: looked up by name in `codes` first; when unmapped, applies
+ * `domesticFallback` only if the stored country is empty or "Ethiopia" (the DB column's default).
+ * A genuinely foreign, unmapped country throws rather than silently filing as Ethiopia — same
+ * "fail locally, don't guess" rule as `resolveLocationCode`, but never digit-validated: MoR's
+ * Country code format is unconfirmed, unlike Region/Wereda's proven `^[0-9]{1,3}$`.
+ */
+function resolveCountryCode(
+  country: string | null | undefined,
+  codes: Record<string, string>,
+  domesticFallback: string | null,
+  invoiceNumber: string,
+): string | null {
+  const raw = (country ?? "").trim();
+  const key = raw.toLowerCase().replace(/\s+/g, " ");
+  const mapped = Object.entries(codes).find(
+    ([name]) => name.trim().toLowerCase().replace(/\s+/g, " ") === key,
+  )?.[1];
+  if (mapped) return mapped;
+
+  if ((!raw || key === "ethiopia") && domesticFallback) return domesticFallback;
+
+  throw new Error(
+    `EIMS mapping: invoice ${invoiceNumber} has buyer Country "${raw || "(unset)"}", which has no ` +
+      "MoR country code mapping. Add it to EIMS_BUYER_COUNTRY_CODES.",
+  );
+}
+
+/**
+ * Same name-or-code resolution as `resolveLocationCode`, for a caller with no invoice to attach an
+ * error to and that must never throw — currently only `EimsSellerCacheService`, resolving
+ * e-Trade's region/zone/woreda *names* for EDR's own seller identity. Pass-through numeric code,
+ * name lookup, `undefined` on no match — the caller falls back to static config either way.
+ */
+export function resolveOptionalCode(
+  value: string | null | undefined,
+  codes: Record<string, string>,
+): string | undefined {
+  const raw = (value ?? "").trim();
+  if (LOCATION_CODE.test(raw)) return raw;
+  const key = raw.toLowerCase().replace(/\s+/g, " ");
+  const mapped = Object.entries(codes).find(
+    ([name]) => name.trim().toLowerCase().replace(/\s+/g, " ") === key,
+  )?.[1];
+  return mapped && LOCATION_CODE.test(mapped) ? mapped : undefined;
+}
+
+export function toEimsInvoice(
+  invoice: EimsMapperInvoice,
+  seller: EimsSellerDetails,
+  context: EimsMapperContext,
+): EimsInvoiceRequest {
+  const company = invoice.company;
+  if (!company || !company.tin?.trim()) {
+    throw new Error(`EIMS mapping: invoice ${invoice.invoiceNumber} has no buyer company TIN`);
+  }
+  if (!invoice.lines?.length) {
+    throw new Error(`EIMS mapping: invoice ${invoice.invoiceNumber} has no lines`);
+  }
+  if (!invoice.issuedAt) {
+    throw new Error(`EIMS mapping: invoice ${invoice.invoiceNumber} is not issued (issuedAt is null)`);
+  }
+  if (invoice.currency !== "ETB" && context.exchangeRate == null) {
+    throw new Error(
+      `EIMS mapping: invoice ${invoice.invoiceNumber} is in ${invoice.currency} and needs an exchangeRate`,
+    );
+  }
+
+  const documentType = context.documentType ?? "INV";
+  if (!EIMS_DOCUMENT_TYPES.includes(documentType)) {
+    throw new Error(
+      `EIMS mapping: invoice ${invoice.invoiceNumber} has documentType "${documentType}", must be one of ${EIMS_DOCUMENT_TYPES.join(", ")}`,
+    );
+  }
+  if (documentType !== "INV") {
+    if (!context.reason?.trim()) {
+      throw new Error(
+        `EIMS mapping: invoice ${invoice.invoiceNumber} is a ${documentType} (debit/credit note) and needs a reason`,
+      );
+    }
+    if (!context.relatedDocument?.trim()) {
+      throw new Error(
+        `EIMS mapping: invoice ${invoice.invoiceNumber} is a ${documentType} (debit/credit note) and needs ` +
+          "relatedDocument — the original registered invoice's IRN",
+      );
+    }
+  }
+
+  const issuedAt = invoice.issuedAt instanceof Date ? invoice.issuedAt : new Date(invoice.issuedAt);
+  if (Number.isNaN(issuedAt.getTime())) {
+    throw new Error(`EIMS mapping: invoice ${invoice.invoiceNumber} has an unparseable issuedAt`);
+  }
+
+  const natureOfSupplies = context.natureOfSupplies.trim().toLowerCase();
+  if (!NATURE_OF_SUPPLIES.includes(natureOfSupplies as (typeof NATURE_OF_SUPPLIES)[number])) {
+    throw new Error(
+      `EIMS mapping: NatureOfSupplies must be one of ${NATURE_OF_SUPPLIES.join(", ")}, ` +
+        `got "${context.natureOfSupplies}"`,
+    );
+  }
+
+  const ItemList: EimsInvoiceItem[] = invoice.lines.map((line, index) => {
+    const lineNumber = index + 1;
+    const tax = context.taxForLine(line, lineNumber);
+    if (
+      !tax ||
+      !tax.code ||
+      !Number.isFinite(tax.ratePercent) ||
+      !Number.isFinite(tax.exciseTaxValue) ||
+      !Number.isFinite(tax.discount)
+    ) {
+      throw new Error(
+        `EIMS mapping: unresolved tax treatment for line ${lineNumber} (${line.chargeType}) ` +
+          `on invoice ${invoice.invoiceNumber}`,
+      );
+    }
+
+    const PreTaxValue = round2(num(line.amount));
+    const TaxAmount = round2((PreTaxValue * tax.ratePercent) / 100);
+    const ExciseTaxValue = round2(tax.exciseTaxValue);
+    // `line.metadata.unit` is our own fee-basis tag (PER_CONTAINER/PER_TON/PER_ITEM — how a charge
+    // is computed, see the fee-rule docs), never a MoR unit of measure — sending it as-is here
+    // (confirmed live 2026-08-17: "PER_CONTAINER" fails Unit's enum, its 8-char max, and its regex
+    // all at once) is what a prior version of this mapper did by mistake. MoR's own enum
+    // (LTR/MTR/101/PCS/ROL/MTS/PKG/SET/KLG) has no freight-shipment concept at all, so every line
+    // uses the single configured default rather than guessing a per-line value that doesn't exist.
+    const unit = context.unitDefault;
+
+    return {
+      Discount: round2(tax.discount),
+      ExciseTaxValue,
+      HarmonizationCode: null,
+      NatureOfSupplies: natureOfSupplies,
+      ItemCode: line.chargeType,
+      ProductDescription: line.description?.trim() || line.chargeType,
+      PreTaxValue,
+      Quantity: round2(num(line.quantity)),
+      LineNumber: lineNumber,
+      TaxAmount,
+      TaxCode: tax.code,
+      TotalLineAmount: round2(PreTaxValue + TaxAmount + ExciseTaxValue),
+      Unit: unit,
+      UnitPrice: round2(num(line.unitRate)),
+    };
+  });
+
+  const preTaxTotal = round2(ItemList.reduce((sum, item) => sum + item.PreTaxValue, 0));
+  const invoiceTotal = round2(num(invoice.totalAmount));
+  if (Math.abs(preTaxTotal - invoiceTotal) > 0.01) {
+    throw new Error(
+      `EIMS mapping: invoice ${invoice.invoiceNumber} lines sum to ${preTaxTotal} ` +
+        `but the invoice total is ${invoiceTotal}`,
+    );
+  }
+
+  const ValueDetails: EimsValueDetails = {
+    Discount: context.invoiceDiscount ?? null,
+    ExciseValue: round2(ItemList.reduce((sum, item) => sum + item.ExciseTaxValue, 0)),
+    IncomeWithholdValue: context.incomeWithholdValue,
+    TaxValue: round2(ItemList.reduce((sum, item) => sum + item.TaxAmount, 0)),
+    TotalValue: round2(ItemList.reduce((sum, item) => sum + item.TotalLineAmount, 0)),
+    TransactionWithholdValue: context.transactionWithholdValue,
+    InvoiceCurrency: invoice.currency,
+  };
+  if (context.exchangeRate != null) ValueDetails.ExchangeRate = context.exchangeRate;
+
+  return {
+    BuyerDetails: {
+      // No dedicated city column on Company — Zone is the closest match; optional (see
+      // resolveLocationCode's City comment).
+      City: resolveLocationCode(
+        "City",
+        company.zone,
+        context.buyerCityCodes,
+        "EIMS_BUYER_CITY_CODES",
+        invoice.invoiceNumber,
+        { required: false },
+      ),
+      Email: company.email ?? null,
+      HouseNumber: company.houseNo ?? null,
+      IdNumber: context.buyerIdNumber ?? null,
+      IdType: context.buyerIdType ?? null,
+      Tin: company.tin,
+      LegalName: company.name,
+      Phone: company.phone ?? null,
+      Region: resolveLocationCode(
+        "Region",
+        company.region,
+        context.buyerRegionCodes,
+        "EIMS_BUYER_REGION_CODES",
+        invoice.invoiceNumber,
+      ),
+      Country: resolveCountryCode(
+        company.country,
+        context.buyerCountryCodes,
+        context.buyerCountryCode ?? null,
+        invoice.invoiceNumber,
+      ),
+      Zone: company.zone ?? null,
+      Kebele: company.kebele ?? null,
+      VatNumber: company.vatNumber ?? null,
+      Wereda: resolveLocationCode(
+        "Wereda",
+        company.woreda,
+        context.buyerWeredaCodes,
+        "EIMS_BUYER_WEREDA_CODES",
+        invoice.invoiceNumber,
+      ),
+    },
+    DocumentDetails: {
+      DocumentNumber: context.documentNumber,
+      Date: (context.formatDate ?? formatEimsDate)(issuedAt),
+      Type: documentType,
+      ...(documentType !== "INV" ? { Reason: context.reason! } : {}),
+    },
+    ItemList,
+    PaymentDetails: { Mode: context.payment.mode, PaymentTerm: context.payment.term },
+    ReferenceDetails: {
+      PreviousIrn: context.previousIrn,
+      RelatedDocument: context.relatedDocument ?? null,
+    },
+    SellerDetails: seller,
+    SourceSystem: {
+      CashierName: context.cashierName,
+      InvoiceCounter: context.invoiceCounter,
+      SalesPersonName: context.salesPersonName,
+      SystemNumber: context.systemNumber,
+      SystemType: context.systemType,
+    },
+    TransactionType: context.transactionType,
+    ValueDetails,
+    Version: EIMS_VERSION,
+  };
+}
diff --git a/apps/edr-freight-api/src/modules/billing/entities/invoice.entity.ts b/apps/edr-freight-api/src/modules/billing/entities/invoice.entity.ts
index 23c332f80..66bf0f452 100644
--- a/apps/edr-freight-api/src/modules/billing/entities/invoice.entity.ts
+++ b/apps/edr-freight-api/src/modules/billing/entities/invoice.entity.ts
@@ -1,6 +1,7 @@
 import { BaseEntity } from "@edr/api-common";
 import { Freight } from "@edr/types";
 import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+import type { EimsInvoiceError, EimsInvoiceStatus } from "../../eims/eims-registration.types";
 import { PaymentEntity } from "../../payment/entities/payment.entity";
 import { Company } from "../../companies/entities/company.entity";
 import { CompanyProfile } from "../../companies/entities/company-profile.entity";
@@ -22,22 +23,37 @@ export class Invoice extends BaseEntity {
   @Column({ name: "invoice_number", type: "varchar", length: 64, unique: true })
   invoiceNumber!: string;
 
-  /** The customer (company) this invoice is billed to. */
-  @Column({ name: "company_id", type: "uuid" })
-  companyId!: string;
+  /**
+   * The customer (company) this invoice is billed to. Null on a shipping-line
+   * invoice, which is billed to `shippingLineCompanyId` instead — a shipping
+   * line is deliberately not a `companies` row. A DB CHECK
+   * (`chk_invoices_single_payer`) guarantees exactly one of the two is set.
+   */
+  @Column({ name: "company_id", type: "uuid", nullable: true })
+  companyId!: string | null;
 
   @ManyToOne(() => Company)
   @JoinColumn({ name: "company_id" })
   company?: Company;
 
   /** The specific company profile (importer/exporter/forwarder/...) billed. */
-  @Column({ name: "company_profile_id", type: "uuid" })
-  companyProfileId!: string;
+  @Column({ name: "company_profile_id", type: "uuid", nullable: true })
+  companyProfileId!: string | null;
 
   @ManyToOne(() => CompanyProfile)
   @JoinColumn({ name: "company_profile_id" })
   companyProfile?: CompanyProfile;
 
+  /**
+   * The shipping line billed, when this invoice bills batched shipping-line
+   * credits rather than a customer booking. Mutually exclusive with
+   * `companyId`. No relation is declared: `ShippingLineCredit` already owns
+   * that edge, and importing the shipping-lines module here would close an
+   * import cycle (shipping-lines already depends on billing).
+   */
+  @Column({ name: "shipping_line_company_id", type: "uuid", nullable: true })
+  shippingLineCompanyId?: string | null;
+
   /** Sum of line amounts before tax; defaults to `totalAmount` for tax-free invoices. */
   @Column({ name: "subtotal_amount", type: "numeric", precision: 14, scale: 2, default: 0 })
   subtotalAmount!: number;
@@ -105,4 +121,94 @@ export class Invoice extends BaseEntity {
 
   @Column({ name: "due_at", type: "timestamptz" })
   dueAt!: Date;
+
+  /** MoR EIMS registration state. Set only by the EIMS module; billing never writes these. */
+  @Column({ name: "eims_status", type: "varchar", length: 20, default: "NOT_SUBMITTED" })
+  eimsStatus!: EimsInvoiceStatus;
+
+  /**
+   * Invoice Reference Number returned by EIMS. Unique across invoices (partial index). `text`,
+   * not a fixed varchar — MoR has never documented an IRN format/length, and a real live value
+   * (a `test-` prefix + 64 hex chars, 69 chars total) already overflowed a prior varchar(64).
+   */
+  @Column({ name: "eims_irn", type: "text", nullable: true })
+  eimsIrn?: string | null;
+
+  /**
+   * `signedQR` from the register response — a base64 PNG image, already rendered by MoR (confirmed
+   * against the Postman collection's saved response: decodes to a PNG magic-byte header). Stored
+   * verbatim; `BillingService.renderEimsQr` only wraps it in a `data:image/png;base64,` URL.
+   */
+  @Column({ name: "eims_signed_qr", type: "text", nullable: true })
+  eimsSignedQr?: string | null;
+
+  /** The numeric `DocumentDetails.DocumentNumber` filed for this invoice. */
+  @Column({ name: "eims_document_number", type: "varchar", length: 16, nullable: true })
+  eimsDocumentNumber?: string | null;
+
+  /** The `SourceSystem.InvoiceCounter` this invoice consumed. */
+  @Column({ name: "eims_invoice_counter", type: "bigint", nullable: true })
+  eimsInvoiceCounter?: number | null;
+
+  @Column({ name: "eims_submitted_at", type: "timestamptz", nullable: true })
+  eimsSubmittedAt?: Date | null;
+
+  /** EIMS acknowledgement timestamp, stored verbatim — it is a Java ZonedDateTime string. */
+  @Column({ name: "eims_ack_date", type: "varchar", length: 64, nullable: true })
+  eimsAckDate?: string | null;
+
+  /** Sanitized last failure: the gateway's own error fields only, never our signed envelope. */
+  @Column({ name: "eims_last_error", type: "jsonb", nullable: true })
+  eimsLastError?: EimsInvoiceError | null;
+
+  /**
+   * `POST /v1/cancel` — set together, only once `eimsStatus` reaches CANCELLED.
+   * `eimsCancelledAt` is our own server time (same convention as `eimsSubmittedAt`);
+   * `eimsCancellationDate` is MoR's own confirmation string, stored verbatim like `eimsAckDate` —
+   * its format (`"Sun Dec 22 21:55:03 EAT 2024"`, a Java `Date#toString()`) is not reliably
+   * `Date.parse`-able (the `EAT` zone abbreviation is non-standard), so it is never parsed.
+   */
+  @Column({ name: "eims_cancelled_at", type: "timestamptz", nullable: true })
+  eimsCancelledAt?: Date | null;
+
+  @Column({ name: "eims_cancellation_date", type: "varchar", length: 64, nullable: true })
+  eimsCancellationDate?: string | null;
+
+  /** Numeric string per the collection docs, e.g. "1" (Duplicate), "6" (Calculation Error). */
+  @Column({ name: "eims_cancellation_reason_code", type: "varchar", length: 8, nullable: true })
+  eimsCancellationReasonCode?: string | null;
+
+  @Column({ name: "eims_cancellation_remark", type: "text", nullable: true })
+  eimsCancellationRemark?: string | null;
+
+  /**
+   * `DocumentDetails.Type` to file this invoice as — "INV" (default), "DEB" or "CRE". Confirmed
+   * by MoR support directly (not the collection): debit/credit notes go through this same
+   * `/v1/register` endpoint, distinguished only by `Type` + `Reason`, linked via
+   * `ReferenceDetails.RelatedDocument` to the original invoice's IRN. This module does not create
+   * debit/credit note invoices — that is a freight-workflow decision — it only files one
+   * correctly once these columns are set on an existing row.
+   */
+  @Column({ name: "eims_document_type", type: "varchar", length: 8, default: "INV" })
+  eimsDocumentType!: string;
+
+  /** Required by MoR when `eimsDocumentType` is DEB/CRE — why the note was issued. */
+  @Column({ name: "eims_reason", type: "text", nullable: true })
+  eimsReason?: string | null;
+
+  /** The original registered invoice this debit/credit note adjusts. Required for DEB/CRE. */
+  @Column({ name: "related_invoice_id", type: "uuid", nullable: true })
+  relatedInvoiceId?: string | null;
+
+  @ManyToOne(() => Invoice)
+  @JoinColumn({ name: "related_invoice_id" })
+  relatedInvoice?: Invoice | null;
+
+  /**
+   * Which `POST /v1/bulkRegister` batch this invoice was submitted in, if any — MoR's own
+   * conversation id, not one we generate. Lets a stuck batch (webhook never arrived) be found and
+   * reconciled. Null for every invoice filed through single `/v1/register`.
+   */
+  @Column({ name: "eims_bulk_conversation_id", type: "text", nullable: true })
+  eimsBulkConversationId?: string | null;
 }
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-clearance-charge.service.ts b/apps/edr-freight-api/src/modules/bookings/booking-clearance-charge.service.ts
new file mode 100644
index 000000000..f41bff39d
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/booking-clearance-charge.service.ts
@@ -0,0 +1,391 @@
+import {
+  BadRequestException,
+  ConflictException,
+  Injectable,
+  Logger,
+  NotFoundException,
+} from '@nestjs/common';
+import { OnEvent } from '@nestjs/event-emitter';
+import { DataSource } from 'typeorm';
+import { Freight } from '@edr/types';
+
+import { BillingService, InvoiceEventPayload } from '../billing/billing.service';
+import { Invoice } from '../billing/entities/invoice.entity';
+import { FilesService } from '../files/files.service';
+import { BookingsService } from './bookings.service';
+import { BookingsRepository } from './bookings.repository';
+import { Booking } from './entities/booking.entity';
+import {
+  BookingClearanceCharge,
+  ClearanceChargeType,
+} from './entities/booking-clearance-charge.entity';
+import { ClearanceEventService } from './clearance-event.service';
+
+/** File-record codes the charge documents are stored under on the booking. */
+const CHARGE_FILE_CODE: Record<ClearanceChargeType, string> = {
+  PORT_CHARGES: 'clearance_charge_port',
+  MISCELLANEOUS: 'clearance_charge_misc',
+};
+
+const CHARGE_LABEL: Record<ClearanceChargeType, string> = {
+  PORT_CHARGES: 'Port charges',
+  MISCELLANEOUS: 'Miscellaneous charges',
+};
+
+/**
+ * Post-finalization clearance charges billed to the customer. Two levels per
+ * booking: GL Djibouti uploads the port-charges document; GL Ethiopia bills it
+ * (amount + currency) and sends the invoice; once that invoice is paid GL
+ * Ethiopia may create and send the miscellaneous charge. ETB invoices are paid
+ * through the portal gateway, other currencies through Finance's manual
+ * settlement worklist — both settle via `clearance_charge.invoice.paid`.
+ */
+@Injectable()
+export class BookingClearanceChargeService {
+  private readonly logger = new Logger(BookingClearanceChargeService.name);
+
+  constructor(
+    private readonly dataSource: DataSource,
+    private readonly filesService: FilesService,
+    private readonly billing: BillingService,
+    private readonly bookingsService: BookingsService,
+    private readonly bookingsRepository: BookingsRepository,
+    private readonly clearanceEvents: ClearanceEventService,
+  ) {}
+
+  private repo() {
+    return this.dataSource.getRepository(BookingClearanceCharge);
+  }
+
+  /**
+   * Charges are a post-finalization step: block while the customer's clearance
+   * documents are still being collected/reviewed.
+   */
+  private assertClearanceFinalized(booking: Booking): void {
+    const inReview =
+      booking.status === 'AWAITING_DOCUMENTS' ||
+      booking.status === 'DOCUMENTS_UNDER_REVIEW';
+    if (inReview && !booking.preClearanceFinalizedAt) {
+      throw new BadRequestException(
+        'Clearance charges open after document clearance is finalized.',
+      );
+    }
+  }
+
+  async list(bookingId: string): Promise<Freight.ClearanceCharge[]> {
+    const charges = await this.repo().find({
+      where: { bookingId },
+      order: { createdAt: 'ASC' },
+    });
+    if (charges.length === 0) return [];
+
+    const files = await this.filesService.findByResource(bookingId, 'bookings');
+    const fileById = new Map(files.map((f) => [f.id, f]));
+    const names = await this.bookingsRepository.resolveStaffNames(
+      charges.flatMap((c) => [c.uploadedByStaffId, c.billedByStaffId]),
+    );
+    const invoiceIds = charges
+      .map((c) => c.invoiceId)
+      .filter((id): id is string => Boolean(id));
+    const invoices = invoiceIds.length
+      ? await this.dataSource
+          .getRepository(Invoice)
+          .find({ where: invoiceIds.map((id) => ({ id })) })
+      : [];
+    const invoiceById = new Map(invoices.map((i) => [i.id, i]));
+
+    return charges.map((c) => {
+      const file = c.fileRecordId ? (fileById.get(c.fileRecordId) ?? null) : null;
+      return {
+        id: c.id,
+        bookingId: c.bookingId,
+        type: c.type,
+        status: c.status,
+        file: file ? { id: file.id, name: file.name, url: file.url } : null,
+        amount: c.amount != null ? Number(c.amount) : null,
+        currency: c.currency ?? null,
+        invoiceId: c.invoiceId ?? null,
+        invoiceNumber: c.invoiceId
+          ? (invoiceById.get(c.invoiceId)?.invoiceNumber ?? null)
+          : null,
+        uploadedByName: c.uploadedByStaffId
+          ? (names.get(c.uploadedByStaffId) ?? null)
+          : null,
+        uploadedAt: c.uploadedAt ? c.uploadedAt.toISOString() : null,
+        billedByName: c.billedByStaffId
+          ? (names.get(c.billedByStaffId) ?? null)
+          : null,
+        billedAt: c.billedAt ? c.billedAt.toISOString() : null,
+        paidAt: c.paidAt ? c.paidAt.toISOString() : null,
+      };
+    });
+  }
+
+  /** GL Djibouti uploads (or replaces, until billed) the port-charges document. */
+  async uploadPortDocument(
+    bookingId: string,
+    file: Express.Multer.File,
+    staffId: string,
+  ): Promise<Freight.ClearanceCharge[]> {
+    const booking = await this.bookingsService.findById(bookingId);
+    this.assertClearanceFinalized(booking);
+
+    const existing = await this.repo().findOne({
+      where: { bookingId, type: 'PORT_CHARGES' },
+    });
+    if (existing && existing.status !== 'DOC_UPLOADED') {
+      throw new ConflictException(
+        'The port charge has already been billed — ask GL Ethiopia to revise it instead.',
+      );
+    }
+
+    const record = await this.filesService.upsertByCode(
+      {
+        resourceId: bookingId,
+        resource: 'bookings',
+        code: CHARGE_FILE_CODE.PORT_CHARGES,
+        file,
+      },
+      { userId: staffId },
+    );
+
+    if (existing) {
+      await this.repo().update(existing.id, {
+        fileRecordId: record.id,
+        uploadedByStaffId: staffId,
+        uploadedAt: new Date(),
+      });
+    } else {
+      await this.repo().save(
+        this.repo().create({
+          bookingId,
+          type: 'PORT_CHARGES',
+          status: 'DOC_UPLOADED',
+          fileRecordId: record.id,
+          uploadedByStaffId: staffId,
+          uploadedAt: new Date(),
+        }),
+      );
+    }
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'CHARGE_PORT_DOC_UPLOADED',
+      label: existing
+        ? 'Replaced the port-charges document'
+        : 'Uploaded the port-charges document',
+      actorId: staffId,
+      metadata: { fileName: file.originalname },
+    });
+    return this.list(bookingId);
+  }
+
+  /**
+   * GL Ethiopia sets (or, on the customer's request, revises) amount +
+   * currency. Revising a SENT charge cancels its unpaid invoice; a PAID charge
+   * is immutable.
+   */
+  async billCharge(
+    bookingId: string,
+    chargeId: string,
+    input: { amount: number; currency: string },
+    staffId: string,
+  ): Promise<Freight.ClearanceCharge[]> {
+    const charge = await this.repo().findOne({
+      where: { id: chargeId, bookingId },
+    });
+    if (!charge) throw new NotFoundException('Clearance charge not found');
+    if (charge.status === 'PAID') {
+      throw new ConflictException('A paid charge can no longer be changed.');
+    }
+    if (!(input.amount > 0)) {
+      throw new BadRequestException('Amount must be greater than zero.');
+    }
+    if (!input.currency?.trim()) {
+      throw new BadRequestException('Currency is required.');
+    }
+
+    if (charge.status === 'SENT' && charge.invoiceId) {
+      await this.billing.cancelInvoice(charge.invoiceId);
+    }
+
+    await this.repo().update(charge.id, {
+      amount: input.amount.toFixed(2),
+      currency: input.currency.trim().toUpperCase(),
+      status: 'BILLED',
+      invoiceId: null,
+      billedByStaffId: staffId,
+      billedAt: new Date(),
+    });
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'CHARGE_BILLED',
+      label: `${charge.status === 'SENT' ? 'Revised' : 'Billed'} ${CHARGE_LABEL[
+        charge.type
+      ].toLowerCase()}: ${input.amount} ${input.currency.trim().toUpperCase()}`,
+      actorId: staffId,
+      metadata: {
+        chargeType: charge.type,
+        amount: input.amount,
+        currency: input.currency.trim().toUpperCase(),
+        revised: charge.status === 'SENT',
+      },
+    });
+    return this.list(bookingId);
+  }
+
+  /** GL Ethiopia issues the payable invoice to the customer. */
+  async sendCharge(
+    bookingId: string,
+    chargeId: string,
+    staffId?: string,
+  ): Promise<Freight.ClearanceCharge[]> {
+    const charge = await this.repo().findOne({
+      where: { id: chargeId, bookingId },
+    });
+    if (!charge) throw new NotFoundException('Clearance charge not found');
+    if (charge.status !== 'BILLED') {
+      throw new ConflictException(
+        'Set the amount and currency before sending the charge to the customer.',
+      );
+    }
+
+    const booking = await this.bookingsService.findById(bookingId);
+    const invoice = await this.billing.generateInvoice({
+      source: Freight.InvoiceSource.ClearanceCharge,
+      // The charge's own id, NOT the booking id — booking-scoped invoice
+      // lookups (findPayable/expirePayable/CBE billQuery) must never match it.
+      sourceId: charge.id,
+      type: charge.type,
+      companyId: booking.companyId,
+      companyProfileId: booking.companyProfileId,
+      currency: charge.currency ?? 'ETB',
+      lines: [
+        {
+          chargeType: charge.type,
+          description: `${CHARGE_LABEL[charge.type]} — ${booking.reference ?? bookingId}`,
+          amount: Number(charge.amount),
+        },
+      ],
+    });
+
+    await this.repo().update(charge.id, {
+      status: 'SENT',
+      invoiceId: invoice.id,
+    });
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'CHARGE_INVOICE_SENT',
+      label: `Sent ${CHARGE_LABEL[charge.type].toLowerCase()} invoice ${invoice.invoiceNumber} to the customer`,
+      actorId: staffId ?? null,
+      metadata: {
+        chargeType: charge.type,
+        invoiceNumber: invoice.invoiceNumber,
+        amount: Number(charge.amount),
+        currency: charge.currency,
+      },
+    });
+    this.logger.log(
+      `Clearance charge ${charge.type} on booking ${bookingId} sent as invoice ${invoice.invoiceNumber}`,
+    );
+    return this.list(bookingId);
+  }
+
+  /**
+   * GL Ethiopia creates the miscellaneous charge whole (document + amount +
+   * currency). Second payment level: allowed only once the port charge is paid.
+   */
+  async createMiscellaneous(
+    bookingId: string,
+    file: Express.Multer.File,
+    input: { amount: number; currency: string },
+    staffId: string,
+  ): Promise<Freight.ClearanceCharge[]> {
+    const booking = await this.bookingsService.findById(bookingId);
+    this.assertClearanceFinalized(booking);
+
+    const port = await this.repo().findOne({
+      where: { bookingId, type: 'PORT_CHARGES' },
+    });
+    if (port?.status !== 'PAID') {
+      throw new ConflictException(
+        'Miscellaneous charges open after the port charge is paid.',
+      );
+    }
+    const existing = await this.repo().findOne({
+      where: { bookingId, type: 'MISCELLANEOUS' },
+    });
+    if (existing) {
+      throw new ConflictException(
+        'This booking already has a miscellaneous charge — revise it instead.',
+      );
+    }
+    if (!(input.amount > 0)) {
+      throw new BadRequestException('Amount must be greater than zero.');
+    }
+    if (!input.currency?.trim()) {
+      throw new BadRequestException('Currency is required.');
+    }
+
+    const record = await this.filesService.upsertByCode(
+      {
+        resourceId: bookingId,
+        resource: 'bookings',
+        code: CHARGE_FILE_CODE.MISCELLANEOUS,
+        file,
+      },
+      { userId: staffId },
+    );
+    await this.repo().save(
+      this.repo().create({
+        bookingId,
+        type: 'MISCELLANEOUS',
+        status: 'BILLED',
+        fileRecordId: record.id,
+        amount: input.amount.toFixed(2),
+        currency: input.currency.trim().toUpperCase(),
+        uploadedByStaffId: staffId,
+        uploadedAt: new Date(),
+        billedByStaffId: staffId,
+        billedAt: new Date(),
+      }),
+    );
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'CHARGE_MISC_CREATED',
+      label: `Created miscellaneous charge: ${input.amount} ${input.currency.trim().toUpperCase()}`,
+      actorId: staffId,
+      metadata: {
+        amount: input.amount,
+        currency: input.currency.trim().toUpperCase(),
+        fileName: file.originalname,
+      },
+    });
+    return this.list(bookingId);
+  }
+
+  /** Gateway and manual settlements both land here (`${source}.invoice.paid`). */
+  @OnEvent('clearance_charge.invoice.paid')
+  async onChargeInvoicePaid(payload: InvoiceEventPayload): Promise<void> {
+    const charge = await this.repo().findOne({
+      where: { id: payload.sourceId },
+    });
+    if (!charge || charge.status === 'PAID') return;
+    await this.repo().update(charge.id, {
+      status: 'PAID',
+      paidAt: new Date(),
+    });
+    await this.clearanceEvents.record({
+      bookingId: charge.bookingId,
+      action: 'CHARGE_PAID',
+      label: `${CHARGE_LABEL[charge.type]} paid (invoice ${payload.invoiceNumber})`,
+      actorType: 'SYSTEM',
+      metadata: {
+        chargeType: charge.type,
+        invoiceNumber: payload.invoiceNumber,
+      },
+    });
+    this.logger.log(
+      `Clearance charge ${charge.type} on booking ${charge.bookingId} paid (invoice ${payload.invoiceNumber})`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-contract.service.ts b/apps/edr-freight-api/src/modules/bookings/booking-contract.service.ts
index 095928bb3..70657f9f6 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-contract.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-contract.service.ts
@@ -304,6 +304,7 @@ export class BookingContractService {
   async getSignatures(bookingId: string) {
     const rows = await this.bookingsRepository.findContractSignatures(bookingId);
     const views = rows.map((r) => this.viewModelBuilder.toSignatureView(r));
+    await this.viewModelBuilder.attachProviderStamp(views);
     await this.inlineSignatureImages(views);
     return { signatures: views };
   }
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.spec.ts b/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.spec.ts
index 2c21d804c..c9bdc4845 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.spec.ts
@@ -1,5 +1,6 @@
 import { BookingLifecycleNotifierService } from './booking-lifecycle-notifier.service';
 import type { Booking } from './entities/booking.entity';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
 
 /**
  * Who hears "Operations wants changes" depends on who owns the booking. A
@@ -35,9 +36,13 @@ describe('BookingLifecycleNotifierService — operation changes requested', () =
     );
   });
 
-  it('sends a GL-created booking back to the GL who created it, not the customer', async () => {
+  it('sends a GL-created customs booking back to the GL who created it, not the customer', async () => {
     service.operationChangesRequested(
-      booking({ createdByRole: 'GL_ET', createdByUserId: 'gl-user-1' }),
+      booking({
+        customsClearingEnabled: true,
+        createdByRole: 'GL_ET',
+        createdByUserId: 'gl-user-1',
+      }),
       'Cargo weight does not match the declaration',
     );
     await flush();
@@ -53,7 +58,7 @@ describe('BookingLifecycleNotifierService — operation changes requested', () =
     expect(notifications.directSend).not.toHaveBeenCalled();
   });
 
-  it('still tells the customer when the booking is their own', async () => {
+  it('still tells the customer when the booking is a non-customs self-service booking', async () => {
     service.operationChangesRequested(booking(), 'Please attach the packing list');
     await flush();
 
@@ -64,13 +69,73 @@ describe('BookingLifecycleNotifierService — operation changes requested', () =
     expect(notifications.directSend).toHaveBeenCalled();
   });
 
-  it('falls back to the customer when the GL creator is unknown (legacy rows)', async () => {
+  it('routes a customer-opened customs booking to the clearance desk, not the customer', async () => {
+    // Path B lets the customer open the ONE_TIME shipment instance themselves
+    // (contract-booking.service assertGate's customerMayInitiate) — createdByRole
+    // stays 'CUSTOMER', but GL still owns completing/resubmitting it.
     service.operationChangesRequested(
-      booking({ createdByRole: 'GL_ET', createdByUserId: null }),
+      booking({ customsClearingEnabled: true, createdByRole: 'CUSTOMER' }),
       'Fix the declaration',
     );
     await flush();
 
-    expect(inbox.notify.mock.calls[0][0].recipients).toEqual({ companyId: 'co-1' });
+    const sent = inbox.notify.mock.calls[0][0];
+    expect(sent.recipients).toEqual({
+      permissionKeys: [FREIGHT_PERMS.bookings.clearanceGetNotification],
+    });
+    expect(sent.audience).toBe('BACKOFFICE');
+    expect(notifications.directSend).not.toHaveBeenCalled();
+  });
+
+  it('falls back to the clearance desk when the GL creator is unknown (legacy rows)', async () => {
+    service.operationChangesRequested(
+      booking({
+        customsClearingEnabled: true,
+        createdByRole: 'GL_ET',
+        createdByUserId: null,
+      }),
+      'Fix the declaration',
+    );
+    await flush();
+
+    expect(inbox.notify.mock.calls[0][0].recipients).toEqual({
+      permissionKeys: [FREIGHT_PERMS.bookings.clearanceGetNotification],
+    });
+  });
+});
+
+/**
+ * Staff notifications used to go to every employee in every organization. They
+ * now target a desk — and the two desks are disjoint: the GL presets hold no
+ * bookings:view and no intake keys, so intake pings would be noise they cannot
+ * act on. Both branches run through the same `inAppStaff` helper, which is the
+ * easy place to lose the distinction again.
+ */
+describe('BookingLifecycleNotifierService — staff desk targeting', () => {
+  const booking = () =>
+    ({ id: 'b-1', reference: 'BKG-0001', companyId: 'co-1' }) as Booking;
+
+  let inbox: { notify: jest.Mock };
+  let service: BookingLifecycleNotifierService;
+
+  beforeEach(() => {
+    inbox = { notify: jest.fn().mockResolvedValue(undefined) };
+    service = new BookingLifecycleNotifierService(
+      { directSend: jest.fn().mockResolvedValue(undefined) } as never,
+      inbox as never,
+      { query: jest.fn().mockResolvedValue([]) } as never,
+    );
+  });
+
+  it('routes intake items to the booking desk and clearance items to the clearance desk', () => {
+    service.submittedToStaff(booking());
+    service.clearanceDocsUploadedToStaff(booking());
+
+    expect(inbox.notify.mock.calls[0][0].recipients).toEqual({
+      permissionKeys: [FREIGHT_PERMS.bookings.getNotification],
+    });
+    expect(inbox.notify.mock.calls[1][0].recipients).toEqual({
+      permissionKeys: [FREIGHT_PERMS.bookings.clearanceGetNotification],
+    });
   });
 });
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.ts b/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.ts
index 6245195eb..78c07bd22 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-lifecycle-notifier.service.ts
@@ -10,7 +10,18 @@ import {
 import { Booking } from './entities/booking.entity';
 import { NotificationsService } from '../notifications/notifications.service';
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
-import { resolveCompanyNotifyPhone } from '../notifications/resolve-company-phone.util';
+import { resolveCompanyNotifyContact } from '../notifications/resolve-company-phone.util';
+import { resolveShippingLineNotifyTarget } from '../notifications/resolve-shipping-line-contact.util';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
+
+/**
+ * Clearance items are worked by the GL desks, which hold no bookings:view and
+ * no intake keys — so they take their own selector rather than the booking
+ * desk's. Every override using this deep-links to a clearance page.
+ */
+const CLEARANCE_DESK = {
+  permissionKeys: [FREIGHT_PERMS.bookings.clearanceGetNotification],
+};
 
 /**
  * Customer + staff notifications for the booking lifecycle: review, clearance
@@ -45,10 +56,19 @@ export class BookingLifecycleNotifierService {
     logLabel: string,
   ): Promise<void> {
     this.logger.log(`${logLabel} — ${this.ref(b)}`);
-    const phone = b.companyId
-      ? await resolveCompanyNotifyPhone(this.dataSource, b.companyId)
-      : null;
-    const email = b.company?.email ?? b.company?.generalManagerEmail ?? null;
+    // Both channels come from the same resolver: the company row's own columns
+    // are only half the story (see companyNotifyEmailExpr), and reading them off
+    // the loaded entity silently dropped every mail to a company whose address
+    // lives in `attributes`. A shipping-line booking has NO company — its
+    // contact lives on the shipping_line_companies row itself.
+    const { phone, email } = b.shippingLineCompanyId
+      ? await resolveShippingLineNotifyTarget(
+          this.dataSource,
+          b.shippingLineCompanyId,
+        )
+      : b.companyId
+        ? await resolveCompanyNotifyContact(this.dataSource, b.companyId)
+        : { phone: null, email: null };
 
     if (phone) {
       try {
@@ -69,13 +89,44 @@ export class BookingLifecycleNotifierService {
     }
   }
 
-  /** Persist + push an in-app item to all portal users of the booking's company. */
+  /**
+   * Persist + push an in-app item to the booking's portal owner: every portal
+   * user of the company, or — for a shipping-line booking — the line's own
+   * account, deep-linked into the shipping-line app rather than the customer
+   * one (its routes live under /shipping-line/*).
+   */
   private inApp(
     b: Booking,
     title: string,
     body: string,
     overrides: Partial<NotifyInput> = {},
   ): void {
+    if (b.shippingLineCompanyId) {
+      void (async () => {
+        const { userId } = await resolveShippingLineNotifyTarget(
+          this.dataSource,
+          b.shippingLineCompanyId!,
+        );
+        if (!userId) return;
+        void this.inbox.notify({
+          recipients: { userIds: [userId] },
+          audience: NotificationAudience.PORTAL,
+          type: NotificationType.BOOKING_STATUS,
+          title,
+          body,
+          data: { bookingId: b.id, reference: b.reference },
+          ...overrides,
+          // After the spread: overrides carry customer links — the bell must
+          // land a shipping line on ITS booking page.
+          link: `/shipping-line/bookings/${b.id}`,
+        });
+      })().catch((err) =>
+        this.logger.warn(
+          `shipping-line inApp failed for ${this.ref(b)}: ${(err as Error).message}`,
+        ),
+      );
+      return;
+    }
     if (!b.companyId) return; // government/unlinked bookings have no portal users
     void this.inbox.notify({
       recipients: { companyId: b.companyId },
@@ -89,7 +140,11 @@ export class BookingLifecycleNotifierService {
     });
   }
 
-  /** Persist + push an in-app item to every backoffice staff user. */
+  /**
+   * Persist + push an in-app item to the booking desk — staff holding
+   * `bookings:get_notification`. Callers whose item belongs to a different desk
+   * override `recipients` (see {@link CLEARANCE_DESK}).
+   */
   private inAppStaff(
     b: Booking,
     title: string,
@@ -97,7 +152,7 @@ export class BookingLifecycleNotifierService {
     overrides: Partial<NotifyInput> = {},
   ): void {
     void this.inbox.notify({
-      recipients: { allBackoffice: true },
+      recipients: { permissionKeys: [FREIGHT_PERMS.bookings.getNotification] },
       audience: NotificationAudience.BACKOFFICE,
       type: NotificationType.REQUEST_SUBMITTED,
       title,
@@ -159,13 +214,23 @@ export class BookingLifecycleNotifierService {
 
   /** Document approval finalized → customer can proceed to request operation. */
   clearanceReady(b: Booking): void {
-    const msg =
-      `Document approval for booking ${b.reference} is finalized. ` +
-      `You can now proceed to request operation from the portal.`;
+    // A shipping line's next move is BOOKING (cargo + shipment day), not the
+    // customer's operation-request step — say so, or the message points at a
+    // flow their portal does not have.
+    const msg = b.shippingLineCompanyId
+      ? `Documents for booking ${b.reference} are approved. ` +
+        `You can now book your shipment — enter the cargo and shipment day from the portal.`
+      : `Document approval for booking ${b.reference} is finalized. ` +
+        `You can now proceed to request operation from the portal.`;
     void this.notifyContact(b, msg, 'DOCUMENT APPROVAL FINALIZED');
-    this.inApp(b, 'Document approval finalized', msg, {
-      type: NotificationType.CLEARANCE_DECISION,
-    });
+    this.inApp(
+      b,
+      b.shippingLineCompanyId
+        ? 'Documents approved — book your shipment'
+        : 'Document approval finalized',
+      msg,
+      { type: NotificationType.CLEARANCE_DECISION },
+    );
   }
 
   /** Intercity documents approved → booking waits in the ride-along pool. */
@@ -182,20 +247,27 @@ export class BookingLifecycleNotifierService {
   /**
    * Operations returned the operation request for changes.
    *
-   * A customs (Path B) booking was created BY GL Ethiopia on the customer's
-   * behalf — the customer cannot edit or resubmit it, so telling them to "update
-   * from the portal" is a dead end. Those go to the GL who created it, linking
-   * the contract clearance page they work from. Everything else (customer-made
-   * bookings) keeps the portal message.
+   * A customs (Path B) booking is completed by GL Ethiopia on the customer's
+   * behalf regardless of who opened the shipment instance — the customer-opened
+   * ONE_TIME case (see contract-booking.service assertGate) still stamps
+   * createdByRole 'CUSTOMER', so gate on customsClearingEnabled, not on who
+   * created it. The customer cannot edit or resubmit a customs booking, so
+   * telling them to "update from the portal" is a dead end. Those go to the GL
+   * who created it when known, else the clearance desk, linking the contract
+   * clearance page they work from. Everything else (customer-made bookings)
+   * keeps the portal message.
    */
   operationChangesRequested(b: Booking, note: string): void {
-    if (b.createdByRole === 'GL_ET' && b.createdByUserId) {
+    if (b.customsClearingEnabled) {
       const msg =
         `Operations returned booking ${b.reference} for changes: ${note}. ` +
         `Address it on the contract clearance page and resubmit to Operations.`;
       this.logger.log(`OPERATION CHANGES REQUESTED (to GL) — ${this.ref(b)}`);
       void this.inbox.notify({
-        recipients: { userIds: [b.createdByUserId] },
+        recipients:
+          b.createdByRole === 'GL_ET' && b.createdByUserId
+            ? { userIds: [b.createdByUserId] }
+            : CLEARANCE_DESK,
         audience: NotificationAudience.BACKOFFICE,
         type: NotificationType.BOOKING_STATUS,
         title: `Booking ${b.reference} needs changes`,
@@ -217,11 +289,19 @@ export class BookingLifecycleNotifierService {
 
   /** Operation accepted → invoice ready; await payment / booking window. */
   operationAccepted(b: Booking): void {
-    const msg =
-      `Your operation request for booking ${b.reference} has been accepted. ` +
-      `An invoice has been prepared — watch for the payment window to secure your slot.`;
+    // No invoice and no pay window for a shipping line — the charge sits on
+    // its credit account and the booking boards its dedicated train directly.
+    const msg = b.shippingLineCompanyId
+      ? `Your booking ${b.reference} has been accepted. The charge has been ` +
+        `recorded on your credit account and your shipment is being placed on its train.`
+      : `Your operation request for booking ${b.reference} has been accepted. ` +
+        `An invoice has been prepared — watch for the payment window to secure your slot.`;
     void this.notifyContact(b, msg, 'OPERATION ACCEPTED');
-    this.inApp(b, 'Operation request accepted', msg);
+    this.inApp(
+      b,
+      b.shippingLineCompanyId ? 'Booking accepted' : 'Operation request accepted',
+      msg,
+    );
   }
 
   /**
@@ -274,6 +354,7 @@ export class BookingLifecycleNotifierService {
       `the customs declaration can be filed.${note ? ` Note: "${note}"` : ''}`;
     this.logger.log(`TRANSIT ASSIGNEE REQUESTED — ${this.ref(b)}`);
     this.inAppStaff(b, `Transit assignee needed — ${b.reference}`, msg, {
+      recipients: CLEARANCE_DESK,
       type: NotificationType.CLEARANCE_REVIEW,
       link: `/dashboard/gl-djibouti/clearance/${b.id}`,
     });
@@ -288,6 +369,7 @@ export class BookingLifecycleNotifierService {
         `The customs declaration can now be filed.`;
     this.logger.log(`TRANSIT ASSIGNEE ASSIGNED — ${this.ref(b)}`);
     this.inAppStaff(b, `Transit assignee set — ${b.reference}`, msg, {
+      recipients: CLEARANCE_DESK,
       type: NotificationType.CLEARANCE_REVIEW,
       link: `/dashboard/bookings/${b.id}/clearance`,
     });
@@ -388,6 +470,36 @@ export class BookingLifecycleNotifierService {
     );
   }
 
+  /**
+   * A shared-wagon pairing is waiting for a human decision. Two customers' cargo
+   * on one wagon is a commercial call, so this never auto-advances.
+   */
+  consolidationApprovalRequestedToStaff(b: Booking, partnerReference: string): void {
+    this.inAppStaff(
+      b,
+      'Shared wagon needs approval',
+      `Booking ${this.ref(b)} shares a wagon with ${partnerReference} — approve the consolidation before it reaches Operations.`,
+    );
+  }
+
+  /** The pairing was approved; both halves move on to Operations together. */
+  consolidationApprovedToStaff(b: Booking, partnerReference: string): void {
+    this.inAppStaff(
+      b,
+      'Shared wagon approved',
+      `The shared wagon for ${this.ref(b)} and ${partnerReference} was approved — both bookings are now with Operations.`,
+    );
+  }
+
+  /** The pairing was rejected; both halves go back to GL for changes. */
+  consolidationRejectedToStaff(b: Booking, partnerReference: string, reason: string): void {
+    this.inAppStaff(
+      b,
+      'Shared wagon rejected',
+      `The shared wagon for ${this.ref(b)} and ${partnerReference} was rejected: ${reason}`,
+    );
+  }
+
   /** Customer uploaded clearance documents — review is next. */
   clearanceDocsUploadedToStaff(b: Booking): void {
     this.inAppStaff(
@@ -395,6 +507,7 @@ export class BookingLifecycleNotifierService {
       'Clearance documents uploaded',
       `Customer uploaded clearance documents for booking ${this.ref(b)} — review them in the clearance queue.`,
       {
+        recipients: CLEARANCE_DESK,
         type: NotificationType.CLEARANCE_REVIEW,
         link: `/dashboard/bookings/${b.id}/clearance`,
       },
@@ -422,6 +535,7 @@ export class BookingLifecycleNotifierService {
       `The customer requested a change to the draft declaration on booking ${this.ref(b)}: ` +
       `"${note}". Send a corrected draft from the clearance page.`;
     this.inAppStaff(b, `Draft declaration change requested — ${this.ref(b)}`, msg, {
+      recipients: CLEARANCE_DESK,
       type: NotificationType.CLEARANCE_REVIEW,
       link: `/dashboard/bookings/${b.id}/clearance`,
     });
@@ -440,6 +554,7 @@ export class BookingLifecycleNotifierService {
       'Payment slip uploaded',
       `Customer uploaded the ${label} payment slip for booking ${this.ref(b)}.`,
       {
+        recipients: CLEARANCE_DESK,
         type: NotificationType.PAYMENT_RECEIVED,
         link: `/dashboard/bookings/${b.id}/clearance`,
       },
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-pricing.service.ts b/apps/edr-freight-api/src/modules/bookings/booking-pricing.service.ts
index ba6fece8c..f7dc40a82 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-pricing.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-pricing.service.ts
@@ -165,7 +165,7 @@ export class BookingPricingService {
       total += line.amount;
     }
 
-    const liveRates = await this.ratesService.findLiveRates();
+    const liveRates = await this.liveRatesForBooking(booking);
     const rateById = new Map(liveRates.map((r) => [r.id, r]));
     const usedRatesMap = new Map([...baseRates, ...mileRates].map((r) => [r.id, r]));
 
@@ -279,9 +279,10 @@ export class BookingPricingService {
 
     return {
       lineItems,
-      // Grand total is billed in whole currency units — fractional line sums
-      // (rate × tons can yield e.g. 260519.2) round to the nearest whole birr/USD.
-      totalAmount: Math.round(total),
+      // Grand total keeps its cents, matching the line items it sums — rounding
+      // to whole birr made the total disagree with the breakdown (135,375.61 of
+      // lines shown as a 135,376.00 total) and CBE bills this figure to the cent.
+      totalAmount: round2(total),
       currency: booking.paymentCurrency,
       usedRates: [...usedRatesMap.values()],
       appliedModifiers: ruleResult.appliedModifiers,
@@ -413,6 +414,9 @@ export class BookingPricingService {
       isGovernment: booking.isGovernment,
       allowConsolidation,
       shippingLineId: booking.shippingLineId,
+      // A shipping line's own booking prices off that line's negotiated rates
+      // instead of the standard customer ones (see RuleEngineService.ratesForOwner).
+      shippingLineCompanyId: booking.shippingLineCompanyId,
       originYardId: booking.originYardId,
       destinationYardId: booking.destinationYardId,
       totalWagons,
@@ -427,6 +431,22 @@ export class BookingPricingService {
     };
   }
 
+  /**
+   * LIVE rates this booking may price off.
+   *
+   * A shipping-line booking sees only its own line's rates; a customer booking
+   * only the standard ones. Line rates override rather than stack, and the
+   * standard rate is not a fallback — a lane the line has no rate for falls
+   * through to the existing "no rate configured" hard block, which is the
+   * intended outcome rather than silently billing the customer price.
+   */
+  private async liveRatesForBooking(booking: Booking): Promise<Rate[]> {
+    const rates = await this.ratesService.findLiveRates();
+    return booking.shippingLineCompanyId
+      ? rates.filter((r) => r.shippingLineCompanyId === booking.shippingLineCompanyId)
+      : rates.filter((r) => !r.shippingLineCompanyId);
+  }
+
   private async requireBooking(id: string): Promise<Booking> {
     const booking = await this.bookingsRepository.findByIdWithFiles(id);
     if (!booking) throw new NotFoundException(`Booking ${id} not found`);
@@ -511,7 +531,7 @@ export class BookingPricingService {
     warnings: string[];
     blocked: string[];
   }> {
-    const liveRates = await this.ratesService.findLiveRates();
+    const liveRates = await this.liveRatesForBooking(booking);
     const paymentCurrency = booking.paymentCurrency;
     const isEtbBooking = paymentCurrency === 'ETB';
     const usdToEtb = isEtbBooking ? await this.exchangeService.getRate('USD', 'ETB') : 1;
@@ -712,7 +732,7 @@ export class BookingPricingService {
       return { lineItems: [], usedRates: [] };
     }
 
-    const liveRates = await this.ratesService.findLiveRates();
+    const liveRates = await this.liveRatesForBooking(booking);
     const paymentCurrency = booking.paymentCurrency;
     const isEtbBooking = paymentCurrency === 'ETB';
     const usdToEtb = isEtbBooking ? await this.exchangeService.getRate('USD', 'ETB') : 1;
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-transition.accept.spec.ts b/apps/edr-freight-api/src/modules/bookings/booking-transition.accept.spec.ts
index 871d03c72..fd8e7192c 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-transition.accept.spec.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-transition.accept.spec.ts
@@ -59,6 +59,7 @@ describe('BookingTransitionService — acceptIntake validity window', () => {
         clearanceDocsUploadedToStaff: jest.fn(),
         dutySlipUploadedToStaff: jest.fn(),
       } as never, // notifier
+      { record: jest.fn() } as never, // clearanceEvents
       { emit: jest.fn() } as never, // events
     );
     return { service, bookingsRepository, ruleEngineService, contractService };
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-transition.clearance.spec.ts b/apps/edr-freight-api/src/modules/bookings/booking-transition.clearance.spec.ts
index b67366431..fbfb0daa4 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-transition.clearance.spec.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-transition.clearance.spec.ts
@@ -68,6 +68,7 @@ describe('BookingTransitionService — finalizeClearance gate', () => {
         clearanceDocsUploadedToStaff: jest.fn(),
         dutySlipUploadedToStaff: jest.fn(),
       } as never, // notifier
+      { record: jest.fn() } as never, // clearanceEvents
       { emit: jest.fn() } as never, // events
     );
     return { service, bookingsRepository };
@@ -172,6 +173,7 @@ describe('BookingTransitionService — finalizeClearance customs output gate', (
         clearanceDocsUploadedToStaff: jest.fn(),
         dutySlipUploadedToStaff: jest.fn(),
       } as never, // notifier
+      { record: jest.fn() } as never, // clearanceEvents
       { emit: jest.fn() } as never, // events
     );
     return { service, bookingsRepository };
@@ -262,6 +264,7 @@ describe('BookingTransitionService — submitClearanceDocuments required-fields
         clearanceDocsUploadedToStaff: jest.fn(),
         dutySlipUploadedToStaff: jest.fn(),
       } as never, // notifier
+      { record: jest.fn() } as never, // clearanceEvents
       { emit: jest.fn() } as never, // events
     );
     return { service, bookingsRepository, filesService };
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-transition.operation.spec.ts b/apps/edr-freight-api/src/modules/bookings/booking-transition.operation.spec.ts
index 0726445d5..b55c8d4b0 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-transition.operation.spec.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-transition.operation.spec.ts
@@ -71,6 +71,7 @@ describe('BookingTransitionService — operation review', () => {
         clearanceDocsUploadedToStaff: jest.fn(),
         dutySlipUploadedToStaff: jest.fn(),
       } as never, // notifier
+      { record: jest.fn() } as never, // clearanceEvents
       { emit: jest.fn() } as never, // events
     );
     return { service, bookingsRepository, bookingBatchService, invoiceService };
@@ -172,6 +173,7 @@ describe('BookingTransitionService — requestOperation export space gate', () =
       {} as never, // invoiceService
       { validate20ftPairing: jest.fn().mockResolvedValue([]) } as never,
       notifier as never,
+      { record: jest.fn() } as never, // clearanceEvents
       { emit: jest.fn() } as never, // events
     );
     return { service, bookingsRepository, bookingBatchService };
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-transition.paired-decision.spec.ts b/apps/edr-freight-api/src/modules/bookings/booking-transition.paired-decision.spec.ts
new file mode 100644
index 000000000..6496208e7
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/booking-transition.paired-decision.spec.ts
@@ -0,0 +1,133 @@
+import { BookingTransitionService } from './booking-transition.service';
+import { Booking } from './entities/booking.entity';
+
+/**
+ * Staff decisions on a consolidated pair. Two bookings sharing a wagon must move
+ * together: accepting one alone would put half a wagon into the approval chain,
+ * and cancelling one alone would strand the other on a wagon it can no longer
+ * fill. All-or-nothing — if either half throws, neither booking moved.
+ */
+describe('BookingTransitionService — paired staff decisions', () => {
+  function makeService(booking: Partial<Booking>) {
+    const bookingsService = {
+      findById: jest.fn().mockResolvedValue(booking as Booking),
+    };
+    // Runs the callback so a throw propagates, which is what the all-or-nothing
+    // guarantee reduces to from this service's point of view.
+    const dataSource = {
+      transaction: jest.fn(async (cb: () => Promise<unknown>) => cb()),
+    };
+
+    const service = new BookingTransitionService(
+      {} as never, // bookingsRepository
+      {} as never, // ruleEngineService
+      {} as never, // pricingService
+      {} as never, // contractService
+      {} as never, // filesService
+      {} as never, // fileUploadSettingsService
+      {} as never, // bookingBatchService
+      bookingsService as never,
+      {} as never, // bookingClearanceService
+      {} as never, // workflowService
+      {} as never, // invoiceService
+      {} as never, // containerValidationService
+      {} as never, // notifier
+      { record: jest.fn() } as never, // clearanceEvents
+      {} as never, // events
+      undefined, // milestoneService
+      dataSource as never,
+    );
+    return { service, dataSource };
+  }
+
+  const paired = {
+    id: 'b-1',
+    reference: 'BK-1',
+    consolidationPartnerId: 'b-2',
+  } as Booking;
+
+  it('accepts both halves with the same validity window', async () => {
+    const { service } = makeService(paired);
+    const accept = jest
+      .spyOn(service, 'acceptIntake')
+      .mockImplementation(async (id) => ({ id }) as Booking);
+
+    const result = await service.applyPairedDecision('b-1', 'accept', 'staff-1', {
+      validityDays: 30,
+    });
+
+    expect(accept).toHaveBeenCalledTimes(2);
+    expect(accept).toHaveBeenNthCalledWith(1, 'b-1', 'staff-1', 30);
+    expect(accept).toHaveBeenNthCalledWith(2, 'b-2', 'staff-1', 30);
+    expect(result.booking.id).toBe('b-1');
+    expect(result.partner.id).toBe('b-2');
+  });
+
+  it('cancels both halves with the same reason', async () => {
+    const { service } = makeService(paired);
+    const cancel = jest
+      .spyOn(service, 'cancel')
+      .mockImplementation(async (id) => ({ id }) as Booking);
+
+    await service.applyPairedDecision('b-1', 'cancel', 'staff-1', {
+      reason: 'customer withdrew',
+    });
+
+    expect(cancel).toHaveBeenNthCalledWith(1, 'b-1', 'customer withdrew');
+    expect(cancel).toHaveBeenNthCalledWith(2, 'b-2', 'customer withdrew');
+  });
+
+  it('propagates a failure on the second half so neither is committed', async () => {
+    const { service, dataSource } = makeService(paired);
+    jest
+      .spyOn(service, 'cancel')
+      .mockImplementationOnce(async (id) => ({ id }) as Booking)
+      .mockImplementationOnce(async () => {
+        throw new Error('partner is already in transit');
+      });
+
+    await expect(
+      service.applyPairedDecision('b-1', 'cancel', 'staff-1', { reason: 'x' }),
+    ).rejects.toThrow('partner is already in transit');
+
+    // Both halves ran inside one transaction, so the throw rolls the first back.
+    expect(dataSource.transaction).toHaveBeenCalledTimes(1);
+  });
+
+  it('refuses a booking that has no partner', async () => {
+    const { service } = makeService({
+      id: 'b-1',
+      consolidationPartnerId: null,
+    } as Booking);
+
+    await expect(
+      service.applyPairedDecision('b-1', 'cancel', 'staff-1', { reason: 'x' }),
+    ).rejects.toThrow(/no consolidation partner/i);
+  });
+
+  it('requires a validity window to accept', async () => {
+    const { service } = makeService(paired);
+    const accept = jest.spyOn(service, 'acceptIntake');
+
+    await expect(
+      service.applyPairedDecision('b-1', 'accept', 'staff-1', {}),
+    ).rejects.toThrow(/validity/i);
+    expect(accept).not.toHaveBeenCalled();
+  });
+
+  it('routes operationAccept through the operation review on both halves', async () => {
+    const { service } = makeService(paired);
+    const review = jest
+      .spyOn(service, 'reviewOperationRequest')
+      .mockImplementation(async (id) => ({ id }) as Booking);
+
+    await service.applyPairedDecision('b-1', 'operationAccept', 'staff-1', {});
+
+    expect(review).toHaveBeenNthCalledWith(1, 'b-1', 'ACCEPT', 'staff-1', {
+      note: undefined,
+    });
+    expect(review).toHaveBeenNthCalledWith(2, 'b-2', 'ACCEPT', 'staff-1', {
+      note: undefined,
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-transition.service.ts b/apps/edr-freight-api/src/modules/bookings/booking-transition.service.ts
index 7cc92be87..805b2216f 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-transition.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-transition.service.ts
@@ -27,7 +27,15 @@ import { BookingPricingService } from './booking-pricing.service';
 import { ContainerValidationService } from './container-validation.service';
 import { BookingsRepository } from './bookings.repository';
 import { assertBookingStatus } from './booking-status.util';
-import { clearanceCodesForBooking } from './clearance.util';
+import {
+  clearanceCodesForBooking,
+  clearanceDocumentsOpen,
+} from './clearance.util';
+import {
+  buildClearanceDocHistory,
+  type ClearanceDocEvent,
+} from './clearance-doc-history.util';
+import { ClearanceEventService } from './clearance-event.service';
 import { computeNextStep, type BookingNextStep } from './booking-next-step.util';
 import { SubmitBookingResponseDto } from './dto/submit-booking-response.dto';
 import { PriceLineItemDto } from './dto/generate-price-response.dto';
@@ -39,6 +47,8 @@ import { ClearanceWorkflowService } from '../contracts/clearance-workflow.servic
 import { ContractDocPhase } from '@edr/types';
 
 import { BookingInvoiceService } from "./booking-invoice.service";
+// Type-only: the DI edge stays event-based to keep the module graph acyclic.
+import type { ShippingLineBookingAcceptedPayload } from "../shipping-lines/shipping-line-credits.service";
 
 @Injectable()
 export class BookingTransitionService {
@@ -66,6 +76,7 @@ export class BookingTransitionService {
     private readonly invoiceService: BookingInvoiceService,
     private readonly containerValidationService: ContainerValidationService,
     private readonly notifier: BookingLifecycleNotifierService,
+    private readonly clearanceEvents: ClearanceEventService,
     private readonly events: EventEmitter2,
     @Optional() private readonly milestoneService?: ClearanceMilestoneService,
     // Optional + last so the hand-constructed service in *.spec.ts files keeps
@@ -79,6 +90,28 @@ export class BookingTransitionService {
 
   /** Reject submit when the booking's 20ft containers can't be balanced onto wagons. */
   private async assert20ftPairable(booking: Booking): Promise<void> {
+    // Parity gate. 20ft ride two per wagon, so an odd total leaves one container
+    // that cannot be placed. Consolidation (pairing it with another customer's
+    // odd booking) is built end to end but switched off for now, so an odd total
+    // is rejected here rather than parked for a partner.
+    // containerSize is not always populated (some rows carry only the container
+    // type), so fall back to the type's sizeFt rather than silently skipping
+    // those lines and letting an odd booking through.
+    const ft20Quantity = (booking.bookingContainers ?? [])
+      .filter((bc) =>
+        bc.containerSize
+          ? bc.containerSize.includes("20")
+          : Number(bc.containerType?.sizeFt) === 20,
+      )
+      .reduce((sum, bc) => sum + Number(bc.quantity || 0), 0);
+    if (ft20Quantity % 2 === 1) {
+      throw new BadRequestException(
+        `20ft containers travel two per wagon, so they must be booked in even ` +
+          `numbers. This booking has ${ft20Quantity} — add one more or remove ` +
+          `one (book ${ft20Quantity + 1} or ${ft20Quantity - 1}).`,
+      );
+    }
+
     const violations =
       await this.containerValidationService.validate20ftPairing(booking);
     if (violations.length) {
@@ -453,6 +486,75 @@ export class BookingTransitionService {
     return this.cancel(bookingId, reason ?? "Customer cancelled before payment");
   }
 
+  /**
+   * Run a staff decision across BOTH halves of a consolidated pair.
+   *
+   * Two bookings that share a wagon must move together: accepting one while the
+   * other stays behind would put half a wagon into the approval chain, and
+   * cancelling one alone would strand the other on a wagon it can no longer
+   * fill. All-or-nothing — if either half throws, the transaction rolls back and
+   * neither booking moved.
+   *
+   * Each half still runs the ordinary single-booking transition, so pricing,
+   * invoicing and notifications stay per booking: the customers are billed and
+   * notified separately, exactly as they are today.
+   */
+  async applyPairedDecision(
+    bookingId: string,
+    decision: "accept" | "cancel" | "operationAccept" | "requestChanges",
+    actorId: string,
+    options: { reason?: string; note?: string; validityDays?: number } = {},
+  ): Promise<{ booking: Booking; partner: Booking }> {
+    const booking = await this.bookingsService.findById(bookingId);
+    const partnerId = booking.consolidationPartnerId;
+    if (!partnerId) {
+      throw new BadRequestException(
+        "This booking has no consolidation partner — use the single-booking action.",
+      );
+    }
+
+    const runOne = async (id: string): Promise<Booking> => {
+      switch (decision) {
+        case "accept":
+          // Same requirement as the single-booking accept: the approval chain
+          // needs a contract validity window.
+          if (!(Number(options.validityDays) > 0)) {
+            throw new BadRequestException(
+              "Contract validity (days) is required to accept.",
+            );
+          }
+          return this.acceptIntake(id, actorId, Number(options.validityDays));
+        case "cancel":
+          return this.cancel(
+            id,
+            options.reason ?? "Cancelled with its consolidation partner",
+          );
+        case "operationAccept":
+          return this.reviewOperationRequest(id, "ACCEPT", actorId, {
+            note: options.note,
+          });
+        case "requestChanges":
+          return this.requestChanges(id, options.note ?? "", actorId);
+      }
+    };
+
+    // Without a DataSource (unit tests hand-construct this service) fall back to
+    // running the two halves directly — the ordering guarantee still holds, only
+    // the rollback does not.
+    if (!this.dataSource) {
+      const own = await runOne(bookingId);
+      const other = await runOne(partnerId);
+      return { booking: own, partner: other };
+    }
+
+    return this.dataSource.transaction(async () => {
+      // Sequential: one connection per transaction context.
+      const own = await runOne(bookingId);
+      const other = await runOne(partnerId);
+      return { booking: own, partner: other };
+    });
+  }
+
   async cancel(bookingId: string, reason: string): Promise<Booking> {
     const booking = await this.bookingsService.findById(bookingId);
     assertBookingStatus(booking, [
@@ -534,8 +636,13 @@ export class BookingTransitionService {
       file: { id: string; name: string; url: string } | null;
       reviewStatus: "PENDING" | "APPROVED" | "QUERIED" | null;
       note: string | null;
+      uploadedAt: string | null;
+      reviewedAt: string | null;
+      reviewedByName: string | null;
+      history: ClearanceDocEvent[];
     }>;
     allApproved: boolean;
+    documentsOpen: boolean;
     phase?: string | null;
     milestones?: unknown[];
     nextAction?: unknown;
@@ -559,6 +666,18 @@ export class BookingTransitionService {
     const reviewByKey = new Map(
       reviews.map((r) => [`${r.settingCode}:${r.fileKey}`, r]),
     );
+    const allVersions = await this.filesService.findAllVersionsByResource(
+      bookingId,
+      "bookings",
+    );
+    const queryNotes = await this.bookingsRepository.findReviewNotes(
+      bookingId,
+      "CHANGES_REQUESTED",
+    );
+    const reviewerNames = await this.bookingsRepository.resolveStaffNames([
+      ...reviews.map((r) => r.reviewedByStaffId),
+      ...queryNotes.map((n) => n.authorId),
+    ]);
 
     const documents: Awaited<
       ReturnType<BookingTransitionService["getClearanceView"]>
@@ -587,6 +706,18 @@ export class BookingTransitionService {
           file: file ? { id: file.id, name: file.name, url: file.url } : null,
           reviewStatus: review?.status ?? null,
           note: review?.note ?? null,
+          uploadedAt: file?.createdAt ? file.createdAt.toISOString() : null,
+          reviewedAt: review?.reviewedAt ? review.reviewedAt.toISOString() : null,
+          reviewedByName: review?.reviewedByStaffId
+            ? (reviewerNames.get(review.reviewedByStaffId) ?? null)
+            : null,
+          history: buildClearanceDocHistory({
+            fileKey: field.fileKey,
+            allVersions,
+            queryNotes,
+            review,
+            names: reviewerNames,
+          }),
         });
       }
     };
@@ -607,6 +738,18 @@ export class BookingTransitionService {
         file: { id: f.id, name: f.name, url: f.url },
         reviewStatus: review?.status ?? null,
         note: review?.note ?? null,
+        uploadedAt: f.createdAt ? f.createdAt.toISOString() : null,
+        reviewedAt: review?.reviewedAt ? review.reviewedAt.toISOString() : null,
+        reviewedByName: review?.reviewedByStaffId
+          ? (reviewerNames.get(review.reviewedByStaffId) ?? null)
+          : null,
+        history: buildClearanceDocHistory({
+          fileKey: f.code,
+          allVersions,
+          queryNotes,
+          review,
+          names: reviewerNames,
+        }),
       });
     }
 
@@ -619,6 +762,7 @@ export class BookingTransitionService {
       outputCode,
       documents,
       allApproved,
+      documentsOpen: clearanceDocumentsOpen(booking),
     };
   }
 
@@ -658,12 +802,17 @@ export class BookingTransitionService {
   async submitClearanceDocuments(
     bookingId: string,
     files: Express.Multer.File[],
+    userId?: string,
   ): Promise<Booking> {
     const booking = await this.bookingsService.findById(bookingId);
-    assertBookingStatus(booking, [
-      "AWAITING_DOCUMENTS",
-      "DOCUMENTS_UNDER_REVIEW",
-    ]);
+    // Documents stay open until the shipment is paid — a customs shipment keeps
+    // collecting paperwork (amended invoices, port documents) well past
+    // clearance finalization. See {@link clearanceDocumentsOpen}.
+    if (!clearanceDocumentsOpen(booking)) {
+      throw new ConflictException(
+        `Clearance documents are closed for this booking (status "${booking.status}").`,
+      );
+    }
     const { inputCode } = clearanceCodesForBooking(booking);
     if (!inputCode) {
       throw new BadRequestException(
@@ -701,21 +850,41 @@ export class BookingTransitionService {
       });
     }
 
-    await this.bookingsRepository.update(bookingId, {
-      status: "DOCUMENTS_UNDER_REVIEW",
-    } as never);
+    // Only the pre-finalization submission drives the booking into review.
+    // A later addition (an amended invoice while the shipment is already
+    // scheduled) must never rewind the status or reopen the phased workflow —
+    // it lands as a new PENDING document for GL to approve where it stands.
+    const inDocumentPhase =
+      booking.status === "AWAITING_DOCUMENTS" ||
+      booking.status === "DOCUMENTS_UNDER_REVIEW";
 
-    if (this.isPhasedCustoms(booking)) {
-      await this.workflowService.onCustomerDocsUploadedForBooking(
-        bookingId,
-        booking.tradeDirection ?? 'IMPORT',
-      );
-      await this.workflowService.onDocumentReviewReopenedForBooking(bookingId);
+    if (inDocumentPhase) {
       await this.bookingsRepository.update(bookingId, {
-        clearanceCurrentPhase: ContractDocPhase.GlEtReview,
+        status: "DOCUMENTS_UNDER_REVIEW",
       } as never);
+
+      if (this.isPhasedCustoms(booking)) {
+        await this.workflowService.onCustomerDocsUploadedForBooking(
+          bookingId,
+          booking.tradeDirection ?? 'IMPORT',
+        );
+        await this.workflowService.onDocumentReviewReopenedForBooking(bookingId);
+        await this.bookingsRepository.update(bookingId, {
+          clearanceCurrentPhase: ContractDocPhase.GlEtReview,
+        } as never);
+      }
     }
 
+    const fileKeys = files.map((f) => f.fieldname);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DOCS_SUBMITTED',
+      label: `Customer submitted ${files.length} clearance document(s): ${fileKeys.join(', ')}`,
+      actorType: 'CUSTOMER',
+      actorId: userId ?? null,
+      metadata: { fileKeys },
+    });
+
     const fresh = await this.bookingsService.findById(bookingId);
     this.notifier.clearanceDocsUploadedToStaff(fresh);
     return fresh;
@@ -768,7 +937,14 @@ export class BookingTransitionService {
     note?: string,
   ): Promise<Booking> {
     const booking = await this.bookingsService.findById(bookingId);
-    assertBookingStatus(booking, ["DOCUMENTS_UNDER_REVIEW"]);
+    // GL keeps reviewing for as long as the customer can still submit — the
+    // two sides share one predicate so they can never drift apart. Documents
+    // added after clearance was finalized still need approving/querying.
+    if (!clearanceDocumentsOpen(booking)) {
+      throw new ConflictException(
+        `Clearance documents are closed for this booking (status "${booking.status}").`,
+      );
+    }
     const { inputCode, outputCode } = clearanceCodesForBooking(booking);
 
     const existing =
@@ -785,15 +961,6 @@ export class BookingTransitionService {
         "A note is required when querying a document",
       );
     }
-    if (
-      status === 'QUERIED' &&
-      this.isPhasedCustoms(booking) &&
-      booking.preClearanceFinalizedAt
-    ) {
-      throw new BadRequestException(
-        'Customer documents cannot be queried after pre-clearance is finalized.',
-      );
-    }
 
     await this.bookingsRepository.setDocumentReviewStatus(
       bookingId,
@@ -803,6 +970,16 @@ export class BookingTransitionService {
       staffId,
       note,
     );
+    await this.clearanceEvents.record({
+      bookingId,
+      action: status === 'APPROVED' ? 'DOC_APPROVED' : 'DOC_QUERIED',
+      label:
+        status === 'APPROVED'
+          ? `Approved document "${fileKey.replace(/_/g, ' ')}"`
+          : `Opened query on document "${fileKey.replace(/_/g, ' ')}"`,
+      actorId: staffId,
+      metadata: { fileKey, note: note ?? null },
+    });
     if (status === "QUERIED") {
       await this.bookingsRepository.createReviewNote(
         bookingId,
@@ -810,7 +987,10 @@ export class BookingTransitionService {
         "CHANGES_REQUESTED",
         staffId,
       );
-      if (this.isPhasedCustoms(booking)) {
+      // Reopening the review phase only makes sense while clearance is still
+      // being decided. Querying a document that arrived afterwards must not
+      // drag a finalized shipment back into the GL review phase.
+      if (this.isPhasedCustoms(booking) && !booking.preClearanceFinalizedAt) {
         await this.workflowService.onDocumentReviewReopenedForBooking(bookingId);
         await this.bookingsRepository.update(bookingId, {
           clearanceCurrentPhase: ContractDocPhase.GlEtReview,
@@ -822,7 +1002,10 @@ export class BookingTransitionService {
     if (status === "QUERIED") {
       this.notifier.documentQueried(updated, fileKey, note ?? '');
     }
-    if (this.isPhasedCustoms(updated)) {
+    // Same reasoning as the query branch: advance the workflow only while
+    // clearance is still open. Approving a late-added document leaves an
+    // already-finalized shipment's phase exactly where it is.
+    if (this.isPhasedCustoms(updated) && !updated.preClearanceFinalizedAt) {
       const allApproved = await this.isClearanceFullyApproved(updated);
       if (allApproved) {
         await this.workflowService.onAllDocsApprovedForBooking(bookingId);
@@ -843,6 +1026,7 @@ export class BookingTransitionService {
   async uploadClearanceOutputDocuments(
     bookingId: string,
     files: Express.Multer.File[],
+    userId?: string,
   ): Promise<Booking> {
     const booking = await this.bookingsService.findById(bookingId);
     assertBookingStatus(booking, ["DOCUMENTS_UNDER_REVIEW"]);
@@ -863,6 +1047,15 @@ export class BookingTransitionService {
         file,
       });
     }
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'OUTPUT_DOCS_UPLOADED',
+      label: `Uploaded customs output document(s): ${files
+        .map((f) => f.fieldname.replace(/_/g, ' '))
+        .join(', ')}`,
+      actorId: userId ?? null,
+      metadata: { fileKeys: files.map((f) => f.fieldname) },
+    });
     return this.bookingsService.findById(bookingId);
   }
 
@@ -870,7 +1063,7 @@ export class BookingTransitionService {
    * GL confirms clearance: requires every customer document APPROVED (100% gate)
    * and, for customs, the required output documents present → CLEARANCE_READY.
    */
-  async finalizeClearance(bookingId: string): Promise<Booking> {
+  async finalizeClearance(bookingId: string, userId?: string): Promise<Booking> {
     const booking = await this.bookingsService.findById(bookingId);
     if (this.isPhasedCustoms(booking)) {
       throw new BadRequestException(
@@ -926,6 +1119,12 @@ export class BookingTransitionService {
     await this.bookingsRepository.update(bookingId, {
       status: "CLEARANCE_READY",
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'CLEARANCE_FINALIZED',
+      label: 'Finalized document approval — clearance ready',
+      actorId: userId ?? null,
+    });
     const fresh = await this.bookingsService.findById(bookingId);
     this.notifier.clearanceReady(fresh);
     return fresh;
@@ -944,6 +1143,17 @@ export class BookingTransitionService {
     bookingId: string,
     scheduledDate: string,
     requestedTrainScheduleId?: string | null,
+    opts?: {
+      /**
+       * Skip the customer day-pool departure/compatibility gate. Used ONLY by
+       * the shipping-line completion path, which has already validated the day
+       * against the line's own dedicated train (those trains are excluded from
+       * the customer pools, so the gate here would wrongly reject them).
+       */
+      bypassDayPool?: boolean;
+      /** Acting user, recorded in the clearance history. */
+      userId?: string;
+    },
   ): Promise<Booking> {
     const booking = await this.bookingsService.findById(bookingId);
     assertBookingStatus(booking, [
@@ -971,20 +1181,22 @@ export class BookingTransitionService {
     // gate; quantity never blocks — oversized bookings get a partial split
     // offer). The batch engine assigns the specific train within that
     // (route, day) pool later.
-    const { hasDeparture, hasCompatible } =
-      await this.bookingsService.checkDayCompatibilityForBooking(
-        booking,
-        eatDay(date),
-      );
-    if (!hasDeparture) {
-      throw new BadRequestException(
-        "No departures available on the selected day for this route",
-      );
-    }
-    if (!hasCompatible) {
-      throw new BadRequestException(
-        "No wagon on the selected day can carry this cargo type — please choose another day",
-      );
+    if (!opts?.bypassDayPool) {
+      const { hasDeparture, hasCompatible } =
+        await this.bookingsService.checkDayCompatibilityForBooking(
+          booking,
+          eatDay(date),
+        );
+      if (!hasDeparture) {
+        throw new BadRequestException(
+          "No departures available on the selected day for this route",
+        );
+      }
+      if (!hasCompatible) {
+        throw new BadRequestException(
+          "No wagon on the selected day can carry this cargo type — please choose another day",
+        );
+      }
     }
 
     // Export is FCFS and never splits — a booking must ride one train whole. So
@@ -1001,7 +1213,14 @@ export class BookingTransitionService {
     // The customer's train pick only exists for export rail; it rides the
     // booking through the space checks below AND is persisted so the accept /
     // reserve path locks onto that train (pickExportSchedule honors it).
-    const requestedId = isExportTrain ? (requestedTrainScheduleId ?? null) : null;
+    // Shipping-line completions (bypassDayPool) pick among the line's own
+    // dedicated trains — already validated by the caller, so the pick is
+    // persisted here the same way an export pick is. Customer import/domestic
+    // bookings still never carry one (the batch engine assigns their train).
+    const requestedId =
+      isExportTrain || opts?.bypassDayPool
+        ? (requestedTrainScheduleId ?? null)
+        : null;
     // Export rail rides the exact train the customer picked — never an
     // auto-assigned one. Both portal flows (clearance + contract completion)
     // surface a picker, so a missing id is an invalid submission, not a
@@ -1048,6 +1267,14 @@ export class BookingTransitionService {
       scheduledDate: date,
       requestedTrainScheduleId: requestedId,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'OPERATION_REQUESTED',
+      label: `Requested operation for shipment day ${scheduledDate}`,
+      actorType: 'CUSTOMER',
+      actorId: opts?.userId ?? null,
+      metadata: { scheduledDate },
+    });
     const fresh = await this.bookingsService.findById(bookingId);
     this.notifier.operationRequestedToStaff(fresh);
     return fresh;
@@ -1205,10 +1432,22 @@ export class BookingTransitionService {
     // booking page correctly still showed it as not payable. The batch engine
     // issues it in `reserve` (SELECTED_FOR_BATCH), which is where the pay window
     // and the real deadline are created — matching the portal's `canPay` gate.
-    const invoice = await this.invoiceService.ensureInvoiceForBooking(booking);
-    this.logger.log(
-      `Generated draft invoice ${invoice.invoiceNumber} (${invoice.id}) for ${booking.reference}:${booking.id} — issued on batch selection`,
-    );
+    //
+    // Shipping-line bookings mint NO invoice at all: they have no company row
+    // to bill (the invoices FK requires one) and they pay on the credit ledger
+    // — the charge was recorded at completion, and Finance bills a batch of
+    // credits later through ShippingLineCreditsService.generateInvoice.
+    if (booking.shippingLineCompanyId) {
+      this.logger.log(
+        `Skipping invoice for shipping-line booking ${booking.reference}:${booking.id} — billed later from the credit ledger`,
+      );
+    } else {
+      const invoice =
+        await this.invoiceService.ensureInvoiceForBooking(booking);
+      this.logger.log(
+        `Generated draft invoice ${invoice.invoiceNumber} (${invoice.id}) for ${booking.reference}:${booking.id} — issued on batch selection`,
+      );
+    }
     // TODO: road (truck) orders are an incomplete feature — they stop at the
     // dead-end ROAD_DISPATCH_PENDING status below (no dispatch transition, no
     // per-km pricing wired via roadKmPrice, no pay surface in the portal). They
@@ -1222,6 +1461,7 @@ export class BookingTransitionService {
         lockedAt: booking.lockedAt ?? now,
       } as never);
       const roadFresh = await this.bookingsService.findById(booking.id);
+      this.emitShippingLineAccepted(roadFresh);
       this.notifier.operationAccepted(roadFresh);
       return roadFresh;
     }
@@ -1258,11 +1498,44 @@ export class BookingTransitionService {
     // batch runs after the window closes + staff document review, never at accept
     // time. (Legacy pre-migration schedules with no window phase are still served
     // by the periodic legacy fill.)
+    //
+    // EXCEPT shipping-line bookings: they pay later on the credit ledger, so
+    // no pay window exists to wait for — accept places them straight onto
+    // their company's dedicated train and its wagons. Non-fatal on purpose:
+    // the accept has committed; an allocation hiccup leaves the booking in
+    // the day pool for the batch engine / staff instead of failing the accept.
+    if (booking.shippingLineCompanyId) {
+      try {
+        await this.bookingBatchService.allocateShippingLineAccepted(booking.id);
+      } catch (err) {
+        this.logger.warn(
+          `Auto-allocation failed for shipping-line booking ${booking.reference}:${booking.id} — left in the day pool: ${(err as Error).message}`,
+        );
+      }
+    }
     const trainFresh = await this.bookingsService.findById(booking.id);
+    this.emitShippingLineAccepted(trainFresh);
     this.notifier.operationAccepted(trainFresh);
     return trainFresh;
   }
 
+  /**
+   * A shipping-line booking becomes debt at THIS moment — Operations accepted
+   * it — not at completion/pricing. Event, not a service call:
+   * ShippingLineCreditsService listens (`shipping_line_booking.accepted`), and
+   * importing its module here would close a module cycle. Emitted after the
+   * accept has fully committed (including the export-capacity path, which can
+   * still revert the status above), so a failed accept never creates debt.
+   */
+  private emitShippingLineAccepted(booking: Booking): void {
+    if (!booking.shippingLineCompanyId) return;
+    this.events.emit("shipping_line_booking.accepted", {
+      bookingId: booking.id,
+      reference: booking.reference,
+      amount: Number(booking.totalAmount),
+    } satisfies ShippingLineBookingAcceptedPayload);
+  }
+
   async enrichBookingResponse(booking: Booking): Promise<
     Booking & {
       latestChangeRequestNote?: string | null;
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.spec.ts b/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.spec.ts
new file mode 100644
index 000000000..8babc8c2e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.spec.ts
@@ -0,0 +1,42 @@
+import { BadRequestException } from '@nestjs/common';
+
+import { BookingWagonCancellationService } from './booking-wagon-cancellation.service';
+
+/**
+ * Sizing of a bulk quantity cut (no DB touched on this branch): a whole-booking
+ * cut is allowed and takes the exact cargo total; over-cut is rejected; a
+ * partial cut stays proportional.
+ */
+describe('BookingWagonCancellationService.resolveRequestedCut (bulk)', () => {
+  const svc = Object.create(BookingWagonCancellationService.prototype) as {
+    resolveRequestedCut(booking: unknown, dto: unknown): Promise<{
+      wagons: number;
+      weightTons: number;
+      quantities: { bulkTons?: number };
+    }>;
+  };
+  const booking = {
+    id: 'b1',
+    freightType: 'BULK',
+    wagonsRequired: 4,
+    cargoTotalWeightVgm: 250.5,
+    bulkTotalWeightTons: null,
+  };
+
+  it('cancels every wagon with the exact total tonnage', async () => {
+    const cut = await svc.resolveRequestedCut(booking, { wagons: 4 });
+    expect(cut).toEqual({ wagons: 4, weightTons: 250.5, quantities: { bulkTons: 250.5 } });
+  });
+
+  it('rejects more wagons than the booking has', async () => {
+    await expect(svc.resolveRequestedCut(booking, { wagons: 5 })).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+  });
+
+  it('sizes a partial cut proportionally', async () => {
+    const cut = await svc.resolveRequestedCut(booking, { wagons: 1 });
+    expect(cut.wagons).toBe(1);
+    expect(cut.weightTons).toBeCloseTo(62.625, 3);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.ts b/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.ts
index c576f5a43..0b4315d62 100644
--- a/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/booking-wagon-cancellation.service.ts
@@ -7,8 +7,9 @@ import {
   Logger,
   NotFoundException,
 } from '@nestjs/common';
+import { ExchangeService } from '@edr/api-common';
 import { Freight, NotificationAudience, NotificationType } from '@edr/types';
-import { DataSource, EntityManager, In } from 'typeorm';
+import { DataSource, EntityManager, In, IsNull } from 'typeorm';
 
 import { BillingService } from '../billing/billing.service';
 import { ContractBookingService } from '../contracts/contract-booking.service';
@@ -18,9 +19,11 @@ import { ClearanceMilestone } from '../contracts/entities/clearance-milestone.en
 import { FirstMileService } from '../first-mile/first-mile.service';
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
 import { wagonsPerUnitForSize } from '../rule-engine/container-type.util';
+import { ContainerType } from '../rule-engine/entities/container-type.entity';
 import { Rate } from '../rule-engine/entities/rate.entity';
 import { BookingBatchService } from '../train-scheduling/booking-batch.service';
-import { TrainSchedulingService } from '../train-scheduling/train-scheduling.service';
+import { TrainSchedulingService } from '../train-scheduling/services/train-scheduling.service';
+import { TrainScheduleBooking } from '../train-schedules/entities/train-schedule-booking.entity';
 import { WagonAllocationBulkLoad } from '../train-schedules/entities/wagon-allocation-bulk-load.entity';
 import { WagonAllocationContainerItem } from '../train-schedules/entities/wagon-allocation-container-item.entity';
 import { WagonBookingAllocation } from '../train-schedules/entities/wagon-booking-allocation.entity';
@@ -46,10 +49,15 @@ import {
 /**
  * rates.rate_type of the cancellation fee — an existing rate-engine type
  * (trigger CANCELLATION, never auto-applied to booking pricing). Staff
- * configure it in the normal rates UI; the wagon flow requires the PER_WAGON
- * unit so the fee scales with the cancelled wagon count.
+ * configure it in the normal rates UI, one PER_WAGON rate per trade direction
+ * + cargo kind + type (20ft / 40ft container type, or bulk commodity), so the
+ * fee scales with the cancelled wagon count and differs by what was booked.
  */
 export const WAGON_CANCELLATION_FEE_RATE_TYPE = 'CANCELLATION_FEE';
+
+/** `booking_container.container_size` is stored as "20ft"/"40ft" — `Number()` on it is NaN. */
+const sizeFtOf = (size: string | number | null | undefined): number =>
+  parseInt(String(size ?? ''), 10);
 /** invoices.type of the fee invoice — the settlement branch key in BookingInvoiceService. */
 export const WAGON_CANCEL_FEE_INVOICE_TYPE = 'WAGON_CANCEL_FEE';
 
@@ -62,8 +70,20 @@ interface RequestedCut {
   quantities: CancelledQuantities;
 }
 
+/** The priced fee for a cut: total, currency and the rate(s) it came from. */
+interface PricedFee {
+  amount: number;
+  currency: string;
+  /** Effective per-wagon fee (amount / wagons) — one number for the customer. */
+  perWagon: number;
+  /** Rate rows used; the first is recorded on the ledger row. */
+  rates: Rate[];
+}
+
 /**
- * Partial wagon cancellation on a PAID booking, with a rebooking credit.
+ * Wagon cancellation on a PAID booking (partial or whole), with a rebooking
+ * credit. Cutting every wagon ends the source booking CANCELLED at T2; the
+ * credit then rebooks as a fresh booking under the same contract.
  *
  * Lifecycle (one ledger row per cycle, see BookingWagonCancellation):
  *  T1 request  — validate + price the fee, open the fee invoice. Nothing else
@@ -91,6 +111,7 @@ export class BookingWagonCancellationService {
     private readonly repo: BookingWagonCancellationsRepository,
     private readonly bookingsRepository: BookingsRepository,
     private readonly billing: BillingService,
+    private readonly exchangeService: ExchangeService,
     @Inject(forwardRef(() => ContractBookingService))
     private readonly contractBooking: ContractBookingService,
     @Inject(forwardRef(() => ClearanceMilestoneService))
@@ -120,14 +141,13 @@ export class BookingWagonCancellationService {
   }> {
     const booking = await this.loadCancellableBooking(bookingId);
     const cut = await this.resolveRequestedCut(booking, dto);
-    const rate = await this.feeRate();
-    const feeAmount = round2(Number(rate.rateValue) * cut.wagons);
+    const fee = await this.priceFee(booking, cut);
     return {
       wagons: cut.wagons,
       weightTons: cut.weightTons,
-      feePerWagon: Number(rate.rateValue),
-      feeAmount,
-      feeCurrency: rate.currency,
+      feePerWagon: fee.perWagon,
+      feeAmount: fee.amount,
+      feeCurrency: fee.currency,
       creditAmount: this.creditFor(booking, cut.wagons),
     };
   }
@@ -146,8 +166,8 @@ export class BookingWagonCancellationService {
     }
 
     const cut = await this.resolveRequestedCut(booking, dto);
-    const rate = await this.feeRate();
-    const feeAmount = round2(Number(rate.rateValue) * cut.wagons);
+    const fee = await this.priceFee(booking, cut);
+    const feeAmount = fee.amount;
     const creditAmount = this.creditFor(booking, cut.wagons);
 
     const row = await this.repo.create({
@@ -156,9 +176,11 @@ export class BookingWagonCancellationService {
       weightTons: cut.weightTons,
       cancelledQuantities: cut.quantities,
       creditAmount,
-      feeRateId: rate.id,
+      // ponytail: one FK for a mixed-size container cut records the first
+      // size's rate; the invoice line carries the effective per-wagon fee.
+      feeRateId: fee.rates[0].id,
       feeAmount,
-      feeCurrency: rate.currency,
+      feeCurrency: fee.currency,
       status: 'FEE_PENDING',
       reason: dto.reason ?? null,
       requestedByUserId: userId ?? null,
@@ -173,15 +195,15 @@ export class BookingWagonCancellationService {
       type: WAGON_CANCEL_FEE_INVOICE_TYPE,
       companyId: booking.companyId,
       companyProfileId: booking.companyProfileId,
-      currency: rate.currency,
+      currency: fee.currency,
       lines: [
         {
           chargeType: 'CANCELLATION_FEE',
           description: `Wagon cancellation fee — ${cut.wagons} wagon(s) of booking ${booking.reference}`,
           quantity: cut.wagons,
-          unitRate: Number(rate.rateValue),
+          unitRate: fee.perWagon,
           amount: feeAmount,
-          currency: rate.currency,
+          currency: fee.currency,
           metadata: { wagonCancellationId: row.id },
         },
       ],
@@ -343,12 +365,28 @@ export class BookingWagonCancellationService {
       const preSplitQuantities =
         booking.preSplitQuantities ?? (await this.currentQuantities(manager, booking, droppedWeight));
 
+      // Whole-booking cut: nothing is left to ship, so the booking ends
+      // CANCELLED (frees the contract slot/cap for the rebook) and drops off its
+      // train. The credit row still points at it for T3.
+      const wagonsLeft = round2(
+        Number(booking.wagonsRequired ?? 0) - Number(row.wagonsCancelled),
+      );
+      const isFull = wagonsLeft <= 0;
       await manager.getRepository(Booking).update(booking.id, {
-        wagonsRequired: round2(Number(booking.wagonsRequired ?? 0) - Number(row.wagonsCancelled)),
-        cargoTotalWeightVgm: round3(Number(booking.cargoTotalWeightVgm) - droppedWeight),
-        totalAmount: round2(Number(booking.totalAmount) - Number(row.creditAmount)),
+        wagonsRequired: Math.max(0, wagonsLeft),
+        cargoTotalWeightVgm: Math.max(
+          0,
+          round3(Number(booking.cargoTotalWeightVgm) - droppedWeight),
+        ),
+        totalAmount: Math.max(
+          0,
+          round2(Number(booking.totalAmount) - Number(row.creditAmount)),
+        ),
         isSplit: true,
         preSplitQuantities,
+        ...(isFull
+          ? { status: 'CANCELLED', trainScheduleId: null, requestedTrainScheduleId: null }
+          : {}),
       } as never);
 
       await manager.getRepository(BookingWagonCancellation).update(row.id, {
@@ -360,11 +398,15 @@ export class BookingWagonCancellationService {
     });
 
     const booking = await this.bookingsRepository.findById(row.bookingId);
+    if (booking?.status === 'CANCELLED') await this.detachFromSchedule(booking);
     if (booking) {
+      const whole = booking.status === 'CANCELLED';
       this.notifyCustomer(
         booking,
-        'Wagon cancellation confirmed',
-        `${row.wagonsCancelled} wagon(s) of ${booking.reference} are cancelled. Your paid freight is kept as credit — rebook any day while your contract is valid.`,
+        whole ? 'Booking cancelled — credit available' : 'Wagon cancellation confirmed',
+        whole
+          ? `All wagons of ${booking.reference} are cancelled. Your paid freight is kept as credit — rebook any day while your contract is valid.`
+          : `${row.wagonsCancelled} wagon(s) of ${booking.reference} are cancelled. Your paid freight is kept as credit — rebook any day while your contract is valid.`,
       );
     }
     this.logger.log(
@@ -372,6 +414,33 @@ export class BookingWagonCancellationService {
     );
   }
 
+  /**
+   * Whole-booking cut: take the cancelled booking OFF its train entirely —
+   * schedule link, leftover wagon slots, window status — via the ops unassign
+   * path (no "removed from train" notice: the customer cancelled it). A stale
+   * link would keep showing the booking on the schedule AND poison every later
+   * auto wagon allocation on that train (the whole-train re-plan rejects a
+   * CANCELLED booking). Then re-run allocation so bookings held back by it
+   * (e.g. the rebooked credit) get their wagons.
+   */
+  private async detachFromSchedule(booking: Booking): Promise<void> {
+    const links = await this.dataSource
+      .getRepository(TrainScheduleBooking)
+      .find({ where: { bookingId: booking.id } });
+    for (const link of links) {
+      try {
+        await this.trainScheduling.unassignBooking(link.trainScheduleId, booking.id, undefined, {
+          notifyCustomer: false,
+        });
+        await this.trainScheduling.tryAutoWagonAllocation(link.trainScheduleId);
+      } catch (err) {
+        this.logger.error(
+          `Detach of cancelled booking ${booking.reference} from schedule ${link.trainScheduleId} failed: ${err instanceof Error ? err.message : String(err)}`,
+        );
+      }
+    }
+  }
+
   // ── T3: rebook ──────────────────────────────────────────────────────────────
 
   async rebook(
@@ -401,6 +470,8 @@ export class BookingWagonCancellationService {
     }
 
     const createDto = this.buildRebookDto(row, dto.scheduledDate);
+    // Same currency as the source booking — the credit is in it.
+    createDto.paymentCurrency = source.paymentCurrency ?? undefined;
     const created = await this.contractBooking.createUnderContract(
       source.contractId,
       createDto,
@@ -413,9 +484,13 @@ export class BookingWagonCancellationService {
 
     // The freight is already paid (credit) — mark PAID and let the existing
     // paid-booking machinery place it. No invoice is generated for it.
+    // Its price IS the credit (already paid, in the source currency) — not a
+    // fresh live-rate quote; a later cut of the rebooked booking credits from it.
     await this.dataSource.getRepository(Booking).update(newBookingId, {
       paymentStatus: 'PAID',
       status: 'PAID',
+      totalAmount: Number(row.creditAmount),
+      paymentCurrency: source.paymentCurrency,
     });
     await this.copyClearanceState(source, newBookingId);
 
@@ -532,16 +607,16 @@ export class BookingWagonCancellationService {
         const live = liveBySize.get(cut.containerSize) ?? 0;
         if (cut.quantity > live) {
           throw new BadRequestException(
-            `Cannot cancel ${cut.quantity} × ${cut.containerSize}ft — the booking only has ${live}.`,
+            `Cannot cancel ${cut.quantity} × ${sizeFtOf(cut.containerSize)}ft — the booking only has ${live}.`,
           );
         }
         bySize[cut.containerSize] = cut.quantity;
-        wagons += cut.quantity * wagonsPerUnitForSize(Number(cut.containerSize));
+        wagons += cut.quantity * wagonsPerUnitForSize(sizeFtOf(cut.containerSize));
       }
       wagons = round2(wagons);
-      if (wagons >= totalWagons) {
+      if (wagons > totalWagons) {
         throw new BadRequestException(
-          'That would cancel the whole booking — use booking cancellation instead of a partial wagon cancel.',
+          `Cannot cancel ${wagons} wagon(s) — the booking only has ${totalWagons}.`,
         );
       }
       // Snapshot the LIFO-picked physical units up front (read-only — cargo is
@@ -577,9 +652,11 @@ export class BookingWagonCancellationService {
           }
         }
       }
-      const weightShare = round3(
-        Number(booking.cargoTotalWeightVgm) * (wagons / totalWagons),
-      );
+      // Whole-booking cut takes the exact total, no ratio rounding.
+      const weightShare =
+        wagons >= totalWagons
+          ? round3(Number(booking.cargoTotalWeightVgm))
+          : round3(Number(booking.cargoTotalWeightVgm) * (wagons / totalWagons));
       return {
         wagons,
         weightTons: weightShare,
@@ -594,17 +671,19 @@ export class BookingWagonCancellationService {
     if (!wagons || wagons <= 0) {
       throw new BadRequestException('Specify how many wagons to cancel.');
     }
-    if (wagons >= totalWagons) {
+    if (wagons > totalWagons) {
       throw new BadRequestException(
-        'That would cancel the whole booking — use booking cancellation instead of a partial wagon cancel.',
+        `Cannot cancel ${wagons} wagon(s) — the booking only has ${totalWagons}.`,
       );
     }
+    // Whole-booking cut: all cargo, exactly. Otherwise proportional sizing.
     // ponytail: proportional sizing (tons/wagon = total/wagons). PER_ITEM item
     // rounding happens here too; switch to items_per_wagon_map sizing if bulk
     // PER_ITEM cancels ever need to be exact per item.
-    let tons = Number(booking.cargoTotalWeightVgm) * (wagons / totalWagons);
+    const isFull = wagons >= totalWagons;
+    let tons = Number(booking.cargoTotalWeightVgm) * (isFull ? 1 : wagons / totalWagons);
     const isPerItem = booking.bulkTotalWeightTons != null;
-    tons = isPerItem ? Math.floor(tons) : round3(tons);
+    tons = isPerItem && !isFull ? Math.floor(tons) : round3(tons);
     if (tons <= 0) {
       throw new BadRequestException('The requested cut is too small to release cargo.');
     }
@@ -641,19 +720,23 @@ export class BookingWagonCancellationService {
     }
 
     const wagons = allocations.length;
-    if (wagons >= totalWagons) {
+    if (wagons > totalWagons) {
       throw new BadRequestException(
-        'That would cancel the whole booking — use booking cancellation instead of a partial wagon cancel.',
+        `Cannot cancel ${wagons} wagon(s) — the booking only has ${totalWagons}.`,
       );
     }
+    const isFull = wagons >= totalWagons;
 
     if (booking.freightType !== 'CONTAINER') {
       const allocated = allocations.reduce(
         (s, a) => s + Number(a.allocatedWeightTons || 0),
         0,
       );
-      const tons =
-        allocated > 0
+      // Whole-booking cut takes the exact total; partial takes the wagons'
+      // allocated tonnage (ratio fallback when nothing is allocated yet).
+      const tons = isFull
+        ? round3(Number(booking.cargoTotalWeightVgm))
+        : allocated > 0
           ? round3(allocated)
           : round3(Number(booking.cargoTotalWeightVgm) * (wagons / totalWagons));
       return {
@@ -714,21 +797,83 @@ export class BookingWagonCancellationService {
     return round2(Number(booking.totalAmount) * (wagons / totalWagons));
   }
 
-  private async feeRate(): Promise<Rate> {
-    const rate = await this.dataSource.getRepository(Rate).findOne({
+  /**
+   * Price the cut off the LIVE per-wagon cancellation rates for the booking's
+   * trade direction. Bulk bills the rate scoped to the booking's commodity ×
+   * cancelled wagons; a container cut bills each size at its own container
+   * type's rate × the wagons that size occupies (two 20ft share one). A
+   * booking owned by a shipping line prices off that line's rates only —
+   * standard rates are never a fallback, matching booking pricing.
+   */
+  private async priceFee(booking: Booking, cut: RequestedCut): Promise<PricedFee> {
+    const raw = await this.priceFeeInRateCurrency(booking, cut);
+    // Bill in the booking's own currency (rates are configured in USD; ETB
+    // bookings pay ETB) — same USD→ETB conversion booking pricing applies.
+    const target = booking.paymentCurrency === 'ETB' ? 'ETB' : 'USD';
+    const from = raw.currency === 'ETB' ? 'ETB' : 'USD';
+    if (from === target) return raw;
+    const fx = await this.exchangeService.getRate(from, target);
+    return {
+      ...raw,
+      amount: round2(raw.amount * fx),
+      perWagon: round2(raw.perWagon * fx),
+      currency: target,
+    };
+  }
+
+  private async priceFeeInRateCurrency(
+    booking: Booking,
+    cut: RequestedCut,
+  ): Promise<PricedFee> {
+    const rates = await this.dataSource.getRepository(Rate).find({
       where: {
         rateType: WAGON_CANCELLATION_FEE_RATE_TYPE,
         rateUnit: 'PER_WAGON',
         status: 'LIVE',
+        tradeDirection: booking.tradeDirection,
+        shippingLineCompanyId: booking.shippingLineCompanyId ?? IsNull(),
       },
       order: { createdAt: 'DESC' },
     });
-    if (!rate) {
-      throw new BadRequestException(
-        'No LIVE per-wagon CANCELLATION_FEE rate is configured — ask EDR to set it in the rate engine (unit PER_WAGON).',
+    const missing = (scope: string): BadRequestException =>
+      new BadRequestException(
+        `No LIVE per-wagon cancellation fee is configured for ${scope} on ${booking.tradeDirection} — ask EDR to set it in the rate engine (surcharge: Cancellation).`,
       );
+
+    if (booking.freightType !== 'CONTAINER') {
+      const rate = rates.find(
+        (r) => !r.containerTypeId && !!r.cargoTypeId && r.cargoTypeId === booking.cargoTypeId,
+      );
+      if (!rate) throw missing(`bulk cargo type ${booking.cargoType?.cargoTypeName ?? booking.cargoTypeId ?? '?'}`);
+      const amount = round2(Number(rate.rateValue) * cut.wagons);
+      return { amount, currency: rate.currency, perWagon: Number(rate.rateValue), rates: [rate] };
     }
-    return rate;
+
+    // Container: split the cancelled wagons across sizes in proportion to the
+    // wagon-space each size's units occupy, so the total always equals
+    // cut.wagons (whole wagons on an allocation cut, fractional on a quantity cut).
+    const bySize = Object.entries(cut.quantities.bySize ?? {}).filter(([, qty]) => qty > 0);
+    const spaceOf = ([size, qty]: [string, number]) => qty * wagonsPerUnitForSize(sizeFtOf(size));
+    const totalSpace = bySize.reduce((s, e) => s + spaceOf(e), 0);
+    if (!bySize.length || totalSpace <= 0) throw missing('containers');
+    const containerTypes = await this.dataSource.getRepository(ContainerType).find();
+    const used: Rate[] = [];
+    let amount = 0;
+    let currency = '';
+    for (const entry of bySize) {
+      const [size] = entry;
+      const sizeFt = sizeFtOf(size);
+      const typeIds = new Set(
+        containerTypes.filter((ct) => Number(ct.sizeFt) === sizeFt).map((ct) => ct.id),
+      );
+      const rate = rates.find((r) => !!r.containerTypeId && typeIds.has(r.containerTypeId));
+      if (!rate) throw missing(`${sizeFt || '?'}ft containers`);
+      currency = rate.currency;
+      used.push(rate);
+      amount += Number(rate.rateValue) * cut.wagons * (spaceOf(entry) / totalSpace);
+    }
+    amount = round2(amount);
+    return { amount, currency, perWagon: round2(amount / cut.wagons), rates: used };
   }
 
   /**
@@ -751,7 +896,7 @@ export class BookingWagonCancellationService {
       const live = lines.reduce((s, l) => s + Number(l.quantity ?? 0), 0);
       if (live < toDrop) {
         throw new BadRequestException(
-          `Booking changed since the request: only ${live} × ${size}ft left, cannot cancel ${toDrop}.`,
+          `Booking changed since the request: only ${live} × ${sizeFtOf(size)}ft left, cannot cancel ${toDrop}.`,
         );
       }
       for (const line of lines) {
@@ -795,7 +940,7 @@ export class BookingWagonCancellationService {
         });
         await manager.getRepository(BookingContainer).update(line.id, {
           quantity: qty - drop,
-          wagonsRequired: round2((qty - drop) * wagonsPerUnitForSize(Number(size))),
+          wagonsRequired: round2((qty - drop) * wagonsPerUnitForSize(sizeFtOf(size))),
           totalVgmTons: round3(Number(line.totalVgmTons) - droppedVgm),
           hazardousQuantity: keptUnits.filter((u) => u.isHazardous).length,
           reeferQuantity: keptUnits.filter((u) => u.isReefer).length,
@@ -883,7 +1028,7 @@ export class BookingWagonCancellationService {
       const doomedVgm = round3(doomed.reduce((s, u) => s + Number(u.vgmTons || 0), 0));
       await manager.getRepository(BookingContainer).update(line.id, {
         quantity: kept.length,
-        wagonsRequired: round2(kept.length * wagonsPerUnitForSize(Number(size))),
+        wagonsRequired: round2(kept.length * wagonsPerUnitForSize(sizeFtOf(size))),
         totalVgmTons: round3(Number(line.totalVgmTons) - doomedVgm),
         hazardousQuantity: kept.filter((u) => u.isHazardous).length,
         reeferQuantity: kept.filter((u) => u.isReefer).length,
@@ -902,9 +1047,9 @@ export class BookingWagonCancellationService {
     booking: Booking,
     tons: number,
   ): Promise<void> {
-    if (tons >= Number(booking.cargoTotalWeightVgm)) {
+    if (tons > Number(booking.cargoTotalWeightVgm)) {
       throw new BadRequestException(
-        'Booking changed since the request: the cut no longer leaves any cargo.',
+        'Booking changed since the request: the cut exceeds the cargo left on the booking.',
       );
     }
     if (booking.bulkTotalWeightTons != null) {
@@ -1112,12 +1257,14 @@ export class BookingWagonCancellationService {
 
   private notifyStaff(booking: Booking, title: string, body: string): void {
     void this.inbox.notify({
-      recipients: { allBackoffice: true },
+      recipients: { permissionKeys: [FREIGHT_PERMS.bookings.getNotification] },
       audience: NotificationAudience.BACKOFFICE,
       type: NotificationType.BOOKING_STATUS,
       title,
       body,
-      link: `/bookings/${booking.id}`,
+      // The portal path `/bookings/:id` used to be sent here, which 404s in the
+      // dashboard. The staff view of these lives on the queue page.
+      link: '/dashboard/wagon-cancellations',
       data: { bookingId: booking.id, reference: booking.reference },
     });
   }
diff --git a/apps/edr-freight-api/src/modules/bookings/bookings.controller.ts b/apps/edr-freight-api/src/modules/bookings/bookings.controller.ts
index b7eb526a3..b1be94016 100644
--- a/apps/edr-freight-api/src/modules/bookings/bookings.controller.ts
+++ b/apps/edr-freight-api/src/modules/bookings/bookings.controller.ts
@@ -1,4 +1,5 @@
 import {
+  BadRequestException,
   Body,
   Controller,
   Delete,
@@ -38,6 +39,9 @@ import {
 } from "@nestjs/swagger";
 import type { Response } from "express";
 
+import { BookingClearanceChargeService } from './booking-clearance-charge.service';
+import { ClearanceEventService } from './clearance-event.service';
+import { BillClearanceChargeDto } from './dto/clearance-charge.dto';
 import { BookingContractService } from './booking-contract.service';
 import { BookingPricingService } from './booking-pricing.service';
 import { BookingTransitionService } from './booking-transition.service';
@@ -50,6 +54,7 @@ import { BookingReferenceDataService } from './booking-reference-data.service';
 import { scopedDirections } from '../user-trade-access/trade-scope.util';
 import { UserTradeAccessService } from '../user-trade-access/user-trade-access.service';
 import { BookingsService } from './bookings.service';
+import { ConsolidationApprovalService } from './consolidation-approval.service';
 import { BookingReferenceDataDto } from './dto/booking-reference-data.dto';
 import { CreateBookingDto } from './dto/create-booking.dto';
 import { BookingListSummaryDto } from './dto/booking-list-summary.dto';
@@ -58,7 +63,10 @@ import { GeneratePriceResponseDto } from './dto/generate-price-response.dto';
 import { SubmitBookingResponseDto } from './dto/submit-booking-response.dto';
 import {
   AcceptIntakeDto,
+  ApproveConsolidationDto,
   CancelBookingDto,
+  PairedDecisionDto,
+  RejectConsolidationDto,
   RejectBookingDto,
   RequestChangesDto,
   ReviewDocumentDto,
@@ -77,6 +85,7 @@ import { LastMileService } from '../last-mile/last-mile.service';
 import { GenerateGrnDto } from './dto/generate-grn.dto';
 import { ContainerReceiptService } from './container-receipt.service';
 import { SignContractDto } from './dto/sign-contract.dto';
+import { SetExportHandoverModeDto } from './dto/set-export-handover-mode.dto';
 import { UpdateBookingDto } from './dto/update-booking.dto';
 import { BookingWagonCancellationService } from './booking-wagon-cancellation.service';
 import {
@@ -164,6 +173,9 @@ export class BookingsController {
     private readonly lastMileService: LastMileService,
     private readonly userTradeAccessService: UserTradeAccessService,
     private readonly wagonCancellationService: BookingWagonCancellationService,
+    private readonly consolidationApprovalService: ConsolidationApprovalService,
+    private readonly clearanceChargeService: BookingClearanceChargeService,
+    private readonly clearanceEventService: ClearanceEventService,
   ) {}
 
   @Post()
@@ -757,6 +769,18 @@ export class BookingsController {
     return this.customerTruckService.getLoadableContainers(id);
   }
 
+  @Patch(':id/export-handover-mode')
+  @BookingStaff(FREIGHT_PERMS.bookings.operations)
+  @ApiOperation({
+    summary: 'Export only: choose direct truck-to-train (no warehouse, no GRN) or warehouse first',
+  })
+  setExportHandoverMode(
+    @Param('id', ParseUUIDPipe) id: string,
+    @Body() dto: SetExportHandoverModeDto,
+  ) {
+    return this.bookingsService.setExportHandoverMode(id, dto.exportHandoverMode);
+  }
+
   @Post(':id/customer-trucks/:assignmentId/load')
   @BookingStaff(FREIGHT_PERMS.bookings.operations)
   @ApiOperation({ summary: 'Truck_dispatch: load selected containers onto a truck (staff)' })
@@ -922,8 +946,8 @@ export class BookingsController {
   @Get('clearance/et-queue')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceEtActions)
   @ApiOperation({ summary: 'GL ET queue — general customs bookings awaiting ET action' })
-  getBookingEtClearanceQueue() {
-    return this.bookingClearanceService.etQueue();
+  getBookingEtClearanceQueue(@CurrentUser() user: unknown) {
+    return this.bookingClearanceService.etQueue(user);
   }
 
   @Get('clearance/dj-queue')
@@ -953,10 +977,12 @@ export class BookingsController {
   async submitClearanceDocuments(
     @Param("id", ParseUUIDPipe) id: string,
     @UploadedFiles() files: Express.Multer.File[],
+    @CurrentUser() user: AuthUserPayload,
   ) {
     const booking = await this.transitionService.submitClearanceDocuments(
       id,
       files ?? [],
+      resolveAuthUserId(user),
     );
     return this.transitionService.enrichBookingResponse(booking);
   }
@@ -973,11 +999,13 @@ export class BookingsController {
   async proceedToOperation(
     @Param("id", ParseUUIDPipe) id: string,
     @Body() dto: RequestOperationDto,
+    @CurrentUser() user: AuthUserPayload,
   ) {
     const booking = await this.transitionService.requestOperation(
       id,
       dto.scheduledDate,
       dto.trainScheduleId ?? null,
+      { userId: resolveAuthUserId(user) },
     );
     return this.transitionService.enrichBookingResponse(booking);
   }
@@ -1055,6 +1083,114 @@ export class BookingsController {
     return this.transitionService.enrichBookingResponse(booking);
   }
 
+  @Get(":id/clearance/history")
+  @BookingStaff([
+    FREIGHT_PERMS.contracts.clearanceEtActions,
+    FREIGHT_PERMS.contracts.clearanceDjActions,
+  ])
+  @ApiOperation({
+    summary:
+      "Clearance action history for the booking — reviews, workflow steps, charges (newest first)",
+  })
+  getClearanceHistory(@Param("id", ParseUUIDPipe) id: string) {
+    return this.clearanceEventService.list(id);
+  }
+
+  // ── Clearance charges (post-finalization customer billing) ────────────────
+
+  @Get(":id/clearance/charges")
+  @BookingStaff([
+    FREIGHT_PERMS.contracts.clearanceEtActions,
+    FREIGHT_PERMS.contracts.clearanceDjActions,
+  ])
+  @ApiOperation({
+    summary: "Clearance charges billed to the customer (port + miscellaneous)",
+  })
+  getClearanceCharges(@Param("id", ParseUUIDPipe) id: string) {
+    return this.clearanceChargeService.list(id);
+  }
+
+  @Post(":id/clearance/charges/port-document")
+  @BookingStaff(FREIGHT_PERMS.contracts.clearanceDjActions)
+  @UseInterceptors(FileInterceptor("file"))
+  @ApiConsumes("multipart/form-data")
+  @ApiOperation({
+    summary: "GL Djibouti uploads (or replaces, until billed) the port-charges document",
+  })
+  uploadPortChargeDocument(
+    @Param("id", ParseUUIDPipe) id: string,
+    @UploadedFile() file: Express.Multer.File,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    if (!file) throw new BadRequestException("A document file is required");
+    return this.clearanceChargeService.uploadPortDocument(
+      id,
+      file,
+      resolveAuthUserId(user),
+    );
+  }
+
+  @Patch(":id/clearance/charges/:chargeId/bill")
+  @BookingStaff(FREIGHT_PERMS.contracts.clearanceEtActions)
+  @ApiOperation({
+    summary:
+      "GL Ethiopia sets or revises the charge's amount + currency (revising a sent charge cancels its unpaid invoice)",
+  })
+  billClearanceCharge(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Param("chargeId", ParseUUIDPipe) chargeId: string,
+    @Body() dto: BillClearanceChargeDto,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    return this.clearanceChargeService.billCharge(
+      id,
+      chargeId,
+      dto,
+      resolveAuthUserId(user),
+    );
+  }
+
+  @Post(":id/clearance/charges/:chargeId/send")
+  @BookingStaff(FREIGHT_PERMS.contracts.clearanceEtActions)
+  @ApiOperation({
+    summary:
+      "GL Ethiopia issues the charge's payable invoice to the customer (ETB pays via gateway, other currencies via manual settlement)",
+  })
+  sendClearanceCharge(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Param("chargeId", ParseUUIDPipe) chargeId: string,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    return this.clearanceChargeService.sendCharge(
+      id,
+      chargeId,
+      resolveAuthUserId(user),
+    );
+  }
+
+  @Post(":id/clearance/charges/miscellaneous")
+  @BookingStaff(FREIGHT_PERMS.contracts.clearanceEtActions)
+  @UseInterceptors(FileInterceptor("file"))
+  @ApiConsumes("multipart/form-data")
+  @ApiOperation({
+    summary:
+      "GL Ethiopia creates the miscellaneous charge (document + amount + currency); unlocked once the port charge is paid",
+  })
+  createMiscellaneousCharge(
+    @Param("id", ParseUUIDPipe) id: string,
+    @UploadedFile() file: Express.Multer.File,
+    @Body() dto: BillClearanceChargeDto,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    if (!file) throw new BadRequestException("A document file is required");
+    return this.clearanceChargeService.createMiscellaneous(
+      id,
+      file,
+      dto,
+      resolveAuthUserId(user),
+    );
+  }
+
   @Post(":id/clearance/output-documents")
   @BookingStaff(FREIGHT_PERMS.bookings.uploadClearanceOutput)
   @UseInterceptors(AnyFilesInterceptor())
@@ -1063,10 +1199,12 @@ export class BookingsController {
   async uploadClearanceOutput(
     @Param("id", ParseUUIDPipe) id: string,
     @UploadedFiles() files: Express.Multer.File[],
+    @CurrentUser() user: AuthUserPayload,
   ) {
     const booking = await this.transitionService.uploadClearanceOutputDocuments(
       id,
       files ?? [],
+      resolveAuthUserId(user),
     );
     return this.transitionService.enrichBookingResponse(booking);
   }
@@ -1077,8 +1215,14 @@ export class BookingsController {
     summary:
       "GL finalizes clearance (requires 100% approved) → CLEARANCE_READY",
   })
-  async finalizeClearance(@Param("id", ParseUUIDPipe) id: string) {
-    const booking = await this.transitionService.finalizeClearance(id);
+  async finalizeClearance(
+    @Param("id", ParseUUIDPipe) id: string,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    const booking = await this.transitionService.finalizeClearance(
+      id,
+      resolveAuthUserId(user),
+    );
     return this.transitionService.enrichBookingResponse(booking);
   }
 
@@ -1091,8 +1235,13 @@ export class BookingsController {
   async requestBookingTransitAssignee(
     @Param('id', ParseUUIDPipe) id: string,
     @Body('note') note: string | undefined,
+    @CurrentUser() user: AuthUserPayload,
   ) {
-    const booking = await this.bookingClearanceService.requestTransitAssignee(id, note);
+    const booking = await this.bookingClearanceService.requestTransitAssignee(
+      id,
+      note,
+      resolveAuthUserId(user),
+    );
     return this.transitionService.enrichBookingResponse(booking);
   }
 
@@ -1105,8 +1254,13 @@ export class BookingsController {
   async assignBookingTransitAssignee(
     @Param('id', ParseUUIDPipe) id: string,
     @Body('transitAgentId', ParseUUIDPipe) transitAgentId: string,
+    @CurrentUser() user: AuthUserPayload,
   ) {
-    const booking = await this.bookingClearanceService.assignTransitAssignee(id, transitAgentId);
+    const booking = await this.bookingClearanceService.assignTransitAssignee(
+      id,
+      transitAgentId,
+      resolveAuthUserId(user),
+    );
     return this.transitionService.enrichBookingResponse(booking);
   }
 
@@ -1190,8 +1344,14 @@ export class BookingsController {
     summary:
       'Customer accepts the draft customs declaration — unlocks the real customs declaration step for GL Ethiopia',
   })
-  async acceptBookingDraftDeclaration(@Param('id', ParseUUIDPipe) id: string) {
-    const booking = await this.bookingClearanceService.acceptDraftDeclaration(id);
+  async acceptBookingDraftDeclaration(
+    @Param('id', ParseUUIDPipe) id: string,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    const booking = await this.bookingClearanceService.acceptDraftDeclaration(
+      id,
+      resolveAuthUserId(user),
+    );
     return this.transitionService.enrichBookingResponse(booking);
   }
 
@@ -1217,8 +1377,14 @@ export class BookingsController {
   @Post(':id/clearance/finalize-pre-clearance')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceEtActions)
   @ApiOperation({ summary: 'GL ET finalizes import pre-clearance on booking' })
-  async finalizeBookingPreClearance(@Param('id', ParseUUIDPipe) id: string) {
-    const booking = await this.bookingClearanceService.finalizePreClearance(id);
+  async finalizeBookingPreClearance(
+    @Param('id', ParseUUIDPipe) id: string,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    const booking = await this.bookingClearanceService.finalizePreClearance(
+      id,
+      resolveAuthUserId(user),
+    );
     return this.transitionService.enrichBookingResponse(booking);
   }
 
@@ -1230,8 +1396,13 @@ export class BookingsController {
   async uploadBookingDutySlip(
     @Param('id', ParseUUIDPipe) id: string,
     @UploadedFile() file: Express.Multer.File,
+    @CurrentUser() user: AuthUserPayload,
   ) {
-    const booking = await this.bookingClearanceService.uploadDutySlip(id, file);
+    const booking = await this.bookingClearanceService.uploadDutySlip(
+      id,
+      file,
+      resolveAuthUserId(user),
+    );
     return this.transitionService.enrichBookingResponse(booking);
   }
 
@@ -1254,18 +1425,18 @@ export class BookingsController {
 
   @Post(':id/clearance/delivery-order')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceDjActions)
-  @UseInterceptors(FileInterceptor('file'))
+  @UseInterceptors(AnyFilesInterceptor())
   @ApiConsumes('multipart/form-data')
   async uploadBookingDeliveryOrder(
     @Param('id', ParseUUIDPipe) id: string,
-    @UploadedFile() file: Express.Multer.File,
+    @UploadedFiles() files: Express.Multer.File[],
     @Body('vesselArrivalDate') vesselArrivalDate: string | undefined,
     @Body('doCollectedDate') doCollectedDate: string | undefined,
     @CurrentUser() user: TCurrentUser,
   ) {
     const booking = await this.bookingClearanceService.uploadDeliveryOrder(
       id,
-      file,
+      files ?? [],
       resolveAuthUserId(user),
       { vesselArrivalDate, doCollectedDate },
     );
@@ -1274,17 +1445,17 @@ export class BookingsController {
 
   @Post(':id/clearance/release-order')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceDjActions)
-  @UseInterceptors(FileInterceptor('file'))
+  @UseInterceptors(AnyFilesInterceptor())
   @ApiConsumes('multipart/form-data')
   async uploadBookingReleaseOrder(
     @Param('id', ParseUUIDPipe) id: string,
-    @UploadedFile() file: Express.Multer.File,
+    @UploadedFiles() files: Express.Multer.File[],
     @Body('vesselDepartureDate') vesselDepartureDate: string,
     @CurrentUser() user: TCurrentUser,
   ) {
     const result = await this.bookingClearanceService.uploadReleaseOrder(
       id,
-      file,
+      files ?? [],
       vesselDepartureDate,
       resolveAuthUserId(user),
     );
@@ -1528,6 +1699,92 @@ export class BookingsController {
     return this.transitionService.enrichBookingResponse(booking);
   }
 
+  // ── Shared-wagon (consolidation) approval gate ────────────────────────────
+  // A consolidated pair is held here, not in the operations queue: two
+  // customers' cargo on one wagon is a commercial call, so a person signs off
+  // on the pairing before Operations sees either half.
+
+  @Get("consolidation-approvals/queue")
+  @BookingStaff(FREIGHT_PERMS.bookings.approveConsolidation)
+  @ApiOperation({
+    summary:
+      "Shared-wagon pairings awaiting approval, oldest first. Each row covers BOTH bookings on the wagon.",
+  })
+  consolidationApprovalQueue() {
+    return this.consolidationApprovalService.queue();
+  }
+
+  @Get(":id/consolidation-approvals")
+  @BookingStaff(FREIGHT_PERMS.bookings.view)
+  @ApiOperation({
+    summary:
+      "Approval history for this booking's shared wagon — who decided what, when, and why.",
+  })
+  consolidationApprovalHistory(@Param("id", ParseUUIDPipe) id: string) {
+    return this.consolidationApprovalService.historyForBooking(id);
+  }
+
+  @Post("consolidation-approvals/:approvalId/approve")
+  @BookingStaff(FREIGHT_PERMS.bookings.approveConsolidation)
+  @ApiOperation({
+    summary:
+      "Approve a shared wagon: both bookings leave the gate and continue to Operations together.",
+  })
+  approveConsolidation(
+    @Param("approvalId", ParseUUIDPipe) approvalId: string,
+    @Body() dto: ApproveConsolidationDto,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    return this.consolidationApprovalService.approve(
+      approvalId,
+      resolveAuthUserId(user) ?? "",
+      dto.note,
+    );
+  }
+
+  @Post("consolidation-approvals/:approvalId/reject")
+  @BookingStaff(FREIGHT_PERMS.bookings.approveConsolidation)
+  @ApiOperation({
+    summary:
+      "Reject a shared wagon: both bookings go back to GL for changes with the reason.",
+  })
+  rejectConsolidation(
+    @Param("approvalId", ParseUUIDPipe) approvalId: string,
+    @Body() dto: RejectConsolidationDto,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    return this.consolidationApprovalService.reject(
+      approvalId,
+      resolveAuthUserId(user) ?? "",
+      dto.reason,
+    );
+  }
+
+  @Post(":id/paired-decision")
+  @BookingStaff(FREIGHT_PERMS.bookings.cancel)
+  @ApiOperation({
+    summary:
+      "Apply a staff decision (accept / cancel / operationAccept / requestChanges) to BOTH halves of a consolidated pair, all-or-nothing.",
+  })
+  async pairedDecision(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: PairedDecisionDto,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    const { booking, partner } = await this.transitionService.applyPairedDecision(
+      id,
+      dto.decision,
+      resolveAuthUserId(user),
+      { reason: dto.reason, note: dto.note, validityDays: dto.validityDays },
+    );
+    // Sequential enrichment: both go back so the UI can refresh either tab.
+    const enrichedBooking =
+      await this.transitionService.enrichBookingResponse(booking);
+    const enrichedPartner =
+      await this.transitionService.enrichBookingResponse(partner);
+    return { booking: enrichedBooking, partner: enrichedPartner };
+  }
+
   @Post(":id/cancel")
   @BookingStaff(FREIGHT_PERMS.bookings.cancel)
   @ApiOperation({ summary: "Cancel booking" })
diff --git a/apps/edr-freight-api/src/modules/bookings/bookings.module.ts b/apps/edr-freight-api/src/modules/bookings/bookings.module.ts
index 658629592..a522a6225 100644
--- a/apps/edr-freight-api/src/modules/bookings/bookings.module.ts
+++ b/apps/edr-freight-api/src/modules/bookings/bookings.module.ts
@@ -30,10 +30,17 @@ import { BookingsController } from './bookings.controller';
 // import { PayController } from './pay.controller';
 import { BookingsRepository } from './bookings.repository';
 import { ConsolidationService } from './consolidation.service';
+import { ConsolidationApprovalService } from './consolidation-approval.service';
+import { ConsolidationApprovalsRepository } from './consolidation-approvals.repository';
+import { ConsolidationApproval } from './entities/consolidation-approval.entity';
 import { ContainerValidationService } from './container-validation.service';
 import { BookingsService } from './bookings.service';
 import { BookingCargoModifier } from './entities/booking-cargo-modifier.entity';
 import { BookingDocumentReview } from './entities/booking-document-review.entity';
+import { BookingClearanceCharge } from './entities/booking-clearance-charge.entity';
+import { BookingClearanceChargeService } from './booking-clearance-charge.service';
+import { BookingClearanceEvent } from './entities/booking-clearance-event.entity';
+import { ClearanceEventService } from './clearance-event.service';
 import { BookingContainer } from './entities/booking-container.entity';
 import { BookingRateSnapshot } from './entities/booking-rate-snapshot.entity';
 import { BookingContractSignature } from './entities/booking-contract-signature.entity';
@@ -72,6 +79,9 @@ import { VehiclesModule } from "../vehicles/vehicles.module";
       BookingWagonCancellation,
       CustomerTruckAssignment,
       CustomerTruckContainer,
+      ConsolidationApproval,
+      BookingClearanceCharge,
+      BookingClearanceEvent,
     ]),
     BillingModule,
     DocumentsModule,
@@ -98,6 +108,8 @@ import { VehiclesModule } from "../vehicles/vehicles.module";
     BookingsService,
     BookingsRepository,
     ConsolidationService,
+    ConsolidationApprovalService,
+    ConsolidationApprovalsRepository,
     ContainerValidationService,
     BookingReferenceDataService,
     BookingPricingService,
@@ -105,6 +117,8 @@ import { VehiclesModule } from "../vehicles/vehicles.module";
     BookingTransitionService,
     BookingContractService,
     BookingInvoiceService,
+    BookingClearanceChargeService,
+    ClearanceEventService,
     ContractTemplateResolver,
     ContractViewModelBuilder,
     ContractPricingScheduleBuilder,
@@ -120,11 +134,15 @@ import { VehiclesModule } from "../vehicles/vehicles.module";
   exports: [
     BookingsService,
     BookingsRepository,
+    ClearanceEventService,
     BookingPricingService,
+    ContainerValidationService,
     BookingInvoiceService,
     BookingLifecycleNotifierService,
     BookingTransitionService,
     ConsolidationService,
+    ConsolidationApprovalService,
+    ConsolidationApprovalsRepository,
     CustomerTruckService,
     ContainerReceiptService,
     BookingWagonCancellationService,
diff --git a/apps/edr-freight-api/src/modules/bookings/bookings.repository.ts b/apps/edr-freight-api/src/modules/bookings/bookings.repository.ts
index 1c5cc7481..3ad75242d 100644
--- a/apps/edr-freight-api/src/modules/bookings/bookings.repository.ts
+++ b/apps/edr-freight-api/src/modules/bookings/bookings.repository.ts
@@ -1,4 +1,4 @@
-import { BaseRepository } from '@edr/api-common';
+import { BaseRepository, logCtx } from '@edr/api-common';
 import { SchedulingStatus } from '@edr/types';
 import { ConflictException, Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
@@ -12,9 +12,12 @@ import {
   SelectQueryBuilder,
 } from 'typeorm';
 
+import { computeFacets, FacetBucket } from '../../common/utils/facets.util';
+import { resolveIamUserNames } from '../../common/utils/iam-user-name.util';
 import { wagonsPerUnitForSize } from '../rule-engine/container-type.util';
 import { ContainerType } from '../rule-engine/entities/container-type.entity';
 import { Contract } from '../contracts/entities/contract.entity';
+import { ShippingLineCompany } from '../shipping-lines/entities/shipping-line-company.entity';
 import { ContractRateSnapshot } from '../contracts/entities/contract-rate-snapshot.entity';
 import { ContractRoute } from '../contracts/entities/contract-route.entity';
 import { applyDirectionScope } from '../user-trade-access/trade-scope.util';
@@ -59,6 +62,7 @@ export interface BookingListFilterOptions {
   assignedToSchedule?: 'true' | 'false';
   companyId?: string;
   companyProfileId?: string;
+  contractId?: string;
   contractType?: string;
   serviceTypeId?: string;
   cargoTypeId?: string;
@@ -78,6 +82,8 @@ export interface BookingListFilterOptions {
   originYardId?: string;
   destinationYardId?: string;
   isGovernment?: 'true' | 'false';
+  /** Shipping-line bookings vs ordinary customer bookings (exactly one owner is set). */
+  customerKind?: 'SHIPPING_LINE' | 'CUSTOMER';
   consolidationPaired?: string;
 }
 
@@ -303,6 +309,72 @@ export class BookingsRepository extends BaseRepository<Booking> {
       .find({ where: { contractId } });
   }
 
+  /**
+   * Bookings a GL operator may manually link to `booking` as its odd-20ft
+   * consolidation partner (Path B customs flow). Unlike
+   * {@link findComplementaryConsolidationPartner} — which auto-pairs on an exact
+   * quantity complement — this lists CANDIDATES for a human to choose from, so
+   * the filter is deliberately looser: any other customs booking on the same
+   * route/direction that is itself carrying an odd 20ft count. Two odd counts
+   * always sum to even, so any pick fills the shared wagon.
+   *
+   * Bare instances awaiting completion have no persisted containers yet, so the
+   * odd-count test runs on the requested container lines when they exist and the
+   * booking is offered as a candidate when they do not (GL enters its cargo on
+   * the split form).
+   */
+  async findManualConsolidationCandidates(
+    booking: Booking,
+    limit = 50,
+  ): Promise<Booking[]> {
+    const rows = await this.repository
+      .createQueryBuilder('b')
+      .leftJoinAndSelect('b.bookingContainers', 'bc')
+      .leftJoinAndSelect('bc.containerType', 'ct')
+      .leftJoinAndSelect('b.company', 'company')
+      .where('b.id != :bookingId', { bookingId: booking.id })
+      // Never offer a booking that already shares a wagon with someone else.
+      .andWhere('b.consolidationPartnerId IS NULL')
+      // Customs-only: this manual flow exists because a customs (Path B)
+      // instance is completed by GL, not by the customer.
+      .andWhere('b.customsClearingEnabled = true')
+      // Same physical wagon ⇒ same route and same direction.
+      .andWhere('b.originYardId = :originYardId', {
+        originYardId: booking.originYardId,
+      })
+      .andWhere('b.destinationYardId = :destinationYardId', {
+        destinationYardId: booking.destinationYardId,
+      })
+      .andWhere('b.tradeDirection = :tradeDirection', {
+        tradeDirection: booking.tradeDirection,
+      })
+      // Bookable = clearance finished and the booking is waiting to be completed,
+      // the same set completeUnderContract accepts, plus one already parked for a
+      // partner.
+      .andWhere('b.status IN (:...statuses)', {
+        statuses: [
+          'CLEARANCE_READY',
+          'OPERATION_CHANGES_REQUESTED',
+          'PENDING_CONSOLIDATION',
+        ],
+      })
+      .orderBy('b.createdAt', 'ASC')
+      .take(limit)
+      .getMany();
+
+    // Odd-20ft test in memory: a bare instance has no containers yet (GL fills
+    // them on the split form) and stays a candidate; one that already carries
+    // cargo qualifies only when its 20ft total is odd.
+    return rows.filter((row) => {
+      const lines = row.bookingContainers ?? [];
+      if (lines.length === 0) return true;
+      const ft20 = lines
+        .filter((line) => Number(line.containerType?.sizeFt) === 20)
+        .reduce((sum, line) => sum + Number(line.quantity || 0), 0);
+      return ft20 % 2 === 1;
+    });
+  }
+
   /**
    * Find another booking whose container quantity complements this one to fill whole wagon(s)
    * (same route, same container type, partial wagon on both sides). Only 20ft lines ever
@@ -503,6 +575,25 @@ export class BookingsRepository extends BaseRepository<Booking> {
     } as never);
   }
 
+  /**
+   * Link two bookings as consolidation partners WITHOUT touching their statuses.
+   * Used by the manual GL pairing, where both bookings have just been completed
+   * into their live status — unlike {@link pairConsolidation}, which exists to
+   * resume bookings parked in PENDING_CONSOLIDATION and rewrites status as part
+   * of that resume.
+   */
+  async linkConsolidationPartners(
+    bookingId: string,
+    partnerId: string,
+  ): Promise<void> {
+    await this.repository.update(bookingId, {
+      consolidationPartnerId: partnerId,
+    } as never);
+    await this.repository.update(partnerId, {
+      consolidationPartnerId: bookingId,
+    } as never);
+  }
+
   /** Un-pair a consolidation. */
   async unpairConsolidation(bookingId: string, partnerId: string): Promise<void> {
     await this.repository.update(bookingId, {
@@ -529,6 +620,29 @@ export class BookingsRepository extends BaseRepository<Booking> {
     });
   }
 
+  /**
+   * Bookings (of those given) that have at least one customer document still
+   * waiting on GL — PENDING or QUERIED. Includes ad-hoc `custom_*` documents,
+   * which no milestone tracks, so a file added after clearance was finalized
+   * still surfaces as needing review. One query for a whole queue page.
+   */
+  async findBookingsWithUnreviewedDocuments(
+    bookingIds: string[],
+  ): Promise<Set<string>> {
+    if (bookingIds.length === 0) return new Set();
+    const rows = (await this.dataSource
+      .getRepository(BookingDocumentReview)
+      .createQueryBuilder('r')
+      .select('DISTINCT r.booking_id', 'bookingId')
+      .where('r.booking_id IN (:...bookingIds)', { bookingIds })
+      .andWhere('r.status IN (:...statuses)', {
+        statuses: ['PENDING', 'QUERIED'],
+      })
+      .andWhere('r.deleted_at IS NULL')
+      .getRawMany()) as Array<{ bookingId: string }>;
+    return new Set(rows.map((r) => r.bookingId));
+  }
+
   findDocumentReview(
     bookingId: string,
     settingCode: string,
@@ -570,6 +684,13 @@ export class BookingsRepository extends BaseRepository<Booking> {
     await repo.save(repo.create({ ...input, status: 'PENDING' }));
   }
 
+  /** Display names for reviewer staff ids — one query for the whole set. */
+  async resolveStaffNames(
+    staffIds: (string | null | undefined)[],
+  ): Promise<Map<string, string>> {
+    return resolveIamUserNames(this.dataSource, staffIds);
+  }
+
   /** GL marks a document APPROVED or QUERIED (with an optional note). */
   async setDocumentReviewStatus(
     bookingId: string,
@@ -631,6 +752,13 @@ export class BookingsRepository extends BaseRepository<Booking> {
     authorId?: string,
   ): Promise<BookingReviewNote> {
     const repo = this.dataSource.getRepository(BookingReviewNote);
+    // Every rejection/cancellation/change-request reason in the booking flow is
+    // written through here — the "why" behind the status change on the same log
+    // line as the status change itself.
+    logCtx(
+      { bookingId, type, note, authorId },
+      { path: 'reviewNotes', mode: 'push' },
+    );
     return repo.save(
       repo.create({ bookingId, note, type, authorId: authorId ?? null }),
     );
@@ -772,16 +900,20 @@ export class BookingsRepository extends BaseRepository<Booking> {
       // by TypeORM and crashes).
       .leftJoin(Contract, 'contract', 'contract.id = booking.contract_id')
       .addSelect('contract.reference', 'contract_reference')
+      // Shipping-line owner name for search only (no relation, see entity) —
+      // the list rows get `shippingLineCompany` hydrated by the service.
+      .leftJoin(ShippingLineCompany, 'slc', 'slc.id = booking.shipping_line_company_id')
       .where('booking.deleted_at IS NULL');
 
     this.applyListFilters(qb, options);
 
-    // Free-text search spans joined columns (company, contract) that only this
-    // list query joins — so it lives here, not in applyListFilters (shared
-    // with getListSummaryMetrics, whose query builder has no joins).
+    // Free-text search spans joined columns (company, shipping line, contract)
+    // that only this list query joins — so it lives here, not in
+    // applyListFilters (shared with getListSummaryMetrics, whose query builder
+    // has no joins).
     if (options.search) {
       qb.andWhere(
-        '(booking.reference ILIKE :search OR company.name ILIKE :search OR contract.reference ILIKE :search)',
+        '(booking.reference ILIKE :search OR company.name ILIKE :search OR slc.name ILIKE :search OR contract.reference ILIKE :search)',
         { search: `%${options.search}%` },
       );
     }
@@ -849,6 +981,29 @@ export class BookingsRepository extends BaseRepository<Booking> {
     };
   }
 
+  /**
+   * Facet counts for the filter bar's enum popovers: one `GROUP BY` per
+   * column, each with every OTHER active filter applied but its own
+   * predicate omitted (see `applyListFilters`'s `omit` param). `bookingType`
+   * is derived from `contract_kind` (see the comment in `applyListFilters`),
+   * not a plain column, so it facets on the same CASE expression the filter
+   * itself applies.
+   */
+  async getFacets(options: BookingListFilterOptions): Promise<Record<string, FacetBucket[]>> {
+    return computeFacets(
+      () => this.repository.createQueryBuilder('booking').where('booking.deleted_at IS NULL'),
+      (qb, omit) => this.applyListFilters(qb, options, omit as keyof BookingListFilterOptions),
+      {
+        status: 'booking.status',
+        freightType: 'booking.freight_type',
+        tradeDirection: 'booking.trade_direction',
+        paymentStatus: 'booking.payment_status',
+        bookingType:
+          "CASE WHEN booking.contract_kind = 'GENERAL' THEN 'GENERAL_CONTRACT' ELSE 'ONE_TIME' END",
+      },
+    );
+  }
+
   async getStatusCounts(): Promise<Record<string, number>> {
     const rows = await this.repository
       .createQueryBuilder('booking')
@@ -907,16 +1062,24 @@ export class BookingsRepository extends BaseRepository<Booking> {
     return { inQueue, onThisPage, needsAction, urgent };
   }
 
+  /**
+   * @param omit  skip this one predicate — used by `getFacets` so a facet's
+   *   own filter doesn't hide its own sibling values. Every other caller
+   *   (list, summary metrics) passes nothing.
+   */
   private applyListFilters(
     qb: SelectQueryBuilder<Booking>,
     options: BookingListFilterOptions,
+    omit?: keyof BookingListFilterOptions | 'status',
   ): void {
-    if (options.statuses?.length) {
-      qb.andWhere('booking.status IN (:...statuses)', {
-        statuses: options.statuses,
-      });
-    } else if (options.status) {
-      qb.andWhere('booking.status = :status', { status: options.status });
+    if (omit !== 'status') {
+      if (options.statuses?.length) {
+        qb.andWhere('booking.status IN (:...statuses)', {
+          statuses: options.statuses,
+        });
+      } else if (options.status) {
+        qb.andWhere('booking.status = :status', { status: options.status });
+      }
     }
 
     if (options.companyId) {
@@ -929,6 +1092,11 @@ export class BookingsRepository extends BaseRepository<Booking> {
         companyProfileId: options.companyProfileId,
       });
     }
+    if (options.contractId) {
+      qb.andWhere('booking.contract_id = :contractId', {
+        contractId: options.contractId,
+      });
+    }
     if (options.contractType) {
       qb.andWhere('booking.contract_type = :contractType', {
         contractType: options.contractType,
@@ -944,12 +1112,12 @@ export class BookingsRepository extends BaseRepository<Booking> {
         cargoTypeId: options.cargoTypeId,
       });
     }
-    if (options.freightType) {
+    if (omit !== 'freightType' && options.freightType) {
       qb.andWhere('booking.freight_type = :freightType', {
         freightType: options.freightType,
       });
     }
-    if (options.bookingType) {
+    if (omit !== 'bookingType' && options.bookingType) {
       // The stored booking_type column is 'ONE_TIME' for every row (contract
       // drawdowns included — see contract-booking.service create), so the
       // one-time vs general split keys on the denormalized contract_kind:
@@ -998,12 +1166,17 @@ export class BookingsRepository extends BaseRepository<Booking> {
     } else if (options.isGovernment === 'false') {
       qb.andWhere('booking.is_government = FALSE');
     }
-    if (options.tradeDirection) {
+    if (options.customerKind === 'SHIPPING_LINE') {
+      qb.andWhere('booking.shipping_line_company_id IS NOT NULL');
+    } else if (options.customerKind === 'CUSTOMER') {
+      qb.andWhere('booking.shipping_line_company_id IS NULL');
+    }
+    if (omit !== 'tradeDirection' && options.tradeDirection) {
       qb.andWhere('booking.trade_direction = :tradeDirection', {
         tradeDirection: options.tradeDirection,
       });
     }
-    if (options.tradeDirections) {
+    if (omit !== 'tradeDirection' && options.tradeDirections) {
       applyDirectionScope(qb, 'booking.trade_direction', options.tradeDirections);
     }
     if (options.paymentCurrency) {
@@ -1011,7 +1184,7 @@ export class BookingsRepository extends BaseRepository<Booking> {
         paymentCurrency: options.paymentCurrency,
       });
     }
-    if (options.paymentStatus) {
+    if (omit !== 'paymentStatus' && options.paymentStatus) {
       qb.andWhere('booking.payment_status = :paymentStatus', {
         paymentStatus: options.paymentStatus,
       });
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 e4b902fe1..0b5bf5a0a 100644
--- a/apps/edr-freight-api/src/modules/bookings/bookings.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/bookings.service.ts
@@ -9,11 +9,11 @@ import {
   NotFoundException,
 } from '@nestjs/common';
 import { Freight, SchedulingStatus } from '@edr/types';
-import { insertWithGeneratedReference } from '@edr/api-common';
+import { insertWithGeneratedReference, logCtx } from '@edr/api-common';
 // import { CustomersService } from '../customers/customers.service';
 import { CompaniesService } from '../companies/companies.service';
 import { CompanyKind, CompanyStatus } from '../companies/entities/company.entity';
-import { TrainSchedulingService } from '../train-scheduling/train-scheduling.service';
+import { TrainSchedulingService } from '../train-scheduling/services/train-scheduling.service';
 import { eatDay } from '../train-scheduling/batch-window.util';
 import { FilesService } from '../files/files.service';
 import { MinioService } from '../minio/minio.service';
@@ -28,12 +28,13 @@ import { EventEmitter2 } from '@nestjs/event-emitter';
 import { DataSource, In } from 'typeorm';
 
 import { deriveTradeDirection } from '../../common/derive-trade-direction.util';
-import { assertExportReceivedWithGrn } from '../../common/export-received-gate';
+import { assertExportReceivedWithGrn, DIRECT_TO_TRAIN } from '../../common/export-received-gate';
 import { Yard } from '../rule-engine/entities/yard.entity';
 import { ServiceType } from '../rule-engine/entities/service-type.entity';
 import { TrainSchedule } from '../train-schedules/entities/train-schedule.entity';
 import { Contract } from '../contracts/entities/contract.entity';
 import { BookingBatchService } from '../train-scheduling/booking-batch.service';
+import { paymentDrainEndsAtIso } from '../train-scheduling/booking-batch.constants';
 import { BookingContractService } from './booking-contract.service';
 import { BookingsRepository } from './bookings.repository';
 import { ConsolidationService } from './consolidation.service';
@@ -57,6 +58,32 @@ import { CustomerTruckAssignmentDto } from './dto/customer-truck-assignment.dto'
 import { PdfRenderService } from '../billing/documents/pdf-render.service';
 import { buildTabularFallbackPdf } from '../billing/documents/styled-pdf.util';
 
+/**
+ * The train as the backoffice booking detail page needs it: which train, its
+ * window phase, and both the planned and actual clock. Attached by `findById`
+ * for the allocated train (`train_schedule_id`) or, before the batch engine has
+ * allocated one, the train the customer picked at day-commit
+ * (`requested_train_schedule_id`) — see `isRequested`.
+ */
+export interface TrainScheduleSummary {
+  id: string;
+  reference: string | null;
+  trainNumber: string | null;
+  status: string | null;
+  scheduledDepartureDate: string | null;
+  scheduledArrivalDate: string | null;
+  actualDepartureAt: string | null;
+  actualArrivalAt: string | null;
+  windowPhase: string | null;
+  paymentPhaseEndsAt: string | null;
+  /**
+   * True when this is the customer's requested train rather than a confirmed
+   * allocation — the state staff review at OPERATION_REQUEST_PENDING, before
+   * accepting the operation puts the booking into the batch pool.
+   */
+  isRequested: boolean;
+}
+
 /** Paginated booking list: flat `total` (backoffice) + `meta` block (portal). */
 export interface PaginatedBookings {
   items: Booking[];
@@ -92,6 +119,7 @@ interface CarriageAcceptanceWagonRow {
 interface CarriageAcceptanceReceivedRow {
   allocatedWeightTons: string | null;
   containerNumbers: string | null;
+  sealNumbers?: string | null;
 }
 
 const URGENT_PRIORITY_THRESHOLD = 1000;
@@ -285,10 +313,28 @@ export class BookingsService {
     // Receipt is proven by the warehouse GRN, but the GRN is warehouse paperwork
     // and never appears on this sheet — it is only the signal that EDR has taken
     // the cargo, which is what the customer's sheet attests to.
+    const isDirectExport =
+      booking.tradeDirection === 'EXPORT' && booking.exportHandoverMode === DIRECT_TO_TRAIN;
     const pendingWagons = wagons.length === 0;
     if (pendingWagons) {
-      const receivedLines: CarriageAcceptanceReceivedRow[] =
-        booking.tradeDirection === 'EXPORT'
+      // Direct truck-to-train cargo never enters the warehouse, so there is no
+      // GRN'd inventory to build the sheet from. Choosing direct handover is
+      // itself the acceptance, so the sheet issues off the containers the
+      // customer declared on the booking — freight.containers only gains rows at
+      // allocation, by which point the wagon query above already serves.
+      const receivedLines: CarriageAcceptanceReceivedRow[] = isDirectExport
+        ? await this.dataSource.query(
+            `SELECT NULL::numeric        AS "allocatedWeightTons",
+                    unit.container_number AS "containerNumbers",
+                    unit.seal_number      AS "sealNumbers"
+               FROM freight.booking_container_units unit
+               JOIN freight.booking_container line
+                 ON line.id = unit.booking_container_id AND line.deleted_at IS NULL
+              WHERE line.booking_id = $1 AND unit.deleted_at IS NULL
+              ORDER BY unit.container_number`,
+            [bookingId],
+          )
+        : booking.tradeDirection === 'EXPORT'
           ? await this.dataSource.query(
               `SELECT inv.weight         AS "allocatedWeightTons",
                       c.container_number AS "containerNumbers"
@@ -304,6 +350,17 @@ export class BookingsService {
               [bookingId],
             )
           : [];
+      // Bulk direct cargo has no containers — one line carrying the booking's
+      // declared weight still makes a valid sheet. bulkTotalWeightTons only
+      // holds the real tonnage for PER_ITEM break-bulk; everywhere else (PER_TON
+      // bulk and every container booking) the VGM column is the weight.
+      if (isDirectExport && receivedLines.length === 0) {
+        const totalWeight = booking.bulkTotalWeightTons ?? booking.cargoTotalWeightVgm;
+        receivedLines.push({
+          allocatedWeightTons: totalWeight == null ? null : String(totalWeight),
+          containerNumbers: null,
+        });
+      }
       if (receivedLines.length === 0) {
         throw new BadRequestException(
           booking.tradeDirection === 'EXPORT'
@@ -324,7 +381,7 @@ export class BookingsService {
         marshalledAt: null,
         arrivalAt: null,
         containerNumbers: row.containerNumbers,
-        sealNumbers: null,
+        sealNumbers: row.sealNumbers ?? null,
       }));
     }
 
@@ -424,7 +481,10 @@ export class BookingsService {
 
     const departureStation = booking.originYard?.label ?? booking.originYard?.code ?? '-';
     const arrivalStation = booking.destinationYard?.label ?? booking.destinationYard?.code ?? '-';
-    const cargoName = booking.cargoType?.cargoTypeName ?? booking.cargoFreeText ?? '-';
+    // Container bookings carry no cargo type or free text — name the freight type
+    // rather than printing a dash in the Cargo Name column.
+    const cargoName =
+      booking.cargoType?.cargoTypeName ?? booking.cargoFreeText ?? booking.freightType ?? '-';
     const currency = booking.paymentCurrency ?? 'ETB';
     const totalAmount = Number(booking.adjustedTotalAmount ?? booking.totalAmount) || 0;
     const prices = this.splitAmountAcrossWagons(
@@ -467,6 +527,28 @@ export class BookingsService {
       )
       .join('');
 
+    // The totals belong in <tbody>, not <tfoot>: the Chromium-less fallback
+    // renderer only parses tbody rows, so a <tfoot> silently drops every footer
+    // figure from the printed sheet.
+    const totalsRow = `<tr class="totals">
+        <td>TOT</td>
+        <td>${wagons.length} ${pendingWagons ? 'received lines' : 'wagons'}</td>
+        <td>${
+          pendingWagons
+            ? 'pending marshalling'
+            : `full ${fullWagons} / empty ${wagons.length - fullWagons}`
+        }</td>
+        <td class="num">${num(totals.tare, 2)}</td>
+        <td class="num">${num(totals.length)}</td>
+        <td class="num">${num(totals.capacity)}</td>
+        <td></td>
+        <td>Gross ${num(totals.tare + totals.load)} T</td>
+        <td></td>
+        <td></td>
+        <td></td>
+        <td class="num">${money(totalAmount)}</td>
+      </tr>`;
+
     return `<!doctype html>
 <html>
 <head>
@@ -490,7 +572,7 @@ export class BookingsService {
     th { background: #f8fafc; color: #475569; text-align: left; }
     th, td { border: 1px solid #cbd5e1; padding: 5px 6px; font-size: 9.5px; vertical-align: top; }
     .num { text-align: right; }
-    tfoot td { background: #f8fafc; font-weight: 700; }
+    tr.totals td { background: #f8fafc; font-weight: 700; }
     .notice { margin-top: 10px; border-left: 4px solid #0f766e; background: #f0fdfa; padding: 8px 10px; font-size: 10px; color: #134e4a; }
     .signatures { display: grid; grid-template-columns: repeat(3, 1fr); gap: 18px; margin-top: 34px; }
     .line { border-top: 1px solid #334155; padding-top: 7px; font-size: 9px; color: #475569; min-height: 34px; }
@@ -538,21 +620,8 @@ export class BookingsService {
     </thead>
     <tbody>
       ${rows}
+      ${totalsRow}
     </tbody>
-    <tfoot>
-      <tr>
-        <td colspan="3">${
-          pendingWagons
-            ? `Received lines: ${wagons.length} — wagons pending marshalling`
-            : `Total wagons: ${wagons.length} (full ${fullWagons} / empty ${wagons.length - fullWagons})`
-        }</td>
-        <td class="num">${num(totals.tare, 2)}</td>
-        <td class="num">${num(totals.length)}</td>
-        <td class="num">${num(totals.capacity)}</td>
-        <td colspan="5">Gross weight (tare + load): ${num(totals.tare + totals.load)} T</td>
-        <td class="num">${money(totalAmount)}</td>
-      </tr>
-    </tfoot>
   </table>
 
   <div class="notice">
@@ -1696,6 +1765,52 @@ export class BookingsService {
       (b as Booking & { handoverAwaitingSignature?: boolean }).handoverAwaitingSignature =
         pending.has(b.id);
     }
+    this.attachPaymentDrainEnds(bookings);
+    await this.attachShippingLineCompanies(bookings);
+  }
+
+  /**
+   * Batched name lookup for shipping-line-owned bookings (`companyId` null,
+   * `shippingLineCompanyId` set). No relation on the entity — the shipping-line
+   * module sits above bookings — so a raw query keyed off the loaded ids fills
+   * `shippingLineCompany` the way `company` is filled for customers.
+   */
+  private async attachShippingLineCompanies(bookings: Booking[]): Promise<void> {
+    const ids = [
+      ...new Set(
+        bookings
+          .map((b) => b.shippingLineCompanyId)
+          .filter((id): id is string => id != null),
+      ),
+    ];
+    if (!ids.length) return;
+    const rows: Array<{ id: string; name: string; email: string | null; phoneNumber: string | null }> =
+      await this.dataSource.query(
+        `SELECT id, name, email, phone_number AS "phoneNumber"
+           FROM freight.shipping_line_companies
+          WHERE id = ANY($1::uuid[]) AND deleted_at IS NULL`,
+        [ids],
+      );
+    const byId = new Map(rows.map((r) => [r.id, r]));
+    for (const b of bookings) {
+      const line = b.shippingLineCompanyId ? byId.get(b.shippingLineCompanyId) : undefined;
+      if (line) {
+        (b as Booking & { shippingLineCompany?: typeof line }).shippingLineCompany = line;
+      }
+    }
+  }
+
+  /**
+   * Derived, no query: end of the settlement drain tail after `paymentDeadline`.
+   * The portal hides "Pay now" between the deadline and this instant — a payment
+   * started just before the buzzer is still settling, so offering to pay again
+   * would invite a double payment.
+   */
+  private attachPaymentDrainEnds(bookings: Booking[]): void {
+    for (const b of bookings) {
+      (b as Booking & { paymentDrainEndsAt?: string | null }).paymentDrainEndsAt =
+        paymentDrainEndsAtIso(b.paymentDeadline);
+    }
   }
 
   async findAll(
@@ -1722,6 +1837,7 @@ export class BookingsService {
       // ANDs both, so cross-company access is impossible.
       companyId: forceCompanyId ?? filter.companyId,
       companyProfileId: forceCompanyProfileId ?? filter.companyProfileId,
+      contractId: filter.contractId,
       tradeDirections,
       contractType: filter.contractType,
       serviceTypeId: filter.serviceTypeId,
@@ -1738,6 +1854,7 @@ export class BookingsService {
       originYardId: filter.originYardId,
       destinationYardId: filter.destinationYardId,
       isGovernment: filter.isGovernment,
+      customerKind: filter.customerKind,
       consolidationPaired: filter.consolidationPaired,
       // DTO carries 'true'/'false' strings (query params); the repo option is a
       // real boolean — convert, preserving "not filtered" when absent.
@@ -1964,11 +2081,13 @@ export class BookingsService {
       originYardId: filter.originYardId,
       destinationYardId: filter.destinationYardId,
       isGovernment: filter.isGovernment,
+      customerKind: filter.customerKind,
       consolidationPaired: filter.consolidationPaired,
     };
 
-    const [statusCounts, metrics] = await Promise.all([
+    const [statusCounts, facets, metrics] = await Promise.all([
       this.bookingsRepository.getStatusCounts(),
+      this.bookingsRepository.getFacets(listFilter),
       this.bookingsRepository.getListSummaryMetrics({
         ...listFilter,
         page,
@@ -1980,17 +2099,77 @@ export class BookingsService {
 
     return {
       metrics,
+      // Tabs stay unfiltered (whole-set) on purpose — see the DTO comment.
       tabs: mapStatusCountsToTabs(statusCounts),
+      facets,
     };
   }
 
   /** Get a single booking by ID with files. */
+  /**
+   * EXPORT only. Choose how the cargo reaches the train. DIRECT_TO_TRAIN takes
+   * the booking out of the warehouse flow entirely — no receipt, no GRN, and the
+   * carriage acceptance sheet becomes issuable straight away.
+   *
+   * Switching to direct is refused once the goods are already in the shed:
+   * inventory exists, so the cargo demonstrably went the warehouse route and its
+   * GRN paperwork must stand.
+   */
+  async setExportHandoverMode(
+    bookingId: string,
+    mode: string,
+  ): Promise<{ bookingId: string; exportHandoverMode: string }> {
+    const booking = await this.bookingsRepository.findById(bookingId);
+    if (!booking) {
+      throw new NotFoundException(`Booking ${bookingId} not found`);
+    }
+    if ((booking.tradeDirection ?? '').toUpperCase() !== 'EXPORT') {
+      throw new BadRequestException('Handover mode applies to export bookings only');
+    }
+    if (mode === DIRECT_TO_TRAIN) {
+      const [stored]: Array<{ one: number }> = await this.dataSource.query(
+        `SELECT 1 AS one
+           FROM freight.warehouse_inventory
+          WHERE booking_id = $1 AND deleted_at IS NULL
+          LIMIT 1`,
+        [bookingId],
+      );
+      if (stored) {
+        throw new BadRequestException(
+          'This booking already has cargo in the warehouse, so it cannot be switched to direct truck-to-train',
+        );
+      }
+    }
+    await this.dataSource.query(
+      `UPDATE freight.bookings SET export_handover_mode = $2, updated_at = NOW() WHERE id = $1`,
+      [bookingId, mode],
+    );
+    return { bookingId, exportHandoverMode: mode };
+  }
+
   async findById(id: string): Promise<Booking> {
     const booking = await this.bookingsRepository.findByIdWithFiles(id);
     if (!booking) {
       throw new NotFoundException(`Booking ${id} not found`);
     }
 
+    // Nearly every booking flow loads the booking through here, so this one
+    // call puts the human-searchable reference + entry state on the request log
+    // line for all of them. Entry state only — the write trail (statusChanges)
+    // shows where it ended up.
+    logCtx(
+      {
+        id: booking.id,
+        reference: booking.reference,
+        statusAtEntry: booking.status,
+        companyId: booking.companyId,
+        contractId: booking.contractId ?? undefined,
+      },
+      { path: "booking" },
+    );
+
+    await this.attachShippingLineCompanies([booking]);
+
     if (booking.files && booking.files.length > 0) {
       booking.files = await Promise.all(
         booking.files.map(async (file: FileRecord) => {
@@ -2016,14 +2195,48 @@ export class BookingsService {
     // Surface the assigned train's operational status so the portal stepper
     // can show the Arrival stage: the booking status stays IN_TRANSIT from
     // dispatch until delivery, so arrival is only knowable from the schedule.
-    if (booking.trainScheduleId) {
+    // The allocated train, or — before the batch engine has allocated one — the
+    // train the customer picked at day-commit. Staff reviewing an operation
+    // request (OPERATION_REQUEST_PENDING) must see which train they are
+    // accepting onto before they approve, and at that point only the requested
+    // id is set.
+    const summarySourceId = booking.trainScheduleId ?? booking.requestedTrainScheduleId;
+    if (summarySourceId) {
       const schedule = await this.dataSource
         .getRepository(TrainSchedule)
-        .findOne({ where: { id: booking.trainScheduleId } });
+        .findOne({ where: { id: summarySourceId } });
+      // trainScheduleStatus drives the portal's Arrival stage, so it stays tied
+      // to a real allocation — a merely requested train has not departed.
       (booking as Booking & { trainScheduleStatus?: string | null }).trainScheduleStatus =
-        schedule?.status ?? null;
+        booking.trainScheduleId ? (schedule?.status ?? null) : null;
+      // Backoffice staff view: the train's identity and clock, so the detail
+      // page can state which train the booking rides and when it runs without a
+      // second round-trip to the schedules API.
+      (
+        booking as Booking & { trainScheduleSummary?: TrainScheduleSummary | null }
+      ).trainScheduleSummary = schedule
+        ? {
+            id: schedule.id,
+            reference: schedule.reference ?? null,
+            trainNumber: schedule.trainNumber ?? null,
+            status: schedule.status ?? null,
+            scheduledDepartureDate: schedule.scheduledDepartureDate?.toISOString() ?? null,
+            scheduledArrivalDate: schedule.scheduledArrivalDate?.toISOString() ?? null,
+            actualDepartureAt: schedule.actualDepartureAt?.toISOString() ?? null,
+            actualArrivalAt: schedule.actualArrivalAt?.toISOString() ?? null,
+            windowPhase: schedule.windowPhase ?? null,
+            paymentPhaseEndsAt: schedule.paymentPhaseEndsAt?.toISOString() ?? null,
+            isRequested: !booking.trainScheduleId,
+          }
+        : null;
     }
 
+    // End of this booking's own pay window including the settlement drain tail —
+    // the deadline staff should quote, since a payment landing inside the drain
+    // still counts (see paymentDrainEndsAtIso).
+    (booking as Booking & { paymentDrainEndsAt?: string | null }).paymentDrainEndsAt =
+      paymentDrainEndsAtIso(booking.paymentDeadline);
+
     // A generated-but-unsigned handover means the customer must approve delivery
     // from the portal. Self-haul: booking-based, one per booking. EDR last-mile:
     // per delivering truck (generated on truck exit), signed one by one.
diff --git a/apps/edr-freight-api/src/modules/bookings/clearance-doc-history.util.ts b/apps/edr-freight-api/src/modules/bookings/clearance-doc-history.util.ts
new file mode 100644
index 000000000..e86c8f644
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/clearance-doc-history.util.ts
@@ -0,0 +1,74 @@
+import type { BookingDocumentReview } from './entities/booking-document-review.entity';
+import type { BookingReviewNote } from './entities/booking-review-note.entity';
+import type { FileRecord } from '../files/entities/file.entity';
+
+/** One entry of a clearance document's per-card audit trail, oldest first. */
+export interface ClearanceDocEvent {
+  type: 'UPLOADED' | 'RESUBMITTED' | 'QUERIED' | 'APPROVED';
+  at: string;
+  byName: string | null;
+  note: string | null;
+}
+
+/**
+ * Query review notes are written as `Document "<fileKey>" queried: <note>`
+ * (see BookingTransitionService.reviewDocument) — the only place a past query
+ * decision survives after the customer re-uploads and the review row resets.
+ */
+const QUERY_NOTE_RE = /^Document "(.+?)" queried: ([\s\S]*)$/;
+
+/**
+ * Per-document audit trail assembled from data the flow already persists:
+ * every stored file version (first = customer upload, later ones = the
+ * customer's amendment responses), every query note (who opened it, when,
+ * why), and the review row's current approval. Approvals that were later
+ * reset by a re-upload are the one thing not kept anywhere — the trail shows
+ * the decision that currently stands.
+ */
+export function buildClearanceDocHistory(input: {
+  fileKey: string;
+  /** All versions of all files on the booking, createdAt ASC, deleted included. */
+  allVersions: FileRecord[];
+  /** CHANGES_REQUESTED review notes for the booking. */
+  queryNotes: BookingReviewNote[];
+  review: BookingDocumentReview | null;
+  /** staff id → display name. */
+  names: Map<string, string>;
+}): ClearanceDocEvent[] {
+  const { fileKey, allVersions, queryNotes, review, names } = input;
+  const events: ClearanceDocEvent[] = [];
+
+  const versions = allVersions.filter((v) => v.code === fileKey);
+  versions.forEach((v, i) => {
+    events.push({
+      type: i === 0 ? 'UPLOADED' : 'RESUBMITTED',
+      at: v.createdAt.toISOString(),
+      byName: v.uploadedByName ?? null,
+      note: null,
+    });
+  });
+
+  for (const n of queryNotes) {
+    const m = QUERY_NOTE_RE.exec(n.note);
+    if (!m || m[1] !== fileKey) continue;
+    events.push({
+      type: 'QUERIED',
+      at: n.createdAt.toISOString(),
+      byName: n.authorId ? (names.get(n.authorId) ?? null) : null,
+      note: m[2] || null,
+    });
+  }
+
+  if (review?.status === 'APPROVED' && review.reviewedAt) {
+    events.push({
+      type: 'APPROVED',
+      at: review.reviewedAt.toISOString(),
+      byName: review.reviewedByStaffId
+        ? (names.get(review.reviewedByStaffId) ?? null)
+        : null,
+      note: null,
+    });
+  }
+
+  return events.sort((a, b) => a.at.localeCompare(b.at));
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/clearance-documents-open.spec.ts b/apps/edr-freight-api/src/modules/bookings/clearance-documents-open.spec.ts
new file mode 100644
index 000000000..893b7c735
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/clearance-documents-open.spec.ts
@@ -0,0 +1,47 @@
+import { Booking } from './entities/booking.entity';
+import { clearanceDocumentsOpen } from './clearance.util';
+
+/**
+ * The customer may attach clearance documents — and GL may review them — right
+ * up to payment, not merely until clearance is finalized. Both the upload and
+ * the review endpoint gate on this one predicate, so a drift here silently
+ * desynchronizes the two sides.
+ */
+const booking = (patch: Partial<Booking>): Booking =>
+  ({ status: 'CLEARANCE_READY', paymentStatus: 'PENDING', ...patch }) as Booking;
+
+describe('clearanceDocumentsOpen', () => {
+  it('stays open across the whole pre-payment flow', () => {
+    for (const status of [
+      'AWAITING_DOCUMENTS',
+      'DOCUMENTS_UNDER_REVIEW',
+      'CLEARANCE_READY',
+      'OPERATION_REQUEST_PENDING',
+      'SELECTED_FOR_BATCH',
+      'PNR_GENERATED',
+      'PAYMENT_VERIFICATION_IN_PROGRESS',
+    ]) {
+      expect(clearanceDocumentsOpen(booking({ status }))).toBe(true);
+    }
+  });
+
+  it('closes once the shipment is paid or finished', () => {
+    for (const status of ['PAID', 'IN_TRANSIT', 'ARRIVED', 'COMPLETED']) {
+      expect(clearanceDocumentsOpen(booking({ status }))).toBe(false);
+    }
+  });
+
+  it('closes on a dead booking', () => {
+    for (const status of ['REJECTED', 'CANCELLED', 'EXPIRED']) {
+      expect(clearanceDocumentsOpen(booking({ status }))).toBe(false);
+    }
+  });
+
+  it('closes when payment settled before the status caught up', () => {
+    expect(
+      clearanceDocumentsOpen(
+        booking({ status: 'PNR_GENERATED', paymentStatus: 'PAID' }),
+      ),
+    ).toBe(false);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/bookings/clearance-event.service.ts b/apps/edr-freight-api/src/modules/bookings/clearance-event.service.ts
new file mode 100644
index 000000000..cc5c1acab
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/clearance-event.service.ts
@@ -0,0 +1,89 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { DataSource, EntityManager } from 'typeorm';
+import { Freight } from '@edr/types';
+
+import { resolveIamUserNames } from '../../common/utils/iam-user-name.util';
+import {
+  BookingClearanceEvent,
+  ClearanceEventActorType,
+} from './entities/booking-clearance-event.entity';
+
+export interface RecordClearanceEventInput {
+  bookingId: string;
+  action: string;
+  /** Human sentence for the History tab, frozen at write time. */
+  label: string;
+  actorType?: ClearanceEventActorType;
+  /** IAM user id (staff or portal customer); name is resolved here. */
+  actorId?: string | null;
+  metadata?: Record<string, unknown> | null;
+  /** Join the caller's transaction so the event commits (or rolls back) with the action. */
+  manager?: EntityManager;
+}
+
+/**
+ * The clearance History tab's write/read path. Every clearance mutation calls
+ * {@link record} — document reviews, phased workflow steps, customer charges.
+ * Recording is deliberately NOT fire-and-forget: the insert shares the caller's
+ * transaction when a manager is passed, and otherwise a failed insert fails the
+ * action, because a silent gap in an audit trail is worse than a retry.
+ */
+@Injectable()
+export class ClearanceEventService {
+  private readonly logger = new Logger(ClearanceEventService.name);
+
+  constructor(private readonly dataSource: DataSource) {}
+
+  async record(input: RecordClearanceEventInput): Promise<void> {
+    const mg = input.manager ?? this.dataSource.manager;
+    const actorName = input.actorId
+      ? ((await resolveIamUserNames(this.dataSource, [input.actorId])).get(
+          input.actorId,
+        ) ?? null)
+      : null;
+    await mg.save(
+      mg.create(BookingClearanceEvent, {
+        bookingId: input.bookingId,
+        action: input.action,
+        label: input.label,
+        actorType: input.actorType ?? 'STAFF',
+        actorId: input.actorId ?? null,
+        actorName,
+        metadata: input.metadata ?? null,
+      }),
+    );
+    this.logger.log(
+      `clearance-history ${input.action} on booking ${input.bookingId}${
+        actorName ? ` by ${actorName}` : ''
+      }`,
+    );
+  }
+
+  /** History for one booking, newest first. */
+  async list(bookingId: string): Promise<Freight.ClearanceHistoryEvent[]> {
+    const rows = await this.dataSource
+      .getRepository(BookingClearanceEvent)
+      .find({ where: { bookingId }, order: { createdAt: 'DESC' } });
+
+    // Rows whose actor name failed to resolve at write time get one more try.
+    const missing = rows
+      .filter((r) => !r.actorName && r.actorId)
+      .map((r) => r.actorId as string);
+    const names = missing.length
+      ? await resolveIamUserNames(this.dataSource, missing).catch(
+          () => new Map<string, string>(),
+        )
+      : new Map<string, string>();
+
+    return rows.map((r) => ({
+      id: r.id,
+      action: r.action,
+      label: r.label,
+      actorType: r.actorType,
+      actorName:
+        r.actorName ?? (r.actorId ? (names.get(r.actorId) ?? null) : null),
+      metadata: r.metadata ?? null,
+      at: r.createdAt.toISOString(),
+    }));
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/clearance.util.ts b/apps/edr-freight-api/src/modules/bookings/clearance.util.ts
index e28917715..56a73fa58 100644
--- a/apps/edr-freight-api/src/modules/bookings/clearance.util.ts
+++ b/apps/edr-freight-api/src/modules/bookings/clearance.util.ts
@@ -16,6 +16,16 @@ type Freight = 'container' | 'bulk';
  */
 export const INTERCITY_DOCUMENTS_SETTING_CODE = 'intercity_documents';
 
+/**
+ * The document set a shipping line uploads on a booking it initiated.
+ *
+ * Shipping lines book without a contract, so none of the trade-direction /
+ * freight / customs matrix below applies to them — this one admin-configured
+ * set is what Operations reviews before the booking may be completed.
+ */
+export const SHIPPING_LINE_DOCUMENTS_SETTING_CODE =
+  'shipping_line_booking_documents';
+
 /** Trade direction → clearance operation. DOMESTIC has no customs clearance. */
 function operationFor(tradeDirection: string): Op | null {
   if (tradeDirection === 'IMPORT') return 'import';
@@ -67,6 +77,20 @@ export function clearanceCodesForBooking(booking: Booking): {
   outputCode: string | null;
   includesCustoms: boolean;
 } {
+  // Shipping-line bookings resolve to their own single set and never reach the
+  // matrix below: they have no contract, and their trade direction / freight
+  // type are placeholders until the booking is completed, so the customer codes
+  // would resolve to a set that was never meant for them. Keyed off the owner
+  // column, which is NULL on every customer booking — so no customer booking
+  // can take this branch.
+  if (booking.shippingLineCompanyId) {
+    return {
+      inputCode: SHIPPING_LINE_DOCUMENTS_SETTING_CODE,
+      outputCode: null,
+      includesCustoms: false,
+    };
+  }
+
   // Customs applies when EITHER the service type bundles it OR the booking was
   // created with customsClearingEnabled (copied from the contract). Contract
   // bookings carry customsClearingEnabled even when the serviceType relation
@@ -89,3 +113,36 @@ export function clearanceCodesForBooking(booking: Booking): {
     includesCustoms,
   };
 }
+
+/**
+ * Statuses after which clearance documents are closed: the shipment is paid
+ * and moving. Everything before that — review, clearance ready, operation
+ * request, batch selection, PNR, payment verification — still accepts new
+ * customer documents and still lets GL review them.
+ */
+const CLEARANCE_DOCS_CLOSED_STATUSES = new Set<string>([
+  'PAID',
+  'IN_TRANSIT',
+  'ARRIVED',
+  'COMPLETED',
+  'REJECTED',
+  'CANCELLED',
+  'EXPIRED',
+]);
+
+/**
+ * True while the customer may still attach clearance documents and GL may
+ * still approve or query them.
+ *
+ * Clearance finalization is NOT the cut-off: a customs shipment keeps
+ * collecting paperwork (amended invoices, revised packing lists, port
+ * documents) right up to the final invoice being settled. Both the customer's
+ * upload endpoint and GL's review endpoint gate on this one predicate, so the
+ * two sides can never drift apart.
+ */
+export function clearanceDocumentsOpen(booking: Booking): boolean {
+  if (CLEARANCE_DOCS_CLOSED_STATUSES.has(booking.status)) return false;
+  // Payment settled ahead of the status transition (webhook ordering).
+  if (booking.paymentStatus === 'PAID') return false;
+  return true;
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/consolidation-approval.service.spec.ts b/apps/edr-freight-api/src/modules/bookings/consolidation-approval.service.spec.ts
new file mode 100644
index 000000000..5f121f630
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/consolidation-approval.service.spec.ts
@@ -0,0 +1,207 @@
+import {
+  ConsolidationApprovalService,
+  CONSOLIDATION_APPROVAL_PENDING,
+} from './consolidation-approval.service';
+import { ConsolidationApprovalStatus } from './entities/consolidation-approval.entity';
+import { Booking } from './entities/booking.entity';
+
+/**
+ * The shared-wagon approval gate. Two customers' cargo on one wagon is a
+ * commercial call, so the pair is held for a human decision instead of going
+ * straight to Operations.
+ *
+ * The invariants that matter: both halves are held and released TOGETHER (a
+ * decision on one side of a shared wagon is meaningless without the other), and
+ * a decided pairing cannot be decided twice.
+ */
+describe('ConsolidationApprovalService', () => {
+  const PENDING = {
+    id: 'ap-1',
+    bookingId: 'b-1',
+    partnerBookingId: 'b-2',
+    status: ConsolidationApprovalStatus.Pending,
+    requestedBy: 'gl-user',
+  };
+
+  function makeService(overrides: {
+    approvals?: Partial<Record<string, jest.Mock>>;
+    bookingsRepository?: Partial<Record<string, jest.Mock>>;
+  } = {}) {
+    const approvals = {
+      findPendingForBooking: jest.fn().mockResolvedValue(null),
+      findById: jest.fn().mockResolvedValue(PENDING),
+      create: jest.fn().mockResolvedValue({ id: 'ap-1' }),
+      decide: jest.fn().mockResolvedValue(true),
+      findQueue: jest.fn().mockResolvedValue([]),
+      findAllForBooking: jest.fn().mockResolvedValue([]),
+      ...overrides.approvals,
+    };
+    const bookingsRepository = {
+      update: jest.fn().mockResolvedValue(undefined),
+      createReviewNote: jest.fn().mockResolvedValue(undefined),
+      ...overrides.bookingsRepository,
+    };
+    const bookingsService = {
+      findById: jest.fn(async (id: string) =>
+        ({ id, reference: `BK-${id}` }) as Booking,
+      ),
+    };
+    const notifier = {
+      consolidationApprovalRequestedToStaff: jest.fn(),
+      consolidationApprovedToStaff: jest.fn(),
+      consolidationRejectedToStaff: jest.fn(),
+      operationRequestedToStaff: jest.fn(),
+    };
+    const dataSource = {
+      transaction: jest.fn(async (cb: () => Promise<unknown>) => cb()),
+    };
+
+    const service = new ConsolidationApprovalService(
+      approvals as never,
+      bookingsRepository as never,
+      bookingsService as never,
+      notifier as never,
+      dataSource as never,
+    );
+    return { service, approvals, bookingsRepository, notifier };
+  }
+
+  it('holds BOTH halves at the gate when a pairing is created', async () => {
+    const { service, approvals, bookingsRepository, notifier } = makeService();
+
+    await service.requestApproval('b-1', 'b-2', 'gl-user');
+
+    expect(approvals.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        bookingId: 'b-1',
+        partnerBookingId: 'b-2',
+        requestedBy: 'gl-user',
+      }),
+    );
+    // Neither half may sit in the operations queue while the wagon is unreviewed.
+    expect(bookingsRepository.update).toHaveBeenCalledWith('b-1', {
+      status: CONSOLIDATION_APPROVAL_PENDING,
+    });
+    expect(bookingsRepository.update).toHaveBeenCalledWith('b-2', {
+      status: CONSOLIDATION_APPROVAL_PENDING,
+    });
+    expect(
+      notifier.consolidationApprovalRequestedToStaff,
+    ).toHaveBeenCalledTimes(1);
+  });
+
+  it('does not open a second review for a pairing already pending', async () => {
+    const { service, approvals } = makeService({
+      approvals: {
+        findPendingForBooking: jest.fn().mockResolvedValue(PENDING),
+      },
+    });
+
+    const result = await service.requestApproval('b-1', 'b-2', 'gl-user');
+
+    expect(result).toBe(PENDING);
+    expect(approvals.create).not.toHaveBeenCalled();
+  });
+
+  it('releases BOTH halves to Operations on approval, logging who decided', async () => {
+    const { service, approvals, bookingsRepository, notifier } = makeService();
+
+    await service.approve('ap-1', 'approver-1', 'looks fine');
+
+    expect(approvals.decide).toHaveBeenCalledWith(
+      'ap-1',
+      ConsolidationApprovalStatus.Approved,
+      'approver-1',
+      'looks fine',
+    );
+    expect(bookingsRepository.update).toHaveBeenCalledWith('b-1', {
+      status: 'OPERATION_REQUEST_PENDING',
+    });
+    expect(bookingsRepository.update).toHaveBeenCalledWith('b-2', {
+      status: 'OPERATION_REQUEST_PENDING',
+    });
+    // Operations only learns about the pair now — the gate is what kept it out.
+    expect(notifier.operationRequestedToStaff).toHaveBeenCalledTimes(2);
+  });
+
+  it('sends BOTH halves back to GL on rejection, with the reason on each', async () => {
+    const { service, approvals, bookingsRepository } = makeService();
+
+    await service.reject('ap-1', 'approver-1', 'partner cargo is wrong');
+
+    expect(approvals.decide).toHaveBeenCalledWith(
+      'ap-1',
+      ConsolidationApprovalStatus.Rejected,
+      'approver-1',
+      'partner cargo is wrong',
+    );
+    expect(bookingsRepository.createReviewNote).toHaveBeenCalledWith(
+      'b-1',
+      'partner cargo is wrong',
+      'CHANGES_REQUESTED',
+    );
+    expect(bookingsRepository.createReviewNote).toHaveBeenCalledWith(
+      'b-2',
+      'partner cargo is wrong',
+      'CHANGES_REQUESTED',
+    );
+    expect(bookingsRepository.update).toHaveBeenCalledWith('b-1', {
+      status: 'OPERATION_CHANGES_REQUESTED',
+    });
+    expect(bookingsRepository.update).toHaveBeenCalledWith('b-2', {
+      status: 'OPERATION_CHANGES_REQUESTED',
+    });
+  });
+
+  it('lets the requester approve their own pairing', async () => {
+    // No maker-checker separation: the permission alone decides who may approve,
+    // and the audit trail still records requester and approver separately.
+    const { service, approvals } = makeService();
+
+    await service.approve('ap-1', 'gl-user');
+
+    expect(approvals.decide).toHaveBeenCalledWith(
+      'ap-1',
+      ConsolidationApprovalStatus.Approved,
+      'gl-user',
+      undefined,
+    );
+  });
+
+  it('requires a reason to reject', async () => {
+    const { service, approvals } = makeService();
+
+    await expect(service.reject('ap-1', 'approver-1', '   ')).rejects.toThrow(
+      /reason is required/i,
+    );
+    expect(approvals.decide).not.toHaveBeenCalled();
+  });
+
+  it('refuses a pairing that was already decided', async () => {
+    const { service, bookingsRepository } = makeService({
+      approvals: {
+        findById: jest.fn().mockResolvedValue({
+          ...PENDING,
+          status: ConsolidationApprovalStatus.Approved,
+        }),
+      },
+    });
+
+    await expect(service.approve('ap-1', 'approver-1')).rejects.toThrow(
+      /already approved/i,
+    );
+    expect(bookingsRepository.update).not.toHaveBeenCalled();
+  });
+
+  it('loses cleanly when another approver decides the same pairing first', async () => {
+    // decide() writes only against a still-PENDING row, so the loser of the race
+    // affects nothing and must not move the bookings.
+    const { service } = makeService({
+      approvals: { decide: jest.fn().mockResolvedValue(false) },
+    });
+
+    await expect(service.approve('ap-1', 'approver-1')).rejects.toThrow(
+      /already decided by someone else/i,
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/bookings/consolidation-approval.service.ts b/apps/edr-freight-api/src/modules/bookings/consolidation-approval.service.ts
new file mode 100644
index 000000000..ab4f4891d
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/consolidation-approval.service.ts
@@ -0,0 +1,242 @@
+import {
+  BadRequestException,
+  ConflictException,
+  Inject,
+  Injectable,
+  Logger,
+  NotFoundException,
+  forwardRef,
+} from "@nestjs/common";
+import { DataSource } from "typeorm";
+
+import { Booking } from "./entities/booking.entity";
+import {
+  ConsolidationApproval,
+  ConsolidationApprovalStatus,
+} from "./entities/consolidation-approval.entity";
+import { ConsolidationApprovalsRepository } from "./consolidation-approvals.repository";
+import { BookingsRepository } from "./bookings.repository";
+import { BookingsService } from "./bookings.service";
+import { BookingLifecycleNotifierService } from "./booking-lifecycle-notifier.service";
+
+/** Where a rejected pair goes back to, so GL can fix and resubmit. */
+const REJECTED_STATUS = "OPERATION_CHANGES_REQUESTED";
+
+/** The gate's own holding status — neither half reaches Operations from here. */
+export const CONSOLIDATION_APPROVAL_PENDING = "CONSOLIDATION_APPROVAL_PENDING";
+
+/**
+ * The shared-wagon approval gate.
+ *
+ * A booking that fills its own wagons goes straight from GL completion to the
+ * operations queue. A consolidated one does not: two customers' cargo rides one
+ * physical wagon under two separate invoices, so a person reviews the pairing
+ * before Operations sees either half.
+ *
+ * Both halves are held and released TOGETHER — the wagon is shared, so a
+ * decision on one is meaningless without the other. Every request is kept,
+ * decided or not: the table is the audit trail of who approved which pairing,
+ * when, and why.
+ *
+ * No maker-checker separation: whoever holds the approve permission may decide a
+ * pairing, including the GL user who created it. The record of who requested and
+ * who decided is still kept either way.
+ */
+@Injectable()
+export class ConsolidationApprovalService {
+  private readonly logger = new Logger(ConsolidationApprovalService.name);
+
+  constructor(
+    private readonly approvals: ConsolidationApprovalsRepository,
+    private readonly bookingsRepository: BookingsRepository,
+    @Inject(forwardRef(() => BookingsService))
+    private readonly bookingsService: BookingsService,
+    private readonly notifier: BookingLifecycleNotifierService,
+    private readonly dataSource: DataSource,
+  ) {}
+
+  /**
+   * Park a newly consolidated pair for review instead of letting it continue to
+   * Operations. Called from the completion path once the two halves are linked.
+   *
+   * Idempotent: a pair that already has an undecided request is left alone, so a
+   * retried completion cannot open a second review of the same wagon.
+   */
+  async requestApproval(
+    bookingId: string,
+    partnerBookingId: string,
+    requestedBy: string | null,
+  ): Promise<ConsolidationApproval> {
+    const existing = await this.approvals.findPendingForBooking(bookingId);
+    if (existing) return existing;
+
+    // Sequential reads: one connection per transaction context.
+    const booking = await this.bookingsService.findById(bookingId);
+    const partner = await this.bookingsService.findById(partnerBookingId);
+    if (!booking || !partner) {
+      throw new NotFoundException("Both bookings of the pair must exist.");
+    }
+
+    const approval = await this.approvals.create({
+      bookingId,
+      partnerBookingId,
+      requestedBy,
+      scheduledDate: booking.scheduledDate ?? null,
+      bookingReference: booking.reference ?? null,
+      partnerBookingReference: partner.reference ?? null,
+    });
+
+    // Hold BOTH halves: the wagon is shared, so neither may advance alone.
+    await this.bookingsRepository.update(bookingId, {
+      status: CONSOLIDATION_APPROVAL_PENDING,
+    } as never);
+    await this.bookingsRepository.update(partnerBookingId, {
+      status: CONSOLIDATION_APPROVAL_PENDING,
+    } as never);
+
+    this.notifier.consolidationApprovalRequestedToStaff(
+      booking,
+      partner.reference ?? partnerBookingId,
+    );
+    this.logger.log(
+      `Consolidation ${booking.reference} + ${partner.reference} awaiting approval (${approval.id}).`,
+    );
+    return approval;
+  }
+
+  /**
+   * Approve the pairing: both halves leave the gate and continue to Operations,
+   * which is exactly where a non-consolidated booking would already be.
+   *
+   * All-or-nothing — the two status writes and the decision record share one
+   * transaction, so the audit trail can never claim an approval that did not
+   * take effect.
+   */
+  async approve(
+    approvalId: string,
+    decidedBy: string,
+    note?: string,
+  ): Promise<{ booking: Booking; partner: Booking }> {
+    const approval = await this.loadPending(approvalId);
+
+    await this.dataSource.transaction(async () => {
+      const claimed = await this.approvals.decide(
+        approval.id,
+        ConsolidationApprovalStatus.Approved,
+        decidedBy,
+        note,
+      );
+      // Lost the race to another approver deciding the same pairing.
+      if (!claimed) {
+        throw new ConflictException(
+          "This consolidation was already decided by someone else.",
+        );
+      }
+      await this.bookingsRepository.update(approval.bookingId, {
+        status: "OPERATION_REQUEST_PENDING",
+      } as never);
+      await this.bookingsRepository.update(approval.partnerBookingId, {
+        status: "OPERATION_REQUEST_PENDING",
+      } as never);
+    });
+
+    const booking = await this.bookingsService.findById(approval.bookingId);
+    const partner = await this.bookingsService.findById(
+      approval.partnerBookingId,
+    );
+    this.notifier.consolidationApprovedToStaff(
+      booking,
+      partner.reference ?? approval.partnerBookingId,
+    );
+    // Operations only now learns about the pair — the gate is what kept it out.
+    this.notifier.operationRequestedToStaff(booking);
+    this.notifier.operationRequestedToStaff(partner);
+    return { booking, partner };
+  }
+
+  /**
+   * Reject the pairing: both halves go back to GL as OPERATION_CHANGES_REQUESTED
+   * with the reason, so the cargo or the partner can be changed and resubmitted.
+   */
+  async reject(
+    approvalId: string,
+    decidedBy: string,
+    reason: string,
+  ): Promise<{ booking: Booking; partner: Booking }> {
+    if (!reason?.trim()) {
+      throw new BadRequestException(
+        "A reason is required to reject a consolidation.",
+      );
+    }
+    const approval = await this.loadPending(approvalId);
+
+    await this.dataSource.transaction(async () => {
+      const claimed = await this.approvals.decide(
+        approval.id,
+        ConsolidationApprovalStatus.Rejected,
+        decidedBy,
+        reason.trim(),
+      );
+      if (!claimed) {
+        throw new ConflictException(
+          "This consolidation was already decided by someone else.",
+        );
+      }
+      await this.bookingsRepository.createReviewNote(
+        approval.bookingId,
+        reason.trim(),
+        "CHANGES_REQUESTED",
+      );
+      await this.bookingsRepository.createReviewNote(
+        approval.partnerBookingId,
+        reason.trim(),
+        "CHANGES_REQUESTED",
+      );
+      await this.bookingsRepository.update(approval.bookingId, {
+        status: REJECTED_STATUS,
+      } as never);
+      await this.bookingsRepository.update(approval.partnerBookingId, {
+        status: REJECTED_STATUS,
+      } as never);
+    });
+
+    const booking = await this.bookingsService.findById(approval.bookingId);
+    const partner = await this.bookingsService.findById(
+      approval.partnerBookingId,
+    );
+    this.notifier.consolidationRejectedToStaff(
+      booking,
+      partner.reference ?? approval.partnerBookingId,
+      reason.trim(),
+    );
+    return { booking, partner };
+  }
+
+  /** Pending pairings awaiting a decision, oldest first. */
+  queue(): Promise<ConsolidationApproval[]> {
+    return this.approvals.findQueue();
+  }
+
+  /** Full decision history for one booking — who decided what, and when. */
+  historyForBooking(bookingId: string): Promise<ConsolidationApproval[]> {
+    return this.approvals.findAllForBooking(bookingId);
+  }
+
+  /** The undecided request covering this booking, if any. */
+  pendingForBooking(bookingId: string): Promise<ConsolidationApproval | null> {
+    return this.approvals.findPendingForBooking(bookingId);
+  }
+
+  private async loadPending(approvalId: string): Promise<ConsolidationApproval> {
+    const approval = await this.approvals.findById(approvalId);
+    if (!approval) {
+      throw new NotFoundException(`Approval ${approvalId} not found`);
+    }
+    if (approval.status !== ConsolidationApprovalStatus.Pending) {
+      throw new ConflictException(
+        `This consolidation was already ${approval.status.toLowerCase()}.`,
+      );
+    }
+    return approval;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/consolidation-approvals.repository.ts b/apps/edr-freight-api/src/modules/bookings/consolidation-approvals.repository.ts
new file mode 100644
index 000000000..b398e7e8c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/consolidation-approvals.repository.ts
@@ -0,0 +1,120 @@
+import { Injectable } from "@nestjs/common";
+import { DataSource, In, Repository } from "typeorm";
+
+import {
+  ConsolidationApproval,
+  ConsolidationApprovalStatus,
+} from "./entities/consolidation-approval.entity";
+
+/**
+ * Persistence for the shared-wagon approval gate. Rows are never deleted —
+ * decided rows are the audit trail of who approved which pairing and when.
+ */
+@Injectable()
+export class ConsolidationApprovalsRepository {
+  private readonly repository: Repository<ConsolidationApproval>;
+
+  constructor(private readonly dataSource: DataSource) {
+    this.repository = this.dataSource.getRepository(ConsolidationApproval);
+  }
+
+  /**
+   * The undecided request covering `bookingId`, from EITHER side of the pair —
+   * one row governs both halves, and the caller may hold either one.
+   */
+  findPendingForBooking(
+    bookingId: string,
+  ): Promise<ConsolidationApproval | null> {
+    return this.repository.findOne({
+      where: [
+        { bookingId, status: ConsolidationApprovalStatus.Pending },
+        {
+          partnerBookingId: bookingId,
+          status: ConsolidationApprovalStatus.Pending,
+        },
+      ],
+    });
+  }
+
+  /** Every request touching this booking, newest first (the audit trail). */
+  findAllForBooking(bookingId: string): Promise<ConsolidationApproval[]> {
+    return this.repository.find({
+      where: [{ bookingId }, { partnerBookingId: bookingId }],
+      order: { createdAt: "DESC" },
+    });
+  }
+
+  findById(id: string): Promise<ConsolidationApproval | null> {
+    return this.repository.findOne({ where: { id } });
+  }
+
+  /** Pending requests for the review queue, oldest first (FIFO). */
+  findQueue(): Promise<ConsolidationApproval[]> {
+    return this.repository.find({
+      where: { status: ConsolidationApprovalStatus.Pending },
+      relations: {
+        booking: { company: true },
+        partnerBooking: { company: true },
+      },
+      order: { requestedAt: "ASC" },
+    });
+  }
+
+  create(input: {
+    bookingId: string;
+    partnerBookingId: string;
+    requestedBy?: string | null;
+    scheduledDate?: Date | null;
+    bookingReference?: string | null;
+    partnerBookingReference?: string | null;
+  }): Promise<ConsolidationApproval> {
+    return this.repository.save(
+      this.repository.create({
+        ...input,
+        status: ConsolidationApprovalStatus.Pending,
+        requestedAt: new Date(),
+      }),
+    );
+  }
+
+  /**
+   * Record the decision. Written only against a row still PENDING, so two
+   * approvers racing on the same pairing cannot both succeed — the second
+   * update matches nothing and the caller sees `false`.
+   */
+  async decide(
+    id: string,
+    status:
+      | ConsolidationApprovalStatus.Approved
+      | ConsolidationApprovalStatus.Rejected,
+    decidedBy: string | null,
+    decisionNote?: string | null,
+  ): Promise<boolean> {
+    const result = await this.repository.update(
+      { id, status: ConsolidationApprovalStatus.Pending },
+      {
+        status,
+        decidedBy,
+        decidedAt: new Date(),
+        decisionNote: decisionNote ?? null,
+      },
+    );
+    return (result.affected ?? 0) > 0;
+  }
+
+  /** Undecided requests covering any of these bookings (list badging). */
+  findPendingForBookings(
+    bookingIds: string[],
+  ): Promise<ConsolidationApproval[]> {
+    if (bookingIds.length === 0) return Promise.resolve([]);
+    return this.repository.find({
+      where: [
+        { bookingId: In(bookingIds), status: ConsolidationApprovalStatus.Pending },
+        {
+          partnerBookingId: In(bookingIds),
+          status: ConsolidationApprovalStatus.Pending,
+        },
+      ],
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/container-validation.service.ts b/apps/edr-freight-api/src/modules/bookings/container-validation.service.ts
index de4dca661..158ac14de 100644
--- a/apps/edr-freight-api/src/modules/bookings/container-validation.service.ts
+++ b/apps/edr-freight-api/src/modules/bookings/container-validation.service.ts
@@ -67,9 +67,16 @@ export class ContainerValidationService {
     const has20ft = containerLines.some((bc) => (bc.containerSize ?? '').includes('20'));
     if (!has20ft) return [];
 
-    const units = await this.load20ftUnits(booking);
-    if (units.length < 2) return [];
+    return this.validate20ftPairingUnits(await this.load20ftUnits(booking));
+  }
 
+  /**
+   * Same rule over units that are not (yet) persisted — a completion payload
+   * being previewed or submitted. Shipping-line completion uses this: its
+   * cargo only hits the DB after the check passes.
+   */
+  async validate20ftPairingUnits(units: Container20ftUnit[]): Promise<PairingViolation[]> {
+    if (units.length < 2) return [];
     const maxDiff = await this.maxPairDiffTons();
     return validate20ftWeightPairing(units, maxDiff);
   }
diff --git a/apps/edr-freight-api/src/modules/bookings/dto/booking-list-summary.dto.ts b/apps/edr-freight-api/src/modules/bookings/dto/booking-list-summary.dto.ts
index 30ca4bdb7..582cde166 100644
--- a/apps/edr-freight-api/src/modules/bookings/dto/booking-list-summary.dto.ts
+++ b/apps/edr-freight-api/src/modules/bookings/dto/booking-list-summary.dto.ts
@@ -1,4 +1,5 @@
 import { ApiProperty } from '@nestjs/swagger';
+import { FacetBucket } from '../../../common/utils/facets.util';
 
 export class BookingListSummaryMetricsDto {
   @ApiProperty({ example: 42 })
@@ -31,4 +32,18 @@ export class BookingListSummaryDto {
 
   @ApiProperty({ type: BookingListSummaryTabsDto })
   tabs!: BookingListSummaryTabsDto;
+
+  /**
+   * Per-column value counts for the filter bar's enum popovers, scoped to
+   * every OTHER currently-active filter (own predicate omitted per column —
+   * see `BookingsRepository.getFacets`). Unlike `tabs`, which is
+   * deliberately unfiltered so tab counts stay stable while you filter
+   * within a tab, these move with the filter set.
+   */
+  @ApiProperty({
+    description: 'Facet counts keyed by filter field, for the pill filter bar',
+    type: 'object',
+    additionalProperties: { type: 'array', items: { type: 'object' } },
+  })
+  facets!: Record<string, FacetBucket[]>;
 }
diff --git a/apps/edr-freight-api/src/modules/bookings/dto/clearance-charge.dto.ts b/apps/edr-freight-api/src/modules/bookings/dto/clearance-charge.dto.ts
new file mode 100644
index 000000000..f2bf15c0e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/dto/clearance-charge.dto.ts
@@ -0,0 +1,16 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { IsNumber, IsPositive, IsString, Length } from 'class-validator';
+
+export class BillClearanceChargeDto {
+  @ApiProperty({ example: 12500.5 })
+  @Type(() => Number)
+  @IsNumber()
+  @IsPositive()
+  amount!: number;
+
+  @ApiProperty({ example: 'ETB' })
+  @IsString()
+  @Length(3, 8)
+  currency!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/dto/contract-view.dto.ts b/apps/edr-freight-api/src/modules/bookings/dto/contract-view.dto.ts
index 0dceadf43..0491969ed 100644
--- a/apps/edr-freight-api/src/modules/bookings/dto/contract-view.dto.ts
+++ b/apps/edr-freight-api/src/modules/bookings/dto/contract-view.dto.ts
@@ -12,6 +12,12 @@ export class ContractSignatureDto {
 
   @ApiPropertyOptional()
   signatureImageUrl?: string | null;
+
+  @ApiPropertyOptional({
+    description:
+      'Company seal beside the signature. Set for the EDR (STAFF) side from the single global company stamp; null for the client side.',
+  })
+  stampImageUrl?: string | null;
 }
 
 export class SavedSignatureViewDto {
diff --git a/apps/edr-freight-api/src/modules/bookings/dto/filter-booking.dto.ts b/apps/edr-freight-api/src/modules/bookings/dto/filter-booking.dto.ts
index 2d3297af8..4ffde3d0d 100644
--- a/apps/edr-freight-api/src/modules/bookings/dto/filter-booking.dto.ts
+++ b/apps/edr-freight-api/src/modules/bookings/dto/filter-booking.dto.ts
@@ -47,6 +47,11 @@ export class FilterBookingDto {
   @IsUUID()
   companyProfileId?: string;
 
+  @ApiPropertyOptional({ format: 'uuid', description: 'Filter bookings drawn down under this contract' })
+  @IsOptional()
+  @IsUUID()
+  contractId?: string;
+
   @ApiPropertyOptional()
   @IsOptional()
   contractType?: string;
@@ -106,6 +111,14 @@ export class FilterBookingDto {
   @IsIn(['true', 'false'])
   isGovernment?: 'true' | 'false';
 
+  @ApiPropertyOptional({
+    enum: ['SHIPPING_LINE', 'CUSTOMER'],
+    description: 'Who booked: a shipping line (owned by shipping_line_company_id) or an ordinary customer company',
+  })
+  @IsOptional()
+  @IsIn(['SHIPPING_LINE', 'CUSTOMER'])
+  customerKind?: 'SHIPPING_LINE' | 'CUSTOMER';
+
   @ApiPropertyOptional({
     enum: ['true', 'false'],
     description: 'Filter customs vs self-clearance (non-customs) bookings',
@@ -135,7 +148,7 @@ export class FilterBookingDto {
 
   @ApiPropertyOptional({
     description:
-      'Free-text search across booking reference, company name, and contract reference.',
+      'Free-text search across booking reference, customer / shipping-line company name, and contract reference.',
   })
   @IsOptional()
   @Transform(({ value }) =>
diff --git a/apps/edr-freight-api/src/modules/bookings/dto/request-changes.dto.ts b/apps/edr-freight-api/src/modules/bookings/dto/request-changes.dto.ts
index 63ad5b9f4..9631def73 100644
--- a/apps/edr-freight-api/src/modules/bookings/dto/request-changes.dto.ts
+++ b/apps/edr-freight-api/src/modules/bookings/dto/request-changes.dto.ts
@@ -125,3 +125,59 @@ export class OperationReviewDto {
   @IsString()
   note?: string;
 }
+
+/**
+ * A staff decision applied to BOTH halves of a consolidated pair. The two
+ * bookings share a wagon, so they advance or cancel together — never one alone.
+ */
+export class PairedDecisionDto {
+  @ApiProperty({
+    enum: ["accept", "cancel", "operationAccept", "requestChanges"],
+    description: 'Which staff decision to apply to both bookings.',
+  })
+  @IsIn(["accept", "cancel", "operationAccept", "requestChanges"])
+  decision!: "accept" | "cancel" | "operationAccept" | "requestChanges";
+
+  @ApiPropertyOptional({ description: "Cancellation reason (decision=cancel)." })
+  @IsOptional()
+  @IsString()
+  reason?: string;
+
+  @ApiPropertyOptional({
+    description: "Message to the customer (decision=requestChanges).",
+  })
+  @IsOptional()
+  @IsString()
+  note?: string;
+
+  @ApiPropertyOptional({
+    description: "Contract validity window in days (decision=accept).",
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  validityDays?: number;
+}
+
+/** Approve a shared-wagon pairing. The note is optional context for the audit. */
+export class ApproveConsolidationDto {
+  @ApiPropertyOptional({
+    description: "Optional note recorded with the approval.",
+    maxLength: 500,
+  })
+  @IsOptional()
+  @IsString()
+  note?: string;
+}
+
+/** Reject a shared-wagon pairing. A reason is mandatory — GL has to act on it. */
+export class RejectConsolidationDto {
+  @ApiProperty({
+    description:
+      "Why the pairing is rejected. Sent back to GL on both bookings.",
+    maxLength: 500,
+  })
+  @IsString()
+  @MinLength(1)
+  reason!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/dto/set-export-handover-mode.dto.ts b/apps/edr-freight-api/src/modules/bookings/dto/set-export-handover-mode.dto.ts
new file mode 100644
index 000000000..c2685cba0
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/dto/set-export-handover-mode.dto.ts
@@ -0,0 +1,15 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsIn } from 'class-validator';
+
+import { DIRECT_TO_TRAIN, WAREHOUSE } from '../../../common/export-received-gate';
+
+export class SetExportHandoverModeDto {
+  @ApiProperty({
+    enum: [DIRECT_TO_TRAIN, WAREHOUSE],
+    description:
+      'DIRECT_TO_TRAIN — the customer truck loads straight onto the wagon (no warehouse, no GRN). ' +
+      'WAREHOUSE — received at the warehouse and issued a GRN first.',
+  })
+  @IsIn([DIRECT_TO_TRAIN, WAREHOUSE])
+  exportHandoverMode!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/entities/booking-clearance-charge.entity.ts b/apps/edr-freight-api/src/modules/bookings/entities/booking-clearance-charge.entity.ts
new file mode 100644
index 000000000..8530ad11e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/entities/booking-clearance-charge.entity.ts
@@ -0,0 +1,68 @@
+import { BaseEntity } from '@edr/api-common';
+import { Column, Entity, Index, JoinColumn, ManyToOne } from 'typeorm';
+import { Booking } from './booking.entity';
+
+export const CLEARANCE_CHARGE_TYPES = ['PORT_CHARGES', 'MISCELLANEOUS'] as const;
+export type ClearanceChargeType = (typeof CLEARANCE_CHARGE_TYPES)[number];
+
+export const CLEARANCE_CHARGE_STATUSES = [
+  'DOC_UPLOADED',
+  'BILLED',
+  'SENT',
+  'PAID',
+] as const;
+export type ClearanceChargeStatus = (typeof CLEARANCE_CHARGE_STATUSES)[number];
+
+/**
+ * Post-finalization clearance charge billed to the customer — at most one
+ * PORT_CHARGES and one MISCELLANEOUS row per booking. GL Djibouti uploads the
+ * port-charges document (DOC_UPLOADED); GL Ethiopia sets amount + currency
+ * (BILLED) and issues the invoice (SENT); the billing `clearance_charge.invoice.paid`
+ * event marks it PAID. MISCELLANEOUS is created whole by GL Ethiopia and only
+ * after the port charge is paid.
+ */
+@Entity({ schema: 'freight', name: 'booking_clearance_charge' })
+@Index(['bookingId', 'type'], { unique: true })
+export class BookingClearanceCharge extends BaseEntity {
+  @Column({ name: 'booking_id', type: 'uuid' })
+  bookingId!: string;
+
+  @ManyToOne(() => Booking, { onDelete: 'CASCADE' })
+  @JoinColumn({ name: 'booking_id' })
+  booking?: Booking;
+
+  @Column({ name: 'type', type: 'varchar', length: 20 })
+  type!: ClearanceChargeType;
+
+  @Column({ name: 'status', type: 'varchar', length: 20, default: 'DOC_UPLOADED' })
+  status!: ClearanceChargeStatus;
+
+  /** The supporting charge document (FileRecord). */
+  @Column({ name: 'file_record_id', type: 'uuid', nullable: true })
+  fileRecordId?: string | null;
+
+  @Column({ name: 'amount', type: 'numeric', precision: 14, scale: 2, nullable: true })
+  amount?: string | null;
+
+  @Column({ name: 'currency', type: 'varchar', length: 8, nullable: true })
+  currency?: string | null;
+
+  /** The payable invoice issued for this charge (null until SENT). */
+  @Column({ name: 'invoice_id', type: 'uuid', nullable: true })
+  invoiceId?: string | null;
+
+  @Column({ name: 'uploaded_by_staff_id', type: 'uuid', nullable: true })
+  uploadedByStaffId?: string | null;
+
+  @Column({ name: 'uploaded_at', type: 'timestamptz', nullable: true })
+  uploadedAt?: Date | null;
+
+  @Column({ name: 'billed_by_staff_id', type: 'uuid', nullable: true })
+  billedByStaffId?: string | null;
+
+  @Column({ name: 'billed_at', type: 'timestamptz', nullable: true })
+  billedAt?: Date | null;
+
+  @Column({ name: 'paid_at', type: 'timestamptz', nullable: true })
+  paidAt?: Date | null;
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/entities/booking-clearance-event.entity.ts b/apps/edr-freight-api/src/modules/bookings/entities/booking-clearance-event.entity.ts
new file mode 100644
index 000000000..247ea12a6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/entities/booking-clearance-event.entity.ts
@@ -0,0 +1,48 @@
+import { BaseEntity } from '@edr/api-common';
+import { Column, Entity, Index, JoinColumn, ManyToOne } from 'typeorm';
+import { Booking } from './booking.entity';
+
+export const CLEARANCE_EVENT_ACTOR_TYPES = ['STAFF', 'CUSTOMER', 'SYSTEM'] as const;
+export type ClearanceEventActorType = (typeof CLEARANCE_EVENT_ACTOR_TYPES)[number];
+
+/**
+ * One row per action in a booking's clearance flow — the History tab's source
+ * of truth. Written explicitly (and, where the caller runs one, inside the
+ * caller's transaction) by every clearance mutation: document review, phased
+ * workflow steps (transit, declaration, duty, DO/RO, permits), and customer
+ * charges. `action` is a stable machine code; `label` is the human sentence
+ * rendered as written, so old rows survive later wording changes.
+ */
+@Entity({ schema: 'freight', name: 'booking_clearance_event' })
+@Index(['bookingId', 'createdAt'])
+export class BookingClearanceEvent extends BaseEntity {
+  @Column({ name: 'booking_id', type: 'uuid' })
+  bookingId!: string;
+
+  @ManyToOne(() => Booking, { onDelete: 'CASCADE' })
+  @JoinColumn({ name: 'booking_id' })
+  booking?: Booking;
+
+  /** Stable machine code, e.g. DOC_APPROVED, DECLARATION_UPLOADED. */
+  @Column({ name: 'action', type: 'varchar', length: 64 })
+  action!: string;
+
+  /** Human sentence shown in the History tab, frozen at write time. */
+  @Column({ name: 'label', type: 'varchar', length: 500 })
+  label!: string;
+
+  @Column({ name: 'actor_type', type: 'varchar', length: 16, default: 'STAFF' })
+  actorType!: ClearanceEventActorType;
+
+  /** IAM user id of the actor (null for SYSTEM events). */
+  @Column({ name: 'actor_id', type: 'uuid', nullable: true })
+  actorId?: string | null;
+
+  /** Display name resolved at write time (iam.users); null when unresolvable. */
+  @Column({ name: 'actor_name', type: 'varchar', length: 150, nullable: true })
+  actorName?: string | null;
+
+  /** Action details: fileKey, note, amount, currency, file names, … */
+  @Column({ name: 'metadata', type: 'jsonb', nullable: true })
+  metadata?: Record<string, unknown> | null;
+}
diff --git a/apps/edr-freight-api/src/modules/bookings/entities/booking.entity.ts b/apps/edr-freight-api/src/modules/bookings/entities/booking.entity.ts
index 3d339fa19..c85e15cfb 100644
--- a/apps/edr-freight-api/src/modules/bookings/entities/booking.entity.ts
+++ b/apps/edr-freight-api/src/modules/bookings/entities/booking.entity.ts
@@ -58,6 +58,10 @@ export const BOOKING_STATUSES = [
   // the booking enters the batch holding pool.
   'OPERATION_REQUEST_PENDING',
   'OPERATION_CHANGES_REQUESTED',
+  // Shared-wagon review gate: a consolidated pair waits for a human decision
+  // before either half reaches Operations. Two customers' cargo on one wagon is
+  // a commercial call, so it is never auto-advanced.
+  'CONSOLIDATION_APPROVAL_PENDING',
   'OPERATION_PRICE_PENDING_CONFIRM',
 ] as const;
 
@@ -108,15 +112,34 @@ export class Booking extends BaseEntity {
   // @JoinColumn({ name: 'customer_id' })
   // customer?: Customer;
 
-  // Every booking is billed to a company — government bookings bill to a seeded
-  // government company (companies.kind = 'government'). Enforced NOT NULL.
-  @Column({ name: 'company_id', type: 'uuid' })
+  // Every CUSTOMER booking is billed to a company — government bookings bill to
+  // a seeded government company (companies.kind = 'government'). NULL only on a
+  // shipping-line booking, owned by `shippingLineCompanyId` instead; a DB CHECK
+  // enforces that exactly one of the two is set.
+  @Column({ name: 'company_id', type: 'uuid', nullable: true })
   companyId!: string;
 
   @ManyToOne(() => Company, { nullable: true })
   @JoinColumn({ name: 'company_id' })
   company?: Company | null;
 
+  /**
+   * The shipping-line ACCOUNT that owns this booking, when it is not a
+   * customer's. Shipping lines book without a contract and are not `companies`
+   * rows (no TIN, licence or operational profiles), so they get their own owner
+   * column rather than a synthetic company. NULL on every customer booking.
+   *
+   * Deliberately NOT `shippingLineId` above: that is cargo metadata naming the
+   * carrier line that moves the goods (`freight.shipping_lines`, reference data
+   * set on customer bookings too). This points at `shipping_line_companies` —
+   * the portal account — and the two are unrelated.
+   *
+   * No relation is declared: `ShippingLineCompany` lives in its own module and
+   * the column is read by id, matching how the migration leaves it FK-free.
+   */
+  @Column({ name: 'shipping_line_company_id', type: 'uuid', nullable: true })
+  shippingLineCompanyId?: string | null;
+
   /**
    * The operational profile (importer/exporter/forwarder) this booking belongs
    * to. Stamped at creation from the booking's trade direction (IMPORT→importer,
@@ -125,7 +148,9 @@ export class Booking extends BaseEntity {
    * commercial bookings resolve it from trade direction / active mode;
    * government bookings carry the explicitly-picked government profile.
    */
-  @Column({ name: 'company_profile_id', type: 'uuid' })
+  // NULL only on a shipping-line booking — shipping lines have no operational
+  // profiles. Always set on a customer booking, as before.
+  @Column({ name: 'company_profile_id', type: 'uuid', nullable: true })
   companyProfileId!: string;
 
   @ManyToOne(() => CompanyProfile, { nullable: true })
@@ -259,7 +284,7 @@ export class Booking extends BaseEntity {
   @Column({ name: 'contract_type', type: 'varchar', length: 20 })
   contractType!: string;
 
-  @Column({ name: 'service_type_id', type: 'uuid' })
+  @Column({ name: 'service_type_id', type: 'uuid', nullable: true })
   serviceTypeId!: string;
 
   @ManyToOne(() => ServiceType)
@@ -302,6 +327,18 @@ export class Booking extends BaseEntity {
   @Column({ name: 'customer_truck_arrived_at', type: 'timestamptz', nullable: true })
   customerTruckArrivedAt?: Date | null;
 
+  /**
+   * EXPORT only. How the cargo reaches the train:
+   *  - DIRECT_TO_TRAIN — the customer's truck loads straight onto the wagon. No
+   *    warehouse, so no GRN is ever raised and the carriage acceptance sheet is
+   *    the only document handed over.
+   *  - WAREHOUSE (also null) — received into the warehouse and GRN'd first.
+   *
+   * Null is treated as WAREHOUSE so existing bookings keep the GRN gate.
+   */
+  @Column({ name: 'export_handover_mode', type: 'varchar', length: 20, nullable: true })
+  exportHandoverMode?: string | null;
+
   /**
    * Did the goods need re-handling in the warehouse? Recorded by warehouse
    * staff after unloading. Only `true` bills the DOUBLE_HANDLING_FEE rule;
@@ -325,14 +362,14 @@ export class Booking extends BaseEntity {
   @Column({ name: 'equipment_return', type: 'varchar', length: 20 })
   equipmentReturn!: string;
 
-  @Column({ name: 'origin_yard_id', type: 'uuid' })
+  @Column({ name: 'origin_yard_id', type: 'uuid', nullable: true })
   originYardId!: string;
 
   @ManyToOne(() => Yard) 
   @JoinColumn({ name: 'origin_yard_id' })
   originYard?: Yard;
 
-  @Column({ name: 'destination_yard_id', type: 'uuid' })
+  @Column({ name: 'destination_yard_id', type: 'uuid', nullable: true })
   destinationYardId!: string;
 
   @ManyToOne(() => Yard)
@@ -342,7 +379,7 @@ export class Booking extends BaseEntity {
   @Column({ name: 'trade_direction', type: 'varchar', length: 10 })
   tradeDirection!: string;
 
-  @Column({ name: 'freight_type', type: 'varchar', length: 20 })
+  @Column({ name: 'freight_type', type: 'varchar', length: 20, nullable: true })
   freightType!: string;
 
   @Column({ name: 'cargo_type_id', type: 'uuid', nullable: true })
diff --git a/apps/edr-freight-api/src/modules/bookings/entities/consolidation-approval.entity.ts b/apps/edr-freight-api/src/modules/bookings/entities/consolidation-approval.entity.ts
new file mode 100644
index 000000000..91c3dcdee
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/bookings/entities/consolidation-approval.entity.ts
@@ -0,0 +1,98 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+
+import { Booking } from "./booking.entity";
+
+export enum ConsolidationApprovalStatus {
+  Pending = "PENDING",
+  Approved = "APPROVED",
+  Rejected = "REJECTED",
+}
+
+/**
+ * Approval gate for a consolidated (shared-wagon) booking pair.
+ *
+ * A booking that fills its own wagons goes straight from GL completion to the
+ * operations queue. A consolidated one does not: two customers' cargo rides one
+ * physical wagon, under two separate invoices and two separate liabilities. That
+ * pairing is a commercial decision, so a person reviews it before Operations
+ * sees either half.
+ *
+ * The pair is approved as a UNIT — one row covers both halves — so nobody can
+ * approve one side of a shared wagon and leave the other pending. Rows are never
+ * deleted: decided rows are the audit trail of who approved which pairing, when,
+ * and why.
+ */
+@Entity({ schema: "freight", name: "consolidation_approvals" })
+@Index(["bookingId", "status"])
+@Index(["status"])
+export class ConsolidationApproval extends BaseEntity {
+  @Column({ name: "booking_id", type: "uuid" })
+  bookingId!: string;
+
+  @ManyToOne(() => Booking)
+  @JoinColumn({ name: "booking_id" })
+  booking?: Booking;
+
+  /** The other half of the shared wagon. */
+  @Column({ name: "partner_booking_id", type: "uuid" })
+  partnerBookingId!: string;
+
+  @ManyToOne(() => Booking)
+  @JoinColumn({ name: "partner_booking_id" })
+  partnerBooking?: Booking;
+
+  @Column({
+    name: "status",
+    type: "enum",
+    enum: ConsolidationApprovalStatus,
+    default: ConsolidationApprovalStatus.Pending,
+  })
+  status!: ConsolidationApprovalStatus;
+
+  /** IAM user id of the GL staff whose completion created the pairing. */
+  @Column({ name: "requested_by", type: "uuid", nullable: true })
+  requestedBy?: string | null;
+
+  @Column({ name: "requested_at", type: "timestamptz", default: () => "now()" })
+  requestedAt!: Date;
+
+  /** IAM user id of the approver; null while pending. */
+  @Column({ name: "decided_by", type: "uuid", nullable: true })
+  decidedBy?: string | null;
+
+  @Column({ name: "decided_at", type: "timestamptz", nullable: true })
+  decidedAt?: Date | null;
+
+  /** Why it was approved or rejected. Required on reject, optional on approve. */
+  @Column({
+    name: "decision_note",
+    type: "varchar",
+    length: 500,
+    nullable: true,
+  })
+  decisionNote?: string | null;
+
+  // ── Snapshot ──────────────────────────────────────────────────────────────
+  // Copied at request time so the audit trail still reads correctly after the
+  // bookings themselves move on (rebooked to another day, cancelled, renamed).
+
+  @Column({ name: "scheduled_date", type: "timestamptz", nullable: true })
+  scheduledDate?: Date | null;
+
+  @Column({
+    name: "booking_reference",
+    type: "varchar",
+    length: 50,
+    nullable: true,
+  })
+  bookingReference?: string | null;
+
+  @Column({
+    name: "partner_booking_reference",
+    type: "varchar",
+    length: 50,
+    nullable: true,
+  })
+  partnerBookingReference?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/chat/chat-bridge.service.ts b/apps/edr-freight-api/src/modules/chat/chat-bridge.service.ts
new file mode 100644
index 000000000..75bbe9a29
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/chat-bridge.service.ts
@@ -0,0 +1,73 @@
+import { Inject, Injectable, Logger } from '@nestjs/common';
+import type { ConfigType } from '@nestjs/config';
+import { NotificationType, type NotifyInput } from '@edr/types';
+
+import chatConfig from '../../config/chat.config';
+import { MatrixClient } from './matrix.client';
+
+const FALLBACK_ROOM = { alias: 'freight-alerts', name: 'Freight Alerts' };
+
+/**
+ * Best-effort per-type routing to an existing dept room. Anything not listed
+ * (including GENERIC) falls through to #freight-alerts — safer than a wrong
+ * guess at which department a type belongs to. Extend as real usage shows
+ * which types actually want a dept room instead of the shared feed.
+ *
+ * `name` matters only if this bridge is the very first thing to touch that
+ * alias (normally the nightly/on-demand reconcile creates dept rooms first,
+ * with the position's real name) — ensureRoom never renames an existing
+ * room, so this must match what ChatProvisioningService would have used.
+ */
+const ROOM_FOR_TYPE: Partial<Record<NotificationType, { alias: string; name: string }>> = {
+  [NotificationType.REQUEST_SUBMITTED]: { alias: 'dept-operation', name: 'Operation' },
+  [NotificationType.CLEARANCE_REVIEW]: { alias: 'dept-operation', name: 'Operation' },
+};
+
+/**
+ * Mirrors BACKOFFICE-audience notifications into chat so staff see them
+ * without having the inbox open. Hooked once into
+ * NotificationInboxService.notify() — every one of that service's ~20
+ * callers gets this for free.
+ *
+ * Gated on BACKOFFICE only: notify() also serves PORTAL (customer)
+ * notifications, which must never land in an internal staff room.
+ */
+@Injectable()
+export class ChatBridgeService {
+  private readonly logger = new Logger(ChatBridgeService.name);
+
+  constructor(
+    @Inject(chatConfig.KEY)
+    private readonly config: ConfigType<typeof chatConfig>,
+    private readonly matrix: MatrixClient,
+  ) {}
+
+  async bridge(input: NotifyInput): Promise<void> {
+    if (!this.config.enabled) return;
+
+    try {
+      const room = ROOM_FOR_TYPE[input.type] ?? FALLBACK_ROOM;
+      const roomId = await this.matrix.ensureRoom(room.alias, room.name);
+      const body = input.link ? `${input.title}\n${input.body}\n${input.link}` : `${input.title}\n${input.body}`;
+      const html = `<strong>${escapeHtml(input.title)}</strong><br/>${escapeHtml(input.body)}${
+        input.link ? `<br/><a href="${escapeHtml(input.link)}">${escapeHtml(input.link)}</a>` : ''
+      }`;
+      await this.matrix.sendMessage(roomId, body, html);
+    } catch (err) {
+      // Same contract as NotificationInboxService.notify(): a chat-bridge
+      // failure must never break or roll back the notification that
+      // triggered it.
+      this.logger.error(
+        `Chat bridge failed for ${input.type}: ${(err as Error).message}`,
+      );
+    }
+  }
+}
+
+function escapeHtml(s: string): string {
+  return s
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
diff --git a/apps/edr-freight-api/src/modules/chat/chat-provisioning.service.ts b/apps/edr-freight-api/src/modules/chat/chat-provisioning.service.ts
new file mode 100644
index 000000000..b122d8073
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/chat-provisioning.service.ts
@@ -0,0 +1,237 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { Cron, CronExpression } from '@nestjs/schedule';
+import { InjectDataSource } from '@nestjs/typeorm';
+import { DataSource } from 'typeorm';
+
+import { MatrixClient } from './matrix.client';
+
+/** edr-org.seeder.ts's EDR_ORG_KEY / EDR_UNIT_KEY — the org is currently flat
+ *  (one org, one unit), so this is the entire scope of what gets provisioned. */
+const ORG_KEY = 'edr_freight';
+const UNIT_KEY = 'edr_freight_app';
+
+const SPACE_ALIAS = 'edr-freight';
+const GENERAL_ALIAS = 'general';
+
+interface PositionHolder {
+  positionKey: string;
+  positionName: string;
+  userId: string;
+  userName: string;
+}
+
+export interface ReconcileResult {
+  rooms: number;
+  joined: number;
+  kicked: number;
+  deactivated: number;
+}
+
+/**
+ * Keeps Matrix rooms and their membership in sync with IAM's unit/position
+ * tree. There is no local hook on "employee position changed" — IAM writes
+ * happen inside the vendored @tria-plc/iamapi-common package — so this is a
+ * reconcile loop, not an event handler: nightly, plus on-demand via
+ * POST /chat/sync.
+ *
+ * Room identity is a deterministic alias (#dept-<positionKey>), not a stored
+ * mapping table — resolved via the directory API, created on first miss.
+ * Room membership is diffed against Matrix's own joined_members, not a local
+ * snapshot — so a user removed from IAM disappears from chat on the very
+ * next reconcile, with no extra state for this service to own.
+ */
+@Injectable()
+export class ChatProvisioningService {
+  private readonly logger = new Logger(ChatProvisioningService.name);
+
+  constructor(
+    @InjectDataSource() private readonly dataSource: DataSource,
+    private readonly matrix: MatrixClient,
+  ) {}
+
+  @Cron(CronExpression.EVERY_DAY_AT_3AM, { name: 'chat-provisioning-reconcile' })
+  async scheduledReconcile(): Promise<void> {
+    try {
+      const result = await this.reconcile();
+      this.logger.log(
+        `Chat reconcile: ${result.rooms} room(s), ${result.joined} joined, ` +
+          `${result.kicked} kicked, ${result.deactivated} deactivated`,
+      );
+    } catch (err) {
+      // Never throws into the scheduler — chat provisioning must not be able
+      // to take down anything else on the cron registry.
+      this.logger.error(
+        `Chat reconcile failed: ${(err as Error).message}`,
+        (err as Error).stack,
+      );
+    }
+  }
+
+  /** Every current holder in the unit, or just one person's rows when `userId` is given. */
+  private async currentHolders(userId?: string): Promise<PositionHolder[]> {
+    return this.dataSource.query(
+      `SELECT p.key AS "positionKey",
+              COALESCE(p.name->>'en', p.key) AS "positionName",
+              e.user_id AS "userId",
+              COALESCE(iu.name->>'en', iu.username, iu.email) AS "userName"
+         FROM iam.employee_positions ep
+         JOIN iam.employees e ON e.id = ep.employee_id
+         JOIN iam.positions p ON p.id = ep.position_id
+         JOIN iam.units u ON u.id = p.unit_id
+         JOIN iam.organizations o ON o.id = u.organization_id
+         JOIN iam.users iu ON iu.id = e.user_id
+        WHERE ep.is_current = true
+          AND e.is_current = true
+          AND o.key = $1
+          AND u.key = $2
+          ${userId ? 'AND e.user_id = $3' : ''}`,
+      userId ? [ORG_KEY, UNIT_KEY, userId] : [ORG_KEY, UNIT_KEY],
+    );
+  }
+
+  /**
+   * Put one person in their rooms right now.
+   *
+   * {@link reconcile} is nightly, so without this a new employee's first
+   * sign-in shows an empty client until 3AM — the SSO handoff creates their
+   * account but joins them to nothing. Called on every /chat/sso, so it is
+   * scoped to the one user (a full reconcile per click would be a room-count
+   * multiple of Matrix calls) and every step is get-or-create.
+   *
+   * Someone holding no current position in the unit joins nothing, by the same
+   * rule the reconcile uses — chat membership follows the org tree.
+   */
+  async joinUserRooms(userId: string, displayName: string): Promise<number> {
+    const positions = await this.currentHolders(userId);
+    if (positions.length === 0) return 0;
+
+    const mxid = this.matrix.mxidFor(userId, displayName);
+    // The JWT login auto-registers too, but that happens after this runs and
+    // the admin join API 404s on an account that does not exist yet.
+    await this.matrix.ensureUser(mxid, displayName);
+
+    const spaceId = await this.matrix.ensureRoom(SPACE_ALIAS, 'EDR Freight', {
+      isSpace: true,
+    });
+    const generalRoomId = await this.matrix.ensureRoom(GENERAL_ALIAS, 'General', {
+      parentSpaceId: spaceId,
+    });
+    await this.matrix.ensureJoined(generalRoomId, mxid);
+
+    for (const position of positions) {
+      const roomId = await this.matrix.ensureRoom(
+        `dept-${position.positionKey}`,
+        position.positionName,
+        { parentSpaceId: spaceId },
+      );
+      await this.matrix.ensureJoined(roomId, mxid);
+    }
+
+    return positions.length + 1;
+  }
+
+  /** Force-joins additions, kicks+deactivates users no longer entitled anywhere. */
+  private async syncMembership(
+    roomId: string,
+    desiredUserIds: Set<string>,
+    botMxid: string,
+  ): Promise<{ joined: number; kicked: string[] }> {
+    const current = await this.matrix.joinedMembers(roomId);
+    const currentSet = new Set(current.filter((id) => id !== botMxid));
+
+    let joined = 0;
+    for (const userId of desiredUserIds) {
+      if (!currentSet.has(userId)) {
+        await this.matrix.ensureJoined(roomId, userId);
+        joined += 1;
+      }
+    }
+
+    const kicked: string[] = [];
+    for (const userId of currentSet) {
+      if (!desiredUserIds.has(userId)) {
+        await this.matrix.kick(roomId, userId, 'No longer assigned to this room');
+        kicked.push(userId);
+      }
+    }
+
+    return { joined, kicked };
+  }
+
+  async reconcile(): Promise<ReconcileResult> {
+    const holders = await this.currentHolders();
+    const botMxid = await this.matrix.whoami();
+
+    const spaceId = await this.matrix.ensureRoom(SPACE_ALIAS, 'EDR Freight', {
+      isSpace: true,
+    });
+    const generalRoomId = await this.matrix.ensureRoom(GENERAL_ALIAS, 'General', {
+      parentSpaceId: spaceId,
+    });
+
+    const allUserIds = new Set(
+      holders.map((h) => this.matrix.mxidFor(h.userId, h.userName)),
+    );
+
+    // Accounts are otherwise only created lazily on first JWT login (see
+    // ChatSsoService) — force-joining someone who has never clicked "Chat"
+    // yet 404s ("User not found") without this.
+    const seenUserIds = new Set<string>();
+    for (const h of holders) {
+      const mxid = this.matrix.mxidFor(h.userId, h.userName);
+      if (seenUserIds.has(mxid)) continue;
+      seenUserIds.add(mxid);
+      await this.matrix.ensureUser(mxid, h.userName);
+    }
+
+    let rooms = 2; // space + general
+    let joined = 0;
+    let kicked = 0;
+    // A user kicked from anything while holding zero current positions
+    // anywhere in the unit (allUserIds spans every position) is a full
+    // leaver, not just moved between positions — deactivate their account.
+    const kickedUserIds = new Set<string>();
+
+    const generalDiff = await this.syncMembership(generalRoomId, allUserIds, botMxid);
+    joined += generalDiff.joined;
+    kicked += generalDiff.kicked.length;
+    generalDiff.kicked.forEach((uid) => kickedUserIds.add(uid));
+
+    const byPosition = new Map<string, { name: string; userIds: Set<string> }>();
+    for (const h of holders) {
+      const entry = byPosition.get(h.positionKey) ?? {
+        name: h.positionName,
+        userIds: new Set<string>(),
+      };
+      entry.userIds.add(this.matrix.mxidFor(h.userId, h.userName));
+      byPosition.set(h.positionKey, entry);
+    }
+
+    for (const [positionKey, { name, userIds }] of byPosition) {
+      const roomId = await this.matrix.ensureRoom(`dept-${positionKey}`, name, {
+        parentSpaceId: spaceId,
+      });
+      rooms += 1;
+
+      const diff = await this.syncMembership(roomId, userIds, botMxid);
+      joined += diff.joined;
+      kicked += diff.kicked.length;
+      diff.kicked.forEach((uid) => kickedUserIds.add(uid));
+    }
+
+    let deactivated = 0;
+    for (const userId of kickedUserIds) {
+      if (allUserIds.has(userId)) continue; // moved position, still current elsewhere
+      try {
+        await this.matrix.deactivateUser(userId);
+        deactivated += 1;
+      } catch (err) {
+        this.logger.warn(
+          `Failed to deactivate departed user ${userId}: ${(err as Error).message}`,
+        );
+      }
+    }
+
+    return { rooms, joined, kicked, deactivated };
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/chat/chat-sso.service.ts b/apps/edr-freight-api/src/modules/chat/chat-sso.service.ts
new file mode 100644
index 000000000..22edb8e1c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/chat-sso.service.ts
@@ -0,0 +1,91 @@
+import { Inject, Injectable, Logger } from '@nestjs/common';
+import type { ConfigType } from '@nestjs/config';
+import type { TCurrentUser } from '@tria-plc/api-common/modules/auth/types/current-user.type';
+import { SignJWT } from 'jose';
+
+import chatConfig from '../../config/chat.config';
+import { ChatProvisioningService } from './chat-provisioning.service';
+import { MatrixClient, chatLocalpart } from './matrix.client';
+
+/** Long enough for one login call, short enough to be worthless if it leaks. */
+const JWT_TTL_SECONDS = 60;
+
+function displayName(user: TCurrentUser): string {
+  return (
+    user.name?.en ||
+    Object.values(user.name ?? {}).find((v) => typeof v === 'string' && v) ||
+    user.username ||
+    user.email
+  );
+}
+
+/**
+ * The SSO handoff: turn an already-authenticated freight session into a
+ * one-click Element sign-in link, with no second password anywhere.
+ *
+ *   1. Sign a short-lived JWT asserting this user's id (Synapse's
+ *      org.matrix.login.jwt auto-registers the account on first use).
+ *   2. Trade that JWT for a real Matrix session.
+ *   3. Hand the caller a link to Element's sso.html shim, which writes that
+ *      session into localStorage and drops the user straight into Element.
+ *
+ * Step 3 used to mint a one-shot login_token and let Element redeem it. That
+ * path is capped at one request per user per minute by a limiter hardcoded in
+ * Synapse, so a second click inside a minute returned M_LIMIT_EXCEEDED — and a
+ * spent token surfaces in Element as "Incorrect username and/or password".
+ * Element accepts a plaintext token out of localStorage (Lifecycle.ts
+ * getStoredToken/tryDecryptToken), so handing over the session we already hold
+ * removes both failure modes and one round-trip.
+ */
+@Injectable()
+export class ChatSsoService {
+  private readonly logger = new Logger(ChatSsoService.name);
+
+  constructor(
+    @Inject(chatConfig.KEY)
+    private readonly config: ConfigType<typeof chatConfig>,
+    private readonly matrix: MatrixClient,
+    private readonly provisioning: ChatProvisioningService,
+  ) {}
+
+  async getSsoUrl(user: TCurrentUser): Promise<{ url: string }> {
+    const secret = new TextEncoder().encode(this.config.jwtSecret);
+    const name = displayName(user);
+
+    // Before the link, not after: the reconcile that fills rooms is nightly, so
+    // a first sign-in would otherwise open an empty client. Best-effort —
+    // failing to join a room is no reason to refuse someone a sign-in link.
+    try {
+      await this.provisioning.joinUserRooms(user.id, name);
+    } catch (err) {
+      this.logger.error(
+        `Room join on sign-in failed for ${user.id}: ${(err as Error).message}`,
+      );
+    }
+    // Synapse takes the localpart straight from `sub` on auto-registration, so
+    // this must be byte-identical to what ChatProvisioningService derives for
+    // the same person — otherwise SSO signs them into one account while the
+    // reconcile force-joins a different one into the rooms.
+    const jwt = await new SignJWT({ name })
+      .setProtectedHeader({ alg: 'HS256' })
+      .setSubject(chatLocalpart(user.id, name))
+      .setIssuer('edr-freight-api')
+      .setAudience('matrix')
+      .setIssuedAt()
+      .setExpirationTime(`${JWT_TTL_SECONDS}s`)
+      .sign(secret);
+
+    const session = await this.matrix.loginWithJwt(jwt);
+
+    // Session goes in the URL fragment, never the query: a fragment is not sent
+    // to any server, so the token stays out of Element's access log, and
+    // sso.html replaces the entry so it does not linger in history either.
+    const params = new URLSearchParams({
+      hs: this.config.publicBaseUrl,
+      t: session.access_token,
+      u: session.user_id,
+      d: session.device_id,
+    });
+    return { url: `${this.config.webUrl}/sso.html#${params.toString()}` };
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/chat/chat.controller.ts b/apps/edr-freight-api/src/modules/chat/chat.controller.ts
new file mode 100644
index 000000000..0ecca04c0
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/chat.controller.ts
@@ -0,0 +1,35 @@
+import { Controller, Get, Post, UseGuards } from '@nestjs/common';
+import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';
+import { CurrentUser } from '@tria-plc/api-common/modules/auth/decorators/current-user.decorator';
+import { JwtGuard } from '@tria-plc/api-common/modules/auth/services/jwt.guard';
+import type { TCurrentUser } from '@tria-plc/api-common/modules/auth/types/current-user.type';
+
+import { ChatSync } from '../../common/booking-guards';
+import { ChatProvisioningService } from './chat-provisioning.service';
+import { ChatSsoService } from './chat-sso.service';
+
+@ApiTags('chat')
+@Controller('chat')
+@ApiBearerAuth()
+export class ChatController {
+  constructor(
+    private readonly sso: ChatSsoService,
+    private readonly provisioning: ChatProvisioningService,
+  ) {}
+
+  @Get('sso')
+  @UseGuards(JwtGuard)
+  @ApiOperation({ summary: 'One-click sign-in link into EDR internal chat' })
+  getSso(@CurrentUser() user: TCurrentUser) {
+    return this.sso.getSsoUrl(user);
+  }
+
+  @Post('sync')
+  @ChatSync()
+  @ApiOperation({
+    summary: 'Re-run the chat room/membership reconcile immediately (normally nightly)',
+  })
+  sync() {
+    return this.provisioning.reconcile();
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/chat/chat.module.ts b/apps/edr-freight-api/src/modules/chat/chat.module.ts
new file mode 100644
index 000000000..8df827339
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/chat.module.ts
@@ -0,0 +1,16 @@
+import { Module } from '@nestjs/common';
+
+import { ChatBridgeService } from './chat-bridge.service';
+import { ChatController } from './chat.controller';
+import { ChatProvisioningService } from './chat-provisioning.service';
+import { ChatSsoService } from './chat-sso.service';
+import { MatrixClient } from './matrix.client';
+
+@Module({
+  controllers: [ChatController],
+  providers: [MatrixClient, ChatSsoService, ChatProvisioningService, ChatBridgeService],
+  // ChatBridgeService: consumed by NotificationInboxModule to mirror
+  // BACKOFFICE notifications into chat — see notification-inbox.module.ts.
+  exports: [ChatBridgeService],
+})
+export class ChatModule {}
diff --git a/apps/edr-freight-api/src/modules/chat/matrix.client.spec.ts b/apps/edr-freight-api/src/modules/chat/matrix.client.spec.ts
new file mode 100644
index 000000000..ea5faa978
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/matrix.client.spec.ts
@@ -0,0 +1,35 @@
+import { chatLocalpart } from './matrix.client';
+
+describe('chatLocalpart', () => {
+  it('reads from the name, not the id', () => {
+    expect(
+      chatLocalpart('03f5eb9e-23a0-4413-8d98-8de4b98b1be2', 'Nati Wondi'),
+    ).toBe('nati-wondi.03f5eb');
+  });
+
+  it('separates two people who share a name', () => {
+    // Both of these are real dev rows — same name, different employees.
+    const a = chatLocalpart('11111111-1111-4111-8111-111111111111', 'MARKOS REGASA');
+    const b = chatLocalpart('22222222-2222-4222-8222-222222222222', 'Markos  REGASA');
+    expect(a).not.toBe(b);
+  });
+
+  it('is stable for the same person', () => {
+    const id = '7d798218-09de-47a1-98eb-f61ec44e9280';
+    expect(chatLocalpart(id, 'Naod')).toBe(chatLocalpart(id, 'Naod'));
+  });
+
+  it('still yields a usable localpart for a name that slugs to nothing', () => {
+    expect(chatLocalpart('7d798218-09de-47a1-98eb-f61ec44e9280', 'ናኦድ')).toBe(
+      'user.7d7982',
+    );
+  });
+
+  it('only emits characters Matrix accepts in a localpart', () => {
+    for (const name of ['Mubarek Jemal Hassen', "N'gozi  O_Brien", 'ናኦድ', 'José']) {
+      expect(chatLocalpart('7d798218-09de-47a1-98eb-f61ec44e9280', name)).toMatch(
+        /^[a-z0-9._=\-/]+$/,
+      );
+    }
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/chat/matrix.client.ts b/apps/edr-freight-api/src/modules/chat/matrix.client.ts
new file mode 100644
index 000000000..1cd09ac33
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/chat/matrix.client.ts
@@ -0,0 +1,320 @@
+import { Inject, Injectable } from '@nestjs/common';
+import type { ConfigType } from '@nestjs/config';
+
+import chatConfig from '../../config/chat.config';
+
+/**
+ * Thin wrapper over the handful of Matrix Client-Server + Synapse Admin API
+ * calls this app needs. Not a general Matrix SDK — matrix-js-sdk is a
+ * browser/Element concern; the server side only ever provisions rooms/users
+ * and posts bot messages, so a fetch wrapper is the whole job.
+ *
+ * All admin-scoped calls act as the account behind MATRIX_ADMIN_TOKEN. That
+ * same account also posts the notification-bridge messages (see
+ * ChatBridgeService) — one bot/admin account covers both jobs, no separate
+ * bot user needed.
+ */
+/**
+ * Localpart of a staff member's MXID: their name, plus the first 6 hex of
+ * their freight user id.
+ *
+ * The tail is not decoration. Names collide — 19 of the 114 users in the dev
+ * IAM share a slug with someone else ("MARKOS REGASA" and "Markos  REGASA" are
+ * two different people) — and an MXID is permanent, so a bare slug would hand
+ * two employees the same Matrix account and each other's rooms. The id is
+ * already random, so 6 hex of it separates them without a lookup or a mapping
+ * table, and keeps the derivation pure: ChatSsoService (which mints the JWT
+ * `sub`) and ChatProvisioningService (which force-joins rooms) must agree on
+ * this string exactly or they provision two accounts per person.
+ */
+export function chatLocalpart(userId: string, displayName: string): string {
+  const slug = displayName
+    // NFKD splits an accent off its letter; the non-alnum sweep below then
+    // folds the leftover mark into the same `-` run as the neighbouring space.
+    .normalize('NFKD')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 40);
+  // Amharic-only names slug to nothing — the tail still makes it unique.
+  return `${slug || 'user'}.${userId.replace(/-/g, '').slice(0, 6)}`;
+}
+
+@Injectable()
+export class MatrixClient {
+  constructor(
+    @Inject(chatConfig.KEY)
+    private readonly config: ConfigType<typeof chatConfig>,
+  ) {}
+
+  /**
+   * Alias localparts go in a URL path segment, so a `/` in one is fatal:
+   * Synapse decodes the path before routing, and `%2F` splits the request into
+   * a route that doesn't exist ("M_UNRECOGNIZED"). resolveAlias reads that 404
+   * as "no such room" and ensureRoom then tries to create the same broken alias
+   * on every run. Position keys are `edr_freight_app/opn` shaped, so this hits
+   * every dept room but the handful whose key happens to be a bare word.
+   */
+  private static aliasSafe(alias: string): string {
+    return alias.replace(/[^A-Za-z0-9._=-]/g, '-');
+  }
+
+  /** `@<localpart>:<server_name>` — the one place this format is assembled. */
+  mxid(localpart: string): string {
+    return `@${localpart}:${this.config.serverName}`;
+  }
+
+  /** The MXID of a freight user — see {@link chatLocalpart}. */
+  mxidFor(userId: string, displayName: string): string {
+    return this.mxid(chatLocalpart(userId, displayName));
+  }
+
+  get serverName(): string {
+    return this.config.serverName;
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown,
+    token: string = this.config.adminToken,
+  ): Promise<T> {
+    const res = await fetch(`${this.config.baseUrl}${path}`, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${token}`,
+      },
+      body: body === undefined ? undefined : JSON.stringify(body),
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => '');
+      throw new Error(
+        `Matrix ${method} ${path} -> ${res.status}: ${text.slice(0, 500)}`,
+      );
+    }
+    if (res.status === 204) return undefined as T;
+    return (await res.json()) as T;
+  }
+
+  /** No auth — only /login accepts a bare JWT with nothing else on the request. */
+  private async publicRequest<T>(
+    method: string,
+    path: string,
+    body: unknown,
+  ): Promise<T> {
+    const res = await fetch(`${this.config.baseUrl}${path}`, {
+      method,
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => '');
+      throw new Error(
+        `Matrix ${method} ${path} -> ${res.status}: ${text.slice(0, 500)}`,
+      );
+    }
+    return (await res.json()) as T;
+  }
+
+  /** 404 → null. Every other non-2xx still throws via {@link request}. */
+  private async requestOrNull<T>(
+    method: string,
+    path: string,
+    token?: string,
+  ): Promise<T | null> {
+    const res = await fetch(`${this.config.baseUrl}${path}`, {
+      method,
+      headers: { Authorization: `Bearer ${token ?? this.config.adminToken}` },
+    });
+    if (res.status === 404) return null;
+    if (!res.ok) {
+      const text = await res.text().catch(() => '');
+      throw new Error(
+        `Matrix ${method} ${path} -> ${res.status}: ${text.slice(0, 500)}`,
+      );
+    }
+    return (await res.json()) as T;
+  }
+
+  /** Sign an already-authenticated freight session into a Matrix session. */
+  loginWithJwt(
+    jwt: string,
+  ): Promise<{ access_token: string; user_id: string; device_id: string }> {
+    return this.publicRequest('POST', '/_matrix/client/v3/login', {
+      type: 'org.matrix.login.jwt',
+      token: jwt,
+      initial_device_display_name: 'EDR Backoffice',
+    });
+  }
+
+  /** The account behind MATRIX_ADMIN_TOKEN — used to exclude the bot itself from membership reconciliation. */
+  async whoami(): Promise<string> {
+    const res = await this.request<{ user_id: string }>(
+      'GET',
+      '/_matrix/client/v3/account/whoami',
+    );
+    return res.user_id;
+  }
+
+  /** Currently-joined user ids for a room (not full member-event state). */
+  async joinedMembers(roomId: string): Promise<string[]> {
+    const res = await this.request<{ joined: Record<string, unknown> }>(
+      'GET',
+      `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/joined_members`,
+    );
+    return Object.keys(res.joined);
+  }
+
+  // No getLoginToken here on purpose. POST /_matrix/client/v1/login/get_token
+  // is rate limited to 1 request per user per MINUTE, hardcoded in Synapse
+  // (rest/client/login_token_request.py: "Ratelimit aggressively … could be
+  // abused by a malicious client to create many sessions") and not settable
+  // from homeserver.yaml. A second click inside a minute got M_LIMIT_EXCEEDED.
+  // ChatSsoService hands Element the session from loginWithJwt directly
+  // instead, which needs no second call.
+
+  /** null when the alias doesn't resolve to a room yet. */
+  resolveAlias(alias: string): Promise<{ room_id: string } | null> {
+    return this.requestOrNull(
+      'GET',
+      `/_matrix/client/v3/directory/room/${encodeURIComponent(alias)}`,
+    );
+  }
+
+  createRoom(input: {
+    alias: string;
+    name: string;
+    topic?: string;
+    isSpace?: boolean;
+    parentSpaceId?: string;
+  }): Promise<{ room_id: string }> {
+    return this.request('POST', '/_matrix/client/v3/createRoom', {
+      room_alias_name: input.alias,
+      name: input.name,
+      topic: input.topic,
+      preset: 'private_chat',
+      creation_content: input.isSpace ? { type: 'm.space' } : undefined,
+      initial_state: input.parentSpaceId
+        ? [
+            {
+              type: 'm.space.parent',
+              state_key: input.parentSpaceId,
+              content: { via: [this.config.serverName], canonical: true },
+            },
+          ]
+        : undefined,
+    });
+  }
+
+  addToSpace(spaceId: string, childRoomId: string): Promise<void> {
+    return this.request(
+      'PUT',
+      `/_matrix/client/v3/rooms/${encodeURIComponent(spaceId)}/state/m.space.child/${encodeURIComponent(childRoomId)}`,
+      { via: [this.config.serverName] },
+    );
+  }
+
+  /**
+   * Get-or-create by alias — the room identity scheme this whole module
+   * relies on instead of a local id-mapping table. Idempotent: safe to call
+   * on every reconcile run and every bridged notification alike.
+   */
+  async ensureRoom(
+    rawAlias: string,
+    name: string,
+    opts: { isSpace?: boolean; parentSpaceId?: string } = {},
+  ): Promise<string> {
+    const alias = MatrixClient.aliasSafe(rawAlias);
+    const existing = await this.resolveAlias(`#${alias}:${this.config.serverName}`);
+    if (existing) return existing.room_id;
+
+    const { room_id } = await this.createRoom({
+      alias,
+      name,
+      isSpace: opts.isSpace,
+      parentSpaceId: opts.parentSpaceId,
+    });
+    if (opts.parentSpaceId) {
+      await this.addToSpace(opts.parentSpaceId, room_id);
+    }
+    return room_id;
+  }
+
+  /**
+   * Create the account if absent (no password — this deployment is JWT-SSO
+   * only), or no-op if it already exists. Needed before force-joining a
+   * position holder who has never clicked "Chat": accounts are otherwise
+   * only created lazily on first JWT login, and the admin join API 404s
+   * ("User not found") on an account that doesn't exist yet.
+   */
+  async ensureUser(userId: string, displayName?: string): Promise<void> {
+    const existing = await this.requestOrNull<{ name: string }>(
+      'GET',
+      `/_synapse/admin/v2/users/${encodeURIComponent(userId)}`,
+    );
+    if (existing) return;
+    await this.request(
+      'PUT',
+      `/_synapse/admin/v2/users/${encodeURIComponent(userId)}`,
+      displayName ? { displayname: displayName } : {},
+    );
+  }
+
+  /** Server-admin force-join — no invite to accept, works even mid-outage for the invitee. */
+  forceJoin(roomIdOrAlias: string, userId: string): Promise<void> {
+    return this.request(
+      'POST',
+      `/_synapse/admin/v1/join/${encodeURIComponent(roomIdOrAlias)}`,
+      { user_id: userId },
+    );
+  }
+
+  /**
+   * Force-join, treating "already a member" as success. Synapse answers a
+   * repeat join with 403 `M_FORBIDDEN: "<user> is already in the room."`, which
+   * is a failure only if you assumed you knew the membership first. Callers
+   * that just want someone in a room (sign-in, reconcile racing itself) want
+   * this; the raw 403 tells them nothing they can act on.
+   */
+  async ensureJoined(roomIdOrAlias: string, userId: string): Promise<void> {
+    try {
+      await this.forceJoin(roomIdOrAlias, userId);
+    } catch (err) {
+      if (!/already in the room/i.test((err as Error).message)) throw err;
+    }
+  }
+
+  kick(roomId: string, userId: string, reason: string): Promise<void> {
+    return this.request(
+      'POST',
+      `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/kick`,
+      { user_id: userId, reason },
+    );
+  }
+
+  /** Deactivating (rather than just kicking) a leaver's account revokes all their sessions. */
+  deactivateUser(userId: string): Promise<void> {
+    return this.request(
+      'POST',
+      `/_synapse/admin/v1/deactivate/${encodeURIComponent(userId)}`,
+      { erase: false },
+    );
+  }
+
+  sendMessage(roomId: string, body: string, formattedBody?: string): Promise<void> {
+    const txnId = `edr-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    return this.request(
+      'PUT',
+      `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/send/m.room.message/${txnId}`,
+      formattedBody
+        ? {
+            msgtype: 'm.text',
+            body,
+            format: 'org.matrix.custom.html',
+            formatted_body: formattedBody,
+          }
+        : { msgtype: 'm.text', body },
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/companies/companies.controller.ts b/apps/edr-freight-api/src/modules/companies/companies.controller.ts
index 810d4d46a..5d29b32f6 100644
--- a/apps/edr-freight-api/src/modules/companies/companies.controller.ts
+++ b/apps/edr-freight-api/src/modules/companies/companies.controller.ts
@@ -20,6 +20,7 @@ import { ApiOperation, ApiTags, ApiConsumes } from "@nestjs/swagger";
 import { CurrentUser } from "@edr/api-common";
 import type { TCurrentUser } from "@tria-plc/api-common/modules/auth/types/current-user.type";
 import { BookingStaff, MixedAudience, PortalCustomer } from "../../common/booking-guards";
+import { documentUploadMulterOptions } from "../../common/document-upload.options";
 import {
   assertFreightPermission,
   hasFreightPermission,
@@ -38,6 +39,7 @@ import {
   CompleteIdentityVerificationDto,
 } from "./dto/complete-identity-verification.dto";
 import { SetOnboardingStepDto } from "./dto/set-onboarding-step.dto";
+import { SetPoaDeclaredDto } from "./dto/set-poa-declared.dto";
 import { StartOnboardingDto } from "./dto/start-onboarding.dto";
 import { DashboardQueryDto } from "./dto/dashboard-query.dto";
 import {
@@ -50,6 +52,11 @@ import {
 } from "./entities/company-profile.entity";
 import { ResponseExternalProfileDto } from "./dto/response-external-profile.dto";
 import { CompanyInfoResponseDto } from "./dto/company-info-response.dto";
+import {
+  AccountInfoResponse,
+  ShippingLineInfoResponseDto,
+} from "./dto/account-info-response.dto";
+import { ShippingLineCompaniesService } from "../shipping-lines/shipping-line-companies.service";
 import { UpdateProfileDto } from "./dto/update-profile.dto";
 import { ProfileResponseDto } from "./dto/profile-response.dto";
 import { DashboardSummaryResponseDto } from "./dto/dashboard-summary-response.dto";
@@ -94,6 +101,7 @@ export class CompaniesController {
   constructor(
     private readonly companiesService: CompaniesService,
     private readonly filesService: FilesService,
+    private readonly shippingLineCompaniesService: ShippingLineCompaniesService,
   ) { }
 
   /**
@@ -117,16 +125,31 @@ export class CompaniesController {
 
   @Get("getInfo")
   @PortalCustomer()
-  @ApiOperation({ summary: "Get company info for the current user" })
+  @ApiOperation({
+    summary: "Get account info for the current user (customer or shipping line)",
+  })
   async getInfo(
     @CurrentUser() user: CurrentIamUser,
-  ): Promise<CompanyInfoResponseDto> {
+  ): Promise<AccountInfoResponse> {
+    // A shipping line has no company and no external profile, so the customer
+    // lookup below would 404. Checked first, and reported with an explicit
+    // `accountKind` so the portal can skip onboarding for shipping lines
+    // without inferring it from a missing company.
+    const shippingLine = await this.shippingLineCompaniesService.findByUserId(
+      user.id,
+    );
+    if (shippingLine) {
+      return new ShippingLineInfoResponseDto(shippingLine);
+    }
+
     const { profile, company } =
       await this.companiesService.getCompanyInfoByUserId(user.id);
     const review = await this.companiesService.getOpenChangeRequestForCompany(
       company.id,
     );
-    return new CompanyInfoResponseDto(profile, company, review);
+    return Object.assign(new CompanyInfoResponseDto(profile, company, review), {
+      accountKind: "customer" as const,
+    });
   }
 
   @Get("profile")
@@ -210,6 +233,7 @@ export class CompaniesController {
     const data = await this.companiesService.fetchETradeData(
       dto.tin,
       companyId,
+      dto.licenceNumber,
     );
     return new ETradeResponseDto(data);
   }
@@ -263,10 +287,26 @@ export class CompaniesController {
       dto.companyType,
       dto.roles,
       dto.nationality,
+      dto.cooperative,
+      dto.investorLicence,
     );
     return new CompanyInfoResponseDto(profile, company);
   }
 
+  @Post("onboarding/revert-to-etrade")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Drop the manual-registration route (co-operative or foreign investment licence): clear the typed registration and reopen onboarding so the TIN is verified against eTrade",
+  })
+  async revertToRegularCompany(
+    @CurrentUser() user: CurrentIamUser,
+  ): Promise<CompanyInfoResponseDto> {
+    const { profile, company } =
+      await this.companiesService.revertToRegularCompany(user.id);
+    return new CompanyInfoResponseDto(profile, company);
+  }
+
   @Post("company-profile")
   @PortalCustomer()
   @ApiOperation({
@@ -413,8 +453,9 @@ export class CompaniesController {
   @PortalCustomer()
   @ApiOperation({
     summary:
-      "Bind a completed Fayda verification to the company's owner or Power of Attorney. " +
+      "Bind a completed Fayda verification to the company's single identity. " +
       "Start the flow with POST /fayda/verification/start (platform=PORTAL), then post the returned code+state here. " +
+      "`subject` must match the company's PoA declaration — the representative when one is named, otherwise the owner. " +
       "The verified name, phone, email and address are written from the Fayda payload; on an approved company the change is staged for backoffice review.",
   })
   async completeIdentityVerification(
@@ -424,43 +465,19 @@ export class CompaniesController {
     return this.companiesService.completeIdentityVerification(user.id, dto);
   }
 
-  @Post("identity/gm/same-as-owner")
+  @Patch("identity/poa-declared")
   @PortalCustomer()
   @ApiOperation({
     summary:
-      "Declare the General Manager is the company's owner, copying the owner's verified identity across. " +
-      "Refused until the owner is Fayda-verified — there would be nothing proven to copy.",
+      "Answer whether anyone holds power of attorney for this company — the question that decides whose identity is verified. " +
+      'Answering "no" removes the representative entirely: their details, their verification, their passport number and the DARS delegation paper. ' +
+      'Refused for a freight forwarder, which cannot operate without a representative (its answer is always "yes").',
   })
-  async setGmSameAsOwner(
+  async setPoaDeclared(
     @CurrentUser() user: CurrentIamUser,
+    @Body() dto: SetPoaDeclaredDto,
   ): Promise<CompanyIdentityStateDto> {
-    return this.companiesService.setGmSameAsOwner(user.id);
-  }
-
-  @Delete("identity/gm")
-  @PortalCustomer()
-  @ApiOperation({
-    summary:
-      "Clear the General Manager's identity — the \"same as owner\" declaration or a verification, and the details either wrote. " +
-      "Leaves the GM open to be verified in their own right, or typed where Fayda is optional.",
-  })
-  async clearGmIdentity(
-    @CurrentUser() user: CurrentIamUser,
-  ): Promise<CompanyIdentityStateDto> {
-    return this.companiesService.clearGmIdentity(user.id);
-  }
-
-  @Delete("identity/fayda/poa")
-  @PortalCustomer()
-  @ApiOperation({
-    summary:
-      "Remove the company's Power of Attorney — the verified identity, its details and the delegation paper together. " +
-      "Refused while the company holds a freight forwarder role, which cannot operate without a representative.",
-  })
-  async removePoaIdentity(
-    @CurrentUser() user: CurrentIamUser,
-  ): Promise<CompanyIdentityStateDto> {
-    return this.companiesService.removePoaIdentity(user.id);
+    return this.companiesService.setPoaDeclared(user.id, dto.declared);
   }
 
   @Patch("onboarding-step")
@@ -689,7 +706,7 @@ export class CompaniesController {
 
   @Post(":companyId/documents")
   @MixedAudience(FREIGHT_PERMS.customers.update)
-  @UseInterceptors(AnyFilesInterceptor())
+  @UseInterceptors(AnyFilesInterceptor(documentUploadMulterOptions))
   @ApiConsumes("multipart/form-data")
   @ApiOperation({ summary: "Upload documents for a company (onboarding)" })
   async uploadDocuments(
diff --git a/apps/edr-freight-api/src/modules/companies/companies.fayda-identity.spec.ts b/apps/edr-freight-api/src/modules/companies/companies.fayda-identity.spec.ts
index 51dd1d61f..30c323ac3 100644
--- a/apps/edr-freight-api/src/modules/companies/companies.fayda-identity.spec.ts
+++ b/apps/edr-freight-api/src/modules/companies/companies.fayda-identity.spec.ts
@@ -147,6 +147,10 @@ function makeService(overrides: Partial<Ctx> = {}) {
     verifayda: {
       completeVerification: jest.fn(async () => ctx.verification),
     },
+    // Onboarding requirements resolve the nationality's document set through
+    // this; no setting means no company documents, which keeps those cases
+    // focused on the identity/PoA half of the list.
+    fileUploadSettings: { getByCode: jest.fn(async () => null) },
   };
 
   const service = new CompaniesService(
@@ -157,7 +161,7 @@ function makeService(overrides: Partial<Ctx> = {}) {
     deps.profilesRepo as never,
     {} as never,
     deps.filesService as never,
-    {} as never,
+    deps.fileUploadSettings as never,
     {} as never,
     deps.companyNotifier as never,
     {} as never,
@@ -173,544 +177,451 @@ function makeService(overrides: Partial<Ctx> = {}) {
 
   return { service, ctx, deps, company };
 }
-
-describe("Fayda identity verification binds a person to the company", () => {
-  it("writes the verified identity", async () => {
-    const { service, ctx } = makeService();
-
-    const state = await service.completeIdentityVerification("user-1", {
-      subject: "owner",
-      code: "c",
-      state: "s",
-    });
-
-    expect(ctx.attributes.ownerFaydaSub).toBe("new-sub");
-    expect(ctx.attributes.ownerName).toBe("Haile Gebrselassie");
-    expect(state.owner.verified).toBe(true);
-  });
-
-  it("fills every PoA detail from the payload, address included", async () => {
-    const { service, ctx } = makeService();
-
-    await service.completeIdentityVerification("user-1", {
-      subject: "poa",
-      code: "c",
-      state: "s",
-    });
-
-    expect(ctx.attributes.poaName).toBe("Haile Gebrselassie");
-    expect(ctx.attributes.poaEmail).toBe("haile@example.com");
-    expect(ctx.attributes.poaPhone).toBe("+251922000000");
-    expect(ctx.attributes.poaAddress).toBe("Addis Ababa");
-  });
-
-  it("verifies successfully even though Fayda returns no national ID number", async () => {
-    // Fayda's userinfo carries no FAN/FIN claim at all — this must be the
-    // normal, successful path, not an error.
-    const { service } = makeService({
-      verification: {
-        purpose: "VERIFY",
-        verified: true,
-        sub: "x",
-        fullName: "No Fan Here",
-      },
-    });
-
-    const state = await service.completeIdentityVerification("user-1", {
-      subject: "owner",
-      code: "c",
-      state: "s",
-    });
-
-    expect(state.owner.verified).toBe(true);
-  });
-
-  it("refuses to make one identity both owner and PoA", async () => {
-    const { service } = makeService({
-      attributes: { ownerFaydaSub: "same-person" },
-      verification: {
-        purpose: "VERIFY",
-        verified: true,
-        sub: "same-person",
-        fullName: "Abebe Bikila",
-      },
-    });
-
+describe("one company, one verified identity", () => {
+  it("refuses a verification before the company says who represents it", async () => {
+    const { service } = makeService();
     await expect(
       service.completeIdentityVerification("user-1", {
-        subject: "poa",
+        subject: "owner",
         code: "c",
         state: "s",
       }),
     ).rejects.toBeInstanceOf(BadRequestException);
   });
 
-  it("stages an owner re-verification for review on an approved company", async () => {
-    // The owner is the live company's identity proof, so re-verifying one is
-    // exactly what the backoffice review exists for: it must not rewrite the
-    // row directly.
-    const { service, ctx, deps } = makeService({
-      status: CompanyStatus.Active,
-    });
-
-    await service.completeIdentityVerification("user-1", {
-      subject: "owner",
-      code: "c",
-      state: "s",
-    });
-
-    expect(deps.changeRequestRepo.create).toHaveBeenCalled();
-    expect(ctx.attributes.ownerFaydaSub).toBeUndefined();
-  });
-
-  it("applies a PoA verification live on an approved company", async () => {
-    // The PoA is personnel the company names for itself — the delegation paper
-    // is what a reviewer actually judges — so it does not go to review.
-    const { service, ctx, deps } = makeService({
-      status: CompanyStatus.Active,
-    });
-
-    await service.completeIdentityVerification("user-1", {
-      subject: "poa",
-      code: "c",
-      state: "s",
-    });
-
-    expect(deps.changeRequestRepo.create).not.toHaveBeenCalled();
-    expect(ctx.attributes.poaFaydaSub).toBe("new-sub");
-  });
-
-  it("stages nothing for a verified field an approved company resubmits", async () => {
-    // Approving it could not move the live row — the verified value is written
-    // back over it — so it must never reach a reviewer as a pending change.
-    const { service, deps } = makeService({
-      status: CompanyStatus.Active,
-      attributes: { ...OWNER_VERIFIED, ownerEmail: "abebe@example.com" },
-    });
-
-    await expect(
-      service.updateProfile("user-1", {
-        companyEmail: "someone-else@example.com",
-      } as never),
-    ).resolves.toBeDefined();
-    expect(deps.changeRequestRepo.create).not.toHaveBeenCalled();
-    expect(deps.changeRequestRepo.update).not.toHaveBeenCalled();
-    expect(deps.companiesRepo.update).not.toHaveBeenCalled();
-  });
-
-  // The verified value wins, and it wins by overwriting rather than by
-  // rejecting: nobody types these fields, so a submission that disagrees is a
-  // stale form echoing itself back, not an edit. Failing it would block a save
-  // the customer never made — and leave them no way through, since re-verifying
-  // returns the same value they are being 400'd for.
-  it("overwrites a hand-renamed verified person with the verified name", async () => {
-    const { service, ctx } = makeService({
-      attributes: { ...OWNER_VERIFIED, ...POA_VERIFIED },
-      files: [paper()],
-    });
-
-    await expect(
-      service.updateProfile("user-1", { poaName: "Someone Else" } as never),
-    ).resolves.toBeDefined();
-    expect(ctx.attributes.poaName).toBe(POA_VERIFIED.poaName);
-  });
-
-  // Fayda's email and phone claims are optional — a verification can prove the
-  // person and return neither. Holding the company mirrors to "the owner is
-  // verified" rather than to "the verification supplied this value" would
-  // clobber the fallbacks the portal is built to send (account email, eTrade's
-  // registered phone) with nothing at all. OWNER_VERIFIED is exactly that
-  // shape: a sub, no contact details.
-  it("keeps company contact details a Fayda verification never supplied", async () => {
-    const { service, deps } = makeService({
-      attributes: { ...OWNER_VERIFIED },
-    });
-
-    await expect(
-      service.updateProfile("user-1", {
-        companyEmail: "account@example.com",
-        companyPhone: "+251911777777",
-      } as never),
-    ).resolves.toBeDefined();
-    const [, patch] = deps.companiesRepo.update.mock.calls.at(-1)!;
-    expect(patch.email).toBe("account@example.com");
-    expect(patch.phone).toBe("+251911777777");
-  });
-
-  it("overwrites company contact details the verification did supply", async () => {
-    const { service, deps } = makeService({
-      attributes: {
-        ...OWNER_VERIFIED,
-        ownerEmail: "abebe@example.com",
-        ownerPhone: "+251911000000",
-      },
-    });
-
-    await expect(
-      service.updateProfile("user-1", {
-        companyEmail: "someone-else@example.com",
-        companyPhone: "+251911999999",
-      } as never),
-    ).resolves.toBeDefined();
-    const [, patch] = deps.companiesRepo.update.mock.calls.at(-1)!;
-    expect(patch.email).toBe("abebe@example.com");
-    expect(patch.phone).toBe("+251911000000");
-  });
-
-  // "Same as owner" copies `ownerEmail ?? null` onto the GM while setting
-  // `gmFaydaSub`. Locking that null made generalManagerEmail required by
-  // onboarding, hidden by the portal's link card and unwritable at once.
-  it("lets the GM's details be typed when the copied owner identity carried none", async () => {
-    const { service } = makeService({
-      attributes: {
-        ...OWNER_VERIFIED,
-        gmSameAsOwner: true,
-        gmFaydaSub: "owner-sub",
-        generalManagerName: "Abebe Bikila",
-        generalManagerEmail: null,
-        generalManagerPhone: null,
-      },
-    });
-
-    await expect(
-      service.updateProfile("user-1", {
-        generalManagerEmail: "gm@example.com",
-        generalManagerPhone: "+251911888888",
-      } as never),
-    ).resolves.toBeDefined();
-  });
-
-  it("never locks or gates the general manager — it is not the verified subject", async () => {
-    // GM is a plain typed role; the portal offers a "same as owner" copy, but
-    // the backend must not treat it as identity-owned or require it verified.
-    const { service } = makeService({
-      attributes: { ...OWNER_VERIFIED },
-    });
-
-    await expect(
-      service.updateProfile("user-1", {
-        generalManagerName: "Someone Else",
-        generalManagerEmail: "someone@example.com",
-        generalManagerPhone: "+251911223344",
-      } as never),
-    ).resolves.toBeDefined();
-  });
-});
-
-describe("Ethiopian companies verify with Fayda; foreign companies verify identity by passport", () => {
-  // The company is applying for the forwarder role, so it must not already
-  // hold it — createCompanyProfileForUser short-circuits on an existing profile
-  // and would never reach the gate.
-  const applyingForFf = {
-    profileTypes: [ProfileType.importer],
-    attributes: { ...POA_VERIFIED },
-    files: [paper()],
-  };
-
-  it("blocks the forwarder role while the owner is unverified", async () => {
-    const { service } = makeService(applyingForFf);
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).rejects.toBeInstanceOf(BadRequestException);
-  });
-
-  it("blocks the forwarder role while the PoA is unverified", async () => {
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      attributes: {
-        ...OWNER_VERIFIED,
-        poaName: "Tirunesh Dibaba",
-        poaEmail: "t@example.com",
-        poaPhone: "+251911000000",
-      },
-      files: [paper()],
-    });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).rejects.toBeInstanceOf(BadRequestException);
-  });
-
-  it("grants the forwarder role once owner and PoA are both verified", async () => {
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      attributes: { ...OWNER_VERIFIED, ...POA_VERIFIED },
-      files: [paper()],
-    });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).resolves.toBeDefined();
-  });
-
-  it("never asks a foreign company for Fayda, verified or not", async () => {
-    const { service } = makeService({
-      nationality: CompanyNationality.Foreign,
-    });
-
+  it("writes the verified identity onto the declared subject", async () => {
+    const { service, ctx } = makeService({ attributes: { poaDeclared: "no" } });
     const state = await service.completeIdentityVerification("user-1", {
       subject: "owner",
       code: "c",
       state: "s",
     });
 
-    // Still lets the owner verify — a foreign owner verifying is allowed, just
-    // never required — but the passport is the thing that actually gates it.
     expect(state.owner.verified).toBe(true);
-    expect(state.faydaRequired).toBe(false);
-    expect(state.passportRequired).toBe(true);
+    expect(state.owner.name).toBe("Haile Gebrselassie");
+    expect(state.owner.email).toBe("haile@example.com");
+    expect(state.owner.address).toBe("Addis Ababa");
+    expect(ctx.attributes.ownerFaydaSub).toBe("new-sub");
+    expect(state.identityProven).toBe(true);
+    expect(state.complete).toBe(true);
   });
 
-  it("blocks the forwarder role for a foreign company with no owner passport", async () => {
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      nationality: CompanyNationality.Foreign,
-      attributes: {
-        poaName: "Jean Dupont",
-        poaEmail: "jean@example.com",
-        poaPhone: "+33100000000",
-      },
-    });
-
+  it("refuses a verification for the person the declaration does not point at", async () => {
+    // A PoA-declared company gates on the PoA. An owner verification here would
+    // sit on the record looking proven while the gate stayed unsatisfied.
+    const { service } = makeService({ attributes: { poaDeclared: "yes" } });
     await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
+      service.completeIdentityVerification("user-1", {
+        subject: "owner",
+        code: "c",
+        state: "s",
+      }),
     ).rejects.toBeInstanceOf(BadRequestException);
   });
 
-  it("grants the forwarder role to a foreign company whose owner has a passport and whose PoA is Fayda-verified", async () => {
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      nationality: CompanyNationality.Foreign,
-      attributes: {
-        ownerPassportNumber: "P1234567",
-        ...POA_VERIFIED,
-      },
-      files: [paper()],
+  it("verifies the representative when one is declared", async () => {
+    const { service, ctx } = makeService({ attributes: { poaDeclared: "yes" } });
+    const state = await service.completeIdentityVerification("user-1", {
+      subject: "poa",
+      code: "c",
+      state: "s",
     });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).resolves.toBeDefined();
+    expect(state.subject).toBe("poa");
+    expect(state.poa.verified).toBe(true);
+    expect(state.poa.address).toBe("Addis Ababa");
+    expect(state.identityProven).toBe(true);
+    expect(ctx.attributes.poaFaydaSub).toBe("new-sub");
   });
 
-  it("accepts a typed PoA from a foreign company, whose representative may hold no Fayda ID", async () => {
-    // Fayda is an Ethiopian national ID, so only an Ethiopian company's
-    // representative can be held to it. A foreign company is offered the
-    // verification and uses it where its representative holds one, but a typed
-    // name stays sufficient — holding it to Fayda would leave a foreign
-    // company whose representative has no Fayda ID unable to trade at all.
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      nationality: CompanyNationality.Foreign,
-      attributes: {
-        ownerPassportNumber: "P1234567",
-        poaName: "Jean Dupont",
-        poaEmail: "jean@example.com",
-        poaPhone: "+33100000000",
-      },
-      files: [paper()],
-    });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).resolves.toBeDefined();
-  });
-
-  it("still refuses a foreign company that named no PoA at all", async () => {
-    // The typed fallback is a different credential, not a waiver: a freight
-    // forwarder acts on other companies' behalf and needs a representative
-    // whatever its nationality.
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      nationality: CompanyNationality.Foreign,
-      attributes: { ownerPassportNumber: "P1234567" },
-      files: [paper()],
-    });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).rejects.toBeInstanceOf(BadRequestException);
-  });
-
-  it("holds an Ethiopian company to a Fayda-verified PoA, typed details notwithstanding", async () => {
-    // The relaxation above is scoped to foreign companies only — an Ethiopian
-    // representative holds a Fayda ID, so typing a name must not substitute.
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      nationality: CompanyNationality.Ethiopian,
-      attributes: {
-        ...OWNER_VERIFIED,
-        poaName: "Abebe Bekele",
-        poaEmail: "abebe@example.com",
-        poaPhone: "+251911000000",
-      },
-      files: [paper()],
-    });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).rejects.toBeInstanceOf(BadRequestException);
-  });
-
-  it("still requires the passport for a foreign owner who chose to verify with Fayda too", async () => {
-    // Verifying is optional for a foreign owner, but it does not waive the
-    // passport requirement — the two are independent credentials.
-    const { service } = makeService({
-      profileTypes: [ProfileType.importer],
-      nationality: CompanyNationality.Foreign,
-      attributes: {
-        ...OWNER_VERIFIED,
-        poaName: "Jean Dupont",
-        poaEmail: "jean@example.com",
-        poaPhone: "+33100000000",
-      },
-    });
-
-    await expect(
-      service.createCompanyProfileForUser(
-        "user-1",
-        ProfileType.freightForwarder,
-      ),
-    ).rejects.toBeInstanceOf(BadRequestException);
-  });
-
-  // -------------------------------------------------------------------------
-  // General manager
-  // -------------------------------------------------------------------------
-
-  it("reuses the owner's verified identity when the GM is declared the same person", async () => {
-    // The GM is very often the owner. Copying the proven identity is the whole
-    // point — asking one human to complete two verifications proves nothing
-    // extra, and typing the details instead would forge a verified badge.
+  it("verifies successfully even though Fayda returns no national ID number", async () => {
     const { service, ctx } = makeService({
-      attributes: {
-        ...OWNER_VERIFIED,
-        ownerEmail: "abebe@example.com",
-        ownerPhone: "+251911222333",
+      attributes: { poaDeclared: "no" },
+      verification: {
+        purpose: "VERIFY",
+        verified: true,
+        sub: "new-sub",
+        fullName: "Haile Gebrselassie",
       },
     });
-
-    const state = await service.setGmSameAsOwner("user-1");
-
-    expect(state.gm.verified).toBe(true);
-    expect(state.gmSameAsOwner).toBe(true);
-    expect(state.gm.name).toBe("Abebe Bikila");
-    expect(ctx.attributes.gmFaydaSub).toBe("owner-sub");
-    // The notifiers mail the flat column, so a linked GM has to land there too.
-    expect(ctx.attributes.generalManagerEmail).toBe("abebe@example.com");
+    const state = await service.completeIdentityVerification("user-1", {
+      subject: "owner",
+      code: "c",
+      state: "s",
+    });
+    expect(state.owner.verified).toBe(true);
+    expect(ctx.attributes.fanNumber).toBeUndefined();
   });
 
-  it("refuses to declare the GM is the owner while the owner is unverified", async () => {
-    // Without a verification there is no proven identity to copy — only typed
-    // text, which would arrive wearing a badge it had not earned.
-    const { service } = makeService({ attributes: {} });
+  it("never stands the signed-in account in for an absent Fayda claim", async () => {
+    // The person onboarding is not necessarily the person on the licence.
+    // Stamping their address onto the owner made a required field a guess.
+    const { service, ctx } = makeService({
+      attributes: { poaDeclared: "no" },
+      verification: {
+        purpose: "VERIFY",
+        verified: true,
+        sub: "new-sub",
+        fullName: "Haile Gebrselassie",
+      },
+    });
+    const state = await service.completeIdentityVerification("user-1", {
+      subject: "owner",
+      code: "c",
+      state: "s",
+    });
+    expect(state.owner.email).toBeNull();
+    expect(state.owner.phone).toBeNull();
+    expect(ctx.attributes.ownerEmail).toBeUndefined();
+  });
 
-    await expect(service.setGmSameAsOwner("user-1")).rejects.toBeInstanceOf(
+  it("stages a verification for review on an approved company", async () => {
+    const { service, deps, ctx } = makeService({
+      status: CompanyStatus.Active,
+      attributes: { poaDeclared: "no", ...OWNER_VERIFIED },
+    });
+    await service.completeIdentityVerification("user-1", {
+      subject: "owner",
+      code: "c",
+      state: "s",
+    });
+    expect(deps.changeRequestRepo.create).toHaveBeenCalled();
+    // The live row is untouched until a reviewer approves.
+    expect(ctx.attributes.ownerFaydaSub).toBe("owner-sub");
+  });
+
+  it("overwrites a hand-renamed verified person with the verified name", async () => {
+    const { service } = makeService({
+      attributes: { poaDeclared: "no", ...OWNER_VERIFIED },
+    });
+    const profile = await service.updateProfile("user-1", {
+      ownerName: "Someone Else",
+    } as never);
+    expect(profile.ownerName).toBe("Abebe Bikila");
+  });
+
+  it("keeps a field the verification never supplied typeable", async () => {
+    // Fayda's email claim is optional and `REQUIRED_COMPANY_INFO` demands one,
+    // so locking against an absent value would make it unfillable forever.
+    const { service, ctx } = makeService({
+      attributes: { poaDeclared: "no", ...OWNER_VERIFIED },
+    });
+    await service.updateProfile("user-1", {
+      ownerEmail: "typed@example.com",
+    } as never);
+    expect(ctx.attributes.ownerEmail).toBe("typed@example.com");
+  });
+
+  it("writes the owner's email onto the company, verified or not", async () => {
+    // `companies.email` is what the notification resolver reads first. Gating
+    // this on a Fayda verification left every foreign company without one.
+    const { service, deps } = makeService({ attributes: { poaDeclared: "no" } });
+    await service.updateProfile("user-1", {
+      ownerEmail: "owner@example.com",
+      ownerPhone: "+251911223344",
+    } as never);
+    const patch = deps.companiesRepo.update.mock.calls.at(-1)?.[1] as Record<
+      string,
+      unknown
+    >;
+    expect(patch.email).toBe("owner@example.com");
+    expect(patch.phone).toBe("+251911223344");
+  });
+});
+
+describe("the declaration decides who verifies", () => {
+  it("points at the owner when the company says it has no representative", async () => {
+    const { service, company } = makeService({
+      attributes: { poaDeclared: "no" },
+    });
+    expect(service.getCompanyIdentityState(company() as never).subject).toBe(
+      "owner",
+    );
+  });
+
+  it("points at the representative when it says it has one", async () => {
+    const { service, company } = makeService({
+      attributes: { poaDeclared: "yes" },
+    });
+    expect(service.getCompanyIdentityState(company() as never).subject).toBe(
+      "poa",
+    );
+  });
+
+  it("is null until the company answers, and nothing is proven yet", async () => {
+    const { service, company } = makeService({ attributes: OWNER_VERIFIED });
+    const state = service.getCompanyIdentityState(company() as never);
+    expect(state.poaDeclared).toBeNull();
+    expect(state.subject).toBeNull();
+    expect(state.identityProven).toBe(false);
+    expect(state.complete).toBe(false);
+  });
+
+  it('forces "yes" for a freight forwarder whatever is stored', async () => {
+    // A forwarder signs on other companies' behalf, so a representative is
+    // non-negotiable — including one that answered "no" before taking the role.
+    const { service, company } = makeService({
+      attributes: { poaDeclared: "no" },
+      profileTypes: [ProfileType.freightForwarder],
+    });
+    const state = service.getCompanyIdentityState(company() as never);
+    expect(state.poaDeclared).toBe("yes");
+    expect(state.subject).toBe("poa");
+  });
+
+  it('refuses to set "no" for a freight forwarder', async () => {
+    const { service } = makeService({
+      profileTypes: [ProfileType.freightForwarder],
+    });
+    await expect(service.setPoaDeclared("user-1", "no")).rejects.toBeInstanceOf(
       BadRequestException,
     );
   });
 
-  it("lets the GM verify as the same human as the owner", async () => {
-    // The owner/PoA collision check exists because self-delegation is not
-    // delegation. It must not fire here: the GM being the owner is a supported
-    // answer, so verifying with the owner's own Fayda sub has to succeed.
-    const { service, ctx } = makeService({
-      attributes: { ...OWNER_VERIFIED },
-      verification: {
-        purpose: "VERIFY",
-        verified: true,
-        sub: "owner-sub",
-        fullName: "Abebe Bikila",
-        email: "abebe@example.com",
-        phoneNumber: "+251911222333",
-      },
+  it('tears the representative down when answered "no"', async () => {
+    const { service, ctx, deps } = makeService({
+      attributes: { poaDeclared: "yes", ...POA_VERIFIED },
+      files: [paper()],
     });
-
-    const state = await service.completeIdentityVerification("user-1", {
-      subject: "gm",
-      code: "c",
-      state: "s",
-    });
-
-    expect(state.gm.verified).toBe(true);
-    expect(ctx.attributes.gmFaydaSub).toBe("owner-sub");
-    expect(ctx.attributes.generalManagerName).toBe("Abebe Bikila");
-  });
-
-  it("still refuses a PoA who is the owner", async () => {
-    // The GM exemption above must not have widened into the PoA.
-    const { service } = makeService({
-      attributes: { ...OWNER_VERIFIED },
-      verification: {
-        purpose: "VERIFY",
-        verified: true,
-        sub: "owner-sub",
-        fullName: "Abebe Bikila",
-      },
-    });
-
-    await expect(
-      service.completeIdentityVerification("user-1", {
-        subject: "poa",
-        code: "c",
-        state: "s",
-      }),
-    ).rejects.toBeInstanceOf(BadRequestException);
-  });
-
-  it("reports a pre-existing typed GM as unverified rather than blank", async () => {
-    // Companies onboarded before the GM was verifiable have typed details and
-    // no gm* attributes. Those details are still what the notifiers mail, so
-    // they must survive — flagged unverified so the portal offers the upgrade.
-    const { service, company } = makeService({
-      attributes: {
-        ...OWNER_VERIFIED,
-        generalManagerName: "Legacy Manager",
-        generalManagerEmail: "legacy@example.com",
-      },
-    });
-
-    const state = service.getCompanyIdentityState(company() as never);
-
-    expect(state.gm.verified).toBe(false);
-    expect(state.gm.name).toBe("Legacy Manager");
-    expect(state.gm.email).toBe("legacy@example.com");
-  });
-
-  it("does not let an unproven GM block the company from trading", async () => {
-    // The GM names who to talk to, not what the company may do. Capturing it
-    // through Fayda changed how it is collected, not whether it gates.
-    const { service } = makeService({
-      attributes: { ...OWNER_VERIFIED },
-    });
-
-    await expect(
-      service.createCompanyProfileForUser("user-1", ProfileType.importer),
-    ).resolves.toBeDefined();
+    const state = await service.setPoaDeclared("user-1", "no");
+    expect(state.poaDeclared).toBe("no");
+    expect(state.poa.verified).toBe(false);
+    expect(ctx.attributes.poaName).toBeNull();
+    expect(ctx.attributes.poaFaydaSub).toBeNull();
+    // The paper evidenced a delegation that no longer exists.
+    expect(deps.filesService.remove).toHaveBeenCalledWith("file-1");
+  });
+});
+
+describe("foreign companies prove the same person by Fayda OR passport", () => {
+  const foreign = (attributes: Record<string, unknown>) =>
+    makeService({ nationality: CompanyNationality.Foreign, attributes });
+
+  it("accepts a passport number in place of Fayda", async () => {
+    const { service, company } = foreign({
+      poaDeclared: "no",
+      ownerPassportNumber: "P1234567",
+    });
+    const state = service.getCompanyIdentityState(company() as never);
+    expect(state.passportAccepted).toBe(true);
+    expect(state.identityProven).toBe(true);
+  });
+
+  it("accepts a Fayda verification instead — the passport is not additional", async () => {
+    const { service, company } = foreign({ poaDeclared: "no", ...OWNER_VERIFIED });
+    expect(
+      service.getCompanyIdentityState(company() as never).identityProven,
+    ).toBe(true);
+  });
+
+  it("collects the passport of whichever person carries the identity", async () => {
+    const { service, company } = foreign({
+      poaDeclared: "yes",
+      poaPassportNumber: "P7654321",
+    });
+    const state = service.getCompanyIdentityState(company() as never);
+    expect(state.subject).toBe("poa");
+    expect(state.identityProven).toBe(true);
+  });
+
+  it("is not satisfied by the OTHER person's passport", async () => {
+    // A PoA-represented company gates on the PoA; the owner's passport proves
+    // nobody relevant.
+    const { service, company } = foreign({
+      poaDeclared: "yes",
+      ownerPassportNumber: "P1234567",
+    });
+    expect(
+      service.getCompanyIdentityState(company() as never).identityProven,
+    ).toBe(false);
+  });
+
+  it("offers an Ethiopian company no passport alternative", async () => {
+    const { service, company } = makeService({
+      attributes: { poaDeclared: "no", ownerPassportNumber: "P1234567" },
+    });
+    const state = service.getCompanyIdentityState(company() as never);
+    expect(state.passportAccepted).toBe(false);
+    expect(state.identityProven).toBe(false);
+  });
+});
+
+describe("the owner is checked against the eTrade licence", () => {
+  it("matches ignoring case, punctuation and word order", async () => {
+    const { service, company } = makeService({
+      attributes: {
+        poaDeclared: "no",
+        ownerName: "abebe  bikila",
+        etradeManagerName: "BIKILA, Abebe",
+      },
+    });
+    expect(
+      service.getCompanyIdentityState(company() as never).ownerMatchesEtrade,
+    ).toBe(true);
+  });
+
+  it("flags a different person", async () => {
+    const { service, company } = makeService({
+      attributes: {
+        poaDeclared: "no",
+        ownerName: "Haile Gebrselassie",
+        etradeManagerName: "Abebe Bikila",
+      },
+    });
+    expect(
+      service.getCompanyIdentityState(company() as never).ownerMatchesEtrade,
+    ).toBe(false);
+  });
+
+  it("reports null when there is nothing to compare", async () => {
+    // eTrade's ManagerNameEng is frequently blank; a null must not read as a
+    // mismatch, which would flag half the customer base.
+    const { service, company } = makeService({
+      attributes: { poaDeclared: "no", ownerName: "Abebe Bikila" },
+    });
+    expect(
+      service.getCompanyIdentityState(company() as never).ownerMatchesEtrade,
+    ).toBeNull();
+  });
+
+  it("never blocks on a mismatch — it is the reviewer's call", async () => {
+    const { service } = makeService({
+      attributes: {
+        poaDeclared: "no",
+        ...OWNER_VERIFIED,
+        // The verified owner is a different human from the one on the licence.
+        ownerName: "Haile Gebrselassie",
+        etradeManagerName: "Abebe Bikila",
+      },
+    });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.outstanding).not.toContain(
+      expect.stringContaining("eTrade"),
+    );
+  });
+});
+
+describe("the freight-forwarder gate", () => {
+  const addForwarder = (service: CompaniesService) =>
+    service.addCompanyProfilesForUser("user-1", [ProfileType.freightForwarder]);
+
+  it("blocks the role while the representative is unverified", async () => {
+    const { service } = makeService({ attributes: { poaDeclared: "yes" } });
+    await expect(addForwarder(service)).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+  });
+
+  it("blocks the role on a company that answered no — it becomes yes", async () => {
+    // Taking the role forces the declaration, so a company that had answered
+    // "no" cannot inherit that answer past the gate.
+    const { service } = makeService({
+      attributes: { poaDeclared: "no", ...OWNER_VERIFIED },
+    });
+    await expect(addForwarder(service)).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+  });
+
+  it("blocks the role without the DARS delegation paper", async () => {
+    const { service } = makeService({
+      attributes: { poaDeclared: "yes", ...POA_VERIFIED },
+      files: [],
+    });
+    await expect(addForwarder(service)).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+  });
+
+  it("grants the role once the representative is proven and the paper is on file", async () => {
+    const { service } = makeService({
+      attributes: { poaDeclared: "yes", ...POA_VERIFIED },
+      files: [paper()],
+    });
+    await expect(addForwarder(service)).resolves.toBeDefined();
+  });
+
+  it("grants it to a foreign forwarder whose representative has a passport", async () => {
+    const { service } = makeService({
+      nationality: CompanyNationality.Foreign,
+      attributes: {
+        poaDeclared: "yes",
+        ...POA_VERIFIED,
+        poaFaydaSub: undefined,
+        poaPassportNumber: "P7654321",
+      },
+      files: [paper()],
+    });
+    await expect(addForwarder(service)).resolves.toBeDefined();
+  });
+});
+
+describe("onboarding requirements report exactly what is outstanding", () => {
+  it("asks the power-of-attorney question before anything else about identity", async () => {
+    const { service } = makeService();
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.poa.declared).toBeNull();
+    expect(reqs.outstanding).toContain(
+      "Tell us whether anyone holds power of attorney for your company",
+    );
+  });
+
+  it("names the representative's missing details once one is declared", async () => {
+    const { service } = makeService({
+      attributes: { poaDeclared: "yes", poaName: "Tirunesh Dibaba" },
+    });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.poa.missingFields.map((f) => f.key)).toEqual([
+      "poaEmail",
+      "poaPhone",
+    ]);
+  });
+
+  it("asks nothing about a representative from a company that has none", async () => {
+    const { service } = makeService({
+      attributes: { poaDeclared: "no", ...OWNER_VERIFIED },
+    });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.poa.missingFields).toEqual([]);
+    expect(reqs.poa.delegationLetterRequired).toBe(false);
+  });
+
+  it("demands the delegation paper from every declared representative", async () => {
+    // No waiver: the owner representing the company IS the "no" answer, so a
+    // "yes" always means a delegation that has to be evidenced.
+    const { service } = makeService({
+      attributes: { poaDeclared: "yes", ...POA_VERIFIED },
+      files: [],
+    });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.poa.delegationLetterRequired).toBe(true);
+    expect(reqs.isComplete).toBe(false);
+  });
+
+  it("names the owner's missing details", async () => {
+    const { service } = makeService({ attributes: { poaDeclared: "no" } });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    const missing = reqs.companyInfo.missingFields.map((f) => f.key);
+    expect(missing).toEqual(
+      expect.arrayContaining(["ownerName", "ownerEmail", "ownerPhone"]),
+    );
+  });
+
+  it("reports the verification against the person it actually gates on", async () => {
+    const { service } = makeService({ attributes: { poaDeclared: "yes" } });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.outstanding).toContain(
+      "Verify your Power of Attorney with Fayda",
+    );
+  });
+
+  it("offers the passport alternative to a foreign company", async () => {
+    const { service } = makeService({
+      nationality: CompanyNationality.Foreign,
+      attributes: { poaDeclared: "no" },
+    });
+    const reqs = await service.getOnboardingRequirements("user-1");
+    expect(reqs.outstanding).toContain(
+      "Verify the person named on your eTrade licence with Fayda, or add their passport number",
+    );
   });
 });
diff --git a/apps/edr-freight-api/src/modules/companies/companies.investor-licence.spec.ts b/apps/edr-freight-api/src/modules/companies/companies.investor-licence.spec.ts
new file mode 100644
index 000000000..9de99186f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/companies.investor-licence.spec.ts
@@ -0,0 +1,292 @@
+import { BadRequestException } from "@nestjs/common";
+
+import { CompaniesService } from "./companies.service";
+import {
+  CompanyNationality,
+  CompanyStatus,
+  CompanyType,
+} from "./entities/company.entity";
+import {
+  ProfileStatus,
+  ProfileType,
+} from "./entities/company-profile.entity";
+
+/**
+ * A foreign company on an Investment Commission licence has no eTrade record,
+ * so it types its registration — and the flag saying so is what makes the
+ * backoffice treat those fields as unverified. Two things must hold: only a
+ * foreign company can carry it, and dropping it must not leave the typed
+ * registration behind looking like eTrade's.
+ *
+ * The dropping half is shared with the co-operative route, which has the same
+ * "eTrade holds nothing" shape, so it is exercised here for both.
+ */
+function makeService(company: Record<string, unknown> | null) {
+  const companiesRepo = {
+    findById: jest.fn(async () => company),
+    update: jest.fn(async () => null),
+    create: jest.fn(async (row: Record<string, unknown>) => ({
+      id: "company-1",
+      ...row,
+    })),
+    existsByTin: jest.fn(async () => false),
+  };
+  const companyProfilesRepo = {
+    findByCompanyId: jest.fn(async (): Promise<Record<string, unknown>[]> => []),
+    updateStatus: jest.fn(async () => null),
+    create: jest.fn(async (row: Record<string, unknown>) => ({
+      id: "cp-1",
+      ...row,
+    })),
+    softDelete: jest.fn(async () => undefined),
+  };
+  const profilesRepo = {
+    findByUserId: jest.fn(async () =>
+      company
+        ? { id: "external-1", companyId: "company-1", company: { id: "company-1" } }
+        : null,
+    ),
+    create: jest.fn(async (row: Record<string, unknown>) => ({
+      id: "external-1",
+      ...row,
+    })),
+    update: jest.fn(async () => null),
+  };
+
+  const service = new CompaniesService(
+    companiesRepo as never,
+    companyProfilesRepo as never,
+    {} as never,
+    {} as never,
+    profilesRepo as never,
+    {} as never,
+    {} as never,
+    {} as never,
+    {} as never,
+    {} as never,
+    {} as never,
+    {} as never,
+  );
+
+  jest
+    .spyOn(service, "getCompanyInfoByUserId")
+    .mockImplementation(
+      async () =>
+        ({ profile: { id: "external-1" }, company: { id: "company-1" } }) as never,
+    );
+
+  return { service, companiesRepo, companyProfilesRepo, profilesRepo };
+}
+
+const identity = { userId: "user-1", firstName: "Abebe", lastName: "K" };
+
+const start = (
+  service: CompaniesService,
+  nationality: CompanyNationality | undefined,
+  cooperative: boolean,
+  investorLicence: boolean,
+) =>
+  service.startOnboarding(
+    identity as never,
+    CompanyType.Customer,
+    [ProfileType.importer],
+    nationality,
+    cooperative,
+    investorLicence,
+  );
+
+describe("the foreign investment-licence route", () => {
+  it("refuses the flag for an Ethiopian company", async () => {
+    const { service } = makeService(null);
+    await expect(
+      start(service, CompanyNationality.Ethiopian, false, true),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
+
+  it("refuses the flag alongside the co-operative one", async () => {
+    const { service } = makeService(null);
+    await expect(
+      start(service, CompanyNationality.Foreign, true, true),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
+
+  it("stores the flag on a new foreign draft", async () => {
+    const { service, companiesRepo } = makeService(null);
+    await start(service, CompanyNationality.Foreign, false, true);
+    expect(companiesRepo.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        nationality: CompanyNationality.Foreign,
+        attributes: { investorLicence: true },
+      }),
+    );
+  });
+
+  it("clears the typed registration and reopens onboarding when switching back to eTrade", async () => {
+    const { service, companiesRepo, profilesRepo } = makeService({
+      id: "company-1",
+      attributes: { investorLicence: true, etradeManagerName: "Typed Name" },
+    });
+
+    await service.revertToRegularCompany("user-1");
+
+    const [, updates] = companiesRepo.update.mock.calls[0] as unknown as [
+      string,
+      Record<string, unknown>,
+    ];
+    expect(updates.attributes).toEqual({});
+    expect(updates.status).toBe(CompanyStatus.Pending);
+    // The wizard treats a populated registration as a passed lookup, so leaving
+    // any of it behind would walk the customer straight past the eTrade step.
+    expect(updates.licenceNumber).toBeNull();
+    expect(updates.region).toBeNull();
+    expect(profilesRepo.update).toHaveBeenCalledWith("external-1", {
+      onboardingCompleted: false,
+      onboardingStep: "company",
+    });
+  });
+
+  it("clears the typed registration when the box is un-ticked on the way back", async () => {
+    const { service, companiesRepo, profilesRepo } = makeService({
+      id: "company-1",
+      nationality: CompanyNationality.Foreign,
+      attributes: { investorLicence: true, etradeManagerName: "Typed Name" },
+      region: "Addis Ababa",
+      licenceNumber: "TYPED-1",
+    });
+
+    await start(service, CompanyNationality.Foreign, false, false);
+
+    const [, updates] = companiesRepo.update.mock.calls[0] as unknown as [
+      string,
+      Record<string, unknown>,
+    ];
+    // The wizard sends both flags; the typed manager does not survive.
+    expect(updates.attributes).toEqual({
+      cooperative: false,
+      investorLicence: false,
+    });
+    expect(updates.licenceNumber).toBeNull();
+    expect(updates.region).toBeNull();
+    // Resume must land back on the company step, or the customer never reaches
+    // the eTrade lookup they just opted back into.
+    expect(profilesRepo.update).toHaveBeenCalledWith("external-1", {
+      onboardingStep: "company",
+    });
+  });
+
+  it("does the same for a co-operative that stops being one", async () => {
+    const { service, companiesRepo } = makeService({
+      id: "company-1",
+      nationality: CompanyNationality.Ethiopian,
+      attributes: { cooperative: true },
+      region: "Oromia",
+    });
+
+    await start(service, CompanyNationality.Ethiopian, false, false);
+
+    const [, updates] = companiesRepo.update.mock.calls[0] as unknown as [
+      string,
+      Record<string, unknown>,
+    ];
+    expect(updates.region).toBeNull();
+  });
+
+  it("leaves the registration alone while the flag stays on", async () => {
+    const { service, companiesRepo, profilesRepo } = makeService({
+      id: "company-1",
+      nationality: CompanyNationality.Foreign,
+      attributes: { investorLicence: true },
+      region: "Addis Ababa",
+    });
+
+    await start(service, CompanyNationality.Foreign, false, true);
+
+    const [, updates] = companiesRepo.update.mock.calls[0] as unknown as [
+      string,
+      Record<string, unknown>,
+    ];
+    expect(updates).not.toHaveProperty("region");
+    expect(profilesRepo.update).not.toHaveBeenCalled();
+  });
+
+  it("refuses to switch a company that never took a manual-registration route", async () => {
+    const { service } = makeService({ id: "company-1", attributes: {} });
+    await expect(service.revertToRegularCompany("user-1")).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+  });
+
+  /**
+   * The switch belongs to both manual-registration routes, not just this one. A
+   * co-operative that has since taken out a trade licence had no way back at
+   * all: the wizard is where the flag is chosen, and an onboarded company can no
+   * longer reach it.
+   */
+  it("switches a co-operative back to eTrade on the same terms", async () => {
+    const { service, companiesRepo, profilesRepo } = makeService({
+      id: "company-1",
+      nationality: CompanyNationality.Ethiopian,
+      attributes: { cooperative: true, etradeManagerName: "Typed Name" },
+      region: "Oromia",
+      licenceNumber: "TYPED-1",
+    });
+
+    await service.revertToRegularCompany("user-1");
+
+    const [, updates] = companiesRepo.update.mock.calls[0] as unknown as [
+      string,
+      Record<string, unknown>,
+    ];
+    expect(updates.attributes).toEqual({});
+    expect(updates.status).toBe(CompanyStatus.Pending);
+    expect(updates.licenceNumber).toBeNull();
+    expect(updates.region).toBeNull();
+    // A co-op owes no per-role business licence; once it stops being one it
+    // does, so the application has to be re-opened and re-reviewed.
+    expect(profilesRepo.update).toHaveBeenCalledWith("external-1", {
+      onboardingCompleted: false,
+      onboardingStep: "company",
+    });
+  });
+
+  /**
+   * Approval of a co-op's role was granted without a business licence, because
+   * a co-op owes none. Leaving makes one due, so the approval no longer stands
+   * for what it said.
+   */
+  it("sends a co-operative's approved roles back for approval", async () => {
+    const { service, companyProfilesRepo } = makeService({
+      id: "company-1",
+      attributes: { cooperative: true },
+    });
+    companyProfilesRepo.findByCompanyId.mockResolvedValue([
+      { id: "role-active", status: ProfileStatus.Active },
+      { id: "role-blocked", status: ProfileStatus.Blacklisted },
+      { id: "role-pending", status: ProfileStatus.Pending },
+    ]);
+
+    await service.revertToRegularCompany("user-1");
+
+    expect(companyProfilesRepo.updateStatus).toHaveBeenCalledWith(
+      "role-active",
+      ProfileStatus.Pending,
+    );
+    // A staff decision is not the customer's to undo by switching registration:
+    // promoting a blocked role to "awaiting approval" would launder the block.
+    expect(companyProfilesRepo.updateStatus).toHaveBeenCalledTimes(1);
+  });
+
+  it("leaves an investor's roles alone — their licences were always due", async () => {
+    const { service, companyProfilesRepo } = makeService({
+      id: "company-1",
+      attributes: { investorLicence: true },
+    });
+    companyProfilesRepo.findByCompanyId.mockResolvedValue([
+      { id: "role-active", status: ProfileStatus.Active },
+    ]);
+
+    await service.revertToRegularCompany("user-1");
+
+    expect(companyProfilesRepo.updateStatus).not.toHaveBeenCalled();
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/companies/companies.license-supersede.spec.ts b/apps/edr-freight-api/src/modules/companies/companies.license-supersede.spec.ts
new file mode 100644
index 000000000..5a73b6040
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/companies.license-supersede.spec.ts
@@ -0,0 +1,187 @@
+import { CompaniesService } from "./companies.service";
+import { CompanyStatus } from "./entities/company.entity";
+import {
+  ProfileStatus,
+  ProfileType,
+} from "./entities/company-profile.entity";
+
+/**
+ * Uploading a business licence only ever adds a row — nothing overwrites. So a
+ * customer answering a rejection or a document correction used to end up with
+ * the refused licence still listed beside the new one, in the portal and in the
+ * backoffice, with nothing saying which is current. An upload that answers a
+ * reviewer now retires what it answers; an upload with nothing outstanding is a
+ * genuine addition and still just adds.
+ */
+interface StoredFile {
+  id: string;
+  name: string;
+  code: string;
+  createdAt: Date;
+  reviewStatus?: string | null;
+  removed?: boolean;
+}
+
+const T0 = new Date("2026-01-01T00:00:00Z");
+const REJECTED_AT = new Date("2026-02-01T00:00:00Z");
+const T2 = new Date("2026-03-01T00:00:00Z");
+
+function makeService(
+  status: ProfileStatus,
+  files: StoredFile[],
+  reviewedAt: Date | null = null,
+) {
+  const stored = [...files];
+  const profile = {
+    id: "profile-1",
+    companyId: "company-1",
+    type: ProfileType.importer,
+    status,
+    reviewedAt,
+  };
+  const company = {
+    id: "company-1",
+    status:
+      status === ProfileStatus.Active
+        ? CompanyStatus.Active
+        : CompanyStatus.Pending,
+    companyProfiles: [profile],
+  };
+
+  const live = () => stored.filter((f) => !f.removed);
+  const filesService = {
+    upload: jest.fn(async (input: { code: string; file: { originalname: string } }) => {
+      const record = {
+        id: `file-${stored.length + 1}`,
+        name: input.file.originalname,
+        code: input.code,
+        createdAt: T2,
+        size: 1,
+        mimeType: "application/pdf",
+      };
+      stored.push(record);
+      return record;
+    }),
+    findByResource: jest.fn(async () => live()),
+    findWithOpenChangeRequest: jest.fn(async () =>
+      live().filter((f) => f.reviewStatus === "change_requested"),
+    ),
+    findById: jest.fn(async (id: string) => ({
+      ...stored.find((f) => f.id === id),
+      resource: "company_profiles",
+      resourceId: "profile-1",
+    })),
+    remove: jest.fn(async (id: string) => {
+      const found = stored.find((f) => f.id === id);
+      if (found) found.removed = true;
+    }),
+    clearReview: jest.fn(async (id: string) => {
+      const found = stored.find((f) => f.id === id);
+      if (found) found.reviewStatus = null;
+    }),
+  };
+
+  const changeRequestRepo = {
+    findPendingByCompanyId: jest.fn(async () => null),
+    create: jest.fn(async (row: Record<string, unknown>) => ({ id: "cr-1", ...row })),
+    update: jest.fn(async () => ({ id: "cr-1" })),
+    findByCompanyId: jest.fn(async () => []),
+  };
+
+  const service = new CompaniesService(
+    { findById: jest.fn(async () => company) } as never,
+    { findByCompanyId: jest.fn(async () => [profile]) } as never,
+    changeRequestRepo as never,
+    {} as never,
+    { findByCompanyId: jest.fn(async () => []) } as never,
+    {} as never,
+    filesService as never,
+    {} as never,
+    {} as never,
+    { changeRequestSubmitted: jest.fn() } as never,
+    {} as never,
+    {} as never,
+  );
+
+  jest
+    .spyOn(service, "getCompanyInfoByUserId")
+    .mockImplementation(
+      async () => ({ profile: { id: "external-1" }, company }) as never,
+    );
+
+  return { service, stored, live, filesService, changeRequestRepo };
+}
+
+const upload = (service: CompaniesService) =>
+  service.addProfileLicenseFiles("user-1", "profile-1", [
+    { originalname: "new-licence.pdf" } as never,
+  ]);
+
+describe("a business licence uploaded to answer a reviewer", () => {
+  it("retires the file the reviewer flagged for correction", async () => {
+    const { service, live } = makeService(ProfileStatus.Pending, [
+      { id: "file-old", name: "old.pdf", code: "business_license", createdAt: T0, reviewStatus: "change_requested" },
+    ]);
+
+    await upload(service);
+
+    expect(live().map((f) => f.name)).toEqual(["new-licence.pdf"]);
+  });
+
+  it("retires what was on file when the role was rejected, but not the customer's own fix so far", async () => {
+    // Two uploads answering one rejection (a second page, or a re-pick) must not
+    // cannibalise each other — only what the reviewer actually refused goes.
+    const { service, live } = makeService(
+      ProfileStatus.Rejected,
+      [
+        { id: "file-refused", name: "refused.pdf", code: "business_license", createdAt: T0 },
+        { id: "file-fix-1", name: "fix-page-1.pdf", code: "business_license", createdAt: T2 },
+      ],
+      REJECTED_AT,
+    );
+
+    await upload(service);
+
+    expect(live().map((f) => f.name)).toEqual([
+      "fix-page-1.pdf",
+      "new-licence.pdf",
+    ]);
+  });
+
+  it("leaves an ordinary addition alone when nothing was asked for", async () => {
+    const { service, live } = makeService(ProfileStatus.Pending, [
+      { id: "file-old", name: "existing.pdf", code: "business_license", createdAt: T0 },
+    ]);
+
+    await upload(service);
+
+    expect(live().map((f) => f.name)).toEqual([
+      "existing.pdf",
+      "new-licence.pdf",
+    ]);
+  });
+
+  it("stages the swap for review on an approved role instead of deleting", async () => {
+    // A live role's licence is not the customer's to remove unilaterally: the
+    // old file stays until a reviewer approves the swap.
+    const { service, live, changeRequestRepo } = makeService(
+      ProfileStatus.Active,
+      [
+        { id: "file-old", name: "old.pdf", code: "business_license", createdAt: T0, reviewStatus: "change_requested" },
+      ],
+    );
+
+    await upload(service);
+
+    expect(live().map((f) => f.name)).toEqual(["old.pdf", "new-licence.pdf"]);
+    const intents = changeRequestRepo.create.mock.calls.flatMap(
+      ([row]) => (row as any).documents.licenseChanges,
+    );
+    expect(intents).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ op: "add", fileId: "file-2" }),
+        expect.objectContaining({ op: "remove", fileId: "file-old" }),
+      ]),
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/companies/companies.module.ts b/apps/edr-freight-api/src/modules/companies/companies.module.ts
index f0a443ba8..666634cb8 100644
--- a/apps/edr-freight-api/src/modules/companies/companies.module.ts
+++ b/apps/edr-freight-api/src/modules/companies/companies.module.ts
@@ -17,6 +17,7 @@ import { CompanyProfile } from "./entities/company-profile.entity";
 import { CompanyChangeRequest } from "./entities/company-change-request.entity";
 import { CompanyRevision } from "./entities/company-revision.entity";
 import { Booking } from "../bookings/entities/booking.entity";
+import { ShippingLineCompaniesModule } from "../shipping-lines/shipping-line-companies.module";
 import { CompanyProfileRepository } from "./company-profile.repository";
 import { CompanyChangeRequestRepository } from "./company-change-request.repository";
 import { CompanyRevisionRepository } from "./company-revision.repository";
@@ -44,6 +45,10 @@ import { VerifaydaModule } from "../verifayda/verifayda.module";
     forwardRef(() => NotificationInboxModule),
     // Fayda identity verification for the company's owner and PoA.
     VerifaydaModule,
+    // `GET /companies/getInfo` serves both portal audiences: it must recognise a
+    // shipping-line session, which has no company row to look up. forwardRef
+    // because that module imports BillingModule, which imports this one.
+    forwardRef(() => ShippingLineCompaniesModule),
   ],
   controllers: [CompaniesController],
   providers: [
@@ -62,6 +67,9 @@ import { VerifaydaModule } from "../verifayda/verifayda.module";
     // Consumed by NotificationInboxModule for portal recipient targeting.
     ExternalProfileRepository,
     CompanyProfileRepository,
+    // Consumed by EimsModule's EimsSellerCacheService — same e-Trade business-registry lookup
+    // already used for every customer company at onboarding, reused for EDR's own TIN.
+    ETradeService,
   ],
 })
 export class CompaniesModule { }
diff --git a/apps/edr-freight-api/src/modules/companies/companies.poa-delegation.spec.ts b/apps/edr-freight-api/src/modules/companies/companies.poa-delegation.spec.ts
index 365bd4639..96dc3ff53 100644
--- a/apps/edr-freight-api/src/modules/companies/companies.poa-delegation.spec.ts
+++ b/apps/edr-freight-api/src/modules/companies/companies.poa-delegation.spec.ts
@@ -174,6 +174,36 @@ describe("PoA delegation paper is enforced wherever PoA state changes", () => {
     ).resolves.toBeDefined();
   });
 
+  it('owes nothing when the company answered "no representative"', async () => {
+    // "The owner represents the company themselves" is now expressed as the
+    // declaration being "no" — there is no delegation, so no paper is due. The
+    // representative's details are cleared with the answer, so there is nothing
+    // left to evidence either.
+    const { service } = makeService({
+      attributes: { ...VERIFIED_IDENTITIES, poaDeclared: "no" },
+    });
+
+    await expect(
+      service.updateProfile("user-1", {} as never),
+    ).resolves.toBeDefined();
+  });
+
+  it("refuses the forwarder role without a paper, however it represents itself", async () => {
+    // The self-representation waiver is gone: a freight forwarder signs on
+    // other companies' behalf, so the delegation and the paper evidencing it
+    // are non-negotiable.
+    const { service } = makeService({
+      attributes: { ...VERIFIED_IDENTITIES, ...POA, poaDeclared: "yes" },
+    });
+
+    await expect(
+      service.createCompanyProfileForUser(
+        "user-1",
+        ProfileType.freightForwarder,
+      ),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
+
   it("rejects a paper the reviewer sent back for correction", async () => {
     const { service } = makeService({ files: [paper("change_requested")] });
 
diff --git a/apps/edr-freight-api/src/modules/companies/companies.profile-approval.spec.ts b/apps/edr-freight-api/src/modules/companies/companies.profile-approval.spec.ts
new file mode 100644
index 000000000..79fbdd479
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/companies.profile-approval.spec.ts
@@ -0,0 +1,115 @@
+import { BadRequestException } from "@nestjs/common";
+
+import { CompaniesService } from "./companies.service";
+import { Company, CompanyStatus } from "./entities/company.entity";
+import {
+  CompanyProfile,
+  ProfileStatus,
+  ProfileType,
+} from "./entities/company-profile.entity";
+
+/**
+ * A rejection hands the role back to the customer: they fix what was flagged
+ * and resubmit (`reapplyCompanyProfile` → Pending). The reviewer used to be
+ * able to skip that entirely and approve straight out of Rejected — granting
+ * the role over the documents that were just refused, while the customer's
+ * "please fix this" note was still on their screen.
+ */
+function makeService(status: ProfileStatus) {
+  const profile: Partial<CompanyProfile> = {
+    id: "profile-1",
+    companyId: "company-1",
+    type: ProfileType.importer,
+    status,
+    reference: null,
+    reviewNote: status === ProfileStatus.Rejected ? "Licence expired" : null,
+  };
+  const company = {
+    id: "company-1",
+    status: CompanyStatus.Pending,
+    attributes: {},
+  };
+
+  const written: Partial<CompanyProfile>[] = [];
+  const profileRepo = {
+    update: jest.fn(async (_id: string, patch: Partial<CompanyProfile>) => {
+      written.push(patch);
+      Object.assign(profile, patch);
+      return null;
+    }),
+    findOne: jest.fn(async () => profile),
+  };
+  const companyRepo = { findOne: jest.fn(async () => company), update: jest.fn() };
+
+  const companyProfilesRepo = {
+    findById: jest.fn(async () => profile),
+    generateReference: jest.fn(async () => "IM-A00001"),
+  };
+  const profilesRepo = {
+    // Onboarding submitted — the other gate in this method is not what these
+    // tests are about.
+    findByCompanyId: jest.fn(async () => [{ onboardingCompleted: true }]),
+  };
+  const filesService = { findWithOpenChangeRequest: jest.fn(async () => []) };
+  const dataSource = {
+    transaction: jest.fn(async (cb: (m: unknown) => Promise<unknown>) =>
+      cb({
+        findOne: jest.fn(async () => company),
+        getRepository: (entity: unknown) =>
+          entity === Company ? companyRepo : profileRepo,
+      }),
+    ),
+  };
+  const companyNotifier = { profileStatusChanged: jest.fn(), companyApproved: jest.fn() };
+
+  const service = new CompaniesService(
+    {} as never,
+    companyProfilesRepo as never,
+    {} as never,
+    {} as never,
+    profilesRepo as never,
+    {} as never,
+    filesService as never,
+    {} as never,
+    {} as never,
+    companyNotifier as never,
+    dataSource as never,
+    {} as never,
+  );
+
+  return { service, profile, written, companyProfilesRepo };
+}
+
+describe("approving an operational role", () => {
+  it("refuses to approve a role the customer has not resubmitted", async () => {
+    const { service, companyProfilesRepo } = makeService(ProfileStatus.Rejected);
+
+    await expect(
+      service.setCompanyProfileStatus("profile-1", ProfileStatus.Active),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    // Refused before any reference could be minted against the rejected role.
+    expect(companyProfilesRepo.generateReference).not.toHaveBeenCalled();
+  });
+
+  it("lets a reviewer undo their own rejection, and drops the note with it", async () => {
+    const { service, written } = makeService(ProfileStatus.Rejected);
+
+    await service.setCompanyProfileStatus("profile-1", ProfileStatus.Pending);
+
+    expect(written[0]).toMatchObject({
+      status: ProfileStatus.Pending,
+      reviewNote: null,
+    });
+  });
+
+  it("still approves a role that is awaiting its first decision", async () => {
+    const { service, written } = makeService(ProfileStatus.Pending);
+
+    await service.setCompanyProfileStatus("profile-1", ProfileStatus.Active);
+
+    expect(written[0]).toMatchObject({
+      status: ProfileStatus.Active,
+      reference: "IM-A00001",
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/companies/companies.role-deselect.spec.ts b/apps/edr-freight-api/src/modules/companies/companies.role-deselect.spec.ts
index 5961be90f..ea81e4dbe 100644
--- a/apps/edr-freight-api/src/modules/companies/companies.role-deselect.spec.ts
+++ b/apps/edr-freight-api/src/modules/companies/companies.role-deselect.spec.ts
@@ -26,7 +26,13 @@ function makeService(existing: ExistingProfile[]) {
     })),
     softDelete: jest.fn(async () => undefined),
   };
-  const companiesRepo = { update: jest.fn(async () => null) };
+  // `findById` is only consulted when the co-operative flag is in play (adding
+  // a forwarder role, or setting the flag itself) — a plain company row is the
+  // right answer for every case here.
+  const companiesRepo = {
+    update: jest.fn(async () => null),
+    findById: jest.fn(async () => ({ id: "company-1", attributes: {} })),
+  };
   const profilesRepo = {
     findByUserId: jest.fn(async () => ({
       id: "external-1",
diff --git a/apps/edr-freight-api/src/modules/companies/companies.service.ts b/apps/edr-freight-api/src/modules/companies/companies.service.ts
index eb6b28b44..d7151f200 100644
--- a/apps/edr-freight-api/src/modules/companies/companies.service.ts
+++ b/apps/edr-freight-api/src/modules/companies/companies.service.ts
@@ -7,6 +7,7 @@ import {
   ForbiddenException,
 } from "@nestjs/common";
 import { DataSource, EntityManager } from "typeorm";
+import { resolveIamUserNames } from "../../common/utils/iam-user-name.util";
 import { CompaniesRepository } from "./companies.repository";
 import { CompanyProfileRepository } from "./company-profile.repository";
 import { CompanyChangeRequestRepository } from "./company-change-request.repository";
@@ -24,6 +25,7 @@ import { FilesService } from "../files/files.service";
 import { FileRecord } from "../files/entities/file.entity";
 import { FileUploadSettingsService } from "../file-upload-settings/file-upload-settings.service";
 import {
+  COOPERATIVE_ONBOARDING_CODE,
   POA_DELEGATION_FILE_KEY,
   POA_DELEGATION_LABEL,
   POA_DELEGATION_PENDING_CODE,
@@ -33,8 +35,13 @@ import {
   buildCompanyIdentityState,
   CompanyIdentityStateDto,
   CompleteIdentityVerificationDto,
+  ETRADE_MANAGER_NAME_KEY,
+  ETRADE_MANAGER_PHONE_KEY,
   IDENTITY_SUBJECTS,
   IdentitySubject,
+  POA_DECLARED_KEY,
+  PoaDeclaration,
+  readPoaDeclaration,
 } from "./dto/complete-identity-verification.dto";
 import { ETradeService } from "./services/etrade.service";
 import { CompanyNotifierService } from "./company-notifier.service";
@@ -55,6 +62,11 @@ import {
   CompanyNationality,
   CompanyStatus,
   CompanyType,
+  COOPERATIVE_KEY,
+  INVESTOR_LICENCE_KEY,
+  hasInvestorLicence,
+  isCooperative,
+  usesManualRegistration,
 } from "./entities/company.entity";
 import { ExternalProfile } from "./entities/external-profile.entity";
 import {
@@ -93,15 +105,16 @@ const POA_ATTRIBUTES = [
   "poaAddress",
 ] as const;
 /**
- * Personnel an approved company maintains itself: its contact person, its
- * general manager and its Power of Attorney. These name who to talk to, not
- * what the company is allowed to do, so freezing the settings page until a
- * reviewer gets to a new phone number costs more than it protects. They write
- * straight to the live row even for an active company.
+ * The one person an approved company maintains itself: its contact person.
+ * That names who to talk to, not what the company is allowed to do, so freezing
+ * the settings page until a reviewer gets to a new phone number costs more than
+ * it protects. It writes straight to the live row even for an active company.
  *
- * The PoA's *delegation letter* is deliberately not here — the paper is the
- * thing that actually evidences the delegation, so it still goes through
- * review (see `uploadPoaDelegationLetter`), as does the owner's own identity.
+ * The owner and the Power of Attorney are deliberately NOT here. Between them
+ * they carry the company's only identity verification — the owner is who the
+ * eTrade licence names, the PoA is who may act for the company — so an edit to
+ * either is exactly the kind of change a reviewer exists to see. Their
+ * delegation letter has always gone through review (`uploadPoaDelegationLetter`).
  */
 const SELF_SERVICE_ATTRIBUTES: readonly string[] = [
   "contactPersonName",
@@ -109,12 +122,8 @@ const SELF_SERVICE_ATTRIBUTES: readonly string[] = [
   "contactPersonEmail",
   "contactPersonPhone",
   "contactVerifiedPhone",
-  "generalManagerName",
-  "generalManagerEmail",
-  "generalManagerPhone",
-  ...POA_ATTRIBUTES,
 ];
-/** Mandatory once the company operates as a freight forwarder. */
+/** Mandatory once the company names a Power of Attorney. */
 const REQUIRED_POA_FIELDS: { key: string; label: string }[] = [
   { key: "poaName", label: "PoA name" },
   { key: "poaEmail", label: "PoA email" },
@@ -122,48 +131,25 @@ const REQUIRED_POA_FIELDS: { key: string; label: string }[] = [
 ];
 
 /**
- * `attributes` key prefix per verifiable person. The owner is NOT the general
- * manager: the owner is who the verification proves the company through, the
- * GM is personnel it names. They're very often the same human, which is what
- * the portal's "same as owner" copy is for.
+ * `attributes` key prefix per person. The owner is whoever the eTrade licence
+ * names as the business's manager; the PoA is whoever the company delegates to.
+ * Exactly one of them carries the company's identity verification — which one
+ * is the company's own declaration (`poaDeclared`).
  */
 const IDENTITY_PREFIX: Record<IdentitySubject, string> = {
   owner: "owner",
   poa: "poa",
-  gm: "gm",
 };
 
-const IDENTITY_LABEL: Record<IdentitySubject, string> = {
-  owner: "owner",
-  poa: "Power of Attorney",
-  gm: "General Manager",
-};
-
-/**
- * Typed GM columns a GM verification also writes. Three notifier services mail
- * `company.generalManagerEmail` directly, so leaving these behind would mean a
- * verified GM whose address the system never actually uses.
- */
-const GM_TYPED_FIELDS = [
-  "generalManagerName",
-  "generalManagerEmail",
-  "generalManagerPhone",
-] as const;
-
 /**
  * Identity fields a Fayda verification owns outright, per person. Once verified
  * these can no longer be typed — the government IdP is the source, so an edit
  * that disagrees with it is either a mistake or an attempt to launder the
  * guarantee away.
- *
- * The GM's entries are its typed columns: a verified GM is locked the same way
- * the others are, while an unverified one (a foreign company's, or a record
- * that predates this) stays freely editable.
  */
 const IDENTITY_OWNED_FIELDS: Record<IdentitySubject, string[]> = {
   owner: ["ownerName", "ownerEmail", "ownerPhone", "ownerAddress"],
   poa: ["poaName", "poaEmail", "poaPhone", "poaAddress"],
-  gm: [...GM_TYPED_FIELDS],
 };
 
 /**
@@ -231,51 +217,63 @@ export class CompaniesService {
     label: string;
     get: (company: Company) => unknown;
   }[] = [
-    {
-      key: "tinNumber",
-      label: "Company TIN",
-      get: (c) => (c.tin && !c.tin.startsWith("D") ? c.tin : null),
-    },
-    { key: "companyEmail", label: "Company email", get: (c) => c.email },
-    { key: "companyPhone", label: "Company phone", get: (c) => c.phone },
-    { key: "companyAddress", label: "Company address", get: (c) => c.address },
-    { key: "fanNumber", label: "FAN number", get: (c) => c.fanNumber },
-    {
-      key: "contactPersonName",
-      label: "Contact person name",
-      get: (c) => c.attributes?.contactPersonName,
-    },
-    {
-      key: "contactPersonPhone",
-      label: "Contact person phone",
-      get: (c) => c.attributes?.contactPersonPhone,
-    },
-    {
-      key: "generalManagerName",
-      label: "General manager name",
-      get: (c) => c.attributes?.generalManagerName,
-    },
-    {
-      key: "generalManagerEmail",
-      label: "General manager email",
-      get: (c) => c.attributes?.generalManagerEmail,
-    },
-    {
-      key: "generalManagerPhone",
-      label: "General manager phone",
-      get: (c) => c.attributes?.generalManagerPhone,
-    },
-  ];
+      {
+        key: "tinNumber",
+        label: "Company TIN",
+        get: (c) => (c.tin && !c.tin.startsWith("D") ? c.tin : null),
+      },
+      { key: "companyAddress", label: "Company address", get: (c) => c.address },
+      { key: "fanNumber", label: "FAN number", get: (c) => c.fanNumber },
+      {
+        key: "contactPersonName",
+        label: "Contact person name",
+        get: (c) => c.attributes?.contactPersonName,
+      },
+      {
+        key: "contactPersonPhone",
+        label: "Contact person phone",
+        get: (c) => c.attributes?.contactPersonPhone,
+      },
+      // The owner — whoever the eTrade licence names as the business's manager.
+      // All three are required whatever their source: the eTrade lookup fills
+      // the name and phone, a Fayda verification can fill all three, and the
+      // portal renders an input for whatever neither supplied. eTrade never
+      // returns an email and Fayda's email claim is optional, so in practice
+      // that field is usually typed — which is fine, because there IS an input
+      // for it. What there is no longer is a fallback to the signed-in account:
+      // the person onboarding is not necessarily the person on the licence, and
+      // silently stamping their address onto the owner made the record a guess.
+      {
+        key: "ownerName",
+        label: "Owner name",
+        get: (c) => c.attributes?.ownerName,
+      },
+      {
+        key: "ownerEmail",
+        label: "Owner email",
+        get: (c) => c.attributes?.ownerEmail,
+      },
+      {
+        key: "ownerPhone",
+        label: "Owner phone",
+        get: (c) => c.attributes?.ownerPhone,
+      },
+    ];
 
-  /** The nationality-based document setting code for a company. */
-  private documentSettingCodeFor(
-    nationality: CompanyNationality | null | undefined,
-  ): string {
-    return nationality === CompanyNationality.Foreign
+  /**
+   * The document setting code for a company: one of three mutually exclusive
+   * sets. A co-operative union or farm resolves to its own set regardless of
+   * nationality — it holds no business licence, so it owes a different list of
+   * papers rather than the nationality list plus extras.
+   */
+  private documentSettingCodeFor(company: Company): string {
+    if (isCooperative(company)) return COOPERATIVE_ONBOARDING_CODE;
+    return company.nationality === CompanyNationality.Foreign
       ? "company_onboarding_documents_foreign"
       : "company_onboarding_documents_ethiopian";
   }
 
+
   async createCompany(dto: CreateCompanyDto): Promise<Company> {
     const exists = await this.companiesRepo.existsByTin(dto.tin);
     if (exists) {
@@ -314,8 +312,6 @@ export class CompaniesService {
       fanNumber: dto.fanNumber ?? null,
       country: dto.companyLocation ?? "Ethiopia",
       address: dto.companyAddress ?? null,
-      phone: normalizeE164(dto.companyPhone) ?? null,
-      email: dto.companyEmail ?? null,
       attributes: dto.attributes ?? null,
     });
 
@@ -384,19 +380,82 @@ export class CompaniesService {
     companyType: CompanyType,
     roles: ProfileType[],
     nationality?: CompanyNationality,
+    cooperative?: boolean,
+    investorLicence?: boolean,
   ): Promise<{ profile: ExternalProfile; company: Company }> {
     // Already started — reuse the existing draft, just ensure roles exist and
     // keep the nationality up to date if it was (re)selected.
     const existing = await this.profilesRepo.findByUserId(identity.userId);
     if (existing) {
       const companyId = existing.company?.id ?? existing.companyId;
+      // Only load the row when the answer actually depends on it: to merge the
+      // flag into `attributes`, or to read a stored one the caller didn't send.
+      const needsCompany =
+        cooperative !== undefined ||
+        investorLicence !== undefined ||
+        roles.includes(ProfileType.freightForwarder);
+      const current = needsCompany
+        ? await this.companiesRepo.findById(companyId)
+        : null;
+      const isCoop = cooperative ?? isCooperative(current);
+      const isInvestor = investorLicence ?? hasInvestorLicence(current);
+      this.assertRolesAllowedForCooperative(isCoop, roles);
+      this.assertNationalityAllowedForCooperative(isCoop, nationality);
+      this.assertInvestorLicenceAllowed(
+        isInvestor,
+        isCoop,
+        nationality ?? current?.nationality ?? undefined,
+      );
       await this.syncCompanyProfiles(companyId, companyType, roles);
-      if (nationality) {
-        await this.companiesRepo.update(companyId, { nationality });
+      const updates: Partial<Company> = {};
+      if (nationality) updates.nationality = nationality;
+      // Ticking the box on a draft that was saved as foreign has to correct the
+      // stored nationality too, or the company keeps resolving to the foreign
+      // document set.
+      if (isCoop) updates.nationality = CompanyNationality.Ethiopian;
+      if (cooperative !== undefined || investorLicence !== undefined) {
+        updates.attributes = {
+          ...(current?.attributes ?? {}),
+          ...(cooperative !== undefined
+            ? { [COOPERATIVE_KEY]: cooperative }
+            : {}),
+          ...(investorLicence !== undefined
+            ? { [INVESTOR_LICENCE_KEY]: investorLicence }
+            : {}),
+        };
+      }
+      // Going back and un-ticking the box is the same act as the settings
+      // switch, so it has to cost the same: the registration the customer typed
+      // goes, and onboarding drops back to the company step. Without this the
+      // draft keeps the typed values, `hasRegistrationDetails` reads as a passed
+      // lookup, resume lands past the company step entirely — and the company
+      // finishes onboarding on unverified data with no flag left to say so.
+      const backToEtrade =
+        usesManualRegistration(current) && !isCoop && !isInvestor;
+      if (backToEtrade) {
+        Object.assign(updates, CompaniesService.CLEARED_REGISTRATION);
+        updates.attributes = this.withoutTypedEtradeManager(
+          updates.attributes ?? current?.attributes,
+        );
+      }
+      if (Object.keys(updates).length > 0) {
+        await this.companiesRepo.update(companyId, updates);
+      }
+      if (backToEtrade) {
+        await this.profilesRepo.update(existing.id, {
+          onboardingStep: "company",
+        });
       }
       return this.getCompanyInfoByUserId(identity.userId);
     }
 
+    this.assertRolesAllowedForCooperative(cooperative === true, roles);
+    this.assertNationalityAllowedForCooperative(cooperative === true, nationality);
+    this.assertInvestorLicenceAllowed(
+      investorLicence === true,
+      cooperative === true,
+      nationality,
+    );
     const allowedTypes = this.getProfileTypeForCompanyType(companyType);
     const chosenTypes = roles.filter((t) => allowedTypes.includes(t));
 
@@ -409,6 +468,14 @@ export class CompaniesService {
       country: "Ethiopia",
       nationality: nationality ?? CompanyNationality.Ethiopian,
       status: CompanyStatus.Pending,
+      ...(cooperative || investorLicence
+        ? {
+            attributes: {
+              ...(cooperative ? { [COOPERATIVE_KEY]: true } : {}),
+              ...(investorLicence ? { [INVESTOR_LICENCE_KEY]: true } : {}),
+            },
+          }
+        : {}),
     });
 
     await this.profilesRepo.create({
@@ -426,6 +493,112 @@ export class CompaniesService {
     return this.getCompanyInfoByUserId(identity.userId);
   }
 
+  /**
+   * A co-operative union or farm cannot hold the freight-forwarder role.
+   *
+   * Forwarding is licensed work — the forwarder signs on other companies'
+   * behalf, which is why the role carries a mandatory Power of Attorney and a
+   * DARS delegation paper. A co-op is here precisely because it has no business
+   * licence, so the role is refused at the door rather than left to fail later
+   * at approval with a document it can never produce.
+   */
+  private assertRolesAllowedForCooperative(
+    cooperative: boolean,
+    roles: ProfileType[],
+  ): void {
+    if (!cooperative) return;
+    if (roles.includes(ProfileType.freightForwarder)) {
+      throw new BadRequestException(
+        "A co-operative union or farm cannot register as a freight forwarder — that role requires a business licence.",
+      );
+    }
+  }
+
+  /**
+   * A co-operative union or farm is registered in Ethiopia by the co-operative
+   * promotion agency, so it is always an Ethiopian company — "foreign" is not a
+   * combination that exists, and allowing it would resolve the company to a
+   * document set built around an investment licence it cannot hold.
+   */
+  private assertNationalityAllowedForCooperative(
+    cooperative: boolean,
+    nationality: CompanyNationality | undefined,
+  ): void {
+    if (!cooperative) return;
+    if (nationality === CompanyNationality.Foreign) {
+      throw new BadRequestException(
+        "A co-operative union or farm is registered in Ethiopia — it cannot onboard as a foreign company.",
+      );
+    }
+  }
+
+  /**
+   * The registration block as it must look when nobody has verified it.
+   *
+   * Used wherever a company stops being one eTrade cannot answer for: whatever
+   * sits in these columns was the customer's own statement, and the wizard
+   * treats a populated registration as a lookup that already passed
+   * (`hasRegistrationDetails`). Leaving it behind would hand the company an
+   * eTrade-verified record eTrade never supplied — and, once the flag is gone,
+   * a backoffice screen that says so.
+   */
+  private static readonly CLEARED_REGISTRATION: Partial<Company> = {
+    licenceNumber: null,
+    statusDescription: null,
+    dateRegistered: null,
+    renewedFrom: null,
+    renewalDate: null,
+    renewedTo: null,
+    region: null,
+    zone: null,
+    woreda: null,
+    kebele: null,
+    houseNo: null,
+    etradePhone: null,
+  };
+
+  /**
+   * The company's own `attributes`, minus the manager captured alongside a
+   * typed registration. It never came from a licence, so it must not outlive
+   * the registration it belonged to.
+   */
+  private withoutTypedEtradeManager(
+    attributes: Record<string, unknown> | null | undefined,
+  ): Record<string, unknown> {
+    const next = { ...(attributes ?? {}) };
+    delete next.etradeManagerName;
+    delete next.etradeManagerPhone;
+    return next;
+  }
+
+  /**
+   * An investment licence belongs to a foreign company and to nothing else.
+   *
+   * It is the Ethiopian Investment Commission's licence, issued to a foreign
+   * investor — an Ethiopian company registers with the trade registry, which is
+   * exactly the eTrade record this flag says does not exist. A co-operative
+   * cannot hold one either: it is Ethiopian by construction, and the two flags
+   * resolve to different document sets, so a company carrying both would owe an
+   * incoherent list of papers.
+   */
+  private assertInvestorLicenceAllowed(
+    investorLicence: boolean,
+    cooperative: boolean,
+    nationality: CompanyNationality | undefined,
+  ): void {
+    if (!investorLicence) return;
+    if (cooperative) {
+      throw new BadRequestException(
+        "A co-operative union or farm is registered in Ethiopia — it cannot also onboard on a foreign investment licence.",
+      );
+    }
+    if (nationality !== CompanyNationality.Foreign) {
+      throw new BadRequestException(
+        "Only a foreign company can onboard on an investment licence.",
+      );
+    }
+  }
+
   /**
    * Reconcile the company's operational profiles with the roles the user has
    * selected: create the missing ones, drop the ones they deselected.
@@ -492,7 +665,8 @@ export class CompaniesService {
   async findCompanyById(id: string): Promise<Company> {
     const company = await this.companiesRepo.findById(id);
     if (!company) throw new NotFoundException(`Company ${id} not found`);
-    company.companyProfiles = await this.companyProfilesRepo.findByCompanyId(id);
+    company.companyProfiles =
+      await this.companyProfilesRepo.findByCompanyId(id);
     // External profiles carry the onboarding flag the backoffice gates
     // approval decisions on (see ResponseCompanyDto.onboardingCompleted).
     company.profiles = await this.profilesRepo.findByCompanyId(id);
@@ -515,9 +689,7 @@ export class CompaniesService {
       );
     }
     if (profile.status !== ProfileStatus.Active) {
-      throw new BadRequestException(
-        "Selected company profile is not active",
-      );
+      throw new BadRequestException("Selected company profile is not active");
     }
     return profile;
   }
@@ -760,11 +932,6 @@ export class CompaniesService {
     };
 
     const keys: string[] = [];
-    if (attrs.ownerFaydaSub) {
-      // The Company-column mirrors of the owner's verified contact details.
-      if (held("ownerEmail")) keys.push("companyEmail");
-      if (held("ownerPhone")) keys.push("companyPhone");
-    }
     for (const subject of IDENTITY_SUBJECTS) {
       if (!attrs[`${IDENTITY_PREFIX[subject]}FaydaSub`]) continue;
       keys.push(...IDENTITY_OWNED_FIELDS[subject].filter(held));
@@ -781,6 +948,7 @@ export class CompaniesService {
     company: Company,
     dto: Partial<UpdateProfileDto> & {
       faydaIdentity?: VerifiedIdentityAttributes;
+      etradeManager?: { name: string; phone: string };
     },
   ): Record<string, any> {
     const companyUpdates: Record<string, any> = {};
@@ -789,9 +957,6 @@ export class CompaniesService {
     if (dto.nationality !== undefined)
       companyUpdates.nationality = dto.nationality;
     if (dto.companyName !== undefined) companyUpdates.name = dto.companyName;
-    if (dto.companyEmail !== undefined) companyUpdates.email = dto.companyEmail;
-    if (dto.companyPhone !== undefined)
-      companyUpdates.phone = normalizeE164(dto.companyPhone);
     if (dto.companyLocation !== undefined)
       companyUpdates.country = dto.companyLocation;
     if (dto.companyAddress !== undefined)
@@ -809,18 +974,19 @@ export class CompaniesService {
     if (dto.contactPersonPhone !== undefined)
       attrUpdates.contactPersonPhone = normalizeE164(dto.contactPersonPhone);
     if (dto.contactVerifiedPhone !== undefined)
-      attrUpdates.contactVerifiedPhone = normalizeE164(dto.contactVerifiedPhone);
-    if (dto.generalManagerName !== undefined)
-      attrUpdates.generalManagerName = dto.generalManagerName;
-    if (dto.generalManagerEmail !== undefined)
-      attrUpdates.generalManagerEmail = dto.generalManagerEmail;
-    if (dto.generalManagerPhone !== undefined)
-      attrUpdates.generalManagerPhone = normalizeE164(dto.generalManagerPhone);
+      attrUpdates.contactVerifiedPhone = normalizeE164(
+        dto.contactVerifiedPhone,
+      );
+    if (dto.ownerName !== undefined) attrUpdates.ownerName = dto.ownerName;
+    if (dto.ownerEmail !== undefined) attrUpdates.ownerEmail = dto.ownerEmail;
+    if (dto.ownerPhone !== undefined)
+      attrUpdates.ownerPhone = normalizeE164(dto.ownerPhone);
     if (dto.poaName !== undefined) attrUpdates.poaName = dto.poaName;
     if (dto.poaPhone !== undefined)
       attrUpdates.poaPhone = normalizeE164(dto.poaPhone);
     if (dto.poaEmail !== undefined) attrUpdates.poaEmail = dto.poaEmail;
-    if (dto.poaLocation !== undefined) attrUpdates.poaLocation = dto.poaLocation;
+    if (dto.poaLocation !== undefined)
+      attrUpdates.poaLocation = dto.poaLocation;
     if (dto.poaAddress !== undefined) attrUpdates.poaAddress = dto.poaAddress;
 
     if (dto.licenceNumber !== undefined)
@@ -842,11 +1008,29 @@ export class CompaniesService {
     if (dto.etradePhone !== undefined)
       companyUpdates.etradePhone = normalizeE164(dto.etradePhone);
 
-    // A plain typed field — never Fayda-verified, so no lock ever applies to
-    // it. Independent of the owner's verification: still required for a
-    // foreign company even if the owner also verifies with Fayda.
+    // Plain typed fields — never Fayda-verified, so no lock ever applies. For a
+    // foreign company a passport number proves the person just as a Fayda
+    // verification does, so it is collected for whichever of the two carries
+    // the company's identity.
     if (dto.ownerPassportNumber !== undefined)
       attrUpdates.ownerPassportNumber = dto.ownerPassportNumber;
+    if (dto.poaPassportNumber !== undefined)
+      attrUpdates.poaPassportNumber = dto.poaPassportNumber;
+
+    // eTrade's own manager, captured at lookup by `applyEtradeSourcedFields`.
+    // Never off the wire — the global pipe runs `forbidNonWhitelisted`, so this
+    // reaches us only from that method, the same guarantee `faydaIdentity` has.
+    // Stored apart from `ownerName`/`ownerPhone` so the two can be COMPARED:
+    // the company asserts an owner, eTrade states a manager, and the backoffice
+    // check is whether they are the same person (`ownerMatchesEtrade`).
+    if (dto.etradeManager) {
+      if (dto.etradeManager.name)
+        attrUpdates[ETRADE_MANAGER_NAME_KEY] = dto.etradeManager.name;
+      if (dto.etradeManager.phone)
+        attrUpdates[ETRADE_MANAGER_PHONE_KEY] = normalizeE164(
+          dto.etradeManager.phone,
+        );
+    }
 
     // A verified identity overwrites the person's details. `faydaIdentity`
     // never comes off the wire — the global validation pipe runs with
@@ -857,26 +1041,17 @@ export class CompaniesService {
       Object.assign(attrUpdates, dto.faydaIdentity);
     }
 
-    // companyEmail/companyPhone are the Company-column mirrors of the owner's
-    // verified contact details (the portal derives and submits them, it never
-    // lets the customer type them once verified) — lock them the same way
-    // ownerEmail/ownerPhone themselves are locked below, once there is a
-    // verified owner to lock them to.
+    // The company's own contact columns follow the owner, verified or not.
     //
-    // Keyed on the verified VALUE, not on `ownerFaydaSub`: Fayda's email and
-    // phone claims are optional, so a verification can prove the person while
-    // supplying neither (see completeIdentityVerification's conditional
-    // spreads). The portal falls back to the account email / eTrade's
-    // registered phone in exactly that case and submits it on every save of
-    // the company step — locking against an absent value would 400 that
-    // forever, and re-verifying could never clear it because Fayda still has
-    // nothing to return.
-    if (attrUpdates.ownerFaydaSub) {
-      if (attrUpdates.ownerEmail && dto.companyEmail !== undefined)
-        companyUpdates.email = attrUpdates.ownerEmail;
-      if (attrUpdates.ownerPhone && dto.companyPhone !== undefined)
-        companyUpdates.phone = normalizeE164(String(attrUpdates.ownerPhone));
-    }
+    // This used to be gated on `ownerFaydaSub`, which meant `companies.email`
+    // was only ever written for a Fayda-verified owner — so every foreign
+    // company (passport instead of Fayda) had none, and the notification
+    // resolver papered over it by falling through to the general manager's
+    // address. The GM is gone and the owner's email is now required outright,
+    // so this is simply where it lands.
+    if (attrUpdates.ownerEmail) companyUpdates.email = attrUpdates.ownerEmail;
+    if (attrUpdates.ownerPhone)
+      companyUpdates.phone = normalizeE164(String(attrUpdates.ownerPhone));
 
     // Renaming a Fayda-verified person by hand would launder the guarantee
     // away, so the verification keeps these fields: a submission that disagrees
@@ -894,12 +1069,10 @@ export class CompaniesService {
         if (dto.faydaIdentity && field in dto.faydaIdentity) continue;
         const stored = company.attributes?.[field];
         // A verification that supplied nothing for this field left no guarantee
-        // to protect, so it stays typeable. Matters most for the GM —
-        // `setGmSameAsOwner` copies `ownerEmail ?? null` onto
-        // `generalManagerEmail` while setting `gmFaydaSub`, and
-        // REQUIRED_COMPANY_INFO still demands that email, so holding a null
-        // here makes it required, hidden by the portal's "same as owner" card,
-        // and unwritable all at once.
+        // to protect, so it stays typeable. This is what makes the required
+        // owner email reachable: Fayda's email claim is optional, so a verified
+        // owner routinely has none stored — locking against that absence would
+        // make `REQUIRED_COMPANY_INFO` demand a field nobody could ever fill.
         if (stored === null || stored === undefined || stored === "") continue;
         attrUpdates[field] = stored;
       }
@@ -985,9 +1158,7 @@ export class CompaniesService {
     if (POA_ATTRIBUTES.some((k) => dto[k] !== undefined)) {
       const attributes = this.mapProfileDtoToCompanyUpdates(company, dto)
         .attributes as Record<string, unknown>;
-      await this.assertPoaDelegationSatisfied(company.id, attributes, {
-        requirePoa: await this.isFreightForwarder(company.id),
-      });
+      await this.assertPoaDelegationSatisfied(company, attributes);
     }
 
     if (company.status !== CompanyStatus.Active) {
@@ -1085,18 +1256,55 @@ export class CompaniesService {
     return new ProfileResponseDto(profile, live, request);
   }
 
-  /** List a company's change requests, newest first (backoffice review). */
-  async listChangeRequests(
-    companyId: string,
-  ): Promise<CompanyChangeRequest[]> {
+  /**
+   * List a company's change requests, newest first (backoffice review). Actor
+   * ids are resolved to display names here — the history screen has to say who
+   * asked for a change and who sent it back, not print two uuids.
+   */
+  async listChangeRequests(companyId: string): Promise<CompanyChangeRequest[]> {
     await this.findCompanyById(companyId);
-    return this.changeRequestRepo.findByCompanyId(companyId);
+    const requests = await this.changeRequestRepo.findByCompanyId(companyId);
+    const names = await this.resolveActorNames(
+      requests.flatMap((r) => [r.submittedBy, r.reviewedBy]),
+    );
+    for (const request of requests) {
+      request.submittedByName = request.submittedBy
+        ? (names.get(request.submittedBy) ?? null)
+        : null;
+      request.reviewedByName = request.reviewedBy
+        ? (names.get(request.reviewedBy) ?? null)
+        : null;
+    }
+    return requests;
   }
 
   /** Onboarding-phase edit history (see {@link recordCompanyRevision}), newest first. */
   async listCompanyRevisions(companyId: string): Promise<CompanyRevision[]> {
     await this.findCompanyById(companyId);
-    return this.revisionRepo.findByCompanyId(companyId);
+    const revisions = await this.revisionRepo.findByCompanyId(companyId);
+    const names = await this.resolveActorNames(revisions.map((r) => r.actorId));
+    for (const revision of revisions) {
+      revision.actorName = revision.actorId
+        ? (names.get(revision.actorId) ?? null)
+        : null;
+    }
+    return revisions;
+  }
+
+  /**
+   * Display names for actor ids, one query for the whole list. A lookup failure
+   * degrades the history to ids rather than failing the request — the entry is
+   * still worth showing without the name.
+   */
+  private async resolveActorNames(
+    actorIds: (string | null | undefined)[],
+  ): Promise<Map<string, string>> {
+    try {
+      return await resolveIamUserNames(this.dataSource, actorIds);
+    } catch (err) {
+      this.logger.warn(`Could not resolve actor names: ${String(err)}`);
+      return new Map();
+    }
   }
 
   /**
@@ -1150,8 +1358,7 @@ export class CompaniesService {
     reviewerId?: string,
   ): Promise<CompanyChangeRequest> {
     const request = await this.changeRequestRepo.findById(id);
-    if (!request)
-      throw new NotFoundException(`Change request ${id} not found`);
+    if (!request) throw new NotFoundException(`Change request ${id} not found`);
     if (request.status !== ChangeRequestStatus.Pending) {
       throw new BadRequestException(
         `Change request ${id} is already ${request.status}`,
@@ -1164,7 +1371,10 @@ export class CompaniesService {
 
     const snapshot = (request.snapshot ?? {}) as Partial<UpdateProfileDto>;
     await this.assertTinAvailable(company, snapshot.tin);
-    const companyUpdates = this.mapProfileDtoToCompanyUpdates(company, snapshot);
+    const companyUpdates = this.mapProfileDtoToCompanyUpdates(
+      company,
+      snapshot,
+    );
     await this.companiesRepo.update(company.id, companyUpdates);
     await this.applyLicenseChanges(request);
     await this.applyDocumentChanges(request);
@@ -1222,7 +1432,7 @@ export class CompaniesService {
     uploaded: FileRecord[],
   ): Promise<CompanyRevisionChange[]> {
     const setting = await this.fileUploadSettingsService
-      .getByCode(this.documentSettingCodeFor(company.nationality))
+      .getByCode(this.documentSettingCodeFor(company))
       .catch(() => null);
     const fields = setting?.fields ?? [];
     const singleFileCodes = new Set(
@@ -1294,7 +1504,12 @@ export class CompaniesService {
       );
     }
     if (documentChanges.length > 0) {
-      await this.recordCompanyRevision(company, {}, submittedBy, documentChanges);
+      await this.recordCompanyRevision(
+        company,
+        {},
+        submittedBy,
+        documentChanges,
+      );
     }
     return uploaded;
   }
@@ -1414,7 +1629,11 @@ export class CompaniesService {
         status: ChangeRequestStatus.Pending,
       });
       if (company) {
-        this.companyNotifier.changeRequestSubmitted(company, existing.id, false);
+        this.companyNotifier.changeRequestSubmitted(
+          company,
+          existing.id,
+          false,
+        );
       }
     } else {
       const history = await this.changeRequestRepo.findByCompanyId(companyId);
@@ -1446,8 +1665,7 @@ export class CompaniesService {
     reviewerId?: string,
   ): Promise<CompanyChangeRequest> {
     const request = await this.changeRequestRepo.findById(id);
-    if (!request)
-      throw new NotFoundException(`Change request ${id} not found`);
+    if (!request) throw new NotFoundException(`Change request ${id} not found`);
     if (request.status !== ChangeRequestStatus.Pending) {
       throw new BadRequestException(
         `Change request ${id} is already ${request.status}`,
@@ -1455,6 +1673,7 @@ export class CompaniesService {
     }
     await this.discardLicenseChanges(request);
     await this.discardDocumentChanges(request);
+    await this.notifyChangeRequestReturned(request, "rejected", note, reviewerId);
     return (
       (await this.changeRequestRepo.update(id, {
         status: ChangeRequestStatus.Rejected,
@@ -1486,13 +1705,18 @@ export class CompaniesService {
     reviewerId?: string,
   ): Promise<CompanyChangeRequest> {
     const request = await this.changeRequestRepo.findById(id);
-    if (!request)
-      throw new NotFoundException(`Change request ${id} not found`);
+    if (!request) throw new NotFoundException(`Change request ${id} not found`);
     if (request.status !== ChangeRequestStatus.Pending) {
       throw new BadRequestException(
         `Change request ${id} is already ${request.status}`,
       );
     }
+    await this.notifyChangeRequestReturned(
+      request,
+      "changes_requested",
+      note,
+      reviewerId,
+    );
     return (
       (await this.changeRequestRepo.update(id, {
         status: ChangeRequestStatus.ChangesRequested,
@@ -1503,6 +1727,35 @@ export class CompaniesService {
     );
   }
 
+  /**
+   * Tell the customer desk a change request came back unapproved. Best-effort:
+   * a missing company or an unresolvable reviewer name must not fail the
+   * reviewer's decision, which is already the point of the try/catch.
+   */
+  private async notifyChangeRequestReturned(
+    request: CompanyChangeRequest,
+    outcome: "rejected" | "changes_requested",
+    note: string,
+    reviewerId?: string,
+  ): Promise<void> {
+    try {
+      const company = await this.companiesRepo.findById(request.companyId);
+      if (!company) return;
+      const names = await this.resolveActorNames([reviewerId]);
+      this.companyNotifier.changeRequestReturned(
+        company,
+        request.id,
+        outcome,
+        note,
+        reviewerId ? (names.get(reviewerId) ?? null) : null,
+      );
+    } catch (err) {
+      this.logger.warn(
+        `Could not notify the customer desk about ${request.id}: ${String(err)}`,
+      );
+    }
+  }
+
   async deleteCompany(id: string): Promise<void> {
     await this.findCompanyById(id);
     await this.companiesRepo.softDelete(id);
@@ -1569,10 +1822,7 @@ export class CompaniesService {
     const reactivating =
       status === ProfileStatus.Active &&
       existing.status === ProfileStatus.Suspended;
-    if (
-      (status === ProfileStatus.Suspended || reactivating) &&
-      !note?.trim()
-    ) {
+    if ((status === ProfileStatus.Suspended || reactivating) && !note?.trim()) {
       throw new BadRequestException(
         status === ProfileStatus.Suspended
           ? "A message explaining the suspension is required — the customer will see it."
@@ -1580,6 +1830,24 @@ export class CompaniesService {
       );
     }
 
+    // A rejected role is waiting on the customer, not on the reviewer: nothing
+    // has been resubmitted, and the note telling them what to fix is still on
+    // their screen. Approving straight out of Rejected grants the very role that
+    // was refused, over the documents that were refused with it. The way back is
+    // the customer's own resubmission (`reapplyCompanyProfile` → Pending); a
+    // rejection made in error is undone by moving the role back to pending
+    // review first — the same shape as "withdraw the change request first" on
+    // the document gate below.
+    if (
+      status === ProfileStatus.Active &&
+      existing.status === ProfileStatus.Rejected
+    ) {
+      throw new BadRequestException(
+        "This role was rejected — the customer has to fix what was flagged and resubmit it before it can be approved. " +
+          "If the rejection was a mistake, move the role back to pending review first.",
+      );
+    }
+
     // A self-registered company is only reviewable once its owner submits the
     // onboarding wizard (markOnboardingComplete) — until then its profiles are
     // half-filled drafts and approving one would mint a reference against an
@@ -1594,7 +1862,9 @@ export class CompaniesService {
       existing.status === ProfileStatus.Pending ||
       existing.status === ProfileStatus.Rejected;
     if (awaitingReview) {
-      const owners = await this.profilesRepo.findByCompanyId(existing.companyId);
+      const owners = await this.profilesRepo.findByCompanyId(
+        existing.companyId,
+      );
       if (owners.length > 0 && !owners.some((o) => o.onboardingCompleted)) {
         throw new BadRequestException(
           "This customer hasn't finished onboarding yet. Their roles can be reviewed once they submit their application.",
@@ -1629,12 +1899,13 @@ export class CompaniesService {
       // the last place it has to be checked — the role may have been applied
       // for before the paper was withdrawn.
       if (company && existing.type === ProfileType.freightForwarder) {
-        this.assertIdentityVerified(company, { requirePoa: true });
-        await this.assertPoaDelegationSatisfied(
-          company.id,
-          company.attributes,
-          { requirePoa: true },
-        );
+        // The row was loaded FOR UPDATE, so its relations are not populated —
+        // and `readPoaDeclaration` reads `companyProfiles` to force "yes" for a
+        // forwarder. This IS the forwarder profile being approved, so naming it
+        // is enough (and truthful) for both assertions below.
+        company.companyProfiles = company.companyProfiles ?? [existing];
+        this.assertIdentityVerified(company);
+        await this.assertPoaDelegationSatisfied(company, company.attributes);
       }
 
       const [companyDocs, profileDocs] = await Promise.all([
@@ -1652,11 +1923,17 @@ export class CompaniesService {
         const names = pending.map((f) => f.name).join(", ");
         throw new BadRequestException(
           `This role has ${pending.length} document(s) awaiting customer correction (${names}). ` +
-            `Approve it once the customer has re-uploaded them, or withdraw the change request first.`,
+          `Approve it once the customer has re-uploaded them, or withdraw the change request first.`,
         );
       }
 
-      return this.applyProfileStatus(manager, existing, status, note, reviewerId);
+      return this.applyProfileStatus(
+        manager,
+        existing,
+        status,
+        note,
+        reviewerId,
+      );
     });
   }
 
@@ -1699,7 +1976,14 @@ export class CompaniesService {
       status === ProfileStatus.Suspended
     ) {
       patch.reviewNote = note ?? null;
-    } else if (status === ProfileStatus.Active) {
+    } else if (
+      status === ProfileStatus.Active ||
+      status === ProfileStatus.Pending
+    ) {
+      // Pending only reaches here when a reviewer withdraws their own rejection
+      // (the customer's resubmission clears the note in `reapplyCompanyProfile`),
+      // so the reason they gave goes with it — leaving it would keep telling the
+      // customer to fix something nobody is waiting on any more.
       patch.reviewNote = null;
     }
     if (status !== ProfileStatus.Pending) {
@@ -1892,11 +2176,12 @@ export class CompaniesService {
       // without a Power of Attorney and its DARS paper — checked here so the
       // customer is told at the point of asking, not at review.
       if (type === ProfileType.freightForwarder) {
-        this.assertIdentityVerified(company, { requirePoa: true });
+        this.assertRolesAllowedForCooperative(isCooperative(company), [type]);
+        const asForwarder = this.withProfileType(company, type);
+        this.assertIdentityVerified(asForwarder);
         await this.assertPoaDelegationSatisfied(
-          companyId,
+          asForwarder,
           await this.effectivePoaAttributes(company),
-          { requirePoa: true },
         );
       }
 
@@ -1938,11 +2223,12 @@ export class CompaniesService {
 
     let created = await this.companyProfilesRepo.findByType(companyId, type);
     if (!created && type === ProfileType.freightForwarder) {
-      this.assertIdentityVerified(company, { requirePoa: true });
+      this.assertRolesAllowedForCooperative(isCooperative(company), [type]);
+      const asForwarder = this.withProfileType(company, type);
+      this.assertIdentityVerified(asForwarder);
       await this.assertPoaDelegationSatisfied(
-        companyId,
+        asForwarder,
         await this.effectivePoaAttributes(company),
-        { requirePoa: true },
       );
     }
     if (!created) {
@@ -1991,8 +2277,13 @@ export class CompaniesService {
       .filter((f) => !f.get(company))
       .map((f) => ({ key: f.key, label: f.label }));
 
-    // 2. Nationality-based company documents + which are already uploaded.
-    const documentSettingCode = this.documentSettingCodeFor(company.nationality);
+    // 2. Company documents + which are already uploaded. One set applies: the
+    // company's nationality set, or the co-operative set in its place — a union
+    // or farm holds no business licence, so it owes its own list rather than the
+    // nationality list plus extras.
+    const cooperative = isCooperative(company);
+    const investorLicence = hasInvestorLicence(company);
+    const documentSettingCode = this.documentSettingCodeFor(company);
     const [setting, uploadedFiles] = await Promise.all([
       this.fileUploadSettingsService
         .getByCode(documentSettingCode)
@@ -2032,35 +2323,53 @@ export class CompaniesService {
         };
       }),
     );
-    const missingLicenses = licenseProfiles.filter((p) => !p.uploaded);
+    // A co-operative holds no business licence — that is the whole reason it
+    // skips the eTrade lookup — so the per-role licence is not owed. Its own
+    // document set (merged above) is what stands in for it. The profiles are
+    // still reported so the portal can show them; only the requirement lifts.
+    const missingLicenses = cooperative
+      ? []
+      : licenseProfiles.filter((p) => !p.uploaded);
 
-    // 4. Power of Attorney. Optional in general, but a freight forwarder acts on
-    // other companies' behalf so its PoA is mandatory. Either way, a PoA that
-    // has been entered must be evidenced by the DARS delegation paper — a legal
-    // requirement, so unlike the documents above it does not depend on the
-    // upload set carrying a field for it (see poa-delegation.constants.ts).
-    const poaRequired = (company.companyProfiles ?? []).some(
-      (p) => p.type === ProfileType.freightForwarder,
-    );
-    const poaProvided = POA_ATTRIBUTES.some((k) =>
-      (company.attributes?.[k] as string | undefined)?.trim(),
-    );
-    // No company types its PoA details — they arrive from the Fayda
-    // verification whatever the nationality — so reporting them as missing
-    // fields would ask for something no form offers. The identity block below
-    // reports "verify your PoA" instead.
-    const missingPoaFields: typeof REQUIRED_POA_FIELDS = [];
+    // 4. Power of Attorney. Whether there is one at all is the company's own
+    // declaration — the question the wizard asks outright — and that answer is
+    // what decides whose identity gets verified, so an unanswered one is itself
+    // outstanding. A freight forwarder never gets to answer: it signs on other
+    // companies' behalf, so `readPoaDeclaration` forces "yes".
+    //
+    // Once there IS a representative, their details and the DARS delegation
+    // paper are both due. The paper is a legal requirement, so unlike the
+    // documents above it does not depend on the upload set carrying a field for
+    // it (see poa-delegation.constants.ts).
+    const poaDue = identity.poaDeclared === "yes";
     const delegation = await this.getPoaDelegationState(company.id);
-    const delegationDue = poaRequired || poaProvided;
+    const delegationDue = poaDue;
+    // The representative's details normally arrive from their Fayda
+    // verification — but Fayda's email and phone claims are optional and
+    // routinely come back empty, and the PoA step renders an input for whatever
+    // the verification did not supply. So these are askable after all, and are
+    // reported outstanding once a PoA is declared; reporting nothing here let a
+    // freight forwarder finish onboarding with a representative the API's own
+    // `REQUIRED_POA_FIELDS` calls incomplete, then 400'd their next PoA edit.
+    const missingPoaFields = poaDue
+      ? REQUIRED_POA_FIELDS.filter(
+        (f) => !(company.attributes?.[f.key] as string | undefined)?.trim(),
+      )
+      : [];
     const missingDelegation = delegationDue && !delegation.onFile;
     // A paper the reviewer sent back is not evidence — the customer has to
     // replace it before the application counts as complete.
     const flaggedDelegation = delegationDue && delegation.flagged;
 
-    // Mirrors `poaProven` in buildCompanyIdentityState — see the note there.
-    const poaProven = identity.faydaRequired
-      ? identity.poa.verified
-      : identity.poa.verified || Boolean(identity.poa.name?.trim());
+    // 5. The single identity. Who proves it is `identity.subject`; how they may
+    // prove it is nationality-dependent (Fayda always, a passport number as an
+    // alternative for a foreign company). Both are derived once in
+    // buildCompanyIdentityState so this list can never disagree with the gate
+    // `assertIdentityVerified` actually enforces.
+    const identitySubjectLabel =
+      identity.subject === "poa"
+        ? "your Power of Attorney"
+        : "the person named on your eTrade licence";
 
     const outstanding = [
       ...missingInfo.map((f) => `Add your ${f.label.toLowerCase()}`),
@@ -2074,57 +2383,42 @@ export class CompaniesService {
         ? [`Upload the ${POA_DELEGATION_LABEL} for your Power of Attorney`]
         : []),
       ...(flaggedDelegation
-        ? [`Re-upload your ${POA_DELEGATION_LABEL} — EDR asked for a correction`]
-        : []),
-      ...(identity.faydaRequired && !identity.owner.verified
-        ? ["Verify the company owner's identity with Fayda"]
-        : []),
-      // Nationality-aware, exactly like `poaProven` in
-      // buildCompanyIdentityState and the check in `assertIdentityVerified`:
-      // Fayda is an Ethiopian national ID, so a foreign company's typed
-      // representative has to count. Demanding a verification here regardless
-      // made this list disagree with the rule actually enforced, and left a
-      // foreign freight forwarder unable to submit — asked for a Fayda
-      // verification its representative may have no way to obtain.
-      ...((poaRequired || poaProvided) && !poaProven
         ? [
-            identity.faydaRequired
-              ? "Verify your Power of Attorney's identity with Fayda"
-              : "Name your Power of Attorney, or verify them with Fayda",
-          ]
+          `Re-upload your ${POA_DELEGATION_LABEL} — EDR asked for a correction`,
+        ]
         : []),
-      ...(identity.passportRequired && !identity.owner.passportNumber
-        ? ["Add the company owner's passport number"]
+      ...(identity.poaDeclared === null
+        ? ["Tell us whether anyone holds power of attorney for your company"]
+        : []),
+      ...(identity.poaDeclared !== null && !identity.identityProven
+        ? [
+          identity.passportAccepted
+            ? `Verify ${identitySubjectLabel} with Fayda, or add their passport number`
+            : `Verify ${identitySubjectLabel} with Fayda`,
+        ]
         : []),
     ];
 
     // Progress spans every required item the user has to satisfy: company-info
-    // fields, required documents, one license per operational profile, and the
-    // PoA details/paper whenever those are mandatory.
+    // fields, required documents, one license per operational profile, the PoA
+    // details/paper once declared, and the two identity items — answering the
+    // declaration, and proving the person it points at.
     const requiredDocCount = documents.filter((d) => d.isRequired).length;
-    const poaItemCount = delegationDue ? 1 : 0;
-    // One item per identity credential the company has to prove: the owner
-    // always (Fayda for Ethiopian, passport for foreign), plus the PoA once
-    // there is one — Fayda for an Ethiopian company, a named representative
-    // for a foreign one, same rule as `poaProven` above. Counting a foreign
-    // company's typed PoA as unproven here left the progress bar permanently
-    // short of 100% on an item it had already satisfied.
-    const ownerCredentialDue =
-      identity.faydaRequired || identity.passportRequired;
-    const ownerCredentialProven = identity.faydaRequired
-      ? identity.owner.verified
-      : Boolean(identity.owner.passportNumber);
-    const identityItemCount =
-      (ownerCredentialDue ? 1 : 0) + (delegationDue ? 1 : 0);
+    // The delegation paper plus the representative's own required details —
+    // `completed` below subtracts every one of those it is still missing, so
+    // leaving them out of the total would make the bar understate progress.
+    const poaItemCount =
+      (poaDue ? REQUIRED_POA_FIELDS.length : 0) + (delegationDue ? 1 : 0);
     const missingIdentityCount =
-      (ownerCredentialDue && !ownerCredentialProven ? 1 : 0) +
-      (delegationDue && !poaProven ? 1 : 0);
+      (identity.poaDeclared === null ? 1 : 0) +
+      (identity.identityProven ? 0 : 1);
     const total =
       requiredInfo.length +
       requiredDocCount +
-      licenseProfiles.length +
+      (cooperative ? 0 : licenseProfiles.length) +
       poaItemCount +
-      identityItemCount;
+      // The declaration and the verification it selects.
+      2;
     const completed =
       total -
       (missingInfo.length +
@@ -2137,12 +2431,22 @@ export class CompaniesService {
     return new OnboardingRequirementsResponseDto({
       documentSettingCode,
       nationality: company.nationality ?? CompanyNationality.Ethiopian,
-      companyInfo: { complete: missingInfo.length === 0, missingFields: missingInfo },
+      cooperative,
+      investorLicence,
+      companyInfo: {
+        complete: missingInfo.length === 0,
+        missingFields: missingInfo,
+      },
       documents,
       licenseProfiles,
       poa: {
-        required: poaRequired,
-        provided: poaProvided,
+        // "Locked" rather than "required": a freight forwarder is not asked the
+        // question at all, everyone else answers it themselves.
+        locked: identity.poaDeclared === "yes" && (company.companyProfiles ?? []).some(
+          (p) => p.type === ProfileType.freightForwarder,
+        ),
+        declared: identity.poaDeclared,
+        delegationLetterRequired: delegationDue,
         delegationLetterUploaded: delegation.onFile,
         delegationLetterFlagged: delegation.flagged,
         missingFields: missingPoaFields,
@@ -2179,7 +2483,7 @@ export class CompaniesService {
     if (!requirements.isComplete) {
       throw new BadRequestException(
         requirements.outstanding[0] ??
-          "Your onboarding is incomplete. Please complete all required steps before submitting.",
+        "Your onboarding is incomplete. Please complete all required steps before submitting.",
       );
     }
 
@@ -2188,7 +2492,10 @@ export class CompaniesService {
     const profiles = await this.companyProfilesRepo.findByCompanyId(companyId);
     for (const cp of profiles) {
       if (cp.status !== ProfileStatus.Pending) {
-        await this.companyProfilesRepo.updateStatus(cp.id, ProfileStatus.Pending);
+        await this.companyProfilesRepo.updateStatus(
+          cp.id,
+          ProfileStatus.Pending,
+        );
       }
     }
 
@@ -2203,6 +2510,97 @@ export class CompaniesService {
     return this.getCompanyInfoByUserId(userId);
   }
 
+  /**
+   * Drop whichever manual-registration route the company is on and send it back
+   * through the normal eTrade one.
+   *
+   * Both routes exist for the same reason — eTrade holds no record to fetch —
+   * so leaving one is the same act whichever it is, and it is the only way back
+   * to eTrade for either. A co-operative union or farm that has since taken out
+   * a trade licence had no exit at all before this; its only route was the
+   * wizard, which an onboarded company can no longer reach.
+   *
+   * Everything the flag let the customer type is cleared, not kept: the
+   * registration block on file was their own statement, and leaving it there
+   * would let the wizard treat the company as already looked-up
+   * (`hasRegistrationDetails` is what stands in for a verified TIN on a
+   * resume) and walk straight past the eTrade step this switch exists to
+   * reach. Onboarding reopens at the company step and the company goes back to
+   * pending — an approval granted against typed data cannot silently carry over
+   * to a record that now claims to be eTrade's.
+   *
+   * Switching the other way — INTO a co-operative or an investment licence — is
+   * deliberately not here. It is the wizard's nationality/role step, which this
+   * reopens, and which is the one place the mutually-exclusive rules live
+   * (`assertInvestorLicenceAllowed`, `assertRolesAllowedForCooperative`,
+   * `assertNationalityAllowedForCooperative`). A second entry point would have
+   * to restate all three.
+   */
+  async revertToRegularCompany(
+    userId: string,
+  ): Promise<{ profile: ExternalProfile; company: Company }> {
+    const profile = await this.profilesRepo.findByUserId(userId);
+    if (!profile)
+      throw new NotFoundException(`Profile for user ${userId} not found`);
+
+    const companyId = profile.company?.id ?? profile.companyId;
+    const company = await this.companiesRepo.findById(companyId);
+    if (!company)
+      throw new NotFoundException(`Company ${companyId} not found`);
+    if (!usesManualRegistration(company)) {
+      throw new BadRequestException(
+        "This company is already registered through eTrade — there is nothing to switch.",
+      );
+    }
+
+    const wasCooperative = isCooperative(company);
+
+    // Both flags go, not just the one that was set: they are mutually exclusive
+    // and a company can only ever hold one, but the destination is "neither",
+    // so stripping only the one we happened to check for would leave the other
+    // behind if the pair ever did coexist.
+    const attributes = this.withoutTypedEtradeManager(company.attributes);
+    delete attributes[INVESTOR_LICENCE_KEY];
+    delete attributes[COOPERATIVE_KEY];
+
+    await this.companiesRepo.update(companyId, {
+      ...CompaniesService.CLEARED_REGISTRATION,
+      attributes,
+      status: CompanyStatus.Pending,
+    });
+    await this.profilesRepo.update(profile.id, {
+      onboardingCompleted: false,
+      onboardingStep: "company",
+    });
+
+    // A co-operative owes no per-role business licence — that is the whole
+    // reason its own document set stands in for one. The moment it stops being
+    // one, every role owes a licence that was never uploaded, so an approval
+    // granted without one no longer means what it said: back to Pending, and
+    // the reviewer sees the licence with the rest of the re-application.
+    //
+    // Only Active roles move. Rejected, Suspended and Blacklisted are the
+    // backoffice's own decisions, and quietly promoting a blocked role to
+    // "awaiting approval" would launder the block away. The reference survives
+    // either way — it is minted once (`setCompanyProfileStatus`) and re-approval
+    // reuses it, so bookings that cite it keep citing the same number.
+    //
+    // An investor is untouched: it always held a licence per role, so nothing
+    // becomes due that was not already reviewed.
+    if (wasCooperative) {
+      const roles = await this.companyProfilesRepo.findByCompanyId(companyId);
+      for (const role of roles) {
+        if (role.status !== ProfileStatus.Active) continue;
+        await this.companyProfilesRepo.updateStatus(
+          role.id,
+          ProfileStatus.Pending,
+        );
+      }
+    }
+
+    return this.getCompanyInfoByUserId(userId);
+  }
+
   /**
    * Block a self-service action when the company account isn't active, naming
    * the actual status — a suspended customer told "awaiting approval" has no
@@ -2214,12 +2612,12 @@ export class CompaniesService {
       case CompanyStatus.Suspended:
         throw new ForbiddenException(
           `Your company account is suspended — you can't create ${action} right now. ` +
-            `Please contact EDR support for details.`,
+          `Please contact EDR support for details.`,
         );
       case CompanyStatus.Blacklisted:
         throw new ForbiddenException(
           `Your company account is blacklisted — you can't create ${action}. ` +
-            `Please contact EDR support.`,
+          `Please contact EDR support.`,
         );
       default:
         throw new ForbiddenException(
@@ -2248,8 +2646,7 @@ export class CompaniesService {
     switch (profile.status) {
       case ProfileStatus.Suspended:
         throw new ForbiddenException(
-          `Your ${role} role is suspended${
-            profile.reviewNote ? ` — ${profile.reviewNote}` : ""
+          `Your ${role} role is suspended${profile.reviewNote ? ` — ${profile.reviewNote}` : ""
           }. Your other roles are unaffected. Please contact EDR support to resolve this.`,
         );
       case ProfileStatus.Blacklisted:
@@ -2258,8 +2655,7 @@ export class CompaniesService {
         );
       case ProfileStatus.Rejected:
         throw new ForbiddenException(
-          `Your ${role} role was rejected${
-            profile.reviewNote ? ` — ${profile.reviewNote}` : ""
+          `Your ${role} role was rejected${profile.reviewNote ? ` — ${profile.reviewNote}` : ""
           }. Amend and resubmit it from your settings page.`,
         );
       default:
@@ -2304,6 +2700,9 @@ export class CompaniesService {
    * with the role itself. Only for an already-approved role are they staged under
    * the pending code and recorded as `add` intents on a pending change request —
    * a licence swap on a live role is a change; a licence on a new role is not.
+   *
+   * An upload that answers a reviewer also retires the licence it answers (see
+   * below), so a correction never leaves both copies on file.
    */
   async addProfileLicenseFiles(
     userId: string,
@@ -2315,6 +2714,28 @@ export class CompaniesService {
     const gated = profile.status === ProfileStatus.Active;
     const code = gated ? LICENSE_PENDING_CODE : LICENSE_CODE;
 
+    // An upload that answers the reviewer replaces what they refused; it does
+    // not sit next to it. Uploading only ever adds a row, so without this the
+    // refused licence stays listed in the portal and the backoffice beside the
+    // new one and nothing says which is current. Two things count as refused:
+    // the file the reviewer flagged for correction, and — when the whole role
+    // came back rejected — every licence that was already on file when they
+    // rejected it. Anything the customer uploaded *since* that decision is part
+    // of the same fix (a second page, a re-pick), so it survives, and an upload
+    // with nothing outstanding is a genuine addition and is left alone.
+    const rejectedAt =
+      profile.status === ProfileStatus.Rejected
+        ? (profile.reviewedAt ?? null)
+        : null;
+    const superseded = rejectedAt
+      ? (
+          await this.filesService.findByResource(profileId, LICENSE_RESOURCE)
+        ).filter((f) => f.createdAt < rejectedAt)
+      : await this.filesService.findWithOpenChangeRequest(
+          [profileId],
+          LICENSE_RESOURCE,
+        );
+
     const uploaded = await Promise.all(
       files.map((file) =>
         this.filesService.upload({
@@ -2339,6 +2760,13 @@ export class CompaniesService {
       );
     }
 
+    // Retire what the upload supersedes, through the normal removal path so an
+    // approved role stages a `remove` intent (reviewed as a swap) while an
+    // unapproved one just drops the file.
+    for (const stale of superseded) {
+      await this.removeProfileLicenseFile(userId, profileId, stale.id);
+    }
+
     // A fresh licence upload answers any correction the reviewer asked for on the
     // previous one, so the old row must stop blocking approval.
     await this.resolveDocumentChangeRequests(
@@ -2518,9 +2946,7 @@ export class CompaniesService {
       LICENSE_RESOURCE,
     );
     return records
-      .filter(
-        (r) => r.code === LICENSE_CODE || r.code === LICENSE_PENDING_CODE,
-      )
+      .filter((r) => r.code === LICENSE_CODE || r.code === LICENSE_PENDING_CODE)
       .map((r) => ({
         id: r.id,
         name: r.name,
@@ -2673,85 +3099,193 @@ export class CompaniesService {
    * judged against the files that would survive it (`ignoreFileIds`).
    */
   private async assertPoaDelegationSatisfied(
-    companyId: string,
+    company: Company,
     attributes: Record<string, unknown> | null | undefined,
-    opts: { requirePoa: boolean; ignoreFileIds?: string[] },
+    opts: { ignoreFileIds?: string[] } = {},
   ): Promise<void> {
+    // The declaration is the whole gate. A company that says it has no
+    // representative owes nothing here; one that says it has owes the details
+    // AND the paper, with no exceptions — including a freight forwarder, for
+    // whom `readPoaDeclaration` forces "yes" regardless of what is stored.
+    const declared = readPoaDeclaration({
+      attributes: attributes as Company["attributes"],
+      companyProfiles: company.companyProfiles,
+    });
+    if (declared !== "yes") return;
+
+    const isForwarder = (company.companyProfiles ?? []).some(
+      (p) => p.type === ProfileType.freightForwarder,
+    );
     const read = (key: string) =>
       (attributes?.[key] as string | undefined)?.trim();
-    const poaProvided = POA_ATTRIBUTES.some((k) => read(k));
-    if (!opts.requirePoa && !poaProvided) return;
 
-    if (opts.requirePoa) {
-      const missing = REQUIRED_POA_FIELDS.filter((f) => !read(f.key));
-      if (missing.length > 0) {
-        throw new BadRequestException(
-          `A freight forwarder acts on other companies' behalf, so a Power of Attorney is required. ` +
-            `Add the ${missing.map((f) => f.label.toLowerCase()).join(", ")} first.`,
-        );
-      }
+    const missing = REQUIRED_POA_FIELDS.filter((f) => !read(f.key));
+    if (missing.length > 0) {
+      throw new BadRequestException(
+        (isForwarder
+          ? "A freight forwarder acts on other companies' behalf, so a Power of Attorney is required. "
+          : "You told us someone holds power of attorney for this company. ") +
+        `Add the ${missing.map((f) => f.label.toLowerCase()).join(", ")} first.`,
+      );
     }
 
     const { onFile, flagged } = await this.getPoaDelegationState(
-      companyId,
+      company.id,
       opts.ignoreFileIds,
     );
     if (!onFile) {
       throw new BadRequestException(
         `Upload the ${POA_DELEGATION_LABEL} for the Power of Attorney` +
-          (opts.requirePoa ? " — it is required for freight forwarders." : "."),
+        (isForwarder ? " — it is required for freight forwarders." : "."),
       );
     }
     if (flagged) {
       throw new BadRequestException(
         `The ${POA_DELEGATION_LABEL} on file needs to be corrected. ` +
-          `Re-upload it before continuing.`,
+        `Re-upload it before continuing.`,
       );
     }
   }
 
-  /** Does this company operate as a freight forwarder? */
-  private async isFreightForwarder(companyId: string): Promise<boolean> {
-    const profiles = await this.companyProfilesRepo.findByCompanyId(companyId);
-    return profiles.some((p) => p.type === ProfileType.freightForwarder);
-  }
-
   // ---------------------------------------------------------------------------
-  // Fayda identity verification (owner / PoA)
+  // Identity verification (one per company)
   //
-  // A completed VeriFayda verification proves a person's name, phone, email
-  // and address — Fayda's userinfo carries no national ID number, so none of
-  // that is collected here. For an Ethiopian company both the owner and its
-  // PoA (once named) must be verified before the company can trade. Fayda is
-  // an Ethiopian national ID system, so a foreign company's owner proves
-  // identity with a typed passport number instead — required on its own
-  // terms, not waived by an owner who happens to verify with Fayda too.
+  // A company proves itself through exactly ONE person. Which one is its own
+  // declaration: the Power of Attorney when it names a representative,
+  // otherwise the owner — whoever the eTrade licence names as the business's
+  // manager. There is no general manager and no "same as owner" copy: an owner
+  // who represents their own company simply answers "no, nobody holds power of
+  // attorney", and verifies as the owner.
+  //
+  // A completed VeriFayda verification proves that person's name, phone, email
+  // and address (Fayda's userinfo carries no national ID number, so none is
+  // collected). Fayda is an Ethiopian national ID, so a foreign company may
+  // instead type a passport number for the same person — an alternative, not an
+  // addition.
   // ---------------------------------------------------------------------------
 
   /**
-   * Verification state for both people, plus whether it is mandatory here.
-   * `complete` answers the gate question directly so the portal, the onboarding
-   * requirements and the assertions below all read the same verdict — the
-   * derivation itself is shared with ProfileResponseDto.
+   * The company's identity state: both people, who currently carries the
+   * verification, whether it is proven, and whether the owner the company put
+   * forward matches the eTrade licence. `complete` answers the gate question
+   * directly so the portal, the onboarding requirements and the assertions
+   * above all read the same verdict — the derivation itself is shared with
+   * ProfileResponseDto and the backoffice company DTO.
    */
   getCompanyIdentityState(company: Company): CompanyIdentityStateDto {
     return buildCompanyIdentityState(company);
   }
 
   /**
-   * Complete a Fayda verification and bind the identity to one of the company's
-   * people. The portal starts the flow through the shared
+   * Record whether anyone holds power of attorney for this company.
+   *
+   * This is the question that decides whose identity gets verified, so it is
+   * stored rather than inferred from "are any `poa*` keys set" — absence means
+   * "not asked yet", which is an outstanding onboarding item in its own right.
+   *
+   * Answering "no" tears the representative down: their details, their
+   * verification, their passport number and the DARS paper evidencing them all
+   * go. Leaving any of it behind would keep the company on the hook for a
+   * delegation it has just said does not exist.
+   *
+   * Refused for a freight forwarder — it signs on other companies' behalf, so a
+   * representative is non-negotiable. (`readPoaDeclaration` forces "yes" for
+   * them anyway; this is the honest error rather than a silently ignored write.)
+   */
+  async setPoaDeclared(
+    userId: string,
+    declared: PoaDeclaration,
+  ): Promise<CompanyIdentityStateDto> {
+    const { company } = await this.getCompanyInfoByUserId(userId);
+
+    if (
+      declared === "no" &&
+      (company.companyProfiles ?? []).some(
+        (p) => p.type === ProfileType.freightForwarder,
+      )
+    ) {
+      throw new BadRequestException(
+        "A freight forwarder acts on other companies' behalf, so it must have a Power of Attorney. Remove the freight forwarder role first.",
+      );
+    }
+
+    const attributes: Record<string, unknown> = {
+      ...(company.attributes ?? {}),
+      [POA_DECLARED_KEY]: declared,
+    };
+
+    if (declared === "no") {
+      for (const key of [
+        ...POA_ATTRIBUTES,
+        "poaFaydaSub",
+        "poaFaydaVerifiedAt",
+        "poaBirthdate",
+        "poaGender",
+        "poaPassportNumber",
+      ]) {
+        attributes[key] = null;
+      }
+      await this.deletePoaDelegationFiles(company.id);
+    }
+
+    const updated = await this.companiesRepo.update(company.id, { attributes });
+    if (!updated)
+      throw new NotFoundException(`Company ${company.id} not found`);
+    updated.companyProfiles = company.companyProfiles;
+    return this.getCompanyIdentityState(updated);
+  }
+
+  /** Drop every DARS paper on file — the delegation it evidenced is gone. */
+  private async deletePoaDelegationFiles(companyId: string): Promise<void> {
+    const records = await this.filesService.findByResource(
+      companyId,
+      COMPANY_RESOURCE,
+    );
+    for (const r of records) {
+      if (
+        r.code === POA_DELEGATION_FILE_KEY ||
+        r.code === POA_DELEGATION_PENDING_CODE
+      ) {
+        await this.filesService.remove(r.id);
+        await this.withdrawDocumentIntent(companyId, r.id);
+      }
+    }
+  }
+
+  /**
+   * Complete a Fayda verification and bind the identity to the company.
+   *
+   * The portal starts the flow through the shared
    * `POST /fayda/verification/start` and only tells us which person it was for
    * here, at completion — so the verifayda module stays generic and its session
    * table needs no company-specific column.
+   *
+   * The subject has to be the one the company's declaration calls for. A
+   * verification bound to the other person would sit on the record looking
+   * proven while the gate — which reads only the declared subject — stayed
+   * unsatisfied, and nothing in the portal would explain why.
    */
   async completeIdentityVerification(
     userId: string,
     dto: CompleteIdentityVerificationDto,
   ): Promise<CompanyIdentityStateDto> {
     const { company } = await this.getCompanyInfoByUserId(userId);
+    const state = buildCompanyIdentityState(company);
     const prefix = IDENTITY_PREFIX[dto.subject];
 
+    if (state.subject === null) {
+      throw new BadRequestException(
+        "Tell us whether anyone holds power of attorney for this company first — the answer decides whose identity we verify.",
+      );
+    }
+    if (state.subject !== dto.subject) {
+      throw new BadRequestException(
+        state.subject === "poa"
+          ? "This company is represented by a Power of Attorney, so it is their identity we need — not the owner's."
+          : "This company has no Power of Attorney, so it is the owner's identity we need.",
+      );
+    }
+
     const result = await this.verifaydaService.completeVerification({
       code: dto.code,
       state: dto.state,
@@ -2762,25 +3296,17 @@ export class CompaniesService {
       );
     }
 
-    // The owner delegating power of attorney to themselves is not a
-    // delegation — it would let one identity satisfy both halves of the check.
-    // Only owner/PoA collide this way: the GM is very often the owner, and
-    // saying so is a supported answer rather than a conflict, so it is left out
-    // of this check entirely.
-    if (dto.subject === "owner" || dto.subject === "poa") {
-      const other: IdentitySubject = dto.subject === "poa" ? "owner" : "poa";
-      const otherSub = company.attributes?.[`${IDENTITY_PREFIX[other]}FaydaSub`];
-      if (otherSub && otherSub === result.sub) {
-        throw new BadRequestException(
-          `This identity is already registered as the company's ${IDENTITY_LABEL[other]}. The Power of Attorney must be a different person from the owner.`,
-        );
-      }
-    }
-
-    const now = new Date().toISOString();
+    // Only what Fayda actually returned is written. Its email and phone claims
+    // are optional and routinely come back empty — the portal renders an input
+    // for whatever is missing and the customer fills it in.
+    //
+    // There is deliberately NO fallback to the signed-in account. The person
+    // onboarding is not necessarily the person on the licence, so stamping
+    // their address onto the owner turned a required field into a guess that
+    // looked verified.
     const identity: VerifiedIdentityAttributes = {
       [`${prefix}FaydaSub`]: result.sub,
-      [`${prefix}FaydaVerifiedAt`]: now,
+      [`${prefix}FaydaVerifiedAt`]: new Date().toISOString(),
       [`${prefix}Birthdate`]: result.birthdate ?? null,
       [`${prefix}Gender`]: result.gender ?? null,
       // The verified payload owns the person's details from here on.
@@ -2796,26 +3322,12 @@ export class CompaniesService {
       ...(result.address ? { [`${prefix}Address`]: result.address } : {}),
     };
 
-    // A GM verification also lands on the typed columns the rest of the system
-    // already reads (the booking, train-scheduling and contract notifiers all
-    // mail `generalManagerEmail`), and clears any earlier "same as owner"
-    // declaration — verifying in their own right is the GM answering for
-    // themselves.
-    if (dto.subject === "gm") {
-      identity.gmSameAsOwner = false;
-      if (result.fullName) identity.generalManagerName = result.fullName;
-      if (result.email) identity.generalManagerEmail = result.email;
-      if (result.phoneNumber)
-        identity.generalManagerPhone = normalizeE164(result.phoneNumber);
-    }
-
-    // An approved company's *owner* is its identity proof, so re-verifying one
-    // is staged for backoffice review rather than quietly rewriting a live
-    // record. The PoA and GM are personnel — the company names its own
-    // representative and manager, and the delegation letter backing the PoA is
-    // what the reviewer sees — so those land live, matching their typed
-    // counterparts in `SELF_SERVICE_ATTRIBUTES`.
-    if (company.status === CompanyStatus.Active && dto.subject === "owner") {
+    // An approved company's identity is what its approval rested on, so
+    // re-verifying is staged for backoffice review rather than quietly
+    // rewriting a live record. Both subjects go through review now: whichever
+    // one the declaration points at IS the company's proof, and the owner is
+    // additionally the person the reviewer checks against the eTrade licence.
+    if (company.status === CompanyStatus.Active) {
       await this.stageIdentityChange(company, userId, identity);
       return this.getCompanyIdentityState(company);
     }
@@ -2829,140 +3341,6 @@ export class CompaniesService {
     return this.getCompanyIdentityState(updated);
   }
 
-  /**
-   * Declare that the General Manager is the company's owner.
-   *
-   * The GM is very often the owner, and making that human verify twice buys
-   * nothing — the owner's verification already proves them. So this copies the
-   * owner's verified identity across rather than starting a second flow, and
-   * records `gmSameAsOwner` so the portal can show it as a declaration rather
-   * than as a verification the GM passed in their own right.
-   *
-   * Refused until the owner is actually verified: without that there is no
-   * proven identity to copy, only typed text that would arrive wearing a
-   * verified badge.
-   */
-  async setGmSameAsOwner(userId: string): Promise<CompanyIdentityStateDto> {
-    const { company } = await this.getCompanyInfoByUserId(userId);
-    const attrs = company.attributes ?? {};
-    const ownerSub = attrs.ownerFaydaSub as string | undefined;
-    if (!ownerSub) {
-      throw new BadRequestException(
-        "Verify the company owner with Fayda first — there is no proven identity to reuse yet.",
-      );
-    }
-
-    const copied: Record<string, unknown> = {
-      gmSameAsOwner: true,
-      gmFaydaSub: ownerSub,
-      gmFaydaVerifiedAt: attrs.ownerFaydaVerifiedAt ?? new Date().toISOString(),
-      gmName: attrs.ownerName ?? null,
-      gmEmail: attrs.ownerEmail ?? null,
-      gmPhone: attrs.ownerPhone ?? null,
-      gmAddress: attrs.ownerAddress ?? null,
-      gmBirthdate: attrs.ownerBirthdate ?? null,
-      gmGender: attrs.ownerGender ?? null,
-      // Kept in step for the notifiers, same as a GM verification does.
-      generalManagerName: attrs.ownerName ?? null,
-      generalManagerEmail: attrs.ownerEmail ?? null,
-      generalManagerPhone: attrs.ownerPhone ?? null,
-    };
-
-    const updated = await this.companiesRepo.update(company.id, {
-      attributes: { ...attrs, ...copied },
-    });
-    if (!updated)
-      throw new NotFoundException(`Company ${company.id} not found`);
-    updated.companyProfiles = company.companyProfiles;
-    return this.getCompanyIdentityState(updated);
-  }
-
-  /**
-   * Undo the "same as owner" declaration, clearing the copied identity so the
-   * GM can be verified in their own right (or typed, where Fayda is optional).
-   */
-  async clearGmIdentity(userId: string): Promise<CompanyIdentityStateDto> {
-    const { company } = await this.getCompanyInfoByUserId(userId);
-    const attrs = { ...(company.attributes ?? {}) };
-    for (const key of [
-      "gmSameAsOwner",
-      "gmFaydaSub",
-      "gmFaydaVerifiedAt",
-      "gmName",
-      "gmEmail",
-      "gmPhone",
-      "gmAddress",
-      "gmBirthdate",
-      "gmGender",
-      ...GM_TYPED_FIELDS,
-    ]) {
-      attrs[key] = null;
-    }
-
-    const updated = await this.companiesRepo.update(company.id, {
-      attributes: attrs,
-    });
-    if (!updated)
-      throw new NotFoundException(`Company ${company.id} not found`);
-    updated.companyProfiles = company.companyProfiles;
-    return this.getCompanyIdentityState(updated);
-  }
-
-  /**
-   * Drop the Power of Attorney entirely — the verified identity, the details it
-   * wrote and the delegation paper together.
-   *
-   * Only the PoA can go: a company always has an owner, and a freight forwarder
-   * always has a representative. Once a PoA is Fayda-verified its
-   * fields are locked, so blanking the form is no longer a way out — without
-   * this the customer would be stuck with a representative they cannot remove.
-   */
-  async removePoaIdentity(userId: string): Promise<CompanyIdentityStateDto> {
-    const { company } = await this.getCompanyInfoByUserId(userId);
-    if (
-      (company.companyProfiles ?? []).some(
-        (p) => p.type === ProfileType.freightForwarder,
-      )
-    ) {
-      throw new BadRequestException(
-        "A freight forwarder must have a Power of Attorney. Remove the freight forwarder role first.",
-      );
-    }
-
-    const cleared: Record<string, unknown> = {};
-    for (const key of [
-      ...POA_ATTRIBUTES,
-      "poaFaydaSub",
-      "poaFaydaVerifiedAt",
-      "poaBirthdate",
-      "poaGender",
-    ]) {
-      cleared[key] = null;
-    }
-    const attributes = { ...(company.attributes ?? {}), ...cleared };
-
-    // The paper evidences a representative who no longer exists.
-    const records = await this.filesService.findByResource(
-      company.id,
-      COMPANY_RESOURCE,
-    );
-    for (const r of records) {
-      if (
-        r.code === POA_DELEGATION_FILE_KEY ||
-        r.code === POA_DELEGATION_PENDING_CODE
-      ) {
-        await this.filesService.remove(r.id);
-        await this.withdrawDocumentIntent(company.id, r.id);
-      }
-    }
-
-    const updated = await this.companiesRepo.update(company.id, { attributes });
-    if (!updated)
-      throw new NotFoundException(`Company ${company.id} not found`);
-    updated.companyProfiles = company.companyProfiles;
-    return this.getCompanyIdentityState(updated);
-  }
-
   /** Stage a verified identity onto the company's pending change request. */
   private async stageIdentityChange(
     company: Company,
@@ -2976,8 +3354,8 @@ export class CompaniesService {
     const snapshot = {
       ...(existing?.snapshot ?? {}),
       faydaIdentity: {
-        ...(((existing?.snapshot ?? {}) as Record<string, any>)
-          .faydaIdentity ?? {}),
+        ...(((existing?.snapshot ?? {}) as Record<string, any>).faydaIdentity ??
+        {}),
         ...identity,
       },
     };
@@ -3011,62 +3389,56 @@ export class CompaniesService {
   }
 
   /**
-   * The gate: an Ethiopian company's owner must be Fayda-verified, and so must
-   * its Power of Attorney once it has one; a foreign company's owner must carry
-   * a passport number instead. Called from the same places as
-   * `assertPoaDelegationSatisfied` — the two rules describe the same moment
-   * (who may act for this company, and on what evidence) and drifting them
-   * apart is how one of them ends up unenforced.
+   * The company as it will be once `type` is one of its roles.
+   *
+   * Taking on the freight-forwarder role is checked BEFORE the profile row
+   * exists, and both assertions below read `companyProfiles` — a forwarder is
+   * what forces the PoA declaration to "yes". Judging the company as it stands
+   * would let one that answered "no" pick up the role and skip the very
+   * requirement the role exists to impose. Read-only; never persisted.
    */
-  private assertIdentityVerified(
-    company: Company,
-    opts: { requirePoa: boolean },
-  ): void {
+  private withProfileType(company: Company, type: ProfileType): Company {
+    const profiles = company.companyProfiles ?? [];
+    if (profiles.some((p) => p.type === type)) return company;
+    return {
+      ...company,
+      companyProfiles: [...profiles, { type } as CompanyProfile],
+    } as Company;
+  }
+
+  /**
+   * The gate: the company's ONE identity must be proven.
+   *
+   * Which person that is comes from the company's own declaration — the
+   * representative when it names one, otherwise the owner (whoever the eTrade
+   * licence names as manager). How they prove it depends on nationality: Fayda
+   * for an Ethiopian company, Fayda *or* a typed passport number for a foreign
+   * one, whose people may hold no Fayda ID at all.
+   *
+   * Called from the same places as `assertPoaDelegationSatisfied` — the two
+   * rules describe the same moment (who may act for this company, and on what
+   * evidence) and drifting them apart is how one of them ends up unenforced.
+   */
+  private assertIdentityVerified(company: Company): void {
     const state = buildCompanyIdentityState(company);
 
-    // Only the owner's credential is nationality-specific: Fayda for an
-    // Ethiopian company, a typed passport number for a foreign one.
-    if (state.passportRequired) {
-      if (!state.owner.passportNumber) {
-        throw new BadRequestException(
-          "Add the company owner's passport number before continuing.",
-        );
-      }
-    } else if (!state.owner.verified) {
+    if (state.poaDeclared === null) {
       throw new BadRequestException(
-        "Verify the company owner's identity with Fayda before continuing.",
+        "Tell us whether anyone holds power of attorney for this company — the answer decides whose identity we verify.",
       );
     }
 
-    const poaNamed = POA_ATTRIBUTES.some((k) =>
-      (company.attributes?.[k] as string | undefined)?.trim(),
+    if (state.identityProven) return;
+
+    const who =
+      state.subject === "poa"
+        ? "your Power of Attorney"
+        : "the person named on your eTrade licence";
+    throw new BadRequestException(
+      state.passportAccepted
+        ? `Verify ${who} with Fayda, or add their passport number.`
+        : `Verify ${who} with Fayda before continuing.`,
     );
-    if (!opts.requirePoa && !poaNamed) return;
-
-    // Fayda is an Ethiopian national ID, so only an Ethiopian company's
-    // representative can be held to it. A foreign company is offered the
-    // verification and nominates a Fayda-holding representative where it can,
-    // but a typed name has to remain sufficient — otherwise a foreign company
-    // whose representative holds no Fayda ID could never trade at all. Mirrors
-    // `poaProven` in buildCompanyIdentityState; the two must agree.
-    if (state.passportRequired) {
-      if (!state.poa.verified && !state.poa.name?.trim()) {
-        throw new BadRequestException(
-          opts.requirePoa
-            ? "Name your Power of Attorney — a freight forwarder cannot operate without one."
-            : "Complete the Power of Attorney you named, or remove the representative.",
-        );
-      }
-      return;
-    }
-
-    if (!state.poa.verified) {
-      throw new BadRequestException(
-        opts.requirePoa
-          ? "Verify your Power of Attorney with Fayda — a freight forwarder cannot operate without one."
-          : "Verify the Power of Attorney you named with Fayda, or remove the representative.",
-      );
-    }
   }
 
   /**
@@ -3190,12 +3562,9 @@ export class CompaniesService {
     // the representative it evidences is gone too (which, for an Active
     // company, means the clearing edit is already staged).
     await this.assertPoaDelegationSatisfied(
-      company.id,
+      company,
       await this.effectivePoaAttributes(company),
-      {
-        requirePoa: await this.isFreightForwarder(company.id),
-        ignoreFileIds: [fileId],
-      },
+      { ignoreFileIds: [fileId] },
     );
 
     if (record.code === POA_DELEGATION_PENDING_CODE) {
@@ -3381,19 +3750,30 @@ export class CompaniesService {
   /** Resolve a TIN's live eTrade registration data. Throws when eTrade has no matching business licence. */
   private async resolveEtradeRegistration(
     tin: string,
+    licenceNumber?: string,
   ): Promise<CompanyRegistrationData> {
     const { businessInfo, companyInfo } =
-      await this.etradeService.resolveCompanyData(tin);
+      await this.etradeService.resolveCompanyData(tin, licenceNumber);
     if (!businessInfo) {
       throw new BadRequestException(
         "We couldn't find a business license for this TIN with eTrade. Please double-check the number and try again.",
       );
     }
-    return this.etradeService.extractRegistrationData(businessInfo, companyInfo);
+    return this.etradeService.extractRegistrationData(
+      businessInfo,
+      companyInfo,
+    );
   }
 
-  async fetchETradeData(tin: string, excludeCompanyId?: string) {
-    const registrationData = await this.resolveEtradeRegistration(tin);
+  async fetchETradeData(
+    tin: string,
+    excludeCompanyId?: string,
+    licenceNumber?: string,
+  ) {
+    const registrationData = await this.resolveEtradeRegistration(
+      tin,
+      licenceNumber,
+    );
     const tinTaken = await this.companiesRepo.existsByTin(
       tin,
       excludeCompanyId,
@@ -3412,16 +3792,31 @@ export class CompaniesService {
    */
   private async applyEtradeSourcedFields(
     company: Company,
-    dto: UpdateProfileDto,
+    dto: UpdateProfileDto & { etradeManager?: { name: string; phone: string } },
   ): Promise<void> {
+    // A co-operative union or farm has a TIN but no business licence, so eTrade holds no
+    // record to check these against — the customer types the company name and
+    // the registered address themselves, and what they send IS the data. The
+    // check is skipped rather than failed: running the lookup would 400 every
+    // save with "no registration found for this TIN".
+    if (usesManualRegistration(company)) return;
+
     const touched = ETRADE_SOURCED_FIELDS.some(
       (key) => key !== "tin" && dto[key] !== undefined,
     );
     if (!touched) return;
 
     const tin = dto.tin ?? company.tin;
-    const registration = await this.resolveEtradeRegistration(tin);
-    const fresh: Partial<Record<(typeof ETRADE_SOURCED_FIELDS)[number], string>> = {
+    // Re-verify the licence the customer actually chose. Without it a TIN
+    // holding several licences would silently snap back to eTrade's first one on
+    // every save, overwriting the selection with a different business's record.
+    const registration = await this.resolveEtradeRegistration(
+      tin,
+      dto.licenceNumber ?? company.licenceNumber ?? undefined,
+    );
+    const fresh: Partial<
+      Record<(typeof ETRADE_SOURCED_FIELDS)[number], string>
+    > = {
       companyName: registration.companyName,
       licenceNumber: registration.licenceNumber,
       statusDescription: registration.statusDescription,
@@ -3447,5 +3842,18 @@ export class CompaniesService {
       // (the onboarding/settings card lets the customer type it directly then).
       if (value) (dto as Record<string, unknown>)[key] = value;
     }
+
+    // Capture the licence's own manager alongside the registration it belongs
+    // to. NOT written onto `ownerName`/`ownerPhone`: those are what the company
+    // asserts (and what a Fayda verification owns), and overwriting them here
+    // would destroy the very difference the backoffice is asked to check. The
+    // portal prefills the owner from these, so they agree unless someone made
+    // them disagree — which is exactly the case worth surfacing.
+    if (registration.managerName || registration.managerPhone) {
+      dto.etradeManager = {
+        name: registration.managerName,
+        phone: registration.managerPhone,
+      };
+    }
   }
 }
diff --git a/apps/edr-freight-api/src/modules/companies/company-notifier.service.ts b/apps/edr-freight-api/src/modules/companies/company-notifier.service.ts
index 66f88e9f8..d3a556f50 100644
--- a/apps/edr-freight-api/src/modules/companies/company-notifier.service.ts
+++ b/apps/edr-freight-api/src/modules/companies/company-notifier.service.ts
@@ -10,7 +10,8 @@ import {
 import { Company, CompanyStatus } from "./entities/company.entity";
 import { NotificationsService } from "../notifications/notifications.service";
 import { NotificationInboxService } from "../notification-inbox/notification-inbox.service";
-import { resolveCompanyNotifyPhone } from "../notifications/resolve-company-phone.util";
+import { resolveCompanyNotifyContact } from "../notifications/resolve-company-phone.util";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
 
 /** Account statuses that lock the customer out and therefore must be told to them. */
 const PUNITIVE_STATUSES: readonly CompanyStatus[] = [
@@ -37,8 +38,13 @@ export class CompanyNotifierService {
 
   /** Send SMS + email to the company contact; log-only on failure. */
   private async notifyContact(company: Company, message: string): Promise<void> {
-    const phone = await resolveCompanyNotifyPhone(this.dataSource, company.id);
-    const email = company.email ?? company.generalManagerEmail ?? null;
+    // One resolver for both channels — the company row's own email column is
+    // only set for a Fayda-verified owner (see companyNotifyEmailExpr), which
+    // left an approval/suspension notice unsent to everyone else.
+    const { phone, email } = await resolveCompanyNotifyContact(
+      this.dataSource,
+      company.id,
+    );
 
     if (phone) {
       try {
@@ -175,12 +181,9 @@ export class CompanyNotifierService {
   // ── Backoffice-facing: work has arrived back in the review queue ────────────
 
   /**
-   * Persist + push an in-app item to every backoffice staff user, deep-linked to
-   * the customer's detail page.
-   *
-   * The recipient resolver has no role/permission targeting (see
-   * `notification-recipients.service.ts`) — `allBackoffice` is the narrowest
-   * selector available, so marketing is reached by notifying all staff.
+   * Persist + push an in-app item to the customer desk — staff holding
+   * `customers:get_notification` — deep-linked to the customer's detail page,
+   * which is itself gated on `customers:view`.
    */
   private notifyStaff(
     company: Company,
@@ -189,7 +192,7 @@ export class CompanyNotifierService {
     data: Record<string, unknown> = {},
   ): void {
     void this.inbox.notify({
-      recipients: { allBackoffice: true },
+      recipients: { permissionKeys: [FREIGHT_PERMS.customers.getNotification] },
       audience: NotificationAudience.BACKOFFICE,
       type: NotificationType.REQUEST_SUBMITTED,
       title,
@@ -241,6 +244,35 @@ export class CompanyNotifierService {
     );
   }
 
+  /**
+   * A reviewer did NOT approve a customer's profile changes — they rejected it
+   * or sent it back for correction. The customer desk (Marketing included, via
+   * the `customers:get_notification` key) owns the follow-up with the customer,
+   * so the decision has to reach their inbox; without this it was silent, and
+   * only visible to whoever happened to reopen the customer's History tab.
+   */
+  changeRequestReturned(
+    company: Company,
+    changeRequestId: string,
+    outcome: "rejected" | "changes_requested",
+    note: string,
+    reviewerName?: string | null,
+  ): void {
+    const rejected = outcome === "rejected";
+    const by = reviewerName?.trim() ? ` by ${reviewerName.trim()}` : "";
+    this.logger.log(`CHANGE_REQUEST_${outcome.toUpperCase()} — ${company.id}`);
+    this.notifyStaff(
+      company,
+      rejected
+        ? "Customer profile changes rejected"
+        : "Customer profile changes sent back for correction",
+      `${company.name}'s profile changes were ` +
+        `${rejected ? "rejected" : "sent back for correction"}${by}. ` +
+        `Reason: ${note}`,
+      { changeRequestId, outcome, note, reviewerName: reviewerName ?? null },
+    );
+  }
+
   // ── Customer-facing: a specific document needs correcting ──────────────────
 
   /**
diff --git a/apps/edr-freight-api/src/modules/companies/company-revision-diff.util.ts b/apps/edr-freight-api/src/modules/companies/company-revision-diff.util.ts
index 83fa539e3..71b60a268 100644
--- a/apps/edr-freight-api/src/modules/companies/company-revision-diff.util.ts
+++ b/apps/edr-freight-api/src/modules/companies/company-revision-diff.util.ts
@@ -23,9 +23,18 @@ export const COMPANY_FIELD_LABELS: Record<string, string> = {
   contactPersonPhone: "Contact person phone",
   contactPersonEmail: "Contact person email",
   contactPersonPosition: "Contact person position",
-  generalManagerName: "General manager name",
-  generalManagerPhone: "General manager phone",
-  generalManagerEmail: "General manager email",
+  ownerName: "Owner name",
+  ownerPhone: "Owner phone",
+  ownerEmail: "Owner email",
+  ownerPassportNumber: "Owner passport number",
+  poaPassportNumber: "PoA passport number",
+  poaDeclared: "Has a Power of Attorney",
+  // Nothing writes these any more (the general manager was removed), but
+  // revisions and change requests filed before that still carry them — without
+  // the labels those rows render raw attribute keys to a reviewer.
+  generalManagerName: "General manager name (retired)",
+  generalManagerPhone: "General manager phone (retired)",
+  generalManagerEmail: "General manager email (retired)",
   poaName: "PoA name",
   poaPhone: "PoA phone",
   poaEmail: "PoA email",
diff --git a/apps/edr-freight-api/src/modules/companies/dto/account-info-response.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/account-info-response.dto.ts
new file mode 100644
index 000000000..ab680f8f3
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/dto/account-info-response.dto.ts
@@ -0,0 +1,66 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+
+import { ShippingLineCompany } from "../../shipping-lines/entities/shipping-line-company.entity";
+import { CompanyInfoResponseDto } from "./company-info-response.dto";
+
+/**
+ * What kind of account is signed in to the portal.
+ *
+ * The portal keys its onboarding gate off this rather than off "is `company`
+ * missing?": a failed or slow company fetch also leaves `company` empty, and
+ * treating that as "no onboarding needed" would let customers skip onboarding
+ * whenever the request failed. A shipping line is identified positively, and
+ * anything else defaults to `customer`.
+ */
+export type AccountKind = "customer" | "shipping_line";
+
+/** The signed-in shipping line. No company, no profile, no onboarding. */
+export class ShippingLineInfoResponseDto {
+  @ApiProperty({ enum: ["shipping_line"] })
+  accountKind: "shipping_line" = "shipping_line";
+
+  @ApiProperty()
+  id: string;
+
+  @ApiProperty()
+  name: string;
+
+  @ApiProperty()
+  email: string;
+
+  @ApiPropertyOptional()
+  phoneNumber?: string | null;
+
+  @ApiPropertyOptional()
+  scacCode?: string | null;
+
+  @ApiProperty()
+  status: string;
+
+  /**
+   * Always null. Present so the portal can read `company` / `profile` off either
+   * payload shape without narrowing the union first — the fields a customer
+   * session carries simply have no shipping-line equivalent.
+   */
+  @ApiProperty({ nullable: true })
+  company: null = null;
+
+  @ApiProperty({ nullable: true })
+  profile: null = null;
+
+  @ApiProperty({ nullable: true })
+  review: null = null;
+
+  constructor(entity: ShippingLineCompany) {
+    this.id = entity.id;
+    this.name = entity.name;
+    this.email = entity.email;
+    this.phoneNumber = entity.phoneNumber ?? null;
+    this.scacCode = entity.scacCode ?? null;
+    this.status = entity.status;
+  }
+}
+
+export type AccountInfoResponse =
+  | (CompanyInfoResponseDto & { accountKind: "customer" })
+  | ShippingLineInfoResponseDto;
diff --git a/apps/edr-freight-api/src/modules/companies/dto/change-request-response.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/change-request-response.dto.ts
index 4a931dae3..2a4f65708 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/change-request-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/change-request-response.dto.ts
@@ -23,8 +23,12 @@ export class ChangeRequestResponseDto {
   documentChanges: DocumentChangeIntent[];
   note: string | null;
   submittedBy: string | null;
+  /** Who filed the request, for the history screen (null when unresolvable). */
+  submittedByName: string | null;
   submittedAt: Date | null;
   reviewedBy: string | null;
+  /** Who approved / rejected / sent it back. */
+  reviewedByName: string | null;
   reviewedAt: Date | null;
   createdAt: Date;
   updatedAt: Date;
@@ -39,8 +43,10 @@ export class ChangeRequestResponseDto {
     this.documentChanges = req.documents?.documentChanges ?? [];
     this.note = req.note ?? null;
     this.submittedBy = req.submittedBy ?? null;
+    this.submittedByName = req.submittedByName ?? null;
     this.submittedAt = req.submittedAt ?? null;
     this.reviewedBy = req.reviewedBy ?? null;
+    this.reviewedByName = req.reviewedByName ?? null;
     this.reviewedAt = req.reviewedAt ?? null;
     this.createdAt = req.createdAt;
     this.updatedAt = req.updatedAt;
diff --git a/apps/edr-freight-api/src/modules/companies/dto/company-revision-response.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/company-revision-response.dto.ts
index c93c7387c..198a44e06 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/company-revision-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/company-revision-response.dto.ts
@@ -8,6 +8,8 @@ export class CompanyRevisionResponseDto {
   id: string;
   companyId: string;
   actorId: string | null;
+  /** Who made the edit, for the history screen (null when unresolvable). */
+  actorName: string | null;
   summary: string;
   changes: CompanyRevisionChange[];
   createdAt: Date;
@@ -16,6 +18,7 @@ export class CompanyRevisionResponseDto {
     this.id = revision.id;
     this.companyId = revision.companyId;
     this.actorId = revision.actorId ?? null;
+    this.actorName = revision.actorName ?? null;
     this.summary = revision.summary;
     this.changes = revision.changes ?? [];
     this.createdAt = revision.createdAt;
diff --git a/apps/edr-freight-api/src/modules/companies/dto/complete-identity-verification.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/complete-identity-verification.dto.ts
index d41e61e8e..feccc855d 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/complete-identity-verification.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/complete-identity-verification.dto.ts
@@ -5,21 +5,61 @@ import { Company, CompanyNationality } from "../entities/company.entity";
 import { ProfileType } from "../entities/company-profile.entity";
 
 /**
- * The three people a company is verified through — its owner, its Power of
- * Attorney and its General Manager. The owner is the person the company's
- * existence is proven by; the other two are personnel it names.
+ * The two people a company can be described through.
  *
- * The GM is very often the owner, which is what the portal's "same as owner"
- * copy is for: that path reuses the owner's verified identity outright rather
- * than asking the same human to verify twice.
+ * The **owner** is whoever the eTrade TIN record names as the business's
+ * manager. Not necessarily the legal owner — eTrade's `ManagerNameEng` is
+ * simply the person on the licence — but that is the point: whoever the company
+ * puts forward here has to match the eTrade record, and the backoffice check is
+ * exactly that comparison (see `ownerMatchesEtrade`).
+ *
+ * The **Power of Attorney** is who the company delegates to act for it, when it
+ * delegates at all.
+ *
+ * Exactly ONE of them is identity-verified, and which one is decided by the
+ * company's own answer (see {@link PoaDeclaration}): the representative if
+ * there is one, otherwise the owner. There is no general manager — the concept
+ * was removed; it named who to talk to and gated nothing.
  */
-export const IDENTITY_SUBJECTS = ["owner", "poa", "gm"] as const;
+export const IDENTITY_SUBJECTS = ["owner", "poa"] as const;
 export type IdentitySubject = (typeof IDENTITY_SUBJECTS)[number];
 
+/**
+ * The company's answer to "does anyone hold power of attorney for you?".
+ *
+ * Explicit rather than derived from "are any `poa*` keys set", because "no" is
+ * an answer that moves the verification onto the owner, while *absent* is a
+ * question the customer has not reached yet. Stored on `company.attributes`
+ * under {@link POA_DECLARED_KEY}.
+ *
+ * A freight forwarder never gets to answer: it signs on other companies'
+ * behalf, so a Power of Attorney (and the DARS paper evidencing it) is
+ * non-negotiable. {@link readPoaDeclaration} forces "yes" for them, which is
+ * why the declaration is read through that helper rather than off the blob.
+ */
+export const POA_DECLARATIONS = ["yes", "no"] as const;
+export type PoaDeclaration = (typeof POA_DECLARATIONS)[number];
+
+/** `company.attributes` key holding the {@link PoaDeclaration}. */
+export const POA_DECLARED_KEY = "poaDeclared";
+
+/**
+ * `company.attributes` keys holding the eTrade record's own manager, captured
+ * at lookup time.
+ *
+ * Kept apart from `ownerName`/`ownerPhone` — which are what the *company*
+ * asserts, and what a Fayda verification overwrites — precisely so the two can
+ * be compared. Storing only one value would leave the reviewer comparing the
+ * owner field against itself.
+ */
+export const ETRADE_MANAGER_NAME_KEY = "etradeManagerName";
+export const ETRADE_MANAGER_PHONE_KEY = "etradeManagerPhone";
+
 export class CompleteIdentityVerificationDto {
   @ApiProperty({
     enum: IDENTITY_SUBJECTS,
-    description: "Which of the company's people this verification is for.",
+    description:
+      "Which of the company's people this verification is for. Must match the company's PoA declaration — the representative when one is named, the owner when not.",
   })
   @IsIn(IDENTITY_SUBJECTS)
   subject!: IdentitySubject;
@@ -35,9 +75,11 @@ export class CompleteIdentityVerificationDto {
   state!: string;
 }
 
-/** One person's verification state, as reported back to the portal. */
+/** One person's identity state, as reported back to the portal. */
 export class IdentityVerificationStateDto {
-  @ApiProperty() verified!: boolean;
+  @ApiProperty({ description: "True once a Fayda verification is bound." })
+  verified!: boolean;
+
   @ApiProperty({ nullable: true }) name!: string | null;
   @ApiProperty({ nullable: true }) phone!: string | null;
   @ApiProperty({ nullable: true }) email!: string | null;
@@ -45,13 +87,11 @@ export class IdentityVerificationStateDto {
   @ApiProperty({ nullable: true }) verifiedAt!: string | null;
   @ApiProperty({ nullable: true }) birthdate!: string | null;
   @ApiProperty({ nullable: true }) gender!: string | null;
-}
 
-export class OwnerIdentityStateDto extends IdentityVerificationStateDto {
   @ApiProperty({
     nullable: true,
     description:
-      "Typed passport number — the foreign-company identity credential. Independent of Fayda: never written by a verification, and still required even if the owner also verifies.",
+      "Typed passport number. Fayda is an Ethiopian national ID, so a foreign company proves the identity with either — this is the alternative, not an addition.",
   })
   passportNumber!: string | null;
 }
@@ -59,38 +99,62 @@ export class OwnerIdentityStateDto extends IdentityVerificationStateDto {
 export class CompanyIdentityStateDto {
   @ApiProperty({
     description:
-      "True when Fayda verification of the owner (and PoA, once named) is mandatory — Ethiopian companies only.",
+      "True for a foreign company: a typed passport number proves the identity just as a Fayda verification does. An Ethiopian company must use Fayda.",
   })
-  faydaRequired!: boolean;
+  passportAccepted!: boolean;
 
   @ApiProperty({
+    enum: POA_DECLARATIONS,
+    nullable: true,
     description:
-      "True when the owner's passport number is mandatory — foreign companies only. Independent of faydaRequired: a foreign owner may verify with Fayda too, but the passport is still required.",
+      'Whether the company named a Power of Attorney. Null until the customer answers — which is itself an outstanding onboarding item, since the answer decides who verifies.',
   })
-  passportRequired!: boolean;
+  poaDeclared!: PoaDeclaration | null;
 
-  @ApiProperty({ type: OwnerIdentityStateDto })
-  owner!: OwnerIdentityStateDto;
+  @ApiProperty({
+    enum: IDENTITY_SUBJECTS,
+    nullable: true,
+    description:
+      "Who the company's single identity verification belongs to: the PoA when one is named, the owner when not. Null while the declaration is unanswered.",
+  })
+  subject!: IdentitySubject | null;
+
+  @ApiProperty({ type: IdentityVerificationStateDto })
+  owner!: IdentityVerificationStateDto;
 
   @ApiProperty({ type: IdentityVerificationStateDto })
   poa!: IdentityVerificationStateDto;
 
   @ApiProperty({
-    type: IdentityVerificationStateDto,
     description:
-      "General manager. `verified` is true both when the GM verified with Fayda in their own right and when the company declared the GM is the owner — in the latter case the owner's Fayda sub backs it.",
+      "True once the subject is proven — Fayda-verified, or carrying a passport number where that is accepted.",
   })
-  gm!: IdentityVerificationStateDto;
+  identityProven!: boolean;
+
+  @ApiProperty({
+    nullable: true,
+    description:
+      "The manager named on the eTrade licence, captured at lookup. Null when eTrade returned none (ManagerNameEng is frequently blank).",
+  })
+  etradeManagerName!: string | null;
+
+  @ApiProperty({
+    nullable: true,
+    description:
+      "That manager's phone, normalized to E.164 and captured at the same lookup. Paired with the name so the portal can still tell that the owner's details came from eTrade after a refresh, when the live lookup result is long gone — without it a resumed wizard offers them back as typeable inputs.",
+  })
+  etradeManagerPhone!: string | null;
+
+  @ApiProperty({
+    nullable: true,
+    description:
+      "Does the owner the company put forward match the person on the eTrade licence? This is the backoffice's check. Null when there is nothing to compare — no eTrade manager on file, or no owner name yet. Advisory, not a gate: eTrade's Latin transliteration and Fayda's rarely agree character-for-character, so a reviewer decides.",
+  })
+  ownerMatchesEtrade!: boolean | null;
 
   @ApiProperty({
     description:
-      "True when the GM's identity is the owner's, declared through the portal's \"same as owner\" copy rather than a separate verification.",
-  })
-  gmSameAsOwner!: boolean;
-
-  @ApiProperty({
-    description:
-      "False while a mandatory requirement (Fayda for Ethiopian, passport for foreign) is still outstanding.",
+      "False while the declaration is unanswered or the subject is unproven. Field-level completeness (owner/PoA details, documents) is reported separately by the onboarding requirements.",
   })
   complete!: boolean;
 }
@@ -99,26 +163,9 @@ export class CompanyIdentityStateDto {
 const PREFIX: Record<IdentitySubject, string> = {
   owner: "owner",
   poa: "poa",
-  gm: "gm",
 };
 
-/**
- * Typed GM fields, kept in step with the Fayda-written ones.
- *
- * The GM predates this verification: its details are plain company columns
- * that three notifier services mail (booking-lifecycle, train-scheduling and
- * contract notifiers all read `company.generalManagerEmail`). A verification
- * therefore writes BOTH — the `gm*` attributes carry the proof, these carry
- * the value everything else already reads — and an unverified company keeps
- * showing whatever was typed before this existed.
- */
-const GM_TYPED_KEYS = {
-  name: "generalManagerName",
-  email: "generalManagerEmail",
-  phone: "generalManagerPhone",
-} as const;
-
-/** company.attributes keys that together mean "a PoA was entered". */
+/** `company.attributes` keys that together mean "a representative was entered". */
 const POA_KEYS = [
   "poaName",
   "poaPhone",
@@ -133,7 +180,7 @@ function stateFor(
 ): IdentityVerificationStateDto {
   const p = PREFIX[subject];
   const read = (key: string) => (attrs[key] as string | undefined) ?? null;
-  const state: IdentityVerificationStateDto = {
+  return {
     verified: Boolean(read(`${p}FaydaSub`)),
     name: read(`${p}Name`),
     phone: read(`${p}Phone`),
@@ -142,80 +189,114 @@ function stateFor(
     verifiedAt: read(`${p}FaydaVerifiedAt`),
     birthdate: read(`${p}Birthdate`),
     gender: read(`${p}Gender`),
-  };
-  if (subject !== "gm") return state;
-
-  // Companies onboarded before the GM was verifiable have typed details and no
-  // `gm*` attributes at all. Report those rather than a blank card — they are
-  // still what the notifiers mail — leaving `verified` false so the portal
-  // offers the upgrade instead of pretending the identity is proven.
-  return {
-    ...state,
-    name: state.name ?? read(GM_TYPED_KEYS.name),
-    email: state.email ?? read(GM_TYPED_KEYS.email),
-    phone: state.phone ?? read(GM_TYPED_KEYS.phone),
+    passportNumber: read(`${p}PassportNumber`),
   };
 }
 
 /**
- * Derive both people's verification state from the company row.
+ * The company's PoA declaration, or null when it hasn't answered yet.
  *
- * Pure and shared: `CompaniesService` gates on it and `ProfileResponseDto`
- * renders from it, so the settings page and the onboarding wizard can never
- * disagree with the rule the API actually enforces.
+ * A freight forwarder is never asked: it acts on other companies' behalf, so a
+ * representative and the DARS paper behind them are mandatory. Forcing it here
+ * — rather than only disabling the radio in the portal — is what stops a
+ * forwarder role added *after* onboarding from inheriting an old "no".
+ */
+export function readPoaDeclaration(
+  company: Pick<Company, "attributes" | "companyProfiles">,
+): PoaDeclaration | null {
+  if (
+    (company.companyProfiles ?? []).some(
+      (p) => p.type === ProfileType.freightForwarder,
+    )
+  ) {
+    return "yes";
+  }
+  const value = company.attributes?.[POA_DECLARED_KEY];
+  if (value === "yes" || value === "no") return value;
+
+  // No explicit answer, but the company holds a representative's details —
+  // so it has one, and owes everything a representative brings with them.
+  //
+  // Covers rows that predate the question (the migration derives the same way)
+  // and any write that reaches the attributes without going through
+  // `setPoaDeclared`. Without this, PoA details could be saved with the
+  // delegation paper silently unowed. Safe against a genuine "no": answering
+  // it clears these keys, so they cannot outlive the answer.
+  return POA_KEYS.some((k) => (company.attributes?.[k] as string | undefined)?.trim())
+    ? "yes"
+    : null;
+}
+
+/**
+ * Do two people's names refer to the same person, as far as a string can tell?
+ *
+ * Deliberately loose: eTrade returns uppercase Latin transliterations of
+ * Amharic names and Fayda returns its own, so exact equality would flag almost
+ * every company. Case, punctuation, extra whitespace and word ORDER are all
+ * ignored — "ABEBE KEBEDE TESFA" and "Tesfa, Abebe Kebede" match. Anything
+ * beyond that is the reviewer's call, which is why the verdict is advisory.
+ */
+export function ownerNameMatchesEtrade(
+  ownerName: string | null | undefined,
+  etradeName: string | null | undefined,
+): boolean | null {
+  const words = (v: string | null | undefined) =>
+    (v ?? "")
+      .toLowerCase()
+      .replace(/[^a-z0-9ሀ-፿\s]/g, " ")
+      .split(/\s+/)
+      .filter(Boolean)
+      .sort();
+  const a = words(ownerName);
+  const b = words(etradeName);
+  if (a.length === 0 || b.length === 0) return null;
+  return a.length === b.length && a.every((w, i) => w === b[i]);
+}
+
+/**
+ * Derive the company's identity state from its row.
+ *
+ * Pure and shared: `CompaniesService` gates on it, `ProfileResponseDto` and the
+ * backoffice's company DTO render from it, so the settings page, the onboarding
+ * wizard and the reviewer can never disagree with the rule the API enforces.
  */
 export function buildCompanyIdentityState(
   company: Company,
 ): CompanyIdentityStateDto {
   const attrs = company.attributes ?? {};
-  const read = (key: string) => (attrs[key] as string | undefined) ?? null;
 
-  // Fayda is an Ethiopian national ID — a foreign company's owner may not hold
-  // one, so a typed passport number is the mandatory credential there instead.
-  // The two are mutually exclusive by nationality but independently tracked,
-  // since a foreign owner verifying with Fayda doesn't waive the passport.
-  const foreign = company.nationality === CompanyNationality.Foreign;
-  const faydaRequired = !foreign;
-  const passportRequired = foreign;
+  // Fayda is an Ethiopian national ID. A foreign company's people may hold
+  // none, so a typed passport number stands in — either one proves the person,
+  // and holding both is fine.
+  const passportAccepted = company.nationality === CompanyNationality.Foreign;
 
-  const owner: OwnerIdentityStateDto = {
-    ...stateFor(attrs, "owner"),
-    passportNumber: read("ownerPassportNumber"),
-  };
+  const owner = stateFor(attrs, "owner");
   const poa = stateFor(attrs, "poa");
-  const poaDue =
-    (company.companyProfiles ?? []).some(
-      (p) => p.type === ProfileType.freightForwarder,
-    ) || POA_KEYS.some((k) => (attrs[k] as string | undefined)?.trim());
+  const poaDeclared = readPoaDeclaration(company);
+  const subject: IdentitySubject | null =
+    poaDeclared === "yes" ? "poa" : poaDeclared === "no" ? "owner" : null;
 
-  const gm = stateFor(attrs, "gm");
-  const gmSameAsOwner = Boolean(attrs.gmSameAsOwner);
+  const proven = (s: IdentityVerificationStateDto) =>
+    s.verified || (passportAccepted && Boolean(s.passportNumber?.trim()));
 
-  const ownerProven = faydaRequired
-    ? owner.verified
-    : !passportRequired || Boolean(owner.passportNumber);
+  const identityProven =
+    subject === null ? false : proven(subject === "poa" ? poa : owner);
 
-  // Fayda is an Ethiopian national ID, so only an Ethiopian company's
-  // personnel can be held to it. A foreign company may nominate a
-  // representative who holds one — and is offered the verification — but a
-  // typed name has to remain sufficient, or a foreign company whose PoA has no
-  // Fayda ID could never finish onboarding.
-  const poaProven = faydaRequired
-    ? poa.verified
-    : poa.verified || Boolean(poa.name?.trim());
-
-  // The GM is deliberately absent from this verdict: it names who to talk to,
-  // not what the company may do, and it has never gated trading. Capturing it
-  // through Fayda changes how it is collected, not whether it is required.
-  const complete = ownerProven && (!poaDue || poaProven);
+  const etradeManagerName =
+    (attrs[ETRADE_MANAGER_NAME_KEY] as string | undefined) ?? null;
+  const etradeManagerPhone =
+    (attrs[ETRADE_MANAGER_PHONE_KEY] as string | undefined) ?? null;
 
   return {
-    faydaRequired,
-    passportRequired,
+    passportAccepted,
+    poaDeclared,
+    subject,
     owner,
     poa,
-    gm,
-    gmSameAsOwner,
-    complete,
+    identityProven,
+    etradeManagerName,
+    etradeManagerPhone,
+    ownerMatchesEtrade: ownerNameMatchesEtrade(owner.name, etradeManagerName),
+    complete: subject !== null && identityProven,
   };
 }
diff --git a/apps/edr-freight-api/src/modules/companies/dto/create-company-with-profile.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/create-company-with-profile.dto.ts
index 7816572ec..d82093336 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/create-company-with-profile.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/create-company-with-profile.dto.ts
@@ -1,9 +1,18 @@
-import { IsString, IsNotEmpty, IsOptional, IsEmail, MaxLength, IsBoolean, IsEnum, IsArray, ValidateNested, ArrayMinSize } from 'class-validator';
-import { Type } from 'class-transformer';
-import { CompanyType } from '../entities/company.entity';
-import { ProfileType } from '../entities/company-profile.entity';
-import { IsValidPhone } from '../../../common/validators/is-phone-number.validator';
-import { IsTin } from '../../../common/validators/is-tin.validator';
+import {
+  IsString,
+  IsNotEmpty,
+  IsOptional,
+  MaxLength,
+  IsBoolean,
+  IsEnum,
+  IsArray,
+  ValidateNested,
+  ArrayMinSize,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { CompanyType } from "../entities/company.entity";
+import { ProfileType } from "../entities/company-profile.entity";
+import { IsTin } from "../../../common/validators/is-tin.validator";
 
 export class CompanyProfileInputDto {
   @IsEnum(ProfileType)
@@ -24,17 +33,6 @@ export class CreateCompanyWithProfileDto {
   @MaxLength(200)
   companyName!: string;
 
-  @IsOptional()
-  @IsEmail()
-  @MaxLength(150)
-  companyEmail?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(20)
-  @IsValidPhone()
-  companyPhone?: string;
-
   @IsOptional()
   @IsString()
   @MaxLength(32)
@@ -46,7 +44,7 @@ export class CreateCompanyWithProfileDto {
 
   @IsOptional()
   @IsString()
-  @IsTin({ message: 'TIN must be exactly 10 digits' })
+  @IsTin({ message: "TIN must be exactly 10 digits" })
   tin?: string;
 
   @IsOptional()
diff --git a/apps/edr-freight-api/src/modules/companies/dto/etrade-response.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/etrade-response.dto.ts
index bfe1f9b72..40b1f308e 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/etrade-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/etrade-response.dto.ts
@@ -1,4 +1,4 @@
-import { CompanyRegistrationData } from "@edr/types";
+import { CompanyRegistrationData, ETradeBusinessOption } from "@edr/types";
 
 export class ETradeResponseDto implements CompanyRegistrationData {
   companyName!: string;
@@ -19,6 +19,7 @@ export class ETradeResponseDto implements CompanyRegistrationData {
   managerEmail?: string;
   managerPhone!: string;
   tinTaken?: boolean;
+  businesses?: ETradeBusinessOption[];
 
   constructor(data: CompanyRegistrationData) {
     this.companyName = data.companyName;
@@ -39,5 +40,6 @@ export class ETradeResponseDto implements CompanyRegistrationData {
     this.managerEmail = data.managerEmail;
     this.managerPhone = data.managerPhone;
     this.tinTaken = data.tinTaken;
+    this.businesses = data.businesses;
   }
 }
diff --git a/apps/edr-freight-api/src/modules/companies/dto/fetch-etrade.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/fetch-etrade.dto.ts
index 466c03ed6..9ca533835 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/fetch-etrade.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/fetch-etrade.dto.ts
@@ -1,4 +1,4 @@
-import { IsString, IsNotEmpty } from "class-validator";
+import { IsString, IsNotEmpty, IsOptional, MaxLength } from "class-validator";
 import { IsTin } from "../../../common/validators/is-tin.validator";
 
 export class FetchETradeDto {
@@ -6,4 +6,14 @@ export class FetchETradeDto {
   @IsNotEmpty()
   @IsTin({ message: "TIN must be exactly 10 digits" })
   tin!: string;
+
+  /**
+   * Which of the TIN's business licences to resolve. Omitted on the first
+   * lookup — the response lists them all so the customer can pick, and the pick
+   * comes back here.
+   */
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  licenceNumber?: string;
 }
diff --git a/apps/edr-freight-api/src/modules/companies/dto/onboarding-requirements-response.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/onboarding-requirements-response.dto.ts
index a8d2f24a2..49dad4b8d 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/onboarding-requirements-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/onboarding-requirements-response.dto.ts
@@ -8,7 +8,10 @@
  * truth the wizard uses to auto-finish.
  */
 
-import { CompanyIdentityStateDto } from "./complete-identity-verification.dto";
+import {
+  CompanyIdentityStateDto,
+  PoaDeclaration,
+} from "./complete-identity-verification.dto";
 
 export interface OnboardingInfoField {
   key: string;
@@ -38,10 +41,20 @@ export interface OnboardingLicenseProfile {
 }
 
 export interface OnboardingPoaState {
-  /** True when the company operates as a freight forwarder — PoA is mandatory. */
-  required: boolean;
-  /** True once any PoA detail has been entered. */
-  provided: boolean;
+  /**
+   * True when the company operates as a freight forwarder: it signs on other
+   * companies' behalf, so a Power of Attorney is non-negotiable and the portal
+   * renders the question answered and locked rather than asking it.
+   */
+  locked: boolean;
+  /**
+   * The company's answer to "does anyone hold power of attorney for you?".
+   * Null until it answers — which is itself outstanding, since the answer
+   * decides whose identity is verified.
+   */
+  declared: PoaDeclaration | null;
+  /** True when the DARS delegation paper is owed — i.e. `declared === "yes"`. */
+  delegationLetterRequired: boolean;
   /** True when the DARS delegation paper is stored for the company. */
   delegationLetterUploaded: boolean;
   /** True when a reviewer sent the paper back for correction. */
@@ -53,9 +66,25 @@ export interface OnboardingPoaState {
 }
 
 export class OnboardingRequirementsResponseDto {
-  /** Resolved document setting code (by nationality) the docs were drawn from. */
+  /**
+   * Resolved document setting code the docs were drawn from: the company's
+   * nationality set, or the co-operative set in its place.
+   */
   documentSettingCode: string;
   nationality: string;
+  /**
+   * The company trades as a co-operative: no business licence, so no eTrade
+   * lookup, no per-role licence upload, and no freight-forwarder role.
+   */
+  cooperative: boolean;
+
+  /**
+   * The company is a foreign investor on an investment licence: no eTrade
+   * record, so the registration was typed. The nationality document set still
+   * applies (it already asks for the investment licence itself), and so does
+   * the per-role business licence.
+   */
+  investorLicence: boolean;
 
   /** Required company-information fields and whether each is filled. */
   companyInfo: {
@@ -94,6 +123,8 @@ export class OnboardingRequirementsResponseDto {
   constructor(init: Omit<OnboardingRequirementsResponseDto, never>) {
     this.documentSettingCode = init.documentSettingCode;
     this.nationality = init.nationality;
+    this.cooperative = init.cooperative;
+    this.investorLicence = init.investorLicence;
     this.companyInfo = init.companyInfo;
     this.documents = init.documents;
     this.licenseProfiles = init.licenseProfiles;
diff --git a/apps/edr-freight-api/src/modules/companies/dto/profile-response.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/profile-response.dto.ts
index f0a19dad7..14753f8ef 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/profile-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/profile-response.dto.ts
@@ -2,21 +2,35 @@ import {
   buildCompanyIdentityState,
   CompanyIdentityStateDto,
 } from "./complete-identity-verification.dto";
-import { Company } from '../entities/company.entity';
-import { ExternalProfile } from '../entities/external-profile.entity';
+import {
+  Company,
+  hasInvestorLicence,
+  isCooperative,
+} from "../entities/company.entity";
+import { ExternalProfile } from "../entities/external-profile.entity";
 import {
   ChangeRequestStatus,
   CompanyChangeRequest,
-} from '../entities/company-change-request.entity';
-import { ResponseCompanyProfileDto } from './response-company.dto';
+} from "../entities/company-change-request.entity";
+import { ResponseCompanyProfileDto } from "./response-company.dto";
 
 export class ProfileResponseDto {
   companyId: string;
   companyName: string;
   companyType: string;
   nationality: string | null;
-  companyEmail: string | null;
-  companyPhone: string | null;
+  /**
+   * The company trades as a co-operative: it has a TIN but no business licence,
+   * so the company step collects the registration by hand instead of fetching
+   * it from eTrade.
+   */
+  cooperative: boolean;
+  /**
+   * The company is a foreign investor on an investment licence: eTrade holds
+   * no record, so the company step collects the registration by hand. Drives
+   * the settings card that switches back to the eTrade route.
+   */
+  investorLicence: boolean;
   companyLocation: string;
   companyAddress: string | null;
   tinNumber: string;
@@ -44,9 +58,10 @@ export class ProfileResponseDto {
   contactPersonPhone: string | null;
   /** Phone that passed SMS OTP verification (drives the verify-step resume). */
   contactVerifiedPhone: string | null;
-  generalManagerName: string | null;
-  generalManagerEmail: string | null;
-  generalManagerPhone: string | null;
+  /** The owner — whoever the eTrade licence names as the business's manager. */
+  ownerName: string | null;
+  ownerEmail: string | null;
+  ownerPhone: string | null;
 
   poaName: string | null;
   poaPhone: string | null;
@@ -57,12 +72,13 @@ export class ProfileResponseDto {
   profileId: string;
 
   /**
-   * Fayda verification state for the company's owner and PoA — not the general
-   * manager, which is a separate typed role. The settings tabs and the
-   * onboarding wizard render from `identity.faydaRequired` /
-   * `identity.passportRequired`: an Ethiopian company verifies the owner (and
-   * PoA) instead of typing their details; a foreign one requires a typed
-   * passport number instead.
+   * The company's single identity verification, plus who it belongs to.
+   *
+   * `identity.subject` follows the company's PoA declaration — the
+   * representative when one is named, otherwise the owner. The settings tabs
+   * and the onboarding wizard render from it: `passportAccepted` says whether a
+   * typed passport number is an alternative to Fayda (foreign companies only),
+   * and `ownerMatchesEtrade` is the check the backoffice makes.
    */
   identity: CompanyIdentityStateDto;
 
@@ -86,11 +102,11 @@ export class ProfileResponseDto {
     this.companyName = company.name;
     this.companyType = company.type;
     this.nationality = company.nationality ?? null;
+    this.cooperative = isCooperative(company);
+    this.investorLicence = hasInvestorLicence(company);
     this.companyProfiles =
       company.companyProfiles?.map((p) => new ResponseCompanyProfileDto(p)) ??
       [];
-    this.companyEmail = company.email ?? null;
-    this.companyPhone = company.phone ?? null;
     this.companyLocation = company.country;
     this.companyAddress = company.address ?? null;
     this.tinNumber = company.tin;
@@ -117,9 +133,9 @@ export class ProfileResponseDto {
     this.contactPersonEmail = attrs.contactPersonEmail ?? null;
     this.contactPersonPhone = attrs.contactPersonPhone ?? null;
     this.contactVerifiedPhone = attrs.contactVerifiedPhone ?? null;
-    this.generalManagerName = attrs.generalManagerName ?? null;
-    this.generalManagerEmail = attrs.generalManagerEmail ?? null;
-    this.generalManagerPhone = attrs.generalManagerPhone ?? null;
+    this.ownerName = attrs.ownerName ?? null;
+    this.ownerEmail = attrs.ownerEmail ?? null;
+    this.ownerPhone = attrs.ownerPhone ?? null;
     this.poaName = attrs.poaName ?? null;
     this.poaPhone = attrs.poaPhone ?? null;
     this.poaEmail = attrs.poaEmail ?? null;
@@ -128,9 +144,9 @@ export class ProfileResponseDto {
 
     const openReview =
       changeRequest &&
-      (changeRequest.status === ChangeRequestStatus.Pending ||
-        changeRequest.status === ChangeRequestStatus.Rejected ||
-        changeRequest.status === ChangeRequestStatus.ChangesRequested)
+        (changeRequest.status === ChangeRequestStatus.Pending ||
+          changeRequest.status === ChangeRequestStatus.Rejected ||
+          changeRequest.status === ChangeRequestStatus.ChangesRequested)
         ? changeRequest
         : null;
     this.reviewStatus =
diff --git a/apps/edr-freight-api/src/modules/companies/dto/response-company.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/response-company.dto.ts
index d705e7323..7c4348e4f 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/response-company.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/response-company.dto.ts
@@ -3,6 +3,8 @@ import {
   CompanyType,
   CompanyStatus,
   CompanyNationality,
+  hasInvestorLicence,
+  isCooperative,
 } from '../entities/company.entity';
 import {
   CompanyProfile,
@@ -55,6 +57,19 @@ export class ResponseCompanyDto {
   type: CompanyType;
   status: CompanyStatus;
   nationality?: CompanyNationality | null;
+  /**
+   * The company trades as a co-operative: no business licence, so its
+   * registration was typed rather than fetched from eTrade and there is no
+   * eTrade manager to check the owner against.
+   */
+  cooperative: boolean;
+  /**
+   * The company onboarded as a foreign investor on an investment licence:
+   * eTrade holds no record for its TIN, so its registration below was typed by
+   * the customer rather than fetched — nothing here has been checked against a
+   * licence, and the reviewer is the check.
+   */
+  investorLicence: boolean;
   tin: string;
   vatNumber?: string | null;
   fanNumber?: string | null;
@@ -89,9 +104,14 @@ export class ResponseCompanyDto {
   houseNo?: string | null;
 
   /**
-   * Owner/PoA Fayda verification state, shared with the portal
-   * (`buildCompanyIdentityState`) so backoffice never re-derives — or
-   * disagrees with — the rule the API actually enforces.
+   * The company's single identity verification, shared with the portal
+   * (`buildCompanyIdentityState`) so backoffice never re-derives — or disagrees
+   * with — the rule the API actually enforces.
+   *
+   * `subject` names whose verification it is (the PoA when one is declared,
+   * otherwise the owner), and `ownerMatchesEtrade` is the reviewer's check:
+   * does the owner the company put forward match the manager on the eTrade
+   * licence? Advisory — see the note on that field.
    */
   identity: CompanyIdentityStateDto;
 
@@ -105,6 +125,8 @@ export class ResponseCompanyDto {
     this.type = company.type;
     this.status = company.status;
     this.nationality = company.nationality ?? null;
+    this.cooperative = isCooperative(company);
+    this.investorLicence = hasInvestorLicence(company);
     this.tin = company.tin;
     this.vatNumber = company.vatNumber;
     this.fanNumber = company.fanNumber;
diff --git a/apps/edr-freight-api/src/modules/companies/dto/set-poa-declared.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/set-poa-declared.dto.ts
new file mode 100644
index 000000000..37c54b254
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/dto/set-poa-declared.dto.ts
@@ -0,0 +1,17 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsIn } from "class-validator";
+
+import {
+  POA_DECLARATIONS,
+  PoaDeclaration,
+} from "./complete-identity-verification.dto";
+
+export class SetPoaDeclaredDto {
+  @ApiProperty({
+    enum: POA_DECLARATIONS,
+    description:
+      'Whether anyone holds power of attorney for this company. "no" tears down any representative already recorded.',
+  })
+  @IsIn(POA_DECLARATIONS)
+  declared!: PoaDeclaration;
+}
diff --git a/apps/edr-freight-api/src/modules/companies/dto/start-onboarding.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/start-onboarding.dto.ts
index 7687faab1..0eac35a5f 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/start-onboarding.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/start-onboarding.dto.ts
@@ -1,4 +1,10 @@
-import { ArrayMinSize, IsArray, IsEnum, IsOptional } from "class-validator";
+import {
+  ArrayMinSize,
+  IsArray,
+  IsBoolean,
+  IsEnum,
+  IsOptional,
+} from "class-validator";
 import { CompanyNationality, CompanyType } from "../entities/company.entity";
 import { ProfileType } from "../entities/company-profile.entity";
 
@@ -14,4 +20,26 @@ export class StartOnboardingDto {
   @IsOptional()
   @IsEnum(CompanyNationality)
   nationality?: CompanyNationality;
+
+  /**
+   * The company trades as a co-operative: it holds a TIN but no business
+   * licence, so there is no eTrade record to fetch its registration from.
+   * Chosen on the same step as the nationality and the roles, because it
+   * decides all three of what the next step asks for, which documents apply,
+   * and which roles are even available (a co-op cannot freight-forward).
+   */
+  @IsOptional()
+  @IsBoolean()
+  cooperative?: boolean;
+
+  /**
+   * The company is a foreign investor: it operates on an investment licence
+   * issued by the Ethiopian Investment Commission, so eTrade holds no record
+   * for its TIN and the registration is typed here instead. Chosen on the same
+   * step for the same reason as the co-operative flag — it decides what the
+   * company step asks for. Only a foreign company can hold one.
+   */
+  @IsOptional()
+  @IsBoolean()
+  investorLicence?: boolean;
 }
diff --git a/apps/edr-freight-api/src/modules/companies/dto/update-profile.dto.ts b/apps/edr-freight-api/src/modules/companies/dto/update-profile.dto.ts
index dc7729479..2273bf79a 100644
--- a/apps/edr-freight-api/src/modules/companies/dto/update-profile.dto.ts
+++ b/apps/edr-freight-api/src/modules/companies/dto/update-profile.dto.ts
@@ -5,12 +5,11 @@ import {
   MaxLength,
   IsEnum,
   IsIn,
-  Matches,
-} from 'class-validator';
-import { ETHIOPIAN_REGIONS, type EthiopianRegion } from '@edr/types';
-import { CompanyNationality } from '../entities/company.entity';
-import { IsValidPhone } from '../../../common/validators/is-phone-number.validator';
-import { IsTin } from '../../../common/validators/is-tin.validator';
+} from "class-validator";
+import { ETHIOPIAN_REGIONS, type EthiopianRegion } from "@edr/types";
+import { CompanyNationality } from "../entities/company.entity";
+import { IsValidPhone } from "../../../common/validators/is-phone-number.validator";
+import { IsTin } from "../../../common/validators/is-tin.validator";
 
 export class UpdateProfileDto {
   @IsOptional()
@@ -22,17 +21,6 @@ export class UpdateProfileDto {
   @MaxLength(200)
   companyName?: string;
 
-  @IsOptional()
-  @IsEmail()
-  @MaxLength(150)
-  companyEmail?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(20)
-  @IsValidPhone()
-  companyPhone?: string;
-
   @IsOptional()
   @IsString()
   @MaxLength(32)
@@ -44,23 +32,24 @@ export class UpdateProfileDto {
 
   @IsOptional()
   @IsString()
-  @IsTin({ message: 'TIN must be exactly 10 digits' })
+  @IsTin({ message: "TIN must be exactly 10 digits" })
   tin?: string;
 
-  // Ethiopian VAT registration numbers are 10 digits, the same shape as the
-  // TIN. Both portal forms enforce that; without it here the API happily stored
-  // whatever a stale client sent, and the two layers disagreed about what the
-  // column may hold.
+  // No shape check. Ethiopian VAT numbers are usually 10 or 11 digits, but a
+  // foreign company's is whatever its own tax authority issues — letters,
+  // dashes and any length — and a co-operative's registration numbering does
+  // not follow the trade-licence pattern either. The field is required (the
+  // portal enforces non-blank) but its content is not ours to police.
   @IsOptional()
   @IsString()
-  @Matches(/^\d{10}$/, { message: 'VAT number must be exactly 10 digits' })
+  @MaxLength(64)
   vatNumber?: string;
 
-  // `fanNumber` is deliberately absent: the FAN is the Fayda number of the
-  // company's PoA (or its general manager), so it is derived from a completed
-  // Fayda verification rather than typed. The global validation pipe runs with
-  // forbidNonWhitelisted, so a client that still sends it gets a 400 telling it
-  // so — see CompaniesService.completeIdentityVerification.
+  // `fanNumber` is deliberately absent: the FAN is a Fayda number, so it would
+  // have to come from a completed verification rather than be typed — and
+  // Fayda's userinfo carries no national ID number, so nothing produces one.
+  // The global validation pipe runs with forbidNonWhitelisted, so a client that
+  // still sends it gets a 400 telling it so.
 
   @IsOptional()
   @IsString()
@@ -89,18 +78,31 @@ export class UpdateProfileDto {
   @IsValidPhone()
   contactVerifiedPhone?: string;
 
+  /**
+   * The owner — whoever the eTrade licence names as the business's manager.
+   *
+   * All three are required before onboarding can be submitted, whatever their
+   * source: the eTrade lookup prefills the name and phone, a Fayda
+   * verification can supply all three, and the portal renders an input for
+   * whatever neither did (eTrade returns no email at all, and Fayda's email
+   * claim is optional, so that one is usually typed).
+   *
+   * Locked once a Fayda verification supplied them — see
+   * `IDENTITY_OWNED_FIELDS` — but only field by field: a claim that came back
+   * empty owns nothing and stays typeable.
+   */
   @IsOptional()
   @IsString()
-  generalManagerName?: string;
+  ownerName?: string;
 
   @IsOptional()
   @IsEmail()
-  generalManagerEmail?: string;
+  ownerEmail?: string;
 
   @IsOptional()
   @IsString()
   @IsValidPhone()
-  generalManagerPhone?: string;
+  ownerPhone?: string;
 
   @IsOptional()
   @IsString()
@@ -124,15 +126,22 @@ export class UpdateProfileDto {
   poaAddress?: string;
 
   /**
-   * The owner's passport number — the identity credential for a foreign
-   * company, since Fayda is an Ethiopian national ID. Plain typed field, never
-   * written or locked by a Fayda verification: still required even if the
-   * owner also verifies.
+   * Passport numbers — the alternative identity credential for a foreign
+   * company, since Fayda is an Ethiopian national ID. Plain typed fields, never
+   * written or locked by a Fayda verification.
+   *
+   * Only the one belonging to the company's declared identity subject matters:
+   * the PoA's when a representative is named, the owner's otherwise. An
+   * Ethiopian company is not offered either — it must use Fayda.
    */
   @IsOptional()
   @IsString()
   ownerPassportNumber?: string;
 
+  @IsOptional()
+  @IsString()
+  poaPassportNumber?: string;
+
   @IsOptional()
   @IsString()
   @MaxLength(100)
diff --git a/apps/edr-freight-api/src/modules/companies/entities/company-change-request.entity.ts b/apps/edr-freight-api/src/modules/companies/entities/company-change-request.entity.ts
index 2ba39ecad..02b49f849 100644
--- a/apps/edr-freight-api/src/modules/companies/entities/company-change-request.entity.ts
+++ b/apps/edr-freight-api/src/modules/companies/entities/company-change-request.entity.ts
@@ -110,4 +110,12 @@ export class CompanyChangeRequest extends BaseEntity {
 
   @Column({ name: "reviewed_at", type: "timestamptz", nullable: true })
   reviewedAt?: Date | null;
+
+  /**
+   * Display names for {@link submittedBy} / {@link reviewedBy}, resolved from
+   * `iam.users` on read. Not columns — the history screen has to name the
+   * person who asked for the change, and an opaque uuid does not.
+   */
+  submittedByName?: string | null;
+  reviewedByName?: string | null;
 }
diff --git a/apps/edr-freight-api/src/modules/companies/entities/company-revision.entity.ts b/apps/edr-freight-api/src/modules/companies/entities/company-revision.entity.ts
index 222a8364f..533f08d7a 100644
--- a/apps/edr-freight-api/src/modules/companies/entities/company-revision.entity.ts
+++ b/apps/edr-freight-api/src/modules/companies/entities/company-revision.entity.ts
@@ -43,4 +43,10 @@ export class CompanyRevision extends BaseEntity {
 
   @Column({ name: "changes", type: "jsonb", default: () => `'[]'::jsonb` })
   changes!: CompanyRevisionChange[];
+
+  /**
+   * Display name for {@link actorId}, resolved from `iam.users` on read. Not a
+   * column — history has to name who made the edit, and a uuid does not.
+   */
+  actorName?: string | null;
 }
diff --git a/apps/edr-freight-api/src/modules/companies/entities/company.entity.ts b/apps/edr-freight-api/src/modules/companies/entities/company.entity.ts
index f254e0121..68bf73cdf 100644
--- a/apps/edr-freight-api/src/modules/companies/entities/company.entity.ts
+++ b/apps/edr-freight-api/src/modules/companies/entities/company.entity.ts
@@ -32,6 +32,56 @@ export enum CompanyNationality {
   Foreign = "foreign",
 }
 
+/**
+ * `attributes` key marking a co-operative union or farm.
+ *
+ * Such a company has a TIN but no business licence, so there is no eTrade record to
+ * look its registration up in — the company name, registered address and the
+ * owner are all typed instead of fetched, and the eTrade authenticity check is
+ * skipped rather than failed. It is a flag rather than a column because
+ * everything it changes is behavioural (which lookup runs, which documents
+ * apply, which roles are offered); nothing queries or joins on it.
+ */
+export const COOPERATIVE_KEY = "cooperative";
+
+/** Is this a co-operative union or farm (a TIN, but no business licence)? */
+export function isCooperative(
+  company: Pick<Company, "attributes"> | null | undefined,
+): boolean {
+  return company?.attributes?.[COOPERATIVE_KEY] === true;
+}
+
+/**
+ * `attributes` key marking a foreign company onboarding on an investment
+ * licence.
+ *
+ * The Ethiopian Investment Commission registers it, not the trade registry, so
+ * eTrade holds no record for its TIN: the registration is typed and the eTrade
+ * authenticity check is skipped rather than failed — exactly as for a
+ * co-operative. What does NOT change is the licence: the company still holds
+ * one per operational role, so that requirement stands.
+ */
+export const INVESTOR_LICENCE_KEY = "investorLicence";
+
+/** Is this a foreign company registered on an investment licence? */
+export function hasInvestorLicence(
+  company: Pick<Company, "attributes"> | null | undefined,
+): boolean {
+  return company?.attributes?.[INVESTOR_LICENCE_KEY] === true;
+}
+
+/**
+ * eTrade holds nothing for this company, so its registration was typed by hand
+ * rather than fetched — and the backoffice is told so. Two different companies
+ * reach it (a co-operative has no licence at all; a foreign investor's is not
+ * the trade registry's), and every consequence they share hangs off this.
+ */
+export function usesManualRegistration(
+  company: Pick<Company, "attributes"> | null | undefined,
+): boolean {
+  return isCooperative(company) || hasInvestorLicence(company);
+}
+
 @Entity({ schema: "freight", name: "companies" })
 @Index(["tin"])
 @Index(["type"])
@@ -112,29 +162,11 @@ export class Company extends BaseEntity {
   })
   contactPersonPhone?: string | null;
 
-  @Column({
-    name: "general_manager_name",
-    type: "varchar",
-    length: 100,
-    nullable: true,
-  })
-  generalManagerName?: string | null;
-
-  @Column({
-    name: "general_manager_email",
-    type: "varchar",
-    length: 150,
-    nullable: true,
-  })
-  generalManagerEmail?: string | null;
-
-  @Column({
-    name: "general_manager_phone",
-    type: "varchar",
-    length: 20,
-    nullable: true,
-  })
-  generalManagerPhone?: string | null;
+  // The general manager used to live here as three columns. It named who to
+  // talk to, gated nothing, and nothing ever populated the columns — the write
+  // path put the values in `attributes`. Removed in RemoveGeneralManager; the
+  // company's people are now its owner (whoever the eTrade licence names) and
+  // its Power of Attorney, both in `attributes`.
 
   @Column({ name: "website", type: "varchar", length: 200, nullable: true })
   website?: string | null;
diff --git a/apps/edr-freight-api/src/modules/companies/services/etrade-business-selection.spec.ts b/apps/edr-freight-api/src/modules/companies/services/etrade-business-selection.spec.ts
new file mode 100644
index 000000000..86117d306
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/companies/services/etrade-business-selection.spec.ts
@@ -0,0 +1,102 @@
+import { ETradeService } from './etrade.service';
+import type { ETradeBusinessInfo, ETradeCompanyInfo } from '@edr/types';
+
+/**
+ * A TIN routinely holds several business licences (import of vehicles, export of
+ * coffee, freight forwarding…), all under the same trade name. The customer
+ * picks one, and every later lookup has to resolve that same licence — snapping
+ * back to eTrade's first would silently swap their company record.
+ */
+const companyInfo = (): ETradeCompanyInfo =>
+  ({
+    Tin: '0045014036',
+    BusinessName: 'PAVE LOGISTICS AND TRADING P L C',
+    Businesses: [
+      {
+        LicenceNumber: 'MT/AA/14/670/11551235/2017',
+        TradesName: 'PAVE LOGISTICS AND TRADING P L C',
+        RenewedTo: '7/7/2026',
+        SubGroups: [
+          { Code: 66331, Description: 'Export trade in minerals' },
+        ],
+      },
+      {
+        LicenceNumber: 'MT/AA/14/670/128936/2007',
+        TradesName: 'PAVE LOGISTICS AND TRADING P L C',
+        RenewedTo: '7/7/2026',
+        SubGroups: [{ Code: 72131, Description: '(72131)Freight Forwarders' }],
+      },
+    ],
+  }) as unknown as ETradeCompanyInfo;
+
+describe('ETradeService business selection', () => {
+  const build = () => {
+    const service = new ETradeService({} as never);
+    const fetched: string[] = [];
+    jest
+      .spyOn(service, 'getCompanyInfoByTin')
+      .mockResolvedValue(companyInfo());
+    jest
+      .spyOn(service, 'getBusinessByLicenseNo')
+      .mockImplementation(async (licenceNo: string) => {
+        fetched.push(licenceNo);
+        return { LicenceNumber: licenceNo } as ETradeBusinessInfo;
+      });
+    return { service, fetched };
+  };
+
+  it('defaults to the first licence when none is chosen', async () => {
+    const { service, fetched } = build();
+    await service.resolveCompanyData('0045014036');
+    expect(fetched).toEqual(['MT/AA/14/670/11551235/2017']);
+  });
+
+  it('resolves the chosen licence', async () => {
+    const { service, fetched } = build();
+    await service.resolveCompanyData('0045014036', 'MT/AA/14/670/128936/2007');
+    expect(fetched).toEqual(['MT/AA/14/670/128936/2007']);
+  });
+
+  it('falls back to the first licence when the chosen one is gone', async () => {
+    const { service, fetched } = build();
+    await service.resolveCompanyData('0045014036', 'NO/SUCH/LICENCE');
+    expect(fetched).toEqual(['MT/AA/14/670/11551235/2017']);
+  });
+
+  it('survives the null entries eTrade puts in SubGroups', () => {
+    const { service } = build();
+    const info = companyInfo();
+    (info.Businesses[0] as any).SubGroups = [
+      null,
+      { Code: 66331, Description: 'Export trade in minerals' },
+      { Code: 1, Description: null },
+    ];
+    const data = service.extractRegistrationData(
+      { LicenceNumber: 'x' } as ETradeBusinessInfo,
+      info,
+    );
+    expect(data.businesses?.[0].activity).toBe('Export trade in minerals');
+  });
+
+  it('lists every licence for the picker, code prefixes stripped', () => {
+    const { service } = build();
+    const data = service.extractRegistrationData(
+      { LicenceNumber: 'x' } as ETradeBusinessInfo,
+      companyInfo(),
+    );
+    expect(data.businesses).toEqual([
+      {
+        licenceNumber: 'MT/AA/14/670/11551235/2017',
+        tradeName: 'PAVE LOGISTICS AND TRADING P L C',
+        activity: 'Export trade in minerals',
+        renewedTo: '7/7/2026',
+      },
+      {
+        licenceNumber: 'MT/AA/14/670/128936/2007',
+        tradeName: 'PAVE LOGISTICS AND TRADING P L C',
+        activity: 'Freight Forwarders',
+        renewedTo: '7/7/2026',
+      },
+    ]);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/companies/services/etrade.service.ts b/apps/edr-freight-api/src/modules/companies/services/etrade.service.ts
index 3292ee2d3..fac57238a 100644
--- a/apps/edr-freight-api/src/modules/companies/services/etrade.service.ts
+++ b/apps/edr-freight-api/src/modules/companies/services/etrade.service.ts
@@ -66,7 +66,15 @@ export class ETradeService {
     }
   }
 
-  async resolveCompanyData(tin: string): Promise<{
+  /**
+   * @param licenceNumber which of the TIN's licences to resolve. Defaults to the
+   * first one — a TIN with several licences is only unambiguous once the
+   * customer has picked one (see {@link ETradeBusinessOption}).
+   */
+  async resolveCompanyData(
+    tin: string,
+    licenceNumber?: string,
+  ): Promise<{
     companyInfo: ETradeCompanyInfo;
     businessInfo: ETradeBusinessInfo | null;
   }> {
@@ -76,10 +84,15 @@ export class ETradeService {
       return { companyInfo, businessInfo: null };
     }
 
-    const latestBusiness = companyInfo.Businesses[0];
+    // An unknown licence falls back to the first rather than 400-ing: eTrade can
+    // drop or renumber a licence between the customer picking it and the save
+    // that re-verifies it, and that must not lock them out of their own profile.
+    const selected =
+      companyInfo.Businesses.find((b) => b.LicenceNumber === licenceNumber) ??
+      companyInfo.Businesses[0];
     try {
       const businessInfo = await this.getBusinessByLicenseNo(
-        latestBusiness.LicenceNumber,
+        selected.LicenceNumber,
         tin,
       );
       return { companyInfo, businessInfo };
@@ -124,6 +137,17 @@ export class ETradeService {
       regularPhone: businessInfo.AddressInfo?.RegularPhone || "",
       managerName: primaryManager?.ManagerNameEng || "",
       managerPhone: primaryManager?.RegularPhone || "",
+      businesses: (companyInfo?.Businesses ?? []).map((b) => ({
+        licenceNumber: b.LicenceNumber,
+        tradeName: b.TradesName?.trim() || "",
+        activity: (b.SubGroups ?? [])
+          // Some descriptions repeat the code inline ("(65611)Import trade …").
+          // eTrade also puts null entries in this array, so every hop is optional.
+          .map((g) => g?.Description?.replace(/^\(\d+\)\s*/, "").trim())
+          .filter(Boolean)
+          .join(", "),
+        renewedTo: b.RenewedTo || "",
+      })),
     };
   }
 }
diff --git a/apps/edr-freight-api/src/modules/container-management/entities/container.entity.ts b/apps/edr-freight-api/src/modules/container-management/entities/container.entity.ts
index e6fdd47ee..ec6df69c5 100644
--- a/apps/edr-freight-api/src/modules/container-management/entities/container.entity.ts
+++ b/apps/edr-freight-api/src/modules/container-management/entities/container.entity.ts
@@ -32,7 +32,7 @@ export class Container extends BaseEntity {
   type: 'varchar',
   nullable: true,
 })
-sealNumber!: string | null;
+  sealNumber!: string | null;
 
   @Column({ type: 'varchar', default: 'AVAILABLE' })
   status!: string; // AVAILABLE, LOADED, IN_TRANSIT, MAINTENANCE, DAMAGED
diff --git a/apps/edr-freight-api/src/modules/contract-templates/bulk-template-direction.spec.ts b/apps/edr-freight-api/src/modules/contract-templates/bulk-template-direction.spec.ts
new file mode 100644
index 000000000..b822387da
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/contract-templates/bulk-template-direction.spec.ts
@@ -0,0 +1,134 @@
+import { BadRequestException } from '@nestjs/common';
+
+import { ContractTemplatesRepository } from './contract-templates.repository';
+import { ContractTemplatesService } from './contract-templates.service';
+import {
+  bulkTemplateCode,
+  bulkTemplateDirectionFor,
+} from './entities/contract-template.entity';
+
+describe('bulkTemplateDirectionFor', () => {
+  it('maps the contract-side DOMESTIC onto the template-side INTERCITY', () => {
+    expect(bulkTemplateDirectionFor('DOMESTIC')).toBe('INTERCITY');
+    expect(bulkTemplateDirectionFor('INTERCITY')).toBe('INTERCITY');
+    expect(bulkTemplateDirectionFor(null)).toBe('INTERCITY');
+    expect(bulkTemplateDirectionFor(undefined)).toBe('INTERCITY');
+    expect(bulkTemplateDirectionFor('IMPORT')).toBe('IMPORT');
+    expect(bulkTemplateDirectionFor('EXPORT')).toBe('EXPORT');
+  });
+});
+
+describe('bulkTemplateCode', () => {
+  it('gives each direction/customs combination its own code', () => {
+    expect(bulkTemplateCode('STEEL', 'IMPORT', true)).toBe('BULK_IMPORT_STEEL_CUSTOMS');
+    expect(bulkTemplateCode('STEEL', 'IMPORT', false)).toBe(
+      'BULK_IMPORT_STEEL_NO_CUSTOMS',
+    );
+    expect(bulkTemplateCode('STEEL', 'EXPORT', true)).toBe('BULK_EXPORT_STEEL_CUSTOMS');
+    expect(bulkTemplateCode('STEEL', 'EXPORT', false)).toBe(
+      'BULK_EXPORT_STEEL_NO_CUSTOMS',
+    );
+  });
+
+  it('leaves intercity unsuffixed — it crosses no border', () => {
+    expect(bulkTemplateCode('STEEL', 'INTERCITY', null)).toBe('BULK_INTERCITY_STEEL');
+  });
+
+  it('produces 5 distinct codes per cargo type', () => {
+    const codes = [
+      bulkTemplateCode('STEEL', 'IMPORT', true),
+      bulkTemplateCode('STEEL', 'IMPORT', false),
+      bulkTemplateCode('STEEL', 'EXPORT', true),
+      bulkTemplateCode('STEEL', 'EXPORT', false),
+      bulkTemplateCode('STEEL', 'INTERCITY', null),
+    ];
+    expect(new Set(codes).size).toBe(5);
+  });
+});
+
+describe('ContractTemplatesService bulk create/resolve', () => {
+  function build() {
+    const repository = {
+      findCargoType: jest.fn(() =>
+        Promise.resolve({
+          id: 'cargo-1',
+          code: 'STEEL',
+          cargoTypeName: 'Steel',
+          hasContractTemplate: true,
+        }),
+      ),
+      findByCargoCombo: jest.fn(() => Promise.resolve(null)),
+      findActiveBulkTemplate: jest.fn(() => Promise.resolve(null)),
+      findByCode: jest.fn(() => Promise.resolve(null)),
+      saveTemplate: jest.fn((template) => Promise.resolve(template)),
+    } as unknown as ContractTemplatesRepository;
+    return {
+      repository,
+      service: new ContractTemplatesService(repository, {} as never),
+    };
+  }
+
+  it('stores direction and customs on an import template', async () => {
+    const { service } = build();
+    const created = await service.create({
+      cargoTypeId: 'cargo-1',
+      tradeDirection: 'EXPORT',
+      withCustoms: true,
+    });
+    expect(created.code).toBe('BULK_EXPORT_STEEL_CUSTOMS');
+    expect(created.tradeDirection).toBe('EXPORT');
+    expect(created.withCustoms).toBe(true);
+    expect(created.documentTitle).toBe(
+      'Steel Transportation and Customs Clearance Services',
+    );
+  });
+
+  it('stores a null customs flag for intercity', async () => {
+    const { service } = build();
+    const created = await service.create({
+      cargoTypeId: 'cargo-1',
+      tradeDirection: 'INTERCITY',
+    });
+    expect(created.code).toBe('BULK_INTERCITY_STEEL');
+    expect(created.withCustoms).toBeNull();
+    expect(created.documentTitle).toBe('Steel Transportation Services');
+  });
+
+  it('rejects a customs flag on intercity', async () => {
+    const { service } = build();
+    await expect(
+      service.create({
+        cargoTypeId: 'cargo-1',
+        tradeDirection: 'INTERCITY',
+        withCustoms: false,
+      }),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
+
+  it('requires a customs flag on import and export', async () => {
+    const { service } = build();
+    await expect(
+      service.create({ cargoTypeId: 'cargo-1', tradeDirection: 'IMPORT' }),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
+
+  it('resolves a domestic bulk contract to the intercity template, ignoring its customs flag', async () => {
+    const { repository, service } = build();
+    await service.findActiveForContract('DOMESTIC', 'BULK', true, 'cargo-1');
+    expect(repository.findActiveBulkTemplate).toHaveBeenCalledWith(
+      'cargo-1',
+      'INTERCITY',
+      null,
+    );
+  });
+
+  it('resolves an import bulk contract on direction and customs', async () => {
+    const { repository, service } = build();
+    await service.findActiveForContract('IMPORT', 'BULK', false, 'cargo-1');
+    expect(repository.findActiveBulkTemplate).toHaveBeenCalledWith(
+      'cargo-1',
+      'IMPORT',
+      false,
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/contract-templates/contract-templates.controller.ts b/apps/edr-freight-api/src/modules/contract-templates/contract-templates.controller.ts
index 6cba17f61..cce30c187 100644
--- a/apps/edr-freight-api/src/modules/contract-templates/contract-templates.controller.ts
+++ b/apps/edr-freight-api/src/modules/contract-templates/contract-templates.controller.ts
@@ -3,6 +3,8 @@ import {
   Controller,
   Delete,
   Get,
+  HttpCode,
+  HttpStatus,
   Param,
   Patch,
   Post,
@@ -15,55 +17,85 @@ import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
 import { ContractTemplatesService } from "./contract-templates.service";
 import {
   CreateArticleDto,
+  CreateContractTemplateDto,
   PreviewContractTemplateDto,
   ReplaceArticlesDto,
   UpdateArticleDto,
   UpdateContractTemplateDto,
 } from "./dto/contract-template.dto";
 
+// `view` opens the Templates page; `read` is API-read-only for other pages
+// that show template data; create/update/delete gate each write. `manage` is
+// the legacy write key and keeps working for roles that already hold it.
+const TEMPLATE_READ = [
+  FREIGHT_PERMS.settings.contractTemplates.view,
+  FREIGHT_PERMS.settings.contractTemplates.read,
+  FREIGHT_PERMS.settings.contractTemplates.update,
+  FREIGHT_PERMS.settings.contractTemplates.manage,
+  FREIGHT_PERMS.admin,
+];
+
+const TEMPLATE_UPDATE = [
+  FREIGHT_PERMS.settings.contractTemplates.update,
+  FREIGHT_PERMS.settings.contractTemplates.manage,
+  FREIGHT_PERMS.admin,
+];
+
 @ApiTags("contract-templates")
 @Controller("contract-templates")
 export class ContractTemplatesController {
   constructor(private readonly service: ContractTemplatesService) {}
 
-  // Reads are staff-only (the backoffice Templates tab is the only consumer);
-  // writes are admin-guarded like other freight configuration resources.
-
   @Get()
-  @BookingStaff([
-    FREIGHT_PERMS.settings.contractTemplates.view,
-    FREIGHT_PERMS.settings.contractTemplates.manage,
-    FREIGHT_PERMS.admin,
-  ])
-  @ApiOperation({ summary: "List the six contract document templates" })
+  @BookingStaff(TEMPLATE_READ)
+  @ApiOperation({ summary: "List contract templates (system container + staff-created bulk)" })
   list() {
     return this.service.list();
   }
 
-  @Get(":code")
+  @Post()
   @BookingStaff([
-    FREIGHT_PERMS.settings.contractTemplates.view,
+    FREIGHT_PERMS.settings.contractTemplates.create,
     FREIGHT_PERMS.settings.contractTemplates.manage,
     FREIGHT_PERMS.admin,
   ])
+  @ApiOperation({
+    summary:
+      "Create a bulk contract template for a (cargo type, trade direction, customs option) combination",
+  })
+  create(@Body() dto: CreateContractTemplateDto) {
+    return this.service.create(dto);
+  }
+
+  @Get(":code")
+  @BookingStaff(TEMPLATE_READ)
   @ApiOperation({ summary: "Get one contract template by code" })
   getByCode(@Param("code") code: string) {
     return this.service.getByCode(code);
   }
 
   @Patch(":code")
-  @BookingStaff([FREIGHT_PERMS.settings.contractTemplates.manage, FREIGHT_PERMS.admin])
+  @BookingStaff(TEMPLATE_UPDATE)
   @ApiOperation({ summary: "Update template metadata (name, title, recitals, active flag)" })
   update(@Param("code") code: string, @Body() dto: UpdateContractTemplateDto) {
     return this.service.update(code, dto);
   }
 
-  @Post(":code/preview")
+  @Delete(":code")
   @BookingStaff([
-    FREIGHT_PERMS.settings.contractTemplates.view,
-    FREIGHT_PERMS.settings.contractTemplates.manage,
+    FREIGHT_PERMS.settings.contractTemplates.delete,
     FREIGHT_PERMS.admin,
   ])
+  @HttpCode(HttpStatus.NO_CONTENT)
+  @ApiOperation({
+    summary: "Delete a staff-created bulk template (system templates refuse)",
+  })
+  remove(@Param("code") code: string) {
+    return this.service.remove(code);
+  }
+
+  @Post(":code/preview")
+  @BookingStaff(TEMPLATE_READ)
   @ApiOperation({
     summary: "Render an HTML preview of the template against mock contract data",
   })
@@ -77,21 +109,21 @@ export class ContractTemplatesController {
   /* ------------------------- article routes ------------------------- */
 
   @Put(":code/articles")
-  @BookingStaff([FREIGHT_PERMS.settings.contractTemplates.manage, FREIGHT_PERMS.admin])
+  @BookingStaff(TEMPLATE_UPDATE)
   @ApiOperation({ summary: "Replace the full ordered article list (used for reorder)" })
   replaceArticles(@Param("code") code: string, @Body() dto: ReplaceArticlesDto) {
     return this.service.replaceArticles(code, dto.articles);
   }
 
   @Post(":code/articles")
-  @BookingStaff([FREIGHT_PERMS.settings.contractTemplates.manage, FREIGHT_PERMS.admin])
+  @BookingStaff(TEMPLATE_UPDATE)
   @ApiOperation({ summary: "Add an article to the template" })
   addArticle(@Param("code") code: string, @Body() dto: CreateArticleDto) {
     return this.service.addArticle(code, dto);
   }
 
   @Patch(":code/articles/:articleId")
-  @BookingStaff([FREIGHT_PERMS.settings.contractTemplates.manage, FREIGHT_PERMS.admin])
+  @BookingStaff(TEMPLATE_UPDATE)
   @ApiOperation({ summary: "Update an article's title or body" })
   updateArticle(
     @Param("code") code: string,
@@ -102,7 +134,7 @@ export class ContractTemplatesController {
   }
 
   @Delete(":code/articles/:articleId")
-  @BookingStaff([FREIGHT_PERMS.settings.contractTemplates.manage, FREIGHT_PERMS.admin])
+  @BookingStaff(TEMPLATE_UPDATE)
   @ApiOperation({ summary: "Remove an article from the template" })
   removeArticle(
     @Param("code") code: string,
diff --git a/apps/edr-freight-api/src/modules/contract-templates/contract-templates.repository.ts b/apps/edr-freight-api/src/modules/contract-templates/contract-templates.repository.ts
index 2f4fb0117..1df3b1302 100644
--- a/apps/edr-freight-api/src/modules/contract-templates/contract-templates.repository.ts
+++ b/apps/edr-freight-api/src/modules/contract-templates/contract-templates.repository.ts
@@ -1,11 +1,12 @@
 import { BaseRepository } from "@edr/api-common";
 import { Injectable } from "@nestjs/common";
 import { InjectRepository } from "@nestjs/typeorm";
-import { Repository } from "typeorm";
+import { IsNull, Repository } from "typeorm";
 
+import { CargoType } from "../rule-engine/entities/cargo-type.entity";
 import {
+  BulkTemplateDirection,
   ContractTemplate,
-  ContractTemplateCode,
 } from "./entities/contract-template.entity";
 
 @Injectable()
@@ -17,12 +18,62 @@ export class ContractTemplatesRepository extends BaseRepository<ContractTemplate
     super(repository);
   }
 
-  findByCode(code: ContractTemplateCode): Promise<ContractTemplate | null> {
+  findByCode(code: string): Promise<ContractTemplate | null> {
     return this.repository.findOne({ where: { code } });
   }
 
   override findAll(): Promise<ContractTemplate[]> {
-    return this.repository.find({ order: { code: "ASC" } });
+    return this.repository.find({
+      relations: { cargoType: true },
+      order: { code: "ASC" },
+    });
+  }
+
+  findByCargoCombo(
+    cargoTypeId: string,
+    tradeDirection: BulkTemplateDirection,
+    withCustoms: boolean | null,
+  ): Promise<ContractTemplate | null> {
+    return this.repository.findOne({
+      where: { cargoTypeId, tradeDirection, withCustoms: withCustoms ?? IsNull() },
+    });
+  }
+
+  /**
+   * The active bulk template covering this cargo type: written against the
+   * cargo type itself or against its parent group (the two are mutually
+   * exclusive, so at most one row matches). Intercity templates carry no
+   * customs variant, so they are matched on a null flag.
+   */
+  findActiveBulkTemplate(
+    cargoTypeId: string,
+    tradeDirection: BulkTemplateDirection,
+    withCustoms: boolean | null,
+  ): Promise<ContractTemplate | null> {
+    return this.repository
+      .createQueryBuilder("t")
+      .where("t.is_active = true")
+      .andWhere("t.trade_direction = :tradeDirection", { tradeDirection })
+      .andWhere(
+        withCustoms === null
+          ? "t.with_customs IS NULL"
+          : "t.with_customs = :withCustoms",
+        withCustoms === null ? {} : { withCustoms },
+      )
+      .andWhere(
+        `(t.cargo_type_id = :cargoTypeId OR t.cargo_type_id = (
+           SELECT c.parent_group_id FROM freight.cargo_types c
+           WHERE c.id = :cargoTypeId AND c.deleted_at IS NULL
+         ))`,
+        { cargoTypeId },
+      )
+      .getOne();
+  }
+
+  findCargoType(id: string): Promise<CargoType | null> {
+    return this.repository.manager
+      .getRepository(CargoType)
+      .findOne({ where: { id } });
   }
 
   async saveTemplate(template: ContractTemplate): Promise<ContractTemplate> {
diff --git a/apps/edr-freight-api/src/modules/contract-templates/contract-templates.service.ts b/apps/edr-freight-api/src/modules/contract-templates/contract-templates.service.ts
index ea41b57a2..3b2e43cff 100644
--- a/apps/edr-freight-api/src/modules/contract-templates/contract-templates.service.ts
+++ b/apps/edr-freight-api/src/modules/contract-templates/contract-templates.service.ts
@@ -1,4 +1,9 @@
-import { BadRequestException, Injectable, NotFoundException } from "@nestjs/common";
+import {
+  BadRequestException,
+  ConflictException,
+  Injectable,
+  NotFoundException,
+} from "@nestjs/common";
 import { randomUUID } from "node:crypto";
 
 import { ContractRendererService } from "../../contracts/contract-renderer.service";
@@ -11,12 +16,16 @@ import {
 import { ContractTemplatesRepository } from "./contract-templates.repository";
 import {
   CreateArticleDto,
+  CreateContractTemplateDto,
   PreviewContractTemplateDto,
   ReplaceArticleDto,
   UpdateArticleDto,
   UpdateContractTemplateDto,
 } from "./dto/contract-template.dto";
 import {
+  BulkTemplateDirection,
+  bulkTemplateCode,
+  bulkTemplateDirectionFor,
   CONTRACT_TEMPLATE_CODES,
   ContractTemplate,
   ContractTemplateArticle,
@@ -53,13 +62,17 @@ export class ContractTemplatesService {
   async list(): Promise<ContractTemplate[]> {
     const templates = await this.repository.findAll();
     const rank = new Map(CONTRACT_TEMPLATE_CODES.map((code, i) => [code, i] as const));
-    return templates.sort(
-      (a, b) => (rank.get(a.code) ?? 99) - (rank.get(b.code) ?? 99),
-    );
+    // Seeded container templates first in canonical order, then staff-created
+    // bulk templates alphabetically.
+    return templates.sort((a, b) => {
+      const ra = rank.get(a.code as ContractTemplateCode) ?? 99;
+      const rb = rank.get(b.code as ContractTemplateCode) ?? 99;
+      return ra !== rb ? ra - rb : a.name.localeCompare(b.name);
+    });
   }
 
   async getByCode(code: string): Promise<ContractTemplate> {
-    const template = await this.repository.findByCode(this.assertCode(code));
+    const template = await this.repository.findByCode(code?.toUpperCase() ?? "");
     if (!template) {
       throw new NotFoundException(`Contract template ${code} not found`);
     }
@@ -67,15 +80,130 @@ export class ContractTemplatesService {
   }
 
   /**
-   * The active template used when generating a contract document for the given
-   * direction/freight/customs triple; null when missing or deactivated (the
-   * renderer then falls back to the built-in generic layout).
+   * Staff-created bulk template for one (cargo type, direction, customs
+   * option) triple. The cargo type must have hasContractTemplate enabled and
+   * the combination must not already exist — the same commodity + direction +
+   * customs pairing is edited, never duplicated.
+   *
+   * Intercity is domestic and crosses no border, so it carries no customs
+   * variant: the flag must be omitted and is stored as null.
+   */
+  async create(dto: CreateContractTemplateDto): Promise<ContractTemplate> {
+    const cargoType = await this.repository.findCargoType(dto.cargoTypeId);
+    if (!cargoType) {
+      throw new NotFoundException(`Cargo type ${dto.cargoTypeId} not found`);
+    }
+    if (!cargoType.hasContractTemplate) {
+      throw new BadRequestException(
+        `"${cargoType.cargoTypeName}" does not allow contract templates — enable "has contract template" on the cargo type first`,
+      );
+    }
+
+    const direction = dto.tradeDirection;
+    const intercity = direction === "INTERCITY";
+    if (intercity && dto.withCustoms !== undefined) {
+      throw new BadRequestException(
+        "Intercity contracts are domestic and cross no border — they have no customs clearing variant",
+      );
+    }
+    if (!intercity && dto.withCustoms === undefined) {
+      throw new BadRequestException(
+        `A ${direction.toLowerCase()} template must state whether customs clearing is included`,
+      );
+    }
+    const withCustoms = intercity ? null : Boolean(dto.withCustoms);
+
+    const label = this.comboLabel(cargoType.cargoTypeName, direction, withCustoms);
+    const existing = await this.repository.findByCargoCombo(
+      dto.cargoTypeId,
+      direction,
+      withCustoms,
+    );
+    if (existing) {
+      throw new ConflictException(
+        `${label} already exists — edit that template instead`,
+      );
+    }
+
+    const template = new ContractTemplate();
+    template.code = bulkTemplateCode(cargoType.code, direction, withCustoms);
+    template.name = dto.name ?? label;
+    template.description = dto.description ?? null;
+    template.documentTitle = withCustoms
+      ? `${cargoType.cargoTypeName} Transportation and Customs Clearance Services`
+      : `${cargoType.cargoTypeName} Transportation Services`;
+    template.whereasClauses = [];
+    template.articles = [];
+    template.isActive = true;
+    template.cargoTypeId = cargoType.id;
+    template.tradeDirection = direction;
+    template.withCustoms = withCustoms;
+    template.isSystem = false;
+    try {
+      return await this.repository.saveTemplate(template);
+    } catch (error) {
+      // Partial unique index backstop for concurrent creates of the same combo.
+      if ((error as { code?: string })?.code === "23505") {
+        throw new ConflictException(
+          `${label} already exists — edit that template instead`,
+        );
+      }
+      throw error;
+    }
+  }
+
+  /** Human label for one bulk combination, used for names and conflict errors. */
+  private comboLabel(
+    cargoTypeName: string,
+    direction: BulkTemplateDirection,
+    withCustoms: boolean | null,
+  ): string {
+    const dir = direction.charAt(0) + direction.slice(1).toLowerCase();
+    const customs =
+      withCustoms === null
+        ? ""
+        : withCustoms
+          ? ", with customs clearing"
+          : ", without customs clearing";
+    return `${cargoTypeName} Bulk Contract (${dir}${customs})`;
+  }
+
+  /** Bulk templates only — the five seeded container templates are permanent. */
+  async remove(code: string): Promise<void> {
+    const template = await this.getByCode(code);
+    if (template.isSystem) {
+      throw new BadRequestException(
+        "System container templates cannot be deleted",
+      );
+    }
+    await this.repository.softDelete(template.id);
+  }
+
+  /**
+   * The active template used when generating a contract document. Container
+   * contracts resolve through the fixed direction/customs codes; bulk contracts
+   * resolve through the staff-created template for the contract's cargo type
+   * (or its parent group), trade direction and customs option. A domestic
+   * contract resolves to the intercity template regardless of its customs flag.
+   * Null when nothing matches or the match is deactivated (the renderer then
+   * falls back to the built-in generic layout).
    */
   async findActiveForContract(
     tradeDirection?: string | null,
     freightType?: string | null,
     customsClearingEnabled?: boolean | null,
+    cargoTypeId?: string | null,
   ): Promise<ContractTemplate | null> {
+    const isBulk = (freightType ?? "").toUpperCase().includes("BULK");
+    if (isBulk) {
+      if (!cargoTypeId) return null;
+      const direction = bulkTemplateDirectionFor(tradeDirection);
+      return this.repository.findActiveBulkTemplate(
+        cargoTypeId,
+        direction,
+        direction === "INTERCITY" ? null : Boolean(customsClearingEnabled),
+      );
+    }
     const code = contractTemplateCodeFor(
       tradeDirection,
       freightType,
@@ -180,27 +308,57 @@ export class ContractTemplatesService {
         : this.sorted(template.articles),
     };
 
-    const view = this.buildMockView(template.code, dynamicTemplate);
+    const view = this.buildMockView(template, dynamicTemplate);
     return { html: this.renderer.render(view) };
   }
 
+  /**
+   * Registry key the mock preview renders against. Staff-created bulk
+   * templates aren't in the fixed code map — they preview against the bulk
+   * pack matching their own direction and customs option.
+   */
+  private previewKeyFor(template: ContractTemplate): string {
+    if (template.cargoTypeId) {
+      const direction = bulkTemplateDirectionFor(template.tradeDirection);
+      const dir =
+        direction === "IMPORT" ? "IMP" : direction === "EXPORT" ? "EXP" : "DOM";
+      const scope = template.withCustoms ? "FORWARDING" : "TRANSPORT_ONLY";
+      return `${dir}_BULK_USD_${scope}`;
+    }
+    return PREVIEW_TEMPLATE_KEYS[template.code as ContractTemplateCode];
+  }
+
+  /**
+   * Preview direction: bulk templates carry it on the row, the fixed container
+   * codes carry it as the code prefix.
+   */
+  private previewDirectionFor(template: ContractTemplate): BulkTemplateDirection {
+    if (template.cargoTypeId) {
+      return bulkTemplateDirectionFor(template.tradeDirection);
+    }
+    return bulkTemplateDirectionFor(template.code.split("_")[0]);
+  }
+
   private buildMockView(
-    code: ContractTemplateCode,
+    template: ContractTemplate,
     dynamicTemplate: ContractDynamicTemplateView,
   ): ContractViewModel {
-    const meta = getTemplateMeta(PREVIEW_TEMPLATE_KEYS[code]);
-    const isBulk = code.endsWith("_BULK");
+    const code = template.code;
+    const previewKey = this.previewKeyFor(template);
+    const meta = getTemplateMeta(previewKey);
+    const isBulk = Boolean(template.cargoTypeId) || code.includes("BULK");
+    const direction = this.previewDirectionFor(template);
     const now = new Date();
 
     // Representative rate schedule so the admin preview shows the live-rate
     // table shape. Real contracts populate this from freight.rates (LIVE).
-    const rateSchedule = this.mockRateSchedule(code, isBulk);
+    const rateSchedule = this.mockRateSchedule(direction, isBulk);
 
     return {
       bookingId: "00000000-0000-0000-0000-000000000000",
       reference: "EDR/CT/2026/0042",
       status: "CONTRACT_READY",
-      templateKey: PREVIEW_TEMPLATE_KEYS[code],
+      templateKey: previewKey,
       template: { ...meta, title: dynamicTemplate.name, templateFile: "edr-dynamic.hbs" },
       contractDate: now.toLocaleDateString("en-GB", {
         day: "numeric",
@@ -232,11 +390,7 @@ export class ContractTemplatesService {
       schedule: {
         originLabel: isBulk ? "Nagad Railway Station" : "SGTD Freight Station",
         destinationLabel: "Galaan Multipurpose Port (GMP)",
-        tradeDirection: code.startsWith("IMPORT")
-          ? "IMPORT"
-          : code.startsWith("EXPORT")
-            ? "EXPORT"
-            : "DOMESTIC",
+        tradeDirection: direction === "INTERCITY" ? "DOMESTIC" : direction,
         freightType: isBulk ? "BULK" : "CONTAINER",
         serviceType: "Rail transport and customs clearance",
         scheduledDate: "—",
@@ -275,16 +429,14 @@ export class ContractTemplatesService {
   }
 
   /** Static, representative rate schedule for the admin preview only. */
-  private mockRateSchedule(code: ContractTemplateCode, isBulk: boolean): RateSchedule {
-    const dir = code.startsWith("IMPORT")
-      ? "import"
-      : code.startsWith("EXPORT")
-        ? "export"
-        : "domestic";
+  private mockRateSchedule(
+    direction: BulkTemplateDirection,
+    isBulk: boolean,
+  ): RateSchedule {
     const lane =
-      dir === "export"
+      direction === "EXPORT"
         ? "Galaan Multipurpose Port → SGTD"
-        : dir === "domestic"
+        : direction === "INTERCITY"
           ? "Mojo Dry Port → Dire Dawa"
           : "Negad → Mojo Dry Port";
 
@@ -311,16 +463,6 @@ export class ContractTemplatesService {
     };
   }
 
-  private assertCode(code: string): ContractTemplateCode {
-    const upper = code?.toUpperCase() as ContractTemplateCode;
-    if (!CONTRACT_TEMPLATE_CODES.includes(upper)) {
-      throw new BadRequestException(
-        `Unknown contract template code "${code}". Valid codes: ${CONTRACT_TEMPLATE_CODES.join(", ")}`,
-      );
-    }
-    return upper;
-  }
-
   private sorted(articles: ContractTemplateArticle[]): ContractTemplateArticle[] {
     return [...(articles ?? [])].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
   }
diff --git a/apps/edr-freight-api/src/modules/contract-templates/dto/contract-template.dto.ts b/apps/edr-freight-api/src/modules/contract-templates/dto/contract-template.dto.ts
index 0ea69f262..9f7579dbd 100644
--- a/apps/edr-freight-api/src/modules/contract-templates/dto/contract-template.dto.ts
+++ b/apps/edr-freight-api/src/modules/contract-templates/dto/contract-template.dto.ts
@@ -3,15 +3,59 @@ import { Type } from "class-transformer";
 import {
   IsArray,
   IsBoolean,
+  IsIn,
   IsInt,
   IsOptional,
   IsString,
+  IsUUID,
   MaxLength,
   Min,
   MinLength,
   ValidateNested,
 } from "class-validator";
 
+import {
+  BULK_TEMPLATE_DIRECTIONS,
+  BulkTemplateDirection,
+} from "../entities/contract-template.entity";
+
+export class CreateContractTemplateDto {
+  @ApiProperty({
+    description:
+      "Bulk cargo type this template is written for (must have hasContractTemplate enabled)",
+    format: "uuid",
+  })
+  @IsUUID()
+  cargoTypeId!: string;
+
+  @ApiProperty({
+    description: "Trade direction this template is written for",
+    enum: BULK_TEMPLATE_DIRECTIONS,
+  })
+  @IsIn(BULK_TEMPLATE_DIRECTIONS as unknown as string[])
+  tradeDirection!: BulkTemplateDirection;
+
+  @ApiPropertyOptional({
+    description:
+      "Whether this is the with-customs-clearing variant. Required for IMPORT/EXPORT, rejected for INTERCITY (domestic movements cross no border)",
+  })
+  @IsOptional()
+  @IsBoolean()
+  withCustoms?: boolean;
+
+  @ApiPropertyOptional({ description: "Display name (derived from the cargo type when omitted)" })
+  @IsOptional()
+  @IsString()
+  @MinLength(3)
+  @MaxLength(200)
+  name?: string;
+
+  @ApiPropertyOptional({ description: "Short description shown on the template card" })
+  @IsOptional()
+  @IsString()
+  description?: string;
+}
+
 export class UpdateContractTemplateDto {
   @ApiPropertyOptional({ description: "Display name of the template" })
   @IsOptional()
diff --git a/apps/edr-freight-api/src/modules/contract-templates/entities/contract-template.entity.ts b/apps/edr-freight-api/src/modules/contract-templates/entities/contract-template.entity.ts
index c322c20a4..e070aa1e4 100644
--- a/apps/edr-freight-api/src/modules/contract-templates/entities/contract-template.entity.ts
+++ b/apps/edr-freight-api/src/modules/contract-templates/entities/contract-template.entity.ts
@@ -1,11 +1,18 @@
 import { BaseEntity } from "@edr/api-common";
-import { Column, Entity, Index } from "typeorm";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+
+import { CargoType } from "../../rule-engine/entities/cargo-type.entity";
 
 /**
- * The ten canonical contract document templates. Import and export split by
- * customs clearing (× freight type = 8); intercity does not, because it is a
- * purely domestic Ethiopian movement that crosses no border and therefore has
- * no customs leg at all (× freight type = 2).
+ * The five seeded container templates (import/export split by customs
+ * clearing; intercity is domestic, crosses no border, so it has a single
+ * template). These are system rows: always present, never deletable.
+ *
+ * Bulk templates are NOT seeded — staff create them per bulk cargo type
+ * (`cargoTypeId`), trade direction (`tradeDirection`) and customs option
+ * (`withCustoms`), one template per combination. Their codes are generated by
+ * `bulkTemplateCode` below. The retired direction-keyed bulk codes remain
+ * listed so old frozen document snapshots still label correctly.
  *
  * Contracts store DOMESTIC for intercity movements; the template layer labels
  * those INTERCITY to match the commercial vocabulary used on the printed
@@ -75,11 +82,45 @@ export function contractTemplateCodeFor(
   return `${direction}_${freight}_${customs}` as ContractTemplateCode;
 }
 
+/** The three directions a bulk template can be written for. */
+export const BULK_TEMPLATE_DIRECTIONS = ["IMPORT", "EXPORT", "INTERCITY"] as const;
+
+export type BulkTemplateDirection = (typeof BULK_TEMPLATE_DIRECTIONS)[number];
+
+/**
+ * Contracts store DOMESTIC for intercity movements; templates use INTERCITY.
+ * Anything that is not an explicit IMPORT/EXPORT is domestic, matching
+ * `contractTemplateCodeFor`.
+ */
+export function bulkTemplateDirectionFor(
+  tradeDirection?: string | null,
+): BulkTemplateDirection {
+  const value = (tradeDirection ?? "").toUpperCase();
+  return value === "IMPORT" || value === "EXPORT" ? value : "INTERCITY";
+}
+
+/**
+ * Generated code for a staff-created bulk template. Intercity gets no customs
+ * suffix — it crosses no border, so the variant does not exist.
+ */
+export function bulkTemplateCode(
+  cargoCode: string,
+  direction: BulkTemplateDirection,
+  withCustoms: boolean | null,
+): string {
+  const suffix =
+    direction === "INTERCITY" ? "" : withCustoms ? "_CUSTOMS" : "_NO_CUSTOMS";
+  return `BULK_${direction}_${cargoCode}${suffix}`.toUpperCase();
+}
+
 @Entity({ schema: "freight", name: "contract_templates" })
-@Index(["code"], { unique: true })
+// Uniqueness lives in partial DB indexes (live rows only): code, and
+// (cargo_type_id, trade_direction, coalesce(with_customs,false)) for
+// staff-created bulk templates.
+@Index(["code"])
 export class ContractTemplate extends BaseEntity {
-  @Column({ name: "code", type: "varchar", length: 40, unique: true })
-  code!: ContractTemplateCode;
+  @Column({ name: "code", type: "varchar", length: 80 })
+  code!: string;
 
   @Column({ name: "name", type: "varchar", length: 200 })
   name!: string;
@@ -100,4 +141,28 @@ export class ContractTemplate extends BaseEntity {
 
   @Column({ name: "is_active", type: "boolean", default: true })
   isActive!: boolean;
+
+  /** Bulk templates only: the cargo type this template is written for. */
+  @Column({ name: "cargo_type_id", type: "uuid", nullable: true })
+  cargoTypeId?: string | null;
+
+  @ManyToOne(() => CargoType, { nullable: true })
+  @JoinColumn({ name: "cargo_type_id" })
+  cargoType?: CargoType | null;
+
+  /** Bulk templates only: IMPORT, EXPORT or INTERCITY. */
+  @Column({ name: "trade_direction", type: "varchar", length: 20, nullable: true })
+  tradeDirection?: BulkTemplateDirection | null;
+
+  /**
+   * Bulk templates only: whether this is the with-customs-clearing variant.
+   * Always null for INTERCITY templates — domestic movements have no customs
+   * leg, so neither variant applies.
+   */
+  @Column({ name: "with_customs", type: "boolean", nullable: true })
+  withCustoms?: boolean | null;
+
+  /** The five seeded container templates — cannot be deleted. */
+  @Column({ name: "is_system", type: "boolean", default: false })
+  isSystem!: boolean;
 }
diff --git a/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.spec.ts b/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.spec.ts
index df55493de..5cee12d3b 100644
--- a/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.spec.ts
@@ -32,11 +32,17 @@ function makeService(overrides?: {
   workflowThrows?: boolean;
   /** Resolve the input doc set with no required fields → every doc counts approved. */
   docsApproved?: boolean;
+  /** Yard ids the caller is scoped to; `null` (default) = unrestricted. */
+  yardScope?: string[] | null;
 }) {
   const booking = overrides?.booking ?? generalImportBooking;
   const bookingsRepository = {
     findDocumentReviews: jest.fn().mockResolvedValue([]),
     update: jest.fn().mockResolvedValue(booking),
+    findByStatuses: jest.fn().mockResolvedValue([]),
+    findBookingsWithUnreviewedDocuments: jest
+      .fn()
+      .mockResolvedValue(new Set<string>()),
   };
   const bookingsService = {
     findById: jest.fn().mockResolvedValue(booking),
@@ -110,6 +116,9 @@ function makeService(overrides?: {
         .fn()
         .mockResolvedValue({ id: 'ta-1', name: 'Ahmed Bourhan' }),
     } as never, // transit agents
+    { findAll: jest.fn().mockResolvedValue([]) } as never, // contracts repository
+    { getScopedYardIds: jest.fn().mockResolvedValue(overrides?.yardScope ?? null) } as never, // yard scope
+    { record: jest.fn() } as never, // clearanceEvents
   );
 
   return {
@@ -123,6 +132,30 @@ function makeService(overrides?: {
 }
 
 describe('BookingClearanceService', () => {
+  describe('etQueue yard scope', () => {
+    const queueBookings = [
+      { ...generalImportBooking, id: 'b-mojo-out', originYardId: 'mojo', destinationYardId: 'dire' },
+      { ...generalImportBooking, id: 'b-mojo-in', originYardId: 'addis', destinationYardId: 'mojo' },
+      { ...generalImportBooking, id: 'b-elsewhere', originYardId: 'addis', destinationYardId: 'dire' },
+    ] as unknown as Booking[];
+
+    it('keeps only bookings whose origin or destination is in scope', async () => {
+      const { service, bookingsRepository, workflowService } = makeService({ yardScope: ['mojo'] });
+      bookingsRepository.findByStatuses.mockResolvedValue(queueBookings);
+      workflowService.listMilestonesForBooking.mockResolvedValue([{ status: 'PENDING' }]);
+      const rows = await service.etQueue({});
+      expect(rows.map((b) => b.id)).toEqual(['b-mojo-out', 'b-mojo-in']);
+    });
+
+    it('shows everything when the position has no yard mapping', async () => {
+      const { service, bookingsRepository, workflowService } = makeService({ yardScope: null });
+      bookingsRepository.findByStatuses.mockResolvedValue(queueBookings);
+      workflowService.listMilestonesForBooking.mockResolvedValue([{ status: 'PENDING' }]);
+      const rows = await service.etQueue({});
+      expect(rows).toHaveLength(3);
+    });
+  });
+
   describe('adviseDuty', () => {
     it('skips duty milestones when duty is not required', async () => {
       const { service, workflowService, bookingsRepository } = makeService();
@@ -291,7 +324,7 @@ describe('BookingClearanceService', () => {
       const { service, bookingsRepository } = makeService({ booking: generalExportBooking });
       const result = await service.uploadReleaseOrder(
         'b-export',
-        { fieldname: 'ro' } as Express.Multer.File,
+        [{ fieldname: 'ro' } as Express.Multer.File],
         dateStr,
       );
 
diff --git a/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.ts b/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.ts
index c9c15f8b0..d9fe1825f 100644
--- a/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/booking-clearance.service.ts
@@ -1,6 +1,8 @@
 import { BadRequestException, Injectable } from '@nestjs/common';
+import { In } from 'typeorm';
 import {
   ContractDocPhase,
+  isDeliveryOrderFileCode,
   isDraftDeclarationFileCode,
   type ClearanceFinalInvoiceSummary,
   type ClearanceOffloadState,
@@ -28,8 +30,17 @@ import { ClearanceMilestoneService } from './clearance-milestone.service';
 import { GlOperationsService } from './gl-operations.service';
 import { GlExchangeService } from './gl-exchange.service';
 import { TransitAgentsService } from '../transit-agents/transit-agents.service';
+import { YardScopeService } from '../rule-engine/services/yard-scope.service';
+import { ContractsRepository } from './contracts.repository';
 import { AdviseContractDutyDto } from './dto/phased-clearance.dto';
-import { buildWorkflowFiles, belongsOnDjClearanceQueue, belongsOnEtClearanceQueue, DJ_BOOKING_QUEUE_STATUSES, persistDeclarationUploads, persistDraftDeclarationUploads, persistTransitPermitUploads, PHASED_CUSTOMS_BOOKING_QUEUE_STATUSES } from './phased-clearance.util';
+import { buildWorkflowFiles, belongsOnDjClearanceQueue, belongsOnEtClearanceQueue, DJ_BOOKING_QUEUE_STATUSES, persistDeclarationUploads, persistDeliveryOrderUploads, persistDraftDeclarationUploads, persistReleaseOrderUploads, persistTransitPermitUploads, PHASED_CUSTOMS_BOOKING_QUEUE_STATUSES } from './phased-clearance.util';
+
+import {
+  buildClearanceDocHistory,
+  type ClearanceDocEvent,
+} from '../bookings/clearance-doc-history.util';
+import { ClearanceEventService } from '../bookings/clearance-event.service';
+import { clearanceDocumentsOpen } from '../bookings/clearance.util';
 
 const RO_VESSEL_MIN_DAYS_CODE = 'ro_vessel_min_days';
 
@@ -48,8 +59,13 @@ export interface BookingClearanceView {
     file: { id: string; name: string; url: string } | null;
     reviewStatus: 'PENDING' | 'APPROVED' | 'QUERIED' | null;
     note: string | null;
+    uploadedAt: string | null;
+    reviewedAt: string | null;
+    reviewedByName: string | null;
+    history: ClearanceDocEvent[];
   }>;
   allApproved: boolean;
+  documentsOpen: boolean;
   phase?: string | null;
   milestones?: Array<{
     id: string;
@@ -154,6 +170,9 @@ export class BookingClearanceService {
     private readonly notifier: BookingLifecycleNotifierService,
     private readonly glExchangeService: GlExchangeService,
     private readonly transitAgentsService: TransitAgentsService,
+    private readonly contractsRepository: ContractsRepository,
+    private readonly yardScope: YardScopeService,
+    private readonly clearanceEvents: ClearanceEventService,
   ) {}
 
   private async assertPhasedCustoms(booking: Booking): Promise<void> {
@@ -179,6 +198,18 @@ export class BookingClearanceService {
     const fileByCode = new Map(files.map((f) => [f.code, f]));
     const reviews = await this.bookingsRepository.findDocumentReviews(bookingId);
     const reviewByKey = new Map(reviews.map((r) => [`${r.settingCode}:${r.fileKey}`, r]));
+    const allVersions = await this.filesService.findAllVersionsByResource(
+      bookingId,
+      'bookings',
+    );
+    const queryNotes = await this.bookingsRepository.findReviewNotes(
+      bookingId,
+      'CHANGES_REQUESTED',
+    );
+    const reviewerNames = await this.bookingsRepository.resolveStaffNames([
+      ...reviews.map((r) => r.reviewedByStaffId),
+      ...queryNotes.map((n) => n.authorId),
+    ]);
 
     const documents: BookingClearanceView['documents'] = [];
 
@@ -202,6 +233,18 @@ export class BookingClearanceService {
           file: file ? { id: file.id, name: file.name, url: file.url } : null,
           reviewStatus: review?.status ?? null,
           note: review?.note ?? null,
+          uploadedAt: file?.createdAt ? file.createdAt.toISOString() : null,
+          reviewedAt: review?.reviewedAt ? review.reviewedAt.toISOString() : null,
+          reviewedByName: review?.reviewedByStaffId
+            ? (reviewerNames.get(review.reviewedByStaffId) ?? null)
+            : null,
+          history: buildClearanceDocHistory({
+            fileKey: field.fileKey,
+            allVersions,
+            queryNotes,
+            review,
+            names: reviewerNames,
+          }),
         });
       }
     };
@@ -221,6 +264,18 @@ export class BookingClearanceService {
         file: { id: f.id, name: f.name, url: f.url },
         reviewStatus: review?.status ?? null,
         note: review?.note ?? null,
+        uploadedAt: f.createdAt ? f.createdAt.toISOString() : null,
+        reviewedAt: review?.reviewedAt ? review.reviewedAt.toISOString() : null,
+        reviewedByName: review?.reviewedByStaffId
+          ? (reviewerNames.get(review.reviewedByStaffId) ?? null)
+          : null,
+        history: buildClearanceDocHistory({
+          fileKey: f.code,
+          allVersions,
+          queryNotes,
+          review,
+          names: reviewerNames,
+        }),
       });
     }
 
@@ -301,6 +356,7 @@ export class BookingClearanceService {
       outputCode,
       documents,
       allApproved,
+      documentsOpen: clearanceDocumentsOpen(booking),
       phase,
       milestones: milestones.map((m) => ({
         id: m.id,
@@ -473,6 +529,7 @@ export class BookingClearanceService {
   async requestTransitAssignee(
     bookingId: string,
     note: string | undefined,
+    userId?: string,
   ): Promise<Booking> {
     const booking = await this.loadBooking(bookingId);
 
@@ -480,6 +537,13 @@ export class BookingClearanceService {
       transitAssigneeRequestedAt: new Date(),
       transitAssigneeRequestNote: note?.trim() || null,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'TRANSIT_ASSIGNEE_REQUESTED',
+      label: 'Requested a transit assignee from GL Djibouti',
+      actorId: userId ?? null,
+      metadata: { note: note?.trim() || null },
+    });
 
     this.notifier.transitAssigneeRequested(booking, note?.trim() ?? null);
     return this.bookingsService.findById(bookingId);
@@ -491,7 +555,11 @@ export class BookingClearanceService {
    * Answering unblocks the declaration for Ethiopia. A later call overwrites
    * the name (reassignment) and re-notifies.
    */
-  async assignTransitAssignee(bookingId: string, transitAgentId: string): Promise<Booking> {
+  async assignTransitAssignee(
+    bookingId: string,
+    transitAgentId: string,
+    userId?: string,
+  ): Promise<Booking> {
     const booking = await this.loadBooking(bookingId);
     if (!booking.transitAssigneeRequestedAt) {
       throw new BadRequestException(
@@ -505,6 +573,13 @@ export class BookingClearanceService {
       transitAssigneeName: agent.name,
       transitAssigneeAssignedAt: new Date(),
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'TRANSIT_ASSIGNEE_ASSIGNED',
+      label: `Assigned transit officer "${agent.name}"`,
+      actorId: userId ?? null,
+      metadata: { transitAgentId, agentName: agent.name, previous },
+    });
 
     this.notifier.transitAssigneeAssigned(booking, agent.name, previous);
     return this.bookingsService.findById(bookingId);
@@ -557,6 +632,13 @@ export class BookingClearanceService {
           ? ContractDocPhase.GlEtPostClearance
           : ContractDocPhase.CustomerDuty,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DECLARATION_UPLOADED',
+      label: `Uploaded customs declaration (${files.length} file(s))`,
+      actorId: userId ?? null,
+      metadata: { fileNames: files.map((f) => f.originalname) },
+    });
 
     return this.bookingsService.findById(bookingId);
   }
@@ -610,6 +692,19 @@ export class BookingClearanceService {
       );
       this.notifier.dutyAdvised(booking, dto.amount, dto.currency ?? 'ETB');
     }
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DUTY_ADVISED',
+      label: dto.dutyRequired
+        ? `Advised duty/tax of ${dto.amount} ${dto.currency ?? 'ETB'}`
+        : 'Advised that no duty/tax applies',
+      actorId: userId ?? null,
+      metadata: {
+        dutyRequired: dto.dutyRequired,
+        amount: dto.amount ?? null,
+        currency: dto.currency ?? null,
+      },
+    });
 
     return this.bookingsService.findById(bookingId);
   }
@@ -657,6 +752,14 @@ export class BookingClearanceService {
       clearanceCurrentPhase: ContractDocPhase.GlEtOutput,
     } as never);
 
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DRAFT_DECLARATION_SENT',
+      label: `Sent draft customs declaration (estimated ${price} ${currency})`,
+      actorId: userId ?? null,
+      metadata: { price, currency, fileNames: files.map((f) => f.originalname) },
+    });
+
     const updated = await this.bookingsService.findById(bookingId);
     this.notifier.draftDeclarationReady(updated, price, currency);
     return updated;
@@ -666,7 +769,7 @@ export class BookingClearanceService {
    * The customer accepts the draft declaration — GL Ethiopia may now file the
    * real customs declaration.
    */
-  async acceptDraftDeclaration(bookingId: string): Promise<Booking> {
+  async acceptDraftDeclaration(bookingId: string, userId?: string): Promise<Booking> {
     const booking = await this.loadBooking(bookingId);
     if (booking.tradeDirection !== 'IMPORT') {
       throw new BadRequestException('Draft declaration applies only to import bookings.');
@@ -678,6 +781,13 @@ export class BookingClearanceService {
     }
 
     await this.workflowService.completeMilestoneForBooking(bookingId, 'DRAFT_DECLARATION_ACCEPTED');
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DRAFT_DECLARATION_ACCEPTED',
+      label: 'Customer accepted the draft customs declaration',
+      actorType: 'CUSTOMER',
+      actorId: userId ?? null,
+    });
     return this.bookingsService.findById(bookingId);
   }
 
@@ -727,12 +837,25 @@ export class BookingClearanceService {
       clearanceCurrentPhase: ContractDocPhase.GlEtOutput,
     } as never);
 
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DRAFT_DECLARATION_CHANGE_REQUESTED',
+      label: 'Customer requested a change to the draft declaration',
+      actorType: 'CUSTOMER',
+      actorId: userId ?? null,
+      metadata: { note: note.trim() },
+    });
+
     const updated = await this.bookingsService.findById(bookingId);
     this.notifier.draftDeclarationChangeRequested(updated, note.trim());
     return updated;
   }
 
-  async uploadDutySlip(bookingId: string, file: Express.Multer.File): Promise<Booking> {
+  async uploadDutySlip(
+    bookingId: string,
+    file: Express.Multer.File,
+    userId?: string,
+  ): Promise<Booking> {
     const booking = await this.loadBooking(bookingId);
     if (booking.tradeDirection !== 'IMPORT') {
       throw new BadRequestException('Duty slip upload applies only to import bookings.');
@@ -754,6 +877,15 @@ export class BookingClearanceService {
       clearanceCurrentPhase: ContractDocPhase.GlEtPostClearance,
     } as never);
 
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DUTY_SLIP_UPLOADED',
+      label: 'Customer uploaded the duty/tax payment slip',
+      actorType: 'CUSTOMER',
+      actorId: userId ?? null,
+      metadata: { fileName: file.originalname },
+    });
+
     this.notifier.dutySlipUploadedToStaff(booking, 'first');
     return this.bookingsService.findById(bookingId);
   }
@@ -786,11 +918,18 @@ export class BookingClearanceService {
     await this.bookingsRepository.update(bookingId, {
       clearanceCurrentPhase: ContractDocPhase.GlEtPostClearance,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'TRANSIT_PERMIT_UPLOADED',
+      label: `Uploaded transit permit (${files.length} file(s))`,
+      actorId: userId ?? null,
+      metadata: { fileNames: files.map((f) => f.originalname) },
+    });
 
     return this.bookingsService.findById(bookingId);
   }
 
-  async finalizePreClearance(bookingId: string): Promise<Booking> {
+  async finalizePreClearance(bookingId: string, userId?: string): Promise<Booking> {
     const booking = await this.loadBooking(bookingId);
     if (booking.tradeDirection !== 'IMPORT') {
       throw new BadRequestException('Pre-clearance finalize applies only to import bookings.');
@@ -810,10 +949,16 @@ export class BookingClearanceService {
       preClearanceFinalizedAt: new Date(),
       clearanceCurrentPhase: ContractDocPhase.GlDjCollection,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'PRE_CLEARANCE_FINALIZED',
+      label: 'Finalized pre-clearance — handed over to GL Djibouti collection',
+      actorId: userId ?? null,
+    });
 
     // GL Djibouti may have uploaded the DO early (un-gated) — count it now.
     const files = await this.filesService.findByResource(bookingId, 'bookings');
-    if (files.some((f) => f.code === 'delivery_order')) {
+    if (files.some((f) => isDeliveryOrderFileCode(f.code))) {
       await this.workflowService.completeMilestoneForBooking(bookingId, 'DO_COLLECTED');
       await this.workflowService.markReadyForOperation(bookingId);
     }
@@ -823,7 +968,7 @@ export class BookingClearanceService {
 
   async uploadDeliveryOrder(
     bookingId: string,
-    file: Express.Multer.File,
+    files: Express.Multer.File[],
     userId?: string,
     dates?: { vesselArrivalDate?: string; doCollectedDate?: string },
   ): Promise<Booking> {
@@ -832,24 +977,28 @@ export class BookingClearanceService {
       throw new BadRequestException('Delivery Order applies only to import bookings.');
     }
 
-    if (!file) throw new BadRequestException('No Delivery Order uploaded');
-
     const { vesselArrivalDate, doCollectedDate } = assertDoCollectionDates(dates);
 
     // DO upload is deliberately un-gated: GL Djibouti may attach it at any point,
     // any file type. The DO_COLLECTED milestone (and operation readiness) still
     // waits for GL Ethiopia to finalize pre-clearance so the workflow order holds.
-    await this.filesService.upsertByCode({
-      resourceId: bookingId,
-      resource: 'bookings',
-      code: 'delivery_order',
-      file,
-    });
+    await persistDeliveryOrderUploads(this.filesService, bookingId, 'bookings', files ?? []);
 
     await this.bookingsRepository.update(bookingId, {
       vesselArrivalDate,
       doCollectedDate,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'DELIVERY_ORDER_UPLOADED',
+      label: 'Uploaded Delivery Order',
+      actorId: userId ?? null,
+      metadata: {
+        vesselArrivalDate: vesselArrivalDate ?? null,
+        doCollectedDate: doCollectedDate ?? null,
+        fileNames: (files ?? []).map((f) => f.originalname),
+      },
+    });
 
     if (booking.preClearanceFinalizedAt) {
       await this.workflowService.completeMilestoneForBooking(bookingId, 'DO_COLLECTED', userId);
@@ -880,7 +1029,7 @@ export class BookingClearanceService {
 
   async uploadReleaseOrder(
     bookingId: string,
-    file: Express.Multer.File,
+    files: Express.Multer.File[],
     vesselDepartureDate: string,
     userId?: string,
   ): Promise<{ booking: Booking; hold: boolean; holdReason?: string }> {
@@ -894,7 +1043,6 @@ export class BookingClearanceService {
       'RELEASE_ORDER_SECURED',
     );
 
-    if (!file) throw new BadRequestException('No Release Order uploaded');
     if (!vesselDepartureDate?.trim()) {
       throw new BadRequestException('Vessel departure date is required');
     }
@@ -902,17 +1050,22 @@ export class BookingClearanceService {
     const minDays = await this.resolveRoMinDays();
     const leadDays = this.daysUntil(vesselDepartureDate);
 
-    await this.filesService.upsertByCode({
-      resourceId: bookingId,
-      resource: 'bookings',
-      code: 'release_order',
-      file,
-    });
+    await persistReleaseOrderUploads(this.filesService, bookingId, 'bookings', files ?? []);
 
     await this.bookingsRepository.update(bookingId, {
       vesselDepartureDate,
       roAmendmentRequestedAt: null,
     } as never);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'RELEASE_ORDER_UPLOADED',
+      label: `Uploaded Release Order (vessel departs ${vesselDepartureDate})`,
+      actorId: userId ?? null,
+      metadata: {
+        vesselDepartureDate,
+        fileNames: (files ?? []).map((f) => f.originalname),
+      },
+    });
 
     if (leadDays < minDays) {
       const reason = `Vessel departs in ${leadDays} day(s) — minimum lead time is ${minDays} day(s). Request a port amendment or upload a new RO with a later date.`;
@@ -972,6 +1125,13 @@ export class BookingClearanceService {
         userId,
       );
     }
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'RO_AMENDMENT_REQUESTED',
+      label: 'Requested a port amendment on the Release Order',
+      actorId: userId ?? null,
+      metadata: { note: reason },
+    });
 
     return this.bookingsService.findById(bookingId);
   }
@@ -987,10 +1147,16 @@ export class BookingClearanceService {
       'EXPORT_RELEASED',
     );
     await this.workflowService.onExportReleasedForBooking(bookingId, userId);
+    await this.clearanceEvents.record({
+      bookingId,
+      action: 'EXPORT_RELEASE_CONFIRMED',
+      label: 'Confirmed export release',
+      actorId: userId ?? null,
+    });
     return this.bookingsService.findById(bookingId);
   }
 
-  async etQueue(): Promise<Booking[]> {
+  async etQueue(user?: unknown): Promise<Booking[]> {
     const candidates = await this.bookingsRepository.findByStatuses([
       ...PHASED_CUSTOMS_BOOKING_QUEUE_STATUSES,
     ]);
@@ -998,9 +1164,82 @@ export class BookingClearanceService {
     for (const b of candidates) {
       if (!this.isPhasedCustomsBooking(b)) continue;
       const milestones = await this.workflowService.listMilestonesForBooking(b.id);
-      if (belongsOnEtClearanceQueue(milestones)) filtered.push(b);
+      if (!belongsOnEtClearanceQueue(milestones)) continue;
+      // Surfaced on the queue row: every required document is approved even
+      // though the booking status stays DOCUMENTS_UNDER_REVIEW until finalize.
+      (b as Booking & { allDocsApproved?: boolean }).allDocsApproved =
+        milestones.some(
+          (m) =>
+            m.milestoneCode === 'DOCUMENTS_APPROVED' &&
+            (m.status === 'COMPLETED' || m.status === 'SKIPPED'),
+        );
+      filtered.push(b);
     }
-    return filtered;
+
+    // A document added after clearance was finalized lands as PENDING without
+    // moving the booking's status — the row would otherwise still read
+    // "Clearance ready" while GL has something waiting. Ad-hoc documents are
+    // tracked by no milestone, so this reads the review rows directly.
+    const pending = await this.bookingsRepository.findBookingsWithUnreviewedDocuments(
+      filtered.map((b) => b.id),
+    );
+    for (const b of filtered) {
+      (b as Booking & { hasDocumentsAwaitingReview?: boolean })
+        .hasDocumentsAwaitingReview = pending.has(b.id);
+    }
+
+    const rows = await this.attachContractSummary(filtered);
+    return this.narrowToYardScope(rows, user);
+  }
+
+  /**
+   * Keep only bookings whose ORIGIN or DESTINATION yard is one of the caller's
+   * assigned yards (`freight.yard_positions` via the active position). Yards in
+   * the middle of a route do not count. An unmapped position, super admin or
+   * `yards:view_all` holder sees everything (scope resolves to `null`).
+   * Runs after {@link attachContractSummary} so route-fallback yards count too.
+   */
+  private async narrowToYardScope(bookings: Booking[], user: unknown): Promise<Booking[]> {
+    const scope = await this.yardScope.getScopedYardIds(user as never);
+    if (scope === null) return bookings;
+    const inScope = (id: string | null | undefined) => !!id && scope.includes(id);
+    return bookings.filter(
+      (b) =>
+        inScope(b.originYardId ?? b.originYard?.id) ||
+        inScope(b.destinationYardId ?? b.destinationYard?.id),
+    );
+  }
+
+  /**
+   * Queue rows show the parent contract's reference and lane. Booking has no
+   * contract relation, and a bare initiated instance may not carry yards yet —
+   * so batch-load the contracts (with routes) and fill in what's missing:
+   * `contractReference` always, origin/destination yards only when the booking
+   * lacks them (its own route wins).
+   */
+  private async attachContractSummary(bookings: Booking[]): Promise<Booking[]> {
+    const ids = [...new Set(bookings.map((b) => b.contractId).filter(Boolean))] as string[];
+    if (!ids.length) return bookings;
+    const contracts = await this.contractsRepository.findAll({
+      where: { id: In(ids) },
+      relations: { routes: { originYard: true, destinationYard: true } },
+    });
+    const byId = new Map(contracts.map((c) => [c.id, c]));
+    for (const b of bookings) {
+      const contract = b.contractId ? byId.get(b.contractId) : undefined;
+      if (!contract) continue;
+      const row = b as Booking & { contractReference?: string | null };
+      row.contractReference = contract.reference ?? null;
+      if (b.originYard && b.destinationYard) continue;
+      const routes = contract.routes ?? [];
+      const route =
+        routes.find((r) => r.id === b.contractRouteId) ??
+        (routes.length === 1 ? routes[0] : undefined);
+      if (!route) continue;
+      b.originYard = b.originYard ?? route.originYard;
+      b.destinationYard = b.destinationYard ?? route.destinationYard;
+    }
+    return bookings;
   }
 
   async djQueue(): Promise<Booking[]> {
@@ -1020,6 +1259,6 @@ export class BookingClearanceService {
         filtered.push(b);
       }
     }
-    return filtered;
+    return this.attachContractSummary(filtered);
   }
 }
diff --git a/apps/edr-freight-api/src/modules/contracts/booking-request.repository.ts b/apps/edr-freight-api/src/modules/contracts/booking-request.repository.ts
index d0705bfb1..d743e3f0d 100644
--- a/apps/edr-freight-api/src/modules/contracts/booking-request.repository.ts
+++ b/apps/edr-freight-api/src/modules/contracts/booking-request.repository.ts
@@ -30,7 +30,8 @@ export class BookingRequestRepository extends BaseRepository<BookingRequest> {
   async findQueue(): Promise<BookingRequest[]> {
     return this.repository.find({
       order: { createdAt: 'DESC' },
-      relations: { contract: { company: true } },
+      // `routes` rides along so the queue can be narrowed to the caller's yards.
+      relations: { contract: { company: true, routes: true } },
     });
   }
 
diff --git a/apps/edr-freight-api/src/modules/contracts/booking-request.service.ts b/apps/edr-freight-api/src/modules/contracts/booking-request.service.ts
index 1ca7cd84f..a2900174a 100644
--- a/apps/edr-freight-api/src/modules/contracts/booking-request.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/booking-request.service.ts
@@ -7,6 +7,7 @@ import {
 } from '@nestjs/common';
 import type { Freight } from '@edr/types';
 
+import { YardScopeService } from '../rule-engine/services/yard-scope.service';
 import { BookingRequestRepository } from './booking-request.repository';
 import { ContractsService } from './contracts.service';
 import { ContractBookingService } from './contract-booking.service';
@@ -28,6 +29,7 @@ export class BookingRequestService {
     private readonly contractsService: ContractsService,
     private readonly contractBookingService: ContractBookingService,
     private readonly notifier: ContractNotifierService,
+    private readonly yardScope: YardScopeService,
   ) {}
 
   /**
@@ -168,8 +170,25 @@ export class BookingRequestService {
     return request;
   }
 
-  queue(): Promise<BookingRequest[]> {
-    return this.repo.findQueue();
+  /**
+   * GL queue narrowed to the caller's yards: a request stays when its route's
+   * ORIGIN or DESTINATION yard is one the caller's active position is mapped to
+   * (unmapped position / super admin → everything). A request with no
+   * resolvable route (no `contractRouteId` on a multi-route contract) has no
+   * yards to judge by and is kept visible.
+   */
+  async queue(user?: unknown): Promise<BookingRequest[]> {
+    const rows = await this.repo.findQueue();
+    const scope = await this.yardScope.getScopedYardIds(user as never);
+    if (scope === null) return rows;
+    return rows.filter((r) => {
+      const routes = r.contract?.routes ?? [];
+      const route =
+        routes.find((x) => x.id === r.contractRouteId) ??
+        (routes.length === 1 ? routes[0] : undefined);
+      if (!route) return true;
+      return scope.includes(route.originYardId) || scope.includes(route.destinationYardId);
+    });
   }
 
   private async findPending(requestId: string): Promise<BookingRequest> {
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-booking.completion.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-booking.completion.spec.ts
index c222ffc16..bdb8d74cd 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-booking.completion.spec.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-booking.completion.spec.ts
@@ -30,6 +30,7 @@ describe('ContractBookingService — quantity-cap completion', () => {
       {} as never, // trainSchedulingService
       {} as never, // bookingBatchService
       {} as never, // bookingTransitionService
+      {} as never, // consolidationApprovalService
     );
     return { service, contractsRepository };
   }
@@ -156,6 +157,7 @@ describe('ContractBookingService — quantity-cap completion', () => {
         {} as never,
         {} as never,
         {} as never,
+        {} as never, // consolidationApprovalService
       );
       return { service, contractsRepository };
     }
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-booking.consolidation.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-booking.consolidation.spec.ts
index 84465145d..fb68b3f5c 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-booking.consolidation.spec.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-booking.consolidation.spec.ts
@@ -64,6 +64,7 @@ describe('ContractBookingService — drawdown consolidation gate', () => {
       {} as never, // trainSchedulingService
       {} as never, // bookingBatchService
       {} as never, // bookingTransitionService
+      {} as never, // consolidationApprovalService
     );
     return {
       service,
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-booking.initiate-gate.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-booking.initiate-gate.spec.ts
index 6b5f54c91..6155eb583 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-booking.initiate-gate.spec.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-booking.initiate-gate.spec.ts
@@ -26,6 +26,7 @@ describe('ContractBookingService — customs booking gate', () => {
       {} as never, // trainSchedulingService
       {} as never, // bookingBatchService
       {} as never, // bookingTransitionService
+      {} as never, // consolidationApprovalService
     );
   }
 
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-booking.manual-consolidation.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-booking.manual-consolidation.spec.ts
new file mode 100644
index 000000000..49e77627f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/contracts/contract-booking.manual-consolidation.spec.ts
@@ -0,0 +1,216 @@
+import { ContractBookingService } from './contract-booking.service';
+import { Booking } from '../bookings/entities/booking.entity';
+
+/**
+ * Manual (GL-driven) odd-20ft consolidation. On a customs contract GL completes
+ * the booking, so GL also picks who shares its wagon: two bookings each carrying
+ * an odd 20ft count are completed together onto one wagon.
+ *
+ * The two invariants that matter are that the pair is all-or-nothing (a failure
+ * on either half must leave NEITHER booking completed and no link written) and
+ * that the two bookings stay financially separate — one completion each, so one
+ * price and one invoice each.
+ */
+describe('ContractBookingService — manual odd-20ft consolidation', () => {
+  function makeService(overrides: {
+    bookingsRepository?: Partial<Record<string, jest.Mock>>;
+    dataSource?: unknown;
+  }) {
+    const bookingsRepository = {
+      findByIdWithFiles: jest.fn(),
+      findManualConsolidationCandidates: jest.fn().mockResolvedValue([]),
+      linkConsolidationPartners: jest.fn().mockResolvedValue(undefined),
+      ...overrides.bookingsRepository,
+    };
+
+    // A transaction that simply runs the callback — enough to assert the
+    // all-or-nothing contract: whatever throws inside propagates out, and the
+    // caller observes no link written.
+    const dataSource = overrides.dataSource ?? {
+      transaction: jest.fn(async (cb: (m: unknown) => Promise<unknown>) => cb({})),
+    };
+
+    const service = new ContractBookingService(
+      { findByIdWithRelations: jest.fn() } as never,
+      bookingsRepository as never,
+      {} as never, // bookingPricingService
+      {} as never, // consolidationService
+      {} as never, // containerTypesService
+      {} as never, // ruleEngineService
+      {} as never, // milestoneService
+      {} as never, // invoiceService
+      {} as never, // bookingNotifier
+      dataSource as never,
+      {} as never, // trainSchedulingService
+      {} as never, // bookingBatchService
+      {} as never, // bookingTransitionService
+      // The pairing is parked for approval rather than going straight to
+      // Operations; the gate itself is covered by its own spec.
+      { requestApproval: jest.fn().mockResolvedValue({ id: 'ap-1' }) } as never,
+    );
+    return { service, bookingsRepository, dataSource };
+  }
+
+  const partnerBooking = {
+    id: 'b-2',
+    reference: 'BK-2',
+    contractId: 'c-2',
+    consolidationPartnerId: null,
+  } as unknown as Booking;
+
+  const pairDto = {
+    partnerBookingId: 'b-2',
+    booking: { scheduledDate: '2026-09-01' },
+    partner: { scheduledDate: '2026-09-01' },
+  };
+
+  it('completes both halves and links them', async () => {
+    const { service, bookingsRepository } = makeService({
+      bookingsRepository: {
+        findByIdWithFiles: jest
+          .fn()
+          // partner lookup before the transaction
+          .mockResolvedValueOnce(partnerBooking)
+          // the two reloads after it
+          .mockResolvedValueOnce({ id: 'b-1', reference: 'BK-1' } as Booking)
+          .mockResolvedValueOnce({ id: 'b-2', reference: 'BK-2' } as Booking),
+      },
+    });
+
+    // Each half runs the ordinary completion machine — one call per booking, so
+    // each is priced and invoiced on its own.
+    const complete = jest
+      .spyOn(service, 'completeUnderContract')
+      .mockImplementation(
+        async (_contractId, bookingId) =>
+          ({
+            booking: { id: bookingId } as Booking,
+            warnings: [],
+          }) as never,
+      );
+
+    const result = await service.completeConsolidatedPair(
+      'c-1',
+      'b-1',
+      pairDto as never,
+    );
+
+    expect(complete).toHaveBeenCalledTimes(2);
+    // The partner is completed against ITS OWN contract, not this one.
+    expect(complete.mock.calls[0][0]).toBe('c-1');
+    expect(complete.mock.calls[1][0]).toBe('c-2');
+    // Neither half may re-enter the automatic matcher — GL links them here.
+    expect(complete.mock.calls[0][2]).toMatchObject({
+      skipAutoConsolidation: true,
+    });
+    expect(complete.mock.calls[1][2]).toMatchObject({
+      skipAutoConsolidation: true,
+    });
+    expect(bookingsRepository.linkConsolidationPartners).toHaveBeenCalledWith(
+      'b-1',
+      'b-2',
+    );
+    expect(result.booking.id).toBe('b-1');
+    expect(result.partner.id).toBe('b-2');
+  });
+
+  it('links nothing when the partner half fails (all-or-nothing)', async () => {
+    const { service, bookingsRepository } = makeService({
+      bookingsRepository: {
+        findByIdWithFiles: jest.fn().mockResolvedValue(partnerBooking),
+      },
+    });
+
+    jest
+      .spyOn(service, 'completeUnderContract')
+      .mockImplementationOnce(
+        async () => ({ booking: { id: 'b-1' } as Booking, warnings: [] }) as never,
+      )
+      .mockImplementationOnce(async () => {
+        throw new Error('no train space for the partner');
+      });
+
+    await expect(
+      service.completeConsolidatedPair('c-1', 'b-1', pairDto as never),
+    ).rejects.toThrow('no train space for the partner');
+
+    // The link is the last write in the transaction — it must never happen when
+    // a half failed, so the rollback leaves no dangling pairing.
+    expect(bookingsRepository.linkConsolidationPartners).not.toHaveBeenCalled();
+  });
+
+  it('refuses a partner that already shares a wagon', async () => {
+    const { service } = makeService({
+      bookingsRepository: {
+        findByIdWithFiles: jest.fn().mockResolvedValue({
+          ...partnerBooking,
+          consolidationPartnerId: 'b-9',
+        }),
+      },
+    });
+
+    await expect(
+      service.completeConsolidatedPair('c-1', 'b-1', pairDto as never),
+    ).rejects.toThrow(/already shares a wagon/i);
+  });
+
+  it('refuses to consolidate a booking with itself', async () => {
+    const { service } = makeService({});
+
+    await expect(
+      service.completeConsolidatedPair('c-1', 'b-1', {
+        ...pairDto,
+        partnerBookingId: 'b-1',
+      } as never),
+    ).rejects.toThrow(/cannot be consolidated with itself/i);
+  });
+
+  it('offers only bookings whose own 20ft count is odd', async () => {
+    // Two odd counts always sum to even, so an odd partner is exactly what fills
+    // the wagon; an even one would leave the pair partial again.
+    const rows = [
+      {
+        id: 'odd',
+        reference: 'BK-ODD',
+        bookingContainers: [
+          { quantity: 3, containerType: { sizeFt: 20 } },
+        ],
+      },
+      {
+        id: 'even',
+        reference: 'BK-EVEN',
+        bookingContainers: [
+          { quantity: 4, containerType: { sizeFt: 20 } },
+        ],
+      },
+      // A bare instance has no cargo yet — GL enters it on the split form, so it
+      // stays a candidate.
+      { id: 'bare', reference: 'BK-BARE', bookingContainers: [] },
+    ];
+
+    const { service } = makeService({
+      bookingsRepository: {
+        findByIdWithFiles: jest
+          .fn()
+          .mockResolvedValue({ id: 'b-1', contractId: 'c-1' } as Booking),
+        findManualConsolidationCandidates: jest.fn(async (booking: Booking) =>
+          // Mirror the repository's in-memory odd filter.
+          rows.filter((row) => {
+            void booking;
+            const lines = row.bookingContainers ?? [];
+            if (lines.length === 0) return true;
+            const ft20 = lines
+              .filter((l) => Number(l.containerType?.sizeFt) === 20)
+              .reduce((sum, l) => sum + Number(l.quantity || 0), 0);
+            return ft20 % 2 === 1;
+          }),
+        ),
+      },
+    });
+
+    const candidates = await service.listConsolidationCandidates('c-1', 'b-1');
+    expect(candidates.map((c) => c.reference)).toEqual(['BK-ODD', 'BK-BARE']);
+    expect(candidates[0].ft20Quantity).toBe(3);
+    expect(candidates[1].hasCargo).toBe(false);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-booking.resubmit-cargo.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-booking.resubmit-cargo.spec.ts
index d5d15d73d..0a892b108 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-booking.resubmit-cargo.spec.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-booking.resubmit-cargo.spec.ts
@@ -59,6 +59,7 @@ describe('ContractBookingService — changes-requested resubmit restating cargo'
       trainSchedulingService as never,
       {} as never, // bookingBatchService
       {} as never, // bookingTransitionService
+      {} as never, // consolidationApprovalService
     );
     return { service, bookingsRepository, invoiceService };
   }
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-booking.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-booking.service.ts
index 59afdb585..e093bd9bf 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-booking.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-booking.service.ts
@@ -20,11 +20,12 @@ import { BookingPricingService } from '../bookings/booking-pricing.service';
 import { BookingTransitionService } from '../bookings/booking-transition.service';
 import { BookingLifecycleNotifierService } from '../bookings/booking-lifecycle-notifier.service';
 import { ConsolidationService } from '../bookings/consolidation.service';
+import { ConsolidationApprovalService } from '../bookings/consolidation-approval.service';
 import { PriceLineItemDto } from '../bookings/dto/generate-price-response.dto';
 import { BookingInvoiceService } from '../bookings/booking-invoice.service';
 import { validate20ftWeightPairing } from '../bookings/container-pairing.util';
 import { TrainSchedulingGlobalRules } from '../train-scheduling/entities/train-scheduling-global-rules.entity';
-import { TrainSchedulingService } from '../train-scheduling/train-scheduling.service';
+import { TrainSchedulingService } from '../train-scheduling/services/train-scheduling.service';
 import { BookingBatchService } from '../train-scheduling/booking-batch.service';
 import { eatDay } from '../train-scheduling/batch-window.util';
 import { wagonsPerUnitForSize } from '../rule-engine/container-type.util';
@@ -44,6 +45,7 @@ import {
 import { ClearanceMilestoneService } from './clearance-milestone.service';
 import { isEffectivelyExpired } from './utils/contract-expiry.util';
 import {
+  CompleteConsolidatedPairDto,
   CreateBookingContainerLineDto,
   CreateBookingUnderContractDto,
 } from './dto/create-booking-under-contract.dto';
@@ -62,6 +64,25 @@ export interface CreateBookingUnderContractResult {
   warnings: string[];
 }
 
+/**
+ * A booking GL may pick as the shared-wagon partner of an odd-20ft customs
+ * booking. `hasCargo` is false for a bare instance whose containers GL still has
+ * to enter on the split completion form.
+ */
+export interface ConsolidationCandidate {
+  id: string;
+  reference: string;
+  contractId: string | null;
+  companyName: string | null;
+  status: string;
+  tradeDirection: string | null;
+  originYardId: string | null;
+  destinationYardId: string | null;
+  scheduledDate: string | null;
+  ft20Quantity: number;
+  hasCargo: boolean;
+}
+
 /**
  * Outstanding split remainder of a contract: what was booked in the first split
  * booking's pre-split snapshot MINUS everything currently booked. Container
@@ -110,6 +131,8 @@ export class ContractBookingService {
     private readonly bookingBatchService: BookingBatchService,
     @Inject(forwardRef(() => BookingTransitionService))
     private readonly bookingTransitionService: BookingTransitionService,
+    @Inject(forwardRef(() => ConsolidationApprovalService))
+    private readonly consolidationApprovalService: ConsolidationApprovalService,
   ) {}
 
   async createUnderContract(
@@ -157,13 +180,9 @@ export class ContractBookingService {
       actorPermissions != null &&
       hasFreightPermission(actorPermissions, FREIGHT_PERMS.contracts.createBooking);
 
+    await this.assertNotExpired(contract);
     const createdByRole = await this.assertGate(contract, isGlActor);
 
-    // Validity window must still be open.
-    if (contract.contractValidUntil && contract.contractValidUntil.getTime() < Date.now()) {
-      throw new BadRequestException('Contract validity has expired — no new bookings.');
-    }
-
     // ONE_TIME: a single shipment at a time. The slot frees only if the prior
     // booking reached a terminal state (e.g. payment expired without shipping),
     // letting the customer re-book within contract validity (doc §10.4).
@@ -441,12 +460,9 @@ export class ContractBookingService {
     // The customer initiates his own shipment instance on ONE_TIME contracts
     // (customs or self-clearance); GL may also initiate on a customs contract.
     // GENERAL customs instances come from a shipment request, not from here.
+    await this.assertNotExpired(contract);
     const createdByRole = await this.assertGate(contract, isGlActor, true);
 
-    if (contract.contractValidUntil && contract.contractValidUntil.getTime() < Date.now()) {
-      throw new BadRequestException('Contract validity has expired — no new bookings.');
-    }
-
     // ONE_TIME carries a single shipment at a time; a bare instance occupies the
     // slot from the moment it is initiated (it is not a terminal status). The
     // split chain is the one exception — a paid partial frees the slot and
@@ -545,9 +561,7 @@ export class ContractBookingService {
         'Shipment-request initiation applies only to general customs contracts.',
       );
     }
-    if (contract.contractValidUntil && contract.contractValidUntil.getTime() < Date.now()) {
-      throw new BadRequestException('Contract validity has expired — no new bookings.');
-    }
+    await this.assertNotExpired(contract);
 
     const route = await this.resolveRoute(contract, opts.contractRouteId);
 
@@ -607,6 +621,146 @@ export class ContractBookingService {
     return created;
   }
 
+  /**
+   * Candidate partners a GL operator may link to an odd-20ft customs booking.
+   * Manual counterpart to the automatic pairing in {@link consolidateDrawdown} —
+   * a customs instance is completed by GL, so GL also chooses who shares its
+   * wagon rather than waiting for the auto-matcher to find an exact complement.
+   */
+  async listConsolidationCandidates(
+    contractId: string,
+    bookingId: string,
+  ): Promise<ConsolidationCandidate[]> {
+    const booking = await this.bookingsRepository.findByIdWithFiles(bookingId);
+    if (!booking || booking.contractId !== contractId) {
+      throw new NotFoundException(`Booking ${bookingId} not found on this contract`);
+    }
+
+    const rows = await this.bookingsRepository.findManualConsolidationCandidates(
+      booking,
+    );
+    return rows.map((row) => {
+      const lines = row.bookingContainers ?? [];
+      return {
+        id: row.id,
+        reference: row.reference,
+        contractId: row.contractId ?? null,
+        companyName: row.company?.name ?? null,
+        status: row.status,
+        tradeDirection: row.tradeDirection ?? null,
+        originYardId: row.originYardId ?? null,
+        destinationYardId: row.destinationYardId ?? null,
+        scheduledDate: row.scheduledDate ? row.scheduledDate.toISOString() : null,
+        ft20Quantity: lines
+          .filter((line) => Number(line.containerType?.sizeFt) === 20)
+          .reduce((sum, line) => sum + Number(line.quantity || 0), 0),
+        hasCargo: lines.length > 0,
+      };
+    });
+  }
+
+  /**
+   * Complete an odd-20ft customs booking together with the partner booking GL
+   * picked for its shared wagon. Both halves run the ordinary
+   * {@link completeUnderContract} machine — same gates, same pricing, same
+   * per-booking invoice, so each customer still pays only its own shipment — and
+   * are linked as consolidation partners at the end.
+   *
+   * All-or-nothing: the two completions plus the pairing run inside one
+   * transaction, so a failure on either half leaves neither booking completed
+   * and no half-linked wagon behind. `runInTransaction` is used rather than a
+   * manual QueryRunner so the nested services join the same transactional
+   * context through the shared DataSource.
+   */
+  async completeConsolidatedPair(
+    contractId: string,
+    bookingId: string,
+    dto: CompleteConsolidatedPairDto,
+    actorPermissions?: unknown,
+    /** IAM id of the GL user creating the pairing — recorded on the approval. */
+    actorUserId?: string | null,
+  ): Promise<{
+    booking: Booking;
+    partner: Booking;
+    warnings: string[];
+  }> {
+    if (dto.partnerBookingId === bookingId) {
+      throw new BadRequestException(
+        'A booking cannot be consolidated with itself.',
+      );
+    }
+
+    const partner = await this.bookingsRepository.findByIdWithFiles(
+      dto.partnerBookingId,
+    );
+    if (!partner) {
+      throw new NotFoundException(
+        `Partner booking ${dto.partnerBookingId} not found`,
+      );
+    }
+    if (partner.consolidationPartnerId) {
+      throw new ConflictException(
+        `Booking ${partner.reference} already shares a wagon with another booking.`,
+      );
+    }
+    if (!partner.contractId) {
+      throw new BadRequestException(
+        `Booking ${partner.reference} is not a contract booking and cannot be completed here.`,
+      );
+    }
+
+    const warnings: string[] = [];
+
+    const { ownId, partnerId } = await this.dataSource.transaction(async () => {
+      const own = await this.completeUnderContract(
+        contractId,
+        bookingId,
+        { ...dto.booking, skipAutoConsolidation: true },
+        // Both halves are completed by the same GL actor that reached this
+        // endpoint — the customs gate in completeUnderContract re-checks it.
+        actorPermissions,
+      );
+      warnings.push(...own.warnings);
+
+      const other = await this.completeUnderContract(
+        partner.contractId as string,
+        partner.id,
+        { ...dto.partner, skipAutoConsolidation: true },
+        actorPermissions,
+      );
+      warnings.push(...other.warnings);
+
+      // Link the two halves. Written directly (not via pairConsolidation) because
+      // both bookings have just been completed into their live status here —
+      // pairConsolidation exists to RESUME bookings parked in
+      // PENDING_CONSOLIDATION and would overwrite that status.
+      await this.bookingsRepository.linkConsolidationPartners(
+        own.booking.id,
+        other.booking.id,
+      );
+      return { ownId: own.booking.id, partnerId: other.booking.id };
+    });
+
+    // Both halves have just been completed into the operations queue by the
+    // ordinary completion machine. A shared wagon does not go there unreviewed:
+    // pull the pair back into the approval gate, which releases them to
+    // Operations only once a person signs off on the pairing.
+    await this.consolidationApprovalService.requestApproval(
+      ownId,
+      partnerId,
+      actorUserId ?? null,
+    );
+
+    // Sequential reads: one connection per transaction context.
+    const finalBooking = await this.bookingsRepository.findByIdWithFiles(ownId);
+    const finalPartner = await this.bookingsRepository.findByIdWithFiles(partnerId);
+    return {
+      booking: finalBooking!,
+      partner: finalPartner ?? partner,
+      warnings,
+    };
+  }
+
   /**
    * Complete a bare initiated booking after its per-booking clearance is
    * finalized (CLEARANCE_READY) or operations returned it for changes
@@ -681,9 +835,11 @@ export class ContractBookingService {
     if (!dto.scheduledDate) {
       throw new BadRequestException('A binding shipment day is required');
     }
-    if (contract.contractValidUntil && contract.contractValidUntil.getTime() < Date.now()) {
-      throw new BadRequestException('Contract validity has expired — no new bookings.');
-    }
+    // No expiry gate here on purpose: this booking was already initiated
+    // before the contract lapsed (createUnderContract/initiateUnderContract
+    // already checked expiry at start). Finishing an in-flight booking must
+    // proceed even if the contract expires meanwhile — only starting a NEW
+    // booking is blocked (see assertNotExpired).
 
     // Completion is booking time: the route's booking window must be open —
     // the same config-driven gate a direct one-time booking passes at create.
@@ -833,10 +989,18 @@ export class ContractBookingService {
       // exactly like a drawdown created with cargo does. The shipment day is
       // stored first so the pairing event can resume straight into the
       // operations queue.
+      // Customs (Path B) instances are exempt from the AUTO-matcher: GL links
+      // their shared wagon by hand through completeConsolidatedPair, so nothing
+      // may claim a partner for them behind GL's back. A customs half completed
+      // as part of a manual pair carries `skipAutoConsolidation`; one completed
+      // alone still falls through to the automatic gate below, so an odd 20ft
+      // booking can never proceed on a partial wagon. Non-customs drawdowns are
+      // unaffected.
       const withContainers = await this.bookingsRepository.findByIdWithFiles(booking.id);
       if (
         withContainers &&
         freightType === 'CONTAINER' &&
+        !dto.skipAutoConsolidation &&
         (await this.consolidationService.needsConsolidationFromBooking(withContainers))
       ) {
         await this.bookingsRepository.update(booking.id, {
@@ -1019,6 +1183,22 @@ export class ContractBookingService {
    * Returns the role to stamp on the booking, or throws if the caller is not
    * allowed to create one for this contract's execution path.
    */
+  /**
+   * Blocks starting a NEW booking (create/initiate) once the contract has
+   * lapsed, and lazily flips the stored status to EXPIRED so it doesn't wait
+   * for the nightly sweep. Only for the "start something new" entry points —
+   * a booking already underway (completeUnderContract) must be allowed to
+   * finish even if the contract expires mid-flight.
+   */
+  private async assertNotExpired(contract: Contract): Promise<void> {
+    if (!isEffectivelyExpired(contract)) return;
+    if (contract.status !== 'EXPIRED') {
+      const flipped = await this.contractsRepository.expireIfLapsed(contract.id);
+      if (flipped) contract.status = 'EXPIRED';
+    }
+    throw new BadRequestException('Contract validity has expired — no new bookings.');
+  }
+
   private async assertGate(
     contract: Contract,
     isGlActor: boolean,
@@ -1974,6 +2154,11 @@ export class ContractBookingService {
       isReefer: this.resolveShipmentHandlingFlag(contract, dto, 'reeferQuantity'),
       equipmentReturn: this.resolveShipmentEquipmentReturn(contract, dto),
       isGovernment: contract.isGovernment,
+      // The clearance fee is gated on this flag in BookingPricingService, and
+      // createUnderContract copies it off the contract. Omitting it here priced
+      // the preview WITHOUT the customs line the created booking is then billed
+      // — the customer confirmed one total and got invoiced a larger one.
+      customsClearingEnabled: contract.customsClearingEnabled,
       shippingLineId: null,
       contractRouteId: route?.id ?? null,
       originYardId: route?.originYardId ?? null,
@@ -2273,6 +2458,22 @@ export class ContractBookingService {
   private async assert20ftPairableAtCreate(
     dto: CreateBookingUnderContractDto,
   ): Promise<void> {
+    // Parity gate. 20ft containers ride two per wagon, so an odd total leaves
+    // one container that cannot be placed. Consolidation (pairing it with
+    // another customer's odd booking) is built end to end but switched off for
+    // now, so an odd total is rejected outright — server-side, because the
+    // frontend block alone is not a guarantee.
+    const ft20Quantity = (dto.containers ?? [])
+      .filter((line) => (line.containerSize ?? '').includes('20'))
+      .reduce((sum, line) => sum + Number(line.quantity || 0), 0);
+    if (ft20Quantity % 2 === 1) {
+      throw new BadRequestException(
+        `20ft containers travel two per wagon, so they must be booked in even ` +
+          `numbers. This booking has ${ft20Quantity} — add one more or remove ` +
+          `one (book ${ft20Quantity + 1} or ${ft20Quantity - 1}).`,
+      );
+    }
+
     const twentyFtUnits = (dto.containers ?? [])
       .filter((line) => (line.containerSize ?? '').includes('20'))
       .flatMap((line, lineIdx) =>
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-clearance.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-clearance.service.ts
index 2ebd8fc70..826c7fdff 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-clearance.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-clearance.service.ts
@@ -6,6 +6,7 @@ import {
 } from '@nestjs/common';
 import {
   ContractDocPhase,
+  isDeliveryOrderFileCode,
   type ClearanceFinalInvoiceSummary,
   type ClearanceOffloadState,
   type ClearanceSecondDuty,
@@ -36,7 +37,7 @@ import { Contract } from './entities/contract.entity';
 import { ContractDocReviewStatus } from './entities/contract-document-review.entity';
 import { FilterContractDto } from './dto/filter-contract.dto';
 import { AdviseContractDutyDto } from './dto/phased-clearance.dto';
-import { buildWorkflowFiles, persistDeclarationUploads, persistTransitPermitUploads, PHASED_CUSTOMS_CONTRACT_QUEUE_STATUSES } from './phased-clearance.util';
+import { buildWorkflowFiles, persistDeclarationUploads, persistDeliveryOrderUploads, persistReleaseOrderUploads, persistTransitPermitUploads, PHASED_CUSTOMS_CONTRACT_QUEUE_STATUSES } from './phased-clearance.util';
 
 const RO_VESSEL_MIN_DAYS_CODE = 'ro_vessel_min_days';
 
@@ -357,32 +358,39 @@ export class ContractClearanceService {
     // Once GL creates the shipment booking, surface its reference + status so the
     // customer sees the concrete booking instead of a stale "will be created
     // shortly" message. Reuse the export booking load; fetch for import too.
+    let linkedBookingId: string | null = null;
     let linkedBookingReference: string | null = null;
     let linkedBookingStatus: string | null = null;
     let linkedBookingReviewNote: string | null = null;
     let linkedBookingScheduledDate: string | null = null;
-    if (cycle?.bookingId) {
-      const booking = await this.bookingsService.findById(cycle.bookingId);
-      if (booking) {
-        linkedBookingReference = booking.reference ?? null;
-        linkedBookingStatus = booking.status ?? null;
-        linkedBookingScheduledDate = booking.scheduledDate
-          ? new Date(booking.scheduledDate).toISOString()
-          : null;
-        // Newest changes-requested note (reviewNotes ride along on findById).
-        linkedBookingReviewNote =
-          [...(booking.reviewNotes ?? [])]
-            .filter((n) => n.type === 'CHANGES_REQUESTED')
-            .sort(
-              (a, b) =>
-                new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),
-            )[0]?.note ?? null;
-        if (contract.tradeDirection === 'EXPORT') {
-          nextAction = this.workflowService.computeNextActionForBooking(
-            booking,
-            bookingMilestones,
-          );
-        }
+    // The cycle is the historical link, but it is not written on every path (an
+    // FCFS export booking and a GL drawdown both reach the operations queue
+    // without a cycle row), so fall back to the contract's own live booking —
+    // otherwise the clearance page sees no linked booking at all and cannot show
+    // its status or the actions that depend on it.
+    const booking = cycle?.bookingId
+      ? await this.bookingsService.findById(cycle.bookingId)
+      : await this.contractsRepository.findLatestBookingForContract(contractId);
+    if (booking) {
+      linkedBookingId = booking.id ?? null;
+      linkedBookingReference = booking.reference ?? null;
+      linkedBookingStatus = booking.status ?? null;
+      linkedBookingScheduledDate = booking.scheduledDate
+        ? new Date(booking.scheduledDate).toISOString()
+        : null;
+      // Newest changes-requested note (reviewNotes ride along on findById).
+      linkedBookingReviewNote =
+        [...(booking.reviewNotes ?? [])]
+          .filter((n) => n.type === 'CHANGES_REQUESTED')
+          .sort(
+            (a, b) =>
+              new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),
+          )[0]?.note ?? null;
+      if (contract.tradeDirection === 'EXPORT') {
+        nextAction = this.workflowService.computeNextActionForBooking(
+          booking,
+          bookingMilestones,
+        );
       }
     }
 
@@ -419,7 +427,7 @@ export class ContractClearanceService {
       bookingReady: boundary,
       preClearanceFinalized: Boolean(cycle?.preClearanceFinalizedAt),
       exportClearanceFinalized: Boolean(cycle?.completedAt),
-      linkedBookingId: cycle?.bookingId ?? null,
+      linkedBookingId,
       linkedBookingReference,
       linkedBookingStatus,
       linkedBookingReviewNote,
@@ -1449,7 +1457,7 @@ export class ContractClearanceService {
 
     // GL Djibouti may have uploaded the DO early (un-gated) — count it now.
     const files = await this.filesService.findByResource(contractId, 'contracts');
-    if (files.some((f) => f.code === 'delivery_order')) {
+    if (files.some((f) => isDeliveryOrderFileCode(f.code))) {
       await this.workflowService.completeMilestone(contractId, 'DO_COLLECTED');
       await this.workflowService.markReadyForBooking(contractId);
     }
@@ -1460,7 +1468,7 @@ export class ContractClearanceService {
 
   async uploadDeliveryOrder(
     contractId: string,
-    file: Express.Multer.File,
+    files: Express.Multer.File[],
     userId?: string,
     dates?: { vesselArrivalDate?: string; doCollectedDate?: string },
   ): Promise<Contract> {
@@ -1470,19 +1478,12 @@ export class ContractClearanceService {
       throw new BadRequestException('Delivery Order applies only to import contracts.');
     }
 
-    if (!file) throw new BadRequestException('No Delivery Order uploaded');
-
     const { vesselArrivalDate, doCollectedDate } = assertDoCollectionDates(dates);
 
     // DO upload is deliberately un-gated: GL Djibouti may attach it at any point,
     // any file type. The DO_COLLECTED milestone (and booking readiness) still waits
     // for GL Ethiopia to finalize pre-clearance so the workflow order holds.
-    await this.filesService.upsertByCode({
-      resourceId: contractId,
-      resource: 'contracts',
-      code: 'delivery_order',
-      file,
-    });
+    await persistDeliveryOrderUploads(this.filesService, contractId, 'contracts', files ?? []);
 
     const cycle = await this.contractsRepository.currentCycle(contractId);
     if (cycle) {
@@ -1520,7 +1521,7 @@ export class ContractClearanceService {
 
   async uploadReleaseOrder(
     contractId: string,
-    file: Express.Multer.File,
+    files: Express.Multer.File[],
     vesselDepartureDate: string,
     userId?: string,
   ): Promise<{ contract: Contract; hold: boolean; holdReason?: string }> {
@@ -1535,7 +1536,6 @@ export class ContractClearanceService {
       'RELEASE_ORDER_SECURED',
     );
 
-    if (!file) throw new BadRequestException('No Release Order uploaded');
     if (!vesselDepartureDate?.trim()) {
       throw new BadRequestException('Vessel departure date is required');
     }
@@ -1545,12 +1545,7 @@ export class ContractClearanceService {
     const cycle = await this.contractsRepository.currentCycle(contractId);
     if (!cycle) throw new BadRequestException('No clearance cycle found');
 
-    await this.filesService.upsertByCode({
-      resourceId: contractId,
-      resource: 'contracts',
-      code: 'release_order',
-      file,
-    });
+    await persistReleaseOrderUploads(this.filesService, contractId, 'contracts', files ?? []);
 
     await this.contractsRepository.updateCycle(cycle.id, {
       vesselDepartureDate,
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-document-history.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-document-history.service.ts
index e38f737c6..1f1469182 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-document-history.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-document-history.service.ts
@@ -2,6 +2,7 @@ import { Injectable, Logger } from '@nestjs/common';
 import { InjectDataSource, InjectRepository } from '@nestjs/typeorm';
 import { DataSource, Repository } from 'typeorm';
 
+import { resolveIamUserNames } from '../../common/utils/iam-user-name.util';
 import {
   ContractDocumentChange,
   diffSnapshots,
@@ -20,28 +21,6 @@ export interface RecordRevisionInput {
   stepId?: string | null;
 }
 
-/**
- * `iam.users.name` is a localized object ({ en, am, … }), not a string — a
- * plain `String(name)` there yields "[object Object]" in the audit trail.
- */
-interface IamUserRow {
-  name?: Record<string, string> | string | null;
-  username?: string | null;
-  email?: string | null;
-}
-
-/** Best display name for a user row: English label → any locale → login → email. */
-function pickUserName(user: IamUserRow): string | null {
-  const { name } = user;
-  if (typeof name === 'string' && name.trim()) return name.trim();
-  if (name && typeof name === 'object') {
-    const localized =
-      name.en ?? Object.values(name).find((v) => typeof v === 'string' && v.trim());
-    if (localized?.trim()) return localized.trim();
-  }
-  return user.username?.trim() || user.email?.trim() || null;
-}
-
 /** Pre-computed changes (contract fields), rather than a document diff. */
 export interface RecordChangesInput {
   contractId: string;
@@ -120,23 +99,12 @@ export class ContractDocumentHistoryService {
   private async resolveActorNames(
     actorIds: string[],
   ): Promise<Map<string, string>> {
-    const resolved = new Map<string, string>();
-    const ids = [...new Set(actorIds.filter(Boolean))];
-    if (ids.length === 0) return resolved;
-
     try {
-      const rows = (await this.dataSource.query(
-        `SELECT id, name, username, email FROM iam.users WHERE id = ANY($1::uuid[])`,
-        [ids],
-      )) as Array<IamUserRow & { id: string }>;
-      for (const row of rows) {
-        const name = pickUserName(row);
-        if (name) resolved.set(row.id, name);
-      }
+      return await resolveIamUserNames(this.dataSource, actorIds);
     } catch (err) {
       this.logger.warn(`Could not resolve actor names: ${String(err)}`);
+      return new Map();
     }
-    return resolved;
   }
 
   /** Revision history for a contract, newest first. */
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.spec.ts
index 0551cfc7a..27cfa5fa1 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.spec.ts
@@ -1,5 +1,6 @@
 import { ContractExpiryService } from './contract-expiry.service';
 import type { Contract } from './entities/contract.entity';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
 
 /**
  * The reminder must warn each customer once, ten days out, and must never let a
@@ -60,4 +61,18 @@ describe('ContractExpiryService — expiry reminder', () => {
     inbox.notify.mockRejectedValue(new Error('inbox down'));
     await expect(service.remindExpiringContracts()).resolves.toBeUndefined();
   });
+
+  // The sweep-failure alert is staff-facing. It used to go to every employee;
+  // it belongs to the people who would notice expired contracts still listed
+  // as active, i.e. the contract desk.
+  it('alerts the contract desk when the sweep itself fails', async () => {
+    repo.expireLapsedContracts.mockRejectedValue(new Error('deadlock'));
+
+    await service.expireLapsedContracts();
+
+    expect(inbox.notify).toHaveBeenCalledTimes(1);
+    expect(inbox.notify.mock.calls[0][0].recipients).toEqual({
+      permissionKeys: [FREIGHT_PERMS.contracts.getNotification],
+    });
+  });
 });
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.ts
index 1ef84c141..c570fbc0a 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-expiry.service.ts
@@ -4,6 +4,7 @@ import { NotificationAudience, NotificationType } from '@edr/types';
 
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
 import { ContractsRepository } from './contracts.repository';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
 
 /**
  * How many days before a contract lapses the customer is reminded. Mirrored by
@@ -79,7 +80,11 @@ export class ContractExpiryService {
       );
       try {
         await this.inbox.notify({
-          recipients: { allBackoffice: true },
+          // The people who would notice expired contracts still listed as
+          // active are the ones working the contract desk.
+          recipients: {
+            permissionKeys: [FREIGHT_PERMS.contracts.getNotification],
+          },
           audience: NotificationAudience.BACKOFFICE,
           type: NotificationType.GENERIC,
           title: 'Contract expiry sweep failed',
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-notifier.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-notifier.service.ts
index 92a313569..477724839 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-notifier.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-notifier.service.ts
@@ -10,7 +10,17 @@ import {
 import { Contract } from './entities/contract.entity';
 import { NotificationsService } from '../notifications/notifications.service';
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
-import { resolveCompanyNotifyPhone } from '../notifications/resolve-company-phone.util';
+import { resolveCompanyNotifyContact } from '../notifications/resolve-company-phone.util';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
+
+/**
+ * Clearance items are worked by the GL desks, which hold no intake keys — so
+ * they take their own selector rather than the contract desk's. Every override
+ * using this deep-links to a clearance or shipment-request page.
+ */
+const CLEARANCE_DESK = {
+  permissionKeys: [FREIGHT_PERMS.contracts.clearanceGetNotification],
+};
 
 /**
  * Customer + staff notifications for the contract lifecycle. Every customer
@@ -42,10 +52,11 @@ export class ContractNotifierService {
     logLabel: string,
   ): Promise<void> {
     this.logger.log(`${logLabel} — ${this.ref(c)}`);
-    const phone = c.companyId
-      ? await resolveCompanyNotifyPhone(this.dataSource, c.companyId)
-      : null;
-    const email = c.company?.email ?? c.company?.generalManagerEmail ?? null;
+    // One resolver for both channels — the company row's own email column is
+    // only set for a Fayda-verified owner (see companyNotifyEmailExpr).
+    const { phone, email } = c.companyId
+      ? await resolveCompanyNotifyContact(this.dataSource, c.companyId)
+      : { phone: null, email: null };
 
     if (phone) {
       try {
@@ -86,7 +97,11 @@ export class ContractNotifierService {
     });
   }
 
-  /** Persist + push an in-app item to every backoffice staff user. */
+  /**
+   * Persist + push an in-app item to the contract desk — staff holding
+   * `contracts:get_notification`. Callers whose item belongs to a different
+   * desk override `recipients` (see {@link CLEARANCE_DESK}).
+   */
   private inAppStaff(
     c: Contract,
     title: string,
@@ -94,7 +109,7 @@ export class ContractNotifierService {
     overrides: Partial<NotifyInput> = {},
   ): void {
     void this.inbox.notify({
-      recipients: { allBackoffice: true },
+      recipients: { permissionKeys: [FREIGHT_PERMS.contracts.getNotification] },
       audience: NotificationAudience.BACKOFFICE,
       type: NotificationType.REQUEST_SUBMITTED,
       title,
@@ -230,6 +245,7 @@ export class ContractNotifierService {
       `the customs declaration can be filed.${note ? ` Note: "${note}"` : ''}`;
     this.logger.log(`TRANSIT ASSIGNEE REQUESTED — ${c.reference}`);
     this.inAppStaff(c, `Transit assignee needed — ${c.reference}`, msg, {
+      recipients: CLEARANCE_DESK,
       type: NotificationType.CLEARANCE_REVIEW,
       link: `/dashboard/gl-djibouti/clearance/${c.id}`,
     });
@@ -248,6 +264,7 @@ export class ContractNotifierService {
         `The customs declaration can now be filed.`;
     this.logger.log(`TRANSIT ASSIGNEE ASSIGNED — ${c.reference}`);
     this.inAppStaff(c, `Transit assignee set — ${c.reference}`, msg, {
+      recipients: CLEARANCE_DESK,
       type: NotificationType.CLEARANCE_REVIEW,
       link: `/dashboard/contracts/clearance/${c.id}`,
     });
@@ -264,6 +281,7 @@ export class ContractNotifierService {
       `"${note}". Review and re-advise the amount on the clearance page.`;
     this.logger.log(`DUTY DISPUTED — ${c.reference}`);
     this.inAppStaff(c, `Duty disputed on ${c.reference}`, msg, {
+      recipients: CLEARANCE_DESK,
       type: NotificationType.CLEARANCE_REVIEW,
       link: `/dashboard/contracts/clearance/${c.id}`,
     });
@@ -321,6 +339,7 @@ export class ContractNotifierService {
       'Clearance documents uploaded',
       `Customer uploaded clearance documents for contract ${this.ref(c)} — review them in the clearance queue.`,
       {
+        recipients: CLEARANCE_DESK,
         type: NotificationType.CLEARANCE_REVIEW,
         link: `/dashboard/contracts/clearance/${c.id}`,
       },
@@ -334,6 +353,7 @@ export class ContractNotifierService {
       'Duty slip uploaded',
       `Customer uploaded the duty & tax payment slip for contract ${this.ref(c)}.`,
       {
+        recipients: CLEARANCE_DESK,
         type: NotificationType.PAYMENT_RECEIVED,
         link: `/dashboard/contracts/clearance/${c.id}`,
       },
@@ -347,6 +367,9 @@ export class ContractNotifierService {
       'New shipment request',
       `Shipment request ${requestRef} was filed under contract ${this.ref(c)} and awaits GL review.`,
       {
+        // GL reviews these, and the shipment-requests page is gated on
+        // contracts:create_booking — a key only the GL Ethiopia preset holds.
+        recipients: CLEARANCE_DESK,
         link: `/dashboard/shipment-requests/${requestId}`,
         data: { contractId: c.id, requestId, reference: requestRef },
       },
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-onetime-paid-gate.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-onetime-paid-gate.spec.ts
new file mode 100644
index 000000000..0b2a16026
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/contracts/contract-onetime-paid-gate.spec.ts
@@ -0,0 +1,38 @@
+import { ContractsRepository } from './contracts.repository';
+
+/**
+ * A ONE_TIME contract stops blocking a duplicate request only once its booking
+ * is PAID. The existing duplicate-guard spec stubs the repository out, so the
+ * candidate SQL itself is unchecked there — this pins the predicate.
+ */
+describe('findDuplicateCandidates ONE_TIME paid gate', () => {
+  const candidateSql = (): string => {
+    const conditions: string[] = [];
+    const qb = {
+      leftJoinAndSelect: () => qb,
+      where: () => qb,
+      andWhere: (condition: string) => {
+        if (typeof condition === 'string') conditions.push(condition);
+        return qb;
+      },
+      getMany: async () => [],
+    };
+
+    const repository = new ContractsRepository(
+      { createQueryBuilder: () => qb } as never,
+      {} as never,
+    );
+
+    void repository.findDuplicateCandidates('company-1', 'svc-1');
+    return conditions.join(' AND ');
+  };
+
+  it('spends the contract on payment, not on the booking row existing', () => {
+    const sql = candidateSql();
+
+    expect(sql).toContain("contract.contract_kind <> 'ONE_TIME'");
+    // The gate: an unpaid booking must NOT free the lane.
+    expect(sql).toContain("b.payment_status = 'PAID'");
+    expect(sql).toContain('b.deleted_at IS NULL');
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-pricing.service.ts b/apps/edr-freight-api/src/modules/contracts/contract-pricing.service.ts
index 924c1a72d..af0a149d7 100644
--- a/apps/edr-freight-api/src/modules/contracts/contract-pricing.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contract-pricing.service.ts
@@ -11,7 +11,14 @@ import { Contract } from './entities/contract.entity';
 export interface ContractUnitRateLineItem {
   code: string;
   label: string;
-  unit: 'per_container' | 'per_wagon' | 'per_ton' | 'per_item' | 'per_km' | 'flat';
+  unit:
+    | 'per_container'
+    | 'per_wagon'
+    | 'per_ton'
+    | 'per_item'
+    | 'per_km'
+    | 'per_liter'
+    | 'flat';
   unitPrice: number;
   containerSize?: string | null;
   conditionalOn?: string | null;
@@ -44,6 +51,8 @@ function toContractUnit(rateUnit: string): ContractUnitRateLineItem['unit'] {
       return 'per_wagon';
     case 'PER_CONTAINER':
       return 'per_container';
+    case 'PER_LITER':
+      return 'per_liter';
     default:
       return 'flat';
   }
@@ -276,6 +285,42 @@ export class ContractPricingService {
       }
     }
 
+    // Fuel surcharge — shown when the contract's commodity incurs fuel
+    // (cargoType.hasFuel), sold per lane + commodity. Billed at booking on the
+    // frozen/live rate (per wagon × wagons, or per liter × base liters, once);
+    // this line freezes the agreed unit price.
+    {
+      const scope = (contract.cargoScope ?? []).find((c) => c.cargoTypeId);
+      if (scope?.cargoType?.hasFuel && route) {
+        const fuel = liveRates.find(
+          (r) =>
+            r.trigger === 'FUEL' &&
+            r.currency === 'USD' &&
+            r.tradeDirection === contract.tradeDirection &&
+            r.originYardId === route.originYardId &&
+            r.destinationYardId === route.destinationYardId &&
+            r.cargoTypeId === scope.cargoTypeId,
+        );
+        if (fuel && Number(fuel.rateValue) > 0) {
+          // Per-liter collapses to one flat total (base liters × rate value) —
+          // the customer only sees the final price, and booking pricing bills
+          // the same flat figure once (see RuleEngineService.fuelCharges).
+          const perLiter = fuel.rateUnit === 'PER_LITER';
+          const total = perLiter
+            ? Number(fuel.baseLiters ?? 0) * Number(fuel.rateValue)
+            : Number(fuel.rateValue);
+          lineItems.push({
+            code: 'FUEL_SURCHARGE',
+            label: `Fuel surcharge (${scope.cargoType.cargoTypeName})`,
+            unit: perLiter ? 'flat' : toContractUnit(fuel.rateUnit),
+            unitPrice: convert(total),
+            cargoTypeCode: scope.cargoType.code ?? null,
+            conditionalOn: 'has_fuel',
+          });
+        }
+      }
+    }
+
     // Empty-container return service — container contracts only, toggled on the
     // contract like hazard/reefer. Billed at booking per WITH_RETURN container.
     if (
diff --git a/apps/edr-freight-api/src/modules/contracts/contract-staff-stamp.spec.ts b/apps/edr-freight-api/src/modules/contracts/contract-staff-stamp.spec.ts
new file mode 100644
index 000000000..99fff9479
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/contracts/contract-staff-stamp.spec.ts
@@ -0,0 +1,159 @@
+import { BadRequestException } from '@nestjs/common';
+
+import { ContractTransitionService } from './contract-transition.service';
+
+/**
+ * The staff signature seals with the ONE global stamp by REFERENCE: the
+ * signature row stores the current global stampFileId instead of re-uploading
+ * a copy per contract. That id stays valid after the stamp is replaced
+ * (StampSettingsService never deletes retired stamp files), so each contract
+ * keeps the exact seal it was signed with. These specs pin the sourcing
+ * split: EDR always seals with the global stamp and staff never supply one,
+ * while the customer must upload their own.
+ */
+describe('applySignature stamp sourcing', () => {
+  const contract = { id: 'c-1', reference: 'CTR-1', status: 'SIGNED_CUSTOMER' };
+  const GLOBAL_STAMP = 'data:image/png;base64,RURS';
+  const GLOBAL_STAMP_FILE_ID = 'file-global-stamp';
+
+  const build = (globalStampFileId: string | null = GLOBAL_STAMP_FILE_ID) => {
+    const uploads: Array<{ code: string; image: string }> = [];
+    const saved: unknown[] = [];
+    const service = Object.create(
+      ContractTransitionService.prototype,
+    ) as ContractTransitionService;
+    Object.assign(service, {
+      logger: { warn: jest.fn(), log: jest.fn() },
+      stampSettings: {
+        get: jest.fn().mockResolvedValue({
+          id: 's-1',
+          stampFileId: globalStampFileId,
+        }),
+      },
+      contractsRepository: {
+        saveSignature: jest.fn((row: unknown) => {
+          saved.push(row);
+          return Promise.resolve(undefined);
+        }),
+      },
+      signaturesService: {
+        getForUser: jest.fn().mockResolvedValue(null),
+        upsertForUser: jest.fn().mockResolvedValue(undefined),
+      },
+      uploadSignatureAsset: jest.fn((_c: unknown, code: string, image: string) => {
+        uploads.push({ code, image });
+        return Promise.resolve({ id: `file-${code}` });
+      }),
+    });
+    return { service, uploads, saved };
+  };
+
+  const apply = (
+    service: ContractTransitionService,
+    dto: Record<string, unknown>,
+  ) =>
+    (
+      service as unknown as {
+        applySignature(
+          c: unknown,
+          d: unknown,
+          o: { signerUserId?: string },
+        ): Promise<void>;
+      }
+    ).applySignature(contract, dto, { signerUserId: 'u-1' });
+
+  const staffDto = {
+    role: 'STAFF' as const,
+    signerDisplayName: 'E. Staff',
+    signatureImageBase64: 'data:image/png;base64,U0lH',
+  };
+
+  it('seals the EDR side by referencing the global stamp file, without re-uploading it', async () => {
+    const { service, uploads, saved } = build();
+
+    await apply(service, staffDto);
+
+    expect(uploads.map((u) => u.code)).toEqual(['signature_staff']);
+    expect(saved[0]).toEqual(
+      expect.objectContaining({ stampFileId: GLOBAL_STAMP_FILE_ID }),
+    );
+  });
+
+  it('ignores a stamp a staff client tries to supply', async () => {
+    const { service, uploads, saved } = build();
+
+    await apply(service, {
+      ...staffDto,
+      stampImageBase64: 'data:image/png;base64,SEFDSw==',
+    });
+
+    expect(uploads.map((u) => u.image)).not.toContain(
+      'data:image/png;base64,SEFDSw==',
+    );
+    expect(saved[0]).toEqual(
+      expect.objectContaining({ stampFileId: GLOBAL_STAMP_FILE_ID }),
+    );
+  });
+
+  /**
+   * Failing loudly matters here: silently executing an unsealed contract
+   * would be worse than refusing to counter-sign.
+   */
+  it('refuses to counter-sign when no global stamp is configured', async () => {
+    const { service, saved } = build(null);
+
+    await expect(apply(service, staffDto)).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+    await expect(apply(service, staffDto)).rejects.toThrow(/company stamp is configured/i);
+    expect(saved).toHaveLength(0);
+  });
+
+  it('requires the customer to upload their own stamp', async () => {
+    const { service, saved } = build();
+
+    await expect(
+      apply(service, {
+        role: 'CUSTOMER',
+        signerDisplayName: 'C. Customer',
+        signatureImageBase64: 'data:image/png;base64,U0lH',
+      }),
+    ).rejects.toThrow(/company stamp is required/i);
+    expect(saved).toHaveLength(0);
+  });
+
+  it('snapshots the customer stamp and never substitutes the global one', async () => {
+    const { service, uploads } = build();
+    const customerStamp = 'data:image/png;base64,Q1VTVA==';
+
+    await apply(service, {
+      role: 'CUSTOMER',
+      signerDisplayName: 'C. Customer',
+      signatureImageBase64: 'data:image/png;base64,U0lH',
+      stampImageBase64: customerStamp,
+    });
+
+    expect(uploads).toContainEqual({
+      code: 'stamp_customer',
+      image: customerStamp,
+    });
+    expect(uploads.map((u) => u.image)).not.toContain(GLOBAL_STAMP);
+  });
+
+  /**
+   * DIRECTOR/CEO rows are internal approval signatures, not party seals, so
+   * they are deliberately exempt from the stamp requirement.
+   */
+  it('lets internal approval signatures through without any stamp', async () => {
+    const { service, uploads, saved } = build();
+
+    await apply(service, {
+      role: 'DIRECTOR',
+      signerDisplayName: 'D. Director',
+      signatureImageBase64: 'data:image/png;base64,U0lH',
+    });
+
+    expect(uploads.map((u) => u.code)).toEqual(['signature_director']);
+    expect(saved[0]).toEqual(expect.objectContaining({ stampFileId: null }));
+  });
+});
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 0a073c9f8..48c90fcbc 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
@@ -9,7 +9,7 @@ import { InjectDataSource } from '@nestjs/typeorm';
 import { DataSource } from 'typeorm';
 import { randomUUID } from 'node:crypto';
 import { Readable } from 'stream';
-import { insertWithGeneratedReference } from '@edr/api-common';
+import { insertWithGeneratedReference, logCtx } from '@edr/api-common';
 import type { TCurrentUser } from '@tria-plc/api-common/modules/auth/types/current-user.type';
 
 import { ContractDocumentViewModelBuilder } from '../../contracts/contract-document-view-model.builder';
@@ -35,6 +35,7 @@ import { CargoTypesService } from '../rule-engine/services/cargo-types.service';
 import { DropdownSettingsService } from '../dropdown-settings/dropdown-settings.service';
 import { FilesService } from '../files/files.service';
 import { SignaturesService } from '../signatures/signatures.service';
+import { StampSettingsService } from '../stamp-settings/stamp-settings.service';
 import { OtpService } from '../otp/otp.service';
 import { ContractTemplatesService } from '../contract-templates/contract-templates.service';
 import { ContractPricingService } from './contract-pricing.service';
@@ -175,6 +176,7 @@ export class ContractTransitionService {
     private readonly otpService: OtpService,
     private readonly notifier: ContractNotifierService,
     private readonly contractTemplates: ContractTemplatesService,
+    private readonly stampSettings: StampSettingsService,
     @InjectDataSource()
     private readonly dataSource: DataSource,
   ) {}
@@ -424,6 +426,8 @@ export class ContractTransitionService {
       contract.tradeDirection,
       contract.freightType,
       contract.customsClearingEnabled,
+      // Bulk templates are keyed by the contract's cargo type.
+      (contract.cargoScope ?? []).find((c) => c.cargoTypeId)?.cargoTypeId,
     );
     if (!active) return null;
     return {
@@ -1080,6 +1084,19 @@ export class ContractTransitionService {
   ): Promise<void> {
     const role = dto.role as ContractSignerRole;
 
+    // Both sign() and counterSign() land here — who signed what, and whether the
+    // ink came from the request or the signer's saved profile signature.
+    logCtx(
+      {
+        contractId: contract.id,
+        reference: contract.reference,
+        role,
+        signerUserId: options.signerUserId,
+        usedDrawnImage: Boolean(dto.signatureImageBase64),
+      },
+      { path: "contractSignatures", mode: "push" },
+    );
+
     // Resolve the signature image. The client may send a freshly-drawn image, or
     // omit it to reuse the signer's saved profile signature. Fall back to the
     // saved one whenever no image is supplied.
@@ -1101,25 +1118,44 @@ export class ContractTransitionService {
     // The company stamp is a separate image from the drawn signature. Both
     // parties to the contract (client + EDR) must seal it; DIRECTOR/CEO rows
     // are internal approval signatures, not party seals, so they stay exempt.
-    const stampRequired = role === 'CUSTOMER' || role === 'STAFF';
-    if (stampRequired && !dto.stampImageBase64) {
+    //
+    // The two parties source their seal differently: the customer uploads their
+    // own company stamp, while EDR always seals with the ONE global stamp
+    // (StampSettingsService) — staff never upload or pick a stamp.
+    if (role === 'CUSTOMER' && !dto.stampImageBase64) {
       throw new BadRequestException(
         'A company stamp is required to sign this contract.',
       );
     }
 
+    // STAFF seals by REFERENCE to the one global stamp file — no per-contract
+    // copy of the image. Safe because StampSettingsService.setStamp/clearStamp
+    // never delete a replaced stamp file: the referenced id keeps rendering
+    // the exact seal that was current at signing, even after the global stamp
+    // is later replaced. The customer's stamp is their own upload and is still
+    // stored per contract.
+    let stampFileId: string | null = null;
+    if (role === 'STAFF') {
+      stampFileId = (await this.stampSettings.get()).stampFileId ?? null;
+      if (!stampFileId) {
+        throw new BadRequestException(
+          'No company stamp is configured. Upload the company stamp under Settings before counter-signing contracts.',
+        );
+      }
+    } else if (dto.stampImageBase64) {
+      const stampRecord = await this.uploadSignatureAsset(
+        contract,
+        `stamp_${role.toLowerCase()}`,
+        dto.stampImageBase64,
+      );
+      stampFileId = stampRecord.id;
+    }
+
     const fileRecord = await this.uploadSignatureAsset(
       contract,
       `signature_${role.toLowerCase()}`,
       imageBase64,
     );
-    const stampRecord = dto.stampImageBase64
-      ? await this.uploadSignatureAsset(
-          contract,
-          `stamp_${role.toLowerCase()}`,
-          dto.stampImageBase64,
-        )
-      : null;
 
     await this.contractsRepository.saveSignature({
       contractId: contract.id,
@@ -1127,7 +1163,7 @@ export class ContractTransitionService {
       signerDisplayName,
       signedAt: new Date(),
       signatureFileId: fileRecord.id,
-      stampFileId: stampRecord?.id ?? null,
+      stampFileId,
       consentText: dto.consentText ?? null,
     });
 
diff --git a/apps/edr-freight-api/src/modules/contracts/contracts.controller.ts b/apps/edr-freight-api/src/modules/contracts/contracts.controller.ts
index 0ff9b7c24..1dc083934 100644
--- a/apps/edr-freight-api/src/modules/contracts/contracts.controller.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contracts.controller.ts
@@ -76,7 +76,10 @@ import {
 import { SignContractDto } from './dto/sign-contract.dto';
 import { ReviewClearanceDocumentDto } from './dto/review-clearance-document.dto';
 import { RenewContractDto } from './dto/renew-contract.dto';
-import { CreateBookingUnderContractDto } from './dto/create-booking-under-contract.dto';
+import {
+  CompleteConsolidatedPairDto,
+  CreateBookingUnderContractDto,
+} from './dto/create-booking-under-contract.dto';
 import {
   CreateBookingRequestDto,
   ReviewBookingRequestDto,
@@ -120,8 +123,8 @@ export class ContractsController {
   @Get('booking-requests/queue')
   @BookingStaff(FREIGHT_PERMS.contracts.createBooking)
   @ApiOperation({ summary: 'GL queue: shipment requests across contracts (all statuses, newest first)' })
-  bookingRequestQueue() {
-    return this.bookingRequestService.queue();
+  bookingRequestQueue(@CurrentUser() user: AuthUserPayload) {
+    return this.bookingRequestService.queue(user);
   }
 
   @Get('booking-requests/:reqId')
@@ -956,20 +959,20 @@ export class ContractsController {
 
   @Post(':id/clearance/delivery-order')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceDjActions)
-  @UseInterceptors(FileInterceptor('file'))
+  @UseInterceptors(AnyFilesInterceptor())
   @ApiConsumes('multipart/form-data')
   @ApiOperation({
     summary:
-      'GL DJ uploads Delivery Order (import) with vessel arrival + DO collected dates',
+      'GL DJ uploads Delivery Order files (import) with vessel arrival + DO collected dates',
   })
   uploadDeliveryOrder(
     @Param('id', ParseUUIDPipe) id: string,
-    @UploadedFile() file: Express.Multer.File,
+    @UploadedFiles() files: Express.Multer.File[],
     @Body('vesselArrivalDate') vesselArrivalDate: string | undefined,
     @Body('doCollectedDate') doCollectedDate: string | undefined,
     @CurrentUser() user: AuthUserPayload,
   ) {
-    return this.clearanceService.uploadDeliveryOrder(id, file, resolveAuthUserId(user), {
+    return this.clearanceService.uploadDeliveryOrder(id, files ?? [], resolveAuthUserId(user), {
       vesselArrivalDate,
       doCollectedDate,
     });
@@ -977,18 +980,18 @@ export class ContractsController {
 
   @Post(':id/clearance/release-order')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceDjActions)
-  @UseInterceptors(FileInterceptor('file'))
+  @UseInterceptors(AnyFilesInterceptor())
   @ApiConsumes('multipart/form-data')
-  @ApiOperation({ summary: 'GL DJ uploads Release Order + vessel departure date (export)' })
+  @ApiOperation({ summary: 'GL DJ uploads Release Order files + vessel departure date (export)' })
   uploadReleaseOrder(
     @Param('id', ParseUUIDPipe) id: string,
-    @UploadedFile() file: Express.Multer.File,
+    @UploadedFiles() files: Express.Multer.File[],
     @Body('vesselDepartureDate') vesselDepartureDate: string,
     @CurrentUser() user: AuthUserPayload,
   ) {
     return this.clearanceService.uploadReleaseOrder(
       id,
-      file,
+      files ?? [],
       vesselDepartureDate,
       resolveAuthUserId(user),
     );
@@ -1152,10 +1155,48 @@ export class ContractsController {
     // Customs (Path B) instances may only be completed by GL Ethiopia — the
     // service checks the actor's contracts:create_booking permission.
     return this.contractBookingService.completeUnderContract(
+      id,
+      bookingId,
+      // skipAutoConsolidation is internal to the manual pair-completion path; a
+      // client must never suppress the wagon gate on a lone booking.
+      { ...dto, skipAutoConsolidation: false },
+      user,
+    );
+  }
+
+  @Get(':id/bookings/:bookingId/consolidation-candidates')
+  @MixedAudience(FREIGHT_PERMS.contracts.createBooking)
+  @ApiOperation({
+    summary:
+      'Bookings GL may link to this odd-20ft customs booking as its shared-wagon partner (same route and direction, customs, odd 20ft, unpaired).',
+  })
+  listConsolidationCandidates(
+    @Param('id', ParseUUIDPipe) id: string,
+    @Param('bookingId', ParseUUIDPipe) bookingId: string,
+  ) {
+    return this.contractBookingService.listConsolidationCandidates(id, bookingId);
+  }
+
+  @Post(':id/bookings/:bookingId/complete-consolidated')
+  @MixedAudience(FREIGHT_PERMS.contracts.createBooking)
+  @ApiOperation({
+    summary:
+      'Complete this booking and its chosen shared-wagon partner together (all-or-nothing). Each booking is priced and invoiced separately — only the wagon is shared.',
+  })
+  completeConsolidatedPair(
+    @Param('id', ParseUUIDPipe) id: string,
+    @Param('bookingId', ParseUUIDPipe) bookingId: string,
+    @Body() dto: CompleteConsolidatedPairDto,
+    @CurrentUser() user: TCurrentUser & { sub?: string },
+  ) {
+    return this.contractBookingService.completeConsolidatedPair(
       id,
       bookingId,
       dto,
       user,
+      // Recorded as the requester on the approval: the person who created the
+      // pairing may not be the one who approves it.
+      user?.id ?? user?.sub ?? null,
     );
   }
 
diff --git a/apps/edr-freight-api/src/modules/contracts/contracts.repository.ts b/apps/edr-freight-api/src/modules/contracts/contracts.repository.ts
index a7fddd816..309079010 100644
--- a/apps/edr-freight-api/src/modules/contracts/contracts.repository.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contracts.repository.ts
@@ -3,6 +3,7 @@ import { Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
 import { DataSource, In, IsNull, Repository, SelectQueryBuilder } from 'typeorm';
 
+import { computeFacets, FacetBucket } from '../../common/utils/facets.util';
 import { Booking } from '../bookings/entities/booking.entity';
 import { FileRecord } from '../files/entities/file.entity';
 import { applyDirectionScope } from '../user-trade-access/trade-scope.util';
@@ -47,6 +48,8 @@ export interface ContractListFilterOptions {
   hasClearanceDocuments?: boolean;
   createdFrom?: string;
   createdTo?: string;
+  originYardId?: string;
+  destinationYardId?: string;
 }
 
 @Injectable()
@@ -104,15 +107,19 @@ export class ContractsRepository extends BaseRepository<Contract> {
       .andWhere('contract.status NOT IN (:...terminal)', {
         terminal: TERMINAL_CONTRACT_STATUSES,
       })
-      // A ONE_TIME contract allows a single booking, so once that booking
-      // exists the contract is spent and can never carry another shipment.
+      // A ONE_TIME contract allows a single booking, so once that booking is
+      // PAID the contract is spent and can never carry another shipment.
       // Without this it kept blocking new requests on the same service type +
       // route until its validity lapsed — locking a customer out of a lane for
       // the rest of the term after one completed shipment.
+      // Payment is the gate, not the booking row: a DRAFT or abandoned unpaid
+      // booking must keep the contract blocking, otherwise a customer holds an
+      // unpaid booking and requests an identical contract alongside it.
       .andWhere(
         `(contract.contract_kind <> 'ONE_TIME' OR NOT EXISTS (
             SELECT 1 FROM freight.bookings b
              WHERE b.contract_id = contract.id AND b.deleted_at IS NULL
+               AND b.payment_status = 'PAID'
          ))`,
       )
       .getMany();
@@ -136,6 +143,27 @@ export class ContractsRepository extends BaseRepository<Contract> {
     return result.affected ?? 0;
   }
 
+  /**
+   * Same-row version of expireLapsedContracts, for lazy flips on read/booking
+   * paths — flips this one contract to EXPIRED if it's lapsed and not already
+   * terminal. No-op (returns false) if the contract isn't actually lapsed, so
+   * callers can call this unconditionally without a pre-check.
+   */
+  async expireIfLapsed(id: string): Promise<boolean> {
+    const result = await this.repository
+      .createQueryBuilder()
+      .update(Contract)
+      .set({ status: 'EXPIRED' })
+      .where('id = :id', { id })
+      .andWhere('deleted_at IS NULL')
+      .andWhere('status NOT IN (:...terminal)', { terminal: TERMINAL_CONTRACT_STATUSES })
+      .andWhere('contract_valid_until IS NOT NULL AND contract_valid_until < :now', {
+        now: new Date(),
+      })
+      .execute();
+    return (result.affected ?? 0) > 0;
+  }
+
   /**
    * Live contracts whose validity ends between `days` and `days + 1` days from
    * now — the slice the daily expiry-reminder cron warns about. The window is
@@ -391,14 +419,22 @@ export class ContractsRepository extends BaseRepository<Contract> {
     return { inQueue, onThisPage, needsAction };
   }
 
+  /**
+   * @param omit  skip this one predicate — used by `getFacets` so a facet's
+   *   own filter doesn't hide its own sibling values (see class doc on
+   *   `getFacets`). Every other list/summary/count caller passes nothing.
+   */
   private applyListFilters(
     qb: SelectQueryBuilder<Contract>,
     options: ContractListFilterOptions,
+    omit?: keyof ContractListFilterOptions | 'status',
   ): void {
-    if (options.statuses?.length) {
-      qb.andWhere('contract.status IN (:...statuses)', { statuses: options.statuses });
-    } else if (options.status) {
-      qb.andWhere('contract.status = :status', { status: options.status });
+    if (omit !== 'status') {
+      if (options.statuses?.length) {
+        qb.andWhere('contract.status IN (:...statuses)', { statuses: options.statuses });
+      } else if (options.status) {
+        qb.andWhere('contract.status = :status', { status: options.status });
+      }
     }
     if (options.companyId) {
       qb.andWhere('contract.company_id = :companyId', { companyId: options.companyId });
@@ -408,7 +444,7 @@ export class ContractsRepository extends BaseRepository<Contract> {
         companyProfileId: options.companyProfileId,
       });
     }
-    if (options.contractKind) {
+    if (omit !== 'contractKind' && options.contractKind) {
       qb.andWhere('contract.contract_kind = :contractKind', {
         contractKind: options.contractKind,
       });
@@ -429,20 +465,20 @@ export class ContractsRepository extends BaseRepository<Contract> {
         serviceTypeId: options.serviceTypeId,
       });
     }
-    if (options.freightType) {
+    if (omit !== 'freightType' && options.freightType) {
       qb.andWhere('contract.freight_type = :freightType', {
         freightType: options.freightType,
       });
     }
-    if (options.tradeDirection) {
+    if (omit !== 'tradeDirection' && options.tradeDirection) {
       qb.andWhere('contract.trade_direction = :tradeDirection', {
         tradeDirection: options.tradeDirection,
       });
     }
-    if (options.tradeDirections) {
+    if (omit !== 'tradeDirection' && options.tradeDirections) {
       applyDirectionScope(qb, 'contract.trade_direction', options.tradeDirections);
     }
-    if (options.paymentCurrency) {
+    if (omit !== 'paymentCurrency' && options.paymentCurrency) {
       qb.andWhere('contract.payment_currency = :paymentCurrency', {
         paymentCurrency: options.paymentCurrency,
       });
@@ -455,6 +491,47 @@ export class ContractsRepository extends BaseRepository<Contract> {
     if (options.createdTo) {
       qb.andWhere('contract.created_at <= :createdTo', { createdTo: options.createdTo });
     }
+    // Routes are one-to-many (a contract can list several lanes), so origin
+    // and destination each need their own EXISTS — a plain join would
+    // duplicate the contract row per matching route.
+    if (omit !== 'originYardId' && options.originYardId) {
+      qb.andWhere(
+        'EXISTS (SELECT 1 FROM freight.contract_routes cr_o ' +
+          'WHERE cr_o.contract_id = contract.id AND cr_o.deleted_at IS NULL ' +
+          'AND cr_o.origin_yard_id = :originYardId)',
+        { originYardId: options.originYardId },
+      );
+    }
+    if (omit !== 'destinationYardId' && options.destinationYardId) {
+      qb.andWhere(
+        'EXISTS (SELECT 1 FROM freight.contract_routes cr_d ' +
+          'WHERE cr_d.contract_id = contract.id AND cr_d.deleted_at IS NULL ' +
+          'AND cr_d.destination_yard_id = :destinationYardId)',
+        { destinationYardId: options.destinationYardId },
+      );
+    }
+  }
+
+  /**
+   * Facet counts for the filter bar's enum popovers: one `GROUP BY` per
+   * column, each with every OTHER active filter applied but its own
+   * predicate omitted — so selecting `status=SUBMITTED` still shows
+   * `APPROVED: 8` in the status popover (to switch), while the freightType
+   * popover reflects only the SUBMITTED-scoped set. Supersedes
+   * `getStatusCounts`, which ignores the active filter entirely.
+   */
+  async getFacets(options: ContractListFilterOptions): Promise<Record<string, FacetBucket[]>> {
+    return computeFacets(
+      () => this.repository.createQueryBuilder('contract').where('contract.deleted_at IS NULL'),
+      (qb, omit) => this.applyListFilters(qb, options, omit as keyof ContractListFilterOptions),
+      {
+        status: 'contract.status',
+        contractKind: 'contract.contract_kind',
+        freightType: 'contract.freight_type',
+        tradeDirection: 'contract.trade_direction',
+        paymentCurrency: 'contract.payment_currency',
+      },
+    );
   }
 
   // ── Approval steps ─────────────────────────────────────────────────────────
@@ -579,6 +656,31 @@ export class ContractsRepository extends BaseRepository<Contract> {
       .getCount();
   }
 
+  /**
+   * The live shipment booking on a contract, newest first.
+   *
+   * The clearance view historically reached the booking through
+   * `currentCycle().bookingId`, but a cycle row is not created on every path —
+   * an FCFS export booking and a GL drawdown both reach
+   * OPERATION_REQUEST_PENDING without one — so that lookup returns null and the
+   * clearance page loses the booking's status entirely. This resolves it from
+   * the bookings themselves, which is the authoritative link (bookings carry
+   * contract_id), and is used as the fallback when the cycle has no booking.
+   */
+  async findLatestBookingForContract(
+    contractId: string,
+  ): Promise<Booking | null> {
+    return this.dataSource
+      .getRepository(Booking)
+      .createQueryBuilder('b')
+      .where('b.contract_id = :contractId', { contractId })
+      .andWhere('b.status NOT IN (:...terminal)', {
+        terminal: TERMINAL_BOOKING_STATUSES,
+      })
+      .orderBy('b.created_at', 'DESC')
+      .getOne();
+  }
+
   async createReviewNote(
     contractId: string,
     body: string,
diff --git a/apps/edr-freight-api/src/modules/contracts/contracts.service.ts b/apps/edr-freight-api/src/modules/contracts/contracts.service.ts
index 6e170f126..3411414e9 100644
--- a/apps/edr-freight-api/src/modules/contracts/contracts.service.ts
+++ b/apps/edr-freight-api/src/modules/contracts/contracts.service.ts
@@ -7,7 +7,7 @@ import {
 } from '@nestjs/common';
 import { InjectDataSource } from '@nestjs/typeorm';
 import { DataSource } from 'typeorm';
-import { insertWithGeneratedReference } from '@edr/api-common';
+import { insertWithGeneratedReference, logCtx } from '@edr/api-common';
 
 import { YardCountry } from '@edr/types';
 //
@@ -768,6 +768,8 @@ export class ContractsService {
       paymentCurrency: filter.paymentCurrency,
       createdFrom: filter.createdFrom,
       createdTo: filter.createdTo,
+      originYardId: filter.originYardId,
+      destinationYardId: filter.destinationYardId,
       search: filter.search,
       sortBy: filter.sortBy,
       sortOrder: filter.sortOrder,
@@ -789,10 +791,12 @@ export class ContractsService {
       paymentCurrency: filter.paymentCurrency,
       createdFrom: filter.createdFrom,
       createdTo: filter.createdTo,
+      originYardId: filter.originYardId,
+      destinationYardId: filter.destinationYardId,
     };
 
-    const [statusCounts, metrics] = await Promise.all([
-      this.contractsRepository.getStatusCounts(),
+    const [facets, metrics] = await Promise.all([
+      this.contractsRepository.getFacets(listFilter),
       this.contractsRepository.getListSummaryMetrics({
         ...listFilter,
         page,
@@ -801,7 +805,13 @@ export class ContractsService {
       }),
     ]);
 
-    return { metrics, statusCounts };
+    // statusCounts kept for existing callers; now filter-scoped like every
+    // other facet instead of the unfiltered global count `getStatusCounts` gave.
+    const statusCounts = Object.fromEntries(
+      (facets.status ?? []).map((b) => [b.value, b.count]),
+    );
+
+    return { metrics, statusCounts, facets };
   }
 
   /** Get a single contract by ID with relations and signed file URLs. */
@@ -811,6 +821,27 @@ export class ContractsService {
       throw new NotFoundException(`Contract ${id} not found`);
     }
 
+    // Lazy expiry flip: the nightly cron only sweeps once a day, so a
+    // contract can be past contract_valid_until for hours before it shows
+    // EXPIRED. Flip it here so the detail page never shows a stale status.
+    if (isEffectivelyExpired(contract) && contract.status !== 'EXPIRED') {
+      const flipped = await this.contractsRepository.expireIfLapsed(id);
+      if (flipped) {
+        contract.status = 'EXPIRED';
+      }
+    }
+    // Entry state for every contract flow (submit, approve, sign, suspend…) —
+    // see the equivalent in BookingsService.findById.
+    logCtx(
+      {
+        id: contract.id,
+        reference: contract.reference,
+        statusAtEntry: contract.status,
+        companyId: contract.companyId,
+      },
+      { path: "contract" },
+    );
+
     if (contract.files && contract.files.length > 0) {
       contract.files = await Promise.all(
         contract.files.map(async (file: FileRecord) => {
diff --git a/apps/edr-freight-api/src/modules/contracts/dto/contract-list-summary.dto.ts b/apps/edr-freight-api/src/modules/contracts/dto/contract-list-summary.dto.ts
index 78b7d97c6..12e4e5aca 100644
--- a/apps/edr-freight-api/src/modules/contracts/dto/contract-list-summary.dto.ts
+++ b/apps/edr-freight-api/src/modules/contracts/dto/contract-list-summary.dto.ts
@@ -1,4 +1,5 @@
 import { ApiProperty } from '@nestjs/swagger';
+import { FacetBucket } from '../../../common/utils/facets.util';
 
 export class ContractListSummaryMetricsDto {
   @ApiProperty({ example: 42 })
@@ -15,6 +16,23 @@ export class ContractListSummaryDto {
   @ApiProperty({ type: ContractListSummaryMetricsDto })
   metrics!: ContractListSummaryMetricsDto;
 
+  /** @deprecated use `facets.status` — kept for existing callers, computed
+   * from the same filter-scoped query now instead of `getStatusCounts`'s
+   * unfiltered global count. */
   @ApiProperty({ description: 'Count per contract status', type: 'object', additionalProperties: { type: 'number' } })
   statusCounts!: Record<string, number>;
+
+  /**
+   * Per-column value counts for the filter bar's enum popovers, scoped to
+   * every OTHER currently-active filter (each column's own predicate is
+   * omitted from its own count — see `ContractsRepository.getFacets`).
+   * Absent/omitted keys mean the frontend falls back to its static option
+   * list with no counts, never an error.
+   */
+  @ApiProperty({
+    description: 'Facet counts keyed by filter field, for the pill filter bar',
+    type: 'object',
+    additionalProperties: { type: 'array', items: { type: 'object' } },
+  })
+  facets!: Record<string, FacetBucket[]>;
 }
diff --git a/apps/edr-freight-api/src/modules/contracts/dto/create-booking-under-contract.dto.ts b/apps/edr-freight-api/src/modules/contracts/dto/create-booking-under-contract.dto.ts
index 8c1bf763d..f50ca9d4d 100644
--- a/apps/edr-freight-api/src/modules/contracts/dto/create-booking-under-contract.dto.ts
+++ b/apps/edr-freight-api/src/modules/contracts/dto/create-booking-under-contract.dto.ts
@@ -1,4 +1,4 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiHideProperty, ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { Transform, Type } from 'class-transformer';
 import {
   IsArray,
@@ -219,4 +219,46 @@ export class CreateBookingUnderContractDto {
   @IsOptional()
   @IsString()
   notes?: string;
+
+  /**
+   * Internal: set by the manual GL pair-completion path, never by a client.
+   * Suppresses the automatic wagon-consolidation gate for this completion
+   * because the caller links the shared wagon itself. Excluded from the public
+   * schema so a client cannot set it to bypass the gate on a lone booking.
+   */
+  @ApiHideProperty()
+  @IsOptional()
+  @IsBoolean()
+  skipAutoConsolidation?: boolean;
+}
+
+/**
+ * Complete an odd-20ft customs booking together with the partner booking GL
+ * picked to share its wagon. Each half carries its own full completion payload —
+ * the two bookings stay separately priced and separately invoiced, they only
+ * share the wagon.
+ */
+export class CompleteConsolidatedPairDto {
+  @ApiProperty({
+    format: 'uuid',
+    description: 'The booking chosen to share this booking’s wagon.',
+  })
+  @IsUUID()
+  partnerBookingId!: string;
+
+  @ApiProperty({
+    type: CreateBookingUnderContractDto,
+    description: 'Completion payload for the booking in the URL.',
+  })
+  @ValidateNested()
+  @Type(() => CreateBookingUnderContractDto)
+  booking!: CreateBookingUnderContractDto;
+
+  @ApiProperty({
+    type: CreateBookingUnderContractDto,
+    description: 'Completion payload for the partner booking.',
+  })
+  @ValidateNested()
+  @Type(() => CreateBookingUnderContractDto)
+  partner!: CreateBookingUnderContractDto;
 }
diff --git a/apps/edr-freight-api/src/modules/contracts/dto/filter-contract.dto.ts b/apps/edr-freight-api/src/modules/contracts/dto/filter-contract.dto.ts
index 8950e7eb3..a03d52afb 100644
--- a/apps/edr-freight-api/src/modules/contracts/dto/filter-contract.dto.ts
+++ b/apps/edr-freight-api/src/modules/contracts/dto/filter-contract.dto.ts
@@ -61,6 +61,22 @@ export class FilterContractDto {
   @IsIn([...PAYMENT_CURRENCIES])
   paymentCurrency?: string;
 
+  @ApiPropertyOptional({
+    format: 'uuid',
+    description: 'Only contracts with a route starting at this yard.',
+  })
+  @IsOptional()
+  @IsUUID()
+  originYardId?: string;
+
+  @ApiPropertyOptional({
+    format: 'uuid',
+    description: 'Only contracts with a route ending at this yard.',
+  })
+  @IsOptional()
+  @IsUUID()
+  destinationYardId?: string;
+
   @ApiPropertyOptional({ description: 'Filter contracts created on/after this date (ISO)' })
   @IsOptional()
   @IsDateString()
diff --git a/apps/edr-freight-api/src/modules/contracts/phased-clearance.util.ts b/apps/edr-freight-api/src/modules/contracts/phased-clearance.util.ts
index 78d0d6b47..ab2a2b2d4 100644
--- a/apps/edr-freight-api/src/modules/contracts/phased-clearance.util.ts
+++ b/apps/edr-freight-api/src/modules/contracts/phased-clearance.util.ts
@@ -5,6 +5,10 @@ import {
   draftDeclarationFileLabel,
   isDeclarationFileCode,
   isDraftDeclarationFileCode,
+  isDeliveryOrderFileCode,
+  isReleaseOrderFileCode,
+  deliveryOrderFileLabel,
+  releaseOrderFileLabel,
   isImportTransitPermitFileCode,
   isExportTransportFileCode,
   isT1TransportFileCode,
@@ -166,6 +170,98 @@ export async function persistTransitPermitUploads(
   );
 }
 
+/** Require at least one Delivery Order file in the upload batch. */
+export function assertDeliveryOrderFiles(files: Express.Multer.File[]): void {
+  if (files.length === 0) {
+    throw new BadRequestException('No Delivery Order uploaded');
+  }
+}
+
+/** Assign stable `delivery_order_*` codes for multi-file DO uploads. */
+export function normalizeDeliveryOrderFieldNames(
+  files: Express.Multer.File[],
+): Express.Multer.File[] {
+  return files.map((file, index) => ({
+    ...file,
+    fieldname: `delivery_order_${index}`,
+  }));
+}
+
+/** Replace all Delivery Order files on a resource with a new multi-file batch. */
+export async function persistDeliveryOrderUploads(
+  store: DeclarationFileStore,
+  resourceId: string,
+  resource: string,
+  files: Express.Multer.File[],
+): Promise<void> {
+  const normalized = normalizeDeliveryOrderFieldNames(files);
+  assertDeliveryOrderFiles(normalized);
+
+  const existing = await store.findByResource(resourceId, resource);
+  await Promise.all(
+    existing
+      .filter((f) => f.code && isDeliveryOrderFileCode(f.code))
+      .map((f) => store.deleteByCode(resourceId, resource, f.code!)),
+  );
+
+  await Promise.all(
+    normalized.map((file, index) =>
+      store.upload({
+        resourceId,
+        resource,
+        code: `delivery_order_${index}`,
+        file,
+      }),
+    ),
+  );
+}
+
+/** Require at least one Release Order file in the upload batch. */
+export function assertReleaseOrderFiles(files: Express.Multer.File[]): void {
+  if (files.length === 0) {
+    throw new BadRequestException('No Release Order uploaded');
+  }
+}
+
+/** Assign stable `release_order_*` codes for multi-file RO uploads. */
+export function normalizeReleaseOrderFieldNames(
+  files: Express.Multer.File[],
+): Express.Multer.File[] {
+  return files.map((file, index) => ({
+    ...file,
+    fieldname: `release_order_${index}`,
+  }));
+}
+
+/** Replace all Release Order files on a resource with a new multi-file batch. */
+export async function persistReleaseOrderUploads(
+  store: DeclarationFileStore,
+  resourceId: string,
+  resource: string,
+  files: Express.Multer.File[],
+): Promise<void> {
+  const normalized = normalizeReleaseOrderFieldNames(files);
+  assertReleaseOrderFiles(normalized);
+
+  const existing = await store.findByResource(resourceId, resource);
+  await Promise.all(
+    existing
+      .filter((f) => f.code && isReleaseOrderFileCode(f.code))
+      .map((f) => store.deleteByCode(resourceId, resource, f.code!)),
+  );
+
+  await Promise.all(
+    normalized.map((file, index) =>
+      store.upload({
+        resourceId,
+        resource,
+        code: `release_order_${index}`,
+        file,
+      }),
+    ),
+  );
+}
+
 /** Require at least one export transport document in the upload batch. */
 export function assertExportTransportFiles(files: Express.Multer.File[]): void {
   if (files.length === 0) {
@@ -422,6 +518,22 @@ export function buildWorkflowFiles(
       });
     });
 
+    const extraDeliveryOrders = files
+      .filter((f) => f.code && isDeliveryOrderFileCode(f.code) && !included.has(f.code))
+      .sort((a, b) => (a.code ?? '').localeCompare(b.code ?? ''));
+
+    extraDeliveryOrders.forEach((file, index) => {
+      if (!file.code) return;
+      included.add(file.code);
+      out.push({
+        code: file.code,
+        label: deliveryOrderFileLabel(file.code, index),
+        uploadedBy: 'gl_dj',
+        category: 'djibouti',
+        file: { id: file.id, name: file.name, url: file.url },
+      });
+    });
+
     const extraT1 = files
       .filter((f) => f.code && isT1TransportFileCode(f.code) && !included.has(f.code))
       .sort((a, b) => (a.code ?? '').localeCompare(b.code ?? ''));
@@ -440,6 +552,22 @@ export function buildWorkflowFiles(
   }
 
   if (tradeDirection === 'EXPORT') {
+    const extraReleaseOrders = files
+      .filter((f) => f.code && isReleaseOrderFileCode(f.code) && !included.has(f.code))
+      .sort((a, b) => (a.code ?? '').localeCompare(b.code ?? ''));
+
+    extraReleaseOrders.forEach((file, index) => {
+      if (!file.code) return;
+      included.add(file.code);
+      out.push({
+        code: file.code,
+        label: releaseOrderFileLabel(file.code, index),
+        uploadedBy: 'gl_dj',
+        category: 'djibouti',
+        file: { id: file.id, name: file.name, url: file.url },
+      });
+    });
+
     const extraExportTransport = files
       .filter((f) => f.code && isExportTransportFileCode(f.code) && !included.has(f.code))
       .sort((a, b) => (a.code ?? '').localeCompare(b.code ?? ''));
diff --git a/apps/edr-freight-api/src/modules/contracts/shipment-preview-parity.spec.ts b/apps/edr-freight-api/src/modules/contracts/shipment-preview-parity.spec.ts
new file mode 100644
index 000000000..4152ffb30
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/contracts/shipment-preview-parity.spec.ts
@@ -0,0 +1,123 @@
+import { ContractBookingService } from './contract-booking.service';
+import type { Contract } from './entities/contract.entity';
+import type { Booking } from '../bookings/entities/booking.entity';
+import type { CreateBookingUnderContractDto } from './dto/create-booking-under-contract.dto';
+
+/**
+ * The price the customer confirms in the modal comes from validateShipment,
+ * which prices an UNSAVED twin of the booking createUnderContract will write.
+ * Any contract field that reaches the pricing service must be copied onto that
+ * twin — a field left off doesn't fail loudly, it silently drops whole charge
+ * lines from the quote while the created booking is still billed for them.
+ *
+ * The regression this locks: `customsClearingEnabled` was missing, so
+ * BookingPricingService's `if (booking.customsClearingEnabled)` gate never
+ * opened in the preview. Container bookings quoted rail freight alone, then
+ * invoiced rail + customs clearance.
+ */
+describe('shipment preview / created booking parity', () => {
+  const contract = (over: Partial<Contract> = {}): Contract =>
+    ({
+      id: 'c1',
+      freightType: 'CONTAINER',
+      tradeDirection: 'EXPORT',
+      paymentCurrency: 'ETB',
+      serviceTypeId: 'svc1',
+      customsClearingEnabled: true,
+      equipmentReturn: 'NO_RETURN',
+      isHazardous: false,
+      isReefer: false,
+      isGovernment: false,
+      cargoScope: [],
+      firstMilePickupAddress: null,
+      lastMileDeliveryAddress: null,
+      ...over,
+    }) as Contract;
+
+  /**
+   * Run validateShipment against stubbed collaborators and hand back the
+   * booking the pricing service was actually asked to price.
+   */
+  const previewBookingFor = async (c: Contract): Promise<Booking> => {
+    let priced: Booking | null = null;
+
+    const svc = {
+      contractsRepository: { findByIdWithRelations: async () => c },
+      bookingPricingService: {
+        computePriceForBooking: async (b: Booking) => {
+          priced = b;
+          return {
+            lineItems: [],
+            totalAmount: 0,
+            currency: 'ETB',
+            overweightLines: [],
+            hardBlocked: [],
+          };
+        },
+      },
+      ruleEngineService: { capacityViolations: async () => [] },
+      resolveRoute: async () => null,
+      resolveShipmentCurrency: () => 'ETB',
+      resolveCargoTypeId: () => null,
+      resolveShipmentHandlingFlag: () => false,
+      resolveShipmentEquipmentReturn: () => c.equipmentReturn,
+      resolveBulkTons: () => 0,
+      resolveBulkWeightTons: () => 0,
+      resolveContainerTypeForSize: async () => ({ id: 'ct40', sizeFt: 40 }),
+      handlingCounts: () => ({
+        hazardousQuantity: 0,
+        reeferQuantity: 0,
+        returnQuantity: 0,
+      }),
+      max20ftPairDiffTons: async () => 2,
+      findContainerClashesOnTrain: async () => [],
+    };
+
+    const dto = {
+      containers: [
+        {
+          containerSize: '40ft',
+          quantity: 2,
+          units: [{ vgmTons: 10 }, { vgmTons: 10 }],
+        },
+      ],
+    } as unknown as CreateBookingUnderContractDto;
+
+    await (
+      ContractBookingService.prototype as unknown as {
+        validateShipment: (
+          this: unknown,
+          id: string,
+          dto: CreateBookingUnderContractDto,
+        ) => Promise<unknown>;
+      }
+    ).validateShipment.call(svc, 'c1', dto);
+
+    if (!priced) throw new Error('pricing service was never called');
+    return priced;
+  };
+
+  it('prices the preview with customs clearing on when the contract clears', async () => {
+    // Without this the clearance fee is quoted as 0 and billed in full later.
+    const booking = await previewBookingFor(contract());
+    expect(booking.customsClearingEnabled).toBe(true);
+  });
+
+  it('leaves customs clearing off when the contract does not clear', async () => {
+    const booking = await previewBookingFor(
+      contract({ customsClearingEnabled: false }),
+    );
+    expect(booking.customsClearingEnabled).toBe(false);
+  });
+
+  it('carries the contract mile legs so trucking is quoted too', async () => {
+    const booking = await previewBookingFor(
+      contract({
+        firstMilePickupAddress: 'Modjo Dry Port',
+        lastMileDeliveryAddress: 'Djibouti Port',
+      }),
+    );
+    expect(booking.firstMilePickupAddress).toBe('Modjo Dry Port');
+    expect(booking.lastMileDeliveryAddress).toBe('Djibouti Port');
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/drivers/drivers.repository.ts b/apps/edr-freight-api/src/modules/drivers/drivers.repository.ts
index 64be88b61..d6ff938f1 100644
--- a/apps/edr-freight-api/src/modules/drivers/drivers.repository.ts
+++ b/apps/edr-freight-api/src/modules/drivers/drivers.repository.ts
@@ -29,52 +29,6 @@ export class DriversRepository extends BaseRepository<Driver> {
     return this.repository.findOne({ where: { id } });
   }
 
-  async findAllWithFilters(query: {
-    page?: number;
-    pageSize?: number;
-    search?: string;
-    status?: string;
-    sortBy?: string;
-    sortOrder?: 'ASC' | 'DESC';
-  }) {
-    const page = query.page || 1;
-    const pageSize = query.pageSize || 10;
-    const skip = (page - 1) * pageSize;
-
-    let queryBuilder = this.repository.createQueryBuilder('driver');
-
-    if (query.search) {
-      queryBuilder = queryBuilder.where(
-        '(driver.firstName ILIKE :search OR driver.lastName ILIKE :search OR driver.email ILIKE :search OR driver.phoneNumber ILIKE :search OR driver.licenseNumber ILIKE :search)',
-        { search: `%${query.search}%` },
-      );
-    }
-
-    if (query.status) {
-      queryBuilder = queryBuilder.andWhere('driver.status = :status', {
-        status: query.status,
-      });
-    }
-
-    const sortBy = query.sortBy || 'createdAt';
-    const sortOrder = query.sortOrder || 'DESC';
-
-    queryBuilder = queryBuilder
-      .orderBy(`driver.${sortBy}`, sortOrder)
-      .skip(skip)
-      .take(pageSize);
-
-    const [data, total] = await queryBuilder.getManyAndCount();
-
-    return {
-      data,
-      total,
-      page,
-      pageSize,
-      totalPages: Math.ceil(total / pageSize),
-    };
-  }
-
   async createDriver(driverData: any): Promise<Driver> {
     const driver = this.repository.create(driverData);
     const result = await this.repository.save(driver);
diff --git a/apps/edr-freight-api/src/modules/eims/dto/bulk-cancel-eims-registration.dto.ts b/apps/edr-freight-api/src/modules/eims/dto/bulk-cancel-eims-registration.dto.ts
new file mode 100644
index 000000000..c4782782c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/dto/bulk-cancel-eims-registration.dto.ts
@@ -0,0 +1,33 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import { ArrayMinSize, IsArray, IsOptional, IsString, IsUUID, Length, ValidateNested } from "class-validator";
+
+export class BulkCancelEimsItemDto {
+  @ApiProperty({ description: "Invoice ID to cancel." })
+  @IsUUID()
+  invoiceId!: string;
+
+  @ApiProperty({
+    description: 'Numeric reason code, e.g. "1" (Duplicate), "6" (Calculation Error).',
+    example: "1",
+  })
+  @IsString()
+  @Length(1, 8)
+  reasonCode!: string;
+
+  @ApiPropertyOptional({ description: "Free-text cancellation note.", example: "Duplicate submission" })
+  @IsOptional()
+  @IsString()
+  @Length(0, 500)
+  remark?: string;
+}
+
+/** `POST invoices/eims/bulk-cancel` body — see `EimsCancellationService.cancelBulkWithEims`. */
+export class BulkCancelEimsRegistrationDto {
+  @ApiProperty({ type: [BulkCancelEimsItemDto] })
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => BulkCancelEimsItemDto)
+  items!: BulkCancelEimsItemDto[];
+}
diff --git a/apps/edr-freight-api/src/modules/eims/dto/bulk-register-eims-invoice.dto.ts b/apps/edr-freight-api/src/modules/eims/dto/bulk-register-eims-invoice.dto.ts
new file mode 100644
index 000000000..2509275e9
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/dto/bulk-register-eims-invoice.dto.ts
@@ -0,0 +1,11 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { ArrayMinSize, IsArray, IsUUID } from "class-validator";
+
+/** `POST invoices/eims/bulk-register` body — see `EimsBulkRegistrationService.registerBulk`. */
+export class BulkRegisterEimsInvoiceDto {
+  @ApiProperty({ type: [String], description: "Invoice IDs to register with MoR EIMS in one batch." })
+  @IsArray()
+  @ArrayMinSize(1)
+  @IsUUID("4", { each: true })
+  invoiceIds!: string[];
+}
diff --git a/apps/edr-freight-api/src/modules/eims/dto/cancel-eims-registration.dto.ts b/apps/edr-freight-api/src/modules/eims/dto/cancel-eims-registration.dto.ts
new file mode 100644
index 000000000..c1ad0c0a1
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/dto/cancel-eims-registration.dto.ts
@@ -0,0 +1,19 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { IsOptional, IsString, Length } from "class-validator";
+
+/** `POST /v1/cancel` body — `ReasonCode`/`Remark` are the collection's own field names. */
+export class CancelEimsRegistrationDto {
+  @ApiProperty({
+    description: 'Numeric reason code, e.g. "1" (Duplicate), "6" (Calculation Error).',
+    example: "1",
+  })
+  @IsString()
+  @Length(1, 8)
+  reasonCode!: string;
+
+  @ApiPropertyOptional({ description: "Free-text cancellation note.", example: "Duplicate submission" })
+  @IsOptional()
+  @IsString()
+  @Length(0, 500)
+  remark?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/dto/register-sales-receipt.dto.ts b/apps/edr-freight-api/src/modules/eims/dto/register-sales-receipt.dto.ts
new file mode 100644
index 000000000..70681f814
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/dto/register-sales-receipt.dto.ts
@@ -0,0 +1,88 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { IsIn, IsNumber, IsOptional, IsString, Length } from "class-validator";
+
+import { EIMS_MODE_OF_PAYMENT, EimsModeOfPayment } from "../eims-receipt.types";
+
+/**
+ * `POST /v1/receipt/sales` — invoice/amounts/currency/IRN are derived from the invoice; everything
+ * here is what this codebase has no source of truth for, so it is asked of the caller rather than
+ * guessed (payment method, collector, provider references — none of it is modelled on `Invoice`).
+ */
+export class RegisterSalesReceiptDto {
+  @ApiProperty({ enum: EIMS_MODE_OF_PAYMENT, description: "MoR's confirmed ModeOfPayment enum." })
+  @IsIn(EIMS_MODE_OF_PAYMENT)
+  modeOfPayment!: EimsModeOfPayment;
+
+  @ApiPropertyOptional({ description: 'Defaults to "Payment received".' })
+  @IsOptional()
+  @IsString()
+  reason?: string;
+
+  @ApiPropertyOptional({ description: "Overrides the amount collected; defaults to the invoice's paidAmount." })
+  @IsOptional()
+  @IsNumber()
+  collectedAmount?: number;
+
+  @ApiPropertyOptional({ description: "ETB, USD or CAD. Defaults to the invoice's currency." })
+  @IsOptional()
+  @IsString()
+  currency?: string;
+
+  @ApiPropertyOptional({ description: "Required when currency is not ETB." })
+  @IsOptional()
+  @IsNumber()
+  exchangeRate?: number;
+
+  @ApiPropertyOptional({ description: 'Defaults to "FULL" if the invoice balance is 0, else "PARTIAL".' })
+  @IsOptional()
+  @IsString()
+  paymentCoverage?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 200)
+  collectorName?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 200)
+  paymentServiceProvider?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 200)
+  otherPaymentServiceProviderName?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 100)
+  accountNumber?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 100)
+  transactionNumber?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 100)
+  chequeNumber?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 100)
+  cpoNumber?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @Length(0, 100)
+  documentNumber?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/dto/register-withholding-receipt.dto.ts b/apps/edr-freight-api/src/modules/eims/dto/register-withholding-receipt.dto.ts
new file mode 100644
index 000000000..d82f2aa70
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/dto/register-withholding-receipt.dto.ts
@@ -0,0 +1,40 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { IsNumber, IsOptional, IsString, Length } from "class-validator";
+
+/**
+ * `POST /v1/receipt/withholding`. `type`/`preTaxAmount`/`withholdingAmount` are real money/tax
+ * values this codebase has no computed source for (the same "no tax model" gap the invoice mapper
+ * documents) — required from the caller rather than defaulted or derived.
+ */
+export class RegisterWithholdingReceiptDto {
+  @ApiProperty({
+    description: 'WithholdDetail.Type. Only "TWHT" has been observed; not restricted to it.',
+    example: "TWHT",
+  })
+  @IsString()
+  @Length(1, 16)
+  type!: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsNumber()
+  rate?: number;
+
+  @ApiProperty({ description: "Amount the withholding is calculated against." })
+  @IsNumber()
+  preTaxAmount!: number;
+
+  @ApiProperty({ description: "The withheld amount itself." })
+  @IsNumber()
+  withholdingAmount!: number;
+
+  @ApiPropertyOptional({ description: 'Defaults to "Withholding".' })
+  @IsOptional()
+  @IsString()
+  reason?: string;
+
+  @ApiPropertyOptional({ description: "Required when the invoice currency is not ETB." })
+  @IsOptional()
+  @IsNumber()
+  exchangeRate?: number;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/dto/resolve-eims-registration.dto.ts b/apps/edr-freight-api/src/modules/eims/dto/resolve-eims-registration.dto.ts
new file mode 100644
index 000000000..f66e71e16
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/dto/resolve-eims-registration.dto.ts
@@ -0,0 +1,27 @@
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { IsBoolean, IsOptional, IsString, Length } from "class-validator";
+
+/**
+ * Manual reconciliation of a submission that was never acknowledged. Exactly one of the two is
+ * meaningful: supply the IRN confirmed with MoR, or discard the attempt.
+ */
+export class ResolveEimsRegistrationDto {
+  @ApiPropertyOptional({
+    description: "IRN confirmed in the MoR portal. Records the registration and resumes the chain.",
+    example: "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0",
+  })
+  // Not capped at 64: eims_irn is `text` now — a real IRN already overflowed a former
+  // varchar(64) (69 chars). This bound is a sanity ceiling, not a confirmed MoR format.
+  @IsOptional()
+  @IsString()
+  @Length(1, 500)
+  irn?: string;
+
+  @ApiPropertyOptional({
+    description: "Abandon the submission: the invoice is marked FAILED and the chain is unchanged.",
+    example: true,
+  })
+  @IsOptional()
+  @IsBoolean()
+  discard?: boolean;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-auth.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-auth.service.spec.ts
new file mode 100644
index 000000000..1bed1fe29
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-auth.service.spec.ts
@@ -0,0 +1,256 @@
+import { HttpService } from "@nestjs/axios";
+import { ConfigService } from "@nestjs/config";
+import { AxiosError, AxiosHeaders } from "axios";
+import { of, throwError } from "rxjs";
+import { EimsConfig } from "../../config/eims.config";
+import { eimsConfig, eimsToken } from "./eims-test-fixtures";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsSignerService } from "./eims-signer.service";
+
+const CLIENT_SECRET = "super-secret-value";
+const API_KEY = "super-secret-apikey";
+
+const cfg = (over: Partial<EimsConfig> = {}): EimsConfig => eimsConfig(over);
+
+const TOKEN_1 = eimsToken({ jti: "one" });
+const TOKEN_2 = eimsToken({ jti: "two" });
+
+const loginBody = (accessToken: string, expiresIn = 3600) => ({
+  data: { accessToken, refreshToken: "refresh-1", encryptionKey: null, expiresIn },
+  status: "SUCCESS",
+});
+
+/** Stub signer: the real signing path has its own spec and needs no key material here. */
+const signer = {
+  signRequest: <T>(request: T) => ({ request, signature: "SIGNATURE", certificate: "CERTIFICATE" }),
+} as unknown as EimsSignerService;
+
+const build = (post: jest.Mock, config: EimsConfig = cfg()) =>
+  new EimsAuthService(
+    { post } as unknown as HttpService,
+    { get: () => config } as unknown as ConfigService,
+    signer,
+  );
+
+const axiosErr = (status: number, data: unknown) =>
+  new AxiosError("Request failed", undefined, undefined, undefined, {
+    status,
+    statusText: "",
+    data,
+    headers: new AxiosHeaders(),
+    config: { headers: new AxiosHeaders() },
+  });
+
+describe("EimsAuthService.getValidAccessToken", () => {
+  it("posts the signed login envelope to /auth/login with no Authorization header", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+
+    await build(post).getValidAccessToken();
+
+    expect(post).toHaveBeenCalledTimes(1);
+    const [url, body, options] = post.mock.calls[0];
+    expect(url).toBe("https://core.mor.gov.et/auth/login");
+    expect(options.headers).toEqual({ "Content-Type": "application/json" });
+    expect(options.headers.Authorization).toBeUndefined();
+
+    expect(typeof body).toBe("string");
+    expect(JSON.parse(body)).toEqual({
+      request: { clientId: "cid", clientSecret: CLIENT_SECRET, apikey: API_KEY, tin: "0000034558" },
+      signature: "SIGNATURE",
+      certificate: "CERTIFICATE",
+    });
+  });
+
+  it("returns the access token from data.accessToken", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+    await expect(build(post).getValidAccessToken()).resolves.toBe(TOKEN_1);
+  });
+
+  it("reuses a cached token instead of logging in again", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+    const auth = build(post);
+
+    await auth.getValidAccessToken();
+    await expect(auth.getValidAccessToken()).resolves.toBe(TOKEN_1);
+    expect(post).toHaveBeenCalledTimes(1);
+  });
+
+  it("re-authenticates a skew-window before the token actually expires", async () => {
+    const post = jest
+      .fn()
+      .mockReturnValueOnce(of({ data: loginBody(TOKEN_1, 100) })) // 100s ttl, 45s skew ⇒ usable 55s
+      .mockReturnValueOnce(of({ data: loginBody(TOKEN_2) }));
+    const auth = build(post);
+    const start = Date.now();
+    const clock = jest.spyOn(Date, "now");
+
+    try {
+      clock.mockReturnValue(start);
+      await expect(auth.getValidAccessToken()).resolves.toBe(TOKEN_1);
+
+      clock.mockReturnValue(start + 50_000); // inside the window: still cached
+      await expect(auth.getValidAccessToken()).resolves.toBe(TOKEN_1);
+      expect(post).toHaveBeenCalledTimes(1);
+
+      clock.mockReturnValue(start + 56_000); // past ttl-minus-skew, before the real 100s expiry
+      await expect(auth.getValidAccessToken()).resolves.toBe(TOKEN_2);
+      expect(post).toHaveBeenCalledTimes(2);
+    } finally {
+      clock.mockRestore();
+    }
+  });
+
+  it("logs in again after invalidate()", async () => {
+    const post = jest
+      .fn()
+      .mockReturnValueOnce(of({ data: loginBody(TOKEN_1) }))
+      .mockReturnValueOnce(of({ data: loginBody(TOKEN_2) }));
+    const auth = build(post);
+
+    await auth.getValidAccessToken();
+    auth.invalidate();
+    await expect(auth.getValidAccessToken()).resolves.toBe(TOKEN_2);
+    expect(post).toHaveBeenCalledTimes(2);
+  });
+
+  it("performs exactly one login for many concurrent callers", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+    const auth = build(post);
+
+    const tokens = await Promise.all(Array.from({ length: 20 }, () => auth.getValidAccessToken()));
+
+    expect(post).toHaveBeenCalledTimes(1);
+    expect(new Set(tokens)).toEqual(new Set([TOKEN_1]));
+  });
+
+  it("does not put the access token in its own log line", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+    const logged: string[] = [];
+    const auth = build(post);
+    jest
+      .spyOn(auth["logger"], "log")
+      .mockImplementation((message: unknown) => void logged.push(String(message)));
+
+    await auth.getValidAccessToken();
+
+    expect(logged.join("\n")).not.toContain(TOKEN_1);
+    expect(logged.join("\n")).toContain("B0360154BA");
+  });
+
+  it("refuses to call the gateway when EIMS is disabled", async () => {
+    const post = jest.fn();
+    await expect(build(post, cfg({ enabled: false })).getValidAccessToken()).rejects.toThrow(
+      /EIMS integration is disabled/,
+    );
+    expect(post).not.toHaveBeenCalled();
+  });
+
+  it("rejects a 200 response that carries no access token", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: { data: {}, status: "SUCCESS" } }));
+    await expect(build(post).getValidAccessToken()).rejects.toThrow(/returned no accessToken/);
+  });
+
+  it("surfaces gateway errors without leaking credentials or the envelope", async () => {
+    const post = jest.fn().mockReturnValue(
+      throwError(() =>
+        axiosErr(401, {
+          message: "GATEWAY ERROR",
+          statusCode: 401,
+          code: "4400",
+          details: [{ errorMessage: "Invalid Credentials" }],
+          // Fields the gateway must never echo back into our logs or exceptions:
+          signature: "SIGNATURE",
+          certificate: "CERTIFICATE",
+          accessToken: "leaked-token",
+        }),
+      ),
+    );
+
+    const error = (await build(post)
+      .getValidAccessToken()
+      .catch((e: Error) => e)) as Error & { response?: unknown };
+    const serialized = JSON.stringify({ message: error.message, response: error.response });
+
+    expect(error.message).toContain("EIMS login failed (401)");
+    expect(error.message).toContain("Invalid Credentials");
+    for (const secret of [CLIENT_SECRET, API_KEY, "SIGNATURE", "CERTIFICATE", "leaked-token"]) {
+      expect(serialized).not.toContain(secret);
+    }
+  });
+
+  it("maps a timeout to a TIMEOUT failure without a status", async () => {
+    const timeout = new AxiosError("timeout of 30000ms exceeded", "ECONNABORTED");
+    const post = jest.fn().mockReturnValue(throwError(() => timeout));
+
+    await expect(build(post).getValidAccessToken()).rejects.toThrow(/EIMS login timed out/);
+  });
+
+  it("maps an unreachable gateway to a NETWORK failure", async () => {
+    const refused = new AxiosError("connect ECONNREFUSED", "ECONNREFUSED");
+    const post = jest.fn().mockReturnValue(throwError(() => refused));
+
+    await expect(build(post).getValidAccessToken()).rejects.toThrow(/could not reach the gateway/);
+  });
+});
+
+describe("EimsAuthService.getSessionContext", () => {
+  it("takes the source system from the token's claims", async () => {
+    const post = jest
+      .fn()
+      .mockReturnValue(
+        of({ data: loginBody(eimsToken({ systemNumber: "FROM-TOKEN", systemType: "POS" })) }),
+      );
+
+    // Env deliberately left empty: with nothing to check against, the token is simply believed.
+    await expect(
+      build(post, cfg({ systemNumber: "", systemType: "" })).getSessionContext(),
+    ).resolves.toEqual({ systemNumber: "FROM-TOKEN", systemType: "POS" });
+  });
+
+  it("serves the session from the cached login rather than re-authenticating", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+    const auth = build(post);
+
+    await auth.getSessionContext();
+    await expect(auth.getSessionContext()).resolves.toEqual({
+      systemNumber: "B0360154BA",
+      systemType: "SYS",
+    });
+    expect(post).toHaveBeenCalledTimes(1);
+  });
+
+  it.each(["systemNumber", "systemType"])("rejects a token with no %s claim", async (claim) => {
+    const post = jest
+      .fn()
+      .mockReturnValue(of({ data: loginBody(eimsToken({ [claim]: undefined })) }));
+
+    await expect(
+      build(post, cfg({ systemNumber: "", systemType: "" })).getSessionContext(),
+    ).rejects.toThrow(new RegExp(`no ${claim} claim`));
+  });
+
+  it("rejects an access token that is not a decodable JWT", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody("not-a-jwt") }));
+
+    await expect(build(post).getSessionContext()).rejects.toThrow(/not a JWT/);
+  });
+
+  it.each([
+    ["systemNumber", { systemNumber: "SOMETHING-ELSE" }, /EIMS_SYSTEM_NUMBER=B0360154BA/],
+    ["systemType", { systemType: "POS" }, /EIMS_SYSTEM_TYPE=SYS/],
+  ])("fails fast when the configured %s disagrees with the token", async (_name, over, pattern) => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(eimsToken(over)) }));
+
+    // cfg() sets EIMS_SYSTEM_NUMBER=B0360154BA and EIMS_SYSTEM_TYPE=SYS as expectations.
+    await expect(build(post).getSessionContext()).rejects.toThrow(pattern);
+  });
+
+  it("accepts a configured value that matches the token", async () => {
+    const post = jest.fn().mockReturnValue(of({ data: loginBody(TOKEN_1) }));
+
+    await expect(build(post).getSessionContext()).resolves.toEqual({
+      systemNumber: "B0360154BA",
+      systemType: "SYS",
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-auth.service.ts b/apps/edr-freight-api/src/modules/eims/eims-auth.service.ts
new file mode 100644
index 000000000..9e53723d0
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-auth.service.ts
@@ -0,0 +1,212 @@
+import { HttpService } from "@nestjs/axios";
+import { Injectable, Logger } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { firstValueFrom } from "rxjs";
+import { EimsConfig } from "../../config/eims.config";
+import { EimsSignerService, toSignedBody } from "./eims-signer.service";
+import { EimsApiException, EimsConfigException, toEimsApiException } from "./eims.errors";
+import { EimsLoginRequest, EimsLoginResponse } from "./eims.types";
+
+interface TokenCache {
+  accessToken: string;
+  /** Epoch ms, already reduced by the configured skew. */
+  expiresAt: number;
+  session: EimsSessionContext;
+}
+
+/**
+ * Source-system identity, taken from the access token MoR issues us.
+ *
+ * The gateway stamps `systemNumber` and `systemType` into the token for the credentials that
+ * authenticated, which makes the token the authority on them — not our environment file. Anything
+ * we configured locally can only ever disagree with what MoR believes.
+ */
+export interface EimsSessionContext {
+  systemNumber: string;
+  systemType: string;
+}
+
+/** Decode a JWT payload without verifying it: this is MoR's token, signed with MoR's key. */
+function decodeTokenClaims(accessToken: string): Record<string, unknown> {
+  const payload = accessToken.split(".")[1];
+  if (!payload) {
+    throw new EimsApiException("UNKNOWN", "EIMS access token is not a JWT (no payload segment)");
+  }
+  try {
+    return JSON.parse(Buffer.from(payload, "base64url").toString("utf8")) as Record<string, unknown>;
+  } catch (err) {
+    // The token itself is never included — only that its payload would not parse.
+    throw new EimsApiException(
+      "UNKNOWN",
+      `EIMS access token payload could not be decoded: ${(err as Error).message}`,
+    );
+  }
+}
+
+const claimString = (claims: Record<string, unknown>, name: string): string => {
+  const value = claims[name];
+  return typeof value === "string" ? value.trim() : "";
+};
+
+/** Used when the gateway omits `expiresIn`; the observed value is 3600. */
+const FALLBACK_EXPIRES_IN_SECONDS = 3600;
+
+/**
+ * EIMS authentication: signed `POST /auth/login`, plus an in-memory access-token cache.
+ *
+ * Login is the one EIMS call that carries no bearer token, which is why it lives here rather than
+ * in the generic client. Tokens are held in memory only — never persisted, never logged, never
+ * returned to a frontend.
+ */
+@Injectable()
+export class EimsAuthService {
+  private readonly logger = new Logger(EimsAuthService.name);
+  private cache: TokenCache | null = null;
+  private loginInFlight: Promise<string> | null = null;
+
+  constructor(
+    private readonly http: HttpService,
+    private readonly config: ConfigService,
+    private readonly signer: EimsSignerService,
+  ) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  /**
+   * A non-expired access token, logging in if needed. Concurrent callers share one login: the
+   * first caller stores the in-flight promise and everyone else awaits it.
+   */
+  async getValidAccessToken(): Promise<string> {
+    if (this.cache && Date.now() < this.cache.expiresAt) {
+      return this.cache.accessToken;
+    }
+    if (this.loginInFlight) return this.loginInFlight;
+
+    this.loginInFlight = this.login();
+    try {
+      return await this.loginInFlight;
+    } finally {
+      this.loginInFlight = null;
+    }
+  }
+
+  /**
+   * The source-system identity MoR issued this session, refreshing the login if needed.
+   *
+   * This is the authority for `SourceSystem.SystemNumber` / `SystemType`: the gateway stamps both
+   * into the access token for the authenticating credentials, so a local env value could only ever
+   * disagree with it.
+   */
+  async getSessionContext(): Promise<EimsSessionContext> {
+    await this.getValidAccessToken();
+    return this.cache!.session;
+  }
+
+  /** Drop the cached token — called after a 401 so the next request re-authenticates. */
+  invalidate(): void {
+    this.cache = null;
+  }
+
+  /**
+   * Read the source-system claims out of the token, and cross-check anything configured locally.
+   *
+   * `EIMS_SYSTEM_NUMBER` / `EIMS_SYSTEM_TYPE` are optional expectations, not inputs: when set they
+   * are compared and a mismatch fails immediately rather than one silently winning. Registering
+   * under the wrong source system is not something to discover from a rejected invoice.
+   */
+  private readSessionContext(accessToken: string, cfg: EimsConfig): EimsSessionContext {
+    const claims = decodeTokenClaims(accessToken);
+    const systemNumber = claimString(claims, "systemNumber");
+    const systemType = claimString(claims, "systemType");
+
+    const missing = [
+      !systemNumber && "systemNumber",
+      !systemType && "systemType",
+    ].filter(Boolean);
+    if (missing.length > 0) {
+      throw new EimsApiException(
+        "UNKNOWN",
+        `EIMS access token carries no ${missing.join(" or ")} claim; cannot identify the source system`,
+      );
+    }
+
+    const mismatches = [
+      cfg.systemNumber && cfg.systemNumber !== systemNumber
+        ? `EIMS_SYSTEM_NUMBER=${cfg.systemNumber} but the token says ${systemNumber}`
+        : null,
+      cfg.systemType && cfg.systemType !== systemType
+        ? `EIMS_SYSTEM_TYPE=${cfg.systemType} but the token says ${systemType}`
+        : null,
+    ].filter(Boolean);
+    if (mismatches.length > 0) {
+      throw new EimsConfigException(
+        `EIMS source-system configuration disagrees with the issued token: ${mismatches.join("; ")}. ` +
+          "Correct the environment or the credentials — neither value is assumed to win.",
+      );
+    }
+
+    return { systemNumber, systemType };
+  }
+
+  private async login(): Promise<string> {
+    const cfg = this.cfg;
+    if (!cfg.enabled) {
+      throw new EimsConfigException("EIMS integration is disabled; set EIMS_ENABLED=true to use it");
+    }
+
+    const request: EimsLoginRequest = {
+      clientId: cfg.clientId,
+      clientSecret: cfg.clientSecret,
+      apikey: cfg.apiKey,
+      tin: cfg.tin,
+    };
+    const body = toSignedBody(this.signer.signRequest(request));
+
+    let response: EimsLoginResponse;
+    try {
+      const res = await firstValueFrom(
+        this.http.post<EimsLoginResponse>(`${cfg.baseUrl}/auth/login`, body, {
+          headers: { "Content-Type": "application/json" },
+          timeout: cfg.httpTimeoutMs,
+        }),
+      );
+      response = res.data;
+    } catch (err) {
+      const mapped = toEimsApiException(err, "login");
+      this.logger.error(mapped.message);
+      throw mapped;
+    }
+
+    const accessToken = response?.data?.accessToken;
+    if (!accessToken) {
+      throw new EimsApiException("UNKNOWN", "EIMS login returned no accessToken");
+    }
+
+    const expiresIn =
+      Number.isFinite(response.data.expiresIn) && response.data.expiresIn > 0
+        ? response.data.expiresIn
+        : FALLBACK_EXPIRES_IN_SECONDS;
+
+    // TODO: implement `POST /auth/refresh-token` and hold `response.data.refreshToken`. The
+    // collection shows a bare `{refreshToken}` body with no envelope, but it also carries unsigned
+    // examples of calls that do require signing, so whether refresh must be signed is unconfirmed.
+    // Until MoR confirms it, an expired token just triggers a fresh login — `expiresIn` is 3600s,
+    // so that is one extra call an hour.
+    // Reject the session before caching it: a token we cannot identify a source system from is
+    // useless for registration, and a configured expectation that disagrees is a deployment fault.
+    const session = this.readSessionContext(accessToken, cfg);
+
+    this.cache = {
+      accessToken,
+      expiresAt: Date.now() + Math.max(expiresIn * 1000 - cfg.tokenSkewMs, 1000),
+      session,
+    };
+    this.logger.log(
+      `EIMS login succeeded; token cached for ~${expiresIn}s ` +
+        `(system ${session.systemNumber}, type ${session.systemType})`,
+    );
+    return accessToken;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-auto-submit.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-auto-submit.service.spec.ts
new file mode 100644
index 000000000..9b3bb5183
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-auto-submit.service.spec.ts
@@ -0,0 +1,183 @@
+import { BadRequestException } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { DataSource } from "typeorm";
+
+import { EimsConfig } from "../../config/eims.config";
+import { EimsAutoSubmitService } from "./eims-auto-submit.service";
+import { EimsInvoiceRegistrationService } from "./eims-invoice-registration.service";
+import { EimsInvoiceStatus } from "./eims-registration.types";
+import { eimsConfig } from "./eims-test-fixtures";
+
+const INVOICE_ID = "11111111-1111-4111-8111-111111111111";
+
+/**
+ * `query` is answered by shape: the first call is the system-state guard, the second is the
+ * candidate lookup. Keeps the fake honest about the order the service actually asks in.
+ *
+ * `managerRow` backs `dataSource.manager.findOne`/`.update` — only exercised by the
+ * pre-reservation-rejection path (`failStalledCandidate`), so it defaults to the candidate itself.
+ */
+const build = (
+  opts: {
+    cfg?: Partial<EimsConfig>;
+    state?: { in_flight_invoice_id?: string | null; blocked_reason?: string | null };
+    candidate?: { id: string; invoiceNumber: string } | null;
+    register?: jest.Mock;
+    managerRow?: { eimsStatus: EimsInvoiceStatus } | null;
+  } = {},
+) => {
+  const register =
+    opts.register ??
+    jest.fn().mockResolvedValue({ eimsStatus: EimsInvoiceStatus.Registered, eimsIrn: "IRN-1" });
+
+  const query = jest.fn().mockImplementation((sql: string) => {
+    if (sql.includes("eims_system_state")) {
+      return Promise.resolve(
+        opts.state ? [{ in_flight_invoice_id: null, blocked_reason: null, ...opts.state }] : [],
+      );
+    }
+    return Promise.resolve(opts.candidate === undefined ? [] : opts.candidate ? [opts.candidate] : []);
+  });
+
+  const managerUpdate = jest.fn().mockResolvedValue(undefined);
+  const managerFindOne = jest
+    .fn()
+    .mockResolvedValue(opts.managerRow === undefined ? { eimsStatus: EimsInvoiceStatus.NotSubmitted } : opts.managerRow);
+
+  const service = new EimsAutoSubmitService(
+    { query, manager: { findOne: managerFindOne, update: managerUpdate } } as unknown as DataSource,
+    { get: () => eimsConfig({ autoSubmit: true, ...opts.cfg }) } as unknown as ConfigService,
+    { registerInvoiceWithEims: register } as unknown as EimsInvoiceRegistrationService,
+  );
+  return { service, register, query, managerUpdate, managerFindOne };
+};
+
+const candidate = { id: INVOICE_ID, invoiceNumber: "INV-20260807-00006" };
+
+describe("EimsAutoSubmitService.tick", () => {
+  it("files the oldest eligible invoice through the registration service", async () => {
+    const { service, register } = build({ candidate });
+
+    await service.tick();
+
+    expect(register).toHaveBeenCalledTimes(1);
+    expect(register).toHaveBeenCalledWith(INVOICE_ID);
+  });
+
+  it("files nothing when EIMS_AUTO_SUBMIT is off", async () => {
+    const { service, register, query } = build({ cfg: { autoSubmit: false }, candidate });
+
+    await service.tick();
+
+    expect(register).not.toHaveBeenCalled();
+    expect(query).not.toHaveBeenCalled();
+  });
+
+  it("files nothing when EIMS itself is disabled, even with auto-submit on", async () => {
+    const { service, register, query } = build({ cfg: { enabled: false }, candidate });
+
+    await service.tick();
+
+    expect(register).not.toHaveBeenCalled();
+    expect(query).not.toHaveBeenCalled();
+  });
+
+  it("does not submit while another submission is in flight", async () => {
+    const { service, register } = build({
+      state: { in_flight_invoice_id: "22222222-2222-4222-8222-222222222222" },
+      candidate,
+    });
+
+    await service.tick();
+
+    expect(register).not.toHaveBeenCalled();
+  });
+
+  it("does not submit while the system number is blocked", async () => {
+    const { service, register } = build({
+      state: { blocked_reason: "never acknowledged" },
+      candidate,
+    });
+
+    await service.tick();
+
+    expect(register).not.toHaveBeenCalled();
+  });
+
+  it("does nothing when no invoice is eligible", async () => {
+    const { service, register } = build({ candidate: null });
+
+    await service.tick();
+
+    expect(register).not.toHaveBeenCalled();
+  });
+
+  it("asks only for NOT_SUBMITTED invoices, so UNKNOWN and FAILED are never retried", async () => {
+    const { service, query } = build({ candidate });
+
+    await service.tick();
+
+    const [sql, params] = query.mock.calls.find(([s]: [string]) => s.includes("freight.invoices"))!;
+    expect(sql).toContain("i.eims_status = $1");
+    expect(params[0]).toBe(EimsInvoiceStatus.NotSubmitted);
+    expect(sql).toContain("i.issued_at IS NOT NULL");
+  });
+
+  it("survives a filing failure so the job keeps running", async () => {
+    const register = jest.fn().mockRejectedValue(new Error("EIMS register failed (406)"));
+    const { service } = build({ candidate, register });
+
+    await expect(service.tick()).resolves.toBeUndefined();
+    expect(register).toHaveBeenCalledTimes(1);
+  });
+
+  it("drains a pre-reservation rejection so the sweep advances, without touching the DB row's own reservation state", async () => {
+    const register = jest
+      .fn()
+      .mockRejectedValue(new BadRequestException({ code: "EIMS_RELATED_INVOICE_REQUIRED", message: "no related invoice" }));
+    const { service, managerFindOne, managerUpdate } = build({ candidate, register });
+
+    await expect(service.tick()).resolves.toBeUndefined();
+
+    expect(managerFindOne).toHaveBeenCalledTimes(1);
+    expect(managerUpdate).toHaveBeenCalledWith(
+      expect.anything(),
+      INVOICE_ID,
+      expect.objectContaining({
+        eimsStatus: EimsInvoiceStatus.Failed,
+        eimsLastError: expect.objectContaining({ message: "no related invoice" }),
+      }),
+    );
+  });
+
+  it("leaves a row alone if it already moved past NOT_SUBMITTED by the time the rejection is handled", async () => {
+    const register = jest
+      .fn()
+      .mockRejectedValue(new BadRequestException({ code: "EIMS_RELATED_INVOICE_REQUIRED", message: "no related invoice" }));
+    const { service, managerUpdate } = build({
+      candidate,
+      register,
+      managerRow: { eimsStatus: EimsInvoiceStatus.Submitting },
+    });
+
+    await expect(service.tick()).resolves.toBeUndefined();
+
+    expect(managerUpdate).not.toHaveBeenCalled();
+  });
+
+  it("does not start a second tick while one is still filing", async () => {
+    let release: () => void = () => {};
+    const register = jest.fn().mockImplementation(
+      () => new Promise((resolve) => (release = () => resolve({ eimsStatus: "REGISTERED" }))),
+    );
+    const { service } = build({ candidate, register });
+
+    const first = service.tick();
+    await new Promise((r) => setImmediate(r));
+    await service.tick(); // overlapping tick, must be a no-op
+
+    expect(register).toHaveBeenCalledTimes(1);
+    release();
+    await first;
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-auto-submit.service.ts b/apps/edr-freight-api/src/modules/eims/eims-auto-submit.service.ts
new file mode 100644
index 000000000..bad283817
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-auto-submit.service.ts
@@ -0,0 +1,169 @@
+import { BadRequestException, Injectable, Logger } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { Cron } from "@nestjs/schedule";
+import { InjectDataSource } from "@nestjs/typeorm";
+import { DataSource } from "typeorm";
+import type { QueryDeepPartialEntity } from "typeorm/query-builder/QueryPartialEntity.js";
+
+import { EimsConfig } from "../../config/eims.config";
+import { Invoice } from "../billing/entities/invoice.entity";
+import { EimsInvoiceRegistrationService } from "./eims-invoice-registration.service";
+import { EimsInvoiceError, EimsInvoiceStatus } from "./eims-registration.types";
+
+/**
+ * Files issued invoices with MoR EIMS on a timer.
+ *
+ * Invoices are produced by the freight workflow rather than by a person, so this — not the manual
+ * endpoint — is the production path. It is a sweep rather than a hook on the eleven places an
+ * invoice can be created or issued, which buys three things: the workflow is untouched, the HTTP
+ * call is by construction outside the invoice's transaction, and an invoice missed through a crash
+ * or a restart is picked up on the next tick.
+ *
+ * `invoices.eims_status` is the queue — nothing new is persisted. Only `NOT_SUBMITTED` is eligible:
+ * `UNKNOWN` must never be retried automatically (the document may already be filed), and `FAILED`
+ * waits for an explicit retry policy rather than a timer's guess.
+ *
+ * Off unless **both** `EIMS_ENABLED` and `EIMS_AUTO_SUBMIT` are true. Enabling it starts filing
+ * real documents with the tax authority, and a registration cannot be undone from this side.
+ */
+@Injectable()
+export class EimsAutoSubmitService {
+  private readonly logger = new Logger(EimsAutoSubmitService.name);
+  /** Guards against a tick starting while the previous one is still filing. */
+  private running = false;
+
+  constructor(
+    @InjectDataSource() private readonly dataSource: DataSource,
+    private readonly config: ConfigService,
+    private readonly registration: EimsInvoiceRegistrationService,
+  ) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  /**
+   * One invoice per tick.
+   *
+   * Deliberately not a batch: each filing consumes a counter and advances the IRN chain, an
+   * ambiguous result blocks the system number until a human resolves it, and a misconfiguration
+   * should cost one rejected document rather than a burst of them.
+   */
+  @Cron(process.env.EIMS_AUTO_SUBMIT_CRON ?? "0 */5 * * * *", { name: "eims-auto-submit" })
+  async tick(): Promise<void> {
+    const cfg = this.cfg;
+    if (!cfg.enabled || !cfg.autoSubmit) return;
+    if (this.running) return;
+
+    this.running = true;
+    try {
+      // Rule of the chain: nothing may be filed while a submission is in flight or the system is
+      // blocked. The reservation would refuse anyway — checking first keeps the log quiet and
+      // avoids burning a tick on a guaranteed conflict.
+      const blocked = await this.systemBlockReason();
+      if (blocked) {
+        this.logger.warn(`EIMS auto-submit paused: ${blocked}`);
+        return;
+      }
+
+      const candidate = await this.nextCandidate();
+      if (!candidate) return;
+
+      try {
+        const view = await this.registration.registerInvoiceWithEims(candidate.id);
+        this.logger.log(
+          `EIMS auto-submit: invoice ${candidate.invoiceNumber} -> ${view.eimsStatus}` +
+            (view.eimsIrn ? ` (IRN ${view.eimsIrn})` : ""),
+        );
+      } catch (err) {
+        // Every other failure path inside registerInvoiceWithEims persists FAILED/UNKNOWN itself
+        // (settleFailure) before throwing. A BadRequestException is the one exception: it is only
+        // ever thrown *before* a reservation is taken (config assertion, DEB/CRE validation), so
+        // nothing is persisted — left alone, this candidate is picked again next tick forever, a
+        // permanent head-of-line block on every invoice behind it. Drain it instead.
+        if (err instanceof BadRequestException) {
+          await this.failStalledCandidate(candidate, err);
+        } else {
+          throw err;
+        }
+      }
+    } catch (err) {
+      // Never let a filing failure kill the job. The outcome is already persisted on the invoice
+      // (FAILED or UNKNOWN with the gateway's own message, or drained by failStalledCandidate
+      // above), and a blocked system number stops the next tick at the guard above.
+      this.logger.error(`EIMS auto-submit tick failed: ${(err as Error).message}`);
+    } finally {
+      this.running = false;
+    }
+  }
+
+  /**
+   * Mark a pre-reservation rejection as FAILED so the sweep advances past it — but only if the
+   * invoice is still exactly where this tick left it. A reservation's own transactions
+   * (SUBMITTING/UNKNOWN, or a system-wide block) are authoritative; this must never clobber them,
+   * so the status is re-read fresh rather than trusted from the stale `candidate` row.
+   */
+  private async failStalledCandidate(
+    candidate: { id: string; invoiceNumber: string },
+    err: BadRequestException,
+  ): Promise<void> {
+    const current = await this.dataSource.manager.findOne(Invoice, { where: { id: candidate.id } });
+    if (current?.eimsStatus !== EimsInvoiceStatus.NotSubmitted) {
+      this.logger.warn(
+        `EIMS auto-submit: invoice ${candidate.invoiceNumber} rejected before reservation, but is ` +
+          `no longer NOT_SUBMITTED (${current?.eimsStatus ?? "not found"}) — leaving state untouched.`,
+      );
+      return;
+    }
+    const lastError: EimsInvoiceError = { kind: "VALIDATION", message: err.message, at: new Date().toISOString() };
+    await this.dataSource.manager.update(Invoice, candidate.id, {
+      eimsStatus: EimsInvoiceStatus.Failed,
+      eimsLastError: lastError,
+    } as QueryDeepPartialEntity<Invoice>);
+    this.logger.error(
+      `EIMS auto-submit: invoice ${candidate.invoiceNumber} rejected before reservation: ${err.message}`,
+    );
+  }
+
+  /** Why filing is currently impossible for this system number, or null when it is free. */
+  private async systemBlockReason(): Promise<string | null> {
+    const rows: { in_flight_invoice_id: string | null; blocked_reason: string | null }[] =
+      await this.dataSource.query(
+        `SELECT in_flight_invoice_id, blocked_reason
+           FROM freight.eims_system_state
+          WHERE system_number = $1 AND deleted_at IS NULL
+          LIMIT 1`,
+        [this.cfg.systemNumber],
+      );
+    const state = rows[0];
+    if (!state) return null;
+    if (state.blocked_reason) return state.blocked_reason;
+    if (state.in_flight_invoice_id) {
+      return `a submission for invoice ${state.in_flight_invoice_id} is still in flight`;
+    }
+    return null;
+  }
+
+  /**
+   * Oldest never-submitted invoice that is issued, still inside MoR's document-age window, and
+   * carries at least one line.
+   */
+  private async nextCandidate(): Promise<{ id: string; invoiceNumber: string } | null> {
+    const rows: { id: string; invoiceNumber: string }[] = await this.dataSource.query(
+      `SELECT i.id, i.invoice_number AS "invoiceNumber"
+         FROM freight.invoices i
+        WHERE i.eims_status = $1
+          AND i.issued_at IS NOT NULL
+          AND i.deleted_at IS NULL
+          AND i.issued_at > now() - ($2 || ' days')::interval
+          AND EXISTS (
+                SELECT 1 FROM freight.invoice_lines l
+                 WHERE l.invoice_id = i.id AND l.deleted_at IS NULL
+              )
+        ORDER BY i.issued_at ASC
+        LIMIT 1`,
+      [EimsInvoiceStatus.NotSubmitted, this.cfg.autoSubmitMaxAgeDays],
+    );
+    return rows[0] ?? null;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-bulk-registration.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-bulk-registration.service.spec.ts
new file mode 100644
index 000000000..459ee8f71
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-bulk-registration.service.spec.ts
@@ -0,0 +1,359 @@
+import { BadRequestException, ConflictException } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { DataSource } from "typeorm";
+
+import { Invoice } from "../billing/entities/invoice.entity";
+import { NotificationsService } from "../notifications/notifications.service";
+import { eimsConfig, eimsInvoiceConfig } from "./eims-test-fixtures";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsBulkRegistrationService } from "./eims-bulk-registration.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsSellerCacheService } from "./eims-seller-cache.service";
+import { EimsSystemState } from "./entities/eims-system-state.entity";
+import { EimsApiException } from "./eims.errors";
+import { EimsInvoiceStatus } from "./eims-registration.types";
+import { buildEimsSeller } from "./eims-invoice-context";
+
+const SYSTEM_NUMBER = "B0360154BA";
+const INVOICE_A = "11111111-1111-4111-8111-111111111111";
+const INVOICE_B = "22222222-2222-4222-8222-222222222222";
+const CONVERSATION_ID = "2345678901-1735900502800-c04f8dd6-e6e2-4198-b871-c6e504fc14f5";
+
+const invoiceRow = (over: Partial<Invoice> = {}): Invoice =>
+  ({
+    id: INVOICE_A,
+    invoiceNumber: "INV-20260807-00001",
+    currency: "ETB",
+    companyId: "company-1",
+    issuedAt: new Date(2026, 7, 7, 9, 5, 3),
+    totalAmount: "10000.00",
+    eimsStatus: EimsInvoiceStatus.NotSubmitted,
+    eimsIrn: null,
+    eimsDocumentType: "INV",
+    eimsBulkConversationId: null,
+    company: {
+      name: "ABC Trading PLC",
+      tin: "0999930000",
+      vatNumber: "123475885858",
+      phone: "0912345678",
+      region: "13",
+      zone: "SHA",
+      woreda: "574",
+      kebele: "03",
+      houseNo: "NEW",
+      country: "Ethiopia",
+    },
+    ...over,
+  }) as unknown as Invoice;
+
+const LINES = (id: string) => [
+  {
+    invoiceId: id,
+    chargeType: "RAIL_FREIGHT",
+    description: "Addis to Djibouti",
+    quantity: "1.00",
+    unitRate: "10000.00",
+    amount: "10000.00",
+  },
+];
+
+/** In-memory stand-in covering the query/manager surface this service actually calls. */
+class FakeDb {
+  invoices = new Map<string, Invoice>();
+  state: EimsSystemState;
+  companyContact: { phone: string | null; email: string | null } | null = null;
+
+  constructor(invoices: Invoice[], state: Partial<EimsSystemState> = {}) {
+    for (const inv of invoices) this.invoices.set(inv.id, inv);
+    this.state = {
+      id: "state-1",
+      systemNumber: SYSTEM_NUMBER,
+      nextInvoiceCounter: 1,
+      nextDocumentNumber: 1,
+      previousIrn: null,
+      inFlightInvoiceId: null,
+      inFlightCounter: null,
+      inFlightDocumentNumber: null,
+      inFlightConversationId: null,
+      blockedReason: null,
+      ...state,
+    } as EimsSystemState;
+  }
+
+  private matches(entity: Invoice | EimsSystemState, where: Record<string, unknown>): boolean {
+    return Object.entries(where).every(([key, value]) => (entity as never)[key] === value);
+  }
+
+  private queryBuilder(entityCtor: unknown) {
+    let where: Record<string, unknown> = {};
+    const builder = {
+      setLock: () => builder,
+      where: (_clause: string, params: Record<string, unknown>) => {
+        where = { ...where, ...this.normalizeParams(params) };
+        return builder;
+      },
+      andWhere: (_clause: string, params: Record<string, unknown>) => {
+        where = { ...where, ...this.normalizeParams(params) };
+        return builder;
+      },
+      getOne: async () => this.find(entityCtor, where)[0] ?? null,
+      getMany: async () => this.find(entityCtor, where),
+    };
+    return builder;
+  }
+
+  private normalizeParams(params: Record<string, unknown>): Record<string, unknown> {
+    // Test-only mapping from the SQL param names used in the service's own queries to entity fields.
+    const map: Record<string, string> = {
+      invoiceId: "id",
+      systemNumber: "systemNumber",
+      id: "eimsBulkConversationId",
+    };
+    const out: Record<string, unknown> = {};
+    for (const [k, v] of Object.entries(params)) out[map[k] ?? k] = v;
+    return out;
+  }
+
+  private find(entityCtor: unknown, where: Record<string, unknown>): Array<Invoice | EimsSystemState> {
+    const isState = entityCtor === EimsSystemState;
+    const pool: Array<Invoice | EimsSystemState> = isState ? [this.state] : [...this.invoices.values()];
+    return pool.filter((e) => this.matches(e, where));
+  }
+
+  private manager = {
+    createQueryBuilder: (entityCtor: unknown) => this.queryBuilder(entityCtor),
+    query: async () => [],
+    findOne: async (entityCtor: unknown, options: { where: Record<string, unknown> }) =>
+      this.find(entityCtor, options.where)[0] ?? null,
+    update: async (entityCtor: unknown, idOrWhere: string | Record<string, unknown>, patch: Record<string, unknown>) => {
+      const targets =
+        typeof idOrWhere === "string"
+          ? this.find(entityCtor, { id: idOrWhere })
+          : this.find(entityCtor, idOrWhere);
+      for (const t of targets) Object.assign(t, patch);
+      return { affected: targets.length };
+    },
+    getRepository: (entityCtor: unknown) => ({
+      findOne: async (options: { where: { id: string } }) => this.find(entityCtor, { id: options.where.id })[0] ?? null,
+    }),
+  };
+
+  asDataSource(): DataSource {
+    return {
+      manager: this.manager,
+      // Routed by SQL text: the lines lookup and sendCompanyChannels' contact lookup share this
+      // one entry point in the real DataSource.
+      query: async (sql: string) => {
+        if (sql.includes("invoice_lines")) {
+          return [...this.invoices.keys()].flatMap((id) => LINES(id));
+        }
+        return this.companyContact ? [this.companyContact] : [];
+      },
+      transaction: async (body: (m: unknown) => Promise<unknown>) => body(this.manager),
+      getRepository: () => ({
+        find: async (options: { where: { id: { value: string[] } } }) => {
+          const ids = options.where.id.value ?? [];
+          return ids.map((id: string) => this.invoices.get(id)).filter(Boolean);
+        },
+        createQueryBuilder: (alias: string) => {
+          void alias;
+          return this.queryBuilder(Invoice);
+        },
+        count: async (options: { where: Record<string, unknown> }) => this.find(Invoice, options.where).length,
+      }),
+    } as unknown as DataSource;
+  }
+}
+
+const build = (db: FakeDb, postSigned: jest.Mock, directSend: jest.Mock = jest.fn().mockResolvedValue(undefined)) =>
+  new EimsBulkRegistrationService(
+    db.asDataSource(),
+    { get: () => eimsConfig({ invoice: eimsInvoiceConfig() }) } as unknown as ConfigService,
+    { postSigned } as unknown as EimsClientService,
+    { getSessionContext: async () => ({ systemNumber: SYSTEM_NUMBER, systemType: "SYS" }) } as unknown as EimsAuthService,
+    { directSend } as unknown as NotificationsService,
+    { getSellerDetails: (c: unknown) => buildEimsSeller(c as never) } as unknown as EimsSellerCacheService,
+  );
+
+const accepted = (conversationId = CONVERSATION_ID) => ({ conversationId, status: 202 });
+
+describe("EimsBulkRegistrationService.registerBulk", () => {
+  it("reserves sequential counters, sends one signed array, and claims MoR's real conversation id", async () => {
+    const db = new FakeDb(
+      [invoiceRow(), invoiceRow({ id: INVOICE_B, invoiceNumber: "INV-20260807-00002" })],
+      { nextInvoiceCounter: 5, nextDocumentNumber: 5, previousIrn: "prev-irn" },
+    );
+    const postSigned = jest.fn().mockResolvedValue(accepted());
+
+    const result = await build(db, postSigned).registerBulk([INVOICE_A, INVOICE_B]);
+
+    expect(result).toEqual({ conversationId: CONVERSATION_ID, accepted: [INVOICE_A, INVOICE_B], alreadyRegistered: [] });
+    const [, request] = postSigned.mock.calls[0];
+    expect(request).toHaveLength(2);
+    expect(request[0].SourceSystem.InvoiceCounter).toBe(5);
+    expect(request[0].DocumentDetails.DocumentNumber).toBe("5");
+    expect(request[0].ReferenceDetails.PreviousIrn).toBe("prev-irn");
+    expect(request[1].SourceSystem.InvoiceCounter).toBe(6);
+    // Only the first item in a bulk batch chains — the rest have no IRN to reference yet.
+    expect(request[1].ReferenceDetails.PreviousIrn).toBe("");
+
+    expect(db.invoices.get(INVOICE_A)).toMatchObject({ eimsStatus: EimsInvoiceStatus.Submitting, eimsBulkConversationId: CONVERSATION_ID });
+    expect(db.invoices.get(INVOICE_B)).toMatchObject({ eimsStatus: EimsInvoiceStatus.Submitting, eimsBulkConversationId: CONVERSATION_ID });
+    expect(db.state.nextInvoiceCounter).toBe(7);
+    expect(db.state.inFlightConversationId).toBe(CONVERSATION_ID);
+  });
+
+  it("skips an already-registered invoice, without consuming a counter for it", async () => {
+    const db = new FakeDb([
+      invoiceRow({ eimsIrn: "already-irn", eimsStatus: EimsInvoiceStatus.Registered }),
+      invoiceRow({ id: INVOICE_B, invoiceNumber: "INV-20260807-00002" }),
+    ]);
+    const postSigned = jest.fn().mockResolvedValue(accepted());
+
+    const result = await build(db, postSigned).registerBulk([INVOICE_A, INVOICE_B]);
+
+    expect(result.alreadyRegistered).toEqual([INVOICE_A]);
+    expect(result.accepted).toEqual([INVOICE_B]);
+    const [, request] = postSigned.mock.calls[0];
+    expect(request).toHaveLength(1);
+  });
+
+  it("refuses the whole batch — no reservation, no HTTP call — when a DEB note has no registered original", async () => {
+    const db = new FakeDb([
+      invoiceRow({ eimsDocumentType: "DEB", relatedInvoice: { eimsIrn: null, invoiceNumber: "INV-orig" } as never }),
+    ]);
+    const postSigned = jest.fn();
+
+    await expect(build(db, postSigned).registerBulk([INVOICE_A])).rejects.toBeInstanceOf(BadRequestException);
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(db.state.inFlightConversationId).toBeNull();
+  });
+
+  it("refuses when a single-invoice submission is already in flight", async () => {
+    const db = new FakeDb([invoiceRow()], { inFlightInvoiceId: "some-other-invoice" });
+    await expect(build(db, jest.fn()).registerBulk([INVOICE_A])).rejects.toBeInstanceOf(ConflictException);
+  });
+
+  it("refuses when another bulk batch is already in flight", async () => {
+    const db = new FakeDb([invoiceRow()], { inFlightConversationId: "other-conversation" });
+    await expect(build(db, jest.fn()).registerBulk([INVOICE_A])).rejects.toBeInstanceOf(ConflictException);
+  });
+
+  it("a deterministic rejection rolls back the whole block and clears the in-flight marker", async () => {
+    const db = new FakeDb(
+      [invoiceRow(), invoiceRow({ id: INVOICE_B, invoiceNumber: "INV-20260807-00002" })],
+      { nextInvoiceCounter: 5, nextDocumentNumber: 5 },
+    );
+    const postSigned = jest.fn().mockRejectedValue(new EimsApiException("SCHEMA_VALIDATION", "bad", 400));
+
+    await expect(build(db, postSigned).registerBulk([INVOICE_A, INVOICE_B])).rejects.toBeInstanceOf(EimsApiException);
+
+    expect(db.state.nextInvoiceCounter).toBe(5);
+    expect(db.state.nextDocumentNumber).toBe(5);
+    expect(db.state.inFlightConversationId).toBeNull();
+    expect(db.invoices.get(INVOICE_A)?.eimsStatus).toBe(EimsInvoiceStatus.Failed);
+    expect(db.invoices.get(INVOICE_A)?.eimsBulkConversationId).toBeNull();
+  });
+
+  it("an ambiguous failure blocks the system number and leaves counters consumed", async () => {
+    const db = new FakeDb([invoiceRow()], { nextInvoiceCounter: 5, nextDocumentNumber: 5 });
+    const postSigned = jest.fn().mockRejectedValue(new EimsApiException("TIMEOUT", "timed out"));
+
+    await expect(build(db, postSigned).registerBulk([INVOICE_A])).rejects.toBeInstanceOf(EimsApiException);
+
+    expect(db.state.nextInvoiceCounter).toBe(6);
+    expect(db.state.blockedReason).toMatch(/never acknowledged/);
+    expect(db.invoices.get(INVOICE_A)?.eimsStatus).toBe(EimsInvoiceStatus.Unknown);
+  });
+
+  it("refuses an empty invoice list", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    await expect(build(db, jest.fn()).registerBulk([])).rejects.toBeInstanceOf(BadRequestException);
+  });
+});
+
+describe("EimsBulkRegistrationService.handleBulkCallback", () => {
+  const submittingRow = (over: Partial<Invoice>) =>
+    invoiceRow({
+      eimsStatus: EimsInvoiceStatus.Submitting,
+      eimsBulkConversationId: CONVERSATION_ID,
+      ...over,
+    });
+
+  it("settles a mixed success/error callback, advancing previousIrn to the last accepted item", async () => {
+    const db = new FakeDb(
+      [
+        submittingRow({ eimsInvoiceCounter: 5, eimsDocumentNumber: "5" }),
+        submittingRow({ id: INVOICE_B, invoiceNumber: "INV-20260807-00002", eimsInvoiceCounter: 6, eimsDocumentNumber: "6" }),
+      ],
+      { inFlightConversationId: CONVERSATION_ID },
+    );
+
+    const results = await build(db, jest.fn()).handleBulkCallback([
+      { irn: "irn-a", status: "A", documentNumber: "5" },
+      { ruleError: [{ portion: "DocumentDetails", errorMessage: ["bad date"] }], status: "ERROR", docNo: "6" },
+      { conversionId: CONVERSATION_ID },
+    ]);
+
+    expect(db.invoices.get(INVOICE_A)).toMatchObject({ eimsStatus: EimsInvoiceStatus.Registered, eimsIrn: "irn-a" });
+    expect(db.invoices.get(INVOICE_B)).toMatchObject({ eimsStatus: EimsInvoiceStatus.Failed });
+    expect(db.state.previousIrn).toBe("irn-a");
+    expect(db.state.inFlightConversationId).toBeNull();
+    expect(results).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ invoiceId: INVOICE_A, success: true, irn: "irn-a" }),
+        expect.objectContaining({ invoiceId: INVOICE_B, success: false }),
+      ]),
+    );
+  });
+
+  it("ignores a callback for an unknown or already-settled conversation", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const results = await build(db, jest.fn()).handleBulkCallback([
+      { irn: "irn-x", status: "A", documentNumber: "1" },
+      { conversionId: "no-such-conversation" },
+    ]);
+    expect(results).toEqual([]);
+  });
+
+  it("does not clear the in-flight marker while another invoice in the batch is still submitting", async () => {
+    const db = new FakeDb(
+      [
+        submittingRow({ eimsInvoiceCounter: 5, eimsDocumentNumber: "5" }),
+        submittingRow({ id: INVOICE_B, invoiceNumber: "INV-20260807-00002", eimsInvoiceCounter: 6, eimsDocumentNumber: "6" }),
+      ],
+      { inFlightConversationId: CONVERSATION_ID },
+    );
+
+    // Callback only reports on one of the two invoices in this batch.
+    await build(db, jest.fn()).handleBulkCallback([
+      { irn: "irn-a", status: "A", documentNumber: "5" },
+      { conversionId: CONVERSATION_ID },
+    ]);
+
+    expect(db.state.inFlightConversationId).toBe(CONVERSATION_ID);
+  });
+
+  it("reports the current state without re-settling an invoice that already resolved", async () => {
+    const db = new FakeDb(
+      [
+        invoiceRow({
+          eimsStatus: EimsInvoiceStatus.Registered,
+          eimsIrn: "irn-a",
+          eimsDocumentNumber: "1",
+          eimsBulkConversationId: CONVERSATION_ID,
+        }),
+      ],
+      { inFlightConversationId: CONVERSATION_ID },
+    );
+
+    const results = await build(db, jest.fn()).handleBulkCallback([
+      { irn: "irn-a", status: "A", documentNumber: "1" },
+      { conversionId: CONVERSATION_ID },
+    ]);
+
+    expect(results).toEqual([
+      expect.objectContaining({ invoiceId: INVOICE_A, success: true, message: expect.stringContaining("Already settled") }),
+    ]);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-bulk-registration.service.ts b/apps/edr-freight-api/src/modules/eims/eims-bulk-registration.service.ts
new file mode 100644
index 000000000..4638d3555
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-bulk-registration.service.ts
@@ -0,0 +1,518 @@
+import { randomUUID } from "node:crypto";
+import { BadRequestException, ConflictException, Injectable, Logger, NotFoundException } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { InjectDataSource } from "@nestjs/typeorm";
+import { DataSource, EntityManager, In } from "typeorm";
+import type { QueryDeepPartialEntity } from "typeorm/query-builder/QueryPartialEntity.js";
+
+import { EimsConfig } from "../../config/eims.config";
+import { Invoice } from "../billing/entities/invoice.entity";
+import { EimsDocumentType, EimsMapperLine, toEimsInvoice } from "../billing/eims-invoice.mapper";
+import { sendCompanyChannels } from "../notifications/notify-company.util";
+import { NotificationsService } from "../notifications/notifications.service";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsApiException, EimsConfigException } from "./eims.errors";
+import { EimsSellerCacheService } from "./eims-seller-cache.service";
+import { EimsSystemState } from "./entities/eims-system-state.entity";
+import { assertEimsInvoiceConfig, buildEimsContext } from "./eims-invoice-context";
+import {
+  EimsBulkCallbackItem,
+  EimsBulkRegisterAcceptedResponse,
+  EimsBulkRegisterItemResult,
+  EimsBulkRegisterRequest,
+  EimsInvoiceError,
+  EimsInvoiceStatus,
+} from "./eims-registration.types";
+
+const DETERMINISTIC_KINDS = new Set(["SCHEMA_VALIDATION", "RULE_VALIDATION", "AUTH", "FORBIDDEN"]);
+
+interface BulkReservation {
+  stateId: string;
+  invoice: Invoice & { lines: EimsMapperLine[] };
+  documentType: EimsDocumentType;
+  relatedDocument: string | null;
+  invoiceCounter: number;
+  documentNumber: string;
+  previousIrn: string;
+}
+
+/**
+ * Registers many invoices with MoR EIMS in one call — `POST /v1/bulkRegister`.
+ *
+ * Fundamentally different shape from `EimsInvoiceRegistrationService.registerInvoiceWithEims`:
+ * that endpoint answers synchronously (an IRN or a rejection, in the HTTP response itself). Bulk
+ * does not — it returns only `{conversationId, status:202}` immediately, and the real per-invoice
+ * results (a mix of accepted/rejected in one array, per the collection's own examples) arrive later
+ * as a POST to a webhook MoR was configured with out of band. That means this service has two
+ * halves that don't share a call stack: `registerBulk` reserves and submits; `handleBulkCallback`
+ * — invoked by `EimsWebhookController`, whenever MoR gets around to it — settles.
+ *
+ * Reservation follows the same durable-reservation doctrine as the single-invoice service (counters
+ * consumed and the holder recorded, committed, before the HTTP call leaves the process), extended
+ * to a contiguous block of N counters instead of one. The "something is in flight" marker is
+ * `EimsSystemState.inFlightConversationId`, not `inFlightInvoiceId` — a whole batch is outstanding,
+ * not one invoice — and the two markers block each other: a single registration cannot start while
+ * a bulk batch is pending, and vice versa, because they share the same counter sequence.
+ *
+ * The conversation id is not known until MoR's 202 response arrives, so reservation stamps a
+ * locally-generated placeholder token first (same "commit the reservation before the network call"
+ * reasoning as the single flow), then swaps it for MoR's real conversation id right after — the only
+ * value the webhook callback can actually use to find this batch again.
+ *
+ * Not live-testable from this sandbox (no route to MoR's real gateway) — signing the whole array as
+ * one envelope, the way single `/v1/register` was confirmed live to need despite the collection's
+ * raw example showing no envelope, is the reasonable extension of that confirmed behavior, not a
+ * blind guess, but it has not itself been exercised against the real gateway.
+ */
+@Injectable()
+export class EimsBulkRegistrationService {
+  private readonly logger = new Logger(EimsBulkRegistrationService.name);
+
+  constructor(
+    @InjectDataSource() private readonly dataSource: DataSource,
+    private readonly config: ConfigService,
+    private readonly client: EimsClientService,
+    private readonly auth: EimsAuthService,
+    private readonly notifications: NotificationsService,
+    private readonly sellerCache: EimsSellerCacheService,
+  ) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  /**
+   * Reserve counters for every eligible invoice and submit them as one `/v1/bulkRegister` call.
+   * An invoice that already has an IRN is silently skipped (idempotent, matching single register);
+   * everything else must pass the same DEB/CRE precondition single register checks, or the whole
+   * call is refused before anything is reserved.
+   */
+  async registerBulk(
+    invoiceIds: string[],
+  ): Promise<{ conversationId: string | null; accepted: string[]; alreadyRegistered: string[] }> {
+    const cfg = this.cfg;
+    assertEimsInvoiceConfig(cfg);
+
+    const ids = [...new Set(invoiceIds)];
+    if (ids.length === 0) {
+      throw new BadRequestException({ code: "EIMS_BULK_EMPTY", message: "No invoice ids given" });
+    }
+
+    const invoices = await this.loadInvoicesForMapping(ids);
+    const alreadyRegistered = invoices.filter((inv) => inv.eimsIrn).map((inv) => inv.id);
+    const pending = invoices.filter((inv) => !inv.eimsIrn);
+
+    // Same DEB/CRE precondition as single register, checked for every pending invoice before any
+    // counter is touched: a bad member must fail the whole batch, not surface mid-submission.
+    const prepared = pending.map((invoice) => {
+      const documentType = (invoice.eimsDocumentType as EimsDocumentType | undefined) ?? "INV";
+      let relatedDocument: string | null = null;
+      if (documentType !== "INV") {
+        if (!invoice.relatedInvoice) {
+          throw new BadRequestException({
+            code: "EIMS_RELATED_INVOICE_REQUIRED",
+            message: `Invoice ${invoice.invoiceNumber} is a ${documentType} but has no related invoice set.`,
+          });
+        }
+        if (!invoice.relatedInvoice.eimsIrn) {
+          throw new BadRequestException({
+            code: "EIMS_RELATED_INVOICE_NOT_REGISTERED",
+            message: `Invoice ${invoice.invoiceNumber} is a ${documentType} against invoice ${invoice.relatedInvoice.invoiceNumber}, which was never registered with EIMS — nothing to reference.`,
+          });
+        }
+        relatedDocument = invoice.relatedInvoice.eimsIrn;
+      }
+      return { invoice, documentType, relatedDocument };
+    });
+
+    if (prepared.length === 0) {
+      return { conversationId: null, accepted: [], alreadyRegistered };
+    }
+
+    const session = await this.auth.getSessionContext();
+    const placeholder = `local:${randomUUID()}`;
+    const reservations = await this.reserveBulk(prepared, session.systemNumber, placeholder);
+
+    let conversationId: string;
+    try {
+      const requests: EimsBulkRegisterRequest = reservations.map((r) =>
+        toEimsInvoice(
+          r.invoice,
+          this.sellerCache.getSellerDetails(cfg),
+          buildEimsContext(cfg, {
+            documentNumber: r.documentNumber,
+            invoiceCounter: r.invoiceCounter,
+            previousIrn: r.previousIrn,
+            session,
+            documentType: r.documentType,
+            reason: r.invoice.eimsReason,
+            relatedDocument: r.relatedDocument,
+          }),
+        ),
+      );
+      const response = await this.client.postSigned<EimsBulkRegisterRequest, EimsBulkRegisterAcceptedResponse>(
+        "/v1/bulkRegister",
+        requests,
+      );
+      if (!response?.conversationId) {
+        throw new EimsApiException(
+          "SCHEMA_VALIDATION",
+          "EIMS bulkRegister returned no conversationId",
+          response?.status,
+        );
+      }
+      conversationId = response.conversationId;
+    } catch (err) {
+      await this.settleBulkFailure(reservations, err);
+      throw err;
+    }
+
+    await this.claimConversationId(placeholder, conversationId);
+    this.logger.log(
+      `Bulk-registered ${reservations.length} invoice(s) with EIMS (conversation ${conversationId}), awaiting callback`,
+    );
+    return { conversationId, accepted: reservations.map((r) => r.invoice.id), alreadyRegistered };
+  }
+
+  /**
+   * Settle a batch's callback, whenever MoR gets around to sending it. Called by
+   * `EimsWebhookController` with the raw parsed array body — no auth on that route (MoR calls it,
+   * not a logged-in user), so the only thing standing between this and a forged callback is the
+   * conversation id itself: an item is only ever applied to an invoice actually holding that exact
+   * id, and an unknown id is logged and ignored rather than touching anything.
+   */
+  async handleBulkCallback(items: EimsBulkCallbackItem[]): Promise<EimsBulkRegisterItemResult[]> {
+    const settlements = items.filter(
+      (item): item is Exclude<EimsBulkCallbackItem, { conversationId?: string; conversionId?: string }> =>
+        "irn" in item || "ruleError" in item,
+    );
+
+    const conversationId = this.markerFrom(items);
+    const invoices = await this.dataSource
+      .getRepository(Invoice)
+      .createQueryBuilder("invoice")
+      .where("invoice.eims_bulk_conversation_id = :id", { id: conversationId })
+      .getMany();
+
+    if (invoices.length === 0) {
+      this.logger.warn(
+        `EIMS bulk callback for an unknown or already-settled conversation — ignored (${settlements.length} item(s))`,
+      );
+      return [];
+    }
+
+    const byDocumentNumber = new Map(invoices.map((inv) => [inv.eimsDocumentNumber, inv]));
+    // Process in invoiceCounter order so `previousIrn` ends up as the last-accepted item's IRN —
+    // the same "advance the chain" semantics as single register's settleSuccess.
+    const ordered = [...settlements].sort((a, b) => {
+      const invA = byDocumentNumber.get("documentNumber" in a ? a.documentNumber : a.docNo);
+      const invB = byDocumentNumber.get("documentNumber" in b ? b.documentNumber : b.docNo);
+      return (invA?.eimsInvoiceCounter ?? 0) - (invB?.eimsInvoiceCounter ?? 0);
+    });
+
+    const results: EimsBulkRegisterItemResult[] = [];
+    for (const item of ordered) {
+      const docNumber = "documentNumber" in item ? item.documentNumber : item.docNo;
+      const invoice = byDocumentNumber.get(docNumber);
+      if (!invoice) {
+        this.logger.warn(`EIMS bulk callback item for unknown document number ${docNumber} — ignored`);
+        continue;
+      }
+      if (invoice.eimsStatus !== EimsInvoiceStatus.Submitting) {
+        // Already settled — a duplicate callback delivery. Report the current state, touch nothing.
+        results.push({
+          invoiceId: invoice.id,
+          invoiceNumber: invoice.invoiceNumber,
+          success: invoice.eimsStatus === EimsInvoiceStatus.Registered,
+          message: `Already settled (${invoice.eimsStatus})`,
+          irn: invoice.eimsIrn ?? undefined,
+        });
+        continue;
+      }
+
+      if ("irn" in item) {
+        await this.settleBulkItemSuccess(invoice, item.irn, conversationId, item.signedQR);
+        results.push({
+          invoiceId: invoice.id,
+          invoiceNumber: invoice.invoiceNumber,
+          success: true,
+          message: `Registered with EIMS (IRN ${item.irn})`,
+          irn: item.irn,
+        });
+      } else {
+        const message = item.ruleError.flatMap((e) => e.errorMessage).join("; ") || "EIMS bulk rule validation error";
+        await this.settleBulkItemFailure(invoice, message);
+        results.push({ invoiceId: invoice.id, invoiceNumber: invoice.invoiceNumber, success: false, message });
+      }
+    }
+
+    // Clear the batch's in-flight marker only once nothing submitted under this conversation is
+    // still waiting — a partial/incremental callback (not expected per the collection's docs, but
+    // not ruled out either) must not prematurely unblock the system number.
+    const stillPending = await this.dataSource
+      .getRepository(Invoice)
+      .count({ where: { eimsBulkConversationId: conversationId, eimsStatus: EimsInvoiceStatus.Submitting } });
+    if (stillPending === 0) {
+      await this.dataSource.manager.update(
+        EimsSystemState,
+        { inFlightConversationId: conversationId },
+        { inFlightConversationId: null },
+      );
+      this.logger.log(`EIMS bulk conversation ${conversationId} fully settled (${results.length} item(s))`);
+    }
+
+    return results;
+  }
+
+  // ── transactions ─────────────────────────────────────────────────────────────────────────────
+
+  /** TX1. Reserve a contiguous block of N counters, one per invoice, in the given order. */
+  private async reserveBulk(
+    prepared: Array<{ invoice: Invoice & { lines: EimsMapperLine[] }; documentType: EimsDocumentType; relatedDocument: string | null }>,
+    systemNumber: string,
+    placeholder: string,
+  ): Promise<BulkReservation[]> {
+    return this.dataSource.transaction(async (manager) => {
+      const state = await this.lockSystemState(manager, systemNumber);
+
+      if (state.blockedReason) {
+        throw new ConflictException({
+          code: "EIMS_SYSTEM_BLOCKED",
+          message: `EIMS registration is blocked for system ${systemNumber}: ${state.blockedReason}. Resolve the affected invoice before registering anything else.`,
+        });
+      }
+      if (state.inFlightInvoiceId) {
+        throw new ConflictException({
+          code: "EIMS_SUBMISSION_IN_FLIGHT",
+          message: `A submission for invoice ${state.inFlightInvoiceId} is already in flight on system ${systemNumber}. Wait for it to settle, or resolve it if the process was interrupted.`,
+        });
+      }
+      if (state.inFlightConversationId) {
+        throw new ConflictException({
+          code: "EIMS_BULK_IN_FLIGHT",
+          message: `A bulk submission (conversation ${state.inFlightConversationId}) is already in flight on system ${systemNumber}. Wait for its callback, or resolve it if the process was interrupted.`,
+        });
+      }
+
+      let counter = Number(state.nextInvoiceCounter);
+      let docNumber = Number(state.nextDocumentNumber);
+      let previousIrn = state.previousIrn ?? "";
+      const reservations: BulkReservation[] = [];
+
+      // Locked in the caller's given order — stable, avoids two concurrent bulk calls deadlocking
+      // on the opposite lock order.
+      for (const { invoice, documentType, relatedDocument } of prepared) {
+        const locked = await this.lockInvoice(manager, invoice.id);
+        const thisCounter = counter++;
+        const thisDocNumber = String(docNumber++);
+        const thisPreviousIrn = reservations.length === 0 ? previousIrn : "";
+
+        await manager.update(Invoice, invoice.id, {
+          eimsStatus: EimsInvoiceStatus.Submitting,
+          eimsInvoiceCounter: thisCounter,
+          eimsDocumentNumber: thisDocNumber,
+          eimsSubmittedAt: new Date(),
+          eimsLastError: null,
+          eimsBulkConversationId: placeholder,
+        } as QueryDeepPartialEntity<Invoice>);
+
+        reservations.push({
+          stateId: state.id,
+          invoice: Object.assign(locked, { lines: invoice.lines }),
+          documentType,
+          relatedDocument,
+          invoiceCounter: thisCounter,
+          documentNumber: thisDocNumber,
+          previousIrn: thisPreviousIrn,
+        });
+      }
+
+      await manager.update(EimsSystemState, state.id, {
+        nextInvoiceCounter: counter,
+        nextDocumentNumber: docNumber,
+        inFlightConversationId: placeholder,
+      });
+
+      return reservations;
+    });
+  }
+
+  /** Swap the local placeholder for MoR's real conversation id, on both the state row and every invoice. */
+  private async claimConversationId(placeholder: string, conversationId: string): Promise<void> {
+    await this.dataSource.transaction(async (manager) => {
+      await manager.update(EimsSystemState, { inFlightConversationId: placeholder }, { inFlightConversationId: conversationId });
+      await manager.update(Invoice, { eimsBulkConversationId: placeholder }, { eimsBulkConversationId: conversationId });
+    });
+  }
+
+  /**
+   * TX2b for the whole batch — the same determinism doctrine as single register's settleFailure,
+   * applied once since `/v1/bulkRegister` either accepts the whole array (202) or fails as one HTTP
+   * call; there is no per-item answer yet at this point, only after the callback.
+   */
+  private async settleBulkFailure(reservations: BulkReservation[], err: unknown): Promise<void> {
+    const api = err instanceof EimsApiException ? err : null;
+    const deterministic = api ? DETERMINISTIC_KINDS.has(api.kind) : true;
+    const status = deterministic ? EimsInvoiceStatus.Failed : EimsInvoiceStatus.Unknown;
+    const localKind = err instanceof EimsConfigException ? "CONFIG" : "LOCAL";
+    const lastError: EimsInvoiceError = {
+      kind: api?.kind ?? localKind,
+      message: (err as Error)?.message ?? "unknown error",
+      httpStatus: api?.httpStatus,
+      details: api?.details,
+      at: new Date().toISOString(),
+    };
+    const first = reservations[0];
+
+    await this.dataSource.transaction(async (manager) => {
+      for (const r of reservations) {
+        await manager.update(Invoice, r.invoice.id, {
+          eimsStatus: status,
+          eimsLastError: lastError,
+          ...(deterministic ? { eimsBulkConversationId: null } : {}),
+        } as QueryDeepPartialEntity<Invoice>);
+      }
+      await manager.update(
+        EimsSystemState,
+        first.stateId,
+        deterministic
+          ? {
+              // The whole block returns: MoR never counted a refused batch against either sequence.
+              nextInvoiceCounter: first.invoiceCounter,
+              nextDocumentNumber: Number(first.documentNumber),
+              inFlightConversationId: null,
+            }
+          : {
+              blockedReason:
+                `A bulk submission of ${reservations.length} invoice(s) (starting counter ${first.invoiceCounter}) ` +
+                `was sent but never acknowledged (${lastError.kind}). No further document can be filed until it is resolved.`,
+            },
+      );
+    });
+
+    this.logger.error(`EIMS bulk submission ${status}: ${lastError.message}`);
+  }
+
+  /** One callback item accepted. */
+  private async settleBulkItemSuccess(
+    invoice: Invoice,
+    irn: string,
+    conversationId: string,
+    signedQR?: string,
+  ): Promise<void> {
+    await this.dataSource.transaction(async (manager) => {
+      await this.lockInvoice(manager, invoice.id);
+      await manager.update(Invoice, invoice.id, {
+        eimsStatus: EimsInvoiceStatus.Registered,
+        eimsIrn: irn,
+        eimsSignedQr: signedQR ?? null,
+        eimsLastError: null,
+      });
+      // Looked up by conversation id, not system number — this batch's state row is whichever one
+      // is holding this conversation, which is exactly what `inFlightConversationId` already tracks.
+      await manager.update(EimsSystemState, { inFlightConversationId: conversationId }, { previousIrn: irn });
+    });
+    this.logger.log(`Invoice ${invoice.invoiceNumber} registered with EIMS via bulk (IRN ${irn})`);
+
+    if (invoice.companyId) {
+      try {
+        await sendCompanyChannels(
+          this.dataSource,
+          this.notifications,
+          invoice.companyId,
+          `Invoice ${invoice.invoiceNumber} has been registered with MoR EIMS. Reference (IRN): ${irn}`,
+        );
+      } catch (err) {
+        this.logger.warn(`EIMS buyer notification failed for invoice ${invoice.id}: ${(err as Error).message}`);
+      }
+    }
+  }
+
+  /**
+   * One callback item rejected. Unlike single register's settleFailure, the counter/document
+   * number are not returned — MoR's own bulk processing already advanced the whole array's
+   * allocation regardless of this item's individual outcome, so there is nothing local to roll back.
+   */
+  private async settleBulkItemFailure(invoice: Invoice, message: string): Promise<void> {
+    const lastError: EimsInvoiceError = { kind: "RULE_VALIDATION", message, at: new Date().toISOString() };
+    await this.dataSource.manager.update(Invoice, invoice.id, {
+      eimsStatus: EimsInvoiceStatus.Failed,
+      eimsLastError: lastError,
+    } as QueryDeepPartialEntity<Invoice>);
+    this.logger.error(`Invoice ${invoice.invoiceNumber} EIMS bulk registration FAILED: ${message}`);
+  }
+
+  // ── internals ────────────────────────────────────────────────────────────────────────────────
+
+  private markerFrom(items: EimsBulkCallbackItem[]): string {
+    const marker = items.find((i) => "conversationId" in i || "conversionId" in i) as
+      | { conversationId?: string; conversionId?: string }
+      | undefined;
+    return marker?.conversationId ?? marker?.conversionId ?? "";
+  }
+
+
+  private async lockInvoice(manager: EntityManager, invoiceId: string): Promise<Invoice> {
+    const invoice = await manager
+      .createQueryBuilder(Invoice, "invoice")
+      .setLock("pessimistic_write")
+      .where("invoice.id = :invoiceId", { invoiceId })
+      .getOne();
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    return invoice;
+  }
+
+  private async lockSystemState(manager: EntityManager, systemNumber: string): Promise<EimsSystemState> {
+    const select = () =>
+      manager
+        .createQueryBuilder(EimsSystemState, "state")
+        .setLock("pessimistic_write")
+        .where("state.system_number = :systemNumber", { systemNumber })
+        .getOne();
+
+    const existing = await select();
+    if (existing) return existing;
+
+    await manager.query(
+      `INSERT INTO freight.eims_system_state (system_number) VALUES ($1) ON CONFLICT (system_number) DO NOTHING`,
+      [systemNumber],
+    );
+    const created = await select();
+    if (!created) throw new Error(`Could not initialise EIMS system state for ${systemNumber}`);
+    return created;
+  }
+
+  private async loadInvoicesForMapping(invoiceIds: string[]): Promise<Array<Invoice & { lines: EimsMapperLine[] }>> {
+    const invoices = await this.dataSource.getRepository(Invoice).find({
+      where: { id: In(invoiceIds) },
+      relations: { company: true, companyProfile: true, relatedInvoice: true },
+    });
+    const found = new Set(invoices.map((inv) => inv.id));
+    const missing = invoiceIds.filter((id) => !found.has(id));
+    if (missing.length > 0) {
+      throw new NotFoundException(`Invoice(s) not found: ${missing.join(", ")}`);
+    }
+
+    const lines: Array<EimsMapperLine & { invoiceId: string }> = await this.dataSource.query(
+      `SELECT invoice_id AS "invoiceId", charge_type AS "chargeType", description, quantity,
+              unit_rate AS "unitRate", amount, currency, metadata
+         FROM freight.invoice_lines
+        WHERE invoice_id = ANY($1) AND deleted_at IS NULL
+        ORDER BY created_at ASC`,
+      [invoiceIds],
+    );
+    const linesByInvoice = new Map<string, EimsMapperLine[]>();
+    for (const line of lines) {
+      const { invoiceId, ...rest } = line;
+      if (!linesByInvoice.has(invoiceId)) linesByInvoice.set(invoiceId, []);
+      linesByInvoice.get(invoiceId)!.push(rest);
+    }
+
+    // Preserve the caller's given order — reservation and result ordering both depend on it.
+    return invoiceIds.map((id) => {
+      const invoice = invoices.find((inv) => inv.id === id)!;
+      return Object.assign(invoice, { lines: linesByInvoice.get(id) ?? [] });
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-cancellation.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-cancellation.service.spec.ts
new file mode 100644
index 000000000..b9fdf62df
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-cancellation.service.spec.ts
@@ -0,0 +1,259 @@
+import { BadRequestException, ConflictException } from "@nestjs/common";
+import { DataSource } from "typeorm";
+
+import { Invoice } from "../billing/entities/invoice.entity";
+import { NotificationsService } from "../notifications/notifications.service";
+import { EimsCancellationService } from "./eims-cancellation.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsApiException } from "./eims.errors";
+import { EimsInvoiceStatus } from "./eims-registration.types";
+
+const INVOICE_ID = "11111111-1111-4111-8111-111111111111";
+const OTHER_INVOICE_ID = "22222222-2222-4222-8222-222222222222";
+const IRN = "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0";
+const OTHER_IRN = "0af579eaef6f1e2d39fa77bd21cf8ecc64e26869275ae1c04eaa9ffea78b6c06";
+
+const invoiceRow = (over: Partial<Invoice> = {}): Invoice =>
+  ({
+    id: INVOICE_ID,
+    invoiceNumber: "INV-20260807-00042",
+    companyId: "company-1",
+    eimsStatus: EimsInvoiceStatus.Registered,
+    eimsIrn: IRN,
+    eimsCancelledAt: null,
+    eimsCancellationDate: null,
+    eimsCancellationReasonCode: null,
+    eimsCancellationRemark: null,
+    ...over,
+  }) as unknown as Invoice;
+
+/** In-memory stand-in, same shape as the registration spec's FakeDb but with only what cancel needs. */
+class FakeDb {
+  invoices = new Map<string, Invoice>();
+  companyContact: { phone: string | null; email: string | null } | null = null;
+
+  constructor(invoices: Invoice[]) {
+    for (const inv of invoices) this.invoices.set(inv.id, inv);
+  }
+
+  private manager = {
+    createQueryBuilder: (entity: unknown) => {
+      let id: string | undefined;
+      const builder = {
+        setLock: () => builder,
+        where: (_clause: string, params: Record<string, string>) => {
+          id = params.invoiceId;
+          return builder;
+        },
+        getOne: async () => (entity === Invoice ? (this.invoices.get(id!) ?? null) : null),
+      };
+      return builder;
+    },
+    findOne: async (_entity: unknown, options: { where: { id: string } }) =>
+      this.invoices.get(options.where.id) ?? null,
+    update: async (_entity: unknown, id: string, patch: Record<string, unknown>) => {
+      Object.assign(this.invoices.get(id)!, patch);
+    },
+  };
+
+  asDataSource(): DataSource {
+    return {
+      manager: this.manager,
+      query: async () => (this.companyContact ? [this.companyContact] : []),
+      transaction: async (body: (m: unknown) => Promise<unknown>) => body(this.manager),
+    } as unknown as DataSource;
+  }
+}
+
+const build = (db: FakeDb, postBearer: jest.Mock, directSend: jest.Mock = jest.fn().mockResolvedValue(undefined)) =>
+  new EimsCancellationService(
+    db.asDataSource(),
+    { postBearer } as unknown as EimsClientService,
+    { directSend } as unknown as NotificationsService,
+  );
+
+describe("EimsCancellationService.cancelInvoiceWithEims", () => {
+  it("cancels a registered invoice and persists MoR's confirmation", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest
+      .fn()
+      .mockResolvedValue({ statusCode: 200, message: "Success", body: { cancellationDate: "Sun Dec 22 21:55:03 EAT 2024" } });
+
+    const view = await build(db, postBearer).cancelInvoiceWithEims(INVOICE_ID, "1", "Duplicate");
+
+    expect(postBearer).toHaveBeenCalledWith("/v1/cancel", { Irn: IRN, ReasonCode: "1", Remark: "Duplicate" });
+    expect(view.eimsStatus).toBe(EimsInvoiceStatus.Cancelled);
+    expect(view.eimsCancellationDate).toBe("Sun Dec 22 21:55:03 EAT 2024");
+    expect(view.eimsCancellationReasonCode).toBe("1");
+    expect(view.eimsCancellationRemark).toBe("Duplicate");
+    expect(db.invoices.get(INVOICE_ID)?.eimsCancelledAt).toBeInstanceOf(Date);
+  });
+
+  it("defaults Remark to an empty string, matching the collection's request shape", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn().mockResolvedValue({ statusCode: 200, body: { cancellationDate: "x" } });
+
+    await build(db, postBearer).cancelInvoiceWithEims(INVOICE_ID, "1");
+
+    expect(postBearer).toHaveBeenCalledWith("/v1/cancel", { Irn: IRN, ReasonCode: "1", Remark: "" });
+  });
+
+  it("refuses re-cancelling an already-cancelled invoice, per IRC-N010 — no silent no-op", async () => {
+    const db = new FakeDb([
+      invoiceRow({ eimsStatus: EimsInvoiceStatus.Cancelled, eimsCancellationDate: "Sun Dec 22 2024" }),
+    ]);
+    const postBearer = jest.fn();
+
+    await expect(build(db, postBearer).cancelInvoiceWithEims(INVOICE_ID, "1")).rejects.toBeInstanceOf(
+      ConflictException,
+    );
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+
+  it("refuses to cancel an invoice that was never registered", async () => {
+    const db = new FakeDb([invoiceRow({ eimsStatus: EimsInvoiceStatus.NotSubmitted, eimsIrn: null })]);
+    const postBearer = jest.fn();
+
+    await expect(build(db, postBearer).cancelInvoiceWithEims(INVOICE_ID, "1")).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+
+  it("propagates a MoR rejection and leaves the invoice REGISTERED", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest
+      .fn()
+      .mockRejectedValue(new EimsApiException("RULE_VALIDATION", "EIMS cancel failed (406)", 406));
+
+    await expect(build(db, postBearer).cancelInvoiceWithEims(INVOICE_ID, "1")).rejects.toBeInstanceOf(
+      EimsApiException,
+    );
+    expect(db.invoices.get(INVOICE_ID)?.eimsStatus).toBe(EimsInvoiceStatus.Registered);
+  });
+
+  it("notifies the buyer company on success, without blocking the result", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    db.companyContact = { phone: "+251911000000", email: "buyer@abc.et" };
+    const directSend = jest.fn().mockResolvedValue(undefined);
+    const postBearer = jest.fn().mockResolvedValue({ statusCode: 200, body: { cancellationDate: "x" } });
+
+    const view = await build(db, postBearer, directSend).cancelInvoiceWithEims(INVOICE_ID, "1");
+
+    expect(view.eimsStatus).toBe(EimsInvoiceStatus.Cancelled);
+    expect(directSend).toHaveBeenCalledWith("sms", "+251911000000", expect.stringContaining("cancelled"));
+  });
+
+  it("does not fail cancellation when the buyer notification itself fails", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    db.companyContact = { phone: "+251911000000", email: null };
+    const directSend = jest.fn().mockRejectedValue(new Error("sms provider down"));
+    const postBearer = jest.fn().mockResolvedValue({ statusCode: 200, body: { cancellationDate: "x" } });
+
+    const view = await build(db, postBearer, directSend).cancelInvoiceWithEims(INVOICE_ID, "1");
+
+    expect(view.eimsStatus).toBe(EimsInvoiceStatus.Cancelled);
+  });
+});
+
+describe("EimsCancellationService.cancelBulkWithEims", () => {
+  it("cancels every eligible invoice in one call, matching results back by IRN", async () => {
+    const db = new FakeDb([invoiceRow(), invoiceRow({ id: OTHER_INVOICE_ID, eimsIrn: OTHER_IRN })]);
+    const postBearer = jest.fn().mockResolvedValue({
+      statusCode: 200,
+      body: [
+        { id: 1, tin: "t", status: "C", mode: "bulk", Irn: OTHER_IRN, ReasonCode: "6", Remark: "x" },
+        { id: 2, tin: "t", status: "C", mode: "bulk", Irn: IRN, ReasonCode: "1", Remark: "" },
+      ],
+    });
+
+    const results = await build(db, postBearer).cancelBulkWithEims([
+      { invoiceId: INVOICE_ID, reasonCode: "1" },
+      { invoiceId: OTHER_INVOICE_ID, reasonCode: "6", remark: "x" },
+    ]);
+
+    expect(postBearer).toHaveBeenCalledWith("/v1/bulkCancel", [
+      { Irn: IRN, ReasonCode: "1", Remark: "" },
+      { Irn: OTHER_IRN, ReasonCode: "6", Remark: "x" },
+    ]);
+    expect(results).toEqual([
+      { invoiceId: INVOICE_ID, success: true, message: expect.stringContaining("cancelled") },
+      { invoiceId: OTHER_INVOICE_ID, success: true, message: expect.stringContaining("cancelled") },
+    ]);
+    expect(db.invoices.get(INVOICE_ID)?.eimsStatus).toBe(EimsInvoiceStatus.Cancelled);
+    expect(db.invoices.get(OTHER_INVOICE_ID)?.eimsStatus).toBe(EimsInvoiceStatus.Cancelled);
+    // Bulk success carries no cancellationDate at all, unlike single cancel.
+    expect(db.invoices.get(INVOICE_ID)?.eimsCancellationDate).toBeNull();
+  });
+
+  it("refuses an already-cancelled or never-registered invoice locally — never sent to MoR", async () => {
+    const db = new FakeDb([
+      invoiceRow({ eimsStatus: EimsInvoiceStatus.Cancelled }),
+      invoiceRow({ id: OTHER_INVOICE_ID, eimsStatus: EimsInvoiceStatus.NotSubmitted, eimsIrn: null }),
+    ]);
+    const postBearer = jest.fn();
+
+    const results = await build(db, postBearer).cancelBulkWithEims([
+      { invoiceId: INVOICE_ID, reasonCode: "1" },
+      { invoiceId: OTHER_INVOICE_ID, reasonCode: "1" },
+    ]);
+
+    expect(postBearer).not.toHaveBeenCalled();
+    expect(results).toEqual([
+      { invoiceId: INVOICE_ID, success: false, message: expect.stringContaining("already cancelled") },
+      { invoiceId: OTHER_INVOICE_ID, success: false, message: expect.stringContaining("never registered") },
+    ]);
+  });
+
+  it("a mix of MoR success and rejection only updates the succeeding invoice", async () => {
+    const db = new FakeDb([invoiceRow(), invoiceRow({ id: OTHER_INVOICE_ID, eimsIrn: OTHER_IRN })]);
+    const postBearer = jest.fn().mockResolvedValue({
+      statusCode: 200,
+      body: [
+        { id: 1, tin: "t", status: "C", mode: "bulk", Irn: IRN, ReasonCode: "1", Remark: "" },
+        { Status: "Processing_Error", msg: "IRN already Canceled.", Irn: OTHER_IRN },
+      ],
+    });
+
+    const results = await build(db, postBearer).cancelBulkWithEims([
+      { invoiceId: INVOICE_ID, reasonCode: "1" },
+      { invoiceId: OTHER_INVOICE_ID, reasonCode: "1" },
+    ]);
+
+    expect(db.invoices.get(INVOICE_ID)?.eimsStatus).toBe(EimsInvoiceStatus.Cancelled);
+    expect(db.invoices.get(OTHER_INVOICE_ID)?.eimsStatus).toBe(EimsInvoiceStatus.Registered);
+    expect(results).toEqual([
+      { invoiceId: INVOICE_ID, success: true, message: expect.stringContaining("cancelled") },
+      { invoiceId: OTHER_INVOICE_ID, success: false, message: "IRN already Canceled." },
+    ]);
+  });
+
+  it("makes no HTTP call at all when every item fails the local eligibility check", async () => {
+    const db = new FakeDb([invoiceRow({ eimsStatus: EimsInvoiceStatus.Cancelled })]);
+    const postBearer = jest.fn();
+
+    await build(db, postBearer).cancelBulkWithEims([{ invoiceId: INVOICE_ID, reasonCode: "1" }]);
+
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+
+  it("notifies the buyer only for invoices that actually got cancelled", async () => {
+    const db = new FakeDb([invoiceRow(), invoiceRow({ id: OTHER_INVOICE_ID, eimsIrn: OTHER_IRN })]);
+    db.companyContact = { phone: "+251911000000", email: null };
+    const directSend = jest.fn().mockResolvedValue(undefined);
+    const postBearer = jest.fn().mockResolvedValue({
+      statusCode: 200,
+      body: [
+        { status: "C", Irn: IRN },
+        { Status: "Processing_Error", msg: "boom", Irn: OTHER_IRN },
+      ],
+    });
+
+    await build(db, postBearer, directSend).cancelBulkWithEims([
+      { invoiceId: INVOICE_ID, reasonCode: "1" },
+      { invoiceId: OTHER_INVOICE_ID, reasonCode: "1" },
+    ]);
+
+    expect(directSend).toHaveBeenCalledTimes(1);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-cancellation.service.ts b/apps/edr-freight-api/src/modules/eims/eims-cancellation.service.ts
new file mode 100644
index 000000000..7f8605c5f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-cancellation.service.ts
@@ -0,0 +1,229 @@
+import { BadRequestException, ConflictException, Injectable, Logger, NotFoundException } from "@nestjs/common";
+import { InjectDataSource } from "@nestjs/typeorm";
+import { DataSource, EntityManager } from "typeorm";
+
+import { Invoice } from "../billing/entities/invoice.entity";
+import { NotificationsService } from "../notifications/notifications.service";
+import { sendCompanyChannels } from "../notifications/notify-company.util";
+import { EimsClientService } from "./eims-client.service";
+import {
+  EimsBulkCancelItemResult,
+  EimsBulkCancelRequest,
+  EimsBulkCancelResponse,
+  EimsCancelRequest,
+  EimsCancelResponse,
+  EimsInvoiceStatus,
+  EimsInvoiceStatusView,
+} from "./eims-registration.types";
+import { toEimsInvoiceStatusView } from "./eims-invoice-view.util";
+
+/**
+ * `POST /v1/cancel` for one already-registered invoice.
+ *
+ * Simpler than registration: cancellation carries no `InvoiceCounter`/`DocumentNumber`, so none of
+ * `EimsSystemState`'s reservation machinery applies, and — unlike registration — a retried cancel
+ * is safe: the collection's bulk-cancel example shows MoR itself rejects a second cancel with
+ * "IRN already Canceled.", so there is no double-filing risk the way an unacknowledged register
+ * call has. That is what makes the simpler shape below correct: no system-wide block, no in-flight
+ * marker, just a lock-check-unlock before the call and a fresh lock-check-write after it.
+ *
+ * ponytail: the eligibility check (TX1) and the write (TX2) are not one atomic operation, so two
+ * concurrent cancels on the same invoice could both pass TX1 and both call MoR — wasted, but safe,
+ * per the paragraph above. Upgrade to a single locked reservation (like registration's) only if
+ * MoR's cancel endpoint turns out not to be idempotent after all.
+ *
+ * Bearer-authenticated but unsigned (`postBearer`), same as `/v1/verify` — the collection's saved
+ * `/v1/cancel` request carries no `{request,signature,certificate}` envelope.
+ */
+@Injectable()
+export class EimsCancellationService {
+  private readonly logger = new Logger(EimsCancellationService.name);
+
+  constructor(
+    @InjectDataSource() private readonly dataSource: DataSource,
+    private readonly client: EimsClientService,
+    private readonly notifications: NotificationsService,
+  ) {}
+
+  /**
+   * Refuses an already-cancelled invoice with a 409, rather than a silent no-op — IRC-N010 in
+   * MoR's Master Compliance Checklist requires "an appropriate error or rejection message" for a
+   * repeat cancellation, not a quiet success. No HTTP call either way: this is a local check, not
+   * a retry against MoR. Also refuses an invoice that was never registered — there is no IRN to
+   * cancel.
+   */
+  async cancelInvoiceWithEims(
+    invoiceId: string,
+    reasonCode: string,
+    remark?: string,
+  ): Promise<EimsInvoiceStatusView> {
+    const eligible = await this.dataSource.transaction(async (manager) => {
+      const invoice = await this.lockInvoice(manager, invoiceId);
+      if (invoice.eimsStatus === EimsInvoiceStatus.Cancelled) {
+        throw new ConflictException({
+          code: "EIMS_ALREADY_CANCELLED",
+          message: `Invoice ${invoice.invoiceNumber} was already cancelled with EIMS${invoice.eimsCancellationDate ? ` (${invoice.eimsCancellationDate})` : ""}.`,
+        });
+      }
+      if (!invoice.eimsIrn) {
+        throw new BadRequestException({
+          code: "EIMS_NOT_REGISTERED",
+          message: `Invoice ${invoice.invoiceNumber} was never registered with EIMS — nothing to cancel.`,
+        });
+      }
+      return invoice;
+    });
+
+    const request: EimsCancelRequest = { Irn: eligible.eimsIrn!, ReasonCode: reasonCode, Remark: remark ?? "" };
+    // Outside any transaction — no DB lock is held across the wire.
+    const response = await this.client.postBearer<EimsCancelRequest, EimsCancelResponse>(
+      "/v1/cancel",
+      request,
+    );
+    const cancellationDate = response?.body?.cancellationDate ?? null;
+
+    await this.dataSource.transaction(async (manager) => {
+      const invoice = await this.lockInvoice(manager, invoiceId);
+      // Re-checked under lock: a concurrent call may have already recorded this cancellation.
+      if (invoice.eimsStatus === EimsInvoiceStatus.Cancelled) return;
+      await manager.update(Invoice, invoiceId, {
+        eimsStatus: EimsInvoiceStatus.Cancelled,
+        eimsCancelledAt: new Date(),
+        eimsCancellationDate: cancellationDate,
+        eimsCancellationReasonCode: reasonCode,
+        eimsCancellationRemark: remark ?? null,
+      });
+    });
+    this.logger.log(`Invoice ${eligible.invoiceNumber} cancelled with EIMS (IRN ${eligible.eimsIrn})`);
+
+    await this.notifyBuyer(eligible);
+    return this.getEimsCancellationStatus(invoiceId);
+  }
+
+  /**
+   * `POST /v1/bulkCancel` — one MoR call for every eligible invoice in `items`, matching the
+   * collection's own shape (an array in, an array of mixed success/error results back).
+   *
+   * Same local-eligibility doctrine as `cancelInvoiceWithEims`, applied per item before anything
+   * goes to MoR: an already-cancelled or never-registered invoice is refused right here (no HTTP
+   * call, no seat in the batch) rather than sent and rejected remotely. Only genuinely eligible
+   * invoices are batched into the one `/v1/bulkCancel` request; everything else is reported back
+   * immediately.
+   *
+   * ponytail: the eligibility pass is per-invoice transactions, not one covering the whole batch —
+   * same reasoning as the single-cancel path (cancel is idempotent at MoR, so a lock held across
+   * every item for the whole call isn't needed for correctness, only for avoiding a wasted call on
+   * an item that's already ineligible).
+   */
+  async cancelBulkWithEims(
+    items: Array<{ invoiceId: string; reasonCode: string; remark?: string }>,
+  ): Promise<EimsBulkCancelItemResult[]> {
+    const results = new Map<string, EimsBulkCancelItemResult>();
+    const eligible: Array<{ invoice: Invoice; reasonCode: string; remark?: string }> = [];
+
+    for (const item of items) {
+      try {
+        const invoice = await this.dataSource.transaction(async (manager) => {
+          const inv = await this.lockInvoice(manager, item.invoiceId);
+          if (inv.eimsStatus === EimsInvoiceStatus.Cancelled) {
+            throw new ConflictException(
+              `Invoice ${inv.invoiceNumber} was already cancelled with EIMS${inv.eimsCancellationDate ? ` (${inv.eimsCancellationDate})` : ""}.`,
+            );
+          }
+          if (!inv.eimsIrn) {
+            throw new BadRequestException(
+              `Invoice ${inv.invoiceNumber} was never registered with EIMS — nothing to cancel.`,
+            );
+          }
+          return inv;
+        });
+        eligible.push({ invoice, reasonCode: item.reasonCode, remark: item.remark });
+      } catch (err) {
+        results.set(item.invoiceId, {
+          invoiceId: item.invoiceId,
+          success: false,
+          message: (err as Error).message,
+        });
+      }
+    }
+
+    if (eligible.length > 0) {
+      const request: EimsBulkCancelRequest = eligible.map((e) => ({
+        Irn: e.invoice.eimsIrn!,
+        ReasonCode: e.reasonCode,
+        Remark: e.remark ?? "",
+      }));
+      // Outside any transaction — no DB lock held across the wire, same as single cancel.
+      const response = await this.client.postBearer<EimsBulkCancelRequest, EimsBulkCancelResponse>(
+        "/v1/bulkCancel",
+        request,
+      );
+      const byIrn = new Map((response?.body ?? []).map((entry) => [entry.Irn, entry]));
+
+      for (const { invoice, reasonCode, remark } of eligible) {
+        const entry = byIrn.get(invoice.eimsIrn!);
+        const failed = !entry || "Status" in entry;
+        if (failed) {
+          const message = entry && "msg" in entry ? entry.msg : "EIMS bulk cancel returned no result for this invoice.";
+          this.logger.warn(`Invoice ${invoice.invoiceNumber} bulk cancel failed: ${message}`);
+          results.set(invoice.id, { invoiceId: invoice.id, success: false, message });
+          continue;
+        }
+
+        await this.dataSource.transaction(async (manager) => {
+          const fresh = await this.lockInvoice(manager, invoice.id);
+          // Re-checked under lock: a concurrent call may have already recorded this cancellation.
+          if (fresh.eimsStatus === EimsInvoiceStatus.Cancelled) return;
+          await manager.update(Invoice, invoice.id, {
+            eimsStatus: EimsInvoiceStatus.Cancelled,
+            eimsCancelledAt: new Date(),
+            // The bulk success shape carries no cancellationDate at all, unlike single cancel.
+            eimsCancellationDate: null,
+            eimsCancellationReasonCode: reasonCode,
+            eimsCancellationRemark: remark ?? null,
+          });
+        });
+        this.logger.log(`Invoice ${invoice.invoiceNumber} cancelled with EIMS via bulk (IRN ${invoice.eimsIrn})`);
+        await this.notifyBuyer(invoice);
+        results.set(invoice.id, {
+          invoiceId: invoice.id,
+          success: true,
+          message: `Invoice ${invoice.invoiceNumber} cancelled with EIMS.`,
+        });
+      }
+    }
+
+    return items.map((item) => results.get(item.invoiceId)!);
+  }
+
+  async getEimsCancellationStatus(invoiceId: string): Promise<EimsInvoiceStatusView> {
+    const invoice = await this.dataSource.manager.findOne(Invoice, { where: { id: invoiceId } });
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    return toEimsInvoiceStatusView(invoice);
+  }
+
+  /** Best-effort — a notification failure must never mask a cancellation that already succeeded. */
+  private async notifyBuyer(invoice: Invoice): Promise<void> {
+    if (!invoice.companyId) return;
+    try {
+      await sendCompanyChannels(
+        this.dataSource,
+        this.notifications,
+        invoice.companyId,
+        `Invoice ${invoice.invoiceNumber} has been cancelled with MoR EIMS.`,
+      );
+    } catch (err) {
+      this.logger.warn(`EIMS buyer notification failed for invoice ${invoice.id}: ${(err as Error).message}`);
+    }
+  }
+
+  private async lockInvoice(manager: EntityManager, invoiceId: string): Promise<Invoice> {
+    const invoice = await manager
+      .createQueryBuilder(Invoice, "invoice")
+      .setLock("pessimistic_write")
+      .where("invoice.id = :invoiceId", { invoiceId })
+      .getOne();
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    return invoice;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-client.service.ts b/apps/edr-freight-api/src/modules/eims/eims-client.service.ts
new file mode 100644
index 000000000..610647b1a
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-client.service.ts
@@ -0,0 +1,80 @@
+import { HttpService } from "@nestjs/axios";
+import { Injectable, Logger } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { firstValueFrom } from "rxjs";
+import { EimsConfig } from "../../config/eims.config";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsSignerService, toSignedBody } from "./eims-signer.service";
+import { toEimsApiException } from "./eims.errors";
+
+/**
+ * Foundation for EIMS's bearer-authenticated endpoints (`/v1/register`, `/v1/verify`, …).
+ *
+ * Login is not routed through here: `/auth/login` carries no bearer token and lives in
+ * `EimsAuthService`. Nothing calls `postSigned` yet — invoice registration is a later phase.
+ */
+@Injectable()
+export class EimsClientService {
+  private readonly logger = new Logger(EimsClientService.name);
+
+  constructor(
+    private readonly http: HttpService,
+    private readonly config: ConfigService,
+    private readonly auth: EimsAuthService,
+    private readonly signer: EimsSignerService,
+  ) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  /**
+   * Sign `request`, POST it to `path` with a valid bearer token, and return the parsed response.
+   * A 401 invalidates the cached token and retries exactly once.
+   */
+  async postSigned<TRequest, TResponse>(path: string, request: TRequest): Promise<TResponse> {
+    return this.send<TRequest, TResponse>(path, request, false, true);
+  }
+
+  /**
+   * POST `request` verbatim — bearer-authenticated but **not** wrapped in a signed envelope.
+   *
+   * `/v1/verify` is the only endpoint observed to work this way: the supplied collection sends a
+   * raw `{"irn":"…"}` body with no `signature`/`certificate` siblings. Kept as its own entry point
+   * so that if the live gateway turns out to require signing after all, exactly one call site
+   * changes — `postSigned` is already the alternative.
+   */
+  async postBearer<TRequest, TResponse>(path: string, request: TRequest): Promise<TResponse> {
+    return this.send<TRequest, TResponse>(path, request, false, false);
+  }
+
+  private async send<TRequest, TResponse>(
+    path: string,
+    request: TRequest,
+    isRetry: boolean,
+    signed: boolean,
+  ): Promise<TResponse> {
+    const cfg = this.cfg;
+    const token = await this.auth.getValidAccessToken();
+    const body = signed ? toSignedBody(this.signer.signRequest(request)) : request;
+
+    try {
+      const res = await firstValueFrom(
+        this.http.post<TResponse>(`${cfg.baseUrl}${path}`, body, {
+          headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+          timeout: cfg.httpTimeoutMs,
+        }),
+      );
+      return res.data;
+    } catch (err) {
+      const mapped = toEimsApiException(err, `POST ${path}`);
+      if (mapped.kind === "AUTH" && !isRetry) {
+        this.logger.warn(`EIMS rejected the token on ${path}; re-authenticating once`);
+        this.auth.invalidate();
+        return this.send<TRequest, TResponse>(path, request, true, signed);
+      }
+      this.logger.error(mapped.message);
+      throw mapped;
+    }
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-credentials.provider.ts b/apps/edr-freight-api/src/modules/eims/eims-credentials.provider.ts
new file mode 100644
index 000000000..a5f837c1e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-credentials.provider.ts
@@ -0,0 +1,139 @@
+import { readFileSync } from "node:fs";
+import { KeyObject, createPrivateKey } from "node:crypto";
+import { Injectable, Logger } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { EimsConfig } from "../../config/eims.config";
+import { EimsConfigException } from "./eims.errors";
+
+const PEM_HEADER = /-----BEGIN [A-Z ]*(PRIVATE KEY|CERTIFICATE)-----/;
+
+/**
+ * A safe-to-log fingerprint of decoded key/cert bytes: length + a printable-only preview of the
+ * first line. Never the actual key material — PEM headers aren't secret, the base64 body is.
+ */
+const describeBytes = (bytes: Buffer): string => {
+  const preview = bytes.toString("utf8", 0, 40).replace(/[^\x20-\x7e]/g, "?");
+  return `${bytes.length} bytes, starts with "${preview}"`;
+};
+
+/**
+ * Loads the INSA-issued EIMS credentials from disk, once, and keeps them in memory.
+ *
+ * The certificate is sent as base64 of the **exact bytes of the issued file** — it is deliberately
+ * never parsed, re-encoded or re-exported, because that is what produced a working live login.
+ * The private key never leaves this process: it is only ever used to produce a signature.
+ */
+@Injectable()
+export class EimsCredentialsProvider {
+  private readonly logger = new Logger(EimsCredentialsProvider.name);
+  private privateKey: KeyObject | null = null;
+  private certificateBase64: string | null = null;
+
+  constructor(private readonly config: ConfigService) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  /**
+   * RSA private key, parsed once. Three ways in, checked in this order: `privateKeyPem` (the PEM
+   * text itself, no encoding step to get wrong), `privateKeyBase64` (for stores that can't hold a
+   * literal newline), `privateKeyPath` (the original file-on-disk form). Throws a config error if
+   * none is usable.
+   */
+  getPrivateKey(): KeyObject {
+    if (this.privateKey) return this.privateKey;
+
+    const { privateKeyPem, privateKeyBase64, privateKeyPath: path } = this.cfg;
+    const source = privateKeyPem
+      ? "EIMS_PRIVATE_KEY"
+      : privateKeyBase64
+        ? "EIMS_PRIVATE_KEY_BASE64"
+        : `EIMS_PRIVATE_KEY_PATH (${path})`;
+    if (!privateKeyPem && !privateKeyBase64 && !path) {
+      throw new EimsConfigException("EIMS_PRIVATE_KEY_PATH is not set");
+    }
+
+    let bytes: Buffer;
+    try {
+      bytes = privateKeyPem
+        ? Buffer.from(privateKeyPem, "utf8")
+        : privateKeyBase64
+          ? Buffer.from(privateKeyBase64, "base64")
+          : readFileSync(path);
+    } catch (err) {
+      throw new EimsConfigException(
+        `EIMS private key from ${source} could not be read or parsed: ${(err as Error).message}`,
+      );
+    }
+
+    // Fail with a diagnosable message before handing possibly-garbled bytes to OpenSSL, whose own
+    // error ("unsupported") gives no hint whether the problem is truncation, double-encoding, or a
+    // genuinely wrong file — all indistinguishable from outside without seeing the decoded bytes.
+    if (!PEM_HEADER.test(bytes.toString("utf8", 0, 100))) {
+      throw new EimsConfigException(
+        `EIMS private key from ${source} does not look like a PEM key after decoding ` +
+          `(${describeBytes(bytes)}) — check it's base64 of the raw key file with no line-wrapping ` +
+          `or truncation, and not base64 applied twice.`,
+      );
+    }
+
+    let key: KeyObject;
+    try {
+      key = createPrivateKey(bytes);
+    } catch (err) {
+      // The source is operational information, not a secret; the key material never appears.
+      throw new EimsConfigException(
+        `EIMS private key from ${source} could not be read or parsed: ${(err as Error).message}`,
+      );
+    }
+    if (key.asymmetricKeyType !== "rsa") {
+      throw new EimsConfigException(
+        `EIMS private key from ${source} is ${key.asymmetricKeyType ?? "of unknown type"}; EIMS requires RSA`,
+      );
+    }
+
+    this.privateKey = key;
+    this.logger.log(`EIMS private key loaded (RSA-${key.asymmetricKeyDetails?.modulusLength ?? "?"})`);
+    return key;
+  }
+
+  /**
+   * Base64 of the certificate file's exact bytes. No parsing, no re-encoding of what MoR issued.
+   * `certificatePem`/`certificateBase64` config win when set (used as-is, or re-encoded from the
+   * pasted text respectively); otherwise read from `certificatePath`.
+   */
+  getCertificateBase64(): string {
+    if (this.certificateBase64) return this.certificateBase64;
+
+    const { certificatePem: pem, certificateBase64: inline, certificatePath: path } = this.cfg;
+    if (pem) {
+      this.certificateBase64 = Buffer.from(pem, "utf8").toString("base64");
+      this.logger.log(`EIMS certificate bundle loaded from EIMS_CERTIFICATE`);
+      return this.certificateBase64;
+    }
+    if (inline) {
+      this.certificateBase64 = inline;
+      this.logger.log(`EIMS certificate bundle loaded from EIMS_CERTIFICATE_BASE64`);
+      return this.certificateBase64;
+    }
+
+    if (!path) throw new EimsConfigException("EIMS_CERTIFICATE_PATH is not set");
+
+    let bytes: Buffer;
+    try {
+      bytes = readFileSync(path);
+    } catch (err) {
+      throw new EimsConfigException(
+        `EIMS certificate at ${path} could not be read: ${(err as Error).message}`,
+      );
+    }
+    if (bytes.length === 0) {
+      throw new EimsConfigException(`EIMS certificate at ${path} is empty`);
+    }
+
+    this.certificateBase64 = bytes.toString("base64");
+    this.logger.log(`EIMS certificate bundle loaded (${bytes.length} bytes)`);
+    return this.certificateBase64;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-invoice-context.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-invoice-context.spec.ts
new file mode 100644
index 000000000..251f71cbd
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-invoice-context.spec.ts
@@ -0,0 +1,118 @@
+import { assertEimsInvoiceConfig, buildEimsContext } from "./eims-invoice-context";
+import { eimsConfig } from "./eims-test-fixtures";
+
+const SESSION = { systemNumber: "B0360154BA", systemType: "SYS" };
+
+describe("assertEimsInvoiceConfig — charge-type overrides", () => {
+  it("passes when EIMS_TAX_CODE_BY_CHARGE_TYPE and _RATE_ list the same charge types", () => {
+    expect(() =>
+      assertEimsInvoiceConfig(
+        eimsConfig({
+          invoice: {
+            ...eimsConfig().invoice,
+            taxCodeByChargeType: { RAIL_FREIGHT: "VAT0" },
+            taxRateByChargeType: { RAIL_FREIGHT: "0" },
+          },
+        }),
+      ),
+    ).not.toThrow();
+  });
+
+  it("throws when a charge type has a code but no rate, or a rate but no code", () => {
+    expect(() =>
+      assertEimsInvoiceConfig(
+        eimsConfig({
+          invoice: {
+            ...eimsConfig().invoice,
+            taxCodeByChargeType: { RAIL_FREIGHT: "VAT0" },
+            taxRateByChargeType: {},
+          },
+        }),
+      ),
+    ).toThrow(/mismatched: RAIL_FREIGHT/);
+
+    expect(() =>
+      assertEimsInvoiceConfig(
+        eimsConfig({
+          invoice: {
+            ...eimsConfig().invoice,
+            taxCodeByChargeType: {},
+            taxRateByChargeType: { RAIL_FREIGHT: "0" },
+          },
+        }),
+      ),
+    ).toThrow(/mismatched: RAIL_FREIGHT/);
+  });
+
+  it("throws when a rate/excise/discount override is not a number", () => {
+    expect(() =>
+      assertEimsInvoiceConfig(
+        eimsConfig({
+          invoice: {
+            ...eimsConfig().invoice,
+            taxCodeByChargeType: { RAIL_FREIGHT: "VAT0" },
+            taxRateByChargeType: { RAIL_FREIGHT: "not-a-number" },
+          },
+        }),
+      ),
+    ).toThrow(/EIMS_TAX_RATE_BY_CHARGE_TYPE\[RAIL_FREIGHT\]/);
+
+    expect(() =>
+      assertEimsInvoiceConfig(
+        eimsConfig({ invoice: { ...eimsConfig().invoice, discountByChargeType: { X: "abc" } } }),
+      ),
+    ).toThrow(/EIMS_DISCOUNT_BY_CHARGE_TYPE\[X\]/);
+  });
+});
+
+describe("buildEimsContext — taxForLine", () => {
+  const input = { documentNumber: "24", invoiceCounter: 7, previousIrn: "", session: SESSION };
+  const line = (chargeType: string) => ({ chargeType, quantity: 1, unitRate: 100, amount: 100 });
+
+  it("uses the per-chargeType override when one is configured", () => {
+    const context = buildEimsContext(
+      eimsConfig({
+        invoice: {
+          ...eimsConfig().invoice,
+          taxCode: "VAT15",
+          taxRatePercent: 15,
+          taxCodeByChargeType: { RAIL_FREIGHT: "VAT0" },
+          taxRateByChargeType: { RAIL_FREIGHT: "0" },
+          exciseByChargeType: { RAIL_FREIGHT: "5" },
+          discountByChargeType: { RAIL_FREIGHT: "10" },
+        },
+      }),
+      input,
+    );
+
+    expect(context.taxForLine(line("RAIL_FREIGHT"), 1)).toEqual({
+      code: "VAT0",
+      ratePercent: 0,
+      exciseTaxValue: 5,
+      discount: 10,
+    });
+  });
+
+  it("falls back to the invoice-wide default for a charge type with no override", () => {
+    const context = buildEimsContext(
+      eimsConfig({
+        invoice: {
+          ...eimsConfig().invoice,
+          taxCode: "VAT15",
+          taxRatePercent: 15,
+          exciseTaxValue: 0,
+          taxCodeByChargeType: { RAIL_FREIGHT: "VAT0" },
+          taxRateByChargeType: { RAIL_FREIGHT: "0" },
+        },
+      }),
+      input,
+    );
+
+    expect(context.taxForLine(line("HANDLING"), 1)).toEqual({
+      code: "VAT15",
+      ratePercent: 15,
+      exciseTaxValue: 0,
+      discount: 0,
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-invoice-context.ts b/apps/edr-freight-api/src/modules/eims/eims-invoice-context.ts
new file mode 100644
index 000000000..4c1c82c10
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-invoice-context.ts
@@ -0,0 +1,221 @@
+import { BadRequestException } from "@nestjs/common";
+import { EimsConfig } from "../../config/eims.config";
+import { EimsSessionContext } from "./eims-auth.service";
+import {
+  EimsMapperContext,
+  EimsMapperLine,
+  EimsSellerDetails,
+} from "../billing/eims-invoice.mapper";
+
+/**
+ * Turns configuration into the seller identity and mapper context that `toEimsInvoice` requires.
+ *
+ * Everything here is unavailable from the database by construction: EDR's own legal identity is not
+ * modelled anywhere, and the application has no tax model at all (`invoice.taxAmount` is always 0,
+ * `invoice_lines` and the rate catalogue carry no fiscal columns). Rather than defaulting any of it,
+ * a missing value fails **here** — locally, before a single byte reaches the gateway — naming the
+ * exact environment variables to set.
+ */
+
+interface RequiredSpec {
+  env: string;
+  value: string | number | null | undefined;
+}
+
+// `systemNumber` / `systemType` are absent by design: they come from the access token, which is
+// MoR's own statement of who we are. See EimsAuthService.getSessionContext.
+const REQUIRED = (invoice: EimsConfig["invoice"], tin: string): RequiredSpec[] => [
+  { env: "EIMS_TIN", value: tin },
+  { env: "EIMS_SELLER_LEGAL_NAME", value: invoice.sellerLegalName },
+  { env: "EIMS_SELLER_VAT_NUMBER", value: invoice.sellerVatNumber },
+  { env: "EIMS_SELLER_PHONE", value: invoice.sellerPhone },
+  { env: "EIMS_SELLER_EMAIL", value: invoice.sellerEmail },
+  { env: "EIMS_SELLER_REGION", value: invoice.sellerRegion },
+  { env: "EIMS_SELLER_WEREDA", value: invoice.sellerWereda },
+  { env: "EIMS_TAX_CODE", value: invoice.taxCode },
+  { env: "EIMS_TAX_RATE_PERCENT", value: invoice.taxRatePercent },
+  { env: "EIMS_INCOME_WITHHOLD_VALUE", value: invoice.incomeWithholdValue },
+  { env: "EIMS_TRANSACTION_WITHHOLD_VALUE", value: invoice.transactionWithholdValue },
+  { env: "EIMS_TRANSACTION_TYPE", value: invoice.transactionType },
+  { env: "EIMS_NATURE_OF_SUPPLIES", value: invoice.natureOfSupplies },
+  { env: "EIMS_PAYMENT_MODE", value: invoice.paymentMode },
+  { env: "EIMS_PAYMENT_TERM", value: invoice.paymentTerm },
+  { env: "EIMS_UNIT_DEFAULT", value: invoice.unitDefault },
+];
+
+/** Throws naming every unset variable at once, so one round trip fixes the whole configuration. */
+export function assertEimsInvoiceConfig(config: EimsConfig): void {
+  const missing = REQUIRED(config.invoice, config.tin)
+    .filter(({ value }) => value === null || value === undefined || value === "")
+    .map(({ env }) => env);
+
+  if (missing.length > 0) {
+    throw new BadRequestException({
+      code: "EIMS_INVOICE_CONFIG_INCOMPLETE",
+      message:
+        "EIMS invoice registration is not configured. Set these environment variables " +
+        `(tax values need finance sign-off — they are deliberately not defaulted): ${missing.join(", ")}`,
+    });
+  }
+
+  assertSellerFormats(config.invoice);
+  assertChargeTypeOverrides(config.invoice);
+}
+
+/**
+ * Per-`chargeType` tax overrides must be internally consistent before anything is filed:
+ * `EIMS_TAX_CODE_BY_CHARGE_TYPE` and `EIMS_TAX_RATE_BY_CHARGE_TYPE` must name the same charge
+ * types (a code with no rate, or vice versa, is a half-finished override), and every rate/excise/
+ * discount value must parse as a number — checked once here rather than once per line at
+ * registration time.
+ */
+function assertChargeTypeOverrides(invoice: EimsConfig["invoice"]): void {
+  const codeKeys = Object.keys(invoice.taxCodeByChargeType);
+  const rateKeys = Object.keys(invoice.taxRateByChargeType);
+  const mismatched = [...new Set([...codeKeys, ...rateKeys])].filter(
+    (k) => !(codeKeys.includes(k) && rateKeys.includes(k)),
+  );
+  if (mismatched.length > 0) {
+    throw new BadRequestException({
+      code: "EIMS_INVOICE_CONFIG_INVALID",
+      message:
+        `EIMS_TAX_CODE_BY_CHARGE_TYPE and EIMS_TAX_RATE_BY_CHARGE_TYPE must list the same charge ` +
+        `types; mismatched: ${mismatched.join(", ")}`,
+    });
+  }
+
+  const numericMaps: { env: string; map: Record<string, string> }[] = [
+    { env: "EIMS_TAX_RATE_BY_CHARGE_TYPE", map: invoice.taxRateByChargeType },
+    { env: "EIMS_EXCISE_BY_CHARGE_TYPE", map: invoice.exciseByChargeType },
+    { env: "EIMS_DISCOUNT_BY_CHARGE_TYPE", map: invoice.discountByChargeType },
+  ];
+  const badNumbers = numericMaps.flatMap(({ env, map }) =>
+    Object.entries(map)
+      .filter(([, value]) => !Number.isFinite(Number(value)))
+      .map(([chargeType]) => `${env}[${chargeType}]`),
+  );
+  if (badNumbers.length > 0) {
+    throw new BadRequestException({
+      code: "EIMS_INVOICE_CONFIG_INVALID",
+      message: `EIMS charge-type overrides must be numbers: ${badNumbers.join(", ")}`,
+    });
+  }
+}
+
+/**
+ * MoR's own patterns for the seller fields, checked here rather than at the gateway.
+ *
+ * A placeholder like `_` is "set" but unfilable, and finding that out costs a real request and a
+ * consumed counter — these are the exact regexes its 400 SCHEMA ERROR quoted back at us.
+ */
+const SELLER_FORMATS: { env: string; value: (i: EimsConfig["invoice"]) => string; pattern: RegExp }[] = [
+  { env: "EIMS_SELLER_PHONE", value: (i) => i.sellerPhone, pattern: /^\+?[0-9]{6,}$/ },
+  {
+    env: "EIMS_SELLER_EMAIL",
+    value: (i) => i.sellerEmail,
+    pattern: /^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$/,
+  },
+  { env: "EIMS_SELLER_REGION", value: (i) => i.sellerRegion, pattern: /^[0-9]{1,3}$/ },
+  { env: "EIMS_SELLER_WEREDA", value: (i) => i.sellerWereda, pattern: /^[0-9A-Za-z]{1,10}$/ },
+];
+
+function assertSellerFormats(invoice: EimsConfig["invoice"]): void {
+  const bad = SELLER_FORMATS.filter(({ value, pattern }) => !pattern.test(value(invoice))).map(
+    ({ env, pattern }) => `${env} (must match ${pattern.source})`,
+  );
+  if (bad.length > 0) {
+    throw new BadRequestException({
+      code: "EIMS_INVOICE_CONFIG_INVALID",
+      message: `EIMS seller details would be rejected by MoR: ${bad.join("; ")}`,
+    });
+  }
+}
+
+export function buildEimsSeller(config: EimsConfig): EimsSellerDetails {
+  const { invoice } = config;
+  return {
+    City: invoice.sellerCity,
+    Email: invoice.sellerEmail,
+    HouseNumber: invoice.sellerHouseNumber,
+    LegalName: invoice.sellerLegalName,
+    Locality: invoice.sellerLocality,
+    Phone: invoice.sellerPhone,
+    Region: invoice.sellerRegion,
+    SubCity: invoice.sellerSubCity,
+    Tin: config.tin,
+    VatNumber: invoice.sellerVatNumber,
+    Wereda: invoice.sellerWereda,
+  };
+}
+
+export interface EimsContextInput {
+  /** `DocumentDetails.DocumentNumber`. The caller decides its source. */
+  documentNumber: string;
+  invoiceCounter: number;
+  previousIrn: string | null;
+  /** Source-system identity from the access token, never from configuration. */
+  session: EimsSessionContext;
+  /** Required when the invoice currency is not ETB. */
+  exchangeRate?: number | null;
+  /** `DocumentDetails.Type` — defaults to "INV" in the mapper when omitted. */
+  documentType?: EimsMapperContext["documentType"];
+  /** Required (by the mapper) when documentType is DEB/CRE. */
+  reason?: string | null;
+  /** `ReferenceDetails.RelatedDocument` — the original invoice's IRN, required for DEB/CRE. */
+  relatedDocument?: string | null;
+}
+
+export function buildEimsContext(config: EimsConfig, input: EimsContextInput): EimsMapperContext {
+  const { invoice } = config;
+  // Validated by assertEimsInvoiceConfig; the non-null assertions below are safe after that call.
+  const taxCode = invoice.taxCode;
+  const ratePercent = invoice.taxRatePercent!;
+  const exciseTaxValue = invoice.exciseTaxValue ?? 0;
+
+  return {
+    systemNumber: input.session.systemNumber,
+    systemType: input.session.systemType,
+    documentNumber: input.documentNumber,
+    invoiceCounter: input.invoiceCounter,
+    previousIrn: input.previousIrn,
+    cashierName: invoice.cashierName,
+    salesPersonName: invoice.salesPersonName,
+    transactionType: invoice.transactionType,
+    payment: { mode: invoice.paymentMode, term: invoice.paymentTerm },
+    // Per-`chargeType` override when one is configured (validated symmetric in
+    // assertChargeTypeOverrides), else the single invoice-wide default.
+    taxForLine: (line: EimsMapperLine) => {
+      const { chargeType } = line;
+      const code = invoice.taxCodeByChargeType[chargeType] ?? taxCode;
+      const rate =
+        chargeType in invoice.taxRateByChargeType
+          ? Number(invoice.taxRateByChargeType[chargeType])
+          : ratePercent;
+      const excise =
+        chargeType in invoice.exciseByChargeType
+          ? Number(invoice.exciseByChargeType[chargeType])
+          : exciseTaxValue;
+      const discount =
+        chargeType in invoice.discountByChargeType
+          ? Number(invoice.discountByChargeType[chargeType])
+          : 0;
+      return { code, ratePercent: rate, exciseTaxValue: excise, discount };
+    },
+    natureOfSupplies: invoice.natureOfSupplies,
+    unitDefault: invoice.unitDefault,
+    incomeWithholdValue: invoice.incomeWithholdValue!,
+    transactionWithholdValue: invoice.transactionWithholdValue!,
+    buyerCountryCode: invoice.buyerCountryCode,
+    buyerCountryCodes: invoice.buyerCountryCodes,
+    buyerRegionCodes: invoice.buyerRegionCodes,
+    buyerWeredaCodes: invoice.buyerWeredaCodes,
+    buyerCityCodes: invoice.buyerCityCodes,
+    // TEMPORARY — see EimsInvoiceConfig.buyerIdType.
+    buyerIdType: invoice.buyerIdType,
+    buyerIdNumber: invoice.buyerIdNumber,
+    exchangeRate: input.exchangeRate ?? null,
+    documentType: input.documentType,
+    reason: input.reason ?? null,
+    relatedDocument: input.relatedDocument ?? null,
+  };
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-invoice-registration.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-invoice-registration.service.spec.ts
new file mode 100644
index 000000000..f560ff917
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-invoice-registration.service.spec.ts
@@ -0,0 +1,856 @@
+import { BadRequestException, ConflictException } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { DataSource } from "typeorm";
+
+import { EimsConfig } from "../../config/eims.config";
+import { Invoice } from "../billing/entities/invoice.entity";
+import { EimsInvoiceRequest } from "../billing/eims-invoice.mapper";
+import { eimsInvoiceConfig } from "./eims-test-fixtures";
+import { NotificationInboxService } from "../notification-inbox/notification-inbox.service";
+import { NotificationsService } from "../notifications/notifications.service";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsApiException, EimsConfigException } from "./eims.errors";
+import { buildEimsSeller } from "./eims-invoice-context";
+import { EimsInvoiceRegistrationService } from "./eims-invoice-registration.service";
+import { EimsSellerCacheService } from "./eims-seller-cache.service";
+import { EimsSystemState } from "./entities/eims-system-state.entity";
+import { EimsInvoiceStatus } from "./eims-registration.types";
+
+const SYSTEM_NUMBER = "B0360154BA";
+const INVOICE_ID = "11111111-1111-4111-8111-111111111111";
+const OTHER_INVOICE_ID = "22222222-2222-4222-8222-222222222222";
+const IRN = "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0";
+
+const config = (over: Partial<EimsConfig["invoice"]> = {}): EimsConfig =>
+  ({
+    enabled: true,
+    baseUrl: "https://core.mor.gov.et",
+    clientId: "cid",
+    clientSecret: "secret",
+    apiKey: "key",
+    tin: "0000034558",
+    systemNumber: SYSTEM_NUMBER,
+    systemType: "SYS",
+    privateKeyPath: "/dev/null",
+    certificatePath: "/dev/null",
+    httpTimeoutMs: 30_000,
+    tokenSkewMs: 45_000,
+    invoice: eimsInvoiceConfig(over),
+  }) as EimsConfig;
+
+const invoiceRow = (over: Partial<Invoice> = {}): Invoice =>
+  ({
+    id: INVOICE_ID,
+    invoiceNumber: "INV-20260807-00042",
+    currency: "ETB",
+    issuedAt: new Date(2026, 7, 7, 9, 5, 3),
+    totalAmount: "10000.00",
+    eimsStatus: EimsInvoiceStatus.NotSubmitted,
+    eimsIrn: null,
+    eimsInvoiceCounter: null,
+    eimsSubmittedAt: null,
+    eimsAckDate: null,
+    eimsLastError: null,
+    company: {
+      name: "ABC Trading PLC",
+      tin: "0999930000",
+      vatNumber: "123475885858",
+      phone: "0912345678",
+      email: "buyer@abc.et",
+      region: "13",
+      zone: "SHA",
+      woreda: "574",
+      kebele: "03",
+      houseNo: "NEW",
+      country: "Ethiopia",
+    },
+    ...over,
+  }) as unknown as Invoice;
+
+const LINES = [
+  {
+    chargeType: "RAIL_FREIGHT",
+    description: "Addis to Djibouti",
+    quantity: "1.00",
+    unitRate: "10000.00",
+    amount: "10000.00",
+  },
+];
+
+/**
+ * In-memory stand-in for the two locked rows. `update` merges, `createQueryBuilder(...).getOne()`
+ * returns the live object — enough to assert ordering, values and the reservation lifecycle without
+ * a database.
+ */
+class FakeDb {
+  invoices = new Map<string, Invoice>();
+  state: EimsSystemState | null = null;
+  /** Runs before every transaction body, to simulate a concurrent writer. */
+  onTransaction: (() => void) | null = null;
+  /** `sendCompanyChannels`'s contact lookup, when a test needs it non-empty. */
+  companyContact: { phone: string | null; email: string | null } | null = null;
+
+  constructor(invoices: Invoice[], state?: Partial<EimsSystemState>) {
+    for (const inv of invoices) this.invoices.set(inv.id, inv);
+    this.state = {
+      id: "state-1",
+      systemNumber: SYSTEM_NUMBER,
+      nextInvoiceCounter: 7,
+      nextDocumentNumber: 5,
+      previousIrn: null,
+      inFlightInvoiceId: null,
+      inFlightCounter: null,
+      inFlightDocumentNumber: null,
+      blockedReason: null,
+      ...state,
+    } as EimsSystemState;
+  }
+
+  private manager = {
+    createQueryBuilder: (entity: unknown) => {
+      const isInvoice = entity === Invoice;
+      let id: string | undefined;
+      const builder = {
+        setLock: () => builder,
+        where: (_clause: string, params: Record<string, string>) => {
+          id = params.invoiceId ?? params.systemNumber;
+          return builder;
+        },
+        getOne: async () => (isInvoice ? (this.invoices.get(id!) ?? null) : this.state),
+      };
+      return builder;
+    },
+    findOne: async (_entity: unknown, options: { where: { id: string } }) =>
+      this.invoices.get(options.where.id) ?? null,
+    update: async (entity: unknown, id: string, patch: Record<string, unknown>) => {
+      if (entity === Invoice) Object.assign(this.invoices.get(id)!, patch);
+      else Object.assign(this.state!, patch);
+    },
+    query: async () => [],
+    getRepository: () => ({
+      findOne: async (options: { where: { id: string } }) =>
+        this.invoices.get(options.where.id) ?? null,
+    }),
+  };
+
+  asDataSource(): DataSource {
+    return {
+      manager: this.manager,
+      getRepository: this.manager.getRepository,
+      query: async (sql: string) => {
+        if (sql.includes("eims_system_state")) {
+          return [{ in_flight_invoice_id: this.state?.inFlightInvoiceId ?? null }];
+        }
+        if (sql.includes("freight.companies")) return this.companyContact ? [this.companyContact] : [];
+        return LINES;
+      },
+      transaction: async (body: (m: unknown) => Promise<unknown>) => {
+        this.onTransaction?.();
+        return body(this.manager);
+      },
+    } as unknown as DataSource;
+  }
+}
+
+/** The source system comes from the access token, so the service is handed a session, not config. */
+const SESSION = { systemNumber: SYSTEM_NUMBER, systemType: "SYS" };
+
+const build = (
+  db: FakeDb,
+  postSigned: jest.Mock,
+  cfg: EimsConfig = config(),
+  postBearer: jest.Mock = jest.fn(),
+  getSessionContext: jest.Mock | undefined = undefined,
+  notify: jest.Mock = jest.fn().mockResolvedValue(undefined),
+  directSend: jest.Mock = jest.fn().mockResolvedValue(undefined),
+) =>
+  new EimsInvoiceRegistrationService(
+    db.asDataSource(),
+    { get: () => cfg } as unknown as ConfigService,
+    { postSigned, postBearer } as unknown as EimsClientService,
+    {
+      getSessionContext: getSessionContext ?? jest.fn().mockResolvedValue(SESSION),
+    } as unknown as EimsAuthService,
+    { notify } as unknown as NotificationInboxService,
+    { directSend } as unknown as NotificationsService,
+    // Same static-config seller the real EimsSellerCacheService falls back to when it has never
+    // successfully fetched e-Trade — matches prior behavior for every test in this file.
+    { getSellerDetails: (c: EimsConfig) => buildEimsSeller(c) } as unknown as EimsSellerCacheService,
+  );
+
+/**
+ * Document number the fixtures register under; `/v1/verify` must echo it back.
+ *
+ * A plain integer, not our `invoiceNumber`: MoR validates the field against
+ * `^(0|[1-9][0-9]{0,8})$`. It is allocated from `nextDocumentNumber` above.
+ */
+const DOCUMENT_NUMBER = "5";
+
+/**
+ * `/v1/verify` success. The response spells the reference `Irn` while the request sends lowercase
+ * `irn`.
+ *
+ * The fixture is deliberately *coherent* — same IRN on both sides. The supplied Postman collection
+ * pairs a saved request and a saved response whose literal IRNs disagree, which is an artefact of
+ * the mock rather than gateway behaviour; asserting against that inconsistency would encode the
+ * mock's bug as a requirement. Resolution requires the returned `Irn` to match the one asked for,
+ * and these fixtures exercise that honestly.
+ */
+const verifyResponse = (over: Record<string, unknown> = {}) => ({
+  statusCode: 200,
+  message: "SUCCESS",
+  body: {
+    Irn: IRN,
+    TransactionType: "B2B",
+    DocumentDetails: { Type: "INV", DocumentNumber: DOCUMENT_NUMBER, Date: "07-08-2026T09:05:03" },
+    Version: "1",
+    ...over,
+  },
+});
+
+const okResponse = (irn = IRN, over: Record<string, unknown> = {}) => ({
+  statusCode: 200,
+  message: "SUCCESS",
+  body: { irn, ackDate: "2026-08-07T09:05:03Z[Etc/UTC]", ...over },
+});
+
+const apiError = (kind: string, status?: number) =>
+  new EimsApiException(kind as never, `EIMS register failed (${status ?? "-"})`, status);
+
+describe("EimsInvoiceRegistrationService.registerInvoiceWithEims", () => {
+  it("registers, persists the IRN and advances the chain", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    const view = await build(db, postSigned).registerInvoiceWithEims(INVOICE_ID);
+
+    expect(postSigned).toHaveBeenCalledTimes(1);
+    expect(postSigned.mock.calls[0][0]).toBe("/v1/register");
+    expect(view).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Registered,
+      eimsIrn: IRN,
+      eimsInvoiceCounter: 7,
+      eimsAckDate: "2026-08-07T09:05:03Z[Etc/UTC]",
+    });
+    expect(db.state).toMatchObject({
+      previousIrn: IRN,
+      nextInvoiceCounter: 8,
+      inFlightInvoiceId: null,
+      inFlightCounter: null,
+      blockedReason: null,
+    });
+  });
+
+  it("persists signedQR alongside the IRN", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockResolvedValue(okResponse(IRN, { signedQR: "signed-qr-payload" }));
+
+    const view = await build(db, postSigned).registerInvoiceWithEims(INVOICE_ID);
+
+    expect(view.eimsSignedQr).toBe("signed-qr-payload");
+    expect(db.invoices.get(INVOICE_ID)?.eimsSignedQr).toBe("signed-qr-payload");
+  });
+
+  it("leaves eimsSignedQr null when the gateway does not return one", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    const view = await build(db, postSigned).registerInvoiceWithEims(INVOICE_ID);
+
+    expect(view.eimsSignedQr).toBeNull();
+  });
+
+  it("notifies the buyer company on a successful registration, without blocking the result", async () => {
+    const db = new FakeDb([invoiceRow({ companyId: "company-1" } as Partial<Invoice>)]);
+    db.companyContact = { phone: "+251911000000", email: "buyer@abc.et" };
+    const directSend = jest.fn().mockResolvedValue(undefined);
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    const view = await build(db, postSigned, config(), jest.fn(), undefined, undefined, directSend)
+      .registerInvoiceWithEims(INVOICE_ID);
+
+    expect(view.eimsStatus).toBe(EimsInvoiceStatus.Registered);
+    expect(directSend).toHaveBeenCalledWith("sms", "+251911000000", expect.stringContaining(IRN));
+    expect(directSend).toHaveBeenCalledWith("email", "buyer@abc.et", expect.stringContaining(IRN));
+  });
+
+  it("does not fail registration when the buyer notification itself fails", async () => {
+    const db = new FakeDb([invoiceRow({ companyId: "company-1" } as Partial<Invoice>)]);
+    db.companyContact = { phone: "+251911000000", email: null };
+    const directSend = jest.fn().mockRejectedValue(new Error("sms provider down"));
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    const view = await build(db, postSigned, config(), jest.fn(), undefined, undefined, directSend)
+      .registerInvoiceWithEims(INVOICE_ID);
+
+    expect(view.eimsStatus).toBe(EimsInvoiceStatus.Registered);
+  });
+
+  it("sends the exact reserved counter and previous IRN to the mapper", async () => {
+    const db = new FakeDb([invoiceRow()], { nextInvoiceCounter: 42, previousIrn: "PRIOR-IRN" });
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    await build(db, postSigned).registerInvoiceWithEims(INVOICE_ID);
+
+    const request = postSigned.mock.calls[0][1] as EimsInvoiceRequest;
+    expect(request.SourceSystem.InvoiceCounter).toBe(42);
+    expect(request.ReferenceDetails.PreviousIrn).toBe("PRIOR-IRN");
+    expect(request.DocumentDetails.DocumentNumber).toBe(DOCUMENT_NUMBER);
+    expect(request.SourceSystem.SystemNumber).toBe(SYSTEM_NUMBER);
+  });
+
+  it("files a credit note with Type/Reason/RelatedDocument from the invoice row", async () => {
+    const original = invoiceRow({
+      id: "original-invoice",
+      invoiceNumber: "INV-20260807-00001",
+      eimsIrn: IRN,
+    });
+    const db = new FakeDb([
+      invoiceRow({
+        eimsDocumentType: "CRE",
+        eimsReason: "Overbilled freight charge",
+        relatedInvoice: original,
+      } as Partial<Invoice>),
+    ]);
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    await build(db, postSigned).registerInvoiceWithEims(INVOICE_ID);
+
+    const request = postSigned.mock.calls[0][1] as EimsInvoiceRequest;
+    expect(request.DocumentDetails).toMatchObject({ Type: "CRE", Reason: "Overbilled freight charge" });
+    expect(request.ReferenceDetails.RelatedDocument).toBe(IRN);
+  });
+
+  it("refuses a credit/debit note whose related invoice was never registered, before touching a counter", async () => {
+    const original = invoiceRow({ id: "original-invoice", eimsIrn: null });
+    const db = new FakeDb([
+      invoiceRow({
+        eimsDocumentType: "DEB",
+        eimsReason: "Additional handling",
+        relatedInvoice: original,
+      } as Partial<Invoice>),
+    ]);
+    const postSigned = jest.fn();
+
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(db.state).toMatchObject({ nextInvoiceCounter: 7 }); // unchanged — never reserved
+  });
+
+  it("refuses a credit/debit note with no related invoice set at all", async () => {
+    const db = new FakeDb([
+      invoiceRow({ eimsDocumentType: "CRE", eimsReason: "x", relatedInvoice: null } as Partial<Invoice>),
+    ]);
+    const postSigned = jest.fn();
+
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+    expect(postSigned).not.toHaveBeenCalled();
+  });
+
+  it("takes SourceSystem from the token session, not from configuration", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+    // Config disagrees on purpose: only the session may reach the wire.
+    const cfg = config();
+    (cfg as { systemNumber: string }).systemNumber = "CONFIG-ONLY";
+    (cfg as { systemType: string }).systemType = "MAN";
+
+    await build(
+      db,
+      postSigned,
+      cfg,
+      jest.fn(),
+      jest.fn().mockResolvedValue({ systemNumber: "FROM-TOKEN", systemType: "POS" }),
+    ).registerInvoiceWithEims(INVOICE_ID);
+
+    const request = postSigned.mock.calls[0][1] as EimsInvoiceRequest;
+    expect(request.SourceSystem.SystemNumber).toBe("FROM-TOKEN");
+    expect(request.SourceSystem.SystemType).toBe("POS");
+  });
+
+  it("does not consume a counter when authentication fails", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn();
+    const getSessionContext = jest.fn().mockRejectedValue(new Error("login failed"));
+
+    await expect(
+      build(db, postSigned, config(), jest.fn(), getSessionContext).registerInvoiceWithEims(
+        INVOICE_ID,
+      ),
+    ).rejects.toThrow(/login failed/);
+
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(db.state).toMatchObject({ nextInvoiceCounter: 7, inFlightInvoiceId: null });
+    expect(db.invoices.get(INVOICE_ID)!.eimsStatus).toBe(EimsInvoiceStatus.NotSubmitted);
+  });
+
+  it("is idempotent — an invoice with an IRN never reaches EIMS", async () => {
+    const db = new FakeDb([
+      invoiceRow({ eimsIrn: IRN, eimsStatus: EimsInvoiceStatus.Registered }),
+    ]);
+    const postSigned = jest.fn();
+
+    const view = await build(db, postSigned).registerInvoiceWithEims(INVOICE_ID);
+
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(view.eimsIrn).toBe(IRN);
+  });
+
+  it("lets only one of two concurrent calls reach EIMS", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    let resolvePost: (v: unknown) => void = () => {};
+    const postSigned = jest
+      .fn()
+      .mockImplementation(() => new Promise((resolve) => (resolvePost = resolve)));
+    const service = build(db, postSigned);
+
+    const first = service.registerInvoiceWithEims(INVOICE_ID);
+    // Let the first reservation commit and its HTTP call start; it is now parked on `resolvePost`.
+    await new Promise((resolve) => setImmediate(resolve));
+    expect(postSigned).toHaveBeenCalledTimes(1);
+
+    const second = service.registerInvoiceWithEims(INVOICE_ID);
+
+    await expect(second).rejects.toBeInstanceOf(ConflictException);
+    resolvePost(okResponse());
+    await first;
+    expect(postSigned).toHaveBeenCalledTimes(1);
+  });
+
+  it("blocks a different invoice while a submission is in flight (survives a restart)", async () => {
+    // A committed reservation left behind by a dead process.
+    const db = new FakeDb(
+      [
+        invoiceRow({ eimsStatus: EimsInvoiceStatus.Submitting, eimsInvoiceCounter: 7 }),
+        invoiceRow({ id: OTHER_INVOICE_ID, invoiceNumber: "INV-20260807-00043" }),
+      ],
+      { inFlightInvoiceId: INVOICE_ID, inFlightCounter: 7, nextInvoiceCounter: 8 },
+    );
+    const postSigned = jest.fn();
+
+    await expect(
+      build(db, postSigned).registerInvoiceWithEims(OTHER_INVOICE_ID),
+    ).rejects.toThrow(/already in flight/);
+    expect(postSigned).not.toHaveBeenCalled();
+  });
+
+  it("fails locally on incomplete tax configuration, with zero HTTP calls", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn();
+
+    await expect(
+      build(db, postSigned, config({ taxCode: "", taxRatePercent: null })).registerInvoiceWithEims(
+        INVOICE_ID,
+      ),
+    ).rejects.toBeInstanceOf(BadRequestException);
+
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(db.invoices.get(INVOICE_ID)!.eimsStatus).toBe(EimsInvoiceStatus.NotSubmitted);
+    expect(db.state).toMatchObject({ nextInvoiceCounter: 7, inFlightInvoiceId: null });
+  });
+
+  it.each([
+    ["SCHEMA_VALIDATION", 400],
+    ["RULE_VALIDATION", 406],
+  ])("marks %s (%i) FAILED and clears the global block", async (kind, status) => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockRejectedValue(apiError(kind, status));
+
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      EimsApiException,
+    );
+
+    expect(db.invoices.get(INVOICE_ID)).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Failed,
+      eimsIrn: null,
+    });
+    expect(db.state).toMatchObject({
+      inFlightInvoiceId: null,
+      blockedReason: null,
+      previousIrn: null,
+      // Returned, not consumed: MoR tracks the sequence and rejects a gap
+      // ("Invoice counter is not correct. expected : 1").
+      nextInvoiceCounter: 7,
+    });
+  });
+
+  it("a config error (bad key, never reached MoR) rolls back both counters, no system block", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest
+      .fn()
+      .mockRejectedValue(new EimsConfigException("EIMS private key ... could not be read or parsed"));
+
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      EimsConfigException,
+    );
+
+    expect(db.invoices.get(INVOICE_ID)).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Failed,
+      eimsIrn: null,
+      eimsLastError: expect.objectContaining({ kind: "CONFIG" }),
+    });
+    expect(db.state).toMatchObject({
+      inFlightInvoiceId: null,
+      blockedReason: null,
+      previousIrn: null,
+      nextInvoiceCounter: 7,
+    });
+  });
+
+  it("a mapper failure after reservation (e.g. unmapped buyer country) also releases the reservation", async () => {
+    // Regression: toEimsInvoice/buildEimsContext used to sit outside the try/catch that calls
+    // settleFailure — a throw here left the reservation permanently orphaned (a real live incident:
+    // 500 on register, then every subsequent attempt 409'd "already in flight" until manually
+    // resolved). This never reaches postSigned at all — the mapper throws before submit() is called.
+    const db = new FakeDb([
+      invoiceRow({ company: { ...invoiceRow().company, country: "France" } as never }),
+    ]);
+    const postSigned = jest.fn();
+
+    // The mapper throws a plain Error (it's a pure function, not a NestJS layer) — that's the
+    // point: settleFailure must treat *any* non-EimsApiException as pre-wire, not just its own
+    // known exception types.
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toThrow(
+      /no MoR country code mapping/,
+    );
+
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(db.invoices.get(INVOICE_ID)).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Failed,
+      eimsLastError: expect.objectContaining({ kind: "LOCAL" }),
+    });
+    expect(db.state).toMatchObject({
+      inFlightInvoiceId: null,
+      blockedReason: null,
+      previousIrn: null,
+      nextInvoiceCounter: 7,
+    });
+  });
+
+  it("treats a success response with no IRN as a failed registration", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockResolvedValue({ statusCode: 200, body: { irn: "" } });
+
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toThrow(
+      /returned no IRN/,
+    );
+    expect(db.invoices.get(INVOICE_ID)!.eimsStatus).toBe(EimsInvoiceStatus.Failed);
+    expect(db.state).toMatchObject({ inFlightInvoiceId: null, blockedReason: null });
+  });
+
+  it("marks a timeout UNKNOWN and keeps the system blocked", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postSigned = jest.fn().mockRejectedValue(apiError("TIMEOUT"));
+
+    await expect(build(db, postSigned).registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      EimsApiException,
+    );
+
+    expect(db.invoices.get(INVOICE_ID)).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Unknown,
+      eimsIrn: null,
+    });
+    expect(db.state!.inFlightInvoiceId).toBe(INVOICE_ID);
+    expect(db.state!.blockedReason).toMatch(/never acknowledged/);
+    expect(db.state!.previousIrn).toBeNull();
+  });
+
+  it("an UNKNOWN result blocks a different invoice too", async () => {
+    const db = new FakeDb([invoiceRow(), invoiceRow({ id: OTHER_INVOICE_ID })]);
+    const postSigned = jest.fn().mockRejectedValueOnce(apiError("TIMEOUT"));
+    const service = build(db, postSigned);
+
+    await expect(service.registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      EimsApiException,
+    );
+    await expect(service.registerInvoiceWithEims(OTHER_INVOICE_ID)).rejects.toThrow(
+      /registration is blocked/,
+    );
+    expect(postSigned).toHaveBeenCalledTimes(1);
+  });
+
+  it("returns both the counter and the document number after a refusal, keeps both after an ambiguous result", async () => {
+    const db = new FakeDb([invoiceRow(), invoiceRow({ id: OTHER_INVOICE_ID })]);
+    const postSigned = jest
+      .fn()
+      .mockRejectedValueOnce(apiError("RULE_VALIDATION", 406))
+      .mockResolvedValueOnce(okResponse());
+    const service = build(db, postSigned);
+
+    await expect(service.registerInvoiceWithEims(INVOICE_ID)).rejects.toBeInstanceOf(
+      EimsApiException,
+    );
+    await service.registerInvoiceWithEims(OTHER_INVOICE_ID);
+
+    // A deterministic rejection rolls both numbers back — MoR's expected-next-value for either
+    // sequence only advances on acceptance (rule 7001 for DocumentNumber, same as InvoiceCounter).
+    const first = postSigned.mock.calls[0][1] as EimsInvoiceRequest;
+    const second = postSigned.mock.calls[1][1] as EimsInvoiceRequest;
+    expect(first.SourceSystem.InvoiceCounter).toBe(7);
+    expect(second.SourceSystem.InvoiceCounter).toBe(7);
+    expect(first.DocumentDetails.DocumentNumber).toBe("5");
+    expect(second.DocumentDetails.DocumentNumber).toBe("5");
+  });
+
+  it("blocks and alerts with the real IRN when MoR accepts but persisting it locally fails", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const notify = jest.fn().mockResolvedValue(undefined);
+    const postSigned = jest.fn().mockResolvedValue(okResponse());
+
+    // 1st/2nd calls are the reserve() updates; the 3rd is settleSuccess's invoice update — the one
+    // that actually failed live (eims_irn too narrow for the real value MoR returned).
+    let call = 0;
+    const manager = (db as unknown as { manager: { update: jest.Mock } }).manager;
+    const realUpdate = manager.update;
+    manager.update = jest.fn(async (entity: unknown, id: string, patch: Record<string, unknown>) => {
+      call++;
+      if (call === 3) throw new Error("value too long for type character varying(64)");
+      return realUpdate(entity, id, patch);
+    });
+
+    await expect(
+      build(db, postSigned, config(), jest.fn(), undefined, notify).registerInvoiceWithEims(
+        INVOICE_ID,
+      ),
+    ).rejects.toThrow(/value too long/);
+
+    // The IRN is never lost, even though the normal success path never committed.
+    expect(db.state?.blockedReason).toContain(IRN);
+    expect(db.state?.blockedReason).toContain("ACCEPTED");
+    expect(db.invoices.get(INVOICE_ID)?.eimsStatus).toBe(EimsInvoiceStatus.Submitting);
+
+    expect(notify).toHaveBeenCalledTimes(1);
+    const sent = notify.mock.calls[0][0];
+    expect(sent.priority).toBe("HIGH");
+    expect(sent.body).toContain(IRN);
+  });
+});
+
+describe("EimsInvoiceRegistrationService staff alerting", () => {
+  it("raises a high-priority alert when a result is ambiguous, because all filing is blocked", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const notify = jest.fn().mockResolvedValue(undefined);
+    const postSigned = jest.fn().mockRejectedValue(apiError("TIMEOUT"));
+
+    await expect(
+      build(db, postSigned, config(), jest.fn(), undefined, notify).registerInvoiceWithEims(
+        INVOICE_ID,
+      ),
+    ).rejects.toBeInstanceOf(EimsApiException);
+
+    expect(notify).toHaveBeenCalledTimes(1);
+    const sent = notify.mock.calls[0][0];
+    expect(sent.priority).toBe("HIGH");
+    expect(sent.title).toMatch(/blocked/i);
+    expect(sent.recipients.permissionKeys).toContain("edr_freight_app:invoices:eims_resolve");
+  });
+
+  it("raises a normal-priority alert for a deterministic rejection", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const notify = jest.fn().mockResolvedValue(undefined);
+    const postSigned = jest.fn().mockRejectedValue(apiError("RULE_VALIDATION", 406));
+
+    await expect(
+      build(db, postSigned, config(), jest.fn(), undefined, notify).registerInvoiceWithEims(
+        INVOICE_ID,
+      ),
+    ).rejects.toBeInstanceOf(EimsApiException);
+
+    expect(notify.mock.calls[0][0].priority).toBe("NORMAL");
+  });
+
+  it("does not alert on a successful filing", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const notify = jest.fn();
+
+    await build(db, jest.fn().mockResolvedValue(okResponse()), config(), jest.fn(), undefined, notify)
+      .registerInvoiceWithEims(INVOICE_ID);
+
+    expect(notify).not.toHaveBeenCalled();
+  });
+
+  it("lets the filing outcome stand even if the alert itself fails", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const notify = jest.fn().mockRejectedValue(new Error("inbox down"));
+    const postSigned = jest.fn().mockRejectedValue(apiError("RULE_VALIDATION", 406));
+
+    await expect(
+      build(db, postSigned, config(), jest.fn(), undefined, notify).registerInvoiceWithEims(
+        INVOICE_ID,
+      ),
+    ).rejects.toThrow(/EIMS register failed \(406\)/);
+
+    expect(db.invoices.get(INVOICE_ID)!.eimsStatus).toBe(EimsInvoiceStatus.Failed);
+  });
+});
+
+describe("EimsInvoiceRegistrationService.verifyInvoiceWithEims", () => {
+  it("verifies the stored IRN over the unsigned bearer transport", async () => {
+    const db = new FakeDb([invoiceRow({ eimsIrn: IRN })]);
+    const postSigned = jest.fn();
+    const postBearer = jest.fn().mockResolvedValue(verifyResponse());
+
+    const result = await build(db, postSigned, config(), postBearer).verifyInvoiceWithEims(
+      INVOICE_ID,
+    );
+
+    // Lowercase `irn`, raw body — not a signed envelope. `postSigned` must stay untouched.
+    expect(postBearer).toHaveBeenCalledWith("/v1/verify", { irn: IRN });
+    expect(postSigned).not.toHaveBeenCalled();
+    expect(result.body).toMatchObject({ Irn: IRN });
+  });
+
+  it("rejects a 200 that carries no Irn", async () => {
+    const db = new FakeDb([invoiceRow({ eimsIrn: IRN })]);
+    const postBearer = jest.fn().mockResolvedValue({ statusCode: 200, body: { Irn: "  " } });
+
+    await expect(
+      build(db, jest.fn(), config(), postBearer).verifyInvoiceWithEims(INVOICE_ID),
+    ).rejects.toThrow(/returned no Irn/);
+  });
+
+  it("refuses to verify an invoice with no IRN", async () => {
+    const db = new FakeDb([invoiceRow({ eimsStatus: EimsInvoiceStatus.Unknown })]);
+    const postBearer = jest.fn();
+
+    await expect(
+      build(db, jest.fn(), config(), postBearer).verifyInvoiceWithEims(INVOICE_ID),
+    ).rejects.toThrow(/no EIMS IRN to verify/);
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+});
+
+describe("EimsInvoiceRegistrationService.resolveEimsRegistration", () => {
+  const blocked = () =>
+    new FakeDb(
+      [
+        invoiceRow({
+          eimsStatus: EimsInvoiceStatus.Unknown,
+          eimsInvoiceCounter: 7,
+          eimsDocumentNumber: DOCUMENT_NUMBER,
+        }),
+      ],
+      {
+      inFlightInvoiceId: INVOICE_ID,
+      inFlightCounter: 7,
+      nextInvoiceCounter: 8,
+      blockedReason: "never acknowledged",
+    });
+
+  it("records a confirmed IRN, resumes the chain and clears the block", async () => {
+    const db = blocked();
+    const postBearer = jest.fn().mockResolvedValue(verifyResponse());
+
+    const view = await build(db, jest.fn(), config(), postBearer).resolveEimsRegistration(
+      INVOICE_ID,
+      { irn: IRN },
+    );
+
+    // The IRN is confirmed at the gateway before it is ever written.
+    expect(postBearer).toHaveBeenCalledWith("/v1/verify", { irn: IRN });
+    expect(view).toMatchObject({ eimsStatus: EimsInvoiceStatus.Registered, eimsIrn: IRN });
+    expect(db.state).toMatchObject({
+      previousIrn: IRN,
+      inFlightInvoiceId: null,
+      blockedReason: null,
+    });
+  });
+
+  it("refuses an IRN the gateway answers with a different one, leaving the block intact", async () => {
+    const db = blocked();
+    const postBearer = jest
+      .fn()
+      .mockResolvedValue(verifyResponse({ Irn: "0000000000000000000000000000000000000000" }));
+
+    await expect(
+      build(db, jest.fn(), config(), postBearer).resolveEimsRegistration(INVOICE_ID, { irn: IRN }),
+    ).rejects.toThrow(/answered the lookup for IRN/);
+
+    expect(db.invoices.get(INVOICE_ID)).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Unknown,
+      eimsIrn: null,
+    });
+    expect(db.state).toMatchObject({
+      inFlightInvoiceId: INVOICE_ID,
+      blockedReason: "never acknowledged",
+      previousIrn: null,
+    });
+  });
+
+  it("refuses an IRN whose document number is not this invoice, leaving the block intact", async () => {
+    const db = blocked();
+    const postBearer = jest.fn().mockResolvedValue(
+      verifyResponse({
+        DocumentDetails: { Type: "INV", DocumentNumber: "99999" },
+      }),
+    );
+
+    await expect(
+      build(db, jest.fn(), config(), postBearer).resolveEimsRegistration(INVOICE_ID, { irn: IRN }),
+    ).rejects.toThrow(/not 5/);
+
+    expect(db.invoices.get(INVOICE_ID)).toMatchObject({
+      eimsStatus: EimsInvoiceStatus.Unknown,
+      eimsIrn: null,
+    });
+    expect(db.state).toMatchObject({
+      inFlightInvoiceId: INVOICE_ID,
+      blockedReason: "never acknowledged",
+      previousIrn: null,
+    });
+  });
+
+  it("refuses an IRN the gateway does not acknowledge at all", async () => {
+    const db = blocked();
+    const postBearer = jest.fn().mockResolvedValue({ statusCode: 200, body: {} });
+
+    await expect(
+      build(db, jest.fn(), config(), postBearer).resolveEimsRegistration(INVOICE_ID, { irn: IRN }),
+    ).rejects.toThrow(/returned no Irn/);
+    expect(db.state!.blockedReason).toBe("never acknowledged");
+  });
+
+  it("discards the attempt, leaving the chain where it was", async () => {
+    const db = blocked();
+    const postBearer = jest.fn();
+
+    const view = await build(db, jest.fn(), config(), postBearer).resolveEimsRegistration(
+      INVOICE_ID,
+      { discard: true },
+    );
+
+    expect(view).toMatchObject({ eimsStatus: EimsInvoiceStatus.Failed, eimsIrn: null });
+    expect(postBearer).not.toHaveBeenCalled(); // nothing to confirm
+    expect(db.state).toMatchObject({
+      previousIrn: null,
+      inFlightInvoiceId: null,
+      blockedReason: null,
+    });
+  });
+
+  it("refuses to resolve an invoice that is not the in-flight one", async () => {
+    const db = blocked();
+    db.invoices.set(
+      OTHER_INVOICE_ID,
+      invoiceRow({ id: OTHER_INVOICE_ID, eimsDocumentNumber: "6" }),
+    );
+    const postBearer = jest.fn().mockResolvedValue(verifyResponse());
+
+    await expect(
+      build(db, jest.fn(), config(), postBearer).resolveEimsRegistration(OTHER_INVOICE_ID, {
+        irn: IRN,
+      }),
+    ).rejects.toThrow(/in-flight EIMS submission is invoice/);
+  });
+
+  it("requires either an IRN or an explicit discard", async () => {
+    await expect(
+      build(blocked(), jest.fn()).resolveEimsRegistration(INVOICE_ID, {}),
+    ).rejects.toBeInstanceOf(BadRequestException);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-invoice-registration.service.ts b/apps/edr-freight-api/src/modules/eims/eims-invoice-registration.service.ts
new file mode 100644
index 000000000..a823e5ddf
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-invoice-registration.service.ts
@@ -0,0 +1,706 @@
+import {
+  BadRequestException,
+  ConflictException,
+  Injectable,
+  Logger,
+  NotFoundException,
+} from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { InjectDataSource } from "@nestjs/typeorm";
+import { DataSource, EntityManager } from "typeorm";
+import type { QueryDeepPartialEntity } from "typeorm/query-builder/QueryPartialEntity.js";
+
+import { EimsConfig } from "../../config/eims.config";
+import { Invoice } from "../billing/entities/invoice.entity";
+import {
+  EimsDocumentType,
+  EimsInvoiceRequest,
+  EimsMapperLine,
+  toEimsInvoice,
+} from "../billing/eims-invoice.mapper";
+import { NotificationAudience, NotificationPriority, NotificationType } from "@edr/types";
+import { NotificationInboxService } from "../notification-inbox/notification-inbox.service";
+import { NotificationsService } from "../notifications/notifications.service";
+import { sendCompanyChannels } from "../notifications/notify-company.util";
+import { toEimsInvoiceStatusView } from "./eims-invoice-view.util";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsApiException, EimsConfigException } from "./eims.errors";
+import { EimsSellerCacheService } from "./eims-seller-cache.service";
+import { EimsSystemState } from "./entities/eims-system-state.entity";
+import { assertEimsInvoiceConfig, buildEimsContext } from "./eims-invoice-context";
+import {
+  EimsInvoiceError,
+  EimsInvoiceStatus,
+  EimsInvoiceStatusView,
+  EimsRegisterResponse,
+  EimsVerifyRequest,
+  EimsVerifyResponse,
+} from "./eims-registration.types";
+
+/**
+ * Failure kinds where the gateway gave a complete answer: the document was rejected and is
+ * definitively not registered. These clear the system-wide block; anything else does not.
+ */
+const DETERMINISTIC_KINDS = new Set(["SCHEMA_VALIDATION", "RULE_VALIDATION", "AUTH", "FORBIDDEN"]);
+
+interface Reservation {
+  stateId: string;
+  invoiceCounter: number;
+  /** MoR requires a plain integer here, so it cannot be our own `invoiceNumber`. */
+  documentNumber: string;
+  previousIrn: string;
+}
+
+/**
+ * Registers a single invoice with MoR EIMS.
+ *
+ * Sequencing is a **durable reservation**: the counter is consumed and the holder recorded in a
+ * committed transaction *before* the request leaves the process, and the network call happens
+ * outside any transaction. That gives three properties the naive design could not:
+ *
+ *  - a counter is never reused once an attempt has begun, even across a crash;
+ *  - a crash mid-flight leaves the reservation standing, so nothing blindly resubmits a document
+ *    that may already have reached MoR;
+ *  - an ambiguous result blocks every invoice for the system number, not just its own, because
+ *    `PreviousIrn` is unknown and any later document would chain to a stale IRN.
+ *
+ * Signing, authentication and error normalisation belong to `EimsClientService`. Manual only —
+ * nothing in invoice creation calls this.
+ */
+@Injectable()
+export class EimsInvoiceRegistrationService {
+  private readonly logger = new Logger(EimsInvoiceRegistrationService.name);
+
+  constructor(
+    @InjectDataSource() private readonly dataSource: DataSource,
+    private readonly config: ConfigService,
+    private readonly client: EimsClientService,
+    private readonly auth: EimsAuthService,
+    private readonly inbox: NotificationInboxService,
+    private readonly notifications: NotificationsService,
+    private readonly sellerCache: EimsSellerCacheService,
+  ) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  async registerInvoiceWithEims(invoiceId: string): Promise<EimsInvoiceStatusView> {
+    const cfg = this.cfg;
+    // Static seller/tax configuration is validated before anything is locked, allocated or sent.
+    assertEimsInvoiceConfig(cfg);
+
+    const invoice = await this.loadInvoiceForMapping(invoiceId);
+    if (invoice.eimsIrn) return this.toView(invoice);
+
+    // Debit/credit notes (confirmed by MoR support: same endpoint, Type DEB/CRE + Reason,
+    // ReferenceDetails.RelatedDocument = the original's IRN) must fail here — before a counter is
+    // touched — if the original was never actually registered.
+    const documentType = (invoice.eimsDocumentType as EimsDocumentType | undefined) ?? "INV";
+    let relatedDocument: string | null = null;
+    if (documentType !== "INV") {
+      if (!invoice.relatedInvoice) {
+        throw new BadRequestException({
+          code: "EIMS_RELATED_INVOICE_REQUIRED",
+          message: `Invoice ${invoice.invoiceNumber} is a ${documentType} but has no related invoice set.`,
+        });
+      }
+      if (!invoice.relatedInvoice.eimsIrn) {
+        throw new BadRequestException({
+          code: "EIMS_RELATED_INVOICE_NOT_REGISTERED",
+          message: `Invoice ${invoice.invoiceNumber} is a ${documentType} against invoice ${invoice.relatedInvoice.invoiceNumber}, which was never registered with EIMS — nothing to reference.`,
+        });
+      }
+      relatedDocument = invoice.relatedInvoice.eimsIrn;
+    }
+
+    // Authenticate before reserving: the source system comes from the token, and the state row is
+    // keyed by it. A login failure here costs nothing — no counter has been consumed yet.
+    const session = await this.auth.getSessionContext();
+
+    const reservation = await this.reserve(invoiceId, session.systemNumber);
+    if (!reservation) return this.getEimsStatus(invoiceId);
+
+    let irn: string;
+    let ackDate: string | undefined;
+    let signedQR: string | undefined;
+    try {
+      // The request can only be built now: InvoiceCounter and PreviousIrn come from the
+      // reservation. Building it — and everything after — stays inside this try: a reservation is
+      // held from here on, and *any* failure past this point, mapper or wire, must release it
+      // through settleFailure rather than leave it orphaned as a permanent system-wide block.
+      const request = toEimsInvoice(
+        invoice,
+        this.sellerCache.getSellerDetails(cfg),
+        buildEimsContext(cfg, {
+          // Allocated from the system state, not our invoiceNumber: MoR validates DocumentNumber
+          // against ^(0|[1-9][0-9]{0,8})$, which "INV-20260807-00006" can never satisfy.
+          documentNumber: reservation.documentNumber,
+          invoiceCounter: reservation.invoiceCounter,
+          previousIrn: reservation.previousIrn,
+          session,
+          documentType,
+          reason: invoice.eimsReason,
+          relatedDocument,
+        }),
+      );
+      // Deliberately outside every transaction — no DB lock is held across the wire.
+      const result = await this.submit(request);
+      irn = result.irn;
+      ackDate = result.ackDate;
+      signedQR = result.signedQR;
+    } catch (err) {
+      await this.settleFailure(invoiceId, reservation, err);
+      throw err;
+    }
+
+    try {
+      await this.settleSuccess(invoiceId, reservation, irn, ackDate, signedQR);
+    } catch (err) {
+      // MoR already accepted this document — unlike settleFailure's targets, this is not
+      // ambiguous, it is a *known* IRN we simply failed to persist (confirmed live 2026-08-12: a
+      // column too narrow for a real IRN). Losing it here would be worse than the persistence
+      // bug itself, so it goes straight into the block reason and the alert, not just a log line.
+      await this.blockOnKnownIrnPersistFailure(invoiceId, reservation, irn, ackDate, err);
+      throw err;
+    }
+    this.logger.log(
+      `Invoice ${invoice.invoiceNumber} registered with EIMS (counter ${reservation.invoiceCounter})`,
+    );
+    return this.getEimsStatus(invoiceId);
+  }
+
+  /**
+   * Verify a registered invoice at `POST /v1/verify`.
+   *
+   * Requires a stored IRN. An invoice whose submission was never acknowledged cannot be reconciled
+   * here — the gateway offers no lookup by document number — so it must be resolved with MoR and
+   * recorded through `resolveEimsRegistration`.
+   */
+  async verifyInvoiceWithEims(invoiceId: string): Promise<EimsVerifyResponse> {
+    const invoice = await this.loadInvoiceRow(this.dataSource.manager, invoiceId);
+    if (!invoice.eimsIrn) {
+      throw new BadRequestException({
+        code: "EIMS_NO_IRN",
+        message:
+          `Invoice ${invoice.invoiceNumber} has no EIMS IRN to verify (status ${invoice.eimsStatus}). ` +
+          "EIMS can only be queried by IRN, so an unacknowledged submission must be resolved with MoR first.",
+      });
+    }
+    return this.queryVerify(invoice.eimsIrn);
+  }
+
+  /**
+   * `POST /v1/verify` for one IRN, with the one check that always applies: the gateway must echo
+   * an `Irn` back. A 200 without it is not a confirmation of anything.
+   *
+   * The request property is lowercase `irn`; the response spells it `Irn`. The two are never
+   * compared — the supplied collection's own fixture uses different example values on each side,
+   * so equality there would assert a property of the mock rather than of the gateway.
+   *
+   * Bearer-authenticated but unsigned, via `postBearer` — see that method for why.
+   */
+  private async queryVerify(irn: string): Promise<EimsVerifyResponse> {
+    const response = await this.client.postBearer<EimsVerifyRequest, EimsVerifyResponse>(
+      "/v1/verify",
+      { irn },
+    );
+    if (!response?.body?.Irn?.trim()) {
+      throw new EimsApiException(
+        "SCHEMA_VALIDATION",
+        "EIMS verify returned no Irn in its response body",
+        response?.statusCode,
+      );
+    }
+    return response;
+  }
+
+  /**
+   * Refuse a manual resolution unless the gateway confirms *both* halves of the claim: that this
+   * IRN is the one it holds, and that it belongs to this invoice.
+   *
+   * The document-number check is against `DocumentDetails.DocumentNumber`, which registration
+   * allocated and stored on the invoice as `eimsDocumentNumber` — the only field tying an IRN back
+   * to a row in this database.
+   *
+   * Recording a wrong IRN is not a local mistake: it marks an unregistered invoice as filed and
+   * chains every later document to a stranger's reference, so both checks are refusals rather
+   * than warnings.
+   */
+  private async assertIrnBelongsToInvoice(
+    irn: string,
+    expectedDocumentNumber: string,
+  ): Promise<void> {
+    const response = await this.queryVerify(irn);
+    const returnedIrn = response.body?.Irn?.trim();
+    const documentNumber = response.body?.DocumentDetails?.DocumentNumber?.trim();
+
+    if (returnedIrn !== irn) {
+      throw new ConflictException({
+        code: "EIMS_RESOLVE_IRN_MISMATCH",
+        message:
+          `EIMS answered the lookup for IRN ${irn} with ${returnedIrn ?? "(none)"}. ` +
+          "Refusing to record it — recheck the IRN in the MoR portal.",
+      });
+    }
+
+    if (documentNumber !== expectedDocumentNumber) {
+      throw new ConflictException({
+        code: "EIMS_RESOLVE_DOCUMENT_MISMATCH",
+        message:
+          `EIMS reports IRN ${irn} against document ${documentNumber ?? "(none)"}, not ` +
+          `${expectedDocumentNumber}. Refusing to record it — recheck the IRN in the MoR portal.`,
+      });
+    }
+  }
+
+  /**
+   * Manual reconciliation of a blocked system number.
+   *
+   * With an `irn` (found in the MoR portal) the invoice is recorded as registered and the chain
+   * resumes from it. With `discard` the invoice is marked failed and the chain resumes from the
+   * previous IRN. Either way the block is cleared — this is the only exit from an ambiguous result.
+   *
+   * An IRN is never taken on trust: it is verified at the gateway first, and the document it
+   * belongs to must be *this* invoice. A transposed digit would otherwise chain every later
+   * document to a stranger's IRN and mark this invoice registered when it is not.
+   */
+  async resolveEimsRegistration(
+    invoiceId: string,
+    input: { irn?: string; discard?: boolean },
+  ): Promise<EimsInvoiceStatusView> {
+    const irn = input.irn?.trim();
+    if (!irn && !input.discard) {
+      throw new BadRequestException({
+        code: "EIMS_RESOLVE_INPUT_REQUIRED",
+        message: "Provide the IRN confirmed with MoR, or discard: true to abandon the submission",
+      });
+    }
+
+    // Cheap ownership check before touching the gateway: resolving an invoice that does not hold
+    // the reservation is a caller mistake, not something to spend a MoR round trip on. The
+    // authoritative re-check happens under lock in the transaction below.
+    const [preState]: { in_flight_invoice_id: string | null }[] = await this.dataSource.query(
+      `SELECT in_flight_invoice_id FROM freight.eims_system_state
+        WHERE system_number = $1 AND deleted_at IS NULL LIMIT 1`,
+      [(await this.auth.getSessionContext()).systemNumber],
+    );
+    if (preState?.in_flight_invoice_id && preState.in_flight_invoice_id !== invoiceId) {
+      throw new ConflictException({
+        code: "EIMS_RESOLVE_WRONG_INVOICE",
+        message: `The in-flight EIMS submission is invoice ${preState.in_flight_invoice_id}, not ${invoiceId}`,
+      });
+    }
+
+    // Outside the transaction: no lock is held across the wire, and a refused verification must
+    // leave the block exactly as it was.
+    if (irn) {
+      const invoice = await this.loadInvoiceRow(this.dataSource.manager, invoiceId);
+      if (!invoice.eimsDocumentNumber) {
+        throw new BadRequestException({
+          code: "EIMS_NO_DOCUMENT_NUMBER",
+          message:
+            `Invoice ${invoice.invoiceNumber} was never allocated an EIMS document number, so a ` +
+            "returned IRN cannot be tied back to it.",
+        });
+      }
+      await this.assertIrnBelongsToInvoice(irn, invoice.eimsDocumentNumber);
+    }
+
+    // Same source of truth as registration: the state row is keyed by the token's system number.
+    const session = await this.auth.getSessionContext();
+
+    await this.dataSource.transaction(async (manager) => {
+      const state = await this.lockSystemState(manager, session.systemNumber);
+      if (state.inFlightInvoiceId && state.inFlightInvoiceId !== invoiceId) {
+        throw new ConflictException({
+          code: "EIMS_RESOLVE_WRONG_INVOICE",
+          message: `The in-flight EIMS submission is invoice ${state.inFlightInvoiceId}, not ${invoiceId}`,
+        });
+      }
+      const invoice = await this.lockInvoice(manager, invoiceId);
+      if (invoice.eimsIrn) {
+        throw new ConflictException({
+          code: "EIMS_ALREADY_REGISTERED",
+          message: `Invoice ${invoice.invoiceNumber} already has IRN ${invoice.eimsIrn}`,
+        });
+      }
+
+      await manager.update(Invoice, invoiceId, {
+        eimsStatus: irn ? EimsInvoiceStatus.Registered : EimsInvoiceStatus.Failed,
+        eimsIrn: irn ?? null,
+      });
+      await manager.update(EimsSystemState, state.id, {
+        // Only a confirmed IRN may advance the chain; a discard leaves it where it was.
+        ...(irn ? { previousIrn: irn } : {}),
+        inFlightInvoiceId: null,
+        inFlightCounter: null,
+        inFlightDocumentNumber: null,
+        blockedReason: null,
+      });
+    });
+
+    this.logger.warn(
+      `EIMS block on invoice ${invoiceId} resolved manually (${irn ? "IRN recorded" : "discarded"})`,
+    );
+    return this.getEimsStatus(invoiceId);
+  }
+
+  async getEimsStatus(invoiceId: string): Promise<EimsInvoiceStatusView> {
+    return this.toView(await this.loadInvoiceRow(this.dataSource.manager, invoiceId));
+  }
+
+  // ── transactions ─────────────────────────────────────────────────────────────────────────────
+
+  /**
+   * TX1. Consume a counter and record the holder, committed before any HTTP call. Returns `null`
+   * when the invoice turned out to be registered already (checked under the lock).
+   */
+  private async reserve(invoiceId: string, systemNumber: string): Promise<Reservation | null> {
+    return this.dataSource.transaction(async (manager) => {
+      const state = await this.lockSystemState(manager, systemNumber);
+
+      if (state.blockedReason) {
+        throw new ConflictException({
+          code: "EIMS_SYSTEM_BLOCKED",
+          message:
+            `EIMS registration is blocked for system ${systemNumber}: ${state.blockedReason}. ` +
+            "Resolve the affected invoice before registering anything else.",
+        });
+      }
+      if (state.inFlightInvoiceId) {
+        throw new ConflictException({
+          code: "EIMS_SUBMISSION_IN_FLIGHT",
+          message:
+            `A submission for invoice ${state.inFlightInvoiceId} is already in flight on system ` +
+            `${systemNumber}. Wait for it to settle, or resolve it if the process was interrupted.`,
+        });
+      }
+
+      const invoice = await this.lockInvoice(manager, invoiceId);
+      if (invoice.eimsIrn) return null;
+
+      const invoiceCounter = Number(state.nextInvoiceCounter);
+      const documentNumber = String(Number(state.nextDocumentNumber));
+      const previousIrn = state.previousIrn ?? "";
+
+      // Counter consumed here, not on success: once an attempt begins it can never be reused,
+      // whatever happens next. A gap is harmless at MoR; a collision is not.
+      await manager.update(EimsSystemState, state.id, {
+        nextInvoiceCounter: invoiceCounter + 1,
+        nextDocumentNumber: Number(documentNumber) + 1,
+        inFlightInvoiceId: invoiceId,
+        inFlightCounter: invoiceCounter,
+        inFlightDocumentNumber: Number(documentNumber),
+      });
+      await manager.update(Invoice, invoiceId, {
+        eimsStatus: EimsInvoiceStatus.Submitting,
+        eimsInvoiceCounter: invoiceCounter,
+        eimsDocumentNumber: documentNumber,
+        eimsSubmittedAt: new Date(),
+        eimsLastError: null,
+      });
+
+      return { stateId: state.id, invoiceCounter, documentNumber, previousIrn };
+    });
+  }
+
+  /** TX2a. Record the IRN, advance the chain, release the reservation. */
+  private async settleSuccess(
+    invoiceId: string,
+    reservation: Reservation,
+    irn: string,
+    ackDate?: string,
+    signedQR?: string,
+  ): Promise<void> {
+    let companyId: string | undefined;
+    let invoiceNumber = invoiceId;
+    await this.dataSource.transaction(async (manager) => {
+      const invoice = await this.lockInvoice(manager, invoiceId);
+      companyId = invoice.companyId ?? undefined;
+      invoiceNumber = invoice.invoiceNumber;
+      await manager.update(Invoice, invoiceId, {
+        eimsStatus: EimsInvoiceStatus.Registered,
+        eimsIrn: irn,
+        eimsAckDate: ackDate ?? null,
+        eimsSignedQr: signedQR ?? null,
+        eimsLastError: null,
+      });
+      await manager.update(EimsSystemState, reservation.stateId, {
+        previousIrn: irn,
+        inFlightInvoiceId: null,
+        inFlightCounter: null,
+        inFlightDocumentNumber: null,
+        blockedReason: null,
+      });
+    });
+
+    // Best-effort, outside the transaction: MoR checklist ADD-N001 wants the buyer notified of a
+    // registration event. Never lets a notification failure mask a filing that already succeeded.
+    if (companyId) {
+      try {
+        await sendCompanyChannels(
+          this.dataSource,
+          this.notifications,
+          companyId,
+          `Invoice ${invoiceNumber} has been registered with MoR EIMS. Reference (IRN): ${irn}`,
+        );
+      } catch (err) {
+        this.logger.warn(`EIMS buyer notification failed for invoice ${invoiceId}: ${(err as Error).message}`);
+      }
+    }
+  }
+
+  /**
+   * TX2b. A deterministic rejection releases the reservation **and returns both numbers**; an
+   * ambiguous result keeps both and blocks the system number, because `PreviousIrn` is now unknown
+   * for every later document.
+   *
+   * Both `InvoiceCounter` and `DocumentNumber` roll back together on a deterministic rejection —
+   * MoR's own expected-next-value only advances on acceptance, for both fields:
+   *
+   *  - `InvoiceCounter`: "Invoice counter is not correct. expected : 1".
+   *  - `DocumentNumber`: "Document number error. Document number is not in correct sequence
+   *    expected : 1" (rule 7001) — confirmed live 2026-08-12. An earlier design burned
+   *    `DocumentNumber` forward on every attempt, reasoning from a separate "Document number is
+   *    not unique" rejection; that turned out to describe the same constraint from the other side
+   *    (MoR rejects both reuse *and* skipping ahead of its true next value), and burning forward on
+   *    every rejection permanently drifted past what MoR would ever accept again — confirmed live
+   *    when two rejected self-test attempts deadlocked the sequence until a manual DB reset.
+   *
+   * An ambiguous result keeps both: MoR may have counted and stored the document.
+   *
+   * Any error that is *not* an `EimsApiException` is also deterministic, on a different basis:
+   * every error that actually touches the wire is normalized to `EimsApiException` before it gets
+   * here (`EimsClientService.send()`'s catch calls `toEimsApiException` on whatever the HTTP call
+   * threw). The try block this feeds covers request-building (`toEimsInvoice`/`buildEimsContext` —
+   * pure, no I/O) and `submit()`; nothing in that span can produce another exception shape by
+   * touching MoR. So a non-`EimsApiException` here — a mapper validation error (unmapped buyer
+   * country, say), `EimsConfigException` from a bad signing key, or a bug — failed strictly before
+   * any HTTP call went out, and releasing the reservation is always safe, never a guess.
+   */
+  private async settleFailure(
+    invoiceId: string,
+    reservation: Reservation,
+    err: unknown,
+  ): Promise<void> {
+    const api = err instanceof EimsApiException ? err : null;
+    // Never touched the wire (see the doc comment above) — always safe to release, whatever it is.
+    const deterministic = api ? DETERMINISTIC_KINDS.has(api.kind) : true;
+    const status = deterministic ? EimsInvoiceStatus.Failed : EimsInvoiceStatus.Unknown;
+    const localKind = err instanceof EimsConfigException ? "CONFIG" : "LOCAL";
+    const lastError: EimsInvoiceError = {
+      kind: api?.kind ?? localKind,
+      message: (err as Error)?.message ?? "unknown error",
+      httpStatus: api?.httpStatus,
+      details: api?.details,
+      at: new Date().toISOString(),
+    };
+
+    await this.dataSource.transaction(async (manager) => {
+      await manager.update(Invoice, invoiceId, {
+        eimsStatus: status,
+        eimsLastError: lastError,
+      } as QueryDeepPartialEntity<Invoice>);
+
+      await manager.update(
+        EimsSystemState,
+        reservation.stateId,
+        deterministic
+          ? {
+              // Both return: MoR never counted a refused document against either sequence.
+              nextInvoiceCounter: reservation.invoiceCounter,
+              nextDocumentNumber: Number(reservation.documentNumber),
+              inFlightInvoiceId: null,
+              inFlightCounter: null,
+              inFlightDocumentNumber: null,
+              blockedReason: null,
+            }
+          : {
+              blockedReason:
+                `Invoice ${invoiceId} was submitted with counter ${reservation.invoiceCounter} but ` +
+                `never acknowledged (${lastError.kind}). Its IRN is unknown, so no further document ` +
+                "can be chained until it is resolved with MoR.",
+            },
+      );
+    });
+
+    this.logger.error(`Invoice ${invoiceId} EIMS registration ${status}: ${lastError.message}`);
+    await this.alertStaff(invoiceId, status, lastError, deterministic);
+  }
+
+  /**
+   * MoR accepted the document (a real IRN came back) but recording that locally failed — the
+   * reservation is still held from TX1, so the system-wide block goes on regardless of *why*
+   * `settleSuccess` failed. The IRN and ack date are written straight into `blockedReason` so a
+   * human resolving this never has to dig through logs for the one thing that must not be lost.
+   */
+  private async blockOnKnownIrnPersistFailure(
+    invoiceId: string,
+    reservation: Reservation,
+    irn: string,
+    ackDate: string | undefined,
+    err: unknown,
+  ): Promise<void> {
+    const reason =
+      `Invoice ${invoiceId} was ACCEPTED by EIMS (IRN ${irn}${ackDate ? `, ack ${ackDate}` : ""}) ` +
+      `but recording it locally failed: ${(err as Error)?.message ?? "unknown error"}. Resolve with ` +
+      `POST /invoices/${invoiceId}/eims/resolve using this IRN once the underlying issue is fixed — ` +
+      "do not resubmit, the document already exists at MoR.";
+
+    try {
+      await this.dataSource.manager.update(EimsSystemState, reservation.stateId, { blockedReason: reason });
+    } catch (updateErr) {
+      // Even the block itself failed to write — last resort is the log, since there is nothing
+      // left to retry into.
+      this.logger.error(`Could not record EIMS block for invoice ${invoiceId}: ${reason}`, updateErr as Error);
+      return;
+    }
+
+    this.logger.error(reason);
+    // Not alertStaff(): its canned copy for a non-deterministic result always says "the IRN is
+    // unknown", which is false here — the whole point of this path is that the IRN *is* known.
+    try {
+      await this.inbox.notify({
+        recipients: { permissionKeys: [FREIGHT_PERMS.invoices.eimsResolve] },
+        audience: NotificationAudience.BACKOFFICE,
+        type: NotificationType.GENERIC,
+        priority: NotificationPriority.HIGH,
+        title: "EIMS accepted an invoice but it was not recorded — all further filing is blocked",
+        body: reason,
+        link: `/dashboard/invoices/${invoiceId}`,
+        data: { invoiceId, eimsStatus: EimsInvoiceStatus.Unknown, irn, action: "EIMS_PERSIST_FAILED" },
+      });
+    } catch (notifyErr) {
+      this.logger.warn(`EIMS staff alert failed for invoice ${invoiceId}: ${(notifyErr as Error).message}`);
+    }
+  }
+
+  /**
+   * Tell the people who can act about a failed filing.
+   *
+   * An ambiguous result is the urgent one: it blocks *every* further invoice for this system
+   * number until a human resolves it, and nothing else in the system would surface that — the
+   * sweep just goes quiet. A deterministic rejection affects one invoice, so it is normal
+   * priority. Never throws: an alert that fails must not mask the filing outcome.
+   */
+  private async alertStaff(
+    invoiceId: string,
+    status: EimsInvoiceStatus,
+    error: EimsInvoiceError,
+    deterministic: boolean,
+  ): Promise<void> {
+    try {
+      await this.inbox.notify({
+        recipients: { permissionKeys: [FREIGHT_PERMS.invoices.eimsResolve] },
+        audience: NotificationAudience.BACKOFFICE,
+        type: NotificationType.GENERIC,
+        priority: deterministic ? NotificationPriority.NORMAL : NotificationPriority.HIGH,
+        title: deterministic
+          ? error.kind === "CONFIG" || error.kind === "LOCAL"
+            ? "EIMS filing failed before reaching MoR"
+            : "EIMS rejected an invoice"
+          : "EIMS filing unresolved — all further filing is blocked",
+        body: deterministic
+          ? error.kind === "CONFIG" || error.kind === "LOCAL"
+            ? `${error.kind === "CONFIG" ? "EIMS is misconfigured" : "Filing failed locally"}: ${error.message}. Nothing was sent to MoR; fix it and file again.`
+            : `MoR rejected the filing (${error.kind}): ${error.message}. The invoice is marked FAILED; correct it and file again.`
+          : `A submission was sent but never acknowledged (${error.kind}). Its IRN is unknown, so no further invoice can be filed until it is resolved with MoR.`,
+        link: `/dashboard/invoices/${invoiceId}`,
+        data: { invoiceId, eimsStatus: status, kind: error.kind, action: "EIMS_FILING_FAILED" },
+      });
+    } catch (err) {
+      this.logger.warn(`EIMS staff alert failed for invoice ${invoiceId}: ${(err as Error).message}`);
+    }
+  }
+
+  // ── internals ────────────────────────────────────────────────────────────────────────────────
+
+  /** A non-empty IRN is the only success signal; anything else is a failed registration. */
+  private async submit(
+    request: EimsInvoiceRequest,
+  ): Promise<{ irn: string; ackDate?: string; signedQR?: string }> {
+    const response = await this.client.postSigned<EimsInvoiceRequest, EimsRegisterResponse>(
+      "/v1/register",
+      request,
+    );
+    const irn = response?.body?.irn;
+    if (!irn) {
+      // The gateway answered, so this is deterministic: the document is not registered.
+      throw new EimsApiException(
+        "SCHEMA_VALIDATION",
+        `EIMS register returned no IRN${response?.body?.errorMessage ? `: ${response.body.errorMessage}` : ""}`,
+        response?.statusCode,
+      );
+    }
+    return { irn, ackDate: response.body?.ackDate, signedQR: response.body?.signedQR };
+  }
+
+  private async lockInvoice(manager: EntityManager, invoiceId: string): Promise<Invoice> {
+    const invoice = await manager
+      .createQueryBuilder(Invoice, "invoice")
+      .setLock("pessimistic_write")
+      .where("invoice.id = :invoiceId", { invoiceId })
+      .getOne();
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    return invoice;
+  }
+
+  /** Locks the system-state row, creating it on first use. */
+  private async lockSystemState(
+    manager: EntityManager,
+    systemNumber: string,
+  ): Promise<EimsSystemState> {
+    const select = () =>
+      manager
+        .createQueryBuilder(EimsSystemState, "state")
+        .setLock("pessimistic_write")
+        .where("state.system_number = :systemNumber", { systemNumber })
+        .getOne();
+
+    const existing = await select();
+    if (existing) return existing;
+
+    await manager.query(
+      `INSERT INTO freight.eims_system_state (system_number) VALUES ($1)
+       ON CONFLICT (system_number) DO NOTHING`,
+      [systemNumber],
+    );
+    const created = await select();
+    if (!created) throw new Error(`Could not initialise EIMS system state for ${systemNumber}`);
+    return created;
+  }
+
+  /** Header + buyer + lines — everything the mapper needs. */
+  private async loadInvoiceForMapping(
+    invoiceId: string,
+  ): Promise<Invoice & { lines: EimsMapperLine[] }> {
+    const invoice = await this.dataSource.getRepository(Invoice).findOne({
+      where: { id: invoiceId },
+      relations: { company: true, companyProfile: true, relatedInvoice: true },
+    });
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+
+    const lines: EimsMapperLine[] = await this.dataSource.query(
+      `SELECT charge_type AS "chargeType", description, quantity, unit_rate AS "unitRate",
+              amount, currency, metadata
+         FROM freight.invoice_lines
+        WHERE invoice_id = $1 AND deleted_at IS NULL
+        ORDER BY created_at ASC`,
+      [invoiceId],
+    );
+    return Object.assign(invoice, { lines });
+  }
+
+  private async loadInvoiceRow(manager: EntityManager, invoiceId: string): Promise<Invoice> {
+    const invoice = await manager.findOne(Invoice, { where: { id: invoiceId } });
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    return invoice;
+  }
+
+  private toView(invoice: Invoice): EimsInvoiceStatusView {
+    return toEimsInvoiceStatusView(invoice);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-invoice-view.util.ts b/apps/edr-freight-api/src/modules/eims/eims-invoice-view.util.ts
new file mode 100644
index 000000000..f04be0873
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-invoice-view.util.ts
@@ -0,0 +1,27 @@
+import { Invoice } from "../billing/entities/invoice.entity";
+import { EimsInvoiceStatus, EimsInvoiceStatusView } from "./eims-registration.types";
+
+/**
+ * `Invoice` → `EimsInvoiceStatusView`, shared by every service that mutates EIMS state on an
+ * invoice (registration, cancellation, receipts) — one place defines what "the current EIMS
+ * status of an invoice" means to a caller.
+ */
+export function toEimsInvoiceStatusView(invoice: Invoice): EimsInvoiceStatusView {
+  const counter = invoice.eimsInvoiceCounter;
+  return {
+    invoiceId: invoice.id,
+    invoiceNumber: invoice.invoiceNumber,
+    eimsStatus: invoice.eimsStatus ?? EimsInvoiceStatus.NotSubmitted,
+    eimsIrn: invoice.eimsIrn ?? null,
+    eimsDocumentNumber: invoice.eimsDocumentNumber ?? null,
+    eimsInvoiceCounter: counter === null || counter === undefined ? null : Number(counter),
+    eimsSubmittedAt: invoice.eimsSubmittedAt ?? null,
+    eimsAckDate: invoice.eimsAckDate ?? null,
+    eimsLastError: invoice.eimsLastError ?? null,
+    eimsSignedQr: invoice.eimsSignedQr ?? null,
+    eimsCancelledAt: invoice.eimsCancelledAt ?? null,
+    eimsCancellationDate: invoice.eimsCancellationDate ?? null,
+    eimsCancellationReasonCode: invoice.eimsCancellationReasonCode ?? null,
+    eimsCancellationRemark: invoice.eimsCancellationRemark ?? null,
+  };
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-invoice.controller.ts b/apps/edr-freight-api/src/modules/eims/eims-invoice.controller.ts
new file mode 100644
index 000000000..db28eeafe
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-invoice.controller.ts
@@ -0,0 +1,154 @@
+import { Body, Controller, Get, Param, ParseUUIDPipe, Post, Res } from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+import type { Response } from "express";
+
+import { BookingStaff } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { sendPdf } from "../billing/billing.controller";
+import { BulkCancelEimsRegistrationDto } from "./dto/bulk-cancel-eims-registration.dto";
+import { BulkRegisterEimsInvoiceDto } from "./dto/bulk-register-eims-invoice.dto";
+import { CancelEimsRegistrationDto } from "./dto/cancel-eims-registration.dto";
+import { RegisterSalesReceiptDto } from "./dto/register-sales-receipt.dto";
+import { RegisterWithholdingReceiptDto } from "./dto/register-withholding-receipt.dto";
+import { ResolveEimsRegistrationDto } from "./dto/resolve-eims-registration.dto";
+import { EimsBulkRegistrationService } from "./eims-bulk-registration.service";
+import { EimsCancellationService } from "./eims-cancellation.service";
+import { EimsInvoiceRegistrationService } from "./eims-invoice-registration.service";
+import { EimsReceiptService } from "./eims-receipt.service";
+
+/**
+ * Manual EIMS actions on an existing invoice.
+ *
+ * Invoices are produced by the freight workflow, not by a person, so these routes are **not** the
+ * normal production path — they exist for controlled testing and exceptional operations. Automatic
+ * submission after an invoice is issued is a separate phase; nothing here is called by it.
+ *
+ * `eims_register`, `eims_resolve`, `eims_cancel` and `eims_receipt_register` are intentionally left
+ * out of every role preset and assigned to named admins instead. They are also separate
+ * permissions: resolving clears the system-wide chain block and can record an IRN against an
+ * invoice, cancelling is its own irreversible-at-MoR action, and filing a receipt is a third —
+ * none follows from the right to register. Only `eims/status` and `eims/receipts` ride on the
+ * ordinary `invoices:view`.
+ *
+ * Filing gets its own permission (`invoices:eims_register`) rather than riding on an existing key:
+ * registration is irreversible at MoR, so it must not follow from the right to download a PDF.
+ * The key is seeded through FINANCE_PERMISSIONS, which reaches `iam.permissions` via
+ * ADVANCED_BACKOFFICE_PERMISSIONS → BOOKING_RULE_ENGINE_PERMISSIONS → EDR_FREIGHT_PERMISSIONS.
+ */
+@ApiTags("eims")
+@ApiBearerAuth()
+@Controller("invoices")
+export class EimsInvoiceController {
+  constructor(
+    private readonly registration: EimsInvoiceRegistrationService,
+    private readonly bulkRegistration: EimsBulkRegistrationService,
+    private readonly cancellation: EimsCancellationService,
+    private readonly receipts: EimsReceiptService,
+  ) {}
+
+  @Post(":id/eims/register")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsRegister)
+  @ApiOperation({
+    summary:
+      "Register the invoice with MoR EIMS. Idempotent — an invoice that already has an IRN is returned unchanged.",
+  })
+  register(@Param("id", ParseUUIDPipe) id: string) {
+    return this.registration.registerInvoiceWithEims(id);
+  }
+
+  @Post("eims/bulk-register")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsRegister)
+  @ApiOperation({
+    summary:
+      "Submit multiple invoices to MoR EIMS in one call. Asynchronous — this only confirms MoR " +
+      "accepted the batch (a conversation id), not the per-invoice outcome. Real results (IRN or " +
+      "rejection per invoice) arrive later via MoR's own callback; poll GET :id/eims/status.",
+  })
+  bulkRegister(@Body() dto: BulkRegisterEimsInvoiceDto) {
+    return this.bulkRegistration.registerBulk(dto.invoiceIds);
+  }
+
+  @Post(":id/eims/verify")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsRegister)
+  @ApiOperation({ summary: "Verify the invoice's stored IRN against EIMS" })
+  verify(@Param("id", ParseUUIDPipe) id: string) {
+    return this.registration.verifyInvoiceWithEims(id);
+  }
+
+  @Post(":id/eims/resolve")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsResolve)
+  @ApiOperation({
+    summary:
+      "Resolve an unacknowledged submission: record the IRN confirmed with MoR, or discard it. Clears the system-wide block.",
+  })
+  resolve(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: ResolveEimsRegistrationDto,
+  ) {
+    return this.registration.resolveEimsRegistration(id, dto);
+  }
+
+  @Get(":id/eims/status")
+  @BookingStaff(FREIGHT_PERMS.invoices.view)
+  @ApiOperation({ summary: "EIMS registration status, IRN and last error for the invoice" })
+  status(@Param("id", ParseUUIDPipe) id: string) {
+    return this.registration.getEimsStatus(id);
+  }
+
+  @Post(":id/eims/cancel")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsCancel)
+  @ApiOperation({
+    summary:
+      "Cancel the invoice's registered EIMS document. Refuses (409) an already-cancelled invoice rather than a silent no-op — see IRC-N010.",
+  })
+  cancel(@Param("id", ParseUUIDPipe) id: string, @Body() dto: CancelEimsRegistrationDto) {
+    return this.cancellation.cancelInvoiceWithEims(id, dto.reasonCode, dto.remark);
+  }
+
+  @Post("eims/bulk-cancel")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsCancel)
+  @ApiOperation({
+    summary:
+      "Cancel multiple invoices' registered EIMS documents in one call. Each invoice's outcome is " +
+      "reported independently — one failure never blocks the rest.",
+  })
+  bulkCancel(@Body() dto: BulkCancelEimsRegistrationDto) {
+    return this.cancellation.cancelBulkWithEims(dto.items);
+  }
+
+  @Post(":id/eims/receipt/sales")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsReceiptRegister)
+  @ApiOperation({ summary: "Register a sales receipt with MoR EIMS against a registered invoice" })
+  registerSalesReceipt(@Param("id", ParseUUIDPipe) id: string, @Body() dto: RegisterSalesReceiptDto) {
+    return this.receipts.registerSalesReceipt(id, dto);
+  }
+
+  @Post(":id/eims/receipt/withholding")
+  @BookingStaff(FREIGHT_PERMS.invoices.eimsReceiptRegister)
+  @ApiOperation({ summary: "Register a withholding receipt with MoR EIMS against a registered invoice" })
+  registerWithholdingReceipt(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: RegisterWithholdingReceiptDto,
+  ) {
+    return this.receipts.registerWithholdingReceipt(id, dto);
+  }
+
+  @Get(":id/eims/receipts")
+  @BookingStaff(FREIGHT_PERMS.invoices.view)
+  @ApiOperation({ summary: "List every EIMS receipt filed against this invoice, newest first" })
+  listReceipts(@Param("id", ParseUUIDPipe) id: string) {
+    return this.receipts.listReceipts(id);
+  }
+
+  @Get(":id/eims/receipts/:receiptId/document")
+  @BookingStaff(FREIGHT_PERMS.invoices.export)
+  @ApiOperation({ summary: "Download the sealed receipt PDF (RRN + QR) for a filed EIMS receipt" })
+  async receiptDocument(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Param("receiptId", ParseUUIDPipe) receiptId: string,
+    @Res() res: Response,
+  ) {
+    const { filename, buffer } = await this.receipts.document(id, receiptId);
+    sendPdf(res, filename, buffer);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-receipt-document.mapper.ts b/apps/edr-freight-api/src/modules/eims/eims-receipt-document.mapper.ts
new file mode 100644
index 000000000..841bfcc54
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-receipt-document.mapper.ts
@@ -0,0 +1,107 @@
+import { Invoice } from "../billing/entities/invoice.entity";
+import {
+  InvoiceDocumentModel,
+  pngDataUrl,
+} from "../billing/documents/invoice-document.service";
+import { EimsReceipt, EimsReceiptStatus } from "./entities/eims-receipt.entity";
+import { EimsSalesReceiptRequest, EimsWithholdReceiptRequest } from "./eims-receipt.types";
+
+/**
+ * Maps a filed `EimsReceipt` onto the shared invoice/receipt document layout — mirrors
+ * `eims-invoice.mapper.ts`'s role for `/v1/register`: a pure function, no I/O.
+ *
+ * The amounts (collected amount, mode of payment, withholding amount) live only in
+ * `receipt.request` — the exact body this app sent, typed and written in exactly one place
+ * (`EimsReceiptService`). Reading it back is a cast, not a new source of truth; real columns
+ * would mean a migration + backfill for data already present in a stable shape.
+ *
+ * Throws rather than returning a model for anything not actually filed: a sealed, stamped PDF
+ * for a receipt MoR rejected, never acknowledged, or whose request was somehow never recorded
+ * would read as a genuine tax document. Callers (`EimsReceiptService.document`) let this throw
+ * surface as a 400 — there is nothing sensible to render instead.
+ */
+export function toReceiptDocumentModel(receipt: EimsReceipt, invoice: Invoice): InvoiceDocumentModel {
+  if (receipt.status !== EimsReceiptStatus.Registered) {
+    throw new Error(
+      `Receipt ${receipt.receiptNumber} is ${receipt.status}, not REGISTERED — refusing to print an unfiled receipt.`,
+    );
+  }
+  if (!receipt.request) {
+    throw new Error(`Receipt ${receipt.receiptNumber} has no stored request body — cannot render its amounts.`);
+  }
+
+  const isSales = receipt.kind === "SALES";
+
+  if (isSales) {
+    const req = receipt.request as unknown as EimsSalesReceiptRequest;
+    return build(receipt, invoice, {
+      title: "Sales Receipt",
+      currency: req.ReceiptCurrency,
+      amountLabel: "Collected",
+      lineDescription: `Payment received against invoice ${invoice.invoiceNumber}`,
+      amount: req.CollectedAmount,
+      // A sales receipt is a real payment — this is the one case the shared layout's own default
+      // ("EDR PAID" for kind RECEIPT) is already correct, but set it explicitly so it never drifts
+      // if that default changes for an unrelated reason.
+      sealText: "EDR PAID",
+      extraSummary: [{ label: "Mode of payment", value: req.TransactionDetails.ModeOfPayment }],
+    });
+  }
+
+  const req = receipt.request as unknown as EimsWithholdReceiptRequest;
+  return build(receipt, invoice, {
+    title: "Withholding Receipt",
+    currency: req.InvoiceDetail.Currency,
+    amountLabel: "Withheld",
+    lineDescription: `Withholding (${req.WithholdDetail.Type}) against invoice ${invoice.invoiceNumber}`,
+    amount: req.WithholdDetail.WithholdingAmount,
+    // A withholding receipt is not a payment — the shared layout's "EDR PAID" default would be
+    // wrong here, so this is the one case that MUST override it.
+    sealText: "EDR",
+    extraSummary: [{ label: "Withholding type", value: req.WithholdDetail.Type }],
+  });
+}
+
+function build(
+  receipt: EimsReceipt,
+  invoice: Invoice,
+  opts: {
+    title: string;
+    currency: string;
+    amountLabel: string;
+    lineDescription: string;
+    amount: number;
+    sealText: string;
+    extraSummary: Array<{ label: string; value: string | null }>;
+  },
+): InvoiceDocumentModel {
+  return {
+    kind: "RECEIPT",
+    title: opts.title,
+    documentNumber: receipt.receiptNumber,
+    issuedAt: receipt.submittedAt ?? null,
+    status: receipt.status,
+    currency: opts.currency,
+    summary: [
+      { label: "Invoice", value: invoice.invoiceNumber },
+      { label: "Invoice IRN", value: invoice.eimsIrn ?? null },
+      { label: "RRN", value: receipt.rrn ?? null },
+      { label: "Ack status", value: receipt.ackStatus ?? null },
+      ...opts.extraSummary,
+    ],
+    // No line items on a receipt — one synthetic line, since buildHtml renders the line table
+    // unconditionally and an empty `lines: []` would print a header-only empty table.
+    lines: [
+      {
+        description: opts.lineDescription,
+        quantity: 1,
+        unitRate: opts.amount,
+        amount: opts.amount,
+        currency: opts.currency,
+      },
+    ],
+    totals: [{ label: opts.amountLabel, amount: opts.amount, grand: true }],
+    sealText: opts.sealText,
+    qrImageUrl: receipt.qr ? pngDataUrl(receipt.qr) : null,
+  };
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-receipt.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-receipt.service.spec.ts
new file mode 100644
index 000000000..93f50e827
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-receipt.service.spec.ts
@@ -0,0 +1,303 @@
+import { BadRequestException } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { DataSource } from "typeorm";
+
+import { EimsConfig } from "../../config/eims.config";
+import { Invoice } from "../billing/entities/invoice.entity";
+import { InvoiceDocumentService } from "../billing/documents/invoice-document.service";
+import { NotificationsService } from "../notifications/notifications.service";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsApiException } from "./eims.errors";
+import { EimsReceiptStatus } from "./entities/eims-receipt.entity";
+import { EimsReceiptService } from "./eims-receipt.service";
+
+const INVOICE_ID = "11111111-1111-4111-8111-111111111111";
+const IRN = "9fe9bbbece6ab76c112b617534e6aac7aa8b819d5be79f4d3d088ed2e887b2e0";
+const SESSION = { systemNumber: "B0360154BA", systemType: "SYS" };
+
+const invoiceRow = (over: Partial<Invoice> = {}): Invoice =>
+  ({
+    id: INVOICE_ID,
+    invoiceNumber: "INV-20260807-00042",
+    companyId: "company-1",
+    currency: "ETB",
+    totalAmount: "10000.00",
+    paidAmount: "10000.00",
+    balanceAmount: "0.00",
+    eimsIrn: IRN,
+    ...over,
+  }) as unknown as Invoice;
+
+/** In-memory stand-in: Invoice lookups + EimsReceipt save/update/find. */
+class FakeDb {
+  invoices = new Map<string, Invoice>();
+  receipts = new Map<string, Record<string, unknown>>();
+  companyContact: { phone: string | null; email: string | null } | null = null;
+  private seq = 0;
+
+  constructor(invoices: Invoice[]) {
+    for (const inv of invoices) this.invoices.set(inv.id, inv);
+  }
+
+  private manager = {
+    findOne: async (
+      entity: unknown,
+      options: { where: { id?: string; invoiceId?: string } },
+    ) => {
+      if (entity === Invoice) return this.invoices.get(options.where.id!) ?? null;
+      const receipt = options.where.id ? this.receipts.get(options.where.id) : undefined;
+      if (!receipt) return null;
+      if (options.where.invoiceId && receipt.invoiceId !== options.where.invoiceId) return null;
+      return receipt;
+    },
+    find: async (_entity: unknown, options: { where: { invoiceId: string } }) =>
+      [...this.receipts.values()].filter((r) => r.invoiceId === options.where.invoiceId),
+    save: async (_entity: unknown, data: Record<string, unknown>) => {
+      const id = `receipt-${++this.seq}`;
+      const row = { id, ...data };
+      this.receipts.set(id, row);
+      return row;
+    },
+    update: async (_entity: unknown, id: string, patch: Record<string, unknown>) => {
+      Object.assign(this.receipts.get(id)!, patch);
+    },
+  };
+
+  asDataSource(): DataSource {
+    return {
+      manager: this.manager,
+      query: async () => (this.companyContact ? [this.companyContact] : []),
+    } as unknown as DataSource;
+  }
+}
+
+const config = (): EimsConfig => ({ tin: "0053481357" }) as EimsConfig;
+
+const build = (
+  db: FakeDb,
+  postBearer: jest.Mock,
+  directSend: jest.Mock = jest.fn().mockResolvedValue(undefined),
+  documents: { render: jest.Mock } = { render: jest.fn() },
+) =>
+  new EimsReceiptService(
+    db.asDataSource(),
+    { get: () => config() } as unknown as ConfigService,
+    { postBearer } as unknown as EimsClientService,
+    { getSessionContext: jest.fn().mockResolvedValue(SESSION) } as unknown as EimsAuthService,
+    { directSend } as unknown as NotificationsService,
+    documents as unknown as InvoiceDocumentService,
+  );
+
+const okResponse = (over: Record<string, unknown> = {}) => ({
+  statusCode: 200,
+  message: "Success",
+  body: { status: "A", rrn: "rrn-value", qr: "iVBORw0KGgo...", ...over },
+});
+
+describe("EimsReceiptService.registerSalesReceipt", () => {
+  it("registers a sales receipt and persists the RRN/QR", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn().mockResolvedValue(okResponse());
+
+    const receipt = await build(db, postBearer).registerSalesReceipt(INVOICE_ID, {
+      modeOfPayment: "CASH",
+    } as never);
+
+    expect(postBearer).toHaveBeenCalledTimes(1);
+    expect(postBearer.mock.calls[0][0]).toBe("/v1/receipt/sales");
+    const request = postBearer.mock.calls[0][1];
+    expect(request.SellerTIN).toBe("0053481357");
+    expect(request.SourceSystemNumber).toBe("B0360154BA");
+    expect(request.Invoices[0].InvoiceIRN).toBe(IRN);
+    expect(request.TransactionDetails.ModeOfPayment).toBe("CASH");
+    expect(receipt.status).toBe(EimsReceiptStatus.Registered);
+    expect(receipt.rrn).toBe("rrn-value");
+    expect(receipt.qr).toBe("iVBORw0KGgo...");
+  });
+
+  it("defaults PaymentCoverage to FULL when the invoice balance is 0, PARTIAL otherwise", async () => {
+    const db = new FakeDb([invoiceRow({ balanceAmount: 500 })]);
+    const postBearer = jest.fn().mockResolvedValue(okResponse());
+
+    await build(db, postBearer).registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never);
+
+    expect(postBearer.mock.calls[0][1].Invoices[0].PaymentCoverage).toBe("PARTIAL");
+  });
+
+  it("rejects an unconfirmed receipt currency locally, with zero HTTP calls", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn();
+
+    await expect(
+      build(db, postBearer).registerSalesReceipt(INVOICE_ID, {
+        modeOfPayment: "CASH",
+        currency: "GBP",
+      } as never),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+
+  it("refuses to file a receipt against an unregistered invoice", async () => {
+    const db = new FakeDb([invoiceRow({ eimsIrn: null })]);
+    const postBearer = jest.fn();
+
+    await expect(
+      build(db, postBearer).registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+
+  it("marks the receipt FAILED on a deterministic rejection and rethrows", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest
+      .fn()
+      .mockRejectedValue(new EimsApiException("RULE_VALIDATION", "EIMS receipt failed (406)", 406));
+
+    await expect(
+      build(db, postBearer).registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never),
+    ).rejects.toBeInstanceOf(EimsApiException);
+    const [receipt] = [...db.receipts.values()];
+    expect(receipt.status).toBe(EimsReceiptStatus.Failed);
+  });
+
+  it("marks the receipt UNKNOWN on an ambiguous failure (never auto-retried)", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn().mockRejectedValue(new EimsApiException("TIMEOUT", "EIMS receipt timed out"));
+
+    await expect(
+      build(db, postBearer).registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never),
+    ).rejects.toBeInstanceOf(EimsApiException);
+    const [receipt] = [...db.receipts.values()];
+    expect(receipt.status).toBe(EimsReceiptStatus.Unknown);
+  });
+
+  it("notifies the buyer company on success, without blocking the result", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    db.companyContact = { phone: "+251911000000", email: "buyer@abc.et" };
+    const directSend = jest.fn().mockResolvedValue(undefined);
+    const postBearer = jest.fn().mockResolvedValue(okResponse());
+
+    const receipt = await build(db, postBearer, directSend).registerSalesReceipt(INVOICE_ID, {
+      modeOfPayment: "CASH",
+    } as never);
+
+    expect(receipt.status).toBe(EimsReceiptStatus.Registered);
+    expect(directSend).toHaveBeenCalledWith("sms", "+251911000000", expect.stringContaining("sales"));
+  });
+});
+
+describe("EimsReceiptService.registerWithholdingReceipt", () => {
+  it("registers a withholding receipt and persists the RRN", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn().mockResolvedValue(okResponse());
+
+    const receipt = await build(db, postBearer).registerWithholdingReceipt(INVOICE_ID, {
+      type: "TWHT",
+      preTaxAmount: 6000,
+      withholdingAmount: 120,
+    } as never);
+
+    expect(postBearer.mock.calls[0][0]).toBe("/v1/receipt/withholding");
+    const request = postBearer.mock.calls[0][1];
+    expect(request.InvoiceDetail.InvoiceIRN).toBe(IRN);
+    expect(request.WithholdDetail).toMatchObject({ Type: "TWHT", PreTaxAmount: 6000, WithholdingAmount: 120 });
+    expect(receipt.status).toBe(EimsReceiptStatus.Registered);
+    expect(receipt.rrn).toBe("rrn-value");
+  });
+
+  it("requires an exchangeRate for a non-ETB invoice", async () => {
+    const db = new FakeDb([invoiceRow({ currency: "USD" })]);
+    const postBearer = jest.fn();
+
+    await expect(
+      build(db, postBearer).registerWithholdingReceipt(INVOICE_ID, {
+        type: "TWHT",
+        preTaxAmount: 6000,
+        withholdingAmount: 120,
+      } as never),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    expect(postBearer).not.toHaveBeenCalled();
+  });
+});
+
+describe("EimsReceiptService.listReceipts", () => {
+  it("returns every receipt filed against the invoice", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn().mockResolvedValue(okResponse());
+    const service = build(db, postBearer);
+
+    await service.registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never);
+    await service.registerWithholdingReceipt(INVOICE_ID, {
+      type: "TWHT",
+      preTaxAmount: 100,
+      withholdingAmount: 2,
+    } as never);
+
+    const list = await service.listReceipts(INVOICE_ID);
+    expect(list).toHaveLength(2);
+  });
+});
+
+describe("EimsReceiptService.document", () => {
+  it("renders a sealed PDF for a registered sales receipt, with RRN and QR in the model", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const documents = { render: jest.fn().mockResolvedValue({ filename: "x.pdf", buffer: Buffer.from("") }) };
+    const service = build(db, jest.fn().mockResolvedValue(okResponse()), undefined, documents);
+    const receipt = await service.registerSalesReceipt(INVOICE_ID, {
+      modeOfPayment: "CASH",
+      collectedAmount: 500,
+    } as never);
+
+    await service.document(INVOICE_ID, receipt.id);
+
+    expect(documents.render).toHaveBeenCalledTimes(1);
+    const model = documents.render.mock.calls[0][0];
+    expect(model.kind).toBe("RECEIPT");
+    expect(model.qrImageUrl).toBe("data:image/png;base64,iVBORw0KGgo...");
+    expect(model.summary).toContainEqual({ label: "RRN", value: "rrn-value" });
+    expect(model.lines[0].amount).toBe(500);
+    expect(model.sealText).toBe("EDR PAID");
+  });
+
+  it("renders a withholding receipt with the withheld amount and a non-PAID seal", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const documents = { render: jest.fn().mockResolvedValue({ filename: "x.pdf", buffer: Buffer.from("") }) };
+    const service = build(db, jest.fn().mockResolvedValue(okResponse()), undefined, documents);
+    const receipt = await service.registerWithholdingReceipt(INVOICE_ID, {
+      type: "TWHT",
+      preTaxAmount: 1000,
+      withholdingAmount: 20,
+    } as never);
+
+    await service.document(INVOICE_ID, receipt.id);
+
+    const model = documents.render.mock.calls[0][0];
+    expect(model.lines[0].amount).toBe(20);
+    expect(model.sealText).toBe("EDR");
+    expect(model.sealText).not.toContain("PAID");
+  });
+
+  it("refuses to render a receipt that was never acknowledged by MoR", async () => {
+    const db = new FakeDb([invoiceRow()]);
+    const postBearer = jest.fn().mockRejectedValue(new EimsApiException("TIMEOUT", "EIMS receipt timed out"));
+    const documents = { render: jest.fn() };
+    const service = build(db, postBearer, undefined, documents);
+    await expect(
+      service.registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never),
+    ).rejects.toBeInstanceOf(EimsApiException);
+    const [receipt] = [...db.receipts.values()];
+
+    await expect(service.document(INVOICE_ID, receipt.id as string)).rejects.toBeInstanceOf(BadRequestException);
+    expect(documents.render).not.toHaveBeenCalled();
+  });
+
+  it("scopes the lookup to the given invoice — a receipt from another invoice is not found", async () => {
+    const OTHER_INVOICE_ID = "22222222-2222-4222-8222-222222222222";
+    const db = new FakeDb([invoiceRow(), invoiceRow({ id: OTHER_INVOICE_ID })]);
+    const service = build(db, jest.fn().mockResolvedValue(okResponse()));
+    const receipt = await service.registerSalesReceipt(INVOICE_ID, { modeOfPayment: "CASH" } as never);
+
+    await expect(service.document(OTHER_INVOICE_ID, receipt.id)).rejects.toThrow(/not found/);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-receipt.service.ts b/apps/edr-freight-api/src/modules/eims/eims-receipt.service.ts
new file mode 100644
index 000000000..2bdb6cbe2
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-receipt.service.ts
@@ -0,0 +1,288 @@
+import { BadRequestException, Injectable, Logger, NotFoundException } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { InjectDataSource } from "@nestjs/typeorm";
+import { DataSource } from "typeorm";
+import type { QueryDeepPartialEntity } from "typeorm/query-builder/QueryPartialEntity.js";
+
+import { EimsConfig } from "../../config/eims.config";
+import { Invoice } from "../billing/entities/invoice.entity";
+import { InvoiceDocumentService } from "../billing/documents/invoice-document.service";
+import { NotificationsService } from "../notifications/notifications.service";
+import { sendCompanyChannels } from "../notifications/notify-company.util";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsApiException } from "./eims.errors";
+import { toReceiptDocumentModel } from "./eims-receipt-document.mapper";
+import { EimsReceipt, EimsReceiptKind, EimsReceiptStatus } from "./entities/eims-receipt.entity";
+import { RegisterSalesReceiptDto } from "./dto/register-sales-receipt.dto";
+import { RegisterWithholdingReceiptDto } from "./dto/register-withholding-receipt.dto";
+import {
+  EimsReceiptResponse,
+  EimsSalesReceiptRequest,
+  EimsWithholdReceiptRequest,
+} from "./eims-receipt.types";
+import { EimsInvoiceError } from "./eims-registration.types";
+
+/** `ReceiptCurrency` / withholding `InvoiceDetail.Currency` — confirmed by a live rule error. */
+const EIMS_RECEIPT_CURRENCIES = ["ETB", "USD", "CAD"] as const;
+
+/** Failure kinds where MoR gave a complete answer — the receipt definitively did not register. */
+const DETERMINISTIC_KINDS = new Set(["SCHEMA_VALIDATION", "RULE_VALIDATION", "AUTH", "FORBIDDEN"]);
+
+/**
+ * `POST /v1/receipt/sales` and `POST /v1/receipt/withholding`, both against an already-registered
+ * invoice.
+ *
+ * No counter/reservation machinery: the collection shows no MoR-enforced ordering on
+ * `ReceiptCounter` the way `InvoiceCounter` has a documented "expected: N" rule, so — unlike
+ * registration — there is no shared sequence to protect. Each attempt is its own `EimsReceipt` row:
+ * created before the HTTP call (so a crash mid-flight leaves an UNKNOWN row instead of nothing),
+ * settled after it. An ambiguous outcome is never auto-retried — receipts have no evidenced
+ * double-submission guard the way `/v1/cancel` does ("IRN already Canceled."), so the same caution
+ * applies as an unacknowledged registration: a human must check the MoR portal first.
+ *
+ * Several request fields have no confirmed source in this codebase (payment method, collector,
+ * withholding rate/amount) and are never guessed — see the two DTOs.
+ */
+@Injectable()
+export class EimsReceiptService {
+  private readonly logger = new Logger(EimsReceiptService.name);
+
+  constructor(
+    @InjectDataSource() private readonly dataSource: DataSource,
+    private readonly config: ConfigService,
+    private readonly client: EimsClientService,
+    private readonly auth: EimsAuthService,
+    private readonly notifications: NotificationsService,
+    private readonly documents: InvoiceDocumentService,
+  ) {}
+
+  private get cfg(): EimsConfig {
+    return this.config.get<EimsConfig>("eims")!;
+  }
+
+  async registerSalesReceipt(invoiceId: string, dto: RegisterSalesReceiptDto): Promise<EimsReceipt> {
+    const invoice = await this.loadRegisteredInvoice(invoiceId);
+    const currency = dto.currency ?? invoice.currency;
+    this.assertReceiptCurrency(currency);
+
+    const session = await this.auth.getSessionContext();
+    const receiptNumber = this.generateReceiptNumber(invoice);
+    const collectedAmount = dto.collectedAmount ?? Number(invoice.paidAmount);
+    const balance = Number(invoice.balanceAmount);
+
+    const request: EimsSalesReceiptRequest = {
+      ReceiptNumber: receiptNumber,
+      ReceiptType: "Sales Receipts",
+      Reason: dto.reason ?? "Payment received",
+      // ISO-8601 UTC — the collection's saved example uses a "+03:00" offset instead; no schema
+      // error for this field was ever observed to confirm which form MoR actually requires.
+      ReceiptDate: new Date().toISOString(),
+      ReceiptCounter: String(Date.now()),
+      ManualReceiptNumber: receiptNumber,
+      SourceSystemType: session.systemType,
+      SourceSystemNumber: session.systemNumber,
+      ReceiptCurrency: currency,
+      ExchangeRate: dto.exchangeRate ?? null,
+      CollectedAmount: collectedAmount,
+      SellerTIN: this.cfg.tin,
+      Invoices: [
+        {
+          InvoiceIRN: invoice.eimsIrn!,
+          PaymentCoverage: dto.paymentCoverage ?? (balance <= 0 ? "FULL" : "PARTIAL"),
+          InvoicePaidAmount: collectedAmount,
+          DiscountAmount: null,
+          RemainingAmount: balance,
+          TotalAmount: Number(invoice.totalAmount),
+        },
+      ],
+      TransactionDetails: {
+        ModeOfPayment: dto.modeOfPayment,
+        ChequeNumber: dto.chequeNumber ?? null,
+        CPONumber: dto.cpoNumber ?? null,
+        DocumentNumber: dto.documentNumber ?? null,
+        CollectorName: dto.collectorName ?? null,
+        PaymentServiceProvider: dto.paymentServiceProvider ?? null,
+        OtherPaymentServiceProviderName: dto.otherPaymentServiceProviderName ?? null,
+        AccountNumber: dto.accountNumber ?? null,
+        TransactionNumber: dto.transactionNumber ?? null,
+      },
+    };
+
+    return this.submit(invoice, "SALES", receiptNumber, request, "/v1/receipt/sales");
+  }
+
+  async registerWithholdingReceipt(
+    invoiceId: string,
+    dto: RegisterWithholdingReceiptDto,
+  ): Promise<EimsReceipt> {
+    const invoice = await this.loadRegisteredInvoice(invoiceId);
+    if (invoice.currency !== "ETB" && dto.exchangeRate == null) {
+      throw new BadRequestException({
+        code: "EIMS_EXCHANGE_RATE_REQUIRED",
+        message: `Invoice ${invoice.invoiceNumber} is in ${invoice.currency} and needs an exchangeRate`,
+      });
+    }
+
+    const session = await this.auth.getSessionContext();
+    const receiptNumber = this.generateReceiptNumber(invoice);
+
+    const request: EimsWithholdReceiptRequest = {
+      ReceiptNumber: receiptNumber,
+      Reason: dto.reason ?? "Withholding",
+      ReceiptCounter: String(Date.now()),
+      ManualReceiptNumber: receiptNumber,
+      SourceSystemType: session.systemType,
+      SourceSystemNumber: session.systemNumber,
+      InvoiceDetail: {
+        InvoiceIRN: invoice.eimsIrn!,
+        Currency: invoice.currency,
+        ExchangeRate: dto.exchangeRate ?? null,
+      },
+      WithholdDetail: {
+        Type: dto.type,
+        Rate: dto.rate ?? null,
+        PreTaxAmount: dto.preTaxAmount,
+        WithholdingAmount: dto.withholdingAmount,
+      },
+    };
+
+    return this.submit(invoice, "WITHHOLDING", receiptNumber, request, "/v1/receipt/withholding");
+  }
+
+  async listReceipts(invoiceId: string): Promise<EimsReceipt[]> {
+    return this.dataSource.manager.find(EimsReceipt, {
+      where: { invoiceId },
+      order: { createdAt: "DESC" },
+    });
+  }
+
+  /**
+   * Sealed PDF for one filed receipt (RRN + QR), scoped to the invoice it belongs to. Not on
+   * `loadRegisteredInvoice` — a receipt refused/never-acknowledged by MoR must not render as a
+   * sealed tax document, and `toReceiptDocumentModel` is the one place that guards it.
+   */
+  async document(invoiceId: string, receiptId: string): Promise<{ filename: string; buffer: Buffer }> {
+    const receipt = await this.dataSource.manager.findOne(EimsReceipt, {
+      where: { id: receiptId, invoiceId },
+    });
+    if (!receipt) throw new NotFoundException(`Receipt ${receiptId} not found on invoice ${invoiceId}`);
+    const invoice = await this.dataSource.manager.findOne(Invoice, { where: { id: invoiceId } });
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+
+    let model: ReturnType<typeof toReceiptDocumentModel>;
+    try {
+      model = toReceiptDocumentModel(receipt, invoice);
+    } catch (err) {
+      // Only the mapper's own refusals (not-yet-registered, missing request body) become a 400 —
+      // a genuine PDF-render failure below is left to surface as whatever InvoiceDocumentService
+      // itself throws.
+      throw new BadRequestException((err as Error).message);
+    }
+    return this.documents.render(model);
+  }
+
+  // ── internals ────────────────────────────────────────────────────────────────────────────────
+
+  private async submit(
+    invoice: Invoice,
+    kind: EimsReceiptKind,
+    receiptNumber: string,
+    request: EimsSalesReceiptRequest | EimsWithholdReceiptRequest,
+    path: "/v1/receipt/sales" | "/v1/receipt/withholding",
+  ): Promise<EimsReceipt> {
+    // Committed before the HTTP call — a crash mid-flight leaves an UNKNOWN row, not nothing.
+    const receipt = await this.dataSource.manager.save(EimsReceipt, {
+      invoiceId: invoice.id,
+      kind,
+      status: EimsReceiptStatus.Submitting,
+      receiptNumber,
+      submittedAt: new Date(),
+      request: request as unknown as Record<string, unknown>,
+    });
+
+    try {
+      const response = await this.client.postBearer<
+        EimsSalesReceiptRequest | EimsWithholdReceiptRequest,
+        EimsReceiptResponse
+      >(path, request);
+      const rrn = response?.body?.rrn;
+      if (!rrn) {
+        throw new EimsApiException(
+          "SCHEMA_VALIDATION",
+          "EIMS receipt registration returned no rrn",
+          response?.statusCode,
+        );
+      }
+      await this.dataSource.manager.update(EimsReceipt, receipt.id, {
+        status: EimsReceiptStatus.Registered,
+        rrn,
+        qr: response.body?.qr ?? null,
+        ackStatus: response.body?.status ?? null,
+      });
+      this.logger.log(`${kind} receipt ${receiptNumber} registered for invoice ${invoice.invoiceNumber} (RRN ${rrn})`);
+      await this.notifyBuyer(invoice, kind, receiptNumber);
+    } catch (err) {
+      const api = err instanceof EimsApiException ? err : null;
+      const deterministic = api ? DETERMINISTIC_KINDS.has(api.kind) : false;
+      const lastError: EimsInvoiceError = {
+        kind: api?.kind ?? "UNKNOWN",
+        message: (err as Error)?.message ?? "unknown error",
+        httpStatus: api?.httpStatus,
+        details: api?.details,
+        at: new Date().toISOString(),
+      };
+      await this.dataSource.manager.update(EimsReceipt, receipt.id, {
+        status: deterministic ? EimsReceiptStatus.Failed : EimsReceiptStatus.Unknown,
+        lastError,
+      } as QueryDeepPartialEntity<EimsReceipt>);
+      this.logger.error(
+        `${kind} receipt ${receiptNumber} for invoice ${invoice.invoiceNumber} ${deterministic ? "FAILED" : "UNKNOWN"}: ${lastError.message}`,
+      );
+      throw err;
+    }
+
+    const saved = await this.dataSource.manager.findOne(EimsReceipt, { where: { id: receipt.id } });
+    return saved!;
+  }
+
+  private async notifyBuyer(invoice: Invoice, kind: EimsReceiptKind, receiptNumber: string): Promise<void> {
+    if (!invoice.companyId) return;
+    try {
+      await sendCompanyChannels(
+        this.dataSource,
+        this.notifications,
+        invoice.companyId,
+        `A ${kind === "SALES" ? "sales" : "withholding"} receipt (${receiptNumber}) has been registered ` +
+          `with MoR EIMS for invoice ${invoice.invoiceNumber}.`,
+      );
+    } catch (err) {
+      this.logger.warn(`EIMS receipt buyer notification failed for invoice ${invoice.id}: ${(err as Error).message}`);
+    }
+  }
+
+  private async loadRegisteredInvoice(invoiceId: string): Promise<Invoice> {
+    const invoice = await this.dataSource.manager.findOne(Invoice, { where: { id: invoiceId } });
+    if (!invoice) throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    if (!invoice.eimsIrn) {
+      throw new BadRequestException({
+        code: "EIMS_NOT_REGISTERED",
+        message: `Invoice ${invoice.invoiceNumber} was never registered with EIMS — no IRN to file a receipt against.`,
+      });
+    }
+    return invoice;
+  }
+
+  private assertReceiptCurrency(currency: string): void {
+    if (!EIMS_RECEIPT_CURRENCIES.includes(currency as (typeof EIMS_RECEIPT_CURRENCIES)[number])) {
+      throw new BadRequestException({
+        code: "EIMS_RECEIPT_CURRENCY_INVALID",
+        message: `EIMS receipt currency must be one of ${EIMS_RECEIPT_CURRENCIES.join(", ")}, got "${currency}"`,
+      });
+    }
+  }
+
+  private generateReceiptNumber(invoice: Invoice): string {
+    return `REC-${invoice.invoiceNumber}-${Date.now()}`;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-receipt.types.ts b/apps/edr-freight-api/src/modules/eims/eims-receipt.types.ts
new file mode 100644
index 000000000..f49600259
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-receipt.types.ts
@@ -0,0 +1,97 @@
+/**
+ * Wire types for `POST /v1/receipt/sales` and `POST /v1/receipt/withholding`, taken verbatim from
+ * the Postman collection's saved requests/responses. Bearer-authenticated but unsigned — no
+ * `{request,signature,certificate}` envelope in the collection's saved bodies, same as `/v1/verify`
+ * and `/v1/cancel`.
+ */
+
+/** One entry of `Invoices[]` on a sales receipt. */
+export interface EimsSalesReceiptInvoice {
+  InvoiceIRN: string;
+  PaymentCoverage: string;
+  InvoicePaidAmount: number;
+  DiscountAmount: number | null;
+  RemainingAmount: number | null;
+  TotalAmount: number;
+}
+
+/**
+ * `ModeOfPayment` enum confirmed by a live schema error: exactly these eight values, verbatim
+ * spelling and casing (including the two multi-word ones).
+ */
+export const EIMS_MODE_OF_PAYMENT = [
+  "CASH",
+  "CHEQUE",
+  "CPO",
+  "Local Bank Transfer",
+  "SWIFT",
+  "Wire Transfer",
+  "Letter of Credit",
+  "Card",
+] as const;
+export type EimsModeOfPayment = (typeof EIMS_MODE_OF_PAYMENT)[number];
+
+export interface EimsSalesReceiptTransactionDetails {
+  ModeOfPayment: EimsModeOfPayment;
+  ChequeNumber: string | null;
+  CPONumber: string | null;
+  DocumentNumber: string | null;
+  CollectorName: string | null;
+  PaymentServiceProvider: string | null;
+  OtherPaymentServiceProviderName: string | null;
+  AccountNumber: string | null;
+  TransactionNumber: string | null;
+}
+
+export interface EimsSalesReceiptRequest {
+  ReceiptNumber: string;
+  ReceiptType: string;
+  Reason: string;
+  ReceiptDate: string;
+  ReceiptCounter: string;
+  ManualReceiptNumber: string;
+  SourceSystemType: string;
+  SourceSystemNumber: string;
+  /** Confirmed enum via a live rule error: "Currency should be ETB, USD, CAD". */
+  ReceiptCurrency: string;
+  ExchangeRate: number | null;
+  CollectedAmount: number;
+  SellerTIN: string;
+  Invoices: EimsSalesReceiptInvoice[];
+  TransactionDetails: EimsSalesReceiptTransactionDetails;
+}
+
+export interface EimsWithholdReceiptRequest {
+  ReceiptNumber: string;
+  Reason: string;
+  ReceiptCounter: string;
+  ManualReceiptNumber: string;
+  SourceSystemType: string;
+  SourceSystemNumber: string;
+  InvoiceDetail: {
+    InvoiceIRN: string;
+    Currency: string;
+    ExchangeRate: number | null;
+  };
+  WithholdDetail: {
+    /** Only "TWHT" has ever been observed; not restricted to it, since no fuller enum is confirmed. */
+    Type: string;
+    Rate: number | null;
+    PreTaxAmount: number;
+    WithholdingAmount: number;
+  };
+}
+
+/** Success body — identical shape for both receipt endpoints. */
+export interface EimsReceiptResponseBody {
+  status: string;
+  rrn: string;
+  /** Base64 PNG, same convention as the register response's `signedQR`. */
+  qr: string;
+}
+
+export interface EimsReceiptResponse {
+  statusCode?: number;
+  message?: string;
+  body?: EimsReceiptResponseBody;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-registration.types.ts b/apps/edr-freight-api/src/modules/eims/eims-registration.types.ts
new file mode 100644
index 000000000..7cc58c0a9
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-registration.types.ts
@@ -0,0 +1,216 @@
+import { EimsInvoiceRequest } from "../billing/eims-invoice.mapper";
+import { EimsErrorResponse } from "./eims.types";
+
+/**
+ * Registration state of one invoice at MoR EIMS.
+ *
+ * `UNKNOWN` is not a synonym for failure: the request left this process and no answer came back,
+ * so the invoice may or may not be registered at the gateway. It is never auto-retried — a resend
+ * would risk a duplicate registration.
+ */
+export enum EimsInvoiceStatus {
+  NotSubmitted = "NOT_SUBMITTED",
+  Submitting = "SUBMITTING",
+  Registered = "REGISTERED",
+  Failed = "FAILED",
+  Unknown = "UNKNOWN",
+  /** Successfully cancelled at MoR via `POST /v1/cancel`. Terminal — never re-registered. */
+  Cancelled = "CANCELLED",
+}
+
+/** `body` of a successful `POST /v1/register`, as observed in the collection. */
+export interface EimsRegisterResponseBody {
+  irn: string;
+  ackDate?: string;
+  signedQR?: string;
+  signedInvoice?: string;
+  status?: string;
+  documentNumber?: string;
+  errorMessage?: string | null;
+}
+
+export interface EimsRegisterResponse {
+  statusCode?: number;
+  message?: string;
+  body?: EimsRegisterResponseBody;
+}
+
+/**
+ * Inner request of `POST /v1/verify`. The wire property is lowercase `irn` and is required —
+ * omitting it yields a 400 "SCHEMA ERROR" reporting `$: required property 'irn' not found`.
+ */
+export interface EimsVerifyRequest {
+  irn: string;
+}
+
+/**
+ * `body` of a successful `POST /v1/verify` — the stored document echoed back. Note the casing
+ * flip against the request: the response spells the reference `Irn`.
+ *
+ * Only the fields we actually assert on are typed; the rest of the echoed document (SellerDetails,
+ * BuyerDetails, ItemList, …) is carried through untyped because nothing here reads it.
+ */
+export interface EimsVerifyResponseBody {
+  Irn?: string;
+  TransactionType?: string;
+  DocumentDetails?: {
+    Type?: string;
+    DocumentNumber?: string;
+    Date?: string;
+  };
+  Version?: string;
+  [section: string]: unknown;
+}
+
+export interface EimsVerifyResponse {
+  statusCode?: number;
+  message?: string;
+  body?: EimsVerifyResponseBody;
+}
+
+/**
+ * `POST /v1/cancel` — bearer-authenticated but unsigned, same shape as `/v1/verify` (no
+ * `{request,signature,certificate}` envelope in the collection's saved request).
+ */
+export interface EimsCancelRequest {
+  Irn: string;
+  /** Numeric code as a string, e.g. "1" (Duplicate), "6" (Calculation Error) per the collection docs. */
+  ReasonCode: string;
+  Remark: string;
+}
+
+/** Success body: `{ cancellationDate: "Sun Dec 22 21:55:03 EAT 2024" }` — a Java Date#toString(), not ISO. Stored verbatim, like `eimsAckDate`. */
+export interface EimsCancelResponseBody {
+  cancellationDate: string;
+}
+
+export interface EimsCancelResponse {
+  statusCode?: number;
+  message?: string;
+  body?: EimsCancelResponseBody;
+}
+
+/** `POST /v1/bulkCancel` — an array of the same `Irn`/`ReasonCode`/`Remark` shape as single cancel. */
+export type EimsBulkCancelRequest = EimsCancelRequest[];
+
+/**
+ * One element of a `/v1/bulkCancel` response array — MoR mixes success and error shapes in the same
+ * array, one entry per submitted IRN, disambiguated by `Status` (capital, error) vs `status`
+ * (lowercase, success — always `"C"`). Unlike single cancel, a bulk success carries no
+ * `cancellationDate` at all.
+ */
+export interface EimsBulkCancelSuccessItem {
+  id?: number;
+  tin?: string;
+  status: string;
+  mode?: string;
+  Irn: string;
+  ReasonCode?: string;
+  Remark?: string;
+}
+
+export interface EimsBulkCancelErrorItem {
+  Status: string;
+  msg: string;
+  Irn: string;
+}
+
+export type EimsBulkCancelResponseItem = EimsBulkCancelSuccessItem | EimsBulkCancelErrorItem;
+
+export interface EimsBulkCancelResponse {
+  statusCode?: number;
+  message?: string;
+  body?: EimsBulkCancelResponseItem[];
+}
+
+/** One invoice's outcome from `cancelBulkWithEims` — local eligibility failure or MoR's own result. */
+export interface EimsBulkCancelItemResult {
+  invoiceId: string;
+  success: boolean;
+  message: string;
+}
+
+/**
+ * `POST /v1/bulkRegister` — same array-of-full-documents shape as single register (`EimsInvoiceRequest`
+ * from `eims-invoice.mapper.ts`), one element per invoice, sent as one signed envelope.
+ */
+export type EimsBulkRegisterRequest = EimsInvoiceRequest[];
+
+/**
+ * Immediate response to `bulkRegister` — unlike single register, this is not the result, just an
+ * acknowledgement. The real per-invoice outcomes arrive later via `EimsBulkCallbackItem`s pushed to
+ * a webhook MoR was configured with out of band (see `EimsBulkRegistrationService`).
+ */
+export interface EimsBulkRegisterAcceptedResponse {
+  conversationId: string;
+  status: number;
+}
+
+/** A settled item in the async callback — `irn` present means MoR accepted this document. */
+export interface EimsBulkCallbackSuccessItem {
+  irn: string;
+  status: string;
+  documentNumber: string;
+  signedQR?: string;
+  signedInvoice?: string;
+}
+
+/** A rejected item in the async callback — `docNo` echoes what we submitted as `DocumentNumber`. */
+export interface EimsBulkCallbackErrorItem {
+  ruleError: Array<{ portion: string; errorMessage: string[] }>;
+  status: string;
+  docNo: string;
+}
+
+/**
+ * The callback array's last element, per the collection's own examples — never a settlement result,
+ * just the batch id echoed back. Spelled two different ways across the collection's own docs
+ * ("conversationId" on the initial 202, "conversionId" in the callback examples); accept both.
+ */
+export interface EimsBulkCallbackMarker {
+  conversationId?: string;
+  conversionId?: string;
+}
+
+export type EimsBulkCallbackItem =
+  | EimsBulkCallbackSuccessItem
+  | EimsBulkCallbackErrorItem
+  | EimsBulkCallbackMarker;
+
+/** One invoice's outcome once a bulk batch's callback has been processed. */
+export interface EimsBulkRegisterItemResult {
+  invoiceId: string;
+  invoiceNumber: string;
+  success: boolean;
+  message: string;
+  irn?: string;
+}
+
+/** Persisted failure detail. Carries the gateway's own error fields only — never our envelope. */
+export interface EimsInvoiceError {
+  kind: string;
+  message: string;
+  httpStatus?: number;
+  details?: EimsErrorResponse;
+  at: string;
+}
+
+/** What the status endpoint returns, and what a later invoice-detail panel will render. */
+export interface EimsInvoiceStatusView {
+  invoiceId: string;
+  invoiceNumber: string;
+  eimsStatus: EimsInvoiceStatus;
+  eimsIrn: string | null;
+  /** The numeric DocumentNumber filed with MoR; not our own invoiceNumber. */
+  eimsDocumentNumber: string | null;
+  eimsInvoiceCounter: number | null;
+  eimsSubmittedAt: Date | null;
+  eimsAckDate: string | null;
+  eimsLastError: EimsInvoiceError | null;
+  /** Raw base64 PNG from MoR, already rendered on their side — see `Invoice.eimsSignedQr`. */
+  eimsSignedQr: string | null;
+  eimsCancelledAt: Date | null;
+  eimsCancellationDate: string | null;
+  eimsCancellationReasonCode: string | null;
+  eimsCancellationRemark: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-seller-cache.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-seller-cache.service.spec.ts
new file mode 100644
index 000000000..7b4ff1b3f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-seller-cache.service.spec.ts
@@ -0,0 +1,155 @@
+import { ConfigService } from "@nestjs/config";
+
+import { EimsConfig } from "../../config/eims.config";
+import { ETradeService } from "../companies/services/etrade.service";
+import { eimsConfig, eimsInvoiceConfig } from "./eims-test-fixtures";
+import { EimsSellerCacheService } from "./eims-seller-cache.service";
+
+const registrationData = (over: Record<string, unknown> = {}) => ({
+  companyName: "Ethio-Djibouti Railway PLC (eTrade)",
+  region: "Addis Ababa",
+  zone: "Bole",
+  woreda: "Yeka",
+  mobilePhone: "0911000000",
+  regularPhone: "",
+  ...over,
+});
+
+const build = (cfg: EimsConfig = eimsConfig()) => {
+  const resolveCompanyData = jest.fn();
+  const extractRegistrationData = jest.fn().mockReturnValue(registrationData());
+  const etrade = { resolveCompanyData, extractRegistrationData } as unknown as ETradeService;
+  const config = { get: () => cfg } as unknown as ConfigService;
+  const service = new EimsSellerCacheService(etrade, config);
+  return { service, resolveCompanyData, extractRegistrationData, cfg };
+};
+
+const CODES = {
+  buyerRegionCodes: { "Addis Ababa": "13" },
+  buyerWeredaCodes: { Yeka: "99" },
+  buyerCityCodes: { Bole: "101" },
+};
+
+describe("EimsSellerCacheService.getSellerDetails", () => {
+  it("static config wins over a conflicting e-Trade value", async () => {
+    const cfg = eimsConfig({
+      invoice: eimsInvoiceConfig({ sellerLegalName: "Ethio-Djibouti Railway S.C.", ...CODES }),
+    });
+    const { service, resolveCompanyData } = build(cfg);
+    resolveCompanyData.mockResolvedValue({
+      companyInfo: {},
+      businessInfo: {}, // presence is all that matters — extractRegistrationData is mocked
+    });
+
+    await service.refresh();
+    const seller = service.getSellerDetails(cfg);
+
+    // The static sellerLegalName ("Ethio-Djibouti Railway S.C.") must survive, not e-Trade's
+    // differently-punctuated "Ethio-Djibouti Railway PLC (eTrade)".
+    expect(seller.LegalName).toBe("Ethio-Djibouti Railway S.C.");
+  });
+
+  it("e-Trade fills a field only when the static value is blank", async () => {
+    const cfg = eimsConfig({
+      invoice: eimsInvoiceConfig({
+        sellerLegalName: "",
+        sellerRegion: "",
+        sellerWereda: "",
+        sellerCity: null,
+        ...CODES,
+      }),
+    });
+    const { service, resolveCompanyData } = build(cfg);
+    resolveCompanyData.mockResolvedValue({ companyInfo: {}, businessInfo: {} });
+
+    await service.refresh();
+    const seller = service.getSellerDetails(cfg);
+
+    expect(seller.LegalName).toBe("Ethio-Djibouti Railway PLC (eTrade)");
+    expect(seller.Region).toBe("13");
+    expect(seller.Wereda).toBe("99");
+    expect(seller.City).toBe("101");
+  });
+
+  it("VatNumber and Email are always the static value, never touched by e-Trade", async () => {
+    const cfg = eimsConfig({
+      invoice: eimsInvoiceConfig({ sellerVatNumber: "0000000000", sellerEmail: "finance@example.et", ...CODES }),
+    });
+    const { service, resolveCompanyData } = build(cfg);
+    resolveCompanyData.mockResolvedValue({ companyInfo: {}, businessInfo: {} });
+
+    await service.refresh();
+    const seller = service.getSellerDetails(cfg);
+
+    expect(seller.VatNumber).toBe("0000000000");
+    expect(seller.Email).toBe("finance@example.et");
+  });
+
+  it("falls back to the static config entirely when e-Trade has never been reachable", () => {
+    const cfg = eimsConfig();
+    const { service } = build(cfg);
+
+    // No refresh() ever called/succeeded — cached stays null.
+    const seller = service.getSellerDetails(cfg);
+
+    expect(seller.LegalName).toBe(cfg.invoice.sellerLegalName);
+    expect(seller.Region).toBe(cfg.invoice.sellerRegion);
+  });
+
+  it("does no I/O at all — filing never triggers an e-Trade request", () => {
+    const { service, resolveCompanyData, cfg } = build();
+
+    service.getSellerDetails(cfg);
+    service.getSellerDetails(cfg);
+
+    expect(resolveCompanyData).not.toHaveBeenCalled();
+  });
+});
+
+describe("EimsSellerCacheService.refresh", () => {
+  it("keeps the previous snapshot when a refresh fails", async () => {
+    const cfg = eimsConfig({ invoice: eimsInvoiceConfig({ sellerLegalName: "", ...CODES }) });
+    const { service, resolveCompanyData } = build(cfg);
+    resolveCompanyData.mockResolvedValueOnce({ companyInfo: {}, businessInfo: {} });
+    await service.refresh();
+    expect(service.getSellerDetails(cfg).LegalName).toBe("Ethio-Djibouti Railway PLC (eTrade)");
+
+    resolveCompanyData.mockRejectedValueOnce(new Error("eTrade down"));
+    await service.refresh();
+
+    expect(service.getSellerDetails(cfg).LegalName).toBe("Ethio-Djibouti Railway PLC (eTrade)");
+  });
+
+  it("keeps the previous snapshot on timeout, without waiting for the slow request", async () => {
+    jest.useFakeTimers();
+    try {
+      const cfg = eimsConfig({ invoice: eimsInvoiceConfig({ sellerLegalName: "", ...CODES }) });
+      const { service, resolveCompanyData } = build(cfg);
+      resolveCompanyData.mockResolvedValueOnce({ companyInfo: {}, businessInfo: {} });
+      await service.refresh();
+      expect(service.getSellerDetails(cfg).LegalName).toBe("Ethio-Djibouti Railway PLC (eTrade)");
+
+      resolveCompanyData.mockReturnValueOnce(new Promise(() => {})); // never resolves
+      const refreshing = service.refresh();
+      await jest.advanceTimersByTimeAsync(10_000);
+      await refreshing;
+
+      expect(service.getSellerDetails(cfg).LegalName).toBe("Ethio-Djibouti Railway PLC (eTrade)");
+    } finally {
+      jest.useRealTimers();
+    }
+  });
+
+  it("does not start a second e-Trade request while one is already in flight", async () => {
+    const { service, resolveCompanyData } = build();
+    let resolveCall: (value: unknown) => void = () => {};
+    resolveCompanyData.mockReturnValue(new Promise((resolve) => (resolveCall = resolve)));
+
+    const first = service.refresh();
+    const second = service.refresh();
+    resolveCall({ companyInfo: {}, businessInfo: {} });
+    await Promise.all([first, second]);
+
+    expect(resolveCompanyData).toHaveBeenCalledTimes(1);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-seller-cache.service.ts b/apps/edr-freight-api/src/modules/eims/eims-seller-cache.service.ts
new file mode 100644
index 000000000..a8d242929
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-seller-cache.service.ts
@@ -0,0 +1,147 @@
+import { Injectable, Logger, OnModuleInit } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+
+import { EimsConfig } from "../../config/eims.config";
+import { ETradeService } from "../companies/services/etrade.service";
+import { EimsSellerDetails, resolveOptionalCode } from "../billing/eims-invoice.mapper";
+import { buildEimsSeller } from "./eims-invoice-context";
+
+const has = (value: string | null | undefined): value is string => Boolean(value && value.trim());
+
+/**
+ * EDR's own EIMS seller identity (LegalName/Phone/Region/Wereda/City), enriched from the same
+ * e-Trade business-registry lookup already used for every customer company at onboarding — instead
+ * of the whole thing being hand-maintained `EIMS_SELLER_*` config.
+ *
+ * **Static config is the source of truth, e-Trade is bootstrap/enrichment only.** MoR validates
+ * `SellerDetails` against its own taxpayer registry (rule 7017, already cleared and live-tested
+ * with the current static values) — e-Trade filling a gap is fine, e-Trade silently overriding a
+ * value already confirmed against MoR is not. `getSellerDetails` therefore only reaches for the
+ * e-Trade-derived value when the static one is blank; a static value, once set, is never replaced.
+ * This also means the durable fallback is the static config, not this cache — the in-memory
+ * snapshot disappearing on a process restart is harmless, not a reliability gap: every field it
+ * could supply already has a working static value today, so filing is unaffected either way.
+ *
+ * `VatNumber` and `Email` are never sourced here — confirmed by reading e-Trade's actual response
+ * shapes (`ETradeCompanyInfo`, `ETradeBusinessInfo`, `CompanyRegistrationData`): neither field
+ * exists anywhere in what e-Trade returns. They stay on static config permanently, same as
+ * `SubCity`/`Locality`/`HouseNumber`, which this pass doesn't touch.
+ *
+ * Cache shape follows `PositionTypePermissionsCache`'s precedent (`src/common/
+ * position-type-permissions.cache.ts`) for "external/slow data, not fetched per request": a plain
+ * field refreshed on a raw `setInterval`, `unref()`'d so it never holds the process open, and a
+ * refresh failure keeps serving the previous snapshot rather than clearing it. Two deliberate
+ * deviations from that precedent, both because `ETradeService` has no request timeout configured
+ * at all (confirmed by reading it) and is a third-party dependency, unlike the DB:
+ *  - the first fetch is fire-and-forget in `onModuleInit`, never awaited by boot;
+ *  - `refresh()` is wrapped in a local timeout, and a second call while one is already in flight
+ *    returns the same in-flight promise instead of starting a duplicate request.
+ *
+ * `getSellerDetails` is fully synchronous — zero I/O at call time — so a live invoice registration
+ * never depends on e-Trade being reachable at that moment, whether or not it ever has been.
+ */
+@Injectable()
+export class EimsSellerCacheService implements OnModuleInit {
+  private readonly logger = new Logger(EimsSellerCacheService.name);
+
+  /** Only the e-Trade-derived fields, used solely to fill a blank static value. */
+  private cached: Partial<EimsSellerDetails> | null = null;
+  /** Concurrency guard — a second `refresh()` call while one is running joins it. */
+  private refreshing: Promise<void> | null = null;
+
+  // ponytail: daily refresh, no invalidation hook — a change at e-Trade takes up to 24h to reach a
+  // filed invoice. Wire a manual refresh() call (e.g. from an admin action) if that lag ever
+  // matters; EDR's own business registration changes rarely enough that this is a generous
+  // ceiling, not a real one.
+  private static readonly REFRESH_INTERVAL_MS = 24 * 60 * 60 * 1000;
+  /** Bounded locally since `ETradeService` itself sets none — see the class comment. */
+  private static readonly REFRESH_TIMEOUT_MS = 10_000;
+
+  constructor(
+    private readonly etrade: ETradeService,
+    private readonly config: ConfigService,
+  ) {}
+
+  onModuleInit(): void {
+    void this.refresh();
+    const timer = setInterval(() => void this.refresh(), EimsSellerCacheService.REFRESH_INTERVAL_MS);
+    timer.unref?.();
+  }
+
+  /**
+   * Static config wins whenever it's non-blank — that's the value already confirmed against MoR.
+   * e-Trade fills a field only when the static one is empty. Synchronous, no I/O: safe to call on
+   * every registration.
+   */
+  getSellerDetails(cfg: EimsConfig): EimsSellerDetails {
+    const fallback = buildEimsSeller(cfg);
+    const e = this.cached;
+    return {
+      ...fallback,
+      LegalName: has(fallback.LegalName) ? fallback.LegalName : (e?.LegalName ?? fallback.LegalName),
+      Phone: has(fallback.Phone) ? fallback.Phone : (e?.Phone ?? fallback.Phone),
+      Region: has(fallback.Region) ? fallback.Region : (e?.Region ?? fallback.Region),
+      Wereda: has(fallback.Wereda) ? fallback.Wereda : (e?.Wereda ?? fallback.Wereda),
+      City: has(fallback.City) ? fallback.City : (e?.City ?? fallback.City),
+    };
+  }
+
+  /** Reload the cache. Concurrency-safe (see class comment); public so a caller can force one. */
+  async refresh(): Promise<void> {
+    if (this.refreshing) return this.refreshing;
+    this.refreshing = this.doRefresh().finally(() => {
+      this.refreshing = null;
+    });
+    return this.refreshing;
+  }
+
+  private async doRefresh(): Promise<void> {
+    try {
+      const cfg = this.config.get<EimsConfig>("eims")!;
+      const { companyInfo, businessInfo } = await this.withTimeout(
+        this.etrade.resolveCompanyData(cfg.tin),
+        EimsSellerCacheService.REFRESH_TIMEOUT_MS,
+      );
+      if (!businessInfo) return; // no licence on file yet — keep the previous snapshot
+      const data = this.etrade.extractRegistrationData(businessInfo, companyInfo);
+      const codes = cfg.invoice;
+      this.cached = {
+        LegalName: data.companyName || undefined,
+        Phone: data.mobilePhone || data.regularPhone || undefined,
+        // e-Trade returns region/zone/woreda as names ("Addis Ababa", "Bole") — resolved via the
+        // same buyer code maps, since the geography is objective, not buyer-specific, despite the
+        // env var's "BUYER_" prefix. Never throws: an unmapped name just leaves that field to
+        // getSellerDetails' static-config fallback.
+        Region: resolveOptionalCode(data.region, codes.buyerRegionCodes),
+        Wereda: resolveOptionalCode(data.woreda, codes.buyerWeredaCodes),
+        City: resolveOptionalCode(data.zone, codes.buyerCityCodes),
+      };
+    } catch (err) {
+      this.logger.warn(
+        `EIMS seller e-Trade refresh failed, keeping previous snapshot: ${(err as Error).message}`,
+      );
+    }
+  }
+
+  /**
+   * `ETradeService` sets no request timeout of its own, so one is enforced here. Note this only
+   * stops *waiting* on the request — nothing cancels the underlying HTTP call (no
+   * `AbortController` wired into `ETradeService`), so a timed-out request may still complete in
+   * the background; its result is simply never read.
+   */
+  private withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {
+    return new Promise<T>((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error(`e-Trade lookup timed out after ${ms}ms`)), ms);
+      promise.then(
+        (value) => {
+          clearTimeout(timer);
+          resolve(value);
+        },
+        (err) => {
+          clearTimeout(timer);
+          reject(err);
+        },
+      );
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims-signer.service.spec.ts b/apps/edr-freight-api/src/modules/eims/eims-signer.service.spec.ts
new file mode 100644
index 000000000..f8210cab6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-signer.service.spec.ts
@@ -0,0 +1,172 @@
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createVerify, generateKeyPairSync } from "node:crypto";
+import { ConfigService } from "@nestjs/config";
+import { EimsCredentialsProvider } from "./eims-credentials.provider";
+import { EimsSignerService, toSignedBody } from "./eims-signer.service";
+
+/**
+ * Test-only key material: generated per run, never a production key. The "certificate" fixture is
+ * an arbitrary byte blob — the point is that its exact bytes survive base64 round-tripping, not
+ * that it is a valid X.509 chain.
+ */
+const CERTIFICATE_FIXTURE = "Subject: CN=TEST\n-----BEGIN CERTIFICATE-----\nZm9vYmFy\n-----END CERTIFICATE-----\n";
+
+let dir: string;
+let keyPath: string;
+let certPath: string;
+let publicKeyPem: string;
+let signer: EimsSignerService;
+
+beforeAll(() => {
+  dir = mkdtempSync(join(tmpdir(), "eims-signer-"));
+  keyPath = join(dir, "private_key.key");
+  certPath = join(dir, "certificate.pem.txt");
+
+  const { privateKey, publicKey } = generateKeyPairSync("rsa", { modulusLength: 2048 });
+  writeFileSync(keyPath, privateKey.export({ type: "pkcs8", format: "pem" }));
+  writeFileSync(certPath, CERTIFICATE_FIXTURE, "utf8");
+  publicKeyPem = publicKey.export({ type: "spki", format: "pem" }).toString();
+
+  const config = {
+    get: () => ({ privateKeyPath: keyPath, certificatePath: certPath }),
+  } as unknown as ConfigService;
+  signer = new EimsSignerService(new EimsCredentialsProvider(config));
+});
+
+afterAll(() => rmSync(dir, { recursive: true, force: true }));
+
+const login = () => ({ clientId: "cid", clientSecret: "secret", apikey: "key", tin: "0000000000" });
+
+const verify = (payload: string, signature: string): boolean =>
+  createVerify("RSA-SHA512").update(payload, "utf8").verify(publicKeyPem, signature, "base64");
+
+describe("EimsSignerService", () => {
+  it("produces a signature that verifies against the matching public key", () => {
+    const signed = signer.signRequest(login());
+    expect(verify(JSON.stringify(signed.request), signed.signature)).toBe(true);
+  });
+
+  it("fails verification when a single request field changes", () => {
+    const signed = signer.signRequest(login());
+    const tampered = JSON.stringify({ ...signed.request, tin: "9999999999" });
+    expect(verify(tampered, signed.signature)).toBe(false);
+  });
+
+  it("emits a 256-byte signature for an RSA-2048 key", () => {
+    const signed = signer.signRequest(login());
+    expect(Buffer.from(signed.signature, "base64")).toHaveLength(256);
+  });
+
+  it("sends the certificate as base64 of the file's exact bytes", () => {
+    const signed = signer.signRequest(login());
+    expect(signed.certificate).toBe(readFileSync(certPath).toString("base64"));
+    expect(Buffer.from(signed.certificate, "base64").equals(readFileSync(certPath))).toBe(true);
+  });
+
+  it("signs the inner request only, and the wire body carries those exact bytes", () => {
+    const signed = signer.signRequest(login());
+    const body = toSignedBody(signed);
+
+    // The signed string appears verbatim inside the transmitted envelope.
+    expect(body).toContain(`"request":${JSON.stringify(signed.request)}`);
+    // Compact, never pretty-printed.
+    expect(body).not.toMatch(/\n/);
+    expect(JSON.parse(body)).toEqual({
+      request: login(),
+      signature: signed.signature,
+      certificate: signed.certificate,
+    });
+  });
+
+  it("does not mutate the request object", () => {
+    const request = login();
+    const signed = signer.signRequest(request);
+    expect(signed.request).toBe(request);
+    expect(request).toEqual(login());
+  });
+
+  it("reuses the loaded key and certificate across calls", () => {
+    const first = signer.signRequest(login());
+    const second = signer.signRequest(login());
+    // PKCS#1 v1.5 is deterministic: same key + same payload ⇒ identical signature.
+    expect(second.signature).toBe(first.signature);
+    expect(second.certificate).toBe(first.certificate);
+  });
+});
+
+describe("EimsCredentialsProvider", () => {
+  const providerFor = (cfg: {
+    privateKeyPath?: string;
+    certificatePath?: string;
+    privateKeyBase64?: string;
+    certificateBase64?: string;
+    privateKeyPem?: string;
+    certificatePem?: string;
+  }) => new EimsCredentialsProvider({ get: () => cfg } as unknown as ConfigService);
+
+  it("fails clearly when the key path is unset", () => {
+    expect(() => providerFor({}).getPrivateKey()).toThrow(/EIMS_PRIVATE_KEY_PATH is not set/);
+  });
+
+  it("fails clearly when the key file is missing", () => {
+    expect(() => providerFor({ privateKeyPath: join(dir, "nope.key") }).getPrivateKey()).toThrow(
+      /could not be read or parsed/,
+    );
+  });
+
+  it("fails clearly when the certificate file is empty", () => {
+    const emptyPath = join(dir, "empty.txt");
+    writeFileSync(emptyPath, "");
+    expect(() => providerFor({ certificatePath: emptyPath }).getCertificateBase64()).toThrow(/is empty/);
+  });
+
+  it("loads the key from inline base64, no file involved", () => {
+    const keyBase64 = readFileSync(keyPath).toString("base64");
+    const key = providerFor({ privateKeyBase64: keyBase64 }).getPrivateKey();
+    expect(key.asymmetricKeyType).toBe("rsa");
+  });
+
+  it("prefers inline base64 over the path when both are set", () => {
+    const keyBase64 = readFileSync(keyPath).toString("base64");
+    // A path that would fail if it were ever actually read.
+    const key = providerFor({ privateKeyBase64: keyBase64, privateKeyPath: join(dir, "nope.key") }).getPrivateKey();
+    expect(key.asymmetricKeyType).toBe("rsa");
+  });
+
+  it("loads the certificate from inline base64 as-is, no re-encoding", () => {
+    const certBase64 = Buffer.from(CERTIFICATE_FIXTURE, "utf8").toString("base64");
+    expect(providerFor({ certificateBase64: certBase64 }).getCertificateBase64()).toBe(certBase64);
+  });
+
+  it("fails with a decoded-bytes preview when the base64 doesn't decode to a PEM key", () => {
+    // Simulates the real failure this guards against: a truncated/mangled env var still decodes
+    // as *some* bytes, but not a key — OpenSSL's own error here gives no hint why.
+    const notAKey = Buffer.from("not actually a pem file", "utf8").toString("base64");
+    expect(() => providerFor({ privateKeyBase64: notAKey }).getPrivateKey()).toThrow(
+      /does not look like a PEM key.*23 bytes, starts with "not actually a pem file"/s,
+    );
+  });
+
+  it("loads the key from the raw PEM env var directly, no encoding step", () => {
+    const pem = readFileSync(keyPath).toString("utf8");
+    const key = providerFor({ privateKeyPem: pem }).getPrivateKey();
+    expect(key.asymmetricKeyType).toBe("rsa");
+  });
+
+  it("prefers the raw PEM var over base64 and path when all three are set", () => {
+    const pem = readFileSync(keyPath).toString("utf8");
+    const key = providerFor({
+      privateKeyPem: pem,
+      privateKeyBase64: Buffer.from("garbage").toString("base64"),
+      privateKeyPath: join(dir, "nope.key"),
+    }).getPrivateKey();
+    expect(key.asymmetricKeyType).toBe("rsa");
+  });
+
+  it("loads the certificate from the raw PEM env var, re-encoded to base64", () => {
+    const base64 = providerFor({ certificatePem: CERTIFICATE_FIXTURE }).getCertificateBase64();
+    expect(base64).toBe(Buffer.from(CERTIFICATE_FIXTURE, "utf8").toString("base64"));
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/eims/eims-signer.service.ts b/apps/edr-freight-api/src/modules/eims/eims-signer.service.ts
new file mode 100644
index 000000000..b91f306ab
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-signer.service.ts
@@ -0,0 +1,42 @@
+import { createSign } from "node:crypto";
+import { Injectable } from "@nestjs/common";
+import { EimsCredentialsProvider } from "./eims-credentials.provider";
+import { EimsSignedRequest } from "./eims.types";
+
+/**
+ * Signs EIMS request objects, reproducing the process that produced a working live access token:
+ *
+ *   1. compact `JSON.stringify` of the **inner** request object only,
+ *   2. those exact UTF-8 bytes,
+ *   3. RSA + SHA-512 (`SHA512withRSA`, PKCS#1 v1.5 — Node's default RSA padding). Confirmed, not
+ *      assumed: MoR's own "Guide to Generating and Using Certificate for E-Invoicing" names
+ *      `SHA512withRSA` explicitly, which is PKCS#1v1.5 in Java (PSS would be named
+ *      `SHA512withRSAandMGF1`) — the same padding `createSign("RSA-SHA512")` uses by default.
+ *   4. base64 of the raw signature bytes (256 bytes for an RSA-2048 key),
+ *   5. base64 of the certificate file's exact bytes. Also confirmed by the same guide: its own
+ *      worked example certificate is the identical `Subject:`/`Issuer:` header + 3-cert PEM chain
+ *      text-file format ours is, base64'd with no re-encoding.
+ *
+ * The outer `{request, signature, certificate}` envelope is never itself signed, and the request
+ * object is never mutated after serialization.
+ */
+@Injectable()
+export class EimsSignerService {
+  constructor(private readonly credentials: EimsCredentialsProvider) {}
+
+  signRequest<T>(request: T): EimsSignedRequest<T> {
+    const payload = JSON.stringify(request);
+    const signature = createSign("RSA-SHA512")
+      .update(payload, "utf8")
+      .sign(this.credentials.getPrivateKey(), "base64");
+
+    return { request, signature, certificate: this.credentials.getCertificateBase64() };
+  }
+}
+
+/**
+ * Exact wire body for a signed envelope. Serializing here (rather than handing axios an object)
+ * keeps one serializer in play: the `request` segment of this string is byte-identical to the
+ * string that was signed.
+ */
+export const toSignedBody = <T>(signed: EimsSignedRequest<T>): string => JSON.stringify(signed);
diff --git a/apps/edr-freight-api/src/modules/eims/eims-test-fixtures.ts b/apps/edr-freight-api/src/modules/eims/eims-test-fixtures.ts
new file mode 100644
index 000000000..a55951db4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-test-fixtures.ts
@@ -0,0 +1,92 @@
+import { EimsConfig, EimsInvoiceConfig } from "../../config/eims.config";
+
+/**
+ * Fixtures shared by the EIMS specs.
+ *
+ * Deliberately not a `.spec.ts`: importing fixtures from a spec file makes jest execute that
+ * file's `describe` blocks inside every importing suite, so the same tests run — and report —
+ * twice.
+ */
+
+export const EIMS_SYSTEM_NUMBER = "B0360154BA";
+export const EIMS_SYSTEM_TYPE = "SYS";
+
+export const eimsInvoiceConfig = (over: Partial<EimsInvoiceConfig> = {}): EimsInvoiceConfig => ({
+  sellerLegalName: "Ethio-Djibouti Railway S.C.",
+  sellerVatNumber: "0000000000",
+  sellerPhone: "0911223344",
+  sellerEmail: "finance@example.et",
+  sellerRegion: "13",
+  sellerWereda: "574",
+  sellerCity: null,
+  sellerSubCity: null,
+  sellerHouseNumber: null,
+  sellerLocality: null,
+  taxCode: "VAT15",
+  taxRatePercent: 15,
+  exciseTaxValue: 0,
+  incomeWithholdValue: 0,
+  transactionWithholdValue: 0,
+  transactionType: "B2B",
+  natureOfSupplies: "Service",
+  paymentMode: "CASH",
+  paymentTerm: "IMMIDIATE",
+  unitDefault: "PCS",
+  buyerCountryCode: null,
+  buyerCountryCodes: { Ethiopia: "231" }, // test-only, not a confirmed real MoR code
+  buyerRegionCodes: { "Addis Ababa": "13" },
+  buyerWeredaCodes: { Yeka: "99" }, // test-only, not a real MoR code
+  buyerCityCodes: { Kirkos: "101" }, // test-only, not a confirmed real MoR code
+  taxCodeByChargeType: {},
+  taxRateByChargeType: {},
+  exciseByChargeType: {},
+  discountByChargeType: {},
+  cashierName: null,
+  salesPersonName: null,
+  buyerIdType: null,
+  buyerIdNumber: null,
+  ...over,
+});
+
+export const eimsConfig = (over: Partial<EimsConfig> = {}): EimsConfig => ({
+  enabled: true,
+  baseUrl: "https://core.mor.gov.et",
+  clientId: "cid",
+  clientSecret: "super-secret-value",
+  apiKey: "super-secret-apikey",
+  tin: "0000034558",
+  systemNumber: EIMS_SYSTEM_NUMBER,
+  systemType: EIMS_SYSTEM_TYPE,
+  privateKeyPath: "/dev/null",
+  certificatePath: "/dev/null",
+  privateKeyBase64: "",
+  certificateBase64: "",
+  privateKeyPem: "",
+  certificatePem: "",
+  httpTimeoutMs: 30_000,
+  tokenSkewMs: 45_000,
+  autoSubmit: false,
+  autoSubmitCron: "0 */5 * * * *",
+  autoSubmitMaxAgeDays: 3,
+  invoice: eimsInvoiceConfig(),
+  ...over,
+});
+
+/**
+ * A structurally real access token. MoR stamps the source-system identity into the JWT payload and
+ * `EimsAuthService` reads it from there; only the payload segment is meaningful, since the token is
+ * never verified locally — it is MoR's, signed with MoR's key.
+ *
+ * Pass a claim as `undefined` to omit it (spreading beats `delete`, which the defaults would undo).
+ */
+export const eimsToken = (claims: Record<string, unknown> = {}): string => {
+  const payload = { systemNumber: EIMS_SYSTEM_NUMBER, systemType: EIMS_SYSTEM_TYPE, ...claims };
+  for (const [key, value] of Object.entries(payload)) {
+    if (value === undefined) delete (payload as Record<string, unknown>)[key];
+  }
+  return [
+    "eyJhbGciOiJSUzI1NiJ9",
+    Buffer.from(JSON.stringify(payload)).toString("base64url"),
+    "signature",
+  ].join(".");
+};
diff --git a/apps/edr-freight-api/src/modules/eims/eims-webhook.controller.ts b/apps/edr-freight-api/src/modules/eims/eims-webhook.controller.ts
new file mode 100644
index 000000000..e2b3ab49e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims-webhook.controller.ts
@@ -0,0 +1,25 @@
+import { Body, Controller, HttpCode, Post } from "@nestjs/common";
+import { ApiExcludeController } from "@nestjs/swagger";
+import { Public } from "@edr/api-common";
+import { EimsBulkCallbackItem } from "./eims-registration.types";
+import { EimsBulkRegistrationService } from "./eims-bulk-registration.service";
+
+/**
+ * MoR's own callback for `POST /v1/bulkRegister`, not a route a person calls. Public — MoR has no
+ * JWT to send — so the conversation id embedded in the payload is the only thing standing between
+ * this and a forged callback: `EimsBulkRegistrationService.handleBulkCallback` only ever touches
+ * invoices actually holding that exact id, and an unrecognised one is logged and ignored. See the
+ * "Callback Mechanism" section of the collection's own docs for the payload shape.
+ */
+@ApiExcludeController()
+@Controller("eims/webhook")
+export class EimsWebhookController {
+  constructor(private readonly bulk: EimsBulkRegistrationService) {}
+
+  @Public()
+  @Post("bulk-register")
+  @HttpCode(200)
+  bulkRegisterCallback(@Body() items: EimsBulkCallbackItem[]) {
+    return this.bulk.handleBulkCallback(items);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims.errors.ts b/apps/edr-freight-api/src/modules/eims/eims.errors.ts
new file mode 100644
index 000000000..853b32c29
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims.errors.ts
@@ -0,0 +1,91 @@
+import { BadGatewayException, ServiceUnavailableException } from "@nestjs/common";
+import { AxiosError } from "axios";
+import { EimsErrorResponse } from "./eims.types";
+
+export type EimsFailureKind =
+  | "NETWORK"
+  | "TIMEOUT"
+  | "SCHEMA_VALIDATION"
+  | "AUTH"
+  | "FORBIDDEN"
+  | "RULE_VALIDATION"
+  | "SERVER"
+  | "UNKNOWN"
+  | "CONFIG"
+  | "LOCAL";
+
+/** Raised when EIMS is disabled or its credential files are unusable. */
+export class EimsConfigException extends ServiceUnavailableException {
+  constructor(message: string) {
+    super({ code: "EIMS_NOT_CONFIGURED", message });
+  }
+}
+
+/**
+ * A failed EIMS call. Carries only the gateway's own error reporting — never the request body,
+ * signature, certificate, bearer token or any configured secret.
+ */
+export class EimsApiException extends BadGatewayException {
+  constructor(
+    readonly kind: EimsFailureKind,
+    message: string,
+    readonly httpStatus?: number,
+    readonly details?: EimsErrorResponse,
+  ) {
+    super({ code: `EIMS_${kind}`, message });
+  }
+}
+
+const SAFE_KEYS = ["message", "statusCode", "code", "details", "body"] as const;
+
+/**
+ * Keep only the gateway's error-reporting fields. Anything else a response might carry — an echoed
+ * request, a token, a signature — is dropped before it can reach a log or an exception payload.
+ */
+export function redactEimsBody(data: unknown): EimsErrorResponse | undefined {
+  if (!data || typeof data !== "object") return undefined;
+  const source = data as Record<string, unknown>;
+  const safe: Record<string, unknown> = {};
+  for (const key of SAFE_KEYS) {
+    if (source[key] !== undefined) safe[key] = source[key];
+  }
+  return Object.keys(safe).length > 0 ? (safe as EimsErrorResponse) : undefined;
+}
+
+const kindFor = (status: number): EimsFailureKind => {
+  if (status === 400) return "SCHEMA_VALIDATION";
+  if (status === 401) return "AUTH";
+  if (status === 403) return "FORBIDDEN";
+  if (status === 406) return "RULE_VALIDATION";
+  if (status >= 500) return "SERVER";
+  return "UNKNOWN";
+};
+
+/** First error line the gateway gives us, whichever shape it used. */
+const describe = (body: EimsErrorResponse | undefined): string => {
+  if (!body) return "no error body";
+  const detail = body.details?.find((d) => d.errorMessage)?.errorMessage;
+  return [body.message, body.code && `code=${body.code}`, detail].filter(Boolean).join(" ") || "no error body";
+};
+
+/**
+ * Normalise anything thrown by an EIMS HTTP call into an `EimsApiException`. `operation` is a
+ * short label such as `"login"` or `"POST /v1/register"` — never a payload.
+ */
+export function toEimsApiException(err: unknown, operation: string): EimsApiException {
+  if (err instanceof EimsApiException) return err;
+
+  if (err instanceof AxiosError) {
+    if (err.code === "ECONNABORTED" || err.code === "ETIMEDOUT") {
+      return new EimsApiException("TIMEOUT", `EIMS ${operation} timed out`);
+    }
+    if (!err.response) {
+      return new EimsApiException("NETWORK", `EIMS ${operation} could not reach the gateway (${err.code ?? "no code"})`);
+    }
+    const status = err.response.status;
+    const body = redactEimsBody(err.response.data);
+    return new EimsApiException(kindFor(status), `EIMS ${operation} failed (${status}): ${describe(body)}`, status, body);
+  }
+
+  return new EimsApiException("UNKNOWN", `EIMS ${operation} failed: ${(err as Error)?.message ?? "unknown error"}`);
+}
diff --git a/apps/edr-freight-api/src/modules/eims/eims.module.ts b/apps/edr-freight-api/src/modules/eims/eims.module.ts
new file mode 100644
index 000000000..739bf7089
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims.module.ts
@@ -0,0 +1,67 @@
+import { HttpModule } from "@nestjs/axios";
+import { Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { Invoice } from "../billing/entities/invoice.entity";
+import { DocumentsModule } from "../billing/documents/documents.module";
+import { CompaniesModule } from "../companies/companies.module";
+import { NotificationInboxModule } from "../notification-inbox/notification-inbox.module";
+import { NotificationsModule } from "../notifications/notifications.module";
+import { EimsAuthService } from "./eims-auth.service";
+import { EimsAutoSubmitService } from "./eims-auto-submit.service";
+import { EimsBulkRegistrationService } from "./eims-bulk-registration.service";
+import { EimsCancellationService } from "./eims-cancellation.service";
+import { EimsClientService } from "./eims-client.service";
+import { EimsCredentialsProvider } from "./eims-credentials.provider";
+import { EimsInvoiceController } from "./eims-invoice.controller";
+import { EimsInvoiceRegistrationService } from "./eims-invoice-registration.service";
+import { EimsReceiptService } from "./eims-receipt.service";
+import { EimsSellerCacheService } from "./eims-seller-cache.service";
+import { EimsSignerService } from "./eims-signer.service";
+import { EimsWebhookController } from "./eims-webhook.controller";
+import { EimsReceipt } from "./entities/eims-receipt.entity";
+import { EimsSystemState } from "./entities/eims-system-state.entity";
+
+/**
+ * MoR EIMS e-invoicing: signed transport, authentication, and manual single-invoice registration.
+ *
+ * Exports only what other modules will consume; the credential loader and signer stay internal so
+ * the private key has exactly one user. Nothing here is called from invoice creation.
+ */
+@Module({
+  imports: [
+    HttpModule.register({ timeout: Number(process.env.EIMS_HTTP_TIMEOUT_MS) || 30_000 }),
+    TypeOrmModule.forFeature([EimsSystemState, Invoice, EimsReceipt]),
+    NotificationInboxModule,
+    NotificationsModule,
+    // For EimsReceiptService.document() — the shared sealed invoice/receipt PDF layout. No domain
+    // deps of its own (StampSettingsService/LogoSettingsService are both @Global), so no cycle.
+    DocumentsModule,
+    // For EimsSellerCacheService's ETradeService — CompaniesModule has a forwardRef cycle with
+    // ShippingLineCompaniesModule -> BillingModule, but nothing in that chain imports EimsModule,
+    // so this stays a plain one-directional import, not a new cycle.
+    CompaniesModule,
+  ],
+  controllers: [EimsInvoiceController, EimsWebhookController],
+  providers: [
+    EimsCredentialsProvider,
+    EimsSignerService,
+    EimsAuthService,
+    EimsClientService,
+    EimsInvoiceRegistrationService,
+    EimsBulkRegistrationService,
+    EimsAutoSubmitService,
+    EimsCancellationService,
+    EimsReceiptService,
+    EimsSellerCacheService,
+  ],
+  exports: [
+    EimsAuthService,
+    EimsClientService,
+    EimsInvoiceRegistrationService,
+    EimsBulkRegistrationService,
+    EimsCancellationService,
+    EimsReceiptService,
+  ],
+})
+export class EimsModule {}
diff --git a/apps/edr-freight-api/src/modules/eims/eims.types.ts b/apps/edr-freight-api/src/modules/eims/eims.types.ts
new file mode 100644
index 000000000..6e74604bd
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/eims.types.ts
@@ -0,0 +1,46 @@
+/**
+ * Wire types for the MoR EIMS gateway, taken from the supplied Postman collection.
+ *
+ * Every protected payload is the same envelope: the business object under `request`, a base64
+ * RSA-SHA512 signature over the *inner* object only, and the base64 certificate bundle.
+ */
+export interface EimsSignedRequest<T> {
+  request: T;
+  signature: string;
+  certificate: string;
+}
+
+/** Inner request of `POST /auth/login`. Note the lowercase `apikey` — that is the wire name. */
+export interface EimsLoginRequest {
+  clientId: string;
+  clientSecret: string;
+  apikey: string;
+  tin: string;
+}
+
+export interface EimsLoginData {
+  accessToken: string;
+  refreshToken: string;
+  /** Observed as a UUID on login and `null` on refresh; unused today. */
+  encryptionKey: string | null;
+  /** Seconds. Observed value: 3600. */
+  expiresIn: number;
+}
+
+export interface EimsLoginResponse {
+  data: EimsLoginData;
+  status: string;
+}
+
+/**
+ * Error bodies differ per failure mode: gateway errors carry `message`/`code`/`details`,
+ * schema errors carry a JSON-Schema violation array under `body`, rule errors carry
+ * `[{portion, errorMessage[]}]` under `body`. Only these fields are ever surfaced or logged.
+ */
+export interface EimsErrorResponse {
+  message?: string;
+  statusCode?: number;
+  code?: string;
+  details?: { errorMessage?: string; field?: string }[];
+  body?: unknown;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/entities/eims-receipt.entity.ts b/apps/edr-freight-api/src/modules/eims/entities/eims-receipt.entity.ts
new file mode 100644
index 000000000..a785a42c2
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/entities/eims-receipt.entity.ts
@@ -0,0 +1,68 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+
+import { Invoice } from "../../billing/entities/invoice.entity";
+import { EimsInvoiceError } from "../eims-registration.types";
+
+export type EimsReceiptKind = "SALES" | "WITHHOLDING";
+
+/** Same shape as `EimsInvoiceStatus`, for a receipt instead of an invoice. */
+export enum EimsReceiptStatus {
+  NotSubmitted = "NOT_SUBMITTED",
+  Submitting = "SUBMITTING",
+  Registered = "REGISTERED",
+  Failed = "FAILED",
+  Unknown = "UNKNOWN",
+}
+
+/**
+ * One `POST /v1/receipt/sales` or `POST /v1/receipt/withholding` attempt, linked to the invoice it
+ * was filed against. An invoice can have more than one receipt (partial payments), so this is its
+ * own table rather than columns on `Invoice`.
+ *
+ * No counter/sequence reservation the way invoice registration has: the collection's `/v1/receipt/*`
+ * examples show no MoR-enforced ordering rule on `ReceiptCounter` (unlike `InvoiceCounter`'s
+ * documented "expected: N"), so this is a plain row per attempt.
+ */
+@Entity({ schema: "freight", name: "eims_receipts" })
+@Index(["invoiceId"])
+export class EimsReceipt extends BaseEntity {
+  @Column({ name: "invoice_id", type: "uuid" })
+  invoiceId!: string;
+
+  @ManyToOne(() => Invoice)
+  @JoinColumn({ name: "invoice_id" })
+  invoice?: Invoice;
+
+  @Column({ name: "kind", type: "varchar", length: 16 })
+  kind!: EimsReceiptKind;
+
+  @Column({ name: "status", type: "varchar", length: 20, default: "NOT_SUBMITTED" })
+  status!: EimsReceiptStatus;
+
+  /** Our own generated `ReceiptNumber` / `ManualReceiptNumber` (both sent equal — see the service). */
+  @Column({ name: "receipt_number", type: "varchar", length: 64 })
+  receiptNumber!: string;
+
+  /** MoR's Receipt Reference Number, returned only on success. */
+  @Column({ name: "rrn", type: "text", nullable: true })
+  rrn?: string | null;
+
+  /** Base64 PNG from MoR, same convention as `Invoice.eimsSignedQr` — embed directly. */
+  @Column({ name: "qr", type: "text", nullable: true })
+  qr?: string | null;
+
+  /** MoR's own `"A"` (active) / `"F"` (failed) status marker, stored verbatim. */
+  @Column({ name: "ack_status", type: "varchar", length: 8, nullable: true })
+  ackStatus?: string | null;
+
+  @Column({ name: "submitted_at", type: "timestamptz", nullable: true })
+  submittedAt?: Date | null;
+
+  @Column({ name: "last_error", type: "jsonb", nullable: true })
+  lastError?: EimsInvoiceError | null;
+
+  /** The exact request body sent — receipts are bearer-only/unsigned, so nothing secret is in it. */
+  @Column({ name: "request", type: "jsonb", nullable: true })
+  request?: Record<string, unknown> | null;
+}
diff --git a/apps/edr-freight-api/src/modules/eims/entities/eims-system-state.entity.ts b/apps/edr-freight-api/src/modules/eims/entities/eims-system-state.entity.ts
new file mode 100644
index 000000000..67b5d74d4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/eims/entities/eims-system-state.entity.ts
@@ -0,0 +1,64 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity } from "typeorm";
+
+/**
+ * One row per MoR system number, holding the sequence state EIMS expects across registrations:
+ * the next `SourceSystem.InvoiceCounter` and the IRN that the next document must chain to via
+ * `ReferenceDetails.PreviousIrn`.
+ *
+ * Registration locks this row `FOR UPDATE` for the duration of the submission, which is what keeps
+ * two concurrent registrations from claiming the same counter or breaking the IRN chain.
+ */
+@Entity({ schema: "freight", name: "eims_system_state" })
+export class EimsSystemState extends BaseEntity {
+  @Column({ name: "system_number", type: "varchar", length: 32, unique: true })
+  systemNumber!: string;
+
+  /** Counter to send on the next registration; advanced only once an attempt has consumed it. */
+  @Column({ name: "next_invoice_counter", type: "bigint", default: 1 })
+  nextInvoiceCounter!: number;
+
+  /**
+   * `DocumentDetails.DocumentNumber` for the next registration.
+   *
+   * Separate from our own `invoiceNumber`, which MoR cannot accept: it validates the field against
+   * `^(0|[1-9][0-9]{0,8})$`, a plain integer.
+   */
+  @Column({ name: "next_document_number", type: "bigint", default: 1 })
+  nextDocumentNumber!: number;
+
+  @Column({ name: "in_flight_document_number", type: "bigint", nullable: true })
+  inFlightDocumentNumber?: number | null;
+
+  /**
+   * IRN of the last successful registration; null until the first one succeeds. `text`, not a
+   * fixed varchar — same reasoning as `Invoice.eimsIrn`: a real IRN already overflowed varchar(64).
+   */
+  @Column({ name: "previous_irn", type: "text", nullable: true })
+  previousIrn?: string | null;
+
+  /**
+   * Invoice holding the current reservation. Committed before the HTTP call, so it survives a
+   * crash and blocks a blind resubmission of a document that may already have reached MoR.
+   */
+  @Column({ name: "in_flight_invoice_id", type: "uuid", nullable: true })
+  inFlightInvoiceId?: string | null;
+
+  /** Counter handed to the in-flight submission. */
+  @Column({ name: "in_flight_counter", type: "bigint", nullable: true })
+  inFlightCounter?: number | null;
+
+  /**
+   * Why registration is blocked for this system number. Set when a submission ends ambiguously:
+   * the IRN is unknown, so no further document can chain correctly until it is resolved.
+   */
+  @Column({ name: "blocked_reason", type: "text", nullable: true })
+  blockedReason?: string | null;
+
+  /**
+   * Bulk equivalent of `in_flight_invoice_id` — a whole batch, not one invoice, is outstanding
+   * while MoR processes `POST /v1/bulkRegister` asynchronously. See `EimsBulkRegistrationService`.
+   */
+  @Column({ name: "in_flight_conversation_id", type: "text", nullable: true })
+  inFlightConversationId?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/file-upload-settings/entities/file-upload-field.entity.ts b/apps/edr-freight-api/src/modules/file-upload-settings/entities/file-upload-field.entity.ts
index e76c5716b..097c1ec39 100644
--- a/apps/edr-freight-api/src/modules/file-upload-settings/entities/file-upload-field.entity.ts
+++ b/apps/edr-freight-api/src/modules/file-upload-settings/entities/file-upload-field.entity.ts
@@ -50,7 +50,7 @@ export class FileUploadField extends BaseEntity {
   })
   allowedExtensions!: string[];
 
-  @Column({ name: "max_size_mb", type: "integer", default: 10 })
+  @Column({ name: "max_size_mb", type: "integer", default: 50 })
   maxSizeMb!: number;
 
   @Column({ name: "display_order", type: "integer", default: 0 })
diff --git a/apps/edr-freight-api/src/modules/file-upload-settings/poa-delegation.constants.ts b/apps/edr-freight-api/src/modules/file-upload-settings/poa-delegation.constants.ts
index 9085cc018..e23a87818 100644
--- a/apps/edr-freight-api/src/modules/file-upload-settings/poa-delegation.constants.ts
+++ b/apps/edr-freight-api/src/modules/file-upload-settings/poa-delegation.constants.ts
@@ -26,6 +26,15 @@ export const POA_DELEGATION_LABEL = "DARS Delegation Paper";
 /** Prefix of the setting codes the field is injected into. */
 export const COMPANY_ONBOARDING_CODE_PREFIX = "company_onboarding_documents_";
 
+/**
+ * The co-operative onboarding set — the third alternative to `_ethiopian` and
+ * `_foreign`, not an addition to them: a union or farm resolves to this set
+ * INSTEAD of its nationality's, because it holds no business licence and so
+ * owes a different list of papers. The delegation paper is injected into it
+ * like any other company onboarding set.
+ */
+export const COOPERATIVE_ONBOARDING_CODE = `${COMPANY_ONBOARDING_CODE_PREFIX}cooperative`;
+
 const POA_DELEGATION_HELP =
   "Delegation paper issued by the Documents Authentication and Registration " +
   "Service (DARS) delegating the representative named above. Upload the " +
@@ -46,7 +55,7 @@ export function poaDelegationField(displayOrder: number): FileUploadField {
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: ["pdf", "jpg", "jpeg", "png"],
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder,
   } as FileUploadField;
 }
diff --git a/apps/edr-freight-api/src/modules/files/files.repository.ts b/apps/edr-freight-api/src/modules/files/files.repository.ts
index 9a2552c7a..e4164c3b2 100644
--- a/apps/edr-freight-api/src/modules/files/files.repository.ts
+++ b/apps/edr-freight-api/src/modules/files/files.repository.ts
@@ -84,6 +84,21 @@ export class FilesRepository extends BaseRepository<FileRecord> {
     });
   }
 
+  /**
+   * Every version of every document on a resource, oldest first — superseded
+   * versions included. One query for a whole document grid's upload history.
+   */
+  findAllVersionsByResource(
+    resourceId: string,
+    resource: string,
+  ): Promise<FileRecord[]> {
+    return this.repository.find({
+      where: { resourceId, resource },
+      withDeleted: true,
+      order: { createdAt: "ASC" },
+    });
+  }
+
   /**
    * Documents belonging to any of the given resources that a reviewer has asked
    * the customer to correct. Used by the approval gate, so it takes a list of
diff --git a/apps/edr-freight-api/src/modules/files/files.service.ts b/apps/edr-freight-api/src/modules/files/files.service.ts
index e76240704..e2481848a 100644
--- a/apps/edr-freight-api/src/modules/files/files.service.ts
+++ b/apps/edr-freight-api/src/modules/files/files.service.ts
@@ -327,6 +327,14 @@ export class FilesService {
     return this.filesRepository.findByResource(resourceId, resource);
   }
 
+  /** All versions of every document on a resource (superseded included), oldest first. */
+  findAllVersionsByResource(
+    resourceId: string,
+    resource: string,
+  ): Promise<FileRecord[]> {
+    return this.filesRepository.findAllVersionsByResource(resourceId, resource);
+  }
+
   /**
    * Files for many resources of one kind, grouped by resource id. Resources with
    * no files are absent from the map (callers should default to `[]`).
diff --git a/apps/edr-freight-api/src/modules/import-operations/dto/import-operations.dto.ts b/apps/edr-freight-api/src/modules/import-operations/dto/import-operations.dto.ts
index b3ec979b4..9af97f1e8 100644
--- a/apps/edr-freight-api/src/modules/import-operations/dto/import-operations.dto.ts
+++ b/apps/edr-freight-api/src/modules/import-operations/dto/import-operations.dto.ts
@@ -1,5 +1,17 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsArray, IsDateString, IsIn, IsOptional, IsString, IsUUID } from 'class-validator';
+import { Type } from 'class-transformer';
+import {
+  ArrayNotEmpty,
+  IsArray,
+  IsDateString,
+  IsIn,
+  IsInt,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Min,
+  ValidateNested,
+} from 'class-validator';
 
 import { DJIBOUTI_INCIDENT_TYPES, type DjiboutiIncidentType } from '../entities/djibouti-incident.entity';
 import {
@@ -120,6 +132,9 @@ export class ImportOperationActionDto {
   notes?: string;
 }
 
+export const EMPTY_CONTAINER_SIZES = ['20', '40'] as const;
+export type EmptyContainerSize = (typeof EMPTY_CONTAINER_SIZES)[number];
+
 export class CreateEmptyContainerReturnDto {
   @ApiProperty()
   @IsString()
@@ -140,6 +155,11 @@ export class CreateEmptyContainerReturnDto {
   @IsDateString()
   returnDate?: string;
 
+  @ApiPropertyOptional({ enum: EMPTY_CONTAINER_SIZES })
+  @IsOptional()
+  @IsIn(EMPTY_CONTAINER_SIZES)
+  containerSize?: EmptyContainerSize;
+
   @ApiPropertyOptional()
   @IsOptional()
   @IsString()
@@ -176,6 +196,39 @@ export class CreateEmptyContainerReturnDto {
   returnedBy?: 'EDR' | 'CUSTOMER';
 }
 
+export class LoadEmptyContainerItemDto {
+  @ApiProperty({ format: 'uuid' })
+  @IsUUID()
+  id!: string;
+
+  @ApiProperty({ enum: EMPTY_CONTAINER_SIZES })
+  @IsIn(EMPTY_CONTAINER_SIZES)
+  containerSize!: EmptyContainerSize;
+
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  wagonSequenceNo!: number;
+}
+
+export class LoadEmptyContainersOnTrainDto extends ImportOperationActionDto {
+  @ApiProperty({ format: 'uuid' })
+  @IsUUID()
+  trainScheduleId!: string;
+
+  @ApiPropertyOptional({ description: 'Run number shown on the return record.' })
+  @IsOptional()
+  @IsString()
+  trainNumber?: string;
+
+  @ApiProperty({ type: [LoadEmptyContainerItemDto] })
+  @IsArray()
+  @ArrayNotEmpty()
+  @ValidateNested({ each: true })
+  @Type(() => LoadEmptyContainerItemDto)
+  items!: LoadEmptyContainerItemDto[];
+}
+
 export class UpdateEmptyContainerReturnStatusDto extends ImportOperationActionDto {
   @ApiProperty({ enum: EMPTY_CONTAINER_RETURN_STATUSES })
   @IsIn(EMPTY_CONTAINER_RETURN_STATUSES)
diff --git a/apps/edr-freight-api/src/modules/import-operations/empty-container-wagon.util.spec.ts b/apps/edr-freight-api/src/modules/import-operations/empty-container-wagon.util.spec.ts
new file mode 100644
index 000000000..34fcece4c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/import-operations/empty-container-wagon.util.spec.ts
@@ -0,0 +1,23 @@
+import { assertWagonLoad } from './empty-container-wagon.util';
+
+describe('assertWagonLoad', () => {
+  it('accepts one 40ft or two 20ft per wagon', () => {
+    expect(() =>
+      assertWagonLoad(
+        new Map([
+          [1, ['40']],
+          [2, ['20', '20']],
+          [3, ['20']],
+        ]),
+      ),
+    ).not.toThrow();
+  });
+
+  it('rejects a 40ft sharing a wagon', () => {
+    expect(() => assertWagonLoad(new Map([[4, ['40', '20']]]))).toThrow(/Wagon 4/);
+  });
+
+  it('rejects three containers on a wagon', () => {
+    expect(() => assertWagonLoad(new Map([[5, ['20', '20', '20']]]))).toThrow(/Wagon 5/);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/import-operations/empty-container-wagon.util.ts b/apps/edr-freight-api/src/modules/import-operations/empty-container-wagon.util.ts
new file mode 100644
index 000000000..bc82db3ee
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/import-operations/empty-container-wagon.util.ts
@@ -0,0 +1,16 @@
+import { BadRequestException } from '@nestjs/common';
+
+/**
+ * A wagon carries ONE 40ft OR TWO 20ft empties — never a mix, never three.
+ * Throws on the first wagon that breaks the rule.
+ */
+export function assertWagonLoad(sizesByWagon: Map<number, string[]>): void {
+  for (const [wagon, sizes] of sizesByWagon) {
+    const has40 = sizes.some((size) => size === '40');
+    if ((has40 && sizes.length > 1) || sizes.length > 2) {
+      throw new BadRequestException(
+        `Wagon ${wagon} takes one 40ft or two 20ft containers — got ${sizes.join('ft + ')}ft`,
+      );
+    }
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/import-operations/entities/empty-container-return.entity.ts b/apps/edr-freight-api/src/modules/import-operations/entities/empty-container-return.entity.ts
index 2538a204b..263dd30d2 100644
--- a/apps/edr-freight-api/src/modules/import-operations/entities/empty-container-return.entity.ts
+++ b/apps/edr-freight-api/src/modules/import-operations/entities/empty-container-return.entity.ts
@@ -51,6 +51,17 @@ export class EmptyContainerReturn extends BaseEntity {
   @Column({ name: 'wagon_allocation_reference', type: 'varchar', length: 120, nullable: true })
   wagonAllocationReference?: string | null;
 
+  /** '20' or '40' — drives the one-40ft-or-two-20ft-per-wagon loading rule. */
+  @Column({ name: 'container_size', type: 'varchar', length: 10, nullable: true })
+  containerSize?: string | null;
+
+  /** Export departure carrying this empty back to Djibouti. */
+  @Column({ name: 'train_schedule_id', type: 'uuid', nullable: true })
+  trainScheduleId?: string | null;
+
+  @Column({ name: 'wagon_sequence_no', type: 'int', nullable: true })
+  wagonSequenceNo?: number | null;
+
   @Column({ name: 'performed_by', type: 'varchar', length: 120, nullable: true })
   performedBy?: string | null;
 
diff --git a/apps/edr-freight-api/src/modules/import-operations/import-operations.controller.ts b/apps/edr-freight-api/src/modules/import-operations/import-operations.controller.ts
index 15e5404a7..c631bef92 100644
--- a/apps/edr-freight-api/src/modules/import-operations/import-operations.controller.ts
+++ b/apps/edr-freight-api/src/modules/import-operations/import-operations.controller.ts
@@ -8,6 +8,7 @@ import {
   CreateDjiboutiIncidentDto,
   CreateEmptyContainerReturnDto,
   ImportOperationActionDto,
+  LoadEmptyContainersOnTrainDto,
   RecordDeclarationDto,
   UpdateEmptyContainerReturnStatusDto,
   UploadImportCustomsDocumentDto,
@@ -104,6 +105,14 @@ export class ImportOperationsController {
     return this.service.createEmptyReturn(dto);
   }
 
+  @Post('empty-container-returns/load-on-train')
+  @ApiOperation({
+    summary: 'Load returned empties onto an export train (1×40ft or 2×20ft per wagon)',
+  })
+  loadEmptyReturnsOnTrain(@Body() dto: LoadEmptyContainersOnTrainDto) {
+    return this.service.loadEmptyReturnsOnTrain(dto);
+  }
+
   @Post('empty-container-returns/:id/status')
   @ApiOperation({ summary: 'Batch 16: advance empty container return workflow' })
   updateEmptyReturnStatus(
diff --git a/apps/edr-freight-api/src/modules/import-operations/import-operations.service.ts b/apps/edr-freight-api/src/modules/import-operations/import-operations.service.ts
index bd40e2ab1..28eb4e44f 100644
--- a/apps/edr-freight-api/src/modules/import-operations/import-operations.service.ts
+++ b/apps/edr-freight-api/src/modules/import-operations/import-operations.service.ts
@@ -1,11 +1,12 @@
 import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
+import { In, Repository } from 'typeorm';
 
 import {
   CreateDjiboutiIncidentDto,
   CreateEmptyContainerReturnDto,
   ImportOperationActionDto,
+  LoadEmptyContainersOnTrainDto,
   RecordDeclarationDto,
   AssignCustomsRiskDto,
   UpdateEmptyContainerReturnStatusDto,
@@ -15,6 +16,7 @@ import {
   DjiboutiIncident,
   type DjiboutiIncidentType,
 } from './entities/djibouti-incident.entity';
+import { assertWagonLoad } from './empty-container-wagon.util';
 import { EmptyContainerReturn } from './entities/empty-container-return.entity';
 import {
   ImportCustomsFinalization,
@@ -156,6 +158,7 @@ export class ImportOperationsService {
         bookingId: dto.bookingId ?? null,
         customerId: dto.customerId ?? null,
         returnDate,
+        containerSize: dto.containerSize ?? null,
         facility: dto.facility ?? null,
         yard: dto.yard ?? null,
         zone: dto.zone ?? null,
@@ -170,6 +173,63 @@ export class ImportOperationsService {
     );
   }
 
+  /**
+   * Load returned empties onto an export departure. A wagon takes ONE 40ft or
+   * TWO 20ft — never a mix, never three. Empties already sitting on a wagon of
+   * the same schedule count against that wagon, so incremental loads cannot
+   * quietly double-book a slot.
+   *
+   * ponytail: does not check the wagon is free of cargo bookings — the loading
+   * UI picks only unallocated wagons from the schedule's plan. Cross-check here
+   * if empties ever get loaded from another client.
+   */
+  async loadEmptyReturnsOnTrain(dto: LoadEmptyContainersOnTrainDto) {
+    const ids = dto.items.map((item) => item.id);
+    const rows = await this.emptyReturns.find({ where: { id: In(ids) } });
+    const missing = ids.filter((id) => !rows.some((row) => row.id === id));
+    if (missing.length) {
+      throw new NotFoundException(`Empty container return(s) not found: ${missing.join(', ')}`);
+    }
+
+    const alreadyOnTrain = await this.emptyReturns.find({
+      where: { trainScheduleId: dto.trainScheduleId },
+    });
+    const byWagon = new Map<number, string[]>();
+    for (const row of alreadyOnTrain) {
+      if (row.wagonSequenceNo == null || ids.includes(row.id)) continue;
+      byWagon.set(row.wagonSequenceNo, [
+        ...(byWagon.get(row.wagonSequenceNo) ?? []),
+        row.containerSize ?? '40',
+      ]);
+    }
+    for (const item of dto.items) {
+      byWagon.set(item.wagonSequenceNo, [
+        ...(byWagon.get(item.wagonSequenceNo) ?? []),
+        item.containerSize,
+      ]);
+    }
+    assertWagonLoad(byWagon);
+
+    const changedAt = new Date().toISOString();
+    for (const item of dto.items) {
+      const row = rows.find((candidate) => candidate.id === item.id)!;
+      await this.emptyReturns.update(item.id, {
+        status: 'WAGON_ALLOCATED',
+        containerSize: item.containerSize,
+        trainScheduleId: dto.trainScheduleId,
+        wagonSequenceNo: item.wagonSequenceNo,
+        wagonAllocationReference: dto.trainNumber ?? dto.trainScheduleId,
+        performedBy: dto.performedBy ?? row.performedBy ?? null,
+        statusHistory: [
+          ...(row.statusHistory ?? []),
+          { status: 'WAGON_ALLOCATED' as const, changedAt, performedBy: dto.performedBy ?? null },
+        ],
+      });
+    }
+
+    return this.emptyReturns.find({ where: { trainScheduleId: dto.trainScheduleId } });
+  }
+
   async updateEmptyReturnStatus(id: string, dto: UpdateEmptyContainerReturnStatusDto) {
     const row = await this.emptyReturns.findOne({ where: { id } });
     if (!row) {
diff --git a/apps/edr-freight-api/src/modules/last-mile-requests/dto/approve-last-mile-request.dto.ts b/apps/edr-freight-api/src/modules/last-mile-requests/dto/approve-last-mile-request.dto.ts
index 56be0c545..0fa7457a8 100644
--- a/apps/edr-freight-api/src/modules/last-mile-requests/dto/approve-last-mile-request.dto.ts
+++ b/apps/edr-freight-api/src/modules/last-mile-requests/dto/approve-last-mile-request.dto.ts
@@ -1,13 +1,19 @@
-import { ApiProperty } from '@nestjs/swagger';
+import { ApiPropertyOptional } from '@nestjs/swagger';
 import { Transform } from 'class-transformer';
-import { IsNumber, Min } from 'class-validator';
+import { IsNumber, IsOptional, Min } from 'class-validator';
 
 export class ApproveLastMileRequestDto {
-  // The approve dialog prefills this from GET :id/price-estimate (rule-based),
-  // but the chief can still override — the typed value is what's invoiced.
-  @ApiProperty({ description: 'Advance amount the customer must pay before execution proceeds', example: 3000 })
-  @Transform(({ value }) => Number(value))
+  // Omitted = the rule-based last-mile rate estimate is the advance. The chief
+  // can still override with an explicit amount (required when no rate covers
+  // the job).
+  @ApiPropertyOptional({
+    description:
+      'Advance override. Omitted = the amount comes from the live last-mile rates (km × rate).',
+    example: 3000,
+  })
+  @IsOptional()
+  @Transform(({ value }) => (value === null || value === undefined || value === '' ? undefined : Number(value)))
   @IsNumber()
   @Min(0.01)
-  advanceAmount!: number;
+  advanceAmount?: number;
 }
diff --git a/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-contract.service.ts b/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-contract.service.ts
index c30112617..b1c89199c 100644
--- a/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-contract.service.ts
+++ b/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-contract.service.ts
@@ -13,6 +13,7 @@ import { FilesService } from '../files/files.service';
 import { FileRecord } from '../files/entities/file.entity';
 import { MinioService } from '../minio/minio.service';
 import { SignaturesService } from '../signatures/signatures.service';
+import { LogoSettingsService } from '../logo-settings/logo-settings.service';
 import { SignLastMileContractDto } from './dto/sign-last-mile-contract.dto';
 import { LastMileRequest } from './entities/last-mile-request.entity';
 import { LastMileRequestsRepository } from './last-mile-requests.repository';
@@ -41,6 +42,7 @@ export class LastMileContractService {
     private readonly pdfService: ContractPdfService,
     private readonly signaturesService: SignaturesService,
     private readonly dataSource: DataSource,
+    private readonly logoSettings: LogoSettingsService,
   ) {}
 
   async getContractView(id: string, viewerUserId?: string | null) {
@@ -194,6 +196,7 @@ export class LastMileContractService {
     return {
       companyName: booking.company?.name ?? 'Customer',
       bookingReference: booking.reference ?? request.bookingId,
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
       containerCount: containers.length || null,
       containerList: containers.join(', '),
       cargoDescription,
diff --git a/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.controller.ts b/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.controller.ts
index 10f82ad07..ff52ff9d7 100644
--- a/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.controller.ts
+++ b/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.controller.ts
@@ -48,6 +48,19 @@ export class LastMileRequestsController {
     return this.requestsService.freeTruckCount().then((count) => ({ count }));
   }
 
+  // Customer-facing like :id — booking detail (portal + backoffice) lists the
+  // booking's requests to link the stored LM contract. Ownership-checked in
+  // the service for portal callers.
+  @Get('by-booking/:bookingId')
+  @MixedAudience(FREIGHT_PERMS.lastMile.requestView)
+  @ApiOperation({ summary: "A booking's last-mile requests, newest first — LM contract reference" })
+  findForBooking(
+    @Param('bookingId', ParseUUIDPipe) bookingId: string,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.requestsService.findForBooking(bookingId, user?.id ?? null);
+  }
+
   @Get(':id/price-estimate')
   @BookingStaff(FREIGHT_PERMS.lastMile.requestView)
   @ApiOperation({
@@ -91,11 +104,15 @@ export class LastMileRequestsController {
     return this.contractService.sign(id, dto, user?.id ?? null);
   }
 
+  // Customer-facing like :id/contract/view — the portal's confirm page opens
+  // this straight from the departure notification link before the customer
+  // has done anything else, so it can't be staff-only. Service ownership-
+  // checks against the resolved company; staff may also open it.
   @Get(':id')
-  @BookingStaff(FREIGHT_PERMS.lastMile.requestView)
+  @MixedAudience(FREIGHT_PERMS.lastMile.requestView)
   @ApiOperation({ summary: 'Get a last-mile confirmation request by ID' })
-  findOne(@Param('id', ParseUUIDPipe) id: string) {
-    return this.requestsService.findById(id);
+  findOne(@Param('id', ParseUUIDPipe) id: string, @CurrentUser() user: TCurrentUser) {
+    return this.requestsService.findById(id, user?.id ?? null);
   }
 
   // No @BookingStaff — the customer (portal) fills this, not backoffice staff.
@@ -114,7 +131,7 @@ export class LastMileRequestsController {
 
   @Post(':id/approve')
   @BookingStaff(FREIGHT_PERMS.lastMile.requestApprove)
-  @ApiOperation({ summary: 'Truck & Machinery chief approves the request — LM contract becomes signable; the advance invoice follows the customer signature' })
+  @ApiOperation({ summary: 'Truck & Machinery chief approves the request — the advance defaults to the live last-mile rate; LM contract becomes signable and the advance invoice follows the customer signature' })
   approve(
     @Param('id', ParseUUIDPipe) id: string,
     @Body() dto: ApproveLastMileRequestDto,
diff --git a/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.service.ts b/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.service.ts
index 901e7b9b5..37612d318 100644
--- a/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.service.ts
+++ b/apps/edr-freight-api/src/modules/last-mile-requests/last-mile-requests.service.ts
@@ -199,14 +199,50 @@ export class LastMileRequestsService {
     };
   }
 
-  async findById(id: string): Promise<LastMileRequest> {
+  /**
+   * `userId` is set only when a portal customer calls this directly (the
+   * confirm-page deep link from the departure notification, before they've
+   * submitted or signed anything) — staff and every internal caller pass
+   * nothing and skip the check, same convention as submit()/sign().
+   */
+  async findById(id: string, userId?: string | null): Promise<LastMileRequest> {
     const record = await this.requestsRepository.findById(id, {
       relations: { booking: { company: true } },
     });
     if (!record) throw new NotFoundException(`Last-mile request ${id} not found`);
+
+    if (userId) {
+      const companyId = await this.bookingsService.resolveCustomerCompanyId(userId);
+      if (companyId && record.booking?.companyId && companyId !== record.booking.companyId) {
+        throw new BadRequestException('This request does not belong to your company');
+      }
+    }
+
     return record;
   }
 
+  /**
+   * Every request on a booking, newest first — the booking-detail pages
+   * (portal + backoffice) use this to surface the LM contract later. Portal
+   * callers pass their userId and are ownership-checked against the booking's
+   * company, mirroring findById.
+   */
+  async findForBooking(bookingId: string, userId?: string | null): Promise<LastMileRequest[]> {
+    if (userId) {
+      const companyId = await this.bookingsService.resolveCustomerCompanyId(userId);
+      if (companyId) {
+        const booking = await this.bookingsRepository.findById(bookingId);
+        if (booking?.companyId && booking.companyId !== companyId) {
+          throw new BadRequestException('This booking does not belong to your company');
+        }
+      }
+    }
+    return this.requestsRepository.findAll({
+      where: { bookingId },
+      order: { createdAt: 'DESC' },
+    });
+  }
+
   /**
    * Rule-based price estimate for the approval dialog: estimated km (yard GPS →
    * delivery point, straight-line) × the LIVE last-mile rate rules against the
@@ -299,7 +335,11 @@ export class LastMileRequestsService {
     return this.findById(id);
   }
 
-  async approve(id: string, staffId: string | null, advanceAmount: number): Promise<LastMileRequest> {
+  async approve(
+    id: string,
+    staffId: string | null,
+    advanceOverride?: number | null,
+  ): Promise<LastMileRequest> {
     const request = await this.findById(id);
     if (request.status !== LastMileRequestStatus.Submitted) {
       throw new BadRequestException(`Only a submitted request can be approved (current status: ${request.status})`);
@@ -307,6 +347,18 @@ export class LastMileRequestsService {
     const booking = request.booking ?? (await this.bookingsRepository.findById(request.bookingId));
     if (!booking) throw new NotFoundException(`Booking ${request.bookingId} not found`);
 
+    // The live last-mile rates are the authority on the advance (km × rate);
+    // the chief's typed amount is only an override — and the only path when no
+    // rate covers the job. Snapshotted so the contract and invoice stay immune
+    // to later rate edits.
+    const estimate = await this.priceEstimate(id);
+    const advanceAmount = advanceOverride ?? estimate.total;
+    if (!advanceAmount || advanceAmount <= 0) {
+      throw new BadRequestException(
+        'No live last-mile rate covers this job — enter the advance amount manually.',
+      );
+    }
+
     // Idempotent per booking — reuses the record if one already exists.
     const lastMile = await this.lastMileService.create({
       bookingId: request.bookingId,
@@ -316,10 +368,6 @@ export class LastMileRequestsService {
 
     // No invoice yet: the advance is invoiced by LastMileContractService.sign()
     // once the customer has signed the LM contract — doc first, then payment.
-    // Snapshot the rate estimate now so the contract shows the numbers the
-    // chief actually approved against, immune to later rate edits.
-    const estimate = await this.priceEstimate(id);
-
     await this.requestsRepository.update(id, {
       status: LastMileRequestStatus.Approved,
       reviewedByStaffId: staffId,
@@ -364,7 +412,10 @@ export class LastMileRequestsService {
       type: 'LAST_MILE_ADVANCE',
       companyId: booking.companyId,
       companyProfileId: booking.companyProfileId || '',
-      currency: booking.paymentCurrency || 'ETB',
+      // The advance is priced by the last-mile rate, so it bills in that
+      // rate's currency (birr for domestic trucking) — the booking's payment
+      // currency is only the fallback when the amount was a manual override.
+      currency: request.contractSummary?.currency || booking.paymentCurrency || 'ETB',
       lines: [
         {
           chargeType: 'LAST_MILE_ADVANCE',
diff --git a/apps/edr-freight-api/src/modules/logo-settings/dto/update-logo-setting.dto.ts b/apps/edr-freight-api/src/modules/logo-settings/dto/update-logo-setting.dto.ts
new file mode 100644
index 000000000..b5fecaf20
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/logo-settings/dto/update-logo-setting.dto.ts
@@ -0,0 +1,9 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsString, MinLength } from "class-validator";
+
+export class UpdateLogoSettingDto {
+  @ApiProperty({ description: "Logo image as a base64 data URL (PNG/JPG)." })
+  @IsString()
+  @MinLength(1)
+  logoImageBase64!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/logo-settings/entities/logo-setting.entity.ts b/apps/edr-freight-api/src/modules/logo-settings/entities/logo-setting.entity.ts
new file mode 100644
index 000000000..dbe8e17df
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/logo-settings/entities/logo-setting.entity.ts
@@ -0,0 +1,25 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, JoinColumn, ManyToOne } from "typeorm";
+
+import { FileRecord } from "../../files/entities/file.entity";
+
+/**
+ * Single-row table holding the one company logo image stamped onto every
+ * generated document (invoices/receipts, contracts, warehouse papers,
+ * train-scheduling manifests, payment receipts). Same single-row shape as
+ * stamp_settings — `get()` lazily creates the row, and there is never more
+ * than one.
+ */
+@Entity({ schema: "freight", name: "logo_settings" })
+export class LogoSetting extends BaseEntity {
+  @Column({ name: "logo_file_id", type: "uuid", nullable: true })
+  logoFileId?: string | null;
+
+  @ManyToOne(() => FileRecord, { nullable: true })
+  @JoinColumn({ name: "logo_file_id" })
+  logoFile?: FileRecord | null;
+
+  /** IAM user id of the last operator to set/clear the logo. */
+  @Column({ name: "updated_by_id", type: "uuid", nullable: true })
+  updatedById?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/logo-settings/logo-settings.controller.ts b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.controller.ts
new file mode 100644
index 000000000..0e3007c0f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.controller.ts
@@ -0,0 +1,39 @@
+import { Body, Controller, Delete, Get, Put } from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+import { CurrentUser } from "@edr/api-common";
+import type { TCurrentUser } from "@tria-plc/api-common/modules/auth/types/current-user.type";
+
+import { BookingStaff } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { UpdateLogoSettingDto } from "./dto/update-logo-setting.dto";
+import { LogoSettingsService } from "./logo-settings.service";
+
+@ApiTags("logo-settings")
+@ApiBearerAuth()
+@Controller("logo-settings")
+export class LogoSettingsController {
+  constructor(private readonly service: LogoSettingsService) {}
+
+  @Get()
+  @BookingStaff([FREIGHT_PERMS.settings.logo.view, FREIGHT_PERMS.admin])
+  @ApiOperation({ summary: "Current company logo used on every generated document" })
+  get() {
+    return this.service.getView();
+  }
+
+  @Put()
+  @BookingStaff([FREIGHT_PERMS.settings.logo.manage, FREIGHT_PERMS.admin])
+  @ApiOperation({ summary: "Replace the company logo" })
+  update(@Body() dto: UpdateLogoSettingDto, @CurrentUser() user: TCurrentUser) {
+    return this.service.setLogo(dto.logoImageBase64, user?.id ?? null);
+  }
+
+  @Delete()
+  @BookingStaff([FREIGHT_PERMS.settings.logo.manage, FREIGHT_PERMS.admin])
+  @ApiOperation({
+    summary: "Clear the company logo (documents fall back to their text mark)",
+  })
+  clear(@CurrentUser() user: TCurrentUser) {
+    return this.service.clearLogo(user?.id ?? null);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/logo-settings/logo-settings.module.ts b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.module.ts
new file mode 100644
index 000000000..86b257297
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.module.ts
@@ -0,0 +1,24 @@
+import { Global, Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { FilesModule } from "../files/files.module";
+import { MinioModule } from "../minio/minio.module";
+import { LogoSetting } from "./entities/logo-setting.entity";
+import { LogoSettingsController } from "./logo-settings.controller";
+import { LogoSettingsRepository } from "./logo-settings.repository";
+import { LogoSettingsService } from "./logo-settings.service";
+
+/**
+ * Global so every document-generating module (billing, contracts,
+ * warehouses, train-scheduling, payment) can inject {@link LogoSettingsService}
+ * without pulling in a circular dependency — same reasoning as
+ * StampSettingsModule.
+ */
+@Global()
+@Module({
+  imports: [TypeOrmModule.forFeature([LogoSetting]), FilesModule, MinioModule],
+  controllers: [LogoSettingsController],
+  providers: [LogoSettingsRepository, LogoSettingsService],
+  exports: [LogoSettingsService],
+})
+export class LogoSettingsModule {}
diff --git a/apps/edr-freight-api/src/modules/logo-settings/logo-settings.repository.ts b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.repository.ts
new file mode 100644
index 000000000..24d440d56
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.repository.ts
@@ -0,0 +1,21 @@
+import { Injectable } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { Repository } from "typeorm";
+import { BaseRepository } from "@edr/api-common";
+
+import { LogoSetting } from "./entities/logo-setting.entity";
+
+@Injectable()
+export class LogoSettingsRepository extends BaseRepository<LogoSetting> {
+  constructor(
+    @InjectRepository(LogoSetting)
+    repo: Repository<LogoSetting>,
+  ) {
+    super(repo);
+  }
+
+  /** The single settings row, with its logo file joined, or null before first upload. */
+  findSingleton(): Promise<LogoSetting | null> {
+    return this.repository.findOne({ where: {}, relations: ["logoFile"] });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/logo-settings/logo-settings.service.ts b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.service.ts
new file mode 100644
index 000000000..916e45e61
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/logo-settings/logo-settings.service.ts
@@ -0,0 +1,161 @@
+import { Injectable, Logger } from "@nestjs/common";
+import { Readable } from "stream";
+import { DataSource } from "typeorm";
+
+import { FilesService } from "../files/files.service";
+import { FileRecord } from "../files/entities/file.entity";
+import { MinioService } from "../minio/minio.service";
+import { LogoSettingsRepository } from "./logo-settings.repository";
+import { LogoSetting } from "./entities/logo-setting.entity";
+
+export interface LogoSettingView {
+  logoImageUrl: string | null;
+  updatedById: string | null;
+  updatedAt: Date | null;
+}
+
+/**
+ * Owns the single `logo_settings` row: the one company logo image used on
+ * every generated document. Same single-row shape as StampSettingsService,
+ * the value is an uploaded image (via FilesService) rather than a scalar.
+ */
+@Injectable()
+export class LogoSettingsService {
+  private readonly logger = new Logger(LogoSettingsService.name);
+
+  constructor(
+    private readonly repository: LogoSettingsRepository,
+    private readonly filesService: FilesService,
+    private readonly minioService: MinioService,
+    private readonly dataSource: DataSource,
+  ) {}
+
+  /** The settings row, created empty on first access. */
+  async get(): Promise<LogoSetting> {
+    const existing = await this.repository.findSingleton();
+    if (existing) return existing;
+    return this.repository.create({ logoFileId: null, updatedById: null });
+  }
+
+  /** Current logo, with the image inlined as a data URL (or null if unset). */
+  async getView(): Promise<LogoSettingView> {
+    const setting = await this.get();
+    return {
+      logoImageUrl: await this.inlineImageUrl(setting.logoFile?.url),
+      updatedById: setting.updatedById ?? null,
+      updatedAt: setting.updatedAt ?? null,
+    };
+  }
+
+  /**
+   * The logo image for embedding into generated documents, ALWAYS as a
+   * `data:` URL or null. Never throws — document generation must succeed even
+   * if the logo lookup fails; callers render their existing text/mark
+   * fallback on null (see logo-markup.util.ts).
+   */
+  async getLogoImageUrl(): Promise<string | null> {
+    try {
+      const setting = await this.get();
+      const inlined = await this.inlineImageUrl(setting.logoFile?.url);
+      if (inlined && !inlined.startsWith("data:")) {
+        this.logger.warn(
+          `Company logo could not be inlined for document rendering (falling back to the text mark): ${inlined}`,
+        );
+        return null;
+      }
+      return inlined;
+    } catch (err) {
+      this.logger.warn(
+        `Could not load company logo for PDF rendering: ${(err as Error).message}`,
+      );
+      return null;
+    }
+  }
+
+  /** Replace the logo image, storing it in MinIO via FilesService. */
+  async setLogo(
+    logoImageBase64: string,
+    updatedById?: string | null,
+  ): Promise<LogoSettingView> {
+    const current = await this.get();
+    const previousFileId = current.logoFileId ?? null;
+
+    const fileRecord = await this.filesService.upload({
+      resourceId: current.id,
+      resource: "logo_settings",
+      code: "logo",
+      file: this.toUploadFile(logoImageBase64),
+      uploadedByUserId: updatedById ?? null,
+    });
+
+    await this.repository.update(current.id, {
+      logoFileId: fileRecord.id,
+      updatedById: updatedById ?? null,
+    });
+
+    if (previousFileId && previousFileId !== fileRecord.id) {
+      await this.dataSource.getRepository(FileRecord).delete(previousFileId);
+    }
+
+    this.logger.log(`Company logo updated by ${updatedById ?? "unknown user"}`);
+    return this.getView();
+  }
+
+  /** Clear the logo (documents fall back to their text/mark). */
+  async clearLogo(updatedById?: string | null): Promise<LogoSettingView> {
+    const current = await this.get();
+    const previousFileId = current.logoFileId ?? null;
+
+    await this.repository.update(current.id, {
+      logoFileId: null,
+      updatedById: updatedById ?? null,
+    });
+
+    if (previousFileId) {
+      await this.dataSource.getRepository(FileRecord).delete(previousFileId);
+    }
+
+    return this.getView();
+  }
+
+  private toUploadFile(base64: string): Express.Multer.File {
+    const raw = base64.includes(",") ? base64.split(",")[1]! : base64;
+    const buffer = Buffer.from(raw, "base64");
+    return {
+      fieldname: "logo",
+      originalname: "company-logo.png",
+      encoding: "7bit",
+      mimetype: "image/png",
+      size: buffer.length,
+      buffer,
+      stream: Readable.from(buffer),
+      destination: "",
+      filename: "",
+      path: "",
+    };
+  }
+
+  private async inlineImageUrl(url?: string | null): Promise<string | null> {
+    if (!url) return null;
+    if (url.startsWith("data:")) return url;
+    try {
+      const objectName = this.minioService.getObjectNameFromUrl(url);
+      const stream = await this.minioService.getFileStream(objectName);
+      const buffer = await this.streamToBuffer(stream);
+      return `data:image/png;base64,${buffer.toString("base64")}`;
+    } catch {
+      return url;
+    }
+  }
+
+  private streamToBuffer(stream: Readable): Promise<Buffer> {
+    return new Promise((resolve, reject) => {
+      const chunks: Buffer[] = [];
+      stream.on("data", (chunk: Buffer | string) => {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+      });
+      stream.on("error", reject);
+      stream.on("end", () => resolve(Buffer.concat(chunks)));
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/maintenance/maintenance-due-alert.spec.ts b/apps/edr-freight-api/src/modules/maintenance/maintenance-due-alert.spec.ts
index 7aac5e863..5726123cf 100644
--- a/apps/edr-freight-api/src/modules/maintenance/maintenance-due-alert.spec.ts
+++ b/apps/edr-freight-api/src/modules/maintenance/maintenance-due-alert.spec.ts
@@ -1,6 +1,7 @@
 import { NotificationAudience } from '@edr/types';
 
 import { MaintenanceService } from './maintenance.service';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
 
 /**
  * The daily due-alert: a SCHEDULED item that crossed its km or date threshold
@@ -37,6 +38,10 @@ describe('MaintenanceService.sendDueAlerts', () => {
     expect(notify).toHaveBeenCalledWith(
       expect.objectContaining({
         audience: NotificationAudience.BACKOFFICE,
+        // The fleet desk, not every employee in the company.
+        recipients: {
+          permissionKeys: [FREIGHT_PERMS.maintenance.getNotification],
+        },
         title: 'Maintenance due — ET-9875',
         body: expect.stringContaining('driven 50200 km (due at 50000 km)'),
       }),
diff --git a/apps/edr-freight-api/src/modules/maintenance/maintenance.service.ts b/apps/edr-freight-api/src/modules/maintenance/maintenance.service.ts
index dd9da55a8..54aab6e36 100644
--- a/apps/edr-freight-api/src/modules/maintenance/maintenance.service.ts
+++ b/apps/edr-freight-api/src/modules/maintenance/maintenance.service.ts
@@ -15,6 +15,7 @@ import {
   UpsertMaintenanceIntervalDto,
 } from './dto/create-maintenance.dto';
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
 
 @Injectable()
 export class MaintenanceService {
@@ -53,7 +54,9 @@ export class MaintenanceService {
             ? `driven ${item.currentKm} km (due at ${item.nextDueKm} km)`
             : `due ${new Date(item.nextDueDate as Date).toLocaleDateString()}`;
         await this.inbox.notify({
-          recipients: { allBackoffice: true },
+          recipients: {
+            permissionKeys: [FREIGHT_PERMS.maintenance.getNotification],
+          },
           audience: NotificationAudience.BACKOFFICE,
           type: NotificationType.GENERIC,
           title: `Maintenance due — ${item.plateNumber}`,
diff --git a/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.module.ts b/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.module.ts
index e9f3af958..aa363ad3d 100644
--- a/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.module.ts
+++ b/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.module.ts
@@ -4,6 +4,7 @@ import { Session } from "@tria-plc/iamapi-common/entities/iam/user/session.entit
 import { User } from "@tria-plc/iamapi-common/entities/iam/user/user.entity";
 
 import { BackofficeModule } from "../backoffice/backoffice.module";
+import { ChatModule } from "../chat/chat.module";
 import { CompaniesModule } from "../companies/companies.module";
 import { NotificationsModule } from "../notifications/notifications.module";
 import { Notification } from "./entities/notification.entity";
@@ -24,6 +25,8 @@ import { WsAuthService } from "./ws-auth.service";
     BackofficeModule,
     // EmailClientService + SmsClientService (HIGH-priority fan-out)
     NotificationsModule,
+    // ChatBridgeService (mirrors BACKOFFICE notifications into chat)
+    ChatModule,
   ],
   controllers: [NotificationInboxController],
   providers: [
diff --git a/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.service.ts b/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.service.ts
index 7cfbf81df..119019997 100644
--- a/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.service.ts
+++ b/apps/edr-freight-api/src/modules/notification-inbox/notification-inbox.service.ts
@@ -1,4 +1,5 @@
 import {
+  NotificationAudience,
   NotificationChannels,
   NotificationChannelsSent,
   NotificationDto,
@@ -11,6 +12,7 @@ import { InjectRepository } from "@nestjs/typeorm";
 import { User } from "@tria-plc/iamapi-common/entities/iam/user/user.entity";
 import { Repository } from "typeorm";
 
+import { ChatBridgeService } from "../chat/chat-bridge.service";
 import { EmailClientService } from "../notifications/email-client.service";
 import { SmsClientService } from "../notifications/sms-client.service";
 import { ListNotificationsQueryDto } from "./dto/list-notifications-query.dto";
@@ -37,6 +39,7 @@ export class NotificationInboxService {
     private readonly gateway: NotificationsGateway,
     private readonly emailClient: EmailClientService,
     private readonly smsClient: SmsClientService,
+    private readonly chatBridge: ChatBridgeService,
     @InjectRepository(User)
     private readonly users: Repository<User>,
   ) {}
@@ -44,11 +47,18 @@ export class NotificationInboxService {
   /**
    * Fan a logical notification out to every resolved recipient: persist one row
    * each, push it live over WebSocket, and (for HIGH priority) also queue
-   * email/SMS via the existing clients.
+   * email/SMS via the existing clients. BACKOFFICE-audience notifications are
+   * also mirrored into internal chat (ChatBridgeService) — a shared-room
+   * broadcast, not per-recipient, so it runs once regardless of how many (if
+   * any) in-app rows get created below. Never PORTAL — that's customer-facing
+   * and must never reach a staff room.
    */
   async notify(input: NotifyInput): Promise<void> {
     try {
       const userIds = await this.recipients.resolve(input.recipients);
+      if (input.audience === NotificationAudience.BACKOFFICE) {
+        await this.chatBridge.bridge(input);
+      }
       if (userIds.length === 0) {
         this.logger.debug(
           `notify(${input.type}) resolved 0 recipients — skipped`,
diff --git a/apps/edr-freight-api/src/modules/notification-inbox/notification-recipients.service.ts b/apps/edr-freight-api/src/modules/notification-inbox/notification-recipients.service.ts
index e3e711d19..d8e338dbf 100644
--- a/apps/edr-freight-api/src/modules/notification-inbox/notification-recipients.service.ts
+++ b/apps/edr-freight-api/src/modules/notification-inbox/notification-recipients.service.ts
@@ -14,7 +14,9 @@ import { ExternalProfileRepository } from "../companies/external-profile.reposit
  * - `companyProfileId` → resolved to its company, then to that company's users.
  * - `organizationId`   → all current employees of the org (backoffice staff).
  * - `permissionKeys`   → current employees (any org) holding any of these
- *   permission keys (e.g. department/role-scoped targeting).
+ *   permission keys — how every staff-facing notification is targeted. There is
+ *   deliberately no "all backoffice" selector: staff notifications belong to a
+ *   desk, and the `<module>:get_notification` keys name which one.
  */
 @Injectable()
 export class NotificationRecipientsService {
@@ -69,18 +71,6 @@ export class NotificationRecipientsService {
       }
     }
 
-    if (recipients.allBackoffice) {
-      try {
-        for (const uid of await this.backoffice.getAllCurrentEmployeeUserIds()) {
-          ids.add(uid);
-        }
-      } catch (err) {
-        this.logger.warn(
-          `Failed to resolve allBackoffice recipients: ${(err as Error).message}`,
-        );
-      }
-    }
-
     if (recipients.permissionKeys?.length) {
       try {
         for (const uid of await this.backoffice.getEmployeeUserIdsByPermission(
diff --git a/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.spec.ts b/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.spec.ts
new file mode 100644
index 000000000..bc79d8acb
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/notification-inbox/notifications.gateway.spec.ts
@@ -0,0 +1,29 @@
+import { NotificationsGateway } from "./notifications.gateway";
+import { WsAuthService } from "./ws-auth.service";
+
+const gateway = () => new NotificationsGateway({} as WsAuthService);
+
+describe("NotificationsGateway", () => {
+  it("skips emitNew rather than throwing when no WebSocket server is attached", () => {
+    const g = gateway();
+    expect(() => g.emitNew("user-1", { id: "n-1" } as never, 3)).not.toThrow();
+  });
+
+  it("skips emitUnreadCount rather than throwing when no WebSocket server is attached", () => {
+    const g = gateway();
+    expect(() => g.emitUnreadCount("user-1", 3)).not.toThrow();
+  });
+
+  it("pushes to the user's room once a server is attached", () => {
+    const g = gateway();
+    const emit = jest.fn();
+    const to = jest.fn().mockReturnValue({ emit });
+    (g as unknown as { server: { to: typeof to } }).server = { to };
+
+    g.emitNew("user-1", { id: "n-1" } as never, 3);
+
+    expect(to).toHaveBeenCalledWith("user:user-1");
+    expect(emit).toHaveBeenCalledWith("notification:new", { id: "n-1" });
+    expect(emit).toHaveBeenCalledWith("notification:unread-count", 3);
+  });
+});
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 0c4704170..4658dfac0 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
@@ -27,8 +27,10 @@ import { WsAuthService } from "./ws-auth.service";
 export class NotificationsGateway implements OnGatewayConnection {
   private readonly logger = new Logger(NotificationsGateway.name);
 
+  // Not `!`-asserted: Nest only wires this once the WS adapter attaches to a running HTTP
+  // listener, which does not happen under `NestFactory.createApplicationContext` — see `skip()`.
   @WebSocketServer()
-  private readonly server!: Server;
+  private readonly server?: Server;
 
   constructor(private readonly wsAuth: WsAuthService) {}
 
@@ -45,6 +47,7 @@ export class NotificationsGateway implements OnGatewayConnection {
 
   /** Push a freshly-created notification + the new unread count to a user. */
   emitNew(userId: string, notification: NotificationDto, unreadCount: number): void {
+    if (!this.server) return this.skip("emitNew");
     const room = this.server.to(this.room(userId));
     room.emit(NOTIFICATION_WS_EVENTS.NEW, notification);
     room.emit(NOTIFICATION_WS_EVENTS.UNREAD_COUNT, unreadCount);
@@ -52,11 +55,24 @@ export class NotificationsGateway implements OnGatewayConnection {
 
   /** Push only an updated unread count (e.g. after a read on another tab). */
   emitUnreadCount(userId: string, unreadCount: number): void {
+    if (!this.server) return this.skip("emitUnreadCount");
     this.server
       .to(this.room(userId))
       .emit(NOTIFICATION_WS_EVENTS.UNREAD_COUNT, unreadCount);
   }
 
+  /**
+   * `@WebSocketServer()` only wires `server` once the WS adapter attaches to a running HTTP
+   * listener — never under `NestFactory.createApplicationContext` (scripts, one-off jobs), and not
+   * for the brief window before `app.listen()` completes in a real boot either. The notification row
+   * is already persisted by this point (the caller writes it before pushing), so a missing socket
+   * server just means "no live push this time" — skip it rather than throw and lose the caller's
+   * own result (e.g. an EIMS registration outcome that already succeeded or failed for real).
+   */
+  private skip(method: string): void {
+    this.logger.debug(`${method}: no WebSocket server attached (non-HTTP context?) — push skipped`);
+  }
+
   private room(userId: string): string {
     return `user:${userId}`;
   }
diff --git a/apps/edr-freight-api/src/modules/notifications/email-client.service.ts b/apps/edr-freight-api/src/modules/notifications/email-client.service.ts
index 20a43d061..52dd7802e 100644
--- a/apps/edr-freight-api/src/modules/notifications/email-client.service.ts
+++ b/apps/edr-freight-api/src/modules/notifications/email-client.service.ts
@@ -51,8 +51,11 @@ export class EmailClientService implements OnApplicationBootstrap {
     this.logger.log(
       `EMAIL publish to RabbitMQ [${process.env.EMAIL_QUEUE ?? "email_queue"}] pattern='send-email' confirmed=${queued}`,
     );
-    // Recipient + content are PII — debug only.
-    this.logger.debug(`EMAIL payload to=${dto.to} subject="${dto.subject}"`);
+    // Full content logged on purpose (audit of what actually left the API).
+    // Note: recipient + body are PII and land in plain application logs.
+    this.logger.log(
+      `EMAIL payload to=${dto.to} subject="${dto.subject}" text="${dto.text ?? ""}" html="${dto.html ?? ""}"`,
+    );
     return { queued };
   }
 
diff --git a/apps/edr-freight-api/src/modules/notifications/notify-company.util.ts b/apps/edr-freight-api/src/modules/notifications/notify-company.util.ts
index 9f121e18a..467b172ba 100644
--- a/apps/edr-freight-api/src/modules/notifications/notify-company.util.ts
+++ b/apps/edr-freight-api/src/modules/notifications/notify-company.util.ts
@@ -1,7 +1,11 @@
 import { DataSource } from 'typeorm';
+import { Logger } from '@nestjs/common';
 
+import { NotificationAudience, NotificationType } from '@edr/types';
 import { NotificationsService } from './notifications.service';
+import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
 import {
+  companyNotifyEmailExpr,
   companyNotifyPhoneExpr,
   primaryContactUserJoin,
 } from './resolve-company-phone.util';
@@ -19,7 +23,8 @@ export async function sendCompanyChannels(
 ): Promise<void> {
   const [contact]: Array<{ phone: string | null; email: string | null }> =
     await dataSource.query(
-      `SELECT ${companyNotifyPhoneExpr('co')} AS phone, co.email
+      `SELECT ${companyNotifyPhoneExpr('co')} AS phone,
+              ${companyNotifyEmailExpr('co')} AS email
          FROM freight.companies co
          ${primaryContactUserJoin('co')}
         WHERE co.id = $1 AND co.deleted_at IS NULL`,
@@ -40,3 +45,41 @@ export async function sendCompanyChannels(
     }
   }
 }
+
+/**
+ * Tell the customer their export carriage acceptance sheet is ready to
+ * download from the portal — the sheet itself is generated on demand by
+ * BookingsService.carriageAcceptanceSheet, never stored, so this is a
+ * "ready" notice + link, not an attachment (the email pipeline carries text
+ * only). Shared by every path that makes a booking's handover final: the
+ * warehouse gate on receive, and direct truck-to-train on load (that cargo
+ * never sees a warehouse, so its handover moment IS the load).
+ */
+export async function notifyCarriageAcceptanceReady(
+  dataSource: DataSource,
+  notifications: NotificationsService,
+  inbox: NotificationInboxService,
+  bookingId: string,
+  logger: Logger,
+): Promise<void> {
+  try {
+    const [b]: Array<{ companyId: string | null; reference: string }> = await dataSource.query(
+      `SELECT company_id AS "companyId", reference FROM freight.bookings WHERE id = $1 AND deleted_at IS NULL`,
+      [bookingId],
+    );
+    if (!b?.companyId) return;
+    const body = `Your carriage acceptance sheet for booking ${b.reference} is ready to download from the portal.`;
+    await inbox.notify({
+      recipients: { companyId: b.companyId },
+      audience: NotificationAudience.PORTAL,
+      type: NotificationType.DOCUMENT_ACTION,
+      title: 'Carriage acceptance sheet ready',
+      body,
+      link: `/bookings/${bookingId}`,
+      data: { bookingId, reference: b.reference },
+    });
+    await sendCompanyChannels(dataSource, notifications, b.companyId, body);
+  } catch (err) {
+    logger.warn(`Carriage acceptance ready notify failed for ${bookingId}: ${(err as Error).message}`);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/notifications/resolve-company-phone.util.ts b/apps/edr-freight-api/src/modules/notifications/resolve-company-phone.util.ts
index 511f3cf8c..104456384 100644
--- a/apps/edr-freight-api/src/modules/notifications/resolve-company-phone.util.ts
+++ b/apps/edr-freight-api/src/modules/notifications/resolve-company-phone.util.ts
@@ -1,7 +1,7 @@
 import { DataSource, EntityManager } from "typeorm";
 
 /**
- * Where a customer-facing SMS actually goes.
+ * Where a customer-facing SMS or email actually goes.
  *
  * The person who signs up, logs in, and receives OTPs is an IAM user, and
  * `iam.users.phone_number` is the number they control and can change themselves
@@ -12,11 +12,13 @@ import { DataSource, EntityManager } from "typeorm";
  * `companies.contact_person_phone` is deliberately NOT consulted: the live write
  * path stores that value in the `attributes` jsonb and has never populated the
  * column, so every reader of it was silently falling through to `phone` anyway.
+ * The retired `general_manager_email` column was the same trap on the email
+ * side — see {@link companyNotifyEmailExpr}.
  */
 
 /**
  * LEFT JOIN a company alias to its primary contact's IAM user, exposing
- * `pc.phone_number`.
+ * `pc.phone_number` and `pc.email`.
  *
  * LATERAL + LIMIT 1 rather than a plain join: nothing in the schema stops a
  * company having two `is_primary_contact` rows, and a plain join would then
@@ -28,7 +30,7 @@ import { DataSource, EntityManager } from "typeorm";
 export function primaryContactUserJoin(alias: string): string {
   return `
     LEFT JOIN LATERAL (
-      SELECT u.phone_number
+      SELECT u.phone_number, u.email
         FROM freight.external_profiles ep
         JOIN iam.users u ON u.id = ep.user_id AND u.is_active = true
        WHERE ep.company_id = ${alias}.id
@@ -44,17 +46,51 @@ export function companyNotifyPhoneExpr(alias: string): string {
   return `COALESCE(pc.phone_number, ${alias}.phone)`;
 }
 
-/** The SMS number for one company, or null when neither source has one. */
-export async function resolveCompanyNotifyPhone(
+/**
+ * SQL expression for the company's notification address, given the joined `pc`
+ * alias.
+ *
+ * `companies.email` is now the owner's email, written on every profile save
+ * whether or not the owner verified with Fayda — and the owner's email is a
+ * required onboarding field, so a company that finished onboarding has one.
+ * (It used to be written ONLY for a Fayda-verified owner, which meant every
+ * foreign company had none; the gap was papered over with a
+ * `general_manager_email` leg that could never fire, because onboarding wrote
+ * that value into `attributes` and nothing ever populated the column.)
+ *
+ * The `generalManagerEmail` attribute is still consulted, after the contact
+ * person: the general manager was removed, but companies onboarded before that
+ * may carry an address there and nowhere else. RemoveGeneralManager backfills
+ * `companies.email` from it, so this is belt-and-braces for rows that migration
+ * could not resolve.
+ *
+ * `NULLIF` because a blank jsonb key is not an address and `COALESCE` would
+ * happily stop on it. The account that registered the company is the last
+ * resort — signup guarantees it has one.
+ */
+export function companyNotifyEmailExpr(alias: string): string {
+  return `COALESCE(
+    NULLIF(${alias}.email, ''),
+    NULLIF(${alias}.attributes->>'ownerEmail', ''),
+    NULLIF(${alias}.attributes->>'contactPersonEmail', ''),
+    NULLIF(${alias}.attributes->>'generalManagerEmail', ''),
+    NULLIF(pc.email, '')
+  )`;
+}
+
+/** Both channels for one company; either side is null when nothing has one. */
+export async function resolveCompanyNotifyContact(
   db: DataSource | EntityManager,
   companyId: string,
-): Promise<string | null> {
-  const rows: Array<{ phone: string | null }> = await db.query(
-    `SELECT ${companyNotifyPhoneExpr("co")} AS phone
-       FROM freight.companies co
-       ${primaryContactUserJoin("co")}
-      WHERE co.id = $1 AND co.deleted_at IS NULL`,
-    [companyId],
-  );
-  return rows[0]?.phone ?? null;
+): Promise<{ phone: string | null; email: string | null }> {
+  const rows: Array<{ phone: string | null; email: string | null }> =
+    await db.query(
+      `SELECT ${companyNotifyPhoneExpr("co")} AS phone,
+              ${companyNotifyEmailExpr("co")} AS email
+         FROM freight.companies co
+         ${primaryContactUserJoin("co")}
+        WHERE co.id = $1 AND co.deleted_at IS NULL`,
+      [companyId],
+    );
+  return { phone: rows[0]?.phone ?? null, email: rows[0]?.email ?? null };
 }
diff --git a/apps/edr-freight-api/src/modules/notifications/resolve-shipping-line-contact.util.ts b/apps/edr-freight-api/src/modules/notifications/resolve-shipping-line-contact.util.ts
new file mode 100644
index 000000000..d736cdf48
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/notifications/resolve-shipping-line-contact.util.ts
@@ -0,0 +1,33 @@
+import { DataSource } from "typeorm";
+
+import { ShippingLineCompany } from "../shipping-lines/entities/shipping-line-company.entity";
+
+/**
+ * Notification target for a shipping-line booking.
+ *
+ * A shipping line is NOT a `companies` row: the company IS the account — one
+ * IAM user (`userId`), and the contact details live on the
+ * `shipping_line_companies` row itself. So the customer resolvers
+ * (external_profiles fan-out, company attributes email) never apply; this is
+ * the one lookup every shipping-line notification routes through.
+ *
+ * Entity-only import — safe from any module graph: notifiers already own a
+ * DataSource and need no service from the shipping-lines module.
+ */
+export async function resolveShippingLineNotifyTarget(
+  dataSource: DataSource,
+  shippingLineCompanyId: string,
+): Promise<{
+  userId: string | null;
+  phone: string | null;
+  email: string | null;
+}> {
+  const line = await dataSource
+    .getRepository(ShippingLineCompany)
+    .findOne({ where: { id: shippingLineCompanyId } });
+  return {
+    userId: line?.userId ?? null,
+    phone: line?.phoneNumber ?? null,
+    email: line?.email ?? null,
+  };
+}
diff --git a/apps/edr-freight-api/src/modules/notifications/sms-client.service.ts b/apps/edr-freight-api/src/modules/notifications/sms-client.service.ts
index 43e47f350..1c4f3adba 100644
--- a/apps/edr-freight-api/src/modules/notifications/sms-client.service.ts
+++ b/apps/edr-freight-api/src/modules/notifications/sms-client.service.ts
@@ -52,8 +52,9 @@ export class SmsClientService implements OnApplicationBootstrap {
     this.logger.log(
       `SMS publish to RabbitMQ [${process.env.SMS_QUEUE ?? "sms_queue"}] pattern='send-sms' confirmed=${queued}`,
     );
-    // Recipient + content are PII — debug only.
-    this.logger.debug(`SMS payload to=${dto.to} text="${dto.message}"`);
+    // Full content logged on purpose (audit of what actually left the API).
+    // Note: recipient + body are PII and land in plain application logs.
+    this.logger.log(`SMS payload to=${dto.to} text="${dto.message}"`);
     return { queued };
   }
 
@@ -81,7 +82,7 @@ export class SmsClientService implements OnApplicationBootstrap {
     this.logger.log(
       `BULK SMS publish to RabbitMQ [${process.env.SMS_QUEUE ?? "sms_queue"}] pattern='ozeking-bulk-sms' count=${messages.length} confirmed=${queued}`,
     );
-    this.logger.debug(`BULK SMS payload messages=${JSON.stringify(messages)}`);
+    this.logger.log(`BULK SMS payload messages=${JSON.stringify(messages)}`);
     return { queued };
   }
 
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 a7361fbdd..b27520c25 100644
--- a/apps/edr-freight-api/src/modules/otp/otp.service.ts
+++ b/apps/edr-freight-api/src/modules/otp/otp.service.ts
@@ -1,12 +1,14 @@
 // otp.service.ts
 
 import { BadRequestException, Injectable, Logger } from "@nestjs/common";
+import { logCtx } from "@edr/api-common";
 import { randomInt } from "node:crypto";
 
 import { OtpRepository } from "./otp.repository";
 
 import { NotificationsService } from "../notifications/notifications.service";
 import { EmailClientService } from "../notifications/email-client.service";
+import { isBypassEnv, DEV_BYPASS_OTP } from "../../common/dev-bypass.util";
 
 /**
  * Where a code goes. At least one of phone/email must be set — enforced by the
@@ -145,6 +147,21 @@ export class OtpService {
         `otp.issue channels=${channels.join("+")} target=${label} action=${rotated ? "rotate" : "create"}`,
       );
 
+      // Dev/staging only: the row above still exists (so a real code would
+      // still verify), but skip the real SMS/email send — no carrier cost, no
+      // dependency on RabbitMQ/the mail relay being up. Verify with the fixed
+      // DEV_BYPASS_OTP code instead of whatever landed in the row.
+      if (isBypassEnv()) {
+        this.logger.warn(
+          `otp.dispatch.bypassed target=${label} — dev/staging, no real SMS/email sent (verify with ${DEV_BYPASS_OTP})`,
+        );
+        return {
+          success: true,
+          delivered: true,
+          message: "OTP sent successfully",
+        };
+      }
+
       // NOTE: do NOT reset the brute-force attempt counter on send. Clearing it
       // here let an attacker wipe the per-target guess budget just by calling
       // /otp/send between guesses. The counter is cleared only when the code is
@@ -317,6 +334,13 @@ export class OtpService {
       }`;
     if (result === "ok") this.logger.log(line);
     else this.logger.warn(line);
+
+    // Outcome only — the target is a phone number / email address and stays out
+    // of the canonical line. Channels are safe and say which one was used.
+    logCtx(
+      { mode, result, channels: channelsOf(target) },
+      { path: "otp.verify", mode: "push" },
+    );
   }
 
   /**
@@ -386,7 +410,10 @@ export class OtpService {
 
     // invalid otp — per-target attempt cap so a 6-digit code can't be
     // brute-forced within its TTL; the code is burned once the budget is spent.
-    if (otpData.otp !== otp) {
+    // Dev/staging only: a fixed code verifies any pending OTP row without
+    // knowing the real one — the row still has to exist (sendOtp still runs).
+    const bypassed = isBypassEnv() && otp === DEV_BYPASS_OTP;
+    if (otpData.otp !== otp && !bypassed) {
       const attempts = (this.actionAttempts.get(key) ?? 0) + 1;
       if (attempts >= this.MAX_ACTION_ATTEMPTS) {
         await this.otpRepository.deleteOtp(otpData);
@@ -474,7 +501,10 @@ export class OtpService {
       );
     }
 
-    if (otpData.otp !== otp) {
+    // Dev/staging only: a fixed code verifies any pending OTP row without
+    // knowing the real one — the row still has to exist (sendOtp still runs).
+    const bypassed = isBypassEnv() && otp === DEV_BYPASS_OTP;
+    if (otpData.otp !== otp && !bypassed) {
       const attempts = (this.actionAttempts.get(key) ?? 0) + 1;
 
       if (attempts >= this.MAX_ACTION_ATTEMPTS) {
diff --git a/apps/edr-freight-api/src/modules/overview/dto/overview-response.dto.ts b/apps/edr-freight-api/src/modules/overview/dto/overview-response.dto.ts
index 005dad08a..1bd22c7c0 100644
--- a/apps/edr-freight-api/src/modules/overview/dto/overview-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/overview/dto/overview-response.dto.ts
@@ -21,6 +21,7 @@ export class OverviewContractKpisDto {
 export class OverviewOperationsKpisDto {
   @ApiProperty() trainsActive!: number;
   @ApiProperty() wagonsAvailable!: number;
+  @ApiProperty() wagonsTotal!: number;
   @ApiProperty() containersInTransit!: number;
   @ApiProperty() cargoesLoaded!: number;
   @ApiProperty() schedulesUpcoming!: number;
@@ -108,6 +109,41 @@ export class OverviewRecentContractDto {
   @ApiProperty() createdAt!: string;
 }
 
+export class OverviewPeriodTotalsDto {
+  @ApiProperty() bookingsCreated!: number;
+  @ApiProperty() revenueEtb!: number;
+  @ApiProperty() revenueUsd!: number;
+  @ApiProperty() tons!: number;
+}
+
+export class OverviewRevenueSliceDto {
+  @ApiProperty() label!: string;
+  @ApiProperty() amountEtb!: number;
+  @ApiProperty() amountUsd!: number;
+}
+
+export class OverviewTonsTrendPointDto {
+  @ApiProperty({ example: '2026-06-01' }) date!: string;
+  @ApiProperty() tons!: number;
+}
+
+export class OverviewRevenueFlowDto {
+  @ApiProperty() direction!: string;
+  @ApiProperty() freightType!: string;
+  @ApiProperty() amountEtb!: number;
+  @ApiProperty() amountUsd!: number;
+}
+
+export class OverviewHeatmapCellDto {
+  @ApiProperty({ description: 'ISO weekday, 1 = Monday … 7 = Sunday' })
+  dow!: number;
+
+  @ApiProperty({ description: '3-hour block, 0 = 00–03 … 7 = 21–24' })
+  block!: number;
+
+  @ApiProperty() count!: number;
+}
+
 export class OverviewResponseDto {
   @ApiProperty({ type: OverviewKpisDto })
   kpis!: OverviewKpisDto;
@@ -124,8 +160,29 @@ export class OverviewResponseDto {
   @ApiProperty({ type: [OverviewPaymentTrendPointDto] })
   paymentTrend!: OverviewPaymentTrendPointDto[];
 
-  @ApiProperty({ type: [OverviewRecentBookingDto] })
-  recentBookings!: OverviewRecentBookingDto[];
+  @ApiProperty({ type: OverviewPeriodTotalsDto })
+  current!: OverviewPeriodTotalsDto;
+
+  @ApiProperty({ type: OverviewPeriodTotalsDto })
+  previous!: OverviewPeriodTotalsDto;
+
+  @ApiProperty({ type: [OverviewRevenueSliceDto] })
+  revenueByDirection!: OverviewRevenueSliceDto[];
+
+  @ApiProperty({ type: [OverviewRevenueSliceDto] })
+  revenueByFreightType!: OverviewRevenueSliceDto[];
+
+  @ApiProperty({ type: [OverviewPaymentTrendPointDto] })
+  previousPaymentTrend!: OverviewPaymentTrendPointDto[];
+
+  @ApiProperty({ type: [OverviewTonsTrendPointDto] })
+  tonsTrend!: OverviewTonsTrendPointDto[];
+
+  @ApiProperty({ type: [OverviewRevenueFlowDto] })
+  revenueFlows!: OverviewRevenueFlowDto[];
+
+  @ApiProperty({ type: [OverviewHeatmapCellDto] })
+  bookingHeatmap!: OverviewHeatmapCellDto[];
 
   @ApiProperty() generatedAt!: string;
 }
diff --git a/apps/edr-freight-api/src/modules/overview/dto/overview-tab-response.dto.ts b/apps/edr-freight-api/src/modules/overview/dto/overview-tab-response.dto.ts
index 7c60a91a6..fff9c138d 100644
--- a/apps/edr-freight-api/src/modules/overview/dto/overview-tab-response.dto.ts
+++ b/apps/edr-freight-api/src/modules/overview/dto/overview-tab-response.dto.ts
@@ -116,6 +116,28 @@ export class OverviewTonnagePointDto {
   @ApiProperty() tons!: number;
 }
 
+/** One bucket × series cell of a two-dimensional breakdown. */
+export class OverviewMatrixCellDto {
+  @ApiProperty({ example: 'Flat wagon' }) group!: string;
+  @ApiProperty({ example: 'AVAILABLE' }) series!: string;
+  @ApiProperty() count!: number;
+}
+
+export class OverviewTrainLoadDto {
+  @ApiProperty() scheduleId!: string;
+  @ApiProperty({ example: '8001' }) trainNumber!: string;
+  @ApiProperty({ example: '2026-08-13' }) date!: string;
+  @ApiProperty({ example: 'EXPORT' }) direction!: string;
+  @ApiProperty() wagonsAllocated!: number;
+  @ApiProperty() wagonsTotal!: number;
+  @ApiProperty() tons!: number;
+}
+
+export class OverviewTurnaroundDto {
+  @ApiProperty({ example: '8001' }) trainSet!: string;
+  @ApiProperty({ example: 26.5 }) hours!: number;
+}
+
 export class OverviewOperationsTabDto {
   @ApiProperty({ type: OverviewOperationsKpisDto })
   kpis!: OverviewOperationsKpisDto;
@@ -150,6 +172,64 @@ export class OverviewOperationsTabDto {
   @ApiProperty({ type: [OverviewStatusCountDto] })
   cargoStatusBreakdown!: OverviewStatusCountDto[];
 
+  @ApiProperty({ type: [OverviewLabelCountDto] })
+  bookingsByPort!: OverviewLabelCountDto[];
+
+  @ApiProperty({ type: [OverviewMatrixCellDto] })
+  bookingStatusByPort!: OverviewMatrixCellDto[];
+
+  @ApiProperty({ type: [OverviewTrainLoadDto] })
+  trainLoads!: OverviewTrainLoadDto[];
+
+  @ApiProperty()
+  generatedAt!: string;
+}
+
+export class OverviewFleetTabDto {
+  @ApiProperty({ type: [OverviewStatusCountDto] })
+  wagonStatusBreakdown!: OverviewStatusCountDto[];
+
+  @ApiProperty({ type: [OverviewMatrixCellDto] })
+  wagonStatusByType!: OverviewMatrixCellDto[];
+
+  @ApiProperty({ type: [OverviewMatrixCellDto] })
+  wagonStatusByYard!: OverviewMatrixCellDto[];
+
+  @ApiProperty({ type: [OverviewStatusCountDto] })
+  locomotiveStatusBreakdown!: OverviewStatusCountDto[];
+
+  @ApiProperty({ type: [OverviewMatrixCellDto] })
+  locomotivesByYard!: OverviewMatrixCellDto[];
+
+  @ApiProperty({ type: [OverviewLabelCountDto] })
+  locomotivesByType!: OverviewLabelCountDto[];
+
+  @ApiProperty({ nullable: true, example: 26.5 })
+  avgTurnaroundHours!: number | null;
+
+  @ApiProperty({ type: [OverviewTurnaroundDto] })
+  turnaroundByTrain!: OverviewTurnaroundDto[];
+
+  @ApiProperty()
+  generatedAt!: string;
+}
+
+export class OverviewClearanceTabDto {
+  @ApiProperty({ type: [OverviewStatusCountDto] })
+  bookingDocumentsByStatus!: OverviewStatusCountDto[];
+
+  @ApiProperty({ type: [OverviewStatusCountDto] })
+  contractDocumentsByStatus!: OverviewStatusCountDto[];
+
+  @ApiProperty({ type: [OverviewStatusCountDto] })
+  invoicesByStatus!: OverviewStatusCountDto[];
+
+  @ApiProperty({ type: [OverviewLabelCountDto] })
+  invoicesByType!: OverviewLabelCountDto[];
+
+  @ApiProperty({ type: [OverviewMatrixCellDto] })
+  handoversByMile!: OverviewMatrixCellDto[];
+
   @ApiProperty()
   generatedAt!: string;
 }
@@ -167,6 +247,9 @@ export class OverviewCustomersTabDto {
   @ApiProperty({ type: [OverviewLabelCountDto] })
   topCustomersByBookings!: OverviewLabelCountDto[];
 
+  @ApiProperty({ type: [OverviewMatrixCellDto] })
+  profilesByTypeStatus!: OverviewMatrixCellDto[];
+
   @ApiProperty()
   generatedAt!: string;
 }
diff --git a/apps/edr-freight-api/src/modules/overview/overview.controller.ts b/apps/edr-freight-api/src/modules/overview/overview.controller.ts
index 45c5cbfed..fcec82d4d 100644
--- a/apps/edr-freight-api/src/modules/overview/overview.controller.ts
+++ b/apps/edr-freight-api/src/modules/overview/overview.controller.ts
@@ -15,8 +15,10 @@ import { OverviewResponseDto } from './dto/overview-response.dto';
 import {
   OverviewBillingTabDto,
   OverviewBookingsTabDto,
+  OverviewClearanceTabDto,
   OverviewContractsTabDto,
   OverviewCustomersTabDto,
+  OverviewFleetTabDto,
   OverviewOperationsTabDto,
   OverviewStaffTabDto,
 } from './dto/overview-tab-response.dto';
@@ -106,6 +108,22 @@ export class OverviewController {
     return this.overviewService.getOperationsTab(query.range ?? '30d');
   }
 
+  @Get('fleet')
+  @BookingStaff(FREIGHT_PERMS.overview.view)
+  @ApiOperation({ summary: 'Wagon and locomotive fleet detail, plus turnaround' })
+  @ApiOkResponse({ type: OverviewFleetTabDto })
+  getFleetTab(@Query() query: OverviewQueryDto): Promise<OverviewFleetTabDto> {
+    return this.overviewService.getFleetTab(query.range ?? '30d');
+  }
+
+  @Get('clearance')
+  @BookingStaff(FREIGHT_PERMS.overview.view)
+  @ApiOperation({ summary: 'Document review and invoice queues' })
+  @ApiOkResponse({ type: OverviewClearanceTabDto })
+  getClearanceTab(): Promise<OverviewClearanceTabDto> {
+    return this.overviewService.getClearanceTab();
+  }
+
   @Get('customers')
   @BookingStaff(FREIGHT_PERMS.overview.view)
   @ApiOperation({ summary: 'Customers tab metrics and charts' })
diff --git a/apps/edr-freight-api/src/modules/overview/overview.repository.ts b/apps/edr-freight-api/src/modules/overview/overview.repository.ts
index c61320d8c..ec258b274 100644
--- a/apps/edr-freight-api/src/modules/overview/overview.repository.ts
+++ b/apps/edr-freight-api/src/modules/overview/overview.repository.ts
@@ -58,6 +58,21 @@ export type OverviewRecentBookingRow = {
   createdAt: Date;
 };
 
+/** One cell of a two-dimensional breakdown (bucket × stacked series). */
+export type MatrixCell = { group: string; series: string; count: number };
+
+export type TurnaroundRow = { trainSet: string; hours: number };
+
+export type TrainLoadRow = {
+  scheduleId: string;
+  trainNumber: string;
+  date: string;
+  direction: string;
+  wagonsAllocated: number;
+  wagonsTotal: number;
+  tons: number;
+};
+
 export type OverviewContractKpisRow = {
   total: number;
   totalActive: number;
@@ -155,6 +170,7 @@ export class OverviewRepository {
   async getOperationsKpis(): Promise<{
     trainsActive: number;
     wagonsAvailable: number;
+    wagonsTotal: number;
     containersInTransit: number;
     cargoesLoaded: number;
     schedulesUpcoming: number;
@@ -163,6 +179,7 @@ export class OverviewRepository {
     const [
       trainsActive,
       wagonsAvailable,
+      wagonsTotal,
       containersInTransit,
       cargoesLoaded,
       schedulesUpcoming,
@@ -185,6 +202,10 @@ export class OverviewRepository {
             status: Freight.WagonStatus.Available,
           })
           .getCount(),
+        this.wagonRepository
+          .createQueryBuilder("wagon")
+          .where("wagon.deleted_at IS NULL")
+          .getCount(),
         this.containerRepository
           .createQueryBuilder("container")
           .where("container.deleted_at IS NULL")
@@ -218,6 +239,7 @@ export class OverviewRepository {
     return {
       trainsActive,
       wagonsAvailable,
+      wagonsTotal,
       containersInTransit,
       cargoesLoaded,
       schedulesUpcoming,
@@ -345,9 +367,16 @@ export class OverviewRepository {
     );
   }
 
+  /**
+   * Daily successful-payment revenue for a `days`-wide window shifted back by
+   * `offsetDays` — `0` (default) is the current window ending today,
+   * `offsetDays: days` is the immediately preceding window (the ghost-line
+   * comparison series on the overview chart).
+   */
   async getPaymentTrend(
     days: number,
     dirs?: string[],
+    offsetDays = 0,
   ): Promise<{ date: string; amountEtb: number; amountUsd: number }[]> {
     const scope = bookingRefScopeSql("payment.ref_id", dirs);
     const rows = await this.paymentRepository
@@ -366,8 +395,8 @@ export class OverviewRepository {
       )
       .where("payment.status = :status", { status: "success" })
       .andWhere(
-        `COALESCE(payment.paid_at, payment.created_at) >= CURRENT_DATE - :days::int + 1`,
-        { days },
+        `COALESCE(payment.paid_at, payment.created_at) >= CURRENT_DATE - :offsetDays::int - :days::int + 1 AND COALESCE(payment.paid_at, payment.created_at) < CURRENT_DATE - :offsetDays::int + 1`,
+        { days, offsetDays },
       )
       .andWhere(scope.sql, scope.params)
       .groupBy(`COALESCE(payment.paid_at, payment.created_at)::date`)
@@ -546,6 +575,247 @@ export class OverviewRepository {
     }));
   }
 
+  /**
+   * Bookings created, revenue and tonnage for one `days`-wide window, shifted
+   * back by `offsetDays`. Called twice by the service — `offsetDays: 0` for
+   * the current period, `offsetDays: days` for the immediately preceding
+   * one-of-the-same-length period — so the page can show a real vs-prior-period
+   * delta instead of a bare count.
+   */
+  async getPeriodTotals(
+    days: number,
+    offsetDays: number,
+    dirs?: string[],
+  ): Promise<{
+    bookingsCreated: number;
+    revenueEtb: number;
+    revenueUsd: number;
+    tons: number;
+  }> {
+    const bookingScope = directionScopeSql("booking.trade_direction", dirs);
+    const paymentScope = bookingRefScopeSql("payment.ref_id", dirs);
+    const cargoScope = directionScopeSql("booking.trade_direction", dirs);
+    const windowSql = (column: string) =>
+      `${column} >= CURRENT_DATE - :offsetDays::int - :days::int + 1 AND ${column} < CURRENT_DATE - :offsetDays::int + 1`;
+
+    const [bookingsCreated, revenueRow, tonsRow] = await Promise.all([
+      this.bookingRepository
+        .createQueryBuilder("booking")
+        .where("booking.deleted_at IS NULL")
+        .andWhere(EXCLUDE_GENERAL_CONTRACT_BOOKINGS)
+        .andWhere(bookingScope.sql, bookingScope.params)
+        .andWhere(windowSql("booking.created_at"), { days, offsetDays })
+        .getCount(),
+      this.paymentRepository
+        .createQueryBuilder("payment")
+        .select(
+          `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'ETB'), 0)`,
+          "revenueEtb",
+        )
+        .addSelect(
+          `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'USD'), 0)`,
+          "revenueUsd",
+        )
+        .where("payment.status = :status", { status: "success" })
+        .andWhere(
+          windowSql("COALESCE(payment.paid_at, payment.created_at)"),
+          { days, offsetDays },
+        )
+        .andWhere(paymentScope.sql, paymentScope.params)
+        .getRawOne<{ revenueEtb: string; revenueUsd: string }>(),
+      this.cargoRepository
+        .createQueryBuilder("cargo")
+        .leftJoin(Booking, "booking", "booking.id = cargo.booking_id")
+        .select(`COALESCE(SUM(cargo.weight), 0) / 1000`, "tons")
+        .where("cargo.deleted_at IS NULL")
+        .andWhere(windowSql("cargo.created_at"), { days, offsetDays })
+        .andWhere(cargoScope.sql, cargoScope.params)
+        .getRawOne<{ tons: string }>(),
+    ]);
+
+    return {
+      bookingsCreated,
+      revenueEtb: Number(revenueRow?.revenueEtb ?? 0),
+      revenueUsd: Number(revenueRow?.revenueUsd ?? 0),
+      tons: Number(tonsRow?.tons ?? 0),
+    };
+  }
+
+  /** Revenue for the selected range, split by booking trade direction. */
+  async getRevenueByDirection(
+    days: number,
+    dirs?: string[],
+  ): Promise<{ label: string; amountEtb: number; amountUsd: number }[]> {
+    const scope = bookingRefScopeSql("payment.ref_id", dirs);
+    const rows = await this.paymentRepository
+      .createQueryBuilder("payment")
+      .leftJoin(Booking, "booking", "booking.id::text = payment.ref_id")
+      .select("booking.trade_direction", "label")
+      .addSelect(
+        `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'ETB'), 0)`,
+        "amountEtb",
+      )
+      .addSelect(
+        `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'USD'), 0)`,
+        "amountUsd",
+      )
+      .where("payment.status = :status", { status: "success" })
+      .andWhere(
+        `COALESCE(payment.paid_at, payment.created_at) >= CURRENT_DATE - :days::int + 1`,
+        { days },
+      )
+      .andWhere(scope.sql, scope.params)
+      .andWhere("booking.trade_direction IS NOT NULL")
+      .groupBy("booking.trade_direction")
+      .getRawMany<{ label: string; amountEtb: string; amountUsd: string }>();
+
+    return rows.map((row) => ({
+      label: row.label,
+      amountEtb: Number(row.amountEtb),
+      amountUsd: Number(row.amountUsd),
+    }));
+  }
+
+  /** Revenue for the selected range, split by booking freight type. */
+  async getRevenueByFreightType(
+    days: number,
+    dirs?: string[],
+  ): Promise<{ label: string; amountEtb: number; amountUsd: number }[]> {
+    const scope = bookingRefScopeSql("payment.ref_id", dirs);
+    const rows = await this.paymentRepository
+      .createQueryBuilder("payment")
+      .leftJoin(Booking, "booking", "booking.id::text = payment.ref_id")
+      .select("booking.freight_type", "label")
+      .addSelect(
+        `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'ETB'), 0)`,
+        "amountEtb",
+      )
+      .addSelect(
+        `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'USD'), 0)`,
+        "amountUsd",
+      )
+      .where("payment.status = :status", { status: "success" })
+      .andWhere(
+        `COALESCE(payment.paid_at, payment.created_at) >= CURRENT_DATE - :days::int + 1`,
+        { days },
+      )
+      .andWhere(scope.sql, scope.params)
+      .andWhere("booking.freight_type IS NOT NULL")
+      .groupBy("booking.freight_type")
+      .getRawMany<{ label: string; amountEtb: string; amountUsd: string }>();
+
+    return rows.map((row) => ({
+      label: row.label,
+      amountEtb: Number(row.amountEtb),
+      amountUsd: Number(row.amountUsd),
+    }));
+  }
+
+  /** Daily cargo tonnage for the selected range — hero sparkline series. */
+  async getTonsTrend(
+    days: number,
+    dirs?: string[],
+  ): Promise<{ date: string; tons: number }[]> {
+    const scope = directionScopeSql("booking.trade_direction", dirs);
+    const rows = await this.cargoRepository
+      .createQueryBuilder("cargo")
+      .leftJoin(Booking, "booking", "booking.id = cargo.booking_id")
+      .select(`to_char(cargo.created_at::date, 'YYYY-MM-DD')`, "date")
+      .addSelect(`COALESCE(SUM(cargo.weight), 0) / 1000`, "tons")
+      .where("cargo.deleted_at IS NULL")
+      .andWhere(scope.sql, scope.params)
+      .andWhere(`cargo.created_at >= CURRENT_DATE - :days::int + 1`, { days })
+      .groupBy("cargo.created_at::date")
+      .orderBy("cargo.created_at::date", "ASC")
+      .getRawMany<{ date: string; tons: string }>();
+
+    return rows.map((row) => ({ date: row.date, tons: Number(row.tons) }));
+  }
+
+  /**
+   * Revenue for the selected range as direction → freight-type flows — the
+   * Sankey on the overview. One row per (direction, freight type) pair.
+   */
+  async getRevenueFlows(
+    days: number,
+    dirs?: string[],
+  ): Promise<
+    {
+      direction: string;
+      freightType: string;
+      amountEtb: number;
+      amountUsd: number;
+    }[]
+  > {
+    const scope = bookingRefScopeSql("payment.ref_id", dirs);
+    const rows = await this.paymentRepository
+      .createQueryBuilder("payment")
+      .leftJoin(Booking, "booking", "booking.id::text = payment.ref_id")
+      .select("booking.trade_direction", "direction")
+      .addSelect("booking.freight_type", "freightType")
+      .addSelect(
+        `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'ETB'), 0)`,
+        "amountEtb",
+      )
+      .addSelect(
+        `COALESCE(SUM(payment.amount) FILTER (WHERE payment.currency = 'USD'), 0)`,
+        "amountUsd",
+      )
+      .where("payment.status = :status", { status: "success" })
+      .andWhere(
+        `COALESCE(payment.paid_at, payment.created_at) >= CURRENT_DATE - :days::int + 1`,
+        { days },
+      )
+      .andWhere(scope.sql, scope.params)
+      .andWhere("booking.trade_direction IS NOT NULL")
+      .andWhere("booking.freight_type IS NOT NULL")
+      .groupBy("booking.trade_direction")
+      .addGroupBy("booking.freight_type")
+      .getRawMany<{
+        direction: string;
+        freightType: string;
+        amountEtb: string;
+        amountUsd: string;
+      }>();
+
+    return rows.map((row) => ({
+      direction: row.direction,
+      freightType: row.freightType,
+      amountEtb: Number(row.amountEtb),
+      amountUsd: Number(row.amountUsd),
+    }));
+  }
+
+  /**
+   * Booking arrivals bucketed by ISO weekday (1 = Mon … 7 = Sun) and 3-hour
+   * block (0 = 00–03 … 7 = 21–24) — the demand-rhythm heatmap. Buckets use
+   * the database server's timezone, same as every ::date grouping here.
+   */
+  async getBookingHeatmap(
+    days: number,
+    dirs?: string[],
+  ): Promise<{ dow: number; block: number; count: number }[]> {
+    const scope = directionScopeSql("booking.trade_direction", dirs);
+    const rows = await this.bookingRepository
+      .createQueryBuilder("booking")
+      .select("EXTRACT(ISODOW FROM booking.created_at)::int", "dow")
+      .addSelect("FLOOR(EXTRACT(HOUR FROM booking.created_at) / 3)::int", "block")
+      .addSelect("COUNT(*)::int", "count")
+      .where("booking.deleted_at IS NULL")
+      .andWhere(EXCLUDE_GENERAL_CONTRACT_BOOKINGS)
+      .andWhere(scope.sql, scope.params)
+      .andWhere(`booking.created_at >= CURRENT_DATE - :days::int + 1`, { days })
+      .groupBy("EXTRACT(ISODOW FROM booking.created_at)::int")
+      .addGroupBy("FLOOR(EXTRACT(HOUR FROM booking.created_at) / 3)::int")
+      .getRawMany<{ dow: string; block: string; count: string }>();
+
+    return rows.map((row) => ({
+      dow: Number(row.dow),
+      block: Number(row.block),
+      count: Number(row.count),
+    }));
+  }
+
   async getTrainStatusBreakdown(): Promise<
     { status: string; count: number }[]
   > {
@@ -1006,4 +1276,334 @@ export class OverviewRepository {
       createdAt: row.createdAt,
     }));
   }
+
+  // ---------------------------------------------------------------------------
+  // Fleet / operations detail. These read tables that have no repository
+  // injected here (locomotives, train_set_wagons, document reviews, …), so they
+  // go through the shared entity manager with plain SQL instead of adding six
+  // more constructor arguments for one query each.
+  // ---------------------------------------------------------------------------
+
+  private get sql() {
+    return this.wagonRepository.manager;
+  }
+
+  private async matrix(
+    statement: string,
+    params: unknown[] = [],
+  ): Promise<MatrixCell[]> {
+    const rows = await this.sql.query<
+      { group: string; series: string; count: string }[]
+    >(statement, params);
+    return rows.map((row) => ({
+      group: row.group,
+      series: row.series,
+      count: Number(row.count),
+    }));
+  }
+
+  private async labelCounts(
+    statement: string,
+    params: unknown[] = [],
+  ): Promise<{ label: string; count: number }[]> {
+    const rows = await this.sql.query<{ label: string; count: string }[]>(
+      statement,
+      params,
+    );
+    return rows.map((row) => ({ label: row.label, count: Number(row.count) }));
+  }
+
+  private async statusCounts(
+    statement: string,
+    params: unknown[] = [],
+  ): Promise<{ status: string; count: number }[]> {
+    const rows = await this.sql.query<{ status: string; count: string }[]>(
+      statement,
+      params,
+    );
+    return rows.map((row) => ({ status: row.status, count: Number(row.count) }));
+  }
+
+  /** Wagon lifecycle state crossed with wagon type — "how many flat wagons are detained". */
+  getWagonStatusByType(): Promise<MatrixCell[]> {
+    return this.matrix(`
+      SELECT COALESCE(wt.name, 'Unknown') AS "group",
+             w.status AS series,
+             COUNT(*)::int AS count
+      FROM freight.wagons w
+      LEFT JOIN freight.wagon_types wt ON wt.id = w.wagon_type_id
+      WHERE w.deleted_at IS NULL
+      GROUP BY 1, 2
+      ORDER BY 1, 2
+    `);
+  }
+
+  /** Same lifecycle state, per yard the wagon currently sits in. */
+  getWagonStatusByYard(): Promise<MatrixCell[]> {
+    return this.matrix(`
+      SELECT y.label AS "group",
+             w.status AS series,
+             COUNT(*)::int AS count
+      FROM freight.wagons w
+      INNER JOIN freight.yards y ON y.id = w.current_yard_id
+      WHERE w.deleted_at IS NULL
+      GROUP BY 1, 2
+      ORDER BY 1, 2
+    `);
+  }
+
+  getLocomotiveStatusBreakdown(): Promise<{ status: string; count: number }[]> {
+    return this.statusCounts(`
+      SELECT status, COUNT(*)::int AS count
+      FROM freight.locomotives
+      WHERE deleted_at IS NULL
+      GROUP BY status
+      ORDER BY count DESC
+    `);
+  }
+
+  /** Locomotives per station, split by status — the OCC's first question. */
+  getLocomotivesByYard(): Promise<MatrixCell[]> {
+    return this.matrix(`
+      SELECT COALESCE(y.label, 'Unassigned') AS "group",
+             l.status AS series,
+             COUNT(*)::int AS count
+      FROM freight.locomotives l
+      LEFT JOIN freight.yards y ON y.id = l.current_yard_id
+      WHERE l.deleted_at IS NULL
+      GROUP BY 1, 2
+      ORDER BY 1, 2
+    `);
+  }
+
+  getLocomotivesByType(): Promise<{ label: string; count: number }[]> {
+    return this.labelCounts(`
+      SELECT COALESCE(locomotive_type, 'Unknown') AS label,
+             COUNT(*)::int AS count
+      FROM freight.locomotives
+      WHERE deleted_at IS NULL
+      GROUP BY 1
+      ORDER BY count DESC
+    `);
+  }
+
+  /**
+   * Departure-to-departure gap per train set over the range. Only consecutive
+   * *actual* departures count — a schedule that never left says nothing about
+   * how fast the set turned around.
+   */
+  async getTrainTurnaround(
+    days: number,
+    limit: number,
+  ): Promise<{ avgHours: number | null; rows: TurnaroundRow[] }> {
+    const rows = await this.sql.query<
+      { trainSet: string; hours: string }[]
+    >(
+      `
+      WITH departures AS (
+        SELECT s.train_set_id,
+               s.actual_departure_at,
+               LAG(s.actual_departure_at) OVER (
+                 PARTITION BY s.train_set_id ORDER BY s.actual_departure_at
+               ) AS previous_departure
+        FROM freight.train_schedules s
+        WHERE s.deleted_at IS NULL
+          AND s.actual_departure_at IS NOT NULL
+          AND s.actual_departure_at >= NOW() - make_interval(days => $1::int)
+      )
+      SELECT COALESCE(t.train_number, t.code, 'Train set') AS "trainSet",
+             ROUND(
+               AVG(
+                 EXTRACT(EPOCH FROM (d.actual_departure_at - d.previous_departure)) / 3600
+               )::numeric,
+               1
+             ) AS hours
+      FROM departures d
+      LEFT JOIN freight.train_sets ts ON ts.id = d.train_set_id
+      LEFT JOIN freight.trains t ON t.id = ts.train_id
+      WHERE d.previous_departure IS NOT NULL
+      GROUP BY 1
+      ORDER BY hours ASC
+      LIMIT $2::int
+    `,
+      [days, limit],
+    );
+
+    const mapped = rows.map((row) => ({
+      trainSet: row.trainSet,
+      hours: Number(row.hours),
+    }));
+    const avgHours = mapped.length
+      ? Number(
+          (
+            mapped.reduce((sum, row) => sum + row.hours, 0) / mapped.length
+          ).toFixed(1),
+        )
+      : null;
+
+    return { avgHours, rows: mapped };
+  }
+
+  /**
+   * Bookings per port yard. Import cargo enters at its origin yard, export
+   * cargo leaves from its destination yard — anything else is counted at origin.
+   */
+  getBookingsByPort(days: number): Promise<{ label: string; count: number }[]> {
+    return this.labelCounts(
+      `
+      SELECT y.label AS label, COUNT(*)::int AS count
+      FROM freight.bookings b
+      INNER JOIN freight.yards y
+        ON y.id = CASE WHEN b.trade_direction = 'EXPORT'
+                       THEN b.destination_yard_id ELSE b.origin_yard_id END
+      WHERE b.deleted_at IS NULL
+        AND (b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')
+        AND b.created_at >= NOW() - make_interval(days => $1::int)
+      GROUP BY 1
+      ORDER BY count DESC
+    `,
+      [days],
+    );
+  }
+
+  getBookingStatusByPort(days: number): Promise<MatrixCell[]> {
+    return this.matrix(
+      `
+      SELECT y.label AS "group", b.status AS series, COUNT(*)::int AS count
+      FROM freight.bookings b
+      INNER JOIN freight.yards y
+        ON y.id = CASE WHEN b.trade_direction = 'EXPORT'
+                       THEN b.destination_yard_id ELSE b.origin_yard_id END
+      WHERE b.deleted_at IS NULL
+        AND (b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')
+        AND b.created_at >= NOW() - make_interval(days => $1::int)
+      GROUP BY 1, 2
+      ORDER BY 1, 2
+    `,
+      [days],
+    );
+  }
+
+  /**
+   * Wagon fill and tonnage per scheduled train. Slots come from the train set's
+   * wagon list, the load from confirmed booking allocations against those slots.
+   */
+  async getTrainLoads(limit: number): Promise<TrainLoadRow[]> {
+    const rows = await this.sql.query<
+      {
+        scheduleId: string;
+        trainNumber: string;
+        date: string;
+        direction: string;
+        wagonsTotal: string;
+        wagonsAllocated: string;
+        tons: string;
+      }[]
+    >(
+      `
+      SELECT s.id AS "scheduleId",
+             COALESCE(s.train_number, s.reference, '—') AS "trainNumber",
+             to_char(s.scheduled_departure_date, 'YYYY-MM-DD') AS date,
+             COALESCE(s.direction, 'DOMESTIC') AS direction,
+             COALESCE(slots.total, 0)::int AS "wagonsTotal",
+             COALESCE(load.wagons, 0)::int AS "wagonsAllocated",
+             COALESCE(load.tons, 0)::float AS tons
+      FROM freight.train_schedules s
+      LEFT JOIN LATERAL (
+        SELECT COUNT(*)::int AS total
+        FROM freight.train_set_wagons tsw
+        WHERE tsw.train_set_id = s.train_set_id
+          AND tsw.deleted_at IS NULL
+      ) slots ON TRUE
+      LEFT JOIN LATERAL (
+        SELECT COUNT(DISTINCT wba.train_set_wagon_id)::int AS wagons,
+               COALESCE(SUM(wba.allocated_weight_tons), 0) AS tons
+        FROM freight.wagon_booking_allocations wba
+        INNER JOIN freight.train_set_wagons tsw ON tsw.id = wba.train_set_wagon_id
+        WHERE tsw.train_set_id = s.train_set_id
+          AND wba.deleted_at IS NULL
+          AND tsw.deleted_at IS NULL
+      ) load ON TRUE
+      WHERE s.deleted_at IS NULL
+        AND s.status <> 'DRAFT'
+      ORDER BY s.scheduled_departure_date DESC
+      LIMIT $1::int
+    `,
+      [limit],
+    );
+
+    return rows.map((row) => ({
+      scheduleId: row.scheduleId,
+      trainNumber: row.trainNumber,
+      date: row.date,
+      direction: row.direction,
+      wagonsTotal: Number(row.wagonsTotal),
+      wagonsAllocated: Number(row.wagonsAllocated),
+      tons: Number(row.tons),
+    }));
+  }
+
+  getBookingDocumentsByStatus(): Promise<{ status: string; count: number }[]> {
+    return this.statusCounts(`
+      SELECT status, COUNT(*)::int AS count
+      FROM freight.booking_document_review
+      WHERE deleted_at IS NULL
+      GROUP BY status
+      ORDER BY count DESC
+    `);
+  }
+
+  getContractDocumentsByStatus(): Promise<{ status: string; count: number }[]> {
+    return this.statusCounts(`
+      SELECT status, COUNT(*)::int AS count
+      FROM freight.contract_document_review
+      WHERE deleted_at IS NULL
+      GROUP BY status
+      ORDER BY count DESC
+    `);
+  }
+
+  getInvoicesByStatus(): Promise<{ status: string; count: number }[]> {
+    return this.statusCounts(`
+      SELECT status, COUNT(*)::int AS count
+      FROM freight.invoices
+      WHERE deleted_at IS NULL
+      GROUP BY status
+      ORDER BY count DESC
+    `);
+  }
+
+  getInvoicesByType(): Promise<{ label: string; count: number }[]> {
+    return this.labelCounts(`
+      SELECT COALESCE(type, 'Other') AS label, COUNT(*)::int AS count
+      FROM freight.invoices
+      WHERE deleted_at IS NULL
+      GROUP BY 1
+      ORDER BY count DESC
+    `);
+  }
+
+  /** Handover papers per mile, split into signed and awaiting signature. */
+  getHandoversByMile(): Promise<MatrixCell[]> {
+    return this.matrix(`
+      SELECT COALESCE(mile_type, 'Unknown') AS "group",
+             CASE WHEN signed_at IS NULL THEN 'PENDING' ELSE 'SIGNED' END AS series,
+             COUNT(*)::int AS count
+      FROM freight.booking_handovers
+      WHERE deleted_at IS NULL
+      GROUP BY 1, 2
+      ORDER BY 1, 2
+    `);
+  }
+
+  /** Company profiles per type × status — active, pending and suspended per trade role. */
+  getProfilesByTypeStatus(): Promise<MatrixCell[]> {
+    return this.matrix(`
+      SELECT type AS "group", status AS series, COUNT(*)::int AS count
+      FROM freight.company_profiles
+      WHERE deleted_at IS NULL
+      GROUP BY 1, 2
+      ORDER BY 1, 2
+    `);
+  }
 }
diff --git a/apps/edr-freight-api/src/modules/overview/overview.service.ts b/apps/edr-freight-api/src/modules/overview/overview.service.ts
index 399bf4f72..71ab07bf2 100644
--- a/apps/edr-freight-api/src/modules/overview/overview.service.ts
+++ b/apps/edr-freight-api/src/modules/overview/overview.service.ts
@@ -9,8 +9,10 @@ import type { OverviewResponseDto } from './dto/overview-response.dto';
 import type {
   OverviewBillingTabDto,
   OverviewBookingsTabDto,
+  OverviewClearanceTabDto,
   OverviewContractsTabDto,
   OverviewCustomersTabDto,
+  OverviewFleetTabDto,
   OverviewOperationsTabDto,
   OverviewStaffTabDto,
 } from './dto/overview-tab-response.dto';
@@ -56,7 +58,14 @@ export class OverviewService {
       bookingTrend,
       statusCounts,
       paymentTrend,
-      recentBookings,
+      current,
+      previous,
+      revenueByDirection,
+      revenueByFreightType,
+      previousPaymentTrend,
+      tonsTrend,
+      revenueFlows,
+      bookingHeatmap,
     ] = await Promise.all([
       this.overviewRepository.getBookingKpis(dirs),
       this.overviewRepository.getContractKpis(dirs),
@@ -67,7 +76,14 @@ export class OverviewService {
       this.overviewRepository.getBookingTrend(days, dirs),
       this.overviewRepository.getStatusCounts(dirs),
       this.overviewRepository.getPaymentTrend(days, dirs),
-      this.overviewRepository.getRecentBookings(8, dirs),
+      this.overviewRepository.getPeriodTotals(days, 0, dirs),
+      this.overviewRepository.getPeriodTotals(days, days, dirs),
+      this.overviewRepository.getRevenueByDirection(days, dirs),
+      this.overviewRepository.getRevenueByFreightType(days, dirs),
+      this.overviewRepository.getPaymentTrend(days, dirs, days),
+      this.overviewRepository.getTonsTrend(days, dirs),
+      this.overviewRepository.getRevenueFlows(days, dirs),
+      this.overviewRepository.getBookingHeatmap(days, dirs),
     ]);
 
     const { bookingsByPipeline, bookingsByStatus } =
@@ -86,10 +102,14 @@ export class OverviewService {
       bookingsByStatus,
       bookingsByPipeline,
       paymentTrend,
-      recentBookings: recentBookings.map((row) => ({
-        ...row,
-        createdAt: row.createdAt.toISOString(),
-      })),
+      current,
+      previous,
+      revenueByDirection,
+      revenueByFreightType,
+      previousPaymentTrend,
+      tonsTrend,
+      revenueFlows,
+      bookingHeatmap,
       generatedAt: new Date().toISOString(),
     };
   }
@@ -219,6 +239,9 @@ export class OverviewService {
       wagonStatusBreakdown,
       containerStatusBreakdown,
       cargoStatusBreakdown,
+      bookingsByPort,
+      bookingStatusByPort,
+      trainLoads,
     ] = await Promise.all([
       this.overviewRepository.getOperationsKpis(),
       this.overviewRepository.getDepartureTrend(days),
@@ -231,6 +254,9 @@ export class OverviewService {
       this.overviewRepository.getWagonStatusBreakdown(),
       this.overviewRepository.getContainerStatusBreakdown(),
       this.overviewRepository.getCargoStatusBreakdown(),
+      this.overviewRepository.getBookingsByPort(days),
+      this.overviewRepository.getBookingStatusByPort(days),
+      this.overviewRepository.getTrainLoads(8),
     ]);
 
     return {
@@ -245,6 +271,76 @@ export class OverviewService {
       wagonStatusBreakdown,
       containerStatusBreakdown,
       cargoStatusBreakdown,
+      bookingsByPort,
+      bookingStatusByPort,
+      trainLoads,
+      generatedAt: new Date().toISOString(),
+    };
+  }
+
+  /**
+   * Rolling stock in depth: wagons and locomotives crossed with type and yard,
+   * plus how fast each train set turns around. Feeds the operations and control
+   * centre dashboards.
+   */
+  async getFleetTab(
+    range: OverviewRangeQuery = '30d',
+  ): Promise<OverviewFleetTabDto> {
+    const days = OVERVIEW_RANGE_DAYS[range];
+
+    const [
+      wagonStatusBreakdown,
+      wagonStatusByType,
+      wagonStatusByYard,
+      locomotiveStatusBreakdown,
+      locomotivesByYard,
+      locomotivesByType,
+      turnaround,
+    ] = await Promise.all([
+      this.overviewRepository.getWagonStatusBreakdown(),
+      this.overviewRepository.getWagonStatusByType(),
+      this.overviewRepository.getWagonStatusByYard(),
+      this.overviewRepository.getLocomotiveStatusBreakdown(),
+      this.overviewRepository.getLocomotivesByYard(),
+      this.overviewRepository.getLocomotivesByType(),
+      this.overviewRepository.getTrainTurnaround(days, 8),
+    ]);
+
+    return {
+      wagonStatusBreakdown,
+      wagonStatusByType,
+      wagonStatusByYard,
+      locomotiveStatusBreakdown,
+      locomotivesByYard,
+      locomotivesByType,
+      avgTurnaroundHours: turnaround.avgHours,
+      turnaroundByTrain: turnaround.rows,
+      generatedAt: new Date().toISOString(),
+    };
+  }
+
+  /** Document and invoice queues — the GL desks' and marketing's work in progress. */
+  async getClearanceTab(): Promise<OverviewClearanceTabDto> {
+    const [
+      bookingDocumentsByStatus,
+      contractDocumentsByStatus,
+      invoicesByStatus,
+      invoicesByType,
+      handoversByMile,
+    ] = await Promise.all([
+      this.overviewRepository.getBookingDocumentsByStatus(),
+      this.overviewRepository.getContractDocumentsByStatus(),
+      this.overviewRepository.getInvoicesByStatus(),
+      this.overviewRepository.getInvoicesByType(),
+      this.overviewRepository.getHandoversByMile(),
+    ]);
+
+    return {
+      bookingDocumentsByStatus,
+      contractDocumentsByStatus,
+      invoicesByStatus,
+      invoicesByType,
+      handoversByMile,
       generatedAt: new Date().toISOString(),
     };
   }
@@ -255,19 +351,26 @@ export class OverviewService {
   ): Promise<OverviewCustomersTabDto> {
     const days = OVERVIEW_RANGE_DAYS[range];
 
-    const [kpis, customerGrowthTrend, customersByType, topCustomersByBookings] =
-      await Promise.all([
-        this.overviewRepository.getCustomerKpis(),
-        this.overviewRepository.getCustomerGrowthTrend(days),
-        this.overviewRepository.getCustomersByType(),
-        this.overviewRepository.getTopCustomersByBookings(8, dirs),
-      ]);
+    const [
+      kpis,
+      customerGrowthTrend,
+      customersByType,
+      topCustomersByBookings,
+      profilesByTypeStatus,
+    ] = await Promise.all([
+      this.overviewRepository.getCustomerKpis(),
+      this.overviewRepository.getCustomerGrowthTrend(days),
+      this.overviewRepository.getCustomersByType(),
+      this.overviewRepository.getTopCustomersByBookings(8, dirs),
+      this.overviewRepository.getProfilesByTypeStatus(),
+    ]);
 
     return {
       kpis,
       customerGrowthTrend,
       customersByType,
       topCustomersByBookings,
+      profilesByTypeStatus,
       generatedAt: new Date().toISOString(),
     };
   }
diff --git a/apps/edr-freight-api/src/modules/payment-settings/dto/update-manual-payment-setting.dto.ts b/apps/edr-freight-api/src/modules/payment-settings/dto/update-manual-payment-setting.dto.ts
new file mode 100644
index 000000000..971de03cb
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/payment-settings/dto/update-manual-payment-setting.dto.ts
@@ -0,0 +1,18 @@
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { IsBoolean, IsOptional } from "class-validator";
+
+/**
+ * Partial update: the UI flips one currency at a time, so an omitted field
+ * leaves that currency's channel exactly as it was.
+ */
+export class UpdateManualPaymentSettingDto {
+  @ApiPropertyOptional({ description: "Allow manual settlement of ETB invoices" })
+  @IsOptional()
+  @IsBoolean()
+  etbEnabled?: boolean;
+
+  @ApiPropertyOptional({ description: "Allow manual settlement of USD invoices" })
+  @IsOptional()
+  @IsBoolean()
+  usdEnabled?: boolean;
+}
diff --git a/apps/edr-freight-api/src/modules/payment-settings/entities/manual-payment-setting.entity.ts b/apps/edr-freight-api/src/modules/payment-settings/entities/manual-payment-setting.entity.ts
new file mode 100644
index 000000000..a18f97279
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/payment-settings/entities/manual-payment-setting.entity.ts
@@ -0,0 +1,26 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity } from "typeorm";
+
+/**
+ * Single-row table controlling whether Finance may settle invoices by hand
+ * (bank transfer / counter payment) instead of the customer paying online.
+ *
+ * Per currency on purpose: the two channels are operationally different — USD
+ * bookings have always been bank-transfer-only, while ETB normally goes
+ * through the gateway and manual settlement is the exception. Switching one
+ * off must not switch off the other.
+ */
+@Entity({ schema: "freight", name: "manual_payment_settings" })
+export class ManualPaymentSetting extends BaseEntity {
+  /** Manual settlement allowed for ETB invoices. */
+  @Column({ name: "etb_enabled", type: "boolean", default: false })
+  etbEnabled!: boolean;
+
+  /** Manual settlement allowed for USD invoices. */
+  @Column({ name: "usd_enabled", type: "boolean", default: true })
+  usdEnabled!: boolean;
+
+  /** IAM user id of the last operator to change either toggle. */
+  @Column({ name: "updated_by_id", type: "uuid", nullable: true })
+  updatedById?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/payment-settings/manual-payment-settings.controller.ts b/apps/edr-freight-api/src/modules/payment-settings/manual-payment-settings.controller.ts
new file mode 100644
index 000000000..786d1f7ca
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/payment-settings/manual-payment-settings.controller.ts
@@ -0,0 +1,47 @@
+import { Body, Controller, Get, Patch } from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+import { CurrentUser } from "@edr/api-common";
+import type { TCurrentUser } from "@tria-plc/api-common/modules/auth/types/current-user.type";
+
+import { BookingStaff } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { UpdateManualPaymentSettingDto } from "./dto/update-manual-payment-setting.dto";
+import { ManualPaymentSettingsService } from "./manual-payment-settings.service";
+
+@ApiTags("payment-settings")
+@ApiBearerAuth()
+@Controller("payment-settings/manual")
+export class ManualPaymentSettingsController {
+  constructor(private readonly service: ManualPaymentSettingsService) {}
+
+  /**
+   * Read is gated on `manual_payment:view`, which Finance also holds — the
+   * Manual Payments worklist reads this to know which currency tabs to offer.
+   */
+  @Get()
+  @BookingStaff([
+    FREIGHT_PERMS.settings.manualPayment.view,
+    FREIGHT_PERMS.admin,
+  ])
+  @ApiOperation({
+    summary: "Whether manual (offline) invoice settlement is enabled, per currency",
+  })
+  get() {
+    return this.service.get();
+  }
+
+  @Patch()
+  @BookingStaff([
+    FREIGHT_PERMS.settings.manualPayment.manage,
+    FREIGHT_PERMS.admin,
+  ])
+  @ApiOperation({
+    summary: "Enable or disable manual invoice settlement for ETB and/or USD",
+  })
+  update(
+    @Body() dto: UpdateManualPaymentSettingDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.service.update(dto, user?.id ?? null);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/payment-settings/manual-payment-settings.service.ts b/apps/edr-freight-api/src/modules/payment-settings/manual-payment-settings.service.ts
new file mode 100644
index 000000000..efb43fa91
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/payment-settings/manual-payment-settings.service.ts
@@ -0,0 +1,71 @@
+import { Injectable, Logger } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { Repository } from "typeorm";
+
+import { ManualPaymentSetting } from "./entities/manual-payment-setting.entity";
+
+/** The two currencies an invoice can be settled by hand in. */
+export type ManualPaymentCurrency = "ETB" | "USD";
+
+/**
+ * Owns the single `manual_payment_settings` row: whether Finance may settle
+ * invoices by hand, per currency.
+ *
+ * Defaults mirror how the platform behaved before the toggles existed — USD
+ * has always been bank-transfer-only so it starts ON; ETB manual settlement is
+ * the new capability and starts OFF, so enabling it is a deliberate act.
+ */
+@Injectable()
+export class ManualPaymentSettingsService {
+  private readonly logger = new Logger(ManualPaymentSettingsService.name);
+
+  constructor(
+    @InjectRepository(ManualPaymentSetting)
+    private readonly repository: Repository<ManualPaymentSetting>,
+  ) {}
+
+  /** The settings row, created at the defaults on first access. */
+  async get(): Promise<ManualPaymentSetting> {
+    const existing = await this.repository.findOne({ where: {} });
+    if (existing) return existing;
+
+    return this.repository.save(
+      this.repository.create({ etbEnabled: false, usdEnabled: true }),
+    );
+  }
+
+  /** Currencies manual settlement is currently allowed for. */
+  async enabledCurrencies(): Promise<ManualPaymentCurrency[]> {
+    const setting = await this.get();
+    const enabled: ManualPaymentCurrency[] = [];
+    if (setting.etbEnabled) enabled.push("ETB");
+    if (setting.usdEnabled) enabled.push("USD");
+    return enabled;
+  }
+
+  /** Whether one currency may be settled by hand right now. */
+  async isEnabled(currency: string | null | undefined): Promise<boolean> {
+    const upper = currency?.toUpperCase();
+    if (upper !== "ETB" && upper !== "USD") return false;
+    const setting = await this.get();
+    return upper === "ETB" ? setting.etbEnabled : setting.usdEnabled;
+  }
+
+  /** Flip either toggle; an omitted field leaves that currency unchanged. */
+  async update(
+    patch: { etbEnabled?: boolean; usdEnabled?: boolean },
+    updatedById?: string | null,
+  ): Promise<ManualPaymentSetting> {
+    const current = await this.get();
+    await this.repository.update(current.id, {
+      ...(patch.etbEnabled === undefined ? {} : { etbEnabled: patch.etbEnabled }),
+      ...(patch.usdEnabled === undefined ? {} : { usdEnabled: patch.usdEnabled }),
+      updatedById: updatedById ?? null,
+    });
+    const updated = await this.get();
+    this.logger.warn(
+      `Manual payment channels set to ETB=${updated.etbEnabled} USD=${updated.usdEnabled} by ${updatedById ?? "unknown user"}`,
+    );
+    return updated;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/payment-settings/payment-settings.module.ts b/apps/edr-freight-api/src/modules/payment-settings/payment-settings.module.ts
new file mode 100644
index 000000000..bcadfe340
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/payment-settings/payment-settings.module.ts
@@ -0,0 +1,20 @@
+import { Global, Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { ManualPaymentSetting } from "./entities/manual-payment-setting.entity";
+import { ManualPaymentSettingsController } from "./manual-payment-settings.controller";
+import { ManualPaymentSettingsService } from "./manual-payment-settings.service";
+
+/**
+ * Global so billing can inject {@link ManualPaymentSettingsService} to gate
+ * the manual-settlement worklist and confirmation endpoint without importing
+ * this module (and without a cycle, since this module needs nothing back).
+ */
+@Global()
+@Module({
+  imports: [TypeOrmModule.forFeature([ManualPaymentSetting])],
+  controllers: [ManualPaymentSettingsController],
+  providers: [ManualPaymentSettingsService],
+  exports: [ManualPaymentSettingsService],
+})
+export class PaymentSettingsModule {}
diff --git a/apps/edr-freight-api/src/modules/payment/payment-client.service.ts b/apps/edr-freight-api/src/modules/payment/payment-client.service.ts
index 26a0cf5ed..de220fd59 100644
--- a/apps/edr-freight-api/src/modules/payment/payment-client.service.ts
+++ b/apps/edr-freight-api/src/modules/payment/payment-client.service.ts
@@ -7,6 +7,7 @@ import {
 import { HttpService } from "@nestjs/axios";
 import { AxiosError } from "axios";
 import { firstValueFrom } from "rxjs";
+import { logCtx } from "@edr/api-common";
 import {
   InitiatePaymentRequest,
   PaymentIntentSnapshot,
@@ -111,6 +112,16 @@ export class PaymentClientService {
     body?: unknown,
   ): Promise<T> {
     const url = `${this.baseUrl}${path}`;
+    // Every hop to the payment service lands on the request log line: which
+    // call, how slow, and what it answered. A settle that never happened is
+    // almost always one of these coming back 4xx/5xx or timing out.
+    const startedAt = Date.now();
+    const trace = (extra: Record<string, unknown>) =>
+      logCtx(
+        { method, path, ms: Date.now() - startedAt, ...extra },
+        { path: "outbound.payment", mode: "push" },
+      );
+
     try {
       const response = await firstValueFrom(
         this.http.request<T>({
@@ -122,9 +133,11 @@ export class PaymentClientService {
             : {},
         }),
       );
+      trace({ status: response.status });
       return response.data;
     } catch (err) {
       if (err instanceof AxiosError && err.response) {
+        trace({ status: err.response.status });
         if (err.response.status === 404) throw err;
         const detail =
           (err.response.data as { message?: string | string[] })?.message ??
@@ -136,6 +149,7 @@ export class PaymentClientService {
       }
       const message =
         err instanceof Error && err.message ? err.message : String(err);
+      trace({ unreachable: true, error: message });
       this.logger.error(
         `payment service unreachable (${method} ${path}): ${message}`,
       );
diff --git a/apps/edr-freight-api/src/modules/payment/payment-events.consumer.ts b/apps/edr-freight-api/src/modules/payment/payment-events.consumer.ts
index e285c181c..91237223c 100644
--- a/apps/edr-freight-api/src/modules/payment/payment-events.consumer.ts
+++ b/apps/edr-freight-api/src/modules/payment/payment-events.consumer.ts
@@ -1,4 +1,4 @@
-import { Injectable, Logger, SetMetadata } from "@nestjs/common";
+import { Injectable, Logger } from "@nestjs/common";
 import { Nack, RabbitSubscribe } from "@golevelup/nestjs-rabbitmq";
 import { Public } from "@edr/api-common";
 import {
@@ -14,11 +14,6 @@ import { PaymentService as PaymentSvc } from "./payment.service";
 
 const FREIGHT_QUEUE = PAYMENT_QUEUES[PaymentService.FREIGHT];
 
-// @tria-plc/auditlog's global ClientLoggerInterceptor (present in deployed builds)
-// crashes on non-HTTP contexts (`originalUrl.split` on a RabbitMQ message) and the
-// resulting requeue storm blocks payment.succeeded forever. Its IgnoreLoggerAudit
-// decorator is just this metadata key — set it directly so we don't need the package.
-@SetMetadata("ignoreAuditLogger", true)
 @Injectable()
 export class PaymentEventsConsumer {
     private readonly logger = new Logger(PaymentEventsConsumer.name);
diff --git a/apps/edr-freight-api/src/modules/payment/payment.service.spec.ts b/apps/edr-freight-api/src/modules/payment/payment.service.spec.ts
index aca224c07..5be987935 100644
--- a/apps/edr-freight-api/src/modules/payment/payment.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/payment/payment.service.spec.ts
@@ -49,6 +49,7 @@ describe("PaymentService.confirmOtp", () => {
       repo as never,
       client as never,
       billing as never,
+      {} as never,
     );
     return { service, repo, billing };
   };
@@ -197,6 +198,7 @@ describe("PaymentService.markIntentSucceeded", () => {
       repo as never,
       {} as never,
       billing as never,
+      {} as never,
     );
     return { service, repo, billing };
   };
diff --git a/apps/edr-freight-api/src/modules/payment/payment.service.ts b/apps/edr-freight-api/src/modules/payment/payment.service.ts
index 316f3e8fe..168fa3df4 100644
--- a/apps/edr-freight-api/src/modules/payment/payment.service.ts
+++ b/apps/edr-freight-api/src/modules/payment/payment.service.ts
@@ -7,11 +7,13 @@ import {
   Logger,
   NotFoundException,
 } from "@nestjs/common";
+import { logCtx } from "@edr/api-common";
 import { applyBookingRefDirectionScope } from "../user-trade-access/trade-scope.util";
 import { PaymentEntity } from "./entities/payment.entity";
 import { PaymentRepository } from "./payment.repository";
 import { PaymentClientService } from "./payment-client.service";
 import { BillingService } from "../billing/billing.service";
+import { LogoSettingsService } from "../logo-settings/logo-settings.service";
 
 import * as fs from "fs";
 import * as path from "path";
@@ -29,6 +31,7 @@ import {
   IntentStatusDto,
   PaymentPlatformDto,
 } from "./payments.dto";
+import { isBypassEnv } from "../../common/dev-bypass.util";
 
 /** Everything the gateway needs to open an intent. Amount/currency are supplied by
  *  the caller (billing) — this service never derives them from a domain record. */
@@ -103,6 +106,7 @@ export class PaymentService {
     private readonly paymentClient: PaymentClientService,
     @Inject(forwardRef(() => BillingService))
     private readonly billing: BillingService,
+    private readonly logoSettings: LogoSettingsService,
   ) { }
 
   async getAll(filters: {
@@ -214,8 +218,16 @@ export class PaymentService {
         PaymentReferenceType.SHIPMENT,
         referenceId,
       );
+      logCtx(
+        { referenceId, paid: result.paid, unverifiable: result.unverifiable },
+        { path: "payment.reconcile" },
+      );
       return { paid: result.paid, unverifiable: result.unverifiable };
     } catch (err) {
+      logCtx(
+        { referenceId, unverifiable: true, error: (err as Error).message },
+        { path: "payment.reconcile" },
+      );
       this.logger.warn(
         `Reconcile for shipment ${referenceId} failed: ${(err as Error).message}`,
       );
@@ -224,6 +236,18 @@ export class PaymentService {
   }
 
   async initiate(input: InitiateIntentInput): Promise<InitiateIntentResult> {
+    logCtx(
+      {
+        referenceId: input.referenceId,
+        source: input.source,
+        orderRef: input.orderRef,
+        method: input.method,
+        amountMinor: input.amountMinor,
+        currency: input.currency,
+        platform: input.platform,
+      },
+      { path: "payment.initiate" },
+    );
     try {
       const isCbeBill = input.method === ProviderMethod.CBE_BILL;
       // CBE settles ETB only (docs/cbe/CBE_IMPLEMENTATION_PLAN.md D8).
@@ -233,34 +257,52 @@ export class PaymentService {
         );
       }
 
-      const snapshot = await this.paymentClient.initiate({
-        service: PaymentServiceEnum.FREIGHT,
-        referenceType: PaymentReferenceType.SHIPMENT,
-        referenceId: input.referenceId,
-        orderRef: input.orderRef,
-        // CBE_BILL must carry the REAL amount: /cbe/payment verifies what the customer was
-        // debited against the intent amount, so the dev shortcut would break it.
-        // CAC bank rejects amounts below 10 (DJF bounds 10–100,000), so its dev
-        // shortcut floor is 10, not 1.
-        // amountMinor: isCbeBill
-        //   ? input.amountMinor
-        //   : input.method === ProviderMethod.CAC_BANK
-        //     ? 10
-        //     : 1,
-        amountMinor: input.amountMinor,
-        currency: input.currency,
-        provider: input.method as ProviderMethod,
-        platform: input.platform,
-        payerAccount: input.payerAccount,
-        payerName: input.payerName,
-        expiresAt: input.expiresAt,
-        // bookingId lets the success page ack the redirect (→ PAYMENT_PROCESSING).
-        returnUrl:
-          input.returnUrl ??
-          `https://edrfreight.triaplc.com/payment/success?bookingId=${encodeURIComponent(input.referenceId)}`,
-        failureUrl:
-          input.failureUrl ?? "https://edrfreight.triaplc.com/payment/failure",
-      });
+      // Dev/staging only: skip the real gateway call entirely and report an
+      // immediate SUCCEEDED snapshot — everything below (upsert, settle,
+      // billing notify) runs exactly as it would for a real synchronous
+      // provider success.
+      const snapshot: PaymentIntentSnapshot = isBypassEnv()
+        ? {
+            intentId: `bypass-${input.referenceId}`,
+            service: PaymentServiceEnum.FREIGHT,
+            referenceType: PaymentReferenceType.SHIPMENT,
+            referenceId: input.referenceId,
+            merchantOrderId: input.orderRef,
+            provider: input.method as ProviderMethod,
+            status: ProviderPaymentStatus.SUCCEEDED,
+            amountMinor: input.amountMinor,
+            currency: input.currency,
+            providerTxnId: `bypass-${input.referenceId}`,
+            paidAt: new Date().toISOString(),
+          }
+        : await this.paymentClient.initiate({
+            service: PaymentServiceEnum.FREIGHT,
+            referenceType: PaymentReferenceType.SHIPMENT,
+            referenceId: input.referenceId,
+            orderRef: input.orderRef,
+            // CBE_BILL must carry the REAL amount: /cbe/payment verifies what the customer was
+            // debited against the intent amount, so the dev shortcut would break it.
+            // CAC bank rejects amounts below 10 (DJF bounds 10–100,000), so its dev
+            // shortcut floor is 10, not 1.
+            // amountMinor: isCbeBill
+            //   ? input.amountMinor
+            //   : input.method === ProviderMethod.CAC_BANK
+            //     ? 10
+            //     : 1,
+            amountMinor: input.amountMinor,
+            currency: input.currency,
+            provider: input.method as ProviderMethod,
+            platform: input.platform,
+            payerAccount: input.payerAccount,
+            payerName: input.payerName,
+            expiresAt: input.expiresAt,
+            // bookingId lets the success page ack the redirect (→ PAYMENT_PROCESSING).
+            returnUrl:
+              input.returnUrl ??
+              `https://edrfreight.triaplc.com/payment/success?bookingId=${encodeURIComponent(input.referenceId)}`,
+            failureUrl:
+              input.failureUrl ?? "https://edrfreight.triaplc.com/payment/failure",
+          });
 
       const immediateSuccess =
         snapshot.status === ProviderPaymentStatus.SUCCEEDED;
@@ -268,6 +310,17 @@ export class PaymentService {
 
       const intent = await this.upsertIntent(input, snapshot);
 
+      logCtx(
+        {
+          intentId: intent.id,
+          providerStatus: snapshot.status,
+          providerTxnId: snapshot.providerTxnId,
+          merchantOrderId: snapshot.merchantOrderId,
+          immediateSuccess,
+        },
+        { path: "payment.initiate" },
+      );
+
       if (immediateSuccess) {
         // Settle the projection but DO NOT notify billing — billing settles
         // inline once it has stored intentId on the invoice (see payInvoice),
@@ -428,6 +481,17 @@ export class PaymentService {
       otp,
     );
 
+    logCtx(
+      {
+        intentId: local.id,
+        refId: local.refId,
+        gatewayIntentId: snapshot.intentId,
+        providerStatus: confirmed.status,
+        failureCode: confirmed.failureCode,
+      },
+      { path: "payment.confirmOtp" },
+    );
+
     if (confirmed.status === ProviderPaymentStatus.SUCCEEDED) {
       await this.markIntentSucceeded(local.id, {
         providerTxnId: confirmed.providerTxnId,
@@ -460,6 +524,16 @@ export class PaymentService {
   ): Promise<{ alreadyFinalized: boolean }> {
     const intent = await this.paymentRepo.findOneBy({ id: intentId });
     if (!intent) throw new NotFoundException("PaymentIntent not found");
+    logCtx(
+      {
+        intentId,
+        refId: intent.refId,
+        priorStatus: intent.status,
+        providerTxnId: opts.providerTxnId,
+        notifyBilling: opts.notify !== false,
+      },
+      { path: "payment.settle" },
+    );
     if (intent.status === "success") {
       // Still notify billing: a prior delivery may have flipped the intent to
       // success and then died before the invoice settled (the two steps are not
@@ -471,6 +545,7 @@ export class PaymentService {
           opts.paidAt ?? intent.paidAt ?? undefined,
         );
       }
+      logCtx(true, { path: "payment.settle.alreadyFinalized", mode: "set" });
       return { alreadyFinalized: true };
     }
 
@@ -507,6 +582,15 @@ export class PaymentService {
     referenceId: string,
   ): Promise<{ acknowledged: boolean }> {
     const intent = await this.paymentRepo.findOneBy({ refId: referenceId });
+    logCtx(
+      {
+        referenceId,
+        intentId: intent?.id,
+        intentStatus: intent?.status ?? "none",
+        method: intent?.method,
+      },
+      { path: "payment.successRedirect" },
+    );
     if (!intent || intent.method === "cbe-bill") {
       return { acknowledged: false };
     }
@@ -533,6 +617,16 @@ export class PaymentService {
   }): Promise<void> {
     const intent = await this.paymentRepo.findOneBy({ id: input.intentId });
     if (!intent) throw new NotFoundException("PaymentIntent not found");
+    logCtx(
+      {
+        intentId: intent.id,
+        refId: intent.refId,
+        priorStatus: intent.status,
+        failureCode: input.failureCode,
+        failureMessage: input.failureMessage,
+      },
+      { path: "payment.failed" },
+    );
     if (intent.status === "success" || intent.status === "canceled") return;
 
     await this.paymentRepo.update(
@@ -584,6 +678,7 @@ export class PaymentService {
       total: payment.amount.toString(),
       currency: payment.currency,
       reason: payment.reason,
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
     });
   }
 
diff --git a/apps/edr-freight-api/src/modules/payment/payments.dto.ts b/apps/edr-freight-api/src/modules/payment/payments.dto.ts
index 255da0ea2..92ff7dc38 100644
--- a/apps/edr-freight-api/src/modules/payment/payments.dto.ts
+++ b/apps/edr-freight-api/src/modules/payment/payments.dto.ts
@@ -60,14 +60,40 @@ export class RefundDto {
 }
 
 export class ClientActionDto {
+  // INVOKE_BRIDGE (SuperApp mini-app payload) is part of the shared ClientAction union and so
+  // must be assignable here, but freight never requests platform=inapp and therefore never
+  // receives one. Passenger owns that flow — see docs/telebirr-miniapp/.
   @ApiProperty({
-    enum: ["REDIRECT", "LAUNCH_APP", "COLLECT_OTP", "SHOW_BILL_REFERENCE"],
+    enum: [
+      "REDIRECT",
+      "LAUNCH_APP",
+      "INVOKE_BRIDGE",
+      "COLLECT_OTP",
+      "AWAIT_PUSH",
+      "SHOW_BILL_REFERENCE",
+    ],
   })
-  type!: "REDIRECT" | "LAUNCH_APP" | "COLLECT_OTP" | "SHOW_BILL_REFERENCE";
+  type!:
+    | "REDIRECT"
+    | "LAUNCH_APP"
+    | "INVOKE_BRIDGE"
+    | "COLLECT_OTP"
+    | "AWAIT_PUSH"
+    | "SHOW_BILL_REFERENCE";
 
   @ApiPropertyOptional({ description: "Set when type=REDIRECT (web flow)" })
   url?: string;
 
+  @ApiPropertyOptional({
+    description: "Set when type=INVOKE_BRIDGE (SuperApp mini app) — not used by freight",
+  })
+  bridge?: "TELEBIRR";
+
+  @ApiPropertyOptional({
+    description: "Set when type=INVOKE_BRIDGE (SuperApp mini app) — not used by freight",
+  })
+  rawRequest?: string;
+
   @ApiPropertyOptional({ description: "Set when type=LAUNCH_APP (mobile flow)" })
   appId?: string;
 
@@ -80,9 +106,16 @@ export class ClientActionDto {
   @ApiPropertyOptional({ description: "Set when type=COLLECT_OTP (e.g. CAC Bank)" })
   providerOrderId?: string;
 
-  @ApiPropertyOptional({ description: "Set when type=COLLECT_OTP" })
+  @ApiPropertyOptional({
+    description: "Set when type=COLLECT_OTP or type=AWAIT_PUSH",
+  })
   message?: string;
 
+  @ApiPropertyOptional({
+    description: "Set when type=AWAIT_PUSH (masked MSISDN the push prompt went to)",
+  })
+  payerAccountMasked?: string;
+
   @ApiPropertyOptional({
     description: "Set when type=SHOW_BILL_REFERENCE (CBE bill payment)",
   })
diff --git a/apps/edr-freight-api/src/modules/payment/templates/receipt.hbs b/apps/edr-freight-api/src/modules/payment/templates/receipt.hbs
index 0f156f6dc..067e2d0ba 100644
--- a/apps/edr-freight-api/src/modules/payment/templates/receipt.hbs
+++ b/apps/edr-freight-api/src/modules/payment/templates/receipt.hbs
@@ -45,6 +45,14 @@
             margin: 0;
         }
 
+        .header .doc-logo {
+            display: block;
+            margin: 0 auto 10px;
+            max-height: 48px;
+            max-width: 180px;
+            object-fit: contain;
+        }
+
         .details-table {
             width: 100%;
             border-collapse: collapse;
@@ -126,6 +134,7 @@
 <body>
     <div class="receipt-box">
         <div class="header">
+            {{#if logoImageUrl}}<img class="doc-logo" src="{{logoImageUrl}}" alt="Company logo" />{{/if}}
             <h1>{{vendorName}}</h1>
             <p>{{vendorAddress}}</p>
         </div>
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/aging-receivables.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/aging-receivables.report.ts
new file mode 100644
index 000000000..d5709508c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/aging-receivables.report.ts
@@ -0,0 +1,87 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Company } from '../../companies/entities/company.entity';
+import { Invoice } from '../../billing/entities/invoice.entity';
+import { applyBookingRefDirectionScope } from '../../user-trade-access/trade-scope.util';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const OPEN_STATUSES = ['ISSUED', 'PENDING', 'PARTIALLY_PAID', 'OVERDUE'];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  // "As of" — invoices due after this instant aren't overdue yet. Defaults
+  // to now() in SQL when the filter is unset (see the COALESCE below).
+  const asOf = (params.asOf as string | null) ?? null;
+
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Invoice, 'i')
+    .innerJoin(Company, 'c', 'c.id = i.company_id')
+    .where('i.deleted_at IS NULL')
+    .andWhere('i.status IN (:...openStatuses)', { openStatuses: OPEN_STATUSES })
+    .andWhere('i.balance_amount > 0')
+    .setParameter('asOf', asOf);
+
+  // ACL: invoices.source_id is a varchar pointer at the originating booking.
+  // Rows not pointing at a booking (e.g. warehouse fee invoices) stay visible.
+  return applyBookingRefDirectionScope(qb, 'i.source_id', directions);
+}
+
+export const agingReceivablesReport: ReportDefinition = {
+  key: 'aging-receivables',
+  title: 'Aging Receivables',
+  description: 'Outstanding customer balances bucketed by days overdue',
+  group: 'Finance',
+  filters: [{ key: 'asOf', label: 'As of', type: 'date' }],
+  columns: [
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'invoices', label: 'Invoices', type: 'number' },
+    { key: 'outstanding', label: 'Outstanding', type: 'money', sortable: true },
+    { key: 'current', label: 'Current', type: 'money' },
+    { key: 'overdue0to30', label: '0-30d', type: 'money' },
+    { key: 'overdue31to60', label: '31-60d', type: 'money' },
+    { key: 'overdue61to90', label: '61-90d', type: 'money' },
+    { key: 'overdue90plus', label: '90d+', type: 'money' },
+  ],
+  defaultSort: { key: 'outstanding', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('c.name', 'customer')
+      .addSelect('COUNT(*)::int', 'invoices')
+      .addSelect('ROUND(SUM(i.balance_amount))::float8', 'outstanding')
+      .addSelect(
+        `ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at >= COALESCE(:asOf::timestamptz, now())), 0))::float8`,
+        'current',
+      )
+      .addSelect(
+        `ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE(:asOf::timestamptz, now())
+          AND i.due_at >= COALESCE(:asOf::timestamptz, now()) - interval '30 days'), 0))::float8`,
+        'overdue0to30',
+      )
+      .addSelect(
+        `ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE(:asOf::timestamptz, now()) - interval '30 days'
+          AND i.due_at >= COALESCE(:asOf::timestamptz, now()) - interval '60 days'), 0))::float8`,
+        'overdue31to60',
+      )
+      .addSelect(
+        `ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE(:asOf::timestamptz, now()) - interval '60 days'
+          AND i.due_at >= COALESCE(:asOf::timestamptz, now()) - interval '90 days'), 0))::float8`,
+        'overdue61to90',
+      )
+      .addSelect(
+        `ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE(:asOf::timestamptz, now()) - interval '90 days'), 0))::float8`,
+        'overdue90plus',
+      )
+      .groupBy('c.name');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('ROUND(COALESCE(SUM(i.balance_amount), 0))::float8', 'outstanding')
+      .addSelect('COUNT(DISTINCT c.id)::int', 'customers')
+      .getRawOne();
+    return [
+      { label: 'Outstanding', value: Number(row?.outstanding ?? 0), unit: 'ETB' },
+      { label: 'Customers with balance', value: Number(row?.customers ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/booking-status-breakdown.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/booking-status-breakdown.report.ts
new file mode 100644
index 000000000..449c47181
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/booking-status-breakdown.report.ts
@@ -0,0 +1,109 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { BookingStatus } from '@edr/types';
+import { Booking } from '../../bookings/entities/booking.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { CargoType } from '../../rule-engine/entities/cargo-type.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// One resolver behind "Booking per status, per port/train/date/cargo/contract
+// type" — the same breakdown Operation, Marketing, Global Logistics and the
+// Operation Report each ask for verbatim. Embed once, reuse everywhere.
+const TONS = 'COALESCE(b.bulk_total_weight_tons, b.cargo_total_weight_vgm)';
+const REVENUE = 'COALESCE(b.adjusted_total_amount, b.total_amount)';
+
+const STATUS_OPTIONS = [...new Set(Object.values(BookingStatus))].map((v) => ({
+  value: v,
+  label: v.replace(/_/g, ' '),
+}));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Booking, 'b')
+    .leftJoin(Yard, 'o', 'o.id = b.origin_yard_id')
+    .leftJoin(CargoType, 'cty', 'cty.id = b.cargo_type_id')
+    .where('b.deleted_at IS NULL');
+
+  if (params.dateFrom) qb.andWhere('b.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('b.created_at < :dateTo', { dateTo: params.dateTo });
+  if (params.direction) qb.andWhere('b.trade_direction = :direction', { direction: params.direction });
+  if (params.freightType) qb.andWhere('b.freight_type = :freightType', { freightType: params.freightType });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('b.status IN (:...statuses)', { statuses });
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'b.trade_direction IN (:...directions)' : '1 = 0', { directions });
+  }
+  return qb;
+}
+
+export const bookingStatusBreakdownReport: ReportDefinition = {
+  key: 'booking-status-breakdown',
+  title: 'Bookings by Status',
+  description: 'Booking counts by status, direction, origin station, cargo and contract type',
+  group: 'Commercial',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+    {
+      key: 'freightType',
+      label: 'Freight type',
+      type: 'select',
+      options: [
+        { value: 'CONTAINER', label: 'Container' },
+        { value: 'BULK', label: 'Bulk' },
+      ],
+    },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'b.status' },
+    { key: 'direction', label: 'Direction', type: 'string', sortable: true, sortExpr: 'b.trade_direction' },
+    { key: 'originStation', label: 'Origin', type: 'string', sortable: true },
+    { key: 'cargoType', label: 'Cargo type', type: 'string', sortable: true },
+    { key: 'contractKind', label: 'Contract type', type: 'string', sortable: true },
+    { key: 'bookings', label: 'Bookings', type: 'number', sortable: true },
+    { key: 'tons', label: 'Tonnage', type: 'tons', sortable: true },
+    { key: 'amount', label: 'Amount', type: 'money', sortable: true },
+  ],
+  defaultSort: { key: 'bookings', dir: 'DESC' },
+  chart: { type: 'bar', x: 'status', y: ['bookings'] },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('b.status', 'status')
+      .addSelect('b.trade_direction', 'direction')
+      .addSelect("COALESCE(o.label, 'Unknown')", 'originStation')
+      .addSelect("COALESCE(cty.cargo_type_name, 'Other')", 'cargoType')
+      .addSelect("COALESCE(b.contract_kind, 'SPOT')", 'contractKind')
+      .addSelect('COUNT(*)::int', 'bookings')
+      .addSelect(`ROUND(COALESCE(SUM(${TONS}), 0))::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'amount')
+      .groupBy('b.status')
+      .addGroupBy('b.trade_direction')
+      .addGroupBy('o.label')
+      .addGroupBy('cty.cargo_type_name')
+      .addGroupBy('b.contract_kind');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'bookings')
+      .addSelect(`ROUND(COALESCE(SUM(${TONS}), 0))::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'amount')
+      .getRawOne();
+    return [
+      { label: 'Bookings', value: Number(row?.bookings ?? 0) },
+      { label: 'Tonnage', value: Number(row?.tons ?? 0), unit: 't' },
+      { label: 'Amount', value: Number(row?.amount ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/bookings-list.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/bookings-list.report.ts
new file mode 100644
index 000000000..ca476cea3
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/bookings-list.report.ts
@@ -0,0 +1,129 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Booking } from '../../bookings/entities/booking.entity';
+import { CargoType } from '../../rule-engine/entities/cargo-type.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { Company } from '../../companies/entities/company.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// For PER_ITEM bulk bookings cargo_total_weight_vgm holds an item COUNT, and
+// the real tonnage lives in bulk_total_weight_tons — hence the COALESCE order
+// (same guard as the retired report-queries.ts).
+const TONS = 'COALESCE(b.bulk_total_weight_tons, b.cargo_total_weight_vgm)';
+// adjusted_total_amount silently overrides total_amount when set.
+const REVENUE = 'COALESCE(b.adjusted_total_amount, b.total_amount)';
+// GENERAL contract_kind rows are umbrella contracts, not shipments; counting
+// them double-counts every child booking.
+const NOT_UMBRELLA = "(b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')";
+const DEAD_STATUSES = ['DRAFT', 'CANCELLED', 'REJECTED', 'EXPIRED'];
+
+function applyFilters(
+  ctx: ReportContext,
+  qb: SelectQueryBuilder<ObjectLiteral>,
+): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  qb.where(`b.deleted_at IS NULL AND ${NOT_UMBRELLA}`);
+  if (params.dateFrom) qb.andWhere('b.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('b.created_at < :dateTo', { dateTo: params.dateTo });
+  if (params.direction) qb.andWhere('b.trade_direction = :direction', { direction: params.direction });
+  if (params.freightType) qb.andWhere('b.freight_type = :freightType', { freightType: params.freightType });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) {
+    qb.andWhere('b.status IN (:...statuses)', { statuses });
+  } else {
+    qb.andWhere('b.status NOT IN (:...deadStatuses)', { deadStatuses: DEAD_STATUSES });
+  }
+  if (params.search) {
+    qb.andWhere('(b.reference ILIKE :search OR c.name ILIKE :search)', {
+      search: `%${params.search}%`,
+    });
+  }
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'b.trade_direction IN (:...directions)' : '1 = 0', {
+      directions,
+    });
+  }
+  return qb;
+}
+
+export const bookingsListReport: ReportDefinition = {
+  key: 'bookings-list',
+  title: 'Bookings',
+  description: 'Every booking with customer, route, cargo and revenue',
+  group: 'Commercial',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+    {
+      key: 'freightType',
+      label: 'Freight type',
+      type: 'select',
+      options: [
+        { value: 'CONTAINER', label: 'Container' },
+        { value: 'BULK', label: 'Bulk' },
+      ],
+    },
+    { key: 'statuses', label: 'Status', type: 'multiselect' },
+    { key: 'search', label: 'Search reference or customer', type: 'text' },
+  ],
+  columns: [
+    { key: 'reference', label: 'Reference', type: 'string', sortable: true, sortExpr: 'b.reference' },
+    { key: 'created', label: 'Created', type: 'date', sortable: true, sortExpr: 'b.created_at' },
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'b.status' },
+    { key: 'direction', label: 'Direction', type: 'string' },
+    { key: 'origin', label: 'Origin', type: 'string' },
+    { key: 'destination', label: 'Destination', type: 'string' },
+    { key: 'cargo', label: 'Cargo', type: 'string' },
+    { key: 'tons', label: 'Tonnage', type: 'tons', sortable: true },
+    { key: 'amount', label: 'Amount', type: 'money', sortable: true },
+  ],
+  defaultSort: { key: 'created', dir: 'DESC' },
+  query(ctx) {
+    const qb = ctx.ds
+      .createQueryBuilder()
+      .select('b.reference', 'reference')
+      .addSelect(`to_char(b.created_at, 'YYYY-MM-DD')`, 'created')
+      .addSelect('c.name', 'customer')
+      .addSelect('b.status', 'status')
+      .addSelect('b.trade_direction', 'direction')
+      .addSelect('o.label', 'origin')
+      .addSelect('d.label', 'destination')
+      .addSelect('COALESCE(cty.cargo_type_name, b.cargo_free_text)', 'cargo')
+      .addSelect(`ROUND(${TONS})::float8`, 'tons')
+      .addSelect(`ROUND(${REVENUE})::float8`, 'amount')
+      .from(Booking, 'b')
+      .innerJoin(Company, 'c', 'c.id = b.company_id')
+      .innerJoin(Yard, 'o', 'o.id = b.origin_yard_id')
+      .innerJoin(Yard, 'd', 'd.id = b.destination_yard_id')
+      .leftJoin(CargoType, 'cty', 'cty.id = b.cargo_type_id');
+    return applyFilters(ctx, qb);
+  },
+  async summary(ctx) {
+    const qb = applyFilters(
+      ctx,
+      ctx.ds
+        .createQueryBuilder()
+        .select('COUNT(*)::int', 'bookings')
+        .addSelect(`ROUND(COALESCE(SUM(${TONS}), 0))::float8`, 'tons')
+        .addSelect(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'revenue')
+        .from(Booking, 'b')
+        .innerJoin(Company, 'c', 'c.id = b.company_id'),
+    );
+    const row = await qb.getRawOne();
+    return [
+      { label: 'Bookings', value: Number(row?.bookings ?? 0) },
+      { label: 'Tonnage', value: Number(row?.tons ?? 0), unit: 't' },
+      { label: 'Revenue', value: Number(row?.revenue ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/cargo-summary.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/cargo-summary.report.ts
new file mode 100644
index 000000000..ee3063ee1
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/cargo-summary.report.ts
@@ -0,0 +1,58 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Booking } from '../../bookings/entities/booking.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const TONS = 'COALESCE(b.bulk_total_weight_tons, b.cargo_total_weight_vgm)';
+const NOT_UMBRELLA = "(b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')";
+const DEAD_STATUSES = ['DRAFT', 'CANCELLED', 'REJECTED', 'EXPIRED'];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Booking, 'b')
+    .where(`b.deleted_at IS NULL AND ${NOT_UMBRELLA}`)
+    .andWhere('b.status NOT IN (:...deadStatuses)', { deadStatuses: DEAD_STATUSES });
+
+  if (params.dateFrom) qb.andWhere('b.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('b.created_at < :dateTo', { dateTo: params.dateTo });
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'b.trade_direction IN (:...directions)' : '1 = 0', { directions });
+  }
+  return qb;
+}
+
+export const cargoSummaryReport: ReportDefinition = {
+  key: 'cargo-summary',
+  title: 'Cargo Summary',
+  description: 'Cargo tonnage by direction and cargo type',
+  group: 'Operations',
+  filters: [{ key: 'date', label: 'Created', type: 'daterange' }],
+  columns: [
+    { key: 'direction', label: 'Direction', type: 'string', sortable: true },
+    { key: 'freightType', label: 'Cargo type', type: 'string', sortable: true },
+    { key: 'bookings', label: 'Bookings', type: 'number', sortable: true },
+    { key: 'tons', label: 'Tonnage', type: 'tons', sortable: true },
+  ],
+  defaultSort: { key: 'tons', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('b.trade_direction', 'direction')
+      .addSelect('b.freight_type', 'freightType')
+      .addSelect('COUNT(*)::int', 'bookings')
+      .addSelect(`ROUND(COALESCE(SUM(${TONS}), 0))::float8`, 'tons')
+      .groupBy('b.trade_direction')
+      .addGroupBy('b.freight_type');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(`ROUND(COALESCE(SUM(${TONS}), 0))::float8`, 'tons')
+      .addSelect('COUNT(*)::int', 'bookings')
+      .getRawOne();
+    return [
+      { label: 'Bookings', value: Number(row?.bookings ?? 0) },
+      { label: 'Total tonnage', value: Number(row?.tons ?? 0), unit: 't' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/contract-lifecycle.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/contract-lifecycle.report.ts
new file mode 100644
index 000000000..513abeda4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/contract-lifecycle.report.ts
@@ -0,0 +1,83 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Contract, CONTRACT_KINDS, CONTRACT_STATUSES } from '../../contracts/entities/contract.entity';
+import { Company } from '../../companies/entities/company.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Contract, 'ct')
+    .leftJoin(Company, 'c', 'c.id = ct.company_id')
+    .where('ct.deleted_at IS NULL');
+
+  if (params.dateFrom) qb.andWhere('ct.contract_valid_from >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('ct.contract_valid_from < :dateTo', { dateTo: params.dateTo });
+  if (params.kind) qb.andWhere('ct.contract_kind = :kind', { kind: params.kind });
+  if (params.direction) qb.andWhere('ct.trade_direction = :direction', { direction: params.direction });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('ct.status IN (:...statuses)', { statuses });
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'ct.trade_direction IN (:...directions)' : '1 = 0', { directions });
+  }
+  return qb;
+}
+
+export const contractLifecycleReport: ReportDefinition = {
+  key: 'contract-lifecycle',
+  title: 'Contracts',
+  description: 'Signed, active and cancelled contracts',
+  group: 'Commercial',
+  filters: [
+    { key: 'date', label: 'Valid from', type: 'daterange' },
+    { key: 'kind', label: 'Kind', type: 'select', options: CONTRACT_KINDS.map((v) => ({ value: v, label: v })) },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: CONTRACT_STATUSES.map((v) => ({ value: v, label: v.replace(/_/g, ' ') })) },
+  ],
+  columns: [
+    { key: 'reference', label: 'Reference', type: 'string', sortable: true, sortExpr: 'ct.reference' },
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'kind', label: 'Kind', type: 'string' },
+    { key: 'direction', label: 'Direction', type: 'string' },
+    { key: 'freightType', label: 'Freight type', type: 'string' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'ct.status' },
+    { key: 'validFrom', label: 'Valid from', type: 'date', sortable: true, sortExpr: 'ct.contract_valid_from' },
+    { key: 'validUntil', label: 'Valid until', type: 'date' },
+    { key: 'signedAt', label: 'Signed', type: 'date' },
+  ],
+  defaultSort: { key: 'validFrom', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('ct.reference', 'reference')
+      .addSelect("COALESCE(c.name, ct.government_institution, 'Unknown')", 'customer')
+      .addSelect('ct.contract_kind', 'kind')
+      .addSelect('ct.trade_direction', 'direction')
+      .addSelect('ct.freight_type', 'freightType')
+      .addSelect('ct.status', 'status')
+      .addSelect(`to_char(ct.contract_valid_from, 'YYYY-MM-DD')`, 'validFrom')
+      .addSelect(`to_char(ct.contract_valid_until, 'YYYY-MM-DD')`, 'validUntil')
+      .addSelect(`to_char(ct.fully_executed_at, 'YYYY-MM-DD')`, 'signedAt');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect('COUNT(*) FILTER (WHERE ct.fully_executed_at IS NOT NULL)::int', 'signed')
+      .addSelect("COUNT(*) FILTER (WHERE ct.status = 'CANCELLED')::int", 'cancelled')
+      .getRawOne();
+    return [
+      { label: 'Contracts', value: Number(row?.total ?? 0) },
+      { label: 'Signed', value: Number(row?.signed ?? 0) },
+      { label: 'Cancelled', value: Number(row?.cancelled ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/contract-utilization.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/contract-utilization.report.ts
new file mode 100644
index 000000000..03f98d306
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/contract-utilization.report.ts
@@ -0,0 +1,121 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Company } from '../../companies/entities/company.entity';
+import { Contract } from '../../contracts/entities/contract.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const TONS = 'COALESCE(b.bulk_total_weight_tons, b.cargo_total_weight_vgm)';
+const DEAD_STATUSES = ['DRAFT', 'CANCELLED', 'REJECTED', 'EXPIRED'];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Contract, 'ct')
+    .leftJoin(Company, 'c', 'c.id = ct.company_id')
+    .leftJoin(
+      (sub) =>
+        sub
+          .select('s.contract_id', 'contract_id')
+          .addSelect('COALESCE(SUM(s.quantity_cap), 0)', 'committed')
+          .from('freight.contract_cargo_scope', 's')
+          .where('s.deleted_at IS NULL')
+          .groupBy('s.contract_id'),
+      'cap',
+      'cap.contract_id = ct.id',
+    )
+    .leftJoin(
+      (sub) =>
+        sub
+          .select('b.contract_id', 'contract_id')
+          .addSelect(`COALESCE(SUM(${TONS}), 0)`, 'tons')
+          .addSelect('COUNT(*)::int', 'cnt')
+          .from('freight.bookings', 'b')
+          .where('b.deleted_at IS NULL')
+          .andWhere('b.status NOT IN (:...deadStatuses)', { deadStatuses: DEAD_STATUSES })
+          .groupBy('b.contract_id'),
+      'booked',
+      'booked.contract_id = ct.id',
+    )
+    .where('ct.deleted_at IS NULL')
+    .andWhere("ct.status <> 'DRAFT'");
+
+  if (params.dateFrom) {
+    qb.andWhere(
+      "(ct.contract_valid_until IS NULL OR ct.contract_valid_until >= :dateFrom::timestamptz)",
+      { dateFrom: params.dateFrom },
+    );
+  }
+  if (params.dateTo) {
+    qb.andWhere('ct.contract_valid_from < :dateTo::timestamptz', { dateTo: params.dateTo });
+  }
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('ct.status IN (:...statuses)', { statuses });
+  if (params.contractId) {
+    qb.andWhere('ct.id = :contractId', { contractId: params.contractId });
+  }
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'ct.trade_direction IN (:...directions)' : '1 = 0', {
+      directions,
+    });
+  }
+  return qb;
+}
+
+export const contractUtilizationReport: ReportDefinition = {
+  key: 'contract-utilization',
+  title: 'Contract Utilization',
+  description: 'Committed volume vs. booked tonnage per contract',
+  group: 'Commercial',
+  idKey: { key: 'contractId', label: 'Contract' },
+  filters: [
+    { key: 'date', label: 'Active during', type: 'daterange' },
+    { key: 'statuses', label: 'Status', type: 'multiselect' },
+  ],
+  columns: [
+    { key: 'reference', label: 'Reference', type: 'string', sortable: true, sortExpr: 'ct.reference' },
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'status', label: 'Status', type: 'string' },
+    { key: 'kind', label: 'Kind', type: 'string' },
+    { key: 'validFrom', label: 'Valid from', type: 'date' },
+    { key: 'validUntil', label: 'Valid until', type: 'date' },
+    { key: 'committed', label: 'Committed', type: 'tons' },
+    { key: 'bookedTons', label: 'Booked', type: 'tons', sortable: true },
+    { key: 'bookings', label: 'Bookings', type: 'number' },
+    { key: 'utilizationPct', label: 'Utilization', type: 'percent', sortable: true },
+  ],
+  defaultSort: { key: 'utilizationPct', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('ct.reference', 'reference')
+      .addSelect('c.name', 'customer')
+      .addSelect('ct.status', 'status')
+      .addSelect('ct.contract_kind', 'kind')
+      .addSelect(`to_char(ct.contract_valid_from, 'YYYY-MM-DD')`, 'validFrom')
+      .addSelect(`to_char(ct.contract_valid_until, 'YYYY-MM-DD')`, 'validUntil')
+      .addSelect('COALESCE(cap.committed, 0)::float8', 'committed')
+      .addSelect('COALESCE(booked.tons, 0)::float8', 'bookedTons')
+      .addSelect('COALESCE(booked.cnt, 0)', 'bookings')
+      .addSelect(
+        `CASE WHEN COALESCE(cap.committed, 0) > 0
+              THEN ROUND(COALESCE(booked.tons, 0) / cap.committed * 100)::float8 END`,
+        'utilizationPct',
+      );
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'contracts')
+      .addSelect('COALESCE(SUM(booked.tons), 0)::float8', 'bookedTons')
+      .addSelect(
+        `AVG(CASE WHEN COALESCE(cap.committed, 0) > 0
+              THEN booked.tons / cap.committed * 100 END)::float8`,
+        'avgUtilization',
+      )
+      .getRawOne();
+    return [
+      { label: 'Contracts', value: Number(row?.contracts ?? 0) },
+      { label: 'Booked tonnage', value: Number(row?.bookedTons ?? 0), unit: 't' },
+      { label: 'Avg utilization', value: Math.round(Number(row?.avgUtilization ?? 0)), unit: '%' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/customer-status.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/customer-status.report.ts
new file mode 100644
index 000000000..60b6ff31a
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/customer-status.report.ts
@@ -0,0 +1,67 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { CompanyProfile, ProfileStatus, ProfileType } from '../../companies/entities/company-profile.entity';
+import { Company } from '../../companies/entities/company.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// "Type (Importer, Exporter, Freight Forwarding)" and "Active/Suspended" are
+// CompanyProfile fields, not Company's — a company can hold several profiles
+// (e.g. importer AND exporter), each independently approved/suspended.
+const TYPE_OPTIONS = Object.values(ProfileType).map((v) => ({ value: v, label: v.replace(/_/g, ' ') }));
+const STATUS_OPTIONS = Object.values(ProfileStatus).map((v) => ({ value: v, label: v }));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(CompanyProfile, 'cp')
+    .innerJoin(Company, 'c', 'c.id = cp.company_id')
+    .where('cp.deleted_at IS NULL');
+
+  if (params.type) qb.andWhere('cp.type = :type', { type: params.type });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('cp.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const customerStatusReport: ReportDefinition = {
+  key: 'customer-status',
+  title: 'Customer Profiles',
+  description: 'Company profiles by role type and approval status',
+  group: 'Commercial',
+  filters: [
+    { key: 'type', label: 'Type', type: 'select', options: TYPE_OPTIONS },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'company', label: 'Company', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'type', label: 'Type', type: 'string', sortable: true, sortExpr: 'cp.type' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'cp.status' },
+    { key: 'reference', label: 'Reference', type: 'string' },
+    { key: 'note', label: 'Note', type: 'string' },
+    { key: 'reviewedAt', label: 'Reviewed', type: 'date', sortable: true, sortExpr: 'cp.reviewed_at' },
+  ],
+  defaultSort: { key: 'reviewedAt', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('c.name', 'company')
+      .addSelect('cp.type', 'type')
+      .addSelect('cp.status', 'status')
+      .addSelect("COALESCE(cp.reference, '')", 'reference')
+      .addSelect("COALESCE(cp.review_note, '')", 'note')
+      .addSelect(`to_char(cp.reviewed_at, 'YYYY-MM-DD')`, 'reviewedAt');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect('COUNT(*) FILTER (WHERE cp.status = :active)::int', 'active')
+      .addSelect('COUNT(*) FILTER (WHERE cp.status = :suspended)::int', 'suspended')
+      .setParameters({ active: ProfileStatus.Active, suspended: ProfileStatus.Suspended })
+      .getRawOne();
+    return [
+      { label: 'Profiles', value: Number(row?.total ?? 0) },
+      { label: 'Active', value: Number(row?.active ?? 0) },
+      { label: 'Suspended', value: Number(row?.suspended ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/customs-documents.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/customs-documents.report.ts
new file mode 100644
index 000000000..a0bcb32fc
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/customs-documents.report.ts
@@ -0,0 +1,66 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import {
+  ClearanceMilestone,
+  MILESTONE_OWNER_REGIONS,
+  MILESTONE_STATUSES,
+} from '../../contracts/entities/clearance-milestone.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds.createQueryBuilder().from(ClearanceMilestone, 'cm').where('cm.deleted_at IS NULL');
+
+  if (params.dateFrom) qb.andWhere('cm.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('cm.created_at < :dateTo', { dateTo: params.dateTo });
+  if (params.ownerRegion) qb.andWhere('cm.owner_region = :ownerRegion', { ownerRegion: params.ownerRegion });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('cm.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const customsDocumentsReport: ReportDefinition = {
+  key: 'customs-documents',
+  title: 'Customs Clearance Milestones',
+  description: 'Clearance milestone volume by label, owner and status',
+  group: 'Operations',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    {
+      key: 'ownerRegion',
+      label: 'Owner',
+      type: 'select',
+      options: MILESTONE_OWNER_REGIONS.map((v) => ({ value: v, label: v })),
+    },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: MILESTONE_STATUSES.map((v) => ({ value: v, label: v })) },
+  ],
+  columns: [
+    { key: 'milestone', label: 'Milestone', type: 'string', sortable: true },
+    { key: 'ownerRegion', label: 'Owner', type: 'string', sortable: true },
+    { key: 'status', label: 'Status', type: 'string', sortable: true },
+    { key: 'count', label: 'Count', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'count', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('cm.milestone_label', 'milestone')
+      .addSelect("COALESCE(cm.owner_region, 'Unassigned')", 'ownerRegion')
+      .addSelect('cm.status', 'status')
+      .addSelect('COUNT(*)::int', 'count')
+      .groupBy('cm.milestone_label')
+      .addGroupBy('cm.owner_region')
+      .addGroupBy('cm.status');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect("COUNT(*) FILTER (WHERE cm.status = 'COMPLETED')::int", 'completed')
+      .addSelect("COUNT(*) FILTER (WHERE cm.status = 'PENDING')::int", 'pending')
+      .getRawOne();
+    return [
+      { label: 'Milestones', value: Number(row?.total ?? 0) },
+      { label: 'Completed', value: Number(row?.completed ?? 0) },
+      { label: 'Pending', value: Number(row?.pending ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/first-last-mile-bookings.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/first-last-mile-bookings.report.ts
new file mode 100644
index 000000000..d3abe10dc
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/first-last-mile-bookings.report.ts
@@ -0,0 +1,90 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Booking } from '../../bookings/entities/booking.entity';
+import { Company } from '../../companies/entities/company.entity';
+import { Vehicle } from '../../vehicles/entities/vehicle.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// FirstMile and LastMile are separate tables with an identical shape (status,
+// booking, optional vehicle). One resolver, unioned, with a `leg` column —
+// beats shipping two near-duplicate reports for the two halves of the trip.
+const LEG_UNION = `(
+  SELECT 'FIRST' AS leg, fm.id AS id, fm.booking_id AS booking_id, fm.status AS status,
+    fm.vehicle_id AS vehicle_id, fm.created_at AS created_at
+  FROM freight.first_mile fm WHERE fm.deleted_at IS NULL
+  UNION ALL
+  SELECT 'LAST' AS leg, lm.id AS id, lm.booking_id AS booking_id, lm.status AS status,
+    lm.vehicle_id AS vehicle_id, lm.created_at AS created_at
+  FROM freight.last_mile lm WHERE lm.deleted_at IS NULL
+)`;
+
+const STATUS_OPTIONS = [
+  { value: 'PAYMENT_PENDING', label: 'Payment pending' },
+  { value: 'READY_TO_TRANSIT', label: 'Ready to transit' },
+  { value: 'IN_TRANSIT', label: 'In transit' },
+  { value: 'RECEIVED_TO_PORT', label: 'Received to port' },
+  { value: 'DELIVERED', label: 'Delivered' },
+];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(LEG_UNION, 'fl')
+    .innerJoin(Booking, 'b', 'b.id = fl.booking_id')
+    .leftJoin(Company, 'c', 'c.id = b.company_id')
+    .leftJoin(Vehicle, 'v', 'v.id = fl.vehicle_id')
+    .where('1 = 1');
+
+  if (params.leg) qb.andWhere('fl.leg = :leg', { leg: params.leg });
+  if (params.dateFrom) qb.andWhere('fl.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('fl.created_at < :dateTo', { dateTo: params.dateTo });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('fl.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const firstLastMileBookingsReport: ReportDefinition = {
+  key: 'first-last-mile-bookings',
+  title: 'First/Last Mile Trucking',
+  description: 'First- and last-mile bookings by status and truck assignment',
+  group: 'Operations',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    { key: 'leg', label: 'Leg', type: 'select', options: [{ value: 'FIRST', label: 'First mile' }, { value: 'LAST', label: 'Last mile' }] },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'leg', label: 'Leg', type: 'string', sortable: true },
+    { key: 'booking', label: 'Booking', type: 'string', sortable: true, sortExpr: 'b.reference' },
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'fl.status' },
+    { key: 'truck', label: 'Truck', type: 'string' },
+    { key: 'assigned', label: 'Assigned', type: 'string', sortable: true },
+    { key: 'createdAt', label: 'Created', type: 'date', sortable: true, sortExpr: 'fl.created_at' },
+  ],
+  defaultSort: { key: 'createdAt', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('fl.leg', 'leg')
+      .addSelect('b.reference', 'booking')
+      .addSelect("COALESCE(c.name, 'Unknown')", 'customer')
+      .addSelect('fl.status', 'status')
+      .addSelect("COALESCE(v.plate_number, '—')", 'truck')
+      .addSelect("CASE WHEN fl.vehicle_id IS NOT NULL THEN 'Assigned' ELSE 'Unassigned' END", 'assigned')
+      .addSelect(`to_char(fl.created_at, 'YYYY-MM-DD')`, 'createdAt');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect('COUNT(*) FILTER (WHERE fl.vehicle_id IS NOT NULL)::int', 'assigned')
+      .getRawOne();
+    const total = Number(row?.total ?? 0);
+    const assigned = Number(row?.assigned ?? 0);
+    return [
+      { label: 'Trips', value: total },
+      { label: 'Assigned', value: assigned },
+      { label: 'Unassigned', value: total - assigned },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/global-logistics-wagons.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/global-logistics-wagons.report.ts
new file mode 100644
index 000000000..d3fd759f7
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/global-logistics-wagons.report.ts
@@ -0,0 +1,69 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ScheduleWagonAdjustmentLog } from '../../train-schedules/entities/schedule-wagon-adjustment-log.entity';
+import { TrainSchedule } from '../../train-schedules/entities/train-schedule.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// ADD = allocated, REMOVE = cancelled. SWITCH (a physical wagon swap, net
+// count unchanged) is excluded — it's neither an allocation nor a cancellation.
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(ScheduleWagonAdjustmentLog, 'l')
+    .leftJoin(TrainSchedule, 'ts', 'ts.id = l.train_schedule_id')
+    .where('l.deleted_at IS NULL')
+    .andWhere("l.action IN ('ADD', 'REMOVE')");
+
+  if (params.dateFrom) qb.andWhere('l.occurred_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('l.occurred_at < :dateTo', { dateTo: params.dateTo });
+  if (params.direction) qb.andWhere('ts.direction = :direction', { direction: params.direction });
+  return qb;
+}
+
+export const globalLogisticsWagonsReport: ReportDefinition = {
+  key: 'global-logistics-wagons',
+  title: 'Wagon Allocations by Day',
+  description: 'Wagons allocated vs. cancelled per day, by direction',
+  group: 'Operations',
+  filters: [
+    { key: 'date', label: 'Date', type: 'daterange' },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+  ],
+  columns: [
+    { key: 'date', label: 'Date', type: 'date', sortable: true, sortExpr: `date_trunc('day', l.occurred_at)` },
+    { key: 'direction', label: 'Direction', type: 'string', sortable: true },
+    { key: 'allocated', label: 'Allocated', type: 'number', sortable: true },
+    { key: 'cancelled', label: 'Cancelled', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'date', dir: 'DESC' },
+  chart: { type: 'line', x: 'date', y: ['allocated', 'cancelled'] },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select(`to_char(date_trunc('day', l.occurred_at), 'YYYY-MM-DD')`, 'date')
+      .addSelect("COALESCE(ts.direction, 'Unknown')", 'direction')
+      .addSelect("COUNT(*) FILTER (WHERE l.action = 'ADD')::int", 'allocated')
+      .addSelect("COUNT(*) FILTER (WHERE l.action = 'REMOVE')::int", 'cancelled')
+      .groupBy(`date_trunc('day', l.occurred_at)`)
+      .addGroupBy('ts.direction');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select("COUNT(*) FILTER (WHERE l.action = 'ADD')::int", 'allocated')
+      .addSelect("COUNT(*) FILTER (WHERE l.action = 'REMOVE')::int", 'cancelled')
+      .getRawOne();
+    return [
+      { label: 'Allocated', value: Number(row?.allocated ?? 0) },
+      { label: 'Cancelled', value: Number(row?.cancelled ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/invoices-by-status.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/invoices-by-status.report.ts
new file mode 100644
index 000000000..81b183f90
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/invoices-by-status.report.ts
@@ -0,0 +1,72 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Freight } from '@edr/types';
+import { Invoice } from '../../billing/entities/invoice.entity';
+import { Company } from '../../companies/entities/company.entity';
+import { CompanyProfile } from '../../companies/entities/company-profile.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const STATUS_OPTIONS = Object.values(Freight.InvoiceStatus).map((v) => ({ value: v, label: v }));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Invoice, 'i')
+    .innerJoin(Company, 'c', 'c.id = i.company_id')
+    .leftJoin(CompanyProfile, 'cp', 'cp.id = i.company_profile_id')
+    .where('i.deleted_at IS NULL');
+
+  if (params.dateFrom) qb.andWhere('i.issued_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('i.issued_at < :dateTo', { dateTo: params.dateTo });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('i.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const invoicesByStatusReport: ReportDefinition = {
+  key: 'invoices-by-status',
+  title: 'Invoices',
+  description: 'Every invoice with customer, profile type and settlement status',
+  group: 'Finance',
+  filters: [
+    { key: 'date', label: 'Issued', type: 'daterange' },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'invoiceNumber', label: 'Invoice No.', type: 'string', sortable: true, sortExpr: 'i.invoice_number' },
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'profileType', label: 'Profile', type: 'string' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'i.status' },
+    { key: 'totalAmount', label: 'Total', type: 'money', sortable: true },
+    { key: 'paidAmount', label: 'Paid', type: 'money' },
+    { key: 'balanceAmount', label: 'Balance', type: 'money', sortable: true },
+    { key: 'issuedAt', label: 'Issued', type: 'date', sortable: true, sortExpr: 'i.issued_at' },
+    { key: 'dueAt', label: 'Due', type: 'date' },
+  ],
+  defaultSort: { key: 'issuedAt', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('i.invoice_number', 'invoiceNumber')
+      .addSelect('c.name', 'customer')
+      .addSelect("COALESCE(cp.type, 'Unknown')", 'profileType')
+      .addSelect('i.status', 'status')
+      .addSelect('ROUND(i.total_amount)::float8', 'totalAmount')
+      .addSelect('ROUND(i.paid_amount)::float8', 'paidAmount')
+      .addSelect('ROUND(i.balance_amount)::float8', 'balanceAmount')
+      .addSelect(`to_char(i.issued_at, 'YYYY-MM-DD')`, 'issuedAt')
+      .addSelect(`to_char(i.due_at, 'YYYY-MM-DD')`, 'dueAt');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'invoices')
+      .addSelect('ROUND(COALESCE(SUM(i.total_amount), 0))::float8', 'total')
+      .addSelect('ROUND(COALESCE(SUM(i.balance_amount), 0))::float8', 'balance')
+      .getRawOne();
+    return [
+      { label: 'Invoices', value: Number(row?.invoices ?? 0) },
+      { label: 'Total value', value: Number(row?.total ?? 0), unit: 'ETB' },
+      { label: 'Outstanding', value: Number(row?.balance ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/invoicing-pipeline.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/invoicing-pipeline.report.ts
new file mode 100644
index 000000000..8907f4f5a
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/invoicing-pipeline.report.ts
@@ -0,0 +1,59 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Freight } from '@edr/types';
+import { Invoice } from '../../billing/entities/invoice.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const STATUS_OPTIONS = Object.values(Freight.InvoiceStatus).map((v) => ({ value: v, label: v }));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds.createQueryBuilder().from(Invoice, 'i').where('i.deleted_at IS NULL');
+
+  if (params.dateFrom) qb.andWhere('i.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('i.created_at < :dateTo', { dateTo: params.dateTo });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('i.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const invoicingPipelineReport: ReportDefinition = {
+  key: 'invoicing-pipeline',
+  title: 'Invoicing Pipeline',
+  description: 'Invoice volume and value by type and status',
+  group: 'Finance',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'type', label: 'Type', type: 'string', sortable: true },
+    { key: 'status', label: 'Status', type: 'string', sortable: true },
+    { key: 'invoices', label: 'Invoices', type: 'number', sortable: true },
+    { key: 'totalAmount', label: 'Total', type: 'money', sortable: true },
+    { key: 'balance', label: 'Outstanding', type: 'money', sortable: true },
+  ],
+  defaultSort: { key: 'invoices', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('i.type', 'type')
+      .addSelect('i.status', 'status')
+      .addSelect('COUNT(*)::int', 'invoices')
+      .addSelect('ROUND(COALESCE(SUM(i.total_amount), 0))::float8', 'totalAmount')
+      .addSelect('ROUND(COALESCE(SUM(i.balance_amount), 0))::float8', 'balance')
+      .groupBy('i.type')
+      .addGroupBy('i.status');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'invoices')
+      .addSelect('ROUND(COALESCE(SUM(i.total_amount), 0))::float8', 'totalAmount')
+      .addSelect('ROUND(COALESCE(SUM(i.balance_amount), 0))::float8', 'balance')
+      .getRawOne();
+    return [
+      { label: 'Invoices', value: Number(row?.invoices ?? 0) },
+      { label: 'Total value', value: Number(row?.totalAmount ?? 0), unit: 'ETB' },
+      { label: 'Outstanding', value: Number(row?.balance ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/loaded-capacity.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/loaded-capacity.report.ts
new file mode 100644
index 000000000..8827b77b8
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/loaded-capacity.report.ts
@@ -0,0 +1,78 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { TrainSetWagon } from '../../train-sets/entities/train-set-wagon.entity';
+import { TrainSchedule } from '../../train-schedules/entities/train-schedule.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// train_set_wagons.assigned_weight_tons is the planned load per slot, already
+// maintained by the wagon-allocation flow — no need to re-derive it from
+// bulk/container line items.
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(TrainSetWagon, 'tsw')
+    .innerJoin(TrainSchedule, 'ts', 'ts.train_set_id = tsw.train_set_id')
+    .leftJoin(WagonType, 'wt', 'wt.id = tsw.wagon_type_id')
+    .where('tsw.deleted_at IS NULL AND ts.deleted_at IS NULL');
+
+  if (params.trainNumber) {
+    qb.andWhere('ts.train_number ILIKE :trainNumber', { trainNumber: `%${params.trainNumber}%` });
+  }
+  if (params.dateFrom) {
+    qb.andWhere('ts.scheduled_departure_date >= :dateFrom', { dateFrom: params.dateFrom });
+  }
+  if (params.dateTo) qb.andWhere('ts.scheduled_departure_date < :dateTo', { dateTo: params.dateTo });
+  return qb;
+}
+
+export const loadedCapacityReport: ReportDefinition = {
+  key: 'loaded-capacity',
+  title: 'Loaded Capacity',
+  description: 'Nameplate vs. loaded capacity per train, by wagon type',
+  group: 'Operations',
+  filters: [
+    { key: 'trainNumber', label: 'Train No.', type: 'text' },
+    { key: 'date', label: 'Departure', type: 'daterange' },
+  ],
+  columns: [
+    { key: 'trainNumber', label: 'Train No.', type: 'string', sortable: true, sortExpr: 'ts.train_number' },
+    { key: 'departureDate', label: 'Departure', type: 'date' },
+    { key: 'wagonType', label: 'Wagon type', type: 'string', sortable: true },
+    { key: 'wagons', label: 'Wagons', type: 'number', sortable: true },
+    { key: 'capacityTons', label: 'Capacity', type: 'tons', sortable: true },
+    { key: 'loadedTons', label: 'Loaded', type: 'tons', sortable: true },
+    { key: 'utilizationPct', label: 'Utilization', type: 'percent', sortable: true },
+  ],
+  defaultSort: { key: 'loadedTons', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('ts.train_number', 'trainNumber')
+      .addSelect(`to_char(ts.scheduled_departure_date, 'YYYY-MM-DD')`, 'departureDate')
+      .addSelect("COALESCE(wt.name, 'Unknown')", 'wagonType')
+      .addSelect('COUNT(*)::int', 'wagons')
+      .addSelect('COALESCE(SUM(tsw.capacity_tons), 0)::float8', 'capacityTons')
+      .addSelect('COALESCE(SUM(tsw.assigned_weight_tons), 0)::float8', 'loadedTons')
+      .addSelect(
+        `CASE WHEN COALESCE(SUM(tsw.capacity_tons), 0) > 0
+              THEN ROUND(SUM(tsw.assigned_weight_tons) / SUM(tsw.capacity_tons) * 100)::float8 END`,
+        'utilizationPct',
+      )
+      .groupBy('ts.train_number')
+      .addGroupBy('ts.scheduled_departure_date')
+      .addGroupBy('wt.name');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'wagons')
+      .addSelect('COALESCE(SUM(tsw.capacity_tons), 0)::float8', 'capacityTons')
+      .addSelect('COALESCE(SUM(tsw.assigned_weight_tons), 0)::float8', 'loadedTons')
+      .getRawOne();
+    return [
+      { label: 'Wagons', value: Number(row?.wagons ?? 0) },
+      { label: 'Capacity', value: Number(row?.capacityTons ?? 0), unit: 't' },
+      { label: 'Loaded', value: Number(row?.loadedTons ?? 0), unit: 't' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/locomotive-fleet-status.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/locomotive-fleet-status.report.ts
new file mode 100644
index 000000000..cf971cf2c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/locomotive-fleet-status.report.ts
@@ -0,0 +1,68 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Locomotive, LOCOMOTIVE_STATUSES } from '../../locomotives/entities/locomotive.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const STATUS_OPTIONS = LOCOMOTIVE_STATUSES.map((v) => ({ value: v, label: v.replace(/_/g, ' ') }));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Locomotive, 'l')
+    .leftJoin(Yard, 'y', 'y.id = l.current_yard_id')
+    .where('l.deleted_at IS NULL');
+
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('l.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const locomotiveFleetStatusReport: ReportDefinition = {
+  key: 'locomotive-fleet-status',
+  title: 'Locomotive Fleet Status',
+  description: 'Locomotive counts by type, station and status',
+  group: 'Operations',
+  filters: [{ key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS }],
+  columns: [
+    { key: 'locomotiveType', label: 'Type', type: 'string', sortable: true },
+    { key: 'station', label: 'Station', type: 'string', sortable: true },
+    { key: 'status', label: 'Status', type: 'string', sortable: true },
+    { key: 'count', label: 'Count', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'count', dir: 'DESC' },
+  chart: { type: 'bar', x: 'status', y: ['count'] },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('l.locomotive_type', 'locomotiveType')
+      .addSelect("COALESCE(y.label, 'Unassigned')", 'station')
+      .addSelect('l.status', 'status')
+      .addSelect('COUNT(*)::int', 'count')
+      .groupBy('l.locomotive_type')
+      .addGroupBy('y.label')
+      .addGroupBy('l.status');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect('COUNT(*) FILTER (WHERE l.status = :available)::int', 'available')
+      .addSelect('COUNT(*) FILTER (WHERE l.status = :assigned)::int', 'assigned')
+      .addSelect('COUNT(*) FILTER (WHERE l.status = :maintenance)::int', 'maintenance')
+      .addSelect('COUNT(*) FILTER (WHERE l.status = :outOfService)::int', 'outOfService')
+      .setParameters({
+        available: 'AVAILABLE',
+        assigned: 'ASSIGNED',
+        maintenance: 'MAINTENANCE',
+        outOfService: 'OUT_OF_SERVICE',
+      })
+      .getRawOne();
+    return [
+      { label: 'Total locomotives', value: Number(row?.total ?? 0) },
+      { label: 'Available', value: Number(row?.available ?? 0) },
+      { label: 'Assigned', value: Number(row?.assigned ?? 0) },
+      { label: 'Under maintenance', value: Number(row?.maintenance ?? 0) },
+      { label: 'Out of service', value: Number(row?.outOfService ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/payment-classification.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/payment-classification.report.ts
new file mode 100644
index 000000000..4a77521b5
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/payment-classification.report.ts
@@ -0,0 +1,76 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  PAID_SHARE,
+  PAYMENT_CLASSES,
+  PAYMENT_CLASS_EXPR,
+  PAYMENT_CLASS_LABEL_EXPR,
+  PERIOD_FILTER,
+  REVENUE_FILTERS,
+  REVENUE_SUM,
+  currencyOf,
+  periodExpr,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const qb = revenueLedgerQb(ctx);
+  const classes = ctx.params.classes as string[] | null;
+  if (classes?.length) {
+    qb.andWhere(`${PAYMENT_CLASS_EXPR} IN (:...classes)`, { classes });
+  }
+  return qb;
+}
+
+export const paymentClassificationReport: ReportDefinition = {
+  key: 'payment-classification',
+  title: 'Payment Classification',
+  description:
+    'What customers actually paid for, per period: rail transport, customs clearance, ' +
+    'first/last mile, overweight, cancellation, demurrage, storage, loading and unloading, ' +
+    'and additional charges. Note there is no dedicated loading/unloading charge type in ' +
+    'the system — handling and double-handling fees stand in for it.',
+  group: 'Finance',
+  filters: [
+    PERIOD_FILTER,
+    ...REVENUE_FILTERS,
+    { key: 'classes', label: 'Payment class', type: 'multiselect', options: PAYMENT_CLASSES },
+  ],
+  columns: [
+    { key: 'period', label: 'Period', type: 'string', sortable: true },
+    { key: 'paymentClass', label: 'Payment class', type: 'string', sortable: true },
+    { key: 'billed', label: 'Billed', type: 'money', sortable: true },
+    { key: 'settled', label: 'Settled', type: 'money', sortable: true },
+    { key: 'outstanding', label: 'Outstanding', type: 'money', sortable: true },
+    { key: 'lines', label: 'Lines', type: 'number' },
+  ],
+  defaultSort: { key: 'billed', dir: 'DESC' },
+  chart: { type: 'bar', x: 'paymentClass', y: ['billed'] },
+  query(ctx) {
+    const period = periodExpr(ctx.params);
+    return baseQuery(ctx)
+      .select(period, 'period')
+      .addSelect(PAYMENT_CLASS_LABEL_EXPR, 'paymentClass')
+      .addSelect('ROUND(SUM(il.amount))::float8', 'billed')
+      .addSelect(`ROUND(SUM(${PAID_SHARE}))::float8`, 'settled')
+      .addSelect(`ROUND(SUM(il.amount) - SUM(${PAID_SHARE}))::float8`, 'outstanding')
+      .addSelect('COUNT(*)::int', 'lines')
+      .groupBy(period)
+      .addGroupBy(PAYMENT_CLASS_EXPR);
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(REVENUE_SUM, 'billed')
+      .addSelect(`ROUND(COALESCE(SUM(${PAID_SHARE}), 0))::float8`, 'settled')
+      .getRawOne<{ billed: number; settled: number }>();
+    const currency = currencyOf(ctx.params);
+    const billed = Number(row?.billed ?? 0);
+    const settled = Number(row?.settled ?? 0);
+    return [
+      { label: 'Billed', value: billed, unit: currency },
+      { label: 'Settled', value: settled, unit: currency },
+      { label: 'Outstanding', value: Math.round(billed - settled), unit: currency },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/payments-by-status.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/payments-by-status.report.ts
new file mode 100644
index 000000000..15e99a4b1
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/payments-by-status.report.ts
@@ -0,0 +1,73 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { PaymentEntity } from '../../payment/entities/payment.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// No direct company link on payments (refId points at whatever the intent was
+// for — booking, demurrage, ...); breakdown stops at status/method/currency.
+const STATUS_OPTIONS = [
+  { value: 'action-required', label: 'Action required' },
+  { value: 'processing', label: 'Processing' },
+  { value: 'success', label: 'Success' },
+  { value: 'failed', label: 'Failed' },
+  { value: 'canceled', label: 'Canceled' },
+  { value: 'refunded', label: 'Refunded' },
+];
+const METHOD_OPTIONS = ['telebirr', 'cbe-birr', 'ebirr', 'waafi', 'card', 'dmoney', 'cac-bank', 'cbe-bill'].map(
+  (v) => ({ value: v, label: v }),
+);
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  // payments carries no deleted_at column (unlike the rest of the schema) —
+  // confirmed against the live DB, not assumed from BaseEntity.
+  const qb = ctx.ds.createQueryBuilder().from(PaymentEntity, 'p').where('1 = 1');
+
+  if (params.dateFrom) qb.andWhere('p.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('p.created_at < :dateTo', { dateTo: params.dateTo });
+  if (params.method) qb.andWhere('p.method = :method', { method: params.method });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('p.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const paymentsByStatusReport: ReportDefinition = {
+  key: 'payments-by-status',
+  title: 'Payments by Status',
+  description: 'Payment volume and value by status, method and currency',
+  group: 'Finance',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    { key: 'method', label: 'Method', type: 'select', options: METHOD_OPTIONS },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'status', label: 'Status', type: 'string', sortable: true },
+    { key: 'method', label: 'Method', type: 'string', sortable: true },
+    { key: 'currency', label: 'Currency', type: 'string' },
+    { key: 'payments', label: 'Payments', type: 'number', sortable: true },
+    { key: 'amount', label: 'Amount', type: 'money', sortable: true },
+  ],
+  defaultSort: { key: 'amount', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('p.status', 'status')
+      .addSelect('p.method', 'method')
+      .addSelect('p.currency', 'currency')
+      .addSelect('COUNT(*)::int', 'payments')
+      .addSelect('ROUND(COALESCE(SUM(p.amount), 0))::float8', 'amount')
+      .groupBy('p.status')
+      .addGroupBy('p.method')
+      .addGroupBy('p.currency');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'payments')
+      .addSelect("ROUND(COALESCE(SUM(p.amount) FILTER (WHERE p.status = 'success'), 0))::float8", 'paid')
+      .getRawOne();
+    return [
+      { label: 'Payments', value: Number(row?.payments ?? 0) },
+      { label: 'Total paid', value: Number(row?.paid ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/receivables-payables.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/receivables-payables.report.ts
new file mode 100644
index 000000000..018a68faf
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/receivables-payables.report.ts
@@ -0,0 +1,114 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition, ReportFilterOption } from '../report.types';
+import {
+  PAYER_EXPR,
+  REVENUE_DATE,
+  REVENUE_FILTERS,
+  currencyOf,
+  invoiceLedgerQb,
+} from '../revenue-classification';
+
+export const LEDGER_SIDES: ReportFilterOption[] = [
+  { value: 'RECEIVABLE_CREDIT', label: 'Receivable — credit service (shipping line)' },
+  { value: 'RECEIVABLE_OPEN', label: 'Receivable — open balance' },
+  { value: 'PAYABLE_CANCELLATION', label: 'Payable — cancellation fee' },
+  { value: 'PAYABLE_UNDELIVERED', label: 'Payable — paid but not delivered' },
+  { value: 'SETTLED', label: 'Settled' },
+];
+
+/**
+ * Which side of the ledger an invoice sits on.
+ *
+ * Receivable = EDR delivered and is owed money — the shipping-line credit
+ * arrangement, plus any invoice still carrying a balance.
+ * Payable = the customer paid for something EDR did not deliver, so the money
+ * is a refund liability rather than revenue: cancellation fees, and prepaid
+ * invoices whose booking died.
+ */
+const SIDE_EXPR = `CASE
+  WHEN i.source = 'shipping_line_credit' OR i.type = 'SHIPPING_LINE_CREDIT'
+    THEN 'RECEIVABLE_CREDIT'
+  WHEN i.type = 'WAGON_CANCEL_FEE' THEN 'PAYABLE_CANCELLATION'
+  WHEN i.paid_amount > 0 AND b.status IN ('CANCELLED', 'REJECTED', 'EXPIRED')
+    THEN 'PAYABLE_UNDELIVERED'
+  WHEN i.balance_amount > 0 THEN 'RECEIVABLE_OPEN'
+  ELSE 'SETTLED'
+END`;
+
+const LABELS = new Map(LEDGER_SIDES.map((s) => [s.value, s.label]));
+const SIDE_LABEL_EXPR = `CASE ${SIDE_EXPR}
+  ${[...LABELS].map(([value, label]) => `WHEN '${value}' THEN '${label.replace(/'/g, "''")}'`).join('\n  ')}
+END`;
+
+/** Money at stake on this row: what is owed, or what may have to be given back. */
+const EXPOSURE = `CASE
+  WHEN ${SIDE_EXPR} LIKE 'PAYABLE%' THEN i.paid_amount
+  ELSE i.balance_amount
+END`;
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const qb = invoiceLedgerQb(ctx);
+  const sides = ctx.params.sides as string[] | null;
+  if (sides?.length) qb.andWhere(`${SIDE_EXPR} IN (:...sides)`, { sides });
+  return qb;
+}
+
+export const receivablesPayablesReport: ReportDefinition = {
+  key: 'receivables-payables',
+  title: 'Receivables and Payables',
+  description:
+    'Splits customer money two ways: receivable, where EDR delivered and is owed — ' +
+    'including shipping-line credit services — and payable, where the customer paid but ' +
+    'the service was not delivered, such as cancellation fees and prepayments against ' +
+    'dead bookings. Payable amounts are a refund liability, not revenue.',
+  group: 'Finance',
+  filters: [
+    ...REVENUE_FILTERS.filter((f) => f.key !== 'categories' && f.key !== 'methods'),
+    { key: 'sides', label: 'Ledger side', type: 'multiselect', options: LEDGER_SIDES },
+  ],
+  columns: [
+    { key: 'side', label: 'Ledger side', type: 'string', sortable: true, sortExpr: SIDE_EXPR },
+    { key: 'issuedAt', label: 'Issued', type: 'date', sortable: true, sortExpr: REVENUE_DATE },
+    { key: 'invoiceNumber', label: 'Invoice No.', type: 'string', sortable: true, sortExpr: 'i.invoice_number' },
+    { key: 'bookingRef', label: 'Booking', type: 'string' },
+    { key: 'bookingStatus', label: 'Booking status', type: 'string' },
+    { key: 'customer', label: 'Payer', type: 'string', sortable: true, sortExpr: PAYER_EXPR },
+    { key: 'invoiced', label: 'Invoiced', type: 'money', sortable: true, sortExpr: 'i.total_amount' },
+    { key: 'paid', label: 'Paid', type: 'money', sortable: true, sortExpr: 'i.paid_amount' },
+    { key: 'exposure', label: 'Owed / refundable', type: 'money', sortable: true, sortExpr: EXPOSURE },
+  ],
+  defaultSort: { key: 'exposure', dir: 'DESC' },
+  chart: { type: 'bar', x: 'side', y: ['exposure'] },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select(SIDE_LABEL_EXPR, 'side')
+      .addSelect(`to_char(${REVENUE_DATE}, 'YYYY-MM-DD')`, 'issuedAt')
+      .addSelect('i.invoice_number', 'invoiceNumber')
+      .addSelect("COALESCE(b.reference, '—')", 'bookingRef')
+      .addSelect("COALESCE(b.status, '—')", 'bookingStatus')
+      .addSelect(PAYER_EXPR, 'customer')
+      .addSelect('ROUND(i.total_amount, 2)::float8', 'invoiced')
+      .addSelect('ROUND(i.paid_amount, 2)::float8', 'paid')
+      .addSelect(`ROUND(${EXPOSURE}, 2)::float8`, 'exposure');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(
+        `ROUND(COALESCE(SUM(${EXPOSURE}) FILTER (WHERE ${SIDE_EXPR} LIKE 'RECEIVABLE%'), 0))::float8`,
+        'receivable',
+      )
+      .addSelect(
+        `ROUND(COALESCE(SUM(${EXPOSURE}) FILTER (WHERE ${SIDE_EXPR} LIKE 'PAYABLE%'), 0))::float8`,
+        'payable',
+      )
+      .addSelect('COUNT(*)::int', 'invoices')
+      .getRawOne<{ receivable: number; payable: number; invoices: number }>();
+    const currency = currencyOf(ctx.params);
+    return [
+      { label: 'Receivable', value: Number(row?.receivable ?? 0), unit: currency },
+      { label: 'Payable', value: Number(row?.payable ?? 0), unit: currency },
+      { label: 'Invoices', value: Number(row?.invoices ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-anomalies.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-anomalies.report.ts
new file mode 100644
index 000000000..cf2d7735e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-anomalies.report.ts
@@ -0,0 +1,102 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  CATEGORY_LABEL_EXPR,
+  PERIOD_FILTER,
+  REVENUE_CATEGORY_EXPR,
+  REVENUE_FILTERS,
+  growthPctExpr,
+  periodExpr,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+const REVENUE = 'SUM(il.amount)';
+
+const THRESHOLDS = [
+  { value: '10', label: '±10%' },
+  { value: '25', label: '±25%' },
+  { value: '50', label: '±50%' },
+];
+
+const thresholdOf = (params: Record<string, unknown>): number => {
+  const raw = Number(params.threshold);
+  return THRESHOLDS.some((t) => Number(t.value) === raw) ? raw : 25;
+};
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  return revenueLedgerQb(ctx);
+}
+
+export const revenueAnomaliesReport: ReportDefinition = {
+  key: 'revenue-anomalies',
+  title: 'Revenue Anomalies',
+  description:
+    'Periods where a revenue category moved more than the chosen threshold against the ' +
+    'previous period. Pull-based on purpose: this surfaces the spikes and drops for review ' +
+    'rather than paging anyone, so the thresholds can be tuned against real numbers first.',
+  group: 'Finance',
+  filters: [
+    PERIOD_FILTER,
+    { key: 'threshold', label: 'Threshold', type: 'select', options: THRESHOLDS },
+    ...REVENUE_FILTERS,
+  ],
+  columns: [
+    { key: 'period', label: 'Period', type: 'string', sortable: true },
+    { key: 'category', label: 'Revenue category', type: 'string', sortable: true },
+    { key: 'direction', label: 'Movement', type: 'string' },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+    { key: 'priorRevenue', label: 'Prior period', type: 'money' },
+    { key: 'growthPct', label: 'Change', type: 'percent', sortable: true },
+  ],
+  defaultSort: { key: 'period', dir: 'DESC' },
+  query(ctx) {
+    const period = periodExpr(ctx.params);
+    // ORDER BY the same expression this query GROUPs BY — the to_char label, not
+    // the inner date_trunc. Ordering by the unwrapped timestamp raises
+    // "column i.issued_at must appear in the GROUP BY clause". The label formats
+    // are zero-padded, so lexicographic order is chronological order.
+    const prior = `lag(${REVENUE}) OVER (PARTITION BY ${REVENUE_CATEGORY_EXPR} ORDER BY ${period})`;
+    const change = growthPctExpr(REVENUE, prior);
+
+    const inner = baseQuery(ctx)
+      .select(period, 'period')
+      .addSelect(CATEGORY_LABEL_EXPR, 'category')
+      .addSelect(REVENUE_CATEGORY_EXPR, 'categoryKey')
+      .addSelect(`ROUND(${REVENUE})::float8`, 'revenue')
+      .addSelect(`ROUND(COALESCE(${prior}, 0))::float8`, 'priorRevenue')
+      .addSelect(change, 'growthPct')
+      .addSelect(
+        `CASE WHEN ${REVENUE} >= COALESCE(${prior}, 0) THEN 'Spike' ELSE 'Drop' END`,
+        'direction',
+      )
+      .groupBy(period)
+      .addGroupBy(REVENUE_CATEGORY_EXPR);
+
+    // The threshold cannot live in WHERE or HAVING — both are evaluated before
+    // window functions, and `growthPct` is one. Wrapping is the only place the
+    // comparison is legal. A period with no predecessor yields NULL, and
+    // `ABS(NULL) >= n` is NULL, so those rows drop out without an extra guard.
+    return ctx.ds
+      .createQueryBuilder()
+      .select('a.*')
+      .from(`(${inner.getQuery()})`, 'a')
+      .setParameters(inner.getParameters())
+      .where('ABS(a."growthPct") >= :threshold', { threshold: thresholdOf(ctx.params) });
+  },
+
+  async summary(ctx) {
+    const [sql, params] = revenueAnomaliesReport.query(ctx).getQueryAndParameters();
+    const rows: Array<{ spikes: number; drops: number }> = await ctx.ds.query(
+      `SELECT COUNT(*) FILTER (WHERE a.direction = 'Spike')::int AS spikes,
+              COUNT(*) FILTER (WHERE a.direction = 'Drop')::int  AS drops
+       FROM (${sql}) a`,
+      params,
+    );
+    return [
+      { label: 'Spikes', value: Number(rows[0]?.spikes ?? 0) },
+      { label: 'Drops', value: Number(rows[0]?.drops ?? 0) },
+      { label: 'Threshold', value: thresholdOf(ctx.params), unit: '%' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-category.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-category.report.ts
new file mode 100644
index 000000000..0a46f15ec
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-category.report.ts
@@ -0,0 +1,121 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  AVG_PER_UNIT_EXPR,
+  CATEGORY_LABEL_EXPR,
+  CONTAINERS_EXPR,
+  PERIOD_FILTER,
+  REVENUE_CATEGORY_EXPR,
+  REVENUE_FILTERS,
+  REVENUE_SUM,
+  TEU_EXPR,
+  TONS_EXPR,
+  UNIT_LABEL_EXPR,
+  currencyOf,
+  growthPctExpr,
+  periodExpr,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+const REVENUE = 'SUM(il.amount)';
+
+/**
+ * Previous period's revenue for the same category.
+ *
+ * Postgres evaluates window functions after GROUP BY, so `lag(SUM(...))` is
+ * legal alongside the SUM — no self-join, no CTE. Both the PARTITION BY and the
+ * ORDER BY must repeat their grouping expressions verbatim: ordering by the
+ * inner `date_trunc` when the group key is the `to_char` wrapper fails, and
+ * ordinal shorthand (`ORDER BY 1`) is read as a constant inside a window
+ * clause, silently producing an unordered partition.
+ */
+const priorRevenue = (period: string): string =>
+  `lag(${REVENUE}) OVER (PARTITION BY ${REVENUE_CATEGORY_EXPR} ORDER BY ${period})`;
+
+const growthPct = (period: string): string => growthPctExpr(REVENUE, priorRevenue(period));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  return revenueLedgerQb(ctx);
+}
+
+export const revenueByCategoryReport: ReportDefinition = {
+  key: 'revenue-by-category',
+  title: 'Revenue by Category',
+  description:
+    'Billed revenue in the twelve rail revenue categories, per period, with volume and ' +
+    'period-over-period growth. Growth compares against the previous period inside the ' +
+    'selected date range, so the earliest period always reads zero. ' +
+    'Multimodal means a named sea carrier is on the booking.',
+  group: 'Finance',
+  filters: [PERIOD_FILTER, ...REVENUE_FILTERS],
+  columns: [
+    { key: 'period', label: 'Period', type: 'string', sortable: true },
+    { key: 'category', label: 'Revenue category', type: 'string', sortable: true },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+    { key: 'priorRevenue', label: 'Prior period', type: 'money' },
+    { key: 'growthPct', label: 'Growth', type: 'percent' },
+    { key: 'tons', label: 'Tonnage', type: 'tons', sortable: true },
+    { key: 'teu', label: 'TEU', type: 'number', sortable: true },
+    { key: 'containers', label: 'Containers', type: 'number' },
+    { key: 'avgPerUnit', label: 'Avg revenue/unit', type: 'money' },
+    { key: 'unit', label: 'Unit', type: 'string' },
+    { key: 'lines', label: 'Lines', type: 'number' },
+  ],
+  defaultSort: { key: 'revenue', dir: 'DESC' },
+  chart: { type: 'bar', x: 'category', y: ['revenue'] },
+  /**
+   * Row click opens the transaction list for exactly this bucket.
+   *
+   * `period` carries into `period_value` (the bucket, e.g. "2026-08"), NOT into
+   * `period` — that filter is the granularity, and handing it a date string
+   * would silently reset it to monthly. The granularity itself rides along
+   * from the filters already applied.
+   *
+   * `categoryKey` rather than `category`: the visible column holds the business
+   * label, and the target filters on the key.
+   */
+  drill: {
+    to: 'revenue-transactions',
+    carry: { period: 'period_value', categoryKey: 'categoryKey' },
+  },
+  query(ctx) {
+    const period = periodExpr(ctx.params);
+    return baseQuery(ctx)
+      .select(period, 'period')
+      .addSelect(CATEGORY_LABEL_EXPR, 'category')
+      .addSelect(REVENUE_CATEGORY_EXPR, 'categoryKey')
+      .addSelect(`ROUND(${REVENUE})::float8`, 'revenue')
+      .addSelect(`ROUND(COALESCE(${priorRevenue(period)}, 0))::float8`, 'priorRevenue')
+      .addSelect(`COALESCE(${growthPct(period)}, 0)`, 'growthPct')
+      .addSelect(`ROUND(COALESCE(${TONS_EXPR}, 0), 1)::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(${TEU_EXPR}, 0))::int`, 'teu')
+      .addSelect(`ROUND(COALESCE(${CONTAINERS_EXPR}, 0))::int`, 'containers')
+      .addSelect(`COALESCE(${AVG_PER_UNIT_EXPR}, 0)`, 'avgPerUnit')
+      .addSelect(UNIT_LABEL_EXPR, 'unit')
+      .addSelect('COUNT(*)::int', 'lines')
+      .groupBy(period)
+      .addGroupBy(REVENUE_CATEGORY_EXPR);
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(REVENUE_SUM, 'revenue')
+      .addSelect(
+        `ROUND(COALESCE(SUM(il.amount) FILTER (WHERE ${REVENUE_CATEGORY_EXPR} = 'UNCLASSIFIED'), 0))::float8`,
+        'unclassified',
+      )
+      .addSelect(`COUNT(DISTINCT ${REVENUE_CATEGORY_EXPR})::int`, 'categories')
+      // Invoice-level balance is deliberately NOT summed here — the ledger is
+      // at line grain, so a 3-line invoice would count its balance three times.
+      // Outstanding lives on `revenue-reconciliation`, at invoice grain.
+      .getRawOne<{ revenue: number; unclassified: number; categories: number }>();
+
+    const currency = currencyOf(ctx.params);
+    return [
+      { label: 'Total revenue', value: Number(row?.revenue ?? 0), unit: currency },
+      { label: 'Categories', value: Number(row?.categories ?? 0) },
+      // Always shown, even at zero: an audit report must never quietly drop money.
+      { label: 'Unclassified', value: Number(row?.unclassified ?? 0), unit: currency },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-customer.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-customer.report.ts
new file mode 100644
index 000000000..31b9951b8
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-customer.report.ts
@@ -0,0 +1,91 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Booking } from '../../bookings/entities/booking.entity';
+import { Company } from '../../companies/entities/company.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const TONS = 'COALESCE(b.bulk_total_weight_tons, b.cargo_total_weight_vgm)';
+const REVENUE = 'COALESCE(b.adjusted_total_amount, b.total_amount)';
+const NOT_UMBRELLA = "(b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')";
+const DEAD_STATUSES = ['DRAFT', 'CANCELLED', 'REJECTED', 'EXPIRED'];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Booking, 'b')
+    .innerJoin(Company, 'c', 'c.id = b.company_id')
+    .where(`b.deleted_at IS NULL AND ${NOT_UMBRELLA}`);
+
+  if (params.dateFrom) qb.andWhere('b.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('b.created_at < :dateTo', { dateTo: params.dateTo });
+  if (params.direction) qb.andWhere('b.trade_direction = :direction', { direction: params.direction });
+  if (params.freightType) qb.andWhere('b.freight_type = :freightType', { freightType: params.freightType });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) {
+    qb.andWhere('b.status IN (:...statuses)', { statuses });
+  } else {
+    qb.andWhere('b.status NOT IN (:...deadStatuses)', { deadStatuses: DEAD_STATUSES });
+  }
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'b.trade_direction IN (:...directions)' : '1 = 0', {
+      directions,
+    });
+  }
+  return qb;
+}
+
+export const revenueByCustomerReport: ReportDefinition = {
+  key: 'revenue-by-customer',
+  title: 'Revenue by Customer',
+  description: 'Ranked customers by booking revenue',
+  group: 'Commercial',
+  filters: [
+    { key: 'date', label: 'Created', type: 'daterange' },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+    {
+      key: 'freightType',
+      label: 'Freight type',
+      type: 'select',
+      options: [
+        { value: 'CONTAINER', label: 'Container' },
+        { value: 'BULK', label: 'Bulk' },
+      ],
+    },
+    { key: 'statuses', label: 'Status', type: 'multiselect' },
+  ],
+  columns: [
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: 'c.name' },
+    { key: 'bookings', label: 'Bookings', type: 'number', sortable: true },
+    { key: 'tons', label: 'Tonnage', type: 'tons', sortable: true },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+  ],
+  defaultSort: { key: 'revenue', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('c.name', 'customer')
+      .addSelect('COUNT(*)::int', 'bookings')
+      .addSelect(`ROUND(COALESCE(SUM(${TONS}), 0))::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'revenue')
+      .groupBy('c.name');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(DISTINCT c.name)::int', 'customers')
+      .addSelect(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'revenue')
+      .getRawOne();
+    return [
+      { label: 'Customers', value: Number(row?.customers ?? 0) },
+      { label: 'Revenue', value: Number(row?.revenue ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-period.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-period.report.ts
new file mode 100644
index 000000000..541b9ef01
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-period.report.ts
@@ -0,0 +1,112 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  PERIOD_FILTER,
+  REVENUE_CATEGORY_EXPR,
+  REVENUE_FILTERS,
+  REVENUE_SUM,
+  TEU_EXPR,
+  TONS_EXPR,
+  currencyOf,
+  growthPctExpr,
+  nextPeriodOrdinalExpr,
+  periodExpr,
+  periodOrdinalExpr,
+  periodTruncExpr,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+const REVENUE = 'SUM(il.amount)';
+
+/**
+ * A six-period rolling linear trend, projected one period ahead.
+ *
+ * `regr_slope`/`regr_intercept` are Postgres built-ins, so this needs no
+ * dependency and no model store. It is a trend line, not a forecast model: no
+ * seasonality, no confidence interval, and meaningless on fewer than about
+ * four points — hence the row-count guard, which returns NULL rather than a
+ * confident-looking number drawn through two dots.
+ *
+ * The x variable is the period's epoch seconds, not `row_number()`: Postgres
+ * rejects a window function nested inside another window function's arguments
+ * ("window function calls cannot be nested"), and the timestamp is already a
+ * monotonic ordinal.
+ *
+ * ponytail: linear trend only. A seasonal model (Holt-Winters/ARIMA) means a
+ * stats dependency, a training story and an owner for model quality — do that
+ * only if the business names a seasonality requirement.
+ */
+const forecastNext = (params: Record<string, unknown>): string => {
+  const window = `OVER (ORDER BY ${periodTruncExpr(params)} ROWS BETWEEN 5 PRECEDING AND CURRENT ROW)`;
+  const x = periodOrdinalExpr(params);
+  return `CASE WHEN count(*) ${window} >= 4 THEN GREATEST(0, ROUND(
+    (regr_intercept(${REVENUE}, ${x}) ${window})
+    + (regr_slope(${REVENUE}, ${x}) ${window}) * ${nextPeriodOrdinalExpr(params)}
+  ))::float8 END`;
+};
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  return revenueLedgerQb(ctx);
+}
+
+export const revenueByPeriodReport: ReportDefinition = {
+  key: 'revenue-by-period',
+  title: 'Revenue Trend',
+  description:
+    'Total billed revenue per period with period-over-period growth and a rolling ' +
+    'six-period linear projection. The projection is a trend line, not a seasonal ' +
+    'forecast, and is blank until six periods of history exist.',
+  group: 'Finance',
+  filters: [PERIOD_FILTER, ...REVENUE_FILTERS],
+  columns: [
+    { key: 'period', label: 'Period', type: 'string', sortable: true },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+    { key: 'priorRevenue', label: 'Prior period', type: 'money' },
+    { key: 'growthPct', label: 'Growth', type: 'percent' },
+    { key: 'forecastNext', label: 'Projected next', type: 'money' },
+    { key: 'categories', label: 'Categories', type: 'number' },
+    { key: 'tons', label: 'Tonnage', type: 'tons' },
+    { key: 'teu', label: 'TEU', type: 'number' },
+    { key: 'lines', label: 'Lines', type: 'number' },
+  ],
+  defaultSort: { key: 'period', dir: 'ASC' },
+  chart: { type: 'line', x: 'period', y: ['revenue', 'forecastNext'] },
+  drill: { to: 'revenue-transactions', carry: { period: 'period_value' } },
+  query(ctx) {
+    const period = periodExpr(ctx.params);
+    const trunc = periodTruncExpr(ctx.params);
+    const prior = `lag(${REVENUE}) OVER (ORDER BY ${trunc})`;
+    return baseQuery(ctx)
+      .select(period, 'period')
+      .addSelect(`ROUND(${REVENUE})::float8`, 'revenue')
+      .addSelect(`ROUND(COALESCE(${prior}, 0))::float8`, 'priorRevenue')
+      .addSelect(`COALESCE(${growthPctExpr(REVENUE, prior)}, 0)`, 'growthPct')
+      .addSelect(forecastNext(ctx.params), 'forecastNext')
+      .addSelect(`COUNT(DISTINCT ${REVENUE_CATEGORY_EXPR})::int`, 'categories')
+      .addSelect(`ROUND(COALESCE(${TONS_EXPR}, 0), 1)::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(${TEU_EXPR}, 0))::int`, 'teu')
+      .addSelect('COUNT(*)::int', 'lines')
+      // Grouped by the period's start timestamp, so the ordering the windows
+      // above use is a grouping key rather than a bare column reference.
+      .groupBy(trunc);
+  },
+
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(REVENUE_SUM, 'revenue')
+      .addSelect(`COUNT(DISTINCT ${periodTruncExpr(ctx.params)})::int`, 'periods')
+      .getRawOne<{ revenue: number; periods: number }>();
+    const periods = Number(row?.periods ?? 0);
+    const revenue = Number(row?.revenue ?? 0);
+    return [
+      { label: 'Total revenue', value: revenue, unit: currencyOf(ctx.params) },
+      { label: 'Periods', value: periods },
+      {
+        label: 'Average per period',
+        value: periods ? Math.round(revenue / periods) : 0,
+        unit: currencyOf(ctx.params),
+      },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-route.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-route.report.ts
new file mode 100644
index 000000000..3d8a9370a
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-by-route.report.ts
@@ -0,0 +1,79 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  AVG_PER_UNIT_EXPR,
+  CATEGORY_LABEL_EXPR,
+  PERIOD_FILTER,
+  REVENUE_CATEGORY_EXPR,
+  REVENUE_FILTERS,
+  REVENUE_SUM,
+  TEU_EXPR,
+  TONS_EXPR,
+  UNIT_LABEL_EXPR,
+  currencyOf,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+/**
+ * There is no corridor entity in the schema — a corridor IS an
+ * (origin_yard, destination_yard) pair, which is exactly how rates are scoped.
+ */
+const CORRIDOR = `COALESCE(oy.label, 'Unknown') || ' → ' || COALESCE(dy.label, 'Unknown')`;
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  return revenueLedgerQb(ctx);
+}
+
+export const revenueByRouteReport: ReportDefinition = {
+  key: 'revenue-by-route',
+  title: 'Revenue by Route',
+  description:
+    'Billed revenue per corridor and revenue category. A corridor is an ' +
+    'origin/destination station pair — the schema has no separate corridor entity.',
+  group: 'Finance',
+  filters: [PERIOD_FILTER, ...REVENUE_FILTERS],
+  columns: [
+    { key: 'corridor', label: 'Corridor', type: 'string', sortable: true, sortExpr: CORRIDOR },
+    { key: 'origin', label: 'Origin', type: 'string' },
+    { key: 'destination', label: 'Destination', type: 'string' },
+    { key: 'category', label: 'Revenue category', type: 'string', sortable: true },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+    { key: 'tons', label: 'Tonnage', type: 'tons', sortable: true },
+    { key: 'teu', label: 'TEU', type: 'number', sortable: true },
+    { key: 'avgPerUnit', label: 'Avg revenue/unit', type: 'money' },
+    { key: 'unit', label: 'Unit', type: 'string' },
+    { key: 'lines', label: 'Lines', type: 'number' },
+  ],
+  defaultSort: { key: 'revenue', dir: 'DESC' },
+  chart: { type: 'bar', x: 'corridor', y: ['revenue'] },
+  drill: { to: 'revenue-transactions', carry: { categoryKey: 'categoryKey' } },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select(CORRIDOR, 'corridor')
+      .addSelect("COALESCE(oy.label, 'Unknown')", 'origin')
+      .addSelect("COALESCE(dy.label, 'Unknown')", 'destination')
+      .addSelect(CATEGORY_LABEL_EXPR, 'category')
+      .addSelect(REVENUE_CATEGORY_EXPR, 'categoryKey')
+      .addSelect('ROUND(SUM(il.amount))::float8', 'revenue')
+      .addSelect(`ROUND(COALESCE(${TONS_EXPR}, 0), 1)::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(${TEU_EXPR}, 0))::int`, 'teu')
+      .addSelect(`COALESCE(${AVG_PER_UNIT_EXPR}, 0)`, 'avgPerUnit')
+      .addSelect(UNIT_LABEL_EXPR, 'unit')
+      .addSelect('COUNT(*)::int', 'lines')
+      .groupBy(CORRIDOR)
+      .addGroupBy('oy.label')
+      .addGroupBy('dy.label')
+      .addGroupBy(REVENUE_CATEGORY_EXPR);
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(REVENUE_SUM, 'revenue')
+      .addSelect(`COUNT(DISTINCT ${CORRIDOR})::int`, 'corridors')
+      .getRawOne<{ revenue: number; corridors: number }>();
+    return [
+      { label: 'Corridors', value: Number(row?.corridors ?? 0) },
+      { label: 'Total revenue', value: Number(row?.revenue ?? 0), unit: currencyOf(ctx.params) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-reconciliation.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-reconciliation.report.ts
new file mode 100644
index 000000000..73de3f505
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-reconciliation.report.ts
@@ -0,0 +1,93 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  GATEWAY_PAID,
+  PAYER_EXPR,
+  REVENUE_DATE,
+  REVENUE_FILTERS,
+  currencyOf,
+  invoiceLedgerQb,
+} from '../revenue-classification';
+
+/**
+ * The gap between what the invoice says was paid and what the payment gateway
+ * recorded. Non-zero is not automatically wrong — manual settlements are real
+ * — but every one of them should be explainable, which is the point.
+ */
+const VARIANCE = `i.paid_amount - ${GATEWAY_PAID}`;
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const qb = invoiceLedgerQb(ctx);
+  const matched = ctx.params.matched as string | null;
+  if (matched === 'matched') qb.andWhere(`ROUND(${VARIANCE}, 2) = 0`);
+  if (matched === 'unmatched') qb.andWhere(`ROUND(${VARIANCE}, 2) <> 0`);
+  return qb;
+}
+
+export const revenueReconciliationReport: ReportDefinition = {
+  key: 'revenue-reconciliation',
+  title: 'Revenue vs Payment Reconciliation',
+  description:
+    'Every invoice with its recorded settlement set against what the payment gateway ' +
+    'actually confirmed. Invoices are matched on the booking id both sides carry — ' +
+    'invoices.payment_id points at a payment-service intent, not a freight payment row. ' +
+    'Invoices with no booking (warehouse, shipping-line credit) have no gateway record to ' +
+    'match against and will show their full paid amount as variance.',
+  group: 'Finance',
+  filters: [
+    ...REVENUE_FILTERS.filter((f) => f.key !== 'categories' && f.key !== 'methods'),
+    {
+      key: 'matched',
+      label: 'Reconciliation',
+      type: 'select',
+      options: [
+        { value: 'unmatched', label: 'Variance only' },
+        { value: 'matched', label: 'Reconciled only' },
+      ],
+    },
+  ],
+  columns: [
+    { key: 'issuedAt', label: 'Issued', type: 'date', sortable: true, sortExpr: REVENUE_DATE },
+    { key: 'invoiceNumber', label: 'Invoice No.', type: 'string', sortable: true, sortExpr: 'i.invoice_number' },
+    { key: 'bookingRef', label: 'Booking', type: 'string', sortable: true, sortExpr: 'b.reference' },
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: PAYER_EXPR },
+    { key: 'source', label: 'Source', type: 'string', sortable: true, sortExpr: 'i.source' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'i.status' },
+    { key: 'invoiced', label: 'Invoiced', type: 'money', sortable: true, sortExpr: 'i.total_amount' },
+    { key: 'recordedPaid', label: 'Recorded paid', type: 'money', sortable: true, sortExpr: 'i.paid_amount' },
+    { key: 'gatewayPaid', label: 'Gateway paid', type: 'money' },
+    { key: 'variance', label: 'Variance', type: 'money', sortable: true, sortExpr: `ABS(${VARIANCE})` },
+    { key: 'balance', label: 'Outstanding', type: 'money', sortable: true, sortExpr: 'i.balance_amount' },
+  ],
+  defaultSort: { key: 'variance', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select(`to_char(${REVENUE_DATE}, 'YYYY-MM-DD')`, 'issuedAt')
+      .addSelect('i.invoice_number', 'invoiceNumber')
+      .addSelect("COALESCE(b.reference, '—')", 'bookingRef')
+      .addSelect(PAYER_EXPR, 'customer')
+      .addSelect('i.source', 'source')
+      .addSelect('i.status', 'status')
+      .addSelect('ROUND(i.total_amount, 2)::float8', 'invoiced')
+      .addSelect('ROUND(i.paid_amount, 2)::float8', 'recordedPaid')
+      .addSelect(`ROUND(${GATEWAY_PAID}, 2)::float8`, 'gatewayPaid')
+      .addSelect(`ROUND(${VARIANCE}, 2)::float8`, 'variance')
+      .addSelect('ROUND(i.balance_amount, 2)::float8', 'balance');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'invoices')
+      .addSelect(`COUNT(*) FILTER (WHERE ROUND(${VARIANCE}, 2) <> 0)::int`, 'withVariance')
+      .addSelect(`ROUND(COALESCE(SUM(ABS(${VARIANCE})), 0))::float8`, 'variance')
+      .addSelect('ROUND(COALESCE(SUM(i.balance_amount), 0))::float8', 'outstanding')
+      .getRawOne<{ invoices: number; withVariance: number; variance: number; outstanding: number }>();
+    const currency = currencyOf(ctx.params);
+    return [
+      { label: 'Invoices', value: Number(row?.invoices ?? 0) },
+      { label: 'With variance', value: Number(row?.withVariance ?? 0) },
+      { label: 'Total variance', value: Number(row?.variance ?? 0), unit: currency },
+      { label: 'Outstanding', value: Number(row?.outstanding ?? 0), unit: currency },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-summary.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-summary.report.ts
new file mode 100644
index 000000000..512e05be8
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-summary.report.ts
@@ -0,0 +1,62 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Booking } from '../../bookings/entities/booking.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const REVENUE = 'COALESCE(b.adjusted_total_amount, b.total_amount)';
+const NOT_UMBRELLA = "(b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')";
+const DEAD_STATUSES = ['DRAFT', 'CANCELLED', 'REJECTED', 'EXPIRED'];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Booking, 'b')
+    .where(`b.deleted_at IS NULL AND ${NOT_UMBRELLA}`)
+    .andWhere('b.status NOT IN (:...deadStatuses)', { deadStatuses: DEAD_STATUSES });
+
+  if (params.dateFrom) qb.andWhere('b.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('b.created_at < :dateTo', { dateTo: params.dateTo });
+  if (directions !== null) {
+    qb.andWhere(directions.length ? 'b.trade_direction IN (:...directions)' : '1 = 0', { directions });
+  }
+  return qb;
+}
+
+export const revenueSummaryReport: ReportDefinition = {
+  key: 'revenue-summary',
+  title: 'Revenue Summary',
+  description: 'Booking revenue by direction, cargo type and currency',
+  group: 'Finance',
+  filters: [{ key: 'date', label: 'Created', type: 'daterange' }],
+  columns: [
+    { key: 'direction', label: 'Direction', type: 'string', sortable: true },
+    { key: 'freightType', label: 'Cargo type', type: 'string', sortable: true },
+    { key: 'currency', label: 'Currency', type: 'string' },
+    { key: 'bookings', label: 'Bookings', type: 'number', sortable: true },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+  ],
+  defaultSort: { key: 'revenue', dir: 'DESC' },
+  chart: { type: 'bar', x: 'direction', y: ['revenue'] },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('b.trade_direction', 'direction')
+      .addSelect('b.freight_type', 'freightType')
+      .addSelect('b.payment_currency', 'currency')
+      .addSelect('COUNT(*)::int', 'bookings')
+      .addSelect(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'revenue')
+      .groupBy('b.trade_direction')
+      .addGroupBy('b.freight_type')
+      .addGroupBy('b.payment_currency');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(`ROUND(COALESCE(SUM(${REVENUE}), 0))::float8`, 'revenue')
+      .addSelect('COUNT(*)::int', 'bookings')
+      .getRawOne();
+    return [
+      { label: 'Bookings', value: Number(row?.bookings ?? 0) },
+      { label: 'Total revenue', value: Number(row?.revenue ?? 0), unit: 'ETB' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-top-customers.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-top-customers.report.ts
new file mode 100644
index 000000000..ae27d7487
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-top-customers.report.ts
@@ -0,0 +1,70 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  CATEGORY_LABEL_EXPR,
+  PAYER_EXPR,
+  PERIOD_FILTER,
+  REVENUE_CATEGORY_EXPR,
+  REVENUE_FILTERS,
+  REVENUE_SUM,
+  TEU_EXPR,
+  TONS_EXPR,
+  currencyOf,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  return revenueLedgerQb(ctx);
+}
+
+export const revenueTopCustomersReport: ReportDefinition = {
+  key: 'revenue-top-customers',
+  title: 'Top Customers by Revenue',
+  description:
+    'Customers ranked by billed revenue, with their category mix and outstanding share. ' +
+    'The payer is the company or, for shipping-line credit invoices, the shipping line — ' +
+    'an invoice carries exactly one of the two.',
+  group: 'Finance',
+  filters: [PERIOD_FILTER, ...REVENUE_FILTERS],
+  columns: [
+    { key: 'customer', label: 'Customer', type: 'string', sortable: true, sortExpr: PAYER_EXPR },
+    { key: 'category', label: 'Revenue category', type: 'string', sortable: true },
+    { key: 'revenue', label: 'Revenue', type: 'money', sortable: true },
+    { key: 'sharePct', label: 'Share of total', type: 'percent' },
+    { key: 'tons', label: 'Tonnage', type: 'tons' },
+    { key: 'teu', label: 'TEU', type: 'number' },
+    { key: 'invoices', label: 'Invoices', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'revenue', dir: 'DESC' },
+  chart: { type: 'bar', x: 'customer', y: ['revenue'] },
+  drill: { to: 'revenue-transactions', carry: { customer: 'customer', categoryKey: 'categoryKey' } },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select(PAYER_EXPR, 'customer')
+      .addSelect(CATEGORY_LABEL_EXPR, 'category')
+      .addSelect(REVENUE_CATEGORY_EXPR, 'categoryKey')
+      .addSelect('ROUND(SUM(il.amount))::float8', 'revenue')
+      // Share of the whole filtered set, not of the page — a window over no
+      // partition sees every group the query produced.
+      .addSelect(
+        'ROUND(100 * SUM(il.amount) / NULLIF(SUM(SUM(il.amount)) OVER (), 0), 1)::float8',
+        'sharePct',
+      )
+      .addSelect(`ROUND(COALESCE(${TONS_EXPR}, 0), 1)::float8`, 'tons')
+      .addSelect(`ROUND(COALESCE(${TEU_EXPR}, 0))::int`, 'teu')
+      .addSelect('COUNT(DISTINCT i.id)::int', 'invoices')
+      .groupBy(PAYER_EXPR)
+      .addGroupBy(REVENUE_CATEGORY_EXPR);
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(REVENUE_SUM, 'revenue')
+      .addSelect(`COUNT(DISTINCT ${PAYER_EXPR})::int`, 'customers')
+      .getRawOne<{ revenue: number; customers: number }>();
+    return [
+      { label: 'Customers', value: Number(row?.customers ?? 0) },
+      { label: 'Total revenue', value: Number(row?.revenue ?? 0), unit: currencyOf(ctx.params) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/revenue-transactions.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/revenue-transactions.report.ts
new file mode 100644
index 000000000..ad96b5b9e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/revenue-transactions.report.ts
@@ -0,0 +1,131 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportContext, ReportDefinition } from '../report.types';
+import {
+  PAYMENT_CLASS_EXPR,
+  PAYER_EXPR,
+  PERIOD_FILTER,
+  REVENUE_CATEGORIES,
+  REVENUE_CATEGORY_EXPR,
+  REVENUE_DATE,
+  REVENUE_FILTERS,
+  REVENUE_SUM,
+  currencyOf,
+  periodExpr,
+  revenueLedgerQb,
+} from '../revenue-classification';
+
+/**
+ * The gateway payment behind an invoice, for traceability. `invoices.payment_id`
+ * points at a payment-api intent id rather than a `freight.payments` row, so the
+ * reliable link is `payments.ref_id = invoices.source_id` (the booking id).
+ *
+ * Correlated scalar subselects rather than a LATERAL join: TypeORM's query
+ * builder cannot emit LATERAL, and the correlation on `i.source_id` is what
+ * makes this work at all. Successful payments win, then most recent.
+ *
+ * `::text` is not cosmetic — `payments.method` and `payments.status` are real
+ * Postgres enums, so `COALESCE(<enum>, '')` fails with
+ * `invalid input value for enum freight.payments_method_enum: ""`.
+ */
+const latestPayment = (column: string): string => `(
+  SELECT p.${column}::text FROM freight.payments p
+  WHERE p.ref_id = i.source_id
+  ORDER BY (p.status = 'success') DESC, p.created_at DESC
+  LIMIT 1
+)`;
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = revenueLedgerQb(ctx);
+
+  // Drill-down target: the summary reports hand over the exact period bucket
+  // and category key they were showing.
+  if (params.period_value) {
+    qb.andWhere(`${periodExpr(params)} = :periodValue`, { periodValue: params.period_value });
+  }
+  if (params.categoryKey) {
+    qb.andWhere(`${REVENUE_CATEGORY_EXPR} = :categoryKey`, { categoryKey: params.categoryKey });
+  }
+  return qb;
+}
+
+export const revenueTransactionsReport: ReportDefinition = {
+  key: 'revenue-transactions',
+  title: 'Revenue Transactions',
+  description:
+    'Every billed revenue line, at transaction level — booking reference, invoice number, ' +
+    'charge type, cargo, quantity and the payment reference behind it. This is the ' +
+    'drill-down target for the revenue summaries and the audit trail for an export.',
+  group: 'Finance',
+  filters: [
+    PERIOD_FILTER,
+    ...REVENUE_FILTERS,
+    { key: 'period_value', label: 'Period bucket', type: 'text' },
+    {
+      key: 'categoryKey',
+      label: 'Category (exact)',
+      type: 'select',
+      options: REVENUE_CATEGORIES,
+    },
+  ],
+  columns: [
+    { key: 'issuedAt', label: 'Issued', type: 'date', sortable: true, sortExpr: REVENUE_DATE },
+    { key: 'invoiceNumber', label: 'Invoice No.', type: 'string', sortable: true, sortExpr: 'i.invoice_number' },
+    { key: 'bookingRef', label: 'Booking', type: 'string', sortable: true, sortExpr: 'b.reference' },
+    { key: 'bookingId', label: 'Booking ID', type: 'string' },
+    { key: 'payer', label: 'Customer', type: 'string', sortable: true, sortExpr: PAYER_EXPR },
+    { key: 'category', label: 'Revenue category', type: 'string', sortable: true, sortExpr: REVENUE_CATEGORY_EXPR },
+    { key: 'paymentClass', label: 'Payment class', type: 'string' },
+    { key: 'chargeType', label: 'Charge type', type: 'string', sortable: true, sortExpr: 'il.charge_type' },
+    { key: 'cargo', label: 'Cargo', type: 'string' },
+    { key: 'route', label: 'Route', type: 'string' },
+    { key: 'quantity', label: 'Qty', type: 'number' },
+    { key: 'unit', label: 'Unit', type: 'string' },
+    { key: 'unitRate', label: 'Unit rate', type: 'money' },
+    { key: 'amount', label: 'Amount', type: 'money', sortable: true, sortExpr: 'il.amount' },
+    { key: 'currency', label: 'Currency', type: 'string' },
+    { key: 'invoiceStatus', label: 'Invoice status', type: 'string', sortable: true, sortExpr: 'i.status' },
+    { key: 'paymentRef', label: 'Payment ref', type: 'string' },
+    { key: 'paymentMethod', label: 'Method', type: 'string' },
+    { key: 'paymentStatus', label: 'Payment status', type: 'string' },
+  ],
+  defaultSort: { key: 'issuedAt', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select(`to_char(${REVENUE_DATE}, 'YYYY-MM-DD')`, 'issuedAt')
+      .addSelect('i.invoice_number', 'invoiceNumber')
+      .addSelect("COALESCE(b.reference, '—')", 'bookingRef')
+      .addSelect("COALESCE(b.id::text, '')", 'bookingId')
+      .addSelect(PAYER_EXPR, 'payer')
+      .addSelect(REVENUE_CATEGORY_EXPR, 'category')
+      .addSelect(PAYMENT_CLASS_EXPR, 'paymentClass')
+      .addSelect('il.charge_type', 'chargeType')
+      .addSelect("COALESCE(ct.cargo_type_name, b.cargo_free_text, '—')", 'cargo')
+      .addSelect("COALESCE(oy.label, '?') || ' → ' || COALESCE(dy.label, '?')", 'route')
+      .addSelect('il.quantity::float8', 'quantity')
+      .addSelect("COALESCE(il.metadata->>'unit', '')", 'unit')
+      .addSelect('ROUND(il.unit_rate, 2)::float8', 'unitRate')
+      .addSelect('ROUND(il.amount, 2)::float8', 'amount')
+      .addSelect('il.currency', 'currency')
+      .addSelect('i.status', 'invoiceStatus')
+      .addSelect(
+        `COALESCE(${latestPayment('transaction_id')}, ${latestPayment('merchant_order_id')}, '')`,
+        'paymentRef',
+      )
+      .addSelect(`COALESCE(${latestPayment('method')}, '')`, 'paymentMethod')
+      .addSelect(`COALESCE(${latestPayment('status')}, '')`, 'paymentStatus');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select(REVENUE_SUM, 'revenue')
+      .addSelect('COUNT(*)::int', 'lines')
+      .addSelect('COUNT(DISTINCT i.id)::int', 'invoices')
+      .getRawOne<{ revenue: number; lines: number; invoices: number }>();
+    return [
+      { label: 'Lines', value: Number(row?.lines ?? 0) },
+      { label: 'Invoices', value: Number(row?.invoices ?? 0) },
+      { label: 'Revenue', value: Number(row?.revenue ?? 0), unit: currencyOf(ctx.params) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/train-schedule-status.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/train-schedule-status.report.ts
new file mode 100644
index 000000000..88a25d890
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/train-schedule-status.report.ts
@@ -0,0 +1,100 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { TrainSchedule, TRAIN_SCHEDULE_STATUSES } from '../../train-schedules/entities/train-schedule.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// ITLMS's spec lists Scheduled/Dispatched/In Transit/Arrived/Cancelled as the
+// train lifecycle. The platform tracks DRAFT/SCHEDULED/DISPATCHED/ARRIVED/
+// CANCELLED — no separate "in transit" status exists (a dispatched schedule
+// with no actual_arrival_at yet *is* in transit; reported as DISPATCHED).
+const STATUS_OPTIONS = TRAIN_SCHEDULE_STATUSES.map((v) => ({ value: v, label: v }));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(TrainSchedule, 'ts')
+    .leftJoin(Yard, 'o', 'o.id = ts.origin_station_id')
+    .leftJoin(Yard, 'd', 'd.id = ts.destination_station_id')
+    .where('ts.deleted_at IS NULL');
+
+  if (params.dateFrom) {
+    qb.andWhere('ts.scheduled_departure_date >= :dateFrom', { dateFrom: params.dateFrom });
+  }
+  if (params.dateTo) {
+    qb.andWhere('ts.scheduled_departure_date < :dateTo', { dateTo: params.dateTo });
+  }
+  if (params.direction) qb.andWhere('ts.direction = :direction', { direction: params.direction });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('ts.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const trainScheduleStatusReport: ReportDefinition = {
+  key: 'train-schedule-status',
+  title: 'Train Schedules',
+  description: 'Scheduled, dispatched, arrived and cancelled train departures',
+  group: 'Operations',
+  filters: [
+    { key: 'date', label: 'Departure', type: 'daterange' },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'trainNumber', label: 'Train No.', type: 'string', sortable: true, sortExpr: 'ts.train_number' },
+    { key: 'reference', label: 'Reference', type: 'string' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'ts.status' },
+    { key: 'direction', label: 'Direction', type: 'string' },
+    { key: 'origin', label: 'Origin', type: 'string' },
+    { key: 'destination', label: 'Destination', type: 'string' },
+    {
+      key: 'scheduledDeparture',
+      label: 'Scheduled dep.',
+      type: 'date',
+      sortable: true,
+      sortExpr: 'ts.scheduled_departure_date',
+    },
+    { key: 'actualDeparture', label: 'Actual dep.', type: 'date' },
+    { key: 'actualArrival', label: 'Actual arr.', type: 'date' },
+  ],
+  defaultSort: { key: 'scheduledDeparture', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('ts.train_number', 'trainNumber')
+      .addSelect('ts.reference', 'reference')
+      .addSelect('ts.status', 'status')
+      .addSelect('ts.direction', 'direction')
+      .addSelect("COALESCE(o.label, 'Unknown')", 'origin')
+      .addSelect("COALESCE(d.label, 'Unknown')", 'destination')
+      .addSelect(`to_char(ts.scheduled_departure_date, 'YYYY-MM-DD')`, 'scheduledDeparture')
+      .addSelect(`to_char(ts.actual_departure_at, 'YYYY-MM-DD HH24:MI')`, 'actualDeparture')
+      .addSelect(`to_char(ts.actual_arrival_at, 'YYYY-MM-DD HH24:MI')`, 'actualArrival');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect('COUNT(*) FILTER (WHERE ts.status = :scheduled)::int', 'scheduled')
+      .addSelect('COUNT(*) FILTER (WHERE ts.status = :dispatched)::int', 'dispatched')
+      .addSelect('COUNT(*) FILTER (WHERE ts.status = :arrived)::int', 'arrived')
+      .addSelect('COUNT(*) FILTER (WHERE ts.status = :cancelled)::int', 'cancelled')
+      .setParameters({ scheduled: 'SCHEDULED', dispatched: 'DISPATCHED', arrived: 'ARRIVED', cancelled: 'CANCELLED' })
+      .getRawOne();
+    return [
+      { label: 'Total', value: Number(row?.total ?? 0) },
+      { label: 'Scheduled', value: Number(row?.scheduled ?? 0) },
+      { label: 'Dispatched', value: Number(row?.dispatched ?? 0) },
+      { label: 'Arrived', value: Number(row?.arrived ?? 0) },
+      { label: 'Cancelled', value: Number(row?.cancelled ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/train-turnaround.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/train-turnaround.report.ts
new file mode 100644
index 000000000..7dc7b8c3c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/train-turnaround.report.ts
@@ -0,0 +1,86 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { TrainSchedule } from '../../train-schedules/entities/train-schedule.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// "Turnaround" here is departure-to-arrival transit time on the actual (not
+// scheduled) timestamps. Station dwell time (arrival -> the SAME train's next
+// departure) would need pairing consecutive schedules by physical train,
+// which isn't tracked directly — deferred, not modeled as a shortcut.
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(TrainSchedule, 'ts')
+    .leftJoin(Yard, 'o', 'o.id = ts.origin_station_id')
+    .leftJoin(Yard, 'd', 'd.id = ts.destination_station_id')
+    .where('ts.deleted_at IS NULL')
+    .andWhere('ts.actual_departure_at IS NOT NULL')
+    .andWhere('ts.actual_arrival_at IS NOT NULL');
+
+  if (params.dateFrom) qb.andWhere('ts.actual_departure_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('ts.actual_departure_at < :dateTo', { dateTo: params.dateTo });
+  if (params.direction) qb.andWhere('ts.direction = :direction', { direction: params.direction });
+  return qb;
+}
+
+export const trainTurnaroundReport: ReportDefinition = {
+  key: 'train-turnaround',
+  title: 'Train Turnaround',
+  description: 'Actual departure-to-arrival transit time per schedule',
+  group: 'Operations',
+  filters: [
+    { key: 'date', label: 'Departed', type: 'daterange' },
+    {
+      key: 'direction',
+      label: 'Direction',
+      type: 'select',
+      options: [
+        { value: 'IMPORT', label: 'Import' },
+        { value: 'EXPORT', label: 'Export' },
+        { value: 'DOMESTIC', label: 'Domestic' },
+      ],
+    },
+  ],
+  columns: [
+    { key: 'trainNumber', label: 'Train No.', type: 'string', sortable: true, sortExpr: 'ts.train_number' },
+    { key: 'origin', label: 'Origin', type: 'string' },
+    { key: 'destination', label: 'Destination', type: 'string' },
+    {
+      key: 'actualDeparture',
+      label: 'Departed',
+      type: 'date',
+      sortable: true,
+      sortExpr: 'ts.actual_departure_at',
+    },
+    { key: 'actualArrival', label: 'Arrived', type: 'date' },
+    { key: 'transitHours', label: 'Transit (hrs)', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'actualDeparture', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('ts.train_number', 'trainNumber')
+      .addSelect("COALESCE(o.label, 'Unknown')", 'origin')
+      .addSelect("COALESCE(d.label, 'Unknown')", 'destination')
+      .addSelect(`to_char(ts.actual_departure_at, 'YYYY-MM-DD HH24:MI')`, 'actualDeparture')
+      .addSelect(`to_char(ts.actual_arrival_at, 'YYYY-MM-DD HH24:MI')`, 'actualArrival')
+      .addSelect(
+        `ROUND(EXTRACT(EPOCH FROM (ts.actual_arrival_at - ts.actual_departure_at))::numeric / 3600, 1)::float8`,
+        'transitHours',
+      );
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'trips')
+      .addSelect(
+        `ROUND(AVG(EXTRACT(EPOCH FROM (ts.actual_arrival_at - ts.actual_departure_at)))::numeric / 3600, 1)::float8`,
+        'avgHours',
+      )
+      .getRawOne();
+    return [
+      { label: 'Trips', value: Number(row?.trips ?? 0) },
+      { label: 'Avg transit', value: Number(row?.avgHours ?? 0), unit: 'h' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/wagon-fleet-status.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/wagon-fleet-status.report.ts
new file mode 100644
index 000000000..8855c491b
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/wagon-fleet-status.report.ts
@@ -0,0 +1,77 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { WagonStatus } from '@edr/types';
+import { Wagon } from '../../wagons/entities/wagon.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const STATUS_OPTIONS = Object.values(WagonStatus).map((v) => ({
+  value: v,
+  label: v.replace(/_/g, ' '),
+}));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Wagon, 'w')
+    .leftJoin(WagonType, 'wt', 'wt.id = w.wagon_type_id')
+    .leftJoin(Yard, 'y', 'y.id = w.current_yard_id')
+    .where('w.deleted_at IS NULL');
+
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('w.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const wagonFleetStatusReport: ReportDefinition = {
+  key: 'wagon-fleet-status',
+  title: 'Wagon Fleet Status',
+  description: 'Wagon counts by type, station and status',
+  group: 'Operations',
+  filters: [{ key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS }],
+  columns: [
+    { key: 'wagonType', label: 'Wagon type', type: 'string', sortable: true },
+    { key: 'station', label: 'Station', type: 'string', sortable: true },
+    { key: 'status', label: 'Status', type: 'string', sortable: true },
+    { key: 'count', label: 'Count', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'count', dir: 'DESC' },
+  chart: { type: 'bar', x: 'status', y: ['count'] },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('COALESCE(wt.name, \'Unknown\')', 'wagonType')
+      .addSelect("COALESCE(y.label, 'Unassigned')", 'station')
+      .addSelect('w.status', 'status')
+      .addSelect('COUNT(*)::int', 'count')
+      .groupBy('wt.name')
+      .addGroupBy('y.label')
+      .addGroupBy('w.status');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'total')
+      .addSelect('COUNT(*) FILTER (WHERE w.status = :available)::int', 'available')
+      .addSelect('COUNT(*) FILTER (WHERE w.status = :assigned)::int', 'assigned')
+      .addSelect('COUNT(*) FILTER (WHERE w.status = :maintenance)::int', 'maintenance')
+      .addSelect('COUNT(*) FILTER (WHERE w.status = :detained)::int', 'detained')
+      .addSelect('COUNT(*) FILTER (WHERE w.status = :outOfService)::int', 'outOfService')
+      .setParameters({
+        available: WagonStatus.Available,
+        assigned: WagonStatus.Assigned,
+        maintenance: WagonStatus.Maintenance,
+        detained: WagonStatus.Detained,
+        outOfService: WagonStatus.OutOfService,
+      })
+      .getRawOne();
+    return [
+      { label: 'Total wagons', value: Number(row?.total ?? 0) },
+      { label: 'Available', value: Number(row?.available ?? 0) },
+      { label: 'Assigned', value: Number(row?.assigned ?? 0) },
+      { label: 'Under maintenance', value: Number(row?.maintenance ?? 0) },
+      { label: 'Detained', value: Number(row?.detained ?? 0) },
+      { label: 'Out of service', value: Number(row?.outOfService ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/wagon-requests.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/wagon-requests.report.ts
new file mode 100644
index 000000000..df5ac364c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/wagon-requests.report.ts
@@ -0,0 +1,85 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { WagonTransferRequestStatus } from '@edr/types';
+import { WagonTransferRequest } from '../../wagons/entities/wagon-transfer-request.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+const STATUS_OPTIONS = Object.values(WagonTransferRequestStatus).map((v) => ({
+  value: v,
+  label: v.replace(/_/g, ' '),
+}));
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(WagonTransferRequest, 'r')
+    .leftJoin(Yard, 'fy', 'fy.id = r.from_yard_id')
+    .leftJoin(Yard, 'ty', 'ty.id = r.to_yard_id')
+    .leftJoin(WagonType, 'wt', 'wt.id = r.wagon_type_id')
+    .where('r.deleted_at IS NULL');
+
+  if (params.dateFrom) qb.andWhere('r.created_at >= :dateFrom', { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere('r.created_at < :dateTo', { dateTo: params.dateTo });
+  const statuses = params.statuses as string[] | null;
+  if (statuses) qb.andWhere('r.status IN (:...statuses)', { statuses });
+  return qb;
+}
+
+export const wagonRequestsReport: ReportDefinition = {
+  key: 'wagon-requests',
+  title: 'Wagon Requests',
+  description: 'Inter-yard wagon transfer requests and fulfilment delay',
+  group: 'Operations',
+  filters: [
+    { key: 'date', label: 'Requested', type: 'daterange' },
+    { key: 'statuses', label: 'Status', type: 'multiselect', options: STATUS_OPTIONS },
+  ],
+  columns: [
+    { key: 'fromYard', label: 'From', type: 'string', sortable: true, sortExpr: 'fy.label' },
+    { key: 'toYard', label: 'To', type: 'string', sortable: true, sortExpr: 'ty.label' },
+    { key: 'wagonType', label: 'Wagon type', type: 'string' },
+    { key: 'quantity', label: 'Requested', type: 'number' },
+    { key: 'fulfilledQuantity', label: 'Fulfilled', type: 'number' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'r.status' },
+    { key: 'requestedAt', label: 'Requested at', type: 'date', sortable: true, sortExpr: 'r.created_at' },
+    { key: 'fulfilledAt', label: 'Fulfilled at', type: 'date' },
+    { key: 'delayDays', label: 'Delay (days)', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'requestedAt', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('fy.label', 'fromYard')
+      .addSelect('ty.label', 'toYard')
+      .addSelect("COALESCE(wt.name, 'Unknown')", 'wagonType')
+      .addSelect('r.quantity', 'quantity')
+      .addSelect('r.fulfilled_quantity', 'fulfilledQuantity')
+      .addSelect('r.status', 'status')
+      .addSelect(`to_char(r.created_at, 'YYYY-MM-DD')`, 'requestedAt')
+      .addSelect(`to_char(r.fulfilled_at, 'YYYY-MM-DD')`, 'fulfilledAt')
+      .addSelect(
+        `ROUND(EXTRACT(EPOCH FROM (COALESCE(r.fulfilled_at, now()) - r.created_at))::numeric / 86400, 1)::float8`,
+        'delayDays',
+      );
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*)::int', 'requests')
+      .addSelect('COUNT(*) FILTER (WHERE r.status IN (:...openStatuses))::int', 'open')
+      .addSelect(
+        `ROUND(AVG(EXTRACT(EPOCH FROM (COALESCE(r.fulfilled_at, now()) - r.created_at))::numeric / 86400), 1)::float8`,
+        'avgDelayDays',
+      )
+      .setParameters({
+        openStatuses: [WagonTransferRequestStatus.Pending, WagonTransferRequestStatus.PartiallyFulfilled],
+      })
+      .getRawOne();
+    return [
+      { label: 'Requests', value: Number(row?.requests ?? 0) },
+      { label: 'Still open', value: Number(row?.open ?? 0) },
+      { label: 'Avg delay', value: Number(row?.avgDelayDays ?? 0), unit: 'd' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/wagon-status-duration.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/wagon-status-duration.report.ts
new file mode 100644
index 000000000..348f681d1
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/wagon-status-duration.report.ts
@@ -0,0 +1,94 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { WagonStatus } from '@edr/types';
+import { Wagon } from '../../wagons/entities/wagon.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// Only these two statuses have an operational "how long has it been stuck
+// here" question — everything else (Available, Assigned, ...) turns over too
+// fast for a days-in-status view to matter.
+const TRACKED_STATUSES = [WagonStatus.Maintenance, WagonStatus.Detained];
+
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Wagon, 'w')
+    .leftJoin(WagonType, 'wt', 'wt.id = w.wagon_type_id')
+    .leftJoin(Yard, 'y', 'y.id = w.current_yard_id')
+    // Latest time each wagon flipped INTO its current status, per (wagon, status)
+    // pair — a plain (non-correlated) derived table, joined on both columns, so
+    // it stays a normal JOIN rather than needing a LATERAL correlated subquery.
+    .leftJoin(
+      (sub) =>
+        sub
+          .select('l.wagon_id', 'wagon_id')
+          .addSelect('l.to_status', 'to_status')
+          .addSelect('MAX(l.created_at)', 'since')
+          .from('freight.wagon_status_logs', 'l')
+          .groupBy('l.wagon_id')
+          .addGroupBy('l.to_status'),
+      'log',
+      'log.wagon_id = w.id AND log.to_status = w.status',
+    )
+    .where('w.deleted_at IS NULL')
+    .andWhere('w.status IN (:...trackedStatuses)', { trackedStatuses: TRACKED_STATUSES });
+
+  const status = params.status as string | null;
+  if (status) qb.andWhere('w.status = :status', { status });
+  return qb;
+}
+
+export const wagonStatusDurationReport: ReportDefinition = {
+  key: 'wagon-status-duration',
+  title: 'Wagon Status Duration',
+  description: 'How long each wagon has sat in Maintenance or Detained',
+  group: 'Operations',
+  filters: [
+    {
+      key: 'status',
+      label: 'Status',
+      type: 'select',
+      options: TRACKED_STATUSES.map((v) => ({ value: v, label: v.replace(/_/g, ' ') })),
+    },
+  ],
+  columns: [
+    { key: 'wagonNumber', label: 'Wagon', type: 'string', sortable: true, sortExpr: 'w.wagon_number' },
+    { key: 'wagonType', label: 'Wagon type', type: 'string' },
+    { key: 'station', label: 'Station', type: 'string' },
+    { key: 'status', label: 'Status', type: 'string', sortable: true, sortExpr: 'w.status' },
+    { key: 'since', label: 'Since', type: 'date', sortable: true },
+    { key: 'daysInStatus', label: 'Days in status', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'daysInStatus', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('w.wagon_number', 'wagonNumber')
+      .addSelect("COALESCE(wt.name, 'Unknown')", 'wagonType')
+      .addSelect("COALESCE(y.label, 'Unassigned')", 'station')
+      .addSelect('w.status', 'status')
+      .addSelect(`to_char(COALESCE(log.since, w.updated_at), 'YYYY-MM-DD')`, 'since')
+      .addSelect(
+        `FLOOR(EXTRACT(EPOCH FROM (now() - COALESCE(log.since, w.updated_at))) / 86400)::int`,
+        'daysInStatus',
+      );
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(*) FILTER (WHERE w.status = :maintenance)::int', 'maintenance')
+      .addSelect('COUNT(*) FILTER (WHERE w.status = :detained)::int', 'detained')
+      .addSelect(
+        `MAX(FLOOR(EXTRACT(EPOCH FROM (now() - COALESCE(log.since, w.updated_at))) / 86400))::int`,
+        'longest',
+      )
+      .setParameters({ maintenance: WagonStatus.Maintenance, detained: WagonStatus.Detained })
+      .getRawOne();
+    return [
+      { label: 'Under maintenance', value: Number(row?.maintenance ?? 0) },
+      { label: 'Detained', value: Number(row?.detained ?? 0) },
+      { label: 'Longest days in status', value: Number(row?.longest ?? 0), unit: 'd' },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/definitions/wagon-teu-utilization.report.ts b/apps/edr-freight-api/src/modules/reports/definitions/wagon-teu-utilization.report.ts
new file mode 100644
index 000000000..7dabec37c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/definitions/wagon-teu-utilization.report.ts
@@ -0,0 +1,76 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { Wagon } from '../../wagons/entities/wagon.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { TrainSchedule } from '../../train-schedules/entities/train-schedule.entity';
+import { Container } from '../../container-management/entities/container.entity';
+import { ContainerType } from '../../rule-engine/entities/container-type.entity';
+import { ReportContext, ReportDefinition } from '../report.types';
+
+// TEU = container size in feet / 20 (20ft -> 1 TEU, 40ft -> 2 TEU). Scoped to
+// each wagon's CURRENT schedule pin — a live-state view, not a historical one.
+function baseQuery(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params } = ctx;
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Wagon, 'w')
+    .innerJoin(TrainSchedule, 'ts', 'ts.id = w.current_train_schedule_id')
+    .leftJoin(WagonType, 'wt', 'wt.id = w.wagon_type_id')
+    .leftJoin(Container, 'c', 'c.wagon_id = w.id AND c.deleted_at IS NULL')
+    .leftJoin(ContainerType, 'ct', 'ct.id = c.container_type_id')
+    .where('w.deleted_at IS NULL');
+
+  if (params.trainNumber) {
+    qb.andWhere('ts.train_number ILIKE :trainNumber', { trainNumber: `%${params.trainNumber}%` });
+  }
+  if (params.dateFrom) {
+    qb.andWhere('ts.scheduled_departure_date >= :dateFrom', { dateFrom: params.dateFrom });
+  }
+  if (params.dateTo) qb.andWhere('ts.scheduled_departure_date < :dateTo', { dateTo: params.dateTo });
+  return qb;
+}
+
+export const wagonTeuUtilizationReport: ReportDefinition = {
+  key: 'wagon-teu-utilization',
+  title: 'Wagon TEU Utilization',
+  description: 'TEU loaded per wagon on its currently assigned train',
+  group: 'Operations',
+  filters: [
+    { key: 'trainNumber', label: 'Train No.', type: 'text' },
+    { key: 'date', label: 'Departure', type: 'daterange' },
+  ],
+  columns: [
+    { key: 'wagonNumber', label: 'Wagon', type: 'string', sortable: true, sortExpr: 'w.wagon_number' },
+    { key: 'wagonType', label: 'Wagon type', type: 'string' },
+    { key: 'trainNumber', label: 'Train No.', type: 'string', sortable: true, sortExpr: 'ts.train_number' },
+    { key: 'departureDate', label: 'Departure', type: 'date' },
+    { key: 'containers', label: 'Containers', type: 'number', sortable: true },
+    { key: 'teu', label: 'TEU', type: 'number', sortable: true },
+  ],
+  defaultSort: { key: 'teu', dir: 'DESC' },
+  query(ctx) {
+    return baseQuery(ctx)
+      .select('w.wagon_number', 'wagonNumber')
+      .addSelect("COALESCE(wt.name, 'Unknown')", 'wagonType')
+      .addSelect('ts.train_number', 'trainNumber')
+      .addSelect(`to_char(ts.scheduled_departure_date, 'YYYY-MM-DD')`, 'departureDate')
+      .addSelect('COUNT(c.id)::int', 'containers')
+      .addSelect('(COALESCE(SUM(ct.size_ft), 0) / 20.0)::float8', 'teu')
+      .groupBy('w.wagon_number')
+      .addGroupBy('wt.name')
+      .addGroupBy('ts.train_number')
+      .addGroupBy('ts.scheduled_departure_date');
+  },
+  async summary(ctx) {
+    const row = await baseQuery(ctx)
+      .select('COUNT(DISTINCT w.id)::int', 'wagons')
+      .addSelect('COUNT(c.id)::int', 'containers')
+      .addSelect('(COALESCE(SUM(ct.size_ft), 0) / 20.0)::float8', 'teu')
+      .getRawOne();
+    return [
+      { label: 'Wagons', value: Number(row?.wagons ?? 0) },
+      { label: 'Containers', value: Number(row?.containers ?? 0) },
+      { label: 'Total TEU', value: Number(row?.teu ?? 0) },
+    ];
+  },
+};
diff --git a/apps/edr-freight-api/src/modules/reports/dto/report-query.dto.ts b/apps/edr-freight-api/src/modules/reports/dto/report-query.dto.ts
deleted file mode 100644
index 82b1a76ef..000000000
--- a/apps/edr-freight-api/src/modules/reports/dto/report-query.dto.ts
+++ /dev/null
@@ -1,54 +0,0 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsIn, IsOptional, IsString } from 'class-validator';
-
-export class ReportQueryDto {
-  @ApiPropertyOptional({ description: 'Inclusive start date (YYYY-MM-DD). Default: 30 days ago.' })
-  @IsOptional()
-  @IsString()
-  dateFrom?: string;
-
-  @ApiPropertyOptional({ description: 'Inclusive end date (YYYY-MM-DD). Default: today.' })
-  @IsOptional()
-  @IsString()
-  dateTo?: string;
-
-  @ApiPropertyOptional({ enum: ['day', 'week', 'month'], default: 'day' })
-  @IsOptional()
-  @IsIn(['day', 'week', 'month'])
-  granularity?: 'day' | 'week' | 'month';
-
-  @ApiPropertyOptional({ description: 'Comma-separated company UUIDs' })
-  @IsOptional()
-  @IsString()
-  companyIds?: string;
-
-  @ApiPropertyOptional({ description: 'Comma-separated route UUIDs' })
-  @IsOptional()
-  @IsString()
-  routeIds?: string;
-
-  @ApiPropertyOptional({ description: 'Comma-separated yard UUIDs (matches origin or destination)' })
-  @IsOptional()
-  @IsString()
-  yardIds?: string;
-
-  @ApiPropertyOptional({ description: 'Comma-separated cargo type UUIDs' })
-  @IsOptional()
-  @IsString()
-  cargoTypeIds?: string;
-
-  @ApiPropertyOptional({ description: 'Comma-separated status values (report-specific)' })
-  @IsOptional()
-  @IsString()
-  statuses?: string;
-
-  @ApiPropertyOptional({ description: 'Trade direction filter' })
-  @IsOptional()
-  @IsString()
-  direction?: string;
-
-  @ApiPropertyOptional({ enum: ['CONTAINER', 'BULK'] })
-  @IsOptional()
-  @IsIn(['CONTAINER', 'BULK'])
-  freightType?: string;
-}
diff --git a/apps/edr-freight-api/src/modules/reports/dto/report-result.dto.ts b/apps/edr-freight-api/src/modules/reports/dto/report-result.dto.ts
deleted file mode 100644
index cc1c215af..000000000
--- a/apps/edr-freight-api/src/modules/reports/dto/report-result.dto.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-
-export class ReportKpiDto {
-  @ApiProperty()
-  label!: string;
-
-  @ApiProperty()
-  value!: number;
-
-  @ApiPropertyOptional()
-  unit?: string;
-}
-
-export class ReportResultDto {
-  @ApiProperty({ type: [ReportKpiDto] })
-  kpis!: ReportKpiDto[];
-
-  @ApiProperty({
-    type: 'array',
-    items: { type: 'object', additionalProperties: true },
-    description: 'Report rows; columns vary per report key',
-  })
-  rows!: Record<string, unknown>[];
-}
diff --git a/apps/edr-freight-api/src/modules/reports/report-export-request.util.spec.ts b/apps/edr-freight-api/src/modules/reports/report-export-request.util.spec.ts
new file mode 100644
index 000000000..dc6fa6230
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report-export-request.util.spec.ts
@@ -0,0 +1,62 @@
+import { PDF_ROW_CAP, XLSX_ROW_CAP } from './report-export.service';
+import { resolveExportCap, resolveExportColumns, resolveExportFormat } from './report-export-request.util';
+import { ReportColumn } from './report.types';
+
+describe('resolveExportFormat', () => {
+  it('only \'pdf\' exports as pdf', () => {
+    expect(resolveExportFormat('pdf')).toBe('pdf');
+  });
+
+  it.each([undefined, 'xlsx', 'csv', ''])('%p falls back to xlsx', (raw) => {
+    expect(resolveExportFormat(raw)).toBe('xlsx');
+  });
+});
+
+describe('resolveExportCap', () => {
+  it('missing limit uses the full format cap', () => {
+    expect(resolveExportCap('xlsx', undefined)).toBe(XLSX_ROW_CAP);
+    expect(resolveExportCap('pdf', undefined)).toBe(PDF_ROW_CAP);
+  });
+
+  it('a limit under the cap is used as-is', () => {
+    expect(resolveExportCap('pdf', '100')).toBe(100);
+  });
+
+  it('a limit over the cap is clamped down', () => {
+    expect(resolveExportCap('pdf', String(PDF_ROW_CAP + 1000))).toBe(PDF_ROW_CAP);
+    expect(resolveExportCap('xlsx', String(XLSX_ROW_CAP + 1))).toBe(XLSX_ROW_CAP);
+  });
+
+  it.each(['0', '-5', 'not-a-number', ''])('non-positive/invalid limit %p falls back to the cap', (raw) => {
+    expect(resolveExportCap('xlsx', raw)).toBe(XLSX_ROW_CAP);
+  });
+});
+
+describe('resolveExportColumns', () => {
+  const columns: ReportColumn[] = [
+    { key: 'a', label: 'A', type: 'string' },
+    { key: 'b', label: 'B', type: 'number' },
+    { key: 'c', label: 'C', type: 'money' },
+  ];
+  const def = { columns };
+
+  it('missing fields returns every column', () => {
+    expect(resolveExportColumns(def, undefined)).toEqual(columns);
+  });
+
+  it('empty fields string returns every column', () => {
+    expect(resolveExportColumns(def, '')).toEqual(columns);
+  });
+
+  it('a known subset filters to just those columns, in the report\'s own order', () => {
+    expect(resolveExportColumns(def, 'c,a')).toEqual([columns[0], columns[2]]);
+  });
+
+  it('unknown keys are dropped, not passed through', () => {
+    expect(resolveExportColumns(def, 'a,ghost')).toEqual([columns[0]]);
+  });
+
+  it('all-unknown keys falls back to every column instead of a blank sheet', () => {
+    expect(resolveExportColumns(def, 'ghost,also-ghost')).toEqual(columns);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/reports/report-export-request.util.ts b/apps/edr-freight-api/src/modules/reports/report-export-request.util.ts
new file mode 100644
index 000000000..18f2fa322
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report-export-request.util.ts
@@ -0,0 +1,29 @@
+import { PDF_ROW_CAP, XLSX_ROW_CAP } from './report-export.service';
+import { ReportColumn, ReportDefinition } from './report.types';
+
+export type ExportFormat = 'xlsx' | 'pdf';
+
+/** Anything but the literal string 'pdf' exports as xlsx. */
+export function resolveExportFormat(raw: string | undefined): ExportFormat {
+  return raw === 'pdf' ? 'pdf' : 'xlsx';
+}
+
+/** Caller's requested row limit, clamped to the format's hard cap. A
+ * missing/non-positive/non-numeric limit means "as many as the format allows". */
+export function resolveExportCap(format: ExportFormat, rawLimit: string | undefined): number {
+  const formatCap = format === 'pdf' ? PDF_ROW_CAP : XLSX_ROW_CAP;
+  const requested = Number(rawLimit);
+  return requested > 0 ? Math.min(requested, formatCap) : formatCap;
+}
+
+/** Caller's requested column subset, whitelisted against the report's own
+ * columns. Missing, empty, or all-unknown `rawFields` falls back to every
+ * column rather than shipping a blank sheet. */
+export function resolveExportColumns(
+  def: Pick<ReportDefinition, 'columns'>,
+  rawFields: string | undefined,
+): ReportColumn[] {
+  const requested = rawFields?.split(',').filter(Boolean);
+  const filtered = requested?.length ? def.columns.filter((c) => requested.includes(c.key)) : def.columns;
+  return filtered.length ? filtered : def.columns;
+}
diff --git a/apps/edr-freight-api/src/modules/reports/report-export.service.ts b/apps/edr-freight-api/src/modules/reports/report-export.service.ts
new file mode 100644
index 000000000..f0919c9c7
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report-export.service.ts
@@ -0,0 +1,117 @@
+import { Injectable } from '@nestjs/common';
+import ExcelJS from 'exceljs';
+
+import { PdfRenderService } from '../billing/documents/pdf-render.service';
+import { ReportColumn, ReportDefinition, ReportKpi } from './report.types';
+
+// ponytail: in-memory Workbook, cap below. Switch to ExcelJS's streaming
+// WorkbookWriter if a report ever needs to outgrow XLSX_ROW_CAP.
+export const XLSX_ROW_CAP = 50_000;
+// ponytail: HTML→PDF render cost grows with row count; larger exports must
+// use XLSX instead.
+export const PDF_ROW_CAP = 5_000;
+
+const NUMBER_FORMAT: Partial<Record<ReportColumn['type'], string>> = {
+  money: '#,##0.00',
+  tons: '#,##0.0',
+  percent: '0"%"',
+  number: '#,##0',
+};
+
+function formatCell(value: unknown, type: ReportColumn['type']): string {
+  if (value === null || value === undefined) return '';
+  if (type === 'money' || type === 'number') {
+    return Number(value).toLocaleString('en-US', { maximumFractionDigits: 2 });
+  }
+  if (type === 'tons') return `${Number(value).toLocaleString('en-US')} t`;
+  if (type === 'percent') return `${value}%`;
+  return String(value);
+}
+
+@Injectable()
+export class ReportExportService {
+  constructor(private readonly pdfRender: PdfRenderService) {}
+
+  async toXlsx(
+    def: ReportDefinition,
+    rows: Record<string, unknown>[],
+    kpis: ReportKpi[],
+    columns: ReportColumn[] = def.columns,
+  ): Promise<Buffer> {
+    const workbook = new ExcelJS.Workbook();
+    const sheet = workbook.addWorksheet(def.title.slice(0, 31));
+
+    if (kpis.length) {
+      sheet.addRow(kpis.map((k) => `${k.label}: ${k.value.toLocaleString()}${k.unit ? ` ${k.unit}` : ''}`));
+      sheet.addRow([]);
+    }
+
+    const headerRow = sheet.addRow(columns.map((c) => c.label));
+    headerRow.font = { bold: true };
+
+    for (const row of rows) {
+      sheet.addRow(columns.map((c) => row[c.key] ?? null));
+    }
+
+    columns.forEach((col, i) => {
+      const format = NUMBER_FORMAT[col.type];
+      const excelCol = sheet.getColumn(i + 1);
+      excelCol.width = Math.max(col.label.length + 2, 12);
+      if (format) excelCol.numFmt = format;
+    });
+
+    const buffer = await workbook.xlsx.writeBuffer();
+    return Buffer.from(buffer);
+  }
+
+  async toPdf(
+    def: ReportDefinition,
+    rows: Record<string, unknown>[],
+    kpis: ReportKpi[],
+    columns: ReportColumn[] = def.columns,
+  ): Promise<Buffer> {
+    const html = this.buildHtml(def, rows, kpis, columns);
+    return this.pdfRender.htmlToPdfBuffer(html, { label: `report:${def.key}`, landscape: true });
+  }
+
+  private buildHtml(
+    def: ReportDefinition,
+    rows: Record<string, unknown>[],
+    kpis: ReportKpi[],
+    columns: ReportColumn[],
+  ): string {
+    const esc = (v: unknown) =>
+      String(v ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+
+    const kpiHtml = kpis.length
+      ? `<div style="display:flex;gap:24px;margin-bottom:16px">${kpis
+          .map(
+            (k) =>
+              `<div><div style="font-size:11px;color:#666">${esc(k.label)}</div><div style="font-size:16px;font-weight:600">${k.value.toLocaleString()}${k.unit ? ` ${esc(k.unit)}` : ''}</div></div>`,
+          )
+          .join('')}</div>`
+      : '';
+
+    const head = columns.map((c) => `<th>${esc(c.label)}</th>`).join('');
+    const body = rows
+      .map(
+        (row) =>
+          `<tr>${columns.map((c) => `<td>${esc(formatCell(row[c.key], c.type))}</td>`).join('')}</tr>`,
+      )
+      .join('');
+
+    return `<!doctype html><html><head><meta charset="utf-8"><style>
+      body { font-family: Arial, sans-serif; font-size: 10px; color: #111; }
+      h1 { font-size: 16px; margin-bottom: 4px; }
+      p.desc { color: #666; margin-top: 0 0 12px; }
+      table { width: 100%; border-collapse: collapse; }
+      th, td { border: 1px solid #ddd; padding: 4px 6px; text-align: left; }
+      th { background: #f3f3f3; }
+    </style></head><body>
+      <h1>${esc(def.title)}</h1>
+      <p class="desc">${esc(def.description)}</p>
+      ${kpiHtml}
+      <table><thead><tr>${head}</tr></thead><tbody>${body}</tbody></table>
+    </body></html>`;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/reports/report-queries.ts b/apps/edr-freight-api/src/modules/reports/report-queries.ts
deleted file mode 100644
index 9e4a6f617..000000000
--- a/apps/edr-freight-api/src/modules/reports/report-queries.ts
+++ /dev/null
@@ -1,669 +0,0 @@
-import { DataSource } from 'typeorm';
-
-export interface ReportFilters {
-  /** ISO timestamp, inclusive lower bound. null = no lower bound (all time). */
-  dateFrom: string | null;
-  /** ISO timestamp, exclusive upper bound. null = no upper bound. */
-  dateTo: string | null;
-  granularity: 'day' | 'week' | 'month';
-  companyIds: string[] | null;
-  routeIds: string[] | null;
-  yardIds: string[] | null;
-  cargoTypeIds: string[] | null;
-  statuses: string[] | null;
-  /** Trade-scope-resolved directions. null = unrestricted, [] = show nothing. */
-  directions: string[] | null;
-  freightType: string | null;
-}
-
-export interface ReportKpi {
-  label: string;
-  value: number;
-  unit?: string;
-}
-
-export interface ReportResult {
-  kpis: ReportKpi[];
-  rows: Record<string, unknown>[];
-}
-
-type ReportQuery = (ds: DataSource, f: ReportFilters) => Promise<ReportResult>;
-
-// For PER_ITEM bulk bookings cargo_total_weight_vgm holds an item COUNT, and
-// the real tonnage lives in bulk_total_weight_tons — hence the COALESCE order.
-const TONS = 'COALESCE(b.bulk_total_weight_tons, b.cargo_total_weight_vgm)';
-// adjusted_total_amount silently overrides total_amount when set.
-const REVENUE = 'COALESCE(b.adjusted_total_amount, b.total_amount)';
-// GENERAL contract_kind rows are umbrella contracts, not shipments; counting
-// them double-counts every child booking (same guard as overview.repository).
-const NOT_UMBRELLA = "(b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')";
-const DEAD_STATUSES = "'DRAFT','CANCELLED','REJECTED','EXPIRED'";
-
-const num = (v: unknown): number => (v === null || v === undefined ? 0 : Number(v));
-const sum = (rows: Record<string, unknown>[], col: string): number =>
-  rows.reduce((acc, r) => acc + num(r[col]), 0);
-
-/**
- * Shared WHERE for booking-based reports (alias `b`).
- * Params occupy $1..$8 in this fixed order; report SQL continues at $9.
- */
-function bookingWhere(f: ReportFilters): { where: string; params: unknown[] } {
-  return {
-    where: `
-      b.deleted_at IS NULL
-      AND ${NOT_UMBRELLA}
-      AND ($1::timestamptz IS NULL OR b.created_at >= $1)
-      AND ($2::timestamptz IS NULL OR b.created_at < $2)
-      AND ($3::uuid[] IS NULL OR b.company_id = ANY($3))
-      AND ($4::uuid[] IS NULL OR b.cargo_type_id = ANY($4))
-      AND ($5::text[] IS NULL OR b.trade_direction = ANY($5))
-      AND ($6::text IS NULL OR b.freight_type = $6)
-      AND (CASE WHEN $7::text[] IS NULL
-            THEN b.status NOT IN (${DEAD_STATUSES})
-            ELSE b.status = ANY($7) END)
-      AND ($8::uuid[] IS NULL OR b.origin_yard_id = ANY($8) OR b.destination_yard_id = ANY($8))`,
-    params: [
-      f.dateFrom,
-      f.dateTo,
-      f.companyIds,
-      f.cargoTypeIds,
-      f.directions,
-      f.freightType,
-      f.statuses,
-      f.yardIds,
-    ],
-  };
-}
-
-/**
- * Direction scope for rows that reference a booking through a varchar id
- * column (invoices.source_id, payments.ref_id). Rows not pointing at a
- * booking stay visible — they carry no direction to scope by.
- * (Positional-param port of trade-scope.util's bookingRefScopeSql.)
- */
-const refDirScope = (refColumn: string, param: string): string => `
-  (${param}::text[] IS NULL OR NOT EXISTS (
-    SELECT 1 FROM freight.bookings sb
-    WHERE sb.id::text = ${refColumn} AND NOT (sb.trade_direction = ANY(${param}))))`;
-
-const bookingsTrend: ReportQuery = async (ds, f) => {
-  const { where, params } = bookingWhere(f);
-  const rows = await ds.query(
-    `SELECT to_char(date_trunc($9, b.created_at), 'YYYY-MM-DD') AS period,
-            COUNT(*)::int AS bookings,
-            ROUND(COALESCE(SUM(${TONS}), 0))::float8 AS tons,
-            ROUND(COALESCE(SUM(${REVENUE}), 0))::float8 AS revenue
-     FROM freight.bookings b
-     WHERE ${where}
-     GROUP BY 1 ORDER BY 1`,
-    [...params, f.granularity],
-  );
-  return {
-    kpis: [
-      { label: 'Bookings', value: sum(rows, 'bookings') },
-      { label: 'Tonnage', value: sum(rows, 'tons'), unit: 't' },
-      { label: 'Revenue', value: sum(rows, 'revenue'), unit: 'ETB' },
-    ],
-    rows,
-  };
-};
-
-const revenueByCustomer: ReportQuery = async (ds, f) => {
-  const { where, params } = bookingWhere(f);
-  const rows = await ds.query(
-    `SELECT c.name AS customer,
-            COUNT(*)::int AS bookings,
-            ROUND(COALESCE(SUM(${TONS}), 0))::float8 AS tons,
-            ROUND(COALESCE(SUM(${REVENUE}), 0))::float8 AS revenue
-     FROM freight.bookings b
-     JOIN freight.companies c ON c.id = b.company_id
-     WHERE ${where}
-     GROUP BY c.name ORDER BY revenue DESC LIMIT 100`,
-    params,
-  );
-  const total = sum(rows, 'revenue');
-  return {
-    kpis: [
-      { label: 'Customers', value: rows.length },
-      { label: 'Revenue', value: total, unit: 'ETB' },
-      {
-        label: 'Top customer share',
-        value: total > 0 ? Math.round((num(rows[0]?.revenue) / total) * 100) : 0,
-        unit: '%',
-      },
-    ],
-    rows,
-  };
-};
-
-const revenueByLane: ReportQuery = async (ds, f) => {
-  const { where, params } = bookingWhere(f);
-  const rows = await ds.query(
-    `SELECT o.label AS origin, d.label AS destination,
-            COUNT(*)::int AS bookings,
-            ROUND(COALESCE(SUM(${TONS}), 0))::float8 AS tons,
-            ROUND(COALESCE(SUM(${REVENUE}), 0))::float8 AS revenue
-     FROM freight.bookings b
-     JOIN freight.yards o ON o.id = b.origin_yard_id
-     JOIN freight.yards d ON d.id = b.destination_yard_id
-     WHERE ${where}
-     GROUP BY 1, 2 ORDER BY revenue DESC LIMIT 100`,
-    params,
-  );
-  return {
-    kpis: [
-      { label: 'Lanes', value: rows.length },
-      { label: 'Tonnage', value: sum(rows, 'tons'), unit: 't' },
-      { label: 'Revenue', value: sum(rows, 'revenue'), unit: 'ETB' },
-    ],
-    rows,
-  };
-};
-
-const contractUtilization: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT ct.reference, c.name AS customer, ct.status, ct.contract_kind AS kind,
-            to_char(ct.contract_valid_from, 'YYYY-MM-DD') AS valid_from,
-            to_char(ct.contract_valid_until, 'YYYY-MM-DD') AS valid_until,
-            cap.committed::float8 AS committed,
-            booked.tons::float8 AS booked_tons,
-            booked.cnt AS bookings,
-            CASE WHEN cap.committed > 0
-                 THEN ROUND(booked.tons / cap.committed * 100)::float8 END AS utilization_pct
-     FROM freight.contracts ct
-     LEFT JOIN freight.companies c ON c.id = ct.company_id
-     LEFT JOIN LATERAL (
-       SELECT COALESCE(SUM(s.quantity_cap), 0) AS committed
-       FROM freight.contract_cargo_scope s
-       WHERE s.contract_id = ct.id AND s.deleted_at IS NULL) cap ON true
-     LEFT JOIN LATERAL (
-       SELECT COALESCE(SUM(${TONS}), 0) AS tons, COUNT(*)::int AS cnt
-       FROM freight.bookings b
-       WHERE b.contract_id = ct.id AND b.deleted_at IS NULL
-         AND b.status NOT IN (${DEAD_STATUSES})) booked ON true
-     WHERE ct.deleted_at IS NULL
-       AND ct.status NOT IN ('DRAFT')
-       AND ct.contract_valid_from < COALESCE($2::timestamptz, 'infinity')
-       AND (ct.contract_valid_until IS NULL
-            OR ct.contract_valid_until >= COALESCE($1::timestamptz, '-infinity'))
-       AND ($3::uuid[] IS NULL OR ct.company_id = ANY($3))
-       AND ($4::text[] IS NULL OR ct.trade_direction = ANY($4))
-       AND ($5::text[] IS NULL OR ct.status = ANY($5))
-     ORDER BY utilization_pct DESC NULLS LAST LIMIT 200`,
-    [f.dateFrom, f.dateTo, f.companyIds, f.directions, f.statuses],
-  );
-  const capped = rows.filter((r: Record<string, unknown>) => num(r.committed) > 0);
-  return {
-    kpis: [
-      { label: 'Contracts', value: rows.length },
-      {
-        label: 'Avg utilization',
-        value: capped.length
-          ? Math.round(sum(capped, 'utilization_pct') / capped.length)
-          : 0,
-        unit: '%',
-      },
-      { label: 'Booked tonnage', value: sum(rows, 'booked_tons'), unit: 't' },
-    ],
-    rows,
-  };
-};
-
-// ponytail: 60-min departure grace is a constant; make it a query param if ops
-// ever wants a configurable threshold.
-const trainOnTime: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT o.label AS origin, d.label AS destination,
-            COUNT(*)::int AS trips,
-            COUNT(*) FILTER (WHERE ts.actual_departure_at IS NOT NULL)::int AS departed,
-            ROUND(AVG(EXTRACT(EPOCH FROM (ts.actual_departure_at - ts.scheduled_departure_date)) / 60)
-              FILTER (WHERE ts.actual_departure_at IS NOT NULL))::float8 AS avg_dep_delay_min,
-            ROUND(AVG(EXTRACT(EPOCH FROM (ts.actual_arrival_at - ts.scheduled_arrival_date)) / 60)
-              FILTER (WHERE ts.actual_arrival_at IS NOT NULL
-                        AND ts.scheduled_arrival_date IS NOT NULL))::float8 AS avg_arr_delay_min,
-            ROUND(100.0 * COUNT(*) FILTER (WHERE ts.actual_departure_at
-                                             <= ts.scheduled_departure_date + interval '60 minutes')
-              / NULLIF(COUNT(*) FILTER (WHERE ts.actual_departure_at IS NOT NULL), 0))::float8 AS on_time_pct
-     FROM freight.train_schedules ts
-     JOIN freight.yards o ON o.id = ts.origin_station_id
-     JOIN freight.yards d ON d.id = ts.destination_station_id
-     WHERE ts.deleted_at IS NULL
-       AND ts.status IN ('DISPATCHED', 'ARRIVED')
-       AND ($1::timestamptz IS NULL OR ts.scheduled_departure_date >= $1)
-       AND ($2::timestamptz IS NULL OR ts.scheduled_departure_date < $2)
-       AND ($3::uuid[] IS NULL OR ts.route_id = ANY($3))
-       AND ($4::text[] IS NULL OR ts.direction = ANY($4))
-       AND ($5::uuid[] IS NULL OR ts.origin_station_id = ANY($5) OR ts.destination_station_id = ANY($5))
-     GROUP BY 1, 2 ORDER BY trips DESC`,
-    [f.dateFrom, f.dateTo, f.routeIds, f.directions, f.yardIds],
-  );
-  const departed = sum(rows, 'departed');
-  const weighted = rows.reduce(
-    (acc: number, r: Record<string, unknown>) =>
-      acc + (num(r.on_time_pct) * num(r.departed)) / 100,
-    0,
-  );
-  return {
-    kpis: [
-      { label: 'Trips', value: sum(rows, 'trips') },
-      {
-        label: 'On-time departures',
-        value: departed > 0 ? Math.round((weighted / departed) * 100) : 0,
-        unit: '%',
-      },
-      {
-        label: 'Avg departure delay',
-        value: rows.length ? Math.round(sum(rows, 'avg_dep_delay_min') / rows.length) : 0,
-        unit: 'min',
-      },
-    ],
-    rows,
-  };
-};
-
-const scheduleFillRate: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT ts.train_number, ts.reference,
-            to_char(ts.scheduled_departure_date, 'YYYY-MM-DD') AS departure,
-            o.label AS origin, d.label AS destination, ts.direction, ts.status,
-            ts.max_wagons, tset.wagon_count,
-            ROUND(w.cap_tons)::float8 AS capacity_tons,
-            ROUND(w.booked_tons)::float8 AS booked_tons,
-            CASE WHEN w.cap_tons > 0
-                 THEN ROUND(w.booked_tons / w.cap_tons * 100)::float8 END AS fill_pct
-     FROM freight.train_schedules ts
-     JOIN freight.yards o ON o.id = ts.origin_station_id
-     JOIN freight.yards d ON d.id = ts.destination_station_id
-     LEFT JOIN freight.train_sets tset ON tset.id = ts.train_set_id
-     LEFT JOIN LATERAL (
-       SELECT COALESCE(SUM(tw.capacity_tons), 0) AS cap_tons,
-              COALESCE(SUM(tw.assigned_weight_tons), 0) AS booked_tons
-       FROM freight.train_set_wagons tw
-       WHERE tw.train_set_id = ts.train_set_id AND tw.deleted_at IS NULL) w ON true
-     WHERE ts.deleted_at IS NULL
-       AND ts.status <> 'CANCELLED'
-       AND ($1::timestamptz IS NULL OR ts.scheduled_departure_date >= $1)
-       AND ($2::timestamptz IS NULL OR ts.scheduled_departure_date < $2)
-       AND ($3::uuid[] IS NULL OR ts.route_id = ANY($3))
-       AND ($4::text[] IS NULL OR ts.direction = ANY($4))
-       AND ($5::uuid[] IS NULL OR ts.origin_station_id = ANY($5) OR ts.destination_station_id = ANY($5))
-     ORDER BY ts.scheduled_departure_date DESC LIMIT 200`,
-    [f.dateFrom, f.dateTo, f.routeIds, f.directions, f.yardIds],
-  );
-  const withCap = rows.filter((r: Record<string, unknown>) => num(r.capacity_tons) > 0);
-  const capTons = sum(withCap, 'capacity_tons');
-  return {
-    kpis: [
-      { label: 'Schedules', value: rows.length },
-      {
-        label: 'Avg fill rate',
-        value: capTons > 0 ? Math.round((sum(withCap, 'booked_tons') / capTons) * 100) : 0,
-        unit: '%',
-      },
-      { label: 'Booked tonnage', value: sum(rows, 'booked_tons'), unit: 't' },
-    ],
-    rows,
-  };
-};
-
-const tripsPerRoute: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT o.label AS origin, d.label AS destination, ts.direction,
-            COUNT(*)::int AS trips,
-            ROUND(COALESCE(SUM(w.booked_tons), 0))::float8 AS tons_hauled,
-            ROUND(COALESCE(AVG(w.booked_tons), 0))::float8 AS avg_tons_per_trip
-     FROM freight.train_schedules ts
-     JOIN freight.yards o ON o.id = ts.origin_station_id
-     JOIN freight.yards d ON d.id = ts.destination_station_id
-     LEFT JOIN LATERAL (
-       SELECT COALESCE(SUM(tw.assigned_weight_tons), 0) AS booked_tons
-       FROM freight.train_set_wagons tw
-       WHERE tw.train_set_id = ts.train_set_id AND tw.deleted_at IS NULL) w ON true
-     WHERE ts.deleted_at IS NULL
-       AND ts.status IN ('DISPATCHED', 'ARRIVED')
-       AND ($1::timestamptz IS NULL OR ts.scheduled_departure_date >= $1)
-       AND ($2::timestamptz IS NULL OR ts.scheduled_departure_date < $2)
-       AND ($3::uuid[] IS NULL OR ts.route_id = ANY($3))
-       AND ($4::text[] IS NULL OR ts.direction = ANY($4))
-       AND ($5::uuid[] IS NULL OR ts.origin_station_id = ANY($5) OR ts.destination_station_id = ANY($5))
-     GROUP BY 1, 2, 3 ORDER BY trips DESC`,
-    [f.dateFrom, f.dateTo, f.routeIds, f.directions, f.yardIds],
-  );
-  return {
-    kpis: [
-      { label: 'Trips', value: sum(rows, 'trips') },
-      { label: 'Routes served', value: rows.length },
-      { label: 'Tonnage hauled', value: sum(rows, 'tons_hauled'), unit: 't' },
-    ],
-    rows,
-  };
-};
-
-const invoicedVsCollected: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT to_char(date_trunc($5, COALESCE(i.issued_at, i.created_at)), 'YYYY-MM-DD') AS period,
-            COUNT(*)::int AS invoices,
-            ROUND(SUM(i.total_amount))::float8 AS invoiced,
-            ROUND(SUM(i.paid_amount))::float8 AS collected,
-            ROUND(SUM(i.balance_amount))::float8 AS outstanding
-     FROM freight.invoices i
-     WHERE i.deleted_at IS NULL
-       AND i.status NOT IN ('DRAFT', 'CANCELLED')
-       AND ($1::timestamptz IS NULL OR COALESCE(i.issued_at, i.created_at) >= $1)
-       AND ($2::timestamptz IS NULL OR COALESCE(i.issued_at, i.created_at) < $2)
-       AND ($3::uuid[] IS NULL OR i.company_id = ANY($3))
-       AND ${refDirScope('i.source_id', '$4')}
-     GROUP BY 1 ORDER BY 1`,
-    [f.dateFrom, f.dateTo, f.companyIds, f.directions, f.granularity],
-  );
-  const invoiced = sum(rows, 'invoiced');
-  const collected = sum(rows, 'collected');
-  return {
-    kpis: [
-      { label: 'Invoiced', value: invoiced, unit: 'ETB' },
-      { label: 'Collected', value: collected, unit: 'ETB' },
-      {
-        label: 'Collection rate',
-        value: invoiced > 0 ? Math.round((collected / invoiced) * 100) : 0,
-        unit: '%',
-      },
-      { label: 'Outstanding', value: sum(rows, 'outstanding'), unit: 'ETB' },
-    ],
-    rows,
-  };
-};
-
-// Aging is an as-of snapshot: dateTo is the as-of moment (default now),
-// dateFrom is ignored.
-const agingReceivables: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT c.name AS customer,
-            COUNT(*)::int AS invoices,
-            ROUND(SUM(i.balance_amount))::float8 AS outstanding,
-            ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at >= COALESCE($1::timestamptz, now())), 0))::float8 AS current,
-            ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE($1::timestamptz, now())
-              AND i.due_at >= COALESCE($1::timestamptz, now()) - interval '30 days'), 0))::float8 AS overdue_0_30,
-            ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE($1::timestamptz, now()) - interval '30 days'
-              AND i.due_at >= COALESCE($1::timestamptz, now()) - interval '60 days'), 0))::float8 AS overdue_31_60,
-            ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE($1::timestamptz, now()) - interval '60 days'
-              AND i.due_at >= COALESCE($1::timestamptz, now()) - interval '90 days'), 0))::float8 AS overdue_61_90,
-            ROUND(COALESCE(SUM(i.balance_amount) FILTER (WHERE i.due_at < COALESCE($1::timestamptz, now()) - interval '90 days'), 0))::float8 AS overdue_90_plus
-     FROM freight.invoices i
-     JOIN freight.companies c ON c.id = i.company_id
-     WHERE i.deleted_at IS NULL
-       AND i.status IN ('ISSUED', 'PENDING', 'PARTIALLY_PAID', 'OVERDUE')
-       AND i.balance_amount > 0
-       AND ($1::timestamptz IS NULL OR i.created_at < $1)
-       AND ($2::uuid[] IS NULL OR i.company_id = ANY($2))
-       AND ${refDirScope('i.source_id', '$3')}
-     GROUP BY 1 ORDER BY outstanding DESC LIMIT 200`,
-    [f.dateTo, f.companyIds, f.directions],
-  );
-  const outstanding = sum(rows, 'outstanding');
-  return {
-    kpis: [
-      { label: 'Outstanding', value: outstanding, unit: 'ETB' },
-      { label: 'Overdue', value: outstanding - sum(rows, 'current'), unit: 'ETB' },
-      { label: 'Customers with balance', value: rows.length },
-    ],
-    rows,
-  };
-};
-
-const revenueByPaymentMethod: ReportQuery = async (ds, f) => {
-  // payments.status values are lowercase-hyphenated ('success'), unlike every
-  // other status enum in the schema. No deleted_at on this table.
-  const rows = await ds.query(
-    `SELECT p.method::text AS method,
-            COUNT(*)::int AS payments,
-            ROUND(SUM(p.amount))::float8 AS amount
-     FROM freight.payments p
-     WHERE p.status = 'success'
-       AND ($1::timestamptz IS NULL OR p.created_at >= $1)
-       AND ($2::timestamptz IS NULL OR p.created_at < $2)
-       AND ${refDirScope('p.ref_id', '$3')}
-     GROUP BY 1 ORDER BY amount DESC`,
-    [f.dateFrom, f.dateTo, f.directions],
-  );
-  const total = sum(rows, 'amount');
-  return {
-    kpis: [
-      { label: 'Collected', value: total, unit: 'ETB' },
-      { label: 'Payments', value: sum(rows, 'payments') },
-      {
-        label: 'Top method share',
-        value: total > 0 ? Math.round((num(rows[0]?.amount) / total) * 100) : 0,
-        unit: '%',
-      },
-    ],
-    rows,
-  };
-};
-
-// ---------------------------------------------------------------------------
-// Record-level list exports. Same engine, raw rows instead of aggregates.
-// ponytail: flat LIMIT 5000 per list — stream/paginate the export if a table
-// ever outgrows that.
-const LIST_LIMIT = 5000;
-
-const bookingsList: ReportQuery = async (ds, f) => {
-  const { where, params } = bookingWhere(f);
-  const rows = await ds.query(
-    `SELECT b.reference,
-            to_char(b.created_at, 'YYYY-MM-DD') AS created,
-            c.name AS customer, b.status, b.freight_type,
-            b.trade_direction AS direction,
-            o.label AS origin, d.label AS destination,
-            COALESCE(cty.cargo_type_name, b.cargo_free_text) AS cargo,
-            ROUND(${TONS})::float8 AS tons,
-            ROUND(${REVENUE})::float8 AS amount,
-            b.payment_status, b.scheduling_status
-     FROM freight.bookings b
-     JOIN freight.companies c ON c.id = b.company_id
-     JOIN freight.yards o ON o.id = b.origin_yard_id
-     JOIN freight.yards d ON d.id = b.destination_yard_id
-     LEFT JOIN freight.cargo_types cty ON cty.id = b.cargo_type_id
-     WHERE ${where}
-     ORDER BY b.created_at DESC LIMIT ${LIST_LIMIT}`,
-    params,
-  );
-  return {
-    kpis: [
-      { label: 'Bookings', value: rows.length },
-      { label: 'Tonnage', value: sum(rows, 'tons'), unit: 't' },
-      { label: 'Amount', value: sum(rows, 'amount'), unit: 'ETB' },
-    ],
-    rows,
-  };
-};
-
-const contractsList: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT ct.reference, c.name AS customer, ct.contract_kind AS kind,
-            ct.status, ct.trade_direction AS direction, ct.freight_type,
-            to_char(ct.contract_valid_from, 'YYYY-MM-DD') AS valid_from,
-            to_char(ct.contract_valid_until, 'YYYY-MM-DD') AS valid_until,
-            to_char(ct.created_at, 'YYYY-MM-DD') AS created
-     FROM freight.contracts ct
-     LEFT JOIN freight.companies c ON c.id = ct.company_id
-     WHERE ct.deleted_at IS NULL
-       AND ($1::timestamptz IS NULL OR ct.created_at >= $1)
-       AND ($2::timestamptz IS NULL OR ct.created_at < $2)
-       AND ($3::uuid[] IS NULL OR ct.company_id = ANY($3))
-       AND ($4::text[] IS NULL OR ct.trade_direction = ANY($4))
-       AND ($5::text[] IS NULL OR ct.status = ANY($5))
-     ORDER BY ct.created_at DESC LIMIT ${LIST_LIMIT}`,
-    [f.dateFrom, f.dateTo, f.companyIds, f.directions, f.statuses],
-  );
-  const active = rows.filter((r: Record<string, unknown>) =>
-    ['CONTRACT_ACTIVE', 'ACTIVE_SHIPMENT_IN_PROGRESS'].includes(String(r.status)),
-  ).length;
-  return {
-    kpis: [
-      { label: 'Contracts', value: rows.length },
-      { label: 'Active', value: active },
-    ],
-    rows,
-  };
-};
-
-const schedulesList: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT ts.train_number, ts.reference, ts.direction, ts.status,
-            o.label AS origin, d.label AS destination,
-            to_char(ts.scheduled_departure_date, 'YYYY-MM-DD HH24:MI') AS scheduled_departure,
-            to_char(ts.actual_departure_at, 'YYYY-MM-DD HH24:MI') AS actual_departure,
-            to_char(ts.scheduled_arrival_date, 'YYYY-MM-DD HH24:MI') AS scheduled_arrival,
-            to_char(ts.actual_arrival_at, 'YYYY-MM-DD HH24:MI') AS actual_arrival,
-            ts.max_wagons, tset.wagon_count
-     FROM freight.train_schedules ts
-     JOIN freight.yards o ON o.id = ts.origin_station_id
-     JOIN freight.yards d ON d.id = ts.destination_station_id
-     LEFT JOIN freight.train_sets tset ON tset.id = ts.train_set_id
-     WHERE ts.deleted_at IS NULL
-       AND ($1::timestamptz IS NULL OR ts.scheduled_departure_date >= $1)
-       AND ($2::timestamptz IS NULL OR ts.scheduled_departure_date < $2)
-       AND ($3::text[] IS NULL OR ts.direction = ANY($3))
-       AND ($4::text[] IS NULL OR ts.status = ANY($4))
-       AND ($5::uuid[] IS NULL OR ts.origin_station_id = ANY($5) OR ts.destination_station_id = ANY($5))
-     ORDER BY ts.scheduled_departure_date DESC LIMIT ${LIST_LIMIT}`,
-    [f.dateFrom, f.dateTo, f.directions, f.statuses, f.yardIds],
-  );
-  const count = (s: string) =>
-    rows.filter((r: Record<string, unknown>) => r.status === s).length;
-  return {
-    kpis: [
-      { label: 'Schedules', value: rows.length },
-      { label: 'Dispatched', value: count('DISPATCHED') },
-      { label: 'Arrived', value: count('ARRIVED') },
-    ],
-    rows,
-  };
-};
-
-const fleetWagons: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT w.wagon_number, wt.name AS type,
-            wt.capacity_tons::float8 AS capacity_tons,
-            w.status, y.label AS current_yard
-     FROM freight.wagons w
-     JOIN freight.wagon_types wt ON wt.id = w.wagon_type_id
-     LEFT JOIN freight.yards y ON y.id = w.current_yard_id
-     WHERE w.deleted_at IS NULL
-       AND ($1::text[] IS NULL OR w.status = ANY($1))
-       AND ($2::uuid[] IS NULL OR w.current_yard_id = ANY($2))
-     ORDER BY w.wagon_number LIMIT ${LIST_LIMIT}`,
-    [f.statuses, f.yardIds],
-  );
-  const count = (s: string) =>
-    rows.filter((r: Record<string, unknown>) => r.status === s).length;
-  return {
-    kpis: [
-      { label: 'Wagons', value: rows.length },
-      { label: 'Available', value: count('AVAILABLE') },
-      { label: 'Assigned', value: count('ASSIGNED') },
-      { label: 'Maintenance', value: count('MAINTENANCE') },
-    ],
-    rows,
-  };
-};
-
-const fleetLocomotives: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT l.code, l.name, l.locomotive_type,
-            l.max_pull_weight_tons::float8 AS max_pull_tons,
-            l.status, y.label AS current_yard
-     FROM freight.locomotives l
-     LEFT JOIN freight.yards y ON y.id = l.current_yard_id
-     WHERE l.deleted_at IS NULL
-       AND ($1::text[] IS NULL OR l.status = ANY($1))
-       AND ($2::uuid[] IS NULL OR l.current_yard_id = ANY($2))
-     ORDER BY l.code LIMIT ${LIST_LIMIT}`,
-    [f.statuses, f.yardIds],
-  );
-  const available = rows.filter(
-    (r: Record<string, unknown>) => r.status === 'AVAILABLE',
-  ).length;
-  return {
-    kpis: [
-      { label: 'Locomotives', value: rows.length },
-      { label: 'Available', value: available },
-    ],
-    rows,
-  };
-};
-
-const customersList: ReportQuery = async (ds, f) => {
-  const rows = await ds.query(
-    `SELECT c.name, c.type, c.kind, c.status, c.tin,
-            to_char(c.approved_at, 'YYYY-MM-DD') AS approved,
-            to_char(c.created_at, 'YYYY-MM-DD') AS created
-     FROM freight.companies c
-     WHERE c.deleted_at IS NULL
-       AND ($1::timestamptz IS NULL OR c.created_at >= $1)
-       AND ($2::timestamptz IS NULL OR c.created_at < $2)
-       AND ($3::text[] IS NULL OR c.status = ANY($3))
-     ORDER BY c.created_at DESC LIMIT ${LIST_LIMIT}`,
-    [f.dateFrom, f.dateTo, f.statuses],
-  );
-  const active = rows.filter(
-    (r: Record<string, unknown>) => r.status === 'active',
-  ).length;
-  return {
-    kpis: [
-      { label: 'Customers', value: rows.length },
-      { label: 'Active', value: active },
-    ],
-    rows,
-  };
-};
-
-const paymentsList: ReportQuery = async (ds, f) => {
-  // No deleted_at on freight.payments; statuses are lowercase-hyphenated.
-  const rows = await ds.query(
-    `SELECT to_char(p.created_at, 'YYYY-MM-DD HH24:MI') AS created,
-            p.method::text AS method, p.status::text AS status,
-            p.currency::text AS currency,
-            ROUND(p.amount)::float8 AS amount,
-            p.transaction_id, p.merchant_order_id,
-            to_char(p.paid_at, 'YYYY-MM-DD') AS paid
-     FROM freight.payments p
-     WHERE ($1::timestamptz IS NULL OR p.created_at >= $1)
-       AND ($2::timestamptz IS NULL OR p.created_at < $2)
-       AND ($3::text[] IS NULL OR p.status::text = ANY($3))
-       AND ${refDirScope('p.ref_id', '$4')}
-     ORDER BY p.created_at DESC LIMIT ${LIST_LIMIT}`,
-    [f.dateFrom, f.dateTo, f.statuses, f.directions],
-  );
-  const success = rows.filter(
-    (r: Record<string, unknown>) => r.status === 'success',
-  );
-  return {
-    kpis: [
-      { label: 'Payments', value: rows.length },
-      { label: 'Successful', value: success.length },
-      { label: 'Collected', value: sum(success, 'amount'), unit: 'ETB' },
-    ],
-    rows,
-  };
-};
-
-export const REPORT_QUERIES: Record<string, ReportQuery> = {
-  'bookings-list': bookingsList,
-  'contracts-list': contractsList,
-  'schedules-list': schedulesList,
-  'fleet-wagons': fleetWagons,
-  'fleet-locomotives': fleetLocomotives,
-  'customers-list': customersList,
-  'payments-list': paymentsList,
-  'bookings-trend': bookingsTrend,
-  'revenue-by-customer': revenueByCustomer,
-  'revenue-by-lane': revenueByLane,
-  'contract-utilization': contractUtilization,
-  'train-on-time': trainOnTime,
-  'schedule-fill-rate': scheduleFillRate,
-  'trips-per-route': tripsPerRoute,
-  'invoiced-vs-collected': invoicedVsCollected,
-  'aging-receivables': agingReceivables,
-  'revenue-by-payment-method': revenueByPaymentMethod,
-};
diff --git a/apps/edr-freight-api/src/modules/reports/report-runner.service.ts b/apps/edr-freight-api/src/modules/reports/report-runner.service.ts
new file mode 100644
index 000000000..a9b662077
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report-runner.service.ts
@@ -0,0 +1,152 @@
+import { BadRequestException, Injectable } from '@nestjs/common';
+import { InjectDataSource } from '@nestjs/typeorm';
+import { DataSource } from 'typeorm';
+
+import {
+  buildPaginationMeta,
+  normalizePagination,
+} from '../../common/utils/pagination.util';
+import { applyBookingRefDirectionScope } from '../user-trade-access/trade-scope.util';
+import { ReportDefinition, ReportRunResult } from './report.types';
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+/** Raw query params, minus the pagination/sort keys the runner owns. */
+export type RawReportQuery = Record<string, string | undefined>;
+
+/**
+ * Coerce raw query strings into typed filter params per the report's own
+ * filter declarations. Unknown filter keys are ignored — `forbidNonWhitelisted`
+ * can't police a per-report bag, so extras are just dropped, not rejected.
+ */
+function coerceParams(
+  def: ReportDefinition,
+  raw: RawReportQuery,
+): Record<string, unknown> {
+  const params: Record<string, unknown> = {};
+  for (const filter of def.filters) {
+    if (filter.type === 'daterange') {
+      const from = raw[`${filter.key}From`];
+      const to = raw[`${filter.key}To`];
+      params[`${filter.key}From`] = from ? new Date(from).toISOString() : null;
+      // Inclusive end date, exclusive bound in SQL.
+      params[`${filter.key}To`] = to
+        ? new Date(new Date(to).getTime() + DAY_MS).toISOString()
+        : null;
+    } else if (filter.type === 'multiselect') {
+      const csv = raw[filter.key];
+      const items = csv?.split(',').map((s) => s.trim()).filter(Boolean) ?? [];
+      params[filter.key] = items.length ? items : null;
+    } else {
+      params[filter.key] = raw[filter.key]?.trim() || null;
+    }
+  }
+  // idKey, when the report declares one, is a plain string param.
+  if (def.idKey) {
+    params[def.idKey.key] = raw[def.idKey.key]?.trim() || null;
+  }
+  return params;
+}
+
+/**
+ * Sort expression for a column with no explicit `sortExpr`: the SELECT alias
+ * TypeORM emitted for it, quoted. TypeORM always double-quotes `addSelect`
+ * aliases in the generated SQL (preserving case) — ordering by the bare,
+ * unquoted key instead lets Postgres fold it to lowercase and 42703 on any
+ * camelCase alias (e.g. "utilizationPct" -> unquoted "utilizationpct").
+ */
+const aliasSortExpr = (key: string): string => `"${key.replace(/"/g, '""')}"`;
+
+/** Resolve a client-requested sort column against the report's own whitelist. */
+function resolveSort(
+  def: ReportDefinition,
+  sortBy?: string,
+  sortOrder?: string,
+): { key: string; expr: string; dir: 'ASC' | 'DESC' } | null {
+  const dir = sortOrder?.toUpperCase() === 'DESC' ? 'DESC' : 'ASC';
+  const requested = sortBy && def.columns.find((c) => c.key === sortBy && c.sortable);
+  if (requested) {
+    return { key: requested.key, expr: requested.sortExpr ?? aliasSortExpr(requested.key), dir };
+  }
+  if (!def.defaultSort) return null;
+  const fallback = def.columns.find((c) => c.key === def.defaultSort!.key);
+  if (!fallback) return null;
+  return {
+    key: fallback.key,
+    expr: fallback.sortExpr ?? aliasSortExpr(fallback.key),
+    dir: def.defaultSort.dir,
+  };
+}
+
+@Injectable()
+export class ReportRunnerService {
+  constructor(@InjectDataSource() private readonly ds: DataSource) {}
+
+  async run(
+    def: ReportDefinition,
+    raw: RawReportQuery,
+    directions: string[] | null,
+  ): Promise<ReportRunResult> {
+    const params = coerceParams(def, raw);
+    const ctx = { ds: this.ds, params, directions };
+
+    const qb = def.query(ctx);
+    const sort = resolveSort(def, raw.sortBy, raw.sortOrder);
+    if (sort) qb.orderBy(sort.expr, sort.dir);
+
+    const { page: pageNum, pageSize, skip, take } = normalizePagination({
+      page: raw.page ? Number(raw.page) : undefined,
+      pageSize: raw.pageSize ? Number(raw.pageSize) : undefined,
+    });
+
+    const [sql, sqlParams] = qb.getQueryAndParameters();
+    // getCount() re-derives its own (wrong) select list for GROUP BY queries —
+    // wrapping the real query as a subquery counts exactly what will be paged.
+    const countRow = await this.ds.query(
+      `SELECT COUNT(*)::int AS c FROM (${sql}) report_count`,
+      sqlParams,
+    );
+    const total = Number(countRow[0]?.c ?? 0);
+
+    // .offset()/.limit(), not .skip()/.take() — skip/take route raw & grouped
+    // selects through TypeORM's DISTINCT-id subquery path, which is wrong here.
+    const items = await qb.offset(skip).limit(take).getRawMany();
+
+    const kpis = def.summary ? await def.summary(ctx) : [];
+
+    return {
+      columns: def.columns,
+      items,
+      meta: buildPaginationMeta(total, pageNum, pageSize),
+      kpis,
+    };
+  }
+
+  /** Same query, no paging — used by the export path. */
+  async runAll(
+    def: ReportDefinition,
+    raw: RawReportQuery,
+    directions: string[] | null,
+    limit: number,
+  ): Promise<{ columns: typeof def.columns; items: Record<string, unknown>[]; kpis: ReportRunResult['kpis'] }> {
+    const params = coerceParams(def, raw);
+    const ctx = { ds: this.ds, params, directions };
+    const qb = def.query(ctx);
+    // Same sort the on-screen table is using, not always the default — an
+    // export is supposed to match what the user is looking at.
+    const sort = resolveSort(def, raw.sortBy, raw.sortOrder);
+    if (sort) qb.orderBy(sort.expr, sort.dir);
+    const items = await qb.limit(limit).getRawMany();
+    if (items.length >= limit) {
+      throw new BadRequestException(
+        `Export exceeds the ${limit}-row cap for this format. Narrow the filters.`,
+      );
+    }
+    const kpis = def.summary ? await def.summary(ctx) : [];
+    return { columns: def.columns, items, kpis };
+  }
+}
+
+// Re-exported so definitions can scope ACL columns without importing the
+// trade-scope module directly.
+export { applyBookingRefDirectionScope };
diff --git a/apps/edr-freight-api/src/modules/reports/report.registry.spec.ts b/apps/edr-freight-api/src/modules/reports/report.registry.spec.ts
new file mode 100644
index 000000000..ccec53c3d
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report.registry.spec.ts
@@ -0,0 +1,52 @@
+import { REPORT_KEYS } from '../../seed/freight-permissions.registry';
+import { REPORTS, getReport } from './report.registry';
+
+describe('REPORTS', () => {
+  it('has exactly one definition per seeded REPORT_KEYS entry', () => {
+    const defKeys = REPORTS.map((r) => r.key).sort();
+    expect(defKeys).toEqual([...REPORT_KEYS].sort());
+  });
+
+  it('has no duplicate keys', () => {
+    const keys = REPORTS.map((r) => r.key);
+    expect(new Set(keys).size).toBe(keys.length);
+  });
+
+  it('resolves every key via getReport', () => {
+    for (const key of REPORT_KEYS) {
+      expect(getReport(key)?.key).toBe(key);
+    }
+  });
+
+  it('every sortable column and defaultSort point at a real column key', () => {
+    for (const def of REPORTS) {
+      const columnKeys = new Set(def.columns.map((c) => c.key));
+      if (def.defaultSort) {
+        expect(columnKeys.has(def.defaultSort.key)).toBe(true);
+      }
+      // Every column marked sortable must have a resolvable key (itself, since
+      // the runner falls back to `key` when `sortExpr` is absent).
+      for (const col of def.columns.filter((c) => c.sortable)) {
+        expect(col.key.length).toBeGreaterThan(0);
+      }
+    }
+  });
+
+  it('idKey, when declared, is not also listed as a user-facing filter', () => {
+    for (const def of REPORTS) {
+      if (!def.idKey) continue;
+      expect(def.filters.some((f) => f.key === def.idKey!.key)).toBe(false);
+    }
+  });
+
+  it('chart.x and chart.y, when declared, point at real column keys', () => {
+    for (const def of REPORTS) {
+      if (!def.chart) continue;
+      const columnKeys = new Set(def.columns.map((c) => c.key));
+      expect(columnKeys.has(def.chart.x)).toBe(true);
+      for (const y of def.chart.y) {
+        expect(columnKeys.has(y)).toBe(true);
+      }
+    }
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/reports/report.registry.ts b/apps/edr-freight-api/src/modules/reports/report.registry.ts
new file mode 100644
index 000000000..da280a271
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report.registry.ts
@@ -0,0 +1,80 @@
+import { ReportKey } from '../../seed/freight-permissions.registry';
+import { bookingsListReport } from './definitions/bookings-list.report';
+import { revenueByCustomerReport } from './definitions/revenue-by-customer.report';
+import { agingReceivablesReport } from './definitions/aging-receivables.report';
+import { contractUtilizationReport } from './definitions/contract-utilization.report';
+import { wagonFleetStatusReport } from './definitions/wagon-fleet-status.report';
+import { wagonStatusDurationReport } from './definitions/wagon-status-duration.report';
+import { wagonRequestsReport } from './definitions/wagon-requests.report';
+import { locomotiveFleetStatusReport } from './definitions/locomotive-fleet-status.report';
+import { bookingStatusBreakdownReport } from './definitions/booking-status-breakdown.report';
+import { trainScheduleStatusReport } from './definitions/train-schedule-status.report';
+import { trainTurnaroundReport } from './definitions/train-turnaround.report';
+import { wagonTeuUtilizationReport } from './definitions/wagon-teu-utilization.report';
+import { loadedCapacityReport } from './definitions/loaded-capacity.report';
+import { globalLogisticsWagonsReport } from './definitions/global-logistics-wagons.report';
+import { customerStatusReport } from './definitions/customer-status.report';
+import { contractLifecycleReport } from './definitions/contract-lifecycle.report';
+import { customsDocumentsReport } from './definitions/customs-documents.report';
+import { invoicingPipelineReport } from './definitions/invoicing-pipeline.report';
+import { firstLastMileBookingsReport } from './definitions/first-last-mile-bookings.report';
+import { invoicesByStatusReport } from './definitions/invoices-by-status.report';
+import { paymentsByStatusReport } from './definitions/payments-by-status.report';
+import { revenueSummaryReport } from './definitions/revenue-summary.report';
+import { cargoSummaryReport } from './definitions/cargo-summary.report';
+import { revenueByCategoryReport } from './definitions/revenue-by-category.report';
+import { revenueTransactionsReport } from './definitions/revenue-transactions.report';
+import { revenueByPeriodReport } from './definitions/revenue-by-period.report';
+import { revenueByRouteReport } from './definitions/revenue-by-route.report';
+import { revenueTopCustomersReport } from './definitions/revenue-top-customers.report';
+import { paymentClassificationReport } from './definitions/payment-classification.report';
+import { revenueReconciliationReport } from './definitions/revenue-reconciliation.report';
+import { receivablesPayablesReport } from './definitions/receivables-payables.report';
+import { revenueAnomaliesReport } from './definitions/revenue-anomalies.report';
+import { ReportDefinition } from './report.types';
+
+/**
+ * Every report the platform knows about. Adding one = a new file under
+ * definitions/ + a key in REPORT_KEYS (freight-permissions.registry.ts) +
+ * an entry here. Nothing else — no frontend edit, no route, no sidebar edit.
+ */
+export const REPORTS: ReportDefinition[] = [
+  bookingsListReport,
+  revenueByCustomerReport,
+  agingReceivablesReport,
+  contractUtilizationReport,
+  wagonFleetStatusReport,
+  wagonStatusDurationReport,
+  wagonRequestsReport,
+  locomotiveFleetStatusReport,
+  bookingStatusBreakdownReport,
+  trainScheduleStatusReport,
+  trainTurnaroundReport,
+  wagonTeuUtilizationReport,
+  loadedCapacityReport,
+  globalLogisticsWagonsReport,
+  customerStatusReport,
+  contractLifecycleReport,
+  customsDocumentsReport,
+  invoicingPipelineReport,
+  firstLastMileBookingsReport,
+  invoicesByStatusReport,
+  paymentsByStatusReport,
+  revenueSummaryReport,
+  cargoSummaryReport,
+  revenueByCategoryReport,
+  revenueTransactionsReport,
+  revenueByPeriodReport,
+  revenueByRouteReport,
+  revenueTopCustomersReport,
+  paymentClassificationReport,
+  revenueReconciliationReport,
+  receivablesPayablesReport,
+  revenueAnomaliesReport,
+];
+
+const BY_KEY = new Map<ReportKey, ReportDefinition>(REPORTS.map((r) => [r.key, r]));
+
+export function getReport(key: string): ReportDefinition | undefined {
+  return BY_KEY.get(key as ReportKey);
+}
diff --git a/apps/edr-freight-api/src/modules/reports/report.types.ts b/apps/edr-freight-api/src/modules/reports/report.types.ts
new file mode 100644
index 000000000..ca7578461
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/report.types.ts
@@ -0,0 +1,132 @@
+import { DataSource, ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { ReportKey } from '../../seed/freight-permissions.registry';
+
+export type { ReportKey };
+
+export type ReportColumnType =
+  | 'string'
+  | 'number'
+  | 'money'
+  | 'tons'
+  | 'percent'
+  | 'date';
+
+export interface ReportColumn {
+  key: string;
+  label: string;
+  type: ReportColumnType;
+  sortable?: boolean;
+  /** SQL to ORDER BY when this column is sorted, if different from `key`. */
+  sortExpr?: string;
+}
+
+export type ReportFilterType = 'daterange' | 'date' | 'select' | 'multiselect' | 'text';
+
+export interface ReportFilterOption {
+  value: string;
+  label: string;
+}
+
+export interface ReportFilterDef {
+  key: string;
+  label: string;
+  type: ReportFilterType;
+  /** Static option list for select/multiselect. */
+  options?: ReportFilterOption[];
+  /**
+   * Resolves the option list from the database instead of declaring it inline —
+   * for filters whose choices are reference data (stations, cargo types).
+   * Called once per catalog request and cached; the result is serialised into
+   * `options`, so the frontend never sees the difference.
+   */
+  optionsQuery?: (ds: DataSource) => Promise<ReportFilterOption[]>;
+}
+
+/**
+ * Makes a summary row clickable: the row's values are carried into another
+ * report as filter params, which is how "drill down from summary to
+ * transaction level" works. Keys are this report's column keys; values are the
+ * target report's filter keys.
+ */
+export interface ReportDrillDef {
+  to: ReportKey;
+  carry: Record<string, string>;
+}
+
+export interface ReportKpi {
+  label: string;
+  value: number;
+  unit?: string;
+}
+
+export type ReportChartType = 'line' | 'bar';
+
+/**
+ * Plots the SAME rows the table gets — no separate query. `x` and `y` are
+ * column keys from `columns`. A report whose group-by has dimensions beyond
+ * `x` will render one mark per row (e.g. two rows sharing a date because they
+ * differ by direction), which is a busier chart, not a wrong one. Pivoting
+ * rows into one-per-x series is a later add if a report actually needs it.
+ */
+export interface ReportChartDef {
+  type: ReportChartType;
+  x: string;
+  y: string[];
+}
+
+/**
+ * Optional entity scope a report can be embedded against — e.g. a
+ * contract-utilization report shown on a single contract's detail page.
+ * Purely descriptive; `query()` reads the resolved value off `ctx.params`
+ * like any other filter.
+ */
+export interface ReportIdKey {
+  key: string;
+  label: string;
+}
+
+export interface ReportContext {
+  ds: DataSource;
+  /** Filter values, already coerced against `def.filters` (CSV → array, etc). */
+  params: Record<string, unknown>;
+  /** Trade-scope-resolved directions. null = unrestricted, [] = show nothing. */
+  directions: string[] | null;
+}
+
+export interface ReportDefinition {
+  key: ReportKey;
+  title: string;
+  description: string;
+  group: 'Commercial' | 'Operations' | 'Finance';
+  idKey?: ReportIdKey;
+  filters: ReportFilterDef[];
+  columns: ReportColumn[];
+  defaultSort?: { key: string; dir: 'ASC' | 'DESC' };
+  query(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral>;
+  /** KPIs over the same filtered set; shown above the table and in exports. */
+  summary?(ctx: ReportContext): Promise<ReportKpi[]>;
+  /** Optional chart view of the same rows. Table remains the default view. */
+  chart?: ReportChartDef;
+  /** Makes rows clickable, navigating to a transaction-level report. */
+  drill?: ReportDrillDef;
+}
+
+/** Catalog shape served by GET /reports — metadata only, no rows. */
+export type ReportCatalogEntry = Omit<ReportDefinition, 'query' | 'summary'> & {
+  hasSummary: boolean;
+};
+
+export interface ReportRunResult {
+  columns: ReportColumn[];
+  items: Record<string, unknown>[];
+  meta: {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+  };
+  kpis: ReportKpi[];
+}
diff --git a/apps/edr-freight-api/src/modules/reports/reports.controller.ts b/apps/edr-freight-api/src/modules/reports/reports.controller.ts
index dc64773d8..107e11097 100644
--- a/apps/edr-freight-api/src/modules/reports/reports.controller.ts
+++ b/apps/edr-freight-api/src/modules/reports/reports.controller.ts
@@ -1,34 +1,127 @@
-import { Controller, Get, Param, Query } from '@nestjs/common';
-import { ApiBearerAuth, ApiOkResponse, ApiOperation, ApiTags } from '@nestjs/swagger';
+import { Controller, Get, NotFoundException, Param, Query, Res } from '@nestjs/common';
+import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';
+import { InjectDataSource } from '@nestjs/typeorm';
+import { DataSource } from 'typeorm';
 import { CurrentUser } from '@edr/api-common';
+import type { Response } from 'express';
 import type { TCurrentUser } from '@tria-plc/api-common/modules/auth/types/current-user.type';
 
 import { BookingStaff } from '../../common/booking-guards';
-import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
+import { assertFreightPermission, hasFreightPermission } from '../../common/freight-permission.util';
+import { FREIGHT_PERMS, reportPermissionKey } from '../../seed/freight-permissions.registry';
 import { UserTradeAccessService } from '../user-trade-access/user-trade-access.service';
-import { ReportQueryDto } from './dto/report-query.dto';
-import { ReportResultDto } from './dto/report-result.dto';
-import { ReportsService } from './reports.service';
+import { ReportExportService } from './report-export.service';
+import { resolveExportCap, resolveExportColumns, resolveExportFormat } from './report-export-request.util';
+import { RawReportQuery, ReportRunnerService } from './report-runner.service';
+import { REPORTS, getReport } from './report.registry';
+import { ReportCatalogEntry, ReportDefinition, ReportFilterOption } from './report.types';
+
+const toCatalogEntry = (def: ReportDefinition): ReportCatalogEntry => {
+  const { query: _query, summary, ...meta } = def;
+  return { ...meta, hasSummary: Boolean(summary) };
+};
+
+/**
+ * Filters whose choices are reference data resolve their options here rather
+ * than declaring them inline, so the catalog the frontend receives looks the
+ * same either way. Cached for the process lifetime — these are small, rarely
+ * changing lists (23 stations, 18 cargo types), and the catalog is hit on
+ * every page load.
+ */
+const optionsCache = new Map<string, ReportFilterOption[]>();
+
+async function resolveFilterOptions(
+  def: ReportCatalogEntry,
+  ds: DataSource,
+): Promise<ReportCatalogEntry> {
+  if (!def.filters.some((f) => f.optionsQuery)) return def;
+
+  const filters = await Promise.all(
+    def.filters.map(async (filter) => {
+      if (!filter.optionsQuery) return filter;
+      let options = optionsCache.get(filter.key);
+      if (!options) {
+        options = await filter.optionsQuery(ds);
+        optionsCache.set(filter.key, options);
+      }
+      // Drop the resolver itself — it is a function and would not serialise.
+      const { optionsQuery: _resolver, ...rest } = filter;
+      return { ...rest, options };
+    }),
+  );
+  return { ...def, filters };
+}
 
 @ApiTags('Reports')
 @ApiBearerAuth()
 @Controller('reports')
+@BookingStaff(FREIGHT_PERMS.reports.view)
 export class ReportsController {
   constructor(
-    private readonly reportsService: ReportsService,
+    private readonly runner: ReportRunnerService,
+    private readonly exportService: ReportExportService,
     private readonly userTradeAccessService: UserTradeAccessService,
+    @InjectDataSource() private readonly dataSource: DataSource,
   ) {}
 
+  @Get()
+  @ApiOperation({ summary: 'List reports the caller has permission to run' })
+  async catalog(@CurrentUser() user: TCurrentUser): Promise<ReportCatalogEntry[]> {
+    const allowed = REPORTS.filter((def) =>
+      hasFreightPermission(user, reportPermissionKey(def.key)),
+    ).map(toCatalogEntry);
+    return Promise.all(allowed.map((def) => resolveFilterOptions(def, this.dataSource)));
+  }
+
   @Get(':key')
-  @BookingStaff(FREIGHT_PERMS.reports.view)
-  @ApiOperation({ summary: 'Run a canned report by key with optional filters' })
-  @ApiOkResponse({ type: ReportResultDto })
+  @ApiOperation({ summary: 'Run a report by key, paginated/sorted/filtered' })
   async run(
     @Param('key') key: string,
-    @Query() query: ReportQueryDto,
+    @Query() query: RawReportQuery,
     @CurrentUser() user: TCurrentUser,
-  ): Promise<ReportResultDto> {
-    const allowed = await this.userTradeAccessService.resolveAllowedDirections(user);
-    return this.reportsService.run(key, query, allowed);
+  ) {
+    const def = this.resolve(key, user);
+    const directions = await this.userTradeAccessService.resolveAllowedDirections(user);
+    return this.runner.run(def, query, directions);
+  }
+
+  @Get(':key/export')
+  @ApiOperation({ summary: 'Export a report to xlsx or pdf' })
+  async export(
+    @Param('key') key: string,
+    @Query() query: RawReportQuery & { format?: string; fields?: string; limit?: string },
+    @CurrentUser() user: TCurrentUser,
+    @Res() res: Response,
+  ): Promise<void> {
+    const def = this.resolve(key, user);
+    const directions = await this.userTradeAccessService.resolveAllowedDirections(user);
+    const format = resolveExportFormat(query.format);
+    const cap = resolveExportCap(format, query.limit);
+    const exportColumns = resolveExportColumns(def, query.fields);
+
+    const { items, kpis } = await this.runner.runAll(def, query, directions, cap);
+    const buffer =
+      format === 'pdf'
+        ? await this.exportService.toPdf(def, items, kpis, exportColumns)
+        : await this.exportService.toXlsx(def, items, kpis, exportColumns);
+
+    const filename = `${def.key}.${format === 'pdf' ? 'pdf' : 'xlsx'}`;
+    res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+    res.setHeader(
+      'Content-Type',
+      format === 'pdf'
+        ? 'application/pdf'
+        : 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    );
+    res.send(buffer);
+  }
+
+  private resolve(key: string, user: TCurrentUser): ReportDefinition {
+    const def = getReport(key);
+    if (!def) throw new NotFoundException(`Unknown report: ${key}`);
+    // Exact-match on purpose — unlike FreightPermissionGuard's :view/:read
+    // fallback, a report's own key is the only thing that opens it.
+    assertFreightPermission(user, reportPermissionKey(def.key));
+    return def;
   }
 }
diff --git a/apps/edr-freight-api/src/modules/reports/reports.module.ts b/apps/edr-freight-api/src/modules/reports/reports.module.ts
index a7fe792a5..2f98e9e04 100644
--- a/apps/edr-freight-api/src/modules/reports/reports.module.ts
+++ b/apps/edr-freight-api/src/modules/reports/reports.module.ts
@@ -1,13 +1,14 @@
 import { Module } from '@nestjs/common';
 
+import { DocumentsModule } from '../billing/documents/documents.module';
 import { UserTradeAccessModule } from '../user-trade-access/user-trade-access.module';
+import { ReportExportService } from './report-export.service';
+import { ReportRunnerService } from './report-runner.service';
 import { ReportsController } from './reports.controller';
-import { ReportsRepository } from './reports.repository';
-import { ReportsService } from './reports.service';
 
 @Module({
-  imports: [UserTradeAccessModule],
+  imports: [UserTradeAccessModule, DocumentsModule],
   controllers: [ReportsController],
-  providers: [ReportsService, ReportsRepository],
+  providers: [ReportRunnerService, ReportExportService],
 })
 export class ReportsModule {}
diff --git a/apps/edr-freight-api/src/modules/reports/reports.repository.ts b/apps/edr-freight-api/src/modules/reports/reports.repository.ts
deleted file mode 100644
index 65f154b22..000000000
--- a/apps/edr-freight-api/src/modules/reports/reports.repository.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { InjectDataSource } from '@nestjs/typeorm';
-import { DataSource } from 'typeorm';
-
-import { REPORT_QUERIES, ReportFilters, ReportResult } from './report-queries';
-
-@Injectable()
-export class ReportsRepository {
-  constructor(@InjectDataSource() private readonly dataSource: DataSource) {}
-
-  run(key: keyof typeof REPORT_QUERIES, filters: ReportFilters): Promise<ReportResult> {
-    return REPORT_QUERIES[key](this.dataSource, filters);
-  }
-}
diff --git a/apps/edr-freight-api/src/modules/reports/reports.service.ts b/apps/edr-freight-api/src/modules/reports/reports.service.ts
deleted file mode 100644
index 04e6e9a60..000000000
--- a/apps/edr-freight-api/src/modules/reports/reports.service.ts
+++ /dev/null
@@ -1,46 +0,0 @@
-import { Injectable, NotFoundException } from '@nestjs/common';
-
-import { scopedDirections } from '../user-trade-access/trade-scope.util';
-import { ReportQueryDto } from './dto/report-query.dto';
-import { REPORT_QUERIES, ReportFilters, ReportResult } from './report-queries';
-import { ReportsRepository } from './reports.repository';
-import type { Freight } from '@edr/types';
-
-const DAY_MS = 24 * 60 * 60 * 1000;
-
-const list = (csv?: string): string[] | null => {
-  const items = csv?.split(',').map((s) => s.trim()).filter(Boolean) ?? [];
-  return items.length ? items : null;
-};
-
-@Injectable()
-export class ReportsService {
-  constructor(private readonly repository: ReportsRepository) {}
-
-  run(
-    key: string,
-    dto: ReportQueryDto,
-    allowedDirections: Freight.ScheduleTradeDirection[] | null,
-  ): Promise<ReportResult> {
-    if (!(key in REPORT_QUERIES)) {
-      throw new NotFoundException(`Unknown report: ${key}`);
-    }
-    // No default range: absent dates mean all time, so exports cover everything.
-    const to = dto.dateTo ? new Date(dto.dateTo) : null;
-    const from = dto.dateFrom ? new Date(dto.dateFrom) : null;
-    const filters: ReportFilters = {
-      dateFrom: from ? from.toISOString() : null,
-      // dateTo is inclusive in the API; queries treat the bound as exclusive.
-      dateTo: to ? new Date(to.getTime() + DAY_MS).toISOString() : null,
-      granularity: dto.granularity ?? 'day',
-      companyIds: list(dto.companyIds),
-      routeIds: list(dto.routeIds),
-      yardIds: list(dto.yardIds),
-      cargoTypeIds: list(dto.cargoTypeIds),
-      statuses: list(dto.statuses),
-      directions: scopedDirections(allowedDirections, dto.direction),
-      freightType: dto.freightType ?? null,
-    };
-    return this.repository.run(key, filters);
-  }
-}
diff --git a/apps/edr-freight-api/src/modules/reports/revenue-classification.spec.ts b/apps/edr-freight-api/src/modules/reports/revenue-classification.spec.ts
new file mode 100644
index 000000000..42475d591
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/revenue-classification.spec.ts
@@ -0,0 +1,102 @@
+import {
+  BULK_FREIGHT_CHARGES,
+  PAYMENT_CLASSES,
+  PAYMENT_CLASS_EXPR,
+  PERIOD_FILTER,
+  REVENUE_CATEGORIES,
+  REVENUE_CATEGORY_EXPR,
+  periodExpr,
+} from './revenue-classification';
+
+/**
+ * `invoice_lines.charge_type` is an unconstrained varchar written by eight
+ * unrelated code paths. Nothing at the type level stops someone adding a ninth
+ * spelling, whose revenue would then land silently in the ELSE arm.
+ *
+ * This list is every value the codebase writes today. When it grows, these
+ * tests are what fail — which is the whole trade the const-map design makes.
+ */
+const KNOWN_CHARGE_TYPES = [
+  // booking base freight (rate_type codes)
+  'CONTAINER_IMPORT', 'CONTAINER_EXPORT', 'CONTAINER_20FT', 'CONTAINER_40FT',
+  'BULK_IMPORT', 'BULK_EXPORT', 'INTERCITY_BULK', 'INTERCITY_CONTAINER', 'FREIGHT',
+  // surcharges
+  'FUEL_SURCHARGE', 'LASHING', 'OVERWEIGHT_PER_TON', 'HAZARD_SURCHARGE',
+  'REEFER_SURCHARGE', 'PIL_EXTRA_FEE', 'RETURN_SURCHARGE', 'RETURN_SURCHARGE_20FT',
+  'RETURN_SURCHARGE_40FT', 'CONTAINER_WITH_RETURN', 'ADJUSTMENT', 'RATE_ADJUSTMENT',
+  // customs
+  'CUSTOMS_CLEARANCE', 'CUSTOMS_CLEARANCE_20FT', 'CUSTOMS_CLEARANCE_40FT',
+  // mile legs
+  'FIRST_MILE', 'LAST_MILE', 'DELIVERY', 'LAST_MILE_ADVANCE',
+  // warehouse fees
+  'CONTAINER_DEMURRAGE', 'BULK_DEMURRAGE', 'DEMURRAGE', 'STORAGE_FEE',
+  'HANDLING_FEE', 'DOUBLE_HANDLING', 'TRUCK_DETENTION',
+  // other producers
+  'CANCELLATION_FEE', 'SHIPPING_LINE_SERVICE',
+];
+
+/**
+ * Does the expression name this charge type — either as a literal or through
+ * one of its `LIKE 'PREFIX%'` arms?
+ *
+ * Deliberately a substring check, not a SQL parser: a parser would be more
+ * fragile than the expression it is guarding. This catches the failure that
+ * actually happens (a new charge type nobody added to the map) and nothing
+ * pretends it verifies the branch order.
+ */
+function isNamed(expr: string, chargeType: string): boolean {
+  if (expr.includes(`'${chargeType}'`)) return true;
+  return [...expr.matchAll(/LIKE '([^']*)%'/g)].some(([, prefix]) =>
+    chargeType.startsWith(prefix),
+  );
+}
+
+describe('revenue classification', () => {
+  it('names every charge type the codebase writes in the payment-class map', () => {
+    const unmapped = KNOWN_CHARGE_TYPES.filter((c) => !isNamed(PAYMENT_CLASS_EXPR, c));
+    expect(unmapped).toEqual([]);
+  });
+
+  it('names every ancillary charge type in the revenue-category map', () => {
+    // Bulk freight lines carry no category of their own — the CASE falls
+    // through to the booking's cargo type and trade direction for those.
+    const cargoDerived = new Set(BULK_FREIGHT_CHARGES);
+    const unmapped = KNOWN_CHARGE_TYPES.filter(
+      (c) => !cargoDerived.has(c) && !isNamed(REVENUE_CATEGORY_EXPR, c),
+    );
+    expect(unmapped).toEqual([]);
+  });
+
+  it('emits only categories that are offered as filter options', () => {
+    const declared = new Set(REVENUE_CATEGORIES.map((c) => c.value));
+    const emitted = [...REVENUE_CATEGORY_EXPR.matchAll(/THEN '([A-Z_]+)'/g)].map((m) => m[1]);
+    expect(emitted.length).toBeGreaterThan(0);
+    expect(emitted.filter((c) => !declared.has(c))).toEqual([]);
+    expect(declared.has('UNCLASSIFIED')).toBe(true);
+  });
+
+  it('emits only payment classes that are offered as filter options', () => {
+    const declared = new Set(PAYMENT_CLASSES.map((c) => c.value));
+    const emitted = [...PAYMENT_CLASS_EXPR.matchAll(/THEN '([A-Z_]+)'/g)].map((m) => m[1]);
+    expect(emitted.filter((c) => !declared.has(c))).toEqual([]);
+    expect(declared.has('ADDITIONAL')).toBe(true);
+  });
+
+  it('falls back to a whitelisted period unit instead of interpolating input', () => {
+    expect(periodExpr({ period: 'quarter' })).toContain("date_trunc('quarter'");
+    expect(periodExpr({ period: 'year' })).toContain("date_trunc('year'");
+    // Anything unrecognised — including an injection attempt — becomes 'month'.
+    expect(periodExpr({ period: "day'); DROP TABLE freight.invoices; --" })).toContain(
+      "date_trunc('month'",
+    );
+    expect(periodExpr({})).toContain("date_trunc('month'");
+  });
+
+  it('offers exactly the period units the expression understands', () => {
+    const offered = (PERIOD_FILTER.options ?? []).map((o) => o.value);
+    expect(offered.length).toBe(5);
+    for (const unit of offered) {
+      expect(periodExpr({ period: unit })).toContain(`date_trunc('${unit}'`);
+    }
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/reports/revenue-classification.ts b/apps/edr-freight-api/src/modules/reports/revenue-classification.ts
new file mode 100644
index 000000000..ebe52ef6b
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/reports/revenue-classification.ts
@@ -0,0 +1,553 @@
+import { ObjectLiteral, SelectQueryBuilder } from 'typeorm';
+
+import { InvoiceLine } from '../billing/entities/invoice-line.entity';
+import { Invoice } from '../billing/entities/invoice.entity';
+import { Booking } from '../bookings/entities/booking.entity';
+import { Company } from '../companies/entities/company.entity';
+import { ShippingLineCompany } from '../shipping-lines/entities/shipping-line-company.entity';
+import { CargoType } from '../rule-engine/entities/cargo-type.entity';
+import { Yard } from '../rule-engine/entities/yard.entity';
+import { applyBookingRefDirectionScope } from '../user-trade-access/trade-scope.util';
+import { ReportContext, ReportFilterDef, ReportFilterOption } from './report.types';
+
+/**
+ * The shared vocabulary and SQL behind every revenue report.
+ *
+ * The fact table is `invoice_lines`, not `bookings`: `charge_type` is the only
+ * column in the system that separates customs, first/last mile, demurrage,
+ * storage and incidental revenue from base freight. A booking total is one
+ * lump sum and cannot answer the revenue-classification requirement.
+ *
+ * Every consumer builds its FROM through {@link revenueLedgerQb}, so the table
+ * aliases below (`il i b ct oy dy co slc`) are a fixed contract and the SQL
+ * fragments here can reference them directly.
+ */
+
+// ---------------------------------------------------------------------------
+// Revenue categories
+// ---------------------------------------------------------------------------
+
+export const REVENUE_CATEGORIES: ReportFilterOption[] = [
+  { value: 'CONTAINER_IMPORT_MULTIMODAL', label: 'Full Container Import — Multimodal' },
+  { value: 'CONTAINER_IMPORT_UNIMODAL', label: 'Full Container Import — Unimodal' },
+  { value: 'CONTAINER_EXPORT', label: 'Full Container Export' },
+  { value: 'EMPTY_CONTAINER_REEXPORT', label: 'Empty Container Re-export' },
+  { value: 'FERTILIZER', label: 'Fertilizer Transportation' },
+  { value: 'BREAK_BULK', label: 'Break Bulk (Steel, Machineries)' },
+  { value: 'RORO', label: 'RoRo Transportation' },
+  { value: 'OTHER_IMPORT_BULK', label: 'Other Import Bulk Cargo' },
+  { value: 'OTHER_EXPORT_CARGO', label: 'Other Export Cargo' },
+  { value: 'DOMESTIC', label: 'Domestic Cargo Transportation' },
+  { value: 'INCIDENTAL', label: 'Incidental Charges' },
+  { value: 'FIRST_LAST_MILE', label: 'First & Last Mile' },
+  { value: 'CUSTOMS_CLEARANCE', label: 'Customs Clearance' },
+  { value: 'UNCLASSIFIED', label: 'Unclassified' },
+];
+
+/**
+ * `charge_type` is an unconstrained varchar written by eight different code
+ * paths, so the same concept arrives under several spellings — three for
+ * demurrage, four for first/last mile. Every set below absorbs all of them.
+ */
+export const MILE_CHARGES = ['FIRST_MILE', 'LAST_MILE', 'DELIVERY', 'LAST_MILE_ADVANCE'];
+
+export const INCIDENTAL_CHARGES = [
+  'FUEL_SURCHARGE',
+  'LASHING',
+  'OVERWEIGHT_PER_TON',
+  'HAZARD_SURCHARGE',
+  'REEFER_SURCHARGE',
+  'PIL_EXTRA_FEE',
+  'CANCELLATION_FEE',
+  'ADJUSTMENT',
+  'RATE_ADJUSTMENT',
+  'DEMURRAGE',
+  'CONTAINER_DEMURRAGE',
+  'BULK_DEMURRAGE',
+  'TRUCK_DETENTION',
+  'STORAGE_FEE',
+  'HANDLING_FEE',
+  'DOUBLE_HANDLING',
+  'SHIPPING_LINE_SERVICE',
+];
+
+export const DOMESTIC_CHARGES = ['INTERCITY_BULK', 'INTERCITY_CONTAINER'];
+
+export const CONTAINER_FREIGHT_CHARGES = [
+  'CONTAINER_IMPORT',
+  'CONTAINER_EXPORT',
+  'CONTAINER_20FT',
+  'CONTAINER_40FT',
+];
+
+export const BULK_FREIGHT_CHARGES = ['BULK_IMPORT', 'BULK_EXPORT', 'FREIGHT'];
+
+/** Cargo codes the business bills as break bulk, wherever the cargo tree puts them. */
+export const BREAK_BULK_CODES = ['STEEL_BILLET', 'STEEL', 'MACHINERY', 'PIPES', 'TIMBER'];
+
+export const RORO_CODES = ['TRUCK', 'AUTOMOBILE', 'CARS', 'RORO'];
+
+export const FERTILIZER_CODES = ['FERTILIZER'];
+
+/**
+ * Multimodal means EDR carried the sea leg as well as the rail leg. Nothing in
+ * the schema says so directly; a named sea carrier on the booking is the
+ * agreed proxy. One constant, deliberately — flip it here if the business
+ * defines multimodality differently.
+ */
+const MULTIMODAL_PREDICATE = 'b.shipping_line_id IS NOT NULL';
+
+const list = (values: string[]): string => values.map((v) => `'${v}'`).join(', ');
+
+/**
+ * Assigns each invoice line exactly one revenue category. First match wins.
+ *
+ * Charge-derived rules run BEFORE cargo-derived ones on purpose: a customs or
+ * demurrage line billed on a container-import booking is customs/incidental
+ * revenue, not container-import revenue. Reversing the order would fold every
+ * ancillary charge back into the freight categories.
+ *
+ * Nothing falls through silently — an unmatched line lands in UNCLASSIFIED and
+ * every report surfaces that total as a KPI, because an audit report must
+ * never quietly drop money.
+ */
+export const REVENUE_CATEGORY_EXPR = `CASE
+  WHEN il.charge_type LIKE 'CUSTOMS_CLEARANCE%' THEN 'CUSTOMS_CLEARANCE'
+  WHEN il.charge_type IN (${list(MILE_CHARGES)}) THEN 'FIRST_LAST_MILE'
+  WHEN il.charge_type LIKE 'RETURN_SURCHARGE%'
+    OR il.charge_type = 'CONTAINER_WITH_RETURN' THEN 'EMPTY_CONTAINER_REEXPORT'
+  WHEN il.charge_type IN (${list(INCIDENTAL_CHARGES)}) THEN 'INCIDENTAL'
+  WHEN il.charge_type IN (${list(DOMESTIC_CHARGES)})
+    OR (oy.country IS NOT NULL AND oy.country = dy.country) THEN 'DOMESTIC'
+  WHEN il.charge_type IN (${list(CONTAINER_FREIGHT_CHARGES)})
+    OR b.freight_type = 'CONTAINER' THEN
+    CASE
+      WHEN b.trade_direction = 'EXPORT' THEN 'CONTAINER_EXPORT'
+      WHEN ${MULTIMODAL_PREDICATE} THEN 'CONTAINER_IMPORT_MULTIMODAL'
+      ELSE 'CONTAINER_IMPORT_UNIMODAL'
+    END
+  WHEN ct.code IN (${list(FERTILIZER_CODES)}) THEN 'FERTILIZER'
+  WHEN ct.code IN (${list(BREAK_BULK_CODES)}) THEN 'BREAK_BULK'
+  WHEN ct.code IN (${list(RORO_CODES)}) THEN 'RORO'
+  WHEN b.trade_direction = 'EXPORT' THEN 'OTHER_EXPORT_CARGO'
+  WHEN b.trade_direction = 'IMPORT' THEN 'OTHER_IMPORT_BULK'
+  ELSE 'UNCLASSIFIED'
+END`;
+
+const labelCase = (expr: string, options: ReportFilterOption[]): string =>
+  `CASE ${expr}\n  ${options
+    .map((o) => `WHEN '${o.value}' THEN '${o.label.replace(/'/g, "''")}'`)
+    .join('\n  ')}\nEND`;
+
+/** The category as a business label rather than its key, for display columns. */
+export const CATEGORY_LABEL_EXPR = labelCase(REVENUE_CATEGORY_EXPR, REVENUE_CATEGORIES);
+
+/**
+ * Period-over-period change, as a percentage.
+ *
+ * The denominator is `ABS(prior)`, not `prior`. A category can post negative
+ * revenue in a period — a credit note or rate adjustment outweighing its
+ * charges — and dividing by a negative prior flips the sign, reporting a
+ * recovery as a decline. Taking the magnitude keeps the sign of the change
+ * itself.
+ */
+export const growthPctExpr = (revenue: string, prior: string): string =>
+  `ROUND(100 * (${revenue} - ${prior}) / NULLIF(ABS(${prior}), 0), 1)::float8`;
+
+// ---------------------------------------------------------------------------
+// Payment classification
+// ---------------------------------------------------------------------------
+
+export const PAYMENT_CLASSES: ReportFilterOption[] = [
+  { value: 'RAIL_TRANSPORT', label: 'Rail transport' },
+  { value: 'CUSTOMS_CLEARANCE', label: 'Custom clearance' },
+  { value: 'FIRST_LAST_MILE', label: 'First and last mile' },
+  { value: 'OVERWEIGHT', label: 'Overweight' },
+  { value: 'CANCELLATION', label: 'Cancellation' },
+  { value: 'DEMURRAGE', label: 'Demurrage' },
+  { value: 'STORAGE', label: 'Storage' },
+  { value: 'LOADING_UNLOADING', label: 'Loading and unloading' },
+  { value: 'ADDITIONAL', label: 'Additional payment' },
+];
+
+const RAIL_CHARGES = [...CONTAINER_FREIGHT_CHARGES, ...BULK_FREIGHT_CHARGES, ...DOMESTIC_CHARGES];
+
+const DEMURRAGE_CHARGES = ['DEMURRAGE', 'CONTAINER_DEMURRAGE', 'BULK_DEMURRAGE', 'TRUCK_DETENTION'];
+
+/**
+ * Charges that legitimately belong in the spec's "additional payment" bucket.
+ *
+ * Listed explicitly rather than left to the ELSE arm: ELSE also catches charge
+ * types nobody has mapped yet, and those two cases must not be
+ * indistinguishable. Naming these is what lets the spec fail when a genuinely
+ * new charge type appears.
+ */
+export const ADDITIONAL_CHARGES = [
+  'FUEL_SURCHARGE',
+  'HAZARD_SURCHARGE',
+  'REEFER_SURCHARGE',
+  'PIL_EXTRA_FEE',
+  'RETURN_SURCHARGE',
+  'RETURN_SURCHARGE_20FT',
+  'RETURN_SURCHARGE_40FT',
+  'CONTAINER_WITH_RETURN',
+  'ADJUSTMENT',
+  'RATE_ADJUSTMENT',
+  'SHIPPING_LINE_SERVICE',
+];
+
+/**
+ * The nine buckets the revenue spec asks payments to be classified into.
+ *
+ * Caveat worth repeating wherever this is shown: there is no dedicated
+ * loading/unloading charge type in the system. HANDLING_FEE, DOUBLE_HANDLING
+ * and LASHING are the nearest equivalent, so that bucket is an approximation,
+ * not an exact match.
+ */
+export const PAYMENT_CLASS_EXPR = `CASE
+  WHEN il.charge_type LIKE 'CUSTOMS_CLEARANCE%' THEN 'CUSTOMS_CLEARANCE'
+  WHEN il.charge_type IN (${list(MILE_CHARGES)}) THEN 'FIRST_LAST_MILE'
+  WHEN il.charge_type IN (${list(RAIL_CHARGES)}) THEN 'RAIL_TRANSPORT'
+  WHEN il.charge_type = 'OVERWEIGHT_PER_TON' THEN 'OVERWEIGHT'
+  WHEN il.charge_type = 'CANCELLATION_FEE' THEN 'CANCELLATION'
+  WHEN il.charge_type IN (${list(DEMURRAGE_CHARGES)}) THEN 'DEMURRAGE'
+  WHEN il.charge_type = 'STORAGE_FEE' THEN 'STORAGE'
+  WHEN il.charge_type IN ('HANDLING_FEE', 'DOUBLE_HANDLING', 'LASHING')
+    THEN 'LOADING_UNLOADING'
+  WHEN il.charge_type IN (${list(ADDITIONAL_CHARGES)}) THEN 'ADDITIONAL'
+  ELSE 'ADDITIONAL'
+END`;
+
+// ---------------------------------------------------------------------------
+// Period granularity
+// ---------------------------------------------------------------------------
+
+/**
+ * Frozen whitelist. The runner coerces a `select` filter to a trimmed string
+ * or null; that string is used only as an object key here, so the user's value
+ * never reaches SQL — one of five compile-time constants does.
+ *
+ * Every format is zero-padded, so lexicographic order equals chronological
+ * order. The growth window depends on that.
+ */
+const PERIOD_UNITS = {
+  day: { trunc: 'day', fmt: 'YYYY-MM-DD', label: 'Daily', step: '1 day' },
+  week: { trunc: 'week', fmt: 'IYYY-"W"IW', label: 'Weekly', step: '1 week' },
+  month: { trunc: 'month', fmt: 'YYYY-MM', label: 'Monthly', step: '1 month' },
+  // `quarter` is a valid date_trunc unit but NOT a valid interval unit —
+  // INTERVAL '1 quarter' is a syntax error, so the step is spelled in months.
+  quarter: { trunc: 'quarter', fmt: 'YYYY-"Q"Q', label: 'Quarterly', step: '3 months' },
+  year: { trunc: 'year', fmt: 'YYYY', label: 'Yearly', step: '1 year' },
+} as const;
+
+export const PERIOD_FILTER: ReportFilterDef = {
+  key: 'period',
+  label: 'Granularity',
+  type: 'select',
+  options: Object.entries(PERIOD_UNITS).map(([value, u]) => ({ value, label: u.label })),
+};
+
+/** The timestamp every revenue report buckets and filters on. */
+export const REVENUE_DATE = 'COALESCE(i.issued_at, i.created_at)';
+
+/**
+ * The period label expression, as a string.
+ *
+ * Callers must reuse the returned string VERBATIM in the select, the GROUP BY
+ * and any window `ORDER BY`. Two traps make this non-negotiable:
+ *
+ * 1. A window `ORDER BY date_trunc(...)` when the group key is `to_char(date_trunc(...))`
+ *    fails with "column i.issued_at must appear in the GROUP BY clause".
+ * 2. Ordinal shorthand — `OVER (PARTITION BY 2 ORDER BY 1)` — is NOT a
+ *    positional reference inside a window clause. Postgres reads the integers
+ *    as constants, so it partitions by a constant and applies no ordering. It
+ *    type-checks, it EXPLAINs clean, and it returns plausible garbage.
+ */
+export function periodExpr(params: Record<string, unknown>): string {
+  const unit = resolvePeriod(params);
+  return `to_char(${periodTruncExpr(params)}, '${unit.fmt}')`;
+}
+
+function resolvePeriod(params: Record<string, unknown>): (typeof PERIOD_UNITS)[keyof typeof PERIOD_UNITS] {
+  const key = String(params.period ?? '') as keyof typeof PERIOD_UNITS;
+  return PERIOD_UNITS[key] ?? PERIOD_UNITS.month;
+}
+
+/** The period's start timestamp — what to GROUP BY when a report needs it numerically. */
+export const periodTruncExpr = (params: Record<string, unknown>): string =>
+  `date_trunc('${resolvePeriod(params).trunc}', ${REVENUE_DATE})`;
+
+/**
+ * The period as a number, for regression: seconds since epoch at the period's
+ * start. Using the timestamp itself rather than `row_number()` keeps a trend
+ * calculation to a single window level — Postgres rejects a window function
+ * nested inside another window function's arguments.
+ */
+export const periodOrdinalExpr = (params: Record<string, unknown>): string =>
+  `EXTRACT(EPOCH FROM ${periodTruncExpr(params)})`;
+
+/** Same scale, one period later — where a one-step-ahead projection lands. */
+export const nextPeriodOrdinalExpr = (params: Record<string, unknown>): string =>
+  `EXTRACT(EPOCH FROM ${periodTruncExpr(params)} + INTERVAL '${resolvePeriod(params).step}')`;
+
+// ---------------------------------------------------------------------------
+// Volume — measured at line grain, never joined from the booking
+// ---------------------------------------------------------------------------
+
+/**
+ * `invoice_lines.quantity` already carries the billed quantity per line, and
+ * `metadata->>'unit'` says what it counts (PER_TON / PER_CONTAINER / PER_WAGON).
+ * Joining booking-level tonnage instead would multiply it by the number of
+ * lines on the booking.
+ */
+export const TONS_EXPR = `SUM(il.quantity) FILTER (WHERE il.metadata->>'unit' = 'PER_TON')`;
+
+export const CONTAINERS_EXPR = `SUM(il.quantity) FILTER (WHERE il.metadata->>'unit' = 'PER_CONTAINER')`;
+
+/**
+ * TEU is never stored. It is derived from the charge code's size suffix; lines
+ * whose code carries no size (CONTAINER_IMPORT / CONTAINER_EXPORT) count as one
+ * TEU each, which under-counts any 40ft box billed under an unsized code.
+ */
+export const TEU_EXPR = `SUM(il.quantity * CASE WHEN il.charge_type LIKE '%40FT%' THEN 2 ELSE 1 END)
+  FILTER (WHERE il.metadata->>'unit' = 'PER_CONTAINER')`;
+
+/**
+ * Revenue per unit, against whichever unit the category is actually billed in.
+ * Exactly one of tons/TEU is non-null per category, so this is per-ton for bulk
+ * and per-TEU for containers; the `unit` column says which.
+ */
+export const AVG_PER_UNIT_EXPR = `ROUND(
+  SUM(il.amount) / NULLIF(COALESCE(${TONS_EXPR}, 0) + COALESCE(${TEU_EXPR}, 0), 0), 2
+)::float8`;
+
+export const UNIT_LABEL_EXPR = `CASE
+  WHEN COALESCE(${TONS_EXPR}, 0) > 0 THEN 'per ton'
+  WHEN COALESCE(${TEU_EXPR}, 0) > 0 THEN 'per TEU'
+  ELSE ''
+END`;
+
+// ---------------------------------------------------------------------------
+// The shared ledger query
+// ---------------------------------------------------------------------------
+
+/** Invoice states that never represent recognised revenue. */
+const DEAD_INVOICE_STATUSES = ['DRAFT', 'CANCELLED'];
+
+export const PAYMENT_METHOD_OPTIONS: ReportFilterOption[] = [
+  'telebirr',
+  'cbe-birr',
+  'cbe-bill',
+  'ebirr',
+  'waafi',
+  'dmoney',
+  'cac-bank',
+  'card',
+].map((v) => ({ value: v, label: v }));
+
+export const CURRENCY_FILTER: ReportFilterDef = {
+  key: 'currency',
+  label: 'Currency',
+  type: 'select',
+  options: [
+    { value: 'ETB', label: 'ETB' },
+    { value: 'USD', label: 'USD' },
+  ],
+};
+
+/**
+ * The filter set shared by every revenue report, so they drill into each other
+ * without losing context.
+ *
+ * `currency` is not optional decoration: the ledger holds both ETB and USD
+ * lines, and summing across them produces a number that means nothing. It
+ * defaults to ETB in {@link revenueLedgerQb} rather than being left blank.
+ */
+export const REVENUE_FILTERS: ReportFilterDef[] = [
+  { key: 'date', label: 'Issued', type: 'daterange' },
+  CURRENCY_FILTER,
+  {
+    key: 'categories',
+    label: 'Revenue category',
+    type: 'multiselect',
+    options: REVENUE_CATEGORIES,
+  },
+  { key: 'origin', label: 'Origin', type: 'select', optionsQuery: yardOptions },
+  { key: 'destination', label: 'Destination', type: 'select', optionsQuery: yardOptions },
+  { key: 'customer', label: 'Customer / booking ref', type: 'text' },
+  {
+    key: 'methods',
+    label: 'Payment method',
+    type: 'multiselect',
+    options: PAYMENT_METHOD_OPTIONS,
+  },
+];
+
+/** Stations are reference data — 23 rows that change about yearly. */
+export async function yardOptions(ds: ReportContext['ds']): Promise<ReportFilterOption[]> {
+  return ds
+    .createQueryBuilder()
+    .from(Yard, 'y')
+    .select('y.code', 'value')
+    .addSelect('y.label', 'label')
+    .where('y.deleted_at IS NULL AND y.is_active')
+    .orderBy('y.display_order', 'ASC')
+    .getRawMany<ReportFilterOption>();
+}
+
+/** Currency the ledger reports in when the caller does not choose one. */
+export const DEFAULT_CURRENCY = 'ETB';
+
+export const currencyOf = (params: Record<string, unknown>): string =>
+  (params.currency as string) || DEFAULT_CURRENCY;
+
+/**
+ * Every revenue report starts here: one invoice line joined out to the booking
+ * that explains it. Bookings are LEFT joined on purpose — warehouse, demurrage
+ * and shipping-line-credit invoices carry no booking and must still be counted.
+ *
+ * The booking join is `i.source_id = b.id::text`, never `i.source_id::uuid`:
+ * `source_id` is a varchar with no FK that holds non-UUID values for other
+ * sources (`eims-self-test-…`), so casting it would throw at runtime.
+ */
+export function revenueLedgerQb(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(InvoiceLine, 'il')
+    .innerJoin(Invoice, 'i', 'i.id = il.invoice_id AND i.deleted_at IS NULL')
+    .leftJoin(
+      Booking,
+      'b',
+      "i.source = 'booking' AND i.source_id = b.id::text AND b.deleted_at IS NULL",
+    )
+    .leftJoin(CargoType, 'ct', 'ct.id = b.cargo_type_id')
+    .leftJoin(Yard, 'oy', 'oy.id = b.origin_yard_id')
+    .leftJoin(Yard, 'dy', 'dy.id = b.destination_yard_id')
+    .leftJoin(Company, 'co', 'co.id = i.company_id')
+    .leftJoin(ShippingLineCompany, 'slc', 'slc.id = i.shipping_line_company_id')
+    .where('il.deleted_at IS NULL')
+    .andWhere('i.status NOT IN (:...deadInvoiceStatuses)', {
+      deadInvoiceStatuses: DEAD_INVOICE_STATUSES,
+    })
+    .andWhere("i.source <> 'eims_self_test'")
+    // An umbrella general contract is paid once and drawn down by many orders;
+    // counting both double-counts its value.
+    .andWhere("(b.id IS NULL OR b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')")
+    // Mixing ETB and USD into one SUM produces a meaningless number.
+    .andWhere('il.currency = :currency', { currency: currencyOf(params) });
+
+  if (params.dateFrom) {
+    qb.andWhere(`${REVENUE_DATE} >= :dateFrom`, { dateFrom: params.dateFrom });
+  }
+  if (params.dateTo) {
+    qb.andWhere(`${REVENUE_DATE} < :dateTo`, { dateTo: params.dateTo });
+  }
+
+  const categories = params.categories as string[] | null;
+  if (categories?.length) {
+    qb.andWhere(`${REVENUE_CATEGORY_EXPR} IN (:...categories)`, { categories });
+  }
+
+  if (params.origin) qb.andWhere('oy.code = :origin', { origin: params.origin });
+  if (params.destination) {
+    qb.andWhere('dy.code = :destination', { destination: params.destination });
+  }
+
+  if (params.customer) {
+    qb.andWhere(
+      '(co.name ILIKE :customer OR slc.name ILIKE :customer OR b.reference ILIKE :customer)',
+      { customer: `%${params.customer as string}%` },
+    );
+  }
+
+  const methods = params.methods as string[] | null;
+  if (methods?.length) {
+    qb.andWhere(
+      `EXISTS (SELECT 1 FROM freight.payments p
+               WHERE p.ref_id = i.source_id AND p.status = 'success'
+                 AND p.method IN (:...methods))`,
+      { methods },
+    );
+  }
+
+  // Hides lines whose booking sits outside the caller's trade scope. Lines with
+  // no booking carry no direction and stay visible.
+  applyBookingRefDirectionScope(qb, 'i.source_id', directions);
+
+  return qb;
+}
+
+/**
+ * Invoice-grain sibling of {@link revenueLedgerQb}, for the reports that must
+ * not multiply an invoice by its line count — outstanding balance,
+ * reconciliation, receivable/payable. Same joins, same filters, minus the
+ * line-only ones (charge category, currency lives on the invoice here).
+ */
+export function invoiceLedgerQb(ctx: ReportContext): SelectQueryBuilder<ObjectLiteral> {
+  const { params, directions } = ctx;
+
+  const qb = ctx.ds
+    .createQueryBuilder()
+    .from(Invoice, 'i')
+    .leftJoin(
+      Booking,
+      'b',
+      "i.source = 'booking' AND i.source_id = b.id::text AND b.deleted_at IS NULL",
+    )
+    .leftJoin(CargoType, 'ct', 'ct.id = b.cargo_type_id')
+    .leftJoin(Yard, 'oy', 'oy.id = b.origin_yard_id')
+    .leftJoin(Yard, 'dy', 'dy.id = b.destination_yard_id')
+    .leftJoin(Company, 'co', 'co.id = i.company_id')
+    .leftJoin(ShippingLineCompany, 'slc', 'slc.id = i.shipping_line_company_id')
+    .where('i.deleted_at IS NULL')
+    .andWhere('i.status NOT IN (:...deadInvoiceStatuses)', {
+      deadInvoiceStatuses: DEAD_INVOICE_STATUSES,
+    })
+    .andWhere("i.source <> 'eims_self_test'")
+    .andWhere("(b.id IS NULL OR b.contract_kind IS NULL OR b.contract_kind <> 'GENERAL')")
+    .andWhere('i.currency = :currency', { currency: currencyOf(params) });
+
+  if (params.dateFrom) qb.andWhere(`${REVENUE_DATE} >= :dateFrom`, { dateFrom: params.dateFrom });
+  if (params.dateTo) qb.andWhere(`${REVENUE_DATE} < :dateTo`, { dateTo: params.dateTo });
+  if (params.origin) qb.andWhere('oy.code = :origin', { origin: params.origin });
+  if (params.destination) qb.andWhere('dy.code = :destination', { destination: params.destination });
+  if (params.customer) {
+    qb.andWhere(
+      '(co.name ILIKE :customer OR slc.name ILIKE :customer OR b.reference ILIKE :customer)',
+      { customer: `%${params.customer as string}%` },
+    );
+  }
+
+  applyBookingRefDirectionScope(qb, 'i.source_id', directions);
+  return qb;
+}
+
+/**
+ * What the payment gateway actually recorded against this invoice, summed.
+ * `invoices.payment_id` points at a payment-api intent id rather than a
+ * `freight.payments` row, so the reliable link is the booking id both sides
+ * carry.
+ */
+export const GATEWAY_PAID = `(
+  SELECT COALESCE(SUM(p.amount), 0) FROM freight.payments p
+  WHERE p.ref_id = i.source_id AND p.status = 'success'
+)`;
+
+/** The payer, whichever of the two mutually exclusive payer columns is set. */
+export const PAYER_EXPR = "COALESCE(co.name, slc.name, 'Unknown')";
+
+/** `SUM(amount)`, rounded to whole currency and typed as a JS number. */
+export const REVENUE_SUM = 'ROUND(COALESCE(SUM(il.amount), 0))::float8';
+
+/**
+ * Settled share of a line, apportioned by how much of its invoice was paid.
+ * Invoice-level `paid_amount` cannot be attributed to a single line any other
+ * way.
+ */
+export const PAID_SHARE =
+  'il.amount * CASE WHEN i.total_amount > 0 THEN i.paid_amount / i.total_amount ELSE 0 END';
+
+/** The payment class as a business label rather than its key. */
+export const PAYMENT_CLASS_LABEL_EXPR = labelCase(PAYMENT_CLASS_EXPR, PAYMENT_CLASSES);
diff --git a/apps/edr-freight-api/src/modules/rule-engine/controllers/yard-positions.controller.ts b/apps/edr-freight-api/src/modules/rule-engine/controllers/yard-positions.controller.ts
new file mode 100644
index 000000000..44ae27607
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/rule-engine/controllers/yard-positions.controller.ts
@@ -0,0 +1,85 @@
+import { Body, Controller, Get, Param, ParseUUIDPipe, Put, Query } from '@nestjs/common';
+import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';
+
+import { CurrentUser } from '@edr/api-common';
+import { StaffReference } from '../../../common/booking-guards';
+import { RuleEngineUpdate, RuleEngineView } from '../../../common/rule-engine-guards';
+import {
+  ListYardPositionsQueryDto,
+  SetPositionYardsDto,
+  SetYardPositionsDto,
+} from '../dto/yard-positions.dto';
+import { YardPositionsService } from '../services/yard-positions.service';
+import { YardScopeService } from '../services/yard-scope.service';
+
+/**
+ * Desk↔yard mapping — which positions ("departments" in the user-management
+ * tree) staff which yard. It is yard configuration, so it is gated by the same
+ * rule-engine yard keys as the rest of the yards screen.
+ *
+ * Writes REPLACE the whole set for the side being edited. The admin UI submits
+ * the full multi-select value; a caller sending a delta will drop everything it
+ * omits. Both write paths flush the scope resolver's cache so a mapping change
+ * takes effect on the next request instead of up to a minute later.
+ */
+@ApiTags('yard-positions')
+@Controller('yard-positions')
+@ApiBearerAuth()
+export class YardPositionsController {
+  constructor(
+    private readonly service: YardPositionsService,
+    private readonly scope: YardScopeService,
+  ) {}
+
+  @Get()
+  @RuleEngineView('yards')
+  @ApiOperation({ summary: 'List desk↔yard mappings, optionally by yard or position' })
+  list(@Query() query: ListYardPositionsQueryDto) {
+    return this.service.list(query);
+  }
+
+  @Get('positions')
+  @RuleEngineView('yards')
+  @ApiOperation({ summary: 'Positions selectable as yard desks' })
+  listPositions() {
+    return this.service.listSelectablePositions();
+  }
+
+  @Get('my-yards')
+  // Any signed-in staff member, NOT gated on the yards keys: this returns the
+  // caller's own access and nothing else, and the frontend needs it to
+  // preselect yard filters. Gating it on `rule_engine:yards:view` 403'd every
+  // desk that does not administer yards — i.e. exactly the users it is for.
+  @StaffReference()
+  @ApiOperation({
+    summary: "The caller's own yard scope (null yardIds = unrestricted)",
+  })
+  async myYards(@CurrentUser() user: unknown) {
+    const yardIds = await this.scope.getScopedYardIds(user as never);
+    return { yardIds, unrestricted: yardIds === null, enforced: this.scope.enforced };
+  }
+
+  @Put('yard/:yardId')
+  @RuleEngineUpdate('yards')
+  @ApiOperation({ summary: "Replace a yard's whole position set" })
+  async setPositionsForYard(
+    @Param('yardId', ParseUUIDPipe) yardId: string,
+    @Body() dto: SetYardPositionsDto,
+  ) {
+    const rows = await this.service.setPositionsForYard(yardId, dto.positionIds);
+    this.scope.invalidate();
+    return rows;
+  }
+
+  @Put('position/:positionId')
+  @RuleEngineUpdate('yards')
+  @ApiOperation({ summary: "Replace a position's whole yard set" })
+  async setYardsForPosition(
+    @Param('positionId', ParseUUIDPipe) positionId: string,
+    @Body() dto: SetPositionYardsDto,
+  ) {
+    const rows = await this.service.setYardsForPosition(positionId, dto.yardIds);
+    this.scope.invalidate();
+    return rows;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/rule-engine/dto/create-cargo-type.dto.ts b/apps/edr-freight-api/src/modules/rule-engine/dto/create-cargo-type.dto.ts
index eefc560e8..67f5d2547 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/dto/create-cargo-type.dto.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/dto/create-cargo-type.dto.ts
@@ -70,6 +70,25 @@ export class CreateCargoTypeDto {
   @IsBoolean()
   hasLashing?: boolean;
 
+  @ApiPropertyOptional({
+    default: false,
+    description:
+      'When true, bookings of this cargo type incur the lane-scoped FUEL surcharge.',
+  })
+  @IsOptional()
+  @IsBoolean()
+  hasFuel?: boolean;
+
+  @ApiPropertyOptional({
+    default: false,
+    description:
+      'Allow staff to write bulk contract templates for this cargo type. ' +
+      'Mutually exclusive with the parent group / children having it.',
+  })
+  @IsOptional()
+  @IsBoolean()
+  hasContractTemplate?: boolean;
+
   @ApiPropertyOptional({ default: true })
   @IsOptional()
   @IsBoolean()
diff --git a/apps/edr-freight-api/src/modules/rule-engine/dto/create-rate.dto.ts b/apps/edr-freight-api/src/modules/rule-engine/dto/create-rate.dto.ts
index 45a5838bd..bca8ab278 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/dto/create-rate.dto.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/dto/create-rate.dto.ts
@@ -7,7 +7,8 @@ import {
   RATE_UNITS,
 } from '../entities/rate.entity';
 
-const TRADE_DIRECTIONS = ['IMPORT', 'EXPORT', 'BOTH'] as const;
+// DOMESTIC is accepted only for FUEL rates (an intercity fuel lane).
+const TRADE_DIRECTIONS = ['IMPORT', 'EXPORT', 'BOTH', 'DOMESTIC'] as const;
 // ETB is accepted only for last-mile rates; the service forces USD elsewhere.
 const CURRENCIES = ['USD', 'ETB'] as const;
 export const INTERCITY_KINDS = ['CONTAINER', 'BULK'] as const;
@@ -52,7 +53,7 @@ export class CreateRateDto {
   @ApiPropertyOptional({
     enum: CARGO_KINDS,
     description:
-      'Whether a customs clearance rate covers containers or bulk. Required when trigger = CUSTOMS_CLEARANCE. Not stored — container fees carry a containerTypeId, bulk fees none.',
+      'Whether a customs clearance / cancellation rate covers containers or bulk. Required when trigger = CUSTOMS_CLEARANCE or CANCELLATION. Not stored — container fees carry a containerTypeId, bulk fees a cargoTypeId.',
   })
   @IsOptional()
   @IsIn([...CARGO_KINDS])
@@ -74,6 +75,14 @@ export class CreateRateDto {
   @IsUUID()
   destinationYardId?: string;
 
+  @ApiPropertyOptional({
+    description:
+      'FK to shipping_line_companies.id — set to price this rate for one shipping line only. Omitted/null = the standard rate every customer pays. A line rate overrides the standard one for that line\'s bookings.',
+  })
+  @IsOptional()
+  @IsUUID()
+  shippingLineCompanyId?: string;
+
   @ApiPropertyOptional({ enum: CURRENCIES })
   @IsOptional()
   @IsIn([...CURRENCIES])
@@ -94,6 +103,17 @@ export class CreateRateDto {
   @IsIn([...RATE_UNITS])
   rateUnit?: string;
 
+  @ApiPropertyOptional({
+    description:
+      'FUEL rates billed PER_LITER only: liters the surcharge covers — price = baseLiters × rateValue, once per booking. Required there, rejected elsewhere.',
+    minimum: 0,
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Transform(({ value }) => (value === null || value === undefined || value === '' ? undefined : Number(value)))
+  baseLiters?: number;
+
   @ApiPropertyOptional({
     description:
       'Distance band start (km, inclusive). Container last-mile rates only (rateUnit = PER_KM).',
diff --git a/apps/edr-freight-api/src/modules/rule-engine/dto/list-rule-engine-query.dto.ts b/apps/edr-freight-api/src/modules/rule-engine/dto/list-rule-engine-query.dto.ts
index d22bd84a7..774037e36 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/dto/list-rule-engine-query.dto.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/dto/list-rule-engine-query.dto.ts
@@ -141,6 +141,22 @@ export class ListRatesQueryDto extends PaginationQueryDto {
   @IsString()
   @MaxLength(200)
   trigger?: string;
+
+  @ApiPropertyOptional({
+    description: 'Filter to one shipping line\'s rates.',
+  })
+  @IsOptional()
+  @IsUUID()
+  shippingLineCompanyId?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'true = only shipping-line rates (any line), false = only standard customer rates. Omitted = both. Powers the Shipping line tab.',
+  })
+  @IsOptional()
+  @Transform(toOptionalBoolean)
+  @IsBoolean()
+  isShippingLineRate?: boolean;
 }
 
 export class ListWeightLimitRulesQueryDto extends PaginationQueryDto {
diff --git a/apps/edr-freight-api/src/modules/rule-engine/dto/yard-positions.dto.ts b/apps/edr-freight-api/src/modules/rule-engine/dto/yard-positions.dto.ts
new file mode 100644
index 000000000..b18648d78
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/rule-engine/dto/yard-positions.dto.ts
@@ -0,0 +1,30 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsArray, IsOptional, IsUUID } from 'class-validator';
+
+export class ListYardPositionsQueryDto {
+  @ApiPropertyOptional({ format: 'uuid' })
+  @IsOptional()
+  @IsUUID()
+  yardId?: string;
+
+  @ApiPropertyOptional({ format: 'uuid' })
+  @IsOptional()
+  @IsUUID()
+  positionId?: string;
+}
+
+/** Replaces the yard's whole position set — see the controller's PUT docs. */
+export class SetYardPositionsDto {
+  @ApiProperty({ type: [String], format: 'uuid' })
+  @IsArray()
+  @IsUUID('4', { each: true })
+  positionIds!: string[];
+}
+
+/** Replaces the position's whole yard set. */
+export class SetPositionYardsDto {
+  @ApiProperty({ type: [String], format: 'uuid' })
+  @IsArray()
+  @IsUUID('4', { each: true })
+  yardIds!: string[];
+}
diff --git a/apps/edr-freight-api/src/modules/rule-engine/entities/cargo-type.entity.ts b/apps/edr-freight-api/src/modules/rule-engine/entities/cargo-type.entity.ts
index e685f3a2d..7084e233a 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/entities/cargo-type.entity.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/entities/cargo-type.entity.ts
@@ -82,6 +82,22 @@ export class CargoType extends BaseEntity {
   @Column({ name: 'has_lashing', type: 'boolean', default: false })
   hasLashing!: boolean;
 
+  /**
+   * Whether bookings of this cargo incur the fuel surcharge. Billed off the
+   * lane-scoped FUEL rate for the booking's direction + route + this cargo
+   * type (per liter or per wagon).
+   */
+  @Column({ name: 'has_fuel', type: 'boolean', default: false })
+  hasFuel!: boolean;
+
+  /**
+   * Whether staff may write bulk contract templates against this cargo type.
+   * Mutually exclusive between a parent group and its children: if the parent
+   * provides the template, no child may, and vice versa.
+   */
+  @Column({ name: 'has_contract_template', type: 'boolean', default: false })
+  hasContractTemplate!: boolean;
+
   @Column({ name: 'is_active', type: 'boolean', default: true })
   isActive!: boolean;
 
diff --git a/apps/edr-freight-api/src/modules/rule-engine/entities/rate-type.util.ts b/apps/edr-freight-api/src/modules/rule-engine/entities/rate-type.util.ts
index a5b5bfc30..536e35527 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/entities/rate-type.util.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/entities/rate-type.util.ts
@@ -46,6 +46,8 @@ export function deriveRateType(input: {
         return 'PIL_EXTRA_FEE';
       case 'CUSTOMS_CLEARANCE':
         return 'CUSTOMS_CLEARANCE';
+      case 'FUEL':
+        return 'FUEL_SURCHARGE';
     }
   }
 
diff --git a/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.spec.ts b/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.spec.ts
index e44dcdb5f..39d6174de 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.spec.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.spec.ts
@@ -61,6 +61,22 @@ describe("allowedRateUnits — bulk unit of measure", () => {
     ).toEqual(["PER_TON"]);
   });
 
+  it("bills the wagon cancellation fee per wagon only, whatever the cargo kind", () => {
+    for (const cargoKind of ["CONTAINER", "BULK"] as const) {
+      expect(
+        allowedRateUnits({ appliesTo: "OTHER", trigger: "CANCELLATION", cargoKind }),
+      ).toEqual(["PER_WAGON"]);
+    }
+    expect(
+      allowedRateUnits({
+        appliesTo: "OTHER",
+        trigger: "CANCELLATION",
+        cargoKind: "BULK",
+        cargoUnitOfMeasure: "PER_ITEM",
+      }),
+    ).toEqual(["PER_WAGON"]);
+  });
+
   it("treats per-ton and per-item as the same booking quantity", () => {
     expect(isBulkQuantityUnit("PER_TON")).toBe(true);
     expect(isBulkQuantityUnit("PER_ITEM")).toBe(true);
diff --git a/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.ts b/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.ts
index a3d336605..5adf225ca 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/entities/rate-unit.util.ts
@@ -16,8 +16,7 @@ export const isBulkQuantityUnit = (unit: string): boolean =>
  * Which rate units make sense for a given rate shape. The weighting basis is
  * driven by the *type* of thing being billed — a container leg bills per
  * container, bulk freight per ton, an intercity move can be per-km, a
- * cancellation is a flat/per-invoice fee, and overweight is always per excess
- * ton. This keeps the rate table dynamic yet non-conflicting: the admin can
+ * cancellation is a per-wagon fee, and overweight is always per excess ton. This keeps the rate table dynamic yet non-conflicting: the admin can
  * only pick a unit the pricing engine knows how to apply.
  *
  * A rate scoped to a break-bulk commodity (unit_of_measure = PER_ITEM) offers
@@ -29,7 +28,7 @@ export const isBulkQuantityUnit = (unit: string): boolean =>
 export function allowedRateUnits(input: {
   appliesTo: RateAppliesTo;
   trigger: RateTrigger;
-  /** CUSTOMS_CLEARANCE only: which cargo kind the fee covers. */
+  /** CUSTOMS_CLEARANCE / CANCELLATION only: which cargo kind the fee covers. */
   cargoKind?: 'CONTAINER' | 'BULK' | null;
   /** Unit of measure of the bulk commodity the rate is scoped to, when any. */
   cargoUnitOfMeasure?: CargoUom;
@@ -64,7 +63,9 @@ function unitsForShape(input: {
         // wagon the empties ride back on, or a flat fee.
         return ['PER_CONTAINER', 'PER_WAGON', 'FLAT'];
       case 'CANCELLATION':
-        return ['FLAT', 'PER_INVOICE'];
+        // Wagon cancellation fee — scales with the cancelled wagon count, so
+        // per wagon is the only unit the wagon-cancel flow can apply.
+        return ['PER_WAGON'];
       case 'CUSTOMS_CLEARANCE':
         // Sold per cargo kind: container fees bill per box or per wagon, bulk
         // fees per ton or per wagon. Billed on the booking invoice.
@@ -74,6 +75,9 @@ function unitsForShape(input: {
       case 'LASHING':
         // Bulk-only cargo securing — per ton or per wagon.
         return ['PER_TON', 'PER_WAGON'];
+      case 'FUEL':
+        // Per wagon (wagons × rate) or per liter (baseLiters × rate, once).
+        return ['PER_WAGON', 'PER_LITER'];
       case 'CONSOLIDATION':
         return ['PER_CONTAINER', 'FLAT'];
       case 'SHIPPING_LINE':
diff --git a/apps/edr-freight-api/src/modules/rule-engine/entities/rate.entity.ts b/apps/edr-freight-api/src/modules/rule-engine/entities/rate.entity.ts
index e7089f08c..c60d03d31 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/entities/rate.entity.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/entities/rate.entity.ts
@@ -1,5 +1,6 @@
 import { BaseEntity } from '@edr/api-common';
 import { Column, Entity, Index, JoinColumn, ManyToOne } from 'typeorm';
+import { ShippingLineCompany } from '../../shipping-lines/entities/shipping-line-company.entity';
 import { CargoType } from './cargo-type.entity';
 import { ContainerType } from './container-type.entity';
 import { Yard } from './yard.entity';
@@ -24,6 +25,7 @@ export const RATE_TYPES = [
   'RETURN_SURCHARGE',
   'PIL_EXTRA_FEE',
   'CUSTOMS_CLEARANCE',
+  'FUEL_SURCHARGE',
 ] as const;
 
 export type RateType = typeof RATE_TYPES[number];
@@ -41,6 +43,8 @@ export const RATE_UNITS = [
   'PER_KM',
   // Last-mile bulk: price = tons × km × rateValue.
   'PER_TON_KM',
+  // Fuel surcharge only: price = baseLiters × rateValue, once per booking.
+  'PER_LITER',
   'PER_INVOICE',
   'FLAT',
 ] as const;
@@ -92,6 +96,9 @@ export const RATE_TRIGGERS = [
   // Customs clearance service fee — billed up front via a clearance invoice,
   // never auto-applied to booking pricing (matchesTrigger returns false).
   'CUSTOMS_CLEARANCE',
+  // Fuel surcharge — fires when the booking's cargo type has hasFuel = true,
+  // billed off the lane-scoped rate (direction + route + cargo type).
+  'FUEL',
 ] as const;
 export type RateTrigger = typeof RATE_TRIGGERS[number];
 
@@ -102,6 +109,7 @@ export type RateTrigger = typeof RATE_TRIGGERS[number];
 @Index(['trigger'])
 @Index(['originYardId'])
 @Index(['destinationYardId'])
+@Index(['shippingLineCompanyId'])
 export class Rate extends BaseEntity {
   @Column({ name: 'rate_type', type: 'varchar', length: 50 })
   rateType!: RateType;
@@ -149,6 +157,23 @@ export class Rate extends BaseEntity {
   @JoinColumn({ name: 'destination_yard_id' })
   destinationYard?: Yard | null;
 
+  /**
+   * The shipping line this rate belongs to, or NULL for the standard rate every
+   * customer pays. A booking owned by a shipping line prices exclusively off
+   * that line's rates — the standard rate is NOT a fallback, so a missing line
+   * rate hard-blocks the booking rather than quietly billing the customer price.
+   *
+   * Points at `shipping_line_companies` (the portal account that books capacity),
+   * not `shipping_lines` (carrier reference data behind the SHIPPING_LINE
+   * trigger). The two are unrelated despite the similar names.
+   */
+  @Column({ name: 'shipping_line_company_id', type: 'uuid', nullable: true })
+  shippingLineCompanyId?: string | null;
+
+  @ManyToOne(() => ShippingLineCompany, { nullable: true, eager: false })
+  @JoinColumn({ name: 'shipping_line_company_id' })
+  shippingLineCompany?: ShippingLineCompany | null;
+
   @Column({ name: 'currency', type: 'varchar', length: 5 })
   currency!: string;
 
@@ -163,6 +188,14 @@ export class Rate extends BaseEntity {
    * containerTypeId): the rate applies when minKm <= km < maxKm (maxKm NULL =
    * open-ended). NULL on every other rate shape.
    */
+  /**
+   * FUEL rates billed PER_LITER only: the liters the surcharge covers —
+   * price = baseLiters × rateValue, once per booking. NULL on every other
+   * rate shape (a PER_WAGON fuel rate bills wagons × rateValue instead).
+   */
+  @Column({ name: 'base_liters', type: 'numeric', precision: 14, scale: 4, nullable: true })
+  baseLiters?: number | null;
+
   @Column({ name: 'min_km', type: 'numeric', precision: 10, scale: 2, nullable: true })
   minKm?: number | null;
 
diff --git a/apps/edr-freight-api/src/modules/rule-engine/entities/yard-position.entity.ts b/apps/edr-freight-api/src/modules/rule-engine/entities/yard-position.entity.ts
new file mode 100644
index 000000000..de12b5674
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/rule-engine/entities/yard-position.entity.ts
@@ -0,0 +1,28 @@
+import { BaseEntity } from '@edr/api-common';
+import { Column, Entity, Index, JoinColumn, ManyToOne } from 'typeorm';
+
+import { Yard } from './yard.entity';
+
+/**
+ * One desk staffed at one yard.
+ *
+ * The pairing that yard access scoping resolves against: a caller's active
+ * position decides which yards they may touch. Position rows live in `iam`
+ * (`iam.positions` — what the user-management tree labels "departments"), so
+ * `positionId` is an unconstrained uuid by design; see the migration for why.
+ */
+@Entity({ schema: 'freight', name: 'yard_positions' })
+@Index(['yardId'])
+@Index(['positionId'])
+export class YardPosition extends BaseEntity {
+  @Column({ name: 'yard_id', type: 'uuid' })
+  yardId!: string;
+
+  @ManyToOne(() => Yard, { nullable: false, onDelete: 'CASCADE' })
+  @JoinColumn({ name: 'yard_id' })
+  yard?: Yard;
+
+  /** `iam.positions.id`. No FK — IAM is package-owned and soft-deletes. */
+  @Column({ name: 'position_id', type: 'uuid' })
+  positionId!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/rule-engine/interfaces/rates.repository.interface.ts b/apps/edr-freight-api/src/modules/rule-engine/interfaces/rates.repository.interface.ts
index 9797ff715..ba2509068 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/interfaces/rates.repository.interface.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/interfaces/rates.repository.interface.ts
@@ -16,6 +16,8 @@ export interface IRatesRepository {
     rateType: string;
     /** Omitted for singly-resolved rates — see the repository implementation. */
     rateUnit?: string;
+    /** Owning shipping line; null/omitted = the standard customer rate. */
+    shippingLineCompanyId?: string | null;
     containerTypeId?: string | null;
     cargoTypeId?: string | null;
     tradeDirection?: string | null;
diff --git a/apps/edr-freight-api/src/modules/rule-engine/repositories/cargo-types.repository.ts b/apps/edr-freight-api/src/modules/rule-engine/repositories/cargo-types.repository.ts
index 07993c267..d285deeb0 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/repositories/cargo-types.repository.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/repositories/cargo-types.repository.ts
@@ -91,9 +91,8 @@ export class CargoTypesRepository implements ICargoTypesRepository {
 
   /**
    * Diffs the wagon-type links through the relation query builder rather than
-   * an entity save: junction-row inserts from save() broadcast afterInsert with
-   * no entity attached, which the @tria-plc/auditlog subscriber (deployed
-   * builds) dereferences and crashes the request on.
+   * an entity save, so junction rows are written without broadcasting
+   * afterInsert events for entity-less inserts.
    */
   private async syncWagonTypes(
     id: string,
diff --git a/apps/edr-freight-api/src/modules/rule-engine/repositories/rates.repository.ts b/apps/edr-freight-api/src/modules/rule-engine/repositories/rates.repository.ts
index 7417987dc..8a739095e 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/repositories/rates.repository.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/repositories/rates.repository.ts
@@ -69,6 +69,7 @@ export class RatesRepository implements IRatesRepository {
   findByPattern(pattern: {
     rateType: string;
     rateUnit?: string;
+    shippingLineCompanyId?: string | null;
     containerTypeId?: string | null;
     cargoTypeId?: string | null;
     tradeDirection?: string | null;
@@ -85,6 +86,16 @@ export class RatesRepository implements IRatesRepository {
       qb.andWhere('rate.rate_unit = :rateUnit', { rateUnit: pattern.rateUnit });
     }
 
+    // The owner is part of the identity: a line's rate for a lane is a
+    // different rate from the standard one, not a duplicate of it.
+    if (pattern.shippingLineCompanyId) {
+      qb.andWhere('rate.shipping_line_company_id = :shippingLineCompanyId', {
+        shippingLineCompanyId: pattern.shippingLineCompanyId,
+      });
+    } else {
+      qb.andWhere('rate.shipping_line_company_id IS NULL');
+    }
+
     if (pattern.containerTypeId) {
       qb.andWhere('rate.container_type_id = :containerTypeId', { containerTypeId: pattern.containerTypeId });
     } else {
@@ -139,8 +150,22 @@ export class RatesRepository implements IRatesRepository {
       // yards joined the route columns have only ids to render.
       .leftJoinAndSelect('rate.originYard', 'originYard')
       .leftJoinAndSelect('rate.destinationYard', 'destinationYard')
+      // The shipping-line tab renders the owning line's name, not its id.
+      .leftJoinAndSelect('rate.shippingLineCompany', 'shippingLineCompany')
       .orderBy('rate.createdAt', query.sortOrder ?? 'DESC');
 
+    if (query.shippingLineCompanyId) {
+      qb.andWhere('rate.shippingLineCompanyId = :shippingLineCompanyId', {
+        shippingLineCompanyId: query.shippingLineCompanyId,
+      });
+    } else if (query.isShippingLineRate !== undefined) {
+      // Tab filter: shipping-line rates (any line) vs standard customer rates.
+      qb.andWhere(
+        query.isShippingLineRate
+          ? 'rate.shippingLineCompanyId IS NOT NULL'
+          : 'rate.shippingLineCompanyId IS NULL',
+      );
+    }
     if (query.status) {
       qb.andWhere('rate.status = :status', { status: query.status });
     }
@@ -164,7 +189,7 @@ export class RatesRepository implements IRatesRepository {
     }
     if (query.search) {
       qb.andWhere(
-        '(rate.rateType ILIKE :search OR rate.status ILIKE :search OR rate.rateUnit ILIKE :search OR rate.currency ILIKE :search)',
+        '(rate.rateType ILIKE :search OR rate.status ILIKE :search OR rate.rateUnit ILIKE :search OR rate.currency ILIKE :search OR shippingLineCompany.name ILIKE :search)',
         { search: `%${query.search}%` },
       );
     }
diff --git a/apps/edr-freight-api/src/modules/rule-engine/rule-engine.module.ts b/apps/edr-freight-api/src/modules/rule-engine/rule-engine.module.ts
index d487387b8..97e89cc3b 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/rule-engine.module.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/rule-engine.module.ts
@@ -13,6 +13,7 @@ import { ShippingLinesController } from './controllers/shipping-lines.controller
 import { WeightLimitRulesController } from './controllers/weight-limit-rules.controller';
 import { YardDistancesController } from './controllers/yard-distances.controller';
 import { YardsController } from './controllers/yards.controller';
+import { YardPositionsController } from './controllers/yard-positions.controller';
 
 import { ApprovalRule } from './entities/approval-rule.entity';
 import { CargoType } from './entities/cargo-type.entity';
@@ -28,6 +29,7 @@ import { Yard } from './entities/yard.entity';
 import { YardDistance } from './entities/yard-distance.entity';
 import { YardFacility } from './entities/yard-facility.entity';
 import { YardLocation } from './entities/yard-location.entity';
+import { YardPosition } from './entities/yard-position.entity';
 
 import { APPROVAL_RULES_REPOSITORY } from './interfaces/approval-rules.repository.interface';
 import { CARGO_TYPES_REPOSITORY } from './interfaces/cargo-types.repository.interface';
@@ -65,10 +67,13 @@ import { WeightLimitRulesService } from './services/weight-limit-rules.service';
 import { YardsService } from './services/yards.service';
 import { YardDistancesService } from './services/yard-distances.service';
 import { YardFacilitiesService } from './services/yard-facilities.service';
+import { YardPositionsService } from './services/yard-positions.service';
+import { YardScopeService } from './services/yard-scope.service';
 
 import { RuleEngineService } from './rule-engine.service';
 
 import { NotificationInboxModule } from '../notification-inbox/notification-inbox.module';
+import { ShippingLineCompaniesModule } from '../shipping-lines/shipping-line-companies.module';
 import { WagonTypesModule } from '../wagon-types/wagon-types.module';
 
 import { BookingCargoModifier } from '../bookings/entities/booking-cargo-modifier.entity';
@@ -90,6 +95,7 @@ import { BookingRateSnapshot } from '../bookings/entities/booking-rate-snapshot.
       YardDistance,
       YardFacility,
       YardLocation,
+      YardPosition,
       ShippingLine,
       Rate,
       ApprovalRule,
@@ -102,6 +108,9 @@ import { BookingRateSnapshot } from '../bookings/entities/booking-rate-snapshot.
     // Rated wagon capacities — cargo types validate their per-wagon tonnage cap
     // against them (a cap above the rating is a typo, not a policy).
     WagonTypesModule,
+    // Rates may be scoped to one shipping line; creating such a rate validates
+    // the line exists and is active.
+    ShippingLineCompaniesModule,
   ],
   controllers: [
     CargoTypesController,
@@ -112,6 +121,7 @@ import { BookingRateSnapshot } from '../bookings/entities/booking-rate-snapshot.
     ServiceTypesController,
     WeightLimitRulesController,
     YardsController,
+    YardPositionsController,
     YardDistancesController,
     ShippingLinesController,
     RatesController,
@@ -148,6 +158,8 @@ import { BookingRateSnapshot } from '../bookings/entities/booking-rate-snapshot.
     YardsService,
     YardDistancesService,
     YardFacilitiesService,
+    YardPositionsService,
+    YardScopeService,
     ShippingLinesService,
     RatesService,
     ApprovalRulesService,
@@ -164,6 +176,10 @@ import { BookingRateSnapshot } from '../bookings/entities/booking-rate-snapshot.
     YardsService,
     YardDistancesService,
     YardFacilitiesService,
+    YardPositionsService,
+    // Exported so any module can narrow its yard queries through the one
+    // resolver — the module is @Global, so no import is needed to inject it.
+    YardScopeService,
     ShippingLinesService,
     RatesService,
     ApprovalRulesService,
diff --git a/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.spec.ts b/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.spec.ts
index a736d4b05..c530e5314 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.spec.ts
@@ -422,3 +422,250 @@ describe('RuleEngineService — lashing (bulk-only, per direction + commodity)',
     expect(lashingMods(result)).toHaveLength(0);
   });
 });
+
+describe('RuleEngineService — fuel surcharge (per lane + cargo type)', () => {
+  const fuelPerLiter: Rate = {
+    id: 'rate-fuel-liter',
+    rateType: 'FUEL_SURCHARGE',
+    trigger: 'FUEL',
+    rateValue: 2,
+    rateUnit: 'PER_LITER',
+    baseLiters: 100,
+    currency: 'USD',
+    status: 'LIVE',
+    containerTypeId: null,
+    cargoTypeId: 'cargo-steel',
+    tradeDirection: 'IMPORT',
+    originYardId: 'yard-nagad',
+    destinationYardId: 'yard-mojo',
+  } as Rate;
+
+  const buildService = (rates: Rate[], hasFuel = true): RuleEngineService =>
+    new RuleEngineService(
+      {
+        findById: jest
+          .fn()
+          .mockResolvedValue({ hasFuel, hasLashing: false, requiresDirectorApproval: false }),
+      } as never,
+      { findById: jest.fn().mockResolvedValue(null) } as never,
+      { findActiveByContainerTypeId: jest.fn().mockResolvedValue([]) } as never,
+      { findAllActive: jest.fn().mockResolvedValue([]) } as never,
+      { findLiveRates: jest.fn().mockResolvedValue(rates) } as never,
+      { findById: jest.fn().mockResolvedValue(null) } as never,
+      {} as never,
+    );
+
+  const fuelInput = (
+    overrides: Partial<BookingEvaluationInput> = {},
+  ): BookingEvaluationInput => ({
+    serviceTypeId: 'svc-1',
+    paymentCurrency: 'USD',
+    tradeDirection: 'IMPORT',
+    isHazardous: false,
+    cargoTypeId: 'cargo-steel',
+    originYardId: 'yard-nagad',
+    destinationYardId: 'yard-mojo',
+    totalWagons: 0,
+    bulkTons: 100,
+    bulkWagons: 4,
+    containers: [],
+    ...overrides,
+  });
+
+  const fuelMods = (result: Awaited<ReturnType<RuleEngineService['evaluate']>>) =>
+    result.appliedModifiers.filter((m) => m.surchargeCode === 'FUEL_SURCHARGE');
+
+  it('PER_LITER collapses to one flat total (base liters × rate value), regardless of wagons', async () => {
+    const result = await buildService([fuelPerLiter]).evaluate(fuelInput());
+    const mods = fuelMods(result);
+    expect(mods).toHaveLength(1);
+    // Flat: the customer sees only the total, and a frozen contract snapshot
+    // (also stored flat) multiplies it by quantity 1 — never by the liters.
+    expect(mods[0].triggerValue).toBe(1);
+    expect(mods[0].unitPriceUsd).toBe(200);
+    expect(mods[0].calculatedAmount).toBe(200);
+    expect(mods[0].billingUnit).toBe('FLAT');
+  });
+
+  it('PER_WAGON bills the wagons the cargo occupies', async () => {
+    const result = await buildService([
+      { ...fuelPerLiter, rateUnit: 'PER_WAGON', baseLiters: null, rateValue: 50 } as Rate,
+    ]).evaluate(fuelInput());
+    const mods = fuelMods(result);
+    expect(mods[0].triggerValue).toBe(4);
+    expect(mods[0].calculatedAmount).toBe(200);
+  });
+
+  it('a rate for another lane, direction or commodity never bills', async () => {
+    for (const wrong of [
+      { tradeDirection: 'EXPORT' },
+      { originYardId: 'yard-other' },
+      { destinationYardId: 'yard-other' },
+      { cargoTypeId: 'cargo-wheat' },
+    ]) {
+      const result = await buildService([{ ...fuelPerLiter, ...wrong } as Rate]).evaluate(
+        fuelInput(),
+      );
+      expect(fuelMods(result)).toHaveLength(0);
+    }
+  });
+
+  it('a domestic booking bills the DOMESTIC fuel lane', async () => {
+    const result = await buildService([
+      { ...fuelPerLiter, tradeDirection: 'DOMESTIC' } as Rate,
+    ]).evaluate(fuelInput({ tradeDirection: 'DOMESTIC' }));
+    expect(fuelMods(result)).toHaveLength(1);
+  });
+
+  it('no fuel charge when the cargo type does not have hasFuel', async () => {
+    const result = await buildService([fuelPerLiter], false).evaluate(fuelInput());
+    expect(fuelMods(result)).toHaveLength(0);
+  });
+
+  it('no matching lane rate bills nothing (lenient, like lashing)', async () => {
+    const result = await buildService([]).evaluate(fuelInput());
+    expect(fuelMods(result)).toHaveLength(0);
+  });
+});
+
+describe('RuleEngineService — shipping-line rates override the standard ones', () => {
+  const LINE = 'slc-msc';
+
+  /** Standard customer container-import rate on the lane. */
+  const standardBase: Rate = {
+    id: 'rate-standard-20',
+    rateType: 'CONTAINER_IMPORT',
+    trigger: 'ALWAYS',
+    rateValue: 1000,
+    rateUnit: 'PER_CONTAINER',
+    currency: 'USD',
+    status: 'LIVE',
+    containerTypeId: 'ct-20',
+    cargoTypeId: null,
+    shippingLineCompanyId: null,
+    originYardId: 'yard-dj',
+    destinationYardId: 'yard-adama',
+  } as Rate;
+
+  /** The same lane, priced for one shipping line. */
+  const lineBase: Rate = {
+    ...standardBase,
+    id: 'rate-line-20',
+    rateValue: 1200,
+    shippingLineCompanyId: LINE,
+  } as Rate;
+
+  const standardHazard: Rate = {
+    id: 'rate-hazard-standard',
+    rateType: 'HAZARD_SURCHARGE',
+    trigger: 'HAZARDOUS',
+    rateValue: 50,
+    rateUnit: 'PER_CONTAINER',
+    currency: 'USD',
+    status: 'LIVE',
+    containerTypeId: null,
+    cargoTypeId: null,
+    shippingLineCompanyId: null,
+  } as Rate;
+
+  const lineHazard: Rate = {
+    ...standardHazard,
+    id: 'rate-hazard-line',
+    rateValue: 80,
+    shippingLineCompanyId: LINE,
+  } as Rate;
+
+  const buildService = (rates: Rate[]) =>
+    new RuleEngineService(
+      { findById: jest.fn().mockResolvedValue(null) } as never,
+      { findById: jest.fn().mockResolvedValue(null) } as never,
+      {
+        findActiveByContainerTypeId: jest
+          .fn()
+          .mockResolvedValue([{ id: 'wlr-20', maxVgmTons: 20, maxCapacityTons: null }]),
+      } as never,
+      { findAllActive: jest.fn().mockResolvedValue([]) } as never,
+      { findLiveRates: jest.fn().mockResolvedValue(rates) } as never,
+      { findById: jest.fn().mockResolvedValue(null) } as never,
+      {} as never,
+    );
+
+  // One 20ft at 25 t against a 20 t limit → 5 t excess.
+  const bookingInput = (
+    overrides: Partial<BookingEvaluationInput> = {},
+  ): BookingEvaluationInput => ({
+    serviceTypeId: 'svc-1',
+    paymentCurrency: 'USD',
+    tradeDirection: 'IMPORT',
+    isHazardous: false,
+    totalWagons: 1,
+    originYardId: 'yard-dj',
+    destinationYardId: 'yard-adama',
+    containers: [
+      { containerTypeId: 'ct-20', quantity: 1, vgmPerUnitTons: 25, totalVgmTons: 25 },
+    ],
+    ...overrides,
+  });
+
+  const overweightOf = (result: { appliedModifiers: Array<{ surchargeCode: string }> }) =>
+    result.appliedModifiers.filter((m) => m.surchargeCode === 'OVERWEIGHT_PER_TON');
+
+  it('derives a line booking\'s overweight from the LINE\'s base rate, not the standard one', async () => {
+    const result = await buildService([standardBase, lineBase]).evaluate(
+      bookingInput({ shippingLineCompanyId: LINE }),
+    );
+    const ow = overweightOf(result);
+    expect(ow).toHaveLength(1);
+    // The line's 1200 / (2 × 20) = 30 USD/t, not the standard 1000 → 25 USD/t.
+    expect(ow[0]).toMatchObject({
+      rateId: lineBase.id,
+      unitPriceUsd: 30,
+      calculatedAmount: 150,
+    });
+  });
+
+  it('keeps a customer booking on the standard rate even when a line rate exists', async () => {
+    const result = await buildService([standardBase, lineBase]).evaluate(bookingInput());
+    const ow = overweightOf(result);
+    expect(ow).toHaveLength(1);
+    expect(ow[0]).toMatchObject({
+      rateId: standardBase.id,
+      unitPriceUsd: 25,
+      calculatedAmount: 125,
+    });
+  });
+
+  it('does not fall back to the standard rate when the line has none for the lane', async () => {
+    const result = await buildService([standardBase]).evaluate(
+      bookingInput({ shippingLineCompanyId: LINE }),
+    );
+    // No line rate on the lane → nothing to derive from. Base freight is what
+    // hard-blocks the booking; the standard 1000 must never be borrowed here.
+    expect(overweightOf(result)).toHaveLength(0);
+  });
+
+  it('bills the line\'s own surcharge and never the standard one alongside it', async () => {
+    const result = await buildService([
+      standardBase,
+      lineBase,
+      standardHazard,
+      lineHazard,
+    ]).evaluate(bookingInput({ shippingLineCompanyId: LINE, isHazardous: true }));
+
+    const hazard = result.appliedModifiers.filter(
+      (m) => m.surchargeCode === 'HAZARD_SURCHARGE',
+    );
+    expect(hazard).toHaveLength(1);
+    expect(hazard[0]).toMatchObject({ rateId: lineHazard.id, calculatedAmount: 80 });
+  });
+
+  it('hard-blocks a requested service the line has no surcharge rate for', async () => {
+    const result = await buildService([standardBase, lineBase, standardHazard]).evaluate(
+      bookingInput({ shippingLineCompanyId: LINE, isHazardous: true }),
+    );
+    // The standard hazard rate exists but belongs to customers, so the line's
+    // hazardous booking must block rather than borrow it.
+    expect(result.hardBlocked).toHaveLength(1);
+    expect(result.hardBlocked[0]).toContain('hazardous');
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.ts b/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.ts
index ac2e854e4..5c9055415 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/rule-engine.service.ts
@@ -74,6 +74,16 @@ export interface BookingEvaluationInput {
   isGovernment?: boolean;
   allowConsolidation?: boolean;
   shippingLineId?: string | null;
+  /**
+   * The shipping line that OWNS this booking (`bookings.shipping_line_company_id`),
+   * when it is a shipping-line booking rather than a customer one. Such a booking
+   * prices exclusively off that line's own rates — see {@link ratesForOwner}.
+   *
+   * Not to be confused with `shippingLineId` above, which is cargo metadata
+   * naming the carrier that physically moves the goods and only feeds the
+   * SHIPPING_LINE double-handling trigger.
+   */
+  shippingLineCompanyId?: string | null;
   /**
    * The booking's rail leg. Import overweight derives its per-ton price from
    * this route's own container freight rate, so the engine needs the yards.
@@ -175,6 +185,9 @@ export class RuleEngineService {
     // matchesTrigger can fire the LASHING rate. Falls back to an explicit
     // input flag when no cargo type is set (e.g. container bookings).
     let hasLashing = input.hasLashing === true;
+    // Fuel is likewise a cargo-type property (hasFuel), billed off the
+    // lane-scoped FUEL rate — see fuelCharges.
+    let hasFuel = false;
     if (input.cargoTypeId) {
       const cargoType = await this.cargoTypesRepo.findById(input.cargoTypeId);
       if (!cargoType) {
@@ -186,6 +199,9 @@ export class RuleEngineService {
         if (cargoType.hasLashing) {
           hasLashing = true;
         }
+        if (cargoType.hasFuel) {
+          hasFuel = true;
+        }
       }
     }
 
@@ -276,7 +292,10 @@ export class RuleEngineService {
     // scope) must contribute exactly ONE line. Duplicate LIVE rate rows — e.g.
     // from a non-idempotent seeder — would otherwise repeat the same surcharge
     // many times and inflate the total, so we collapse them to one row each.
-    const liveRates = await this.ratesRepo.findLiveRates();
+    const liveRates = this.ratesForOwner(
+      await this.ratesRepo.findLiveRates(),
+      input.shippingLineCompanyId,
+    );
     const surchargeRates = this.dedupeRatesBySignature(
       liveRates.filter((r) => r.trigger && r.trigger !== 'ALWAYS'),
     );
@@ -328,6 +347,9 @@ export class RuleEngineService {
       // Lashing is sold per cargo kind + container type — billed by the
       // kind-aware block below, never by this generic loop.
       if (rate.trigger === 'LASHING') continue;
+      // Fuel is sold per lane + cargo type — billed by the route-matched
+      // block below, never by this route-agnostic loop.
+      if (rate.trigger === 'FUEL') continue;
       const triggered = this.matchesTrigger(rate.trigger, {
         isHazardous: input.isHazardous,
         hasReefer,
@@ -442,6 +464,10 @@ export class RuleEngineService {
       appliedModifiers.push(...this.lashingCharges(input, liveRates));
     }
 
+    if (hasFuel) {
+      appliedModifiers.push(...this.fuelCharges(input, liveRates));
+    }
+
     return {
       priorityScore,
       appliedModifiers,
@@ -632,6 +658,56 @@ export class RuleEngineService {
     return modifiers;
   }
 
+  /**
+   * Fuel surcharge — fires when the booking's cargo type has hasFuel = true,
+   * billed off the FUEL rate matching the booking's lane (trade direction +
+   * origin + destination) and cargo type. PER_LITER collapses to one FLAT
+   * amount (baseLiters × rateValue, once per booking) — the customer only ever
+   * sees the total, and the frozen contract snapshot stores that same flat
+   * figure so the snapshot-override math bills it exactly once. PER_WAGON
+   * bills the wagons the cargo occupies. No matching lane rate simply bills
+   * nothing — same leniency as lashing.
+   */
+  private fuelCharges(
+    input: BookingEvaluationInput,
+    liveRates: Rate[],
+  ): AppliedCargoModifier[] {
+    const modifiers: AppliedCargoModifier[] = [];
+    const rate = liveRates.find(
+      (r) =>
+        r.trigger === 'FUEL' &&
+        r.currency === 'USD' &&
+        r.tradeDirection === input.tradeDirection &&
+        r.originYardId === input.originYardId &&
+        r.destinationYardId === input.destinationYardId &&
+        r.cargoTypeId === input.cargoTypeId,
+    );
+    if (!rate) return modifiers;
+
+    const rateValue = Number(rate.rateValue);
+    const wagons = Math.max(
+      0,
+      Number(input.bulkWagons ?? 0) || Number(input.totalWagons ?? 0),
+    );
+    const perLiter = rate.rateUnit === 'PER_LITER';
+    const billedQty = perLiter ? 1 : wagons;
+    const unitPrice = perLiter
+      ? Number(rate.baseLiters ?? 0) * rateValue
+      : rateValue;
+    const amount = billedQty * unitPrice;
+    if (!(amount > 0)) return modifiers;
+    modifiers.push({
+      rateId: rate.id,
+      surchargeCode: this.surchargeCode(rate),
+      triggerValue: billedQty,
+      calculatedAmount: amount,
+      currency: rate.currency,
+      unitPriceUsd: unitPrice,
+      billingUnit: perLiter ? 'FLAT' : rate.rateUnit,
+    });
+    return modifiers;
+  }
+
   /**
    * Messages for container lines whose total weight exceeds the hard capacity
    * ceiling (weight_limit_rules.max_capacity_tons). Non-empty ⇒ the booking
@@ -749,6 +825,28 @@ export class RuleEngineService {
     return rate.rateType ?? rate.trigger;
   }
 
+  /**
+   * Narrow the LIVE rate pool to the ones this booking's owner may price off.
+   *
+   * A customer booking sees only standard rates (no owner) — a shipping line's
+   * negotiated price must never leak into a customer quote. A shipping-line
+   * booking sees only that line's own rates: line rates OVERRIDE the standard
+   * ones rather than stacking on them, and the standard rate is deliberately
+   * NOT a fallback, so a lane the line has no rate for hard-blocks downstream
+   * (base freight already blocks on "no rate for this route") instead of
+   * quietly billing the line at the customer price.
+   *
+   * Filtering once, here, is what makes the override apply uniformly: every
+   * downstream lookup (base freight, derived overweight, empty return, lashing,
+   * fuel, and the additive surcharges) reads from this same pool, so none of
+   * them needs its own owner check.
+   */
+  private ratesForOwner(rates: Rate[], shippingLineCompanyId?: string | null): Rate[] {
+    return shippingLineCompanyId
+      ? rates.filter((r) => r.shippingLineCompanyId === shippingLineCompanyId)
+      : rates.filter((r) => !r.shippingLineCompanyId);
+  }
+
   /**
    * Collapse rates that describe the same charge to a single representative.
    *
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/cargo-types.service.ts b/apps/edr-freight-api/src/modules/rule-engine/services/cargo-types.service.ts
index 1f25b0823..9c11005e9 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/services/cargo-types.service.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/cargo-types.service.ts
@@ -135,6 +135,35 @@ export class CargoTypesService {
     return map;
   }
 
+  /**
+   * A cargo type and its parent group may not BOTH offer a contract template —
+   * the template would be ambiguous for bookings of the child. To enable the
+   * child, the parent must be turned off first (and vice versa).
+   */
+  private async assertContractTemplateExclusive(input: {
+    id?: string;
+    parentGroupId?: string | null;
+  }): Promise<void> {
+    if (input.parentGroupId) {
+      const parent = await this.repository.findById(input.parentGroupId);
+      if (parent?.hasContractTemplate) {
+        throw new BadRequestException(
+          `Parent group "${parent.cargoTypeName}" already has a contract template — turn it off there first`,
+        );
+      }
+    }
+    if (input.id) {
+      const children = await this.repository.findAll({
+        where: { parentGroupId: input.id, hasContractTemplate: true },
+      });
+      if (children.length) {
+        throw new BadRequestException(
+          `Child cargo type(s) ${children.map((c) => `"${c.cargoTypeName}"`).join(', ')} already have their own contract template — turn those off first`,
+        );
+      }
+    }
+  }
+
   /** Create a new cargo type. */
   async create(dto: CreateCargoTypeDto): Promise<CargoType> {
     const code = generateCode(dto.cargoTypeName);
@@ -144,6 +173,9 @@ export class CargoTypesService {
       const parent = await this.repository.findById(dto.parentGroupId);
       if (!parent) throw new NotFoundException(`Parent cargo type ${dto.parentGroupId} not found`);
     }
+    if (dto.hasContractTemplate) {
+      await this.assertContractTemplateExclusive({ parentGroupId: dto.parentGroupId });
+    }
 
     const displayOrder = await this.displayOrder.resolveCreateOrder(CargoType, 'displayOrder', {
       explicitOrder: dto.displayOrder,
@@ -160,6 +192,7 @@ export class CargoTypesService {
       code,
       cargoTypeName: dto.cargoTypeName,
       parentGroupId: dto.parentGroupId ?? null,
+      hasContractTemplate: dto.hasContractTemplate ?? false,
       requiresDirectorApproval: dto.requiresDirectorApproval ?? false,
       isActive: dto.isActive ?? true,
       unitOfMeasure: dto.unitOfMeasure ?? null,
@@ -183,6 +216,18 @@ export class CargoTypesService {
       const parent = await this.repository.findById(dto.parentGroupId);
       if (!parent) throw new NotFoundException(`Parent cargo type ${dto.parentGroupId} not found`);
     }
+    // Re-check the parent/child template exclusivity whenever the flag or the
+    // parent moves and the row ends up flagged.
+    const willHaveTemplate = dto.hasContractTemplate ?? existing.hasContractTemplate;
+    if (
+      willHaveTemplate &&
+      (dto.hasContractTemplate !== undefined || dto.parentGroupId !== undefined)
+    ) {
+      await this.assertContractTemplateExclusive({
+        id,
+        parentGroupId: dto.parentGroupId ?? existing.parentGroupId,
+      });
+    }
     const {
       wagonTypeIds,
       itemsPerWagonMap,
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/priority-rule-change-requests.service.ts b/apps/edr-freight-api/src/modules/rule-engine/services/priority-rule-change-requests.service.ts
index a80221c68..1526769d3 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/services/priority-rule-change-requests.service.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/priority-rule-change-requests.service.ts
@@ -22,6 +22,7 @@ import {
   PriorityRuleChangeStatus,
 } from '../entities/priority-rule-change-request.entity';
 import { PriorityConfigsService } from './priority-configs.service';
+import { FREIGHT_PERMS } from '../../../seed/freight-permissions.registry';
 
 /** Backoffice rule-engine page — where both queue and rules live. */
 const RULES_LINK = '/dashboard/rules/priority-configs';
@@ -221,7 +222,9 @@ export class PriorityRuleChangeRequestsService {
   ): void {
     void this.inbox
       .notify({
-        recipients: { allBackoffice: true },
+        recipients: {
+          permissionKeys: [FREIGHT_PERMS.ruleEngine.getNotification],
+        },
         audience: NotificationAudience.BACKOFFICE,
         type: NotificationType.REQUEST_SUBMITTED,
         title,
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.spec.ts b/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.spec.ts
index be7c8984c..f8617cd65 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.spec.ts
@@ -118,6 +118,19 @@ describe('RateChangeRequestsService', () => {
       expect(request.payload).toEqual({ destinationYardId: 'yard-c' });
     });
 
+    it('carries baseLiters — a switch to PER_LITER keeps its billing base', async () => {
+      const { service } = build({
+        rate: liveRate({ rateUnit: 'PER_WAGON', baseLiters: null }),
+      });
+
+      const request = await service.submit({
+        rateId: 'rate-1',
+        update: { rateUnit: 'PER_LITER', baseLiters: 3 },
+      });
+
+      expect(request.payload).toEqual({ rateUnit: 'PER_LITER', baseLiters: 3 });
+    });
+
     it('rejects a no-op — 100 posted against a live 100.0000 is not a change', async () => {
       const { service } = build();
       await expect(
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.ts b/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.ts
index 6dde40d7d..8913c9ef9 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/rate-change-requests.service.ts
@@ -19,6 +19,7 @@ import {
 } from '../entities/rate-change-request.entity';
 import { Rate } from '../entities/rate.entity';
 import { RatesService } from './rates.service';
+import { FREIGHT_PERMS } from '../../../seed/freight-permissions.registry';
 
 /** Backoffice page where both the queue and the rates live. */
 const RATES_LINK = '/dashboard/rules/rates';
@@ -41,6 +42,10 @@ const DIFFABLE_FIELDS = [
   // LIVE last-mile rate would diff to "nothing changed".
   'minKm',
   'maxKm',
+  // PER_LITER fuel surcharge billing base. Missing here, a switch to PER_LITER
+  // dropped the submitted liters and validation failed with "needs a base
+  // liters amount" even though the payload carried one.
+  'baseLiters',
 ] as const;
 
 /**
@@ -234,7 +239,9 @@ export class RateChangeRequestsService {
   private notifyTeam(title: string, body: string, request: RateChangeRequest): void {
     void this.inbox
       .notify({
-        recipients: { allBackoffice: true },
+        recipients: {
+          permissionKeys: [FREIGHT_PERMS.ruleEngine.getNotification],
+        },
         audience: NotificationAudience.BACKOFFICE,
         type: NotificationType.REQUEST_SUBMITTED,
         title,
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/rates.duplicate-pattern.spec.ts b/apps/edr-freight-api/src/modules/rule-engine/services/rates.duplicate-pattern.spec.ts
index 23d96da89..0a4108a4e 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/services/rates.duplicate-pattern.spec.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/rates.duplicate-pattern.spec.ts
@@ -61,6 +61,8 @@ describe('RatesService — one rate per pattern', () => {
         })),
       } as never,
       { findById: jest.fn().mockResolvedValue(null) } as never,
+      // Shipping line companies — these rates carry no owner, so it is never hit.
+      { findById: jest.fn() } as never,
     );
   });
 
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/rates.service.ts b/apps/edr-freight-api/src/modules/rule-engine/services/rates.service.ts
index 971097377..977a31718 100644
--- a/apps/edr-freight-api/src/modules/rule-engine/services/rates.service.ts
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/rates.service.ts
@@ -8,6 +8,8 @@ import {
 } from '@nestjs/common';
 import { PaginatedResponse, YardCountry } from '@edr/types';
 import { IsNull, Not } from 'typeorm';
+import { ShippingLineStatus } from '../../shipping-lines/entities/shipping-line-company.entity';
+import { ShippingLineCompaniesService } from '../../shipping-lines/shipping-line-companies.service';
 import { CreateRateDto } from '../dto/create-rate.dto';
 import { ListRatesQueryDto } from '../dto/list-rule-engine-query.dto';
 import { UpdateRateDto } from '../dto/update-rate.dto';
@@ -23,6 +25,19 @@ import { IYardsRepository, YARDS_REPOSITORY } from '../interfaces/yards.reposito
 
 /** Categories priced per rail leg — they carry an origin → destination yard pair. */
 const BASE_FREIGHT_CATEGORIES: readonly Rate['appliesTo'][] = ['BULK', 'CONTAINER', 'INTERCITY'];
+/**
+ * Surcharges sold per cargo kind: the admin says container or bulk, a
+ * container fee then names its container type and a bulk fee its commodity.
+ */
+const CARGO_KIND_TRIGGERS: readonly Rate['trigger'][] = ['CUSTOMS_CLEARANCE', 'CANCELLATION'];
+/** Surcharges that keep a trade direction (everything else is direction-agnostic). */
+const DIRECTED_SURCHARGE_TRIGGERS: readonly Rate['trigger'][] = [
+  'CUSTOMS_CLEARANCE',
+  'CANCELLATION',
+  'WITH_RETURN',
+  'LASHING',
+  'FUEL',
+];
 
 /** The yard pair a rate scopes to, already validated against its direction. */
 interface YardScope {
@@ -39,6 +54,7 @@ export class RatesService {
     private readonly yardsRepository: IYardsRepository,
     @Inject(CARGO_TYPES_REPOSITORY)
     private readonly cargoTypesRepository: ICargoTypesRepository,
+    private readonly shippingLineCompaniesService: ShippingLineCompaniesService,
   ) {}
 
   /** List rates — standard paginated envelope with server-side search. */
@@ -121,15 +137,16 @@ export class RatesService {
   }
 
   /**
-   * Rates sold per direction + route. Base freight always; customs clearance
-   * and empty-container return are the surcharges that are too — their fee
-   * depends on the lane (and, for returns, the container type).
+   * Rates sold per direction + route. Base freight always; customs clearance,
+   * empty-container return and fuel are the surcharges that are too — their
+   * fee depends on the lane (and, for returns, the container type).
    */
   private isRouteScoped(appliesTo: Rate['appliesTo'], trigger: Rate['trigger']): boolean {
     return (
       this.isBaseFreight(appliesTo, trigger) ||
       trigger === 'CUSTOMS_CLEARANCE' ||
-      trigger === 'WITH_RETURN'
+      trigger === 'WITH_RETURN' ||
+      trigger === 'FUEL'
     );
   }
 
@@ -148,7 +165,11 @@ export class RatesService {
     appliesTo: Rate['appliesTo'],
     trigger: Rate['trigger'],
   ): boolean {
-    return this.isRouteScoped(appliesTo, trigger) || trigger === 'LASHING';
+    return (
+      this.isRouteScoped(appliesTo, trigger) ||
+      trigger === 'LASHING' ||
+      trigger === 'CANCELLATION'
+    );
   }
 
   /**
@@ -160,7 +181,9 @@ export class RatesService {
     appliesTo: Rate['appliesTo'],
     tradeDirection: string | null,
   ): { origin: YardCountry; destination: YardCountry } {
-    if (appliesTo === 'INTERCITY') {
+    // DOMESTIC only reaches here on a FUEL rate's intercity lane — it stays
+    // inside Ethiopia exactly like intercity base freight.
+    if (appliesTo === 'INTERCITY' || tradeDirection === 'DOMESTIC') {
       return { origin: YardCountry.ETHIOPIA, destination: YardCountry.ETHIOPIA };
     }
     return tradeDirection === 'EXPORT'
@@ -238,10 +261,13 @@ export class RatesService {
   }): void {
     const { appliesTo, trigger, tradeDirection, intercityKind, cargoKind } = input;
     const { containerTypeId, cargoTypeId } = input;
-    if (trigger === 'CUSTOMS_CLEARANCE') {
+    if (trigger === 'CUSTOMS_CLEARANCE' || trigger === 'CANCELLATION') {
+      // Both fees are sold per direction + cargo kind + type: customs clearance
+      // per lane, the wagon cancellation fee per direction only.
+      const fee = trigger === 'CANCELLATION' ? 'cancellation fee' : 'customs clearance';
       if (tradeDirection !== 'IMPORT' && tradeDirection !== 'EXPORT') {
         throw new BadRequestException(
-          'A customs clearance rate must say whether it covers IMPORT or EXPORT.',
+          `A ${fee} rate must say whether it covers IMPORT or EXPORT.`,
         );
       }
       // Sold per cargo kind: a container fee names the container type it covers
@@ -249,29 +275,29 @@ export class RatesService {
       // that absence is what marks it as the bulk fee.
       if (cargoKind !== 'CONTAINER' && cargoKind !== 'BULK') {
         throw new BadRequestException(
-          'A customs clearance rate must say whether it covers containers or bulk.',
+          `A ${fee} rate must say whether it covers containers or bulk.`,
         );
       }
       if (cargoKind === 'CONTAINER' && !containerTypeId) {
         throw new BadRequestException(
-          'A container customs clearance rate must name the container type it covers.',
+          `A container ${fee} rate must name the container type it covers.`,
         );
       }
       if (cargoKind === 'BULK' && containerTypeId) {
         throw new BadRequestException(
-          'A bulk customs clearance rate cannot be scoped to a container type.',
+          `A bulk ${fee} rate cannot be scoped to a container type.`,
         );
       }
-      // The bulk customs fee names the commodity it covers (sugar and
-      // fertilizer clear differently).
+      // The bulk fee names the commodity it covers (sugar and fertilizer
+      // clear — and cancel — differently).
       if (cargoKind === 'BULK' && !cargoTypeId) {
         throw new BadRequestException(
-          'A bulk customs clearance rate must name the bulk cargo type it covers.',
+          `A bulk ${fee} rate must name the bulk cargo type it covers.`,
         );
       }
       if (cargoKind === 'CONTAINER' && cargoTypeId) {
         throw new BadRequestException(
-          'A container customs clearance rate cannot be scoped to a bulk cargo type.',
+          `A container ${fee} rate cannot be scoped to a bulk cargo type.`,
         );
       }
       return;
@@ -291,6 +317,31 @@ export class RatesService {
       }
       return;
     }
+    if (trigger === 'FUEL') {
+      // Fuel is sold per lane + commodity: the direction says which countries
+      // the leg spans (DOMESTIC = intercity, inside Ethiopia) and the cargo
+      // type names the commodity — different commodities price differently.
+      if (
+        tradeDirection !== 'IMPORT' &&
+        tradeDirection !== 'EXPORT' &&
+        tradeDirection !== 'DOMESTIC'
+      ) {
+        throw new BadRequestException(
+          'A fuel rate must say whether it covers IMPORT, EXPORT or DOMESTIC (intercity).',
+        );
+      }
+      if (containerTypeId) {
+        throw new BadRequestException(
+          'A fuel rate cannot be scoped to a container type.',
+        );
+      }
+      if (!cargoTypeId) {
+        throw new BadRequestException(
+          'A fuel rate must name the cargo type it covers.',
+        );
+      }
+      return;
+    }
     if (trigger === 'WITH_RETURN') {
       // Returning the empty box only exists on imports (the box goes back to
       // the port) — export return rates are rejected until the business sells
@@ -463,6 +514,7 @@ export class RatesService {
     rateType: string;
     /** Passed only for additive surcharges — see {@link resolvesSingleRate}. */
     rateUnit?: string;
+    shippingLineCompanyId: string | null;
     containerTypeId: string | null;
     cargoTypeId: string | null;
     tradeDirection: string | null;
@@ -480,37 +532,68 @@ export class RatesService {
     }
   }
 
+  /**
+   * Validate the shipping line a rate is scoped to, when any.
+   *
+   * A shipping line only ever ships import — the export leg is sold through the
+   * customer's contract — so a line rate carrying an EXPORT direction is
+   * rejected here as well as by `CK_rates_shipping_line_import_only`.
+   * Returns the owner id to store (null = the standard customer rate).
+   */
+  private async resolveShippingLineScope(
+    shippingLineCompanyId: string | null | undefined,
+    tradeDirection: string | null,
+  ): Promise<string | null> {
+    if (!shippingLineCompanyId) return null;
+
+    // Throws NotFoundException when the line does not exist.
+    const line = await this.shippingLineCompaniesService.findById(shippingLineCompanyId);
+    if (line.status !== ShippingLineStatus.Active) {
+      throw new BadRequestException(
+        `${line.name} is ${line.status} — rates can only be configured for an active shipping line.`,
+      );
+    }
+    if (tradeDirection && tradeDirection !== 'IMPORT') {
+      throw new BadRequestException(
+        'Shipping line rates are import-only — the export leg is priced through the customer contract.',
+      );
+    }
+    return shippingLineCompanyId;
+  }
+
   /** Create a rate in DRAFT status. */
   async create(dto: CreateRateDto, proposedByStaffId: string): Promise<Rate> {
     const appliesTo = dto.appliesTo as Rate['appliesTo'];
     const trigger = dto.trigger as Rate['trigger'];
     // Surcharges (trigger ≠ ALWAYS) carry no direction/scope — clear them so
     // the engine never accidentally narrows a surcharge by container/direction.
-    // Exceptions: customs clearance and empty-container return keep direction +
-    // container type — both are sold per lane (and per container type).
+    // Exceptions: the directed surcharges (customs clearance, cancellation,
+    // empty-container return, lashing, fuel) keep direction + cargo scope.
     const isSurcharge = trigger !== 'ALWAYS';
-    const cargoKind =
-      trigger === 'CUSTOMS_CLEARANCE'
-        ? ((dto.cargoKind as 'CONTAINER' | 'BULK' | undefined) ?? null)
-        : null;
+    const cargoKind = CARGO_KIND_TRIGGERS.includes(trigger)
+      ? ((dto.cargoKind as 'CONTAINER' | 'BULK' | undefined) ?? null)
+      : null;
     const containerTypeId =
       trigger === 'WITH_RETURN' ||
-      (trigger === 'CUSTOMS_CLEARANCE' && cargoKind === 'CONTAINER')
+      (CARGO_KIND_TRIGGERS.includes(trigger) && cargoKind === 'CONTAINER')
         ? (dto.containerTypeId ?? null)
         : isSurcharge
           ? null
           : (dto.containerTypeId ?? null);
     const cargoTypeId =
-      (trigger === 'CUSTOMS_CLEARANCE' && cargoKind === 'BULK') ||
-      trigger === 'LASHING'
+      (CARGO_KIND_TRIGGERS.includes(trigger) && cargoKind === 'BULK') ||
+      trigger === 'LASHING' ||
+      trigger === 'FUEL'
         ? (dto.cargoTypeId ?? null)
         : isSurcharge
           ? null
           : (dto.cargoTypeId ?? null);
     // Intercity never leaves Ethiopia, so it has no trade direction to store —
-    // its yard pair already says where it runs.
+    // its yard pair already says where it runs. (Fuel is the exception: its
+    // intercity lane is stored as DOMESTIC, since appliesTo = OTHER says
+    // nothing about the direction.)
     const tradeDirection =
-      trigger === 'CUSTOMS_CLEARANCE' || trigger === 'WITH_RETURN' || trigger === 'LASHING'
+      DIRECTED_SURCHARGE_TRIGGERS.includes(trigger)
         ? (dto.tradeDirection ?? null)
         : isSurcharge || appliesTo === 'INTERCITY'
           ? null
@@ -534,6 +617,11 @@ export class RatesService {
       destinationYardId: dto.destinationYardId,
     });
 
+    const shippingLineCompanyId = await this.resolveShippingLineScope(
+      dto.shippingLineCompanyId,
+      tradeDirection,
+    );
+
     const rateType = deriveRateType({
       appliesTo,
       trigger,
@@ -563,9 +651,12 @@ export class RatesService {
       await this.assertNoBandOverlap({ rateUnit, containerTypeId, minKm, maxKm });
     }
 
+    const baseLiters = this.resolveBaseLiters(rateUnit, dto.baseLiters);
+
     await this.assertNoDuplicatePattern({
       rateType,
       ...(this.resolvesSingleRate(appliesTo, trigger) ? {} : { rateUnit }),
+      shippingLineCompanyId,
       containerTypeId,
       cargoTypeId,
       tradeDirection,
@@ -578,6 +669,7 @@ export class RatesService {
       appliesTo,
       trigger,
       rateType,
+      shippingLineCompanyId,
       containerTypeId,
       cargoTypeId,
       tradeDirection,
@@ -588,6 +680,7 @@ export class RatesService {
       currency: appliesTo === 'LAST_MILE' ? (dto.currency ?? 'ETB') : 'USD',
       rateValue: dto.rateValue,
       rateUnit,
+      baseLiters,
       minKm,
       maxKm,
       status: 'DRAFT',
@@ -595,6 +688,25 @@ export class RatesService {
     });
   }
 
+  /**
+   * The liters a PER_LITER fuel rate bills (price = baseLiters × rateValue,
+   * once per booking). Required there; cleared on every other rate shape —
+   * a PER_WAGON fuel rate bills wagons × rateValue and carries none.
+   */
+  private resolveBaseLiters(
+    rateUnit: Rate['rateUnit'],
+    baseLiters?: number | null,
+  ): number | null {
+    if (rateUnit !== 'PER_LITER') return null;
+    const liters = Number(baseLiters);
+    if (!(liters > 0)) {
+      throw new BadRequestException(
+        'A per-liter fuel rate needs a base liters amount — the price is base liters × rate value.',
+      );
+    }
+    return liters;
+  }
+
   /**
    * Update a DRAFT rate in place. Nothing prices off a draft, so a direct edit
    * is safe. A LIVE rate cannot take this path — see `applyApprovedUpdate`.
@@ -662,16 +774,15 @@ export class RatesService {
 
     // A patch that leaves the cargo kind unsaid keeps the one the rate already
     // has — read back off its container scope (container fees carry the type).
-    const cargoKind =
-      trigger !== 'CUSTOMS_CLEARANCE'
-        ? null
-        : ((dto.cargoKind as 'CONTAINER' | 'BULK' | undefined) ??
-          (existing.containerTypeId ? 'CONTAINER' : 'BULK'));
+    const cargoKind = !CARGO_KIND_TRIGGERS.includes(trigger)
+      ? null
+      : ((dto.cargoKind as 'CONTAINER' | 'BULK' | undefined) ??
+        (existing.containerTypeId ? 'CONTAINER' : 'BULK'));
 
     const keepsContainerType =
       !isSurcharge ||
       trigger === 'WITH_RETURN' ||
-      (trigger === 'CUSTOMS_CLEARANCE' && cargoKind === 'CONTAINER');
+      (CARGO_KIND_TRIGGERS.includes(trigger) && cargoKind === 'CONTAINER');
     const containerTypeId = !keepsContainerType
       ? null
       : dto.containerTypeId !== undefined
@@ -679,15 +790,16 @@ export class RatesService {
         : existing.containerTypeId;
     const keepsCargoType =
       !isSurcharge ||
-      (trigger === 'CUSTOMS_CLEARANCE' && cargoKind === 'BULK') ||
-      trigger === 'LASHING';
+      (CARGO_KIND_TRIGGERS.includes(trigger) && cargoKind === 'BULK') ||
+      trigger === 'LASHING' ||
+      trigger === 'FUEL';
     const cargoTypeId = !keepsCargoType
       ? null
       : dto.cargoTypeId !== undefined
         ? dto.cargoTypeId
         : existing.cargoTypeId;
     const tradeDirection =
-      trigger === 'CUSTOMS_CLEARANCE' || trigger === 'WITH_RETURN' || trigger === 'LASHING'
+      DIRECTED_SURCHARGE_TRIGGERS.includes(trigger)
         ? dto.tradeDirection !== undefined
           ? dto.tradeDirection
           : existing.tradeDirection
@@ -731,6 +843,17 @@ export class RatesService {
     updates.originYardId = yardScope.originYardId;
     updates.destinationYardId = yardScope.destinationYardId;
 
+    // The owning line is re-validated on every edit: a patch that flips the
+    // direction to EXPORT has to be refused for a line rate, and a patch that
+    // moves the rate to a suspended line too.
+    const shippingLineCompanyId = await this.resolveShippingLineScope(
+      dto.shippingLineCompanyId !== undefined
+        ? dto.shippingLineCompanyId
+        : existing.shippingLineCompanyId,
+      updates.tradeDirection,
+    );
+    updates.shippingLineCompanyId = shippingLineCompanyId;
+
     // Keep the derived rateType in sync with whatever changed.
     const rateType = deriveRateType({
       appliesTo,
@@ -779,6 +902,7 @@ export class RatesService {
     await this.assertNoDuplicatePattern({
       rateType,
       ...(this.resolvesSingleRate(appliesTo, trigger) ? {} : { rateUnit }),
+      shippingLineCompanyId,
       containerTypeId: updates.containerTypeId,
       cargoTypeId: updates.cargoTypeId,
       tradeDirection: updates.tradeDirection,
@@ -788,6 +912,11 @@ export class RatesService {
       ignoreId: id,
     });
 
+    updates.baseLiters = this.resolveBaseLiters(
+      rateUnit,
+      dto.baseLiters !== undefined ? dto.baseLiters : existing.baseLiters,
+    );
+
     updates.currency =
       appliesTo === 'LAST_MILE'
         ? (dto.currency ?? existing.currency ?? 'ETB')
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/yard-positions.service.ts b/apps/edr-freight-api/src/modules/rule-engine/services/yard-positions.service.ts
new file mode 100644
index 000000000..93f9752f6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/yard-positions.service.ts
@@ -0,0 +1,194 @@
+import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
+import { DataSource, In, IsNull } from 'typeorm';
+
+import { YardPosition } from '../entities/yard-position.entity';
+import { Yard } from '../entities/yard.entity';
+
+/** A mapped desk, joined to its IAM position for display. */
+export interface YardPositionRow {
+  id: string;
+  yardId: string;
+  yardCode: string;
+  yardLabel: string;
+  positionId: string;
+  /** Localised name from `iam.positions.name` — null if the position is gone. */
+  positionName: { am?: string; en?: string } | null;
+  positionTypeKey: string | null;
+}
+
+/**
+ * The desk↔yard mapping behind yard access scoping.
+ *
+ * Reads always join `iam.positions` and drop soft-deleted rows: the mapping has
+ * no FK to IAM (see the migration), so a position deleted in the admin UI leaves
+ * an orphan row here. Dropping it on read means the orphan can never widen
+ * someone's scope — it just disappears.
+ */
+@Injectable()
+export class YardPositionsService {
+  constructor(private readonly dataSource: DataSource) {}
+
+  /** Mapping rows, optionally narrowed to one yard or one position. */
+  async list(filter: {
+    yardId?: string;
+    positionId?: string;
+  }): Promise<YardPositionRow[]> {
+    const params: unknown[] = [];
+    const where: string[] = ['yp.deleted_at IS NULL', 'y.deleted_at IS NULL'];
+
+    if (filter.yardId) {
+      params.push(filter.yardId);
+      where.push(`yp.yard_id = $${params.length}`);
+    }
+    if (filter.positionId) {
+      params.push(filter.positionId);
+      where.push(`yp.position_id = $${params.length}`);
+    }
+
+    return this.dataSource.query(
+      `SELECT yp.id            AS "id",
+              yp.yard_id       AS "yardId",
+              y.code           AS "yardCode",
+              y.label          AS "yardLabel",
+              yp.position_id   AS "positionId",
+              p.name           AS "positionName",
+              pt.key           AS "positionTypeKey"
+         FROM freight.yard_positions yp
+         JOIN freight.yards y        ON y.id = yp.yard_id
+         -- INNER join: a mapping whose position was deleted grants nothing and
+         -- is not shown. The row stays for audit until someone re-saves the set.
+         JOIN iam.positions p        ON p.id = yp.position_id AND p.deleted_at IS NULL
+         LEFT JOIN iam.position_types pt ON pt.id = p.position_type_id
+        WHERE ${where.join(' AND ')}
+        ORDER BY y.display_order ASC, y.label ASC, p.name->>'en' ASC`,
+      params,
+    );
+  }
+
+  /**
+   * Replace the yard's entire position set.
+   *
+   * Replace, not append — the admin UI submits the full multi-select value, so a
+   * partial payload would silently keep desks the user just unticked. Callers
+   * sending a delta will remove everything they omit.
+   */
+  async setPositionsForYard(
+    yardId: string,
+    positionIds: string[],
+  ): Promise<YardPositionRow[]> {
+    await this.assertYardExists(yardId);
+    await this.assertPositionsExist(positionIds);
+
+    await this.dataSource.transaction(async (manager) => {
+      const repo = manager.getRepository(YardPosition);
+      await repo.delete({ yardId });
+      if (positionIds.length) {
+        await repo.insert(
+          [...new Set(positionIds)].map((positionId) => ({ yardId, positionId })),
+        );
+      }
+    });
+
+    return this.list({ yardId });
+  }
+
+  /** Replace the position's entire yard set. Same replace semantics. */
+  async setYardsForPosition(
+    positionId: string,
+    yardIds: string[],
+  ): Promise<YardPositionRow[]> {
+    await this.assertPositionsExist([positionId]);
+    await this.assertYardsExist(yardIds);
+
+    await this.dataSource.transaction(async (manager) => {
+      const repo = manager.getRepository(YardPosition);
+      await repo.delete({ positionId });
+      if (yardIds.length) {
+        await repo.insert(
+          [...new Set(yardIds)].map((yardId) => ({ yardId, positionId })),
+        );
+      }
+    });
+
+    return this.list({ positionId });
+  }
+
+  /**
+   * Positions offered by the mapping picker.
+   *
+   * Reads `iam.positions` directly rather than going through IAM's
+   * `/positions/list/{unitId}`: that endpoint needs the caller to resolve a unit
+   * first, and the picker wants every desk that could staff a yard regardless of
+   * which unit it hangs under.
+   */
+  async listSelectablePositions(): Promise<
+    Array<{
+      id: string;
+      name: { am?: string; en?: string } | null;
+      positionTypeKey: string | null;
+      unitKey: string | null;
+    }>
+  > {
+    return this.dataSource.query(
+      `SELECT p.id       AS "id",
+              p.name     AS "name",
+              pt.key     AS "positionTypeKey",
+              u.key      AS "unitKey"
+         FROM iam.positions p
+         LEFT JOIN iam.position_types pt ON pt.id = p.position_type_id
+         LEFT JOIN iam.units u           ON u.id = p.unit_id
+        WHERE p.deleted_at IS NULL
+        ORDER BY p.name->>'en' ASC`,
+    );
+  }
+
+  /** Yard ids mapped to any of these positions — the scope resolver's read. */
+  async yardIdsForPositions(positionIds: string[]): Promise<string[]> {
+    if (!positionIds.length) return [];
+    const rows: { yardId: string }[] = await this.dataSource.query(
+      `SELECT DISTINCT yp.yard_id AS "yardId"
+         FROM freight.yard_positions yp
+         JOIN freight.yards y ON y.id = yp.yard_id AND y.deleted_at IS NULL
+        WHERE yp.deleted_at IS NULL
+          AND yp.position_id = ANY($1)`,
+      [positionIds],
+    );
+    return rows.map((r) => r.yardId);
+  }
+
+  private async assertYardExists(yardId: string): Promise<void> {
+    const yard = await this.dataSource
+      .getRepository(Yard)
+      .findOne({ where: { id: yardId, deletedAt: IsNull() } });
+    if (!yard) throw new NotFoundException(`Yard ${yardId} not found`);
+  }
+
+  private async assertYardsExist(yardIds: string[]): Promise<void> {
+    if (!yardIds.length) return;
+    const found = await this.dataSource
+      .getRepository(Yard)
+      .count({ where: { id: In(yardIds), deletedAt: IsNull() } });
+    if (found !== new Set(yardIds).size) {
+      throw new BadRequestException('One or more yards do not exist');
+    }
+  }
+
+  /**
+   * Validated in the service because the database cannot: there is no FK to
+   * `iam.positions`, so an unchecked payload would happily store a typo'd uuid
+   * that silently grants nothing and reads as a configuration bug later.
+   */
+  private async assertPositionsExist(positionIds: string[]): Promise<void> {
+    if (!positionIds.length) return;
+    const unique = [...new Set(positionIds)];
+    const rows: { count: string }[] = await this.dataSource.query(
+      `SELECT COUNT(*)::text AS count
+         FROM iam.positions
+        WHERE id = ANY($1) AND deleted_at IS NULL`,
+      [unique],
+    );
+    if (Number(rows[0]?.count ?? 0) !== unique.length) {
+      throw new BadRequestException('One or more positions do not exist');
+    }
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/yard-scope.service.spec.ts b/apps/edr-freight-api/src/modules/rule-engine/services/yard-scope.service.spec.ts
new file mode 100644
index 000000000..c9af80ad3
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/yard-scope.service.spec.ts
@@ -0,0 +1,139 @@
+import { ForbiddenException } from '@nestjs/common';
+
+import { YardScopeService } from './yard-scope.service';
+
+/**
+ * The resolver answers "which yards", never "may they act at all" — that stays
+ * with the permission guard. So a mapped desk is narrowed to its yards, and an
+ * unmapped one keeps the reach its permissions already gave it.
+ */
+describe('YardScopeService', () => {
+  const yardIdsForPositions = jest.fn();
+  const service = () =>
+    new YardScopeService({ yardIdsForPositions } as never);
+
+  const staff = (positionId: string, permissions: string[] = []) => ({
+    roles: [{ key: 'staff' }],
+    permissions: permissions.map((key) => ({ key })),
+    employee: { position: { id: positionId, permissions: [] } },
+  });
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    delete process.env.YARD_SCOPE_ENFORCE;
+  });
+
+  it('resolves a mapped position to its yards', async () => {
+    yardIdsForPositions.mockResolvedValue(['yard-kality', 'yard-mojo']);
+
+    const scope = await service().getScopedYardIds(staff('pos-officer'));
+
+    expect(scope).toEqual(['yard-kality', 'yard-mojo']);
+    expect(yardIdsForPositions).toHaveBeenCalledWith(['pos-officer']);
+  });
+
+  it('leaves an unmapped position unrestricted — permissions still gate the action', async () => {
+    yardIdsForPositions.mockResolvedValue([]);
+
+    expect(await service().getScopedYardIds(staff('pos-unmapped'))).toBeNull();
+  });
+
+  it('leaves a caller with no resolvable position unrestricted', async () => {
+    const noPosition = { roles: [{ key: 'staff' }], employee: { position: {} } };
+
+    expect(await service().getScopedYardIds(noPosition)).toBeNull();
+    expect(yardIdsForPositions).not.toHaveBeenCalled();
+  });
+
+  it('narrows nothing for an anonymous caller but grants nothing either', async () => {
+    expect(await service().getScopedYardIds(null)).toEqual([]);
+  });
+
+  it('returns unrestricted only for super admins and view_all holders', async () => {
+    const superAdmin = { roles: [{ key: 'super_admin' }] };
+    const hqDesk = staff('pos-occ', ['edr_freight_app:yards:view_all']);
+
+    expect(await service().getScopedYardIds(superAdmin)).toBeNull();
+    expect(await service().getScopedYardIds(hqDesk)).toBeNull();
+    expect(yardIdsForPositions).not.toHaveBeenCalled();
+  });
+
+  it('includes delegated positions — standing in must not lose the yard', async () => {
+    yardIdsForPositions.mockResolvedValue(['yard-kality']);
+
+    await service().getScopedYardIds({
+      roles: [{ key: 'staff' }],
+      employee: {
+        position: { id: 'pos-own' },
+        delegatedPositions: [{ id: 'pos-gelan-director' }],
+      },
+    });
+
+    expect(yardIdsForPositions).toHaveBeenCalledWith([
+      'pos-own',
+      'pos-gelan-director',
+    ]);
+  });
+
+  describe('listFilterYardIds', () => {
+    it('narrows nothing while shadow-logging', async () => {
+      yardIdsForPositions.mockResolvedValue(['yard-kality']);
+
+      expect(
+        await service().listFilterYardIds(staff('pos-officer'), undefined, 'list'),
+      ).toBeNull();
+    });
+
+    it('narrows to the mapped yards once enforcing', async () => {
+      process.env.YARD_SCOPE_ENFORCE = 'true';
+      yardIdsForPositions.mockResolvedValue(['yard-kality', 'yard-mojo']);
+
+      expect(
+        await service().listFilterYardIds(staff('pos-officer'), undefined, 'list'),
+      ).toEqual(['yard-kality', 'yard-mojo']);
+    });
+
+    it('keeps an in-scope yard filter as the caller asked', async () => {
+      process.env.YARD_SCOPE_ENFORCE = 'true';
+      yardIdsForPositions.mockResolvedValue(['yard-kality', 'yard-mojo']);
+
+      expect(
+        await service().listFilterYardIds(staff('pos-officer'), 'yard-mojo', 'list'),
+      ).toEqual(['yard-mojo']);
+    });
+
+    it('returns an empty set — not everything — for an out-of-scope yard filter', async () => {
+      process.env.YARD_SCOPE_ENFORCE = 'true';
+      yardIdsForPositions.mockResolvedValue(['yard-kality']);
+
+      expect(
+        await service().listFilterYardIds(staff('pos-officer'), 'yard-djibouti', 'list'),
+      ).toEqual([]);
+    });
+
+    it('never narrows an unmapped desk', async () => {
+      process.env.YARD_SCOPE_ENFORCE = 'true';
+      yardIdsForPositions.mockResolvedValue([]);
+
+      expect(
+        await service().listFilterYardIds(staff('pos-unmapped'), undefined, 'list'),
+      ).toBeNull();
+    });
+  });
+
+  it('only logs an out-of-scope yard until YARD_SCOPE_ENFORCE is set', async () => {
+    yardIdsForPositions.mockResolvedValue(['yard-kality']);
+    const shadow = service();
+
+    await expect(
+      shadow.assertYardInScope(staff('pos-officer'), 'yard-mojo', 'test'),
+    ).resolves.toBeUndefined();
+
+    process.env.YARD_SCOPE_ENFORCE = 'true';
+    const enforcing = service();
+
+    await expect(
+      enforcing.assertYardInScope(staff('pos-officer'), 'yard-mojo', 'test'),
+    ).rejects.toBeInstanceOf(ForbiddenException);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/rule-engine/services/yard-scope.service.ts b/apps/edr-freight-api/src/modules/rule-engine/services/yard-scope.service.ts
new file mode 100644
index 000000000..0a7fbe2e0
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/rule-engine/services/yard-scope.service.ts
@@ -0,0 +1,186 @@
+import { ForbiddenException, Injectable, Logger } from "@nestjs/common";
+
+import { hasFreightPermission, isSuperAdmin } from "../../../common/freight-permission.util";
+import { FREIGHT_PERMS } from "../../../seed/freight-permissions.registry";
+import { YardPositionsService } from "./yard-positions.service";
+
+/**
+ * Caller shape the resolver reads — the `/auth/me` user in either of its two
+ * shapes. Structurally compatible with what `freight-permission.util` accepts,
+ * so the same object serves both the permission checks and the position walk.
+ */
+type PositionLike = {
+  id?: string;
+  permissions?: { key?: string }[];
+  positionType?: { key?: string } | null;
+};
+
+type ScopeUser = {
+  roles?: { key?: string }[];
+  permissions?: { key?: string }[];
+  employee?:
+    | {
+        position?: PositionLike;
+        delegatedPositions?: PositionLike[];
+      }
+    | { positions?: PositionLike[] }[]
+    | null;
+};
+
+/**
+ * Which yards a caller may touch.
+ *
+ * Scope follows the caller's ACTIVE position, not a union of every position they
+ * have ever held: the frontends already send `x-current-position-id` and the
+ * token snapshots that one position, so switching desks switches yards — which
+ * is what staff covering two yards actually do. Delegated positions are added on
+ * top, otherwise standing in for the Gelan director silently loses Gelan.
+ *
+ * `null` means unrestricted, and an UNMAPPED caller gets it. Scoping narrows a
+ * desk that has been given yards; it does not hand out access. Whether the
+ * caller may perform the action at all is the permission guard's job — this
+ * resolver only answers "which yards", so a desk with the permission and no
+ * mapping keeps the reach it had before the mapping existed.
+ *
+ * The trade-off is deliberate and worth knowing: an accidentally-cleared
+ * mapping widens access rather than blocking work, so the mapping is not a
+ * containment barrier on its own — the permission keys still are. Super admins
+ * and holders of `yards:view_all` are unrestricted regardless of mapping.
+ *
+ * ENFORCEMENT IS OFF until `YARD_SCOPE_ENFORCE=true`. Until then
+ * {@link assertYardInScope} logs what it would have blocked and returns. Flip it
+ * only once the mapping table is populated and the log is quiet — on an empty
+ * table, enforcing locks out every staff member at once.
+ */
+@Injectable()
+export class YardScopeService {
+  private readonly logger = new Logger(YardScopeService.name);
+
+  // ponytail: 60s cache keyed by the position-id set, no invalidation hook. A
+  // mapping change takes up to a minute to reach the resolver. Call
+  // `invalidate()` from the mutation if that lag ever matters.
+  private static readonly CACHE_TTL_MS = 60_000;
+  private readonly cache = new Map<string, { yardIds: string[]; at: number }>();
+
+  constructor(private readonly yardPositions: YardPositionsService) {}
+
+  /** True when the deny path is live; false while shadow-logging. */
+  get enforced(): boolean {
+    return process.env.YARD_SCOPE_ENFORCE === "false";
+  }
+
+  /** Yard ids the caller is scoped to, or `null` for unrestricted. */
+  async getScopedYardIds(user: ScopeUser | null | undefined): Promise<string[] | null> {
+    // No user at all is an unauthenticated call the guards should already have
+    // rejected — narrow to nothing rather than trusting it.
+    if (!user) return [];
+    if (isSuperAdmin(user)) return null;
+    if (hasFreightPermission(user, FREIGHT_PERMS.yards.viewAll)) return null;
+
+    const positionIds = this.effectivePositionIds(user);
+    // No resolvable position — nothing to narrow by, so nothing is narrowed.
+    if (!positionIds.length) return null;
+
+    const key = positionIds.join(",");
+    const hit = this.cache.get(key);
+    if (hit && Date.now() - hit.at < YardScopeService.CACHE_TTL_MS) {
+      return hit.yardIds.length ? hit.yardIds : null;
+    }
+
+    const yardIds = await this.yardPositions.yardIdsForPositions(positionIds);
+    this.cache.set(key, { yardIds, at: Date.now() });
+    // Unmapped desk → unrestricted. Mapping narrows; absence of one does not.
+    return yardIds.length ? yardIds : null;
+  }
+
+  async isYardInScope(
+    user: ScopeUser | null | undefined,
+    yardId: string | null | undefined,
+  ): Promise<boolean> {
+    if (!yardId) return true;
+    const scope = await this.getScopedYardIds(user);
+    return scope === null || scope.includes(yardId);
+  }
+
+  /**
+   * Gate an action on a yard. While `YARD_SCOPE_ENFORCE` is unset this only
+   * logs — wire it into write paths first and read filters second, so the
+   * shadow log shows what enforcement would break before it breaks it.
+   */
+  async assertYardInScope(
+    user: ScopeUser | null | undefined,
+    yardId: string | null | undefined,
+    context: string,
+  ): Promise<void> {
+    if (await this.isYardInScope(user, yardId)) return;
+
+    const positions = this.effectivePositionIds(user).join(",") || "none";
+    if (!this.enforced) {
+      this.logger.warn(
+        `[yard-scope shadow] would block ${context}: yard=${yardId} positions=${positions}`,
+      );
+      return;
+    }
+    throw new ForbiddenException("This yard is outside your assigned yards");
+  }
+
+  /**
+   * Yard ids a list query should be narrowed to, or `null` for no narrowing.
+   *
+   * Returns an EMPTY array only when the caller explicitly asked for a yard
+   * outside their scope and enforcement is on — the caller should answer with an
+   * empty result rather than silently widening back to everything.
+   *
+   * While `YARD_SCOPE_ENFORCE` is unset this always returns `null` and logs what
+   * it would have narrowed, so the mapping can be populated against real traffic
+   * before it starts hiding rows.
+   */
+  async listFilterYardIds(
+    user: ScopeUser | null | undefined,
+    requestedYardId: string | null | undefined,
+    context: string,
+  ): Promise<string[] | null> {
+    const scope = await this.getScopedYardIds(user);
+    if (scope === null) return null;
+
+    const outOfScope = !!requestedYardId && !scope.includes(requestedYardId);
+
+    if (!this.enforced) {
+      this.logger.warn(
+        `[yard-scope shadow] would narrow ${context} to [${scope.join(", ")}]` +
+          (outOfScope ? ` and reject yard=${requestedYardId}` : ""),
+      );
+      return null;
+    }
+
+    if (outOfScope) return [];
+    return requestedYardId ? [requestedYardId] : scope;
+  }
+
+  /** Drops the memoised scopes — call after editing the mapping. */
+  invalidate(): void {
+    this.cache.clear();
+  }
+
+  /** Active position plus any delegated ones, across both `employee` shapes. */
+  private effectivePositionIds(user: ScopeUser | null | undefined): string[] {
+    const ids = new Set<string>();
+    const employee = user?.employee;
+    if (!employee) return [];
+
+    if (Array.isArray(employee)) {
+      for (const emp of employee) {
+        for (const position of emp.positions ?? []) {
+          if (position?.id) ids.add(position.id);
+        }
+      }
+      return [...ids];
+    }
+
+    if (employee.position?.id) ids.add(employee.position.id);
+    for (const delegated of employee.delegatedPositions ?? []) {
+      if (delegated?.id) ids.add(delegated.id);
+    }
+    return [...ids];
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.spec.ts b/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.spec.ts
index 4a5fc86bb..2d1bbf6f4 100644
--- a/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.spec.ts
@@ -72,6 +72,8 @@ describe('SchedulingRescheduleService', () => {
       previewTrainSchedule: jest.fn(),
       unassignBooking: jest.fn(),
       assignBookingsToSchedule: jest.fn(),
+      windowFieldsForNewDeparture: jest.fn().mockResolvedValue({}),
+      emitWindowState: jest.fn().mockResolvedValue(undefined),
     };
     schedulingRescheduleRepository = {
       createEvent: jest.fn().mockResolvedValue({ id: 'event-1' }),
@@ -213,6 +215,13 @@ describe('SchedulingRescheduleService', () => {
     });
     trainSchedulesRepository.updateStatus.mockResolvedValue(undefined);
     trainSchedulingService.assignBookingsToSchedule.mockResolvedValue({ id: 'sched-1' });
+    // An OPEN window's close must follow the new departure (this is the
+    // portal's "closes in" countdown) — the derived fields ride along with the
+    // date write.
+    const newCloses = new Date('2099-06-22T08:00:00.000Z');
+    trainSchedulingService.windowFieldsForNewDeparture.mockResolvedValue({
+      windowClosesAt: newCloses,
+    });
 
     const result = await service.maintenanceReschedule(
       'sched-1',
@@ -228,9 +237,16 @@ describe('SchedulingRescheduleService', () => {
     expect(trainSchedulesRepository.updateStatus).toHaveBeenCalledWith(
       'sched-1',
       'DRAFT',
-      { scheduledDepartureDate: new Date('2099-06-22T10:00:00.000Z') },
+      {
+        scheduledDepartureDate: new Date('2099-06-22T10:00:00.000Z'),
+        windowClosesAt: newCloses,
+      },
       txManager,
     );
+    expect(trainSchedulingService.windowFieldsForNewDeparture).toHaveBeenCalledWith(
+      schedule,
+      new Date('2099-06-22T10:00:00.000Z'),
+    );
     expect(schedulingRescheduleRepository.createEvent).toHaveBeenCalledWith(
       expect.objectContaining({
         trigger: 'TRAIN_MAINTENANCE',
diff --git a/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.ts b/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.ts
index fefbbc868..7c41ee43a 100644
--- a/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.ts
+++ b/apps/edr-freight-api/src/modules/scheduling-reschedule/scheduling-reschedule.service.ts
@@ -11,7 +11,7 @@ import { Booking } from '../bookings/entities/booking.entity';
 import { BookingsRepository } from '../bookings/bookings.repository';
 import { compareSchedulingPriority } from '../scheduling/compare-scheduling-priority.util';
 import { TrainSchedulesRepository } from '../train-schedules/train-schedules.repository';
-import { TrainSchedulingService } from '../train-scheduling/train-scheduling.service';
+import { TrainSchedulingService } from '../train-scheduling/services/train-scheduling.service';
 import { BookingNotifierService } from '../train-scheduling/booking-notifier.service';
 import { ExecuteRescheduleDto, PreviewRescheduleDto } from './dto/preview-reschedule.dto';
 import { MaintenanceRescheduleDto } from './dto/maintenance-reschedule.dto';
@@ -227,17 +227,25 @@ export class SchedulingRescheduleService {
     // through this manager without editing TrainSchedulingService. A failure
     // between those steps and this block can still leave partial state; a human
     // must finish the full cross-service transaction threading.
+    // The booking window must follow the new departure (an OPEN window's
+    // "closes in" countdown is capped at departure − close offset; PRE_WINDOW /
+    // DONE re-derive their open/close). Same math as maintenanceReschedule.
+    const windowFields = newDeparture
+      ? await this.trainSchedulingService.windowFieldsForNewDeparture(
+          schedule,
+          newDeparture,
+        )
+      : {};
+
     await this.dataSource.transaction(async (manager) => {
       if (newDeparture) {
-        // M7: raw write of scheduledDepartureDate. We deliberately do NOT
-        // delegate to TrainSchedulingService.updateScheduleDate, which only
-        // permits a date change while windowPhase === 'PRE_WINDOW' and would
-        // reject reschedules of already-open (SCHEDULED) trains. Consequence:
-        // the booking-window fields are NOT re-derived for the new date here.
+        // Raw write of scheduledDepartureDate: updateScheduleDate only permits a
+        // date change while windowPhase === 'PRE_WINDOW' and would reject
+        // reschedules of already-open (SCHEDULED) trains.
         await this.trainSchedulesRepository.updateStatus(
           scheduleId,
           schedule.status as TrainScheduleStatus,
-          { scheduledDepartureDate: newDeparture },
+          { scheduledDepartureDate: newDeparture, ...windowFields },
           manager,
         );
       }
@@ -263,6 +271,7 @@ export class SchedulingRescheduleService {
     // `newDeparture` is null when the date was unchanged, so retained customers
     // are not falsely told the train was rescheduled.
     await this.notifyRescheduleOutcome(dto, newDeparture);
+    if (newDeparture) void this.trainSchedulingService.emitWindowState(scheduleId);
 
     return { plan, schedule: assignResult };
   }
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/dto/cancel-shipping-line-booking.dto.ts b/apps/edr-freight-api/src/modules/shipping-lines/dto/cancel-shipping-line-booking.dto.ts
new file mode 100644
index 000000000..1064cdeb4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/dto/cancel-shipping-line-booking.dto.ts
@@ -0,0 +1,15 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsOptional, IsString, MaxLength } from "class-validator";
+
+/** Payload for a shipping line cancelling its own booking. */
+export class CancelShippingLineBookingDto {
+  @ApiProperty({
+    required: false,
+    description:
+      "Why the booking is being cancelled. Recorded on the booking's review-note log.",
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  reason?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/dto/complete-shipping-line-booking.dto.ts b/apps/edr-freight-api/src/modules/shipping-lines/dto/complete-shipping-line-booking.dto.ts
new file mode 100644
index 000000000..90e31e42d
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/dto/complete-shipping-line-booking.dto.ts
@@ -0,0 +1,193 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Transform, Type } from "class-transformer";
+import {
+  IsArray,
+  IsBoolean,
+  IsDateString,
+  IsIn,
+  IsInt,
+  IsNumber,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Min,
+  ValidateNested,
+} from "class-validator";
+
+import { PAYMENT_CURRENCIES } from "../../contracts/dto/create-contract.dto";
+
+/**
+ * One physical container on a line — number, seal, VGM and its per-container
+ * handling switches. Same shape the customer shipment form submits.
+ */
+export class CompleteShippingLineContainerUnitDto {
+  @ApiProperty({ example: "MSCU1234567" })
+  @IsString()
+  containerNumber!: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  sealNumber?: string;
+
+  @ApiProperty({ minimum: 0, description: "VGM of this container, tons." })
+  @IsNumber()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  vgmTons!: number;
+
+  @ApiPropertyOptional({ default: false })
+  @IsOptional()
+  @IsBoolean()
+  isHazardous?: boolean;
+
+  @ApiPropertyOptional({ default: false })
+  @IsOptional()
+  @IsBoolean()
+  isReefer?: boolean;
+}
+
+/**
+ * One container line the shipping line ships — container type + count, the
+ * same shape the customer one-time form collects. When `units` is sent (the
+ * full booking page), per-container numbers/seals/VGM and handling switches
+ * are persisted exactly like the customer shipment form; without it (legacy
+ * modal shape) the line-level counts stand alone.
+ */
+export class CompleteShippingLineContainerLineDto {
+  @ApiPropertyOptional({
+    format: "uuid",
+    description:
+      "Container type being shipped. Optional when containerSize is sent — the server resolves the type from the size.",
+  })
+  @IsOptional()
+  @IsUUID()
+  containerTypeId?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Container size, e.g. "20ft" | "40ft". The server maps it to the configured container type (reefer variant when the line carries reefer boxes) — so the client never needs the type catalog.',
+  })
+  @IsOptional()
+  @IsString()
+  containerSize?: string;
+
+  @ApiProperty({ minimum: 1 })
+  @IsInt()
+  @Min(1)
+  @Transform(({ value }) => Number(value))
+  quantity!: number;
+
+  @ApiPropertyOptional({ minimum: 0, description: "VGM per container, tons." })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  vgmPerUnitTons?: number;
+
+  @ApiPropertyOptional({ minimum: 0 })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  hazardousQuantity?: number;
+
+  @ApiPropertyOptional({ minimum: 0 })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  reeferQuantity?: number;
+
+  @ApiPropertyOptional({
+    type: [CompleteShippingLineContainerUnitDto],
+    description:
+      "Per-container details. When present, the handling counts and VGM are derived from these rows.",
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => CompleteShippingLineContainerUnitDto)
+  units?: CompleteShippingLineContainerUnitDto[];
+}
+
+/**
+ * Completion payload for a shipping-line booking whose documents Operations
+ * has approved (CLEARANCE_READY): the cargo and the binding shipment day —
+ * the two things `initiate` deliberately left empty.
+ */
+export class CompleteShippingLineBookingDto {
+  @ApiProperty({
+    description: "Binding shipment day (train departure day).",
+    example: "2026-09-01",
+  })
+  @IsDateString()
+  scheduledDate!: string;
+
+  @ApiPropertyOptional({
+    format: "uuid",
+    description:
+      "Which of the line's dedicated trains this booking rides. Required when more than one departs on the chosen day; implicit with a single departure.",
+  })
+  @IsOptional()
+  @IsUUID()
+  trainScheduleId?: string;
+
+  @ApiPropertyOptional({ enum: PAYMENT_CURRENCIES })
+  @IsOptional()
+  @IsIn([...PAYMENT_CURRENCIES])
+  paymentCurrency?: string;
+
+  @ApiPropertyOptional({
+    type: [CompleteShippingLineContainerLineDto],
+    description: "Container freight: what ships. Required for CONTAINER bookings.",
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => CompleteShippingLineContainerLineDto)
+  containers?: CompleteShippingLineContainerLineDto[];
+
+  @ApiPropertyOptional({
+    format: "uuid",
+    description: "Bulk freight: the cargo type. Required for BULK bookings.",
+  })
+  @IsOptional()
+  @IsUUID()
+  cargoTypeId?: string;
+
+  @ApiPropertyOptional({
+    minimum: 0,
+    description: "Bulk freight: total weight in tons. Required for BULK bookings.",
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  cargoWeightTons?: number;
+
+  @ApiPropertyOptional({
+    minimum: 0,
+    description: "Bulk freight: hazardous portion of the cargo.",
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  bulkHazardousQuantity?: number;
+
+  @ApiPropertyOptional({
+    minimum: 0,
+    description: "Bulk freight: refrigerated portion of the cargo.",
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Transform(({ value }) => Number(value))
+  bulkReeferQuantity?: number;
+
+  @ApiPropertyOptional({ description: "What the containers carry." })
+  @IsOptional()
+  @IsString()
+  cargoFreeText?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/dto/create-shipping-line.dto.ts b/apps/edr-freight-api/src/modules/shipping-lines/dto/create-shipping-line.dto.ts
new file mode 100644
index 000000000..5f89c916c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/dto/create-shipping-line.dto.ts
@@ -0,0 +1,68 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import {
+  IsEmail,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Matches,
+  MaxLength,
+} from "class-validator";
+
+import { IsValidPhone } from "../../../common/validators/is-phone-number.validator";
+
+export class CreateShippingLineDto {
+  @ApiProperty({ example: "Ethiopian Shipping Lines" })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(200)
+  name!: string;
+
+  /**
+   * Becomes the IAM account's email — the activation link is sent here, so it
+   * is required even though the customer equivalent is optional.
+   */
+  @ApiProperty({ example: "ops@esl.com.et" })
+  @IsEmail()
+  @MaxLength(150)
+  email!: string;
+
+  @ApiPropertyOptional({ example: "+251911223344" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(30)
+  @IsValidPhone()
+  phoneNumber?: string;
+
+  @ApiPropertyOptional({
+    example: "ESLK",
+    description: "Standard Carrier Alpha Code — 2-4 letters",
+  })
+  @IsOptional()
+  @IsString()
+  @Matches(/^[A-Za-z]{2,4}$/, {
+    message: "SCAC must be 2-4 letters",
+  })
+  scacCode?: string;
+
+  @ApiPropertyOptional({ example: "IMO9074729" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(20)
+  imoNumber?: string;
+
+  @ApiPropertyOptional({ example: "ESLU" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(20)
+  bicCode?: string;
+
+  /**
+   * Login name. Optional — defaults to the email, which is what the line will
+   * naturally try first.
+   */
+  @ApiPropertyOptional({ example: "esl-ops" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(100)
+  username?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/dto/initiate-shipping-line-booking.dto.ts b/apps/edr-freight-api/src/modules/shipping-lines/dto/initiate-shipping-line-booking.dto.ts
new file mode 100644
index 000000000..3b0615fe4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/dto/initiate-shipping-line-booking.dto.ts
@@ -0,0 +1,47 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsDateString, IsIn, IsOptional, IsUUID } from "class-validator";
+
+import { FREIGHT_TYPES } from "../../bookings/entities/booking.entity";
+
+/**
+ * Payload for initiating a bare shipping-line booking.
+ *
+ * A customer's bare booking inherits its lane from the contract it is initiated
+ * under. Shipping lines have no contract, so the lane comes from a route the
+ * caller picks — one choice that yields origin, destination and trade direction
+ * together, rather than three fields that can contradict each other.
+ */
+export class InitiateShippingLineBookingDto {
+  @ApiProperty({
+    description:
+      "The lane being booked. Supplies the booking's origin yard, destination yard and trade direction.",
+  })
+  @IsUUID()
+  routeId!: string;
+
+  @ApiProperty({
+    required: false,
+    description: "Service type being booked.",
+  })
+  @IsOptional()
+  @IsUUID()
+  serviceTypeId?: string;
+
+  @ApiProperty({
+    required: false,
+    enum: FREIGHT_TYPES,
+    description: "Freight type. Defaults to CONTAINER.",
+  })
+  @IsOptional()
+  @IsIn(FREIGHT_TYPES)
+  freightType?: string;
+
+  @ApiProperty({
+    required: false,
+    description:
+      "Intended shipment day (YYYY-MM-DD). Unlike the customer flow it is picked up front — a shipping line has no later operation-request step to choose it at.",
+  })
+  @IsOptional()
+  @IsDateString()
+  scheduledDate?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/dto/shipping-line-credit.dto.ts b/apps/edr-freight-api/src/modules/shipping-lines/dto/shipping-line-credit.dto.ts
new file mode 100644
index 000000000..7ad524f01
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/dto/shipping-line-credit.dto.ts
@@ -0,0 +1,85 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import {
+  ArrayNotEmpty,
+  IsArray,
+  IsInt,
+  IsOptional,
+  IsString,
+  IsUUID,
+  MaxLength,
+  Min,
+  MinLength,
+} from "class-validator";
+
+/** Finance's request to bill a batch of unbilled credits as one invoice. */
+export class GenerateCreditInvoiceDto {
+  @ApiProperty({
+    description:
+      "The unbilled credits to bill. All must belong to the same shipping line and share one currency.",
+    type: [String],
+    format: "uuid",
+  })
+  @IsArray()
+  @ArrayNotEmpty()
+  @IsUUID("4", { each: true })
+  creditIds!: string[];
+
+  @ApiPropertyOptional({
+    description:
+      "Pay window in days from issue. Defaults to the standard invoice term.",
+    minimum: 1,
+    example: 14,
+  })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  dueInDays?: number;
+}
+
+/** Finance's request for a manual action on a credit invoice (maker step). */
+export class RequestInvoiceActionDto {
+  @ApiProperty({
+    description:
+      "Why the action is needed. Shown to the approver and kept for audit.",
+    example: "Paid by bank transfer, slip #TT-4491",
+  })
+  @IsString()
+  @MinLength(3)
+  @MaxLength(500)
+  reason!: string;
+
+  @ApiPropertyOptional({
+    description:
+      "Offline payment reference (bank slip / transfer number). MARK_PAID requests only.",
+    example: "TT-4491",
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  paymentReference?: string;
+}
+
+/** The decision on a pending request (approve and reject routes). */
+export class DecideInvoiceActionDto {
+  @ApiPropertyOptional({
+    description: "Decision note. Required when rejecting.",
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  note?: string;
+}
+
+/** Write-off of a single unbilled credit. */
+export class CancelCreditDto {
+  @ApiProperty({
+    description: "Why the credit is being written off. Recorded on the row.",
+    example: "Booking voided before departure",
+  })
+  @IsString()
+  @MinLength(3)
+  @MaxLength(255)
+  reason!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/dto/shipping-line-response.dto.ts b/apps/edr-freight-api/src/modules/shipping-lines/dto/shipping-line-response.dto.ts
new file mode 100644
index 000000000..051c3af28
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/dto/shipping-line-response.dto.ts
@@ -0,0 +1,64 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+
+import {
+  ShippingLineCompany,
+  ShippingLineStatus,
+} from "../entities/shipping-line-company.entity";
+
+export class ShippingLineResponseDto {
+  @ApiProperty()
+  id: string;
+
+  @ApiProperty()
+  name: string;
+
+  @ApiProperty()
+  email: string;
+
+  @ApiPropertyOptional()
+  phoneNumber?: string | null;
+
+  @ApiPropertyOptional()
+  scacCode?: string | null;
+
+  @ApiPropertyOptional()
+  imoNumber?: string | null;
+
+  @ApiPropertyOptional()
+  bicCode?: string | null;
+
+  @ApiProperty({ enum: ShippingLineStatus })
+  status: ShippingLineStatus;
+
+  @ApiProperty()
+  createdAt: Date;
+
+  constructor(entity: ShippingLineCompany) {
+    this.id = entity.id;
+    this.name = entity.name;
+    this.email = entity.email;
+    this.phoneNumber = entity.phoneNumber ?? null;
+    this.scacCode = entity.scacCode ?? null;
+    this.imoNumber = entity.imoNumber ?? null;
+    this.bicCode = entity.bicCode ?? null;
+    this.status = entity.status;
+    this.createdAt = entity.createdAt;
+  }
+}
+
+export class RegisterShippingLineResponseDto {
+  @ApiProperty({ type: ShippingLineResponseDto })
+  shippingLine: ShippingLineResponseDto;
+
+  @ApiPropertyOptional({
+    description:
+      "Masked destination the activation link was sent to, or null if delivery failed.",
+    example: "o**@esl.com.et",
+  })
+  activationSentTo: string | null;
+
+  constructor(shippingLine: ShippingLineCompany, activationSentTo: string | null) {
+    this.shippingLine = new ShippingLineResponseDto(shippingLine);
+    this.activationSentTo = activationSentTo;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-company.entity.ts b/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-company.entity.ts
new file mode 100644
index 000000000..fac8c00a6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-company.entity.ts
@@ -0,0 +1,64 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, Index } from "typeorm";
+
+export enum ShippingLineStatus {
+  Active = "active",
+  Suspended = "suspended",
+}
+
+/**
+ * A shipping line — a carrier that books rail capacity directly, registered by
+ * backoffice staff rather than self-signing up.
+ *
+ * Deliberately NOT a {@link Company} of a new {@link CompanyType}: a shipping
+ * line carries none of what `companies` exists to hold — no TIN, no business
+ * licence, no eTrade authenticity lookup, no operational `company_profiles`, no
+ * onboarding wizard state. Modelling it there would mean making all of that
+ * nullable for one row shape that never uses it.
+ *
+ * The company IS the account: there is no contact-person row (customers get one
+ * via `external_profiles`), so `user_id` lives here and the login credentials
+ * are the company's own. That is also why the password-reset flow resolves a
+ * shipping line straight off this table instead of through a primary contact.
+ */
+@Entity({ schema: "freight", name: "shipping_line_companies" })
+@Index(["status"])
+export class ShippingLineCompany extends BaseEntity {
+  /**
+   * The IAM account (`iam.users`, userType `individual`) that signs in as this
+   * shipping line. No FK: `iam` is a separate schema owned by the IAM service,
+   * and the rest of the codebase reaches it by query rather than by relation.
+   */
+  @Column({ name: "user_id", type: "uuid", unique: true })
+  userId!: string;
+
+  @Column({ name: "name", type: "varchar", length: 200 })
+  name!: string;
+
+  /** Standard Carrier Alpha Code — 2-4 letters identifying the carrier. */
+  @Column({ name: "scac_code", type: "varchar", length: 4, nullable: true })
+  scacCode?: string | null;
+
+  /** IMO number of the vessel operator. */
+  @Column({ name: "imo_number", type: "varchar", length: 20, nullable: true })
+  imoNumber?: string | null;
+
+  /** BIC code — the container prefix the line's equipment is registered under. */
+  @Column({ name: "bic_code", type: "varchar", length: 20, nullable: true })
+  bicCode?: string | null;
+
+  /** Mirrors the IAM account's email; the activation link is sent here. */
+  @Column({ name: "email", type: "varchar", length: 150 })
+  email!: string;
+
+  @Column({ name: "phone_number", type: "varchar", length: 30, nullable: true })
+  phoneNumber?: string | null;
+
+  @Column({
+    name: "status",
+    type: "enum",
+    enum: ShippingLineStatus,
+    default: ShippingLineStatus.Active,
+  })
+  status!: ShippingLineStatus;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-credit.entity.ts b/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-credit.entity.ts
new file mode 100644
index 000000000..3c81968f6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-credit.entity.ts
@@ -0,0 +1,110 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+
+import { Booking } from "../../bookings/entities/booking.entity";
+import { Invoice } from "../../billing/entities/invoice.entity";
+import { ShippingLineCompany } from "./shipping-line-company.entity";
+
+/** Where a credit sits between "service used" and "money received". */
+export enum ShippingLineCreditStatus {
+  /** Service used, priced, not yet on any invoice. Counts as debt. */
+  Unbilled = "UNBILLED",
+  /** Finance put it on an invoice; awaiting payment. Still counts as debt. */
+  Billed = "BILLED",
+  /** The invoice settled. Terminal — no longer debt, and never re-billed. */
+  Paid = "PAID",
+  /** Written off / booking voided. Terminal, excluded from every total. */
+  Cancelled = "CANCELLED",
+}
+
+/** Statuses a shipping line still owes money for. */
+export const OUTSTANDING_CREDIT_STATUSES = [
+  ShippingLineCreditStatus.Unbilled,
+  ShippingLineCreditStatus.Billed,
+] as const;
+
+/**
+ * What a shipping line owes for one booking.
+ *
+ * Shipping lines get the service first and pay later, so a booking of theirs
+ * raises no invoice and passes no payment gate — it raises one of these. The
+ * amount is frozen when the booking is priced and is never recalculated, so a
+ * later rate change cannot silently alter a debt already incurred.
+ *
+ * Finance batches unbilled credits into one invoice (see
+ * `ShippingLineCreditsService.generateInvoice`); the line pays that invoice
+ * through the ordinary CBE flow; settlement flips the batch to PAID and the
+ * debt disappears. The outstanding figure is always derived by summing
+ * {@link OUTSTANDING_CREDIT_STATUSES} rows — there is no balance column,
+ * because a stored balance is one missed UPDATE away from being a lie.
+ */
+@Entity({ schema: "freight", name: "shipping_line_credits" })
+@Index(["shippingLineCompanyId", "status"])
+@Index(["invoiceId"])
+export class ShippingLineCredit extends BaseEntity {
+  /** The line that owes this. */
+  @Column({ name: "shipping_line_company_id", type: "uuid" })
+  shippingLineCompanyId!: string;
+
+  @ManyToOne(() => ShippingLineCompany)
+  @JoinColumn({ name: "shipping_line_company_id" })
+  shippingLineCompany?: ShippingLineCompany;
+
+  /**
+   * The booking that incurred the charge. Unique among live rows (partial
+   * index excludes soft-deleted and CANCELLED), so one booking can never be
+   * billed twice.
+   */
+  @Column({ name: "booking_id", type: "uuid" })
+  bookingId!: string;
+
+  @ManyToOne(() => Booking)
+  @JoinColumn({ name: "booking_id" })
+  booking?: Booking;
+
+  /** Frozen at pricing time. Never recalculated. */
+  @Column({ name: "amount", type: "numeric", precision: 14, scale: 2 })
+  amount!: number;
+
+  @Column({ name: "currency", type: "varchar", length: 8, default: "ETB" })
+  currency!: string;
+
+  @Column({
+    name: "status",
+    type: "enum",
+    enum: ShippingLineCreditStatus,
+    default: ShippingLineCreditStatus.Unbilled,
+  })
+  status!: ShippingLineCreditStatus;
+
+  /** What the charge is for; becomes the invoice line description. */
+  @Column({ name: "description", type: "varchar", length: 255, nullable: true })
+  description?: string | null;
+
+  /** The invoice this credit was billed on; null while UNBILLED. */
+  @Column({ name: "invoice_id", type: "uuid", nullable: true })
+  invoiceId?: string | null;
+
+  @ManyToOne(() => Invoice)
+  @JoinColumn({ name: "invoice_id" })
+  invoice?: Invoice;
+
+  /** When finance put it on an invoice. */
+  @Column({ name: "billed_at", type: "timestamptz", nullable: true })
+  billedAt?: Date | null;
+
+  /** When that invoice settled. */
+  @Column({ name: "paid_at", type: "timestamptz", nullable: true })
+  paidAt?: Date | null;
+
+  @Column({ name: "cancelled_at", type: "timestamptz", nullable: true })
+  cancelledAt?: Date | null;
+
+  @Column({
+    name: "cancellation_reason",
+    type: "varchar",
+    length: 255,
+    nullable: true,
+  })
+  cancellationReason?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-invoice-approval.entity.ts b/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-invoice-approval.entity.ts
new file mode 100644
index 000000000..54ef7338d
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/entities/shipping-line-invoice-approval.entity.ts
@@ -0,0 +1,82 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+
+import { Invoice } from "../../billing/entities/invoice.entity";
+
+/** What finance asked to do to a shipping-line credit invoice. */
+export enum ShippingLineInvoiceActionType {
+  /** Record a full offline settlement (paid outside the gateway). */
+  MarkPaid = "MARK_PAID",
+  /** Void the invoice; its credits return to the unbilled pool. */
+  Cancel = "CANCEL",
+}
+
+export enum ShippingLineInvoiceActionStatus {
+  Pending = "PENDING",
+  Approved = "APPROVED",
+  Rejected = "REJECTED",
+}
+
+/**
+ * Maker–checker for manual actions on shipping-line credit invoices.
+ *
+ * Marking an invoice paid by hand erases real debt, and cancelling one
+ * releases its credits back to the unbilled pool — either done unilaterally is
+ * a one-person fraud path. So finance REQUESTS the action (one permission)
+ * and a chief APPROVES or REJECTS it (a separate permission, different
+ * person). Every request is kept, decided or not: the table is the audit
+ * trail of who asked, who decided, and why.
+ */
+@Entity({ schema: "freight", name: "shipping_line_invoice_approvals" })
+@Index(["invoiceId", "status"])
+export class ShippingLineInvoiceApproval extends BaseEntity {
+  @Column({ name: "invoice_id", type: "uuid" })
+  invoiceId!: string;
+
+  @ManyToOne(() => Invoice)
+  @JoinColumn({ name: "invoice_id" })
+  invoice?: Invoice;
+
+  @Column({ name: "action", type: "enum", enum: ShippingLineInvoiceActionType })
+  action!: ShippingLineInvoiceActionType;
+
+  @Column({
+    name: "status",
+    type: "enum",
+    enum: ShippingLineInvoiceActionStatus,
+    default: ShippingLineInvoiceActionStatus.Pending,
+  })
+  status!: ShippingLineInvoiceActionStatus;
+
+  /** IAM user id of the finance staff who raised the request. */
+  @Column({ name: "requested_by", type: "uuid" })
+  requestedBy!: string;
+
+  /** Why the action is needed; shown to the approver, kept for audit. */
+  @Column({ name: "reason", type: "varchar", length: 500 })
+  reason!: string;
+
+  /** Offline payment reference (bank slip no. etc.) for MARK_PAID requests. */
+  @Column({
+    name: "payment_reference",
+    type: "varchar",
+    length: 255,
+    nullable: true,
+  })
+  paymentReference?: string | null;
+
+  /** IAM user id of the chief who approved/rejected; null while pending. */
+  @Column({ name: "decided_by", type: "uuid", nullable: true })
+  decidedBy?: string | null;
+
+  @Column({ name: "decided_at", type: "timestamptz", nullable: true })
+  decidedAt?: Date | null;
+
+  @Column({
+    name: "decision_note",
+    type: "varchar",
+    length: 500,
+    nullable: true,
+  })
+  decisionNote?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.controller.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.controller.ts
new file mode 100644
index 000000000..b2417a08f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.controller.ts
@@ -0,0 +1,109 @@
+import { CurrentUser } from "@edr/api-common";
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseUUIDPipe,
+  Post,
+  Query,
+} from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+
+import { PortalCustomer } from "../../common/booking-guards";
+import { CompleteShippingLineBookingDto } from "./dto/complete-shipping-line-booking.dto";
+import { ShippingLineBookingCompletionService } from "./shipping-line-booking-completion.service";
+
+interface CurrentIamUser {
+  id: string;
+}
+
+/**
+ * The completion half of shipping-line bookings, sharing the
+ * `/shipping-line-bookings` prefix with {@link ShippingLineBookingsController}.
+ * Separate controller because it lives in its own module — see
+ * {@link ShippingLineBookingCompletionService} for why the module split exists.
+ */
+@ApiTags("shipping-line-bookings")
+@Controller("shipping-line-bookings")
+@ApiBearerAuth()
+export class ShippingLineBookingCompletionController {
+  constructor(
+    private readonly completionService: ShippingLineBookingCompletionService,
+  ) {}
+
+  @Get(":id/available-days")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Days with an open departure that can carry this booking's cargo — for the completion form's day picker.",
+  })
+  async availableDays(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+  ) {
+    return this.completionService.availableDaysMine(user.id, id);
+  }
+
+  @Get(":id/trains")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "The line's dedicated trains on the booking's lane for a shipment day, each with per-wagon-type free space — for the completion form's train picker. Cargo context (sizes/cargoTypeId/wagons) refines the availability.",
+  })
+  async trainsForDay(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+    @Query("date") date?: string,
+    @Query("sizes") sizes?: string,
+    @Query("cargoTypeId") cargoTypeId?: string,
+    @Query("wagons") wagons?: string,
+  ) {
+    return this.completionService.trainsForDayMine(user.id, id, date, {
+      containerSizes: sizes ? sizes.split(",").filter(Boolean) : undefined,
+      cargoTypeId: cargoTypeId || undefined,
+      wagons: wagons ? Number(wagons) : undefined,
+    });
+  }
+
+  @Post(":id/price-preview")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Authoritative price quote for the completion payload — same compute as /complete, saved as the booking's breakdown + rate snapshots (refreshed on every re-preview). Persists nothing else.",
+  })
+  async pricePreview(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: CompleteShippingLineBookingDto,
+  ) {
+    return this.completionService.previewPriceMine(user.id, id, dto);
+  }
+
+  @Get(":id/operations")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Operations view of the booking: the train it rides (assigned or requested) and the wagons allocated to it.",
+  })
+  async operations(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+  ) {
+    return this.completionService.operationsMine(user.id, id);
+  }
+
+  @Post(":id/complete")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Complete an approved (CLEARANCE_READY) booking: cargo + binding shipment day. Prices off the line's rates, records the charge on the credit ledger and requests operation.",
+  })
+  async completeMine(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: CompleteShippingLineBookingDto,
+  ) {
+    return this.completionService.completeMine(user.id, id, dto);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.module.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.module.ts
new file mode 100644
index 000000000..470984c70
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.module.ts
@@ -0,0 +1,29 @@
+import { Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { BookingsModule } from "../bookings/bookings.module";
+import { Booking } from "../bookings/entities/booking.entity";
+import { TrainSchedulingModule } from "../train-scheduling/train-scheduling.module";
+import { ShippingLineBookingCompletionController } from "./shipping-line-booking-completion.controller";
+import { ShippingLineBookingCompletionService } from "./shipping-line-booking-completion.service";
+import { ShippingLineCompaniesModule } from "./shipping-line-companies.module";
+
+/**
+ * Deliberately a LEAF module — registered in AppModule and imported by
+ * nothing. Completion needs BookingsModule (pricing + the operation-request
+ * transition), but ShippingLineCompaniesModule sits under rule-engine and
+ * companies, which sit under BookingsModule; importing bookings from there
+ * closes a module cycle Nest cannot construct. Keeping the completion flow
+ * here keeps the graph acyclic with no forwardRef chains.
+ */
+@Module({
+  imports: [
+    TypeOrmModule.forFeature([Booking]),
+    BookingsModule,
+    TrainSchedulingModule,
+    ShippingLineCompaniesModule,
+  ],
+  controllers: [ShippingLineBookingCompletionController],
+  providers: [ShippingLineBookingCompletionService],
+})
+export class ShippingLineBookingCompletionModule {}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.service.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.service.ts
new file mode 100644
index 000000000..ce5a7fad8
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-booking-completion.service.ts
@@ -0,0 +1,816 @@
+import {
+  BadRequestException,
+  ForbiddenException,
+  Injectable,
+  NotFoundException,
+} from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { In, Repository } from "typeorm";
+
+import { BookingPricingService } from "../bookings/booking-pricing.service";
+import { BookingTransitionService } from "../bookings/booking-transition.service";
+import { BookingsService } from "../bookings/bookings.service";
+import type { Container20ftUnit } from "../bookings/container-pairing.util";
+import { ContainerValidationService } from "../bookings/container-validation.service";
+import { BookingContainer } from "../bookings/entities/booking-container.entity";
+import { BookingContainerUnit } from "../bookings/entities/booking-container-unit.entity";
+import { Booking } from "../bookings/entities/booking.entity";
+import { wagonsPerUnitForSize } from "../rule-engine/container-type.util";
+import { CargoType } from "../rule-engine/entities/cargo-type.entity";
+import { ContainerType } from "../rule-engine/entities/container-type.entity";
+import { eatDay } from "../train-scheduling/batch-window.util";
+import {
+  BookingBatchService,
+  type TrainOptionCargoOverrides,
+} from "../train-scheduling/booking-batch.service";
+import { TrainSchedule } from "../train-schedules/entities/train-schedule.entity";
+import { WagonBookingAllocation } from "../train-schedules/entities/wagon-booking-allocation.entity";
+import { TrainSchedulingService } from "../train-scheduling/services/train-scheduling.service";
+import { CompleteShippingLineBookingDto } from "./dto/complete-shipping-line-booking.dto";
+import {
+  ShippingLineCredit,
+  ShippingLineCreditStatus,
+} from "./entities/shipping-line-credit.entity";
+import { ShippingLineCompaniesService } from "./shipping-line-companies.service";
+import { ShippingLineCreditsService } from "./shipping-line-credits.service";
+
+/**
+ * Completion of a shipping-line booking — the step after Operations approves
+ * its documents, mirroring what a customer does at that point: cargo + binding
+ * shipment day go in, the booking prices off the line's negotiated rates and
+ * the request lands with Operations.
+ *
+ * Its own module (not part of {@link ShippingLineBookingsService}) because it
+ * needs BookingsModule (pricing, the operation-request transition) and
+ * TrainSchedulingModule — and ShippingLineCompaniesModule is imported by
+ * rule-engine/companies, which sit UNDER BookingsModule. Importing bookings
+ * from there closes a module cycle Nest cannot construct; a leaf module that
+ * nothing imports keeps the graph acyclic.
+ */
+@Injectable()
+export class ShippingLineBookingCompletionService {
+  constructor(
+    @InjectRepository(Booking)
+    private readonly bookingsRepository: Repository<Booking>,
+    private readonly shippingLineCompaniesService: ShippingLineCompaniesService,
+    private readonly bookingsService: BookingsService,
+    private readonly bookingPricingService: BookingPricingService,
+    private readonly bookingTransitionService: BookingTransitionService,
+    private readonly trainSchedulingService: TrainSchedulingService,
+    private readonly bookingBatchService: BookingBatchService,
+    private readonly creditsService: ShippingLineCreditsService,
+    private readonly containerValidationService: ContainerValidationService,
+  ) {}
+
+  /**
+   * 20ft weight-pairing check over the completion payload — the same rule the
+   * customer shipment form enforces (`max20ftPairWeightDiffTons`, default 10t):
+   * two 20ft sharing a wagon must be within the cap. Preview surfaces the
+   * messages; completion hard-blocks on them. Runs off the DTO so nothing is
+   * persisted before the check passes.
+   */
+  private async pairingViolationMessages(
+    dto: CompleteShippingLineBookingDto,
+  ): Promise<string[]> {
+    const units: Container20ftUnit[] = [];
+    for (const line of dto.containers ?? []) {
+      const containerType = await this.resolveContainerType(line);
+      if (containerType.sizeFt !== 20) continue;
+      (line.units ?? []).forEach((u, idx) =>
+        units.push({
+          label: u.containerNumber || `20ft-${idx + 1}`,
+          grossWeightTons: Number(u.vgmTons ?? 0),
+        }),
+      );
+    }
+    const violations =
+      await this.containerValidationService.validate20ftPairingUnits(units);
+    return violations.map((v) => v.message);
+  }
+
+  /** Same session→owner resolution every shipping-line entry point uses. */
+  private async requireShippingLine(userId: string) {
+    const shippingLine =
+      await this.shippingLineCompaniesService.findByUserId(userId);
+    if (!shippingLine) {
+      throw new ForbiddenException("This account is not a shipping line.");
+    }
+    if (shippingLine.status !== "active") {
+      throw new ForbiddenException(
+        "This shipping-line account is suspended and cannot create bookings.",
+      );
+    }
+    return shippingLine;
+  }
+
+  private async requireOwnBooking(
+    userId: string,
+    bookingId: string,
+    relations?: { bookingContainers?: boolean },
+  ) {
+    const shippingLine = await this.requireShippingLine(userId);
+    const booking = await this.bookingsRepository.findOne({
+      where: { id: bookingId, shippingLineCompanyId: shippingLine.id },
+      relations,
+    });
+    if (!booking) throw new NotFoundException(`Booking ${bookingId} not found`);
+    return booking;
+  }
+
+  /**
+   * The line's dedicated departures on the booking's lane (DRAFT/SCHEDULED,
+   * soonest first). These trains run NO booking-window cycle — the line books
+   * whenever it wants until the close offset stamped in `windowClosesAt` — and
+   * they are excluded from every customer pool, so this is the only source
+   * that can offer them.
+   */
+  private async dedicatedTrainsForBooking(booking: Booking) {
+    if (!booking.shippingLineCompanyId) return [];
+    return this.bookingsRepository.manager.getRepository(TrainSchedule).find({
+      where: {
+        shippingLineCompanyId: booking.shippingLineCompanyId,
+        originStationId: booking.originYardId ?? undefined,
+        destinationStationId: booking.destinationYardId ?? undefined,
+        status: In(["DRAFT", "SCHEDULED"]),
+      },
+      order: { scheduledDepartureDate: "ASC" },
+    });
+  }
+
+  /** Still bookable: the close offset before departure has not passed yet. */
+  private isStillOpen(schedule: TrainSchedule): boolean {
+    const closesAt =
+      schedule.windowClosesAt ?? schedule.scheduledDepartureDate;
+    return closesAt.getTime() > Date.now();
+  }
+
+  /**
+   * The line's dedicated trains on the booking's lane for one shipment day,
+   * each with per-wagon-type free space — the completion form's train picker.
+   * A booking rides ONE schedule, so with several departures that day the
+   * line picks which; the pick is validated again at complete time.
+   */
+  async trainsForDayMine(
+    userId: string,
+    bookingId: string,
+    date: string | undefined,
+    overrides?: TrainOptionCargoOverrides,
+  ) {
+    const booking = await this.requireOwnBooking(userId, bookingId);
+    if (!booking.shippingLineCompanyId) return [];
+    return this.bookingBatchService.dedicatedTrainOptionsForDay(
+      booking,
+      date ? eatDay(new Date(date)) : null,
+      booking.shippingLineCompanyId,
+      overrides,
+    );
+  }
+
+  /**
+   * Days the shipping line may pick as the shipment day.
+   *
+   * Lanes with trains DEDICATED to this line offer exactly those trains' days,
+   * open until each train's close offset — no window cycle. Lanes without a
+   * dedicated train fall back to the shared customer day pool, exactly as
+   * before. Ownership is checked first so one line cannot probe another's
+   * booking.
+   */
+  async availableDaysMine(userId: string, bookingId: string) {
+    const booking = await this.requireOwnBooking(userId, bookingId);
+    const dedicated = await this.dedicatedTrainsForBooking(booking);
+    if (dedicated.length === 0) {
+      return this.bookingsService.availableDaysForBooking(bookingId);
+    }
+    const days = [
+      ...new Set(
+        dedicated
+          .filter((s) => this.isStillOpen(s))
+          .map((s) => eatDay(s.scheduledDepartureDate)),
+      ),
+    ];
+    return { days };
+  }
+
+  /**
+   * Complete a bare shipping-line booking once Operations has approved its
+   * documents (CLEARANCE_READY), or after Operations returned the request
+   * (OPERATION_CHANGES_REQUESTED). The cargo and the binding shipment day go
+   * in, the booking is priced off the line's negotiated rates, and the request
+   * lands with Operations (OPERATION_REQUEST_PENDING) through the same
+   * transition customers use.
+   *
+   * Payment differs from customers by design: no invoice is issued here.
+   * Shipping lines run on the credit ledger — the priced amount is recorded as
+   * an UNBILLED credit and Finance bills a batch later, so the booking
+   * proceeds without a payment gate.
+   */
+  async completeMine(
+    userId: string,
+    bookingId: string,
+    dto: CompleteShippingLineBookingDto,
+  ) {
+    const booking = await this.requireOwnBooking(userId, bookingId, {
+      bookingContainers: true,
+    });
+    if (
+      !["CLEARANCE_READY", "OPERATION_CHANGES_REQUESTED"].includes(
+        booking.status,
+      )
+    ) {
+      throw new BadRequestException(
+        "Your documents must be approved before the booking can be completed.",
+      );
+    }
+
+    // Unbalanced 20ft pairs can never be planned onto wagons — refuse before
+    // any cargo/credit write below. Same block the contract path applies.
+    if (booking.freightType === "CONTAINER") {
+      const pairing = await this.pairingViolationMessages(dto);
+      if (pairing.length) {
+        throw new BadRequestException(
+          `Cannot complete booking — 20ft containers cannot be paired on wagons: ${pairing.join(" ")}`,
+        );
+      }
+    }
+
+    // Completion is booking time. A lane with trains DEDICATED to this line
+    // has no window concept at all: the line books whenever it wants until the
+    // train's close offset. Only a lane with no dedicated train falls back to
+    // the customer window gate, unchanged.
+    const dedicated = await this.dedicatedTrainsForBooking(booking);
+    const pickedDay = eatDay(new Date(dto.scheduledDate));
+    const dedicatedOnDay = dedicated.filter(
+      (s) => eatDay(s.scheduledDepartureDate) === pickedDay,
+    );
+    let bypassDayPool = false;
+    let requestedTrainScheduleId: string | null = null;
+    if (dedicatedOnDay.length > 0) {
+      const openOnDay = dedicatedOnDay.filter((s) => this.isStillOpen(s));
+      if (openOnDay.length === 0) {
+        throw new BadRequestException(
+          "Booking for your train on this day has closed — the cut-off before departure has passed.",
+        );
+      }
+      // A booking rides ONE schedule. Several departures that day → the line
+      // must say which; a single one is picked implicitly. The id comes from
+      // the request, so it is validated against the day's own trains.
+      if (dto.trainScheduleId) {
+        const picked = openOnDay.find((s) => s.id === dto.trainScheduleId);
+        if (!picked) {
+          throw new BadRequestException(
+            "The selected train does not run your route on that day (or its booking cut-off has passed) — pick another train.",
+          );
+        }
+        requestedTrainScheduleId = picked.id;
+      } else if (openOnDay.length === 1) {
+        requestedTrainScheduleId = openOnDay[0].id;
+      } else {
+        throw new BadRequestException(
+          "More than one of your trains departs that day — select which train this booking rides.",
+        );
+      }
+      // The day is backed by the line's own train, which every customer pool
+      // deliberately excludes — so the day-pool gate downstream must not run.
+      bypassDayPool = true;
+    } else if (dedicated.length > 0) {
+      throw new BadRequestException(
+        "Pick one of your assigned train days for this route.",
+      );
+    } else {
+      await this.trainSchedulingService.assertBookingWindowOpen({
+        originYardId: booking.originYardId ?? null,
+        destinationYardId: booking.destinationYardId ?? null,
+        scheduledDate: dto.scheduledDate,
+        direction: booking.tradeDirection ?? null,
+      });
+    }
+
+    let hasCargo =
+      (booking.bookingContainers?.length ?? 0) > 0 ||
+      Number(booking.cargoTotalWeightVgm) > 0;
+    const restatesCargo = Boolean(
+      dto.containers?.length || dto.cargoTypeId || dto.cargoWeightTons,
+    );
+
+    // Operations may return the request asking for the CARGO to change, not
+    // just the day. A resubmit that restates cargo starts completion over:
+    // the recorded (unbilled) credit is written off and the persisted cargo
+    // wiped, so the fresh path below re-persists, re-prices and re-records.
+    // Once the credit is on an issued invoice the cargo is frozen — the
+    // invoice total must keep matching what it bills.
+    if (hasCargo && restatesCargo) {
+      const credit = await this.bookingsRepository.manager
+        .getRepository(ShippingLineCredit)
+        .findOne({ where: { bookingId } });
+      if (credit && credit.status === ShippingLineCreditStatus.Unbilled) {
+        await this.creditsService.cancelCredit(
+          credit.id,
+          "Cargo changed before billing — booking re-priced on completion.",
+        );
+      } else if (
+        credit &&
+        credit.status !== ShippingLineCreditStatus.Cancelled
+      ) {
+        throw new BadRequestException(
+          "This booking's charge has already been invoiced — contact Operations to change its cargo.",
+        );
+      }
+      await this.wipeCargo(bookingId);
+      hasCargo = false;
+    }
+
+    // First completion persists cargo and prices the booking; a day-only
+    // resubmit after OPERATION_CHANGES_REQUESTED skips straight to the
+    // operation request with the cargo (and price) it already carries.
+    if (!hasCargo) {
+      if (booking.freightType === "CONTAINER") {
+        await this.persistContainerLines(booking, dto);
+      } else {
+        if (!dto.cargoTypeId || !(Number(dto.cargoWeightTons) > 0)) {
+          throw new BadRequestException(
+            "Bulk bookings need a cargo type and a total weight in tons.",
+          );
+        }
+        const cargoType = await this.bookingsRepository.manager
+          .getRepository(CargoType)
+          .findOne({ where: { id: dto.cargoTypeId, isActive: true } });
+        if (!cargoType) {
+          throw new NotFoundException(
+            `Cargo type ${dto.cargoTypeId} not found`,
+          );
+        }
+      }
+
+      await this.bookingsRepository.update(bookingId, {
+        cargoTypeId:
+          booking.freightType === "BULK" ? (dto.cargoTypeId ?? null) : null,
+        cargoFreeText: dto.cargoFreeText?.trim() || null,
+        cargoTotalWeightVgm:
+          booking.freightType === "BULK" ? Number(dto.cargoWeightTons) : 0,
+        bulkTotalWeightTons:
+          booking.freightType === "BULK" ? Number(dto.cargoWeightTons) : null,
+        // Bulk handling portions — sized against the cargo, billed by pricing.
+        ...(booking.freightType === "BULK"
+          ? {
+              bulkHazardousQuantity: Number(dto.bulkHazardousQuantity ?? 0),
+              bulkReeferQuantity: Number(dto.bulkReeferQuantity ?? 0),
+            }
+          : {}),
+        // Hazard is per-line for containers; the booking-level flag is what
+        // pricing bills the surcharge from.
+        isHazardous:
+          (dto.containers ?? []).some(
+            (line) =>
+              Number(line.hazardousQuantity ?? 0) > 0 ||
+              (line.units ?? []).some((u) => u.isHazardous),
+          ) || Number(dto.bulkHazardousQuantity ?? 0) > 0,
+        // Same for reefer: the rule engine's REEFER trigger fires on the
+        // booking-level flag (or a reefer container TYPE) — a ticked reefer
+        // switch on a standard box only sets the per-line count, so without
+        // this flag the surcharge silently never bills.
+        isReefer:
+          (dto.containers ?? []).some(
+            (line) =>
+              Number(line.reeferQuantity ?? 0) > 0 ||
+              (line.units ?? []).some((u) => u.isReefer),
+          ) || Number(dto.bulkReeferQuantity ?? 0) > 0,
+        // Shipping lines are always billed in ETB: the charge lands on the
+        // ETB credit ledger, so the currency is enforced here rather than
+        // trusted from the payload.
+        paymentCurrency: "ETB",
+      } as never);
+
+      const loaded = await this.bookingsRepository.findOne({
+        where: { id: bookingId },
+        relations: { bookingContainers: true, serviceType: true },
+      });
+      const computed = await this.bookingPricingService.computePriceForBooking(
+        loaded ?? booking,
+      );
+      // A zero price or hard block means no rate is configured for this line
+      // on this lane. Roll the cargo back so the booking stays completable —
+      // the approved clearance is not lost — and surface why.
+      if (!(computed.totalAmount > 0) || computed.hardBlocked.length > 0) {
+        await this.wipeCargo(bookingId);
+        throw new BadRequestException(
+          computed.hardBlocked.length > 0
+            ? computed.hardBlocked.join("; ")
+            : "No rate is configured for your shipping line on this route/cargo — please contact Operations.",
+        );
+      }
+
+      await this.bookingsRepository.update(bookingId, {
+        totalAmount: computed.totalAmount,
+        priorityScore: computed.priorityScore,
+        pricingBreakdown: {
+          lineItems: computed.lineItems,
+          totalAmount: computed.totalAmount,
+          currency: computed.currency,
+          generatedAt: new Date().toISOString(),
+        },
+      } as never);
+      await this.bookingPricingService.createPricingSnapshots(
+        bookingId,
+        computed.usedRates,
+        computed.appliedModifiers,
+      );
+
+      // No credit is recorded here: completion only REQUESTS the operation.
+      // The charge lands on the line's ledger when Operations accepts —
+      // `shipping_line_booking.accepted` → ShippingLineCreditsService — so a
+      // request that is returned or never accepted creates no debt.
+    }
+
+    // Binding day, OPERATION_REQUEST_PENDING and the staff notification — the
+    // machine a customer booking uses. When the day is backed by a dedicated
+    // train, the customer day-pool gate is skipped (validated above instead).
+    return this.bookingTransitionService.requestOperation(
+      bookingId,
+      dto.scheduledDate,
+      requestedTrainScheduleId,
+      bypassDayPool ? { bypassDayPool: true } : undefined,
+    );
+  }
+
+  /**
+   * Authoritative price preview for the completion form's confirm step: the
+   * SAME compute the completion itself runs, over an in-memory probe shaped
+   * exactly like completeMine would persist the booking — so the figure the
+   * shipping line confirms is line-for-line what it will owe.
+   *
+   * The result is not advisory-only: the breakdown is saved on the booking and
+   * the rate snapshots are (re)written, so every re-preview refreshes them.
+   * Nothing else is persisted — no cargo rows, no credit, no transition.
+   */
+  async previewPriceMine(
+    userId: string,
+    bookingId: string,
+    dto: CompleteShippingLineBookingDto,
+  ) {
+    const booking = await this.requireOwnBooking(userId, bookingId, {
+      bookingContainers: true,
+    });
+    if (
+      !["CLEARANCE_READY", "OPERATION_CHANGES_REQUESTED"].includes(
+        booking.status,
+      )
+    ) {
+      throw new BadRequestException(
+        "Your documents must be approved before the booking can be priced.",
+      );
+    }
+
+    // In-memory cargo, mirroring what completeMine persists.
+    let probeContainers: Partial<BookingContainer>[] = [];
+    let bulkFields: Record<string, unknown> = {};
+    if (booking.freightType === "CONTAINER") {
+      const lines = dto.containers ?? [];
+      if (!lines.length) {
+        throw new BadRequestException(
+          "At least one container line is required.",
+        );
+      }
+      for (const line of lines) {
+        const containerType = await this.resolveContainerType(line);
+        const figures = this.lineFigures(line);
+        probeContainers.push({
+          containerTypeId: containerType.id,
+          containerSize: containerType.sizeFt
+            ? `${containerType.sizeFt}ft`
+            : null,
+          quantity: line.quantity,
+          hazardousQuantity: figures.hazardous,
+          reeferQuantity: figures.reefer,
+          returnQuantity: 0,
+          vgmPerUnitTons: figures.vgmPerUnit,
+          totalVgmTons: figures.totalVgm,
+          wagonsRequired: Math.ceil(
+            line.quantity * wagonsPerUnitForSize(containerType.sizeFt),
+          ),
+        });
+      }
+    } else {
+      if (!dto.cargoTypeId || !(Number(dto.cargoWeightTons) > 0)) {
+        throw new BadRequestException(
+          "Bulk bookings need a cargo type and a total weight in tons.",
+        );
+      }
+      const cargoType = await this.bookingsRepository.manager
+        .getRepository(CargoType)
+        .findOne({ where: { id: dto.cargoTypeId, isActive: true } });
+      if (!cargoType) {
+        throw new NotFoundException(`Cargo type ${dto.cargoTypeId} not found`);
+      }
+      bulkFields = {
+        cargoTypeId: dto.cargoTypeId,
+        cargoTotalWeightVgm: Number(dto.cargoWeightTons),
+        bulkTotalWeightTons: Number(dto.cargoWeightTons),
+        bulkHazardousQuantity: Number(dto.bulkHazardousQuantity ?? 0),
+        bulkReeferQuantity: Number(dto.bulkReeferQuantity ?? 0),
+      };
+      probeContainers = [];
+    }
+
+    // Prototype-preserving clone so entity getters keep working — the same
+    // probe trick the contract preview uses.
+    const probe = Object.assign(
+      Object.create(Object.getPrototypeOf(booking)),
+      booking,
+      {
+        bookingContainers: probeContainers,
+        paymentCurrency: "ETB",
+        isHazardous:
+          (dto.containers ?? []).some(
+            (line) =>
+              Number(line.hazardousQuantity ?? 0) > 0 ||
+              (line.units ?? []).some((u) => u.isHazardous),
+          ) || Number(dto.bulkHazardousQuantity ?? 0) > 0,
+        // Mirrors completeMine: without the booking-level flag the engine's
+        // REEFER trigger never fires for reefer opt-ins on standard boxes,
+        // and the quote would show base freight only.
+        isReefer:
+          (dto.containers ?? []).some(
+            (line) =>
+              Number(line.reeferQuantity ?? 0) > 0 ||
+              (line.units ?? []).some((u) => u.isReefer),
+          ) || Number(dto.bulkReeferQuantity ?? 0) > 0,
+        ...bulkFields,
+      },
+    ) as Booking;
+
+    const computed =
+      await this.bookingPricingService.computePriceForBooking(probe);
+    if (!(computed.totalAmount > 0) || computed.hardBlocked.length > 0) {
+      throw new BadRequestException(
+        computed.hardBlocked.length > 0
+          ? computed.hardBlocked.join("; ")
+          : "No rate is configured for your shipping line on this route/cargo — please contact Operations.",
+      );
+    }
+
+    // Persist the quoted figure: breakdown on the booking, snapshots of the
+    // rates it was built from. createPricingSnapshots clears the previous
+    // artifacts first, so a re-preview replaces the old quote rather than
+    // stacking a second one.
+    await this.bookingsRepository.update(bookingId, {
+      pricingBreakdown: {
+        lineItems: computed.lineItems,
+        totalAmount: computed.totalAmount,
+        currency: computed.currency,
+        generatedAt: new Date().toISOString(),
+      },
+    } as never);
+    await this.bookingPricingService.createPricingSnapshots(
+      bookingId,
+      computed.usedRates,
+      computed.appliedModifiers,
+    );
+
+    // Pairing is reported, not thrown: the confirm modal shows it next to the
+    // price (as the customer form does) and disables confirm; /complete
+    // hard-blocks the same payload.
+    const pairingErrors =
+      booking.freightType === "CONTAINER"
+        ? await this.pairingViolationMessages(dto)
+        : [];
+
+    return {
+      totalAmount: computed.totalAmount,
+      currency: computed.currency,
+      lineItems: computed.lineItems,
+      warnings: computed.warnings,
+      overweightLines: computed.overweightLines,
+      pairingErrors,
+    };
+  }
+
+  /**
+   * What operations has done with the booking so far: the train it rides
+   * (assigned, or the requested one before assignment) and the wagons the
+   * batch engine allocated to it, with any container numbers loaded per wagon.
+   * Read-only, owner-scoped — feeds the detail page's Wagons & Train tab.
+   */
+  async operationsMine(userId: string, bookingId: string) {
+    const booking = await this.requireOwnBooking(userId, bookingId);
+    const manager = this.bookingsRepository.manager;
+
+    const scheduleId =
+      booking.trainScheduleId ?? booking.requestedTrainScheduleId ?? null;
+    let train: Record<string, unknown> | null = null;
+    if (scheduleId) {
+      const schedule = await manager.getRepository(TrainSchedule).findOne({
+        where: { id: scheduleId },
+        relations: { originStation: true, destinationStation: true },
+      });
+      if (schedule) {
+        train = {
+          id: schedule.id,
+          reference: schedule.reference,
+          trainNumber: schedule.trainNumber,
+          status: schedule.status,
+          direction: schedule.direction,
+          scheduledDepartureDate: schedule.scheduledDepartureDate,
+          scheduledArrivalDate: schedule.scheduledArrivalDate,
+          originLabel:
+            schedule.originStation?.label ??
+            schedule.originStation?.code ??
+            "Origin",
+          destinationLabel:
+            schedule.destinationStation?.label ??
+            schedule.destinationStation?.code ??
+            "Destination",
+          // Whether this is the confirmed assignment or still the request.
+          assigned: Boolean(booking.trainScheduleId),
+        };
+      }
+    }
+
+    const allocations = await manager
+      .getRepository(WagonBookingAllocation)
+      .find({
+        where: { bookingId },
+        relations: {
+          trainSetWagon: { wagonType: true, physicalWagon: true },
+          containerItems: true,
+        },
+        order: { createdAt: "ASC" },
+      });
+
+    const wagons = allocations.map((allocation) => ({
+      id: allocation.id,
+      status: allocation.status,
+      loadType: allocation.loadType,
+      allocatedWeightTons: Number(allocation.allocatedWeightTons),
+      sequenceNo: allocation.trainSetWagon?.sequenceNo ?? null,
+      wagonNumber: allocation.trainSetWagon?.physicalWagon?.wagonNumber ?? null,
+      wagonType:
+        allocation.trainSetWagon?.wagonType?.name ??
+        allocation.trainSetWagon?.wagonType?.code ??
+        null,
+      capacityTons: Number(allocation.trainSetWagon?.capacityTons ?? 0),
+      containerNumbers: (allocation.containerItems ?? [])
+        .map((item) => item.containerNumber)
+        .filter((n): n is string => Boolean(n)),
+    }));
+
+    return { train, wagons };
+  }
+
+  /**
+   * Resolve a line's container type: by id when the payload carries one, else
+   * from the size string ("40ft" → the active 40ft type, preferring the reefer
+   * variant when the line ships reefer boxes). Resolution lives HERE, not in
+   * the portal, so a slow or failed catalog fetch can never block a booking
+   * with a phantom "type not configured" error — mirrors the customer flow's
+   * server-side size→type mapping.
+   */
+  private async resolveContainerType(line: {
+    containerTypeId?: string;
+    containerSize?: string;
+    reeferQuantity?: number;
+    units?: { isReefer?: boolean }[];
+  }): Promise<ContainerType> {
+    const containerTypeRepo =
+      this.bookingsRepository.manager.getRepository(ContainerType);
+
+    if (line.containerTypeId) {
+      const byId = await containerTypeRepo.findOne({
+        where: { id: line.containerTypeId, isActive: true },
+      });
+      if (!byId) {
+        throw new NotFoundException(
+          `Container type ${line.containerTypeId} not found`,
+        );
+      }
+      return byId;
+    }
+
+    const sizeFt = parseInt(line.containerSize ?? "", 10);
+    if (!Number.isFinite(sizeFt)) {
+      throw new BadRequestException(
+        "Each container line needs a containerTypeId or a containerSize.",
+      );
+    }
+    const candidates = await containerTypeRepo.find({
+      where: { isActive: true },
+    });
+    const ofSize = candidates.filter((ct) => Number(ct.sizeFt) === sizeFt);
+    if (!ofSize.length) {
+      throw new BadRequestException(
+        `No ${sizeFt}ft container type is configured — please contact Operations.`,
+      );
+    }
+    const wantsReefer =
+      Number(line.reeferQuantity ?? 0) > 0 ||
+      (line.units ?? []).some((u) => u.isReefer);
+    if (wantsReefer) {
+      const reefer = ofSize.find((ct) => ct.isReefer);
+      if (reefer) return reefer;
+    }
+    return ofSize.find((ct) => !ct.isReefer) ?? ofSize[0];
+  }
+
+  /**
+   * A line's derived figures. With per-container rows (the full booking page),
+   * counts and VGM come FROM the rows — each container's switches are the
+   * source of truth. Without them, the line-level figures stand alone.
+   */
+  private lineFigures(line: {
+    quantity: number;
+    vgmPerUnitTons?: number;
+    hazardousQuantity?: number;
+    reeferQuantity?: number;
+    units?: { vgmTons?: number; isHazardous?: boolean; isReefer?: boolean }[];
+  }) {
+    const units = line.units ?? [];
+    const hazardous = units.length
+      ? units.filter((u) => u.isHazardous).length
+      : Math.min(Number(line.hazardousQuantity ?? 0), line.quantity);
+    const reefer = units.length
+      ? units.filter((u) => u.isReefer).length
+      : Math.min(Number(line.reeferQuantity ?? 0), line.quantity);
+    const totalVgm = units.length
+      ? units.reduce((s, u) => s + Number(u.vgmTons ?? 0), 0)
+      : Number(line.vgmPerUnitTons ?? 0) * line.quantity;
+    const vgmPerUnit = units.length
+      ? totalVgm / units.length
+      : Number(line.vgmPerUnitTons ?? 0);
+    return { hazardous, reefer, totalVgm, vgmPerUnit };
+  }
+
+  /**
+   * Persist the container lines of a CONTAINER completion. Same row shape the
+   * customer paths write (quantity per type, VGM totals, wagon share) — the
+   * per-unit ISO numbers customers also skip at booking time arrive later at
+   * yard operations.
+   */
+  private async persistContainerLines(
+    booking: Booking,
+    dto: CompleteShippingLineBookingDto,
+  ): Promise<void> {
+    const lines = dto.containers ?? [];
+    if (!lines.length) {
+      throw new BadRequestException("At least one container line is required.");
+    }
+
+    const containerRepo =
+      this.bookingsRepository.manager.getRepository(BookingContainer);
+    const unitRepo =
+      this.bookingsRepository.manager.getRepository(BookingContainerUnit);
+
+    for (const line of lines) {
+      const containerType = await this.resolveContainerType(line);
+      // Counts and VGM derived by lineFigures — the same math the price
+      // preview runs, so the persisted cargo always matches the quote.
+      const units = line.units ?? [];
+      const figures = this.lineFigures(line);
+      const containerRow = await containerRepo.save(
+        containerRepo.create({
+          bookingId: booking.id,
+          containerTypeId: containerType.id,
+          containerSize: containerType.sizeFt
+            ? `${containerType.sizeFt}ft`
+            : null,
+          quantity: line.quantity,
+          hazardousQuantity: figures.hazardous,
+          reeferQuantity: figures.reefer,
+          returnQuantity: 0,
+          vgmPerUnitTons: figures.vgmPerUnit,
+          totalVgmTons: figures.totalVgm,
+          wagonsRequired: Math.ceil(
+            line.quantity * wagonsPerUnitForSize(containerType.sizeFt),
+          ),
+        }),
+      );
+      let sortOrder = 0;
+      for (const unit of units) {
+        await unitRepo.save(
+          unitRepo.create({
+            bookingContainerId: containerRow.id,
+            containerNumber: unit.containerNumber.trim().toUpperCase(),
+            sealNumber: unit.sealNumber?.trim() || null,
+            vgmTons: Number(unit.vgmTons ?? 0),
+            isHazardous: unit.isHazardous ?? false,
+            isReefer: unit.isReefer ?? false,
+            isReturn: false,
+            sortOrder: sortOrder++,
+          }),
+        );
+      }
+    }
+  }
+
+  /** Roll a failed/superseded completion back to the bare-booking shape. */
+  private async wipeCargo(bookingId: string): Promise<void> {
+    await this.bookingsRepository.manager
+      .getRepository(BookingContainer)
+      .softDelete({ bookingId });
+    await this.bookingsRepository.update(bookingId, {
+      cargoTypeId: null,
+      cargoTotalWeightVgm: 0,
+      bulkTotalWeightTons: null,
+      totalAmount: 0,
+      pricingBreakdown: null,
+    } as never);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-bookings.controller.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-bookings.controller.ts
new file mode 100644
index 000000000..8a8e8ef2b
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-bookings.controller.ts
@@ -0,0 +1,107 @@
+import { CurrentUser } from "@edr/api-common";
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseUUIDPipe,
+  Post,
+} from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+
+import { PortalCustomer } from "../../common/booking-guards";
+import { CancelShippingLineBookingDto } from "./dto/cancel-shipping-line-booking.dto";
+import { InitiateShippingLineBookingDto } from "./dto/initiate-shipping-line-booking.dto";
+import { ShippingLineBookingsService } from "./shipping-line-bookings.service";
+
+interface CurrentIamUser {
+  id: string;
+}
+
+/**
+ * Bookings a shipping line makes for itself, from the portal.
+ *
+ * Separate from `/bookings` (customers) on purpose — see
+ * {@link ShippingLineBookingsService} for why the two flows are not merged.
+ * `PortalCustomer` only proves a valid portal session; the service resolves the
+ * shipping-line account from that session and rejects anyone else, so the owner
+ * is never taken from the request body.
+ */
+@ApiTags("shipping-line-bookings")
+@Controller("shipping-line-bookings")
+@ApiBearerAuth()
+export class ShippingLineBookingsController {
+  constructor(
+    private readonly shippingLineBookingsService: ShippingLineBookingsService,
+  ) {}
+
+  @Post("initiate")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Initiate a bare booking (no contract). Starts at AWAITING_DOCUMENTS so the shipping line can upload its documents for Operations to approve.",
+  })
+  async initiate(
+    @CurrentUser() user: CurrentIamUser,
+    @Body() dto: InitiateShippingLineBookingDto,
+  ) {
+    return this.shippingLineBookingsService.initiate(user.id, dto);
+  }
+
+  // Declared before @Get(":id") so the path isn't captured as a booking id.
+  @Get("reference-data")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Catalog for the initiate form: bookable routes (each carrying its trade direction) and service types.",
+  })
+  async referenceData(@CurrentUser() user: CurrentIamUser) {
+    return this.shippingLineBookingsService.referenceData(user.id);
+  }
+
+  @Get("my")
+  @PortalCustomer()
+  @ApiOperation({ summary: "List the signed-in shipping line's bookings." })
+  async listMine(@CurrentUser() user: CurrentIamUser) {
+    return this.shippingLineBookingsService.listMine(user.id);
+  }
+
+  // Declared before @Get(":id") so the path isn't captured as a booking id.
+  @Get("my-trains")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Train departures dedicated to the signed-in shipping line. These trains are hidden from customers; this is the only portal read that surfaces them.",
+  })
+  async listMyTrains(@CurrentUser() user: CurrentIamUser) {
+    return this.shippingLineBookingsService.listMyTrains(user.id);
+  }
+
+  @Get(":id")
+  @PortalCustomer()
+  @ApiOperation({ summary: "Get one of the signed-in shipping line's bookings." })
+  async findMine(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+  ) {
+    return this.shippingLineBookingsService.findMine(user.id, id);
+  }
+
+  @Post(":id/cancel")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "Cancel one of the signed-in shipping line's own bookings. Allowed only before the booking is priced.",
+  })
+  async cancelMine(
+    @CurrentUser() user: CurrentIamUser,
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: CancelShippingLineBookingDto,
+  ) {
+    return this.shippingLineBookingsService.cancelMine(
+      user.id,
+      id,
+      dto.reason,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-bookings.service.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-bookings.service.ts
new file mode 100644
index 000000000..da1b90129
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-bookings.service.ts
@@ -0,0 +1,473 @@
+import { insertWithGeneratedReference } from "@edr/api-common";
+import {
+  BadRequestException,
+  ForbiddenException,
+  Injectable,
+  NotFoundException,
+} from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { In, MoreThanOrEqual, Repository } from "typeorm";
+
+import { BookingDocumentReview } from "../bookings/entities/booking-document-review.entity";
+import { BookingReviewNote } from "../bookings/entities/booking-review-note.entity";
+import { Booking } from "../bookings/entities/booking.entity";
+import { formatRouteLabel, Route } from "../routes/entities/route.entity";
+import { CargoType } from "../rule-engine/entities/cargo-type.entity";
+import { ContainerType } from "../rule-engine/entities/container-type.entity";
+import { ServiceType } from "../rule-engine/entities/service-type.entity";
+import { TrainSchedule } from "../train-schedules/entities/train-schedule.entity";
+import { InitiateShippingLineBookingDto } from "./dto/initiate-shipping-line-booking.dto";
+import { ShippingLineCompaniesService } from "./shipping-line-companies.service";
+
+/**
+ * The only trade direction a shipping line books.
+ *
+ * Their cargo arrives by sea at Djibouti and moves inland to Ethiopia, which is
+ * IMPORT by the rule routes are stamped with (DJ→ET = IMPORT, ET→DJ = EXPORT,
+ * same country = DOMESTIC). Export and intercity lanes are therefore neither
+ * offered nor accepted.
+ */
+const SHIPPING_LINE_DIRECTION = "IMPORT";
+
+/**
+ * Statuses a shipping line may cancel its own booking from — everything before
+ * the booking is priced. Past this point cancelling has billing consequences
+ * (fees, credit notes) and belongs with Operations.
+ */
+const SHIPPING_LINE_CANCELLABLE_STATUSES: string[] = [
+  "AWAITING_DOCUMENTS",
+  "DOCUMENTS_UNDER_REVIEW",
+  "CLEARANCE_READY",
+  "CHANGES_REQUESTED",
+];
+
+/**
+ * Booking creation for shipping lines.
+ *
+ * Deliberately separate from `BookingsService` / `ContractBookingService`
+ * rather than a branch inside them. Those are built end to end around a
+ * customer: a `companies` row, an approved operational `company_profile`, a
+ * contract supplying route/quantities, and contract-capacity accounting. A
+ * shipping line has none of that — it books directly, without a contract — so
+ * branching there would mean threading "no company, no profile, no contract"
+ * through every method a customer booking passes through. Keeping it here means
+ * the customer paths are not touched at all.
+ *
+ * What IS shared is the table and the downstream lifecycle: the row lands in
+ * `freight.bookings` at `AWAITING_DOCUMENTS`, the shipping line uploads its
+ * documents against the `shipping_line_booking_documents` file-upload setting,
+ * and Operations reviews and finalizes them through the same clearance flow
+ * customers already use.
+ */
+@Injectable()
+export class ShippingLineBookingsService {
+  constructor(
+    @InjectRepository(Booking)
+    private readonly bookingsRepository: Repository<Booking>,
+    private readonly shippingLineCompaniesService: ShippingLineCompaniesService,
+  ) {}
+
+  /**
+   * Resolve the shipping-line account for a signed-in user, or reject. Every
+   * entry point goes through this: the owner is taken from the session, never
+   * from the request body, so one shipping line cannot book as another.
+   */
+  private async requireShippingLine(userId: string) {
+    const shippingLine =
+      await this.shippingLineCompaniesService.findByUserId(userId);
+    if (!shippingLine) {
+      throw new ForbiddenException("This account is not a shipping line.");
+    }
+    if (shippingLine.status !== "active") {
+      throw new ForbiddenException(
+        "This shipping-line account is suspended and cannot create bookings.",
+      );
+    }
+    return shippingLine;
+  }
+
+  /**
+   * The catalog the initiate form needs: the lanes EDR actually runs, and the
+   * services that can be booked on their own.
+   *
+   * Routes are offered instead of two loose yard pickers so a shipping line
+   * cannot invent a lane that does not exist — and because the route already
+   * carries its trade direction, which is otherwise guesswork.
+   *
+   * Read-only and scoped to bookable rows, which is why it lives here rather
+   * than reusing the staff `/routes` controller (gated behind fleet
+   * permissions a shipping line does not and should not hold).
+   */
+  async referenceData(userId: string) {
+    await this.requireShippingLine(userId);
+
+    const [routes, serviceTypes, containerTypes, cargoTypes] =
+      await Promise.all([
+        this.bookingsRepository.manager.getRepository(Route).find({
+          // Shipping lines only move inbound cargo: it lands at the Djibouti port
+          // and runs inland to Ethiopia. Filtering here rather than in the portal
+          // means an export or intercity lane is never offered AND never
+          // accepted — `initiate` re-checks the same rule below.
+          where: { status: "AVAILABLE", direction: SHIPPING_LINE_DIRECTION },
+          relations: { originYard: true, destinationYard: true },
+        }),
+        // Customs-bundled services are excluded: those run the phased ET/DJ
+        // customs workflow, which is a contract-backed flow a shipping line has
+        // no part in. Their clearance is the single document set Operations
+        // reviews on the booking itself.
+        this.bookingsRepository.manager.getRepository(ServiceType).find({
+          where: {
+            canBeBookedAlone: true,
+            includesCustoms: false,
+            isActive: true,
+          },
+          order: { displayOrder: "ASC" },
+        }),
+        // For the completion form: what ships. Container types for CONTAINER
+        // bookings, cargo types for BULK ones.
+        this.bookingsRepository.manager.getRepository(ContainerType).find({
+          where: { isActive: true },
+        }),
+        this.bookingsRepository.manager.getRepository(CargoType).find({
+          where: { isActive: true },
+          order: { displayOrder: "ASC" },
+        }),
+      ]);
+
+    return {
+      routes: routes.map((route) => ({
+        id: route.id,
+        label: formatRouteLabel(route),
+        direction: route.direction,
+        originYardId: route.originYardId,
+        // Per-yard labels so the portal can offer origin and destination as two
+        // separate pickers (the shape the customer form uses) while still
+        // resolving the pair back to one of these routes.
+        originLabel:
+          route.originYard?.label ?? route.originYard?.code ?? "Origin",
+        destinationYardId: route.destinationYardId,
+        destinationLabel:
+          route.destinationYard?.label ??
+          route.destinationYard?.code ??
+          "Destination",
+      })),
+      serviceTypes: serviceTypes.map((service) => ({
+        id: service.id,
+        name: service.serviceName,
+      })),
+      containerTypes: containerTypes.map((ct) => ({
+        id: ct.id,
+        label: ct.label ?? ct.code,
+        sizeFt: ct.sizeFt,
+        isReefer: ct.isReefer,
+      })),
+      // parentGroupId lets the portal tell leaf types from grouping rows.
+      cargoTypes: cargoTypes.map((cargo) => ({
+        id: cargo.id,
+        name: cargo.cargoTypeName,
+        parentGroupId: cargo.parentGroupId ?? null,
+        unitOfMeasure: cargo.unitOfMeasure ?? null,
+      })),
+    };
+  }
+
+  /**
+   * Create a BARE booking for a shipping line — no contract, no cargo, no date
+   * and no price. It exists so documents have something to hang off: the
+   * shipping line uploads them next, Operations approves, and only then is the
+   * booking completed with its cargo and shipment day.
+   */
+  async initiate(userId: string, dto: InitiateShippingLineBookingDto) {
+    const shippingLine = await this.requireShippingLine(userId);
+
+    // The route is the single source of origin, destination AND direction —
+    // resolved server-side so the three can never disagree, and so a caller
+    // cannot post a lane EDR does not run.
+    const route = await this.bookingsRepository.manager
+      .getRepository(Route)
+      .findOne({ where: { id: dto.routeId } });
+    if (!route) {
+      throw new NotFoundException(`Route ${dto.routeId} not found`);
+    }
+    if (route.status !== "AVAILABLE") {
+      throw new BadRequestException(
+        "This route is not currently available for booking.",
+      );
+    }
+    // Enforced here too, not just by filtering the picker: the route id comes
+    // from the request, so an export or intercity lane could otherwise be
+    // posted directly.
+    if (route.direction !== SHIPPING_LINE_DIRECTION) {
+      throw new BadRequestException(
+        "Shipping lines can only book inbound (Djibouti to Ethiopia) routes.",
+      );
+    }
+
+    // Only a forward-looking day makes sense; train validation happens later
+    // when Operations schedules it, so only the past is rejected here.
+    let scheduledDate: Date | null = null;
+    if (dto.scheduledDate) {
+      scheduledDate = new Date(dto.scheduledDate);
+      const today = new Date();
+      today.setHours(0, 0, 0, 0);
+      if (scheduledDate < today) {
+        throw new BadRequestException(
+          "The scheduled date cannot be in the past.",
+        );
+      }
+    }
+
+    // Same reasoning as the picker filter: a customs-bundled service would put
+    // the booking into the phased customs workflow, which has no contract to
+    // hang off here. Checked server-side because the id comes from the request.
+    if (dto.serviceTypeId) {
+      const serviceType = await this.bookingsRepository.manager
+        .getRepository(ServiceType)
+        .findOne({ where: { id: dto.serviceTypeId } });
+      if (!serviceType) {
+        throw new NotFoundException(
+          `Service type ${dto.serviceTypeId} not found`,
+        );
+      }
+      if (serviceType.includesCustoms) {
+        throw new BadRequestException(
+          "Shipping lines cannot book a service that bundles customs clearance.",
+        );
+      }
+    }
+
+    return insertWithGeneratedReference(
+      () => this.generateReference(),
+      (reference) =>
+        this.bookingsRepository.save({
+          reference,
+          // The owner columns: a shipping-line booking has no company and no
+          // operational profile, which is exactly what the `chk_bookings_
+          // single_owner` CHECK expects alongside a set shippingLineCompanyId.
+          companyId: null,
+          companyProfileId: null,
+          shippingLineCompanyId: shippingLine.id,
+          status: "AWAITING_DOCUMENTS",
+          bookingType: "ONE_TIME",
+          contractId: null,
+          contractType: "NEW",
+          createdByRole: "SHIPPING_LINE",
+          createdByUserId: userId,
+          // Taken from the chosen route, never from the request body: the
+          // direction is frozen on the route from its yard countries, so
+          // deriving it here keeps it consistent with scheduling and booking
+          // windows, which read the same field.
+          originYardId: route.originYardId,
+          destinationYardId: route.destinationYardId,
+          tradeDirection: route.direction,
+          serviceTypeId: dto.serviceTypeId ?? null,
+          freightType: dto.freightType ?? "CONTAINER",
+          // The shipping line picks its shipment day up front (no later
+          // operation-request step exists for them); cargo is still filled in
+          // when the booking is completed.
+          scheduledDate,
+          cargoTypeId: null,
+          cargoTotalWeightVgm: 0,
+        } as never),
+    );
+  }
+
+  /**
+   * List the bookings belonging to the signed-in shipping line, newest first.
+   *
+   * Each row carries `hasQueriedDocuments`: a reviewer querying a document sets
+   * that document's review status but leaves the BOOKING on
+   * DOCUMENTS_UNDER_REVIEW, so status alone cannot tell the list which bookings
+   * need the shipping line to act. Resolved in one grouped query rather than a
+   * clearance call per row.
+   */
+  async listMine(userId: string) {
+    const shippingLine = await this.requireShippingLine(userId);
+
+    const bookings = await this.bookingsRepository.find({
+      where: { shippingLineCompanyId: shippingLine.id },
+      relations: { originYard: true, destinationYard: true },
+      order: { createdAt: "DESC" },
+    });
+    if (bookings.length === 0) return [];
+
+    const queried = await this.bookingsRepository.manager
+      .getRepository(BookingDocumentReview)
+      .find({
+        where: {
+          bookingId: In(bookings.map((b) => b.id)),
+          status: "QUERIED",
+        },
+        select: { bookingId: true },
+      });
+
+    const queriedIds = new Set(queried.map((row) => row.bookingId));
+
+    return bookings.map((booking) => ({
+      ...booking,
+      hasQueriedDocuments: queriedIds.has(booking.id),
+    }));
+  }
+
+  /**
+   * Fetch one of the signed-in shipping line's own bookings. Scoped by owner so
+   * an id belonging to a customer (or another shipping line) reads as missing.
+   */
+  async findMine(userId: string, bookingId: string) {
+    const shippingLine = await this.requireShippingLine(userId);
+
+    const booking = await this.bookingsRepository.findOne({
+      where: { id: bookingId, shippingLineCompanyId: shippingLine.id },
+      // Yards are loaded so the portal can render the lane without a second
+      // lookup — they are set at initiate time from the chosen route. Cargo
+      // (container lines + units, bulk cargo type) rides along for the detail
+      // page's cargo tab once the booking is completed.
+      relations: {
+        originYard: true,
+        destinationYard: true,
+        serviceType: true,
+        cargoType: true,
+        bookingContainers: { containerType: true, units: true },
+      },
+    });
+    if (!booking) throw new NotFoundException(`Booking ${bookingId} not found`);
+
+    // Same flag as the list — see listMine for why booking status alone is not
+    // enough to tell whether the shipping line has something to fix.
+    const queriedCount = await this.bookingsRepository.manager
+      .getRepository(BookingDocumentReview)
+      .count({ where: { bookingId, status: "QUERIED" } });
+
+    // The note Operations wrote when returning the request — the line has to
+    // read it to know what to fix. Only the latest CHANGES_REQUESTED note is
+    // exposed; the other review-note types are staff-internal.
+    const changeNote =
+      booking.status === "OPERATION_CHANGES_REQUESTED"
+        ? await this.bookingsRepository.manager
+            .getRepository(BookingReviewNote)
+            .findOne({
+              where: { bookingId, type: "CHANGES_REQUESTED" },
+              order: { createdAt: "DESC" },
+            })
+        : null;
+
+    return {
+      ...booking,
+      hasQueriedDocuments: queriedCount > 0,
+      operationChangeNote: changeNote?.note ?? null,
+    };
+  }
+
+  /**
+   * Train departures dedicated to the signed-in shipping line: schedules whose
+   * `shippingLineCompanyId` is this line's. These trains are hidden from every
+   * customer-facing read, so this endpoint is the ONLY place they surface in
+   * the portal — the home page lists them and the booking detail matches them
+   * to a booking by lane + day.
+   */
+  async listMyTrains(userId: string) {
+    const shippingLine = await this.requireShippingLine(userId);
+
+    // Recent past kept (48h) so a just-departed train is still visible while
+    // its cargo is on the rails; CANCELLED never shows.
+    const horizon = new Date(Date.now() - 48 * 60 * 60 * 1000);
+    const schedules = await this.bookingsRepository.manager
+      .getRepository(TrainSchedule)
+      .find({
+        where: {
+          shippingLineCompanyId: shippingLine.id,
+          status: In(["DRAFT", "SCHEDULED", "DISPATCHED"]),
+          scheduledDepartureDate: MoreThanOrEqual(horizon),
+        },
+        relations: { originStation: true, destinationStation: true },
+        order: { scheduledDepartureDate: "ASC" },
+      });
+
+    return schedules.map((s) => ({
+      id: s.id,
+      reference: s.reference,
+      trainNumber: s.trainNumber,
+      status: s.status,
+      direction: s.direction,
+      scheduledDepartureDate: s.scheduledDepartureDate,
+      scheduledArrivalDate: s.scheduledArrivalDate,
+      originYardId: s.originStationId,
+      originLabel: s.originStation?.label ?? s.originStation?.code ?? "Origin",
+      destinationYardId: s.destinationStationId,
+      destinationLabel:
+        s.destinationStation?.label ??
+        s.destinationStation?.code ??
+        "Destination",
+    }));
+  }
+
+  /**
+   * Cancel one of the signed-in shipping line's own bookings.
+   *
+   * Its own method rather than the customer `customerCancel`: that path routes
+   * into `BookingTransitionService.cancel`, whose status whitelist covers the
+   * contract-backed lifecycle (DRAFT, SUBMITTED, PENDING_APPROVAL…) and does
+   * not include the document-clearance statuses a shipping-line booking lives
+   * in — so it would reject every one of them.
+   *
+   * Only allowed before the booking is priced and paid. Once it carries a
+   * charge, cancelling is a billing decision (fees, credit notes) that belongs
+   * with Operations, not a self-service button.
+   */
+  async cancelMine(userId: string, bookingId: string, reason?: string) {
+    const shippingLine = await this.requireShippingLine(userId);
+
+    const booking = await this.bookingsRepository.findOne({
+      where: { id: bookingId, shippingLineCompanyId: shippingLine.id },
+    });
+    if (!booking) throw new NotFoundException(`Booking ${bookingId} not found`);
+
+    if (booking.status === "CANCELLED") {
+      throw new BadRequestException("This booking is already cancelled.");
+    }
+    if (!SHIPPING_LINE_CANCELLABLE_STATUSES.includes(booking.status)) {
+      throw new BadRequestException(
+        "This booking can no longer be cancelled — please contact Operations.",
+      );
+    }
+    // Belt and braces: the statuses above are all pre-pricing, so a charge here
+    // would mean the booking moved on in a way this guard did not anticipate.
+    if (Number(booking.totalAmount ?? 0) > 0) {
+      throw new BadRequestException(
+        "This booking has already been priced — please contact Operations to cancel it.",
+      );
+    }
+
+    // The reason lives on the booking's review-note log, the same place the
+    // customer cancel path records it — there is no column for it.
+    await this.bookingsRepository.manager
+      .getRepository(BookingReviewNote)
+      .save({
+        bookingId,
+        note: reason?.trim() || "Cancelled by the shipping line",
+        type: "REJECTION",
+        authorId: userId,
+      } as never);
+
+    await this.bookingsRepository.update(bookingId, {
+      status: "CANCELLED",
+    } as never);
+
+    return this.findMine(userId, bookingId);
+  }
+
+  /** Mirrors the customer reference format — one booking sequence per year. */
+  private async generateReference(): Promise<string> {
+    const year = new Date().getFullYear();
+    const { max } = (await this.bookingsRepository
+      .createQueryBuilder("b")
+      .select(
+        `COALESCE(MAX(NULLIF(regexp_replace(b.reference, '^BK-${year}-', ''), b.reference)::int), 0)`,
+        "max",
+      )
+      .where("b.reference LIKE :prefix", { prefix: `BK-${year}-%` })
+      .getRawOne<{ max: number }>()) ?? { max: 0 };
+
+    return `BK-${year}-${String(Number(max) + 1).padStart(6, "0")}`;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.controller.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.controller.ts
new file mode 100644
index 000000000..3d11e2a29
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.controller.ts
@@ -0,0 +1,100 @@
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseUUIDPipe,
+  Post,
+  Query,
+} 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 "../auth/dto/forgot-password.dto";
+import { CreateShippingLineDto } from "./dto/create-shipping-line.dto";
+import {
+  RegisterShippingLineResponseDto,
+  ShippingLineResponseDto,
+} from "./dto/shipping-line-response.dto";
+import { ShippingLineCompaniesService } from "./shipping-line-companies.service";
+
+/**
+ * Shipping line *companies* — carriers with a portal login, registered by staff
+ * (there is no self-signup). The line receives a single-use activation link and
+ * sets its own password, so staff never see or handle a credential.
+ *
+ * Distinct from `freight.shipping_lines` behind `/shipping-lines`
+ * (rule-engine): that is a pricing lookup list — a code/label a booking points
+ * at via `shipping_line_id` — with no account, no user and no login. Same words,
+ * different concept, hence the separate route.
+ */
+@ApiTags("shipping-line-companies")
+@Controller("shipping-line-companies")
+@ApiBearerAuth()
+export class ShippingLineCompaniesController {
+  constructor(private readonly shippingLineCompaniesService: ShippingLineCompaniesService) {}
+
+  @Post()
+  @BookingStaff(FREIGHT_PERMS.shippingLines.create)
+  @ApiOperation({
+    summary: "Register a shipping line and send its activation link",
+  })
+  async register(
+    @Body() dto: CreateShippingLineDto,
+  ): Promise<RegisterShippingLineResponseDto> {
+    const { shippingLine, activationSentTo } =
+      await this.shippingLineCompaniesService.register(dto);
+    return new RegisterShippingLineResponseDto(shippingLine, activationSentTo);
+  }
+
+  @Get()
+  // OR'd: the credits view needs this list as its line picker, so holding
+  // shipping_line_credits:view alone is enough to read it.
+  @BookingStaff([
+    FREIGHT_PERMS.shippingLines.view,
+    FREIGHT_PERMS.shippingLineCredits.view,
+  ])
+  @ApiOperation({ summary: "List shipping lines (paginated)" })
+  async list(
+    @Query("page") page?: string,
+    @Query("limit") limit?: string,
+  ): Promise<{
+    items: ShippingLineResponseDto[];
+    total: number;
+    page: number;
+    limit: number;
+  }> {
+    const result = await this.shippingLineCompaniesService.list(
+      page ? Number(page) : undefined,
+      limit ? Number(limit) : undefined,
+    );
+    return {
+      ...result,
+      items: result.items.map((item) => new ShippingLineResponseDto(item)),
+    };
+  }
+
+  @Get(":id")
+  @BookingStaff(FREIGHT_PERMS.shippingLines.view)
+  @ApiOperation({ summary: "Get a shipping line by id" })
+  async findOne(
+    @Param("id", ParseUUIDPipe) id: string,
+  ): Promise<ShippingLineResponseDto> {
+    return new ShippingLineResponseDto(
+      await this.shippingLineCompaniesService.findById(id),
+    );
+  }
+
+  @Post(":id/resend-activation")
+  @BookingStaff(FREIGHT_PERMS.shippingLines.resetPassword)
+  @ApiOperation({
+    summary: "Resend a shipping line's activation / password-reset link",
+  })
+  async resendActivation(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: BackofficeResetPasswordDto,
+  ) {
+    return this.shippingLineCompaniesService.resendActivation(id, dto.channel);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.module.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.module.ts
new file mode 100644
index 000000000..888a996a6
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.module.ts
@@ -0,0 +1,59 @@
+import { Module, forwardRef } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { User } from "@tria-plc/iamapi-common/entities/iam/user/user.entity";
+
+import { FreightAuthModule } from "../auth/freight-auth.module";
+import { BillingModule } from "../billing/billing.module";
+import { Booking } from "../bookings/entities/booking.entity";
+import { OtpModule } from "../otp/otp.module";
+import { ShippingLineCompany } from "./entities/shipping-line-company.entity";
+import { ShippingLineCredit } from "./entities/shipping-line-credit.entity";
+import { ShippingLineInvoiceApproval } from "./entities/shipping-line-invoice-approval.entity";
+import { ShippingLineInvoiceApprovalsRepository } from "./shipping-line-invoice-approvals.repository";
+import { ShippingLineBookingsController } from "./shipping-line-bookings.controller";
+import { ShippingLineBookingsService } from "./shipping-line-bookings.service";
+import { ShippingLineCompaniesController } from "./shipping-line-companies.controller";
+import { ShippingLineCompaniesRepository } from "./shipping-line-companies.repository";
+import { ShippingLineCompaniesService } from "./shipping-line-companies.service";
+import { ShippingLineCreditsController } from "./shipping-line-credits.controller";
+import { ShippingLineCreditsRepository } from "./shipping-line-credits.repository";
+import { ShippingLineCreditsService } from "./shipping-line-credits.service";
+
+@Module({
+  imports: [
+    // Booking is registered here only so this module can create shipping-line
+    // rows in `freight.bookings`; the customer BookingsModule is untouched.
+    TypeOrmModule.forFeature([
+      ShippingLineCompany,
+      ShippingLineCredit,
+      ShippingLineInvoiceApproval,
+      User,
+      Booking,
+    ]),
+    // CustomerResetService — activation links reuse the staff-triggered reset path.
+    FreightAuthModule,
+    OtpModule,
+    // Credits are billed by generating an ordinary invoice. Billing still knows
+    // nothing about credits and hears about settlement only by emitting its own
+    // `shipping_line_credit.invoice.paid` event, but the module graph now cycles
+    // (billing -> companies -> here -> billing), so this edge needs forwardRef.
+    forwardRef(() => BillingModule),
+  ],
+  controllers: [
+    ShippingLineCompaniesController,
+    ShippingLineBookingsController,
+    ShippingLineCreditsController,
+  ],
+  providers: [
+    ShippingLineCompaniesService,
+    ShippingLineCompaniesRepository,
+    ShippingLineBookingsService,
+    ShippingLineCreditsService,
+    ShippingLineCreditsRepository,
+    ShippingLineInvoiceApprovalsRepository,
+  ],
+  // Exported so whatever prices a shipping-line booking can record the charge.
+  exports: [ShippingLineCompaniesService, ShippingLineCreditsService],
+})
+export class ShippingLineCompaniesModule {}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.repository.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.repository.ts
new file mode 100644
index 000000000..997550172
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.repository.ts
@@ -0,0 +1,61 @@
+import { BaseRepository } from "@edr/api-common";
+import { Injectable } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { EntityManager, Repository } from "typeorm";
+
+import { ShippingLineCompany } from "./entities/shipping-line-company.entity";
+
+@Injectable()
+export class ShippingLineCompaniesRepository extends BaseRepository<ShippingLineCompany> {
+  constructor(
+    @InjectRepository(ShippingLineCompany)
+    private readonly shippingLineRepo: Repository<ShippingLineCompany>,
+  ) {
+    super(shippingLineRepo);
+  }
+
+  findByUserId(userId: string): Promise<ShippingLineCompany | null> {
+    return this.shippingLineRepo.findOne({ where: { userId } });
+  }
+
+  /** Case-insensitive, matching the `lower(email)` unique index. */
+  async existsByEmail(email: string): Promise<boolean> {
+    const count = await this.shippingLineRepo
+      .createQueryBuilder("sl")
+      .where("lower(sl.email) = lower(:email)", { email })
+      .getCount();
+    return count > 0;
+  }
+
+  async existsByScac(scacCode: string): Promise<boolean> {
+    const count = await this.shippingLineRepo
+      .createQueryBuilder("sl")
+      .where("upper(sl.scacCode) = upper(:scacCode)", { scacCode })
+      .getCount();
+    return count > 0;
+  }
+
+  findAllPaginated(
+    skip: number,
+    take: number,
+  ): Promise<[ShippingLineCompany[], number]> {
+    return this.shippingLineRepo.findAndCount({
+      order: { createdAt: "DESC" },
+      skip,
+      take,
+    });
+  }
+
+  /**
+   * Insert inside a caller-supplied transaction, so the shipping-line row and
+   * the IAM user it points at commit together — a row referencing a user that
+   * was rolled back (or vice versa) is an account nobody can sign in to.
+   */
+  createInTransaction(
+    manager: EntityManager,
+    data: Partial<ShippingLineCompany>,
+  ): Promise<ShippingLineCompany> {
+    const repo = manager.getRepository(ShippingLineCompany);
+    return repo.save(repo.create(data));
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.service.spec.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.service.spec.ts
new file mode 100644
index 000000000..d9d429dc9
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.service.spec.ts
@@ -0,0 +1,233 @@
+import { ConflictException } from "@nestjs/common";
+import {
+  EUserStatus,
+  EUserType,
+} from "@tria-plc/api-common/utils/enums/user.enum";
+
+import { ResetChannel } from "../auth/dto/forgot-password.dto";
+import { ShippingLineCompaniesService } from "./shipping-line-companies.service";
+
+/**
+ * Registration is the whole feature: an IAM account and a carrier record
+ * created together, then an activation link the line uses to set its own
+ * password. These lock the parts that would silently break the login.
+ */
+describe("ShippingLineCompaniesService.register", () => {
+  const savedUser = { id: "user-1" };
+
+  let shippingLinesRepo: {
+    existsByEmail: jest.Mock;
+    existsByScac: jest.Mock;
+    createInTransaction: jest.Mock;
+    findById: jest.Mock;
+    findByUserId: jest.Mock;
+  };
+  let userRepository: { findOne: jest.Mock };
+  let customerResetService: { sendResetLinkToUser: jest.Mock };
+  let dataSource: { transaction: jest.Mock };
+  let userRepoInTx: { create: jest.Mock; save: jest.Mock };
+  let service: ShippingLineCompaniesService;
+
+  const dto = {
+    name: "Ethiopian Shipping Lines",
+    email: "Ops@ESL.com.et",
+    phoneNumber: "+251911223344",
+    scacCode: "eslk",
+  };
+
+  beforeEach(() => {
+    userRepoInTx = {
+      create: jest.fn((v) => v),
+      save: jest.fn().mockResolvedValue(savedUser),
+    };
+
+    shippingLinesRepo = {
+      existsByEmail: jest.fn().mockResolvedValue(false),
+      existsByScac: jest.fn().mockResolvedValue(false),
+      createInTransaction: jest
+        .fn()
+        .mockImplementation((_m, data) => ({ id: "sl-1", ...data })),
+      findById: jest.fn(),
+      findByUserId: jest.fn(),
+    };
+    userRepository = { findOne: jest.fn().mockResolvedValue(null) };
+    customerResetService = {
+      sendResetLinkToUser: jest
+        .fn()
+        .mockResolvedValue({ maskedTarget: "o**@esl.com.et", channel: "email" }),
+    };
+    dataSource = {
+      transaction: jest.fn(async (cb) =>
+        cb({ getRepository: () => userRepoInTx }),
+      ),
+    };
+
+    service = new ShippingLineCompaniesService(
+      shippingLinesRepo as never,
+      userRepository as never,
+      customerResetService as never,
+      dataSource as never,
+    );
+  });
+
+  it("creates the IAM account with no password set", async () => {
+    await service.register(dto as never);
+
+    const created = userRepoInTx.create.mock.calls[0][0];
+    expect(created).toMatchObject({
+      userType: EUserType.INDIVIDUAL,
+      isActive: true,
+      status: EUserStatus.ACCEPTED,
+      // The line sets its own password from the activation link. Employee
+      // creation seeds a shared default here; a shipping line must not get one.
+      hasSetPassword: false,
+    });
+  });
+
+  it("never writes a credential row", async () => {
+    await service.register(dto as never);
+
+    // Only the User repository is touched inside the transaction — a
+    // UserCredential insert would mean the account has a password nobody chose.
+    for (const call of userRepoInTx.save.mock.calls) {
+      expect(call[0]).not.toHaveProperty("password");
+    }
+  });
+
+  it("normalises email and SCAC before storing", async () => {
+    const result = await service.register(dto as never);
+
+    expect(result.shippingLine).toMatchObject({
+      email: "ops@esl.com.et",
+      scacCode: "ESLK",
+    });
+  });
+
+  it("creates the account and the record in one transaction", async () => {
+    await service.register(dto as never);
+
+    expect(dataSource.transaction).toHaveBeenCalledTimes(1);
+    expect(shippingLinesRepo.createInTransaction).toHaveBeenCalledWith(
+      expect.anything(),
+      expect.objectContaining({ userId: "user-1" }),
+    );
+  });
+
+  it("sends the activation link outside the transaction, after commit", async () => {
+    const order: string[] = [];
+    dataSource.transaction.mockImplementation(async (cb: never) => {
+      order.push("tx");
+      return (cb as unknown as (m: unknown) => Promise<unknown>)({
+        getRepository: () => userRepoInTx,
+      });
+    });
+    customerResetService.sendResetLinkToUser.mockImplementation(async () => {
+      order.push("send");
+      return { maskedTarget: "o**@esl.com.et", channel: "email" };
+    });
+
+    await service.register(dto as never);
+
+    expect(order[0]).toBe("tx");
+    expect(order).toContain("send");
+  });
+
+  it("emails the link, and also texts it when the number is domestic", async () => {
+    await service.register(dto as never);
+
+    const channels = customerResetService.sendResetLinkToUser.mock.calls.map(
+      (c) => c[1],
+    );
+    expect(channels).toContain(ResetChannel.Email);
+    expect(channels).toContain(ResetChannel.Phone);
+  });
+
+  it("emails only when the number is foreign — the SMS gateway is domestic-only", async () => {
+    await service.register({ ...dto, phoneNumber: "+441234567890" } as never);
+
+    const channels = customerResetService.sendResetLinkToUser.mock.calls.map(
+      (c) => c[1],
+    );
+    expect(channels).toEqual([ResetChannel.Email]);
+  });
+
+  it("keeps the registration when the activation link fails to send", async () => {
+    customerResetService.sendResetLinkToUser.mockResolvedValue(null);
+
+    const result = await service.register(dto as never);
+
+    // The account is valid without the link and the link is resendable —
+    // a delivery failure must not roll back the registration.
+    expect(result.shippingLine).toMatchObject({ id: "sl-1" });
+    expect(result.activationSentTo).toBeNull();
+  });
+
+  it("refuses a duplicate email", async () => {
+    shippingLinesRepo.existsByEmail.mockResolvedValue(true);
+
+    await expect(service.register(dto as never)).rejects.toBeInstanceOf(
+      ConflictException,
+    );
+    expect(dataSource.transaction).not.toHaveBeenCalled();
+  });
+
+  it("refuses a duplicate SCAC", async () => {
+    shippingLinesRepo.existsByScac.mockResolvedValue(true);
+
+    await expect(service.register(dto as never)).rejects.toBeInstanceOf(
+      ConflictException,
+    );
+    expect(dataSource.transaction).not.toHaveBeenCalled();
+  });
+
+  it("refuses credentials already belonging to another account", async () => {
+    // Reusing an existing IAM user would let one login resolve to both a
+    // customer and a shipping line.
+    userRepository.findOne.mockResolvedValue({ id: "existing" });
+
+    await expect(service.register(dto as never)).rejects.toBeInstanceOf(
+      ConflictException,
+    );
+    expect(dataSource.transaction).not.toHaveBeenCalled();
+  });
+
+  it("defaults the username to the email", async () => {
+    await service.register(dto as never);
+
+    expect(userRepoInTx.create.mock.calls[0][0]).toMatchObject({
+      username: "ops@esl.com.et",
+    });
+  });
+
+  /**
+   * The default reset lookup inner-joins an active `user_credentials` row so a
+   * reset cannot revive a suspended account. A shipping line has no credential
+   * until it uses the activation link, so without this flag the account is
+   * excluded from its own activation — the link is never minted, never logged,
+   * and resend answers 404.
+   */
+  it("requests the credential-less lookup for every activation send", async () => {
+    await service.register(dto as never);
+
+    expect(customerResetService.sendResetLinkToUser).toHaveBeenCalled();
+    for (const call of customerResetService.sendResetLinkToUser.mock.calls) {
+      expect(call[2]).toMatchObject({ allowWithoutCredential: true });
+    }
+  });
+
+  it("requests the credential-less lookup when resending", async () => {
+    shippingLinesRepo.findById.mockResolvedValue({
+      id: "sl-1",
+      userId: "user-1",
+      phoneNumber: "+251911223344",
+    });
+
+    await service.resendActivation("sl-1", ResetChannel.Email);
+
+    expect(customerResetService.sendResetLinkToUser).toHaveBeenCalledWith(
+      "user-1",
+      ResetChannel.Email,
+      expect.objectContaining({ allowWithoutCredential: true }),
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.service.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.service.ts
new file mode 100644
index 000000000..ad290def8
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-companies.service.ts
@@ -0,0 +1,219 @@
+import {
+  BadRequestException,
+  ConflictException,
+  Injectable,
+  Logger,
+  NotFoundException,
+} from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import {
+  EUserStatus,
+  EUserType,
+} from "@tria-plc/api-common/utils/enums/user.enum";
+// Subpath import (not the package root) so ts-jest can resolve it when this
+// file lands in a spec's compile graph — same reason as backoffice.service.ts.
+import { User } from "@tria-plc/iamapi-common/entities/iam/user/user.entity";
+import { DataSource, Repository } from "typeorm";
+
+import { CustomerResetService } from "../auth/customer-reset.service";
+import { ResetChannel } from "../auth/dto/forgot-password.dto";
+import { isDomesticPhone } from "../otp/otp.service";
+import { CreateShippingLineDto } from "./dto/create-shipping-line.dto";
+import { ShippingLineCompany } from "./entities/shipping-line-company.entity";
+import { ShippingLineCompaniesRepository } from "./shipping-line-companies.repository";
+
+export interface RegisteredShippingLine {
+  shippingLine: ShippingLineCompany;
+  /** Masked destination of the activation link, or null if none was sent. */
+  activationSentTo: string | null;
+  activationChannel: ResetChannel | null;
+}
+
+@Injectable()
+export class ShippingLineCompaniesService {
+  private readonly logger = new Logger(ShippingLineCompaniesService.name);
+
+  constructor(
+    private readonly shippingLineCompaniesRepo: ShippingLineCompaniesRepository,
+    @InjectRepository(User)
+    private readonly userRepository: Repository<User>,
+    private readonly customerResetService: CustomerResetService,
+    private readonly dataSource: DataSource,
+  ) {}
+
+  /**
+   * Register a shipping line: create its IAM account and its record together,
+   * then send an activation link so the line sets its own password.
+   *
+   * The IAM mechanics follow `BackofficeService.createOrganizationUser` — same
+   * entities, same transaction shape — with one deliberate difference: no
+   * `UserCredential` row is written and `hasSetPassword` stays false. Staff
+   * creating an employee seed a shared default password; a shipping line must
+   * come through the activation link instead, so no credential exists until the
+   * line sets one.
+   */
+  async register(dto: CreateShippingLineDto): Promise<RegisteredShippingLine> {
+    const email = dto.email.trim().toLowerCase();
+    const username = (dto.username?.trim() || email).toLowerCase();
+    const phoneNumber = dto.phoneNumber?.trim() || undefined;
+    const scacCode = dto.scacCode?.trim().toUpperCase();
+
+    if (await this.shippingLineCompaniesRepo.existsByEmail(email)) {
+      throw new ConflictException(
+        `A shipping line with email ${email} already exists`,
+      );
+    }
+
+    if (scacCode && (await this.shippingLineCompaniesRepo.existsByScac(scacCode))) {
+      throw new ConflictException(
+        `A shipping line with SCAC ${scacCode} already exists`,
+      );
+    }
+
+    // An existing IAM account means these credentials already belong to a
+    // customer or an employee. Reusing it would let one login resolve to two
+    // different account kinds, so this is refused rather than merged — unlike
+    // employee creation, which legitimately re-uses a person's existing user.
+    const existingUser = await this.userRepository.findOne({
+      where: [{ email }, { username }],
+      select: { id: true },
+    });
+    if (existingUser) {
+      throw new ConflictException(
+        "email_or_username_already_in_use",
+      );
+    }
+
+    const shippingLine = await this.dataSource.transaction(async (manager) => {
+      const userRepo = manager.getRepository(User);
+      const user = await userRepo.save(
+        userRepo.create({
+          email,
+          username,
+          phoneNumber,
+          name: { en: dto.name.trim() },
+          userType: EUserType.INDIVIDUAL,
+          isActive: true,
+          // No credential row is written: the account has no password until the
+          // activation link is used. `hasSetPassword` must stay false or the
+          // portal treats the account as ready to sign in with a password that
+          // does not exist.
+          hasSetPassword: false,
+          status: EUserStatus.ACCEPTED,
+        }),
+      );
+
+      return this.shippingLineCompaniesRepo.createInTransaction(manager, {
+        userId: user.id as string,
+        name: dto.name.trim(),
+        email,
+        phoneNumber: phoneNumber ?? null,
+        scacCode: scacCode ?? null,
+        imoNumber: dto.imoNumber?.trim() || null,
+        bicCode: dto.bicCode?.trim() || null,
+      });
+    });
+
+    // Outside the transaction on purpose: a delivery failure must not roll back
+    // a registered line. The link is resendable, and the account is already
+    // valid without it.
+    const activation = await this.sendActivationLink(shippingLine);
+
+    return {
+      shippingLine,
+      activationSentTo: activation?.maskedTarget ?? null,
+      activationChannel: activation?.channel ?? null,
+    };
+  }
+
+  /**
+   * Send the activation link on registration.
+   *
+   * Email always goes out — it is required at registration and is the only
+   * channel guaranteed to reach a foreign-registered line. SMS is sent in
+   * addition when the number is domestic, since the gateway silently drops
+   * anything else (see `CustomerResetService`). Both carry the SAME single-use
+   * ticket: minting retires earlier tickets, so two mints would kill the email
+   * link the moment the SMS went out.
+   *
+   * Reports the email send, as that is the one that is always attempted.
+   */
+  async sendActivationLink(shippingLine: ShippingLineCompany) {
+    const scope = `shipping line ${shippingLine.id}`;
+    const channels = [ResetChannel.Email];
+    if (shippingLine.phoneNumber && isDomesticPhone(shippingLine.phoneNumber)) {
+      channels.push(ResetChannel.Phone);
+    }
+
+    const sent = await this.customerResetService.sendResetLinkToUserOnChannels(
+      shippingLine.userId,
+      channels,
+      { scope, allowWithoutCredential: true },
+    );
+    const emailed = sent.find((s) => s.channel === ResetChannel.Email) ?? null;
+
+    if (!emailed) {
+      this.logger.error(
+        `Activation email not sent for shipping line ${shippingLine.id} — no reachable address`,
+      );
+    }
+    if (channels.includes(ResetChannel.Phone) && !sent.some((s) => s.channel === ResetChannel.Phone)) {
+      this.logger.warn(`Activation SMS not sent for shipping line ${shippingLine.id}`);
+    }
+
+    return emailed;
+  }
+
+  async resendActivation(id: string, channel: ResetChannel) {
+    const shippingLine = await this.shippingLineCompaniesRepo.findById(id);
+    if (!shippingLine) {
+      throw new NotFoundException("Shipping line not found");
+    }
+
+    if (
+      channel === ResetChannel.Phone &&
+      (!shippingLine.phoneNumber || !isDomesticPhone(shippingLine.phoneNumber))
+    ) {
+      throw new BadRequestException(
+        "This shipping line has no domestic phone number — the SMS gateway cannot reach it",
+      );
+    }
+
+    const sent = await this.customerResetService.sendResetLinkToUser(
+      shippingLine.userId,
+      channel,
+      { scope: `shipping line ${shippingLine.id}`, allowWithoutCredential: true },
+    );
+
+    if (!sent) {
+      throw new NotFoundException(
+        `No active account with ${
+          channel === ResetChannel.Email ? "an email address" : "a phone number"
+        } for this shipping line`,
+      );
+    }
+
+    return sent;
+  }
+
+  async findById(id: string): Promise<ShippingLineCompany> {
+    const shippingLine = await this.shippingLineCompaniesRepo.findById(id);
+    if (!shippingLine) {
+      throw new NotFoundException("Shipping line not found");
+    }
+    return shippingLine;
+  }
+
+  /** The shipping line signed in as `userId`, or null for any other account. */
+  findByUserId(userId: string): Promise<ShippingLineCompany | null> {
+    return this.shippingLineCompaniesRepo.findByUserId(userId);
+  }
+
+  async list(page = 1, limit = 20) {
+    const [items, total] = await this.shippingLineCompaniesRepo.findAllPaginated(
+      (page - 1) * limit,
+      limit,
+    );
+    return { items, total, page, limit };
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.controller.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.controller.ts
new file mode 100644
index 000000000..7a2c8418f
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.controller.ts
@@ -0,0 +1,284 @@
+import { CurrentUser } from "@edr/api-common";
+import { Freight } from "@edr/types";
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseUUIDPipe,
+  Post,
+  Query,
+} from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+
+import { BookingStaff, PortalCustomer } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import {
+  CancelCreditDto,
+  DecideInvoiceActionDto,
+  GenerateCreditInvoiceDto,
+  RequestInvoiceActionDto,
+} from "./dto/shipping-line-credit.dto";
+import { ShippingLineCreditStatus } from "./entities/shipping-line-credit.entity";
+import { ShippingLineInvoiceActionType } from "./entities/shipping-line-invoice-approval.entity";
+import { ShippingLineCreditsService } from "./shipping-line-credits.service";
+
+interface CurrentIamUser {
+  id: string;
+}
+
+/**
+ * Finance's view of what shipping lines owe.
+ *
+ * A shipping line books and ships without paying — the charge is recorded as a
+ * credit instead. Finance reads the unbilled list here, batches it into an
+ * invoice, and the line then pays that invoice through the ordinary
+ * `/billing` + CBE routes; nothing in this controller touches money directly.
+ */
+@ApiTags("shipping-line-credits")
+@Controller("shipping-line-credits")
+@ApiBearerAuth()
+export class ShippingLineCreditsController {
+  constructor(private readonly credits: ShippingLineCreditsService) {}
+
+  @Get()
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary:
+      "The whole credit ledger across every shipping line (paginated), optionally filtered by line and/or status.",
+  })
+  async listAll(
+    @Query("page") page?: string,
+    @Query("pageSize") pageSize?: string,
+    @Query("status") status?: ShippingLineCreditStatus,
+    @Query("shippingLineId", new ParseUUIDPipe({ optional: true }))
+    shippingLineId?: string,
+  ) {
+    return this.credits.listAll(
+      page ? Number(page) : 1,
+      pageSize ? Number(pageSize) : 20,
+      status,
+      shippingLineId,
+    );
+  }
+
+  // Declared before the parameterised staff routes so "summary" is never
+  // captured as a shipping-line id.
+  @Get("summary")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary:
+      "Outstanding totals across every shipping line, or one line when shippingLineId is given.",
+  })
+  async summaryAll(
+    @Query("shippingLineId", new ParseUUIDPipe({ optional: true }))
+    shippingLineId?: string,
+  ) {
+    return this.credits.summary(shippingLineId);
+  }
+
+  // Declared before ":shippingLineId" so "invoices" is never captured as an id.
+  @Get("invoices")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary:
+      "Credit invoices across every shipping line (paginated), each with any pending manual-action request.",
+  })
+  async listInvoices(
+    @Query("page") page?: string,
+    @Query("pageSize") pageSize?: string,
+    @Query("status") status?: string,
+    @Query("shippingLineId", new ParseUUIDPipe({ optional: true }))
+    shippingLineId?: string,
+  ) {
+    return this.credits.listCreditInvoices(
+      page ? Number(page) : 1,
+      pageSize ? Number(pageSize) : 20,
+      status as Freight.InvoiceStatus | undefined,
+      shippingLineId,
+    );
+  }
+
+  @Get("invoice-actions/pending")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary:
+      "Undecided manual-action requests for a batch of invoices (one lookup for a list page).",
+  })
+  async pendingInvoiceActions(@Query("invoiceIds") invoiceIds?: string) {
+    const ids = (invoiceIds ?? "")
+      .split(",")
+      .map((id) => id.trim())
+      .filter(Boolean);
+    return this.credits.pendingInvoiceActions(ids);
+  }
+
+  // ── Maker–checker on credit invoices ──────────────────────────────────────
+  // Request and approve are DIFFERENT permissions, and the service refuses a
+  // decision by the requester — marking debt paid or voiding an invoice is
+  // never a one-person action.
+
+  @Post("invoices/:invoiceId/mark-paid-request")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.invoiceMarkPaid)
+  @ApiOperation({
+    summary:
+      "Request recording a full offline payment against a credit invoice (awaits chief approval).",
+  })
+  async requestMarkPaid(
+    @Param("invoiceId", ParseUUIDPipe) invoiceId: string,
+    @Body() dto: RequestInvoiceActionDto,
+    @CurrentUser() user: CurrentIamUser,
+  ) {
+    return this.credits.requestInvoiceAction(
+      invoiceId,
+      ShippingLineInvoiceActionType.MarkPaid,
+      user.id,
+      dto.reason,
+      dto.paymentReference,
+    );
+  }
+
+  @Post("invoices/:invoiceId/cancel-request")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.invoiceCancel)
+  @ApiOperation({
+    summary:
+      "Request voiding a credit invoice — its credits return to the unbilled pool (awaits chief approval).",
+  })
+  async requestCancel(
+    @Param("invoiceId", ParseUUIDPipe) invoiceId: string,
+    @Body() dto: RequestInvoiceActionDto,
+    @CurrentUser() user: CurrentIamUser,
+  ) {
+    return this.credits.requestInvoiceAction(
+      invoiceId,
+      ShippingLineInvoiceActionType.Cancel,
+      user.id,
+      dto.reason,
+    );
+  }
+
+  @Post("invoice-actions/:approvalId/approve")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.invoiceApprove)
+  @ApiOperation({
+    summary:
+      "Approve a pending invoice request — executes the offline settlement or the cancellation.",
+  })
+  async approveInvoiceAction(
+    @Param("approvalId", ParseUUIDPipe) approvalId: string,
+    @Body() dto: DecideInvoiceActionDto,
+    @CurrentUser() user: CurrentIamUser,
+  ) {
+    return this.credits.decideInvoiceAction(
+      approvalId,
+      user.id,
+      true,
+      dto.note,
+    );
+  }
+
+  @Post("invoice-actions/:approvalId/reject")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.invoiceReject)
+  @ApiOperation({
+    summary: "Reject a pending invoice request — nothing is changed.",
+  })
+  async rejectInvoiceAction(
+    @Param("approvalId", ParseUUIDPipe) approvalId: string,
+    @Body() dto: DecideInvoiceActionDto,
+    @CurrentUser() user: CurrentIamUser,
+  ) {
+    return this.credits.decideInvoiceAction(
+      approvalId,
+      user.id,
+      false,
+      dto.note,
+    );
+  }
+
+  // Declared before the parameterised staff routes so "me" is never captured
+  // as a shipping-line id.
+  @Get("me")
+  @PortalCustomer()
+  @ApiOperation({
+    summary:
+      "The signed-in shipping line's own statement: outstanding balance plus its credit ledger.",
+  })
+  async myStatement(
+    @CurrentUser() user: CurrentIamUser,
+    @Query("page") page?: string,
+    @Query("pageSize") pageSize?: string,
+  ) {
+    return this.credits.myStatement(
+      user.id,
+      page ? Number(page) : 1,
+      pageSize ? Number(pageSize) : 20,
+    );
+  }
+
+  @Get(":shippingLineId/outstanding")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary:
+      "What one shipping line owes: unbilled + billed totals, derived from the ledger.",
+  })
+  async outstanding(
+    @Param("shippingLineId", ParseUUIDPipe) shippingLineId: string,
+  ) {
+    return this.credits.outstanding(shippingLineId);
+  }
+
+  @Get(":shippingLineId/unbilled")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary:
+      "Credits that can go on an invoice for this line, oldest first. This is the selection list.",
+  })
+  async listUnbilled(
+    @Param("shippingLineId", ParseUUIDPipe) shippingLineId: string,
+  ) {
+    return this.credits.listUnbilled(shippingLineId);
+  }
+
+  @Get(":shippingLineId")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.view)
+  @ApiOperation({
+    summary: "Full credit ledger for one shipping line (paginated).",
+  })
+  async listCredits(
+    @Param("shippingLineId", ParseUUIDPipe) shippingLineId: string,
+    @Query("page") page?: string,
+    @Query("pageSize") pageSize?: string,
+    @Query("status") status?: ShippingLineCreditStatus,
+  ) {
+    return this.credits.listCredits(
+      shippingLineId,
+      page ? Number(page) : 1,
+      pageSize ? Number(pageSize) : 20,
+      status,
+    );
+  }
+
+  @Post("invoice")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.invoice)
+  @ApiOperation({
+    summary:
+      "Bill a batch of unbilled credits as one invoice. All credits must belong to the same shipping line.",
+  })
+  async generateInvoice(@Body() dto: GenerateCreditInvoiceDto) {
+    return this.credits.generateInvoice(dto.creditIds, {
+      dueInDays: dto.dueInDays,
+    });
+  }
+
+  @Post(":creditId/cancel")
+  @BookingStaff(FREIGHT_PERMS.shippingLineCredits.cancel)
+  @ApiOperation({
+    summary:
+      "Write off an unbilled credit. Once billed, cancel the invoice instead.",
+  })
+  async cancel(
+    @Param("creditId", ParseUUIDPipe) creditId: string,
+    @Body() dto: CancelCreditDto,
+  ) {
+    return this.credits.cancelCredit(creditId, dto.reason);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.repository.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.repository.ts
new file mode 100644
index 000000000..f1413cbaf
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.repository.ts
@@ -0,0 +1,148 @@
+import { BaseRepository } from "@edr/api-common";
+import { Injectable } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { EntityManager, In, Repository } from "typeorm";
+
+import {
+  OUTSTANDING_CREDIT_STATUSES,
+  ShippingLineCredit,
+  ShippingLineCreditStatus,
+} from "./entities/shipping-line-credit.entity";
+
+/** What one shipping line currently owes, split by billing stage. */
+export interface OutstandingTotals {
+  /** Priced but not yet on an invoice. */
+  unbilledAmount: number;
+  /** On an issued invoice, awaiting payment. */
+  billedAmount: number;
+  /** `unbilledAmount + billedAmount` — the full debt. */
+  totalOutstanding: number;
+  unbilledCount: number;
+  billedCount: number;
+  currency: string;
+}
+
+@Injectable()
+export class ShippingLineCreditsRepository extends BaseRepository<ShippingLineCredit> {
+  constructor(
+    @InjectRepository(ShippingLineCredit)
+    private readonly credits: Repository<ShippingLineCredit>,
+  ) {
+    super(credits);
+  }
+
+  findByBookingId(bookingId: string): Promise<ShippingLineCredit | null> {
+    return this.credits.findOne({ where: { bookingId } });
+  }
+
+  /**
+   * Finance's worklist: everything for one line that can go on an invoice,
+   * oldest first so the longest-standing debt is billed before newer charges.
+   */
+  findUnbilled(shippingLineCompanyId: string): Promise<ShippingLineCredit[]> {
+    return this.credits.find({
+      where: {
+        shippingLineCompanyId,
+        status: ShippingLineCreditStatus.Unbilled,
+      },
+      relations: { booking: true },
+      order: { createdAt: "ASC" },
+    });
+  }
+
+  findByInvoiceId(
+    invoiceId: string,
+    manager?: EntityManager,
+  ): Promise<ShippingLineCredit[]> {
+    const repo = manager
+      ? manager.getRepository(ShippingLineCredit)
+      : this.credits;
+    return repo.find({ where: { invoiceId } });
+  }
+
+  /**
+   * Load a specific batch inside the caller's transaction and lock it, so two
+   * concurrent invoice generations cannot both claim the same credits.
+   */
+  findByIdsForUpdate(
+    manager: EntityManager,
+    ids: string[],
+  ): Promise<ShippingLineCredit[]> {
+    return manager.getRepository(ShippingLineCredit).find({
+      where: { id: In(ids) },
+      lock: { mode: "pessimistic_write" },
+    });
+  }
+
+  /**
+   * Derived debt — never a stored column. Grouped in one query so the detail
+   * page does not fan out per status. Without a line id it totals every line —
+   * the back-office overview figure.
+   */
+  async outstandingFor(
+    shippingLineCompanyId?: string,
+  ): Promise<OutstandingTotals> {
+    const qb = this.credits
+      .createQueryBuilder("credit")
+      .select("credit.status", "status")
+      .addSelect("COALESCE(SUM(credit.amount), 0)", "amount")
+      .addSelect("COUNT(*)", "count")
+      .where("credit.status IN (:...statuses)", {
+        statuses: [...OUTSTANDING_CREDIT_STATUSES],
+      })
+      .andWhere("credit.deletedAt IS NULL")
+      .groupBy("credit.status");
+    if (shippingLineCompanyId) {
+      qb.andWhere("credit.shippingLineCompanyId = :shippingLineCompanyId", {
+        shippingLineCompanyId,
+      });
+    }
+    const rows = await qb.getRawMany<{
+      status: string;
+      amount: string;
+      count: string;
+    }>();
+
+    const totals = (status: ShippingLineCreditStatus) => {
+      const row = rows.find((r) => r.status === status);
+      return {
+        amount: row ? Number(row.amount) : 0,
+        count: row ? Number(row.count) : 0,
+      };
+    };
+
+    const unbilled = totals(ShippingLineCreditStatus.Unbilled);
+    const billed = totals(ShippingLineCreditStatus.Billed);
+
+    return {
+      unbilledAmount: unbilled.amount,
+      billedAmount: billed.amount,
+      totalOutstanding: unbilled.amount + billed.amount,
+      unbilledCount: unbilled.count,
+      billedCount: billed.count,
+      currency: "ETB",
+    };
+  }
+
+  /**
+   * Paginated ledger — every credit, whatever its status. Scoped to one line
+   * when an id is given, across all lines otherwise.
+   */
+  findAllPaginated(
+    shippingLineCompanyId: string | undefined,
+    skip: number,
+    take: number,
+    status?: ShippingLineCreditStatus,
+  ): Promise<[ShippingLineCredit[], number]> {
+    return this.credits.findAndCount({
+      where: {
+        ...(shippingLineCompanyId ? { shippingLineCompanyId } : {}),
+        ...(status ? { status } : {}),
+      },
+      relations: { booking: true, invoice: true, shippingLineCompany: true },
+      order: { createdAt: "DESC" },
+      skip,
+      take,
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.service.spec.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.service.spec.ts
new file mode 100644
index 000000000..43e0b5c40
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.service.spec.ts
@@ -0,0 +1,304 @@
+import { BadRequestException, NotFoundException } from "@nestjs/common";
+import { Freight } from "@edr/types";
+
+import { Booking } from "../bookings/entities/booking.entity";
+import {
+  ShippingLineCredit,
+  ShippingLineCreditStatus,
+} from "./entities/shipping-line-credit.entity";
+import { ShippingLineCreditsService } from "./shipping-line-credits.service";
+
+/**
+ * The money path: a shipping line ships without paying, so the debt lives
+ * entirely in these three transitions. Each test below locks one way the debt
+ * could be lost or double-counted.
+ */
+describe("ShippingLineCreditsService", () => {
+  let creditsRepo: {
+    findByIdsForUpdate: jest.Mock;
+    findUnbilled: jest.Mock;
+    outstandingFor: jest.Mock;
+    findAllPaginated: jest.Mock;
+  };
+  let billing: { generateInvoice: jest.Mock };
+  let shippingLines: { findById: jest.Mock; findByUserId: jest.Mock };
+  let dataSource: { transaction: jest.Mock; getRepository: jest.Mock };
+  let mg: {
+    findOne: jest.Mock;
+    getRepository: jest.Mock;
+    update: jest.Mock;
+  };
+  let txRepo: { findOne: jest.Mock; save: jest.Mock; create: jest.Mock };
+  let updateResult: { affected: number };
+  let service: ShippingLineCreditsService;
+
+  const booking = {
+    id: "booking-1",
+    reference: "BK-2026-000001",
+    shippingLineCompanyId: "sl-1",
+  } as Booking;
+
+  beforeEach(() => {
+    txRepo = {
+      findOne: jest.fn().mockResolvedValue(null),
+      create: jest.fn((v) => v),
+      save: jest.fn(async (v) => ({ id: "credit-1", ...v })),
+    };
+    mg = {
+      findOne: jest.fn().mockResolvedValue(booking),
+      getRepository: jest.fn(() => txRepo),
+      update: jest.fn().mockResolvedValue({ affected: 1 }),
+    };
+    updateResult = { affected: 2 };
+    dataSource = {
+      transaction: jest.fn(async (cb) => cb(mg)),
+      getRepository: jest.fn(() => ({
+        update: jest.fn().mockResolvedValue(updateResult),
+      })),
+    };
+    creditsRepo = {
+      findByIdsForUpdate: jest.fn(),
+      findUnbilled: jest.fn(),
+      outstandingFor: jest.fn(),
+      findAllPaginated: jest.fn(),
+    };
+    billing = {
+      generateInvoice: jest.fn().mockResolvedValue({
+        id: "inv-1",
+        invoiceNumber: "INV-20260813-00001",
+        totalAmount: 50000,
+      }),
+    };
+    shippingLines = {
+      findById: jest.fn().mockResolvedValue({ id: "sl-1", name: "ESL" }),
+      findByUserId: jest.fn(),
+    };
+
+    service = new ShippingLineCreditsService(
+      dataSource as never,
+      creditsRepo as never,
+      // Approvals repo — only the invoice maker–checker paths touch it.
+      {
+        findPendingByInvoice: jest.fn(),
+        findPendingByInvoiceIds: jest.fn().mockResolvedValue([]),
+        findByIdForUpdate: jest.fn(),
+        create: jest.fn(),
+        update: jest.fn(),
+      } as never,
+      billing as never,
+      shippingLines as never,
+    );
+  });
+
+  describe("recordCredit", () => {
+    it("records the charge against the booking's own shipping line", async () => {
+      const credit = await service.recordCredit({
+        bookingId: "booking-1",
+        amount: 20000,
+      });
+
+      expect(txRepo.save).toHaveBeenCalledWith(
+        expect.objectContaining({
+          // Taken from the booking, never from the caller.
+          shippingLineCompanyId: "sl-1",
+          bookingId: "booking-1",
+          amount: 20000,
+          status: ShippingLineCreditStatus.Unbilled,
+        }),
+      );
+      expect(credit.id).toBe("credit-1");
+    });
+
+    it("is idempotent per booking — a retried pricing step cannot double the debt", async () => {
+      const existing = {
+        id: "credit-existing",
+        status: ShippingLineCreditStatus.Unbilled,
+        amount: 20000,
+        currency: "ETB",
+      };
+      txRepo.findOne.mockResolvedValue(existing);
+
+      const credit = await service.recordCredit({
+        bookingId: "booking-1",
+        amount: 20000,
+      });
+
+      expect(credit).toBe(existing);
+      expect(txRepo.save).not.toHaveBeenCalled();
+    });
+
+    it("refuses a customer booking — those are paid up front, not on credit", async () => {
+      mg.findOne.mockResolvedValue({
+        ...booking,
+        shippingLineCompanyId: null,
+      });
+
+      await expect(
+        service.recordCredit({ bookingId: "booking-1", amount: 100 }),
+      ).rejects.toBeInstanceOf(BadRequestException);
+    });
+
+    it("rejects a negative amount", async () => {
+      await expect(
+        service.recordCredit({ bookingId: "booking-1", amount: -1 }),
+      ).rejects.toBeInstanceOf(BadRequestException);
+    });
+  });
+
+  describe("generateInvoice", () => {
+    const unbilled = (id: string, amount: number) => ({
+      id,
+      shippingLineCompanyId: "sl-1",
+      bookingId: `booking-${id}`,
+      amount,
+      currency: "ETB",
+      status: ShippingLineCreditStatus.Unbilled,
+      description: `Freight service — ${id}`,
+    });
+
+    it("bills the batch as one invoice and flips the credits to BILLED", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([
+        unbilled("c1", 20000),
+        unbilled("c2", 30000),
+      ]);
+
+      const invoice = await service.generateInvoice(["c1", "c2"]);
+
+      expect(billing.generateInvoice).toHaveBeenCalledWith(
+        expect.objectContaining({
+          source: Freight.InvoiceSource.ShippingLineCredit,
+          // The payer, not a customer — invoices.company_id stays null.
+          shippingLineCompanyId: "sl-1",
+          sourceId: "sl-1",
+          status: Freight.InvoiceStatus.Issued,
+          lines: [
+            expect.objectContaining({ amount: 20000 }),
+            expect.objectContaining({ amount: 30000 }),
+          ],
+        }),
+        mg,
+      );
+      expect(mg.update).toHaveBeenCalledWith(
+        ShippingLineCredit,
+        expect.anything(),
+        expect.objectContaining({
+          status: ShippingLineCreditStatus.Billed,
+          invoiceId: "inv-1",
+        }),
+      );
+      expect(invoice.id).toBe("inv-1");
+    });
+
+    it("refuses to bill a credit that is already on an invoice", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([
+        { ...unbilled("c1", 20000), status: ShippingLineCreditStatus.Billed },
+      ]);
+
+      await expect(service.generateInvoice(["c1"])).rejects.toBeInstanceOf(
+        BadRequestException,
+      );
+      expect(billing.generateInvoice).not.toHaveBeenCalled();
+    });
+
+    it("refuses to mix two shipping lines on one invoice", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([
+        unbilled("c1", 20000),
+        { ...unbilled("c2", 30000), shippingLineCompanyId: "sl-2" },
+      ]);
+
+      await expect(
+        service.generateInvoice(["c1", "c2"]),
+      ).rejects.toBeInstanceOf(BadRequestException);
+      expect(billing.generateInvoice).not.toHaveBeenCalled();
+    });
+
+    it("refuses to mix currencies", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([
+        unbilled("c1", 20000),
+        { ...unbilled("c2", 300), currency: "USD" },
+      ]);
+
+      await expect(
+        service.generateInvoice(["c1", "c2"]),
+      ).rejects.toBeInstanceOf(BadRequestException);
+    });
+
+    it("reports ids that do not exist rather than silently billing the rest", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([unbilled("c1", 20000)]);
+
+      await expect(
+        service.generateInvoice(["c1", "missing"]),
+      ).rejects.toBeInstanceOf(NotFoundException);
+    });
+
+    it("rejects an empty selection", async () => {
+      await expect(service.generateInvoice([])).rejects.toBeInstanceOf(
+        BadRequestException,
+      );
+    });
+  });
+
+  describe("onInvoicePaid", () => {
+    it("clears every billed credit on the settled invoice", async () => {
+      const update = jest.fn().mockResolvedValue({ affected: 2 });
+      dataSource.getRepository = jest.fn(() => ({ update }));
+
+      await service.onInvoicePaid({
+        invoiceId: "inv-1",
+        invoiceNumber: "INV-20260813-00001",
+      } as never);
+
+      expect(update).toHaveBeenCalledWith(
+        // Scoped to BILLED so a redelivered webhook cannot re-stamp paidAt.
+        { invoiceId: "inv-1", status: ShippingLineCreditStatus.Billed },
+        expect.objectContaining({ status: ShippingLineCreditStatus.Paid }),
+      );
+    });
+
+    it("is a no-op on webhook redelivery", async () => {
+      const update = jest.fn().mockResolvedValue({ affected: 0 });
+      dataSource.getRepository = jest.fn(() => ({ update }));
+
+      await expect(
+        service.onInvoicePaid({
+          invoiceId: "inv-1",
+          invoiceNumber: "INV-1",
+        } as never),
+      ).resolves.toBeUndefined();
+    });
+  });
+
+  describe("cancelCredit", () => {
+    it("writes off an unbilled credit", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([
+        { id: "c1", status: ShippingLineCreditStatus.Unbilled },
+      ]);
+
+      const result = await service.cancelCredit("c1", "Booking voided");
+
+      expect(result.status).toBe(ShippingLineCreditStatus.Cancelled);
+      expect(mg.update).toHaveBeenCalledWith(
+        ShippingLineCredit,
+        { id: "c1" },
+        expect.objectContaining({
+          status: ShippingLineCreditStatus.Cancelled,
+          cancellationReason: "Booking voided",
+        }),
+      );
+    });
+
+    it("refuses to write off a credit already on an invoice", async () => {
+      creditsRepo.findByIdsForUpdate.mockResolvedValue([
+        {
+          id: "c1",
+          status: ShippingLineCreditStatus.Billed,
+          invoiceId: "inv-1",
+        },
+      ]);
+
+      await expect(
+        service.cancelCredit("c1", "oops"),
+      ).rejects.toBeInstanceOf(BadRequestException);
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.service.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.service.ts
new file mode 100644
index 000000000..2fffc4c2e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-credits.service.ts
@@ -0,0 +1,780 @@
+import { logCtx } from "@edr/api-common";
+import { Freight } from "@edr/types";
+import {
+  BadRequestException,
+  ForbiddenException,
+  Injectable,
+  Logger,
+  NotFoundException,
+} from "@nestjs/common";
+import { OnEvent } from "@nestjs/event-emitter";
+import { DataSource, EntityManager, In } from "typeorm";
+
+import {
+  BillingService,
+  InvoiceEventPayload,
+  InvoiceLineInput,
+} from "../billing/billing.service";
+import { Invoice } from "../billing/entities/invoice.entity";
+import { Booking } from "../bookings/entities/booking.entity";
+import {
+  ShippingLineCredit,
+  ShippingLineCreditStatus,
+} from "./entities/shipping-line-credit.entity";
+import {
+  ShippingLineInvoiceApproval,
+  ShippingLineInvoiceActionStatus,
+  ShippingLineInvoiceActionType,
+} from "./entities/shipping-line-invoice-approval.entity";
+import { ShippingLineCreditsRepository } from "./shipping-line-credits.repository";
+import { ShippingLineInvoiceApprovalsRepository } from "./shipping-line-invoice-approvals.repository";
+import { ShippingLineCompany } from "./entities/shipping-line-company.entity";
+import { ShippingLineCompaniesService } from "./shipping-line-companies.service";
+
+/** A charge to record against a shipping line's booking. */
+export interface RecordCreditInput {
+  bookingId: string;
+  /** Frozen at this value; never recalculated afterwards. */
+  amount: number;
+  currency?: string;
+  description?: string;
+}
+
+/** Payment terms for a generated shipping-line invoice. */
+export interface GenerateCreditInvoiceOptions {
+  /** Pay window in days; defaults to the billing module's own default. */
+  dueInDays?: number;
+}
+
+/**
+ * Emitted by the booking-transition accept path for shipping-line bookings.
+ * An event rather than a service call: BookingsModule cannot import the
+ * shipping-line modules without closing a module cycle.
+ */
+export interface ShippingLineBookingAcceptedPayload {
+  bookingId: string;
+  reference: string;
+  /** The booking's priced total, frozen at completion time. */
+  amount: number;
+}
+
+/**
+ * The credit ledger for shipping lines — "use the service now, pay later".
+ *
+ * Three moments, in order:
+ *
+ * 1. **Charge.** A shipping line's booking is priced, and
+ *    {@link recordCredit} writes an UNBILLED credit. No invoice, no payment
+ *    intent, no gate on the booking — it proceeds regardless.
+ * 2. **Bill.** Finance picks a batch of unbilled credits for ONE line and
+ *    {@link generateInvoice} turns them into a single invoice, one line per
+ *    credit. The credits become BILLED.
+ * 3. **Settle.** The line pays that invoice through the ordinary CBE flow.
+ *    Billing emits `shipping_line_credit.invoice.paid`, {@link onInvoicePaid}
+ *    marks the batch PAID, and the debt disappears.
+ *
+ * Nothing here decrements a balance: the amount owed is always
+ * `SUM(amount)` over non-terminal credits. Payment is settled by the gateway
+ * webhook alone — no manual approval step — so a credit only ever leaves debt
+ * because real money arrived.
+ */
+@Injectable()
+export class ShippingLineCreditsService {
+  private readonly logger = new Logger(ShippingLineCreditsService.name);
+
+  constructor(
+    private readonly dataSource: DataSource,
+    private readonly credits: ShippingLineCreditsRepository,
+    private readonly approvals: ShippingLineInvoiceApprovalsRepository,
+    private readonly billing: BillingService,
+    private readonly shippingLines: ShippingLineCompaniesService,
+  ) {}
+
+  // ── 1. Charge ──────────────────────────────────────────────────────────────
+
+  /**
+   * Record what a shipping line owes for one booking.
+   *
+   * Called when the booking is priced. The owner is read off the booking
+   * itself rather than passed in, so a credit can never be filed against the
+   * wrong line. Idempotent per booking: a second call returns the existing
+   * credit untouched rather than doubling the debt — safe against a retried
+   * pricing step, and the partial unique index backs it at the DB level.
+   *
+   * Pass `manager` to enlist in the caller's transaction, so the credit and
+   * whatever priced the booking commit together.
+   */
+  async recordCredit(
+    input: RecordCreditInput,
+    manager?: EntityManager,
+  ): Promise<ShippingLineCredit> {
+    if (!(input.amount >= 0)) {
+      throw new BadRequestException("Credit amount cannot be negative.");
+    }
+
+    const run = async (mg: EntityManager): Promise<ShippingLineCredit> => {
+      const booking = await mg.findOne(Booking, {
+        where: { id: input.bookingId },
+      });
+      if (!booking) {
+        throw new NotFoundException(`Booking ${input.bookingId} not found`);
+      }
+      if (!booking.shippingLineCompanyId) {
+        throw new BadRequestException(
+          `Booking ${booking.reference} is not a shipping-line booking — customer bookings are billed up front, not on credit.`,
+        );
+      }
+
+      const repo = mg.getRepository(ShippingLineCredit);
+      const existing = await repo.findOne({
+        where: { bookingId: input.bookingId },
+      });
+      if (existing && existing.status !== ShippingLineCreditStatus.Cancelled) {
+        this.logger.warn(
+          `Credit already exists for booking ${booking.reference} (${existing.status}, ${existing.amount} ${existing.currency}) — leaving it unchanged.`,
+        );
+        return existing;
+      }
+
+      const credit = await repo.save(
+        repo.create({
+          shippingLineCompanyId: booking.shippingLineCompanyId,
+          bookingId: input.bookingId,
+          amount: input.amount,
+          currency: input.currency ?? "ETB",
+          description:
+            input.description ?? `Freight service — booking ${booking.reference}`,
+          status: ShippingLineCreditStatus.Unbilled,
+        }),
+      );
+
+      logCtx(
+        {
+          creditId: credit.id,
+          bookingId: credit.bookingId,
+          shippingLineCompanyId: credit.shippingLineCompanyId,
+          amount: credit.amount,
+        },
+        { path: "shippingLineCredit.recorded" },
+      );
+
+      return credit;
+    };
+
+    return manager ? run(manager) : this.dataSource.transaction(run);
+  }
+
+  /**
+   * The moment a shipping-line booking becomes debt: Operations accepted it.
+   * Swallows its own failures with a loud log instead of throwing — the accept
+   * has already committed, and failing the staff response for a ledger write
+   * would present a succeeded accept as an error. `recordCredit` is idempotent
+   * per booking, so a re-accepted (previously reverted) booking cannot double
+   * the debt.
+   */
+  @OnEvent("shipping_line_booking.accepted")
+  async onBookingAccepted(
+    payload: ShippingLineBookingAcceptedPayload,
+  ): Promise<void> {
+    try {
+      await this.recordCredit({
+        bookingId: payload.bookingId,
+        amount: payload.amount,
+        // Shipping lines are always billed in ETB (enforced at completion).
+        currency: "ETB",
+      });
+    } catch (err) {
+      this.logger.error(
+        `Failed to record credit for accepted shipping-line booking ${payload.reference} (${payload.bookingId}): ${(err as Error).message} — the debt is NOT on the ledger; record it manually or re-trigger.`,
+      );
+    }
+  }
+
+  // ── 2. Bill ────────────────────────────────────────────────────────────────
+
+  /**
+   * Turn a batch of unbilled credits into one invoice.
+   *
+   * Every credit must belong to the SAME shipping line — one invoice has one
+   * payer, so a mixed batch is rejected rather than silently split. The whole
+   * thing runs in one transaction with the credits locked FOR UPDATE, so two
+   * finance users clicking at once cannot bill the same credit twice: the
+   * second transaction blocks, then finds the rows already BILLED and fails.
+   */
+  async generateInvoice(
+    creditIds: string[],
+    options: GenerateCreditInvoiceOptions = {},
+  ): Promise<Invoice> {
+    if (creditIds.length === 0) {
+      throw new BadRequestException(
+        "Select at least one credit to invoice.",
+      );
+    }
+    const uniqueIds = [...new Set(creditIds)];
+
+    return this.dataSource.transaction(async (mg) => {
+      const credits = await this.credits.findByIdsForUpdate(mg, uniqueIds);
+
+      const missing = uniqueIds.filter(
+        (id) => !credits.some((c) => c.id === id),
+      );
+      if (missing.length > 0) {
+        throw new NotFoundException(
+          `Credit(s) not found: ${missing.join(", ")}`,
+        );
+      }
+
+      const alreadyBilled = credits.filter(
+        (c) => c.status !== ShippingLineCreditStatus.Unbilled,
+      );
+      if (alreadyBilled.length > 0) {
+        throw new BadRequestException(
+          `These credits are no longer unbilled and cannot be invoiced: ${alreadyBilled
+            .map((c) => `${c.id} (${c.status})`)
+            .join(", ")}`,
+        );
+      }
+
+      const lineIds = new Set(credits.map((c) => c.shippingLineCompanyId));
+      if (lineIds.size > 1) {
+        throw new BadRequestException(
+          "All selected credits must belong to the same shipping line — one invoice has one payer.",
+        );
+      }
+      const shippingLineCompanyId = credits[0].shippingLineCompanyId;
+
+      const currencies = new Set(credits.map((c) => c.currency));
+      if (currencies.size > 1) {
+        throw new BadRequestException(
+          `Cannot mix currencies on one invoice: ${[...currencies].join(", ")}.`,
+        );
+      }
+      const currency = credits[0].currency;
+
+      const shippingLine = await this.shippingLines.findById(
+        shippingLineCompanyId,
+      );
+      if (!shippingLine) {
+        throw new NotFoundException(
+          `Shipping line ${shippingLineCompanyId} not found`,
+        );
+      }
+
+      const lines: InvoiceLineInput[] = credits.map((credit) => ({
+        chargeType: "SHIPPING_LINE_SERVICE",
+        description: credit.description ?? undefined,
+        quantity: 1,
+        unitRate: Number(credit.amount),
+        amount: Number(credit.amount),
+        currency: credit.currency,
+        metadata: { creditId: credit.id, bookingId: credit.bookingId },
+      }));
+
+      const invoice = await this.billing.generateInvoice(
+        {
+          source: Freight.InvoiceSource.ShippingLineCredit,
+          // Unlike other sources this is the payer, not a single billed
+          // record: the invoice spans many bookings, and each credit keeps its
+          // own booking link.
+          sourceId: shippingLineCompanyId,
+          type: "SHIPPING_LINE_CREDIT",
+          shippingLineCompanyId,
+          currency,
+          lines,
+          dueInDays: options.dueInDays,
+          status: Freight.InvoiceStatus.Issued,
+        },
+        mg,
+      );
+
+      const billedAt = new Date();
+      await mg.update(
+        ShippingLineCredit,
+        { id: In(credits.map((c) => c.id)) },
+        {
+          status: ShippingLineCreditStatus.Billed,
+          invoiceId: invoice.id,
+          billedAt,
+        },
+      );
+
+      logCtx(
+        {
+          invoiceId: invoice.id,
+          invoiceNumber: invoice.invoiceNumber,
+          shippingLineCompanyId,
+          creditCount: credits.length,
+          totalAmount: invoice.totalAmount,
+        },
+        { path: "shippingLineCredit.invoiced" },
+      );
+
+      return invoice;
+    });
+  }
+
+  // ── 3. Settle ──────────────────────────────────────────────────────────────
+
+  /**
+   * Clear the batch once its invoice is paid.
+   *
+   * Driven by the billing event rather than a call inside the payment path, so
+   * the CBE webhook flow needs no knowledge of credits: whatever settles the
+   * invoice — gateway webhook, or a finance-recorded offline payment — this
+   * fires. Idempotent, because a redelivered webhook re-emits the event.
+   */
+  @OnEvent("shipping_line_credit.invoice.paid")
+  async onInvoicePaid(payload: InvoiceEventPayload): Promise<void> {
+    const result = await this.dataSource
+      .getRepository(ShippingLineCredit)
+      .update(
+        {
+          invoiceId: payload.invoiceId,
+          status: ShippingLineCreditStatus.Billed,
+        },
+        { status: ShippingLineCreditStatus.Paid, paidAt: new Date() },
+      );
+
+    logCtx(
+      {
+        invoiceId: payload.invoiceId,
+        invoiceNumber: payload.invoiceNumber,
+        creditsCleared: result.affected ?? 0,
+      },
+      { path: "shippingLineCredit.settled" },
+    );
+
+    // Zero is the ordinary idempotent no-op on webhook redelivery. It is only
+    // worth a line in the log, not an error: the invoice is paid either way.
+    if (!result.affected) {
+      this.logger.log(
+        `Invoice ${payload.invoiceNumber} paid — no BILLED credits left to clear (already settled).`,
+      );
+    }
+  }
+
+  // ── Reads ──────────────────────────────────────────────────────────────────
+
+  /** Finance's worklist: what can go on an invoice for this line right now. */
+  async listUnbilled(shippingLineCompanyId: string) {
+    await this.requireShippingLine(shippingLineCompanyId);
+    const credits = await this.credits.findUnbilled(shippingLineCompanyId);
+    return {
+      items: credits,
+      totalAmount: credits.reduce((sum, c) => sum + Number(c.amount), 0),
+      currency: credits[0]?.currency ?? "ETB",
+    };
+  }
+
+  /** The debt figure shown on the shipping-line detail page. */
+  async outstanding(shippingLineCompanyId: string) {
+    await this.requireShippingLine(shippingLineCompanyId);
+    return this.credits.outstandingFor(shippingLineCompanyId);
+  }
+
+  /**
+   * Back-office overview: outstanding totals across every line, or one line
+   * when an id is given.
+   */
+  async summary(shippingLineCompanyId?: string) {
+    if (shippingLineCompanyId) {
+      await this.requireShippingLine(shippingLineCompanyId);
+    }
+    return this.credits.outstandingFor(shippingLineCompanyId);
+  }
+
+  /**
+   * The whole ledger across every shipping line, newest first — finance's
+   * landing list. Optionally narrowed to one line and/or one status.
+   */
+  async listAll(
+    page = 1,
+    pageSize = 20,
+    status?: ShippingLineCreditStatus,
+    shippingLineCompanyId?: string,
+  ) {
+    if (shippingLineCompanyId) {
+      await this.requireShippingLine(shippingLineCompanyId);
+    }
+    const [items, total] = await this.credits.findAllPaginated(
+      shippingLineCompanyId,
+      (page - 1) * pageSize,
+      pageSize,
+      status,
+    );
+    return { items, total, page, pageSize };
+  }
+
+  /** Full ledger for one line, newest first. */
+  async listCredits(
+    shippingLineCompanyId: string,
+    page = 1,
+    pageSize = 20,
+    status?: ShippingLineCreditStatus,
+  ) {
+    await this.requireShippingLine(shippingLineCompanyId);
+    const [items, total] = await this.credits.findAllPaginated(
+      shippingLineCompanyId,
+      (page - 1) * pageSize,
+      pageSize,
+      status,
+    );
+    return { items, total, page, pageSize };
+  }
+
+  /**
+   * The signed-in shipping line's own statement: what it owes and why.
+   * Resolves the line from the session, so one line can never read another's.
+   */
+  async myStatement(userId: string, page = 1, pageSize = 20) {
+    const shippingLine = await this.shippingLines.findByUserId(userId);
+    if (!shippingLine) {
+      throw new ForbiddenException("This account is not a shipping line.");
+    }
+    const [outstanding, ledger] = await Promise.all([
+      this.credits.outstandingFor(shippingLine.id),
+      this.credits.findAllPaginated(
+        shippingLine.id,
+        (page - 1) * pageSize,
+        pageSize,
+      ),
+    ]);
+    return {
+      outstanding,
+      items: ledger[0],
+      total: ledger[1],
+      page,
+      pageSize,
+    };
+  }
+
+  // ── Credit invoices: list + maker–checker manual actions ─────────────────
+
+  /**
+   * Staff list of the invoices minted from credit batches, each with its line
+   * name and any undecided manual-action request attached — the data the
+   * back-office actions column renders from.
+   */
+  async listCreditInvoices(
+    page = 1,
+    pageSize = 20,
+    status?: Freight.InvoiceStatus,
+    shippingLineCompanyId?: string,
+  ) {
+    const [invoices, total] = await this.dataSource
+      .getRepository(Invoice)
+      .findAndCount({
+        where: {
+          source: Freight.InvoiceSource.ShippingLineCredit,
+          ...(status ? { status } : {}),
+          ...(shippingLineCompanyId ? { shippingLineCompanyId } : {}),
+        },
+        order: { createdAt: "DESC" },
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      });
+
+    const lineIds = [
+      ...new Set(
+        invoices
+          .map((inv) => inv.shippingLineCompanyId)
+          .filter((id): id is string => !!id),
+      ),
+    ];
+    const lines = lineIds.length
+      ? await this.dataSource
+          .getRepository(ShippingLineCompany)
+          .find({ where: { id: In(lineIds) } })
+      : [];
+    const nameById = new Map(lines.map((l) => [l.id, l.name]));
+
+    const pending = await this.approvals.findPendingByInvoiceIds(
+      invoices.map((inv) => inv.id),
+    );
+    const pendingByInvoice = new Map(pending.map((p) => [p.invoiceId, p]));
+
+    return {
+      items: invoices.map((inv) => ({
+        ...inv,
+        shippingLineName: inv.shippingLineCompanyId
+          ? (nameById.get(inv.shippingLineCompanyId) ?? null)
+          : null,
+        pendingAction: pendingByInvoice.get(inv.id) ?? null,
+      })),
+      total,
+      page,
+      pageSize,
+    };
+  }
+
+  /** Undecided requests for a batch of invoices — feeds any invoice list. */
+  async pendingInvoiceActions(
+    invoiceIds: string[],
+  ): Promise<ShippingLineInvoiceApproval[]> {
+    // Bounded to a list page's worth of ids; anything larger is a misuse.
+    return this.approvals.findPendingByInvoiceIds(invoiceIds.slice(0, 100));
+  }
+
+  /**
+   * Finance raises a manual action on a credit invoice: record an offline
+   * payment (MARK_PAID) or void it (CANCEL). Nothing happens to the invoice
+   * yet — a chief with the matching approve permission decides it. One
+   * undecided request per invoice (backed by a partial unique index).
+   */
+  async requestInvoiceAction(
+    invoiceId: string,
+    action: ShippingLineInvoiceActionType,
+    requestedBy: string,
+    reason: string,
+    paymentReference?: string,
+  ): Promise<ShippingLineInvoiceApproval> {
+    const invoice = await this.dataSource
+      .getRepository(Invoice)
+      .findOne({ where: { id: invoiceId } });
+    if (!invoice) {
+      throw new NotFoundException(`Invoice ${invoiceId} not found`);
+    }
+    if (invoice.source !== Freight.InvoiceSource.ShippingLineCredit) {
+      throw new BadRequestException(
+        "Manual actions here apply only to shipping-line credit invoices.",
+      );
+    }
+    // Fast feedback only — the billing service re-validates authoritatively
+    // (under lock) when the request is approved.
+    if (
+      action === ShippingLineInvoiceActionType.MarkPaid &&
+      invoice.status === Freight.InvoiceStatus.Paid
+    ) {
+      throw new BadRequestException("Invoice is already paid.");
+    }
+    if (invoice.status === Freight.InvoiceStatus.Cancelled) {
+      throw new BadRequestException("Invoice is already cancelled.");
+    }
+    if (
+      action === ShippingLineInvoiceActionType.Cancel &&
+      Number(invoice.paidAmount) > 0
+    ) {
+      throw new BadRequestException(
+        "Cannot cancel an invoice that has payments recorded against it.",
+      );
+    }
+    const existing = await this.approvals.findPendingByInvoice(invoiceId);
+    if (existing) {
+      throw new BadRequestException(
+        `A ${existing.action} request is already awaiting decision on this invoice.`,
+      );
+    }
+
+    const approval = await this.approvals.create({
+      invoiceId,
+      action,
+      status: ShippingLineInvoiceActionStatus.Pending,
+      requestedBy,
+      reason,
+      paymentReference: paymentReference ?? null,
+    });
+
+    logCtx(
+      {
+        approvalId: approval.id,
+        invoiceId,
+        invoiceNumber: invoice.invoiceNumber,
+        action,
+        requestedBy,
+      },
+      { path: "shippingLineCredit.invoiceAction.requested" },
+    );
+
+    return approval;
+  }
+
+  /**
+   * Decide a pending request. Gated purely by permission (the approve/reject
+   * grants on the controller routes) — a decider holding the grant may decide
+   * ANY pending request, their own included; that trade-off is deliberate.
+   *
+   * Approval executes the real action through the billing service AFTER the
+   * decision row commits — its settlement/cancellation events must fire from
+   * billing's own committed transaction (the credits listeners react to
+   * them). If billing then rejects the action, the decision is compensated
+   * back to PENDING so the request is not silently lost.
+   */
+  async decideInvoiceAction(
+    approvalId: string,
+    decidedBy: string,
+    approve: boolean,
+    note?: string,
+  ): Promise<ShippingLineInvoiceApproval> {
+    if (!approve && !note?.trim()) {
+      throw new BadRequestException(
+        "A note is required when rejecting a request.",
+      );
+    }
+
+    const decided = await this.dataSource.transaction(async (mg) => {
+      const approval = await this.approvals.findByIdForUpdate(mg, approvalId);
+      if (!approval) {
+        throw new NotFoundException(`Request ${approvalId} not found`);
+      }
+      if (approval.status !== ShippingLineInvoiceActionStatus.Pending) {
+        throw new BadRequestException(
+          `This request was already ${approval.status.toLowerCase()}.`,
+        );
+      }
+
+      const status = approve
+        ? ShippingLineInvoiceActionStatus.Approved
+        : ShippingLineInvoiceActionStatus.Rejected;
+      await mg.update(
+        ShippingLineInvoiceApproval,
+        { id: approvalId },
+        {
+          status,
+          decidedBy,
+          decidedAt: new Date(),
+          decisionNote: note ?? null,
+        },
+      );
+      return { ...approval, status, decidedBy, decisionNote: note ?? null };
+    });
+
+    if (!approve) {
+      logCtx(
+        { approvalId, invoiceId: decided.invoiceId, decidedBy },
+        { path: "shippingLineCredit.invoiceAction.rejected" },
+      );
+      return decided;
+    }
+
+    try {
+      if (decided.action === ShippingLineInvoiceActionType.MarkPaid) {
+        const invoice = await this.dataSource
+          .getRepository(Invoice)
+          .findOne({ where: { id: decided.invoiceId } });
+        if (!invoice) {
+          throw new NotFoundException(`Invoice ${decided.invoiceId} not found`);
+        }
+        // Full settlement of the outstanding balance; billing emits
+        // `shipping_line_credit.invoice.paid`, which marks the credits PAID.
+        await this.billing.recordPayment(decided.invoiceId, {
+          amount: Number(invoice.balanceAmount ?? invoice.totalAmount),
+          method: "OFFLINE",
+          reference: decided.paymentReference ?? undefined,
+          metadata: {
+            approvalId: decided.id,
+            requestedBy: decided.requestedBy,
+            approvedBy: decidedBy,
+          },
+        });
+      } else {
+        // Billing emits `shipping_line_credit.invoice.cancelled`;
+        // onInvoiceCancelled releases the credits back to the unbilled pool.
+        await this.billing.cancelInvoice(decided.invoiceId);
+      }
+    } catch (err) {
+      // The action was refused (state changed since the request — e.g. the
+      // line paid through CBE in the meantime). Put the request back so it is
+      // not recorded as approved-but-unexecuted.
+      await this.approvals.update(approvalId, {
+        status: ShippingLineInvoiceActionStatus.Pending,
+        decidedBy: null,
+        decidedAt: null,
+        decisionNote: null,
+      });
+      throw err;
+    }
+
+    logCtx(
+      {
+        approvalId,
+        invoiceId: decided.invoiceId,
+        action: decided.action,
+        decidedBy,
+      },
+      { path: "shippingLineCredit.invoiceAction.approved" },
+    );
+
+    return decided;
+  }
+
+  /**
+   * When a credit invoice is cancelled — through the approval flow or any
+   * other billing path — its BILLED credits return to the unbilled pool so
+   * the debt can be re-billed. The debt itself never disappears on invoice
+   * cancellation; only {@link cancelCredit} writes debt off.
+   */
+  @OnEvent("shipping_line_credit.invoice.cancelled")
+  async onInvoiceCancelled(payload: InvoiceEventPayload): Promise<void> {
+    const result = await this.dataSource
+      .getRepository(ShippingLineCredit)
+      .update(
+        {
+          invoiceId: payload.invoiceId,
+          status: ShippingLineCreditStatus.Billed,
+        },
+        {
+          status: ShippingLineCreditStatus.Unbilled,
+          invoiceId: null,
+          billedAt: null,
+        },
+      );
+
+    logCtx(
+      {
+        invoiceId: payload.invoiceId,
+        invoiceNumber: payload.invoiceNumber,
+        creditsReleased: result.affected ?? 0,
+      },
+      { path: "shippingLineCredit.invoiceCancelled.released" },
+    );
+  }
+
+  // ── Cancellation ───────────────────────────────────────────────────────────
+
+  /**
+   * Write off an unbilled credit (booking voided, charge raised in error).
+   * Only UNBILLED credits can be cancelled — once a credit is on an issued
+   * invoice, the invoice is what has to be cancelled or credited, otherwise
+   * the invoice total would stop matching the sum of its lines.
+   */
+  async cancelCredit(
+    creditId: string,
+    reason: string,
+  ): Promise<ShippingLineCredit> {
+    return this.dataSource.transaction(async (mg) => {
+      const [credit] = await this.credits.findByIdsForUpdate(mg, [creditId]);
+      if (!credit) {
+        throw new NotFoundException(`Credit ${creditId} not found`);
+      }
+      if (credit.status !== ShippingLineCreditStatus.Unbilled) {
+        throw new BadRequestException(
+          `Only an unbilled credit can be cancelled; this one is ${credit.status}. Cancel or credit invoice ${credit.invoiceId} instead.`,
+        );
+      }
+
+      await mg.update(
+        ShippingLineCredit,
+        { id: creditId },
+        {
+          status: ShippingLineCreditStatus.Cancelled,
+          cancelledAt: new Date(),
+          cancellationReason: reason,
+        },
+      );
+
+      return { ...credit, status: ShippingLineCreditStatus.Cancelled };
+    });
+  }
+
+  private async requireShippingLine(shippingLineCompanyId: string) {
+    const shippingLine = await this.shippingLines.findById(
+      shippingLineCompanyId,
+    );
+    if (!shippingLine) {
+      throw new NotFoundException(
+        `Shipping line ${shippingLineCompanyId} not found`,
+      );
+    }
+    return shippingLine;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-invoice-approvals.repository.ts b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-invoice-approvals.repository.ts
new file mode 100644
index 000000000..dcd904fa2
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/shipping-lines/shipping-line-invoice-approvals.repository.ts
@@ -0,0 +1,51 @@
+import { BaseRepository } from "@edr/api-common";
+import { Injectable } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { EntityManager, In, Repository } from "typeorm";
+
+import {
+  ShippingLineInvoiceApproval,
+  ShippingLineInvoiceActionStatus,
+} from "./entities/shipping-line-invoice-approval.entity";
+
+@Injectable()
+export class ShippingLineInvoiceApprovalsRepository extends BaseRepository<ShippingLineInvoiceApproval> {
+  constructor(
+    @InjectRepository(ShippingLineInvoiceApproval)
+    private readonly approvals: Repository<ShippingLineInvoiceApproval>,
+  ) {
+    super(approvals);
+  }
+
+  findPendingByInvoice(
+    invoiceId: string,
+  ): Promise<ShippingLineInvoiceApproval | null> {
+    return this.approvals.findOne({
+      where: { invoiceId, status: ShippingLineInvoiceActionStatus.Pending },
+    });
+  }
+
+  /** Pending requests for a page of invoices — one query, no N+1. */
+  findPendingByInvoiceIds(
+    invoiceIds: string[],
+  ): Promise<ShippingLineInvoiceApproval[]> {
+    if (!invoiceIds.length) return Promise.resolve([]);
+    return this.approvals.find({
+      where: {
+        invoiceId: In(invoiceIds),
+        status: ShippingLineInvoiceActionStatus.Pending,
+      },
+    });
+  }
+
+  /** Load one request inside the caller's transaction, locked for decision. */
+  findByIdForUpdate(
+    manager: EntityManager,
+    id: string,
+  ): Promise<ShippingLineInvoiceApproval | null> {
+    return manager.getRepository(ShippingLineInvoiceApproval).findOne({
+      where: { id },
+      lock: { mode: "pessimistic_write" },
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/dto/update-stamp-setting.dto.ts b/apps/edr-freight-api/src/modules/stamp-settings/dto/update-stamp-setting.dto.ts
new file mode 100644
index 000000000..96f86bf61
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/dto/update-stamp-setting.dto.ts
@@ -0,0 +1,9 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsString, MinLength } from "class-validator";
+
+export class UpdateStampSettingDto {
+  @ApiProperty({ description: "Stamp image as a base64 data URL (PNG/JPG)." })
+  @IsString()
+  @MinLength(1)
+  stampImageBase64!: string;
+}
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/entities/stamp-setting.entity.ts b/apps/edr-freight-api/src/modules/stamp-settings/entities/stamp-setting.entity.ts
new file mode 100644
index 000000000..7ab7a0e2c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/entities/stamp-setting.entity.ts
@@ -0,0 +1,24 @@
+import { BaseEntity } from "@edr/api-common";
+import { Column, Entity, JoinColumn, ManyToOne } from "typeorm";
+
+import { FileRecord } from "../../files/entities/file.entity";
+
+/**
+ * Single-row table holding the one company stamp/seal image stamped onto
+ * generated invoice/receipt PDFs (see InvoiceDocumentService). Mirrors the
+ * exchange_settings single-row pattern — `get()` lazily creates the row, and
+ * there is never more than one.
+ */
+@Entity({ schema: "freight", name: "stamp_settings" })
+export class StampSetting extends BaseEntity {
+  @Column({ name: "stamp_file_id", type: "uuid", nullable: true })
+  stampFileId?: string | null;
+
+  @ManyToOne(() => FileRecord, { nullable: true })
+  @JoinColumn({ name: "stamp_file_id" })
+  stampFile?: FileRecord | null;
+
+  /** IAM user id of the last operator to set/clear the stamp. */
+  @Column({ name: "updated_by_id", type: "uuid", nullable: true })
+  updatedById?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.controller.ts b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.controller.ts
new file mode 100644
index 000000000..1ba60139e
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.controller.ts
@@ -0,0 +1,39 @@
+import { Body, Controller, Delete, Get, Put } from "@nestjs/common";
+import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
+import { CurrentUser } from "@edr/api-common";
+import type { TCurrentUser } from "@tria-plc/api-common/modules/auth/types/current-user.type";
+
+import { BookingStaff } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { UpdateStampSettingDto } from "./dto/update-stamp-setting.dto";
+import { StampSettingsService } from "./stamp-settings.service";
+
+@ApiTags("stamp-settings")
+@ApiBearerAuth()
+@Controller("stamp-settings")
+export class StampSettingsController {
+  constructor(private readonly service: StampSettingsService) {}
+
+  @Get()
+  @BookingStaff([FREIGHT_PERMS.settings.stamp.view, FREIGHT_PERMS.admin])
+  @ApiOperation({ summary: "Current company stamp used on invoice/receipt PDFs" })
+  get() {
+    return this.service.getView();
+  }
+
+  @Put()
+  @BookingStaff([FREIGHT_PERMS.settings.stamp.manage, FREIGHT_PERMS.admin])
+  @ApiOperation({ summary: "Replace the company stamp" })
+  update(@Body() dto: UpdateStampSettingDto, @CurrentUser() user: TCurrentUser) {
+    return this.service.setStamp(dto.stampImageBase64, user?.id ?? null);
+  }
+
+  @Delete()
+  @BookingStaff([FREIGHT_PERMS.settings.stamp.manage, FREIGHT_PERMS.admin])
+  @ApiOperation({
+    summary: "Clear the company stamp (invoices fall back to the plain seal)",
+  })
+  clear(@CurrentUser() user: TCurrentUser) {
+    return this.service.clearStamp(user?.id ?? null);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.module.ts b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.module.ts
new file mode 100644
index 000000000..6c9fc3a36
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.module.ts
@@ -0,0 +1,23 @@
+import { Global, Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { FilesModule } from "../files/files.module";
+import { MinioModule } from "../minio/minio.module";
+import { StampSetting } from "./entities/stamp-setting.entity";
+import { StampSettingsController } from "./stamp-settings.controller";
+import { StampSettingsRepository } from "./stamp-settings.repository";
+import { StampSettingsService } from "./stamp-settings.service";
+
+/**
+ * Global so DocumentsModule (invoice PDF rendering) can inject
+ * {@link StampSettingsService} without pulling in a circular billing/warehouse
+ * dependency — same reasoning as ExchangeSettingsModule.
+ */
+@Global()
+@Module({
+  imports: [TypeOrmModule.forFeature([StampSetting]), FilesModule, MinioModule],
+  controllers: [StampSettingsController],
+  providers: [StampSettingsRepository, StampSettingsService],
+  exports: [StampSettingsService],
+})
+export class StampSettingsModule {}
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.repository.ts b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.repository.ts
new file mode 100644
index 000000000..0ca4cfb68
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.repository.ts
@@ -0,0 +1,21 @@
+import { Injectable } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { Repository } from "typeorm";
+import { BaseRepository } from "@edr/api-common";
+
+import { StampSetting } from "./entities/stamp-setting.entity";
+
+@Injectable()
+export class StampSettingsRepository extends BaseRepository<StampSetting> {
+  constructor(
+    @InjectRepository(StampSetting)
+    repo: Repository<StampSetting>,
+  ) {
+    super(repo);
+  }
+
+  /** The single settings row, with its stamp file joined, or null before first upload. */
+  findSingleton(): Promise<StampSetting | null> {
+    return this.repository.findOne({ where: {}, relations: ["stampFile"] });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.service.spec.ts b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.service.spec.ts
new file mode 100644
index 000000000..ef55e9ecc
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.service.spec.ts
@@ -0,0 +1,110 @@
+import { Readable } from "stream";
+
+import { StampSettingsService } from "./stamp-settings.service";
+
+/**
+ * The one global company stamp feeds three document paths (invoices, warehouse
+ * papers, contract signature blocks). All three treat the returned value as a
+ * `data:` URL — so the data-URL-or-null contract of getStampImageUrl is what
+ * these specs pin down, especially its behaviour when MinIO cannot be reached.
+ */
+describe("StampSettingsService.getStampImageUrl", () => {
+  const PNG = Buffer.from("fake-png-bytes");
+  const OBJECT_URL = "https://minio.local:9000/edr-freight/stamp/company.png";
+
+  const build = (
+    overrides: {
+      stampUrl?: string | null;
+      getFileStream?: jest.Mock;
+      findSingleton?: jest.Mock;
+    } = {},
+  ) => {
+    const service = Object.create(
+      StampSettingsService.prototype,
+    ) as StampSettingsService;
+    const warn = jest.fn();
+    Object.assign(service, {
+      logger: { warn, log: jest.fn() },
+      repository: {
+        findSingleton:
+          overrides.findSingleton ??
+          jest.fn().mockResolvedValue({
+            id: "s-1",
+            stampFileId: overrides.stampUrl ? "f-1" : null,
+            stampFile: overrides.stampUrl ? { url: overrides.stampUrl } : null,
+            updatedById: null,
+            updatedAt: null,
+          }),
+        create: jest.fn(),
+        update: jest.fn(),
+      },
+      minioService: {
+        getObjectNameFromUrl: jest.fn().mockReturnValue("stamp/company.png"),
+        getFileStream:
+          overrides.getFileStream ??
+          jest.fn().mockResolvedValue(Readable.from(PNG)),
+      },
+      filesService: { upload: jest.fn() },
+    });
+    return { service, warn };
+  };
+
+  it("inlines the stored stamp as a data URL", async () => {
+    const { service } = build({ stampUrl: OBJECT_URL });
+
+    await expect(service.getStampImageUrl()).resolves.toBe(
+      `data:image/png;base64,${PNG.toString("base64")}`,
+    );
+  });
+
+  it("returns null when no stamp is configured", async () => {
+    const { service } = build({ stampUrl: null });
+
+    await expect(service.getStampImageUrl()).resolves.toBeNull();
+  });
+
+  it("passes an already-inlined data URL straight through", async () => {
+    const dataUrl = "data:image/png;base64,QUJD";
+    const { service } = build({ stampUrl: dataUrl });
+
+    await expect(service.getStampImageUrl()).resolves.toBe(dataUrl);
+  });
+
+  /**
+   * Regression: inlineImageUrl falls back to the raw object URL when MinIO is
+   * unreachable, which is right for getView (a browser can fetch it) but wrong
+   * here. ContractTransitionService base64-decodes this value to snapshot the
+   * seal — and a URL decodes to garbage bytes WITHOUT throwing, so a transient
+   * MinIO failure used to seal an executed contract with a corrupt image file.
+   * Degrade to null instead so callers draw their text/vector seal.
+   */
+  it("returns null rather than a raw object URL when MinIO inlining fails", async () => {
+    const { service, warn } = build({
+      stampUrl: OBJECT_URL,
+      getFileStream: jest.fn().mockRejectedValue(new Error("connect ECONNREFUSED")),
+    });
+
+    await expect(service.getStampImageUrl()).resolves.toBeNull();
+    expect(warn).toHaveBeenCalledWith(expect.stringMatching(/plain seal/i));
+  });
+
+  it("never throws when the settings lookup itself fails", async () => {
+    const { service, warn } = build({
+      findSingleton: jest.fn().mockRejectedValue(new Error("db is down")),
+    });
+
+    await expect(service.getStampImageUrl()).resolves.toBeNull();
+    expect(warn).toHaveBeenCalledWith(expect.stringContaining("db is down"));
+  });
+
+  it("still exposes the raw URL through getView, which a browser can load", async () => {
+    const { service } = build({
+      stampUrl: OBJECT_URL,
+      getFileStream: jest.fn().mockRejectedValue(new Error("connect ECONNREFUSED")),
+    });
+
+    await expect(service.getView()).resolves.toEqual(
+      expect.objectContaining({ stampImageUrl: OBJECT_URL }),
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.service.ts b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.service.ts
new file mode 100644
index 000000000..bfc544f88
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/stamp-settings/stamp-settings.service.ts
@@ -0,0 +1,166 @@
+import { Injectable, Logger } from "@nestjs/common";
+import { Readable } from "stream";
+
+import { FilesService } from "../files/files.service";
+import { MinioService } from "../minio/minio.service";
+import { StampSettingsRepository } from "./stamp-settings.repository";
+import { StampSetting } from "./entities/stamp-setting.entity";
+
+export interface StampSettingView {
+  stampImageUrl: string | null;
+  updatedById: string | null;
+  updatedAt: Date | null;
+}
+
+/**
+ * Owns the single `stamp_settings` row: the one company stamp/seal image used
+ * on generated invoice/receipt PDFs (see InvoiceDocumentService). Same
+ * single-row shape as ExchangeSettingsService, but the value is an uploaded
+ * image (via FilesService) rather than a scalar.
+ */
+@Injectable()
+export class StampSettingsService {
+  private readonly logger = new Logger(StampSettingsService.name);
+
+  constructor(
+    private readonly repository: StampSettingsRepository,
+    private readonly filesService: FilesService,
+    private readonly minioService: MinioService,
+  ) {}
+
+  /** The settings row, created empty on first access. */
+  async get(): Promise<StampSetting> {
+    const existing = await this.repository.findSingleton();
+    if (existing) return existing;
+    return this.repository.create({ stampFileId: null, updatedById: null });
+  }
+
+  /** Current stamp, with the image inlined as a data URL (or null if unset). */
+  async getView(): Promise<StampSettingView> {
+    const setting = await this.get();
+    return {
+      stampImageUrl: await this.inlineImageUrl(setting.stampFile?.url),
+      updatedById: setting.updatedById ?? null,
+      updatedAt: setting.updatedAt ?? null,
+    };
+  }
+
+  /**
+   * The stamp image for embedding into generated documents, ALWAYS as a
+   * `data:` URL or null. Never throws — document generation must succeed even
+   * if the stamp lookup fails; callers fall back to their own seal on null.
+   *
+   * The data-URL-or-null guarantee is load-bearing, not cosmetic: the HTML
+   * render paths inline this value into an <img> that headless Chromium
+   * cannot fetch over the network. So where getView() may hand a raw URL to
+   * a browser that can load it, this degrades to null and lets the caller
+   * draw its text/vector seal instead. (Contract signing no longer consumes
+   * this — staff signatures reference the stampFileId directly.)
+   */
+  async getStampImageUrl(): Promise<string | null> {
+    try {
+      const setting = await this.get();
+      const inlined = await this.inlineImageUrl(setting.stampFile?.url);
+      if (inlined && !inlined.startsWith("data:")) {
+        this.logger.warn(
+          `Company stamp could not be inlined for document rendering (falling back to the plain seal): ${inlined}`,
+        );
+        return null;
+      }
+      return inlined;
+    } catch (err) {
+      this.logger.warn(
+        `Could not load company stamp for PDF rendering: ${(err as Error).message}`,
+      );
+      return null;
+    }
+  }
+
+  /**
+   * Replace the stamp image, storing it in MinIO via FilesService.
+   *
+   * The replaced file is NEVER deleted: contract signatures reference stamp
+   * files by id (ContractTransitionService points staff signatures at the
+   * current stampFileId instead of copying the image), so each retired file
+   * is the immutable record of which seal executed the contracts signed while
+   * it was current. Deleting it would strip the seal off those contracts.
+   */
+  async setStamp(
+    stampImageBase64: string,
+    updatedById?: string | null,
+  ): Promise<StampSettingView> {
+    const current = await this.get();
+
+    const fileRecord = await this.filesService.upload({
+      resourceId: current.id,
+      resource: "stamp_settings",
+      code: "stamp",
+      file: this.toUploadFile(stampImageBase64),
+      uploadedByUserId: updatedById ?? null,
+    });
+
+    await this.repository.update(current.id, {
+      stampFileId: fileRecord.id,
+      updatedById: updatedById ?? null,
+    });
+
+    this.logger.log(`Company stamp updated by ${updatedById ?? "unknown user"}`);
+    return this.getView();
+  }
+
+  /**
+   * Clear the stamp (invoices fall back to the programmatic seal). The file
+   * is kept for the same reason as in {@link setStamp}.
+   */
+  async clearStamp(updatedById?: string | null): Promise<StampSettingView> {
+    const current = await this.get();
+
+    await this.repository.update(current.id, {
+      stampFileId: null,
+      updatedById: updatedById ?? null,
+    });
+
+    return this.getView();
+  }
+
+  private toUploadFile(base64: string): Express.Multer.File {
+    const raw = base64.includes(",") ? base64.split(",")[1]! : base64;
+    const buffer = Buffer.from(raw, "base64");
+    return {
+      fieldname: "stamp",
+      originalname: "company-stamp.png",
+      encoding: "7bit",
+      mimetype: "image/png",
+      size: buffer.length,
+      buffer,
+      stream: Readable.from(buffer),
+      destination: "",
+      filename: "",
+      path: "",
+    };
+  }
+
+  private async inlineImageUrl(url?: string | null): Promise<string | null> {
+    if (!url) return null;
+    if (url.startsWith("data:")) return url;
+    try {
+      const objectName = this.minioService.getObjectNameFromUrl(url);
+      const stream = await this.minioService.getFileStream(objectName);
+      const buffer = await this.streamToBuffer(stream);
+      return `data:image/png;base64,${buffer.toString("base64")}`;
+    } catch {
+      return url;
+    }
+  }
+
+  private streamToBuffer(stream: Readable): Promise<Buffer> {
+    return new Promise((resolve, reject) => {
+      const chunks: Buffer[] = [];
+      stream.on("data", (chunk: Buffer | string) => {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+      });
+      stream.on("error", reject);
+      stream.on("end", () => resolve(Buffer.concat(chunks)));
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/support-content/dto/support-content.dto.ts b/apps/edr-freight-api/src/modules/support-content/dto/support-content.dto.ts
new file mode 100644
index 000000000..64b5bfcb2
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/dto/support-content.dto.ts
@@ -0,0 +1,251 @@
+import { SupportDocSlug } from "@edr/types";
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import {
+  ArrayMaxSize,
+  IsArray,
+  IsObject,
+  IsOptional,
+  IsString,
+  Matches,
+  MaxLength,
+  MinLength,
+  ValidateNested,
+} from "class-validator";
+
+/**
+ * Markdown bodies are safe on read — the portal renders them with
+ * `react-markdown` and no `rehype-raw`, so any HTML in them is inert. The
+ * fields worth validating are these: they land in `href`/`src` attributes and
+ * bypass markdown entirely, which is where a `javascript:` URL would actually
+ * execute.
+ *
+ * Placeholders survive the check because they sit after the scheme
+ * (`mailto:{{supportEmail}}`, `tel:{{supportPhoneTel}}`).
+ */
+const LINK_PATTERN = /^(https?:\/\/|mailto:|tel:|\/)/;
+const LINK_MESSAGE =
+  "$property must start with http(s)://, mailto:, tel: or /";
+
+/* ------------------------------- CONTACT ------------------------------- */
+
+export class PortalSupportContactDto {
+  @ApiProperty()
+  @IsString()
+  @MinLength(3)
+  @MaxLength(200)
+  email!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(3)
+  @MaxLength(60)
+  phone!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(2)
+  @MaxLength(200)
+  office!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(2)
+  @MaxLength(200)
+  hours!: string;
+}
+
+/* ---------------------------- PRIVACY / TERMS --------------------------- */
+
+export class PortalDocSectionDto {
+  @ApiPropertyOptional({ description: "Stable id; generated when omitted" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(64)
+  id?: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(200)
+  heading!: string;
+
+  @ApiProperty({ description: "Markdown" })
+  @IsString()
+  @MaxLength(20_000)
+  body!: string;
+}
+
+export class PortalLegalContentDto {
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(200)
+  title!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MaxLength(500)
+  subtitle!: string;
+
+  @ApiProperty({ description: 'Free text, e.g. "6 August 2026"' })
+  @IsString()
+  @MaxLength(60)
+  lastUpdated!: string;
+
+  @ApiProperty({ type: [PortalDocSectionDto] })
+  @IsArray()
+  @ArrayMaxSize(60)
+  @ValidateNested({ each: true })
+  @Type(() => PortalDocSectionDto)
+  sections!: PortalDocSectionDto[];
+}
+
+/* --------------------------------- FAQ --------------------------------- */
+
+export class PortalCtaCardDto {
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(200)
+  heading!: string;
+
+  @ApiProperty({ description: "Markdown" })
+  @IsString()
+  @MaxLength(2_000)
+  body!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(100)
+  ctaLabel!: string;
+
+  @ApiProperty()
+  @IsString()
+  @Matches(LINK_PATTERN, { message: LINK_MESSAGE })
+  @MaxLength(500)
+  ctaTo!: string;
+}
+
+export class PortalFaqItemDto {
+  @ApiPropertyOptional({ description: "Stable id; generated when omitted" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(64)
+  id?: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(300)
+  question!: string;
+
+  @ApiProperty({ description: "Markdown" })
+  @IsString()
+  @MaxLength(5_000)
+  answer!: string;
+}
+
+export class PortalFaqGroupDto {
+  @ApiPropertyOptional({ description: "Stable id; generated when omitted" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(64)
+  id?: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(200)
+  title!: string;
+
+  @ApiProperty({ type: [PortalFaqItemDto] })
+  @IsArray()
+  @ArrayMaxSize(50)
+  @ValidateNested({ each: true })
+  @Type(() => PortalFaqItemDto)
+  items!: PortalFaqItemDto[];
+}
+
+export class PortalFaqContentDto {
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(200)
+  title!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MaxLength(500)
+  subtitle!: string;
+
+  @ApiProperty({ type: [PortalFaqGroupDto] })
+  @IsArray()
+  @ArrayMaxSize(20)
+  @ValidateNested({ each: true })
+  @Type(() => PortalFaqGroupDto)
+  groups!: PortalFaqGroupDto[];
+
+  @ApiPropertyOptional({ type: PortalCtaCardDto, nullable: true })
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => PortalCtaCardDto)
+  footer?: PortalCtaCardDto | null;
+}
+
+/* --------------------------------- HELP -------------------------------- */
+
+export class PortalHelpContentDto {
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(200)
+  title!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MaxLength(500)
+  subtitle!: string;
+
+  /**
+   * Same section shape as the legal documents — images and videos live inside
+   * the markdown, so a help section needs nothing the others do not have.
+   */
+  @ApiProperty({ type: [PortalDocSectionDto] })
+  @IsArray()
+  @ArrayMaxSize(40)
+  @ValidateNested({ each: true })
+  @Type(() => PortalDocSectionDto)
+  sections!: PortalDocSectionDto[];
+}
+
+/* ------------------------------- request ------------------------------- */
+
+export class UpdateSupportDocumentDto {
+  @ApiProperty({
+    description:
+      "The document's whole payload. Validated against the shape for its slug.",
+    type: Object,
+  })
+  @IsObject()
+  payload!: Record<string, unknown>;
+
+  @ApiPropertyOptional({ description: "Why this change was made" })
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  note?: string;
+}
+
+/** Which DTO class a slug's payload is validated against on write. */
+export const PAYLOAD_DTO_BY_SLUG: Record<
+  SupportDocSlug,
+  new () => object
+> = {
+  CONTACT: PortalSupportContactDto,
+  HELP: PortalHelpContentDto,
+  FAQ: PortalFaqContentDto,
+  PRIVACY: PortalLegalContentDto,
+  TERMS: PortalLegalContentDto,
+};
diff --git a/apps/edr-freight-api/src/modules/support-content/entities/support-document.entity.ts b/apps/edr-freight-api/src/modules/support-content/entities/support-document.entity.ts
new file mode 100644
index 000000000..1b8a1acd7
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/entities/support-document.entity.ts
@@ -0,0 +1,69 @@
+import { BaseEntity } from "@edr/api-common";
+import type { SupportDocPayload, SupportDocSlug } from "@edr/types";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+
+/**
+ * One editable customer-facing document for the freight portal's public pages
+ * (/help, /faq, /terms, /privacy) plus the support contact block they all
+ * quote. Five fixed rows, keyed by slug and seeded on first boot — there is no
+ * create/delete route.
+ *
+ * The payload is opaque jsonb because the five documents have genuinely
+ * different shapes and the help page's blocks keep changing; typed columns
+ * would mean a migration per copy tweak. Shape safety lives in the per-slug
+ * DTOs the service validates against on write, the same arrangement
+ * `contract_templates.articles` already uses.
+ *
+ * `version` is the live row's version and always equals `max(version)` in
+ * {@link SupportDocumentVersion} — the seeder writes v1 and its history row
+ * together, so the log is never missing the current state.
+ */
+@Entity({ schema: "freight", name: "support_documents" })
+@Index(["slug"], { unique: true })
+export class SupportDocument extends BaseEntity {
+  @Column({ name: "slug", type: "varchar", length: 32, unique: true })
+  slug!: SupportDocSlug;
+
+  @Column({ name: "payload", type: "jsonb", default: () => "'{}'::jsonb" })
+  payload!: SupportDocPayload;
+
+  @Column({ name: "version", type: "int", default: 1 })
+  version!: number;
+
+  @Column({ name: "updated_by_id", type: "uuid", nullable: true })
+  updatedById?: string | null;
+}
+
+/**
+ * Append-only history of every saved state of a document, written in the same
+ * transaction as the live row. Restoring is not a pointer reset: it re-saves an
+ * old payload through the normal write path, producing a *new* version, so a
+ * restore is itself undoable and the log only ever grows.
+ *
+ * Modelled on {@link CompanyRevision}, but snapshots the whole payload rather
+ * than a field diff — rollback needs the full state, not the delta.
+ */
+@Entity({ schema: "freight", name: "support_document_versions" })
+@Index(["documentId"])
+export class SupportDocumentVersion extends BaseEntity {
+  @Column({ name: "document_id", type: "uuid" })
+  documentId!: string;
+
+  @ManyToOne(() => SupportDocument, { onDelete: "CASCADE" })
+  @JoinColumn({ name: "document_id" })
+  document?: SupportDocument;
+
+  @Column({ name: "version", type: "int" })
+  version!: number;
+
+  @Column({ name: "payload", type: "jsonb" })
+  payload!: SupportDocPayload;
+
+  /** Who saved it. Null for the seeded initial version. */
+  @Column({ name: "actor_id", type: "uuid", nullable: true })
+  actorId?: string | null;
+
+  /** Optional "why" the editor typed, shown in the history list. */
+  @Column({ name: "note", type: "varchar", length: 255, nullable: true })
+  note?: string | null;
+}
diff --git a/apps/edr-freight-api/src/modules/support-content/public-support-content.controller.ts b/apps/edr-freight-api/src/modules/support-content/public-support-content.controller.ts
new file mode 100644
index 000000000..905ebc974
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/public-support-content.controller.ts
@@ -0,0 +1,29 @@
+import { Public } from "@edr/api-common";
+import { Controller, Get, Header } from "@nestjs/common";
+import { ApiOperation, ApiTags } from "@nestjs/swagger";
+
+import { SupportContentService } from "./support-content.service";
+
+/**
+ * The portal's /help, /faq, /terms and /privacy routes are deliberately outside
+ * its auth guard — the sign-up screen links to them before a session exists —
+ * so this read must work with no token. `@Public()` is class-level because that
+ * is the idiom the other genuinely-anonymous controllers here use; without it
+ * the globally registered `JwtGuard` would 401 every anonymous visitor.
+ */
+@ApiTags("support-content")
+@Public()
+@Controller("support-content")
+export class PublicSupportContentController {
+  constructor(private readonly service: SupportContentService) {}
+
+  @Get()
+  // Hit on every anonymous page view, and the copy changes a few times a year.
+  @Header("Cache-Control", "public, max-age=300")
+  @ApiOperation({
+    summary: "Public help, FAQ, legal and support-contact copy for the portal",
+  })
+  getBundle() {
+    return this.service.getBundle();
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/support-content/support-content.controller.ts b/apps/edr-freight-api/src/modules/support-content/support-content.controller.ts
new file mode 100644
index 000000000..218a95985
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/support-content.controller.ts
@@ -0,0 +1,135 @@
+import { CurrentUser } from "@edr/api-common";
+import { SUPPORT_MEDIA_MAX_BYTES } from "@edr/types";
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+  Query,
+  UploadedFile,
+  UseInterceptors,
+} from "@nestjs/common";
+import { FileInterceptor } from "@nestjs/platform-express";
+import {
+  ApiBearerAuth,
+  ApiConsumes,
+  ApiOperation,
+  ApiQuery,
+  ApiTags,
+} from "@nestjs/swagger";
+import type { TCurrentUser } from "@tria-plc/api-common/modules/auth/types/current-user.type";
+
+import { BookingStaff } from "../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
+import { UpdateSupportDocumentDto } from "./dto/support-content.dto";
+import { SupportContentService } from "./support-content.service";
+
+const READ = [
+  FREIGHT_PERMS.settings.supportContent.view,
+  FREIGHT_PERMS.settings.supportContent.manage,
+  FREIGHT_PERMS.admin,
+];
+
+const WRITE = [
+  FREIGHT_PERMS.settings.supportContent.manage,
+  FREIGHT_PERMS.admin,
+];
+
+@ApiTags("support-content")
+@ApiBearerAuth()
+@Controller("support-content")
+export class SupportContentController {
+  constructor(private readonly service: SupportContentService) {}
+
+  /**
+   * Stores a help-page image or video and returns its object key. The editor
+   * saves the key, not the returned URL — see `SupportContentService.uploadMedia`.
+   *
+   * The Multer limit duplicates the service-side type check on purpose: it
+   * stops reading the socket once the part is oversized instead of buffering
+   * the whole thing into memory first.
+   */
+  @Post("media")
+  @BookingStaff(WRITE)
+  @UseInterceptors(
+    FileInterceptor("file", { limits: { fileSize: SUPPORT_MEDIA_MAX_BYTES } }),
+  )
+  @ApiConsumes("multipart/form-data")
+  @ApiOperation({ summary: "Upload an image or video for a help section" })
+  uploadMedia(@UploadedFile() file: Express.Multer.File) {
+    return this.service.uploadMedia(file);
+  }
+
+  /**
+   * Signs one stored key so the editor can preview an already-saved image.
+   * The editor stores `minio:<key>`, never a signed URL, so it needs somewhere
+   * to resolve those refs for display — this is it.
+   */
+  @Get("media-url")
+  @BookingStaff(READ)
+  @ApiQuery({ name: "key", description: "MinIO object key" })
+  @ApiOperation({ summary: "Presigned URL for one stored media key" })
+  mediaUrl(@Query("key") key: string) {
+    return this.service.mediaUrl(key);
+  }
+
+  @Get("documents")
+  @BookingStaff(READ)
+  @ApiOperation({ summary: "List the five portal content documents (no payloads)" })
+  list() {
+    return this.service.list();
+  }
+
+  @Get("documents/:slug")
+  @BookingStaff(READ)
+  @ApiOperation({ summary: "Get one document with its payload" })
+  getBySlug(@Param("slug") slug: string) {
+    return this.service.getBySlug(slug);
+  }
+
+  @Patch("documents/:slug")
+  @BookingStaff(WRITE)
+  @ApiOperation({
+    summary: "Replace a document's payload, recording a new version",
+  })
+  update(
+    @Param("slug") slug: string,
+    @Body() dto: UpdateSupportDocumentDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.service.update(slug, dto, user?.id ?? null);
+  }
+
+  @Get("documents/:slug/versions")
+  @BookingStaff(READ)
+  @ApiOperation({ summary: "Version history, newest first (no payloads)" })
+  listVersions(@Param("slug") slug: string) {
+    return this.service.listVersions(slug);
+  }
+
+  @Get("documents/:slug/versions/:version")
+  @BookingStaff(READ)
+  @ApiOperation({ summary: "One historical version, with its payload" })
+  getVersion(
+    @Param("slug") slug: string,
+    @Param("version", ParseIntPipe) version: number,
+  ) {
+    return this.service.getVersion(slug, version);
+  }
+
+  @Post("documents/:slug/versions/:version/restore")
+  @BookingStaff(WRITE)
+  @ApiOperation({
+    summary: "Restore a version — re-saves it as a new version, never destructive",
+  })
+  restore(
+    @Param("slug") slug: string,
+    @Param("version", ParseIntPipe) version: number,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.service.restore(slug, version, user?.id ?? null);
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/support-content/support-content.module.ts b/apps/edr-freight-api/src/modules/support-content/support-content.module.ts
new file mode 100644
index 000000000..53467153d
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/support-content.module.ts
@@ -0,0 +1,23 @@
+import { Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+
+import { MinioModule } from "../minio/minio.module";
+import {
+  SupportDocument,
+  SupportDocumentVersion,
+} from "./entities/support-document.entity";
+import { PublicSupportContentController } from "./public-support-content.controller";
+import { SupportContentController } from "./support-content.controller";
+import { SupportContentRepository } from "./support-content.repository";
+import { SupportContentService } from "./support-content.service";
+
+@Module({
+  imports: [
+    TypeOrmModule.forFeature([SupportDocument, SupportDocumentVersion]),
+    MinioModule,
+  ],
+  controllers: [PublicSupportContentController, SupportContentController],
+  providers: [SupportContentRepository, SupportContentService],
+  exports: [SupportContentService],
+})
+export class SupportContentModule {}
diff --git a/apps/edr-freight-api/src/modules/support-content/support-content.repository.ts b/apps/edr-freight-api/src/modules/support-content/support-content.repository.ts
new file mode 100644
index 000000000..eacc28926
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/support-content.repository.ts
@@ -0,0 +1,71 @@
+import { BaseRepository } from "@edr/api-common";
+import type { SupportDocSlug } from "@edr/types";
+import { Injectable } from "@nestjs/common";
+import { InjectRepository } from "@nestjs/typeorm";
+import { Repository } from "typeorm";
+
+import {
+  SupportDocument,
+  SupportDocumentVersion,
+} from "./entities/support-document.entity";
+
+@Injectable()
+export class SupportContentRepository extends BaseRepository<SupportDocument> {
+  constructor(
+    @InjectRepository(SupportDocument)
+    repository: Repository<SupportDocument>,
+    @InjectRepository(SupportDocumentVersion)
+    private readonly versions: Repository<SupportDocumentVersion>,
+  ) {
+    super(repository);
+  }
+
+  findBySlug(slug: SupportDocSlug): Promise<SupportDocument | null> {
+    return this.repository.findOne({ where: { slug } });
+  }
+
+  override findAll(): Promise<SupportDocument[]> {
+    return this.repository.find({ order: { slug: "ASC" } });
+  }
+
+  findVersions(documentId: string): Promise<SupportDocumentVersion[]> {
+    return this.versions.find({
+      where: { documentId },
+      order: { version: "DESC" },
+    });
+  }
+
+  findVersion(
+    documentId: string,
+    version: number,
+  ): Promise<SupportDocumentVersion | null> {
+    return this.versions.findOne({ where: { documentId, version } });
+  }
+
+  /**
+   * Bump the live row and append its history entry atomically. Doing both in
+   * one transaction is what guarantees `document.version` always has a matching
+   * version row — the invariant the history list and rollback both rely on.
+   */
+  async saveWithVersion(
+    document: SupportDocument,
+    actorId: string | null,
+    note: string | null,
+  ): Promise<SupportDocument> {
+    return this.repository.manager.transaction(async (manager) => {
+      const saved = await manager.save(SupportDocument, document);
+
+      await manager.save(
+        manager.create(SupportDocumentVersion, {
+          documentId: saved.id,
+          version: saved.version,
+          payload: saved.payload,
+          actorId,
+          note,
+        }),
+      );
+
+      return saved;
+    });
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/support-content/support-content.service.spec.ts b/apps/edr-freight-api/src/modules/support-content/support-content.service.spec.ts
new file mode 100644
index 000000000..d1d72b397
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/support-content.service.spec.ts
@@ -0,0 +1,230 @@
+import {
+  SUPPORT_CONTENT_DEFAULTS,
+  SUPPORT_DOC_SLUGS,
+  SupportDocPayload,
+  SupportDocSlug,
+} from "@edr/types";
+import { BadRequestException, NotFoundException } from "@nestjs/common";
+
+import { MinioService } from "../minio/minio.service";
+import {
+  SupportDocument,
+  SupportDocumentVersion,
+} from "./entities/support-document.entity";
+import { SupportContentRepository } from "./support-content.repository";
+import { SupportContentService, validatePayload } from "./support-content.service";
+
+const ACTOR = "11111111-1111-4111-8111-111111111111";
+
+/**
+ * In-memory stand-in for the repository: one seeded document plus its version
+ * log, with `saveWithVersion` doing what the real transaction does. Enough to
+ * assert the rollback contract without a database.
+ */
+function makeRepository(slug: SupportDocSlug) {
+  const document = {
+    id: "00000000-0000-0000-0000-000000000001",
+    slug,
+    payload: SUPPORT_CONTENT_DEFAULTS[slug],
+    version: 1,
+    updatedById: null,
+  } as SupportDocument;
+
+  const versions: SupportDocumentVersion[] = [
+    {
+      id: "v1",
+      documentId: document.id,
+      version: 1,
+      payload: document.payload,
+      actorId: null,
+      note: "Initial content",
+    } as SupportDocumentVersion,
+  ];
+
+  const repository = {
+    findAll: jest.fn(async () => [document]),
+    findBySlug: jest.fn(async (s: SupportDocSlug) =>
+      s === slug ? document : null,
+    ),
+    findVersions: jest.fn(async () => [...versions].reverse()),
+    findVersion: jest.fn(
+      async (_id: string, version: number) =>
+        versions.find((v) => v.version === version) ?? null,
+    ),
+    saveWithVersion: jest.fn(
+      async (doc: SupportDocument, actorId: string | null, note: string | null) => {
+        versions.push({
+          id: `v${doc.version}`,
+          documentId: doc.id,
+          version: doc.version,
+          payload: doc.payload,
+          actorId,
+          note,
+        } as SupportDocumentVersion);
+        return doc;
+      },
+    ),
+  };
+
+  // Signing is exercised only through getBundle; the write path never touches it.
+  const minio = {
+    getSignedUrl: jest.fn(async (key: string) => `https://minio.test/${key}?sig=x`),
+    uploadFile: jest.fn(),
+  };
+
+  return {
+    document,
+    versions,
+    minio,
+    service: new SupportContentService(
+      repository as unknown as SupportContentRepository,
+      minio as unknown as MinioService,
+    ),
+  };
+}
+
+describe("SupportContentService.restore", () => {
+  it("rolls back to an older payload as a NEW version, leaving history intact", async () => {
+    const { document, versions, service } = makeRepository("CONTACT");
+    const original = SUPPORT_CONTENT_DEFAULTS.CONTACT;
+
+    await service.update(
+      "CONTACT",
+      { payload: { ...original, phone: "+251 99 999 9999" } },
+      ACTOR,
+    );
+
+    expect(document.version).toBe(2);
+    expect(versions.map((v) => v.version)).toEqual([1, 2]);
+
+    const restored = await service.restore("CONTACT", 1, ACTOR);
+
+    expect(restored.payload).toEqual(original);
+    // The assertion that matters: restore is additive. If someone "optimises"
+    // it into a destructive pointer reset this drops back to 1 and rollback
+    // silently stops being undoable.
+    expect(restored.version).toBe(3);
+    expect(versions.map((v) => v.version)).toEqual([1, 2, 3]);
+    expect(versions[2].note).toBe("Restored version 1");
+  });
+
+  it("404s on a version that was never written", async () => {
+    const { service } = makeRepository("CONTACT");
+    await expect(service.restore("CONTACT", 99, ACTOR)).rejects.toBeInstanceOf(
+      NotFoundException,
+    );
+  });
+
+  it("rejects an unknown slug", async () => {
+    const { service } = makeRepository("CONTACT");
+    await expect(service.getBySlug("NOPE")).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+  });
+});
+
+describe("SupportContentService.getBundle", () => {
+  it("signs stored keys on read and leaves paths and URLs alone", async () => {
+    const { service, minio } = makeRepository("CONTACT");
+    const help = SUPPORT_CONTENT_DEFAULTS.HELP;
+
+    // findAll returns only CONTACT, so HELP falls back to the defaults — which
+    // is itself worth asserting: an unseeded row must not break the page.
+    const bundle = await service.getBundle();
+    // A shipped asset path is not a stored object, so nothing is signed.
+    expect(bundle.help.sections[0].body).toContain(
+      "/assets/edr-portal-guide.webm",
+    );
+    expect(minio.getSignedUrl).not.toHaveBeenCalled();
+
+    const withUpload = {
+      ...help,
+      sections: [
+        {
+          ...help.sections[0],
+          body:
+            "See ![diagram](minio:support-content/d.png) and " +
+            "![clip](minio:support-content/c.mp4).",
+        },
+      ],
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const signed = await (service as any).signMedia({
+      ...bundle,
+      help: withUpload,
+    });
+
+    expect(signed.help.sections[0].body).toContain(
+      "https://minio.test/support-content/d.png?sig=x",
+    );
+    expect(signed.help.sections[0].body).toContain(
+      "https://minio.test/support-content/c.mp4?sig=x",
+    );
+    // The stored copy must never be mutated into a URL — that is what would rot.
+    expect(withUpload.sections[0].body).toContain("minio:support-content/d.png");
+  });
+});
+
+describe("validatePayload", () => {
+  const help = SUPPORT_CONTENT_DEFAULTS.HELP;
+
+  it("accepts every shipped default", () => {
+    for (const slug of SUPPORT_DOC_SLUGS) {
+      expect(() =>
+        validatePayload(slug, SUPPORT_CONTENT_DEFAULTS[slug]),
+      ).not.toThrow();
+    }
+  });
+
+  const sectionWithBody = (body: string) => ({
+    ...help,
+    sections: [{ ...help.sections[0], body }],
+  });
+
+  it("stores embedded media as refs, whatever the scheme", () => {
+    // Media now lives in the markdown, so the API no longer validates its URL
+    // scheme — the portal's renderer does, by dropping anything that is not
+    // http(s)/mailto/tel/relative. These all persist fine.
+    for (const body of [
+      "![](minio:support-content/9f1c.png)",
+      "![](/assets/edr-portal-guide.webm)",
+      "![](https://cdn.example.com/clip.mp4)",
+    ]) {
+      expect(() => validatePayload("HELP", sectionWithBody(body))).not.toThrow();
+    }
+  });
+
+  it("rejects a section body past the cap", () => {
+    expect(() =>
+      validatePayload("HELP", sectionWithBody("x".repeat(20_001))),
+    ).toThrow(BadRequestException);
+  });
+
+  it("rejects an unknown property, which is how a stale payload is caught", () => {
+    expect(() =>
+      validatePayload("HELP", { ...help, channels: [] }),
+    ).toThrow(BadRequestException);
+  });
+
+  it("keeps placeholder links, which sit after the scheme", () => {
+    expect(() =>
+      validatePayload("FAQ", {
+        ...SUPPORT_CONTENT_DEFAULTS.FAQ,
+        footer: {
+          ...SUPPORT_CONTENT_DEFAULTS.FAQ.footer!,
+          ctaTo: "mailto:{{supportEmail}}",
+        },
+      }),
+    ).not.toThrow();
+  });
+
+  it("generates ids for items saved without one", () => {
+    const legal = validatePayload("TERMS", {
+      ...SUPPORT_CONTENT_DEFAULTS.TERMS,
+      sections: [{ heading: "1. New", body: "Body." }],
+    }) as Extract<SupportDocPayload, { sections: unknown }>;
+
+    expect(legal.sections[0].id).toEqual(expect.any(String));
+    expect(legal.sections[0].id.length).toBeGreaterThan(0);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/support-content/support-content.service.ts b/apps/edr-freight-api/src/modules/support-content/support-content.service.ts
new file mode 100644
index 000000000..11099ae55
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/support-content/support-content.service.ts
@@ -0,0 +1,345 @@
+import {
+  PORTAL_MEDIA_URI_SCHEME,
+  PortalContentBundle,
+  PortalFaqContent,
+  PortalHelpContent,
+  PortalLegalContent,
+  PortalMediaKind,
+  SUPPORT_CONTENT_DEFAULTS,
+  SUPPORT_DOC_SLUGS,
+  SUPPORT_MEDIA_PREFIX,
+  SupportDocPayload,
+  SupportDocSlug,
+} from "@edr/types";
+import {
+  BadRequestException,
+  Injectable,
+  NotFoundException,
+} from "@nestjs/common";
+import { extname } from "path";
+
+import { MinioService } from "../minio/minio.service";
+import { plainToInstance } from "class-transformer";
+import { validateSync, ValidationError } from "class-validator";
+import { randomUUID } from "crypto";
+
+import {
+  PAYLOAD_DTO_BY_SLUG,
+  UpdateSupportDocumentDto,
+} from "./dto/support-content.dto";
+import {
+  SupportDocument,
+  SupportDocumentVersion,
+} from "./entities/support-document.entity";
+import { SupportContentRepository } from "./support-content.repository";
+
+/**
+ * A paste-bomb in one section would bloat the public bundle every anonymous
+ * visitor downloads, so the whole payload is capped as well as its fields.
+ */
+const MAX_PAYLOAD_BYTES = 200_000;
+
+/**
+ * Comfortably longer than the 5-minute `Cache-Control` on the public bundle, so
+ * a cached response never outlives the URLs inside it.
+ */
+const MEDIA_URL_TTL_SECONDS = 6 * 60 * 60;
+
+/** `minio:support-content/<file>` inside markdown. */
+const MEDIA_REF = new RegExp(
+  `${PORTAL_MEDIA_URI_SCHEME}([A-Za-z0-9._\\-/]+)`,
+  "g",
+);
+
+@Injectable()
+export class SupportContentService {
+  constructor(
+    private readonly repository: SupportContentRepository,
+    private readonly minio: MinioService,
+  ) {}
+
+  /**
+   * Stores an image or video for the help page and returns its object key.
+   *
+   * The key is what gets saved in the document — never the signed URL. A
+   * presigned URL expires, so persisting one would leave every embedded image
+   * broken a few hours later; signing happens per read instead.
+   */
+  async uploadMedia(
+    file?: Express.Multer.File,
+  ): Promise<{ key: string; kind: PortalMediaKind; url: string }> {
+    if (!file) throw new BadRequestException("No file uploaded");
+
+    const kind: PortalMediaKind | null = file.mimetype.startsWith("image/")
+      ? "image"
+      : file.mimetype.startsWith("video/")
+        ? "video"
+        : null;
+
+    if (!kind) {
+      throw new BadRequestException(
+        `Unsupported file type ${file.mimetype} — images and videos only`,
+      );
+    }
+
+    const key = `${SUPPORT_MEDIA_PREFIX}${randomUUID()}${extname(file.originalname).toLowerCase()}`;
+    await this.minio.uploadFile(key, file.buffer, file.mimetype);
+
+    return {
+      key,
+      kind,
+      url: await this.minio.getSignedUrl(key, MEDIA_URL_TTL_SECONDS),
+    };
+  }
+
+  /** Presigned URL for one stored key, for the backoffice editor's previews. */
+  async mediaUrl(key: string): Promise<{ url: string }> {
+    if (!key?.startsWith(SUPPORT_MEDIA_PREFIX)) {
+      throw new BadRequestException(
+        `key must be an uploaded ${SUPPORT_MEDIA_PREFIX} object`,
+      );
+    }
+    return { url: await this.minio.getSignedUrl(key, MEDIA_URL_TTL_SECONDS) };
+  }
+
+  /**
+   * The public bundle. Missing rows fall back to the shipped defaults so an
+   * unseeded or half-migrated environment still serves the legal pages rather
+   * than 404-ing the first thing an anonymous visitor sees.
+   */
+  async getBundle(): Promise<PortalContentBundle> {
+    const documents = await this.repository.findAll();
+    const bySlug = new Map(documents.map((d) => [d.slug, d.payload]));
+
+    const payload = <S extends SupportDocSlug>(slug: S) =>
+      (bySlug.get(slug) ?? SUPPORT_CONTENT_DEFAULTS[slug]) as never;
+
+    return this.signMedia({
+      contact: payload("CONTACT"),
+      help: payload("HELP"),
+      faq: payload("FAQ"),
+      privacy: payload("PRIVACY"),
+      terms: payload("TERMS"),
+    });
+  }
+
+  /**
+   * Swaps every `minio:<key>` reference embedded in the copy for a freshly
+   * signed URL. Media lives inside the markdown, so this one pass covers every
+   * document.
+   *
+   * Each distinct key is signed once per request, and a signing failure
+   * degrades to MinIO's public URL rather than failing the whole page (see
+   * `MinioService.getSignedUrl`).
+   */
+  private async signMedia(
+    bundle: PortalContentBundle,
+  ): Promise<PortalContentBundle> {
+    const keys = new Set<string>();
+
+    const collect = (value: unknown): void => {
+      if (typeof value === "string") {
+        for (const match of value.matchAll(MEDIA_REF)) keys.add(match[1]);
+      } else if (Array.isArray(value)) {
+        value.forEach(collect);
+      } else if (value && typeof value === "object") {
+        Object.values(value).forEach(collect);
+      }
+    };
+    collect(bundle);
+
+    if (keys.size === 0) return bundle;
+
+    const signed = new Map(
+      await Promise.all(
+        [...keys].map(
+          async (key) =>
+            [key, await this.minio.getSignedUrl(key, MEDIA_URL_TTL_SECONDS)] as const,
+        ),
+      ),
+    );
+
+    const rewrite = (value: unknown): unknown => {
+      if (typeof value === "string") {
+        return value.replace(MEDIA_REF, (whole, key: string) =>
+          signed.get(key) ?? whole,
+        );
+      }
+      if (Array.isArray(value)) return value.map(rewrite);
+      if (value && typeof value === "object") {
+        return Object.fromEntries(
+          Object.entries(value).map(([k, v]) => [k, rewrite(v)]),
+        );
+      }
+      return value;
+    };
+
+    return rewrite(bundle) as PortalContentBundle;
+  }
+
+  /** Admin list — metadata only, no payloads. */
+  async list(): Promise<Omit<SupportDocument, "payload">[]> {
+    const documents = await this.repository.findAll();
+    return documents.map(({ payload: _payload, ...rest }) => rest);
+  }
+
+  async getBySlug(rawSlug: string): Promise<SupportDocument> {
+    const slug = assertSlug(rawSlug);
+    const document = await this.repository.findBySlug(slug);
+    if (!document) {
+      throw new NotFoundException(`Support document ${slug} not found`);
+    }
+    return document;
+  }
+
+  /**
+   * Replace a document's whole payload. Writing the whole slice rather than
+   * patching fields is deliberate: one editorial change becomes exactly one
+   * version, which is what keeps the history readable.
+   */
+  async update(
+    rawSlug: string,
+    dto: UpdateSupportDocumentDto,
+    actorId: string | null,
+  ): Promise<SupportDocument> {
+    const document = await this.getBySlug(rawSlug);
+    const payload = validatePayload(document.slug, dto.payload);
+
+    document.payload = payload;
+    document.version += 1;
+    document.updatedById = actorId;
+
+    return this.repository.saveWithVersion(document, actorId, dto.note ?? null);
+  }
+
+  async listVersions(rawSlug: string): Promise<SupportDocumentVersion[]> {
+    const document = await this.getBySlug(rawSlug);
+    return this.repository.findVersions(document.id);
+  }
+
+  async getVersion(
+    rawSlug: string,
+    version: number,
+  ): Promise<SupportDocumentVersion> {
+    const document = await this.getBySlug(rawSlug);
+    const found = await this.repository.findVersion(document.id, version);
+    if (!found) {
+      throw new NotFoundException(
+        `Version ${version} of ${document.slug} not found`,
+      );
+    }
+    return found;
+  }
+
+  /**
+   * Roll back to an earlier version by re-saving its payload through the normal
+   * write path. The result is a NEW version whose content equals the old one —
+   * never a destructive pointer reset — so the history only grows and a restore
+   * is itself undoable.
+   */
+  async restore(
+    rawSlug: string,
+    version: number,
+    actorId: string | null,
+  ): Promise<SupportDocument> {
+    const target = await this.getVersion(rawSlug, version);
+
+    return this.update(
+      rawSlug,
+      {
+        payload: target.payload as unknown as Record<string, unknown>,
+        note: `Restored version ${version}`,
+      },
+      actorId,
+    );
+  }
+}
+
+/* ------------------------------ helpers ------------------------------- */
+
+export function assertSlug(raw: string): SupportDocSlug {
+  const slug = raw?.toUpperCase() as SupportDocSlug;
+  if (!SUPPORT_DOC_SLUGS.includes(slug)) {
+    throw new BadRequestException(
+      `Unknown support document "${raw}". Valid slugs: ${SUPPORT_DOC_SLUGS.join(", ")}`,
+    );
+  }
+  return slug;
+}
+
+/**
+ * Validate an incoming payload against the DTO registered for its slug, then
+ * fill in any missing item ids. Exported so the seeder's spec can assert the
+ * shipped defaults are themselves valid.
+ */
+export function validatePayload(
+  slug: SupportDocSlug,
+  raw: unknown,
+): SupportDocPayload {
+  if (JSON.stringify(raw ?? null).length > MAX_PAYLOAD_BYTES) {
+    throw new BadRequestException(
+      `Payload for ${slug} exceeds ${MAX_PAYLOAD_BYTES} bytes`,
+    );
+  }
+
+  const instance = plainToInstance(PAYLOAD_DTO_BY_SLUG[slug], raw ?? {});
+  const errors = validateSync(instance as object, {
+    whitelist: true,
+    forbidNonWhitelisted: true,
+  });
+
+  if (errors.length) {
+    throw new BadRequestException(flattenErrors(errors));
+  }
+
+  return withGeneratedIds(slug, instance as SupportDocPayload);
+}
+
+function flattenErrors(errors: ValidationError[], path = ""): string[] {
+  return errors.flatMap((error) => {
+    const here = path ? `${path}.${error.property}` : error.property;
+    const own = Object.values(error.constraints ?? {}).map(
+      (message) => `${here}: ${message}`,
+    );
+    return [...own, ...flattenErrors(error.children ?? [], here)];
+  });
+}
+
+const withId = <T extends { id?: string }>(item: T): T => ({
+  ...item,
+  id: item.id || randomUUID(),
+});
+
+/**
+ * Item ids are the React keys in the portal, and admin-authored headings and
+ * questions collide too easily to use as keys. Editors may omit them; the
+ * server mints one rather than making every client remember to.
+ */
+function withGeneratedIds(
+  slug: SupportDocSlug,
+  payload: SupportDocPayload,
+): SupportDocPayload {
+  switch (slug) {
+    case "HELP": {
+      const help = payload as PortalHelpContent;
+      return { ...help, sections: help.sections.map(withId) };
+    }
+    case "FAQ": {
+      const faq = payload as PortalFaqContent;
+      return {
+        ...faq,
+        groups: faq.groups.map((group) => ({
+          ...withId(group),
+          items: group.items.map(withId),
+        })),
+      };
+    }
+    case "PRIVACY":
+    case "TERMS": {
+      const legal = payload as PortalLegalContent;
+      return { ...legal, sections: legal.sections.map(withId) };
+    }
+    default:
+      return payload;
+  }
+}
diff --git a/apps/edr-freight-api/src/modules/train-schedules/entities/train-schedule.entity.ts b/apps/edr-freight-api/src/modules/train-schedules/entities/train-schedule.entity.ts
index 5730120e9..393378740 100644
--- a/apps/edr-freight-api/src/modules/train-schedules/entities/train-schedule.entity.ts
+++ b/apps/edr-freight-api/src/modules/train-schedules/entities/train-schedule.entity.ts
@@ -7,6 +7,7 @@ import { Column, Entity, Index, JoinColumn, ManyToOne, OneToMany, OneToOne } fro
 
 import { Yard } from '../../rule-engine/entities/yard.entity';
 import { Route } from '../../routes/entities/route.entity';
+import { ShippingLineCompany } from '../../shipping-lines/entities/shipping-line-company.entity';
 import { TrainSet } from '../../train-sets/entities/train-set.entity';
 import { TrainScheduleBooking } from './train-schedule-booking.entity';
 
@@ -64,6 +65,14 @@ export class TrainSchedule extends BaseEntity {
   @Column({ name: 'train_number', type: 'varchar', length: 20, nullable: true })
   trainNumber?: string | null;
 
+  /**
+   * Voyage (sailing) number for this departure — the identifier yards and
+   * customs quote alongside the train number. Per-departure, so it lives here
+   * rather than on the built train.
+   */
+  @Column({ name: 'voyage_number', type: 'varchar', length: 20, nullable: true })
+  voyageNumber?: string | null;
+
   // Human-facing unique schedule reference (S-YYYY-NNNNN). Shown on the schedule
   // list, booking windows, and load lists. Assigned at creation from the highest
   // sequence issued this year (see TrainSchedulesRepository.maxReferenceSequence).
@@ -73,6 +82,19 @@ export class TrainSchedule extends BaseEntity {
   @Column({ name: 'direction', type: 'varchar', length: 10, nullable: true })
   direction?: string | null;
 
+  /**
+   * Dedicates this departure to one shipping line. NULL = a normal train,
+   * visible to customers as today. Set = the train is HIDDEN from every
+   * customer-facing read (windows, day pools, home cards) and shown only to
+   * this shipping line in its portal.
+   */
+  @Column({ name: 'shipping_line_company_id', type: 'uuid', nullable: true })
+  shippingLineCompanyId?: string | null;
+
+  @ManyToOne(() => ShippingLineCompany)
+  @JoinColumn({ name: 'shipping_line_company_id' })
+  shippingLineCompany?: ShippingLineCompany | null;
+
   /**
    * Reverse the wagon ORDER on this train: when true, the built wagon plan is
    * flipped at build so the physically-last wagon sits at position 1. Only the
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/booking-batch.service.ts b/apps/edr-freight-api/src/modules/train-scheduling/booking-batch.service.ts
index e89c56b2a..cb1958582 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/booking-batch.service.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/booking-batch.service.ts
@@ -17,6 +17,7 @@ import {
   FindOptionsWhere,
   ILike,
   In,
+  IsNull,
   LessThanOrEqual,
   MoreThanOrEqual,
 } from 'typeorm';
@@ -25,6 +26,7 @@ import { Booking } from '../bookings/entities/booking.entity';
 import { BookingsRepository } from '../bookings/bookings.repository';
 import { BookingPricingService } from '../bookings/booking-pricing.service';
 import { formatRouteLabel } from '../routes/entities/route.entity';
+import { isRoadService } from '../bookings/road.util';
 import { RouteMilestone } from '../routes/entities/route-milestone.entity';
 import { Yard } from '../rule-engine/entities/yard.entity';
 import { CargoType } from '../rule-engine/entities/cargo-type.entity';
@@ -37,7 +39,7 @@ import { BookingNotifierService } from './booking-notifier.service';
 import {
   TrainSchedulingService,
   effectiveWindowConfig,
-} from './train-scheduling.service';
+} from './services/train-scheduling.service';
 import { eatDay, listConfigBookingWindows } from './batch-window.util';
 import {
   BATCH_BOARD_STATUSES,
@@ -90,7 +92,7 @@ import { BookingWindowGateway } from './booking-window.gateway';
 import {
   MAX_TEU_SLOTS_PER_WAGON,
   containerWagonsForLines,
-} from './wagon-plan.util';
+} from './utils/wagon-plan.util';
 import {
   Capacity,
   CorridorBudget,
@@ -153,6 +155,19 @@ export interface ExportTrainOption {
   }>;
 }
 
+/** Form-entered cargo for a train-options probe (nothing persisted yet). */
+export interface TrainOptionCargoOverrides {
+  /** Container types drive the per-type space. */
+  containerTypeIds?: string[];
+  /** Size labels ("20ft"/"40ft") when the form has no type ids. */
+  containerSizes?: string[];
+  /** Bulk counterparts of the container inputs. */
+  cargoTypeId?: string;
+  cargoTypeCode?: string;
+  /** Needed wagons estimate from the form (drives the `fits` flag). */
+  wagons?: number;
+}
+
 /** A train a paid-unallocated booking can board (route + capacity verified). */
 export interface AllocationCandidate {
   id: string;
@@ -820,8 +835,9 @@ export class BookingBatchService implements OnModuleInit {
     // stop order, so we fetch the day's open trains without endpoint filters.
     const corridor = await this.trainSchedulesRepository.findAll({
       where: [
-        { status: TrainScheduleStatusEnum.Draft },
-        { status: TrainScheduleStatusEnum.Scheduled },
+        // Dedicated shipping-line trains are never customer-booking targets.
+        { status: TrainScheduleStatusEnum.Draft, shippingLineCompanyId: IsNull() },
+        { status: TrainScheduleStatusEnum.Scheduled, shippingLineCompanyId: IsNull() },
       ],
     });
     // A customer-picked train narrows the scan to that ONE schedule: export
@@ -983,8 +999,9 @@ export class BookingBatchService implements OnModuleInit {
   ): Promise<Array<{ scheduleId: string; departure: Date; freeWagons: number }>> {
     const corridor = await this.trainSchedulesRepository.findAll({
       where: [
-        { status: TrainScheduleStatusEnum.Draft },
-        { status: TrainScheduleStatusEnum.Scheduled },
+        // Dedicated shipping-line trains are never customer-booking targets.
+        { status: TrainScheduleStatusEnum.Draft, shippingLineCompanyId: IsNull() },
+        { status: TrainScheduleStatusEnum.Scheduled, shippingLineCompanyId: IsNull() },
       ],
     });
     const candidates = corridor
@@ -1048,19 +1065,84 @@ export class BookingBatchService implements OnModuleInit {
   async exportTrainOptionsForDay(
     booking: Booking,
     day: string,
-    overrides?: {
-      /** Cargo the customer is entering on a form (bare contract instance —
-       * nothing persisted yet): container types drive the per-type space. */
-      containerTypeIds?: string[];
-      /** Size labels ("20ft"/"40ft") when the form has no type ids. */
-      containerSizes?: string[];
-      /** Bulk counterparts of the container inputs. */
-      cargoTypeId?: string;
-      cargoTypeCode?: string;
-      /** Needed wagons estimate from the form (drives the `fits` flag). */
-      wagons?: number;
-    },
+    overrides?: TrainOptionCargoOverrides,
   ): Promise<ExportTrainOption[]> {
+    booking = await this.withCargoOverrides(booking, overrides);
+    const corridor = await this.trainSchedulesRepository.findAll({
+      where: [
+        // Dedicated shipping-line trains are never customer-booking targets.
+        { status: TrainScheduleStatusEnum.Draft, shippingLineCompanyId: IsNull() },
+        { status: TrainScheduleStatusEnum.Scheduled, shippingLineCompanyId: IsNull() },
+      ],
+    });
+    const candidates = corridor
+      .filter(
+        (s) =>
+          s.scheduledDepartureDate != null &&
+          eatDay(s.scheduledDepartureDate) === day &&
+          s.direction === 'EXPORT',
+      )
+      .sort(
+        (a, b) =>
+          a.scheduledDepartureDate!.getTime() -
+          b.scheduledDepartureDate!.getTime(),
+      );
+    return this.buildTrainOptions(booking, candidates);
+  }
+
+  /**
+   * The same per-train wagon-availability cards, but for the trains DEDICATED
+   * to a shipping line on the booking's lane + day. Same option shape as the
+   * export picker so the portal reuses the same component; `isOpen`
+   * additionally respects the dedicated close offset (windowClosesAt), since
+   * these trains run no window cycle.
+   */
+  async dedicatedTrainOptionsForDay(
+    booking: Booking,
+    day: string | null,
+    shippingLineCompanyId: string,
+    overrides?: TrainOptionCargoOverrides,
+  ): Promise<ExportTrainOption[]> {
+    booking = await this.withCargoOverrides(booking, overrides);
+    const dedicated = await this.trainSchedulesRepository.findAll({
+      where: [
+        { status: TrainScheduleStatusEnum.Draft, shippingLineCompanyId },
+        { status: TrainScheduleStatusEnum.Scheduled, shippingLineCompanyId },
+      ],
+    });
+    const candidates = dedicated
+      .filter(
+        (s) =>
+          s.scheduledDepartureDate != null &&
+          // A day narrows to that departure day; without one, every upcoming
+          // departure on the lane is listed (the picker's full card list).
+          (day
+            ? eatDay(s.scheduledDepartureDate) === day
+            : s.scheduledDepartureDate.getTime() > Date.now() - 3_600_000) &&
+          (!booking.originYardId || s.originStationId === booking.originYardId) &&
+          (!booking.destinationYardId ||
+            s.destinationStationId === booking.destinationYardId),
+      )
+      .sort(
+        (a, b) =>
+          a.scheduledDepartureDate!.getTime() -
+          b.scheduledDepartureDate!.getTime(),
+      );
+    const options = await this.buildTrainOptions(booking, candidates);
+    const now = Date.now();
+    return options.map((o) => ({
+      ...o,
+      isOpen:
+        o.isOpen &&
+        (o.bookingClosesAt == null || o.bookingClosesAt.getTime() > now),
+    }));
+  }
+
+  /** Resolve form-entered cargo onto an (unpersisted) booking probe. */
+  private async withCargoOverrides(
+    booking: Booking,
+    overrides?: TrainOptionCargoOverrides,
+  ): Promise<Booking> {
     const sizeFts = (overrides?.containerSizes ?? [])
       .map((s) => parseInt(s, 10))
       .filter((n) => Number.isFinite(n) && n > 0);
@@ -1092,25 +1174,14 @@ export class BookingBatchService implements OnModuleInit {
     if (overrides?.wagons && overrides.wagons > 0) {
       booking = { ...booking, wagonsRequired: overrides.wagons } as Booking;
     }
-    const corridor = await this.trainSchedulesRepository.findAll({
-      where: [
-        { status: TrainScheduleStatusEnum.Draft },
-        { status: TrainScheduleStatusEnum.Scheduled },
-      ],
-    });
-    const candidates = corridor
-      .filter(
-        (s) =>
-          s.scheduledDepartureDate != null &&
-          eatDay(s.scheduledDepartureDate) === day &&
-          s.direction === 'EXPORT',
-      )
-      .sort(
-        (a, b) =>
-          a.scheduledDepartureDate!.getTime() -
-          b.scheduledDepartureDate!.getTime(),
-      );
+    return booking;
+  }
 
+  /** One availability card per candidate schedule — the export picker's math. */
+  private async buildTrainOptions(
+    booking: Booking,
+    candidates: TrainSchedule[],
+  ): Promise<ExportTrainOption[]> {
     const wagonDims = await this.loadWagonDims();
     const allowed = this.allowedDimsWithTypes(booking, wagonDims);
     const neededWagons = this.wagonsFor(booking, wagonDims);
@@ -1150,13 +1221,21 @@ export class BookingBatchService implements OnModuleInit {
       const ledger = new WagonStockLedger(
         stock.remainingByTypeId,
         Math.max(1, budget.stops.length - 1),
+        stock.byYardId,
+        budget.stops,
       );
+      // On a multi-yard consist the pool that matters is the one standing at
+      // the booking's own boarding yard — a type carried only in Mojo must not
+      // be advertised to a customer boarding at Dire.
+      const carriedAtBoardYard = (wagonTypeId: string): number => {
+        const boardYardId = stock.byYardId ? budget.stops[leg.fromEdge] : null;
+        if (boardYardId) return stock.byYardId?.get(boardYardId)?.get(wagonTypeId) ?? 0;
+        return stock.remainingByTypeId.get(wagonTypeId) ?? 0;
+      };
       const byWagonType = allowed
         .filter(
           ({ wagonTypeId }) =>
-            stock.mode !== 'TRAIN' ||
-            !wagonTypeId ||
-            (stock.remainingByTypeId.get(wagonTypeId) ?? 0) > 0,
+            stock.mode !== 'TRAIN' || !wagonTypeId || carriedAtBoardYard(wagonTypeId) > 0,
         )
         .map(({ wagonTypeId, dims }) => {
           const type = wagonTypeId ? typeById.get(wagonTypeId) : undefined;
@@ -1219,8 +1298,9 @@ export class BookingBatchService implements OnModuleInit {
   ): Promise<{ freeWagons: number; need: number; trainsForDay: boolean }> {
     const corridor = await this.trainSchedulesRepository.findAll({
       where: [
-        { status: TrainScheduleStatusEnum.Draft },
-        { status: TrainScheduleStatusEnum.Scheduled },
+        // Dedicated shipping-line trains are never customer-booking targets.
+        { status: TrainScheduleStatusEnum.Draft, shippingLineCompanyId: IsNull() },
+        { status: TrainScheduleStatusEnum.Scheduled, shippingLineCompanyId: IsNull() },
       ],
     });
     const candidates = corridor.filter(
@@ -2365,11 +2445,14 @@ export class BookingBatchService implements OnModuleInit {
           originStationId: originYardId,
           destinationStationId: destinationYardId,
           status: TrainScheduleStatusEnum.Draft,
+          // Dedicated shipping-line trains never join the customer day pool.
+          shippingLineCompanyId: IsNull(),
         },
         {
           originStationId: originYardId,
           destinationStationId: destinationYardId,
           status: TrainScheduleStatusEnum.Scheduled,
+          shippingLineCompanyId: IsNull(),
         },
       ],
     });
@@ -3100,8 +3183,9 @@ export class BookingBatchService implements OnModuleInit {
     if (!booking) throw new NotFoundException(`Booking ${bookingId} not found`);
     const schedules = await this.trainSchedulesRepository.findAll({
       where: [
-        { status: TrainScheduleStatusEnum.Draft },
-        { status: TrainScheduleStatusEnum.Scheduled },
+        // Dedicated shipping-line trains are never customer-booking targets.
+        { status: TrainScheduleStatusEnum.Draft, shippingLineCompanyId: IsNull() },
+        { status: TrainScheduleStatusEnum.Scheduled, shippingLineCompanyId: IsNull() },
       ],
     });
     const today = eatDay(new Date());
@@ -3176,6 +3260,99 @@ export class BookingBatchService implements OnModuleInit {
     }
   }
 
+  /**
+   * Auto-allocate an accepted SHIPPING-LINE booking onto its company's
+   * dedicated train for the booking's lane and shipment day.
+   *
+   * Runs at operation-accept: shipping lines pay later on the credit ledger,
+   * so there is no pay window between accept and wagon placement — the
+   * booking boards its train immediately. Customer bookings never come here;
+   * they keep the batch pool → reserve → pay → allocate pipeline.
+   *
+   * Wagon shortage parks the booking WAITING_FOR_WAGON on the schedule
+   * (without the PAID stamps the customer hold writes — nothing was paid).
+   * No dedicated train on the day is not an error: the booking simply stays
+   * in the ordinary day pool for the batch engine.
+   */
+  async allocateShippingLineAccepted(bookingId: string): Promise<void> {
+    const booking = await this.dataSource.getRepository(Booking).findOne({
+      where: { id: bookingId },
+      relations: { bookingContainers: { containerType: true }, cargoType: true },
+    });
+    if (!booking?.shippingLineCompanyId || !booking.scheduledDate) return;
+    if (isRoadService(booking.serviceType)) return;
+
+    const day = eatDay(booking.scheduledDate);
+    const dedicated = await this.dataSource.getRepository(TrainSchedule).find({
+      where: [
+        {
+          shippingLineCompanyId: booking.shippingLineCompanyId,
+          originStationId: booking.originYardId,
+          destinationStationId: booking.destinationYardId,
+          status: TrainScheduleStatusEnum.Draft,
+        },
+        {
+          shippingLineCompanyId: booking.shippingLineCompanyId,
+          originStationId: booking.originYardId,
+          destinationStationId: booking.destinationYardId,
+          status: TrainScheduleStatusEnum.Scheduled,
+        },
+      ],
+    });
+    const target = dedicated.find(
+      (s) =>
+        s.scheduledDepartureDate && eatDay(s.scheduledDepartureDate) === day,
+    );
+    if (!target) {
+      this.logger.log(
+        `[BATCH] shipping-line booking ${booking.reference} has no dedicated ` +
+          `train on ${day} — left in the day pool for the batch engine`,
+      );
+      return;
+    }
+
+    // Point the booking at its train BEFORE the shortage probe — the probe
+    // reads the link to size the need against that schedule's wagons.
+    await this.dataSource.getRepository(Booking).update(booking.id, {
+      trainScheduleId: target.id,
+    } as never);
+    booking.trainScheduleId = target.id;
+
+    // One dedicated train carries ONE booking: the accept claims the train by
+    // closing its booking window on the spot. Both gates a later booking
+    // passes — the day picker (isStillOpen on windowClosesAt) and the
+    // completion's dedicated-day check — read these fields, so a second
+    // booking can never pick this train.
+    await this.dataSource.getRepository(TrainSchedule).update(target.id, {
+      bookingWindowStatus: "CLOSED",
+      windowClosesAt: new Date(),
+    } as never);
+    this.notifyBoardChanged(target.id, "shipping_line_train_claimed");
+
+    const shortage =
+      await this.trainSchedulingService.previewPaidBookingWagonShortage(
+        target.id,
+        booking.id,
+      );
+    if (shortage) {
+      // Parked for staff to attach wagons — WITHOUT the customer hold's PAID
+      // stamps: a shipping line has paid nothing, its debt sits on the ledger.
+      await this.dataSource.getRepository(Booking).update(booking.id, {
+        schedulingStatus: "WAITING_FOR_WAGON",
+      } as never);
+      this.logger.warn(
+        `Shipping-line booking ${booking.reference} WAITING FOR WAGON on its ` +
+          `dedicated train ${target.reference ?? target.id}: needs ` +
+          `${shortage.wagonsNeeded} × ${shortage.wagonTypeCodes}, ` +
+          `${shortage.wagonsAvailable} available (short ${shortage.wagonsShort}).`,
+      );
+      this.notifyBoardChanged(target.id, "booking_waiting_wagon");
+      return;
+    }
+
+    await this.allocate(target.id, booking, "shipping_line");
+  }
+
   /**
    * One reminder per hold, shortly before its pay deadline (the window tick
    * calls this every pass; `payment_reminder_sent_at` dedups). Skips paid
@@ -3535,7 +3712,7 @@ export class BookingBatchService implements OnModuleInit {
   private async allocate(
     scheduleId: string,
     booking: Booking,
-    reason: "paid" | "gov",
+    reason: "paid" | "gov" | "shipping_line",
   ): Promise<void> {
     // Stamp the computed wagon need on the link. Several callers pass a booking
     // loaded without cargo relations (ensurePaidBookingAllocated), and a NULL
@@ -3680,23 +3857,24 @@ export class BookingBatchService implements OnModuleInit {
       // (provider query errored / payment still in flight) means we could not
       // confirm "not paid" — never expire on unknown; the next settle tick
       // asks again.
-      if (reason === "payment" && (fresh?.paymentDeadline ?? booking.paymentDeadline)) {
-        const reconcile = await this.billing.reconcilePayable(booking.id);
-        if (reconcile.paid) {
-          this.logger.log(
-            `[BATCH] expire skipped for ${booking.reference} — gateway ` +
-              `reconcile found a settled payment; payment.succeeded will allocate it`,
-          );
-          return;
-        }
-        if (reconcile.unverifiable) {
-          this.logger.warn(
-            `[BATCH] expire deferred for ${booking.reference} — settlement ` +
-              `unverifiable at the gateway; retrying next settle tick`,
-          );
-          return;
-        }
-      }
+      // TODO: CBE has no reconcile endpoint yet — re-enable once available.
+      // if (reason === "payment" && (fresh?.paymentDeadline ?? booking.paymentDeadline)) {
+      //   const reconcile = await this.billing.reconcilePayable(booking.id);
+      //   if (reconcile.paid) {
+      //     this.logger.log(
+      //       `[BATCH] expire skipped for ${booking.reference} — gateway ` +
+      //         `reconcile found a settled payment; payment.succeeded will allocate it`,
+      //     );
+      //     return;
+      //   }
+      //   if (reconcile.unverifiable) {
+      //     this.logger.warn(
+      //       `[BATCH] expire deferred for ${booking.reference} — settlement ` +
+      //         `unverifiable at the gateway; retrying next settle tick`,
+      //     );
+      //     return;
+      //   }
+      // }
     }
     const freedScheduleId = booking.trainScheduleId;
     await this.bookingsRepository.update(booking.id, {
@@ -4613,6 +4791,8 @@ export class BookingBatchService implements OnModuleInit {
     return new WagonStockLedger(
       stock.remainingByTypeId,
       Math.max(1, budget.stops.length - 1),
+      stock.byYardId,
+      budget.stops,
     );
   }
 
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.spec.ts
index 0a8cc99fe..ea936465e 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.spec.ts
@@ -11,6 +11,8 @@ describe('BookingJourneyService.autoPlaceOnFreedWagons', () => {
     {} as never, // yardFacilities
     {} as never, // facilityHandling
     { emit: jest.fn() } as never, // events
+    {} as never, // notifications
+    {} as never, // inbox
   );
 
   const schedule = { id: 'sched-1', trainSetId: 'ts-1' };
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.ts b/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.ts
index 8668b4f75..56b28fb7f 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/booking-journey.service.ts
@@ -24,7 +24,10 @@ import { WagonBookingAllocation } from '../train-schedules/entities/wagon-bookin
 import { Wagon } from '../wagons/entities/wagon.entity';
 import { WagonMovement } from '../wagons/entities/wagon-movement.entity';
 import { TrainCheckpointEvent } from './entities/train-checkpoint-event.entity';
-import { assertExportReceivedWithGrn } from '../../common/export-received-gate';
+import { assertExportReceivedWithGrn, DIRECT_TO_TRAIN } from '../../common/export-received-gate';
+import { NotificationsService } from '../notifications/notifications.service';
+import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
+import { notifyCarriageAcceptanceReady } from '../notifications/notify-company.util';
 
 /**
  * Per-booking journey along a train's corridor — for EVERY trade direction.
@@ -52,6 +55,8 @@ export class BookingJourneyService {
     private readonly yardFacilities: YardFacilitiesService,
     private readonly facilityHandling: FacilityHandlingService,
     private readonly events: EventEmitter2,
+    private readonly notifications: NotificationsService,
+    private readonly inbox: NotificationInboxService,
     @Optional() private readonly milestoneService?: ClearanceMilestoneService,
   ) {}
 
@@ -76,6 +81,21 @@ export class BookingJourneyService {
     // Export cargo must be in the warehouse with a GRN before it can be loaded,
     // however it arrived and whatever it is allocated to.
     await assertExportReceivedWithGrn(this.dataSource, booking);
+    // Direct truck-to-train cargo never sees the warehouse, so loading IS its
+    // handover moment — the carriage acceptance sheet must go out to the
+    // customer right here, not on a receive event that will never fire.
+    if (
+      booking.tradeDirection === 'EXPORT' &&
+      booking.exportHandoverMode === DIRECT_TO_TRAIN
+    ) {
+      await notifyCarriageAcceptanceReady(
+        this.dataSource,
+        this.notifications,
+        this.inbox,
+        booking.id,
+        this.logger,
+      );
+    }
 
     const now = new Date();
     await this.dataSource.transaction(async (manager) => {
@@ -95,6 +115,20 @@ export class BookingJourneyService {
       await manager
         .getRepository(TrainScheduleBooking)
         .update({ trainScheduleId: scheduleId, bookingId }, { loadingStatus: 'LOADED' });
+      // Warehouse cargo may be loaded either from the warehouse Load-to-Train
+      // queue or from the schedule itself. Loading here must move its inventory
+      // too, otherwise the goods read as still sitting in the shed while the
+      // train leaves with them. No-ops for direct truck-to-train (no inventory).
+      // ponytail: no WarehouseLoading record on this path — those are only read
+      // back as per-inventory loading history, never billed. Create them here if
+      // that history ever has to be complete.
+      await manager.query(
+        `UPDATE freight.warehouse_inventory
+            SET status = 'LOADED', loaded_at = COALESCE(loaded_at, $2), updated_at = NOW()
+          WHERE booking_id = $1 AND deleted_at IS NULL
+            AND status NOT IN ('LOADED', 'DISPATCHED')`,
+        [bookingId, now],
+      );
       // The facility handed the cargo over — raise its GRN. No-ops for yards
       // without a facility (import/export terminals), which keep their own flow.
       await this.facilityHandling.recordHandling(manager, {
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/booking-notifier.service.ts b/apps/edr-freight-api/src/modules/train-scheduling/booking-notifier.service.ts
index efb540066..1c2d99401 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/booking-notifier.service.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/booking-notifier.service.ts
@@ -11,7 +11,8 @@ import {
 import { Booking } from '../bookings/entities/booking.entity';
 import { NotificationsService } from '../notifications/notifications.service';
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
-import { resolveCompanyNotifyPhone } from '../notifications/resolve-company-phone.util';
+import { resolveCompanyNotifyContact } from '../notifications/resolve-company-phone.util';
+import { resolveShippingLineNotifyTarget } from '../notifications/resolve-shipping-line-contact.util';
 import { TrainSchedulesRepository } from '../train-schedules/train-schedules.repository';
 import { BATCH_TIMEZONE } from './booking-batch.constants';
 
@@ -65,10 +66,17 @@ export class BookingNotifierService {
     logLabel: string,
   ): Promise<void> {
     this.logger.log(`${logLabel} — ${this.ref(b)}`);
-    const phone = b.companyId
-      ? await resolveCompanyNotifyPhone(this.dataSource, b.companyId)
-      : null;
-    const email = b.company?.email ?? b.company?.generalManagerEmail ?? null;
+    // One resolver for both channels — the company row's own email column is
+    // only set for a Fayda-verified owner (see companyNotifyEmailExpr). A
+    // shipping-line booking has no company; its contact is the line's row.
+    const { phone, email } = b.shippingLineCompanyId
+      ? await resolveShippingLineNotifyTarget(
+          this.dataSource,
+          b.shippingLineCompanyId,
+        )
+      : b.companyId
+        ? await resolveCompanyNotifyContact(this.dataSource, b.companyId)
+        : { phone: null, email: null };
 
     if (phone) {
       try {
@@ -89,13 +97,42 @@ export class BookingNotifierService {
     }
   }
 
-  /** Persist + push an in-app item to all portal users of the booking's company. */
+  /**
+   * Persist + push an in-app item to the booking's portal owner: every portal
+   * user of the company, or — for a shipping-line booking — the line's own
+   * account, deep-linked into the shipping-line app (/shipping-line/*).
+   */
   private inApp(
     b: Booking,
     title: string,
     body: string,
     overrides: Partial<NotifyInput> = {},
   ): void {
+    if (b.shippingLineCompanyId) {
+      void (async () => {
+        const { userId } = await resolveShippingLineNotifyTarget(
+          this.dataSource,
+          b.shippingLineCompanyId!,
+        );
+        if (!userId) return;
+        void this.inbox.notify({
+          recipients: { userIds: [userId] },
+          audience: NotificationAudience.PORTAL,
+          type: NotificationType.SCHEDULE_UPDATE,
+          title,
+          body,
+          data: { bookingId: b.id, reference: b.reference },
+          ...overrides,
+          // After the spread: the bell must land the line on ITS booking page.
+          link: `/shipping-line/bookings/${b.id}`,
+        });
+      })().catch((err) =>
+        this.logger.warn(
+          `shipping-line inApp failed for ${this.ref(b)}: ${(err as Error).message}`,
+        ),
+      );
+      return;
+    }
     if (!b.companyId) return; // government/unlinked bookings have no portal users
     void this.inbox.notify({
       recipients: { companyId: b.companyId },
@@ -208,11 +245,19 @@ export class BookingNotifierService {
     });
   }
 
-  secured(b: Booking, reason: 'paid' | 'gov', scheduleId?: string | null): void {
+  secured(
+    b: Booking,
+    reason: 'paid' | 'gov' | 'shipping_line',
+    scheduleId?: string | null,
+  ): void {
     void (async () => {
       const label = await this.scheduleLabel(scheduleId ?? b.trainScheduleId);
       const msg = `Booking ${b.reference ?? b.id} allocated on ${label}${
-        reason === 'gov' ? ' (government)' : ''
+        reason === 'gov'
+          ? ' (government)'
+          : reason === 'shipping_line'
+            ? ' (shipping line)'
+            : ''
       }.`;
       void this.notifyContact(b, msg, 'ALLOCATED');
       this.inApp(b, 'Wagon allocated', msg);
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/booking-window.service.ts b/apps/edr-freight-api/src/modules/train-scheduling/booking-window.service.ts
index 1a3baa6b4..47d0a0d21 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/booking-window.service.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/booking-window.service.ts
@@ -14,12 +14,13 @@ import { TrainSchedulesRepository } from '../train-schedules/train-schedules.rep
 import { NotificationsService } from '../notifications/notifications.service';
 import { NotificationInboxService } from '../notification-inbox/notification-inbox.service';
 import {
+  companyNotifyEmailExpr,
   companyNotifyPhoneExpr,
   primaryContactUserJoin,
 } from '../notifications/resolve-company-phone.util';
 import { BookingBatchService } from './booking-batch.service';
 import { BookingWindowGateway } from './booking-window.gateway';
-import { TrainSchedulingService, effectiveWindowConfig } from './train-scheduling.service';
+import { TrainSchedulingService, effectiveWindowConfig } from './services/train-scheduling.service';
 import { BATCH_TIMEZONE } from './booking-batch.constants';
 import {
   bookingCloseCutoff,
@@ -313,6 +314,8 @@ export class BookingWindowService implements OnModuleInit {
       // Fire-and-forget: a slow SMS/email gateway must not stall the tick loop
       // (the `ticking` guard would otherwise delay every schedule's transition).
       void this.notifyWindowOpened(schedule);
+      // Intercity rides along whatever train passes, export included.
+      void this.notifyIntercityCorridorScheduled(schedule);
       this.logger.log(`Export booking window opened for schedule ${schedule.id}`);
       return true;
     }
@@ -365,7 +368,10 @@ export class BookingWindowService implements OnModuleInit {
       }
       // Only announce the first opening of the day; reopen cycles don't re-notify.
       // Fire-and-forget so a slow SMS/email gateway never stalls the tick loop.
-      if (schedule.bookingCycleNo === 1) void this.notifyWindowOpened(schedule);
+      if (schedule.bookingCycleNo === 1) {
+        void this.notifyWindowOpened(schedule);
+        void this.notifyIntercityCorridorScheduled(schedule);
+      }
       this.logger.log(
         `[WINDOW] ${schedule.id} PRE_WINDOW→OPEN — booking window opened ` +
           `(cycle ${schedule.bookingCycleNo})`,
@@ -644,7 +650,7 @@ export class BookingWindowService implements OnModuleInit {
         `SELECT DISTINCT
                 c.company_id,
                 ${companyNotifyPhoneExpr('co')} AS phone,
-                COALESCE(co.email, co.general_manager_email) AS email
+                ${companyNotifyEmailExpr('co')} AS email
            FROM freight.contract_routes cr
            JOIN freight.contracts c
              ON c.id = cr.contract_id
@@ -710,6 +716,149 @@ export class BookingWindowService implements OnModuleInit {
     }
   }
 
+  /**
+   * SMS + email + inbox the owner of every waiting intercity booking whose
+   * corridor lies on this schedule's route.
+   *
+   * Intercity (DOMESTIC) bookings carry no date — the customer books a corridor
+   * and the cargo waits in a pool until staff ride it along a passing
+   * import/export train (see IntercityService). Until now that wait was silent:
+   * `notifyWindowOpened` only reaches companies holding an ACTIVE contract whose
+   * `contract_routes` match the train's exact origin→destination, and an
+   * intercity booking is neither contracted nor necessarily end-to-end.
+   *
+   * Corridor match mirrors `IntercityService.corridorOnRoute` exactly — both
+   * yards on the route with origin strictly before destination, falling back to
+   * the train's own origin/destination when the route has fewer than two
+   * milestones — so nobody is told about a train they can never be placed on.
+   */
+  private async notifyIntercityCorridorScheduled(
+    schedule: TrainSchedule,
+  ): Promise<void> {
+    try {
+      const rows: Array<{
+        bookingId: string;
+        companyId: string;
+        phone: string | null;
+        email: string | null;
+        corridor: string;
+      }> = await this.dataSource.query(
+        // `stops` is the schedule's stop list, with the two-stop
+        // origin→destination pseudo-route as the legacy fallback — the same
+        // shape IntercityService.milestoneSequenceOf builds in TypeScript.
+        `WITH ms AS (
+           SELECT yard_id, sequence_no
+             FROM freight.route_milestones
+            WHERE route_id = $1 AND deleted_at IS NULL
+         ),
+         stops AS (
+           SELECT yard_id, sequence_no FROM ms WHERE (SELECT count(*) FROM ms) >= 2
+           UNION ALL
+           SELECT v.yard_id, v.seq
+             FROM (VALUES ($2::uuid, 1), ($3::uuid, 2)) AS v(yard_id, seq)
+            WHERE (SELECT count(*) FROM ms) < 2
+         )
+         SELECT DISTINCT
+                b.id                                        AS "bookingId",
+                b.company_id                                AS "companyId",
+                ${companyNotifyPhoneExpr('co')}             AS phone,
+                ${companyNotifyEmailExpr('co')}             AS email,
+                COALESCE(oy.label, oy.code) || ' to ' ||
+                COALESCE(dy.label, dy.code)                 AS corridor
+           FROM freight.bookings b
+           JOIN stops o ON o.yard_id = b.origin_yard_id
+           JOIN stops d ON d.yard_id = b.destination_yard_id
+                       AND d.sequence_no > o.sequence_no
+           JOIN freight.companies co ON co.id = b.company_id AND co.deleted_at IS NULL
+           JOIN freight.yards oy ON oy.id = b.origin_yard_id
+           JOIN freight.yards dy ON dy.id = b.destination_yard_id
+           ${primaryContactUserJoin('co')}
+          WHERE b.deleted_at IS NULL
+            AND b.trade_direction = 'DOMESTIC'
+            AND b.train_schedule_id IS NULL
+            -- Same waiting pool IntercityService.findWaitingIntercityBookings
+            -- draws candidates from: commercial paid/executed, government approved.
+            AND ((b.is_government = false AND b.status IN ('FULLY_EXECUTED', 'PAID'))
+              OR (b.is_government = true AND b.status = 'APPROVED'))
+            -- Once per booking, not once per train. A booking can sit in the
+            -- pool for weeks while several trains open a window on its corridor,
+            -- and "trains run your corridor, you are queued" is the same message
+            -- every time. The inbox row written below is the marker.
+            -- ponytail: unindexed jsonb probe over freight.notifications; add a
+            -- partial index on (data->>'intercityCorridorBookingId') if the
+            -- table grows enough for this to show up in the tick loop.
+            AND NOT EXISTS (
+              SELECT 1 FROM freight.notifications n
+               WHERE n.data->>'intercityCorridorBookingId' = b.id::text)`,
+        [schedule.routeId, schedule.originStationId, schedule.destinationStationId],
+      );
+      if (!rows.length) return;
+
+      const depart = schedule.scheduledDepartureDate.toLocaleDateString('en-GB', {
+        timeZone: BATCH_TIMEZONE,
+      });
+      const msgFor = (corridors: string[]) =>
+        `A train is scheduled on your intercity corridor ${corridors.join(', ')}, ` +
+        `departing ${depart}. EDR will confirm once your cargo is placed on a train.`;
+
+      // One inbox item per booking (its `data` is the once-per-booking marker
+      // the query above reads), but one SMS/email per company — a customer with
+      // three waiting bookings gets one message naming all three corridors.
+      const byCompany = new Map<
+        string,
+        { phone: string | null; email: string | null; corridors: string[] }
+      >();
+      for (const row of rows) {
+        const entry = byCompany.get(row.companyId) ?? {
+          phone: row.phone,
+          email: row.email,
+          corridors: [],
+        };
+        if (!entry.corridors.includes(row.corridor)) entry.corridors.push(row.corridor);
+        byCompany.set(row.companyId, entry);
+
+        await this.inbox.notify({
+          recipients: { companyId: row.companyId },
+          audience: NotificationAudience.PORTAL,
+          type: NotificationType.SCHEDULE_UPDATE,
+          title: 'Train scheduled on your corridor',
+          body: msgFor([row.corridor]),
+          link: `/bookings/${row.bookingId}`,
+          data: {
+            intercityCorridorBookingId: row.bookingId,
+            trainScheduleId: schedule.id,
+          },
+        });
+      }
+
+      for (const [companyId, entry] of byCompany) {
+        const msg = msgFor(entry.corridors);
+        if (entry.phone) {
+          await this.notifications
+            .directSend('sms', entry.phone, msg)
+            .catch((e) =>
+              this.logger.warn(`Intercity corridor SMS failed: ${(e as Error).message}`),
+            );
+        }
+        if (entry.email) {
+          await this.notifications
+            .directSend('email', entry.email, msg)
+            .catch((e) =>
+              this.logger.warn(`Intercity corridor email failed: ${(e as Error).message}`),
+            );
+        }
+        this.logger.log(
+          `Notified company ${companyId} of ${entry.corridors.length} intercity ` +
+            `corridor(s) served by schedule ${schedule.id}`,
+        );
+      }
+    } catch (err) {
+      this.logger.warn(
+        `notifyIntercityCorridorScheduled failed for ${schedule.id}: ${(err as Error).message}`,
+      );
+    }
+  }
+
   private async setPhase(
     schedule: TrainSchedule,
     patch: Partial<
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/container-placement.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/container-placement.util.ts
index 72ee1407e..bbfaedaf0 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/container-placement.util.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/container-placement.util.ts
@@ -1,4 +1,4 @@
-import type { ContainerPlacementInput } from './wagon-plan.util';
+import type { ContainerPlacementInput } from './utils/wagon-plan.util';
 
 export type ContainerUnitForPlacement = {
   bookingId: string;
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.controller.ts b/apps/edr-freight-api/src/modules/train-scheduling/controllers/train-scheduling.controller.ts
similarity index 85%
rename from apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.controller.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/controllers/train-scheduling.controller.ts
index 2c92ba00d..54056404a 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.controller.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/controllers/train-scheduling.controller.ts
@@ -1,11 +1,11 @@
 import { ApiBearerAuth, ApiOperation, ApiTags } from "@nestjs/swagger";
 import type { Response } from "express";
-import type { AuthUserPayload } from "../../common/resolve-auth-user-id";
-import { UserTradeAccessService } from "../user-trade-access/user-trade-access.service";
-import { resolveAuthUserId } from "../../common/resolve-auth-user-id";
+import type { AuthUserPayload } from "../../../common/resolve-auth-user-id";
+import { UserTradeAccessService } from "../../user-trade-access/user-trade-access.service";
+import { resolveAuthUserId } from "../../../common/resolve-auth-user-id";
 
 import {
-  Body, Controller, Delete, Get, Param, ParseUUIDPipe, Patch, Post, Query, Res,
+  Body, Controller, Delete, Get, Param, ParseIntPipe, ParseUUIDPipe, Patch, Post, Query, Res,
 } from "@nestjs/common";
 import { CurrentUser } from "@edr/api-common";
 import {
@@ -15,50 +15,57 @@ import {
   PortalCustomer,
   TrainSchedulingCancel,
   TrainSchedulingCreate,
+  TrainSchedulingEditTrainNumber,
   TrainSchedulingReschedule,
   TrainSchedulingRulesManage,
   TrainSchedulingUpdate,
   TrainSchedulingView,
-} from "../../common/booking-guards";
-import { FREIGHT_PERMS } from "../../seed/freight-permissions.registry";
-import { AcceptIntercityBookingsDto } from "./dto/accept-intercity-bookings.dto";
-import { AssignBookingsDto } from "./dto/assign-bookings.dto";
-import { AssignUnassignedBookingDto } from "./dto/assign-unassigned-booking.dto";
-import { SwitchGovernmentBookingDto } from "./dto/switch-government-booking.dto";
-import { CreateContainerTrainScheduleDto } from "./dto/create-container-train-schedule.dto";
-import { GetEligibleBookingsDto } from "./dto/get-eligible-bookings.dto";
-import { GetEligibleBulkBookingsDto } from "./dto/get-eligible-bulk-bookings.dto";
-import { GetEligibleContainerBookingsDto } from "./dto/get-eligible-container-bookings.dto";
-import { PinWagonsDto } from "./dto/pin-wagons.dto";
-import { MoveWagonLoadDto } from "./dto/move-wagon-load.dto";
-import { UpdateContainerItemDto } from "./dto/update-container-item.dto";
-import { UpdateImportLoadingStatusDto } from "./dto/update-import-loading-status.dto";
-import { PreviewBulkTrainScheduleDto } from "./dto/preview-bulk-train-schedule.dto";
-import { PreviewContainerTrainScheduleDto } from "./dto/preview-container-train-schedule.dto";
-import { PreviewTrainScheduleDto } from "./dto/preview-train-schedule.dto";
-import { RecordCheckpointDto } from "./dto/record-checkpoint.dto";
+} from "../../../common/booking-guards";
+import { FREIGHT_PERMS } from "../../../seed/freight-permissions.registry";
+import { AcceptIntercityBookingsDto } from "../dto/accept-intercity-bookings.dto";
+import { AssignBookingsDto } from "../dto/assign-bookings.dto";
+import { AssignUnassignedBookingDto } from "../dto/assign-unassigned-booking.dto";
+import { SwitchGovernmentBookingDto } from "../dto/switch-government-booking.dto";
+import { CreateContainerTrainScheduleDto } from "../dto/create-container-train-schedule.dto";
+import { GetEligibleBookingsDto } from "../dto/get-eligible-bookings.dto";
+import { GetEligibleBulkBookingsDto } from "../dto/get-eligible-bulk-bookings.dto";
+import { GetEligibleContainerBookingsDto } from "../dto/get-eligible-container-bookings.dto";
+import { PinWagonsDto } from "../dto/pin-wagons.dto";
+import { MoveWagonLoadDto } from "../dto/move-wagon-load.dto";
+import { UpdateContainerItemDto } from "../dto/update-container-item.dto";
+import { UpdateImportLoadingStatusDto } from "../dto/update-import-loading-status.dto";
+import { PreviewBulkTrainScheduleDto } from "../dto/preview-bulk-train-schedule.dto";
+import { PreviewContainerTrainScheduleDto } from "../dto/preview-container-train-schedule.dto";
+import { PreviewTrainScheduleDto } from "../dto/preview-train-schedule.dto";
+import {
+  DispatchScheduleDto,
+  RecordCheckpointDto,
+  UpdateCheckpointDto,
+} from "../dto/record-checkpoint.dto";
 import {
   ImportDjiboutiActionDto,
   UploadImportDjiboutiDocumentDto,
-} from "./dto/import-djibouti-operation.dto";
-import { AvailableLocomotivesQueryDto } from "./dto/available-locomotives-query.dto";
-import { AdjustScheduleConsistDto } from "./dto/adjust-schedule-consist.dto";
-import { AvailableTrainsQueryDto } from "./dto/available-trains-query.dto";
-import { BatchBoardQueryDto } from "./dto/batch-board-query.dto";
-import { BookableSchedulesQueryDto } from "./dto/bookable-schedules-query.dto";
-import { ListTrainSchedulesQueryDto } from "./dto/list-train-schedules-query.dto";
-import { AvailableDaysQueryDto } from "./dto/available-days-query.dto";
-import { AvailableDaysForCargoQueryDto } from "./dto/available-days-for-cargo-query.dto";
-import { UpdateTrainSchedulingGlobalRulesDto } from "./dto/update-train-scheduling-global-rules.dto";
-import { UpdateScheduleWindowRuleDto } from "./dto/update-schedule-window-rule.dto";
-import { UpdateScheduleDateDto } from "./dto/update-schedule-date.dto";
-import { MaintenanceRescheduleDto } from "./dto/maintenance-reschedule.dto";
-import { TrainSchedulingService } from "./train-scheduling.service";
-import { BookingBatchService } from "./booking-batch.service";
-import { BookingJourneyService } from "./booking-journey.service";
-import { BookingWindowService } from "./booking-window.service";
-import { IntercityService } from "./intercity.service";
-import { BillingService } from "../billing/billing.service";
+} from "../dto/import-djibouti-operation.dto";
+import { AvailableLocomotivesQueryDto } from "../dto/available-locomotives-query.dto";
+import { AdjustScheduleConsistDto } from "../dto/adjust-schedule-consist.dto";
+import { AvailableTrainsQueryDto } from "../dto/available-trains-query.dto";
+import { BatchBoardQueryDto } from "../dto/batch-board-query.dto";
+import { BookableSchedulesQueryDto } from "../dto/bookable-schedules-query.dto";
+import { ListTrainSchedulesQueryDto } from "../dto/list-train-schedules-query.dto";
+import { AvailableDaysQueryDto } from "../dto/available-days-query.dto";
+import { AvailableDaysForCargoQueryDto } from "../dto/available-days-for-cargo-query.dto";
+import { UpdateTrainSchedulingGlobalRulesDto } from "../dto/update-train-scheduling-global-rules.dto";
+import { UpdateScheduleWindowRuleDto } from "../dto/update-schedule-window-rule.dto";
+import { UpdateScheduleDateDto } from "../dto/update-schedule-date.dto";
+import { MergeScheduleTrainDto } from "../dto/merge-schedule-train.dto";
+import { UpdateScheduleTrainNumberDto } from "../dto/update-schedule-train-number.dto";
+import { MaintenanceRescheduleDto } from "../dto/maintenance-reschedule.dto";
+import { TrainSchedulingService } from "../services/train-scheduling.service";
+import { BookingBatchService } from "../booking-batch.service";
+import { BookingJourneyService } from "../booking-journey.service";
+import { BookingWindowService } from "../booking-window.service";
+import { IntercityService } from "../intercity.service";
+import { BillingService } from "../../billing/billing.service";
 
 @ApiTags("train-scheduling")
 @ApiBearerAuth()
@@ -513,9 +520,14 @@ export class TrainSchedulingController {
 
   @Post("schedules/:id/dispatch")
   @BookingStaff(FREIGHT_PERMS.trainScheduling.dispatch)
-  @ApiOperation({ summary: "Dispatch a scheduled train" })
-  dispatchSchedule(@Param("id", ParseUUIDPipe) id: string) {
-    return this.trainSchedulingService.dispatchSchedule(id);
+  @ApiOperation({
+    summary: "Dispatch a scheduled train (optional actual departure time, past allowed)",
+  })
+  dispatchSchedule(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: DispatchScheduleDto,
+  ) {
+    return this.trainSchedulingService.dispatchSchedule(id, dto);
   }
 
   @Get("intercity/bookings")
@@ -795,6 +807,47 @@ export class TrainSchedulingController {
     return this.trainSchedulingService.getContainerTrainScheduleById(id);
   }
 
+  @Patch("schedules/:id/train-number")
+  @TrainSchedulingEditTrainNumber()
+  @ApiOperation({
+    summary:
+      "Edit a departure's train number and voyage number — allowed only until the train is dispatched",
+  })
+  async updateScheduleTrainNumber(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: UpdateScheduleTrainNumberDto,
+  ) {
+    await this.trainSchedulingService.updateScheduleTrainNumber(id, dto);
+    return this.trainSchedulingService.getContainerTrainScheduleById(id);
+  }
+
+  @Get("schedules/:id/merge-preview/:targetTrainId")
+  @TrainSchedulingUpdate()
+  @ApiOperation({
+    summary:
+      "What merging a train into this schedule would do — affected schedules, wagon totals and any blocking reasons. Read-only.",
+  })
+  async previewScheduleMerge(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Param("targetTrainId", ParseUUIDPipe) targetTrainId: string,
+  ) {
+    return this.trainSchedulingService.previewMerge(id, targetTrainId);
+  }
+
+  @Post("schedules/:id/merge")
+  @TrainSchedulingUpdate()
+  @ApiOperation({
+    summary:
+      "Merge another train into this schedule: its wagons join this consist, a same-day schedule on it is absorbed, and the emptied train is deactivated",
+  })
+  async mergeScheduleTrain(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Body() dto: MergeScheduleTrainDto,
+  ) {
+    await this.trainSchedulingService.mergeScheduleTrain(id, dto);
+    return this.trainSchedulingService.getContainerTrainScheduleById(id);
+  }
+
   @Post("schedules/:id/maintenance")
   @TrainSchedulingReschedule()
   @ApiOperation({
@@ -912,6 +965,20 @@ export class TrainSchedulingController {
     return this.trainSchedulingService.recordCheckpoint(id, dto);
   }
 
+  @Patch("schedules/:id/checkpoints/:sequenceNo")
+  @TrainSchedulingUpdate()
+  @ApiOperation({
+    summary:
+      "Edit a logged leg's time/note (no side effects; allowed while dispatched or after arrival)",
+  })
+  updateCheckpoint(
+    @Param("id", ParseUUIDPipe) id: string,
+    @Param("sequenceNo", ParseIntPipe) sequenceNo: number,
+    @Body() dto: UpdateCheckpointDto,
+  ) {
+    return this.trainSchedulingService.updateCheckpoint(id, sequenceNo, dto);
+  }
+
   @Post("schedules/:id/arrive")
   @TrainSchedulingUpdate()
   @ApiOperation({
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/dto/create-container-train-schedule.dto.ts b/apps/edr-freight-api/src/modules/train-scheduling/dto/create-container-train-schedule.dto.ts
index e8716eb99..18904c032 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/dto/create-container-train-schedule.dto.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/dto/create-container-train-schedule.dto.ts
@@ -172,6 +172,17 @@ export class CreateContainerTrainScheduleDto {
   @IsBoolean()
   reverseWagonOrder?: boolean;
 
+  @ApiPropertyOptional({
+    format: 'uuid',
+    description:
+      'Dedicate this departure to one shipping line. The schedule is then hidden ' +
+      'from every customer-facing read (windows, day pools, home cards) and shown ' +
+      'only to that shipping line in its portal. Omit for a normal customer train.',
+  })
+  @IsOptional()
+  @IsUUID()
+  shippingLineCompanyId?: string;
+
   @ApiPropertyOptional({
     type: CreateScheduleWindowRuleDto,
     description:
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/dto/merge-schedule-train.dto.ts b/apps/edr-freight-api/src/modules/train-scheduling/dto/merge-schedule-train.dto.ts
new file mode 100644
index 000000000..8f4c09d43
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/dto/merge-schedule-train.dto.ts
@@ -0,0 +1,23 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, IsUUID, MaxLength } from 'class-validator';
+
+/**
+ * Merge another train into this schedule's train. The schedule always survives:
+ * its train set is repointed at `targetTrainId`, that train's wagons join this
+ * consist, and the source train is left empty and deactivated.
+ */
+export class MergeScheduleTrainDto {
+  @ApiProperty({
+    description: "The train being merged IN. This schedule's train absorbs it.",
+  })
+  @IsUUID()
+  targetTrainId!: string;
+
+  @ApiPropertyOptional({
+    description: 'Why the trains were merged — kept on the audit trail.',
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  reason?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/dto/record-checkpoint.dto.ts b/apps/edr-freight-api/src/modules/train-scheduling/dto/record-checkpoint.dto.ts
index da7ebc0e7..1495185f0 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/dto/record-checkpoint.dto.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/dto/record-checkpoint.dto.ts
@@ -10,8 +10,6 @@ import {
   Min,
 } from 'class-validator';
 
-import { IsNotBackdated } from '../../../common/validators/is-not-backdated.validator';
-
 export class RecordCheckpointDto {
   @ApiProperty({ description: 'Station position along the route (0 = origin).' })
   @IsInt()
@@ -24,17 +22,17 @@ export class RecordCheckpointDto {
   kind?: TrainCheckpointKind;
 
   /**
-   * A checkpoint records where the train is as staff observe it, and the final
-   * one arrives the schedule — so a backdated value rewrites the journey after
-   * the fact. Only "now" is accepted; omit the field and the service stamps it.
+   * When the train was actually at the station — staff often log after the
+   * fact, so a past value is allowed. The service rejects the future and any
+   * value out of order with the neighbouring legs.
    */
   @ApiProperty({
     required: false,
-    description: 'ISO timestamp; defaults to now. Cannot be earlier than now.',
+    description:
+      'ISO timestamp; defaults to now. Past allowed, future rejected, must be in corridor order.',
   })
   @IsOptional()
   @IsISO8601()
-  @IsNotBackdated()
   occurredAt?: string;
 
   @ApiProperty({ required: false })
@@ -43,3 +41,30 @@ export class RecordCheckpointDto {
   @MaxLength(500)
   note?: string;
 }
+
+/** Edit an already-logged leg's time/note — no side effects (no unload, no arrival). */
+export class UpdateCheckpointDto {
+  @ApiProperty({
+    required: false,
+    description: 'ISO timestamp. Past allowed, future rejected, must be in corridor order.',
+  })
+  @IsOptional()
+  @IsISO8601()
+  occurredAt?: string;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  note?: string | null;
+}
+
+export class DispatchScheduleDto {
+  @ApiProperty({
+    required: false,
+    description: 'Actual departure time; defaults to now. Past allowed, future rejected.',
+  })
+  @IsOptional()
+  @IsISO8601()
+  actualDepartureAt?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/dto/update-schedule-train-number.dto.ts b/apps/edr-freight-api/src/modules/train-scheduling/dto/update-schedule-train-number.dto.ts
new file mode 100644
index 000000000..5756732c4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/dto/update-schedule-train-number.dto.ts
@@ -0,0 +1,40 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, MaxLength } from 'class-validator';
+
+/**
+ * Edit a departure's operational run identifiers. Both fields are optional so
+ * either can be corrected alone; the service rejects a body carrying neither,
+ * so an empty request cannot write an audit row for a no-op.
+ *
+ * Sending an empty string clears the field; omitting it leaves it unchanged.
+ */
+export class UpdateScheduleTrainNumberDto {
+  @ApiPropertyOptional({
+    example: '9201',
+    description: "Run number for this departure. Empty string clears it.",
+    maxLength: 20,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(20)
+  trainNumber?: string;
+
+  @ApiPropertyOptional({
+    example: 'V-2026-014',
+    description: 'Voyage (sailing) number for this departure. Empty string clears it.',
+    maxLength: 20,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(20)
+  voyageNumber?: string;
+
+  @ApiPropertyOptional({
+    description: 'Why the numbers changed — kept on the audit trail.',
+    maxLength: 500,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  reason?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/entities/train-scheduling-global-rules.entity.ts b/apps/edr-freight-api/src/modules/train-scheduling/entities/train-scheduling-global-rules.entity.ts
index 94882833b..50debc6c0 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/entities/train-scheduling-global-rules.entity.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/entities/train-scheduling-global-rules.entity.ts
@@ -57,9 +57,10 @@ export class TrainSchedulingGlobalRules extends BaseEntity {
   /**
    * Local (Africa/Addis_Ababa) hour the booking desk shuts each day. A not-yet-full
    * train whose next cycle would reopen at/after this hour pauses until the next
-   * morning's windowOpenHour. Set equal to windowOpenHour for a 24-hour desk.
+   * morning's windowOpenHour. Set equal to windowOpenHour for a 24-hour desk
+   * (the default).
    */
-  @Column({ name: 'window_close_hour', type: 'int', default: 17 })
+  @Column({ name: 'window_close_hour', type: 'int', default: 8 })
   windowCloseHour!: number;
 
   // Stored in hours; 4 decimals so sub-minute UI durations (4 min = 0.0667h)
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/gatepass-payment-gate.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/gatepass-payment-gate.spec.ts
index 912f437f4..8521f4001 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/gatepass-payment-gate.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/gatepass-payment-gate.spec.ts
@@ -1,4 +1,4 @@
-import { TrainSchedulingService } from './train-scheduling.service';
+import { TrainSchedulingService } from './services/train-scheduling.service';
 import { Booking } from '../bookings/entities/booking.entity';
 import { ClearanceMilestone } from '../contracts/entities/clearance-milestone.entity';
 
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/intercity-corridor-notify.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/intercity-corridor-notify.spec.ts
new file mode 100644
index 000000000..3b6648c19
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/intercity-corridor-notify.spec.ts
@@ -0,0 +1,110 @@
+import { BookingWindowService } from './booking-window.service';
+import type { TrainSchedule } from '../train-schedules/entities/train-schedule.entity';
+
+/**
+ * Intercity corridor announcement: when a train's booking window opens, every
+ * customer with a waiting intercity booking on that corridor is told over SMS,
+ * email and the portal inbox.
+ *
+ * The corridor SQL itself is EXPLAIN-validated against the dev database; what
+ * this covers is the fan-out shape around it — one inbox row per booking
+ * (that row's `data` is the once-per-booking marker the query dedupes on) but
+ * one SMS/email per company, naming every corridor at once.
+ */
+describe('BookingWindowService — intercity corridor announcement', () => {
+  const schedule = {
+    id: 'sched-1',
+    routeId: 'route-1',
+    originStationId: 'yard-o',
+    destinationStationId: 'yard-d',
+    scheduledDepartureDate: new Date('2026-08-01T06:00:00.000Z'),
+  } as unknown as TrainSchedule;
+
+  const build = (rows: unknown[]) => {
+    const query = jest.fn().mockResolvedValue(rows);
+    const directSend = jest.fn().mockResolvedValue(undefined);
+    const notify = jest.fn().mockResolvedValue(undefined);
+    const service = new BookingWindowService(
+      { query, getRepository: () => ({ update: jest.fn() }) } as never,
+      { findById: jest.fn(), findAll: jest.fn() } as never,
+      {} as never,
+      {} as never,
+      { directSend } as never,
+      { notify } as never,
+      { emitPhase: jest.fn() } as never,
+    );
+    const run = (): Promise<void> =>
+      (
+        service as unknown as {
+          notifyIntercityCorridorScheduled: (s: TrainSchedule) => Promise<void>;
+        }
+      ).notifyIntercityCorridorScheduled(schedule);
+    return { run, query, directSend, notify };
+  };
+
+  it('sends one inbox item per booking and one SMS/email per company', async () => {
+    const { run, directSend, notify } = build([
+      {
+        bookingId: 'bk-1',
+        companyId: 'co-1',
+        phone: '+251900000001',
+        email: 'ops@co1.example',
+        corridor: 'Dire Dawa to Adama',
+      },
+      {
+        bookingId: 'bk-2',
+        companyId: 'co-1',
+        phone: '+251900000001',
+        email: 'ops@co1.example',
+        corridor: 'Adama to Mojo',
+      },
+    ]);
+
+    await run();
+
+    // Per booking: the marker keeps the next train on this corridor from
+    // re-announcing the same thing to the same booking.
+    expect(notify).toHaveBeenCalledTimes(2);
+    expect(notify.mock.calls.map((c) => c[0].data.intercityCorridorBookingId)).toEqual([
+      'bk-1',
+      'bk-2',
+    ]);
+    expect(notify.mock.calls[0][0].recipients).toEqual({ companyId: 'co-1' });
+    expect(notify.mock.calls[0][0].link).toBe('/bookings/bk-1');
+
+    // Per company: two bookings, one SMS and one email, both corridors named.
+    expect(directSend).toHaveBeenCalledTimes(2);
+    const [smsChannel, smsTo, smsBody] = directSend.mock.calls[0];
+    expect([smsChannel, smsTo]).toEqual(['sms', '+251900000001']);
+    expect(smsBody).toContain('Dire Dawa to Adama, Adama to Mojo');
+    expect(smsBody).toContain('01/08/2026');
+    expect(directSend.mock.calls[1][0]).toBe('email');
+  });
+
+  it('sends nothing when no waiting booking rides this corridor', async () => {
+    const { run, directSend, notify } = build([]);
+
+    await run();
+
+    expect(notify).not.toHaveBeenCalled();
+    expect(directSend).not.toHaveBeenCalled();
+  });
+
+  it('skips the channels a company has no contact for', async () => {
+    const { run, directSend, notify } = build([
+      {
+        bookingId: 'bk-3',
+        companyId: 'co-2',
+        phone: null,
+        email: 'ops@co2.example',
+        corridor: 'Dire Dawa to Adama',
+      },
+    ]);
+
+    await run();
+
+    expect(notify).toHaveBeenCalledTimes(1);
+    expect(directSend).toHaveBeenCalledTimes(1);
+    expect(directSend.mock.calls[0][0]).toBe('email');
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/train-checkpoint-events.repository.ts b/apps/edr-freight-api/src/modules/train-scheduling/repositories/train-checkpoint-events.repository.ts
similarity index 89%
rename from apps/edr-freight-api/src/modules/train-scheduling/train-checkpoint-events.repository.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/repositories/train-checkpoint-events.repository.ts
index 210de382e..195b2e596 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/train-checkpoint-events.repository.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/repositories/train-checkpoint-events.repository.ts
@@ -3,7 +3,7 @@ import { Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
 import { Repository } from 'typeorm';
 
-import { TrainCheckpointEvent } from './entities/train-checkpoint-event.entity';
+import { TrainCheckpointEvent } from '../entities/train-checkpoint-event.entity';
 
 @Injectable()
 export class TrainCheckpointEventsRepository extends BaseRepository<TrainCheckpointEvent> {
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/schedule-merge.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/schedule-merge.spec.ts
new file mode 100644
index 000000000..c3acfbecb
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/schedule-merge.spec.ts
@@ -0,0 +1,399 @@
+import { BadRequestException, NotFoundException } from '@nestjs/common';
+
+import { TrainSchedulingService } from './services/train-scheduling.service';
+
+/**
+ * Merging one train into a schedule. The schedule ALWAYS survives: its train
+ * set is repointed at the target train, that train's wagons join the consist,
+ * a same-day schedule on the target is absorbed (bookings move here, it is
+ * soft-deleted), and the emptied source train is deactivated.
+ *
+ * Driven against stub repositories — every rule under test is service logic.
+ */
+describe('TrainSchedulingService — train merge', () => {
+  const DAY = '2026-08-12T00:00:00.000Z';
+  const OTHER_DAY = '2026-08-14T00:00:00.000Z';
+
+  /** Rows each repository returns, keyed by entity. */
+  type Fixture = {
+    schedule: Record<string, unknown> | null;
+    train?: Record<string, unknown> | null;
+    trainSets?: Record<string, unknown>[];
+    schedules?: Record<string, unknown>[];
+    wagons?: Record<string, unknown>[];
+    wagonTypes?: Record<string, unknown>[];
+    scheduleBookings?: Record<string, unknown>[];
+    allocations?: Record<string, unknown>[];
+    milestones?: Record<string, unknown>[];
+    setWagons?: Record<string, unknown>[];
+  };
+
+  const makeService = (fx: Fixture) => {
+    const updates: Array<{ entity: string; args: unknown[] }> = [];
+    const softDeletes: string[] = [];
+
+    const repoFor = (entity: unknown) => {
+      const name = (entity as { name?: string })?.name ?? String(entity);
+      const rows = (): Record<string, unknown>[] => {
+        switch (name) {
+          case 'Train':
+            return fx.train ? [fx.train] : [];
+          case 'TrainSet':
+            return fx.trainSets ?? [];
+          case 'TrainSchedule':
+            return fx.schedules ?? [];
+          case 'Wagon':
+            return fx.wagons ?? [];
+          case 'WagonType':
+            return fx.wagonTypes ?? [];
+          case 'TrainScheduleBooking':
+            return fx.scheduleBookings ?? [];
+          case 'WagonBookingAllocation':
+            return fx.allocations ?? [];
+          case 'RouteMilestone':
+            return fx.milestones ?? [];
+          case 'TrainSetWagon':
+            return fx.setWagons ?? [];
+          default:
+            return [];
+        }
+      };
+      return {
+        find: jest.fn().mockImplementation(async () => rows()),
+        findOne: jest.fn().mockImplementation(async () => rows()[0] ?? null),
+        update: jest.fn().mockImplementation(async (...args: unknown[]) => {
+          updates.push({ entity: name, args });
+        }),
+        softDelete: jest.fn().mockImplementation(async (id: string) => {
+          softDeletes.push(id);
+        }),
+      };
+    };
+
+    const dataSource = {
+      getRepository: jest.fn().mockImplementation(repoFor),
+      transaction: jest
+        .fn()
+        .mockImplementation(async (cb: (m: unknown) => Promise<void>) =>
+          cb({ getRepository: repoFor }),
+        ),
+    };
+
+    const service = Object.create(
+      TrainSchedulingService.prototype,
+    ) as TrainSchedulingService;
+    Object.assign(service, {
+      dataSource,
+      trainSchedulesRepository: {
+        findByIdWithFullGraph: jest.fn().mockResolvedValue(fx.schedule),
+        findById: jest.fn().mockResolvedValue(fx.schedule),
+      },
+      logger: { log: jest.fn(), warn: jest.fn() },
+    });
+    return { service, updates, softDeletes };
+  };
+
+  /** A draft schedule on T1 with 10 wagons and no locomotive caps. */
+  const baseSchedule = (over: Record<string, unknown> = {}) => ({
+    id: 'S1',
+    reference: 'S-2026-00001',
+    status: 'DRAFT',
+    scheduledDepartureDate: DAY,
+    routeId: null,
+    maxWagons: 0,
+    trainSetId: 'TS1',
+    trainSet: {
+      id: 'TS1',
+      trainId: 'T1',
+      wagons: Array.from({ length: 10 }, (_, i) => ({
+        id: `sw-${i}`,
+        sequenceNo: i + 1,
+        lengthMeters: 14,
+        wagonType: { tareWeightTons: 22.4 },
+      })),
+    },
+    ...over,
+  });
+
+  const targetWagons = (n: number) =>
+    Array.from({ length: n }, (_, i) => ({
+      id: `w-${i}`,
+      wagonNumber: `200${i}`,
+      wagonTypeId: 'wt-1',
+      trainId: 'T2',
+    }));
+
+  describe('guards', () => {
+    it('refuses to merge into a dispatched schedule', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule({ status: 'DISPATCHED' }),
+      });
+
+      await expect(
+        service.mergeScheduleTrain('S1', { targetTrainId: 'T2' }),
+      ).rejects.toBeInstanceOf(BadRequestException);
+    });
+
+    it('refuses to merge a train into itself', async () => {
+      const { service } = makeService({ schedule: baseSchedule() });
+
+      await expect(
+        service.mergeScheduleTrain('S1', { targetTrainId: 'T1' }),
+      ).rejects.toThrow(/already this schedule's train/i);
+    });
+
+    it('404s on an unknown schedule', async () => {
+      const { service } = makeService({ schedule: null });
+
+      await expect(
+        service.mergeScheduleTrain('S1', { targetTrainId: 'T2' }),
+      ).rejects.toBeInstanceOf(NotFoundException);
+    });
+
+    it('blocks when the target train has no wagons to give', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        wagons: [],
+      });
+
+      await expect(
+        service.mergeScheduleTrain('S1', { targetTrainId: 'T2' }),
+      ).rejects.toThrow(/no wagons to merge/i);
+    });
+  });
+
+  describe('preview', () => {
+    it('reports the merged wagon total and the emptied source train', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2', trainNumber: '8002' },
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+      });
+
+      const preview = await service.previewMerge('S1', 'T2');
+
+      expect(preview.canMerge).toBe(true);
+      expect(preview.wagons).toEqual({ current: 10, incoming: 40, merged: 50 });
+      expect(preview.sourceTrainWillDeactivate).toBe(true);
+      expect(preview.absorbedSchedule).toBeNull();
+    });
+
+    it('names the same-day schedule whose bookings move here', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        trainSets: [{ id: 'TS2', trainId: 'T2' }],
+        schedules: [
+          {
+            id: 'S2',
+            reference: 'S-2026-00002',
+            status: 'SCHEDULED',
+            scheduledDepartureDate: DAY,
+            trainSetId: 'TS2',
+          },
+        ],
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+        scheduleBookings: [
+          { id: 'sb-1', bookingId: 'bk-1', trainScheduleId: 'S2' },
+          { id: 'sb-2', bookingId: 'bk-2', trainScheduleId: 'S2' },
+        ],
+      });
+
+      const preview = await service.previewMerge('S1', 'T2');
+
+      expect(preview.absorbedSchedule).toMatchObject({
+        id: 'S2',
+        reference: 'S-2026-00002',
+        bookingsMoving: 2,
+      });
+    });
+
+    it('lists an other-day schedule as wagons-only, never absorbed', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        trainSets: [{ id: 'TS2', trainId: 'T2' }],
+        schedules: [
+          {
+            id: 'S3',
+            reference: 'S-2026-00003',
+            status: 'DRAFT',
+            scheduledDepartureDate: OTHER_DAY,
+            trainSetId: 'TS2',
+          },
+        ],
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+      });
+
+      const preview = await service.previewMerge('S1', 'T2');
+
+      expect(preview.absorbedSchedule).toBeNull();
+      expect(preview.affectedSchedules).toHaveLength(1);
+      expect(preview.affectedSchedules[0]).toMatchObject({ id: 'S3' });
+    });
+
+    it('leaves a dispatched schedule on the target untouched', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        trainSets: [{ id: 'TS2', trainId: 'T2' }],
+        schedules: [
+          {
+            id: 'S4',
+            status: 'DISPATCHED',
+            scheduledDepartureDate: DAY,
+            trainSetId: 'TS2',
+          },
+        ],
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+      });
+
+      const preview = await service.previewMerge('S1', 'T2');
+
+      // Same day, but dispatched — its cargo stays put.
+      expect(preview.absorbedSchedule).toBeNull();
+      expect(preview.affectedSchedules).toHaveLength(0);
+      expect(preview.untouchedSchedules).toHaveLength(1);
+    });
+  });
+
+  describe('commit', () => {
+    it('repoints the set, moves the wagons and deactivates the source train', async () => {
+      const { service, updates } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+      });
+
+      await service.mergeScheduleTrain('S1', { targetTrainId: 'T2' });
+
+      const setRepoint = updates.find(
+        (u) => u.entity === 'TrainSet' && u.args[0] === 'TS1',
+      );
+      expect(setRepoint?.args[1]).toMatchObject({ trainId: 'T2' });
+
+      const wagonMove = updates.find((u) => u.entity === 'Wagon');
+      expect(wagonMove?.args[1]).toMatchObject({ trainId: 'T2' });
+
+      const trainPark = updates.find(
+        (u) => u.entity === 'Train' && u.args[0] === 'T1',
+      );
+      expect(trainPark?.args[1]).toMatchObject({ status: 'DEACTIVATED' });
+    });
+
+    it('moves the absorbed schedule\'s bookings here and soft-deletes it', async () => {
+      const { service, updates, softDeletes } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        trainSets: [{ id: 'TS2', trainId: 'T2' }],
+        schedules: [
+          {
+            id: 'S2',
+            reference: 'S-2026-00002',
+            status: 'SCHEDULED',
+            scheduledDepartureDate: DAY,
+            trainSetId: 'TS2',
+          },
+        ],
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+        scheduleBookings: [
+          { id: 'sb-1', bookingId: 'bk-1', trainScheduleId: 'S2' },
+        ],
+      });
+
+      await service.mergeScheduleTrain('S1', { targetTrainId: 'T2' });
+
+      const bookingMove = updates.find(
+        (u) => u.entity === 'TrainScheduleBooking',
+      );
+      expect(bookingMove?.args[0]).toMatchObject({ trainScheduleId: 'S2' });
+      expect(bookingMove?.args[1]).toMatchObject({ trainScheduleId: 'S1' });
+
+      // Soft-deleted, not cancelled — the bookings still exist and still depart.
+      expect(softDeletes).toEqual(['S2']);
+    });
+
+    it('appends merged wagons after the existing consist', async () => {
+      const { service, updates } = makeService({
+        schedule: baseSchedule(),
+        train: { id: 'T2', code: 'TR-2' },
+        wagons: targetWagons(2),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+        setWagons: [
+          { id: 'in-0', trainSetId: 'TS2', physicalWagonId: 'w-0' },
+          { id: 'in-1', trainSetId: 'TS2', physicalWagonId: 'w-1' },
+        ],
+      });
+
+      await service.mergeScheduleTrain('S1', { targetTrainId: 'T2' });
+
+      // 10 existing wagons occupy 1..10, so the merged pair lands at 11 and 12
+      // — staff reorder them in the train builder afterwards.
+      const seqs = updates
+        .filter((u) => u.entity === 'TrainSetWagon')
+        .map((u) => (u.args[1] as { sequenceNo: number }).sequenceNo);
+      expect(seqs).toEqual([11, 12]);
+    });
+  });
+
+  describe('capacity', () => {
+    it('blocks a merge that overruns the locomotive length cap', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule({
+          trainSet: {
+            id: 'TS1',
+            trainId: 'T1',
+            // A short loco: 100m of train, already 10 × 14m = 140m used.
+            locomotive: {
+              maxPullWeightTons: 5000,
+              maxTrainLengthMeters: 100,
+            },
+            wagons: Array.from({ length: 10 }, (_, i) => ({
+              id: `sw-${i}`,
+              sequenceNo: i + 1,
+              lengthMeters: 14,
+              wagonType: { tareWeightTons: 22.4 },
+            })),
+          },
+        }),
+        train: { id: 'T2', code: 'TR-2' },
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+      });
+
+      await expect(
+        service.mergeScheduleTrain('S1', { targetTrainId: 'T2' }),
+      ).rejects.toThrow(/exceeds max train length/i);
+    });
+
+    it('blocks a merge that overruns the pull-weight cap', async () => {
+      const { service } = makeService({
+        schedule: baseSchedule({
+          trainSet: {
+            id: 'TS1',
+            trainId: 'T1',
+            locomotive: {
+              maxPullWeightTons: 300,
+              maxTrainLengthMeters: 10000,
+            },
+            wagons: [],
+          },
+        }),
+        train: { id: 'T2', code: 'TR-2' },
+        wagons: targetWagons(40),
+        wagonTypes: [{ id: 'wt-1', lengthMeters: 14, tareWeightTons: 22.4 }],
+      });
+
+      await expect(
+        service.mergeScheduleTrain('S1', { targetTrainId: 'T2' }),
+      ).rejects.toThrow(/exceeds max pull weight/i);
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/schedule-train-number.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/schedule-train-number.spec.ts
new file mode 100644
index 000000000..d7dae50f4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/schedule-train-number.spec.ts
@@ -0,0 +1,114 @@
+import { BadRequestException, NotFoundException } from '@nestjs/common';
+
+import { TrainSchedulingService } from './services/train-scheduling.service';
+import type { UpdateScheduleTrainNumberDto } from './dto/update-schedule-train-number.dto';
+
+/**
+ * Guards around renumbering a departure. Exercised against a stub repository —
+ * the rules (dispatch lock, empty-body rejection, clear-vs-leave semantics) are
+ * pure service logic and need no database.
+ */
+describe('TrainSchedulingService.updateScheduleTrainNumber', () => {
+  const makeService = (schedule: Record<string, unknown> | null) => {
+    const update = jest.fn().mockResolvedValue(undefined);
+    const findById = jest.fn().mockResolvedValue(schedule);
+    const service = Object.create(
+      TrainSchedulingService.prototype,
+    ) as TrainSchedulingService;
+    Object.assign(service, {
+      trainSchedulesRepository: { findById, update },
+      logger: { log: jest.fn(), warn: jest.fn() },
+    });
+    return { service, update, findById };
+  };
+
+  const call = (service: TrainSchedulingService, dto: UpdateScheduleTrainNumberDto) =>
+    service.updateScheduleTrainNumber('sched-1', dto);
+
+  it('updates both numbers on a SCHEDULED train', async () => {
+    const { service, update } = makeService({
+      id: 'sched-1',
+      status: 'SCHEDULED',
+      trainNumber: '9101',
+      voyageNumber: null,
+    });
+
+    await call(service, { trainNumber: '9201', voyageNumber: 'V-2026-014' });
+
+    expect(update).toHaveBeenCalledWith('sched-1', {
+      trainNumber: '9201',
+      voyageNumber: 'V-2026-014',
+    });
+  });
+
+  it('refuses to renumber a dispatched train', async () => {
+    // The numbers are already printed on paperwork that left with the train.
+    const { service, update } = makeService({
+      id: 'sched-1',
+      status: 'DISPATCHED',
+      trainNumber: '9101',
+    });
+
+    await expect(call(service, { trainNumber: '9201' })).rejects.toBeInstanceOf(
+      BadRequestException,
+    );
+    expect(update).not.toHaveBeenCalled();
+  });
+
+  it.each(['ARRIVED', 'CANCELLED', 'COMPLETED'])(
+    'refuses to renumber a %s schedule',
+    async (status) => {
+      const { service, update } = makeService({ id: 'sched-1', status });
+
+      await expect(call(service, { trainNumber: '9201' })).rejects.toBeInstanceOf(
+        BadRequestException,
+      );
+      expect(update).not.toHaveBeenCalled();
+    },
+  );
+
+  it('rejects a body carrying neither number before touching the schedule', async () => {
+    const { service, update, findById } = makeService({
+      id: 'sched-1',
+      status: 'DRAFT',
+    });
+
+    await expect(call(service, {})).rejects.toBeInstanceOf(BadRequestException);
+    expect(findById).not.toHaveBeenCalled();
+    expect(update).not.toHaveBeenCalled();
+  });
+
+  it('leaves an omitted field untouched rather than clearing it', async () => {
+    const { service, update } = makeService({
+      id: 'sched-1',
+      status: 'DRAFT',
+      trainNumber: '9101',
+      voyageNumber: 'V-1',
+    });
+
+    await call(service, { trainNumber: '9201' });
+
+    expect(update).toHaveBeenCalledWith('sched-1', { trainNumber: '9201' });
+    expect(update.mock.calls[0][1]).not.toHaveProperty('voyageNumber');
+  });
+
+  it('clears a field when an empty string is sent', async () => {
+    const { service, update } = makeService({
+      id: 'sched-1',
+      status: 'DRAFT',
+      voyageNumber: 'V-1',
+    });
+
+    await call(service, { voyageNumber: '   ' });
+
+    expect(update).toHaveBeenCalledWith('sched-1', { voyageNumber: null });
+  });
+
+  it('404s on an unknown schedule', async () => {
+    const { service } = makeService(null);
+
+    await expect(call(service, { trainNumber: '9201' })).rejects.toBeInstanceOf(
+      NotFoundException,
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.service.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/services/train-scheduling.service.spec.ts
similarity index 88%
rename from apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.service.spec.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/services/train-scheduling.service.spec.ts
index 455dc3d9c..15cf4f592 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/services/train-scheduling.service.spec.ts
@@ -1,11 +1,11 @@
 import { BadRequestException, ConflictException } from '@nestjs/common';
 import { WagonStatus } from '@edr/types';
 
-import { Wagon } from '../wagons/entities/wagon.entity';
-import { WagonType } from '../wagon-types/entities/wagon-type.entity';
-import { TrainSetWagon } from '../train-sets/entities/train-set-wagon.entity';
-import { TrainSchedulingGlobalRules } from './entities/train-scheduling-global-rules.entity';
-import { WagonBookingAllocation } from '../train-schedules/entities/wagon-booking-allocation.entity';
+import { Wagon } from '../../wagons/entities/wagon.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { TrainSetWagon } from '../../train-sets/entities/train-set-wagon.entity';
+import { TrainSchedulingGlobalRules } from '../entities/train-scheduling-global-rules.entity';
+import { WagonBookingAllocation } from '../../train-schedules/entities/wagon-booking-allocation.entity';
 import { TrainSchedulingService } from './train-scheduling.service';
 
 const nw5 = {
@@ -94,6 +94,7 @@ describe('TrainSchedulingService', () => {
   let wagonBookingAllocationsRepository: Record<string, jest.Mock>;
   let wagonAllocationContainerItemsRepository: Record<string, jest.Mock>;
   let wagonAllocationBulkLoadsRepository: Record<string, jest.Mock>;
+  let trainCheckpointEventsRepository: Record<string, jest.Mock>;
 
   beforeEach(() => {
     // findGroupSiblings runs a query builder off dataSource.manager; default it
@@ -127,6 +128,7 @@ describe('TrainSchedulingService', () => {
       findByIdWithFullGraph: jest.fn(),
       findAll: jest.fn(),
       updateStatus: jest.fn(),
+      update: jest.fn(),
       maxReferenceSequence: jest.fn().mockResolvedValue(0),
     };
     trainScheduleBookingsRepository = {
@@ -150,7 +152,7 @@ describe('TrainSchedulingService', () => {
       findAll: jest.fn().mockResolvedValue([]),
     };
 
-    const trainCheckpointEventsRepository = {
+    trainCheckpointEventsRepository = {
       findBySchedule: jest.fn().mockResolvedValue([]),
       findAll: jest.fn().mockResolvedValue([]),
       create: jest.fn(),
@@ -181,6 +183,7 @@ describe('TrainSchedulingService', () => {
         autoArriveAtFinalYard: jest.fn().mockResolvedValue([]),
       } as never, // bookingJourneyService
       { dispatched: jest.fn(), arrived: jest.fn() } as never, // bookingNotifier
+      { getLogoImageUrl: jest.fn().mockResolvedValue(null) } as never, // logoSettings
     );
 
     const defaultFleetWagons = [
@@ -1131,6 +1134,36 @@ describe('TrainSchedulingService', () => {
       expect(html).toContain('2 (1 empty)');
     });
 
+    it('lists loaded empty containers by number and states they are empty', () => {
+      const schedule = {
+        id: 'schedule-1',
+        trainNumber: '8301',
+        direction: 'EXPORT',
+        trainSet: {
+          wagons: [makeWagon(1, 'W-001', []), makeWagon(2, 'W-002', []), makeWagon(3, 'W-003', [])],
+        },
+        scheduleBookings: [],
+      };
+
+      const html = (service as never as {
+        buildExportLoadListHtml: (s: unknown, o?: unknown) => string;
+      }).buildExportLoadListHtml(schedule, {
+        emptyContainers: [
+          { containerNumber: 'CMU9876543', containerSize: '40', wagonSequenceNo: 1 },
+          { containerNumber: 'TEMU1112223', containerSize: '20', wagonSequenceNo: 2 },
+          { containerNumber: 'TEMU4445556', containerSize: '20', wagonSequenceNo: 2 },
+        ],
+      });
+
+      expect(html).toContain('CMU9876543');
+      expect(html).toContain('TEMU1112223, TEMU4445556');
+      expect(html.match(/EMPTY CONTAINER/g)).toHaveLength(2);
+      // Wagon 3 carries nothing at all, so it keeps the bare-wagon wording.
+      expect(html.match(/EMPTY — no cargo allocated/g)).toHaveLength(1);
+      expect(html).toContain('3 (1 empty)');
+      expect(html).toContain('<span>Empty containers</span><strong>3</strong>');
+    });
+
     it('renders wagons in consist order regardless of the order the relation returns', () => {
       const schedule = {
         id: 'schedule-1',
@@ -1607,6 +1640,61 @@ describe('TrainSchedulingService', () => {
     });
   });
 
+  describe('updateCheckpoint — leg time correction', () => {
+    const t = (h: number) => new Date(Date.UTC(2026, 0, 1, h));
+    const schedule = {
+      id: 'sch-track',
+      status: 'ARRIVED',
+      routeId: null,
+      originStationId: 'y0',
+      destinationStationId: 'y1',
+      actualDepartureAt: t(8),
+    };
+    const events = () => [
+      { id: 'e0', yardId: 'y0', sequenceNo: 0, kind: 'DEPARTED', occurredAt: t(8) },
+      { id: 'e1', yardId: 'y1', sequenceNo: 1, kind: 'ARRIVED', occurredAt: t(12) },
+    ];
+
+    beforeEach(() => {
+      trainSchedulesRepository.findByIdWithFullGraph.mockResolvedValue(schedule);
+      trainCheckpointEventsRepository.findBySchedule.mockImplementation(async () => events());
+    });
+
+    it('rejects a leg time earlier than the previous leg', async () => {
+      await expect(
+        service.updateCheckpoint('sch-track', 1, { occurredAt: t(7).toISOString() }),
+      ).rejects.toThrow(/cannot be earlier than/);
+      expect(trainCheckpointEventsRepository.update).not.toHaveBeenCalled();
+    });
+
+    it('rejects a leg time later than the next leg', async () => {
+      await expect(
+        service.updateCheckpoint('sch-track', 0, { occurredAt: t(13).toISOString() }),
+      ).rejects.toThrow(/cannot be later than/);
+    });
+
+    it('rejects a future time', async () => {
+      const future = new Date(Date.now() + 3_600_000).toISOString();
+      await expect(
+        service.updateCheckpoint('sch-track', 1, { occurredAt: future }),
+      ).rejects.toThrow(/future/);
+    });
+
+    it('accepts an in-order past time and re-stamps arrival for the final leg', async () => {
+      await service.updateCheckpoint('sch-track', 1, {
+        occurredAt: t(11).toISOString(),
+        note: 'late log',
+      });
+      expect(trainCheckpointEventsRepository.update).toHaveBeenCalledWith('e1', {
+        occurredAt: t(11),
+        note: 'late log',
+      });
+      expect(trainSchedulesRepository.update).toHaveBeenCalledWith('sch-track', {
+        actualArrivalAt: t(11),
+      });
+    });
+  });
+
   describe('effectiveWagonsRequired', () => {
     const effective = (booking: unknown): number =>
       (service as never as { effectiveWagonsRequired(b: unknown): number })
@@ -1646,4 +1734,118 @@ describe('TrainSchedulingService', () => {
       ).toBe(5);
     });
   });
+
+  describe('maintenanceReschedule — window reopens when it had already finished', () => {
+    const { TrainSchedule } = jest.requireActual(
+      '../../train-schedules/entities/train-schedule.entity',
+    );
+
+    const doneExportSchedule = (extra: Record<string, unknown> = {}) => ({
+      id: 'sch-done',
+      status: 'SCHEDULED',
+      direction: 'EXPORT',
+      windowPhase: 'DONE',
+      bookingWindowStatus: 'CLOSED',
+      scheduledDepartureDate: new Date('2027-06-20T05:00:00.000Z'),
+      scheduledArrivalDate: null,
+      originStationId: 'yard-origin',
+      destinationStationId: 'yard-destination',
+      scheduleBookings: [],
+      // Frozen rule snapshot: desk 8–17 EAT, 24h lead, close 120min before departure.
+      ruleWindowOpenHour: 8,
+      ruleWindowCloseHour: 17,
+      ruleExportBookingLeadHours: 24,
+      ruleExportCloseOffsetMinutes: 120,
+      ...extra,
+    });
+
+    let scheduleUpdate: jest.Mock;
+
+    beforeEach(() => {
+      scheduleUpdate = jest.fn().mockResolvedValue({ affected: 1 });
+      dataSource.getRepository.mockImplementation((entity: unknown) => {
+        if (entity === TrainSchedulingGlobalRules) {
+          return { find: jest.fn().mockResolvedValue([]) };
+        }
+        if (entity === TrainSchedule) {
+          return { update: scheduleUpdate, find: jest.fn().mockResolvedValue([]) };
+        }
+        return {
+          find: jest.fn().mockResolvedValue([]),
+          findOne: jest.fn().mockResolvedValue(null),
+          update: jest.fn(),
+        };
+      });
+      trainSchedulesRepository.findById.mockResolvedValue(null);
+    });
+
+    it('reopens a DONE export window against the new departure', async () => {
+      trainSchedulesRepository.findByIdWithFullGraph.mockResolvedValue(
+        doneExportSchedule(),
+      );
+
+      // New departure 12:00 EAT → window opens 24h earlier (12:00 EAT, inside
+      // the desk) and closes at departure − 120min = 10:00 EAT.
+      await service.maintenanceReschedule('sch-done', {
+        newDepartureDate: '2027-06-20T09:00:00.000Z',
+      } as never);
+
+      expect(scheduleUpdate).toHaveBeenCalledWith(
+        'sch-done',
+        expect.objectContaining({
+          scheduledDepartureDate: new Date('2027-06-20T09:00:00.000Z'),
+          windowPhase: 'PRE_WINDOW',
+          bookingWindowStatus: 'CLOSED',
+          windowOpensAt: new Date('2027-06-19T09:00:00.000Z'),
+          windowClosesAt: new Date('2027-06-20T07:00:00.000Z'),
+          docReviewCompletedAt: null,
+          docReviewEndsAt: null,
+          paymentPhaseEndsAt: null,
+        }),
+      );
+    });
+
+    it('keeps a FULL train closed — nothing left to sell', async () => {
+      trainSchedulesRepository.findByIdWithFullGraph.mockResolvedValue(
+        doneExportSchedule({ bookingWindowStatus: 'FULL' }),
+      );
+
+      await service.maintenanceReschedule('sch-done', {
+        newDepartureDate: '2027-06-20T09:00:00.000Z',
+      } as never);
+
+      const written = scheduleUpdate.mock.calls[0][1];
+      expect(written.scheduledDepartureDate).toEqual(
+        new Date('2027-06-20T09:00:00.000Z'),
+      );
+      expect(written.windowPhase).toBeUndefined();
+      expect(written.windowOpensAt).toBeUndefined();
+    });
+
+    it('moves an OPEN export close to the new departure but keeps the open', async () => {
+      const opensAt = new Date('2027-06-19T03:00:00.000Z');
+      trainSchedulesRepository.findByIdWithFullGraph.mockResolvedValue(
+        doneExportSchedule({
+          windowPhase: 'OPEN',
+          bookingWindowStatus: 'OPEN',
+          windowOpensAt: opensAt,
+          windowClosesAt: new Date('2027-06-20T03:00:00.000Z'),
+        }),
+      );
+
+      // Departure pushed 3 days later → close = new departure − 120min; the
+      // open customers already booked against stays untouched.
+      await service.maintenanceReschedule('sch-done', {
+        newDepartureDate: '2027-06-23T05:00:00.000Z',
+      } as never);
+
+      const written = scheduleUpdate.mock.calls[0][1];
+      expect(written.scheduledDepartureDate).toEqual(
+        new Date('2027-06-23T05:00:00.000Z'),
+      );
+      expect(written.windowClosesAt).toEqual(new Date('2027-06-23T03:00:00.000Z'));
+      expect(written.windowOpensAt).toBeUndefined();
+      expect(written.windowPhase).toBeUndefined();
+    });
+  });
 });
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.service.ts b/apps/edr-freight-api/src/modules/train-scheduling/services/train-scheduling.service.ts
similarity index 85%
rename from apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.service.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/services/train-scheduling.service.ts
index 9a03f665c..9a20c0486 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.service.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/services/train-scheduling.service.ts
@@ -21,7 +21,6 @@ import {
 } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { InjectDataSource } from '@nestjs/typeorm';
-import { SCHEDULE_BOOKINGS_CTE } from '../../common/schedule-bookings.sql';
 import {
   DataSource,
   EntityManager,
@@ -37,71 +36,75 @@ import {
 import {
   buildPaginationMeta,
   normalizePagination,
-} from '../../common/utils/pagination.util';
-import { BookingsRepository } from '../bookings/bookings.repository';
-import { Booking } from '../bookings/entities/booking.entity';
-import { BookingContainer } from '../bookings/entities/booking-container.entity';
-import { ClearanceMilestone } from '../contracts/entities/clearance-milestone.entity';
-import { ClearanceMilestoneService } from '../contracts/clearance-milestone.service';
-import { Contract } from '../contracts/entities/contract.entity';
-import { Container } from '../container-management/entities/container.entity';
-import { Locomotive } from '../locomotives/entities/locomotive.entity';
-import { LocomotivesRepository } from '../locomotives/locomotives.repository';
-import { formatRouteLabel, Route } from '../routes/entities/route.entity';
-import { WagonMovement } from '../wagons/entities/wagon-movement.entity';
-import { Train } from '../trains/entities/train.entity';
-import { TrainSetLocomotive } from '../train-sets/entities/train-set-locomotive.entity';
-import { TrainSetWagon } from '../train-sets/entities/train-set-wagon.entity';
-import { TrainSet } from '../train-sets/entities/train-set.entity';
-import { ScheduleWagonAdjustmentLog } from '../train-schedules/entities/schedule-wagon-adjustment-log.entity';
-import { TrainScheduleBooking } from '../train-schedules/entities/train-schedule-booking.entity';
-import { TrainSchedule } from '../train-schedules/entities/train-schedule.entity';
-import { WagonAllocationContainerItem } from '../train-schedules/entities/wagon-allocation-container-item.entity';
-import { WagonBookingAllocation } from '../train-schedules/entities/wagon-booking-allocation.entity';
-import { TrainScheduleBookingsRepository } from '../train-schedules/train-schedule-bookings.repository';
-import { TrainSchedulesRepository } from '../train-schedules/train-schedules.repository';
-import { TrainCompositionRemovalLogRepository } from '../train-schedules/train-composition-removal-log.repository';
-import { WagonAllocationBulkLoadsRepository } from '../train-schedules/wagon-allocation-bulk-loads.repository';
-import { WagonAllocationContainerItemsRepository } from '../train-schedules/wagon-allocation-container-items.repository';
-import { WagonBookingAllocationsRepository } from '../train-schedules/wagon-booking-allocations.repository';
-import { Yard } from '../rule-engine/entities/yard.entity';
-import { WagonType } from '../wagon-types/entities/wagon-type.entity';
-import { WagonTypesRepository } from '../wagon-types/wagon-types.repository';
-import { Wagon } from '../wagons/entities/wagon.entity';
-import { AdjustScheduleConsistDto } from './dto/adjust-schedule-consist.dto';
-import { AssignBookingsDto } from './dto/assign-bookings.dto';
-import { CreateContainerTrainScheduleDto } from './dto/create-container-train-schedule.dto';
-import { GetEligibleBookingsDto } from './dto/get-eligible-bookings.dto';
-import { GetEligibleBulkBookingsDto } from './dto/get-eligible-bulk-bookings.dto';
-import { GetEligibleContainerBookingsDto } from './dto/get-eligible-container-bookings.dto';
+} from '../../../common/utils/pagination.util';
+import { BookingsRepository } from '../../bookings/bookings.repository';
+import { Booking } from '../../bookings/entities/booking.entity';
+import { BookingContainer } from '../../bookings/entities/booking-container.entity';
+import { ClearanceMilestone } from '../../contracts/entities/clearance-milestone.entity';
+import { ClearanceMilestoneService } from '../../contracts/clearance-milestone.service';
+import { Contract } from '../../contracts/entities/contract.entity';
+import { Container } from '../../container-management/entities/container.entity';
+import { Locomotive } from '../../locomotives/entities/locomotive.entity';
+import { LocomotivesRepository } from '../../locomotives/locomotives.repository';
+import { formatRouteLabel, Route } from '../../routes/entities/route.entity';
+import { ShippingLineCompany } from '../../shipping-lines/entities/shipping-line-company.entity';
+import { WagonMovement } from '../../wagons/entities/wagon-movement.entity';
+import { Train } from '../../trains/entities/train.entity';
+import { TrainSetLocomotive } from '../../train-sets/entities/train-set-locomotive.entity';
+import { TrainSetWagon } from '../../train-sets/entities/train-set-wagon.entity';
+import { TrainSet } from '../../train-sets/entities/train-set.entity';
+import { ScheduleWagonAdjustmentLog } from '../../train-schedules/entities/schedule-wagon-adjustment-log.entity';
+import { TrainScheduleBooking } from '../../train-schedules/entities/train-schedule-booking.entity';
+import { TrainSchedule } from '../../train-schedules/entities/train-schedule.entity';
+import { WagonAllocationContainerItem } from '../../train-schedules/entities/wagon-allocation-container-item.entity';
+import { WagonBookingAllocation } from '../../train-schedules/entities/wagon-booking-allocation.entity';
+import { TrainScheduleBookingsRepository } from '../../train-schedules/train-schedule-bookings.repository';
+import { TrainSchedulesRepository } from '../../train-schedules/train-schedules.repository';
+import { TrainCompositionRemovalLogRepository } from '../../train-schedules/train-composition-removal-log.repository';
+import { WagonAllocationBulkLoadsRepository } from '../../train-schedules/wagon-allocation-bulk-loads.repository';
+import { WagonAllocationContainerItemsRepository } from '../../train-schedules/wagon-allocation-container-items.repository';
+import { WagonBookingAllocationsRepository } from '../../train-schedules/wagon-booking-allocations.repository';
+import { Yard } from '../../rule-engine/entities/yard.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+import { WagonTypesRepository } from '../../wagon-types/wagon-types.repository';
+import { Wagon } from '../../wagons/entities/wagon.entity';
+import { AdjustScheduleConsistDto } from '../dto/adjust-schedule-consist.dto';
+import { AssignBookingsDto } from '../dto/assign-bookings.dto';
+import { CreateContainerTrainScheduleDto } from '../dto/create-container-train-schedule.dto';
+import { GetEligibleBookingsDto } from '../dto/get-eligible-bookings.dto';
+import { GetEligibleBulkBookingsDto } from '../dto/get-eligible-bulk-bookings.dto';
+import { GetEligibleContainerBookingsDto } from '../dto/get-eligible-container-bookings.dto';
 import {
   ListTrainSchedulesQueryDto,
   TrainScheduleFreightType,
-} from './dto/list-train-schedules-query.dto';
-import { PinWagonsDto } from './dto/pin-wagons.dto';
-import { MoveWagonLoadDto } from './dto/move-wagon-load.dto';
-import { UpdateContainerItemDto } from './dto/update-container-item.dto';
-import { UpdateImportLoadingStatusDto } from './dto/update-import-loading-status.dto';
-import { PreviewBulkTrainScheduleDto } from './dto/preview-bulk-train-schedule.dto';
-import { PreviewContainerTrainScheduleDto } from './dto/preview-container-train-schedule.dto';
-import { PreviewTrainScheduleDto } from './dto/preview-train-schedule.dto';
-import { TrainSchedulingGlobalRules } from './entities/train-scheduling-global-rules.entity';
+} from '../dto/list-train-schedules-query.dto';
+import { PinWagonsDto } from '../dto/pin-wagons.dto';
+import { MoveWagonLoadDto } from '../dto/move-wagon-load.dto';
+import { UpdateContainerItemDto } from '../dto/update-container-item.dto';
+import { UpdateImportLoadingStatusDto } from '../dto/update-import-loading-status.dto';
+import { PreviewBulkTrainScheduleDto } from '../dto/preview-bulk-train-schedule.dto';
+import { PreviewContainerTrainScheduleDto } from '../dto/preview-container-train-schedule.dto';
+import { PreviewTrainScheduleDto } from '../dto/preview-train-schedule.dto';
+import { TrainSchedulingGlobalRules } from '../entities/train-scheduling-global-rules.entity';
+import { UpdateTrainSchedulingGlobalRulesDto } from '../dto/update-train-scheduling-global-rules.dto';
 import {
   ImportDjiboutiOperation,
   type ImportDjiboutiDocumentType,
-} from './entities/import-djibouti-operation.entity';
+} from '../entities/import-djibouti-operation.entity';
+import { EmptyContainerReturn } from '../../import-operations/entities/empty-container-return.entity';
 import {
   ImportDjiboutiActionDto,
   UploadImportDjiboutiDocumentDto,
-} from './dto/import-djibouti-operation.dto';
-import { UpdateTrainSchedulingGlobalRulesDto } from './dto/update-train-scheduling-global-rules.dto';
-import { UpdateScheduleWindowRuleDto } from './dto/update-schedule-window-rule.dto';
-import { UpdateScheduleDateDto } from './dto/update-schedule-date.dto';
-import { MaintenanceRescheduleDto } from './dto/maintenance-reschedule.dto';
-import { type BookingWindowConfig } from './booking-window.config';
-import { BookingWindowGateway } from './booking-window.gateway';
-import { BookingNotifierService } from './booking-notifier.service';
-import { BookingBatchService } from './booking-batch.service';
+} from '../dto/import-djibouti-operation.dto';
+import { UpdateScheduleWindowRuleDto } from '../dto/update-schedule-window-rule.dto';
+import { UpdateScheduleDateDto } from '../dto/update-schedule-date.dto';
+import { MergeScheduleTrainDto } from '../dto/merge-schedule-train.dto';
+import { UpdateScheduleTrainNumberDto } from '../dto/update-schedule-train-number.dto';
+import { MaintenanceRescheduleDto } from '../dto/maintenance-reschedule.dto';
+import { type BookingWindowConfig } from '../booking-window.config';
+import { BookingWindowGateway } from '../booking-window.gateway';
+import { BookingNotifierService } from '../booking-notifier.service';
+import { BookingBatchService } from '../booking-batch.service';
 import {
   computeFleetAvailability,
   summarizeFleetWarnings,
@@ -110,13 +113,13 @@ import {
   type BookingWagonShortage,
   type DeferredBookingRow,
   type FleetAvailabilityRow,
-} from './fleet-plan.util';
+} from '../utils/fleet-plan.util';
 import {
   applyWagonOrderReversal,
   planWagonsWithStock,
   type AllowedWagonTypeMap,
   type WagonStock,
-} from './wagon-plan-flex.util';
+} from '../wagon-plan-flex.util';
 import {
   containerWagonsForLines,
   expandBookingContainerUnits,
@@ -128,24 +131,28 @@ import {
   perEdgeConsistUsage,
   validateContainerPlacements,
   validateMixedTrainLimitsPerEdge,
+  MAX_TEU_SLOTS_PER_WAGON,
   type ContainerPlacementInput,
   type WagonPlanSlot,
-} from './wagon-plan.util';
-import { CorridorBudget } from './corridor-capacity.util';
-import { deriveScheduleDirection } from './derive-schedule-direction.util';
-import { pickLowestFreeNumber, pickTrainNumberPool } from './train-number.util';
+} from '../utils/wagon-plan.util';
+import { CorridorBudget } from '../corridor-capacity.util';
+import { deriveScheduleDirection } from '../utils/derive-schedule-direction.util';
+import { computeScheduleWagonUsage } from '../utils/schedule-wagon-usage.util';
+import { pickLowestFreeNumber, pickTrainNumberPool } from '../train-number.util';
 import {
   bookingCargoTons,
   bulkItemsFitFor,
   bulkItemWagonsRequired,
   bulkTonsPerWagon,
+  consistViolations,
   deriveTrainCapacityFromLocomotive,
   combinedLocomotiveLimits,
+  trainHardCaps,
   trainSetLocomotiveLimits,
   wagonTypeDimensionsFromEntity,
   LocomotiveLimits,
   WagonTypeDimensions,
-} from './train-capacity.util';
+} from '../train-capacity.util';
 import {
   DEFAULT_BULK_WAGON_CAPACITY_TONS,
   DEFAULT_BULK_WAGON_LENGTH_METERS,
@@ -154,31 +161,39 @@ import {
   DEFAULT_CONTAINER_WAGON_LENGTH_METERS,
   DEFAULT_CONTAINER_WAGON_TARE_TONS,
   paymentDrainEndsAtIso,
-} from './booking-batch.constants';
-import { orderConsistWagons } from './consist-order.util';
+} from '../booking-batch.constants';
+import { orderConsistWagons } from '../consist-order.util';
 import {
+  bookingCloseCutoff,
+  clampCloseToOfficeHours,
   computeExportWindowTimes,
   computeImportWindowTimes,
   earliestSchedulableDeparture,
   eatDay,
   eatDayToUtc,
   shiftEatDay,
-} from './batch-window.util';
-import { TrainCheckpointEvent } from './entities/train-checkpoint-event.entity';
-import { BookingJourneyService } from './booking-journey.service';
-import { TrainCheckpointEventsRepository } from './train-checkpoint-events.repository';
-import { RecordCheckpointDto } from './dto/record-checkpoint.dto';
-import { RouteMilestone } from '../routes/entities/route-milestone.entity';
-import { deriveTradeDirection } from '../../common/derive-trade-direction.util';
-import { WarehouseInventoryService } from '../warehouses/warehouse-inventory.service';
-import { WarehouseReleaseDocumentService } from '../warehouses/warehouse-release-document.service';
+} from '../batch-window.util';
+import { TrainCheckpointEvent } from '../entities/train-checkpoint-event.entity';
+import { BookingJourneyService } from '../booking-journey.service';
+import { TrainCheckpointEventsRepository } from '../repositories/train-checkpoint-events.repository';
+import {
+  DispatchScheduleDto,
+  RecordCheckpointDto,
+  UpdateCheckpointDto,
+} from '../dto/record-checkpoint.dto';
+import { RouteMilestone } from '../../routes/entities/route-milestone.entity';
+import { deriveTradeDirection } from '../../../common/derive-trade-direction.util';
+import { WarehouseInventoryService } from '../../warehouses/warehouse-inventory.service';
+import { WarehouseReleaseDocumentService } from '../../warehouses/warehouse-release-document.service';
+import { LogoSettingsService } from '../../logo-settings/logo-settings.service';
+import { logoImageCss, logoMarkup } from '../../billing/documents/logo-markup.util';
 import {
   autoFillPlacements,
   findMissingContainerNumberIssues,
   isPlaceholderContainerNumber,
   placementsForBookings,
   type ContainerUnitForPlacement,
-} from './container-placement.util';
+} from '../container-placement.util';
 
 const SCHEDULABLE_BOOKING_STATUSES = ['PAID'] as const;
 
@@ -326,6 +341,8 @@ const DEFAULT_TRAIN_LIMITS: Required<TrainLimitConfig> = {
 interface BookingWindowRow {
   schedule_id: string;
   reference: string | null;
+  /** Operational run number (e.g. 8001 import / 8002 export), typed by staff. */
+  train_number: string | null;
   contract_id: string | null;
   contract_kind: string | null;
   direction: string | null;
@@ -369,6 +386,7 @@ export class TrainSchedulingService {
     private readonly bookingWindowGateway: BookingWindowGateway,
     private readonly bookingJourneyService: BookingJourneyService,
     private readonly bookingNotifier: BookingNotifierService,
+    private readonly logoSettings: LogoSettingsService,
     @Optional() private readonly milestoneService?: ClearanceMilestoneService,
     private readonly configService?: ConfigService,
     // forwardRef: BookingBatchService injects this service back; @Optional so
@@ -457,10 +475,14 @@ export class TrainSchedulingService {
    * used for lifecycle changes outside the window tick (create, cancel,
    * finalize, restamp). A push failure must never break the mutation.
    */
-  private async emitWindowState(scheduleId: string): Promise<void> {
+  async emitWindowState(scheduleId: string): Promise<void> {
     try {
       const fresh = await this.trainSchedulesRepository.findById(scheduleId);
-      if (fresh) this.bookingWindowGateway.emitPhase(fresh);
+      // Dedicated shipping-line departures are never announced to the portal —
+      // the broadcast reaches every customer client.
+      if (fresh && !fresh.shippingLineCompanyId) {
+        this.bookingWindowGateway.emitPhase(fresh);
+      }
     } catch (err) {
       this.logger.warn(
         `Booking-window push failed for ${scheduleId}: ${(err as Error).message}`,
@@ -501,7 +523,11 @@ export class TrainSchedulingService {
       // and a newborn anchoring to it would inherit that dead window verbatim.
       .andWhere('s.status != :cancelledStatus', {
         cancelledStatus: TrainScheduleStatusEnum.Cancelled,
-      });
+      })
+      // A dedicated shipping-line departure is never a sibling either: it runs
+      // no window cycle, so it must neither anchor a customer group nor be
+      // dragged through one's open/doc-review/payment instants.
+      .andWhere('s.shippingLineCompanyId IS NULL');
     if (excludeScheduleId) {
       qb.andWhere('s.id != :excludeScheduleId', { excludeScheduleId });
     }
@@ -929,6 +955,68 @@ export class TrainSchedulingService {
     return fresh ?? schedule;
   }
 
+  /**
+   * Correct a departure's operational run identifiers — the train number and
+   * voyage number yards and customs quote.
+   *
+   * Editable only until the train leaves: once DISPATCHED (or beyond) the
+   * numbers are printed on paperwork and quoted downstream, so a late edit would
+   * desync records that already left with the train. The audit row is written by
+   * the global AuditInterceptor from the registered route.
+   */
+  async updateScheduleTrainNumber(
+    id: string,
+    dto: UpdateScheduleTrainNumberDto,
+  ): Promise<TrainSchedule> {
+    if (dto.trainNumber === undefined && dto.voyageNumber === undefined) {
+      throw new BadRequestException(
+        'Provide a train number or a voyage number to update.',
+      );
+    }
+
+    const schedule = await this.trainSchedulesRepository.findById(id);
+    if (!schedule) {
+      throw new NotFoundException(`Train schedule ${id} not found`);
+    }
+
+    // Only a train that has not left can be renumbered. CANCELLED is excluded
+    // too — renumbering a dead schedule has no meaning.
+    const editable: string[] = [
+      TrainScheduleStatusEnum.Draft,
+      TrainScheduleStatusEnum.Scheduled,
+    ];
+    if (!editable.includes(schedule.status)) {
+      throw new BadRequestException(
+        `Cannot change the train or voyage number of a ${schedule.status} schedule — ` +
+          'the numbers are fixed once the train is dispatched.',
+      );
+    }
+
+    // An empty string clears the field; an omitted field is left untouched.
+    const patch: Partial<TrainSchedule> = {};
+    if (dto.trainNumber !== undefined) {
+      patch.trainNumber = dto.trainNumber.trim() || null;
+    }
+    if (dto.voyageNumber !== undefined) {
+      patch.voyageNumber = dto.voyageNumber.trim() || null;
+    }
+
+    await this.trainSchedulesRepository.update(id, patch);
+    this.logger.log(
+      `Schedule ${schedule.reference ?? id} renumbered` +
+        (patch.trainNumber !== undefined
+          ? ` — train ${schedule.trainNumber ?? '—'} → ${patch.trainNumber ?? '—'}`
+          : '') +
+        (patch.voyageNumber !== undefined
+          ? ` — voyage ${schedule.voyageNumber ?? '—'} → ${patch.voyageNumber ?? '—'}`
+          : '') +
+        (dto.reason?.trim() ? ` (${dto.reason.trim()})` : ''),
+    );
+
+    const fresh = await this.trainSchedulesRepository.findById(id);
+    return fresh ?? schedule;
+  }
+
   /**
    * Reschedule ONE train's departure date (staff action on the ops board). Only
    * allowed while the booking window has not opened yet — an OPEN/past schedule
@@ -1072,6 +1160,124 @@ export class TrainSchedulingService {
     return fresh ?? schedule;
   }
 
+  /**
+   * Booking-window fields that must follow a train's departure moving to
+   * `departure` (any window phase). Shared by every reschedule path so the
+   * "closes in" countdown always tracks the real departure.
+   *
+   * PRE_WINDOW: the stamped open/close were derived from the old departure
+   * and the window hasn't opened yet, so re-derive them from the schedule's
+   * own rule snapshot against the new date (joining the target day's route
+   * group timeline when one exists, exactly like updateScheduleDate).
+   *
+   * DONE: the window already finished (e.g. the close offset hit and then the
+   * train was moved to a later departure). The window must follow the new
+   * departure, so it REOPENS: re-derive open/close the same way, reset the
+   * phase to PRE_WINDOW and clamp a past open into the present so the tick
+   * opens it immediately. A FULL train stays closed — there is nothing left
+   * to sell — and so does one whose re-derived window would already be over.
+   *
+   * OPEN: customers are already booking against the open they were shown, so
+   * the open stays put — but the close was capped at the OLD departure's
+   * cutoff, so it must follow the new one (import: open + duration under
+   * office hours, capped at the cutoff; export: the cutoff itself). Moving
+   * the train later extends the "closes in" countdown, moving it earlier
+   * shortens it (a close now in the past is picked up by the next tick).
+   *
+   * DOC_REVIEW/PAYMENT keep their running timeline.
+   */
+  async windowFieldsForNewDeparture(
+    schedule: TrainSchedule,
+    departure: Date,
+  ): Promise<
+    Partial<
+      Pick<
+        TrainSchedule,
+        | 'windowOpensAt'
+        | 'windowClosesAt'
+        | 'windowPhase'
+        | 'bookingWindowStatus'
+        | 'docReviewCompletedAt'
+        | 'docReviewEndsAt'
+        | 'paymentPhaseEndsAt'
+      >
+    >
+  > {
+    const reopenFromDone =
+      schedule.windowPhase === 'DONE' && schedule.bookingWindowStatus !== 'FULL';
+    const shiftOpenClose =
+      schedule.windowPhase === 'OPEN' && schedule.windowOpensAt != null;
+    const windowFields =
+      shiftOpenClose
+        ? await (async () => {
+            const merged = effectiveWindowConfig(
+              schedule,
+              await this.getWindowConfig(),
+            );
+            const opensAt = schedule.windowOpensAt!;
+            const cutoff = bookingCloseCutoff(departure, schedule.direction, merged);
+            let closesAt = cutoff;
+            if (schedule.direction !== 'EXPORT') {
+              closesAt = clampCloseToOfficeHours(
+                opensAt,
+                new Date(opensAt.getTime() + merged.windowDurationHours * 3_600_000),
+                merged,
+              );
+              if (closesAt.getTime() > cutoff.getTime()) closesAt = cutoff;
+            }
+            return { windowClosesAt: closesAt };
+          })()
+        : schedule.windowPhase === 'PRE_WINDOW' || reopenFromDone
+        ? await (async () => {
+            const merged = effectiveWindowConfig(
+              schedule,
+              await this.getWindowConfig(),
+            );
+            const times =
+              schedule.direction === 'EXPORT'
+                ? computeExportWindowTimes(departure, merged)
+                : computeImportWindowTimes(departure, merged, new Date());
+            const anchor =
+              schedule.direction === 'EXPORT'
+                ? null
+                : await this.findGroupWindowAnchor(
+                    this.dataSource.manager,
+                    schedule.originStationId,
+                    schedule.destinationStationId,
+                    departure,
+                  );
+            if (anchor) {
+              // groupWindowFieldsFrom copies the anchor's live phase and
+              // deadlines, so a DONE train joining a live group re-enters the
+              // group's cycle directly — no extra reset needed.
+              return this.groupWindowFieldsFrom(anchor, departure);
+            }
+            if (!reopenFromDone) {
+              return {
+                windowOpensAt: times.windowOpensAt,
+                windowClosesAt: times.windowClosesAt,
+              };
+            }
+            const now = new Date();
+            const windowOpensAt =
+              times.windowOpensAt < now ? now : times.windowOpensAt;
+            if (times.windowClosesAt.getTime() <= windowOpensAt.getTime()) {
+              return {}; // no window fits before the new departure — stay closed
+            }
+            return {
+              windowOpensAt,
+              windowClosesAt: times.windowClosesAt,
+              windowPhase: 'PRE_WINDOW',
+              bookingWindowStatus: 'CLOSED',
+              docReviewCompletedAt: null,
+              docReviewEndsAt: null,
+              paymentPhaseEndsAt: null,
+            };
+          })()
+        : {};
+    return windowFields;
+  }
+
   /**
    * Maintenance reschedule: the admin moves a train (with everything aboard) to
    * a new departure. Unlike {@link updateScheduleDate} this runs at ANY window
@@ -1082,9 +1288,10 @@ export class TrainSchedulingService {
    *    aboard/targeted booking's scheduledDate (the day-pool queries key on it,
    *    so a booking left on the old day would fall out of its own train's pool).
    *  - STAYS: train set, wagon assignments, schedule↔booking links, route,
-   *    maxWagons, and the window RULE snapshot. Stamped window times are only
-   *    re-derived for PRE_WINDOW schedules (their window hasn't run yet); a
-   *    schedule mid- or post-window keeps its timeline untouched.
+   *    maxWagons, and the window RULE snapshot. Stamped window times are
+   *    re-derived for PRE_WINDOW schedules (their window hasn't run yet); an
+   *    OPEN schedule keeps its open but its close follows the new departure;
+   *    DOC_REVIEW/PAYMENT keep their timeline untouched.
    *
    * Customers of every moved booking are notified (maintenanceMoved).
    */
@@ -1116,39 +1323,7 @@ export class TrainSchedulingService {
       ? new Date(new Date(schedule.scheduledArrivalDate).getTime() + deltaMs)
       : undefined;
 
-    // PRE_WINDOW only: the stamped open/close were derived from the old
-    // departure and the window hasn't opened yet, so re-derive them from the
-    // schedule's own rule snapshot against the new date (joining the target
-    // day's route group timeline when one exists, exactly like
-    // updateScheduleDate). Mid/post-window schedules keep their timeline.
-    const windowFields =
-      schedule.windowPhase === 'PRE_WINDOW'
-        ? await (async () => {
-            const merged = effectiveWindowConfig(
-              schedule,
-              await this.getWindowConfig(),
-            );
-            const times =
-              schedule.direction === 'EXPORT'
-                ? computeExportWindowTimes(departure, merged)
-                : computeImportWindowTimes(departure, merged, new Date());
-            const anchor =
-              schedule.direction === 'EXPORT'
-                ? null
-                : await this.findGroupWindowAnchor(
-                    this.dataSource.manager,
-                    schedule.originStationId,
-                    schedule.destinationStationId,
-                    departure,
-                  );
-            return anchor
-              ? this.groupWindowFieldsFrom(anchor, departure)
-              : {
-                  windowOpensAt: times.windowOpensAt,
-                  windowClosesAt: times.windowClosesAt,
-                };
-          })()
-        : {};
+    const windowFields = await this.windowFieldsForNewDeparture(schedule, departure);
 
     await this.dataSource.getRepository(TrainSchedule).update(id, {
       scheduledDepartureDate: departure,
@@ -1193,7 +1368,7 @@ export class TrainSchedulingService {
    * in the future) using the CURRENT global-rules config. Schedules already OPEN or
    * past their window are left untouched — customers may have booked against the
    * times they were shown, so those stay frozen. Returns the count re-stamped.
-   */
+   */ 
   async restampPendingWindows(): Promise<number> {
     const cfg = await this.getWindowConfig();
     const now = new Date();
@@ -1358,6 +1533,24 @@ export class TrainSchedulingService {
 
     const scheduleWarnings: string[] = [];
 
+    // Dedicating the departure to a shipping line: the id comes from the
+    // request, so verify it is a real, active line before stamping it.
+    if (dto.shippingLineCompanyId) {
+      const line = await this.dataSource
+        .getRepository(ShippingLineCompany)
+        .findOne({ where: { id: dto.shippingLineCompanyId } });
+      if (!line) {
+        throw new NotFoundException(
+          `Shipping line ${dto.shippingLineCompanyId} not found`,
+        );
+      }
+      if (line.status !== 'active') {
+        throw new BadRequestException(
+          `Shipping line ${line.name} is suspended — it cannot be assigned a train`,
+        );
+      }
+    }
+
     // The pulling set comes either from a built train (Train Builder) or from
     // hand-picked locomotive ids (legacy path). A built train also links the
     // schedule's train set back to it (`train_sets.train_id`) so its lifecycle
@@ -1396,6 +1589,7 @@ export class TrainSchedulingService {
           `Train ${builtTrain.code} is not at the origin yard yet; it must arrive before this departure dispatches`,
         );
       }
+      await this.assertRouteCoversWagonYards(builtTrain, route);
       const conflict = await this.findTrainRouteDayConflict(
         builtTrain.id,
         route.id,
@@ -1490,8 +1684,11 @@ export class TrainSchedulingService {
       // doc-review/payment phase — so there is no cross-expiry to fix, and two
       // export trains departing the same day at different times must keep their
       // own departure-anchored windows.
+      // Dedicated shipping-line departures never group either: they run no
+      // window cycle at all, so sharing a customer group's timeline (or
+      // anchoring one) would drag them into phases they must not have.
       const groupAnchor =
-        direction === 'EXPORT'
+        direction === 'EXPORT' || dto.shippingLineCompanyId
           ? null
           : await this.findGroupWindowAnchor(
               manager,
@@ -1556,45 +1753,71 @@ export class TrainSchedulingService {
       // only re-derives NOT-YET-OPEN schedules (see restampPendingWindows); an
       // already-open schedule keeps this snapshot, and the batch board draws its
       // windows from it rather than the live config.
-      const ruleSnapshot = windowRuleSnapshot(windowCfg);
-      const computedTimes =
-        direction === 'EXPORT'
-          ? { ...ruleSnapshot, ...computeExportWindowTimes(departure, windowCfg) }
-          : {
-              // IMPORT and DOMESTIC share the import booking-day window cycle.
-              ...ruleSnapshot,
-              ...computeImportWindowTimes(departure, windowCfg, new Date()),
-            };
-      // Inside-lead departure (e.g. a huge configured lead): the raw open lands
-      // in the past — clamp it to `now` so the window tick opens it immediately.
-      if (computedTimes.windowOpensAt.getTime() < Date.now()) {
-        computedTimes.windowOpensAt = new Date();
+      let windowFields: Partial<TrainSchedule>;
+      if (dto.shippingLineCompanyId) {
+        // Dedicated shipping-line departure: NO window cycle at all. The line
+        // books whenever it wants from creation until the close offset before
+        // departure. windowPhase stays NULL, so the window engine, restamp and
+        // the customer window lists all skip this schedule; the close-offset
+        // gate is enforced by the shipping-line completion path, which reads
+        // windowClosesAt stamped here.
+        const offsetMinutes = windowCfg.importCloseOffsetMinutes ?? 0;
+        const closesAt = new Date(departure.getTime() - offsetMinutes * 60_000);
+        if (closesAt.getTime() <= Date.now()) {
+          throw new BadRequestException(
+            'With the booking-close offset applied, this departure would already be ' +
+              'closed for shipping-line booking — pick a later departure.',
+          );
+        }
+        windowFields = {
+          bookingWindowStatus: 'OPEN',
+          windowPhase: null,
+          windowOpensAt: new Date(),
+          windowClosesAt: closesAt,
+          ruleImportCloseOffsetMinutes: offsetMinutes || null,
+          windowRuleCustom: dto.windowRule != null,
+        };
+      } else {
+        const ruleSnapshot = windowRuleSnapshot(windowCfg);
+        const computedTimes =
+          direction === 'EXPORT'
+            ? { ...ruleSnapshot, ...computeExportWindowTimes(departure, windowCfg) }
+            : {
+                // IMPORT and DOMESTIC share the import booking-day window cycle.
+                ...ruleSnapshot,
+                ...computeImportWindowTimes(departure, windowCfg, new Date()),
+              };
+        // Inside-lead departure (e.g. a huge configured lead): the raw open lands
+        // in the past — clamp it to `now` so the window tick opens it immediately.
+        if (computedTimes.windowOpensAt.getTime() < Date.now()) {
+          computedTimes.windowOpensAt = new Date();
+        }
+        if (
+          computedTimes.windowOpensAt.getTime() >= computedTimes.windowClosesAt.getTime()
+        ) {
+          throw new BadRequestException(
+            'These booking-window settings leave no window before departure — with the ' +
+              'desk hours and close offset applied, the window would only open once the ' +
+              'train has left.',
+          );
+        }
+        windowFields = {
+          bookingWindowStatus: 'CLOSED',
+          windowPhase: 'PRE_WINDOW',
+          ...(groupAnchor
+            ? this.groupWindowFieldsFrom(groupAnchor, departure)
+            : computedTimes),
+          // `windowRuleSnapshot` never stamps the pay window (NULL = follow the
+          // live global value for the direction), so an explicit staff override is
+          // persisted here — the same field the post-creation override writes.
+          ...(dto.windowRule?.paymentWindowMinutes !== undefined
+            ? { rulePaymentWindowMinutes: dto.windowRule.paymentWindowMinutes }
+            : {}),
+          // Hand-configured windows opt OUT of the global re-stamp, or the next
+          // global-rules edit would overwrite exactly what staff chose here.
+          windowRuleCustom: dto.windowRule != null,
+        };
       }
-      if (
-        computedTimes.windowOpensAt.getTime() >= computedTimes.windowClosesAt.getTime()
-      ) {
-        throw new BadRequestException(
-          'These booking-window settings leave no window before departure — with the ' +
-            'desk hours and close offset applied, the window would only open once the ' +
-            'train has left.',
-        );
-      }
-      const windowFields = {
-        bookingWindowStatus: 'CLOSED',
-        windowPhase: 'PRE_WINDOW',
-        ...(groupAnchor
-          ? this.groupWindowFieldsFrom(groupAnchor, departure)
-          : computedTimes),
-        // `windowRuleSnapshot` never stamps the pay window (NULL = follow the
-        // live global value for the direction), so an explicit staff override is
-        // persisted here — the same field the post-creation override writes.
-        ...(dto.windowRule?.paymentWindowMinutes !== undefined
-          ? { rulePaymentWindowMinutes: dto.windowRule.paymentWindowMinutes }
-          : {}),
-        // Hand-configured windows opt OUT of the global re-stamp, or the next
-        // global-rules edit would overwrite exactly what staff chose here.
-        windowRuleCustom: dto.windowRule != null,
-      };
       // A built train's own consist is the schedule's capacity: full when all
       // its wagons are allocated. Trains built without wagons yet fall back to
       // the configured limit.
@@ -1622,6 +1845,7 @@ export class TrainSchedulingService {
           trainNumber: pairTrainNumber ?? undefined,
           maxWagons,
           reverseWagonOrder: dto.reverseWagonOrder ?? false,
+          shippingLineCompanyId: dto.shippingLineCompanyId ?? null,
           ...windowFields,
         }),
       );
@@ -1999,7 +2223,15 @@ export class TrainSchedulingService {
     return { ...detail, warnings, deferredBookings };
   }
 
-  async unassignBooking(scheduleId: string, bookingId: string, userId?: string) {
+  async unassignBooking(
+    scheduleId: string,
+    bookingId: string,
+    userId?: string,
+    opts: {
+      /** false = system detach (e.g. booking cancelled) — no "removed from train, rebook" notice. */
+      notifyCustomer?: boolean;
+    } = {},
+  ) {
     const schedule = await this.trainSchedulesRepository.findByIdWithFullGraph(scheduleId);
     if (!schedule) {
       throw new NotFoundException(`Train schedule ${scheduleId} not found`);
@@ -2126,7 +2358,9 @@ export class TrainSchedulingService {
     const removedBooking = await this.dataSource
       .getRepository(Booking)
       .findOne({ where: { id: bookingId }, relations: { company: true } });
-    if (removedBooking) this.bookingNotifier.removedFromTrain(removedBooking);
+    if (removedBooking && opts.notifyCustomer !== false) {
+      this.bookingNotifier.removedFromTrain(removedBooking);
+    }
     this.logger.log(
       `Booking ${bookingReference} removed from schedule ${scheduleId} by user ${userId ?? 'unknown'} — customer notified to reschedule or cancel.`,
     );
@@ -2474,64 +2708,7 @@ export class TrainSchedulingService {
     return this.getTrainScheduleById(scheduleId);
   }
 
-  /**
-   * EXPORT ONLY. An export train must not leave carrying nothing while its cargo
-   * sits in the shed: the goods are received into the origin warehouse, GRN'd and
-   * loaded onto the wagons allocated to the booking, so anything still in the
-   * warehouse at dispatch is being left behind. Blocks dispatch when an allocated
-   * booking has warehouse inventory that never made it onto a wagon (received /
-   * stored / ready but not LOADED) — either load it from the Load-to-Train queue,
-   * or drop the booking's wagon allocation so it rides a later train.
-   *
-   * Import/domestic are untouched: their cargo isn't loaded out of an origin
-   * warehouse, so warehouse inventory says nothing about what's aboard.
-   *
-   * Bookings with no warehouse inventory at all are NOT blocked — allocating a
-   * wagon before the goods arrive is normal planning; they simply aren't aboard.
-   */
-  private async assertAllocatedCargoLoaded(scheduleId: string): Promise<void> {
-    const [route]: Array<{ originCountry: string | null; destinationCountry: string | null }> =
-      await this.dataSource.query(
-        `SELECT oy.country AS "originCountry", dy.country AS "destinationCountry"
-           FROM freight.train_schedules ts
-           LEFT JOIN freight.yards oy ON oy.id = ts.origin_station_id
-           LEFT JOIN freight.yards dy ON dy.id = ts.destination_station_id
-          WHERE ts.id = $1 AND ts.deleted_at IS NULL`,
-        [scheduleId],
-      );
-    if (!route) return;
-    const direction = deriveTradeDirection(
-      { country: route.originCountry },
-      { country: route.destinationCountry },
-    );
-    if (direction !== 'EXPORT') return;
-
-    // Only bookings boarding at the schedule's ORIGIN station gate dispatch —
-    // a mid-corridor boarder (origin B on an A→B→C→D run) is loaded when the
-    // train reaches its yard, so its warehouse state says nothing at departure.
-    const rows: Array<{ reference: string | null; status: string }> = await this.dataSource.query(
-      `WITH ${SCHEDULE_BOOKINGS_CTE}
-       SELECT DISTINCT b.reference AS "reference", inv.status AS "status"
-         FROM sched_bookings sb
-         JOIN freight.bookings b ON b.id = sb.booking_id AND b.deleted_at IS NULL
-         JOIN freight.train_schedules ts ON ts.id = sb.schedule_id
-         JOIN freight.warehouse_inventory inv
-           ON inv.booking_id = b.id AND inv.deleted_at IS NULL
-        WHERE sb.schedule_id = $1
-          AND b.origin_yard_id = ts.origin_station_id
-          AND inv.status IN ('RECEIVED', 'STORED', 'READY_FOR_LOADING')`,
-      [scheduleId],
-    );
-    if (rows.length) {
-      const refs = [...new Set(rows.map((r) => r.reference ?? '?'))].join(', ');
-      throw new BadRequestException(
-        `Cannot dispatch: cargo for booking(s) ${refs} is in the warehouse but not loaded onto a wagon. ` +
-          `Load it from the warehouse Load-to-Train queue, or remove the booking's wagon allocation so it travels on a later train.`,
-      );
-    }
-  }
-
-  async dispatchSchedule(scheduleId: string) {
+  async dispatchSchedule(scheduleId: string, dto: DispatchScheduleDto = {}) {
     const schedule = await this.trainSchedulesRepository.findByIdWithFullGraph(scheduleId);
     if (!schedule) {
       throw new NotFoundException(`Train schedule ${scheduleId} not found`);
@@ -2539,9 +2716,12 @@ export class TrainSchedulingService {
     if (schedule.status !== TrainScheduleStatusEnum.Scheduled) {
       throw new BadRequestException('Only SCHEDULED trains can be dispatched');
     }
+    // Staff may record the departure after the fact — past is fine, future is not.
+    const now = dto.actualDepartureAt ? new Date(dto.actualDepartureAt) : new Date();
+    this.assertNotFuture(now, 'Departure time');
     await this.assertImportDjiboutiMayDepart(schedule);
-    // Export only: don't leave received cargo behind in the warehouse.
-    await this.assertAllocatedCargoLoaded(scheduleId);
+    // Cargo readiness (in the warehouse, not inspected, not loaded onto a wagon)
+    // never blocks departure — the dispatch confirm dialog warns and staff decide.
     // A locomotive may sit on many future schedules, but it can only pull one train
     // at a time — block dispatch while any set locomotive is out on a dispatched train.
     const setLocomotiveIds = this.locomotivesOfTrainSet(schedule.trainSet).map((l) => l.id);
@@ -2563,7 +2743,6 @@ export class TrainSchedulingService {
       }
     }
 
-    const now = new Date();
     await this.dataSource.transaction(async (manager) => {
       const trainNumber = await this.assignTrainNumber(manager, schedule);
       if (setLocomotiveIds.length) {
@@ -2888,6 +3067,10 @@ export class TrainSchedulingService {
     // dispatch pre-check keeps reporting these bookings as unloaded).
     const wagonAssignedIds = await this.getWagonAssignedBookingIds(scheduleId);
     if (wagonAssignedIds.size) {
+      // Re-check the 1×40ft/2×20ft-per-wagon packing rule right before loading
+      // is confirmed — allocation time already enforces it, but a wagon swap or
+      // an edited allocation since then could have broken it unnoticed.
+      await this.assertWagonContainerCapacity(scheduleId);
       // Export cargo must be received at the warehouse with a GRN before it can
       // be confirmed loaded — an allocation is not proof the goods are in hand.
       if (this.isExportSchedule(schedule)) {
@@ -2955,6 +3138,9 @@ export class TrainSchedulingService {
         .map((wagon) => ({
           sequenceNo: wagon.sequenceNo,
           wagonNumber: wagon.physicalWagon?.wagonNumber ?? null,
+          wagonType: wagon.wagonType?.code ?? wagon.wagonType?.name ?? null,
+          tareWeightTons: wagon.wagonType?.tareWeightTons ?? null,
+          equatedLengthM: wagon.wagonType?.equatedLengthM ?? null,
           allocations: (wagon.allocations ?? []).map((allocation) => ({
             bookingId: allocation.bookingId,
             bookingReference: allocation.booking?.reference ?? null,
@@ -2975,7 +3161,7 @@ export class TrainSchedulingService {
     const loadList = await this.generateImportLoadList(scheduleId, {
       performedBy: 'DOCUMENT_GENERATION',
     });
-    const html = this.buildImportLoadListHtml(loadList);
+    const html = this.buildImportLoadListHtml(loadList, await this.logoSettings.getLogoImageUrl());
     // Styled table-aware fallback (marshalling grid) when Chromium is unavailable —
     // NOT the release-order fallback (would mislabel this as a gate-clearance order).
     const buffer = await this.pdfDocuments.renderTabularDocument(html, 'Import marshalling / load list');
@@ -2995,7 +3181,10 @@ export class TrainSchedulingService {
       throw new BadRequestException('Export marshalling document applies only to EXPORT schedules');
     }
 
-    const html = this.buildExportLoadListHtml(schedule);
+    const html = this.buildExportLoadListHtml(schedule, {
+      emptyContainers: await this.loadedEmptyContainers(scheduleId),
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
+    });
     // Styled table-aware fallback (marshalling grid) — see importLoadListDocument.
     const buffer = await this.pdfDocuments.renderTabularDocument(html, 'Export marshalling / load list');
     const reference = schedule.trainNumber ?? schedule.id;
@@ -3067,6 +3256,8 @@ export class TrainSchedulingService {
       positionLabel,
       wagons,
       unassignedBookings,
+      emptyContainers: await this.loadedEmptyContainers(scheduleId),
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
     });
     // Styled table-aware fallback (marshalling grid) — see importLoadListDocument.
     const buffer = await this.pdfDocuments.renderTabularDocument(html, 'Intercity marshalling / load list');
@@ -3103,6 +3294,18 @@ export class TrainSchedulingService {
     return null;
   }
 
+  /**
+   * Empty containers riding this departure back to Djibouti. They carry no
+   * booking and no wagon allocation, so the marshalling document would show
+   * their wagons as bare — staff checking the paper against the train would
+   * find boxes that the list denies are there.
+   */
+  private loadedEmptyContainers(scheduleId: string): Promise<EmptyContainerReturn[]> {
+    return this.dataSource
+      .getRepository(EmptyContainerReturn)
+      .find({ where: { trainScheduleId: scheduleId } });
+  }
+
   private buildExportLoadListHtml(
     schedule: TrainSchedule,
     opts?: {
@@ -3110,6 +3313,8 @@ export class TrainSchedulingService {
       positionLabel?: string;
       wagons?: TrainSetWagon[];
       unassignedBookings?: Booking[];
+      emptyContainers?: EmptyContainerReturn[];
+      logoImageUrl?: string | null;
     },
   ): string {
     const esc = (value: unknown) =>
@@ -3127,6 +3332,16 @@ export class TrainSchedulingService {
     const wagons = [...(opts?.wagons ?? schedule.trainSet?.wagons ?? [])].sort(
       (a, b) => Number(a.sequenceNo ?? 0) - Number(b.sequenceNo ?? 0),
     );
+    // Empties sit on wagons that carry no booking allocation, keyed by the wagon
+    // slot recorded when they were loaded.
+    const emptiesByWagon = new Map<number, EmptyContainerReturn[]>();
+    for (const empty of opts?.emptyContainers ?? []) {
+      if (empty.wagonSequenceNo == null) continue;
+      emptiesByWagon.set(empty.wagonSequenceNo, [
+        ...(emptiesByWagon.get(empty.wagonSequenceNo) ?? []),
+        empty,
+      ]);
+    }
     const rows = wagons
       .flatMap((wagon) => {
         // Wagon identity is the same on every row the wagon produces, loaded or not.
@@ -3141,6 +3356,21 @@ export class TrainSchedulingService {
         // check this document against the physical train — a wagon with no row
         // reads as a wagon that is not there, and the count stops matching.
         if (allocations.length === 0) {
+          const empties = emptiesByWagon.get(Number(wagon.sequenceNo)) ?? [];
+          // Empty boxes returning to Djibouti: numbers listed like any other
+          // container, state spelled out so nobody reads them as laden.
+          if (empties.length) {
+            return [
+              `<tr>
+            ${wagonCells}
+            <td>EMPTY CONTAINER</td>
+            <td>-</td>
+            <td>${esc(empties.map((empty) => empty.containerNumber).filter(Boolean).join(', '))}</td>
+            <td>-</td>
+            <td>-</td>
+          </tr>`,
+            ];
+          }
           return [
             `<tr class="empty">
             ${wagonCells}
@@ -3191,14 +3421,19 @@ export class TrainSchedulingService {
           })
           .join('')
       : '';
-    const emptyWagons = wagons.filter((wagon) => (wagon.allocations ?? []).length === 0).length;
+    const emptyWagons = wagons.filter(
+      (wagon) =>
+        (wagon.allocations ?? []).length === 0 &&
+        !emptiesByWagon.get(Number(wagon.sequenceNo))?.length,
+    ).length;
     const totalWeight = wagons.reduce(
       (sum, wagon) =>
         sum + (wagon.allocations ?? []).reduce((wagonSum, allocation) => wagonSum + Number(allocation.allocatedWeightTons || 0), 0),
       0,
     );
 
-    // Container count summary (40ft, 20ft)
+    // Container count summary (40ft, 20ft) — empties returning to Djibouti are
+    // physically on the train, so they count, and are called out on their own tile.
     let count40ft = 0, count20ft = 0;
     wagons.forEach((wagon) => {
       (wagon.allocations ?? []).forEach((allocation) => {
@@ -3209,6 +3444,11 @@ export class TrainSchedulingService {
         });
       });
     });
+    const emptyContainers = [...emptiesByWagon.values()].flat();
+    for (const empty of emptyContainers) {
+      if (empty.containerSize?.includes('20')) count20ft++;
+      else count40ft++;
+    }
 
     return `<!doctype html>
 <html>
@@ -3228,6 +3468,7 @@ export class TrainSchedulingService {
     .tile { border: 1px solid #cbd5e1; padding: 8px; min-height: 50px; }
     .tile span { display: block; color: #64748b; font-size: 9px; text-transform: uppercase; letter-spacing: .05em; margin-bottom: 4px; }
     .tile strong { font-size: 11px; }
+    ${logoImageCss()}
     table { width: 100%; border-collapse: collapse; }
     th { background: #f8fafc; color: #475569; text-align: left; }
     th, td { border: 1px solid #cbd5e1; padding: 5px 6px; font-size: 9.5px; vertical-align: top; }
@@ -3242,6 +3483,7 @@ export class TrainSchedulingService {
 <body>
   <div class="top">
     <div>
+      ${logoMarkup(opts?.logoImageUrl)}
       <div class="brand">Ethio-Djibouti Railway S.C.</div>
       <h1>${esc(opts?.title ?? 'Export Marshalling Document / Load List')}</h1>
     </div>
@@ -3262,6 +3504,7 @@ export class TrainSchedulingService {
     <div class="tile"><span>Containers 40ft</span><strong>${esc(count40ft)}</strong></div>
     <div class="tile"><span>Containers 20ft</span><strong>${esc(count20ft)}</strong></div>
     <div class="tile"><span>Total containers</span><strong>${esc(count40ft + count20ft)}</strong></div>
+    ${emptyContainers.length ? `<div class="tile"><span>Empty containers</span><strong>${esc(emptyContainers.length)}</strong></div>` : ''}
     <div class="tile"><span>Prepared person</span><strong>${esc(schedule.preparedByUserId)}</strong></div>
     <div class="tile"><span>Check person</span><strong>${esc(schedule.checkedByUserId)}</strong></div>
     <div class="tile"><span>Wagons</span><strong>${esc(wagons.length)}${emptyWagons ? ` (${emptyWagons} empty)` : ''}</strong></div>
@@ -3320,6 +3563,12 @@ export class TrainSchedulingService {
    * Every export booking being confirmed loaded must already be received at the
    * warehouse with a GRN. An allocation puts a booking on a wagon on paper; this
    * is the check that the cargo is physically in the yard before we call it loaded.
+   *
+   * Direct truck-to-train (exportHandoverMode = DIRECT_TO_TRAIN) is excluded —
+   * that cargo is manually loaded from the customer's truck straight onto the
+   * wagon, never sees the warehouse, and is never GRN'd. Its custody is attested
+   * by the carriage acceptance sheet instead (same carve-out as the shared
+   * assertExportReceivedWithGrn gate — see common/export-received-gate.ts).
    */
   private async assertExportBookingsReceived(bookingIds: string[]): Promise<void> {
     if (!bookingIds.length) return;
@@ -3328,6 +3577,7 @@ export class TrainSchedulingService {
          FROM freight.bookings b
         WHERE b.id = ANY($1)
           AND b.deleted_at IS NULL
+          AND b.export_handover_mode IS DISTINCT FROM 'DIRECT_TO_TRAIN'
           AND NOT EXISTS (
             SELECT 1 FROM freight.warehouse_inventory inv
              WHERE inv.booking_id = b.id
@@ -3348,7 +3598,76 @@ export class TrainSchedulingService {
     }
   }
 
-  private buildImportLoadListHtml(loadList: Awaited<ReturnType<TrainSchedulingService['generateImportLoadList']>>): string {
+  /**
+   * Re-check the 1×40ft / 2×20ft-per-wagon packing rule at loading confirmation
+   * time. `validateContainerPlacements` already enforces this the moment a
+   * booking is allocated to a wagon, but nothing re-checks it afterwards — a
+   * wagon swap, an edited allocation, or a container item added out-of-band
+   * between allocation and loading could still leave a wagon over its 2-TEU
+   * capacity undetected until the train is already loaded. This closes that gap
+   * by summing the TEU actually persisted per wagon (40ft = 2 TEU, 20ft = 1 TEU,
+   * same size resolution as the marshalling document) right before loading is
+   * confirmed.
+   */
+  private async assertWagonContainerCapacity(scheduleId: string): Promise<void> {
+    const rows: Array<{ sequenceNo: number; wagonNumber: string | null; teuUsed: string }> =
+      await this.dataSource.query(
+        `SELECT tsw.sequence_no AS "sequenceNo",
+                pw.wagon_number AS "wagonNumber",
+                SUM(
+                  CASE COALESCE(ct.size_ft, bct.size_ft)
+                    WHEN 40 THEN 2
+                    WHEN 20 THEN 1
+                    ELSE
+                      CASE
+                        WHEN bc.container_size ILIKE '%40%' THEN 2
+                        WHEN bc.container_size ILIKE '%20%' THEN 1
+                        ELSE 0
+                      END
+                  END
+                ) AS "teuUsed"
+           FROM freight.train_set_wagons tsw
+           JOIN freight.wagon_booking_allocations wba
+             ON wba.train_set_wagon_id = tsw.id AND wba.deleted_at IS NULL
+           JOIN freight.wagon_allocation_container_items wci
+             ON wci.wagon_booking_allocation_id = wba.id AND wci.deleted_at IS NULL
+           LEFT JOIN freight.container_types ct ON ct.id = wci.container_type_id
+           LEFT JOIN freight.booking_container bc ON bc.id = wci.booking_container_id
+           LEFT JOIN freight.container_types bct ON bct.id = bc.container_type_id
+           LEFT JOIN freight.wagons pw ON pw.id = tsw.physical_wagon_id
+          WHERE tsw.train_set_id = (
+                  SELECT train_set_id FROM freight.train_schedules WHERE id = $1
+                )
+            AND tsw.deleted_at IS NULL
+          GROUP BY tsw.id, tsw.sequence_no, pw.wagon_number
+         HAVING SUM(
+                  CASE COALESCE(ct.size_ft, bct.size_ft)
+                    WHEN 40 THEN 2
+                    WHEN 20 THEN 1
+                    ELSE
+                      CASE
+                        WHEN bc.container_size ILIKE '%40%' THEN 2
+                        WHEN bc.container_size ILIKE '%20%' THEN 1
+                        ELSE 0
+                      END
+                  END
+                ) > $2`,
+        [scheduleId, MAX_TEU_SLOTS_PER_WAGON],
+      );
+    if (rows.length) {
+      const labels = rows
+        .map((r) => `wagon #${r.sequenceNo}${r.wagonNumber ? ` (${r.wagonNumber})` : ''}`)
+        .join(', ');
+      throw new BadRequestException(
+        `These wagons exceed capacity (max 1×40ft or 2×20ft per wagon) — fix the container placement before confirming loading: ${labels}.`,
+      );
+    }
+  }
+
+  private buildImportLoadListHtml(
+    loadList: Awaited<ReturnType<TrainSchedulingService['generateImportLoadList']>>,
+    logoImageUrl?: string | null,
+  ): string {
     const esc = (value: unknown) =>
       String(value ?? '-')
         .replace(/&/g, '&amp;')
@@ -3381,26 +3700,37 @@ export class TrainSchedulingService {
     const allocationRows = loadList.wagons
       .flatMap((wagon) => {
         const wagonCells = `<td>${esc(wagon.sequenceNo)}</td>
-            <td>${esc(wagon.wagonNumber)}</td>`;
+            <td>${esc(wagon.wagonNumber)}</td>
+            <td>${esc(wagon.wagonType)}</td>
+            <td class="num">${wagon.tareWeightTons == null ? '-' : esc(Number(wagon.tareWeightTons).toFixed(2))}</td>
+            <td class="num">${wagon.equatedLengthM == null ? '-' : esc(Number(wagon.equatedLengthM).toFixed(3))}</td>
+            <td>${esc(loadList.origin)}</td>
+            <td>${esc(loadList.destination)}</td>`;
         // An empty wagon still runs in the consist, so it still gets a line — see
         // buildExportLoadListHtml.
         if (wagon.allocations.length === 0) {
           return [
             `<tr class="empty">
             ${wagonCells}
-            <td colspan="4">EMPTY — no cargo allocated</td>
+            <td colspan="7">EMPTY — no cargo allocated</td>
           </tr>`,
           ];
         }
         return wagon.allocations.map(
           (allocation) => {
             const companyName = (allocation.booking as unknown as { company?: { name?: string } } | undefined)?.company?.name ?? '-';
+            const sealNumbers = (allocation.containerItems ?? [])
+              .map((item) => item.sealNumber)
+              .filter(Boolean)
+              .join(', ');
             return `<tr>
             ${wagonCells}
             <td>${esc(allocation.bookingReference ?? allocation.bookingId)}</td>
             <td>${esc(companyName)}</td>
             <td>${esc(allocation.loadType)}</td>
             <td>${esc(allocation.containerNumbers.length ? allocation.containerNumbers.join(', ') : '-')}</td>
+            <td>${esc(sealNumbers || '-')}</td>
+            <td></td>
             <td class="num">${esc(Number(allocation.allocatedWeightTons || 0).toFixed(3))}</td>
           </tr>`;
           },
@@ -3428,6 +3758,7 @@ export class TrainSchedulingService {
     .tile { border: 1px solid #cbd5e1; padding: 10px; min-height: 58px; }
     .tile span { display: block; color: #64748b; font-size: 10px; text-transform: uppercase; letter-spacing: .05em; margin-bottom: 5px; }
     .tile strong { font-size: 13px; }
+    ${logoImageCss()}
     .status { display: grid; grid-template-columns: repeat(6, 1fr); gap: 8px; margin-top: 14px; }
     .step { border: 1px solid #cbd5e1; padding: 8px; font-size: 10px; text-align: center; min-height: 48px; }
     .done { background: #ecfdf5; border-color: #22c55e; color: #14532d; font-weight: 700; }
@@ -3449,6 +3780,7 @@ export class TrainSchedulingService {
   <div class="doc">
     <div class="top">
       <div>
+        ${logoMarkup(logoImageUrl)}
         <div class="brand">Ethio-Djibouti Railway S.C.</div>
         <h1>Import Load List /<br />Marshalling Document</h1>
         <div class="subtitle">Djibouti-side gatepass, loading, and departure manifest</div>
@@ -3489,15 +3821,22 @@ export class TrainSchedulingService {
         <tr>
           <th>Seq</th>
           <th>Wagon</th>
+          <th>Wagon Type</th>
+          <th class="num">Tare</th>
+          <th class="num">Equated</th>
+          <th>Departure Station</th>
+          <th>Arrival Station</th>
           <th>Booking</th>
           <th>Company</th>
           <th>Load</th>
           <th>Container numbers</th>
+          <th>Seal No</th>
+          <th>Note</th>
           <th class="num">Weight T</th>
         </tr>
       </thead>
       <tbody>
-        ${allocationRows || '<tr><td colspan="6">No wagons on this train set.</td></tr>'}
+        ${allocationRows || '<tr><td colspan="14">No wagons on this train set.</td></tr>'}
       </tbody>
     </table>
 
@@ -3886,6 +4225,7 @@ export class TrainSchedulingService {
           ? TrainCheckpointKind.Arrived
           : TrainCheckpointKind.Passed);
     const occurredAt = dto.occurredAt ? new Date(dto.occurredAt) : new Date();
+    await this.assertCheckpointTime(schedule, stations, dto.sequenceNo, occurredAt);
 
     // Upsert by (scheduleId, sequenceNo) so re-logging a station updates rather than duplicates.
     const [existing] = await this.trainCheckpointEventsRepository.findAll({
@@ -3909,8 +4249,14 @@ export class TrainSchedulingService {
       });
     }
 
+    // The origin DEPARTED checkpoint IS the departure — keep the schedule's
+    // headline timestamp on the same clock the operator just entered.
+    if (dto.sequenceNo === 0) {
+      await this.trainSchedulesRepository.update(scheduleId, { actualDepartureAt: occurredAt });
+    }
+
     if (dto.sequenceNo === finalSeq) {
-      await this.arriveSchedule(scheduleId);
+      await this.arriveSchedule(scheduleId, occurredAt);
     } else {
       // Mid-corridor auto-unload: bookings destined for this yard alight the
       // moment the train is recorded here — the yard operator no longer has to
@@ -3929,12 +4275,26 @@ export class TrainSchedulingService {
             .getRepository(Locomotive)
             .update({ id: In(locoIds) }, { currentYardId: station.yardId });
         }
+        // Only wagons the train has actually COLLECTED move with it. On a
+        // consist spread across yards (20 in Dire, 33 in Mojo), reaching Mojo
+        // moves the Dire wagons — the ones already aboard — and picks up the
+        // Mojo ones standing here. Wagons waiting at yards further down the
+        // line stay where they are until the train physically gets to them.
+        const passedYardIds = stations
+          .filter((s) => s.sequenceNo <= dto.sequenceNo)
+          .map((s) => s.yardId);
         await manager
           .getRepository(Wagon)
-          .update(
-            { currentTrainScheduleId: scheduleId },
-            { currentYardId: station.yardId },
-          );
+          .createQueryBuilder()
+          .update(Wagon)
+          .set({ currentYardId: station.yardId })
+          .where('current_train_schedule_id = :scheduleId', { scheduleId })
+          // A yard-less wagon has no "waiting further down the line" position
+          // to protect, so it rides along as it always did.
+          .andWhere('(current_yard_id IS NULL OR current_yard_id IN (:...passedYardIds))', {
+            passedYardIds,
+          })
+          .execute();
         if (schedule.trainSet?.trainId) {
           await manager
             .getRepository(Train)
@@ -3946,11 +4306,133 @@ export class TrainSchedulingService {
     return this.getScheduleCheckpoints(scheduleId);
   }
 
+  /**
+   * Correct an already-logged leg's time/note. Pure edit: no auto-unload, no
+   * position fix, no arrival — those already happened when the leg was logged.
+   * Allowed on DISPATCHED and ARRIVED trains (a journey is corrected after the
+   * fact as often as during it). The origin/final legs also re-stamp the
+   * schedule's departure/arrival so the headline figures follow the edit.
+   */
+  async updateCheckpoint(scheduleId: string, sequenceNo: number, dto: UpdateCheckpointDto) {
+    const schedule = await this.trainSchedulesRepository.findByIdWithFullGraph(scheduleId);
+    if (!schedule) {
+      throw new NotFoundException(`Train schedule ${scheduleId} not found`);
+    }
+    if (
+      schedule.status !== TrainScheduleStatusEnum.Dispatched &&
+      schedule.status !== TrainScheduleStatusEnum.Arrived
+    ) {
+      throw new BadRequestException('Only DISPATCHED or ARRIVED trains have checkpoints to edit');
+    }
+    const stations = await this.buildScheduleStations(schedule);
+    const station = stations.find((s) => s.sequenceNo === sequenceNo);
+    if (!station) {
+      throw new BadRequestException(`Station ${sequenceNo} is not on this route`);
+    }
+    // Match by yard, like getScheduleCheckpoints — legacy rows may carry an
+    // older station numbering.
+    const events = await this.trainCheckpointEventsRepository.findBySchedule(scheduleId);
+    const existing =
+      events.find((e) => e.yardId === station.yardId) ??
+      events.find((e) => e.sequenceNo === sequenceNo);
+    if (!existing) {
+      throw new BadRequestException(`Station ${station.label} has not been logged yet`);
+    }
+
+    const patch: Partial<TrainCheckpointEvent> = {};
+    if (dto.occurredAt) {
+      const occurredAt = new Date(dto.occurredAt);
+      await this.assertCheckpointTime(schedule, stations, sequenceNo, occurredAt, existing.id);
+      patch.occurredAt = occurredAt;
+    }
+    if (dto.note !== undefined) patch.note = dto.note;
+    if (Object.keys(patch).length) {
+      await this.trainCheckpointEventsRepository.update(existing.id, patch);
+    }
+
+    if (patch.occurredAt) {
+      const finalSeq = stations[stations.length - 1].sequenceNo;
+      if (sequenceNo === 0) {
+        await this.trainSchedulesRepository.update(scheduleId, {
+          actualDepartureAt: patch.occurredAt,
+        });
+      } else if (sequenceNo === finalSeq && schedule.status === TrainScheduleStatusEnum.Arrived) {
+        await this.trainSchedulesRepository.update(scheduleId, {
+          actualArrivalAt: patch.occurredAt,
+        });
+      }
+    }
+
+    return this.getScheduleCheckpoints(scheduleId);
+  }
+
+  private assertNotFuture(at: Date, what: string) {
+    if (Number.isNaN(at.getTime())) {
+      throw new BadRequestException(`${what} is not a valid date`);
+    }
+    // Small skew allowance so an honest "now" from a client clock passes.
+    if (at.getTime() > Date.now() + 60_000) {
+      throw new BadRequestException(`${what} cannot be in the future`);
+    }
+  }
+
+  /**
+   * A leg's time must not be in the future and must sit in corridor order:
+   * no earlier than every logged leg before it (and the dispatch time, for
+   * legs after the origin), no later than every logged leg after it.
+   * `ignoreEventId` excludes the row being edited from its own bounds.
+   */
+  private async assertCheckpointTime(
+    schedule: TrainSchedule,
+    stations: { sequenceNo: number; yardId: string; label: string }[],
+    sequenceNo: number,
+    occurredAt: Date,
+    ignoreEventId?: string,
+  ) {
+    this.assertNotFuture(occurredAt, 'Checkpoint time');
+
+    const seqByYard = new Map(stations.map((s) => [s.yardId, s.sequenceNo]));
+    const labelBySeq = new Map(stations.map((s) => [s.sequenceNo, s.label]));
+    const events = (await this.trainCheckpointEventsRepository.findBySchedule(schedule.id)).filter(
+      (e) => e.id !== ignoreEventId,
+    );
+    const seqOf = (e: TrainCheckpointEvent) => seqByYard.get(e.yardId) ?? e.sequenceNo;
+    const fmt = (d: Date) => d.toISOString().replace('T', ' ').slice(0, 16) + ' UTC';
+
+    let floor: { at: Date; label: string } | null = null;
+    let ceil: { at: Date; label: string } | null = null;
+    for (const e of events) {
+      const s = seqOf(e);
+      if (s < sequenceNo && (!floor || e.occurredAt > floor.at)) {
+        floor = { at: e.occurredAt, label: labelBySeq.get(s) ?? `station ${s}` };
+      }
+      if (s > sequenceNo && (!ceil || e.occurredAt < ceil.at)) {
+        ceil = { at: e.occurredAt, label: labelBySeq.get(s) ?? `station ${s}` };
+      }
+    }
+    // The origin leg rewrites the departure itself; every later leg must
+    // follow it.
+    if (sequenceNo > 0 && schedule.actualDepartureAt && (!floor || schedule.actualDepartureAt > floor.at)) {
+      floor = { at: schedule.actualDepartureAt, label: 'departure' };
+    }
+
+    if (floor && occurredAt < floor.at) {
+      throw new BadRequestException(
+        `Checkpoint time cannot be earlier than ${floor.label} (${fmt(floor.at)})`,
+      );
+    }
+    if (ceil && occurredAt > ceil.at) {
+      throw new BadRequestException(
+        `Checkpoint time cannot be later than ${ceil.label} (${fmt(ceil.at)})`,
+      );
+    }
+  }
+
   /**
    * Mark a dispatched train arrived: close out the schedule, move the locomotive
    * and wagons to the destination yard, and free the assets for re-use.
    */
-  async arriveSchedule(scheduleId: string) {
+  async arriveSchedule(scheduleId: string, arrivedAt?: Date) {
     const schedule = await this.trainSchedulesRepository.findByIdWithFullGraph(scheduleId);
     if (!schedule) {
       throw new NotFoundException(`Train schedule ${scheduleId} not found`);
@@ -3959,7 +4441,9 @@ export class TrainSchedulingService {
       throw new BadRequestException('Only DISPATCHED trains can arrive');
     }
 
-    const now = new Date();
+    // The arrival clock: the operator's entered time when arriving via the final
+    // checkpoint (already order/future-checked there), else now.
+    const now = arrivedAt ?? new Date();
 
     await this.dataSource.transaction(async (manager) => {
       await this.trainSchedulesRepository.updateStatus(
@@ -4130,13 +4614,22 @@ export class TrainSchedulingService {
     const [schedules, total] = await this.trainSchedulesRepository.findAndCount({
       where,
       relations: {
-        trainSet: { locomotive: true, locomotives: { locomotive: true }, train: true },
+        trainSet: {
+          locomotive: true,
+          locomotives: { locomotive: true },
+          train: true,
+          // Slot allocations back the list's "used wagons" figure — without
+          // them the row can only report the coupled consist size, which is
+          // what made the list disagree with the detail page's wagon plan.
+          wagons: { allocations: true },
+        },
         // Yards carry the route's display name used by mapScheduleListItem;
         // milestones (with yards) let it show the full corridor path.
         route: { originYard: true, destinationYard: true, milestones: { yard: true } },
         originStation: true,
         destinationStation: true,
         scheduleBookings: { booking: true },
+        shippingLineCompany: true,
       },
       order: { [sortBy]: sortOrder } as never,
       skip,
@@ -4311,7 +4804,10 @@ export class TrainSchedulingService {
       (b) =>
         !(targetScheduleId && b.trainScheduleId === targetScheduleId) &&
         !SCHEDULABLE_BOOKING_STATUSES.includes(b.status as 'PAID') &&
-        !b.isGovernment,
+        !b.isGovernment &&
+        // Shipping-line bookings pay later on the credit ledger — never PAID
+        // up front, schedulable from accept (FULLY_EXECUTED) like government.
+        !b.shippingLineCompanyId,
     );
     if (invalidStatus.length) {
       const statuses = [...new Set(invalidStatus.map((b) => b.status))];
@@ -4805,12 +5301,26 @@ export class TrainSchedulingService {
     const typeCodeById = new Map(wagonTypes.map((type) => [type.id, type.code]));
     const counts = new Map<string, { code: string; available: number }>();
 
+    // A built consist spread across several yards can only offer, at each yard,
+    // the wagons standing there. A single-yard consist keeps the original
+    // behaviour: the whole train counts wherever it currently sits.
+    const consistYards = builtTrainId
+      ? new Set(
+          wagons
+            .filter((w) => w.trainId === builtTrainId && w.currentYardId)
+            .map((w) => w.currentYardId as string),
+        )
+      : new Set<string>();
+    const consistIsSplit = consistYards.size > 1;
+
     for (const wagon of wagons) {
       // Train-bound schedule: the built train's own consist IS the fleet — only
-      // its wagons count (wherever they currently sit; they travel with the
-      // train), and loose yard wagons never do.
+      // its wagons count, and loose yard wagons never do. A single-yard consist
+      // counts wherever it sits (it travels with the train); a split consist is
+      // counted at the yard each wagon actually stands in.
       if (builtTrainId) {
         if (wagon.trainId !== builtTrainId) continue;
+        if (consistIsSplit && wagon.currentYardId !== originYardId) continue;
       } else {
         // Schedule-scoped availability: pins held by OTHER schedules never
         // consume a wagon here — the same physical wagon may serve the July 17
@@ -5170,12 +5680,23 @@ export class TrainSchedulingService {
       // consist views draw the schedule exactly like the train builder; a schedule
       // created with reverseWagonOrder pins back-to-front (physically-last wagon
       // takes slot #1). Unsequenced wagons sort after every sequenced one.
+      const consistYards = new Set(
+        wagons
+          .filter((w) => w.trainId === builtTrainId && w.currentYardId)
+          .map((w) => w.currentYardId as string),
+      );
+      // Split consist: a slot boarding at a given yard must take a wagon that
+      // physically stands there — the train cannot load a Mojo wagon at Dire.
+      // A single-yard consist ignores this (the whole train is at one place).
+      const requiredYardId =
+        consistYards.size > 1 ? (slot.boardYardId ?? originYardId) : null;
       const candidates = wagons
         .filter(
           (w) =>
             w.trainId === builtTrainId &&
             w.wagonTypeId === slot.wagonTypeId &&
-            spanFree(w.id),
+            spanFree(w.id) &&
+            (!requiredYardId || w.currentYardId === requiredYardId),
         )
         .sort((a, b) => {
           if (a.sequenceNumber == null || b.sequenceNumber == null) {
@@ -5344,14 +5865,28 @@ export class TrainSchedulingService {
     });
     const remainingByTypeId = new Map<string, number>();
     const codesByTypeId = new Map<string, string>();
+    const byYardId = new Map<string, Map<string, number>>();
     for (const wagon of wagons) {
       remainingByTypeId.set(
         wagon.wagonTypeId,
         (remainingByTypeId.get(wagon.wagonTypeId) ?? 0) + 1,
       );
       if (wagon.wagonType) codesByTypeId.set(wagon.wagonTypeId, wagon.wagonType.code);
+      if (wagon.currentYardId) {
+        const perType = byYardId.get(wagon.currentYardId) ?? new Map<string, number>();
+        perType.set(wagon.wagonTypeId, (perType.get(wagon.wagonTypeId) ?? 0) + 1);
+        byYardId.set(wagon.currentYardId, perType);
+      }
     }
-    return { mode: 'TRAIN', remainingByTypeId, codesByTypeId };
+    // Single-yard consist (the overwhelming majority): the whole train is
+    // offered at every boarding yard exactly as before — the per-yard split is
+    // only meaningful once the consist is genuinely spread across yards.
+    return {
+      mode: 'TRAIN',
+      remainingByTypeId,
+      codesByTypeId,
+      ...(byYardId.size > 1 ? { byYardId } : {}),
+    };
   }
 
   /**
@@ -5679,6 +6214,45 @@ export class TrainSchedulingService {
     return saved;
   }
 
+  /**
+   * A built train's wagons may stand in several yards. The route must pass
+   * through every one of them as origin or an intermediate stop — never only
+   * as the final destination (the train has to pick the wagons up en route).
+   */
+  private async assertRouteCoversWagonYards(train: Train, route: Route) {
+    const wagons = await this.dataSource.getRepository(Wagon).find({
+      where: { trainId: train.id },
+      select: { id: true, currentYardId: true },
+    });
+    const wagonYards = [...new Set(wagons.map((w) => w.currentYardId).filter((y): y is string => !!y))];
+    if (!wagonYards.length) return;
+
+    const milestones = await this.dataSource
+      .getRepository(RouteMilestone)
+      .find({ where: { routeId: route.id }, order: { sequenceNo: 'ASC' } });
+    const stops = milestones.length >= 2
+      ? milestones.map((m) => m.yardId)
+      : [route.originYardId, route.destinationYardId];
+    // Every stop except the last one is a pickup point.
+    const pickupYards = new Set(stops.slice(0, -1));
+
+    const uncovered = wagonYards.filter((y) => !pickupYards.has(y));
+    if (!uncovered.length) return;
+
+    const labels = await this.yardLabelMap(uncovered);
+    const destination = stops[stops.length - 1];
+    const detail = uncovered
+      .map((y) =>
+        y === destination
+          ? `${labels.get(y) ?? y} (only as the destination)`
+          : `${labels.get(y) ?? y} (not on route)`,
+      )
+      .join(', ');
+    throw new BadRequestException(
+      `Route ${formatRouteLabel(route)} does not pass through every yard where train ${train.code}'s wagons stand: ${detail}`,
+    );
+  }
+
   private async getSchedulableRoute(routeId: string) {
     const route = await this.dataSource.getRepository(Route).findOne({
       where: { id: routeId },
@@ -5767,7 +6341,7 @@ export class TrainSchedulingService {
   }
 
   private resolveScheduleFreightType(
-    schedule: import('../train-schedules/entities/train-schedule.entity').TrainSchedule,
+    schedule: import('../../train-schedules/entities/train-schedule.entity').TrainSchedule,
   ): 'CONTAINER' | 'BULK' | 'MIXED' | null {
     const types = new Set(
       (schedule.scheduleBookings ?? [])
@@ -5809,18 +6383,33 @@ export class TrainSchedulingService {
     throw new ConflictException('Could not allocate a unique schedule reference');
   }
 
-  private mapScheduleListItem(schedule: import('../train-schedules/entities/train-schedule.entity').TrainSchedule) {
+  private mapScheduleListItem(schedule: import('../../train-schedules/entities/train-schedule.entity').TrainSchedule) {
+    // Wagon figures must match the detail page's wagon plan (WagonPlanGrid) —
+    // see computeScheduleWagonUsage for why the stored counter cannot be used.
+    const { wagonsUsed, wagonsTotal, wagonsReserved, wagonsRemaining } =
+      computeScheduleWagonUsage({
+        wagonSlots: schedule.trainSet?.wagons,
+        storedWagonCount: schedule.trainSet?.wagonCount,
+        scheduleBookings: schedule.scheduleBookings,
+        maxWagons: schedule.maxWagons,
+      });
+
     return {
       id: schedule.id,
       reference: schedule.reference ?? null,
       createdAt: schedule.createdAt ?? null,
       scheduleDate: schedule.scheduledDepartureDate,
       trainNumber: schedule.trainNumber ?? null,
+      voyageNumber: schedule.voyageNumber ?? null,
       direction: schedule.direction ?? null,
       routeName: schedule.route ? formatRouteLabel(schedule.route) : null,
       origin: schedule.originStation?.label ?? schedule.originStation?.code ?? null,
       destination:
         schedule.destinationStation?.label ?? schedule.destinationStation?.code ?? null,
+      // Dedicated shipping-line departure (hidden from customers) — the list
+      // highlights these rows so staff can tell them apart at a glance.
+      shippingLineCompanyId: schedule.shippingLineCompanyId ?? null,
+      shippingLineCompanyName: schedule.shippingLineCompany?.name ?? null,
       // Built train (Train Builder) behind this departure, when scheduled by train.
       train: schedule.trainSet?.train
         ? {
@@ -5844,6 +6433,14 @@ export class TrainSchedulingService {
         currentYardId: loco.currentYardId ?? null,
       })),
       wagonCount: schedule.trainSet?.wagonCount ?? 0,
+      /** Coupled slots carrying a booking allocation — matches the wagon plan. */
+      wagonsUsed,
+      /** Coupled consist size; the denominator of "used". */
+      wagonsTotal,
+      /** Claimed by bookings (incl. unpaid) — not bookable. */
+      wagonsReserved,
+      /** Consist minus what bookings have claimed; what is still bookable. */
+      wagonsRemaining,
       totalWeightTons: roundTons(Number(schedule.trainSet?.totalWeightTons ?? 0)),
       totalLengthMeters: roundTons(Number(schedule.trainSet?.totalLengthMeters ?? 0)),
       bookingsCount: schedule.scheduleBookings?.length ?? 0,
@@ -6774,6 +7371,7 @@ export class TrainSchedulingService {
       `SELECT DISTINCT ON (ts.id)
               ts.id AS schedule_id,
               ts.reference AS reference,
+              ts.train_number,
               cr.contract_id AS contract_id,
               c.contract_kind AS contract_kind,
               ts.direction,
@@ -6804,6 +7402,7 @@ export class TrainSchedulingService {
          LEFT JOIN freight.yards dy ON dy.id = ts.destination_station_id
         WHERE ts.deleted_at IS NULL
           AND ts.status IN ('DRAFT', 'SCHEDULED')
+          AND ts.shipping_line_company_id IS NULL
           AND ts.window_phase IS NOT NULL
           AND ts.window_phase NOT IN ('DONE', 'CLOSED_FOR_DAY')
           AND ts.scheduled_departure_date >= now()
@@ -6830,6 +7429,7 @@ export class TrainSchedulingService {
     const rows: Array<BookingWindowRow> = await this.dataSource.query(
       `SELECT DISTINCT ts.id AS schedule_id,
               ts.reference AS reference,
+              ts.train_number,
               cr.contract_id AS contract_id,
               c.contract_kind AS contract_kind,
               ts.direction,
@@ -6859,6 +7459,7 @@ export class TrainSchedulingService {
          LEFT JOIN freight.yards dy ON dy.id = ts.destination_station_id
         WHERE ts.deleted_at IS NULL
           AND ts.status IN ('DRAFT', 'SCHEDULED')
+          AND ts.shipping_line_company_id IS NULL
           AND ts.window_phase IS NOT NULL
           AND ts.window_phase NOT IN ('DONE', 'CLOSED_FOR_DAY')
           AND ts.scheduled_departure_date >= now()
@@ -6875,9 +7476,7 @@ export class TrainSchedulingService {
    */
   async listAllBookingWindows() {
     const rows: Array<
-      Omit<BookingWindowRow, 'contract_id' | 'contract_kind'> & {
-        train_number: string | null;
-      }
+      Omit<BookingWindowRow, 'contract_id' | 'contract_kind'>
     > = await this.dataSource.query(
       `SELECT ts.id AS schedule_id,
               ts.reference AS reference,
@@ -6907,14 +7506,13 @@ export class TrainSchedulingService {
           AND ts.scheduled_departure_date >= now()
         ORDER BY ts.scheduled_departure_date ASC NULLS LAST`,
     );
-    return rows.map((r) => ({
-      ...this.mapBookingWindowRow({
+    return rows.map((r) =>
+      this.mapBookingWindowRow({
         ...r,
         contract_id: null,
         contract_kind: null,
       }),
-      trainNumber: r.train_number,
-    }));
+    );
   }
 
   private mapBookingWindowRow(r: BookingWindowRow) {
@@ -6932,6 +7530,7 @@ export class TrainSchedulingService {
     return {
       scheduleId: r.schedule_id,
       reference: r.reference ?? null,
+      trainNumber: r.train_number ?? null,
       contractId: r.contract_id,
       contractKind: r.contract_kind,
       direction: r.direction,
@@ -6965,11 +7564,13 @@ export class TrainSchedulingService {
     originYardId?: string,
     destinationYardId?: string,
   ): Promise<
-    import('../train-schedules/entities/train-schedule.entity').TrainSchedule[]
+    import('../../train-schedules/entities/train-schedule.entity').TrainSchedule[]
   > {
     const schedules = await this.trainSchedulesRepository.findAll({
       where: {
         bookingWindowStatus: 'OPEN',
+        // Dedicated shipping-line trains never surface to customer booking.
+        shippingLineCompanyId: IsNull(),
       },
       relations: {
         trainSet: { locomotive: true, locomotives: { locomotive: true }, train: true },
@@ -7555,7 +8156,7 @@ export class TrainSchedulingService {
   }
 
   private async mapScheduleDetail(
-    schedule: import('../train-schedules/entities/train-schedule.entity').TrainSchedule,
+    schedule: import('../../train-schedules/entities/train-schedule.entity').TrainSchedule,
   ) {
     const allocations = (schedule.trainSet?.wagons ?? []).flatMap(
       (w) => w.allocations ?? [],
@@ -7761,6 +8362,7 @@ export class TrainSchedulingService {
       status: schedule.status,
       freightType: this.resolveScheduleFreightType(schedule),
       trainNumber: schedule.trainNumber ?? null,
+      voyageNumber: schedule.voyageNumber ?? null,
       maxWagons: schedule.maxWagons ?? null,
       direction: schedule.direction ?? null,
       reverseWagonOrder: schedule.reverseWagonOrder ?? false,
@@ -8403,7 +9005,12 @@ export class TrainSchedulingService {
       .map((sb) => sb.booking)
       .filter((b): b is Booking => Boolean(b));
     const eligible = linkedBookings.filter(
-      (b) => SCHEDULABLE_BOOKING_STATUSES.includes(b.status as 'PAID') || b.isGovernment,
+      (b) =>
+        SCHEDULABLE_BOOKING_STATUSES.includes(b.status as 'PAID') ||
+        b.isGovernment ||
+        // Shipping-line bookings board without paying up front — their charge
+        // sits on the credit ledger, so accept (FULLY_EXECUTED) is boardable.
+        Boolean(b.shippingLineCompanyId),
     );
     if (!eligible.length) return empty;
 
@@ -8693,40 +9300,101 @@ export class TrainSchedulingService {
     }
 
     const allocRepo = this.dataSource.getRepository(WagonBookingAllocation);
+    // Cargo type → allowed wagon types rides along: for bulk, the commodity's
+    // own wagon-type list (the planner's rule) decides, not only the wagon
+    // type's generic supportedLoadTypes.
     const loadAllocations = (trainSetWagonId: string) =>
-      allocRepo.find({ where: { trainSetWagonId } });
+      allocRepo.find({
+        where: { trainSetWagonId },
+        relations: { booking: { cargoType: { wagonTypes: true } } },
+      });
     const sourceAllocs = await loadAllocations(source.id);
     if (!sourceAllocs.length) {
       throw new BadRequestException('Source wagon has no load to move');
     }
 
-    // Target: a slot of this train set, or an empty consist-only wagon of the
-    // built train (physical wagon with no slot row yet).
+    // Leg spans: a physical wagon carries one slot PER LEG (cross-leg sharing —
+    // Gelan→Adama and Adama→Doraleh loads ride the same wagon in two slots), so
+    // "the slot on that wagon" only means the one whose leg overlaps the moving
+    // load's leg. Null board/alight = the schedule's own endpoints.
+    const stops = await this.stopYardsForSchedule(schedule);
+    const spanOf = (slot: {
+      boardYardId?: string | null;
+      alightYardId?: string | null;
+    }): [number, number] => {
+      const from = slot.boardYardId ? stops.indexOf(slot.boardYardId) : 0;
+      const to = slot.alightYardId ? stops.indexOf(slot.alightYardId) : stops.length - 1;
+      return [from < 0 ? 0 : from, to < 0 ? Math.max(1, stops.length - 1) : to];
+    };
+    const overlaps = (a: [number, number], b: [number, number]) => a[0] < b[1] && b[0] < a[1];
+    const sourceSpan = spanOf(source);
+
+    // Target: a slot of this train set, or a physical wagon of this train —
+    // coupled-but-empty consist wagon (built train), or a wagon already pinned
+    // by another slot of this set (then: the overlapping-leg slot, or a fresh
+    // slot for a free leg).
     const slotById = slots.find((w) => w.id === dto.targetWagonId) ?? null;
-    const wagonForTarget = slotById
-      ? null
-      : schedule.trainSet?.trainId
-        ? await this.dataSource.getRepository(Wagon).findOne({
-            where: { id: dto.targetWagonId, trainId: schedule.trainSet.trainId },
-            relations: { wagonType: true },
-          })
-        : null;
+    let wagonForTarget: Wagon | null = null;
+    if (!slotById) {
+      const wagon = await this.dataSource.getRepository(Wagon).findOne({
+        where: { id: dto.targetWagonId },
+        relations: { wagonType: true },
+      });
+      const onThisTrain =
+        !!wagon &&
+        ((!!schedule.trainSet?.trainId && wagon.trainId === schedule.trainSet.trainId) ||
+          slots.some((w) => w.physicalWagonId === wagon.id));
+      wagonForTarget = onThisTrain ? wagon : null;
+    }
     if (!slotById && !wagonForTarget) {
       throw new NotFoundException('Target wagon is not part of this schedule');
     }
-    // A physical wagon holds at most one slot. When the caller addressed the
-    // wagon directly but a slot is already pinned to it, move into that slot
-    // rather than minting a second one on the same wagon.
     const targetSlot =
       slotById ??
       (wagonForTarget
-        ? (slots.find((w) => w.physicalWagonId === wagonForTarget.id) ?? null)
+        ? (slots.find(
+            (w) =>
+              w.physicalWagonId === wagonForTarget.id && overlaps(spanOf(w), sourceSpan),
+          ) ?? null)
         : null);
     const consistWagon = targetSlot ? null : wagonForTarget;
+
+    // Leg clash guard: after the move, no two slots on one physical wagon may
+    // ride the same edge. Source load → target wagon; on a swap, target load →
+    // source wagon.
+    const targetPhysicalId = targetSlot?.physicalWagonId ?? consistWagon?.id ?? null;
+    const clashOn = (
+      physicalWagonId: string | null,
+      excludeSlotId: string | null,
+      span: [number, number],
+    ) =>
+      !!physicalWagonId &&
+      slots.some(
+        (w) =>
+          w.physicalWagonId === physicalWagonId &&
+          w.id !== excludeSlotId &&
+          w.id !== source.id &&
+          (w.allocations?.length ?? 0) > 0 &&
+          overlaps(spanOf(w), span),
+      );
+    if (clashOn(targetPhysicalId, targetSlot?.id ?? null, sourceSpan)) {
+      throw new BadRequestException(
+        'That wagon already carries another load on the same leg — pick a wagon free on that leg.',
+      );
+    }
     const targetAllocs = targetSlot ? await loadAllocations(targetSlot.id) : [];
     if (targetSlot && targetSlot.id === source.id) {
       return this.getTrainScheduleById(scheduleId);
     }
+    if (
+      targetSlot &&
+      targetAllocs.length &&
+      clashOn(source.physicalWagonId ?? null, source.id, spanOf(targetSlot))
+    ) {
+      throw new BadRequestException(
+        'Swap refused: the source wagon already carries another load on the incoming load’s leg.',
+      );
+    }
 
     const loadTypesOf = (allocs: WagonBookingAllocation[]) => [
       ...new Set(allocs.map((a) => (a.loadType ?? 'CONTAINER').toUpperCase())),
@@ -8739,10 +9407,25 @@ export class TrainSchedulingService {
       slot.physicalWagon?.wagonNumber ?? `#${slot.sequenceNo}`;
     const wagonLabel = (slot: TrainSetWagon | null, wagon: Wagon | null) =>
       slot ? slotLabel(slot) : (wagon?.wagonNumber ?? 'the target wagon');
+    // Bulk is allowed on a wagon type when every bulk load's cargo type lists
+    // it (cargo-type ↔ wagon-type config, same rule the wagon planner uses).
+    const bulkCargoAllows = (allocs: WagonBookingAllocation[], wagonTypeId?: string) => {
+      const bulk = allocs.filter((a) => (a.loadType ?? 'CONTAINER').toUpperCase() === 'BULK');
+      return (
+        !!wagonTypeId &&
+        bulk.length > 0 &&
+        bulk.every((a) =>
+          (a.booking?.cargoType?.wagonTypes ?? []).some((wt) => wt.id === wagonTypeId),
+        )
+      );
+    };
     const checkReceives = (
       allocs: WagonBookingAllocation[],
       label: string,
-      wagonType: { code?: string; supportedLoadTypes?: string[]; supportsContainer?: boolean } | null | undefined,
+      wagonType:
+        | { id?: string; code?: string; supportedLoadTypes?: string[]; supportsContainer?: boolean }
+        | null
+        | undefined,
       capacityTons: number,
     ) => {
       const incoming = loadTypesOf(allocs);
@@ -8753,6 +9436,7 @@ export class TrainSchedulingService {
           const ok =
             supported.includes(loadType) ||
             (loadType === 'CONTAINER' && wagonType.supportsContainer) ||
+            (loadType === 'BULK' && bulkCargoAllows(allocs, wagonType.id)) ||
             supported.length === 0;
           if (!ok) {
             throw new BadRequestException(
@@ -9180,4 +9864,440 @@ export class TrainSchedulingService {
     });
     return new Set(allocations.map((a) => a.bookingId));
   }
+
+  // ── Train merge ────────────────────────────────────────────────────────────
+  // Combine two trains into one departure. The schedule the action is taken
+  // from ALWAYS survives: its train set is repointed at the target train, the
+  // target's wagons join this consist, and the source train is emptied and
+  // deactivated. When the target also runs a schedule on the SAME DAY, that
+  // schedule's bookings move here and it is soft-deleted; the target's
+  // other-day schedules contribute wagons only.
+
+  /** Statuses whose schedules may take part in a merge. */
+  private static readonly MERGEABLE_STATUSES: string[] = [
+    TrainScheduleStatusEnum.Draft,
+    TrainScheduleStatusEnum.Scheduled,
+  ];
+
+  /**
+   * Everything a merge needs to decide, gathered once. Both `previewMerge` and
+   * `mergeScheduleTrain` run this so the modal shows exactly what will happen
+   * and the commit cannot diverge from it.
+   */
+  private async planMerge(scheduleId: string, targetTrainId: string) {
+    const schedule =
+      await this.trainSchedulesRepository.findByIdWithFullGraph(scheduleId);
+    if (!schedule) {
+      throw new NotFoundException(`Train schedule ${scheduleId} not found`);
+    }
+    if (!TrainSchedulingService.MERGEABLE_STATUSES.includes(schedule.status)) {
+      throw new BadRequestException(
+        `Cannot merge into a ${schedule.status} schedule — only draft or scheduled departures can be merged.`,
+      );
+    }
+
+    const sourceTrainId = schedule.trainSet?.trainId ?? null;
+    if (sourceTrainId && sourceTrainId === targetTrainId) {
+      throw new BadRequestException(
+        'That is already this schedule\'s train — pick a different one to merge in.',
+      );
+    }
+
+    const targetTrain = await this.dataSource
+      .getRepository(Train)
+      .findOne({ where: { id: targetTrainId } });
+    if (!targetTrain) {
+      throw new NotFoundException(`Train ${targetTrainId} not found`);
+    }
+
+    // Every schedule the target train is committed to, via its train sets.
+    // Locomotives come along: the merged train is pulled by the union of this
+    // schedule's locos and the target train's, so capacity checks need both.
+    const targetSets = await this.dataSource
+      .getRepository(TrainSet)
+      .find({
+        where: { trainId: targetTrainId },
+        relations: { locomotives: { locomotive: true }, locomotive: true },
+      });
+    const targetSetIds = targetSets.map((s) => s.id);
+    const targetSchedules = targetSetIds.length
+      ? await this.dataSource.getRepository(TrainSchedule).find({
+          where: { trainSetId: In(targetSetIds) },
+        })
+      : [];
+
+    // The same-day schedule is the one whose bookings move here. Only a
+    // draft/scheduled one qualifies — a dispatched departure keeps its cargo.
+    const sameDay = (a: Date | string, b: Date | string) =>
+      new Date(a).toISOString().slice(0, 10) ===
+      new Date(b).toISOString().slice(0, 10);
+
+    const absorbed =
+      targetSchedules.find(
+        (s) =>
+          s.id !== schedule.id &&
+          sameDay(s.scheduledDepartureDate, schedule.scheduledDepartureDate) &&
+          TrainSchedulingService.MERGEABLE_STATUSES.includes(s.status),
+      ) ?? null;
+
+    // Wagons ride with the train, so every OTHER draft/scheduled schedule on it
+    // is affected too — it gains the merged consist but never the bookings.
+    const affectedOthers = targetSchedules.filter(
+      (s) =>
+        s.id !== schedule.id &&
+        s.id !== absorbed?.id &&
+        TrainSchedulingService.MERGEABLE_STATUSES.includes(s.status),
+    );
+    const untouched = targetSchedules.filter(
+      (s) =>
+        s.id !== schedule.id &&
+        s.id !== absorbed?.id &&
+        !TrainSchedulingService.MERGEABLE_STATUSES.includes(s.status),
+    );
+
+    // The wagons joining this consist: whatever physically sits on the target
+    // train today.
+    const incomingWagons = await this.dataSource
+      .getRepository(Wagon)
+      .find({ where: { trainId: targetTrainId }, order: { wagonNumber: 'ASC' } });
+
+    // EVERY wagon physically on the source train moves with the merge — not
+    // just the ones coupled into this schedule's set. A wagon left behind
+    // would strand on the deactivated train. "Loose" = on the train but not
+    // backing a set slot; it joins the counts and the capacity math.
+    const sourceWagons = sourceTrainId
+      ? await this.dataSource
+          .getRepository(Wagon)
+          .find({ where: { trainId: sourceTrainId }, order: { wagonNumber: 'ASC' } })
+      : [];
+    const coupledPhysicalIds = new Set(
+      (schedule.trainSet?.wagons ?? [])
+        .map((w) => w.physicalWagonId)
+        .filter(Boolean),
+    );
+    const looseSourceWagons = sourceWagons.filter(
+      (w) => !coupledPhysicalIds.has(w.id),
+    );
+
+    const movingBookings = absorbed
+      ? await this.dataSource.getRepository(TrainScheduleBooking).find({
+          where: { trainScheduleId: absorbed.id },
+          relations: { booking: true },
+        })
+      : [];
+
+    return {
+      schedule,
+      sourceTrainId,
+      targetTrain,
+      targetSets,
+      absorbed,
+      affectedOthers,
+      untouched,
+      incomingWagons,
+      looseSourceWagons,
+      movingBookings,
+    };
+  }
+
+  /**
+   * Blocking checks, run against the plan. Returns human-readable reasons; an
+   * empty array means the merge may proceed. Kept separate from `planMerge` so
+   * the preview can SHOW the reasons rather than throwing on them.
+   */
+  private async mergeBlockers(
+    plan: Awaited<ReturnType<TrainSchedulingService['planMerge']>>,
+  ): Promise<string[]> {
+    const blockers: string[] = [];
+    const { schedule, incomingWagons, movingBookings, absorbed } = plan;
+
+    if (incomingWagons.length === 0) {
+      blockers.push(
+        `${plan.targetTrain.code} has no wagons to merge — nothing would move.`,
+      );
+    }
+
+    // ── Capacity: the merged consist must fit the merged train's locomotives ─
+    // Existing side = coupled set slots PLUS loose wagons riding the source
+    // train without a slot — they all move, so they all count.
+    const existingSlots = (schedule.trainSet?.wagons ?? []).map((w) => ({
+      lengthMeters: Number(w.lengthMeters) || 0,
+      tareWeightTons: Number(w.wagonType?.tareWeightTons) || 0,
+      cargoTons: 0,
+    }));
+    const wagonTypeIds = [
+      ...new Set(
+        [...incomingWagons, ...plan.looseSourceWagons]
+          .map((w) => w.wagonTypeId)
+          .filter(Boolean),
+      ),
+    ];
+    const wagonTypes = wagonTypeIds.length
+      ? await this.dataSource
+          .getRepository(WagonType)
+          .find({ where: { id: In(wagonTypeIds) } })
+      : [];
+    const typeById = new Map(wagonTypes.map((t) => [t.id, t]));
+    const slotFromWagon = (w: Wagon) => {
+      const t = typeById.get(w.wagonTypeId);
+      return {
+        lengthMeters: Number(t?.lengthMeters) || 0,
+        tareWeightTons: Number(t?.tareWeightTons) || 0,
+        cargoTons: 0,
+      };
+    };
+    const incomingSlots = incomingWagons.map(slotFromWagon);
+    const looseSlots = plan.looseSourceWagons.map(slotFromWagon);
+
+    // The merged train is pulled by the union of this schedule's locomotives
+    // and whatever already pulls the target train (its sets keep their locos).
+    // Pull weight adds up across the pool; length stays the tightest cap.
+    const locoPool = [
+      ...this.locomotivesOfTrainSet(schedule.trainSet),
+      ...plan.targetSets.flatMap((set) => this.locomotivesOfTrainSet(set)),
+    ];
+    const limits = combinedLocomotiveLimits([
+      ...new Map(locoPool.map((l) => [l.id, l])).values(),
+    ]);
+    if (limits) {
+      const rules = await this.dataSource
+        .getRepository(TrainSchedulingGlobalRules)
+        .find({ take: 1 });
+      const caps = trainHardCaps(limits, {
+        maxTrainWeightTons: rules[0]?.maxTrainWeightTons ?? undefined,
+        maxTrainLengthMeters: rules[0]?.maxTrainLengthMeters ?? undefined,
+      });
+      const merged = [...existingSlots, ...looseSlots, ...incomingSlots];
+      // Merge is a physical consist move, so only the physical axes gate it:
+      // can this schedule's locomotives pull the merged weight and length.
+      // `schedule.maxWagons` is the booking-window planning ceiling — using it
+      // as a slot cap here blocked every merge into a bigger train (e.g. a
+      // 3-wagon plan absorbing a 47-wagon train). The commit raises the
+      // ceiling to the merged size instead.
+      const violations = consistViolations(merged, {
+        maxWeightTons: caps.maxWeightTons,
+        maxLengthMeters: caps.maxLengthMeters,
+        maxWagonSlots: merged.length,
+      });
+      blockers.push(...violations);
+    }
+
+    // ── Legs: an absorbed booking must be servable by THIS schedule's route ──
+    if (absorbed && movingBookings.length) {
+      const routeYardIds = await this.routeYardSequence(schedule.routeId ?? null);
+      if (routeYardIds.length) {
+        const position = new Map(routeYardIds.map((id, i) => [id, i]));
+        const slotIds = movingBookings.map((mb) => mb.bookingId);
+        const allocations = slotIds.length
+          ? await this.dataSource.getRepository(WagonBookingAllocation).find({
+              where: { bookingId: In(slotIds) },
+              relations: { trainSetWagon: true },
+            })
+          : [];
+        const offRoute = new Set<string>();
+        for (const alloc of allocations) {
+          const board = alloc.trainSetWagon?.boardYardId ?? null;
+          const alight = alloc.trainSetWagon?.alightYardId ?? null;
+          // Null on both = rides the whole route; always compatible.
+          if (!board && !alight) continue;
+          const from = board ? position.get(board) : 0;
+          const to = alight ? position.get(alight) : routeYardIds.length - 1;
+          if (from === undefined || to === undefined || from >= to) {
+            offRoute.add(alloc.bookingId);
+          }
+        }
+        if (offRoute.size) {
+          blockers.push(
+            `${offRoute.size} booking(s) on ${absorbed.reference ?? 'the merged schedule'} ` +
+              'travel legs this schedule\'s route does not serve in the same order.',
+          );
+        }
+      }
+    }
+
+    return blockers;
+  }
+
+  /** Ordered yard ids along a route, origin first. Empty when unknown. */
+  private async routeYardSequence(routeId: string | null): Promise<string[]> {
+    if (!routeId) return [];
+    const milestones = await this.dataSource
+      .getRepository(RouteMilestone)
+      .find({ where: { routeId }, order: { sequenceNo: 'ASC' } });
+    return milestones
+      .map((m) => m.yardId)
+      .filter((id): id is string => Boolean(id));
+  }
+
+  /**
+   * What a merge WOULD do, without doing it. Drives the confirmation modal:
+   * which schedules gain wagons, which one is absorbed, and why it is blocked.
+   */
+  async previewMerge(scheduleId: string, targetTrainId: string) {
+    const plan = await this.planMerge(scheduleId, targetTrainId);
+    const blockers = await this.mergeBlockers(plan);
+
+    // Coupled slots plus loose wagons on the source train — everything moves.
+    const existingCount =
+      (plan.schedule.trainSet?.wagons?.length ?? 0) +
+      plan.looseSourceWagons.length;
+    return {
+      canMerge: blockers.length === 0,
+      blockers,
+      targetTrain: {
+        id: plan.targetTrain.id,
+        code: plan.targetTrain.code,
+        trainNumber: plan.targetTrain.trainNumber ?? null,
+      },
+      wagons: {
+        current: existingCount,
+        incoming: plan.incomingWagons.length,
+        merged: existingCount + plan.incomingWagons.length,
+      },
+      /** The same-day schedule whose bookings move here and is then removed. */
+      absorbedSchedule: plan.absorbed
+        ? {
+            id: plan.absorbed.id,
+            reference: plan.absorbed.reference ?? null,
+            scheduledDepartureDate: plan.absorbed.scheduledDepartureDate,
+            status: plan.absorbed.status,
+            bookingsMoving: plan.movingBookings.length,
+          }
+        : null,
+      /** Other draft/scheduled schedules on the target — wagons only. */
+      affectedSchedules: plan.affectedOthers.map((s) => ({
+        id: s.id,
+        reference: s.reference ?? null,
+        scheduledDepartureDate: s.scheduledDepartureDate,
+        status: s.status,
+      })),
+      /** On the target train but left alone (dispatched, cancelled, …). */
+      untouchedSchedules: plan.untouched.map((s) => ({
+        id: s.id,
+        reference: s.reference ?? null,
+        scheduledDepartureDate: s.scheduledDepartureDate,
+        status: s.status,
+      })),
+      sourceTrainWillDeactivate: Boolean(plan.sourceTrainId),
+    };
+  }
+
+  /**
+   * Execute the merge. One transaction: repoint the train set, move the wagons
+   * (appended last so the builder can reorder them later), carry the absorbed
+   * schedule's bookings across, soft-delete that schedule, and deactivate the
+   * emptied source train.
+   */
+  async mergeScheduleTrain(
+    scheduleId: string,
+    dto: MergeScheduleTrainDto,
+  ): Promise<TrainSchedule> {
+    const plan = await this.planMerge(scheduleId, dto.targetTrainId);
+    const blockers = await this.mergeBlockers(plan);
+    if (blockers.length) {
+      throw new BadRequestException(blockers.join(' '));
+    }
+
+    const {
+      schedule,
+      sourceTrainId,
+      targetTrain,
+      absorbed,
+      incomingWagons,
+      movingBookings,
+    } = plan;
+    const trainSetId = schedule.trainSetId;
+
+    await this.dataSource.transaction(async (manager) => {
+      // 1. This schedule's set now runs on the target train.
+      await manager.getRepository(TrainSet).update(trainSetId, {
+        trainId: targetTrain.id,
+      });
+
+      // 2. The physical wagons follow the train — the target's stay put, and
+      //    EVERY wagon on the source train (coupled or loose) moves across so
+      //    nothing strands on the deactivated train.
+      if (incomingWagons.length) {
+        await manager.getRepository(Wagon).update(
+          { id: In(incomingWagons.map((w) => w.id)) },
+          { trainId: targetTrain.id },
+        );
+      }
+      if (sourceTrainId) {
+        await manager
+          .getRepository(Wagon)
+          .update({ trainId: sourceTrainId }, { trainId: targetTrain.id });
+      }
+
+      // 3. Carry the target's train-set wagon rows into THIS consist, appended
+      //    after the existing wagons. Sequence is provisional — staff reorder
+      //    in the train builder afterwards.
+      const existing = schedule.trainSet?.wagons ?? [];
+      let nextSequence =
+        existing.reduce((max, w) => Math.max(max, w.sequenceNo ?? 0), 0) + 1;
+      const incomingSetWagons = await manager.getRepository(TrainSetWagon).find({
+        where: { physicalWagonId: In(incomingWagons.map((w) => w.id)) },
+      });
+      for (const row of incomingSetWagons) {
+        if (row.trainSetId === trainSetId) continue;
+        await manager.getRepository(TrainSetWagon).update(row.id, {
+          trainSetId,
+          sequenceNo: nextSequence,
+        });
+        nextSequence += 1;
+      }
+
+      // 4. The absorbed schedule's bookings move here. `bookingId` is uniquely
+      //    indexed, so these rows are UPDATED across rather than re-inserted.
+      if (absorbed && movingBookings.length) {
+        await manager
+          .getRepository(TrainScheduleBooking)
+          .update(
+            { trainScheduleId: absorbed.id },
+            { trainScheduleId: schedule.id },
+          );
+      }
+
+      // 5. The absorbed schedule is soft-deleted — its bookings still exist and
+      //    still depart that day, so nobody is notified and nothing is lost.
+      if (absorbed) {
+        await manager.getRepository(TrainSchedule).softDelete(absorbed.id);
+      }
+
+      // 6. The source train is now empty; park it.
+      if (sourceTrainId) {
+        await manager.getRepository(Train).update(sourceTrainId, {
+          status: Freight.TrainStatus.Deactivated,
+        });
+      }
+
+      // 7. Keep the set's cached totals honest.
+      const mergedCount =
+        (schedule.trainSet?.wagons?.length ?? 0) + incomingSetWagons.length;
+      await manager
+        .getRepository(TrainSet)
+        .update(trainSetId, { wagonCount: mergedCount });
+
+      // 8. Booking capacity follows the consist: raise (never lower) the
+      //    planning ceiling so the merged wagons are actually sellable.
+      if (mergedCount > (schedule.maxWagons ?? 0)) {
+        await manager
+          .getRepository(TrainSchedule)
+          .update(schedule.id, { maxWagons: mergedCount });
+      }
+    });
+
+    this.logger.log(
+      `Schedule ${schedule.reference ?? scheduleId} merged with train ${targetTrain.code}` +
+        ` — ${incomingWagons.length} wagon(s) moved` +
+        (absorbed
+          ? `, absorbed ${absorbed.reference ?? absorbed.id} (${movingBookings.length} booking(s))`
+          : '') +
+        (sourceTrainId ? ', source train deactivated' : '') +
+        (dto.reason?.trim() ? ` (${dto.reason.trim()})` : ''),
+    );
+
+    const fresh = await this.trainSchedulesRepository.findById(scheduleId);
+    return fresh ?? schedule;
+  }
 }
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.module.ts b/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.module.ts
index 56f2cff00..dd5cc74bc 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.module.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/train-scheduling.module.ts
@@ -24,9 +24,9 @@ import { WarehousesModule } from '../warehouses/warehouses.module';
 import { TrainCheckpointEvent } from './entities/train-checkpoint-event.entity';
 import { ImportDjiboutiOperation } from './entities/import-djibouti-operation.entity';
 import { TrainSchedulingGlobalRules } from './entities/train-scheduling-global-rules.entity';
-import { TrainCheckpointEventsRepository } from './train-checkpoint-events.repository';
-import { TrainSchedulingController } from './train-scheduling.controller';
-import { TrainSchedulingService } from './train-scheduling.service';
+import { TrainCheckpointEventsRepository } from './repositories/train-checkpoint-events.repository';
+import { TrainSchedulingController } from './controllers/train-scheduling.controller';
+import { TrainSchedulingService } from './services/train-scheduling.service';
 import { BookingBatchService } from './booking-batch.service';
 import { BookingNotifierService } from './booking-notifier.service';
 import { BookingWindowGateway } from './booking-window.gateway';
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/derive-schedule-direction.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/derive-schedule-direction.util.spec.ts
similarity index 100%
rename from apps/edr-freight-api/src/modules/train-scheduling/derive-schedule-direction.util.spec.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/derive-schedule-direction.util.spec.ts
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/derive-schedule-direction.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/derive-schedule-direction.util.ts
similarity index 65%
rename from apps/edr-freight-api/src/modules/train-scheduling/derive-schedule-direction.util.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/derive-schedule-direction.util.ts
index 7e7358358..1916f5bb8 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/derive-schedule-direction.util.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/derive-schedule-direction.util.ts
@@ -1,4 +1,4 @@
-import { deriveTradeDirection } from '../../common/derive-trade-direction.util';
+import { deriveTradeDirection } from '../../../common/derive-trade-direction.util';
 
 /** @deprecated Use deriveTradeDirection from common — kept as alias for train scheduling. */
 export const deriveScheduleDirection = deriveTradeDirection;
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/fleet-plan.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/fleet-plan.util.spec.ts
similarity index 96%
rename from apps/edr-freight-api/src/modules/train-scheduling/fleet-plan.util.spec.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/fleet-plan.util.spec.ts
index ff685d30c..23a432a1c 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/fleet-plan.util.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/fleet-plan.util.spec.ts
@@ -1,5 +1,5 @@
-import { Booking } from '../bookings/entities/booking.entity';
-import { WagonType } from '../wagon-types/entities/wagon-type.entity';
+import { Booking } from '../../bookings/entities/booking.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
 import {
   computeFleetAvailability,
   selectBookingsWithinFleetCap,
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/fleet-plan.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/fleet-plan.util.ts
similarity index 96%
rename from apps/edr-freight-api/src/modules/train-scheduling/fleet-plan.util.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/fleet-plan.util.ts
index 2769c212b..1dbd6e05a 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/fleet-plan.util.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/fleet-plan.util.ts
@@ -1,6 +1,6 @@
-import { bookingCargoTons, bulkWagonsForAllowedTypes } from './train-capacity.util';
-import type { Booking } from '../bookings/entities/booking.entity';
-import type { WagonType } from '../wagon-types/entities/wagon-type.entity';
+import { bookingCargoTons, bulkWagonsForAllowedTypes } from '../train-capacity.util';
+import type { Booking } from '../../bookings/entities/booking.entity';
+import type { WagonType } from '../../wagon-types/entities/wagon-type.entity';
 import {
   buildBulkWagonPlan,
   buildContainerWagonPlan,
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/utils/schedule-wagon-usage.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/schedule-wagon-usage.util.spec.ts
new file mode 100644
index 000000000..6507b8a8c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/schedule-wagon-usage.util.spec.ts
@@ -0,0 +1,113 @@
+import { computeScheduleWagonUsage } from './schedule-wagon-usage.util';
+
+/** A coupled slot; `allocated` = a booking actually sits on it. */
+const slot = (allocated = false) => ({ allocations: allocated ? [{}] : [] });
+const booking = (wagonsRequired: number | null) => ({ booking: { wagonsRequired } });
+
+describe('computeScheduleWagonUsage', () => {
+  it('reports allocated slots as used, not the coupled consist size', () => {
+    // The reported bug: a 37-wagon consist carrying 3 allocated bookings read
+    // "37 wgn used" in the list while the detail page read "3 in use".
+    const slots = [...Array(34).fill(slot(false)), ...Array(3).fill(slot(true))];
+
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: slots,
+      storedWagonCount: 37,
+      scheduleBookings: [],
+    });
+
+    expect(usage.wagonsUsed).toBe(3);
+    expect(usage.wagonsTotal).toBe(37);
+  });
+
+  it('counts a built train with no bookings as 0 used', () => {
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: Array(40).fill(slot(false)),
+      storedWagonCount: 40,
+      scheduleBookings: [],
+    });
+
+    expect(usage.wagonsUsed).toBe(0);
+    expect(usage.wagonsRemaining).toBe(40);
+  });
+
+  it('treats wagons of an unpaid booking as reserved, so they are not bookable', () => {
+    // Booking claims 5 wagons but has no wagon plan yet: 0 used, still only 5
+    // bookable on a 10-wagon train — the reservation is not free space.
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: Array(10).fill(slot(false)),
+      storedWagonCount: 10,
+      scheduleBookings: [booking(5)],
+    });
+
+    expect(usage.wagonsUsed).toBe(0);
+    expect(usage.wagonsReserved).toBe(5);
+    expect(usage.wagonsRemaining).toBe(5);
+  });
+
+  it('does not double-count a booking that is both reserved and allocated', () => {
+    // 3 allocated slots for a booking that reserved 3 wagons: 7 remain, not 4.
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: [...Array(7).fill(slot(false)), ...Array(3).fill(slot(true))],
+      storedWagonCount: 10,
+      scheduleBookings: [booking(3)],
+    });
+
+    expect(usage.wagonsUsed).toBe(3);
+    expect(usage.wagonsReserved).toBe(3);
+    expect(usage.wagonsRemaining).toBe(7);
+  });
+
+  it('never reports negative remaining when claims exceed the consist', () => {
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: Array(2).fill(slot(false)),
+      storedWagonCount: 2,
+      scheduleBookings: [booking(5)],
+    });
+
+    expect(usage.wagonsRemaining).toBe(0);
+  });
+
+  it('sells against the planned ceiling, not the partially coupled consist', () => {
+    // S-2026-00003: planned 3 wagons, 2 coupled + allocated for a paid booking
+    // that reserved 2 — the list read "2/2 used, 0 bookable" while the detail
+    // page and the booking gate (remainingWagonsForLeg vs maxWagons) both said
+    // 1 wagon was still free. Wagons couple on demand; the ceiling is capacity.
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: Array(2).fill(slot(true)),
+      storedWagonCount: 2,
+      scheduleBookings: [booking(2)],
+      maxWagons: 3,
+    });
+
+    expect(usage.wagonsUsed).toBe(2);
+    expect(usage.wagonsTotal).toBe(3);
+    expect(usage.wagonsRemaining).toBe(1);
+  });
+
+  it('falls back to the stored counter when slot rows were not loaded', () => {
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: [],
+      storedWagonCount: 12,
+      scheduleBookings: [],
+    });
+
+    expect(usage.wagonsTotal).toBe(12);
+    expect(usage.wagonsUsed).toBe(0);
+  });
+
+  it('tolerates missing relations and null wagonsRequired', () => {
+    const usage = computeScheduleWagonUsage({
+      wagonSlots: null,
+      storedWagonCount: null,
+      scheduleBookings: [booking(null)],
+    });
+
+    expect(usage).toEqual({
+      wagonsUsed: 0,
+      wagonsTotal: 0,
+      wagonsReserved: 0,
+      wagonsRemaining: 0,
+    });
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/utils/schedule-wagon-usage.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/schedule-wagon-usage.util.ts
new file mode 100644
index 000000000..899e4c066
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/schedule-wagon-usage.util.ts
@@ -0,0 +1,67 @@
+/**
+ * Wagon figures for a train-schedule list row.
+ *
+ * The list used to report `trainSet.wagonCount` — the COUPLED CONSIST SIZE —
+ * under the label "wgn used", so a 37-wagon train carrying 3 allocated bookings
+ * read "37 wgn used" in the list while its detail page (WagonPlanGrid) read
+ * "37 wagons · 3 in use". These helpers make the list agree with the detail
+ * page, which is the figure staff trust.
+ */
+
+/** The shape this math needs — a slot counts as used when it has allocations. */
+export interface WagonSlotLike {
+  allocations?: unknown[] | null;
+}
+
+export interface ScheduleBookingLike {
+  booking?: { wagonsRequired?: number | null } | null;
+}
+
+export interface ScheduleWagonUsage {
+  /** Coupled slots carrying at least one booking allocation. */
+  wagonsUsed: number;
+  /** Schedule capacity — the larger of coupled consist and planned ceiling. */
+  wagonsTotal: number;
+  /** Wagons claimed by bookings, including bookings that have not paid. */
+  wagonsReserved: number;
+  /** Capacity minus what bookings have claimed — what is still bookable. */
+  wagonsRemaining: number;
+}
+
+export function computeScheduleWagonUsage(input: {
+  wagonSlots?: WagonSlotLike[] | null;
+  /** Stored counter; used only when the slot rows were not loaded. */
+  storedWagonCount?: number | null;
+  scheduleBookings?: ScheduleBookingLike[] | null;
+  /** Planned wagon ceiling (`maxWagons`) — what booking capacity is sold against. */
+  maxWagons?: number | null;
+}): ScheduleWagonUsage {
+  const slots = input.wagonSlots ?? [];
+
+  // Same predicate as the detail page's WagonPlanGrid: a slot is in use only
+  // when a booking is actually allocated onto it.
+  const wagonsUsed = slots.filter((slot) => (slot.allocations?.length ?? 0) > 0).length;
+
+  // Prefer live slot rows; the stored counter drifts when a consist is edited
+  // without a recompute, which is why the list and detail disagreed on totals.
+  const coupled = slots.length || (input.storedWagonCount ?? 0);
+
+  // Wagons are coupled on demand as bookings are allocated, so a partially
+  // built consist does not cap what is bookable — the planned ceiling does
+  // (remainingWagonsForLeg sells against maxWagons). Without this, a schedule
+  // planned for 3 wagons with 2 coupled+allocated read "2/2 used, 0 bookable"
+  // while its detail page and the booking gate both said 1 wagon was free.
+  const wagonsTotal = Math.max(coupled, input.maxWagons ?? 0);
+
+  // An unpaid booking still holds its wagons, so reserved space is NOT bookable.
+  const wagonsReserved = (input.scheduleBookings ?? []).reduce(
+    (sum, link) => sum + (link.booking?.wagonsRequired ?? 0),
+    0,
+  );
+
+  // Reserved subsumes allocated — an allocated booking still counts its wagons —
+  // so remaining subtracts whichever claim is larger, never both.
+  const wagonsRemaining = Math.max(0, wagonsTotal - Math.max(wagonsUsed, wagonsReserved));
+
+  return { wagonsUsed, wagonsTotal, wagonsReserved, wagonsRemaining };
+}
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-plan.util.spec.ts
similarity index 98%
rename from apps/edr-freight-api/src/modules/train-scheduling/wagon-plan.util.spec.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-plan.util.spec.ts
index 43c9d0f31..52176662a 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan.util.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-plan.util.spec.ts
@@ -1,7 +1,7 @@
 import { AllocationLoadType } from '@edr/types';
 
-import { Booking } from '../bookings/entities/booking.entity';
-import { WagonType } from '../wagon-types/entities/wagon-type.entity';
+import { Booking } from '../../bookings/entities/booking.entity';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
 import {
   buildBulkWagonPlan,
   buildContainerWagonPlan,
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-plan.util.ts
similarity index 99%
rename from apps/edr-freight-api/src/modules/train-scheduling/wagon-plan.util.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-plan.util.ts
index 9720e46c4..01c497262 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan.util.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-plan.util.ts
@@ -1,8 +1,8 @@
 import { AllocationLoadType } from '@edr/types';
 
-import { Booking } from '../bookings/entities/booking.entity';
-import { containersPerWagonForSize, wagonsPerUnitForSize } from '../rule-engine/container-type.util';
-import { WagonType } from '../wagon-types/entities/wagon-type.entity';
+import { Booking } from '../../bookings/entities/booking.entity';
+import { containersPerWagonForSize, wagonsPerUnitForSize } from '../../rule-engine/container-type.util';
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
 import {
   bookingCargoTons,
   bulkItemsFitFor,
@@ -10,7 +10,7 @@ import {
   bulkTonsPerWagon,
   bulkTonWagonsRequired,
   consistViolations,
-} from './train-capacity.util';
+} from '../train-capacity.util';
 
 export const MAX_TRAIN_WEIGHT_TONS = 3500;
 export const MAX_TRAIN_LENGTH_METERS = 760;
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-readiness.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-readiness.util.spec.ts
similarity index 100%
rename from apps/edr-freight-api/src/modules/train-scheduling/wagon-readiness.util.spec.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-readiness.util.spec.ts
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-readiness.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-readiness.util.ts
similarity index 100%
rename from apps/edr-freight-api/src/modules/train-scheduling/wagon-readiness.util.ts
rename to apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-readiness.util.ts
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-type-resolver.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-type-resolver.util.ts
new file mode 100644
index 000000000..6ce404ed1
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/train-scheduling/utils/wagon-type-resolver.util.ts
@@ -0,0 +1,49 @@
+import { WagonType } from '../../wagon-types/entities/wagon-type.entity';
+
+const CARGO_CODE_TO_WAGON_TYPE: Record<string, string> = {
+  COFFEE: 'KW2',
+  GRAIN: 'KW2',
+  WHEAT: 'KW2',
+  SORGHUM: 'KW2',
+  CORN: 'KW2',
+  FERTILIZER: 'PW2',
+  SUGAR: 'PW2',
+  COAL: 'KW3',
+  STEEL: 'CW3',
+  ORE: 'CW3',
+};
+
+const DEFAULT_BULK_WAGON_TYPE = 'CW3';
+const DEFAULT_CONTAINER_WAGON_TYPE = 'NW5';
+
+/**
+ * Resolve wagon type code from cargo type code for bulk freight.
+ */
+export function resolveBulkWagonTypeCode(cargoTypeCode?: string | null): string {
+  if (!cargoTypeCode) return DEFAULT_BULK_WAGON_TYPE;
+  const normalized = cargoTypeCode.trim().toUpperCase();
+  return CARGO_CODE_TO_WAGON_TYPE[normalized] ?? DEFAULT_BULK_WAGON_TYPE;
+}
+
+/**
+ * Pick the best matching wagon type entity for bulk cargo.
+ */
+export function pickBulkWagonType(
+  wagonTypes: WagonType[],
+  cargoTypeCode?: string | null,
+): WagonType | undefined {
+  const preferredCode = resolveBulkWagonTypeCode(cargoTypeCode);
+  const direct = wagonTypes.find((wt) => wt.code === preferredCode && wt.isActive);
+  if (direct) return direct;
+
+  return wagonTypes.find(
+    (wt) =>
+      wt.isActive &&
+      !wt.supportsContainer &&
+      wt.code !== DEFAULT_CONTAINER_WAGON_TYPE,
+  );
+}
+
+export function getDefaultContainerWagonTypeCode(): string {
+  return DEFAULT_CONTAINER_WAGON_TYPE;
+}
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.spec.ts
index 8d9339186..af0cd11f4 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.spec.ts
@@ -4,7 +4,7 @@ import {
   applyWagonOrderReversal,
   planWagonsWithStock,
 } from './wagon-plan-flex.util';
-import type { WagonPlanSlot } from './wagon-plan.util';
+import type { WagonPlanSlot } from './utils/wagon-plan.util';
 
 const nw6: WagonType = {
   id: 'wt-nw6',
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.ts
index ef1e741be..29a67da45 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/wagon-plan-flex.util.ts
@@ -11,7 +11,7 @@ import {
   sortBookingsForScheduling,
   type BookingWagonShortage,
   type DeferredBookingRow,
-} from './fleet-plan.util';
+} from './utils/fleet-plan.util';
 import {
   MAX_TEU_SLOTS_PER_WAGON,
   containerWagonsForLines,
@@ -21,7 +21,7 @@ import {
   teuSlotsForSizeFt,
   type SlotLoadType,
   type WagonPlanSlot,
-} from './wagon-plan.util';
+} from './utils/wagon-plan.util';
 
 /**
  * Wagon types allowed to carry each container type / bulk cargo type — the
@@ -43,6 +43,16 @@ export type WagonStock = {
   remainingByTypeId: Map<string, number>;
   /** Wagon-type code per id, for human-readable shortfall messages. */
   codesByTypeId: Map<string, string>;
+  /**
+   * Multi-yard consist only: yardId → (wagonTypeId → count) for the wagons
+   * standing at that yard. A train whose wagons are split across yards can
+   * only offer, at each boarding yard, the wagons physically standing there —
+   * a wagon waiting in Mojo is not bookable from Dire, and one picked up at
+   * Dire is not re-offered at Mojo. Absent (undefined) when every wagon sits
+   * in one yard, which keeps single-yard trains on the original whole-train
+   * math.
+   */
+  byYardId?: Map<string, Map<string, number>>;
 };
 
 export type FlexPlanResult = {
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.spec.ts b/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.spec.ts
index 47823cddd..5815ce435 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.spec.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.spec.ts
@@ -68,3 +68,94 @@ describe('WagonStockLedger', () => {
     expect(ledger.availableFor(['nw5'], { fromEdge: 2, toEdge: 3 })).toBe(10);
   });
 });
+
+describe('WagonStockLedger — multi-yard consist', () => {
+  // The reported case: a built train of 53 wagons, 20 standing in Dire and 33
+  // in Mojo. Each yard may only sell the wagons physically standing there.
+  const DIRE = 'yard-dire';
+  const MOJO = 'yard-mojo';
+  const ADDIS = 'yard-addis';
+  const STOPS = [DIRE, MOJO, ADDIS];
+  const EDGES = STOPS.length - 1;
+  const splitStock = () =>
+    new Map([
+      [DIRE, new Map([['nw5', 20]])],
+      [MOJO, new Map([['nw5', 33]])],
+    ]);
+  // Legs along Dire → Mojo → Addis.
+  const DIRE_TO_ADDIS = { fromEdge: 0, toEdge: 2 };
+  const MOJO_TO_ADDIS = { fromEdge: 1, toEdge: 2 };
+
+  const splitLedger = () =>
+    new WagonStockLedger(new Map([['nw5', 53]]), EDGES, splitStock(), STOPS);
+
+  it('offers each yard only the wagons standing there', () => {
+    const ledger = splitLedger();
+    expect(ledger.availableFor(['nw5'], DIRE_TO_ADDIS)).toBe(20);
+    expect(ledger.availableFor(['nw5'], MOJO_TO_ADDIS)).toBe(33);
+  });
+
+  it('keeps the yards independent — Dire bookings never eat Mojo stock', () => {
+    const ledger = splitLedger();
+    // A Dire booking rides the whole corridor, occupying the Mojo→Addis edge…
+    expect(ledger.consume(['nw5'], 20, DIRE_TO_ADDIS)).toBe(20);
+    expect(ledger.availableFor(['nw5'], DIRE_TO_ADDIS)).toBe(0);
+    // …but those are Dire's steel, so Mojo still has its own 33 to sell.
+    expect(ledger.availableFor(['nw5'], MOJO_TO_ADDIS)).toBe(33);
+    expect(ledger.consume(['nw5'], 33, MOJO_TO_ADDIS)).toBe(33);
+    expect(ledger.availableFor(['nw5'], MOJO_TO_ADDIS)).toBe(0);
+  });
+
+  it('never lends a free Dire wagon to a Mojo customer', () => {
+    const ledger = splitLedger();
+    // Only 5 of Dire's 20 sell; the other 15 ride past Mojo empty.
+    expect(ledger.consume(['nw5'], 5, DIRE_TO_ADDIS)).toBe(5);
+    // Mojo is still capped at its own 33 — the 15 empty Dire wagons are not
+    // offered here, exactly as the operator requires.
+    expect(ledger.availableFor(['nw5'], MOJO_TO_ADDIS)).toBe(33);
+    expect(ledger.consume(['nw5'], 40, MOJO_TO_ADDIS)).toBe(33);
+  });
+
+  it('offers nothing at the destination — there is nothing to pick up there', () => {
+    const ledger = splitLedger();
+    // A leg boarding at the last stop has no pool of its own.
+    expect(ledger.availableFor(['nw5'], { fromEdge: 2, toEdge: 2 })).toBe(0);
+  });
+
+  it('second example: Addis → Dire → Indode → Mojo → Djibouti', () => {
+    const [ADD, DIRE_2, INDODE, MOJO_2, DJIBOUTI] = [
+      'yard-add',
+      'yard-dire',
+      'yard-indode',
+      'yard-mojo',
+      'yard-djibouti',
+    ];
+    const stops = [ADD, DIRE_2, INDODE, MOJO_2, DJIBOUTI];
+    const ledger = new WagonStockLedger(
+      new Map([['nw5', 53]]),
+      stops.length - 1,
+      new Map([
+        [DIRE_2, new Map([['nw5', 20]])],
+        [MOJO_2, new Map([['nw5', 33]])],
+      ]),
+      stops,
+    );
+    const to = (fromEdge: number) => ({ fromEdge, toEdge: stops.length - 1 });
+    // Addis: the train starts empty — nothing to sell.
+    expect(ledger.availableFor(['nw5'], to(0))).toBe(0);
+    // Dire: the 20 wagons waiting there.
+    expect(ledger.availableFor(['nw5'], to(1))).toBe(20);
+    // Indode: the same 20 wagons, which have moved with the train.
+    expect(ledger.availableFor(['nw5'], to(2))).toBe(0);
+    // Mojo: its own 33 only.
+    expect(ledger.availableFor(['nw5'], to(3))).toBe(33);
+  });
+
+  it('single-yard consist keeps the original whole-train behaviour', () => {
+    // No byYardId (the train is not split) — every leg sees the whole train,
+    // exactly as before this feature.
+    const ledger = new WagonStockLedger(new Map([['nw5', 53]]), EDGES);
+    expect(ledger.availableFor(['nw5'], DIRE_TO_ADDIS)).toBe(53);
+    expect(ledger.availableFor(['nw5'], MOJO_TO_ADDIS)).toBe(53);
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.ts b/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.ts
index 0e4f6949d..bf5b935ad 100644
--- a/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.ts
+++ b/apps/edr-freight-api/src/modules/train-scheduling/wagon-stock-ledger.util.ts
@@ -20,17 +20,53 @@ import type { CorridorLeg } from './corridor-capacity.util';
  * Gelan→Adama never competes for stock with an export on Adama→Doraleh.
  */
 export class WagonStockLedger {
+  /**
+   * Usage rows keyed by pool. A single-yard train has one pool (''), so this is
+   * exactly the original per-type accounting. A multi-yard consist keys by
+   * boarding yard as well, because the Dire wagons and the Mojo wagons are
+   * disjoint sets of steel: 5 Dire wagons riding the whole corridor occupy the
+   * Mojo→Addis edge, but they must not shrink what Mojo itself can offer.
+   */
   private readonly usedPerEdge = new Map<string, number[]>();
 
   constructor(
     private readonly remainingByTypeId: Map<string, number>,
     private readonly edgeCount: number,
+    /**
+     * Multi-yard consist only (see {@link WagonStock.byYardId}): the wagons
+     * standing at each yard. When present, a leg is served ONLY by the wagons
+     * standing at the yard it boards from — a Dire→Addis booking on a train
+     * whose wagons sit 20 in Dire and 33 in Mojo sees 20, and a Mojo→Addis
+     * booking sees 33, never the Dire wagons that ride past empty.
+     */
+    private readonly byYardId?: Map<string, Map<string, number>>,
+    /** Ordered corridor stops, parallel to the edges — maps an edge to its yard. */
+    private readonly stops: readonly string[] = [],
   ) {}
 
+  /** The yard a leg boards from, or '' when the train is not split across yards. */
+  private poolYardOf(leg: CorridorLeg): string {
+    if (!this.byYardId) return '';
+    return this.stops[leg.fromEdge] ?? '';
+  }
+
+  /** Usage-row key: one row per (pool, wagon type). */
+  private rowKey(wagonTypeId: string, leg: CorridorLeg): string {
+    const pool = this.poolYardOf(leg);
+    return pool ? `${pool}\u0000${wagonTypeId}` : wagonTypeId;
+  }
+
+  /** Wagons of one type offered at the yard a leg boards from. */
+  private totalForType(wagonTypeId: string, leg: CorridorLeg): number {
+    const pool = this.poolYardOf(leg);
+    if (!pool) return this.remainingByTypeId.get(wagonTypeId) ?? 0;
+    return this.byYardId?.get(pool)?.get(wagonTypeId) ?? 0;
+  }
+
   /** Free wagons of ONE type on a leg: total minus its busiest edge within that leg. */
   private availableForType(wagonTypeId: string, leg: CorridorLeg): number {
-    const total = this.remainingByTypeId.get(wagonTypeId) ?? 0;
-    const row = this.usedPerEdge.get(wagonTypeId);
+    const total = this.totalForType(wagonTypeId, leg);
+    const row = this.usedPerEdge.get(this.rowKey(wagonTypeId, leg));
     if (!row) return total;
     let busiest = 0;
     for (let edge = leg.fromEdge; edge < leg.toEdge; edge += 1) {
@@ -69,10 +105,11 @@ export class WagonStockLedger {
       if (!deepest) break;
 
       const take = Math.min(outstanding, deepest.free);
-      let row = this.usedPerEdge.get(deepest.id);
+      const key = this.rowKey(deepest.id, leg);
+      let row = this.usedPerEdge.get(key);
       if (!row) {
         row = new Array<number>(this.edgeCount).fill(0);
-        this.usedPerEdge.set(deepest.id, row);
+        this.usedPerEdge.set(key, row);
       }
       for (let edge = leg.fromEdge; edge < leg.toEdge; edge += 1) {
         row[edge] = (row[edge] ?? 0) + take;
diff --git a/apps/edr-freight-api/src/modules/trains/dto/build-train.dto.ts b/apps/edr-freight-api/src/modules/trains/dto/build-train.dto.ts
index 0c9415e42..08a424cdc 100644
--- a/apps/edr-freight-api/src/modules/trains/dto/build-train.dto.ts
+++ b/apps/edr-freight-api/src/modules/trains/dto/build-train.dto.ts
@@ -44,16 +44,16 @@ export class BuildTrainDto {
   @ApiPropertyOptional({
     type: [String],
     format: 'uuid',
-    description: 'Wagons to attach at build time, in consist order (must sit in the same yard)',
+    description: 'Wagons to attach at build time, in consist order (any yard)',
   })
   @IsOptional()
   @IsArray()
   @IsUUID('all', { each: true })
   wagonIds?: string[];
 
-  @ApiProperty({ maxLength: 100, description: 'Vogue number' })
+  @ApiProperty({ maxLength: 100, description: 'Voyage number' })
   @IsString()
-  @IsNotEmpty({ message: 'Vogue number is required' })
+  @IsNotEmpty({ message: 'Voyage number is required' })
   @MaxLength(100)
   trainName!: string;
 
diff --git a/apps/edr-freight-api/src/modules/trains/dto/send-wagon-to-maintenance.dto.ts b/apps/edr-freight-api/src/modules/trains/dto/send-wagon-to-maintenance.dto.ts
new file mode 100644
index 000000000..269c4f9b4
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/trains/dto/send-wagon-to-maintenance.dto.ts
@@ -0,0 +1,15 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, MaxLength } from 'class-validator';
+
+export class SendWagonToMaintenanceDto {
+  @ApiPropertyOptional({
+    description:
+      "Why the wagon is going to maintenance. Stored on the wagon's status-history " +
+      'log alongside the train it was detached from, matching the fleet desk flow.',
+    maxLength: 500,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  note?: string;
+}
diff --git a/apps/edr-freight-api/src/modules/trains/train-builder.controller.ts b/apps/edr-freight-api/src/modules/trains/train-builder.controller.ts
index 834663170..277c3be38 100644
--- a/apps/edr-freight-api/src/modules/trains/train-builder.controller.ts
+++ b/apps/edr-freight-api/src/modules/trains/train-builder.controller.ts
@@ -23,6 +23,7 @@ import { AssignTrainWagonsDto } from './dto/assign-train-wagons.dto';
 import { BuildTrainDto } from './dto/build-train.dto';
 import { ListBuiltTrainsQueryDto } from './dto/list-built-trains-query.dto';
 import { ReorderTrainWagonsDto } from './dto/reorder-train-wagons.dto';
+import { SendWagonToMaintenanceDto } from './dto/send-wagon-to-maintenance.dto';
 import { UpdateTrainDetailsDto } from './dto/update-train-details.dto';
 import { UpdateTrainLocomotivesDto } from './dto/update-train-locomotives.dto';
 import { UpdateTrainYardDto } from './dto/update-train-yard.dto';
@@ -39,6 +40,11 @@ import { TrainBuilderService } from './train-builder.service';
   FREIGHT_PERMS.trains.update,
   FREIGHT_PERMS.trains.assignWagons,
   FREIGHT_PERMS.trains.delete,
+  FREIGHT_PERMS.trains.changeLocomotives,
+  FREIGHT_PERMS.trains.changeYard,
+  FREIGHT_PERMS.trains.changeWagonYard,
+  FREIGHT_PERMS.trains.toggleActive,
+  FREIGHT_PERMS.trains.disband,
 ])
 export class TrainBuilderController {
   constructor(private readonly trainBuilderService: TrainBuilderService) {}
@@ -72,7 +78,7 @@ export class TrainBuilderController {
   }
 
   @Put(':id/locomotives')
-  @FleetManage(FREIGHT_PERMS.trains.update)
+  @FleetManage(FREIGHT_PERMS.trains.changeLocomotives)
   @ApiOperation({ summary: 'Replace the locomotive set (minimum 1, same yard)' })
   setLocomotives(
     @Param('id', ParseUUIDPipe) id: string,
@@ -94,7 +100,7 @@ export class TrainBuilderController {
   }
 
   @Patch(':id/yard')
-  @FleetManage(FREIGHT_PERMS.trains.update)
+  @FleetManage(FREIGHT_PERMS.trains.changeYard)
   @ApiOperation({
     summary: 'Relocate the train — its locomotives and wagons move to the new yard with it',
   })
@@ -102,6 +108,26 @@ export class TrainBuilderController {
     return this.trainBuilderService.setYard(id, dto.currentYardId);
   }
 
+  @Patch(':id/wagons/:wagonId/yard')
+  @FleetManage(FREIGHT_PERMS.trains.changeWagonYard)
+  @ApiOperation({
+    summary:
+      'Move one coupled wagon to another yard — refused while any live schedule has the wagon allocated',
+  })
+  setWagonYard(
+    @Param('id', ParseUUIDPipe) id: string,
+    @Param('wagonId', ParseUUIDPipe) wagonId: string,
+    @Body() dto: UpdateTrainYardDto,
+    @CurrentUser() user: AuthUserPayload,
+  ) {
+    return this.trainBuilderService.setWagonYard(
+      id,
+      wagonId,
+      dto.currentYardId,
+      resolveAuthUserId(user),
+    );
+  }
+
   @Post(':id/wagons')
   @FleetManage(FREIGHT_PERMS.trains.assignWagons)
   @ApiOperation({ summary: "Append AVAILABLE wagons from the train's yard to the consist" })
@@ -131,8 +157,14 @@ export class TrainBuilderController {
     @Param('id', ParseUUIDPipe) id: string,
     @Param('wagonId', ParseUUIDPipe) wagonId: string,
     @CurrentUser() user: AuthUserPayload,
+    @Body() dto?: SendWagonToMaintenanceDto,
   ) {
-    return this.trainBuilderService.sendWagonToMaintenance(id, wagonId, resolveAuthUserId(user));
+    return this.trainBuilderService.sendWagonToMaintenance(
+      id,
+      wagonId,
+      resolveAuthUserId(user),
+      dto?.note,
+    );
   }
 
   @Post(':id/reorder-wagons')
@@ -143,7 +175,7 @@ export class TrainBuilderController {
   }
 
   @Post(':id/deactivate')
-  @FleetManage(FREIGHT_PERMS.trains.update)
+  @FleetManage(FREIGHT_PERMS.trains.toggleActive)
   @ApiOperation({
     summary: 'Deactivate the train (park it) — only allowed with no active schedule',
   })
@@ -152,14 +184,14 @@ export class TrainBuilderController {
   }
 
   @Post(':id/activate')
-  @FleetManage(FREIGHT_PERMS.trains.update)
+  @FleetManage(FREIGHT_PERMS.trains.toggleActive)
   @ApiOperation({ summary: 'Reactivate a deactivated train back to AVAILABLE' })
   activate(@Param('id', ParseUUIDPipe) id: string) {
     return this.trainBuilderService.activate(id);
   }
 
   @Delete(':id')
-  @FleetManage(FREIGHT_PERMS.trains.delete)
+  @FleetManage(FREIGHT_PERMS.trains.disband)
   @HttpCode(HttpStatus.NO_CONTENT)
   @ApiOperation({ summary: 'Disband the train (release wagons and locomotives)' })
   disband(@Param('id', ParseUUIDPipe) id: string) {
diff --git a/apps/edr-freight-api/src/modules/trains/train-builder.maintenance.spec.ts b/apps/edr-freight-api/src/modules/trains/train-builder.maintenance.spec.ts
new file mode 100644
index 000000000..a6157db7c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/trains/train-builder.maintenance.spec.ts
@@ -0,0 +1,83 @@
+import { buildMaintenanceNotes, formatTrainRunLabel } from './train-builder.service';
+
+describe('formatTrainRunLabel', () => {
+  it('names the train by its export and import run numbers', () => {
+    // What staff actually recognise — NOT the internal code (TRN-LEDGER-PW2).
+    expect(
+      formatTrainRunLabel({
+        exportTrainNumber: '9201',
+        importTrainNumber: '9202',
+        trainNumber: 'TRN-7',
+        code: 'TRN-LEDGER-PW2',
+      }),
+    ).toBe('export 9201 / import 9202');
+  });
+
+  it('shows only the run number that is set', () => {
+    expect(
+      formatTrainRunLabel({ exportTrainNumber: '9201', code: 'TRN-LEDGER-PW2' }),
+    ).toBe('export 9201');
+    expect(
+      formatTrainRunLabel({ importTrainNumber: '9202', code: 'TRN-LEDGER-PW2' }),
+    ).toBe('import 9202');
+  });
+
+  it('falls back to the train number, then the code, when no run is set', () => {
+    expect(formatTrainRunLabel({ trainNumber: 'TRN-7', code: 'TRN-LEDGER-PW2' })).toBe(
+      'TRN-7',
+    );
+    expect(formatTrainRunLabel({ code: 'TRN-LEDGER-PW2' })).toBe('TRN-LEDGER-PW2');
+  });
+
+  it('ignores blank run numbers rather than printing empty labels', () => {
+    expect(
+      formatTrainRunLabel({ exportTrainNumber: '  ', importTrainNumber: null, code: 'C-1' }),
+    ).toBe('C-1');
+  });
+
+  it('never returns an empty label', () => {
+    expect(formatTrainRunLabel({})).toBe('unknown');
+  });
+});
+
+describe('buildMaintenanceNotes', () => {
+  it('records the operator reason together with the train it came off', () => {
+    const notes = buildMaintenanceNotes('export 9201 / import 9202', 'Brake shoe worn through');
+
+    expect(notes.statusLogNote).toBe(
+      'Brake shoe worn through (detached from train export 9201 / import 9202)',
+    );
+    expect(notes.movementNote).toBe(
+      'Sent to maintenance from train export 9201 / import 9202: Brake shoe worn through',
+    );
+  });
+
+  it('still records the train number when no reason is given', () => {
+    // The reason is optional, but which train a wagon left is never optional —
+    // the history has to answer that on its own.
+    const notes = buildMaintenanceNotes('export 9201 / import 9202');
+
+    expect(notes.statusLogNote).toBe('Detached from train export 9201 / import 9202');
+    expect(notes.movementNote).toBe('Sent to maintenance from train export 9201 / import 9202');
+  });
+
+  it('treats a whitespace-only reason as no reason', () => {
+    const notes = buildMaintenanceNotes('export 9201 / import 9202', '   ');
+
+    expect(notes.statusLogNote).toBe('Detached from train export 9201 / import 9202');
+    expect(notes.movementNote).toBe('Sent to maintenance from train export 9201 / import 9202');
+  });
+
+  it('trims padding around a real reason', () => {
+    const notes = buildMaintenanceNotes('export 9201 / import 9202', '  Coupler damage  ');
+
+    expect(notes.statusLogNote).toBe('Coupler damage (detached from train export 9201 / import 9202)');
+    expect(notes.movementNote).toBe('Sent to maintenance from train export 9201 / import 9202: Coupler damage');
+  });
+
+  it('handles a null reason from an older client', () => {
+    expect(buildMaintenanceNotes('export 9201 / import 9202', null).statusLogNote).toBe(
+      'Detached from train export 9201 / import 9202',
+    );
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/trains/train-builder.service.ts b/apps/edr-freight-api/src/modules/trains/train-builder.service.ts
index fbb5301fb..827596bb7 100644
--- a/apps/edr-freight-api/src/modules/trains/train-builder.service.ts
+++ b/apps/edr-freight-api/src/modules/trains/train-builder.service.ts
@@ -19,6 +19,7 @@ import { TrainSet } from '../train-sets/entities/train-set.entity';
 import { TrainSetWagon } from '../train-sets/entities/train-set-wagon.entity';
 import { WagonType } from '../wagon-types/entities/wagon-type.entity';
 import { WagonMovement } from '../wagons/entities/wagon-movement.entity';
+import { WagonStatusLog } from '../wagons/entities/wagon-status-log.entity';
 import { Wagon } from '../wagons/entities/wagon.entity';
 import { AssignTrainWagonsDto } from './dto/assign-train-wagons.dto';
 import { BuildTrainDto } from './dto/build-train.dto';
@@ -282,6 +283,10 @@ export class TrainBuilderService {
       wagonNumber: wagon.wagonNumber,
       sequenceNumber: wagon.sequenceNumber,
       status: wagon.status,
+      currentYardId: wagon.currentYardId ?? null,
+      currentYard: wagon.currentYard
+        ? { id: wagon.currentYard.id, code: wagon.currentYard.code, label: wagon.currentYard.label }
+        : null,
       wagonType: wagon.wagonType
         ? {
             id: wagon.wagonType.id,
@@ -325,6 +330,27 @@ export class TrainBuilderService {
         : null,
       locomotives,
       wagons,
+      // Where the consist physically stands. A train built from several yards
+      // only picks a yard's wagons up when it reaches that yard, and a customer
+      // boarding there can only book the wagons standing there — the schedule
+      // route must therefore cover every one of these yards before its
+      // destination.
+      wagonYards: [
+        ...wagons
+          .reduce((acc, wagon) => {
+            const id = wagon.currentYardId ?? 'UNASSIGNED';
+            const entry = acc.get(id) ?? {
+              yardId: wagon.currentYardId ?? null,
+              code: wagon.currentYard?.code ?? null,
+              label: wagon.currentYard?.label ?? null,
+              wagonCount: 0,
+            };
+            entry.wagonCount += 1;
+            acc.set(id, entry);
+            return acc;
+          }, new Map<string, { yardId: string | null; code: string | null; label: string | null; wagonCount: number }>())
+          .values(),
+      ].sort((a, b) => b.wagonCount - a.wagonCount),
       totals: {
         wagonCount: wagons.length,
         totalTareTons,
@@ -427,10 +453,13 @@ export class TrainBuilderService {
   }
 
   /**
-   * Relocate the train to another yard. The consist moves as one unit: every
-   * coupled locomotive and wagon follows to the new yard (so their current
-   * yards always match the train's), and each wagon gets a movement-ledger row.
-   * Blocked while the train is out on a dispatched run.
+   * Relocate the train to another yard. The locomotives always follow. Of the
+   * wagons, only those standing WITH the train move: on a consist spread
+   * across yards (20 in Dire, 33 waiting in Mojo), moving the train Dire→Mojo
+   * relocates the 20 it is actually pulling and leaves the Mojo wagons where
+   * they stand — the train collects those by arriving, not by this call.
+   * Each moved wagon gets a movement-ledger row. Blocked while the train is
+   * out on a dispatched run.
    */
   async setYard(id: string, currentYardId: string) {
     await this.dataSource.transaction(async (manager) => {
@@ -438,6 +467,7 @@ export class TrainBuilderService {
       if (train.currentYardId === currentYardId) return;
       const yard = await manager.getRepository(Yard).findOne({ where: { id: currentYardId } });
       if (!yard) throw new NotFoundException(`Yard ${currentYardId} not found`);
+      const previousYardId = train.currentYardId ?? null;
 
       await manager.getRepository(Train).update(train.id, { currentYardId: yard.id });
 
@@ -453,7 +483,17 @@ export class TrainBuilderService {
           );
       }
 
-      const wagons = await manager.getRepository(Wagon).find({ where: { trainId: train.id } });
+      const allWagons = await manager
+        .getRepository(Wagon)
+        .find({ where: { trainId: train.id } });
+      // Wagons travelling with the train = those at the yard it is leaving.
+      // A yard-less wagon has no standing position of its own, so it follows.
+      const wagons = allWagons.filter(
+        (wagon) =>
+          wagon.currentYardId == null ||
+          previousYardId == null ||
+          wagon.currentYardId === previousYardId,
+      );
       const now = new Date();
       for (const wagon of wagons) {
         if (wagon.currentYardId === yard.id) continue;
@@ -474,7 +514,43 @@ export class TrainBuilderService {
     return this.getComposition(id);
   }
 
-  /** Append AVAILABLE wagons from the train's own yard to the consist. */
+  /**
+   * Move ONE coupled wagon to another yard (the train and the rest of the
+   * consist stay put). Refused while any live (DRAFT/SCHEDULED/DISPATCHED)
+   * schedule has the wagon allocated to a slot — its standing yard is part of
+   * that schedule's route validation. Ledger row mirrors `setYard`.
+   */
+  async setWagonYard(id: string, wagonId: string, currentYardId: string, userId?: string | null) {
+    await this.dataSource.transaction(async (manager) => {
+      const train = await this.getEditableTrain(manager, id);
+      const wagon = await manager.getRepository(Wagon).findOne({ where: { id: wagonId } });
+      if (!wagon || wagon.trainId !== train.id) {
+        throw new NotFoundException(`Wagon ${wagonId} is not coupled to train ${train.code}`);
+      }
+      if (wagon.currentYardId === currentYardId) return;
+      const yard = await manager.getRepository(Yard).findOne({ where: { id: currentYardId } });
+      if (!yard) throw new NotFoundException(`Yard ${currentYardId} not found`);
+      if (await this.isWagonPinnedToLiveSchedule(manager, wagon.id)) {
+        throw new ConflictException(
+          `Wagon ${wagon.wagonNumber} is allocated to a scheduled or dispatched run; its yard cannot be changed`,
+        );
+      }
+      await manager.getRepository(Wagon).update(wagon.id, { currentYardId: yard.id });
+      await manager.getRepository(WagonMovement).save(
+        manager.getRepository(WagonMovement).create({
+          wagonId: wagon.id,
+          fromYardId: wagon.currentYardId ?? null,
+          toYardId: yard.id,
+          kind: WagonMovementKind.Manual,
+          movedByUserId: userId ?? null,
+          occurredAt: new Date(),
+        }),
+      );
+    });
+    return this.getComposition(id);
+  }
+
+  /** Append AVAILABLE, unassigned wagons (any yard) to the consist. */
   async assignWagons(id: string, dto: AssignTrainWagonsDto, userId?: string | null) {
     await this.dataSource.transaction(async (manager) => {
       const train = await this.getEditableTrain(manager, id);
@@ -501,15 +577,13 @@ export class TrainBuilderService {
       if (!wagon || wagon.trainId !== train.id) {
         throw new NotFoundException(`Wagon ${wagonId} is not part of this train`);
       }
-      if (await this.isWagonPinnedToLiveSchedule(manager, wagon.id)) {
-        throw new ConflictException(
-          `Wagon ${wagon.wagonNumber} is pinned to an active schedule and cannot be removed`,
-        );
-      }
+      await this.assertDetachableAndReleaseStaleSlots(manager, wagon);
       await manager.getRepository(Wagon).update(wagon.id, {
         trainId: null,
         sequenceNumber: null,
         status: WagonStatus.Available,
+        importTrainNumber: null,
+        exportTrainNumber: null,
       });
       await this.resequenceWagons(manager, train.id);
       await this.syncLiveScheduleAfterConsistChange(
@@ -528,23 +602,44 @@ export class TrainBuilderService {
    * moves to MAINTENANCE status (not AVAILABLE), so it is not re-coupled until
    * it clears maintenance. The freed sequence gap is closed.
    */
-  async sendWagonToMaintenance(id: string, wagonId: string, userId?: string | null) {
+  async sendWagonToMaintenance(
+    id: string,
+    wagonId: string,
+    userId?: string | null,
+    note?: string | null,
+  ) {
     await this.dataSource.transaction(async (manager) => {
       const train = await this.getEditableTrain(manager, id);
       const wagon = await manager.getRepository(Wagon).findOne({ where: { id: wagonId } });
       if (!wagon || wagon.trainId !== train.id) {
         throw new NotFoundException(`Wagon ${wagonId} is not part of this train`);
       }
-      if (await this.isWagonPinnedToLiveSchedule(manager, wagon.id)) {
-        throw new ConflictException(
-          `Wagon ${wagon.wagonNumber} is pinned to an active schedule and cannot be removed`,
-        );
-      }
+      await this.assertDetachableAndReleaseStaleSlots(manager, wagon);
+      const previousStatus = wagon.status;
+      const notes = buildMaintenanceNotes(formatTrainRunLabel(train), note);
       await manager.getRepository(Wagon).update(wagon.id, {
         trainId: null,
         sequenceNumber: null,
         status: WagonStatus.Maintenance,
+        importTrainNumber: null,
+        exportTrainNumber: null,
       });
+
+      // Status-history row, same as the fleet desk's "Send to maintenance" —
+      // without it a maintenance detach made here is invisible in the wagon's
+      // status history. The train number is folded into the note so the history
+      // answers "which train did it come off, and why" in one line.
+      if (previousStatus !== WagonStatus.Maintenance) {
+        await manager.getRepository(WagonStatusLog).save(
+          manager.getRepository(WagonStatusLog).create({
+            wagonId: wagon.id,
+            fromStatus: previousStatus,
+            toStatus: WagonStatus.Maintenance,
+            changedByUserId: userId ?? null,
+            note: notes.statusLogNote,
+          }),
+        );
+      }
       // Audit row: which train it came off and when. The wagon does not change
       // yard here, so from/to are the same — the ledger is the wagon's history
       // surface, and a maintenance detach has to be in it.
@@ -556,7 +651,7 @@ export class TrainBuilderService {
             fromYardId: yardId,
             toYardId: yardId,
             kind: WagonMovementKind.Maintenance,
-            note: `Sent to maintenance from train ${train.trainNumber ?? train.code}`,
+            note: notes.movementNote,
             occurredAt: new Date(),
           }),
         );
@@ -602,6 +697,57 @@ export class TrainBuilderService {
     return rows.length > 0;
   }
 
+  /**
+   * Detach guard for removeWagon / sendWagonToMaintenance. A wagon is truly
+   * pinned only while a live schedule still NEEDS it: a slot carrying booking
+   * allocations, or any slot on a DISPATCHED run. An empty (allocation-free)
+   * slot on a DRAFT/SCHEDULED schedule is a stale reservation — its load was
+   * moved to another wagon (moveWagonLoad keeps the emptied slot) or its
+   * booking left through a path that didn't clean up — and used to pin the
+   * wagon forever. Release those slots here instead of blocking, with the
+   * same recount removeTrainSetWagonSlot does (wagonCount / totalLengthMeters
+   * feed the schedule capacity math).
+   */
+  private async assertDetachableAndReleaseStaleSlots(
+    manager: EntityManager,
+    wagon: Wagon,
+  ): Promise<void> {
+    const rows: { id: string; train_set_id: string; status: string; allocs: string }[] =
+      await manager.query(
+        `SELECT tsw.id, tsw.train_set_id, ts.status,
+                (SELECT count(*)
+                   FROM freight.wagon_booking_allocations a
+                  WHERE a.train_set_wagon_id = tsw.id
+                    AND a.deleted_at IS NULL) AS allocs
+           FROM freight.train_set_wagons tsw
+           JOIN freight.train_schedules ts ON ts.train_set_id = tsw.train_set_id
+          WHERE tsw.physical_wagon_id = $1
+            AND ts.status IN ('DRAFT', 'SCHEDULED', 'DISPATCHED')
+            AND ts.deleted_at IS NULL
+            AND tsw.deleted_at IS NULL`,
+        [wagon.id],
+      );
+    if (!rows.length) return;
+    if (rows.some((r) => Number(r.allocs) > 0 || r.status === 'DISPATCHED')) {
+      throw new ConflictException(
+        `Wagon ${wagon.wagonNumber} is pinned to an active schedule and cannot be removed`,
+      );
+    }
+    await manager.getRepository(TrainSetWagon).delete(rows.map((r) => r.id));
+    for (const trainSetId of [...new Set(rows.map((r) => r.train_set_id))]) {
+      const remaining = await manager.getRepository(TrainSetWagon).find({
+        where: { trainSetId },
+        select: { id: true, lengthMeters: true },
+      });
+      await manager.getRepository(TrainSet).update(trainSetId, {
+        wagonCount: remaining.length,
+        totalLengthMeters: round(
+          remaining.reduce((sum, w) => sum + (Number(w.lengthMeters) || 0), 0),
+        ),
+      });
+    }
+  }
+
   /** Persist a drag-reorder: `wagonIds` is the full consist in its new order. */
   async reorderWagons(id: string, dto: ReorderTrainWagonsDto) {
     await this.dataSource.transaction(async (manager) => {
@@ -761,7 +907,13 @@ export class TrainBuilderService {
         .getRepository(Wagon)
         .update(
           { trainId: train.id },
-          { trainId: null, sequenceNumber: null, status: WagonStatus.Available },
+          {
+            trainId: null,
+            sequenceNumber: null,
+            status: WagonStatus.Available,
+            importTrainNumber: null,
+            exportTrainNumber: null,
+          },
         );
       await manager.getRepository(TrainLocomotive).delete({ trainId: train.id });
       await manager.getRepository(Train).remove(train);
@@ -1003,11 +1155,8 @@ export class TrainBuilderService {
       if (wagon.status !== WagonStatus.Available) {
         throw new ConflictException(`Wagon ${wagon.wagonNumber} is not available (${wagon.status})`);
       }
-      if (wagon.currentYardId !== train.currentYardId) {
-        throw new BadRequestException(
-          `Wagon ${wagon.wagonNumber} is not in the train's yard; only wagons in the same yard can be attached`,
-        );
-      }
+      // Wagons may sit in any yard — the schedule's route must pass through
+      // every wagon yard before its destination (checked at scheduling time).
       toAttach.push(wagon);
     }
     if (!toAttach.length) return [];
@@ -1021,6 +1170,10 @@ export class TrainBuilderService {
         trainId: train.id,
         sequenceNumber: sequence,
         status: WagonStatus.Assigned,
+        // Wagon inherits the train's run numbers on coupling — no per-wagon
+        // number entry, they ride whatever numbers the train was built with.
+        importTrainNumber: train.importTrainNumber,
+        exportTrainNumber: train.exportTrainNumber,
       });
     }
     return toAttach;
@@ -1097,6 +1250,48 @@ export class TrainBuilderService {
  * pinned to a reordered wagon adopt the wagon's new position; unpinned slots
  * trail behind in their previous relative order.
  */
+/**
+ * How a train is named in a wagon's history. Staff identify a train by its
+ * OPERATIONAL run numbers — the fixed export (odd) and import (even) numbers
+ * typed at build time — not by its internal code (`TRN-LEDGER-PW2`), which is a
+ * ledger key and means nothing on the ground. Both runs are shown when set,
+ * since one built train carries the pair. Falls back to the train number, then
+ * the code, only when no run number exists.
+ */
+export function formatTrainRunLabel(train: {
+  exportTrainNumber?: string | null;
+  importTrainNumber?: string | null;
+  trainNumber?: string | null;
+  code?: string | null;
+}): string {
+  const exportNo = train.exportTrainNumber?.trim();
+  const importNo = train.importTrainNumber?.trim();
+  const runs = [
+    exportNo ? `export ${exportNo}` : null,
+    importNo ? `import ${importNo}` : null,
+  ].filter(Boolean);
+  if (runs.length) return runs.join(' / ');
+  return train.trainNumber?.trim() || train.code?.trim() || 'unknown';
+}
+
+/**
+ * Notes for a maintenance detach. The train's run numbers are always recorded —
+ * staff need to know which consist a wagon came off — and the operator's reason
+ * is folded in when given, so the wagon's status history answers "which train,
+ * and why" in one line (matching the fleet desk's Send-to-maintenance note).
+ */
+export function buildMaintenanceNotes(trainLabel: string, note?: string | null) {
+  const reason = note?.trim();
+  return {
+    statusLogNote: reason
+      ? `${reason} (detached from train ${trainLabel})`
+      : `Detached from train ${trainLabel}`,
+    movementNote: reason
+      ? `Sent to maintenance from train ${trainLabel}: ${reason}`
+      : `Sent to maintenance from train ${trainLabel}`,
+  };
+}
+
 export function orderSlotsByWagonSequence<
   T extends Pick<TrainSetWagon, 'sequenceNo' | 'physicalWagonId'>,
 >(slots: T[], newSeq: Map<string, number>): T[] {
diff --git a/apps/edr-freight-api/src/modules/vehicles/vehicles.repository.ts b/apps/edr-freight-api/src/modules/vehicles/vehicles.repository.ts
index 1080480fa..c5af8cee2 100644
--- a/apps/edr-freight-api/src/modules/vehicles/vehicles.repository.ts
+++ b/apps/edr-freight-api/src/modules/vehicles/vehicles.repository.ts
@@ -21,52 +21,6 @@ export class VehiclesRepository extends BaseRepository<Vehicle> {
     return this.repository.findOne({ where: { id } });
   }
 
-  async findAllWithFilters(query: {
-    page?: number;
-    pageSize?: number;
-    search?: string;
-    status?: string;
-    sortBy?: string;
-    sortOrder?: 'ASC' | 'DESC';
-  }) {
-    const page = query.page || 1;
-    const pageSize = query.pageSize || 10;
-    const skip = (page - 1) * pageSize;
-
-    let queryBuilder = this.repository.createQueryBuilder('vehicle');
-
-    if (query.search) {
-      queryBuilder = queryBuilder.where(
-        '(vehicle.plateNumber ILIKE :search OR vehicle.manufacturer ILIKE :search OR vehicle.model ILIKE :search)',
-        { search: `%${query.search}%` },
-      );
-    }
-
-    if (query.status) {
-      queryBuilder = queryBuilder.andWhere('vehicle.status = :status', {
-        status: query.status,
-      });
-    }
-
-    const sortBy = query.sortBy || 'createdAt';
-    const sortOrder = query.sortOrder || 'DESC';
-
-    queryBuilder = queryBuilder
-      .orderBy(`vehicle.${sortBy}`, sortOrder)
-      .skip(skip)
-      .take(pageSize);
-
-    const [data, total] = await queryBuilder.getManyAndCount();
-
-    return {
-      data,
-      total,
-      page,
-      pageSize,
-      totalPages: Math.ceil(total / pageSize),
-    };
-  }
-
   async createVehicle(vehicleData: Partial<Vehicle>): Promise<Vehicle> {
     const vehicle = this.repository.create(vehicleData);
     return this.repository.save(vehicle);
diff --git a/apps/edr-freight-api/src/modules/verifayda/verifayda.service.ts b/apps/edr-freight-api/src/modules/verifayda/verifayda.service.ts
index af627f25a..298cae11e 100644
--- a/apps/edr-freight-api/src/modules/verifayda/verifayda.service.ts
+++ b/apps/edr-freight-api/src/modules/verifayda/verifayda.service.ts
@@ -28,6 +28,11 @@ import {
   NormalizedFaydaUserInfo,
   VerifaydaPurpose,
 } from './verifayda.types';
+import { randomUUID } from 'node:crypto';
+import { isBypassEnv } from '../../common/dev-bypass.util';
+
+/** Sentinel `code` that skips the real eSignet exchange in dev/staging. */
+export const DEV_BYPASS_FAYDA_CODE = 'DEV_BYPASS';
 
 export interface StartVerificationInput {
   purpose: VerifaydaPurpose;
@@ -143,6 +148,26 @@ export class VerifaydaService {
   async completeVerification(
     query: VerifaydaCallbackDto,
   ): Promise<CompleteVerificationResult> {
+    // Dev/staging only: caller sends the sentinel code instead of a real
+    // eSignet redirect — skip the token exchange/session entirely and hand
+    // back a canned VERIFY result. `sub` is unique per call so binding both
+    // owner and PoA in the same bypass session doesn't collide.
+    if (isBypassEnv() && query.code === DEV_BYPASS_FAYDA_CODE) {
+      this.logger.warn('Fayda verification BYPASSED (dev/staging)');
+      return {
+        purpose: 'VERIFY',
+        verified: true,
+        sub: `dev-bypass-${randomUUID()}`,
+        fullName: 'Dev Bypass User',
+        email: 'dev-bypass@example.com',
+        phoneNumber: '+251900000000',
+        birthdate: '1990-01-01',
+        gender: 'M',
+        address: 'Dev Bypass Address',
+        userDataSaved: false,
+      };
+    }
+
     if (query.error) {
       this.logger.warn(`Fayda callback returned error: ${query.error}`);
       if (query.state) {
diff --git a/apps/edr-freight-api/src/modules/wagons/dto/create-transfer-request.dto.ts b/apps/edr-freight-api/src/modules/wagons/dto/create-transfer-request.dto.ts
index e747b69f2..615ef0701 100644
--- a/apps/edr-freight-api/src/modules/wagons/dto/create-transfer-request.dto.ts
+++ b/apps/edr-freight-api/src/modules/wagons/dto/create-transfer-request.dto.ts
@@ -1,5 +1,7 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import {
+  ArrayMaxSize,
+  IsArray,
   IsInt,
   IsNotEmpty,
   IsOptional,
@@ -11,10 +13,14 @@ import {
 } from 'class-validator';
 
 /**
- * A count-only wagon-transfer request. The requester picks source yard, wagon
- * type, destination yard and HOW MANY — never the specific wagons; OCC hand-picks
- * those at fulfilment. The quantity may not exceed the AVAILABLE wagons of that
- * type currently in the source yard, and a reason is mandatory.
+ * A wagon-transfer request. The requester picks source yard, wagon type,
+ * destination yard and HOW MANY. The quantity may not exceed the AVAILABLE
+ * wagons of that type currently in the source yard (enforced in the service,
+ * which is the only layer that can count them), and a reason is mandatory.
+ *
+ * The requester may additionally name the specific wagons they want via
+ * `preferredWagonIds`. That is a preference recorded for OCC, not a
+ * reservation — the count still drives fulfilment.
  */
 export class CreateTransferRequestDto {
   @IsUUID()
@@ -37,6 +43,17 @@ export class CreateTransferRequestDto {
   @MaxLength(2000)
   reason!: string;
 
+  @ApiPropertyOptional({
+    description:
+      'Specific wagons the requester wants, if they picked any. A preference for OCC — the wagons are not reserved.',
+    type: [String],
+  })
+  @IsOptional()
+  @IsArray()
+  @ArrayMaxSize(1000)
+  @IsUUID('4', { each: true })
+  preferredWagonIds?: string[];
+
   @ApiPropertyOptional({ description: 'Optional note for the fulfilling staff' })
   @IsOptional()
   @IsString()
diff --git a/apps/edr-freight-api/src/modules/wagons/entities/wagon-transfer-request.entity.ts b/apps/edr-freight-api/src/modules/wagons/entities/wagon-transfer-request.entity.ts
index c39b12b9d..8b1922711 100644
--- a/apps/edr-freight-api/src/modules/wagons/entities/wagon-transfer-request.entity.ts
+++ b/apps/edr-freight-api/src/modules/wagons/entities/wagon-transfer-request.entity.ts
@@ -56,6 +56,14 @@ export class WagonTransferRequest extends BaseEntity {
   })
   status!: WagonTransferRequestStatus;
 
+  /**
+   * The wagons the requester specifically asked for, when they picked any. A
+   * preference, not a reservation — the wagons stay AVAILABLE to everyone else,
+   * and OCC may still send different ones. Null/empty on a plain count request.
+   */
+  @Column({ name: 'preferred_wagon_ids', type: 'uuid', array: true, nullable: true })
+  preferredWagonIds?: string[] | null;
+
   @Column({ name: 'requested_by_user_id', type: 'uuid', nullable: true })
   requestedByUserId?: string | null;
 
diff --git a/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.spec.ts b/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.spec.ts
index 205d86450..74fb6d6d7 100644
--- a/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.spec.ts
+++ b/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.spec.ts
@@ -149,6 +149,19 @@ describe('WagonTransferRequestsService — partial fulfilment', () => {
       expect(result.skipped).toHaveLength(0);
     });
 
+    it('auto-picks the wagons the requester named ahead of the rest', async () => {
+      // Asked for 2 and named w-3 — the auto-pick must take it even though
+      // wagon-number order would have sent w-0 and w-1.
+      build(request({ quantity: 2, preferredWagonIds: ['w-3'] }));
+      wagonRepo.find.mockResolvedValue(availableWagons(5));
+
+      await service.bulkFulfill(['req-1']);
+
+      const [{ wagonIds }] = wagonsService.bulkTransfer.mock.calls[0];
+      expect(wagonIds).toHaveLength(2);
+      expect(wagonIds[0]).toBe('w-3');
+    });
+
     it('skips only when the yard has nothing to give', async () => {
       wagonRepo.find.mockResolvedValue([]);
 
@@ -199,7 +212,7 @@ describe('WagonTransferRequestsService — partial fulfilment', () => {
   });
 
   describe('createRequest', () => {
-    it('accepts a count larger than what the yard holds today', async () => {
+    it('accepts a count up to what the yard holds today', async () => {
       wagonRepo.count.mockResolvedValue(20);
 
       await service.createRequest(
@@ -207,14 +220,128 @@ describe('WagonTransferRequestsService — partial fulfilment', () => {
           fromYardId: 'yard-a',
           toYardId: 'yard-b',
           wagonTypeId: 'type-1',
-          quantity: 50,
+          quantity: 20,
           reason: 'Grain campaign',
         },
         'user-1',
       );
 
       expect(requestRepo.save).toHaveBeenCalled();
-      expect(stored.quantity).toBe(50);
+      expect(stored.quantity).toBe(20);
+    });
+
+    it('refuses a count larger than what the yard holds today', async () => {
+      wagonRepo.count.mockResolvedValue(20);
+
+      await expect(
+        service.createRequest(
+          {
+            fromYardId: 'yard-a',
+            toYardId: 'yard-b',
+            wagonTypeId: 'type-1',
+            quantity: 50,
+            reason: 'Grain campaign',
+          },
+          'user-1',
+        ),
+      ).rejects.toThrow(/only 20 wagon\(s\).*available/i);
+      expect(requestRepo.save).not.toHaveBeenCalled();
+    });
+
+    it('refuses when the yard has nothing of that type available', async () => {
+      wagonRepo.count.mockResolvedValue(0);
+
+      await expect(
+        service.createRequest(
+          {
+            fromYardId: 'yard-a',
+            toYardId: 'yard-b',
+            wagonTypeId: 'type-1',
+            quantity: 1,
+            reason: 'Grain campaign',
+          },
+          'user-1',
+        ),
+      ).rejects.toThrow(/no available wagons/i);
+      expect(requestRepo.save).not.toHaveBeenCalled();
+    });
+
+    it('records the wagons the requester hand-picked', async () => {
+      wagonRepo.count.mockResolvedValue(20);
+      wagonRepo.find.mockResolvedValue(availableWagons(3));
+
+      await service.createRequest(
+        {
+          fromYardId: 'yard-a',
+          toYardId: 'yard-b',
+          wagonTypeId: 'type-1',
+          quantity: 3,
+          reason: 'Grain campaign',
+          preferredWagonIds: ['w-0', 'w-1', 'w-2'],
+        },
+        'user-1',
+      );
+
+      expect(stored.preferredWagonIds).toEqual(['w-0', 'w-1', 'w-2']);
+    });
+
+    it('leaves the picks null on a plain count request', async () => {
+      wagonRepo.count.mockResolvedValue(20);
+
+      await service.createRequest(
+        {
+          fromYardId: 'yard-a',
+          toYardId: 'yard-b',
+          wagonTypeId: 'type-1',
+          quantity: 5,
+          reason: 'Grain campaign',
+        },
+        'user-1',
+      );
+
+      expect(stored.preferredWagonIds).toBeNull();
+    });
+
+    it('refuses picks that are not available in the source yard', async () => {
+      wagonRepo.count.mockResolvedValue(20);
+      // Sitting in another yard — the requester's list is stale.
+      wagonRepo.find.mockResolvedValue([
+        { ...availableWagons(1)[0], currentYardId: 'yard-z' },
+      ]);
+
+      await expect(
+        service.createRequest(
+          {
+            fromYardId: 'yard-a',
+            toYardId: 'yard-b',
+            wagonTypeId: 'type-1',
+            quantity: 1,
+            reason: 'Grain campaign',
+            preferredWagonIds: ['w-0'],
+          },
+          'user-1',
+        ),
+      ).rejects.toThrow(/no longer available in the source yard/i);
+      expect(requestRepo.save).not.toHaveBeenCalled();
+    });
+
+    it('refuses more picks than the requested quantity', async () => {
+      wagonRepo.count.mockResolvedValue(20);
+
+      await expect(
+        service.createRequest(
+          {
+            fromYardId: 'yard-a',
+            toYardId: 'yard-b',
+            wagonTypeId: 'type-1',
+            quantity: 2,
+            reason: 'Grain campaign',
+            preferredWagonIds: ['w-0', 'w-1', 'w-2'],
+          },
+          'user-1',
+        ),
+      ).rejects.toThrow(/picked 3 wagon\(s\) but are requesting 2/i);
+      expect(requestRepo.save).not.toHaveBeenCalled();
     });
 
     it('still refuses a same-yard move', async () => {
diff --git a/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.ts b/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.ts
index 8d4159726..dc50a8742 100644
--- a/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.ts
+++ b/apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.service.ts
@@ -27,6 +27,15 @@ import { WagonMovement } from './entities/wagon-movement.entity';
 import { WagonTransferRequest } from './entities/wagon-transfer-request.entity';
 import { WagonsService } from './wagons.service';
 
+/**
+ * A request as sent to clients: the entity plus the resolved wagon numbers for
+ * whatever the requester hand-picked, so the desk can name them without a
+ * second round trip.
+ */
+export interface TransferRequestView extends WagonTransferRequest {
+  preferredWagons?: Array<{ id: string; wagonNumber: string }>;
+}
+
 /** Bundled per-user activity: requests they touched + wagons they moved. */
 export interface TransferHistory {
   requests: WagonTransferRequest[];
@@ -75,10 +84,15 @@ export class WagonTransferRequestsService {
   ) {}
 
   /**
-   * Record a PENDING request. Count-only — no wagons are picked here, and the
-   * count is NOT capped by what the source yard holds today: OCC fulfils in
-   * instalments, so asking for 50 while only 20 sit there is a normal, useful
-   * request. A reason is mandatory and is shown on the OCC queue.
+   * Record a PENDING request. The count is capped by what the source yard can
+   * hand over right now: a request may not exceed the AVAILABLE, uncoupled
+   * wagons of that type in the source yard (the same number the yard desk
+   * shows). A reason is mandatory and is shown on the OCC queue.
+   *
+   * The requester may also name the wagons they want (`preferredWagonIds`).
+   * Those are validated against the source yard here so a bad pick is rejected
+   * at request time rather than surfacing at fulfilment, but they are only a
+   * preference — the wagons are not reserved and OCC may send others.
    */
   async createRequest(
     dto: CreateTransferRequestDto,
@@ -89,11 +103,29 @@ export class WagonTransferRequestsService {
         'Source and destination yard must be different',
       );
     }
+    const available = await this.countAvailable(
+      dto.fromYardId,
+      dto.wagonTypeId,
+    );
+    if (available === 0) {
+      throw new BadRequestException(
+        'No available wagons of this type in the source yard',
+      );
+    }
+    if (dto.quantity > available) {
+      throw new BadRequestException(
+        `Only ${available} wagon(s) of this type are available in the source yard — cannot request ${dto.quantity}`,
+      );
+    }
+
+    const preferredWagonIds = await this.validatePreferredWagons(dto);
+
     const request = this.requestRepo.create({
       fromYardId: dto.fromYardId,
       toYardId: dto.toYardId,
       wagonTypeId: dto.wagonTypeId,
       quantity: dto.quantity,
+      preferredWagonIds,
       status: WagonTransferRequestStatus.Pending,
       requestedByUserId: userId ?? null,
       reason: dto.reason,
@@ -103,6 +135,45 @@ export class WagonTransferRequestsService {
     return this.findById(saved.id);
   }
 
+  /**
+   * Check the requester's hand-picked wagons against the source yard: each must
+   * exist, sit in that yard, match the requested type, be AVAILABLE and be
+   * uncoupled — the same conditions fulfilment will apply. Returns the
+   * de-duplicated ids, or null when the requester picked nothing.
+   */
+  private async validatePreferredWagons(
+    dto: CreateTransferRequestDto,
+  ): Promise<string[] | null> {
+    const ids = [...new Set(dto.preferredWagonIds ?? [])];
+    if (ids.length === 0) return null;
+
+    if (ids.length > dto.quantity) {
+      throw new BadRequestException(
+        `You picked ${ids.length} wagon(s) but are requesting ${dto.quantity} — pick at most ${dto.quantity}`,
+      );
+    }
+
+    const wagons = await this.wagonRepo.find({ where: { id: In(ids) } });
+    if (wagons.length !== ids.length) {
+      throw new NotFoundException('One or more selected wagons not found');
+    }
+    const unusable = wagons.filter(
+      (w) =>
+        w.currentYardId !== dto.fromYardId ||
+        w.wagonTypeId !== dto.wagonTypeId ||
+        w.status !== WagonStatus.Available ||
+        w.trainId != null,
+    );
+    if (unusable.length) {
+      throw new BadRequestException(
+        `These wagons are no longer available in the source yard: ${unusable
+          .map((w) => w.wagonNumber)
+          .join(', ')}`,
+      );
+    }
+    return ids;
+  }
+
   /**
    * AVAILABLE wagons of `wagonTypeId` currently in `yardId` — what OCC can move
    * right now. Shown on the desk beside the outstanding count so staff see at a
@@ -164,16 +235,51 @@ export class WagonTransferRequestsService {
           : 'r.createdAt';
     qb.orderBy(sortColumn, query.sortOrder ?? 'DESC');
 
-    return paginateQuery(qb, { page: query.page, pageSize: query.pageSize });
+    const page = await paginateQuery<WagonTransferRequest>(qb, {
+      page: query.page,
+      pageSize: query.pageSize,
+    });
+    return { ...page, items: await this.withPreferredWagons(page.items) };
   }
 
-  async findById(id: string): Promise<WagonTransferRequest> {
+  /**
+   * Resolve `preferredWagonIds` into wagon numbers for a page of requests in a
+   * single query, so the desk can show WHICH wagons were asked for. Ids that no
+   * longer resolve (purged wagon) simply drop out — the column carries no FK.
+   */
+  private async withPreferredWagons(
+    requests: WagonTransferRequest[],
+  ): Promise<TransferRequestView[]> {
+    const ids = [
+      ...new Set(requests.flatMap((r) => r.preferredWagonIds ?? [])),
+    ];
+    if (ids.length === 0) return requests;
+
+    const wagons = await this.wagonRepo.find({
+      where: { id: In(ids) },
+      select: { id: true, wagonNumber: true },
+    });
+    const byId = new Map(wagons.map((w) => [w.id, w.wagonNumber]));
+
+    return requests.map((r) => {
+      const picked = r.preferredWagonIds ?? [];
+      if (picked.length === 0) return r;
+      return Object.assign(r, {
+        preferredWagons: picked
+          .filter((id) => byId.has(id))
+          .map((id) => ({ id, wagonNumber: byId.get(id)! })),
+      });
+    });
+  }
+
+  async findById(id: string): Promise<TransferRequestView> {
     const request = await this.requestRepo.findOne({
       where: { id },
       relations: REQUEST_RELATIONS,
     });
     if (!request) throw new NotFoundException(`Transfer request ${id} not found`);
-    return request;
+    const [view] = await this.withPreferredWagons([request]);
+    return view;
   }
 
   /** Wagons still owed on an open request. */
@@ -396,7 +502,7 @@ export class WagonTransferRequestsService {
         continue;
       }
       const remaining = this.remainingOn(request);
-      const wagons = await this.wagonRepo.find({
+      const candidates = await this.wagonRepo.find({
         where: {
           currentYardId: request.fromYardId,
           wagonTypeId: request.wagonTypeId,
@@ -404,8 +510,19 @@ export class WagonTransferRequestsService {
           trainId: IsNull(),
         },
         order: { wagonNumber: 'ASC' },
-        take: remaining,
       });
+      // Honour the requester's picks first — any that are still available in
+      // the yard go out ahead of the plain wagon-number order, and the rest of
+      // the instalment is topped up from whatever else is on hand.
+      const preferred = new Set(request.preferredWagonIds ?? []);
+      const wagons = (
+        preferred.size
+          ? [
+              ...candidates.filter((w) => preferred.has(w.id)),
+              ...candidates.filter((w) => !preferred.has(w.id)),
+            ]
+          : candidates
+      ).slice(0, remaining);
       if (wagons.length === 0) {
         skipped.push({
           id,
@@ -464,7 +581,7 @@ export class WagonTransferRequestsService {
     });
 
     return {
-      requests,
+      requests: await this.withPreferredWagons(requests),
       movements,
       meta: {
         page: page ?? 1,
diff --git a/apps/edr-freight-api/src/modules/wagons/wagons.service.ts b/apps/edr-freight-api/src/modules/wagons/wagons.service.ts
index 2d8950fb4..f2c76e283 100644
--- a/apps/edr-freight-api/src/modules/wagons/wagons.service.ts
+++ b/apps/edr-freight-api/src/modules/wagons/wagons.service.ts
@@ -121,8 +121,46 @@ export class WagonsService {
    * (yard workspace, coupling pickers) walk the pages client-side — see
    * `wagonService.listAll` in the backoffice.
    */
-  findAll(query: ListWagonsQueryDto = {}): Promise<PaginatedResponse<Wagon>> {
-    return paginateQuery(this.buildListQuery(query), query, { defaultPageSize: 10 });
+  async findAll(query: ListWagonsQueryDto = {}): Promise<PaginatedResponse<Wagon>> {
+    const page = await paginateQuery(this.buildListQuery(query), query, { defaultPageSize: 10 });
+    await this.attachStatusDates(page.items);
+    return page;
+  }
+
+  /**
+   * Latest status-flip dates from the audit log, for the wagons desk columns:
+   * when the wagon last went to MAINTENANCE and when it last became AVAILABLE.
+   * One grouped query per page; null when the log has no such flip.
+   */
+  private async attachStatusDates(wagons: Wagon[]): Promise<void> {
+    if (!wagons.length) return;
+    const rows: Array<{
+      wagonId: string;
+      lastMaintenanceAt: Date | null;
+      lastAvailableAt: Date | null;
+    }> = await this.dataSource
+      .getRepository(WagonStatusLog)
+      .createQueryBuilder('l')
+      .select('l.wagon_id', 'wagonId')
+      .addSelect(
+        `MAX(l.created_at) FILTER (WHERE l.to_status = '${WagonStatus.Maintenance}')`,
+        'lastMaintenanceAt',
+      )
+      .addSelect(
+        `MAX(l.created_at) FILTER (WHERE l.to_status = '${WagonStatus.Available}')`,
+        'lastAvailableAt',
+      )
+      .where('l.wagon_id IN (:...ids)', { ids: wagons.map((w) => w.id) })
+      .groupBy('l.wagon_id')
+      .getRawMany();
+    const byId = new Map(rows.map((r) => [r.wagonId, r]));
+    for (const w of wagons) {
+      const r = byId.get(w.id);
+      Object.assign(w, {
+        lastMaintenanceAt: r?.lastMaintenanceAt ?? null,
+        lastAvailableAt: r?.lastAvailableAt ?? null,
+      });
+    }
   }
 
   async findById(id: string): Promise<Wagon> {
@@ -304,8 +342,8 @@ export class WagonsService {
 
   async assignToTrain(wagonId: string, dto: AssignWagonToTrainDto): Promise<Wagon> {
     const wagon = await this.findById(wagonId);
-    // Mirror train-builder attachWagons: only a truly free, available wagon in
-    // the train's own yard can be coupled, and never onto a dispatched train.
+    // Mirror train-builder attachWagons: only a truly free, available wagon
+    // (any yard) can be coupled, and never onto a dispatched train.
     if (wagon.trainId != null) {
       throw new ConflictException(`Wagon ${wagon.wagonNumber} is already on another train`);
     }
@@ -320,11 +358,6 @@ export class WagonsService {
         `Train ${train.code} is out on a dispatched run; its composition is frozen until arrival`,
       );
     }
-    if (wagon.currentYardId !== train.currentYardId) {
-      throw new BadRequestException(
-        `Wagon ${wagon.wagonNumber} is not in the train's yard; only wagons in the same yard can be attached`,
-      );
-    }
 
     const maxSeq = await this.wagonRepo
       .createQueryBuilder('w')
diff --git a/apps/edr-freight-api/src/modules/warehouses/mark-customer-truck-arrived.spec.ts b/apps/edr-freight-api/src/modules/warehouses/mark-customer-truck-arrived.spec.ts
new file mode 100644
index 000000000..51a1f4c1c
--- /dev/null
+++ b/apps/edr-freight-api/src/modules/warehouses/mark-customer-truck-arrived.spec.ts
@@ -0,0 +1,56 @@
+import { WarehouseInventoryService } from './warehouse-inventory.service';
+
+/**
+ * Export self-haul has no separate "truck arrived" gate action the way import
+ * does (release()'s arrival branch, fired later when a truck shows up to
+ * COLLECT already-warehoused goods) — the truck delivering cargo TO the
+ * warehouse arrives and is received in the same act, so receive()/
+ * bulkReceive() must stamp customer_truck_assignments.arrived_at themselves.
+ */
+type Marker = (
+  manager: { query: jest.Mock },
+  bookingId: string,
+  plateNumber: string | null | undefined,
+) => Promise<void>;
+
+function makeMarker() {
+  const service = Object.create(WarehouseInventoryService.prototype) as Record<string, unknown>;
+  const marker = (
+    service as unknown as { markCustomerTruckArrived: Marker }
+  ).markCustomerTruckArrived.bind(service);
+  return marker;
+}
+
+describe('markCustomerTruckArrived', () => {
+  it('stamps arrival matched by booking + plate', async () => {
+    const marker = makeMarker();
+    const manager = { query: jest.fn().mockResolvedValue(undefined) };
+
+    await marker(manager, 'b-1', 'AAA-2323');
+
+    expect(manager.query).toHaveBeenCalledTimes(1);
+    const [sql, params] = manager.query.mock.calls[0];
+    expect(sql).toMatch(/UPDATE freight\.customer_truck_assignments/);
+    expect(sql).toMatch(/UPPER\(a\.plate_number\) = UPPER\(\$2\)/);
+    expect(params).toEqual(['b-1', 'AAA-2323']);
+  });
+
+  it('trims the plate before matching', async () => {
+    const marker = makeMarker();
+    const manager = { query: jest.fn().mockResolvedValue(undefined) };
+
+    await marker(manager, 'b-1', '  AAA-2323  ');
+
+    expect(manager.query.mock.calls[0][1]).toEqual(['b-1', 'AAA-2323']);
+  });
+
+  it('no-ops on a missing/blank plate — no query, nothing to match on', async () => {
+    const marker = makeMarker();
+    const manager = { query: jest.fn() };
+
+    await marker(manager, 'b-1', undefined);
+    await marker(manager, 'b-1', '   ');
+
+    expect(manager.query).not.toHaveBeenCalled();
+  });
+});
diff --git a/apps/edr-freight-api/src/modules/warehouses/warehouse-dashboard.service.ts b/apps/edr-freight-api/src/modules/warehouses/warehouse-dashboard.service.ts
index 0bbcdee48..3eee095f8 100644
--- a/apps/edr-freight-api/src/modules/warehouses/warehouse-dashboard.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/warehouse-dashboard.service.ts
@@ -3,6 +3,7 @@ import { DataSource, FindManyOptions, IsNull, ObjectLiteral, Repository } from '
 
 import { Warehouse } from './entities/warehouse.entity';
 import { WarehouseInventory } from './entities/warehouse-inventory.entity';
+import { SchedulingReadFacade } from './scheduling-read.facade';
 
 export interface WarehouseDashboard {
   totalWarehouses: number;
@@ -20,11 +21,45 @@ export interface WarehouseDashboard {
   // Import branch
   readyForPickup: number;
   delivered: number;
+  // Fleet / train snapshot
+  emptyContainers: number;
+  importTrains: number;
+  exportTrains: number;
 }
 
 @Injectable()
 export class WarehouseDashboardService {
-  constructor(private readonly dataSource: DataSource) {}
+  constructor(
+    private readonly dataSource: DataSource,
+    private readonly schedulingRead: SchedulingReadFacade,
+  ) {}
+
+  private async safeQueryCount(sql: string, params: unknown[] = []): Promise<number> {
+    try {
+      const rows = await this.dataSource.query(sql, params);
+      return Number(rows?.[0]?.count) || 0;
+    } catch {
+      return 0;
+    }
+  }
+
+  /** ARRIVED trains with IMPORT-direction routing — same set as the import arrival queue. */
+  private async safeImportTrains(): Promise<number> {
+    try {
+      return (await this.schedulingRead.importArriveQueue()).length;
+    } catch {
+      return 0;
+    }
+  }
+
+  /** Trains at/near Djibouti relevant to the export flow — same set as the Djibouti unloading queue. */
+  private async safeExportTrains(): Promise<number> {
+    try {
+      return (await this.schedulingRead.exportDjiboutiArrivalQueue()).length;
+    } catch {
+      return 0;
+    }
+  }
 
   private async safeCount<T extends ObjectLiteral>(
     repo: Repository<T>,
@@ -69,6 +104,9 @@ export class WarehouseDashboardService {
       readyForPickup,
       delivered,
       receivedToday,
+      emptyContainers,
+      importTrains,
+      exportTrains,
     ] = await Promise.all([
       this.safeCount(warehouseRepo),
       this.safeCount(inventoryRepo),
@@ -82,6 +120,16 @@ export class WarehouseDashboardService {
       this.safeCount(inventoryRepo, { where: { status: 'READY_FOR_PICKUP' } }),
       this.safeCount(inventoryRepo, { where: { status: 'DELIVERED' } }),
       this.safeReceivedToday(startOfToday),
+      // ponytail: the container fleet has no literal EMPTY status (AVAILABLE | LOADED |
+      // IN_TRANSIT | MAINTENANCE | DAMAGED) — AVAILABLE (not on a wagon, not in transit,
+      // not flagged) is the closest proxy for "empty and free to use". Revisit if the
+      // domain ever grows a real empty/full distinction per container.
+      this.safeQueryCount(
+        `SELECT count(*)::int AS count FROM freight.containers WHERE deleted_at IS NULL AND status = $1`,
+        ['AVAILABLE'],
+      ),
+      this.safeImportTrains(),
+      this.safeExportTrains(),
     ]);
 
     return {
@@ -97,6 +145,9 @@ export class WarehouseDashboardService {
       dispatched,
       readyForPickup,
       delivered,
+      emptyContainers,
+      importTrains,
+      exportTrains,
     };
   }
 }
diff --git a/apps/edr-freight-api/src/modules/warehouses/warehouse-fee.service.ts b/apps/edr-freight-api/src/modules/warehouses/warehouse-fee.service.ts
index aa30b31e7..576933c01 100644
--- a/apps/edr-freight-api/src/modules/warehouses/warehouse-fee.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/warehouse-fee.service.ts
@@ -8,6 +8,7 @@ import { NotificationInboxService } from '../notification-inbox/notification-inb
 import { CreateFeeRuleDto, UpdateFeeRuleDto } from './dto/fee-rule.dto';
 import { FeeRuleBasis, FeeRuleType, WarehouseFeeRule, WarehouseFeeTier } from './entities/warehouse-fee-rule.entity';
 import { WarehouseFeeRuleRepository } from './warehouse-fee-rule.repository';
+import { FREIGHT_PERMS } from '../../seed/freight-permissions.registry';
 
 interface ItemAttributes {
   arrivedAt: Date | null;
@@ -178,7 +179,11 @@ export class WarehouseFeeService {
       const total = alerts.reduce((sum, r) => sum + r.accruedAmount, 0);
       try {
         await this.inbox.notify({
-          recipients: { allBackoffice: true },
+          recipients: {
+            permissionKeys: [
+              FREIGHT_PERMS.warehouseFeeInvoices.getNotification,
+            ],
+          },
           audience: NotificationAudience.BACKOFFICE,
           type: NotificationType.BOOKING_STATUS,
           title: 'Warehouse fee accruals need attention',
diff --git a/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.controller.ts b/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.controller.ts
index 459b5009e..19d3b4b7a 100644
--- a/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.controller.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/warehouse-inventory.controller.ts
@@ -38,15 +38,21 @@ export class WarehouseInventoryController {
   @Get()
   @BookingStaff(FREIGHT_PERMS.warehouseInventory.view)
   @ApiOperation({ summary: 'List warehouse inventory' })
-  findAll(@Query() filter: FilterWarehouseInventoryDto) {
-    return this.inventoryService.findAll(filter);
+  findAll(
+    @Query() filter: FilterWarehouseInventoryDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.inventoryService.findAll(filter, user);
   }
 
   @Get('ready-for-loading')
   @BookingStaff(FREIGHT_PERMS.warehouseInventory.view)
   @ApiOperation({ summary: 'List inventory ready for loading' })
-  findReadyForLoading(@Query() filter: FilterWarehouseInventoryDto) {
-    return this.inventoryService.findReadyForLoading(filter);
+  findReadyForLoading(
+    @Query() filter: FilterWarehouseInventoryDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.inventoryService.findReadyForLoading(filter, user);
   }
 
   @Get('inquiry')
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 1159c1151..126998bae 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
@@ -28,12 +28,20 @@ import type { InterchangeDocument } from '../interchange-documents/entities/inte
 import { LastMileService } from '../last-mile/last-mile.service';
 import { UpdateLastMileDto } from '../last-mile/dto/update-last-mile.dto';
 import { NotificationsService } from '../notifications/notifications.service';
-import { sendCompanyChannels } from '../notifications/notify-company.util';
+import {
+  sendCompanyChannels,
+  notifyCarriageAcceptanceReady as notifyCarriageAcceptanceReadyShared,
+} from '../notifications/notify-company.util';
 import {
   companyNotifyPhoneExpr,
   primaryContactUserJoin,
 } from '../notifications/resolve-company-phone.util';
 import { SignaturesService } from '../signatures/signatures.service';
+import { StampSettingsService } from '../stamp-settings/stamp-settings.service';
+import { LogoSettingsService } from '../logo-settings/logo-settings.service';
+import { YardScopeService } from '../rule-engine/services/yard-scope.service';
+import { logoImageCss, logoMarkup } from '../billing/documents/logo-markup.util';
+import { sealClass, sealImageCss, sealMarkup } from '../billing/documents/seal-markup.util';
 import { BulkInspectDto } from './dto/bulk-inspect.dto';
 import { BulkReceiveDto, TruckEntranceDto } from './dto/bulk-receive.dto';
 import { DeliverInventoryDto } from './dto/deliver-inventory.dto';
@@ -414,6 +422,9 @@ export class WarehouseInventoryService {
     private readonly handover: HandoverService,
     private readonly inbox: NotificationInboxService,
     private readonly events: EventEmitter2,
+    private readonly stampSettings: StampSettingsService,
+    private readonly logoSettings: LogoSettingsService,
+    private readonly yardScope: YardScopeService,
   ) {}
 
   /**
@@ -969,7 +980,16 @@ export class WarehouseInventoryService {
 
   // ── Listing ────────────────────────────────────────────────────────────
 
-  async findAll(filter: FilterWarehouseInventoryDto): Promise<WarehouseInventory[]> {
+  /**
+   * `user` drives yard access scoping: a desk mapped to yards sees only those
+   * yards' inventory. Optional so internal callers that are not serving a
+   * request (schedulers, other services) are unaffected — they pass nothing and
+   * get the unscoped list, which is what they had before.
+   */
+  async findAll(
+    filter: FilterWarehouseInventoryDto,
+    user?: unknown,
+  ): Promise<WarehouseInventory[]> {
     const createdAt =
       filter.dateFrom && filter.dateTo
         ? Between(new Date(filter.dateFrom), new Date(filter.dateTo))
@@ -1011,6 +1031,32 @@ export class WarehouseInventoryService {
       });
     }
 
+    // Yard scoping — applied to `base` before the search branch splits it, so
+    // both OR arms carry the constraint. A null result means "do not narrow".
+    //
+    // Scoped on `warehouse.stationId`, NOT on `inventory.yardId`: those are two
+    // different id spaces that share a name. `warehouse_inventory.yard_id` is a
+    // FK to `warehouse_yards` — a yard INSIDE a warehouse — while the desk↔yard
+    // mapping is against `freight.yards`, the network yard, which inventory
+    // reaches through `warehouses.station_id`. Filtering `yardId` against
+    // mapped network yards matches nothing and hides every row (observed: all
+    // 34 rows disappeared before this was corrected).
+    //
+    // `filter.yardId` is likewise a warehouse-yard id, so it is NOT passed as
+    // the requested yard here; `filter.facilityId` is the station-yard filter.
+    const scopedYardIds = await this.yardScope.listFilterYardIds(
+      user as never,
+      filter.facilityId,
+      'warehouse-inventory list',
+    );
+    if (scopedYardIds) {
+      if (!scopedYardIds.length) return [];
+      base.warehouse = {
+        ...((base.warehouse as FindOptionsWhere<Warehouse>) ?? {}),
+        stationId: scopedYardIds.length === 1 ? scopedYardIds[0] : In(scopedYardIds),
+      };
+    }
+
     const search = filter.search?.trim();
     const where: FindManyOptions<WarehouseInventory>['where'] = search
       ? [
@@ -1028,8 +1074,11 @@ export class WarehouseInventoryService {
     return items;
   }
 
-  findReadyForLoading(filter: FilterWarehouseInventoryDto): Promise<WarehouseInventory[]> {
-    return this.findAll({ ...filter, status: 'READY_FOR_LOADING' });
+  findReadyForLoading(
+    filter: FilterWarehouseInventoryDto,
+    user?: unknown,
+  ): Promise<WarehouseInventory[]> {
+    return this.findAll({ ...filter, status: 'READY_FOR_LOADING' }, user);
   }
 
   /**
@@ -1425,6 +1474,9 @@ export class WarehouseInventoryService {
         WHERE b.deleted_at IS NULL
           AND b.payment_status = 'PAID'
           AND inv.id IS NULL
+          -- Direct truck-to-train cargo never comes to the warehouse, so never
+          -- offer it for receipt.
+          AND COALESCE(b.export_handover_mode, 'WAREHOUSE') <> 'DIRECT_TO_TRAIN'
         ORDER BY b.scheduled_date DESC NULLS LAST`,
     );
 
@@ -1643,6 +1695,12 @@ export class WarehouseInventoryService {
           [bookingId],
         );
 
+        // Export self-haul: this receive IS the truck's arrival — see
+        // markCustomerTruckArrived / receive()'s single-booking mirror.
+        if (dto.direction === 'EXPORT') {
+          await this.markCustomerTruckArrived(manager, bookingId, truckEntrance?.truckPlateNumber);
+        }
+
         await this.activityLog.record(
           {
             activityType: 'INVENTORY_RECEIVED',
@@ -1691,7 +1749,6 @@ export class WarehouseInventoryService {
   /** EXPORT inventory rows at a given status (route-derived direction), with booking detail. */
   private async exportInventoryByStatus(
     status: WarehouseInventoryStatus,
-    requireInspectionPassed = false,
   ): Promise<ReadyToLoadRow[]> {
     const rows: Array<
       ReadyToLoadRow & { originCountry: string | null; destinationCountry: string | null }
@@ -1720,7 +1777,6 @@ export class WarehouseInventoryService {
          LEFT JOIN freight.containers ct ON ct.id = inv.container_id
         WHERE inv.deleted_at IS NULL
           AND inv.status = $1
-          ${requireInspectionPassed ? `AND inv.inspection_status = 'PASSED'` : ''}
         ORDER BY inv.created_at DESC`,
       [status],
     );
@@ -1733,9 +1789,13 @@ export class WarehouseInventoryService {
       .map(({ originCountry: _oc, destinationCountry: _dc, ...rest }) => rest);
   }
 
-  /** EXPORT inventory that passed inspection and is waiting to be loaded (READY_FOR_LOADING). */
+  /**
+   * EXPORT inventory waiting to be loaded (READY_FOR_LOADING). Inspection state
+   * rides along on each row for the UI to show, but does not filter the queue —
+   * uninspected cargo must still be loadable.
+   */
   async readyToLoadExport(): Promise<ReadyToLoadRow[]> {
-    return this.exportInventoryByStatus('READY_FOR_LOADING', true);
+    return this.exportInventoryByStatus('READY_FOR_LOADING');
   }
 
   /** EXPORT inventory received at the facility and awaiting inspection. */
@@ -2886,6 +2946,13 @@ export class WarehouseInventoryService {
         );
       }
 
+      // Export self-haul: this receive IS the truck's arrival — stamp it on
+      // its own customer_truck_assignments row (mirror of import's arrival,
+      // see markCustomerTruckArrived).
+      if (dto.bookingId && bookingDirection === 'EXPORT') {
+        await this.markCustomerTruckArrived(manager, dto.bookingId, truckEntrance.truckPlateNumber);
+      }
+
       await this.activityLog.record(
         {
             activityType: 'INVENTORY_RECEIVED',
@@ -3117,9 +3184,8 @@ export class WarehouseInventoryService {
     if (!item.bookingId || !item.warehouseId || !item.yardId || !item.zoneId) {
       throw new BadRequestException('Inventory must have booking, warehouse, yard and zone before loading prep');
     }
-    if (item.inspectionStatus !== 'PASSED') {
-      throw new BadRequestException('Inventory must pass inspection before it can be marked ready for loading');
-    }
+    // Inspection is tracked, not enforced — uninspected cargo may still be
+    // marked ready and loaded so a train is never held for paperwork.
     return this.transition(id, 'READY_FOR_LOADING', {
       timestampField: 'readyForLoadingAt',
       activityType: 'READY_FOR_LOADING',
@@ -3727,6 +3793,8 @@ export class WarehouseInventoryService {
     const html = this.buildReleaseDocumentHtml({
       reference,
       issuedAt,
+      stampImageUrl: await this.stampSettings.getStampImageUrl(),
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
       bookingReference,
       bookingStatus: row?.bookingStatus ?? null,
       customerName: row?.customerName ?? null,
@@ -4198,6 +4266,7 @@ export class WarehouseInventoryService {
 
     const html = this.buildGrnDocumentHtml({
       grnNumber: row.grnNumber,
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
       receivedAt: row.receivedAt ? new Date(row.receivedAt) : new Date(),
       bookingReference: row.bookingReference ?? row.bookingId ?? 'N/A',
       bookingStatus: row.bookingStatus ?? null,
@@ -4781,6 +4850,8 @@ export class WarehouseInventoryService {
     const html = this.buildHandoverDocumentHtml({
       reference,
       handedOverAt,
+      stampImageUrl: await this.stampSettings.getStampImageUrl(),
+      logoImageUrl: await this.logoSettings.getLogoImageUrl(),
       bookingReference,
       bookingStatus: row.bookingStatus ?? null,
       customerName: row.customerName ?? null,
@@ -5130,6 +5201,7 @@ export class WarehouseInventoryService {
       activityType: 'INVENTORY_DISPATCHED',
       description: 'Inventory dispatched',
       performedBy,
+      freeCapacity: true,
     });
   }
 
@@ -5414,6 +5486,8 @@ export class WarehouseInventoryService {
       description: string;
       performedBy?: string;
       preloaded?: WarehouseInventory;
+      /** Cargo physically leaves the warehouse on this transition — free up capacity (mirrors deliver()). */
+      freeCapacity?: boolean;
     },
   ): Promise<WarehouseInventory> {
     const item = opts.preloaded ?? (await this.findById(id));
@@ -5424,6 +5498,20 @@ export class WarehouseInventoryService {
         status: to,
         [opts.timestampField]: new Date(),
       });
+
+      if (opts.freeCapacity) {
+        const weight = Number(item.weight) || 0;
+        const volume = Number(item.volume) || 0;
+        const containerCount = item.containerId ? Math.round(Number(item.quantity) || 0) : 0;
+        await this.applyCapacityDelta(
+          manager,
+          { warehouseId: item.warehouseId, yardId: item.yardId, zoneId: item.zoneId },
+          -weight,
+          -volume,
+          -containerCount,
+        );
+      }
+
       await this.activityLog.record(
         {
           activityType: opts.activityType,
@@ -5462,6 +5550,8 @@ export class WarehouseInventoryService {
     zone: string | null;
     inventoryStatus: string | null;
     receiveSummary: string | null;
+    /** The one global company logo; null renders the plain text brand. */
+    logoImageUrl?: string | null;
   }): string {
     const esc = (value: unknown) =>
       String(value ?? '-')
@@ -5518,6 +5608,7 @@ export class WarehouseInventoryService {
     .ref { text-align: right; font-size: 11px; color: #334155; padding-top: 8px; }
     .ref strong { display: block; color: #061323; font-size: 18px; margin: 5px 0 8px; letter-spacing: .02em; }
     .rule { height: 3px; background: #0f766e; margin: 16px 0 22px; }
+    ${logoImageCss()}
     .notice { width: 76%; margin: 0 0 18px; padding: 13px 18px; background: #f0fdfa; border: 1px solid #5eead4; border-left: 5px solid #0f766e; font-size: 13px; line-height: 1.45; }
     .section-title { margin: 18px 0 8px; font-size: 13px; font-weight: 800; color: #0f766e; text-transform: uppercase; letter-spacing: .12em; }
     table { width: 100%; border-collapse: collapse; }
@@ -5531,6 +5622,7 @@ export class WarehouseInventoryService {
 <body>
   <div class="top">
     <div>
+      ${logoMarkup(data.logoImageUrl)}
       <div class="brand">Ethio-Djibouti Railway S.C.</div>
       <h1>Goods Received Note</h1>
       <div class="subtitle">Warehouse receiving confirmation</div>
@@ -5586,6 +5678,10 @@ export class WarehouseInventoryService {
     truckType?: string | null;
     truckGateOut?: string | null;
     truckWeightTons?: number | null;
+    /** The one global company stamp; null falls back to the drawn text seal. */
+    stampImageUrl?: string | null;
+    /** The one global company logo; null renders the plain text brand. */
+    logoImageUrl?: string | null;
   }): string {
     const esc = (value: unknown) =>
       String(value ?? '-')
@@ -5672,12 +5768,15 @@ export class WarehouseInventoryService {
     .seal { width: 96px; height: 96px; margin: -28px auto 0; border: 3px double #17633a; border-radius: 999px; color: #17633a; display: flex; align-items: center; justify-content: center; text-align: center; font-weight: 800; font-size: 14px; line-height: 1.05; transform: rotate(-17deg); text-transform: uppercase; }
     .seal::before { content: ""; position: absolute; width: 78px; height: 78px; border: 1px solid #17633a; border-radius: 999px; }
     .seal span { position: relative; }
+    ${sealImageCss()}
+    ${logoImageCss()}
   </style>
 </head>
 <body>
   <div class="doc">
     <div class="top">
       <div>
+        ${logoMarkup(data.logoImageUrl)}
         <div class="brand">Ethio-Djibouti Railway S.C.</div>
         <h1>Warehouse Release / Exit Paper</h1>
         <div class="subtitle">Official gate clearance and warehouse exit authorization</div>
@@ -5705,7 +5804,7 @@ export class WarehouseInventoryService {
     </div>
     <div class="signatures">
       <div class="line">Officer in charge name / signature / date</div>
-      <div class="seal"><span>EDR<br />Warehouse<br />Cleared</span></div>
+      <div class="${sealClass(data.stampImageUrl)}">${sealMarkup(data.stampImageUrl, ['EDR', 'Warehouse', 'Cleared'])}</div>
       <div class="line">Customer or driver name / signature / date</div>
     </div>
   </div>
@@ -5745,6 +5844,10 @@ export class WarehouseInventoryService {
       signerDisplayName: string;
       signatureImageUrl: string | null;
     } | null;
+    /** The one global company stamp; null falls back to the drawn text seal. */
+    stampImageUrl?: string | null;
+    /** The one global company logo; null renders the plain text brand. */
+    logoImageUrl?: string | null;
   }): string {
     const esc = (value: unknown) =>
       String(value ?? '-')
@@ -5822,11 +5925,14 @@ export class WarehouseInventoryService {
     .seal { position: relative; width: 96px; height: 96px; margin: -28px auto 0; border: 3px double #17633a; border-radius: 999px; color: #17633a; display: flex; align-items: center; justify-content: center; text-align: center; font-weight: 800; font-size: 14px; line-height: 1.05; transform: rotate(-17deg); text-transform: uppercase; }
     .seal::before { content: ""; position: absolute; width: 78px; height: 78px; border: 1px solid #17633a; border-radius: 999px; }
     .seal span { position: relative; }
+    ${sealImageCss()}
+    ${logoImageCss()}
   </style>
 </head>
 <body>
   <div class="top">
     <div>
+      ${logoMarkup(data.logoImageUrl)}
       <div class="brand">Ethio-Djibouti Railway S.C.</div>
       <h1>Import Goods Handover Document</h1>
       <div class="subtitle">EDR to customer warehouse handover</div>
@@ -5865,7 +5971,7 @@ export class WarehouseInventoryService {
   </div>
   <div class="signatures">
     <div class="line">Officer in charge name / signature / date</div>
-    <div class="seal"><span>EDR<br />Warehouse<br />Handover</span></div>
+    <div class="${sealClass(data.stampImageUrl)}">${sealMarkup(data.stampImageUrl, ['EDR', 'Warehouse', 'Handover'])}</div>
     <div class="line">
       ${approval?.signatureImageUrl ? `<img class="signature-img" src="${esc(approval.signatureImageUrl)}" />` : ''}
       <div class="signature-meta">${approval ? esc(approval.signerDisplayName) : 'Customer or driver name / signature / date'}</div>
@@ -6008,6 +6114,33 @@ export class WarehouseInventoryService {
     };
   }
 
+  /**
+   * EXPORT self-haul mirror of the customer truck lifecycle IMPORT already has:
+   * import stamps a truck's arrival on the SEPARATE gate action that comes
+   * later (release()'s arrival branch, when the customer's truck shows up to
+   * COLLECT already-warehoused goods). Export has no such separate step — the
+   * truck delivering cargo TO the warehouse arrives and is received in the
+   * same act, so receive()/bulkReceive() themselves are the arrival event.
+   * Matched by plate (not assignmentId — neither receive endpoint carries
+   * one), same as release()'s departure-branch self-haul UPDATE.
+   */
+  private async markCustomerTruckArrived(
+    manager: EntityManager,
+    bookingId: string,
+    plateNumber: string | null | undefined,
+  ): Promise<void> {
+    const plate = plateNumber?.trim();
+    if (!plate) return;
+    await manager.query(
+      `UPDATE freight.customer_truck_assignments a
+          SET arrived_at = COALESCE(a.arrived_at, NOW()), updated_at = NOW()
+        WHERE a.booking_id = $1
+          AND UPPER(a.plate_number) = UPPER($2)
+          AND a.deleted_at IS NULL`,
+      [bookingId, plate],
+    );
+  }
+
   private async getBookingTruckEntranceSource(
     manager: EntityManager,
     bookingId: string,
@@ -6027,6 +6160,10 @@ export class WarehouseInventoryService {
     firstMileDriverPhone?: string | null;
     firstMileDriverLicenseNumber?: string | null;
     firstMileTruckType?: string | null;
+    customerTruckPlateNumber?: string | null;
+    customerTruckDriverName?: string | null;
+    customerTruckType?: string | null;
+    customerTruckContainerNumber?: string | null;
   }> {
     const [booking] = await manager.query(
       `SELECT b.reference AS "reference",
@@ -6046,7 +6183,24 @@ export class WarehouseInventoryService {
               ) AS "firstMileDriverName",
               driver.phone_number AS "firstMileDriverPhone",
               driver.license_number AS "firstMileDriverLicenseNumber",
-              v.vehicle_type AS "firstMileTruckType"
+              v.vehicle_type AS "firstMileTruckType",
+              -- Self-haul truck assigned via the portal — export delivering to
+              -- the warehouse or import collecting from it. Same pattern as
+              -- eligibleBookings/importQueueByStatuses: multi-truck self-haul
+              -- writes plates/drivers to customer_truck_assignments and leaves
+              -- the booking columns null, so read the assignments first and
+              -- keep the legacy column as the fallback for single-truck
+              -- bookings written before that table existed.
+              COALESCE((SELECT string_agg(DISTINCT cta.plate_number, ', ')
+                          FROM freight.customer_truck_assignments cta
+                         WHERE cta.booking_id = b.id AND cta.deleted_at IS NULL),
+                       b.customer_truck_plate_number) AS "customerTruckPlateNumber",
+              COALESCE((SELECT string_agg(DISTINCT cta.driver_name, ', ')
+                          FROM freight.customer_truck_assignments cta
+                         WHERE cta.booking_id = b.id AND cta.deleted_at IS NULL),
+                       b.customer_truck_driver_name) AS "customerTruckDriverName",
+              b.customer_truck_type AS "customerTruckType",
+              b.customer_truck_container_number AS "customerTruckContainerNumber"
          FROM freight.bookings b
          LEFT JOIN freight.companies company ON company.id = b.company_id
          ${primaryContactUserJoin('company')}
@@ -6091,26 +6245,13 @@ export class WarehouseInventoryService {
    * fires right after receive, not at marshalling.
    */
   private async notifyCarriageAcceptanceReady(bookingId: string): Promise<void> {
-    try {
-      const [b]: Array<{ companyId: string | null; reference: string }> = await this.dataSource.query(
-        `SELECT company_id AS "companyId", reference FROM freight.bookings WHERE id = $1 AND deleted_at IS NULL`,
-        [bookingId],
-      );
-      if (!b?.companyId) return;
-      const body = `Your carriage acceptance sheet for booking ${b.reference} is ready to download from the portal.`;
-      await this.inbox.notify({
-        recipients: { companyId: b.companyId },
-        audience: NotificationAudience.PORTAL,
-        type: NotificationType.DOCUMENT_ACTION,
-        title: 'Carriage acceptance sheet ready',
-        body,
-        link: `/bookings/${bookingId}`,
-        data: { bookingId, reference: b.reference },
-      });
-      await sendCompanyChannels(this.dataSource, this.notifications, b.companyId, body);
-    } catch (err) {
-      this.logger.warn(`Carriage acceptance ready notify failed for ${bookingId}: ${(err as Error).message}`);
-    }
+    await notifyCarriageAcceptanceReadyShared(
+      this.dataSource,
+      this.notifications,
+      this.inbox,
+      bookingId,
+      this.logger,
+    );
   }
 
   private async notifyOwnerInventoryReceived(params: {
diff --git a/apps/edr-freight-api/src/modules/warehouses/warehouse-invoice.service.ts b/apps/edr-freight-api/src/modules/warehouses/warehouse-invoice.service.ts
index 6bf03c93d..558ffc1a9 100644
--- a/apps/edr-freight-api/src/modules/warehouses/warehouse-invoice.service.ts
+++ b/apps/edr-freight-api/src/modules/warehouses/warehouse-invoice.service.ts
@@ -99,7 +99,9 @@ interface InventoryContext {
 interface ViewSource {
   id: string;
   invoiceNumber: string;
-  companyId: string;
+  /** Nullable on the entity (shipping-line invoices have no company); every
+   * warehouse invoice is customer-billed, so in practice this is always set. */
+  companyId: string | null;
   sourceId: string;
   type: string;
   status: Freight.InvoiceStatus | string;
diff --git a/apps/edr-freight-api/src/scripts/eims-login.ts b/apps/edr-freight-api/src/scripts/eims-login.ts
new file mode 100644
index 000000000..f9cc60d27
--- /dev/null
+++ b/apps/edr-freight-api/src/scripts/eims-login.ts
@@ -0,0 +1,40 @@
+import "dotenv/config";
+import axios from "axios";
+import { HttpService } from "@nestjs/axios";
+import { ConfigService } from "@nestjs/config";
+import eimsConfig, { EimsConfig } from "../config/eims.config";
+import { EimsAuthService } from "../modules/eims/eims-auth.service";
+import { EimsCredentialsProvider } from "../modules/eims/eims-credentials.provider";
+import { EimsSignerService } from "../modules/eims/eims-signer.service";
+
+/**
+ * Manual, developer-run live check of EIMS authentication.
+ *
+ * Run explicitly:  pnpm --filter @edr/freight-api eims:login
+ *
+ * Reads credentials from the local .env only. Never runs at boot, never runs in the test suite,
+ * and prints no token, secret, signature or certificate — only whether login succeeded.
+ */
+async function main(): Promise<void> {
+  const config = eimsConfig() as EimsConfig;
+  if (!config.enabled) {
+    throw new Error("EIMS_ENABLED is not true — set it in .env before running this check");
+  }
+
+  const configService = { get: () => config } as unknown as ConfigService;
+  const http = new HttpService(axios.create());
+  const credentials = new EimsCredentialsProvider(configService);
+  const auth = new EimsAuthService(http, configService, new EimsSignerService(credentials));
+
+  console.log(`POST ${config.baseUrl}/auth/login  (tin=${config.tin})`);
+  const token = await auth.getValidAccessToken();
+  console.log(`✔ login succeeded — access token received (${token.length} chars, not printed)`);
+
+  const cached = await auth.getValidAccessToken();
+  console.log(`✔ second call served from cache: ${cached === token}`);
+}
+
+main().catch((err: Error) => {
+  console.error(`✘ ${err.message}`);
+  process.exitCode = 1;
+});
diff --git a/apps/edr-freight-api/src/scripts/migrate.ts b/apps/edr-freight-api/src/scripts/migrate.ts
index ac8a97b28..266d015cd 100644
--- a/apps/edr-freight-api/src/scripts/migrate.ts
+++ b/apps/edr-freight-api/src/scripts/migrate.ts
@@ -9,7 +9,7 @@ import {
   buildIamMigrationDataSourceOptions,
   buildFreightMigrationDataSourceOptions,
   FREIGHT_MIGRATIONS,
-  IAM_MIGRATIONS,
+  // IAM_MIGRATIONS,
   LEGACY_MIGRATIONS,
 } from "../config/database.config";
 
@@ -109,7 +109,7 @@ async function adoptLegacyHistory(
 
   if (!legacyExists[0].present) return;
 
-  await createHistoryTable(dataSource, IAM_MIGRATIONS);
+  // await createHistoryTable(dataSource, IAM_MIGRATIONS);
   await createHistoryTable(dataSource, FREIGHT_MIGRATIONS);
 
   const adopt = async (
@@ -134,7 +134,7 @@ async function adoptLegacyHistory(
     );
   };
 
-  await adopt(IAM_MIGRATIONS, true);
+  // await adopt(IAM_MIGRATIONS, true);
   await adopt(FREIGHT_MIGRATIONS, false);
 }
 
@@ -158,7 +158,9 @@ export async function runAllMigrations(): Promise<void> {
       (migration) => migration.name ?? migration.constructor.name,
     );
     await adoptLegacyHistory(iam, iamMigrationNames);
-    await runMigrations("iam", iam);
+    // IAM migrations are owned by @tria-plc/iamapi-common's own CLI, not the
+    // freight deploy — do not apply them here.
+    // await runMigrations("iam", iam);
   } finally {
     await iam.destroy();
   }
diff --git a/apps/edr-freight-api/src/scripts/seed-negad-indode-arrived-train.ts b/apps/edr-freight-api/src/scripts/seed-negad-indode-arrived-train.ts
index 9cf1ef0cd..174a32341 100644
--- a/apps/edr-freight-api/src/scripts/seed-negad-indode-arrived-train.ts
+++ b/apps/edr-freight-api/src/scripts/seed-negad-indode-arrived-train.ts
@@ -157,9 +157,6 @@ async function main() {
             email: 'negad-indode-demo@edr.local',
             contactPersonName: 'Marshalling Demo',
             contactPersonPhone: '251900000202',
-            generalManagerName: 'Demo Manager',
-            generalManagerEmail: 'negad-indode-demo@edr.local',
-            generalManagerPhone: '251900000202',
           }),
         ));
 
diff --git a/apps/edr-freight-api/src/seed/approved-first-lastmile-demo-bookings.seeder.ts b/apps/edr-freight-api/src/seed/approved-first-lastmile-demo-bookings.seeder.ts
index 2e234bcf0..91848dff4 100644
--- a/apps/edr-freight-api/src/seed/approved-first-lastmile-demo-bookings.seeder.ts
+++ b/apps/edr-freight-api/src/seed/approved-first-lastmile-demo-bookings.seeder.ts
@@ -247,9 +247,6 @@ export class ApprovedFirstLastMileDemoBookingsSeeder {
           website: null,
           contactPersonName: 'First Last Mile Demo',
           contactPersonPhone: '251900000101',
-          generalManagerName: 'Demo Manager',
-          generalManagerEmail: COMPANY_EMAIL,
-          generalManagerPhone: '251900000101',
         },
         { conflictPaths: { tin: true } },
       );
diff --git a/apps/edr-freight-api/src/seed/demo-bookings.seeder.ts b/apps/edr-freight-api/src/seed/demo-bookings.seeder.ts
index 20d2a3f8b..4f259c28c 100644
--- a/apps/edr-freight-api/src/seed/demo-bookings.seeder.ts
+++ b/apps/edr-freight-api/src/seed/demo-bookings.seeder.ts
@@ -324,9 +324,6 @@ export class DemoBookingsSeeder {
           website: null,
           contactPersonName: "Train Scheduling",
           contactPersonPhone: "251900000001",
-          generalManagerName: "Demo Manager",
-          generalManagerEmail: COMPANY_EMAIL,
-          generalManagerPhone: "251900000001",
         },
         { conflictPaths: { tin: true } },
       );
diff --git a/apps/edr-freight-api/src/seed/edr-freight.seed.ts b/apps/edr-freight-api/src/seed/edr-freight.seed.ts
index d90fe7b80..e4ab41954 100644
--- a/apps/edr-freight-api/src/seed/edr-freight.seed.ts
+++ b/apps/edr-freight-api/src/seed/edr-freight.seed.ts
@@ -191,6 +191,24 @@ const POSITION_TYPE_PERMISSIONS = [
   },
 ] as const;
 
+/**
+ * Audit trail access.
+ *
+ * Read-only by design: `audit_logs` rows are written solely by
+ * `AuditInterceptor` and the module exposes no create/update/delete route, so
+ * there is deliberately no `:create` / `:update` / `:delete` twin to grant.
+ * The matching `:read` key is derived automatically by
+ * `deriveReadPermissions` below.
+ */
+const AUDIT_LOG_PERMISSIONS = [
+  {
+    id: "52b2cdef-5313-4954-8c69-0f8c58ea2c1e",
+    key: "edr_freight_app:audit_log:view",
+    name: { am: "የኦዲት መዝገብ ይመልከቱ", en: "View audit logs" },
+    applicationKey: EDR_FREIGHT_APPLICATION.key,
+  },
+] as const;
+
 const EDR_FREIGHT_VIEWABLE_PERMISSIONS = [
   ...EMPLOYEE_REGISTRATION_PERMISSIONS,
   ...ROLE_ASSIGNMENT_PERMISSIONS,
@@ -198,6 +216,7 @@ const EDR_FREIGHT_VIEWABLE_PERMISSIONS = [
   ...HIERARCHY_POSITION_PERMISSIONS,
   ...HIERARCHY_EMPLOYEE_ASSIGNMENT_PERMISSIONS,
   ...POSITION_TYPE_PERMISSIONS,
+  ...AUDIT_LOG_PERMISSIONS,
   ...BOOKING_RULE_ENGINE_PERMISSIONS,
 ];
 
@@ -223,6 +242,7 @@ export const EDR_FREIGHT_ROLES: FreightSeedRole[] = [
       "edr_freight_app:hierarchy_positions:view",
       "edr_freight_app:hierarchy_employee_assignment:view",
       "edr_freight_app:position_types:view",
+      "edr_freight_app:chat:view",
     ],
   },
   {
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 7bcae753b..53f7ad2d2 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
@@ -1,6 +1,7 @@
 import { Injectable, Logger } from "@nestjs/common";
 import { DataSource } from "typeorm";
 
+import { FileUploadField } from "../modules/file-upload-settings/entities/file-upload-field.entity";
 import { FileUploadSetting } from "../modules/file-upload-settings/entities/file-upload-setting.entity";
 import { poaDelegationField } from "../modules/file-upload-settings/poa-delegation.constants";
 
@@ -37,7 +38,7 @@ const ETHIOPIAN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 1,
   },
   {
@@ -49,7 +50,7 @@ const ETHIOPIAN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 2,
   },
   {
@@ -60,7 +61,7 @@ const ETHIOPIAN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 3,
   },
   poaDelegationDefault(4),
@@ -76,7 +77,7 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 1,
   },
   {
@@ -87,7 +88,7 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 2,
   },
   {
@@ -98,7 +99,7 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 3,
   },
   {
@@ -109,7 +110,7 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 4,
   },
   poaDelegationDefault(5),
@@ -127,7 +128,7 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
 //     isMultiple: false,
 //     maxFiles: 1,
 //     allowedExtensions: DOC_EXTENSIONS,
-//     maxSizeMb: 10,
+//     maxSizeMb: 50,
 //     displayOrder: 1,
 //   },
 //   {
@@ -138,7 +139,7 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
 //     isMultiple: false,
 //     maxFiles: 1,
 //     allowedExtensions: DOC_EXTENSIONS,
-//     maxSizeMb: 10,
+//     maxSizeMb: 50,
 //     displayOrder: 2,
 //   },
 //   {
@@ -149,11 +150,61 @@ const FOREIGN_ONBOARDING_FIELDS: OnboardingField[] = [
 //     isMultiple: false,
 //     maxFiles: 1,
 //     allowedExtensions: DOC_EXTENSIONS,
-//     maxSizeMb: 10,
+//     maxSizeMb: 50,
 //     displayOrder: 3,
 //   },
 // ];
 
+/**
+ * Documents required from a co-operative union or farm — the third alternative
+ * to the two nationality sets, not an addition to them. A co-op is always
+ * registered in Ethiopia and has a TIN but no business licence, so its
+ * registration certificate stands in for the commercial registration every
+ * other Ethiopian company uploads.
+ *
+ * Admin-managed like every other onboarding set: what these members must
+ * actually produce is a backoffice decision, edited in the file-settings editor.
+ */
+const COOPERATIVE_ONBOARDING_FIELDS: OnboardingField[] = [
+  // First on purpose: only the first field of a new set is seeded, and this is
+  // the paper that distinguishes a co-operative from every other company.
+  {
+    fileKey: "cooperative_registration_certificate",
+    fileLabel: "Co-operative Union / Farm Registration Certificate",
+    helpText:
+      "Certificate issued by the co-operative promotion agency that registered the union or farm.",
+    isRequired: true,
+    isMultiple: false,
+    maxFiles: 1,
+    allowedExtensions: DOC_EXTENSIONS,
+    maxSizeMb: 50,
+    displayOrder: 1,
+  },
+  {
+    fileKey: "tin_certificate",
+    fileLabel: "TIN Certificate",
+    helpText: "Verified against the TIN registry during registration.",
+    isRequired: true,
+    isMultiple: false,
+    maxFiles: 1,
+    allowedExtensions: DOC_EXTENSIONS,
+    maxSizeMb: 50,
+    displayOrder: 2,
+  },
+  {
+    fileKey: "national_id",
+    fileLabel: "National ID",
+    helpText: "Verified against the National ID API during registration.",
+    isRequired: true,
+    isMultiple: false,
+    maxFiles: 1,
+    allowedExtensions: DOC_EXTENSIONS,
+    maxSizeMb: 50,
+    displayOrder: 3,
+  },
+  poaDelegationDefault(4),
+];
+
 interface OnboardingDocumentSetting {
   code: string;
   label: string;
@@ -176,6 +227,14 @@ const COMPANY_ONBOARDING_DOCUMENTS: OnboardingDocumentSetting[] = [
     entity: "customer",
     fields: FOREIGN_ONBOARDING_FIELDS,
   },
+  // The third set: a union or farm resolves here INSTEAD of a nationality set
+  // (it is always Ethiopian, and holds no business licence).
+  {
+    code: "company_onboarding_documents_cooperative",
+    label: "Co-operative union / farm onboarding documents",
+    entity: "customer",
+    fields: COOPERATIVE_ONBOARDING_FIELDS,
+  },
   // Legacy per-company-type codes — removed, unused by any resolver or portal
   // lookup (only `company_onboarding_documents_ethiopian`/`_foreign` are live).
   // {
@@ -232,7 +291,7 @@ function clearanceField(
     isMultiple: false,
     maxFiles: 1,
     allowedExtensions: opts?.extensions ?? DOC_EXTENSIONS,
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder,
   };
 }
@@ -556,7 +615,7 @@ const DRIVER_DOCUMENT_FIELDS: OnboardingField[] = [
     isMultiple: true,
     maxFiles: 20,
     allowedExtensions: ["pdf", "jpg", "jpeg", "png", "doc", "docx"],
-    maxSizeMb: 10,
+    maxSizeMb: 50,
     displayOrder: 1,
   },
 ];
@@ -584,6 +643,21 @@ const INTERCITY_DOCUMENT_SETTINGS: OnboardingDocumentSetting[] = [
   },
 ];
 
+// ── Shipping line booking documents ─────────────────────────────────────────
+// Collected on a shipping line's booking right after it is initiated. Shipping
+// lines book without a contract, so this set — not a contract — is what
+// Operations reviews before the booking may be completed. Fields start empty
+// and are configured in the backoffice file-settings editor, like the sets
+// above. `entity: "booking"` puts it alongside the other per-booking sets.
+const SHIPPING_LINE_DOCUMENT_SETTINGS: OnboardingDocumentSetting[] = [
+  {
+    code: "shipping_line_booking_documents",
+    label: "Shipping line booking documents",
+    entity: "booking",
+    fields: [],
+  },
+];
+
 // ── Hazardous cargo documents ───────────────────────────────────────────────
 // Asked for in the contract wizard the moment the customer flags the cargo as
 // hazardous (ONE_TIME contracts only). Fields start empty and are configured in
@@ -606,16 +680,15 @@ export class FileUploadSettingsSeeder {
   async run() {
     const settingRepository = this.dataSource.getRepository(FileUploadSetting);
 
-    // Seed only into an empty table: any existing rows (including
-    // soft-deleted ones, which would still conflict on the unique `code`)
-    // mean the data is admin-managed, so leave it untouched.
-    const existing = await settingRepository.count({ withDeleted: true });
-    if (existing > 0) {
-      this.logger.log(
-        `file_upload_settings already has ${existing} rows — skipping seed`,
-      );
-      return;
-    }
+    // Seed per CODE, not "only into an empty table". An existing row is
+    // admin-managed and never touched — including a soft-deleted one, which
+    // means the set was removed on purpose (and would still conflict on the
+    // unique `code`). What the table-wide check got wrong is the other half: a
+    // set added to this file after the first boot could never reach a database
+    // that already held the others, so it existed in code and nowhere else.
+    const existingCodes = new Set(
+      (await settingRepository.find({ withDeleted: true })).map((s) => s.code),
+    );
 
     const allSettings: Array<
       OnboardingDocumentSetting & { description: string }
@@ -643,22 +716,48 @@ export class FileUploadSettingsSeeder {
           description:
             "Intercity shipment documents — contract-level for ONE_TIME (after both signatures), per booking for GENERAL; reviewed by Operations.",
         })),
+        ...SHIPPING_LINE_DOCUMENT_SETTINGS.map((s) => ({
+          ...s,
+          description:
+            "Documents a shipping line uploads on a booking it initiated. Reviewed by Operations; the booking can only be completed once they are approved.",
+        })),
       ];
 
-    // Insert setting rows only — no FileUploadField rows. Fields start empty
-    // and are configured from the backoffice file-settings editor; the field
-    // definitions above are kept as reference defaults.
-    await settingRepository.insert(
-      allSettings.map((documentSetting) => ({
-        code: documentSetting.code,
-        label: documentSetting.label,
-        description: documentSetting.description,
-        entity: documentSetting.entity,
-      })),
+    const missing = allSettings.filter((s) => !existingCodes.has(s.code));
+    if (missing.length === 0) {
+      this.logger.log("file upload settings up to date — nothing to seed");
+      return;
+    }
+
+    const inserted = await settingRepository.save(
+      missing.map((documentSetting) =>
+        settingRepository.create({
+          code: documentSetting.code,
+          label: documentSetting.label,
+          description: documentSetting.description,
+          entity: documentSetting.entity,
+        }),
+      ),
     );
 
+    // A brand-new set gets exactly ONE field: its first reference default. The
+    // rest of the list above stays documentation — what a set actually asks for
+    // is a backoffice decision, edited in the file-settings editor. Seeding one
+    // means a set is never born empty (an empty set silently requires nothing),
+    // while leaving the admin a single row to extend rather than a list to prune.
+    const fieldRepository = this.dataSource.getRepository(FileUploadField);
+    const firstFields = inserted.flatMap((setting) => {
+      const reference = missing.find((s) => s.code === setting.code)?.fields[0];
+      return reference
+        ? [fieldRepository.create({ ...reference, settingId: setting.id })]
+        : [];
+    });
+    if (firstFields.length > 0) await fieldRepository.save(firstFields);
+
     this.logger.log(
-      `Seeded ${allSettings.length} file upload settings with empty fields`,
+      `Seeded ${missing.length} file upload settings (${firstFields.length} with a default field): ${missing
+        .map((s) => s.code)
+        .join(", ")}`,
     );
   }
 }
diff --git a/apps/edr-freight-api/src/seed/freight-notification-permissions.seeder.ts b/apps/edr-freight-api/src/seed/freight-notification-permissions.seeder.ts
new file mode 100644
index 000000000..0bea4ad95
--- /dev/null
+++ b/apps/edr-freight-api/src/seed/freight-notification-permissions.seeder.ts
@@ -0,0 +1,103 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { Application, Permission } from '@tria-plc/iamapi-common';
+import { DataSource } from 'typeorm';
+
+import {
+  NOTIFICATION_PERMISSIONS,
+  NOTIFICATION_PERMISSION_ANCHORS,
+} from './freight-permissions.registry';
+
+const EDR_FREIGHT_APP_KEY = 'edr_freight_app';
+
+/**
+ * The three tables a permission grant can arrive on, with the column naming
+ * the grantee. These are compile-time constants — the only values interpolated
+ * into the SQL below.
+ */
+const CARRIERS = [
+  ['iam.position_permissions', 'position_id'],
+  ['iam.position_type_permissions', 'position_type_id'],
+  ['iam.role_permissions', 'role_id'],
+] as const;
+
+/**
+ * Backfills the `<module>:get_notification` keys.
+ *
+ * Those keys are new, so on deploy nobody holds them and every staff
+ * notification would resolve to zero recipients — silently, because
+ * `NotificationInboxService.notify` logs an empty resolve at debug level. This
+ * grants each new key to whoever already holds that desk's anchor key (the
+ * permission gating the page the notification links to), across all three
+ * carriers.
+ *
+ * Deliberately NOT gated behind SEED_EDR_ORG: that flag is off everywhere
+ * except e2e/integration, and this has to run wherever the notifications do.
+ * For the same reason it inserts the permission rows itself rather than
+ * trusting EdrOrgSeeder. Idempotent — safe on every boot, and safe to leave in
+ * place permanently.
+ */
+@Injectable()
+export class FreightNotificationPermissionsSeeder {
+  private readonly logger = new Logger(FreightNotificationPermissionsSeeder.name);
+
+  constructor(private readonly dataSource: DataSource) {}
+
+  async run(): Promise<void> {
+    const application = await this.dataSource
+      .getRepository(Application)
+      .findOne({ where: { key: EDR_FREIGHT_APP_KEY }, select: { id: true } });
+
+    if (!application?.id) {
+      this.logger.warn(
+        `Application '${EDR_FREIGHT_APP_KEY}' not found — notification permission backfill skipped`,
+      );
+      return;
+    }
+
+    // Ids are left to the column default and never sent: iam.permissions has
+    // two unique columns (PK id, UQ key) and ON CONFLICT can only target one,
+    // so a hand-minted id that some retired key already owns would slip past
+    // ON CONFLICT (key) and die on the PK. Same reasoning as EdrOrgSeeder.
+    await this.dataSource
+      .getRepository(Permission)
+      .createQueryBuilder()
+      .insert()
+      .values(
+        NOTIFICATION_PERMISSIONS.map((permission) => ({
+          key: permission.key,
+          name: { ...permission.name },
+          applicationId: application.id as string,
+        })),
+      )
+      .orIgnore()
+      .execute();
+
+    let granted = 0;
+    for (const [key, anchors] of Object.entries(
+      NOTIFICATION_PERMISSION_ANCHORS,
+    )) {
+      for (const [table, granteeColumn] of CARRIERS) {
+        const result: unknown = await this.dataSource.query(
+          `INSERT INTO ${table} (${granteeColumn}, permission_id)
+           SELECT DISTINCT g.${granteeColumn}, target.id
+             FROM ${table} g
+             JOIN iam.permissions anchor
+               ON anchor.id = g.permission_id AND anchor.key = ANY($1)
+             JOIN iam.permissions target ON target.key = $2
+            WHERE NOT EXISTS (
+              SELECT 1
+                FROM ${table} existing
+               WHERE existing.${granteeColumn} = g.${granteeColumn}
+                 AND existing.permission_id = target.id)`,
+          [anchors, key],
+        );
+        // node-postgres returns [rows, rowCount] for a bare INSERT.
+        granted += (Array.isArray(result) ? (result[1] as number) : 0) ?? 0;
+      }
+    }
+
+    this.logger.log(
+      `Ensured ${NOTIFICATION_PERMISSIONS.length} notification permissions, backfilled ${granted} grant(s)`,
+    );
+  }
+}
diff --git a/apps/edr-freight-api/src/seed/freight-permissions.registry.spec.ts b/apps/edr-freight-api/src/seed/freight-permissions.registry.spec.ts
index b69dcff71..d134a7986 100644
--- a/apps/edr-freight-api/src/seed/freight-permissions.registry.spec.ts
+++ b/apps/edr-freight-api/src/seed/freight-permissions.registry.spec.ts
@@ -1,5 +1,9 @@
 import { EDR_FREIGHT_PERMISSIONS } from './edr-freight.seed';
-import { readTwinOf } from './freight-permissions.registry';
+import {
+  NOTIFICATION_PERMISSIONS,
+  NOTIFICATION_PERMISSION_ANCHORS,
+  readTwinOf,
+} from './freight-permissions.registry';
 
 describe('EDR_FREIGHT_PERMISSIONS', () => {
   // The seeder inserts the whole catalog in one ON CONFLICT (key) DO UPDATE
@@ -48,3 +52,36 @@ describe('EDR_FREIGHT_PERMISSIONS', () => {
     }
   });
 });
+
+describe('NOTIFICATION_PERMISSION_ANCHORS', () => {
+  const catalog = new Set(EDR_FREIGHT_PERMISSIONS.map((p) => p.key));
+
+  // FreightNotificationPermissionsSeeder backfills each get_notification key
+  // onto whoever holds its anchor. A typo'd anchor matches no permission row,
+  // so the key is granted to nobody and every notification on that desk
+  // silently resolves to zero recipients — notify() logs that at debug level.
+  it('anchors every notification key on keys that exist', () => {
+    const missing = Object.values(NOTIFICATION_PERMISSION_ANCHORS)
+      .flat()
+      .filter((key) => !catalog.has(key));
+
+    expect(missing).toEqual([]);
+  });
+
+  it('seeds every notification key into the catalog', () => {
+    const missing = NOTIFICATION_PERMISSIONS.map((p) => p.key).filter(
+      (key) => !catalog.has(key),
+    );
+
+    expect(missing).toEqual([]);
+  });
+
+  it('gives every notification key an anchor to backfill from', () => {
+    const anchored = new Set(Object.keys(NOTIFICATION_PERMISSION_ANCHORS));
+    const unanchored = NOTIFICATION_PERMISSIONS.map((p) => p.key).filter(
+      (key) => !anchored.has(key),
+    );
+
+    expect(unanchored).toEqual([]);
+  });
+});
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 c181cba90..c78dede1b 100644
--- a/apps/edr-freight-api/src/seed/freight-permissions.registry.ts
+++ b/apps/edr-freight-api/src/seed/freight-permissions.registry.ts
@@ -47,6 +47,64 @@ const perm = (id: string, key: string, en: string): FreightPermissionSeed => ({
   applicationKey: EDR_FREIGHT_APP_KEY,
 });
 
+/**
+ * One entry per report definition (see modules/reports/definitions). Each
+ * gets its own permission, gated behind the `reports:view` master key that
+ * opens the Reports section itself.
+ * Keep new keys at the END: reportPermId derives ids from list index, so a
+ * mid-list insert would shift ids already seeded for later keys.
+ */
+export const REPORT_KEYS = [
+  "bookings-list",
+  "revenue-by-customer",
+  "aging-receivables",
+  "contract-utilization",
+  "wagon-fleet-status",
+  "wagon-status-duration",
+  "wagon-requests",
+  "locomotive-fleet-status",
+  "booking-status-breakdown",
+  "train-schedule-status",
+  "train-turnaround",
+  "wagon-teu-utilization",
+  "loaded-capacity",
+  "global-logistics-wagons",
+  "customer-status",
+  "contract-lifecycle",
+  "customs-documents",
+  "invoicing-pipeline",
+  "first-last-mile-bookings",
+  "invoices-by-status",
+  "payments-by-status",
+  "revenue-summary",
+  "cargo-summary",
+  "revenue-by-category",
+  "revenue-transactions",
+  "revenue-by-period",
+  "revenue-by-route",
+  "revenue-top-customers",
+  "payment-classification",
+  "revenue-reconciliation",
+  "receivables-payables",
+  "revenue-anomalies",
+] as const;
+
+export type ReportKey = (typeof REPORT_KEYS)[number];
+
+export const reportPermissionKey = (key: ReportKey): string =>
+  `edr_freight_app:reports:${key.replace(/-/g, "_")}:view`;
+
+const reportPermId = (index: number): string =>
+  `a4f00002-0001-4000-8000-${(index + 1).toString(16).padStart(12, "0")}`;
+
+const titleCase = (slug: string): string =>
+  slug.split("-").map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
+
+export const REPORT_PERMISSIONS: FreightPermissionSeed[] = REPORT_KEYS.map(
+  (key, index) =>
+    perm(reportPermId(index), reportPermissionKey(key), `Report: ${titleCase(key)}`),
+);
+
 export const BOOKING_PERMISSIONS: FreightPermissionSeed[] = [
   perm(
     "a1000001-0001-4000-8000-000000000001",
@@ -177,6 +235,14 @@ export const BOOKING_PERMISSIONS: FreightPermissionSeed[] = [
     "edr_freight_app:bookings:wagon_cancellation_rebook",
     "Rebook cancelled wagons for a customer",
   ),
+  // Shared-wagon gate: two customers' cargo on one wagon is a commercial call,
+  // so it is signed off separately from the ordinary booking approvals — and
+  // never by the GL user who created the pairing.
+  perm(
+    "a1000001-0001-4000-8000-000000000029",
+    "edr_freight_app:bookings:approve_consolidation",
+    "Approve shared-wagon consolidation",
+  ),
 ];
 
 /**
@@ -410,6 +476,26 @@ export const GAP_CONTROLLER_PERMISSIONS: FreightPermissionSeed[] = [
   ),
 ];
 
+/**
+ * Yard access scoping. `yard_positions` maps desks to yards and the resolver
+ * (`YardScopeService`) narrows a caller to the yards their active position is
+ * mapped to. This key is the deliberate way out of that narrowing, for the HQ
+ * desks that are cross-yard by nature (OCC, CEO, rolling stock). Without it,
+ * "unmapped" would have to mean "sees everything", which is a bypass by
+ * accident rather than by grant.
+ *
+ * Editing the mapping itself needs no key of its own: it is yard configuration,
+ * so it rides on `rule_engine:yards:view` / `:update` like every other field on
+ * a yard.
+ */
+export const YARD_SCOPE_PERMISSIONS: FreightPermissionSeed[] = [
+  perm(
+    "f4a00001-0001-4000-8000-000000000001",
+    "edr_freight_app:yards:view_all",
+    "Access every yard (bypass yard scoping)",
+  ),
+];
+
 /**
  * Advanced backoffice resources — full CRUD + workflow-action keys.
  * See docs/rbac/freight-backoffice-permissions.md. Additive only: the existing
@@ -450,6 +536,36 @@ export const CUSTOMER_PERMISSIONS: FreightPermissionSeed[] = [
   ),
 ];
 
+// C2. Shipping lines — carriers registered by staff (no self-signup).
+export const SHIPPING_LINE_PERMISSIONS: FreightPermissionSeed[] = [
+  perm(
+    "d1a00002-0001-4000-8000-000000000001",
+    "edr_freight_app:shipping_lines:view",
+    "View shipping lines",
+  ),
+  perm(
+    "d1a00002-0001-4000-8000-000000000002",
+    "edr_freight_app:shipping_lines:create",
+    "Register shipping line",
+  ),
+  perm(
+    "d1a00002-0001-4000-8000-000000000003",
+    "edr_freight_app:shipping_lines:update",
+    "Update shipping line",
+  ),
+  perm(
+    "d1a00002-0001-4000-8000-000000000004",
+    "edr_freight_app:shipping_lines:reset-password",
+    "Resend shipping line activation link",
+  ),
+];
+
+// Internal chat (Matrix/Element) — sidebar visibility + manual reconcile trigger.
+export const CHAT_PERMISSIONS: FreightPermissionSeed[] = [
+  perm('c9a00001-0001-4000-8000-000000000001', 'edr_freight_app:chat:view', 'Open internal chat'),
+  perm('c9a00001-0001-4000-8000-000000000002', 'edr_freight_app:chat:sync', 'Re-run chat room/membership sync'),
+];
+
 // D. Finance — payments + invoices
 export const FINANCE_PERMISSIONS: FreightPermissionSeed[] = [
   perm(
@@ -467,6 +583,91 @@ export const FINANCE_PERMISSIONS: FreightPermissionSeed[] = [
     "edr_freight_app:invoices:export",
     "Download invoice document",
   ),
+  // Filing with the tax authority is its own grant: registration is irreversible at MoR, so it
+  // must not ride along with the right to download an invoice PDF.
+  perm(
+    "d2b00001-0001-4000-8000-000000000005",
+    "edr_freight_app:invoices:eims_register",
+    "Register invoice with MoR EIMS",
+  ),
+  // Separate from registering: resolving an unacknowledged submission clears the
+  // system-wide chain block and can record an IRN against an invoice, so it is a
+  // supervisor/admin action rather than an operational one.
+  perm(
+    "d2b00001-0001-4000-8000-000000000006",
+    "edr_freight_app:invoices:eims_resolve",
+    "Resolve a blocked MoR EIMS submission",
+  ),
+  // Cancellation is a separate irreversible-at-MoR action from registration — its own grant,
+  // same reasoning as eims_register.
+  perm(
+    "d2b00001-0001-4000-8000-000000000008",
+    "edr_freight_app:invoices:eims_cancel",
+    "Cancel a registered invoice with MoR EIMS",
+  ),
+  // Covers both sales and withholding receipts — same risk profile (filing a document with
+  // MoR), no reason to split further.
+  perm(
+    "d2b00001-0001-4000-8000-000000000009",
+    "edr_freight_app:invoices:eims_receipt_register",
+    "Register a sales or withholding receipt with MoR EIMS",
+  ),
+  // Issuing a credit/debit memo is itself filing-equivalent — auto-submit picks it up like any
+  // other issued invoice — so it carries the same restricted grant as the eims_* actions above,
+  // not invoices:export.
+  perm(
+    "d2b00001-0001-4000-8000-00000000000a",
+    "edr_freight_app:invoices:memo_issue",
+    "Issue a credit or debit memo against a registered invoice",
+  ),
+  // USD bookings are paid by bank transfer; Finance uploads the slip and settles
+  // the invoice. Moves money state, so it is its own grant, not part of view.
+  perm(
+    "d2b00001-0001-4000-8000-000000000007",
+    "edr_freight_app:invoices:confirm_offline",
+    "Confirm offline (bank transfer) invoice payment",
+  ),
+  // Shipping lines consume services on credit and are invoiced after the fact,
+  // so what they owe is its own Finance surface, separate from invoices:view —
+  // an unbilled credit is not an invoice yet.
+  perm(
+    "d2c00001-0001-4000-8000-000000000001",
+    "edr_freight_app:shipping_line_credits:view",
+    "View shipping-line credits and outstanding balance",
+  ),
+  perm(
+    "d2c00001-0001-4000-8000-000000000002",
+    "edr_freight_app:shipping_line_credits:invoice",
+    "Generate an invoice from shipping-line credits",
+  ),
+  // Erases a debt outright, which is why it is not folded into :invoice.
+  perm(
+    "d2c00001-0001-4000-8000-000000000003",
+    "edr_freight_app:shipping_line_credits:cancel",
+    "Cancel (write off) an unbilled shipping-line credit",
+  ),
+  // Two-step manual actions on credit invoices: request grants per action,
+  // decision grants that apply to any pending request.
+  perm(
+    "d2c00001-0001-4000-8000-000000000004",
+    "edr_freight_app:shipping_line_credits:invoice_mark_paid",
+    "Request marking a shipping-line credit invoice paid (offline payment)",
+  ),
+  perm(
+    "d2c00001-0001-4000-8000-000000000005",
+    "edr_freight_app:shipping_line_credits:invoice_approve",
+    "Approve any pending shipping-line credit invoice request",
+  ),
+  perm(
+    "d2c00001-0001-4000-8000-000000000006",
+    "edr_freight_app:shipping_line_credits:invoice_cancel",
+    "Request cancelling a shipping-line credit invoice",
+  ),
+  perm(
+    "d2c00001-0001-4000-8000-000000000007",
+    "edr_freight_app:shipping_line_credits:invoice_reject",
+    "Reject any pending shipping-line credit invoice request",
+  ),
 ];
 
 // E. First / last mile operations
@@ -685,6 +886,34 @@ export const FLEET_RAIL_PERMISSIONS: FreightPermissionSeed[] = [
     "edr_freight_app:trains:assign_wagons",
     "Assign wagons to train",
   ),
+  // Granular splits of trains:update / trains:delete for the train-builder
+  // detail page's Actions menu — each item gets its own grant instead of
+  // sharing the coarse update/delete keys.
+  perm(
+    "e1c00001-0001-4000-8000-000000000006",
+    "edr_freight_app:trains:change_locomotives",
+    "Change train locomotives",
+  ),
+  perm(
+    "e1c00001-0001-4000-8000-000000000007",
+    "edr_freight_app:trains:change_yard",
+    "Change train yard",
+  ),
+  perm(
+    "e1c00001-0001-4000-8000-000000000008",
+    "edr_freight_app:trains:toggle_active",
+    "Activate or deactivate train",
+  ),
+  perm(
+    "e1c00001-0001-4000-8000-000000000009",
+    "edr_freight_app:trains:disband",
+    "Disband train",
+  ),
+  perm(
+    "e1c00001-0001-4000-8000-000000000010",
+    "edr_freight_app:trains:change_wagon_yard",
+    "Change yard of a coupled wagon",
+  ),
   perm(
     "e1d00001-0001-4000-8000-000000000001",
     "edr_freight_app:routes:view",
@@ -1142,6 +1371,42 @@ export const CONFIG_SETTINGS_PERMISSIONS: FreightPermissionSeed[] = [
     "edr_freight_app:settings:dropdown:manage",
     "Manage dropdown settings",
   ),
+  perm(
+    "b4b00002-0001-4000-8000-000000000001",
+    "edr_freight_app:settings:stamp:view",
+    "View the company stamp",
+  ),
+  perm(
+    "b4b00002-0001-4000-8000-000000000002",
+    "edr_freight_app:settings:stamp:manage",
+    "Manage the company stamp",
+  ),
+  perm(
+    "b4b00004-0001-4000-8000-000000000001",
+    "edr_freight_app:settings:logo:view",
+    "View the company logo",
+  ),
+  perm(
+    "b4b00004-0001-4000-8000-000000000002",
+    "edr_freight_app:settings:logo:manage",
+    "Manage the company logo",
+  ),
+  // The per-officer approval teeter (ማህተም) — an individual's own stamp +
+  // signature, not the company seal. It used to ride on settings:stamp:*, which
+  // now gates the ONE company stamp; this key was split out when the two were
+  // untangled. `settings:invoice_stamp:*` retired at the same time: it gated the
+  // company stamp before the fold and is deliberately left orphaned in any DB
+  // that already seeded it (the seeder upserts by key and never deletes).
+  perm(
+    "b4b00003-0001-4000-8000-000000000001",
+    "edr_freight_app:settings:teeter:view",
+    "View own approval teeter and signature",
+  ),
+  perm(
+    "b4b00003-0001-4000-8000-000000000002",
+    "edr_freight_app:settings:teeter:manage",
+    "Manage own approval teeter and signature",
+  ),
   perm(
     "b4c00001-0001-4000-8000-000000000001",
     "edr_freight_app:audit:view",
@@ -1248,6 +1513,16 @@ export const GRANULAR_SPLIT_PERMISSIONS: FreightPermissionSeed[] = [
     "edr_freight_app:settings:exchange_rate:manage",
     "Set the USD-ETB fallback rate",
   ),
+  perm(
+    "b4d00001-0001-4000-8000-000000000003",
+    "edr_freight_app:settings:manual_payment:view",
+    "View the manual (offline) payment channel settings",
+  ),
+  perm(
+    "b4d00001-0001-4000-8000-000000000004",
+    "edr_freight_app:settings:manual_payment:manage",
+    "Enable or disable manual invoice settlement per currency",
+  ),
   perm(
     "b4e00001-0001-4000-8000-000000000001",
     "edr_freight_app:settings:contract_templates:view",
@@ -1258,6 +1533,36 @@ export const GRANULAR_SPLIT_PERMISSIONS: FreightPermissionSeed[] = [
     "edr_freight_app:settings:contract_templates:manage",
     "Edit contract templates & articles",
   ),
+  // Granular split of contract-template access. `view` opens the sidebar page;
+  // `read` is API-read-only for other pages that display template data — and is
+  // NOT written out here: deriveReadPermissions mints the `:read` twin of every
+  // `:view` key, so a hand-written one duplicates the key (Postgres 21000 on the
+  // seeder's ON CONFLICT (key) insert) and carries a v4 id where twins are v5.
+  perm(
+    "b4e00001-0001-4000-8000-000000000003",
+    "edr_freight_app:settings:contract_templates:create",
+    "Create bulk contract templates",
+  ),
+  perm(
+    "b4e00001-0001-4000-8000-000000000004",
+    "edr_freight_app:settings:contract_templates:update",
+    "Update contract templates & articles",
+  ),
+  perm(
+    "b4e00001-0001-4000-8000-000000000005",
+    "edr_freight_app:settings:contract_templates:delete",
+    "Delete bulk contract templates",
+  ),
+  perm(
+    "b4f00001-0001-4000-8000-000000000001",
+    "edr_freight_app:settings:support_content:view",
+    "View portal help & legal content",
+  ),
+  perm(
+    "b4f00001-0001-4000-8000-000000000002",
+    "edr_freight_app:settings:support_content:manage",
+    "Edit portal help, FAQ & legal content",
+  ),
 ];
 
 // N. Previously-ungated staff surfaces (support inbox, procurement, compliance,
@@ -1342,8 +1647,59 @@ export const AUDIENCE_GAP_PERMISSIONS: FreightPermissionSeed[] = [
   ),
 ];
 
+// O. Notification recipient selectors. NOT route guards — these are never
+// passed to FreightPermissionGuard/assertFreightPermission and never appear in
+// the frontend's RequirePermission. They exist so ops can tune who gets pinged
+// WITHOUT changing who can open the page. Before them every staff notification
+// used the `allBackoffice` selector, i.e. every current employee in every org.
+export const NOTIFICATION_PERMISSIONS: FreightPermissionSeed[] = [
+  perm(
+    "f3a00001-0001-4000-8000-000000000001",
+    "edr_freight_app:bookings:get_notification",
+    "Receive booking desk notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000002",
+    "edr_freight_app:bookings:clearance_get_notification",
+    "Receive booking clearance notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000003",
+    "edr_freight_app:contracts:get_notification",
+    "Receive contract desk notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000004",
+    "edr_freight_app:contracts:clearance_get_notification",
+    "Receive contract clearance notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000005",
+    "edr_freight_app:customers:get_notification",
+    "Receive customer desk notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000006",
+    "edr_freight_app:maintenance:get_notification",
+    "Receive maintenance due notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000007",
+    "edr_freight_app:rule_engine:get_notification",
+    "Receive rule-change approval notifications",
+  ),
+  perm(
+    "f3a00001-0001-4000-8000-000000000008",
+    "edr_freight_app:warehouse_fee_invoices:get_notification",
+    "Receive warehouse fee accrual notifications",
+  ),
+];
+
 export const ADVANCED_BACKOFFICE_PERMISSIONS: FreightPermissionSeed[] = [
+  ...REPORT_PERMISSIONS,
   ...CUSTOMER_PERMISSIONS,
+  ...SHIPPING_LINE_PERMISSIONS,
+  ...CHAT_PERMISSIONS,
   ...FINANCE_PERMISSIONS,
   ...MILE_PERMISSIONS,
   ...FLEET_RAIL_PERMISSIONS,
@@ -1355,6 +1711,7 @@ export const ADVANCED_BACKOFFICE_PERMISSIONS: FreightPermissionSeed[] = [
   ...STAFF_IAM_PERMISSIONS,
   ...AUDIENCE_GAP_PERMISSIONS,
   ...GRANULAR_SPLIT_PERMISSIONS,
+  ...NOTIFICATION_PERMISSIONS,
 ];
 
 export const BOOKING_RULE_ENGINE_PERMISSIONS = [
@@ -1362,6 +1719,7 @@ export const BOOKING_RULE_ENGINE_PERMISSIONS = [
   ...CONTRACT_PERMISSIONS,
   ...RULE_ENGINE_PERMISSIONS,
   ...GAP_CONTROLLER_PERMISSIONS,
+  ...YARD_SCOPE_PERMISSIONS,
   ...ADVANCED_BACKOFFICE_PERMISSIONS,
 ];
 
@@ -1446,6 +1804,11 @@ export const FREIGHT_PERMS = {
     wagonCancellationVoid: "edr_freight_app:bookings:wagon_cancellation_void",
     wagonCancellationRebook:
       "edr_freight_app:bookings:wagon_cancellation_rebook",
+    approveConsolidation: "edr_freight_app:bookings:approve_consolidation",
+    // Notification selectors, not route guards — see NOTIFICATION_PERMISSIONS.
+    getNotification: "edr_freight_app:bookings:get_notification",
+    clearanceGetNotification:
+      "edr_freight_app:bookings:clearance_get_notification",
   },
   contracts: {
     view: "edr_freight_app:contracts:view",
@@ -1482,6 +1845,10 @@ export const FREIGHT_PERMS = {
     editDocument: "edr_freight_app:contracts:edit_document",
     finalInvoiceRaise: "edr_freight_app:contracts:final_invoice_raise",
     finalInvoiceConfirm: "edr_freight_app:contracts:final_invoice_confirm",
+    // Notification selectors, not route guards — see NOTIFICATION_PERMISSIONS.
+    getNotification: "edr_freight_app:contracts:get_notification",
+    clearanceGetNotification:
+      "edr_freight_app:contracts:clearance_get_notification",
   },
   trainScheduling: {
     view: "edr_freight_app:train_scheduling:view",
@@ -1493,11 +1860,24 @@ export const FREIGHT_PERMS = {
     dispatch: "edr_freight_app:train_scheduling:dispatch",
     markPaid: "edr_freight_app:train_scheduling:mark_paid",
     expireBooking: "edr_freight_app:train_scheduling:expire_booking",
+    /**
+     * Edit a schedule's operational run numbers (train + voyage) before
+     * dispatch. Separate from `update`: these numbers are what yards and
+     * customs quote, so changing them is narrower than general scheduling edits.
+     */
+    editTrainNumber: "edr_freight_app:train_scheduling:edit_train_number",
   },
   fleet: {
     view: "edr_freight_app:fleet:view",
     manage: "edr_freight_app:fleet:manage",
   },
+  /**
+   * Audit trail. View-only: the module has no write routes, so this is the
+   * only key it needs — see AUDIT_LOG_PERMISSIONS in edr-freight.seed.ts.
+   */
+  auditLog: {
+    view: "edr_freight_app:audit_log:view",
+  },
   admin: "edr_freight_app:admin",
   ruleEngine: {
     view: (slug: RuleEngineResourceSlug) =>
@@ -1510,10 +1890,18 @@ export const FREIGHT_PERMS = {
       `edr_freight_app:rule_engine:${slugToResourceKey(slug)}:delete`,
     approve: (slug: RuleEngineApprovableSlug) =>
       `edr_freight_app:rule_engine:${slugToResourceKey(slug)}:approve`,
+    // Notification selector, not a route guard — see NOTIFICATION_PERMISSIONS.
+    // One key for the whole rules desk: every preset grants the rule-engine
+    // view keys as a block, and both producers link to /dashboard/rules/*.
+    getNotification: "edr_freight_app:rule_engine:get_notification",
   },
   allocation: {
     manage: "edr_freight_app:allocation:manage",
   },
+  yards: {
+    /** Bypasses yard scoping entirely — see YARD_SCOPE_PERMISSIONS. */
+    viewAll: "edr_freight_app:yards:view_all",
+  },
   customers: {
     view: "edr_freight_app:customers:view",
     create: "edr_freight_app:customers:create",
@@ -1521,6 +1909,37 @@ export const FREIGHT_PERMS = {
     deactivate: "edr_freight_app:customers:deactivate",
     verify: "edr_freight_app:customers:verify",
     resetPassword: "edr_freight_app:customers:reset-password",
+    // Notification selector, not a route guard — see NOTIFICATION_PERMISSIONS.
+    getNotification: "edr_freight_app:customers:get_notification",
+  },
+  shippingLines: {
+    view: "edr_freight_app:shipping_lines:view",
+    create: "edr_freight_app:shipping_lines:create",
+    update: "edr_freight_app:shipping_lines:update",
+    resetPassword: "edr_freight_app:shipping_lines:reset-password",
+  },
+  shippingLineCredits: {
+    view: "edr_freight_app:shipping_line_credits:view",
+    /** Turn a batch of unbilled credits into an invoice. */
+    invoice: "edr_freight_app:shipping_line_credits:invoice",
+    /** Write off an unbilled credit — separate grant: it erases a debt. */
+    cancel: "edr_freight_app:shipping_line_credits:cancel",
+    // Two-step manual actions on credit invoices, gated purely by permission:
+    // finance-level REQUEST grants (per action) and decision grants that apply
+    // to ANY pending request — including the holder's own.
+    /** Request recording an offline payment against a credit invoice. */
+    invoiceMarkPaid:
+      "edr_freight_app:shipping_line_credits:invoice_mark_paid",
+    /** Request voiding a credit invoice (credits return to unbilled). */
+    invoiceCancel: "edr_freight_app:shipping_line_credits:invoice_cancel",
+    /** Approve any pending invoice request (mark-paid or cancel). */
+    invoiceApprove: "edr_freight_app:shipping_line_credits:invoice_approve",
+    /** Reject any pending invoice request. */
+    invoiceReject: "edr_freight_app:shipping_line_credits:invoice_reject",
+  },
+  chat: {
+    view: 'edr_freight_app:chat:view',
+    sync: 'edr_freight_app:chat:sync',
   },
   payments: {
     view: "edr_freight_app:payments:view",
@@ -1528,6 +1947,12 @@ export const FREIGHT_PERMS = {
   invoices: {
     view: "edr_freight_app:invoices:view",
     export: "edr_freight_app:invoices:export",
+    eimsRegister: "edr_freight_app:invoices:eims_register",
+    eimsResolve: "edr_freight_app:invoices:eims_resolve",
+    eimsCancel: "edr_freight_app:invoices:eims_cancel",
+    eimsReceiptRegister: "edr_freight_app:invoices:eims_receipt_register",
+    memoIssue: "edr_freight_app:invoices:memo_issue",
+    confirmOffline: "edr_freight_app:invoices:confirm_offline",
   },
   firstMile: {
     view: "edr_freight_app:first_mile:view",
@@ -1594,6 +2019,11 @@ export const FREIGHT_PERMS = {
     update: "edr_freight_app:trains:update",
     delete: "edr_freight_app:trains:delete",
     assignWagons: "edr_freight_app:trains:assign_wagons",
+    changeLocomotives: "edr_freight_app:trains:change_locomotives",
+    changeYard: "edr_freight_app:trains:change_yard",
+    changeWagonYard: "edr_freight_app:trains:change_wagon_yard",
+    toggleActive: "edr_freight_app:trains:toggle_active",
+    disband: "edr_freight_app:trains:disband",
   },
   routes: {
     view: "edr_freight_app:routes:view",
@@ -1646,6 +2076,8 @@ export const FREIGHT_PERMS = {
     create: "edr_freight_app:maintenance:create",
     update: "edr_freight_app:maintenance:update",
     delete: "edr_freight_app:maintenance:delete",
+    // Notification selector, not a route guard — see NOTIFICATION_PERMISSIONS.
+    getNotification: "edr_freight_app:maintenance:get_notification",
   },
   fleetReports: {
     view: "edr_freight_app:fleet_reports:view",
@@ -1715,6 +2147,8 @@ export const FREIGHT_PERMS = {
     generate: "edr_freight_app:warehouse_fee_invoices:generate",
     cancel: "edr_freight_app:warehouse_fee_invoices:cancel",
     pay: "edr_freight_app:warehouse_fee_invoices:pay",
+    // Notification selector, not a route guard — see NOTIFICATION_PERMISSIONS.
+    getNotification: "edr_freight_app:warehouse_fee_invoices:get_notification",
   },
   settings: {
     fileUpload: {
@@ -1725,17 +2159,50 @@ export const FREIGHT_PERMS = {
       view: "edr_freight_app:settings:dropdown:view",
       manage: "edr_freight_app:settings:dropdown:manage",
     },
+    // The ONE company stamp/seal, applied to every generated document
+    // (invoices, receipts, warehouse papers, the EDR side of contracts).
+    stamp: {
+      view: "edr_freight_app:settings:stamp:view",
+      manage: "edr_freight_app:settings:stamp:manage",
+    },
+    // The ONE company logo, applied to every generated document (invoices,
+    // receipts, contracts, warehouse papers, train-scheduling manifests).
+    logo: {
+      view: "edr_freight_app:settings:logo:view",
+      manage: "edr_freight_app:settings:logo:manage",
+    },
+    // The per-officer approval teeter (ማህተም) + signature — genuinely per-person,
+    // and NOT the company seal above. Retired: `invoiceStamp`, which used to
+    // gate the company stamp before the two were untangled.
+    teeter: {
+      view: "edr_freight_app:settings:teeter:view",
+      manage: "edr_freight_app:settings:teeter:manage",
+    },
     exchangeRate: {
       view: "edr_freight_app:settings:exchange_rate:view",
       manage: "edr_freight_app:settings:exchange_rate:manage",
     },
+    // Whether Finance may settle invoices by hand, per currency. Split
+    // view/manage on purpose: Finance reads it (the worklist offers only the
+    // enabled currencies) but must not switch its own channel on — same
+    // maker-checker split as the other sensitive finance settings.
+    manualPayment: {
+      view: "edr_freight_app:settings:manual_payment:view",
+      manage: "edr_freight_app:settings:manual_payment:manage",
+    },
     contractTemplates: {
       view: "edr_freight_app:settings:contract_templates:view",
       manage: "edr_freight_app:settings:contract_templates:manage",
+      create: "edr_freight_app:settings:contract_templates:create",
+      update: "edr_freight_app:settings:contract_templates:update",
+      delete: "edr_freight_app:settings:contract_templates:delete",
+      read: "edr_freight_app:settings:contract_templates:read",
+    },
+    // Portal-facing help/FAQ/legal copy, edited from Portal content.
+    supportContent: {
+      view: "edr_freight_app:settings:support_content:view",
+      manage: "edr_freight_app:settings:support_content:manage",
     },
-  },
-  audit: {
-    view: "edr_freight_app:audit:view",
   },
   support: {
     agentView: "edr_freight_app:support:agent_view",
@@ -1764,6 +2231,7 @@ export const FREIGHT_PERMS = {
   },
   reports: {
     view: "edr_freight_app:reports:view",
+    report: (key: ReportKey): string => reportPermissionKey(key),
   },
   staff: {
     users: {
@@ -1819,6 +2287,40 @@ export const FREIGHT_PERMS = {
   },
 } as const;
 
+/**
+ * Backfill sources for the `<module>:get_notification` keys: a new key is
+ * granted to whoever already holds ANY of its anchors. The anchor is the key
+ * that gates the page the notification deep-links to — if you cannot open the
+ * page, you were never the intended recipient. The rule-engine desk has no page
+ * of its own, so it anchors on the keys that let you ACT on a filed change.
+ *
+ * Consumed only by FreightNotificationPermissionsSeeder. Keeping it here means
+ * the registry spec can assert every anchor still exists in the catalog — a
+ * typo'd anchor backfills nobody, silently.
+ */
+export const NOTIFICATION_PERMISSION_ANCHORS: Record<string, string[]> = {
+  [FREIGHT_PERMS.bookings.getNotification]: [FREIGHT_PERMS.bookings.view],
+  [FREIGHT_PERMS.bookings.clearanceGetNotification]: [
+    FREIGHT_PERMS.bookings.clearanceView,
+  ],
+  [FREIGHT_PERMS.contracts.getNotification]: [FREIGHT_PERMS.contracts.view],
+  [FREIGHT_PERMS.contracts.clearanceGetNotification]: [
+    FREIGHT_PERMS.contracts.clearanceReview,
+    FREIGHT_PERMS.contracts.clearanceEtActions,
+    FREIGHT_PERMS.contracts.clearanceDjActions,
+    FREIGHT_PERMS.contracts.opsClearanceReview,
+  ],
+  [FREIGHT_PERMS.customers.getNotification]: [FREIGHT_PERMS.customers.view],
+  [FREIGHT_PERMS.maintenance.getNotification]: [FREIGHT_PERMS.maintenance.view],
+  [FREIGHT_PERMS.ruleEngine.getNotification]: [
+    FREIGHT_PERMS.ruleEngine.approve("rates"),
+    FREIGHT_PERMS.ruleEngine.update("priority-configs"),
+  ],
+  [FREIGHT_PERMS.warehouseFeeInvoices.getNotification]: [
+    FREIGHT_PERMS.warehouseFeeInvoices.view,
+  ],
+};
+
 /** Both arms of a freight-type-split permission (for one-of route guards). */
 export const bothFreightTypes = (p: {
   bulk: string;
@@ -1854,6 +2356,11 @@ const FLEET_GRANULAR_KEYS: string[] = [
   FREIGHT_PERMS.trains.update,
   FREIGHT_PERMS.trains.delete,
   FREIGHT_PERMS.trains.assignWagons,
+  FREIGHT_PERMS.trains.changeLocomotives,
+  FREIGHT_PERMS.trains.changeYard,
+  FREIGHT_PERMS.trains.changeWagonYard,
+  FREIGHT_PERMS.trains.toggleActive,
+  FREIGHT_PERMS.trains.disband,
   FREIGHT_PERMS.routes.view,
   FREIGHT_PERMS.routes.create,
   FREIGHT_PERMS.routes.update,
@@ -1870,11 +2377,30 @@ const FLEET_GRANULAR_KEYS: string[] = [
   FREIGHT_PERMS.consignments.create,
 ];
 
+const allReportKeys = (): string[] => REPORT_KEYS.map((k) => reportPermissionKey(k));
+
 // Everyone who works the booking desk also opens the overview dashboard and
 // the canned reports — granted alongside bookings:view in every preset below.
+// Each report also carries its own key (see REPORT_PERMISSIONS); spreading
+// allReportKeys() here keeps every existing preset seeing every report, same
+// as when reports:view alone gated the whole section.
 const STAFF_DASHBOARD_KEYS: string[] = [
   FREIGHT_PERMS.overview.view,
   FREIGHT_PERMS.reports.view,
+  ...allReportKeys(),
+];
+
+// Notification desks — recipient selectors, not access. A preset gets a desk
+// key only where it actually works that queue, which is why the GL presets take
+// the clearance pair and nothing else: they hold no bookings:view and no intake
+// keys, so intake pings would only be noise they cannot act on.
+const BOOKING_DESK_NOTIFICATION_KEYS: string[] = [
+  FREIGHT_PERMS.bookings.getNotification,
+  FREIGHT_PERMS.contracts.getNotification,
+];
+const CLEARANCE_DESK_NOTIFICATION_KEYS: string[] = [
+  FREIGHT_PERMS.bookings.clearanceGetNotification,
+  FREIGHT_PERMS.contracts.clearanceGetNotification,
 ];
 
 export const ROLE_PERMISSION_PRESETS = {
@@ -1889,6 +2415,10 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.bookings.reject,
     FREIGHT_PERMS.bookings.approveLineStaff,
     FREIGHT_PERMS.bookings.rejectApproval,
+    // Shared-wagon gate: two customers' cargo on one wagon is a commercial
+    // call. Granted to the approver roles and NOT to GL — GL creates the
+    // pairing, so GL approving it would defeat the second pair of eyes.
+    FREIGHT_PERMS.bookings.approveConsolidation,
     FREIGHT_PERMS.bookings.cancel,
     FREIGHT_PERMS.bookings.wagonCancellationView,
     FREIGHT_PERMS.bookings.wagonCancellationVoid,
@@ -1899,6 +2429,8 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.contracts.approveLineStaff,
     FREIGHT_PERMS.contracts.editDocument,
     ...allRuleEngineViewKeys(),
+    ...BOOKING_DESK_NOTIFICATION_KEYS,
+    FREIGHT_PERMS.ruleEngine.getNotification,
   ],
   // Operations Officer: train scheduling + wagon allocation + transit/complete
   // + fleet management (wagons, trains, locomotives, routes, containers, cargo).
@@ -1919,6 +2451,7 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.trainScheduling.dispatch,
     FREIGHT_PERMS.trainScheduling.markPaid,
     FREIGHT_PERMS.trainScheduling.expireBooking,
+    FREIGHT_PERMS.trainScheduling.editTrainNumber,
     FREIGHT_PERMS.fleet.view,
     FREIGHT_PERMS.fleet.manage,
     ...FLEET_GRANULAR_KEYS,
@@ -1931,34 +2464,67 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.bookings.reviewDocuments,
     FREIGHT_PERMS.bookings.finalizeClearance,
     ...allRuleEngineViewKeys(),
+    ...BOOKING_DESK_NOTIFICATION_KEYS,
+    // They run Path A clearance review from the booking detail, so the booking
+    // clearance desk is theirs too — but not the contract one, which is GL's.
+    FREIGHT_PERMS.bookings.clearanceGetNotification,
+    FREIGHT_PERMS.ruleEngine.getNotification,
   ],
   director: [
     ...STAFF_DASHBOARD_KEYS,
     FREIGHT_PERMS.bookings.view,
     FREIGHT_PERMS.bookings.approveDirector,
     FREIGHT_PERMS.bookings.rejectApproval,
+    // Shared-wagon gate: two customers' cargo on one wagon is a commercial
+    // call. Granted to the approver roles and NOT to GL — GL creates the
+    // pairing, so GL approving it would defeat the second pair of eyes.
+    FREIGHT_PERMS.bookings.approveConsolidation,
     FREIGHT_PERMS.bookings.generateContract,
     FREIGHT_PERMS.contracts.view,
     FREIGHT_PERMS.contracts.approveDirector,
     FREIGHT_PERMS.contracts.generateContract,
     ...allRuleEngineViewKeys(),
+    ...BOOKING_DESK_NOTIFICATION_KEYS,
   ],
   ceo: [
     ...STAFF_DASHBOARD_KEYS,
     FREIGHT_PERMS.bookings.view,
     FREIGHT_PERMS.bookings.approveCeo,
     FREIGHT_PERMS.bookings.rejectApproval,
+    // Shared-wagon gate: two customers' cargo on one wagon is a commercial
+    // call. Granted to the approver roles and NOT to GL — GL creates the
+    // pairing, so GL approving it would defeat the second pair of eyes.
+    FREIGHT_PERMS.bookings.approveConsolidation,
     FREIGHT_PERMS.contracts.view,
     FREIGHT_PERMS.contracts.approveCeo,
     ...allRuleEngineViewKeys(),
+    ...BOOKING_DESK_NOTIFICATION_KEYS,
   ],
   finance: [
     ...STAFF_DASHBOARD_KEYS,
     FREIGHT_PERMS.bookings.view,
     FREIGHT_PERMS.invoices.view,
     FREIGHT_PERMS.invoices.export,
+    // Manual settlement (bank transfer / counter) of USD and ETB invoices.
+    FREIGHT_PERMS.invoices.confirmOffline,
+    // Read-only: the worklist offers whichever currencies are switched on.
+    // Flipping the switch is deliberately NOT here — see `manualPayment`.
+    FREIGHT_PERMS.settings.manualPayment.view,
+    // Deliberately NOT granted here: invoices:eims_register, eims_resolve, eims_cancel,
+    // eims_receipt_register, eims:memo_issue. Automatic filing needs no human permission at all
+    // (the cron sweep runs as the system); these are the *manual* exceptional-operations
+    // endpoints, and stay off the general Finance role. They are granted to the `chief` position
+    // instead — see below — the same maker–checker split already used for shipping-line credit
+    // mark-paid/cancel (Finance raises, chief decides).
     FREIGHT_PERMS.payments.view,
     FREIGHT_PERMS.bookings.wagonCancellationView,
+    // Shipping-line credit ledger is a Finance surface: bill batches into
+    // invoices and RAISE manual invoice actions. Approval of those actions is
+    // deliberately absent — it sits with the chief (maker–checker).
+    FREIGHT_PERMS.shippingLineCredits.view,
+    FREIGHT_PERMS.shippingLineCredits.invoice,
+    FREIGHT_PERMS.shippingLineCredits.invoiceMarkPaid,
+    FREIGHT_PERMS.shippingLineCredits.invoiceCancel,
   ],
   // Global Logistics: manages ONLY the customs-clearance queue. Scoped out of
   // the general booking-request list (no bookings:view) — instead a dedicated
@@ -1982,6 +2548,7 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.bookings.uploadClearanceOutput,
     FREIGHT_PERMS.bookings.finalizeClearance,
     FREIGHT_PERMS.bookings.operations,
+    ...CLEARANCE_DESK_NOTIFICATION_KEYS,
   ],
   // GL Djibouti (edr_gl_djibouti): DO/RO collection, gatepass, loading milestones,
   // damage reports. Read-only on the contract; no booking creation.
@@ -1993,6 +2560,7 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.bookings.clearanceView,
     FREIGHT_PERMS.bookings.uploadClearanceOutput,
     FREIGHT_PERMS.bookings.operations,
+    ...CLEARANCE_DESK_NOTIFICATION_KEYS,
   ],
   // Marketing handles intake through contract (same as line staff here) and,
   // for non-customs bookings, reviews/finalizes the customer's clearance
@@ -2005,6 +2573,10 @@ export const ROLE_PERMISSION_PRESETS = {
     FREIGHT_PERMS.bookings.reject,
     FREIGHT_PERMS.bookings.approveLineStaff,
     FREIGHT_PERMS.bookings.rejectApproval,
+    // Shared-wagon gate: two customers' cargo on one wagon is a commercial
+    // call. Granted to the approver roles and NOT to GL — GL creates the
+    // pairing, so GL approving it would defeat the second pair of eyes.
+    FREIGHT_PERMS.bookings.approveConsolidation,
     FREIGHT_PERMS.bookings.cancel,
     FREIGHT_PERMS.bookings.wagonCancellationView,
     FREIGHT_PERMS.bookings.wagonCancellationVoid,
@@ -2022,6 +2594,13 @@ export const ROLE_PERMISSION_PRESETS = {
     ...bothFreightTypes(FREIGHT_PERMS.contracts.signStaff),
     FREIGHT_PERMS.contracts.suspend,
     FREIGHT_PERMS.contracts.editDocument,
+    ...BOOKING_DESK_NOTIFICATION_KEYS,
+    // Marketing follows up with the customer when a reviewer sends profile
+    // changes back, so they sit on the customer desk: read-only on the customer
+    // record (no verify/deactivate — the decision stays with the chief) plus the
+    // desk key the change-request pings are addressed to.
+    FREIGHT_PERMS.customers.view,
+    FREIGHT_PERMS.customers.getNotification,
   ],
   orgManager: [...BOOKING_RULE_ENGINE_PERMISSION_KEYS],
 } as const;
@@ -2048,6 +2627,8 @@ export const POSITION_PERMISSION_PRESETS = {
     FREIGHT_PERMS.customers.view,
     FREIGHT_PERMS.customers.verify,
     FREIGHT_PERMS.customers.deactivate,
+    // …and therefore the profile-review pings company-notifier emits.
+    FREIGHT_PERMS.customers.getNotification,
     // The chief also owns the customer-facing support inbox.
     FREIGHT_PERMS.support.agentView,
     FREIGHT_PERMS.support.agentSend,
@@ -2055,10 +2636,24 @@ export const POSITION_PERMISSION_PRESETS = {
     FREIGHT_PERMS.bookings.governmentExpedite,
     FREIGHT_PERMS.invoices.view,
     FREIGHT_PERMS.invoices.export,
+    // Manual MoR EIMS actions and credit/debit memo issuance: kept off the general Finance role
+    // (see that preset's comment) and granted here instead — the chief is already the decision
+    // side of every other sensitive finance action (mark-paid/cancel approval below), and these
+    // are irreversible-at-MoR or receivable-creating in the same way.
+    FREIGHT_PERMS.invoices.eimsCancel,
+    FREIGHT_PERMS.invoices.eimsResolve,
+    FREIGHT_PERMS.invoices.eimsReceiptRegister,
+    FREIGHT_PERMS.invoices.memoIssue,
     FREIGHT_PERMS.payments.view,
+    // Decision side of the credit-invoice two-step: finance raises
+    // mark-paid/cancel requests, the chief approves or rejects them.
+    FREIGHT_PERMS.shippingLineCredits.view,
+    FREIGHT_PERMS.shippingLineCredits.invoiceApprove,
+    FREIGHT_PERMS.shippingLineCredits.invoiceReject,
   ]),
   // Director additionally manages train scheduling + rail fleet (same block the
-  // operation officer/chief hold), on top of the approval-chain role preset.
+  // operation officer/chief hold), on top of the approval-chain role preset,
+  // and carries the same full warehouse authority the chief tier holds.
   director: dedupe([
     ...ROLE_PERMISSION_PRESETS.director,
     FREIGHT_PERMS.trainScheduling.view,
@@ -2067,9 +2662,22 @@ export const POSITION_PERMISSION_PRESETS = {
     FREIGHT_PERMS.trainScheduling.cancel,
     FREIGHT_PERMS.trainScheduling.reschedule,
     FREIGHT_PERMS.trainScheduling.rulesManage,
+    FREIGHT_PERMS.trainScheduling.editTrainNumber,
     FREIGHT_PERMS.fleet.view,
     FREIGHT_PERMS.fleet.manage,
     ...FLEET_GRANULAR_KEYS,
+    // Warehouse — full CRUD, matching the chief tier. Unlike the dispatcher,
+    // the director also owns the allocation and fee rules themselves.
+    FREIGHT_PERMS.warehouseDashboard.view,
+    ...Object.values(FREIGHT_PERMS.warehouses),
+    ...Object.values(FREIGHT_PERMS.warehouseYards),
+    ...Object.values(FREIGHT_PERMS.warehouseZones),
+    ...Object.values(FREIGHT_PERMS.warehouseAllocationRules),
+    ...Object.values(FREIGHT_PERMS.warehouseFeeRules),
+    ...Object.values(FREIGHT_PERMS.warehouseInventory),
+    ...Object.values(FREIGHT_PERMS.warehouseInspectionReports),
+    ...Object.values(FREIGHT_PERMS.interchangeDocuments),
+    ...Object.values(FREIGHT_PERMS.warehouseFeeInvoices),
   ]),
   ceo: dedupe([...ROLE_PERMISSION_PRESETS.ceo]),
   ethiopianGl: dedupe([...ROLE_PERMISSION_PRESETS.glEthiopia]),
diff --git a/apps/edr-freight-api/src/seed/freight-positions.seeder.ts b/apps/edr-freight-api/src/seed/freight-positions.seeder.ts
index 09901b502..81df21a17 100644
--- a/apps/edr-freight-api/src/seed/freight-positions.seeder.ts
+++ b/apps/edr-freight-api/src/seed/freight-positions.seeder.ts
@@ -1,5 +1,6 @@
 import { Injectable, Logger } from '@nestjs/common';
 import {
+  Application,
   Organization,
   Permission,
   Position,
@@ -8,7 +9,23 @@ import {
 } from '@tria-plc/iamapi-common';
 import { DataSource, EntityManager, In } from 'typeorm';
 
-import { EDR_FREIGHT_POSITIONS } from './edr-freight.seed';
+import { EDR_FREIGHT_APPLICATION, EDR_FREIGHT_POSITIONS } from './edr-freight.seed';
+
+/**
+ * Turn a permission key into a readable fallback name for a row this seeder has
+ * to mint itself: `edr_freight_app:train_scheduling:edit_train_number` becomes
+ * "Train scheduling: edit train number". Only used for keys absent from the
+ * catalog — a key that IS catalogued keeps its curated Amharic/English name.
+ */
+const nameForKey = (key: string): { en: string } => {
+  const [, ...rest] = key.split(':');
+  const [resource, ...action] = rest;
+  const humanize = (s: string) => s.replace(/_/g, ' ');
+  const label = action.length
+    ? `${humanize(resource)}: ${humanize(action.join(' '))}`
+    : humanize(resource);
+  return { en: label.charAt(0).toUpperCase() + label.slice(1) };
+};
 
 const SEED_FLAG = 'SEED_EDR_ORG';
 const EDR_ORG_KEY = 'edr_freight';
@@ -83,7 +100,19 @@ export class FreightPositionsSeeder {
     );
   }
 
-  /** Resolve every permission key referenced by any position to its id. */
+  /**
+   * Resolve every permission key referenced by any position to its id, minting
+   * the rows that do not exist yet.
+   *
+   * The position presets draw from FREIGHT_PERMS (the registry), which is
+   * broader than the EDR_FREIGHT_PERMISSIONS catalog EdrOrgSeeder inserts —
+   * module keys like `train_scheduling:*` live only in the registry. So every
+   * newly-added preset key would otherwise abort boot with
+   * `missing_permissions:<key>` until someone hand-inserted it. Ensuring them
+   * here keeps this seeder self-sufficient: it declares the keys it needs, so
+   * it is the one that guarantees they exist. Same approach, and the same
+   * id-less insert reasoning, as FreightNotificationPermissionsSeeder.
+   */
   private async loadPermissionIds(
     manager: EntityManager,
   ): Promise<Map<string, string>> {
@@ -91,16 +120,54 @@ export class FreightPositionsSeeder {
       ...new Set(EDR_FREIGHT_POSITIONS.flatMap((p) => p.permissionKeys)),
     ];
 
-    const permissions = await manager.getRepository(Permission).find({
-      where: { key: In(keys) },
-      select: { id: true, key: true },
-    });
-
-    const map = new Map(permissions.map((p) => [p.key, p.id as string]));
+    const read = async () => {
+      const rows = await manager.getRepository(Permission).find({
+        where: { key: In(keys) },
+        select: { id: true, key: true },
+      });
+      return new Map(rows.map((p) => [p.key, p.id as string]));
+    };
 
+    let map = await read();
     const missing = keys.filter((key) => !map.has(key));
-    if (missing.length > 0) {
-      throw new Error(`missing_permissions:${missing.join(',')}`);
+    if (missing.length === 0) {
+      return map;
+    }
+
+    const application = await manager.getRepository(Application).findOne({
+      where: { key: EDR_FREIGHT_APPLICATION.key },
+      select: { id: true },
+    });
+    if (!application?.id) {
+      throw new Error(`missing_application:${EDR_FREIGHT_APPLICATION.key}`);
+    }
+
+    // Ids are left to the column default and never sent: iam.permissions has
+    // two unique columns (PK id, UQ key) and ON CONFLICT can only target one,
+    // so a hand-minted id already owned by a retired key would slip past
+    // ON CONFLICT (key) and die on the PK.
+    await manager
+      .createQueryBuilder()
+      .insert()
+      .into(Permission)
+      .values(
+        missing.map((key) => ({
+          key,
+          name: nameForKey(key),
+          applicationId: application.id as string,
+        })),
+      )
+      .orIgnore()
+      .execute();
+
+    this.logger.log(
+      `Seeded ${missing.length} permission(s) referenced by positions but absent from the catalog: ${missing.join(', ')}`,
+    );
+
+    map = await read();
+    const stillMissing = keys.filter((key) => !map.has(key));
+    if (stillMissing.length > 0) {
+      throw new Error(`missing_permissions:${stillMissing.join(',')}`);
     }
 
     return map;
diff --git a/apps/edr-freight-api/src/seed/paid-import-export-mile-demo.seeder.ts b/apps/edr-freight-api/src/seed/paid-import-export-mile-demo.seeder.ts
index 654f4f77f..a658ec13d 100644
--- a/apps/edr-freight-api/src/seed/paid-import-export-mile-demo.seeder.ts
+++ b/apps/edr-freight-api/src/seed/paid-import-export-mile-demo.seeder.ts
@@ -175,9 +175,6 @@ export class PaidImportExportMileDemoSeeder {
           website: null,
           contactPersonName: 'Paid Mile Demo',
           contactPersonPhone: '251900000202',
-          generalManagerName: 'Demo Manager',
-          generalManagerEmail: COMPANY_EMAIL,
-          generalManagerPhone: '251900000202',
         },
         { conflictPaths: { tin: true } },
       );
diff --git a/apps/edr-freight-api/src/seed/support-content.seeder.ts b/apps/edr-freight-api/src/seed/support-content.seeder.ts
new file mode 100644
index 000000000..5ae5e57fe
--- /dev/null
+++ b/apps/edr-freight-api/src/seed/support-content.seeder.ts
@@ -0,0 +1,62 @@
+import { SUPPORT_CONTENT_DEFAULTS, SUPPORT_DOC_SLUGS } from "@edr/types";
+import { Injectable, Logger } from "@nestjs/common";
+import { DataSource } from "typeorm";
+
+import {
+  SupportDocument,
+  SupportDocumentVersion,
+} from "../modules/support-content/entities/support-document.entity";
+
+/**
+ * Puts the portal's shipped help/FAQ/legal copy into the database on first
+ * boot. Idempotent by emptiness, like the other reference-data seeders: once a
+ * row exists the content is admin-managed, so a redeploy must never clobber it.
+ *
+ * Each document is written together with its `version = 1` history row, which
+ * is what makes `max(version)` in the log always equal the live row — the
+ * invariant the version list and rollback both assume.
+ */
+@Injectable()
+export class SupportContentSeeder {
+  private readonly logger = new Logger(SupportContentSeeder.name);
+
+  constructor(private readonly dataSource: DataSource) {}
+
+  async run() {
+    const documents = this.dataSource.getRepository(SupportDocument);
+    const versions = this.dataSource.getRepository(SupportDocumentVersion);
+
+    const existing = await documents.count({ withDeleted: true });
+    if (existing > 0) {
+      this.logger.log(
+        `support_documents already has ${existing} rows — skipping seed`,
+      );
+      return;
+    }
+
+    for (const slug of SUPPORT_DOC_SLUGS) {
+      const document = await documents.save(
+        documents.create({
+          slug,
+          payload: SUPPORT_CONTENT_DEFAULTS[slug],
+          version: 1,
+          updatedById: null,
+        }),
+      );
+
+      await versions.save(
+        versions.create({
+          documentId: document.id,
+          version: 1,
+          payload: document.payload,
+          actorId: null,
+          note: "Initial content",
+        }),
+      );
+    }
+
+    this.logger.log(
+      `Seeded ${SUPPORT_DOC_SLUGS.length} portal content documents`,
+    );
+  }
+}
diff --git a/apps/edr-freight-web/backoffice/.env.example b/apps/edr-freight-web/backoffice/.env.example
index 454817139..36bdb80de 100644
--- a/apps/edr-freight-web/backoffice/.env.example
+++ b/apps/edr-freight-web/backoffice/.env.example
@@ -12,3 +12,9 @@ VITE_TOKEN_REFRESH_INTERVAL_MINUTES=10
 # observability stays off (the app works either way). Self-hosted instance.
 VITE_POSTHOG_KEY=phc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 VITE_POSTHOG_HOST=https://posthog.example.com
+
+# Maps JavaScript API key (fleet TrackingPage). Required — the hardcoded
+# fallback in TrackingPage.tsx is expired (ExpiredKeyMapError), so without
+# this set the tracking map renders blank. Get a key from the Google Cloud
+# Console (Maps JavaScript API + Places API + Geocoding API enabled).
+VITE_GOOGLE_MAPS_API_KEY=
diff --git a/apps/edr-freight-web/backoffice/index.css b/apps/edr-freight-web/backoffice/index.css
index fa9eb3e3d..8e410f026 100644
--- a/apps/edr-freight-web/backoffice/index.css
+++ b/apps/edr-freight-web/backoffice/index.css
@@ -1,11 +1,13 @@
 @import "tailwindcss";
 @import "@edr/ui-common/theme.css" layer(theme);
 
-/* The app toggles dark mode by setting the `dark` class on <html> (see
-   main.tsx / FreightDashboardLayout). Without this, Tailwind v4 compiles
-   `dark:` utilities to `@media (prefers-color-scheme: dark)` and they follow
-   the OS setting instead of the in-app toggle. */
-@custom-variant dark (&:where(.dark, .dark *));
+/* The backoffice is light-only — there is no theme toggle and nothing sets the
+   `dark` class. This override is load-bearing: without it Tailwind v4 compiles
+   `dark:` utilities to `@media (prefers-color-scheme: dark)`, so every
+   leftover `dark:` class (the vendored IAM UI is full of them) would activate
+   on an OS-level dark setting. Binding the variant to a class that is never
+   rendered keeps those utilities inert no matter what the OS says. */
+@custom-variant dark (&:where(.edr-dark-disabled));
 
 /* Bridge the central Mantine theme into Tailwind. freightMantineTheme
    (createTheme) is the single source of truth; these just alias its generated
diff --git a/apps/edr-freight-web/backoffice/package.json b/apps/edr-freight-web/backoffice/package.json
index 68fdb2a8f..e0ef813e9 100644
--- a/apps/edr-freight-web/backoffice/package.json
+++ b/apps/edr-freight-web/backoffice/package.json
@@ -20,6 +20,7 @@
     "@mantine/core": "^9.3.0",
     "@mantine/dates": "^9.3.0",
     "@mantine/hooks": "^9.3.0",
+    "@mdxeditor/editor": "^4.2.0",
     "@posthog/react": "^1.10.3",
     "@radix-ui/react-accordion": "^1.2.13",
     "@radix-ui/react-alert-dialog": "^1.1.16",
@@ -93,6 +94,7 @@
     "react-icons": "^5.6.0",
     "react-image-crop": "^11.0.10",
     "react-intersection-observer": "^9.16.0",
+    "react-markdown": "^9.1.0",
     "react-pdf": "^10.4.1",
     "react-pdf-html": "^2.1.5",
     "react-quill-new": "^3.8.3",
diff --git a/apps/edr-freight-web/backoffice/src/App.tsx b/apps/edr-freight-web/backoffice/src/App.tsx
index bad3cbfe5..f0e9c2254 100644
--- a/apps/edr-freight-web/backoffice/src/App.tsx
+++ b/apps/edr-freight-web/backoffice/src/App.tsx
@@ -1,4 +1,5 @@
-import { useEffect } from "react";
+import { useEffect, useMemo } from "react";
+import { useQuery } from "@tanstack/react-query";
 import {
   Navigate,
   Outlet,
@@ -10,6 +11,7 @@ import {
 } from "react-router-dom";
 
 import { FreightDashboardLayout, type SidebarItem } from "@/components/layout";
+import { api } from "@/services/api";
 import { useAuth } from "./auth/useAuth";
 import LoadingScreen from "./components/LoadingScreen";
 import LoginPage from "./pages/auth/LoginPage";
@@ -17,6 +19,7 @@ import ForgotPasswordPage from "./pages/auth/ForgotPasswordPage";
 import BookingContractPage from "./pages/bookings/BookingContractPage";
 import BookingRequestDetailPage from "./pages/bookings/BookingRequestDetailPage";
 import BookingRequestsPage from "./pages/bookings/BookingRequestsPage";
+import ConsolidationApprovalsPage from "./pages/bookings/ConsolidationApprovalsPage";
 import NewBookingPage from "./pages/bookings/NewBookingPage";
 import WagonCancellationsPage from "./pages/bookings/WagonCancellationsPage";
 import ContractRequestsPage from "./pages/contracts/ContractRequestsPage";
@@ -34,28 +37,29 @@ import DocumentClearanceDetailPage from "./pages/bookings/DocumentClearanceDetai
 import DocumentClearanceListPage from "./pages/bookings/DocumentClearanceListPage";
 import CustomerDetailPage from "./pages/customers/CustomerDetailPage";
 import CustomersPage from "./pages/customers/CustomersPage";
+import ShippingLineCompaniesPage from "./pages/shipping-lines/ShippingLineCompaniesPage";
+import ShippingLineCreditsPage from "./pages/shipping-lines/ShippingLineCreditsPage";
 import InvoiceDetailPage from "./pages/invoices/InvoiceDetailPage";
-import InvoicesPage from "./pages/invoices/InvoicesPage";
+import FinanceHubPage from "./pages/invoices/FinanceHubPage";
 import MyProfilePage from "./pages/dashboard/MyProfilePage";
 import OverviewPage from "./pages/dashboard/OverviewPage";
-import ReportsHubPage from "./pages/reports/ReportsHubPage";
+import OverviewDomainPage from "./pages/dashboard/OverviewDomainPage";
+import { OVERVIEW_DOMAINS } from "./components/overview/overview-domains.config";
+import ReportsLandingPage from "./pages/reports/ReportsLandingPage";
 import ReportPage from "./pages/reports/ReportPage";
+import AuditLogsPage from "./pages/AuditLogsPage";
 import AiBookingMockTestPage from "./pages/ai/AiBookingMockTestPage";
-import PaymentsPage from "./pages/payments/PaymentsPage";
-import AuditLogsPage from "./pages/audit/AuditLogsPage";
 //import EmployeesPage from "./pages/dashboard/user-management/EmployeesPage";
 import { RequirePermission } from "./components/auth/RequirePermission";
-import {
-  FREIGHT_PERMS,
-  isDjiboutiGl,
-  isEthiopianGl,
-  isSuperAdmin,
-} from "./lib/permissions";
+import { FREIGHT_PERMS } from "./lib/permissions";
 import { NO_ACCESS_PATH, resolveLandingPath } from "./lib/landing";
 import NoAccessPage from "./pages/NoAccessPage";
 import FileUploadSettingsPage from "./pages/documents/FileUploadSettingsPage";
 import DropdownSettingsPage from "./pages/dropdown_settings/DropdownSettingsPage";
+import CompanyStampSettingsPage from "./pages/settings/CompanyStampSettingsPage";
+import LogoSettingsPage from "./pages/settings/LogoSettingsPage";
 import ContractTemplatesPage from "./pages/contract_templates/ContractTemplatesPage";
+import PortalContentPage from "./pages/portal_content/PortalContentPage";
 import ContractTemplateEditorPage from "./pages/contract_templates/ContractTemplateEditorPage";
 import FleetResourcePage from "./pages/fleet/FleetResourcePage";
 import WagonTransfersPage from "./pages/wagons/WagonTransfersPage";
@@ -83,14 +87,13 @@ import TrainScheduleTrackPage from "./pages/trainScheduling/TrainScheduleTrackPa
 import TrainSchedulingGlobalRulesPage from "./pages/trainScheduling/TrainSchedulingGlobalRulesPage";
 import TradeAccessPage from "./pages/configuration/TradeAccessPage";
 import ExchangeRateSettingsCard from "./pages/settings/ExchangeRateSettingsCard";
-import ContractValidityPeriodsPage from "./pages/configuration/ContractValidityPeriodsPage";
+import ManualPaymentSettingsCard from "./pages/settings/ManualPaymentSettingsCard";
 import FirstMilePage from "./pages/operations/FirstMilePage";
 import LastMilePage from "./pages/operations/LastMilePage";
 import TrainDetailPage from "./pages/trains/TrainDetailPage";
 import TrainBuilderDetailPage from "./pages/trainBuilder/TrainBuilderDetailPage";
 import TrainBuilderListPage from "./pages/trainBuilder/TrainBuilderListPage";
 import ArrivalQueuePage from "./pages/warehouses/ArrivalQueuePage";
-import EDRLastMileReturnsPage from "./pages/warehouses/EDRLastMileReturnsPage";
 import ContainerReturnsPage from "./pages/warehouses/ContainerReturnsPage";
 import DispatchQueuePage from "./pages/warehouses/DispatchQueuePage";
 import ExportDjiboutiUnloadingQueuePage from "./pages/warehouses/ExportDjiboutiUnloadingQueuePage";
@@ -114,16 +117,28 @@ import FaydaCallbackPage from "./pages/FaydaCallbackPage";
 import { UserManagementRoutes } from "./user-management/route";
 import SetPassword from "./shared/components/SetPassword";
 import SupportInboxPage from "./pages/support/SupportInboxPage";
+import ChatLaunchPage from "./pages/chat/ChatLaunchPage";
 import {
   APP_TITLE,
   buildSidebarSections,
-  DJ_CLEARANCE_HREF,
-  ET_CLEARANCE_HREF,
   filterSidebarByPermission,
   findActiveSidebarLabel,
-  GL_WORKFLOW_PATH_PATTERNS,
 } from "@/components/layout/sidebar-sections";
 
+/**
+ * The per-shipment clearance detail page is the shared destination of three
+ * hubs (Operations → Clearance, Clearance Documents, Self-Clearance Review),
+ * none of which are gated on `bookings:clearance_view`. Gating the detail on
+ * that key alone bounced reviewers back to their landing page (Bookings) the
+ * moment they opened a row, so accept any key that can reach a hub.
+ */
+const CLEARANCE_DETAIL_PERMS = [
+  FREIGHT_PERMS.bookings.clearanceView,
+  FREIGHT_PERMS.contracts.clearanceReview,
+  FREIGHT_PERMS.contracts.clearanceEtActions,
+  FREIGHT_PERMS.contracts.opsClearanceReview,
+];
+
 const DashboardShell = () => {
   const navigate = useNavigate();
   const location = useLocation();
@@ -131,24 +146,22 @@ const DashboardShell = () => {
 
   const demoItems: SidebarItem[] = [];
 
+  const { data: reportCatalog } = useQuery(api.reports.catalog.queryOptions());
+  const reportItems: SidebarItem[] = useMemo(
+    () =>
+      (reportCatalog ?? []).map((report) => ({
+        label: report.title,
+        href: `/dashboard/reports/${report.key}`,
+      })),
+    [reportCatalog],
+  );
+
   const sidebarSections = filterSidebarByPermission(
-    buildSidebarSections(demoItems),
+    buildSidebarSections(demoItems, reportItems),
     user,
   );
   const displayName = user?.name?.en || user?.username || user?.email || "User";
 
-  // GL positions are locked to their single clearance page: if they navigate
-  // (or deep-link) anywhere else, send them back to their clearance hub.
-  // Super admin is exempt. Allow the clearance path + its detail sub-routes.
-  const superAdmin = isSuperAdmin(user);
-  const glClearanceHome = !superAdmin
-    ? isEthiopianGl(user)
-      ? ET_CLEARANCE_HREF
-      : isDjiboutiGl(user)
-        ? DJ_CLEARANCE_HREF
-        : null
-    : null;
-
   useEffect(() => {
     const activeLabel = findActiveSidebarLabel(
       location.pathname,
@@ -157,23 +170,11 @@ const DashboardShell = () => {
     document.title = activeLabel ? `${activeLabel} | ${APP_TITLE}` : APP_TITLE;
   }, [location.pathname, sidebarSections]);
 
-  if (
-    glClearanceHome &&
-    !location.pathname.startsWith(glClearanceHome) &&
-    !GL_WORKFLOW_PATH_PATTERNS.some((re) => re.test(location.pathname))
-  ) {
-    return <Navigate to={glClearanceHome} replace />;
-  }
-
   return (
     <FreightDashboardLayout
       sidebarSections={sidebarSections}
-      // GL Ethiopia / GL Djibouti are locked to a single clearance page — no
-      // sidebar (or mobile burger) at all; the page renders full width.
-      hideSidebar={Boolean(glClearanceHome)}
       activeHref={location.pathname}
       onNavigate={navigate}
-      enableThemeToggle
       userName={displayName}
       userEmail={user?.email}
       onLogout={logout}
@@ -215,11 +216,58 @@ const App = () => {
       {/* Landing is per-user: /dashboard/overview is gated on overview:view, so
           a fixed target strands anyone without that key on a blank page. */}
       <Route path="/" element={<Navigate to={landingPath} replace />} />
-      <Route path="/dashboard" element={<Navigate to={landingPath} replace />} />
+      <Route
+        path="/dashboard"
+        element={<Navigate to={landingPath} replace />}
+      />
       <Route path="/dashboard" element={<DashboardShell />}>
-        <Route path="overview" element={<RequirePermission permission={FREIGHT_PERMS.overview.view}><OverviewPage /></RequirePermission>} />
-        <Route path="reports" element={<RequirePermission permission={FREIGHT_PERMS.reports.view}><ReportsHubPage /></RequirePermission>} />
-        <Route path="reports/:reportKey" element={<RequirePermission permission={FREIGHT_PERMS.reports.view}><ReportPage /></RequirePermission>} />
+        <Route
+          path="overview"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.overview.view}>
+              <OverviewPage />
+            </RequirePermission>
+          }
+        />
+        {/* One drill-down route per overview domain — the old per-tab charts,
+            now each on its own page. Single source of truth for the
+            permission gate is OVERVIEW_DOMAINS, shared with the summary
+            page's "View all" links. */}
+        {OVERVIEW_DOMAINS.map((domain) => (
+          <Route
+            key={domain.key}
+            path={`overview/${domain.key}`}
+            element={
+              <RequirePermission permission={domain.permission}>
+                <OverviewDomainPage />
+              </RequirePermission>
+            }
+          />
+        ))}
+        <Route
+          path="reports"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.reports.view}>
+              <ReportsLandingPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="reports/:reportKey"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.reports.view}>
+              <ReportPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="audit-logs"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.auditLog.view}>
+              <AuditLogsPage />
+            </RequirePermission>
+          }
+        />
         {/* Dev/testing page for the mock AI booking assistant. */}
         <Route
           path="ai-booking-mock-test"
@@ -231,16 +279,36 @@ const App = () => {
         />
         <Route path="profile" element={<MyProfilePage />} />
 
-        <Route path="booking-requests" element={<RequirePermission permission={FREIGHT_PERMS.bookings.view}><BookingRequestsPage /></RequirePermission>} />
         <Route
-          path="payments"
+          path="booking-requests"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.payments.view}>
-              <PaymentsPage />
+            <RequirePermission permission={FREIGHT_PERMS.bookings.view}>
+              <BookingRequestsPage />
+            </RequirePermission>
+          }
+        />
+        {/* Payments used to be its own page; it's now the "payments" tab on
+            the merged Invoices hub. Old bookmarks/links still land there. */}
+        <Route
+          path="payments"
+          element={<Navigate to="/dashboard/invoices?tab=payments" replace />}
+        />
+        <Route
+          path="support"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.support.agentView}>
+              <SupportInboxPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="chat"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.chat.view}>
+              <ChatLaunchPage />
             </RequirePermission>
           }
         />
-        <Route path="support" element={<RequirePermission permission={FREIGHT_PERMS.support.agentView}><SupportInboxPage /></RequirePermission>} />
         <Route
           path="customers"
           element={
@@ -257,14 +325,46 @@ const App = () => {
             </RequirePermission>
           }
         />
+        {/* Merged Invoices / Payments / USD Payments hub — tabs switch via
+            ?tab=invoices|payments|manual-payments (default invoices). Access is
+            OR'd across both keys so a user with just one still gets in; each
+            tab hides itself if the user lacks the permission it used to be
+            routed on. */}
+        <Route
+          path="shipping-lines"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.shippingLines.view}>
+              <ShippingLineCompaniesPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="shipping-line-credits"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.shippingLineCredits.view}
+            >
+              <ShippingLineCreditsPage />
+            </RequirePermission>
+          }
+        />
         <Route
           path="invoices"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.invoices.view}>
-              <InvoicesPage />
+            <RequirePermission
+              permission={[
+                FREIGHT_PERMS.invoices.view,
+                FREIGHT_PERMS.payments.view,
+              ]}
+            >
+              <FinanceHubPage />
             </RequirePermission>
           }
         />
+        <Route
+          path="usd-payments"
+          element={<Navigate to="/dashboard/invoices?tab=manual-payments" replace />}
+        />
         <Route
           path="invoices/:id"
           element={
@@ -273,7 +373,14 @@ const App = () => {
             </RequirePermission>
           }
         />
-        <Route path="booking-requests/new" element={<RequirePermission permission={FREIGHT_PERMS.bookings.view}><NewBookingPage /></RequirePermission>} />
+        <Route
+          path="booking-requests/new"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.bookings.view}>
+              <NewBookingPage />
+            </RequirePermission>
+          }
+        />
         <Route
           path="wagon-cancellations"
           element={
@@ -284,6 +391,18 @@ const App = () => {
             </RequirePermission>
           }
         />
+        {/* Shared-wagon gate: consolidated pairs wait for a human decision
+            before either half reaches Operations. */}
+        <Route
+          path="consolidation-approvals"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.bookings.approveConsolidation}
+            >
+              <ConsolidationApprovalsPage />
+            </RequirePermission>
+          }
+        />
         <Route
           path="booking-requests/:id"
           element={
@@ -308,9 +427,7 @@ const App = () => {
         <Route
           path="clearance/:id"
           element={
-            <RequirePermission
-              permission={FREIGHT_PERMS.bookings.clearanceView}
-            >
+            <RequirePermission permission={CLEARANCE_DETAIL_PERMS}>
               <DocumentClearanceDetailPage />
             </RequirePermission>
           }
@@ -344,9 +461,7 @@ const App = () => {
         <Route
           path="bookings/:bookingId/clearance"
           element={
-            <RequirePermission
-              permission={FREIGHT_PERMS.bookings.clearanceView}
-            >
+            <RequirePermission permission={CLEARANCE_DETAIL_PERMS}>
               <DocumentClearanceDetailPage />
             </RequirePermission>
           }
@@ -486,26 +601,195 @@ const App = () => {
           path="bookings/:id/milestones"
           element={<BookingMilestonesRedirect />}
         />
-        <Route path="warehouses" element={<RequirePermission permission={FREIGHT_PERMS.warehouses.view}><WarehouseListPage /></RequirePermission>} />
-        <Route path="warehouses/:id" element={<RequirePermission permission={FREIGHT_PERMS.warehouses.view}><WarehouseDetailPage /></RequirePermission>} />
-        <Route path="warehouse-inventory" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><WarehouseInventoryPage /></RequirePermission>} />
-        <Route path="import-warehouse" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><ImportWarehouseFlowPage /></RequirePermission>} />
-        <Route path="export-warehouse" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><ExportWarehouseFlowPage /></RequirePermission>} />
-        <Route path="arrival-queue" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><ArrivalQueuePage /></RequirePermission>} />
-        <Route path="loading-queue" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><LoadingQueuePage /></RequirePermission>} />
-        <Route path="intercity" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><IntercityPage /></RequirePermission>} />
-        <Route path="trucks-on-site" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><TrucksOnSitePage /></RequirePermission>} />
-        <Route path="import-trucks" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><ImportTrucksPage /></RequirePermission>} />
-        <Route path="edr-last-mile-returns" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><EDRLastMileReturnsPage /></RequirePermission>} />
-        <Route path="container-returns" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><ContainerReturnsPage /></RequirePermission>} />
-        <Route path="loaded-inventory" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><LoadedInventoryPage /></RequirePermission>} />
-        <Route path="dispatch-queue" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><DispatchQueuePage /></RequirePermission>} />
-        <Route path="export-djibouti-unloading" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><ExportDjiboutiUnloadingQueuePage /></RequirePermission>} />
-        <Route path="interchange-documents" element={<RequirePermission permission={FREIGHT_PERMS.interchangeDocuments.view}><InterchangeDocumentsPage /></RequirePermission>} />
-        <Route path="inventory-inquiry" element={<RequirePermission permission={FREIGHT_PERMS.warehouseInventory.view}><InventoryInquiryPage /></RequirePermission>} />
-        <Route path="warehouse-rules" element={<RequirePermission permission={[FREIGHT_PERMS.warehouseAllocationRules.view, FREIGHT_PERMS.warehouseFeeRules.view]}><WarehouseRulesPage /></RequirePermission>} />
-        <Route path="warehouse-fee-invoices" element={<RequirePermission permission={FREIGHT_PERMS.warehouseFeeInvoices.view}><WarehouseInvoicesPage /></RequirePermission>} />
-        <Route path="warehouse-dashboard" element={<RequirePermission permission={FREIGHT_PERMS.warehouseDashboard.view}><WarehouseDashboardPage /></RequirePermission>} />
+        <Route
+          path="warehouses"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.warehouses.view}>
+              <WarehouseListPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="warehouses/:id"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.warehouses.view}>
+              <WarehouseDetailPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="warehouse-inventory"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <WarehouseInventoryPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="import-warehouse"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <ImportWarehouseFlowPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="export-warehouse"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <ExportWarehouseFlowPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="arrival-queue"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <ArrivalQueuePage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="loading-queue"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <LoadingQueuePage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="intercity"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <IntercityPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="trucks-on-site"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <TrucksOnSitePage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="import-trucks"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <ImportTrucksPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="container-returns"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <ContainerReturnsPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="loaded-inventory"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <LoadedInventoryPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="dispatch-queue"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <DispatchQueuePage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="export-djibouti-unloading"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <ExportDjiboutiUnloadingQueuePage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="interchange-documents"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.interchangeDocuments.view}
+            >
+              <InterchangeDocumentsPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="inventory-inquiry"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseInventory.view}
+            >
+              <InventoryInquiryPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="warehouse-rules"
+          element={
+            <RequirePermission
+              permission={[
+                FREIGHT_PERMS.warehouseAllocationRules.view,
+                FREIGHT_PERMS.warehouseFeeRules.view,
+              ]}
+            >
+              <WarehouseRulesPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="warehouse-fee-invoices"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseFeeInvoices.view}
+            >
+              <WarehouseInvoicesPage />
+            </RequirePermission>
+          }
+        />
+        <Route
+          path="warehouse-dashboard"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.warehouseDashboard.view}
+            >
+              <WarehouseDashboardPage />
+            </RequirePermission>
+          }
+        />
 
         <Route
           path="operations/train-scheduling"
@@ -572,9 +856,7 @@ const App = () => {
         <Route
           path="routes"
           element={
-            <RequirePermission
-              permission={[FREIGHT_PERMS.routes.view, FREIGHT_PERMS.fleet.view]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.routes.view}>
               <RoutesPage />
             </RequirePermission>
           }
@@ -582,12 +864,7 @@ const App = () => {
         <Route
           path="locomotives"
           element={
-            <RequirePermission
-              permission={[
-                FREIGHT_PERMS.locomotives.view,
-                FREIGHT_PERMS.fleet.view,
-              ]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.locomotives.view}>
               <FleetResourcePage />
             </RequirePermission>
           }
@@ -595,9 +872,7 @@ const App = () => {
         <Route
           path="trains"
           element={
-            <RequirePermission
-              permission={[FREIGHT_PERMS.trains.view, FREIGHT_PERMS.fleet.view]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.trains.view}>
               <FleetResourcePage />
             </RequirePermission>
           }
@@ -605,9 +880,7 @@ const App = () => {
         <Route
           path="trains/:id"
           element={
-            <RequirePermission
-              permission={[FREIGHT_PERMS.trains.view, FREIGHT_PERMS.fleet.view]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.trains.view}>
               <TrainDetailPage />
             </RequirePermission>
           }
@@ -615,9 +888,7 @@ const App = () => {
         <Route
           path="train-builder"
           element={
-            <RequirePermission
-              permission={[FREIGHT_PERMS.trains.view, FREIGHT_PERMS.fleet.view]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.trains.view}>
               <TrainBuilderListPage />
             </RequirePermission>
           }
@@ -625,9 +896,7 @@ const App = () => {
         <Route
           path="train-builder/:id"
           element={
-            <RequirePermission
-              permission={[FREIGHT_PERMS.trains.view, FREIGHT_PERMS.fleet.view]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.trains.view}>
               <TrainBuilderDetailPage />
             </RequirePermission>
           }
@@ -635,9 +904,7 @@ const App = () => {
         <Route
           path="wagons"
           element={
-            <RequirePermission
-              permission={[FREIGHT_PERMS.wagons.view, FREIGHT_PERMS.fleet.view]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.wagons.view}>
               <FleetResourcePage />
             </RequirePermission>
           }
@@ -658,12 +925,7 @@ const App = () => {
         <Route
           path="containers"
           element={
-            <RequirePermission
-              permission={[
-                FREIGHT_PERMS.containers.view,
-                FREIGHT_PERMS.fleet.view,
-              ]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.containers.view}>
               <FleetResourcePage />
             </RequirePermission>
           }
@@ -671,12 +933,7 @@ const App = () => {
         <Route
           path="cargoes"
           element={
-            <RequirePermission
-              permission={[
-                FREIGHT_PERMS.cargoes.view,
-                FREIGHT_PERMS.fleet.view,
-              ]}
-            >
+            <RequirePermission permission={FREIGHT_PERMS.cargoes.view}>
               <FleetResourcePage />
             </RequirePermission>
           }
@@ -764,7 +1021,7 @@ const App = () => {
         <Route
           path="compliance"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.fleet.view}>
+            <RequirePermission permission={FREIGHT_PERMS.compliance.view}>
               <CompliancePage />
             </RequirePermission>
           }
@@ -788,7 +1045,7 @@ const App = () => {
         <Route
           path="procurement"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.fleet.view}>
+            <RequirePermission permission={FREIGHT_PERMS.procurement.view}>
               <ProcurementPage />
             </RequirePermission>
           }
@@ -811,7 +1068,9 @@ const App = () => {
         <Route
           path="file-settings"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.admin}>
+            <RequirePermission
+              permission={FREIGHT_PERMS.settings.fileUpload.view}
+            >
               <FileUploadSettingsPage />
             </RequirePermission>
           }
@@ -819,23 +1078,48 @@ const App = () => {
         <Route
           path="dropdown-settings"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.admin}>
+            <RequirePermission
+              permission={FREIGHT_PERMS.settings.dropdown.view}
+            >
               <DropdownSettingsPage />
             </RequirePermission>
           }
         />
+        {/*
+          The ONE company stamp, for every generated document. The per-officer
+          teeter (ማህተም) that used to sit beside it at /dashboard/stamp-settings
+          now lives at /user-management/teeter-and-signature — it is a different
+          thing (an individual's approval stamp), and pairing the two here was
+          the duplication.
+        */}
         <Route
-          path="audit-logs"
+          path="stamp-settings"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.audit.view}>
-              <AuditLogsPage />
+            <RequirePermission permission={FREIGHT_PERMS.settings.stamp.view}>
+              <CompanyStampSettingsPage />
+            </RequirePermission>
+          }
+        />
+        {/* Old URL kept alive so existing links/bookmarks do not 404. */}
+        <Route
+          path="invoice-stamp-settings"
+          element={<Navigate to="/dashboard/stamp-settings" replace />}
+        />
+        {/* The ONE company logo, shown in the header of every generated document. */}
+        <Route
+          path="logo-settings"
+          element={
+            <RequirePermission permission={FREIGHT_PERMS.settings.logo.view}>
+              <LogoSettingsPage />
             </RequirePermission>
           }
         />
         <Route
           path="contract-templates"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.admin}>
+            <RequirePermission
+              permission={FREIGHT_PERMS.settings.contractTemplates.view}
+            >
               <ContractTemplatesPage />
             </RequirePermission>
           }
@@ -843,11 +1127,26 @@ const App = () => {
         <Route
           path="contract-templates/:code"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.admin}>
+            <RequirePermission
+              permission={FREIGHT_PERMS.settings.contractTemplates.view}
+            >
               <ContractTemplateEditorPage />
             </RequirePermission>
           }
         />
+        <Route
+          path="portal-content"
+          element={
+            <RequirePermission
+              permission={[
+                FREIGHT_PERMS.settings.supportContent.view,
+                FREIGHT_PERMS.settings.supportContent.manage,
+              ]}
+            >
+              <PortalContentPage />
+            </RequirePermission>
+          }
+        />
 
         <Route
           path="configuration"
@@ -866,15 +1165,29 @@ const App = () => {
         <Route
           path="configuration/trade-access"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.admin}>
+            <RequirePermission permission={FREIGHT_PERMS.tradeAccess.view}>
               <TradeAccessPage />
             </RequirePermission>
           }
         />
+        <Route
+          path="configuration/manual-payments"
+          element={
+            <RequirePermission
+              permission={FREIGHT_PERMS.settings.manualPayment.view}
+            >
+              <div className="p-4">
+                <ManualPaymentSettingsCard />
+              </div>
+            </RequirePermission>
+          }
+        />
         <Route
           path="configuration/exchange-rate"
           element={
-            <RequirePermission permission={FREIGHT_PERMS.admin}>
+            <RequirePermission
+              permission={FREIGHT_PERMS.settings.exchangeRate.view}
+            >
               <div className="p-4">
                 <ExchangeRateSettingsCard />
               </div>
@@ -942,4 +1255,3 @@ function LegacyGlEthiopiaClearanceRedirect() {
 }
 
 export default App;
-
diff --git a/apps/edr-freight-web/backoffice/src/complaints/services/etradeTinService.ts b/apps/edr-freight-web/backoffice/src/complaints/services/etradeTinService.ts
index 3bdc653c4..8feb7cfb8 100644
--- a/apps/edr-freight-web/backoffice/src/complaints/services/etradeTinService.ts
+++ b/apps/edr-freight-web/backoffice/src/complaints/services/etradeTinService.ts
@@ -101,7 +101,8 @@ export function mapEtradeBusinessLicenses(
     const tradeName = String(business.TradesName ?? "").trim();
     const tradeNameAmh = String(business.TradeNameAmh ?? "").trim();
     const activities = (business.SubGroups ?? [])
-      .map((group) => String(group.Description ?? "").trim())
+      // eTrade returns null entries in this array, not just a null array.
+      .map((group) => String(group?.Description ?? "").trim())
       .filter(Boolean);
 
     const displayTradeName =
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/BookingActionsMenu.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/BookingActionsMenu.tsx
index b2d260e37..5b7de12d5 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/BookingActionsMenu.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/BookingActionsMenu.tsx
@@ -1,5 +1,5 @@
 import { useNavigate } from "react-router-dom";
-import { ChevronRight, ExternalLink, MoreHorizontal } from "lucide-react";
+import { ExternalLink, MoreHorizontal } from "lucide-react";
 import { Button, Menu, ActionIcon, Group, Text } from "@mantine/core";
 
 import { BookingConfirmDialog } from "./BookingConfirmDialog";
@@ -38,6 +38,7 @@ export function BookingActionsMenu({
     reference: row.reference,
     schedulingStatus: row.schedulingStatus,
     customsClearingEnabled: row.customsClearingEnabled,
+    consolidationPartnerId: row.consolidationPartnerId,
   };
 
   const flow = useBookingActionDialog(row.id, context);
@@ -64,17 +65,9 @@ export function BookingActionsMenu({
 
   const hasMenu = listRowHasActions(row, user);
 
+  // Row click already opens the detail page — no chevron affordance needed.
   if (!hasMenu && variant === "table") {
-    return (
-      <ActionIcon
-        variant="subtle"
-        color="gray"
-        onClick={() => navigate(`/dashboard/booking-requests/${row.id}`)}
-        aria-label="View booking"
-      >
-        <ChevronRight size={16} />
-      </ActionIcon>
-    );
+    return null;
   }
 
   // Toolbar: lay every action out as a button row.
@@ -100,7 +93,13 @@ export function BookingActionsMenu({
             );
           })}
         </Group>
-        <ActionDialog flow={flow} pendingAction={pendingAction} onSuppressRowClick={onSuppressRowClick} />
+        <ActionDialog
+          flow={flow}
+          pendingAction={pendingAction}
+          onSuppressRowClick={onSuppressRowClick}
+          consolidationPartnerId={row.consolidationPartnerId}
+          consolidationPartnerReference={row.consolidationPartnerReference}
+        />
       </>
     );
   }
@@ -157,7 +156,13 @@ export function BookingActionsMenu({
         </Menu.Dropdown>
       </Menu>
 
-      <ActionDialog flow={flow} pendingAction={pendingAction} onSuppressRowClick={onSuppressRowClick} />
+      <ActionDialog
+          flow={flow}
+          pendingAction={pendingAction}
+          onSuppressRowClick={onSuppressRowClick}
+          consolidationPartnerId={row.consolidationPartnerId}
+          consolidationPartnerReference={row.consolidationPartnerReference}
+        />
     </Group>
   );
 }
@@ -166,10 +171,14 @@ function ActionDialog({
   flow,
   pendingAction,
   onSuppressRowClick,
+  consolidationPartnerId,
+  consolidationPartnerReference,
 }: {
   flow: ReturnType<typeof useBookingActionDialog>;
   pendingAction: ReturnType<typeof useBookingActionDialog>["pendingAction"];
   onSuppressRowClick?: () => void;
+  consolidationPartnerId?: string | null;
+  consolidationPartnerReference?: string | null;
 }) {
   return (
     <BookingConfirmDialog
@@ -190,6 +199,17 @@ function ActionDialog({
       }}
       isPending={flow.mutations.isPending || flow.detailLoading}
       confirmDisabled={flow.confirmDisabled}
+      // Only the four pairable decisions land on both halves; the rest stay
+      // per booking, so the warning must not appear for them.
+      pairedWithReference={
+        consolidationPartnerId &&
+        pendingAction &&
+        ["accept", "cancel", "operationAccept", "requestChanges"].includes(
+          pendingAction.id,
+        )
+          ? (consolidationPartnerReference ?? "its wagon partner")
+          : null
+      }
     />
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/BookingConfirmDialog.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/BookingConfirmDialog.tsx
index 6b8e4b650..246704aca 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/BookingConfirmDialog.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/BookingConfirmDialog.tsx
@@ -1,5 +1,7 @@
 import type { ReactNode } from "react";
+import { Link2 } from "lucide-react";
 import {
+  Alert,
   Modal,
   Group,
   Stack,
@@ -37,6 +39,12 @@ interface BookingConfirmDialogProps {
   isPending: boolean;
   confirmDisabled?: boolean;
   extra?: ReactNode;
+  /**
+   * Reference of the booking sharing this one's wagon. When set, the dialog
+   * warns that the decision lands on BOTH bookings — staff must not think they
+   * are acting on one.
+   */
+  pairedWithReference?: string | null;
 }
 
 export function BookingConfirmDialog({
@@ -52,6 +60,7 @@ export function BookingConfirmDialog({
   isPending,
   confirmDisabled = false,
   extra,
+  pairedWithReference = null,
 }: BookingConfirmDialogProps) {
   if (!action || !action.confirmTitle) return null;
 
@@ -125,6 +134,21 @@ export function BookingConfirmDialog({
             {action.confirmDescription}
           </Text>
         )}
+        {pairedWithReference && (
+          <Alert
+            color="blue"
+            variant="light"
+            radius="md"
+            mt="sm"
+            icon={<Link2 size={16} />}
+          >
+            <Text size="sm">
+              This applies to <strong>{pairedWithReference}</strong> as well —
+              the two bookings share a wagon and are decided together. If either
+              fails, neither changes.
+            </Text>
+          </Alert>
+        )}
       </Box>
 
       {/* Body */}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/BookingPricingSummary.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/BookingPricingSummary.tsx
index 6c5dd9b07..814fb9a95 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/BookingPricingSummary.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/BookingPricingSummary.tsx
@@ -19,7 +19,10 @@ export function BookingPricingSummary({ booking }: { booking: BookingDetail }) {
   const lineItems = booking.pricingBreakdown?.lineItems ?? [];
 
   const fmt = (n: number) =>
-    `${booking.paymentCurrency} ${n.toLocaleString(undefined, { minimumFractionDigits: 2 })}`;
+    `${booking.paymentCurrency} ${n.toLocaleString(undefined, {
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2,
+    })}`;
 
   return (
     <SectionCard icon={Banknote} title="Pricing & payment">
@@ -74,7 +77,11 @@ export function BookingPricingSummary({ booking }: { booking: BookingDetail }) {
                     {li.description}
                   </Text>
                   <Text size="sm" fw={600} style={{ fontVariantNumeric: "tabular-nums" }}>
-                    {Number(li.amount).toLocaleString()} {li.currency}
+                    {Number(li.amount).toLocaleString(undefined, {
+                      minimumFractionDigits: 2,
+                      maximumFractionDigits: 2,
+                    })}{" "}
+                    {li.currency}
                   </Text>
                 </Group>
               ))}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/BookingStatusBadge.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/BookingStatusBadge.tsx
index 7d1fff022..fa21d0d9f 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/BookingStatusBadge.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/BookingStatusBadge.tsx
@@ -1,6 +1,7 @@
 import { Badge, Group } from "@mantine/core";
 import { Link2 } from "lucide-react";
 import { BOOKING_STATUS_STYLES } from "@/features/bookings/booking-status.config";
+import { humanize } from "@/lib/format";
 
 const statusColorMap: Record<string, string> = {
   DRAFT: "gray",
@@ -40,7 +41,7 @@ export function BookingStatusBadge({
   partnerReference,
 }: BookingStatusBadgeProps) {
   const style = BOOKING_STATUS_STYLES[status] ?? {
-    label: status,
+    label: humanize(status),
     color: "gray",
   };
   const color = statusColorMap[status] ?? "gray";
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCargoCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCargoCard.tsx
index ecd903128..dc7286b5c 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCargoCard.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCargoCard.tsx
@@ -1,5 +1,5 @@
 import { Package } from "lucide-react";
-import { SimpleGrid, Divider, Box, Table, Text } from "@mantine/core";
+import { SimpleGrid, Divider, Box, Group, Table, Text, Badge } from "@mantine/core";
 
 import type { BookingDetail } from "@/types/booking";
 import { cargoTonsAndItems } from "@/utils/cargoWeight";
@@ -16,22 +16,82 @@ export function BookingCargoCard({ booking }: BookingCargoCardProps) {
   const containers = booking.bookingContainers ?? [];
   const { tons, items } = cargoTonsAndItems(booking);
 
+  // Booking-level flags OR any container line carrying a count — the flag can
+  // lag the lines (per-line opt-ins), so either alone must light the tile.
+  const isHazardous =
+    booking.isHazardous ||
+    containers.some((c) => Number(c.hazardousQuantity ?? 0) > 0);
+  const isReefer =
+    booking.isReefer ||
+    containers.some((c) => Number(c.reeferQuantity ?? 0) > 0);
+  const showHandlingColumns = containers.some(
+    (c) =>
+      Number(c.hazardousQuantity ?? 0) > 0 || Number(c.reeferQuantity ?? 0) > 0,
+  );
+
+  const isBulk = booking.freightType === "BULK";
+  // Bulk: the commodity itself (Wheat, Steel…) is the headline. Containers:
+  // the freight kind, with the shipper's own description alongside.
+  const cargoHeadline = isBulk
+    ? (booking.cargoType?.label ?? booking.cargoType?.name ?? "Bulk cargo")
+    : "Containers";
+  const cargoDescription = booking.cargoFreeText?.trim() || null;
+
   return (
     <SectionCard icon={Package} title="Cargo specifications" accent="orange">
+      <Group gap="sm" align="center" mb="md" wrap="wrap">
+        <Text fw={800} fz={22} lh={1.1}>
+          {cargoHeadline}
+        </Text>
+        <Badge variant="light" color={isBulk ? "orange" : "blue"} radius="sm">
+          {isBulk ? "Bulk" : "Container"}
+        </Badge>
+        {cargoDescription ? (
+          <Text size="sm" c="dimmed">
+            — {cargoDescription}
+          </Text>
+        ) : null}
+      </Group>
       <SimpleGrid cols={{ base: 1, sm: 3 }} spacing="sm">
         <MetricTile
-          label="Cargo type"
-          value={booking.cargoType?.label ?? booking.freightType}
+          label={isBulk ? "Commodity" : "Cargo type"}
+          value={
+            isBulk
+              ? (booking.cargoType?.label ?? booking.cargoType?.name ?? "—")
+              : (cargoDescription ?? booking.freightType)
+          }
         />
         <MetricTile label="Total VGM" value={`${tons} tons`} />
         {items != null && <MetricTile label="Items" value={`${items}`} />}
         <MetricTile
           label="Hazardous"
-          value={booking.isHazardous ? "Yes" : "No"}
-          highlight={booking.isHazardous}
+          value={isHazardous ? "Yes" : "No"}
+          highlight={isHazardous}
+        />
+        <MetricTile
+          label="Refrigerated"
+          value={isReefer ? "Yes" : "No"}
+          highlight={isReefer}
         />
       </SimpleGrid>
 
+      {/* Handling that changes how the yard treats the shipment is flagged
+          loudly, not buried in the grid. */}
+      {(isHazardous || isReefer) && (
+        <Box mt="sm">
+          {isHazardous && (
+            <Badge color="red" variant="filled" radius="sm" mr={8}>
+              Hazardous cargo
+            </Badge>
+          )}
+          {isReefer && (
+            <Badge color="blue" variant="filled" radius="sm">
+              Refrigerated cargo
+            </Badge>
+          )}
+        </Box>
+      )}
+
       {containers.length > 0 && (
         <>
           <Divider my="lg" color="var(--mantine-color-gray-2)" />
@@ -42,6 +102,8 @@ export function BookingCargoCard({ booking }: BookingCargoCardProps) {
                   <Table.Th>Container type</Table.Th>
                   <Table.Th>Qty</Table.Th>
                   <Table.Th>VGM / unit</Table.Th>
+                  {showHandlingColumns && <Table.Th>Hazardous</Table.Th>}
+                  {showHandlingColumns && <Table.Th>Reefer</Table.Th>}
                 </Table.Tr>
               </Table.Thead>
               <Table.Tbody>
@@ -54,6 +116,28 @@ export function BookingCargoCard({ booking }: BookingCargoCardProps) {
                     </Table.Td>
                     <Table.Td>{c.quantity}</Table.Td>
                     <Table.Td>{c.vgmPerUnitTons} t</Table.Td>
+                    {showHandlingColumns && (
+                      <Table.Td>
+                        {Number(c.hazardousQuantity ?? 0) > 0 ? (
+                          <Text fw={700} c="red" size="sm">
+                            {c.hazardousQuantity}
+                          </Text>
+                        ) : (
+                          "—"
+                        )}
+                      </Table.Td>
+                    )}
+                    {showHandlingColumns && (
+                      <Table.Td>
+                        {Number(c.reeferQuantity ?? 0) > 0 ? (
+                          <Text fw={700} c="blue" size="sm">
+                            {c.reeferQuantity}
+                          </Text>
+                        ) : (
+                          "—"
+                        )}
+                      </Table.Td>
+                    )}
                   </Table.Tr>
                 ))}
               </Table.Tbody>
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCompanyCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCompanyCard.tsx
index 06fafc099..92df02ab6 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCompanyCard.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingCompanyCard.tsx
@@ -1,44 +1,16 @@
-import type { LucideIcon } from "lucide-react";
-import {
-  Building2,
-  FileCheck,
-  Mail,
-  MapPin,
-  Phone,
-  User,
-} from "lucide-react";
-import { Group, Stack, Text, Divider } from "@mantine/core";
+import { Building2, FileCheck, Mail, MapPin, Phone, User } from "lucide-react";
+import { Text } from "@mantine/core";
 
 import type { BookingDetail } from "@/types/booking";
+import { LinkedEntityCard } from "@/components/detail";
+import type { FieldRowProps } from "@/components/detail";
 import { SectionCard } from "./SectionCard";
 
-interface InfoRowProps {
-  icon: LucideIcon;
-  label: string;
-  value?: string | null;
-}
-
-function InfoRow({ icon: Icon, label, value }: InfoRowProps) {
-  return (
-    <Group justify="space-between" wrap="nowrap" py={6} gap="md">
-      <Group gap="xs" wrap="nowrap">
-        <Icon size={15} color="var(--mantine-color-gray-5)" />
-        <Text size="sm" c="dimmed">
-          {label}
-        </Text>
-      </Group>
-      <Text size="sm" fw={600} ta="right" style={{ minWidth: 0 }} truncate>
-        {value || "—"}
-      </Text>
-    </Group>
-  );
-}
-
 export interface BookingCompanyCardProps {
   booking: BookingDetail;
 }
 
-/** Customer (company) information for the booking. */
+/** Customer (company) quick info for the booking, linking to its detail page. */
 export function BookingCompanyCard({ booking }: BookingCompanyCardProps) {
   const company = booking.company;
 
@@ -46,11 +18,9 @@ export function BookingCompanyCard({ booking }: BookingCompanyCardProps) {
   if (!company && booking.isGovernment) {
     return (
       <SectionCard icon={Building2} title="Customer" accent="blue">
-        <InfoRow
-          icon={Building2}
-          label="Government"
-          value={booking.governmentInstitution}
-        />
+        <Text size="sm" fw={600}>
+          {booking.governmentInstitution ?? "Government"}
+        </Text>
       </SectionCard>
     );
   }
@@ -67,36 +37,24 @@ export function BookingCompanyCard({ booking }: BookingCompanyCardProps) {
 
   const companyName = company.companyName ?? company.name ?? company.label;
 
-  const rows: InfoRowProps[] = [
+  const rows: FieldRowProps[] = [
     { icon: FileCheck, label: "TIN", value: company.tin },
     { icon: Mail, label: "Email", value: company.email },
     { icon: Phone, label: "Phone", value: company.phone },
     { icon: MapPin, label: "Address", value: company.address },
     { icon: User, label: "Contact person", value: company.contactPersonName },
     { icon: Phone, label: "Contact phone", value: company.contactPersonPhone },
-  ].filter((r) => r.value);
+  ];
 
   return (
-    <SectionCard
+    <LinkedEntityCard
       icon={Building2}
       title="Customer"
-      subtitle={companyName}
+      name={companyName ?? "Unnamed company"}
+      to={company.id ? `/dashboard/customers/${company.id}` : null}
       accent="blue"
-    >
-      <Stack gap={0}>
-        {rows.length === 0 ? (
-          <Text size="sm" c="dimmed">
-            No additional company details available.
-          </Text>
-        ) : (
-          rows.map((row, index) => (
-            <div key={row.label}>
-              {index > 0 && <Divider color="var(--mantine-color-gray-2)" />}
-              <InfoRow {...row} />
-            </div>
-          ))
-        )}
-      </Stack>
-    </SectionCard>
+      rows={rows}
+      emptyMessage="No additional company details available."
+    />
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingContractCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingContractCard.tsx
new file mode 100644
index 000000000..f5fc3bf2a
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingContractCard.tsx
@@ -0,0 +1,49 @@
+import { Anchor as AnchorIcon } from "lucide-react";
+import { Code } from "@mantine/core";
+
+import type { BookingDetail } from "@/types/booking";
+import { LinkedEntityCard } from "@/components/detail";
+import type { FieldRowProps } from "@/components/detail";
+
+export interface BookingContractCardProps {
+  booking: BookingDetail;
+}
+
+/** Parent contract quick info for the booking, linking to its detail page. */
+export function BookingContractCard({ booking }: BookingContractCardProps) {
+  if (!booking.contractId || !booking.contractReference) return null;
+
+  const rows: FieldRowProps[] = [
+    {
+      label: "Kind",
+      value: booking.contractKind === "GENERAL" ? "General" : "One-time",
+    },
+  ];
+
+  return (
+    <LinkedEntityCard
+      icon={AnchorIcon}
+      title="Contract"
+      name={booking.contractReference}
+      to={`/dashboard/contract-requests/${booking.contractId}`}
+      accent="teal"
+      rows={rows}
+      footer={
+        booking.contractSummary ? (
+          <Code
+            block
+            mt={4}
+            style={{
+              maxHeight: 220,
+              overflow: "auto",
+              whiteSpace: "pre-wrap",
+              background: "var(--mantine-color-gray-0)",
+            }}
+          >
+            {booking.contractSummary}
+          </Code>
+        ) : undefined
+      }
+    />
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingContractSummaryCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingContractSummaryCard.tsx
deleted file mode 100644
index 1e86a7d2a..000000000
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingContractSummaryCard.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Anchor } from "lucide-react";
-import { Code } from "@mantine/core";
-
-import { SectionCard } from "./SectionCard";
-
-export interface BookingContractSummaryCardProps {
-  summary: string;
-}
-
-/** Generated contract terms, shown verbatim. */
-export function BookingContractSummaryCard({ summary }: BookingContractSummaryCardProps) {
-  return (
-    <SectionCard icon={Anchor} title="Contract summary" accent="teal">
-      <Code
-        block
-        style={{
-          maxHeight: 256,
-          overflow: "auto",
-          whiteSpace: "pre-wrap",
-          background: "var(--mantine-color-gray-0)",
-        }}
-      >
-        {summary}
-      </Code>
-    </SectionCard>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingMileServicesCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingMileServicesCard.tsx
index 3236e5cae..d3bee348d 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingMileServicesCard.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingMileServicesCard.tsx
@@ -1,6 +1,10 @@
-import { Truck } from "lucide-react";
-import { SimpleGrid } from "@mantine/core";
+import type { ReactNode } from "react";
+import { Download, Truck } from "lucide-react";
+import { Button, Group, SimpleGrid, Stack, Text } from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
 
+import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
+import { lastMileRequestsService } from "@/services/last-mile-requests.service";
 import type { BookingDetail } from "@/types/booking";
 
 import { SectionCard } from "./SectionCard";
@@ -8,24 +12,92 @@ import { MetricTile } from "./MetricTile";
 
 export interface BookingMileServicesCardProps {
   booking: BookingDetail;
+  /** Export handover-mode control — how the cargo reaches the train. Lives
+   * here because it's the other "how does the cargo physically travel" fact;
+   * shown even when no mile address is set, since EXPORT bookings still need
+   * the choice made. */
+  handoverSection?: ReactNode;
 }
 
-/** First / last mile addresses. Renders nothing when neither is present. */
-export function BookingMileServicesCard({ booking }: BookingMileServicesCardProps) {
-  if (!booking.firstMilePickupAddress && !booking.lastMileDeliveryAddress) {
+/**
+ * First / last mile addresses, plus the export handover control and the
+ * stored last-mile contract reference (signed status + PDF download) for
+ * Truck & Machinery once a request on this booking is approved. Renders
+ * nothing when none of the three are present.
+ */
+export function BookingMileServicesCard({
+  booking,
+  handoverSection,
+}: BookingMileServicesCardProps) {
+  const hasAddresses =
+    Boolean(booking.firstMilePickupAddress) || Boolean(booking.lastMileDeliveryAddress);
+
+  const { data: requestsResponse } = useQuery({
+    queryKey: QUERY_KEYS.LAST_MILE_REQUESTS.list({ bookingId: booking.id }),
+    queryFn: async () =>
+      (await lastMileRequestsService.list({ bookingId: booking.id })).data,
+    enabled: Boolean(booking.lastMileDeliveryAddress),
+  });
+  const approvedRequest = (requestsResponse?.data ?? []).find(
+    (r) => r.status === "APPROVED",
+  );
+
+  if (!hasAddresses && !handoverSection) {
     return null;
   }
 
+  const downloadContract = async () => {
+    if (!approvedRequest) return;
+    const blob = (await lastMileRequestsService.contractDocument(approvedRequest.id)).data;
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = `last-mile-contract-${booking.reference ?? booking.id}.pdf`;
+    a.click();
+    URL.revokeObjectURL(url);
+  };
+
   return (
     <SectionCard icon={Truck} title="Mile services" accent="grape">
-      <SimpleGrid cols={{ base: 1, md: 2 }} spacing="sm">
-        {booking.firstMilePickupAddress && (
-          <MetricTile label="First mile pickup" value={booking.firstMilePickupAddress} />
+      <Stack gap="md">
+        {hasAddresses && (
+          <SimpleGrid cols={{ base: 1, md: 2 }} spacing="sm">
+            {booking.firstMilePickupAddress && (
+              <MetricTile label="First mile pickup" value={booking.firstMilePickupAddress} />
+            )}
+            {booking.lastMileDeliveryAddress && (
+              <MetricTile label="Last mile delivery" value={booking.lastMileDeliveryAddress} />
+            )}
+          </SimpleGrid>
         )}
-        {booking.lastMileDeliveryAddress && (
-          <MetricTile label="Last mile delivery" value={booking.lastMileDeliveryAddress} />
+        {approvedRequest && (
+          <Group justify="space-between" align="center" wrap="wrap">
+            <Stack gap={0}>
+              <Text size="sm" fw={600}>
+                Last-mile contract
+              </Text>
+              <Text size="xs" c={approvedRequest.customerSignedAt ? "green.8" : "orange.8"}>
+                {approvedRequest.customerSignedAt
+                  ? `Signed ${new Date(approvedRequest.customerSignedAt).toLocaleDateString()}${
+                      approvedRequest.signerDisplayName
+                        ? ` by ${approvedRequest.signerDisplayName}`
+                        : ""
+                    }`
+                  : "Awaiting customer signature"}
+              </Text>
+            </Stack>
+            <Button
+              size="xs"
+              variant="light"
+              leftSection={<Download size={14} />}
+              onClick={() => void downloadContract()}
+            >
+              Download PDF
+            </Button>
+          </Group>
         )}
-      </SimpleGrid>
+        {handoverSection}
+      </Stack>
     </SectionCard>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingRequestHero.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingRequestHero.tsx
deleted file mode 100644
index ed9802150..000000000
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingRequestHero.tsx
+++ /dev/null
@@ -1,258 +0,0 @@
-import type { ReactNode } from "react";
-import {
-  ArrowLeft,
-  Building2,
-  Calendar,
-  Clock,
-  Container as ContainerIcon,
-  Flame,
-  RefreshCw,
-  Wallet,
-  Weight,
-} from "lucide-react";
-import {
-  Button,
-  Group,
-  Paper,
-  Stack,
-  Text,
-  ThemeIcon,
-  Title,
-} from "@mantine/core";
-import type { LucideIcon } from "lucide-react";
-
-import type { BookingDetail } from "@/types/booking";
-import { cargoTonsAndItems } from "@/utils/cargoWeight";
-import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
-import { BookingPriorityBadge } from "@/components/bookings/BookingPriorityBadge";
-import { ContractReferenceLink } from "@/components/bookings/ContractReferenceLink";
-import { SchedulingStatusBadge } from "@/components/trainScheduling/ScheduleStatusBadge";
-import { NextStepBanner } from "@/components/bookings/NextStepBanner";
-
-import { formatDate } from "./booking-detail.styles";
-
-export interface BookingRequestHeroProps {
-  booking: BookingDetail;
-  customerLabel: string;
-  onBack: () => void;
-  onRefresh: () => void;
-  isFetching?: boolean;
-}
-
-/** Top hero for the request detail page: identity, status, next step, key figures. */
-export function BookingRequestHero({
-  booking,
-  customerLabel,
-  onBack,
-  onRefresh,
-  isFetching,
-}: BookingRequestHeroProps) {
-  const amount = Number(booking.totalAmount);
-  const containers = booking.bookingContainers ?? [];
-  const containerCount = containers.reduce(
-    (sum, c) => sum + Number(c.quantity ?? 0),
-    0,
-  );
-  const { tons: weight, items: itemCount } = cargoTonsAndItems(booking);
-
-  return (
-    <Paper
-      radius="xl"
-      p="xl"
-      style={{ position: "relative", overflow: "hidden" }}
-    >
-      <Stack gap="lg" style={{ position: "relative" }}>
-        <Group justify="space-between" align="flex-start" wrap="wrap">
-          <Button
-            variant="default"
-            size="compact-sm"
-            radius="lg"
-            leftSection={<ArrowLeft size={16} />}
-            onClick={onBack}
-          >
-            Back to list
-          </Button>
-          <Button
-            variant="light"
-            color="edr-green"
-            size="compact-sm"
-            radius="lg"
-            leftSection={<RefreshCw size={15} />}
-            loading={isFetching}
-            onClick={onRefresh}
-          >
-            Refresh
-          </Button>
-        </Group>
-
-        <Group justify="space-between" align="flex-start" wrap="wrap" gap="lg">
-          <Stack gap="sm" style={{ flex: 1, minWidth: 0 }}>
-            <Text
-              size="xs"
-              fw={700}
-              tt="uppercase"
-              style={{ letterSpacing: 1, color: "#B26C09" }}
-            >
-              Booking reference
-            </Text>
-            <Group gap="sm" align="center" wrap="wrap">
-              <Stack gap={2} miw={0}>
-                <Title order={2} fw={700} style={{ letterSpacing: "-0.4px" }}>
-                  {booking.reference}
-                </Title>
-                <ContractReferenceLink
-                  contractId={booking.contractId}
-                  contractReference={booking.contractReference}
-                />
-              </Stack>
-              <BookingStatusBadge status={booking.status} />
-              <BookingPriorityBadge score={booking.priorityScore} />
-              {booking.schedulingStatus ? (
-                <SchedulingStatusBadge status={booking.schedulingStatus} />
-              ) : null}
-            </Group>
-
-            {booking.holdExpiresAt && booking.schedulingStatus === "HOLDING" ? (
-              <Text size="xs" c="orange.7">
-                Hold expires {new Date(booking.holdExpiresAt).toLocaleString()}
-              </Text>
-            ) : null}
-
-            <Group gap="lg" mt={4}>
-              <MetaItem icon={Building2} text={customerLabel} strong />
-              <MetaItem
-                icon={Calendar}
-                text={`Scheduled ${booking.scheduledDate}`}
-              />
-              <MetaItem
-                icon={Clock}
-                text={`Created ${formatDate(booking.createdAt)}`}
-              />
-            </Group>
-          </Stack>
-        </Group>
-
-        {booking.nextStep ? (
-          <Paper
-            radius="lg"
-            p={4}
-            maw={640}
-            style={{
-              background: "var(--mantine-color-gray-0)",
-              border: "1px solid var(--mantine-color-gray-2)",
-            }}
-          >
-            <NextStepBanner nextStep={booking.nextStep} />
-          </Paper>
-        ) : null}
-
-        <Group grow gap="md" align="stretch" wrap="wrap">
-          <HeroTile
-            icon={Wallet}
-            label="Total value"
-            value={`${booking.paymentCurrency} ${amount.toLocaleString(
-              undefined,
-              {
-                minimumFractionDigits: 2,
-              },
-            )}`}
-            hint={booking.paymentStatus}
-            accent="edr-green"
-          />
-          <HeroTile
-            icon={Weight}
-            label="Cargo weight"
-            value={`${weight} T`}
-            hint={itemCount != null ? `${itemCount} items` : "VGM total"}
-            accent="blue"
-          />
-          <HeroTile
-            icon={ContainerIcon}
-            label="Containers"
-            value={containerCount || "—"}
-            hint={`${containers.length} line${containers.length === 1 ? "" : "s"}`}
-            accent="teal"
-          />
-          <HeroTile
-            icon={Flame}
-            label="Priority score"
-            value={booking.priorityScore ?? 0}
-            hint={booking.tradeDirection}
-            accent="orange"
-          />
-        </Group>
-      </Stack>
-    </Paper>
-  );
-}
-
-function MetaItem({
-  icon: Icon,
-  text,
-  strong,
-}: {
-  icon: LucideIcon;
-  text: ReactNode;
-  strong?: boolean;
-}) {
-  return (
-    <Group gap={6} wrap="nowrap">
-      <Icon size={14} color="var(--mantine-color-gray-5)" />
-      <Text size="sm" fw={strong ? 600 : 400} c={strong ? "dark" : "dimmed"}>
-        {text}
-      </Text>
-    </Group>
-  );
-}
-
-function HeroTile({
-  icon: Icon,
-  label,
-  value,
-  hint,
-  accent = "edr-green",
-}: {
-  icon: LucideIcon;
-  label: string;
-  value: ReactNode;
-  hint?: ReactNode;
-  accent?: string;
-}) {
-  return (
-    <Paper
-      p="md"
-      radius="lg"
-      style={{
-        flex: "1 1 160px",
-        minWidth: 150,
-        background: "var(--mantine-color-gray-0)",
-        border: "1px solid var(--mantine-color-gray-2)",
-      }}
-    >
-      <Group gap="sm" wrap="nowrap" align="flex-start">
-        <ThemeIcon size={36} radius="md" variant="light" color={accent}>
-          <Icon size={18} />
-        </ThemeIcon>
-        <Stack gap={2} style={{ minWidth: 0 }}>
-          <Text
-            size="xs"
-            fw={600}
-            tt="uppercase"
-            c="dimmed"
-            style={{ letterSpacing: 0.4 }}
-          >
-            {label}
-          </Text>
-          <Text fw={700} size="lg" lh={1.1} style={{ whiteSpace: "nowrap" }}>
-            {value}
-          </Text>
-          {hint ? (
-            <Text size="xs" c="dimmed" truncate>
-              {hint}
-            </Text>
-          ) : null}
-        </Stack>
-      </Group>
-    </Paper>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingSchedulingWindowCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingSchedulingWindowCard.tsx
new file mode 100644
index 000000000..7f5a4af23
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingSchedulingWindowCard.tsx
@@ -0,0 +1,286 @@
+import { useEffect, useState } from "react";
+import { Badge, Box, Group, Stack, Text } from "@mantine/core";
+import { CalendarClock } from "lucide-react";
+
+import type { BookingDetail } from "@/types/booking";
+import { SchedulingStatusBadge } from "@/components/trainScheduling/ScheduleStatusBadge";
+
+import { SectionCard } from "./SectionCard";
+
+export interface BookingSchedulingWindowCardProps {
+  booking: BookingDetail;
+}
+
+/** Full date + time — staff read these against the operating clock, so no time is dropped. */
+function formatStamp(iso: string | null | undefined): string | null {
+  if (!iso) return null;
+  const ms = new Date(iso).getTime();
+  if (!Number.isFinite(ms)) return null;
+  return new Date(ms).toLocaleString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+/** "in 2h 14m" / "12m ago" — the at-a-glance read next to an absolute stamp. */
+function formatRelative(iso: string, nowMs: number): string {
+  const diff = new Date(iso).getTime() - nowMs;
+  const past = diff < 0;
+  const totalMinutes = Math.floor(Math.abs(diff) / 60_000);
+  const days = Math.floor(totalMinutes / 1440);
+  const hours = Math.floor((totalMinutes % 1440) / 60);
+  const minutes = totalMinutes % 60;
+
+  const parts: string[] = [];
+  if (days) parts.push(`${days}d`);
+  if (hours) parts.push(`${hours}h`);
+  // Keep minutes when they're the only unit, so sub-hour gaps never read "0".
+  if (minutes || parts.length === 0) parts.push(`${minutes}m`);
+
+  const span = parts.slice(0, 2).join(" ");
+  return past ? `${span} ago` : `in ${span}`;
+}
+
+/**
+ * Length of a window as "1h 30m" / "45m". Null unless both ends are real and
+ * ordered — the pay window is configurable per schedule, so this is read off the
+ * actual stamps rather than assuming any fixed duration.
+ */
+function formatDuration(
+  from: string | null | undefined,
+  to: string | null | undefined,
+): string | null {
+  if (!from || !to) return null;
+  const fromMs = new Date(from).getTime();
+  const toMs = new Date(to).getTime();
+  if (!Number.isFinite(fromMs) || !Number.isFinite(toMs)) return null;
+  const minutes = Math.round((toMs - fromMs) / 60_000);
+  if (minutes <= 0) return null;
+  const hours = Math.floor(minutes / 60);
+  const rest = minutes % 60;
+  if (!hours) return `${rest}m`;
+  return rest ? `${hours}h ${rest}m` : `${hours}h`;
+}
+
+function Row({
+  label,
+  value,
+  hint,
+  tone,
+}: {
+  label: string;
+  value: string;
+  hint?: string | null;
+  tone?: "muted" | "warning" | "danger";
+}) {
+  const valueColor =
+    tone === "danger" ? "red.7" : tone === "warning" ? "orange.7" : "dark";
+  return (
+    <Group justify="space-between" align="flex-start" wrap="nowrap" gap="md">
+      <Text size="sm" c="dimmed" style={{ flexShrink: 0 }}>
+        {label}
+      </Text>
+      <Box style={{ textAlign: "right", minWidth: 0 }}>
+        <Text size="sm" fw={600} c={valueColor}>
+          {value}
+        </Text>
+        {hint ? (
+          <Text size="xs" c="dimmed">
+            {hint}
+          </Text>
+        ) : null}
+      </Box>
+    </Group>
+  );
+}
+
+/**
+ * Backoffice-only staff view of the scheduling clock: which batch/train the
+ * booking is scheduled for, when its pay window closes, and the train's
+ * planned vs actual departure/arrival (i.e. when the run actually ended).
+ */
+export function BookingSchedulingWindowCard({
+  booking,
+}: BookingSchedulingWindowCardProps) {
+  const schedule = booking.trainScheduleSummary ?? null;
+
+  // The pay-window end staff should quote is the drain end (a payment landing
+  // inside the drain still counts); fall back to the raw deadline if the API
+  // predates that field.
+  const payWindowEndsAt = booking.paymentDrainEndsAt ?? booking.paymentDeadline ?? null;
+
+  // One shared ticking clock so every relative label in the card stays in sync.
+  const [nowMs, setNowMs] = useState(() => Date.now());
+  useEffect(() => {
+    const interval = setInterval(() => setNowMs(Date.now()), 30_000);
+    return () => clearInterval(interval);
+  }, []);
+
+  // How long the customer actually had to pay: start → the raw deadline, NOT the
+  // drain end (the drain is settlement grace, not payable time).
+  const windowDuration = formatDuration(
+    booking.selectedForBatchAt,
+    booking.paymentDeadline,
+  );
+
+  const hasAnything =
+    Boolean(schedule) ||
+    Boolean(payWindowEndsAt) ||
+    Boolean(booking.selectedForBatchAt) ||
+    Boolean(booking.holdExpiresAt);
+  if (!hasAnything) return null;
+
+  const payWindowClosed = payWindowEndsAt
+    ? new Date(payWindowEndsAt).getTime() <= nowMs
+    : false;
+
+  const trainLabel =
+    schedule?.trainNumber ??
+    schedule?.reference ??
+    (schedule ? "Assigned train" : null);
+
+  // Before the batch engine allocates, the only train on the booking is the one
+  // the customer picked at day-commit — staff review that during Operation
+  // Review, so it is labelled as a request, not as a confirmed allocation.
+  const isRequested = schedule?.isRequested === true;
+  const trainRowLabel = isRequested ? "Requested train" : "Scheduled on train";
+
+  // A train that has already left (or is past its planned departure) can no
+  // longer carry this booking, so accepting onto it would be wrong. Called out
+  // here because this card sits above the staff-actions toolbar.
+  const departureIso =
+    schedule?.actualDepartureAt ?? schedule?.scheduledDepartureDate ?? null;
+  const hasDeparted = schedule?.actualDepartureAt
+    ? true
+    : departureIso !== null && new Date(departureIso).getTime() <= nowMs;
+
+  return (
+    <SectionCard
+      icon={CalendarClock}
+      title="Scheduling & payment window"
+      subtitle="Staff view — batch allocation and the operating clock"
+      accent="indigo"
+      extra={<SchedulingStatusBadge status={booking.schedulingStatus} />}
+    >
+      <Stack gap="sm">
+        {trainLabel ? (
+          <Row
+            label={trainRowLabel}
+            value={trainLabel}
+            hint={
+              schedule?.reference && schedule.reference !== trainLabel
+                ? schedule.reference
+                : null
+            }
+          />
+        ) : (
+          <Row
+            label={trainRowLabel}
+            value="Not yet allocated"
+            tone="muted"
+            hint="The booking has not been placed on a train schedule"
+          />
+        )}
+
+        {isRequested && trainLabel ? (
+          <Text size="xs" c="dimmed">
+            {hasDeparted
+              ? "This train has already departed — accepting the operation will not place the booking on it."
+              : "Picked by the customer at day-commit. Accepting the operation releases the booking to the batch pool for this train."}
+          </Text>
+        ) : null}
+
+        {schedule?.status ? (
+          <Group justify="space-between" wrap="nowrap">
+            <Text size="sm" c="dimmed">
+              Train status
+            </Text>
+            <Group gap="xs">
+              {schedule.windowPhase ? (
+                <Badge variant="light" color="gray" size="sm">
+                  {schedule.windowPhase.replace(/_/g, " ")}
+                </Badge>
+              ) : null}
+              <Badge variant="light" color="indigo" size="sm">
+                {schedule.status}
+              </Badge>
+            </Group>
+          </Group>
+        ) : null}
+
+        {booking.selectedForBatchAt ? (
+          <Row
+            label="Payment window started"
+            value={formatStamp(booking.selectedForBatchAt) ?? "—"}
+            hint={
+              windowDuration
+                ? `${windowDuration} window`
+                : formatRelative(booking.selectedForBatchAt, nowMs)
+            }
+          />
+        ) : null}
+
+        {payWindowEndsAt ? (
+          <Row
+            label="Payment window ends"
+            value={formatStamp(payWindowEndsAt) ?? "—"}
+            tone={payWindowClosed ? "danger" : "warning"}
+            hint={
+              payWindowClosed
+                ? `Closed ${formatRelative(payWindowEndsAt, nowMs)}`
+                : `Closes ${formatRelative(payWindowEndsAt, nowMs)}`
+            }
+          />
+        ) : null}
+
+        {booking.holdExpiresAt && booking.schedulingStatus === "HOLDING" ? (
+          <Row
+            label="Wagon hold expires"
+            value={formatStamp(booking.holdExpiresAt) ?? "—"}
+            tone="warning"
+            hint={formatRelative(booking.holdExpiresAt, nowMs)}
+          />
+        ) : null}
+
+        {schedule ? (
+          <>
+            <Row
+              label="Departure"
+              value={
+                formatStamp(schedule.actualDepartureAt) ??
+                formatStamp(schedule.scheduledDepartureDate) ??
+                "—"
+              }
+              tone={isRequested && hasDeparted ? "danger" : undefined}
+              hint={
+                schedule.actualDepartureAt
+                  ? `Actual · planned ${formatStamp(schedule.scheduledDepartureDate) ?? "—"}`
+                  : departureIso && !hasDeparted
+                    ? `Planned · departs ${formatRelative(departureIso, nowMs)}`
+                    : hasDeparted
+                      ? "Planned — already past"
+                      : "Planned"
+              }
+            />
+            <Row
+              label={schedule.actualArrivalAt ? "Arrived (trip ended)" : "Arrival"}
+              value={
+                formatStamp(schedule.actualArrivalAt) ??
+                formatStamp(schedule.scheduledArrivalDate) ??
+                "—"
+              }
+              hint={
+                schedule.actualArrivalAt
+                  ? `Actual · planned ${formatStamp(schedule.scheduledArrivalDate) ?? "—"}`
+                  : "Planned — the train has not arrived yet"
+              }
+            />
+          </>
+        ) : null}
+      </Stack>
+    </SectionCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingTrucksPanel.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingTrucksPanel.tsx
index 4427367cb..65c9719ed 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingTrucksPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/BookingTrucksPanel.tsx
@@ -11,7 +11,10 @@ import { SectionCard } from "./SectionCard";
 import { MetricTile } from "./MetricTile";
 
 const money = (amount: number, currency: string) =>
-  `${Number(amount).toLocaleString()} ${currency === "ETB" ? "Birr (ETB)" : currency}`;
+  `${Number(amount).toLocaleString(undefined, {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+  })} ${currency === "ETB" ? "Birr (ETB)" : currency}`;
 
 /**
  * Cargo costs (booking-level totals) plus the same truck-import block the
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/ClearanceReviewSection.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/ClearanceReviewSection.tsx
index 501e074e2..291bc0d05 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/ClearanceReviewSection.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/ClearanceReviewSection.tsx
@@ -14,6 +14,7 @@ import {
   Text,
   Textarea,
   ThemeIcon,
+  Timeline,
   Tooltip,
 } from "@mantine/core";
 import {
@@ -24,6 +25,7 @@ import {
   FileCheck2,
   FileText,
   MessageSquareWarning,
+  RefreshCw,
   Upload,
 } from "lucide-react";
 import toast from "react-hot-toast";
@@ -31,6 +33,7 @@ import type { Freight } from "@edr/types";
 import { isViewable } from "@edr/ui-common";
 
 import { SectionCard } from "./SectionCard";
+import { formatDateTime } from "@/lib/format";
 import { bookingsService } from "@/services/bookings.service";
 import {
   downloadBookingFile,
@@ -457,6 +460,76 @@ export function ClearanceReviewSection({
   );
 }
 
+const EVENT_META: Record<
+  Freight.ClearanceDocumentEvent["type"],
+  { color: string; icon: typeof Upload; label: (byName: string | null) => string }
+> = {
+  UPLOADED: {
+    color: "blue",
+    icon: Upload,
+    label: (n) => `Uploaded by ${n ?? "customer"}`,
+  },
+  RESUBMITTED: {
+    color: "blue",
+    icon: RefreshCw,
+    label: (n) => `Re-submitted by ${n ?? "customer"}`,
+  },
+  QUERIED: {
+    color: "red",
+    icon: MessageSquareWarning,
+    label: (n) => `Query opened by ${n ?? "staff"}`,
+  },
+  APPROVED: {
+    color: "edr-green",
+    icon: CheckCircle2,
+    label: (n) => `Approved by ${n ?? "staff"}`,
+  },
+};
+
+/** Per-document audit trail: uploads, amendment responses, queries, approval. */
+function DocHistoryTimeline({
+  history,
+}: {
+  history: Freight.ClearanceDocumentEvent[];
+}) {
+  return (
+    <Timeline
+      mt="sm"
+      ml={4}
+      bulletSize={20}
+      lineWidth={2}
+      active={history.length - 1}
+      color="gray"
+    >
+      {history.map((ev, i) => {
+        const meta = EVENT_META[ev.type];
+        const Icon = meta.icon;
+        return (
+          <Timeline.Item
+            key={`${ev.type}:${ev.at}:${i}`}
+            color={meta.color}
+            bullet={<Icon size={11} />}
+            title={
+              <Text fz="12.5px" fw={600} c="edr-text" lh={1.3}>
+                {meta.label(ev.byName)}
+              </Text>
+            }
+          >
+            <Text fz="11px" c="dimmed">
+              {formatDateTime(ev.at)}
+            </Text>
+            {ev.note ? (
+              <Text fz="11.5px" c="red.8" mt={2}>
+                {ev.note}
+              </Text>
+            ) : null}
+          </Timeline.Item>
+        );
+      })}
+    </Timeline>
+  );
+}
+
 function StatPill({
   color,
   label,
@@ -578,9 +651,33 @@ function DocReviewCard({
                 </Button>
               </Tooltip>
             )}
+          {hasFile && (
+            <Tooltip label="Download">
+              <Box
+                component="button"
+                type="button"
+                onClick={() =>
+                  void downloadBookingFile(doc.file!.id, doc.file!.name)
+                }
+                c="edr-green"
+                style={{
+                  display: "flex",
+                  background: "transparent",
+                  border: "none",
+                  cursor: "pointer",
+                }}
+              >
+                <Download size={15} />
+              </Box>
+            </Tooltip>
+          )}
         </Group>
       </Group>
 
+      {(doc.history?.length ?? 0) > 0 && (
+        <DocHistoryTimeline history={doc.history!} />
+      )}
+
       {status === "QUERIED" && doc.note && (
         <Alert
           mt="sm"
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/ConsolidationApprovalCard.tsx b/apps/edr-freight-web/backoffice/src/components/bookings/detail/ConsolidationApprovalCard.tsx
new file mode 100644
index 000000000..a5c74f52e
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/ConsolidationApprovalCard.tsx
@@ -0,0 +1,82 @@
+import { useQuery } from "@tanstack/react-query";
+import { Badge, Box, Group, Stack, Text } from "@mantine/core";
+import { Link2 } from "lucide-react";
+
+import { bookingsService } from "@/services/bookings.service";
+import { formatDateTime } from "@/lib/format";
+import { SectionCard } from "./SectionCard";
+
+const STATUS_COLOR: Record<string, string> = {
+  PENDING: "yellow",
+  APPROVED: "teal",
+  REJECTED: "red",
+};
+
+/**
+ * Audit trail for this booking's shared wagon: every approval request against
+ * it, who decided, when, and why. Rendered only for a booking that is actually
+ * consolidated — there is nothing to show otherwise.
+ */
+export function ConsolidationApprovalCard({ bookingId }: { bookingId: string }) {
+  const { data } = useQuery({
+    queryKey: ["consolidation-approvals", "history", bookingId],
+    queryFn: () => bookingsService.consolidationApprovalHistory(bookingId),
+    enabled: Boolean(bookingId),
+  });
+
+  if (!data?.length) return null;
+
+  return (
+    <SectionCard icon={Link2} title="Shared wagon approval">
+      <Stack gap="md">
+        {data.map((row) => (
+          <Box
+            key={row.id}
+            style={{
+              borderLeft: "3px solid var(--mantine-color-gray-3)",
+              paddingLeft: 12,
+            }}
+          >
+            <Group gap={8} align="center" wrap="wrap" mb={4}>
+              <Badge
+                color={STATUS_COLOR[row.status] ?? "gray"}
+                variant="light"
+                radius="sm"
+                size="sm"
+              >
+                {row.status}
+              </Badge>
+              <Text fz={13} fw={600}>
+                {row.bookingReference ?? "—"} + {row.partnerBookingReference ?? "—"}
+              </Text>
+            </Group>
+
+            <Text fz={12} c="dimmed">
+              Requested {formatDateTime(row.requestedAt)}
+              {row.requestedBy ? ` by ${row.requestedBy}` : ""}
+            </Text>
+
+            {row.decidedAt ? (
+              <Text fz={12} c="dimmed">
+                {row.status === "APPROVED" ? "Approved" : "Rejected"}{" "}
+                {formatDateTime(row.decidedAt)}
+                {row.decidedBy ? ` by ${row.decidedBy}` : ""}
+              </Text>
+            ) : (
+              <Text fz={12} c="yellow.8">
+                Waiting for a decision — neither booking reaches Operations until
+                this is approved.
+              </Text>
+            )}
+
+            {row.decisionNote ? (
+              <Text fz={12.5} mt={4} style={{ whiteSpace: "pre-wrap" }}>
+                “{row.decisionNote}”
+              </Text>
+            ) : null}
+          </Box>
+        ))}
+      </Stack>
+    </SectionCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/detail/index.ts b/apps/edr-freight-web/backoffice/src/components/bookings/detail/index.ts
index ecbb0488e..23f9b2bd8 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/detail/index.ts
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/detail/index.ts
@@ -16,9 +16,9 @@ export * from "./BookingPaymentCard";
 export * from "./BookingPaymentCountdownCard";
 export * from "./BookingFactsCard";
 export * from "./BookingDocumentsCard";
-export * from "./BookingRequestHero";
 export * from "./BookingRouteServiceCard";
 export * from "./BookingMileServicesCard";
 export * from "./BookingCargoCard";
-export * from "./BookingContractSummaryCard";
+export * from "./BookingContractCard";
 export * from "./BookingCompanyCard";
+export * from "./BookingSchedulingWindowCard";
diff --git a/apps/edr-freight-web/backoffice/src/components/bookings/useBookingActionDialog.ts b/apps/edr-freight-web/backoffice/src/components/bookings/useBookingActionDialog.ts
index be7111745..24398bdf9 100644
--- a/apps/edr-freight-web/backoffice/src/components/bookings/useBookingActionDialog.ts
+++ b/apps/edr-freight-web/backoffice/src/components/bookings/useBookingActionDialog.ts
@@ -14,6 +14,19 @@ function isValidValidityDays(value: string): boolean {
   return Number.isInteger(days) && days >= 1 && days <= 365;
 }
 
+/**
+ * Decisions that must be applied to BOTH halves of a consolidated pair. The two
+ * bookings share one wagon: accepting one alone would put half a wagon into the
+ * approval chain, and cancelling one alone would strand the other on a wagon it
+ * can no longer fill.
+ */
+const PAIRED_DECISIONS = {
+  accept: "accept",
+  cancel: "cancel",
+  operationAccept: "operationAccept",
+  requestChanges: "requestChanges",
+} as const;
+
 export function useBookingActionDialog(
   bookingId: string,
   context: BookingActionContext,
@@ -52,6 +65,30 @@ export function useBookingActionDialog(
 
     const onSuccess = () => closeDialog();
 
+    // A booking on a shared wagon routes the four pairable decisions through the
+    // paired endpoint, which applies them to both halves all-or-nothing. Every
+    // other action stays per booking.
+    const pairedDecision =
+      PAIRED_DECISIONS[pendingAction.id as keyof typeof PAIRED_DECISIONS];
+    if (context.consolidationPartnerId && pairedDecision) {
+      if (pairedDecision === "accept") {
+        const days = Number(inputValue.trim());
+        if (!Number.isInteger(days) || days < 1 || days > 365) return;
+        mutations.pairedDecision.mutate(
+          { decision: "accept", validityDays: days },
+          { onSuccess },
+        );
+        return;
+      }
+      mutations.pairedDecision.mutate(
+        pairedDecision === "cancel"
+          ? { decision: "cancel", reason: inputValue.trim() }
+          : { decision: pairedDecision, note: inputValue.trim() },
+        { onSuccess },
+      );
+      return;
+    }
+
     switch (pendingAction.id) {
       case "accept": {
         const days = Number(inputValue.trim());
diff --git a/apps/edr-freight-web/backoffice/src/components/common/FilterToggle.tsx b/apps/edr-freight-web/backoffice/src/components/common/FilterToggle.tsx
new file mode 100644
index 000000000..b97f827d4
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/common/FilterToggle.tsx
@@ -0,0 +1,34 @@
+import { ActionIcon, Indicator } from "@mantine/core";
+import { Filter } from "lucide-react";
+
+export interface FilterToggleProps {
+  /** Number of active advanced filters — shown as a badge on the button. */
+  count: number;
+  expanded: boolean;
+  onClick: () => void;
+}
+
+/** Toggle for the collapsible advanced-filters row on list pages. */
+export function FilterToggle({ count, expanded, onClick }: FilterToggleProps) {
+  return (
+    <Indicator
+      label={count}
+      size={16}
+      color="edr-green"
+      disabled={count === 0}
+      offset={4}
+    >
+      <ActionIcon
+        variant={expanded ? "filled" : "default"}
+        color="edr-green"
+        size="lg"
+        radius="lg"
+        aria-label="Toggle advanced filters"
+        aria-expanded={expanded}
+        onClick={onClick}
+      >
+        <Filter size={16} />
+      </ActionIcon>
+    </Indicator>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/common/ListControls.tsx b/apps/edr-freight-web/backoffice/src/components/common/ListControls.tsx
index 92ab514ad..8ca604ba4 100644
--- a/apps/edr-freight-web/backoffice/src/components/common/ListControls.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/common/ListControls.tsx
@@ -2,6 +2,7 @@ import { Button, Group, TextInput } from "@mantine/core";
 import { DatePickerInput } from "@mantine/dates";
 import { Search, X } from "lucide-react";
 import type { ReactNode } from "react";
+import { getDateRangePresets } from "./dateRangePresets";
 
 export interface ListControlsProps {
   search: string;
@@ -54,28 +55,19 @@ const ListControls = ({
     )}
 
     {showDateRange && (
-      <>
-        <DatePickerInput
-          label={dateLabel ? `${dateLabel} from` : "From"}
-          placeholder="Any"
-          value={dateFrom}
-          onChange={onDateFromChange}
-          // Cannot start after it ends — the picker refuses the invalid range
-          // instead of silently returning nothing.
-          maxDate={dateTo ?? undefined}
-          clearable
-          w={150}
-        />
-        <DatePickerInput
-          label={dateLabel ? `${dateLabel} to` : "To"}
-          placeholder="Any"
-          value={dateTo}
-          onChange={onDateToChange}
-          minDate={dateFrom ?? undefined}
-          clearable
-          w={150}
-        />
-      </>
+      <DatePickerInput
+        type="range"
+        label={dateLabel ?? "Date range"}
+        placeholder="Any"
+        value={[dateFrom, dateTo]}
+        onChange={([from, to]) => {
+          onDateFromChange(from);
+          onDateToChange(to);
+        }}
+        presets={getDateRangePresets()}
+        clearable
+        w={230}
+      />
     )}
 
     {children}
diff --git a/apps/edr-freight-web/backoffice/src/components/common/dateRangePresets.ts b/apps/edr-freight-web/backoffice/src/components/common/dateRangePresets.ts
new file mode 100644
index 000000000..e59e3bb84
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/common/dateRangePresets.ts
@@ -0,0 +1,41 @@
+import {
+  format,
+  startOfDay,
+  endOfDay,
+  startOfMonth,
+  endOfMonth,
+  startOfYear,
+  subDays,
+  subMonths,
+} from "date-fns";
+import type { DatePickerPreset } from "@mantine/dates";
+
+const iso = (date: Date) => format(date, "yyyy-MM-dd");
+
+/**
+ * Shared "Today / Last 7 days / …" presets for every Mantine
+ * `<DatePickerInput type="range" presets={getDateRangePresets()} />` in the app,
+ * so every from/to filter offers the same shortcuts. Computed fresh per call
+ * (not a module-level constant) so "Today" stays today.
+ */
+export function getDateRangePresets(): DatePickerPreset<"range">[] {
+  const today = new Date();
+  return [
+    { label: "Today", value: [iso(startOfDay(today)), iso(endOfDay(today))] },
+    {
+      label: "Yesterday",
+      value: [iso(startOfDay(subDays(today, 1))), iso(endOfDay(subDays(today, 1)))],
+    },
+    { label: "Last 7 days", value: [iso(startOfDay(subDays(today, 6))), iso(endOfDay(today))] },
+    { label: "Last 30 days", value: [iso(startOfDay(subDays(today, 29))), iso(endOfDay(today))] },
+    { label: "This month", value: [iso(startOfMonth(today)), iso(endOfDay(today))] },
+    {
+      label: "Last month",
+      value: [
+        iso(startOfMonth(subMonths(today, 1))),
+        iso(endOfMonth(subMonths(today, 1))),
+      ],
+    },
+    { label: "Year to date", value: [iso(startOfYear(today)), iso(endOfDay(today))] },
+  ];
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/BookingRequestStatusBadge.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/BookingRequestStatusBadge.tsx
new file mode 100644
index 000000000..dc742df4f
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/BookingRequestStatusBadge.tsx
@@ -0,0 +1,16 @@
+import { Badge } from "@mantine/core";
+
+const STATUS_COLOR: Record<string, string> = {
+  PENDING: "edr-green",
+  ACCEPTED: "blue",
+  REJECTED: "red",
+};
+
+/** Status of a customer-submitted shipment (booking) request against a contract. */
+export function BookingRequestStatusBadge({ status }: { status: string }) {
+  return (
+    <Badge variant="light" radius="sm" color={STATUS_COLOR[status] ?? "gray"}>
+      {status}
+    </Badge>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceChargesTab.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceChargesTab.tsx
new file mode 100644
index 000000000..6f3fb530f
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceChargesTab.tsx
@@ -0,0 +1,525 @@
+import { useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  Badge,
+  Box,
+  Button,
+  FileButton,
+  Group,
+  Loader,
+  NumberInput,
+  Paper,
+  Select,
+  Stack,
+  Text,
+  Tooltip,
+} from "@mantine/core";
+import {
+  CheckCircle2,
+  Download,
+  Eye,
+  FileText,
+  Receipt,
+  Send,
+  Upload,
+} from "lucide-react";
+import toast from "react-hot-toast";
+import type { Freight } from "@edr/types";
+import { isViewable } from "@edr/ui-common";
+
+import { bookingsService } from "@/services/bookings.service";
+import {
+  downloadBookingFile,
+  fetchViewableFile,
+} from "@/services/files.service";
+import { formatDateTime } from "@/lib/format";
+import { extractErrorMessage } from "@/utils/errorExtractor";
+
+const CURRENCIES = ["ETB", "USD"];
+
+const STATUS_META: Record<
+  Freight.ClearanceChargeStatus,
+  { label: string; color: string }
+> = {
+  DOC_UPLOADED: { label: "Awaiting billing", color: "yellow" },
+  BILLED: { label: "Ready to send", color: "blue" },
+  SENT: { label: "Sent — unpaid", color: "orange" },
+  PAID: { label: "Paid", color: "edr-green" },
+};
+
+export interface ClearanceChargesTabProps {
+  bookingId: string;
+  /** DJ uploads the port document; ET bills, sends and creates miscellaneous. */
+  roleMode: "ET" | "DJ";
+  onViewFile: (file: { name: string; url: string }) => void;
+}
+
+/**
+ * Post-finalization charges billed to the customer, two levels: port charges
+ * (document from GL Djibouti, billed by GL Ethiopia) then miscellaneous
+ * (created whole by GL Ethiopia once the port charge is paid). Each level
+ * issues its own payable invoice — ETB settles through the portal gateway
+ * (CBE), other currencies through Finance's manual settlement.
+ */
+export function ClearanceChargesTab({
+  bookingId,
+  roleMode,
+  onViewFile,
+}: ClearanceChargesTabProps) {
+  const qc = useQueryClient();
+  const { data: charges, isLoading } = useQuery({
+    queryKey: ["clearance-charges", bookingId],
+    queryFn: () => bookingsService.getClearanceCharges(bookingId),
+  });
+
+  const refresh = (next: Freight.ClearanceCharge[]) =>
+    qc.setQueryData(["clearance-charges", bookingId], next);
+  const onError = (e: unknown) =>
+    toast.error(extractErrorMessage(e, "Could not update the charge"));
+
+  const uploadPort = useMutation({
+    mutationFn: (file: File) =>
+      bookingsService.uploadPortChargeDocument(bookingId, file),
+    onSuccess: (next) => {
+      toast.success("Port-charges document uploaded");
+      refresh(next);
+    },
+    onError,
+  });
+  const bill = useMutation({
+    mutationFn: (p: { chargeId: string; amount: number; currency: string }) =>
+      bookingsService.billClearanceCharge(bookingId, p.chargeId, p),
+    onSuccess: (next) => {
+      toast.success("Charge amount saved");
+      refresh(next);
+    },
+    onError,
+  });
+  const send = useMutation({
+    mutationFn: (chargeId: string) =>
+      bookingsService.sendClearanceCharge(bookingId, chargeId),
+    onSuccess: (next) => {
+      toast.success("Invoice sent to the customer");
+      refresh(next);
+    },
+    onError,
+  });
+  const createMisc = useMutation({
+    mutationFn: (p: { file: File; amount: number; currency: string }) =>
+      bookingsService.createMiscellaneousCharge(bookingId, p.file, p),
+    onSuccess: (next) => {
+      toast.success("Miscellaneous charge created");
+      refresh(next);
+    },
+    onError,
+  });
+
+  if (isLoading) {
+    return (
+      <Group justify="center" py="xl" gap={10}>
+        <Loader size="sm" color="edr-green" />
+        <Text c="dimmed">Loading charges…</Text>
+      </Group>
+    );
+  }
+
+  const port = (charges ?? []).find((c) => c.type === "PORT_CHARGES") ?? null;
+  const misc = (charges ?? []).find((c) => c.type === "MISCELLANEOUS") ?? null;
+  const busy =
+    uploadPort.isPending || bill.isPending || send.isPending || createMisc.isPending;
+
+  const totals = new Map<string, number>();
+  for (const c of charges ?? []) {
+    if (c.amount != null && c.currency)
+      totals.set(c.currency, (totals.get(c.currency) ?? 0) + c.amount);
+  }
+
+  return (
+    <Stack gap="md" maw={860}>
+      <ChargeCard
+        title="1 · Port charges"
+        charge={port}
+        roleMode={roleMode}
+        busy={busy}
+        emptyHint={
+          roleMode === "DJ"
+            ? "Upload the port-charges document to start this charge."
+            : "Waiting for GL Djibouti to upload the port-charges document."
+        }
+        onViewFile={onViewFile}
+        onBill={(amount, currency) =>
+          port && bill.mutate({ chargeId: port.id, amount, currency })
+        }
+        onSend={() => port && send.mutate(port.id)}
+        djUpload={
+          roleMode === "DJ" && (!port || port.status === "DOC_UPLOADED") ? (
+            <FileButton
+              onChange={(f) => f && uploadPort.mutate(f)}
+              accept="application/pdf,image/*"
+              disabled={busy}
+            >
+              {(props) => (
+                <Button
+                  {...props}
+                  size="compact-sm"
+                  color="edr-green"
+                  radius="md"
+                  leftSection={<Upload size={14} />}
+                  loading={uploadPort.isPending}
+                >
+                  {port ? "Replace document" : "Upload document"}
+                </Button>
+              )}
+            </FileButton>
+          ) : null
+        }
+      />
+
+      <ChargeCard
+        title="2 · Miscellaneous charges"
+        charge={misc}
+        roleMode={roleMode}
+        busy={busy}
+        emptyHint={
+          port?.status !== "PAID"
+            ? "Unlocks once the port charge is paid."
+            : roleMode === "ET"
+              ? "Create the miscellaneous charge with its document, amount and currency."
+              : "GL Ethiopia creates this charge once the port charge is paid."
+        }
+        onViewFile={onViewFile}
+        onBill={(amount, currency) =>
+          misc && bill.mutate({ chargeId: misc.id, amount, currency })
+        }
+        onSend={() => misc && send.mutate(misc.id)}
+        etCreate={
+          roleMode === "ET" && !misc && port?.status === "PAID" ? (
+            <MiscCreateForm
+              busy={createMisc.isPending}
+              onCreate={(file, amount, currency) =>
+                createMisc.mutate({ file, amount, currency })
+              }
+            />
+          ) : null
+        }
+      />
+
+      {totals.size > 0 && (
+        <Paper withBorder radius="md" p="md">
+          <Group justify="space-between">
+            <Text fz="13px" fw={700} c="edr-text">
+              Total billed
+            </Text>
+            <Group gap="md">
+              {[...totals.entries()].map(([currency, amount]) => (
+                <Text key={currency} fz="14px" fw={800} c="edr-text">
+                  {amount.toLocaleString(undefined, {
+                    minimumFractionDigits: 2,
+                  })}{" "}
+                  {currency}
+                </Text>
+              ))}
+            </Group>
+          </Group>
+        </Paper>
+      )}
+    </Stack>
+  );
+}
+
+function ChargeCard({
+  title,
+  charge,
+  roleMode,
+  busy,
+  emptyHint,
+  onViewFile,
+  onBill,
+  onSend,
+  djUpload,
+  etCreate,
+}: {
+  title: string;
+  charge: Freight.ClearanceCharge | null;
+  roleMode: "ET" | "DJ";
+  busy: boolean;
+  emptyHint: string;
+  onViewFile: (file: { name: string; url: string }) => void;
+  onBill: (amount: number, currency: string) => void;
+  onSend: () => void;
+  djUpload?: React.ReactNode;
+  etCreate?: React.ReactNode;
+}) {
+  const [editing, setEditing] = useState(false);
+  const [amount, setAmount] = useState<number | string>(charge?.amount ?? "");
+  const [currency, setCurrency] = useState<string>(charge?.currency ?? "ETB");
+
+  const status = charge?.status ?? null;
+  const meta = status ? STATUS_META[status] : null;
+  // ET enters/revises the amount while the charge is unpaid.
+  const showBillForm =
+    roleMode === "ET" &&
+    charge != null &&
+    (charge.status === "DOC_UPLOADED" || editing);
+
+  return (
+    <Paper withBorder radius="md" p="md">
+      <Group justify="space-between" wrap="nowrap" align="flex-start">
+        <Group gap={10} wrap="nowrap">
+          <Receipt size={18} color="var(--mantine-color-edr-green-6)" />
+          <Box>
+            <Text fz="14px" fw={700} c="edr-text">
+              {title}
+            </Text>
+            {charge?.uploadedAt && (
+              <Text fz="11.5px" c="dimmed">
+                Document uploaded
+                {charge.uploadedByName ? ` by ${charge.uploadedByName}` : ""} ·{" "}
+                {formatDateTime(charge.uploadedAt)}
+              </Text>
+            )}
+            {charge?.billedAt && (
+              <Text fz="11.5px" c="dimmed">
+                Billed{charge.billedByName ? ` by ${charge.billedByName}` : ""} ·{" "}
+                {formatDateTime(charge.billedAt)}
+              </Text>
+            )}
+            {charge?.paidAt && (
+              <Text fz="11.5px" c="edr-green.8" fw={600}>
+                Paid · {formatDateTime(charge.paidAt)}
+                {charge.invoiceNumber ? ` (invoice ${charge.invoiceNumber})` : ""}
+              </Text>
+            )}
+          </Box>
+        </Group>
+        <Group gap={8} wrap="nowrap">
+          {charge?.amount != null && charge.currency && (
+            <Text fz="14px" fw={800} c="edr-text">
+              {charge.amount.toLocaleString(undefined, {
+                minimumFractionDigits: 2,
+              })}{" "}
+              {charge.currency}
+            </Text>
+          )}
+          {meta && (
+            <Badge variant="light" color={meta.color} radius="sm">
+              {meta.label}
+            </Badge>
+          )}
+        </Group>
+      </Group>
+
+      {charge?.file && (
+        <Group gap={8} mt="sm" wrap="nowrap">
+          <FileText size={15} color="var(--mantine-color-edr-green-6)" />
+          <Text fz="12.5px" c="edr-text" truncate style={{ minWidth: 0 }}>
+            {charge.file.name}
+          </Text>
+          {isViewable({ name: charge.file.name, url: "" }) && (
+            <Tooltip label="View">
+              <Box
+                component="button"
+                type="button"
+                onClick={() =>
+                  void fetchViewableFile(
+                    charge.file!.id,
+                    charge.file!.name,
+                  ).then(onViewFile)
+                }
+                c="edr-green"
+                style={{
+                  display: "flex",
+                  background: "transparent",
+                  border: "none",
+                  cursor: "pointer",
+                }}
+              >
+                <Eye size={15} />
+              </Box>
+            </Tooltip>
+          )}
+          <Tooltip label="Download">
+            <Box
+              component="button"
+              type="button"
+              onClick={() =>
+                void downloadBookingFile(charge.file!.id, charge.file!.name)
+              }
+              c="edr-green"
+              style={{
+                display: "flex",
+                background: "transparent",
+                border: "none",
+                cursor: "pointer",
+              }}
+            >
+              <Download size={15} />
+            </Box>
+          </Tooltip>
+        </Group>
+      )}
+
+      {!charge && (
+        <Text fz="12.5px" c="dimmed" mt="xs">
+          {emptyHint}
+        </Text>
+      )}
+      {djUpload && <Box mt="sm">{djUpload}</Box>}
+      {etCreate && <Box mt="sm">{etCreate}</Box>}
+
+      {showBillForm && (
+        <Group mt="sm" gap={8} align="flex-end" wrap="wrap">
+          <NumberInput
+            label="Amount"
+            size="xs"
+            radius="md"
+            min={0.01}
+            decimalScale={2}
+            value={amount}
+            onChange={setAmount}
+            w={160}
+          />
+          <Select
+            label="Currency"
+            size="xs"
+            radius="md"
+            data={CURRENCIES}
+            value={currency}
+            onChange={(v) => v && setCurrency(v)}
+            w={100}
+          />
+          <Button
+            size="compact-sm"
+            color="edr-green"
+            radius="md"
+            disabled={busy || !(Number(amount) > 0)}
+            onClick={() => {
+              onBill(Number(amount), currency);
+              setEditing(false);
+            }}
+          >
+            Save amount
+          </Button>
+          {editing && (
+            <Button
+              size="compact-sm"
+              variant="subtle"
+              color="gray"
+              radius="md"
+              disabled={busy}
+              onClick={() => setEditing(false)}
+            >
+              Cancel
+            </Button>
+          )}
+        </Group>
+      )}
+
+      {roleMode === "ET" && charge && !showBillForm && charge.status !== "PAID" && (
+        <Group mt="sm" gap={8} justify="flex-end">
+          <Button
+            size="compact-sm"
+            variant="light"
+            color="gray"
+            radius="md"
+            disabled={busy}
+            onClick={() => {
+              setAmount(charge.amount ?? "");
+              setCurrency(charge.currency ?? "ETB");
+              setEditing(true);
+            }}
+          >
+            {charge.status === "SENT" ? "Revise (cancels invoice)" : "Edit amount"}
+          </Button>
+          {charge.status === "BILLED" && (
+            <Tooltip label="ETB is payable online via CBE; other currencies go to Finance's manual settlement.">
+              <Button
+                size="compact-sm"
+                color="edr-green"
+                radius="md"
+                leftSection={<Send size={14} />}
+                disabled={busy}
+                onClick={onSend}
+              >
+                Send invoice to customer
+              </Button>
+            </Tooltip>
+          )}
+          {charge.status === "SENT" && charge.invoiceNumber && (
+            <Badge variant="light" color="orange" radius="sm">
+              Invoice {charge.invoiceNumber}
+            </Badge>
+          )}
+        </Group>
+      )}
+      {charge?.status === "PAID" && (
+        <Group mt="sm" gap={6} justify="flex-end">
+          <CheckCircle2 size={14} color="var(--mantine-color-edr-green-6)" />
+          <Text fz="12px" c="edr-green.8" fw={600}>
+            Settled
+          </Text>
+        </Group>
+      )}
+    </Paper>
+  );
+}
+
+function MiscCreateForm({
+  busy,
+  onCreate,
+}: {
+  busy: boolean;
+  onCreate: (file: File, amount: number, currency: string) => void;
+}) {
+  const [file, setFile] = useState<File | null>(null);
+  const [amount, setAmount] = useState<number | string>("");
+  const [currency, setCurrency] = useState("ETB");
+
+  return (
+    <Group gap={8} align="flex-end" wrap="wrap">
+      <FileButton onChange={setFile} accept="application/pdf,image/*" disabled={busy}>
+        {(props) => (
+          <Button
+            {...props}
+            size="compact-sm"
+            variant="light"
+            color="edr-green"
+            radius="md"
+            leftSection={<Upload size={14} />}
+          >
+            {file ? file.name : "Choose document"}
+          </Button>
+        )}
+      </FileButton>
+      <NumberInput
+        label="Amount"
+        size="xs"
+        radius="md"
+        min={0.01}
+        decimalScale={2}
+        value={amount}
+        onChange={setAmount}
+        w={160}
+      />
+      <Select
+        label="Currency"
+        size="xs"
+        radius="md"
+        data={CURRENCIES}
+        value={currency}
+        onChange={(v) => v && setCurrency(v)}
+        w={100}
+      />
+      <Button
+        size="compact-sm"
+        color="edr-green"
+        radius="md"
+        disabled={busy || !file || !(Number(amount) > 0)}
+        loading={busy}
+        onClick={() => file && onCreate(file, Number(amount), currency)}
+      >
+        Create charge
+      </Button>
+    </Group>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceHistoryTab.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceHistoryTab.tsx
new file mode 100644
index 000000000..c63558593
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceHistoryTab.tsx
@@ -0,0 +1,116 @@
+import { useQuery } from "@tanstack/react-query";
+import { Badge, Group, Loader, Paper, Text, Timeline } from "@mantine/core";
+import {
+  CheckCircle2,
+  CircleDot,
+  FileText,
+  MessageSquareWarning,
+  Receipt,
+  Send,
+  Ship,
+  Upload,
+  UserCheck,
+} from "lucide-react";
+import type { Freight } from "@edr/types";
+
+import { bookingsService } from "@/services/bookings.service";
+import { formatDateTime } from "@/lib/format";
+
+/** Icon + color per action family; unknown actions fall back to a neutral dot. */
+function eventMeta(action: string): { icon: typeof Upload; color: string } {
+  if (action === "DOC_APPROVED" || action.endsWith("_ACCEPTED") || action.endsWith("_FINALIZED") || action.endsWith("_CONFIRMED"))
+    return { icon: CheckCircle2, color: "edr-green" };
+  if (action === "DOC_QUERIED" || action.includes("CHANGE_REQUESTED") || action.includes("AMENDMENT"))
+    return { icon: MessageSquareWarning, color: "red" };
+  if (action.startsWith("CHARGE_"))
+    return { icon: Receipt, color: action === "CHARGE_PAID" ? "edr-green" : "orange" };
+  if (action.includes("TRANSIT_ASSIGNEE")) return { icon: UserCheck, color: "blue" };
+  if (action.includes("ORDER")) return { icon: Ship, color: "blue" };
+  if (action.includes("SENT")) return { icon: Send, color: "blue" };
+  if (action.includes("UPLOAD") || action.includes("SUBMITTED"))
+    return { icon: Upload, color: "blue" };
+  if (action.includes("DOC")) return { icon: FileText, color: "gray" };
+  return { icon: CircleDot, color: "gray" };
+}
+
+const ACTOR_BADGE: Record<
+  Freight.ClearanceHistoryEvent["actorType"],
+  { label: string; color: string }
+> = {
+  STAFF: { label: "Staff", color: "blue" },
+  CUSTOMER: { label: "Customer", color: "grape" },
+  SYSTEM: { label: "System", color: "gray" },
+};
+
+/**
+ * Full per-booking clearance action trail: document reviews, phased workflow
+ * steps (transit, declaration, duty, DO/RO, permits) and customer charges —
+ * every event with who did it and when, newest first.
+ */
+export function ClearanceHistoryTab({ bookingId }: { bookingId: string }) {
+  const { data: events, isLoading } = useQuery({
+    queryKey: ["clearance-history", bookingId],
+    queryFn: () => bookingsService.getClearanceHistory(bookingId),
+  });
+
+  if (isLoading) {
+    return (
+      <Group justify="center" py="xl" gap={10}>
+        <Loader size="sm" color="edr-green" />
+        <Text c="dimmed">Loading history…</Text>
+      </Group>
+    );
+  }
+
+  if (!events || events.length === 0) {
+    return (
+      <Paper withBorder radius="md" p="lg">
+        <Text size="sm" c="dimmed">
+          No clearance actions recorded yet. Actions from now on — approvals,
+          queries, workflow steps, charges — appear here automatically.
+        </Text>
+      </Paper>
+    );
+  }
+
+  return (
+    <Paper withBorder radius="md" p="lg" maw={760}>
+      <Timeline bulletSize={22} lineWidth={2} active={events.length - 1} color="gray">
+        {events.map((ev) => {
+          const meta = eventMeta(ev.action);
+          const Icon = meta.icon;
+          const actor = ACTOR_BADGE[ev.actorType];
+          const note =
+            typeof ev.metadata?.note === "string" ? ev.metadata.note : null;
+          return (
+            <Timeline.Item
+              key={ev.id}
+              color={meta.color}
+              bullet={<Icon size={12} />}
+              title={
+                <Group gap={8} wrap="wrap">
+                  <Text fz="13px" fw={600} c="edr-text" lh={1.35}>
+                    {ev.label}
+                  </Text>
+                  <Badge size="xs" variant="light" color={actor.color} radius="sm">
+                    {actor.label}
+                  </Badge>
+                </Group>
+              }
+            >
+              <Text fz="11.5px" c="dimmed">
+                {ev.actorName ? `${ev.actorName} · ` : ""}
+                {formatDateTime(ev.at)}
+              </Text>
+              {note ? (
+                <Text fz="12px" c="red.8" mt={2}>
+                  {note}
+                </Text>
+              ) : null}
+            </Timeline.Item>
+          );
+        })}
+      </Timeline>
+    </Paper>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceOpsTabs.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceOpsTabs.tsx
index a61646d6f..8672e60d3 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceOpsTabs.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/ClearanceOpsTabs.tsx
@@ -1,6 +1,6 @@
 import type { ReactNode } from "react";
 import { Badge, Stack, Tabs, Text } from "@mantine/core";
-import { AlertTriangle, FileText, Share2, ShieldAlert } from "lucide-react";
+import { AlertTriangle, FileText, History, Receipt, Share2, ShieldAlert } from "lucide-react";
 import type { Freight } from "@edr/types";
 
 import { useAuth } from "@/auth/useAuth";
@@ -9,6 +9,8 @@ import { SectionCard } from "@/components/bookings/detail/SectionCard";
 import { AssignRiskCard } from "@/components/contracts/gl-actions/AssignRiskCard";
 import { IncidentReportCard } from "@/components/contracts/gl-actions/IncidentReportCard";
 import { ClearanceUploadedDocumentsPanel } from "@/components/contracts/ClearanceUploadedDocumentsPanel";
+import { ClearanceChargesTab } from "@/components/contracts/ClearanceChargesTab";
+import { ClearanceHistoryTab } from "@/components/contracts/ClearanceHistoryTab";
 import { GlExchangePanel } from "@/components/contracts/GlExchangePanel";
 
 export interface ClearanceOpsTabsProps {
@@ -68,6 +70,12 @@ export function ClearanceOpsTabs({
     Boolean(exchangeEntityId) &&
     (hasPermission(user, FREIGHT_PERMS.contracts.clearanceEtActions) ||
       hasPermission(user, FREIGHT_PERMS.contracts.clearanceDjActions));
+  // Post-finalization customer billing. This layout is only rendered on the ET
+  // clearance pages — the DJ page (GlClearanceDetailPage) mounts its own tab.
+  const showCharges =
+    Boolean(bookingId) &&
+    Boolean(onViewFile) &&
+    hasPermission(user, FREIGHT_PERMS.contracts.clearanceEtActions);
   // Risk assignment + incident reporting hit bookings:operations endpoints.
   const canOps = hasPermission(user, FREIGHT_PERMS.bookings.operations);
   const hasTabs = (showOpsTabs && hasOps) || showDocuments || showExchange;
@@ -100,6 +108,16 @@ export function ClearanceOpsTabs({
             Document exchange
           </Tabs.Tab>
         ) : null}
+        {showCharges ? (
+          <Tabs.Tab value="charges" leftSection={<Receipt size={14} />}>
+            Customer charges
+          </Tabs.Tab>
+        ) : null}
+        {bookingId && showExchange ? (
+          <Tabs.Tab value="history" leftSection={<History size={14} />}>
+            History
+          </Tabs.Tab>
+        ) : null}
         {showOpsTabs && canOps && riskMs ? (
           <Tabs.Tab value="risk" leftSection={<ShieldAlert size={14} />}>
             Risk assignment
@@ -131,6 +149,22 @@ export function ClearanceOpsTabs({
         </Tabs.Panel>
       ) : null}
 
+      {showCharges ? (
+        <Tabs.Panel value="charges">
+          <ClearanceChargesTab
+            bookingId={bookingId!}
+            roleMode="ET"
+            onViewFile={onViewFile!}
+          />
+        </Tabs.Panel>
+      ) : null}
+
+      {bookingId && showExchange ? (
+        <Tabs.Panel value="history">
+          <ClearanceHistoryTab bookingId={bookingId} />
+        </Tabs.Panel>
+      ) : null}
+
       {showOpsTabs && canOps && riskMs && bookingId ? (
         <Tabs.Panel value="risk">
           <SectionCard icon={ShieldAlert} title="Customs risk" accent="edr-green">
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/ContractMilestonesTimeline.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/ContractMilestonesTimeline.tsx
index 1bf9b55e7..3a3c71449 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/ContractMilestonesTimeline.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/ContractMilestonesTimeline.tsx
@@ -10,6 +10,7 @@ import {
 import { Group, Stack, Text, Timeline, Tooltip } from "@mantine/core";
 import type { Freight } from "@edr/types";
 
+import { formatDate } from "@/lib/format";
 import {
   CONTRACT_APPROVAL_ROLE_LABELS,
   HAZARDOUS_APPROVAL_ROLE_PERMISSION,
@@ -54,10 +55,6 @@ function formatAgo(iso: string): string {
   return "just now";
 }
 
-function formatDate(iso: string): string {
-  return new Date(iso).toLocaleDateString(undefined, { dateStyle: "medium" });
-}
-
 type MilestoneIcon = typeof Send;
 
 interface Milestone {
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/ContractStatusTabs.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/ContractStatusTabs.tsx
deleted file mode 100644
index 862bc1562..000000000
--- a/apps/edr-freight-web/backoffice/src/components/contracts/ContractStatusTabs.tsx
+++ /dev/null
@@ -1,92 +0,0 @@
-import { Badge, ScrollArea, Tabs } from "@mantine/core";
-import {
-  ClipboardCheck,
-  FileSignature,
-  Inbox,
-  LayoutGrid,
-  ShieldCheck,
-  Truck,
-  XCircle,
-} from "lucide-react";
-
-import "@/components/overview/overview.css";
-import {
-  CONTRACT_LIST_TABS,
-  type ContractStatusTabKey,
-} from "@/features/contracts/contract-status.config";
-
-const TAB_ICONS: Record<ContractStatusTabKey, React.ReactNode> = {
-  all: <LayoutGrid size={17} strokeWidth={1.85} />,
-  intake: <Inbox size={17} strokeWidth={1.85} />,
-  in_approval: <ClipboardCheck size={17} strokeWidth={1.85} />,
-  approved_contract: <FileSignature size={17} strokeWidth={1.85} />,
-  clearance: <ShieldCheck size={17} strokeWidth={1.85} />,
-  active: <Truck size={17} strokeWidth={1.85} />,
-  closed: <XCircle size={17} strokeWidth={1.85} />,
-};
-
-interface ContractStatusTabsProps {
-  active: ContractStatusTabKey;
-  onChange: (tab: ContractStatusTabKey) => void;
-  counts?: Partial<Record<ContractStatusTabKey, number>>;
-}
-
-export function ContractStatusTabs({
-  active,
-  onChange,
-  counts,
-}: ContractStatusTabsProps) {
-  return (
-    <Tabs
-      value={active}
-      onChange={(value) => onChange((value as ContractStatusTabKey) ?? "all")}
-      variant="pills"
-      color="edr-green"
-      keepMounted={false}
-      classNames={{ list: "ov-tablist", tab: "ov-tab" }}
-    >
-      <ScrollArea type="auto" scrollbarSize={6} offsetScrollbars="x">
-        <Tabs.List style={{ flexWrap: "nowrap", width: "max-content" }}>
-          {CONTRACT_LIST_TABS.map((tab) => {
-            const isActive = active === tab.key;
-            const count = counts?.[tab.key];
-            return (
-              <Tabs.Tab
-                key={tab.key}
-                value={tab.key}
-                leftSection={TAB_ICONS[tab.key]}
-                size={"sm"}
-                rightSection={
-                  count !== undefined ? (
-                    <Badge
-                      size="sm"
-                      radius="sm"
-                      variant={isActive ? "white" : "light"}
-                      color={isActive ? "edr-green" : "gray"}
-                      styles={
-                        isActive
-                          ? {
-                              root: {
-                                background: "rgba(255,255,255,0.9)",
-                                color: "#15805f",
-                              },
-                            }
-                          : undefined
-                      }
-                    >
-                      {count}
-                    </Badge>
-                  ) : undefined
-                }
-              >
-                {tab.label}
-              </Tabs.Tab>
-            );
-          })}
-        </Tabs.List>
-      </ScrollArea>
-    </Tabs>
-  );
-}
-
-export type { ContractStatusTabKey };
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/ExportClearanceStepper.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/ExportClearanceStepper.tsx
index f665f388b..af68d0f55 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/ExportClearanceStepper.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/ExportClearanceStepper.tsx
@@ -1006,7 +1006,7 @@ export function ReleaseOrderCard({
   clearance: ClearanceViewLike & { vesselDepartureDate?: string | null };
   onChanged?: () => void;
 }) {
-  const [file, setFile] = useState<File | null>(null);
+  const [files, setFiles] = useState<File[]>([]);
   const [vesselDate, setVesselDate] = useState<Date | null>(
     clearance.vesselDepartureDate ? new Date(clearance.vesselDepartureDate) : null,
   );
@@ -1020,7 +1020,14 @@ export function ReleaseOrderCard({
         Release Order
       </Text>
       <Stack gap="sm">
-        <FileInput label="Release Order" value={file} onChange={setFile} size="sm" />
+        <FileInput
+          label="Release Order"
+          placeholder="Select one or more files"
+          multiple
+          value={files}
+          onChange={setFiles}
+          size="sm"
+        />
         <DateInput
           label="Vessel departure date"
           value={vesselDate}
@@ -1032,15 +1039,15 @@ export function ReleaseOrderCard({
           <Button
             color="edr-green"
             loading={loading}
-            disabled={!file || !vesselDate}
+            disabled={files.length === 0 || !vesselDate}
             onClick={async () => {
-              if (!file || !vesselDate) return;
+              if (files.length === 0 || !vesselDate) return;
               setLoading(true);
               try {
                 const iso = vesselDate.toISOString().slice(0, 10);
                 const result = isBooking
-                  ? await bookingsService.uploadReleaseOrder(entityId, file, iso)
-                  : await contractsService.uploadReleaseOrder(entityId, file, iso);
+                  ? await bookingsService.uploadReleaseOrder(entityId, files, iso)
+                  : await contractsService.uploadReleaseOrder(entityId, files, iso);
                 if (result.hold) {
                   toast.error(result.holdReason ?? "Vessel date too soon");
                 } else {
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/GlClearanceUploadModal.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/GlClearanceUploadModal.tsx
index dfe0bf0e4..95dbc787e 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/GlClearanceUploadModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/GlClearanceUploadModal.tsx
@@ -10,11 +10,10 @@ import {
   toIsoDate,
   useDoCollectionDates,
 } from "@/components/contracts/DoCollectionDateFields";
-import { PhasedFileDropzone } from "@/components/contracts/PhasedFileDropzone";
-import { findWorkflowFile } from "@/components/contracts/PhasedUploadedFileRow";
+import { PhasedMultiFileDropzone } from "@/components/contracts/PhasedFileDropzone";
 import { contractsService } from "@/services/contracts.service";
 import { bookingsService } from "@/services/bookings.service";
-import type { Freight } from "@edr/types";
+import { isDeliveryOrderFileCode, isReleaseOrderFileCode, type Freight } from "@edr/types";
 
 export type GlClearanceUploadKind = "do" | "ro";
 
@@ -44,9 +43,8 @@ export function GlClearanceUploadModal({
   vesselArrivalDate,
   doCollectedDate,
   onSuccess,
-  onPreview,
 }: GlClearanceUploadModalProps) {
-  const [file, setFile] = useState<File | null>(null);
+  const [files, setFiles] = useState<File[]>([]);
   const [vesselDate, setVesselDate] = useState<Date | null>(
     vesselDepartureDate ? new Date(vesselDepartureDate) : null,
   );
@@ -66,16 +64,16 @@ export function GlClearanceUploadModal({
   const isDo = kind === "do";
   const isRo = kind === "ro";
   const replaceMode = isDo
-    ? Boolean(findWorkflowFile(workflowFiles, "delivery_order"))
-    : Boolean(findWorkflowFile(workflowFiles, "release_order"));
+    ? workflowFiles.some((f) => isDeliveryOrderFileCode(f.code) && f.file)
+    : workflowFiles.some((f) => isReleaseOrderFileCode(f.code) && f.file);
 
   const close = () => {
-    setFile(null);
+    setFiles([]);
     onClose();
   };
 
   const submit = async () => {
-    if (!file || !kind) return;
+    if (files.length === 0 || !kind) return;
     if (isRo && !vesselDate) {
       toast.error("Vessel departure date is required.");
       return;
@@ -93,23 +91,23 @@ export function GlClearanceUploadModal({
           doCollectedDate: toIsoDate(doDates.doCollected)!,
         };
         if (isBooking) {
-          await bookingsService.uploadDeliveryOrder(entityId, file, dates);
+          await bookingsService.uploadDeliveryOrder(entityId, files, dates);
         } else {
-          await contractsService.uploadDeliveryOrder(entityId, file, dates);
+          await contractsService.uploadDeliveryOrder(entityId, files, dates);
         }
         toast.success(replaceMode ? "Delivery Order updated" : "Delivery Order uploaded");
       } else {
         const iso = vesselDate!.toISOString().slice(0, 10);
         const result = isBooking
-          ? await bookingsService.uploadReleaseOrder(entityId, file, iso)
-          : await contractsService.uploadReleaseOrder(entityId, file, iso);
+          ? await bookingsService.uploadReleaseOrder(entityId, files, iso)
+          : await contractsService.uploadReleaseOrder(entityId, files, iso);
         if (result.hold) {
           toast.error(result.holdReason ?? "Vessel date too soon");
         } else {
           toast.success(replaceMode ? "Release Order updated" : "Release Order uploaded");
         }
       }
-      setFile(null);
+      setFiles([]);
       onSuccess?.();
       close();
     } catch (e) {
@@ -152,14 +150,15 @@ export function GlClearanceUploadModal({
           <DoCollectionDateFields value={doDates} onChange={setDoDates} />
         )}
 
-        <PhasedFileDropzone
-          label={isDo ? "Delivery Order file" : "Release Order file"}
-          description={isDo ? "Any file type." : "PDF or image."}
+        <PhasedMultiFileDropzone
+          label={isDo ? "Delivery Order files" : "Release Order files"}
+          description={
+            isDo ? "Any file type. Add as many files as needed." : "PDF or image. Add as many files as needed."
+          }
           accept={isDo ? "*/*" : undefined}
-          value={file}
-          onChange={setFile}
+          value={files}
+          onChange={setFiles}
           replaceMode={replaceMode}
-          onPreview={onPreview}
         />
 
         <Group justify="flex-end" gap="sm">
@@ -170,7 +169,7 @@ export function GlClearanceUploadModal({
             color="edr-green"
             loading={loading}
             disabled={
-              !file ||
+              files.length === 0 ||
               (isRo && !vesselDate) ||
               (isDo && !doDatesComplete(doDates))
             }
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/GlCreateBookingForm.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/GlCreateBookingForm.tsx
index 42ecbce61..06ae71384 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/GlCreateBookingForm.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/GlCreateBookingForm.tsx
@@ -11,6 +11,7 @@ import { useMutation, useQuery } from "@tanstack/react-query";
 import {
   ActionIcon,
   Alert,
+  Badge,
   Box,
   Button,
   Center,
@@ -40,6 +41,7 @@ import {
   FileText,
   FileUp,
   Flame,
+  Link2,
   MapPin,
   Package,
   Receipt,
@@ -57,7 +59,10 @@ import {
 import { api } from "@/services/api";
 import { PageContainer } from "@/components/page";
 import { PageHeader } from "@/components/page/PageHeader";
-import { contractsService } from "@/services/contracts.service";
+import {
+  contractsService,
+  type ConsolidationCandidate,
+} from "@/services/contracts.service";
 import { bookingsService } from "@/services/bookings.service";
 import {
   useContractCapacity,
@@ -80,6 +85,18 @@ import {
   StepHeader,
   StepLabel,
 } from "./gl-booking-form/form-ui";
+import {
+  ConsolidationPartnerPanel,
+  emptyPartnerLine,
+} from "./gl-booking-form/ConsolidationPartnerPanel";
+import { ConsolidationPartnerPicker } from "./gl-booking-form/ConsolidationPartnerPicker";
+
+/**
+ * Container sizes offered on the parent-booking panel. Fixed rather than taken
+ * from this contract's scope: the parent booking is a different customer on a
+ * different contract, so its sizes are its own.
+ */
+const PARTNER_SIZES = ["20ft", "40ft"];
 
 /** All booking-window times are communicated in East Africa Time. */
 const EAT_TZ = "Africa/Addis_Ababa";
@@ -240,6 +257,14 @@ export default function GlCreateBookingForm() {
     enabled: Boolean(copyFromParam),
   });
 
+  // The booking being completed — used to name the customer on the price
+  // confirmation when a second booking's price is shown beside it.
+  const { data: completeBooking } = useQuery({
+    queryKey: ["gl-complete-booking", completeBookingId],
+    queryFn: () => bookingsService.getById(completeBookingId!),
+    enabled: Boolean(completeBookingId),
+  });
+
   // Same window-gating the customer sees: booking is only allowed while a
   // window is OPEN for one of the contract's routes. Intercity contracts are
   // never window-gated — the shipment rides a passing train staff pick later.
@@ -276,9 +301,8 @@ export default function GlCreateBookingForm() {
   const [trainScheduleId, setTrainScheduleId] = useState("");
   const [contractRouteId, setContractRouteId] = useState<string | null>(null);
   const [notes, setNotes] = useState("");
-  // The customer states the billing currency on their shipment request — GL
-  // books in it. Intercity is always ETB (the API enforces this too).
-  const [paymentCurrency, setPaymentCurrency] = useState<"USD" | "ETB">("USD");
+  // ponytail: ETB-only for now — widen back to "USD" | "ETB" when multi-currency billing returns.
+  const [paymentCurrency, setPaymentCurrency] = useState<"USD" | "ETB">("ETB");
   // What the containers carry — captured per booking (moved off the contract).
   const [cargoDescription, setCargoDescription] = useState("");
   const [containerLines, setContainerLines] = useState<ContainerLineDraft[]>([]);
@@ -291,6 +315,18 @@ export default function GlCreateBookingForm() {
   const [withReturn, setWithReturn] = useState(false);
   const [prefilled, setPrefilled] = useState(false);
   const [priceOpen, setPriceOpen] = useState(false);
+  // ── Odd-20ft shared wagon (customs / Path B) ──────────────────────────────
+  // An odd 20ft total leaves one container unpaired. On a customs contract GL
+  // resolves that here by linking a second booking that is also odd — two odd
+  // counts always sum to even — completing both together onto the shared wagon.
+  const [consolidateOdd, setConsolidateOdd] = useState(false);
+  // Set once GL flips the toggle by hand, so the auto-on effect below never
+  // re-opens a panel GL deliberately closed.
+  const consolidateTouchedRef = useRef(false);
+  const [partnerPickerOpen, setPartnerPickerOpen] = useState(false);
+  const [partner, setPartner] = useState<ConsolidationCandidate | null>(null);
+  const [partnerLines, setPartnerLines] = useState<ContainerLineDraft[]>([]);
+  const [partnerCargoDescription, setPartnerCargoDescription] = useState("");
   const seededRef = useRef(false);
   const returnSeededRef = useRef(false);
 
@@ -349,6 +385,9 @@ export default function GlCreateBookingForm() {
   // Intercity shipments ride a passing import/export train staff pick at
   // finalize time — no shipment day is chosen and no window gate applies.
   const isIntercity = contract?.tradeDirection === "DOMESTIC";
+  // USD billing is offered on import traffic only — export and domestic
+  // shipments are always invoiced in ETB.
+  const isImport = contract?.tradeDirection === "IMPORT";
 
   // ONE_TIME split-remainder mode: a previous booking on this contract was
   // split on train capacity, so the capacity endpoint reports the outstanding
@@ -449,9 +488,6 @@ export default function GlCreateBookingForm() {
     }
     if (bookingRequest.contractRouteId)
       setContractRouteId(bookingRequest.contractRouteId);
-    if (bookingRequest.paymentCurrency === "USD" || bookingRequest.paymentCurrency === "ETB") {
-      setPaymentCurrency(bookingRequest.paymentCurrency);
-    }
     if (bookingRequest.notes) setNotes(bookingRequest.notes);
   }, [bookingRequest, prefilled]);
 
@@ -835,6 +871,53 @@ export default function GlCreateBookingForm() {
   }, [isContainer, containerLines]);
   const hasOdd20ft = ft20Total % 2 === 1;
 
+  // Only a customs (Path B) instance being COMPLETED by GL can use the shared
+  // wagon: it is GL, not the customer, who links the two bookings. Anything else
+  // keeps the historical hard block on odd 20ft.
+  //
+  // Switched OFF for now: consolidation is built end to end (toggle, parent
+  // picker, split entry, paired pricing, approval gate) but not in use, so an
+  // odd 20ft total is rejected outright instead of offering the shared wagon.
+  // Drop the `false &&` to bring the whole flow back.
+  const oddConsolidationAvailable =
+    false &&
+    Boolean(completeBookingId && isContainer && contract?.customsClearingEnabled);
+
+  // Auto-on: entering an odd 20ft total opens the consolidation panel by itself,
+  // once. GL can still switch it off — then odd is blocked exactly as before.
+  useEffect(() => {
+    if (!oddConsolidationAvailable) return;
+    if (consolidateTouchedRef.current) return;
+    if (hasOdd20ft) setConsolidateOdd(true);
+  }, [oddConsolidationAvailable, hasOdd20ft]);
+
+  // Clear the partner as soon as the panel closes or stops applying, so a
+  // leftover selection can never ride along into a plain single-booking submit.
+  useEffect(() => {
+    if (consolidateOdd && oddConsolidationAvailable) return;
+    setPartner(null);
+    setPartnerLines([]);
+    setPartnerCargoDescription("");
+  }, [consolidateOdd, oddConsolidationAvailable]);
+
+  const consolidationActive =
+    oddConsolidationAvailable && consolidateOdd && hasOdd20ft;
+
+  // Once a parent booking is linked, each booking's cargo is entered under its
+  // own labelled heading so it is clear which containers belong to whom.
+  const splitView = Boolean(consolidationActive && partner);
+
+  const candidatesQuery = useQuery({
+    queryKey: ["consolidation-candidates", id, completeBookingId],
+    queryFn: () =>
+      contractsService.listConsolidationCandidates(
+        id ?? "",
+        completeBookingId ?? "",
+      ),
+    enabled:
+      partnerPickerOpen && Boolean(id) && Boolean(completeBookingId),
+  });
+
   const bulkUom = contract ? bulkUnitOfMeasure(contract) : "PER_TON";
 
   const bulkErrors = useMemo<BulkErrors>(() => {
@@ -887,7 +970,65 @@ export default function GlCreateBookingForm() {
       !cargoDescriptionError
     : !bulkErrors.quantity && !bulkErrors.hazardous && !bulkErrors.reefer;
 
-  const formValid = cargoValid && !hasOdd20ft && !dateError && !routeError;
+  // Consolidation (sharing the wagon with another customer's odd booking) is
+  // built but switched off for now, so an odd 20ft total always blocks — the
+  // shared wagon no longer resolves the unpaired container. Flip this back to
+  // `hasOdd20ft && !consolidationActive` to re-enable the shared-wagon path.
+  const oddBlocksSubmit = hasOdd20ft;
+
+  // Partner side: a linked partner must be picked, carry an odd 20ft count of
+  // its own (odd + odd = even fills the wagon) and have complete unit details.
+  const partnerFt20Total = useMemo(() => {
+    if (!consolidationActive) return 0;
+    return partnerLines
+      .filter((l) => parseInt(l.containerSize, 10) === 20)
+      .reduce((sum, l) => sum + Number(l.quantity || 0), 0);
+  }, [consolidationActive, partnerLines]);
+
+  const partnerError = useMemo<string | undefined>(() => {
+    if (!consolidationActive) return undefined;
+    if (!partner) return "Select the booking that shares this wagon.";
+    const totalQty = partnerLines.reduce(
+      (sum, l) => sum + Math.max(0, Number(l.quantity) || 0),
+      0,
+    );
+    if (totalQty < 1) {
+      return `Enter the containers for ${partner.reference}.`;
+    }
+    if (partnerFt20Total % 2 === 0) {
+      return `${partner.reference} must also carry an odd number of 20ft containers so the two bookings fill whole wagons together (it has ${partnerFt20Total}).`;
+    }
+    const incomplete = partnerLines.some((line) => {
+      const qty = Number(line.quantity || 0);
+      return qty >= 1 && line.units.length < qty;
+    });
+    if (incomplete) {
+      return `Enter the container details for all of ${partner.reference}'s containers.`;
+    }
+    const badUnit = partnerLines.some((line) =>
+      line.units.some(
+        (u) =>
+          !ISO_CONTAINER_NUMBER_REGEX.test(u.containerNumber.trim().toUpperCase()) ||
+          !(Number(u.vgmTons) > 0),
+      ),
+    );
+    if (badUnit) {
+      return `Every ${partner.reference} container needs a valid container number and a VGM above 0.`;
+    }
+    if (!partnerCargoDescription.trim()) {
+      return `Describe the cargo carried in ${partner.reference}'s containers.`;
+    }
+    return undefined;
+  }, [
+    consolidationActive,
+    partner,
+    partnerLines,
+    partnerFt20Total,
+    partnerCargoDescription,
+  ]);
+
+  const formValid =
+    cargoValid && !oddBlocksSubmit && !dateError && !routeError && !partnerError;
 
   /** The create-booking DTO from the current form state — shared by the
    * authoritative price preview and the actual submit so what GL confirms is
@@ -954,6 +1095,44 @@ export default function GlCreateBookingForm() {
     return payload;
   };
 
+  /**
+   * Completion DTO for the partner half of a shared wagon. Route, day and train
+   * are deliberately copied from THIS booking: the two bookings ride the same
+   * wagon, so they must ride the same train on the same day. Only the cargo and
+   * the billing currency belong to the partner.
+   */
+  const buildPartnerPayload = (): Freight.CreateBookingUnderContractDto | null => {
+    if (!partner || !consolidationActive) return null;
+
+    const payload: Freight.CreateBookingUnderContractDto = {
+      paymentCurrency,
+      ...(scheduledDate
+        ? { scheduledDate: new Date(scheduledDate).toISOString() }
+        : {}),
+      ...(trainScheduleId ? { trainScheduleId } : {}),
+      ...(partnerCargoDescription.trim()
+        ? { cargoFreeText: partnerCargoDescription.trim() }
+        : {}),
+      containers: partnerLines
+        .filter((l) => Number(l.quantity) >= 1)
+        .map((l) => ({
+          containerSize: l.containerSize,
+          quantity: Number(l.quantity),
+          hazardousQuantity: Number(l.hazardousQuantity || 0) || undefined,
+          reeferQuantity: Number(l.reeferQuantity || 0) || undefined,
+          units: l.units.map((u) => ({
+            containerNumber: u.containerNumber.trim().toUpperCase(),
+            ...(u.sealNumber ? { sealNumber: u.sealNumber } : {}),
+            vgmTons: Number(u.vgmTons) || 0,
+            isHazardous: Boolean(u.isHazardous),
+            isReefer: Boolean(u.isReefer),
+          })),
+        })),
+    };
+
+    return payload;
+  };
+
   // Authoritative price preview (same pricing pass the booking persists at
   // create): rail freight + first/last mile + overweight + every surcharge,
   // plus the hard-block checks (20ft pairing, max capacity, container numbers
@@ -965,6 +1144,22 @@ export default function GlCreateBookingForm() {
   });
   const validation = validateShipmentMutation.data ?? null;
 
+  // The partner is priced against ITS OWN contract, so the two totals shown in
+  // the confirm modal are each customer's real bill — nobody pays for the other.
+  const validatePartnerMutation = useMutation({
+    mutationFn: (input: {
+      contractId: string;
+      bookingId: string;
+      dto: Freight.CreateBookingUnderContractDto;
+    }) =>
+      contractsService.validateShipment(
+        input.contractId,
+        input.dto,
+        input.bookingId,
+      ),
+  });
+  const partnerValidation = validatePartnerMutation.data ?? null;
+
   const serverTotal = useMemo(() => {
     const items = validation?.lineItems;
     if (!items?.length) return null;
@@ -1011,8 +1206,52 @@ export default function GlCreateBookingForm() {
     };
   }, [serverTotal, priceTotal, overweightSurchargeAmount]);
 
+  const partnerTotal = useMemo(() => {
+    const items = partnerValidation?.lineItems;
+    if (!items?.length) return null;
+    return {
+      currency: partnerValidation?.currency ?? "ETB",
+      lines: items.map((li) => ({
+        label: li.description,
+        unitPrice: li.unitAmount,
+        unit: li.unit.toLowerCase(),
+        quantity: li.quantity,
+        amount: li.amount,
+      })),
+      total:
+        partnerValidation?.totalAmount ?? items.reduce((s, l) => s + l.amount, 0),
+    };
+  }, [partnerValidation]);
+
+  // The partner half must clear the same hard blocks as this one — the pair is
+  // booked all-or-nothing, so a block on either side blocks both.
+  const partnerBlockers = useMemo(() => {
+    if (!consolidationActive || !partnerValidation) return [];
+    return [
+      ...(partnerValidation.pairingErrors ?? []),
+      ...(partnerValidation.capacityErrors ?? []),
+      ...(partnerValidation.containerClashErrors ?? []),
+      ...(partnerValidation.spaceErrors ?? []),
+    ];
+  }, [consolidationActive, partnerValidation]);
+
+  const completePairMutation = useMutation({
+    mutationFn: (input: {
+      payload: Freight.CreateBookingUnderContractDto;
+      partnerPayload: Freight.CreateBookingUnderContractDto;
+      partnerBookingId: string;
+    }) =>
+      contractsService.completeConsolidatedPair(id ?? "", completeBookingId ?? "", {
+        partnerBookingId: input.partnerBookingId,
+        booking: input.payload,
+        partner: input.partnerPayload,
+      }),
+  });
+
   const submitPending =
-    mutations.createBooking.isPending || mutations.completeBooking.isPending;
+    mutations.createBooking.isPending ||
+    mutations.completeBooking.isPending ||
+    completePairMutation.isPending;
 
   // Block confirm until the authoritative server price is in hand — the client
   // estimate is display-only; booking on it would confirm an un-validated,
@@ -1024,7 +1263,13 @@ export default function GlCreateBookingForm() {
     capacityErrors.length > 0 ||
     containerClashErrors.length > 0 ||
     spaceErrors.length > 0 ||
-    !serverTotal;
+    !serverTotal ||
+    // Same bar for the shared-wagon partner: its authoritative price must be in
+    // hand and its own hard blocks clear before either booking is confirmed.
+    (consolidationActive &&
+      (validatePartnerMutation.isPending ||
+        !partnerTotal ||
+        partnerBlockers.length > 0));
 
   const openPriceModal = () => {
     // Surface the per-field errors (portal-parity validation) instead of
@@ -1040,6 +1285,15 @@ export default function GlCreateBookingForm() {
       validateShipmentMutation.reset();
       validateShipmentMutation.mutate(payload);
     }
+    validatePartnerMutation.reset();
+    const partnerPayload = buildPartnerPayload();
+    if (partnerPayload && partner?.contractId) {
+      validatePartnerMutation.mutate({
+        contractId: partner.contractId,
+        bookingId: partner.id,
+        dto: partnerPayload,
+      });
+    }
   };
 
   const handleSubmit = () => {
@@ -1055,6 +1309,25 @@ export default function GlCreateBookingForm() {
     const payload = buildPayload();
     if (!payload) return;
 
+    // Shared wagon: both halves complete together, all-or-nothing on the server.
+    if (consolidationActive && partner && completeBookingId) {
+      // A hard block on the partner's own price preview blocks the pair.
+      if (partnerBlockers.length > 0) return;
+      const partnerPayload = buildPartnerPayload();
+      if (!partnerPayload) return;
+      completePairMutation.mutate(
+        {
+          payload,
+          partnerPayload,
+          partnerBookingId: partner.id,
+        },
+        {
+          onSuccess: () => navigate(`/dashboard/clearance/${completeBookingId}`),
+        },
+      );
+      return;
+    }
+
     if (completeBookingId) {
       // Completion mode: cargo + day land on the already-cleared instance —
       // the request was linked and accepted at submission time.
@@ -1348,6 +1621,18 @@ export default function GlCreateBookingForm() {
                 maxRows={4}
                 styles={fieldStyles}
               />
+              {/* With a parent booking linked, each booking's containers are
+                  entered in its own labelled section, one after the other. */}
+              {splitView ? (
+                <Group gap={8} align="center">
+                  <Badge color="edr-green" variant="light" radius="sm">
+                    {completeBooking?.reference ?? "This booking"}
+                  </Badge>
+                  <Text fz={13} fw={600} c="#10202F">
+                    {completeBooking?.company?.name ?? "—"}
+                  </Text>
+                </Group>
+              ) : null}
               {containerLines.length === 0 ? (
                 <Text fz="sm" c="dimmed">
                   This contract has no container sizes in scope.
@@ -1527,7 +1812,71 @@ export default function GlCreateBookingForm() {
                 ))
               )}
 
-              {hasOdd20ft ? (
+              {hasOdd20ft && oddConsolidationAvailable ? (
+                <Alert
+                  color={consolidateOdd ? "edr-green" : "red"}
+                  variant="light"
+                  radius="md"
+                  icon={<AlertCircle size={16} />}
+                  title={`Odd number of 20ft containers (${ft20Total})`}
+                >
+                  <Stack gap={10}>
+                    <Text fz={13}>
+                      20ft containers travel two per wagon, so one container here
+                      is unpaired. On a customs booking you can pair it with
+                      another customer's odd booking and complete both onto the
+                      shared wagon — each booking is still priced and invoiced
+                      separately.
+                    </Text>
+                    <Switch
+                      checked={consolidateOdd}
+                      color="edr-green"
+                      label="Share a wagon with another booking"
+                      onChange={(e) => {
+                        consolidateTouchedRef.current = true;
+                        setConsolidateOdd(e.currentTarget.checked);
+                      }}
+                    />
+                    {consolidateOdd ? (
+                      <Group gap={10} align="center" wrap="wrap">
+                        <Button
+                          size="xs"
+                          radius="md"
+                          variant="light"
+                          color="edr-green"
+                          leftSection={<Link2 size={14} />}
+                          onClick={() => setPartnerPickerOpen(true)}
+                        >
+                          {partner
+                            ? `Parent booking: ${partner.reference} — change`
+                            : "Parent booking"}
+                        </Button>
+                        {partner ? (
+                          <Button
+                            size="xs"
+                            radius="md"
+                            variant="subtle"
+                            color="gray"
+                            onClick={() => {
+                              setPartner(null);
+                              setPartnerLines([]);
+                              setPartnerCargoDescription("");
+                            }}
+                          >
+                            Remove
+                          </Button>
+                        ) : null}
+                      </Group>
+                    ) : (
+                      <Text fz={12.5} c="red.7">
+                        With sharing off, book an even number of 20ft containers
+                        — add one more or remove one (e.g. {ft20Total + 1} or{" "}
+                        {ft20Total - 1} instead of {ft20Total}).
+                      </Text>
+                    )}
+                  </Stack>
+                </Alert>
+              ) : hasOdd20ft ? (
                 <Alert
                   color="red"
                   variant="light"
@@ -1541,6 +1890,34 @@ export default function GlCreateBookingForm() {
                   — the booking cannot be created with an unpaired 20ft container.
                 </Alert>
               ) : null}
+
+              {splitView && partner ? (
+                <>
+                  <Divider my={4} />
+                  <Group gap={8} align="center">
+                    <Badge color="blue" variant="light" radius="sm">
+                      {partner.reference}
+                    </Badge>
+                    <Text fz={13} fw={600} c="#10202F">
+                      {partner.companyName ?? "—"}
+                    </Text>
+                  </Group>
+                  <Text fz={12.5} c="dimmed">
+                    Parent booking — ships on the same day and train, billed to
+                    its own customer.
+                  </Text>
+                  <ConsolidationPartnerPanel
+                    lines={partnerLines}
+                    onLinesChange={setPartnerLines}
+                    cargoDescription={partnerCargoDescription}
+                    onCargoDescriptionChange={setPartnerCargoDescription}
+                    showHazardous={Boolean(contract.isHazardous)}
+                    showReefer={Boolean(contract.isReefer)}
+                    showErrors={showErrors}
+                    error={partnerError}
+                  />
+                </>
+              ) : null}
             </Stack>
           </StepCard>
         ) : (
@@ -1761,16 +2138,15 @@ export default function GlCreateBookingForm() {
               Billing currency
             </Text>
             <Text size="xs" c="dimmed" mb={8}>
-              {isIntercity
-                ? "Intercity shipments are invoiced in ETB."
-                : bookingRequest?.paymentCurrency
-                  ? "Requested by the customer on their shipment request."
-                  : "The contract is quoted in USD — pick the currency this shipment is invoiced in."}
+              {isImport
+                ? "Import shipments may be invoiced in ETB or USD. USD is paid by bank transfer, not online."
+                : "Shipments are invoiced in ETB."}
             </Text>
             <CurrencySelector
               value={isIntercity ? "ETB" : paymentCurrency}
               onChange={setPaymentCurrency}
               disabled={isIntercity}
+              allowUsd={isImport}
             />
           </Box>
 
@@ -1798,7 +2174,23 @@ export default function GlCreateBookingForm() {
         }}
       >
         <Box maw={896} mx="auto">
-          {showErrors && !formValid ? (
+          {/* The review button is disabled on an odd 20ft total, so the click
+              that would surface the errors never lands — state the reason here
+              rather than leaving it in a tooltip nobody hovers. */}
+          {oddBlocksSubmit ? (
+            <Alert
+              color="red"
+              variant="light"
+              radius="md"
+              icon={<AlertCircle size={16} />}
+              mb="sm"
+              title={`Odd number of 20ft containers (${ft20Total})`}
+            >
+              20ft containers travel two per wagon, so they must be booked in
+              even numbers. Add one more 20ft container or remove one — book{" "}
+              {ft20Total + 1} or {ft20Total - 1} instead of {ft20Total}.
+            </Alert>
+          ) : showErrors && !formValid ? (
             <Alert
               color="red"
               variant="light"
@@ -1808,12 +2200,31 @@ export default function GlCreateBookingForm() {
             >
               Fix the highlighted fields before reviewing the price.
             </Alert>
+          ) : partnerError ? (
+            // The review button is disabled while the parent booking is
+            // incomplete, so the click that would reveal the errors never
+            // lands — say what is outstanding without waiting for it.
+            <Alert
+              color="yellow"
+              variant="light"
+              radius="md"
+              icon={<AlertCircle size={16} />}
+              mb="sm"
+            >
+              {partnerError}
+            </Alert>
           ) : null}
           <Group justify="flex-end">
             <Tooltip
-              label={`Book an even number of 20ft containers — ${ft20Total} is odd and would leave one unpaired.`}
+              label={
+                oddBlocksSubmit
+                  ? `Book an even number of 20ft containers — ${ft20Total} is odd and would leave one unpaired.`
+                  : (partnerError ?? "")
+              }
               withArrow
-              disabled={!hasOdd20ft}
+              // Only explain a block that is actually in force: an odd count
+              // linked to a parent booking is resolved by the shared wagon.
+              disabled={!oddBlocksSubmit && !partnerError}
             >
               {/* Mantine tooltips get no pointer events from a disabled button,
                   so the wrapper carries the hover target. */}
@@ -1823,9 +2234,11 @@ export default function GlCreateBookingForm() {
                   radius="md"
                   leftSection={<Receipt size={16} />}
                   onClick={openPriceModal}
-                  // Same hard block the customer portal applies at review time —
-                  // an unpaired 20ft can never be planned onto a wagon.
-                  disabled={hasOdd20ft}
+                  // An unpaired 20ft can never be planned onto a wagon — unless
+                  // a parent booking is linked to share it, which is what
+                  // oddBlocksSubmit accounts for. The parent's own cargo must be
+                  // complete too, or there is nothing to price.
+                  disabled={oddBlocksSubmit || Boolean(partnerError)}
                 >
                   Review price &amp; book
                 </Button>
@@ -1835,6 +2248,24 @@ export default function GlCreateBookingForm() {
         </Box>
       </Box>
 
+      <ConsolidationPartnerPicker
+        opened={partnerPickerOpen}
+        onClose={() => setPartnerPickerOpen(false)}
+        candidates={candidatesQuery.data ?? []}
+        isLoading={candidatesQuery.isLoading}
+        isError={candidatesQuery.isError}
+        onSelect={(candidate) => {
+          setPartner(candidate);
+          // Seed a 20ft and a 40ft line. The parent booking sits on its OWN
+          // contract, whose size scope need not match this one's, so the panel
+          // offers both sizes rather than mirroring this contract's scope; a
+          // size the parent does not ship is simply left at 0.
+          setPartnerLines(PARTNER_SIZES.map(emptyPartnerLine));
+          setPartnerCargoDescription("");
+          setPartnerPickerOpen(false);
+        }}
+      />
+
       <Modal
         opened={priceOpen}
         onClose={() => {
@@ -1986,6 +2417,18 @@ export default function GlCreateBookingForm() {
             )}
 
             <Paper withBorder radius={16} p="lg" style={{ borderColor: "#E6ECF2" }}>
+              {/* Whose bill this is. Only worth naming when a second booking is
+                  on screen — on a lone booking there is nothing to confuse it with. */}
+              {consolidationActive && partner ? (
+                <Group gap={8} align="center" mb={12} wrap="wrap">
+                  <Badge color="edr-green" variant="light" radius="sm">
+                    {completeBooking?.reference ?? "This booking"}
+                  </Badge>
+                  <Text fz={13} fw={600} c="#10202F">
+                    {completeBooking?.company?.name ?? contract.company?.name ?? "—"}
+                  </Text>
+                </Group>
+              ) : null}
               <Stack gap={10}>
                 {displayTotal.lines.map((line, i) => (
                   <Group key={i} justify="space-between" wrap="nowrap" gap="sm">
@@ -2030,6 +2473,123 @@ export default function GlCreateBookingForm() {
               </Group>
             </Paper>
 
+            {consolidationActive && partner ? (
+              <Paper
+                withBorder
+                radius={16}
+                p="lg"
+                style={{ borderColor: "#E6ECF2" }}
+              >
+                <Group gap={8} align="center" mb={12} wrap="wrap">
+                  <Badge color="blue" variant="light" radius="sm">
+                    {partner.reference}
+                  </Badge>
+                  <Text fz={13} fw={600} c="#10202F">
+                    {partner.companyName ?? "—"}
+                  </Text>
+                </Group>
+
+                {validatePartnerMutation.isPending ? (
+                  <Group gap={8} c="dimmed">
+                    <Loader size="xs" color="edr-green" />
+                    <Text fz="sm" c="dimmed">
+                      Pricing the partner booking…
+                    </Text>
+                  </Group>
+                ) : partnerBlockers.length > 0 ? (
+                  <Alert
+                    color="red"
+                    variant="light"
+                    radius="md"
+                    icon={<AlertCircle size={16} />}
+                    title={`Cannot book ${partner.reference}`}
+                  >
+                    <Stack gap={6}>
+                      {partnerBlockers.map((msg, i) => (
+                        <Text key={i} fz="sm" c="red.8">
+                          {msg}
+                        </Text>
+                      ))}
+                      <Text fz="xs" c="red.7" mt={2}>
+                        Both bookings are confirmed together, so this must be
+                        fixed before either can be booked.
+                      </Text>
+                    </Stack>
+                  </Alert>
+                ) : partnerTotal ? (
+                  <>
+                    <Stack gap={10}>
+                      {partnerTotal.lines.map((line, i) => (
+                        <Group
+                          key={i}
+                          justify="space-between"
+                          wrap="nowrap"
+                          gap="sm"
+                        >
+                          <Box style={{ minWidth: 0 }}>
+                            <Text fz="sm" fw={500}>
+                              {line.label}
+                            </Text>
+                            <Text fz="xs" c="dimmed">
+                              {line.quantity.toLocaleString()} ×{" "}
+                              {line.unitPrice.toLocaleString()}{" "}
+                              {partnerTotal.currency} ·{" "}
+                              {formatRateUnit(line.unit)}
+                            </Text>
+                          </Box>
+                          <Text
+                            fz="sm"
+                            fw={600}
+                            style={{ whiteSpace: "nowrap" }}
+                          >
+                            {line.amount.toLocaleString()}{" "}
+                            {partnerTotal.currency}
+                          </Text>
+                        </Group>
+                      ))}
+                    </Stack>
+                    <Divider my="md" />
+                    <Group justify="space-between" align="flex-end">
+                      <Text
+                        fz="xs"
+                        fw={700}
+                        tt="uppercase"
+                        c="blue"
+                        style={{ letterSpacing: "0.06em" }}
+                      >
+                        Total
+                      </Text>
+                      <Text fw={800} fz={28}>
+                        {partnerTotal.total.toLocaleString()}{" "}
+                        <Text span fz={16} fw={700} c="dimmed">
+                          {partnerTotal.currency}
+                        </Text>
+                      </Text>
+                    </Group>
+                  </>
+                ) : (
+                  <Text fz="sm" c="dimmed">
+                    No price yet for the partner booking.
+                  </Text>
+                )}
+              </Paper>
+            ) : null}
+
+            {consolidationActive && partner ? (
+              <Alert
+                color="blue"
+                variant="light"
+                radius="md"
+                icon={<Link2 size={16} />}
+              >
+                <Text fz="sm">
+                  These two bookings share one wagon but stay separate: each is
+                  invoiced to its own customer and paid separately. Confirming
+                  books both together — if either fails, neither is booked.
+                </Text>
+              </Alert>
+            ) : null}
+
             <Group justify="space-between" mt="xs">
               <Button
                 variant="default"
@@ -2048,7 +2608,11 @@ export default function GlCreateBookingForm() {
                 disabled={confirmDisabled}
                 onClick={handleSubmit}
               >
-                {completeBookingId ? "Confirm & complete" : "Confirm & book"}
+                {consolidationActive && partner
+                  ? "Confirm & book both"
+                  : completeBookingId
+                    ? "Confirm & complete"
+                    : "Confirm & book"}
               </Button>
             </Group>
           </Stack>
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/LogoUpload.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/LogoUpload.tsx
new file mode 100644
index 000000000..f8ffe0fd0
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/LogoUpload.tsx
@@ -0,0 +1,172 @@
+import { useRef, useState } from "react";
+import { Box, Button, Group, Image, Paper, Stack, Text } from "@mantine/core";
+import { ImageIcon, RefreshCw, X } from "lucide-react";
+
+const MAX_LOGO_MB = 10;
+
+export interface LogoUploadProps {
+  /** Logo image as a data URL, or null when none is attached yet. */
+  value: string | null;
+  onChange: (dataUrl: string | null) => void;
+  label?: string;
+  description?: string;
+}
+
+/**
+ * Company logo picker — reads the picked image straight into a data URL,
+ * same transport as {@link StampUpload}. Kept as its own component (not a
+ * generalized image-upload) matching how stamp/teeter are already separate
+ * files here despite the near-identical shape.
+ */
+export function LogoUpload({
+  value,
+  onChange,
+  label = "Company logo",
+  description = "Attach the official company logo.",
+}: LogoUploadProps) {
+  const inputRef = useRef<HTMLInputElement>(null);
+  const [dragging, setDragging] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [fileName, setFileName] = useState<string | null>(null);
+
+  const readFile = (file: File | undefined | null) => {
+    if (!file) return;
+    if (!file.type.startsWith("image/")) {
+      setError("The logo must be an image file (PNG or JPG).");
+      return;
+    }
+    if (file.size > MAX_LOGO_MB * 1024 * 1024) {
+      setError(`The logo image must be under ${MAX_LOGO_MB} MB.`);
+      return;
+    }
+    const reader = new FileReader();
+    reader.onload = () => {
+      setError(null);
+      setFileName(file.name);
+      onChange(typeof reader.result === "string" ? reader.result : null);
+    };
+    reader.onerror = () => setError("Could not read that file. Try another.");
+    reader.readAsDataURL(file);
+  };
+
+  const openPicker = () => inputRef.current?.click();
+
+  const clear = () => {
+    setFileName(null);
+    setError(null);
+    onChange(null);
+    if (inputRef.current) inputRef.current.value = "";
+  };
+
+  return (
+    <Stack gap={6}>
+      <Text size="sm" fw={500}>
+        {label}
+      </Text>
+
+      <input
+        ref={inputRef}
+        type="file"
+        accept="image/png,image/jpeg,image/webp"
+        hidden
+        onChange={(e) => readFile(e.currentTarget.files?.[0])}
+      />
+
+      {value ? (
+        <Paper withBorder radius="md" p="sm">
+          <Group gap="md" wrap="nowrap" align="center">
+            <Box
+              style={{
+                background:
+                  "repeating-conic-gradient(var(--mantine-color-gray-1) 0% 25%, transparent 0% 50%) 50% / 14px 14px",
+                borderRadius: 8,
+                flexShrink: 0,
+                padding: 6,
+              }}
+            >
+              <Image
+                src={value}
+                alt="Company logo"
+                fit="contain"
+                h={92}
+                w={92}
+              />
+            </Box>
+            <Stack gap={4} style={{ flex: 1, minWidth: 0 }}>
+              <Text size="sm" fw={500} truncate>
+                {fileName ?? "Logo attached"}
+              </Text>
+              <Text size="xs" c="dimmed">
+                Shown in the header of every generated document.
+              </Text>
+              <Group gap="xs" mt={2}>
+                <Button
+                  size="compact-xs"
+                  variant="light"
+                  color="edr-green"
+                  leftSection={<RefreshCw size={13} />}
+                  onClick={openPicker}
+                >
+                  Replace
+                </Button>
+                <Button
+                  size="compact-xs"
+                  variant="subtle"
+                  color="red"
+                  leftSection={<X size={13} />}
+                  onClick={clear}
+                >
+                  Remove
+                </Button>
+              </Group>
+            </Stack>
+          </Group>
+        </Paper>
+      ) : (
+        <Paper
+          withBorder
+          radius="md"
+          p="lg"
+          onClick={openPicker}
+          onDragOver={(e) => {
+            e.preventDefault();
+            setDragging(true);
+          }}
+          onDragLeave={() => setDragging(false)}
+          onDrop={(e) => {
+            e.preventDefault();
+            setDragging(false);
+            readFile(e.dataTransfer.files?.[0]);
+          }}
+          style={{
+            borderColor: dragging
+              ? "var(--mantine-color-edr-green-6)"
+              : undefined,
+            borderStyle: "dashed",
+            backgroundColor: dragging
+              ? "var(--mantine-color-edr-green-0)"
+              : undefined,
+            cursor: "pointer",
+          }}
+        >
+          <Stack gap={6} align="center">
+            <ImageIcon size={26} color="var(--mantine-color-edr-green-6)" />
+            <Text size="sm" fw={500}>
+              Upload company logo
+            </Text>
+            <Text size="xs" c="dimmed" ta="center">
+              {description} Drop an image here or click to browse — PNG or JPG,
+              up to {MAX_LOGO_MB} MB.
+            </Text>
+          </Stack>
+        </Paper>
+      )}
+
+      {error && (
+        <Text size="xs" c="red.7">
+          {error}
+        </Text>
+      )}
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/PhasedClearanceActionPanel.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/PhasedClearanceActionPanel.tsx
index 926637db2..4b44edda6 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/PhasedClearanceActionPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/PhasedClearanceActionPanel.tsx
@@ -34,12 +34,15 @@ import {
   Truck,
   Upload,
 } from "lucide-react";
-import type { Freight } from "@edr/types";
+import {
+  deliveryOrderFileLabel,
+  isDeliveryOrderFileCode,
+  type Freight,
+} from "@edr/types";
 import toast from "react-hot-toast";
 
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
 import { ExportClearanceStepper } from "@/components/contracts/ExportClearanceStepper";
-import { PhasedDocumentUploadField } from "@/components/contracts/PhasedDocumentUploadField";
 import {
   DoCollectionDateFields,
   doDatesComplete,
@@ -2133,56 +2136,82 @@ function DeliveryOrderStep({
   onViewFile?: (file: { name: string; url: string }) => void;
   onDownloadFile?: (file: { id: string; name: string }) => void;
 }) {
-  const [files, setFiles] = useState<Record<string, File | null>>({
-    delivery_order: null,
-  });
+  const [files, setFiles] = useState<File[]>([]);
   const [doDates, setDoDates] = useDoCollectionDates({
     vesselArrivalDate,
     doCollectedDate,
   });
   const [loading, setLoading] = useState(false);
-  const hasFile = Boolean(files.delivery_order);
+
+  const submit = async () => {
+    if (files.length === 0 || !doDatesComplete(doDates)) return;
+    const dates = {
+      vesselArrivalDate: toIsoDate(doDates.vesselArrival)!,
+      doCollectedDate: toIsoDate(doDates.doCollected)!,
+    };
+    setLoading(true);
+    try {
+      if (isBooking) {
+        await bookingsService.uploadDeliveryOrder(entityId, files, dates);
+      } else {
+        await contractsService.uploadDeliveryOrder(entityId, files, dates);
+      }
+      setFiles([]);
+      toast.success(replaceMode ? "Delivery Order updated" : "Delivery Order uploaded");
+      onChanged?.();
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "Upload failed");
+    } finally {
+      setLoading(false);
+    }
+  };
 
   return (
-    <PhasedDocumentUploadField
-      fields={[{ key: "delivery_order", label: "Delivery Order" }]}
-      files={files}
-      onChange={(key, file) => setFiles((prev) => ({ ...prev, [key]: file }))}
-      workflowFiles={workflowFiles}
-      replaceMode={replaceMode}
-      loading={loading}
-      disabled={!hasFile || !doDatesComplete(doDates)}
-      helperText="Upload the Djibouti Delivery Order (DO) and record when the vessel arrived and when the DO was collected."
-      submitLabel={replaceMode ? "Replace DO" : "Upload DO"}
-      extraFields={
-        <DoCollectionDateFields value={doDates} onChange={setDoDates} />
-      }
-      onViewFile={onViewFile}
-      onDownloadFile={onDownloadFile}
-      onSubmit={async () => {
-        const file = files.delivery_order;
-        if (!file || !doDatesComplete(doDates)) return;
-        const dates = {
-          vesselArrivalDate: toIsoDate(doDates.vesselArrival)!,
-          doCollectedDate: toIsoDate(doDates.doCollected)!,
-        };
-        setLoading(true);
-        try {
-          if (isBooking) {
-            await bookingsService.uploadDeliveryOrder(entityId, file, dates);
-          } else {
-            await contractsService.uploadDeliveryOrder(entityId, file, dates);
-          }
-          setFiles({ delivery_order: null });
-          toast.success(replaceMode ? "Delivery Order updated" : "Delivery Order uploaded");
-          onChanged?.();
-        } catch (e) {
-          toast.error(e instanceof Error ? e.message : "Upload failed");
-        } finally {
-          setLoading(false);
+    <Stack gap="sm">
+      <Text size="sm" c="dimmed">
+        Upload the Djibouti Delivery Order (DO) and record when the vessel arrived and when the
+        DO was collected. Add as many files as needed.
+      </Text>
+
+      {workflowFiles
+        .filter((wf) => isDeliveryOrderFileCode(wf.code) && wf.file)
+        .map((wf, index) => (
+          <PhasedUploadedFileRow
+            key={wf.code}
+            label={deliveryOrderFileLabel(wf.code, index)}
+            file={wf.file!}
+            onView={onViewFile}
+            onDownload={onDownloadFile}
+          />
+        ))}
+
+      <DoCollectionDateFields value={doDates} onChange={setDoDates} />
+
+      <PhasedMultiFileDropzone
+        label="Delivery Order files"
+        description={
+          replaceMode
+            ? "Replace the DO — upload one or more files (any file type)."
+            : "Upload one or more Delivery Order files (any file type)."
         }
-      }}
-    />
+        accept="*/*"
+        value={files}
+        onChange={setFiles}
+        replaceMode={replaceMode}
+        disabled={loading}
+      />
+
+      <Button
+        color="edr-green"
+        loading={loading}
+        disabled={files.length === 0 || !doDatesComplete(doDates)}
+        leftSection={<Upload size={16} />}
+        fullWidth
+        onClick={() => void submit()}
+      >
+        {replaceMode ? "Replace DO" : "Upload DO"}
+      </Button>
+    </Stack>
   );
 }
 
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/detail/ContractDetailTabCards.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/detail/ContractDetailTabCards.tsx
index de8ff1953..5d875d98e 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/detail/ContractDetailTabCards.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/detail/ContractDetailTabCards.tsx
@@ -30,6 +30,7 @@ import { clearanceWorkflowFileLabel } from "@edr/types";
 
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
 import { detailStyles } from "@/components/bookings/detail/booking-detail.styles";
+import { LinkedEntityCard } from "@/components/detail";
 import { customersService } from "@/services/customers.service";
 
 type ContractFile = NonNullable<Freight.IContract["files"]>[number];
@@ -141,25 +142,23 @@ export function ContractCustomerCard({
 
   return (
     <Stack gap="lg">
-      <SectionCard
+      <LinkedEntityCard
         icon={Building2}
         title="Customer"
-        subtitle={company.name}
+        name={company.name ?? "Unnamed company"}
+        to={`/dashboard/customers/${company.id}`}
         accent="blue"
-      >
-        <InfoRows
-          rows={[
-            { icon: FileCheck, label: "TIN", value: company.tin },
-            { icon: Hash, label: "VAT number", value: company.vatNumber },
-            { icon: ShieldCheck, label: "FAN number", value: company.fanNumber },
-            { icon: Globe, label: "Country", value: company.country },
-            { icon: Mail, label: "Email", value: company.email },
-            { icon: Phone, label: "Phone", value: company.phone },
-            { icon: MapPin, label: "Address", value: company.address },
-            { icon: Globe, label: "Website", value: company.website },
-          ]}
-        />
-      </SectionCard>
+        rows={[
+          { icon: FileCheck, label: "TIN", value: company.tin },
+          { icon: Hash, label: "VAT number", value: company.vatNumber },
+          { icon: ShieldCheck, label: "FAN number", value: company.fanNumber },
+          { icon: Globe, label: "Country", value: company.country },
+          { icon: Mail, label: "Email", value: company.email },
+          { icon: Phone, label: "Phone", value: company.phone },
+          { icon: MapPin, label: "Address", value: company.address },
+          { icon: Globe, label: "Website", value: company.website },
+        ]}
+      />
 
       <SectionCard icon={User} title="Contact person" accent="teal">
         <InfoRows
@@ -170,12 +169,13 @@ export function ContractCustomerCard({
         />
       </SectionCard>
 
-      <SectionCard icon={User} title="General manager" accent="grape">
+      {/* Whoever the eTrade licence names as the business's manager. */}
+      <SectionCard icon={User} title="Owner" accent="grape">
         <InfoRows
           rows={[
-            { icon: User, label: "Name", value: company.generalManagerName },
-            { icon: Mail, label: "Email", value: company.generalManagerEmail },
-            { icon: Phone, label: "Phone", value: company.generalManagerPhone },
+            { icon: User, label: "Name", value: company.ownerName },
+            { icon: Mail, label: "Email", value: company.ownerEmail },
+            { icon: Phone, label: "Phone", value: company.ownerPhone },
           ]}
         />
       </SectionCard>
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/detail/RequestDetailCards.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/detail/RequestDetailCards.tsx
index d8c5f819a..1469e06e3 100644
--- a/apps/edr-freight-web/backoffice/src/components/contracts/detail/RequestDetailCards.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/detail/RequestDetailCards.tsx
@@ -12,56 +12,14 @@ import {
   User,
   Warehouse,
 } from "lucide-react";
-import { Badge, Box, Divider, Group, Stack, Text } from "@mantine/core";
+import { Badge, Box, Group, Stack, Text } from "@mantine/core";
 import type { Freight } from "@edr/types";
 
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
+import { LinkedEntityCard } from "@/components/detail";
 
 type ReqContract = NonNullable<Freight.IBookingRequest["contract"]>;
 
-interface InfoRowProps {
-  icon: LucideIcon;
-  label: string;
-  value?: string | null;
-}
-
-function InfoRow({ icon: Icon, label, value }: InfoRowProps) {
-  return (
-    <Group justify="space-between" wrap="nowrap" py={6} gap="md">
-      <Group gap="xs" wrap="nowrap">
-        <Icon size={15} color="var(--mantine-color-gray-5)" />
-        <Text size="sm" c="dimmed">
-          {label}
-        </Text>
-      </Group>
-      <Text size="sm" fw={600} ta="right" style={{ minWidth: 0 }} truncate>
-        {value || "—"}
-      </Text>
-    </Group>
-  );
-}
-
-function InfoRows({ rows }: { rows: InfoRowProps[] }) {
-  const visible = rows.filter((r) => r.value);
-  if (visible.length === 0) {
-    return (
-      <Text size="sm" c="dimmed">
-        No details available.
-      </Text>
-    );
-  }
-  return (
-    <Stack gap={0}>
-      {visible.map((row, i) => (
-        <div key={row.label}>
-          {i > 0 && <Divider color="var(--mantine-color-gray-2)" />}
-          <InfoRow {...row} />
-        </div>
-      ))}
-    </Stack>
-  );
-}
-
 /** Customer (company) on the request's contract. */
 export function RequestCustomerCard({ contract }: { contract?: ReqContract | null }) {
   const company = contract?.company;
@@ -75,23 +33,21 @@ export function RequestCustomerCard({ contract }: { contract?: ReqContract | nul
     );
   }
   return (
-    <SectionCard
+    <LinkedEntityCard
       icon={Building2}
       title="Customer"
-      subtitle={company.name ?? undefined}
+      name={company.name ?? "Unnamed company"}
+      to={company.id ? `/dashboard/customers/${company.id}` : null}
       accent="blue"
-    >
-      <InfoRows
-        rows={[
-          { icon: FileCheck, label: "TIN", value: company.tin },
-          { icon: Mail, label: "Email", value: company.email },
-          { icon: Phone, label: "Phone", value: company.phone },
-          { icon: MapPin, label: "Address", value: company.address },
-          { icon: User, label: "Contact", value: company.contactPersonName },
-          { icon: Phone, label: "Contact phone", value: company.contactPersonPhone },
-        ]}
-      />
-    </SectionCard>
+      rows={[
+        { icon: FileCheck, label: "TIN", value: company.tin },
+        { icon: Mail, label: "Email", value: company.email },
+        { icon: Phone, label: "Phone", value: company.phone },
+        { icon: MapPin, label: "Address", value: company.address },
+        { icon: User, label: "Contact", value: company.contactPersonName },
+        { icon: Phone, label: "Contact phone", value: company.contactPersonPhone },
+      ]}
+    />
   );
 }
 
@@ -119,43 +75,41 @@ export function RequestContractSummaryCard({
 }) {
   if (!contract) return null;
   return (
-    <SectionCard
+    <LinkedEntityCard
       icon={FileText}
       title="Contract"
-      subtitle={contract.reference}
+      name={contract.reference}
+      to={`/dashboard/contract-requests/${contract.id}`}
       accent="grape"
-    >
-      <InfoRows
-        rows={[
-          {
-            icon: FileText,
-            label: "Kind",
-            value: contract.contractKind === "GENERAL" ? "General" : "One-time",
-          },
-          {
-            icon: Package,
-            label: "Cargo",
-            value: contract.freightType === "CONTAINER" ? "Container" : "Bulk",
-          },
-          { icon: Ship, label: "Trade", value: titleCase(contract.tradeDirection) },
-          { icon: FileCheck, label: "Currency", value: contract.paymentCurrency },
-          {
-            icon: FileCheck,
-            label: "Customs",
-            value: contract.customsClearingEnabled
-              ? "Included (Global Logistics)"
-              : "Not included",
-          },
-          {
-            icon: FileText,
-            label: "Valid until",
-            value: contract.contractValidUntil
-              ? fmtDate(contract.contractValidUntil)
-              : "Not active yet",
-          },
-        ]}
-      />
-    </SectionCard>
+      rows={[
+        {
+          icon: FileText,
+          label: "Kind",
+          value: contract.contractKind === "GENERAL" ? "General" : "One-time",
+        },
+        {
+          icon: Package,
+          label: "Cargo",
+          value: contract.freightType === "CONTAINER" ? "Container" : "Bulk",
+        },
+        { icon: Ship, label: "Trade", value: titleCase(contract.tradeDirection) },
+        { icon: FileCheck, label: "Currency", value: contract.paymentCurrency },
+        {
+          icon: FileCheck,
+          label: "Customs",
+          value: contract.customsClearingEnabled
+            ? "Included (Global Logistics)"
+            : "Not included",
+        },
+        {
+          icon: FileText,
+          label: "Valid until",
+          value: contract.contractValidUntil
+            ? fmtDate(contract.contractValidUntil)
+            : "Not active yet",
+        },
+      ]}
+    />
   );
 }
 
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/gl-booking-form/ConsolidationPartnerPanel.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/gl-booking-form/ConsolidationPartnerPanel.tsx
new file mode 100644
index 000000000..e52cce097
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/gl-booking-form/ConsolidationPartnerPanel.tsx
@@ -0,0 +1,255 @@
+import { type KeyboardEvent } from "react";
+import {
+  Box,
+  Checkbox,
+  Group,
+  Stack,
+  Text,
+  TextInput,
+} from "@mantine/core";
+
+/**
+ * Container editor for the PARTNER half of a shared wagon. Deliberately a
+ * reduced version of the main form's editor: the partner contributes only cargo
+ * — route, shipment day and train are inherited from the booking it shares the
+ * wagon with, and hazardous/reefer/return counts are derived from the per-unit
+ * ticks rather than typed line totals.
+ */
+
+export interface PartnerUnitDraft {
+  containerNumber: string;
+  sealNumber: string;
+  vgmTons: string;
+  isHazardous: boolean;
+  isReefer: boolean;
+  isReturn: boolean;
+}
+
+export interface PartnerLineDraft {
+  containerSize: string;
+  quantity: string;
+  hazardousQuantity: string;
+  reeferQuantity: string;
+  returnQuantity: string;
+  units: PartnerUnitDraft[];
+}
+
+export function emptyPartnerUnit(): PartnerUnitDraft {
+  return {
+    containerNumber: "",
+    sealNumber: "",
+    vgmTons: "",
+    isHazardous: false,
+    isReefer: false,
+    isReturn: false,
+  };
+}
+
+export function emptyPartnerLine(size: string): PartnerLineDraft {
+  return {
+    containerSize: size,
+    quantity: "0",
+    hazardousQuantity: "0",
+    reeferQuantity: "0",
+    returnQuantity: "0",
+    units: [],
+  };
+}
+
+/** Quantities are magnitudes — swallow the minus key before it reaches the field. */
+const blockNegative = (event: KeyboardEvent<HTMLInputElement>) => {
+  if (event.key === "-") event.preventDefault();
+};
+
+/** Grow or shrink a line's unit rows to match its quantity. */
+function syncUnits(line: PartnerLineDraft, quantity: number): PartnerLineDraft {
+  const target = Math.max(0, Math.floor(quantity) || 0);
+  const units = [...line.units];
+  while (units.length < target) units.push(emptyPartnerUnit());
+  units.length = target;
+  return {
+    ...line,
+    units,
+    hazardousQuantity: String(units.filter((u) => u.isHazardous).length),
+    reeferQuantity: String(units.filter((u) => u.isReefer).length),
+  };
+}
+
+interface Props {
+  lines: PartnerLineDraft[];
+  onLinesChange: (lines: PartnerLineDraft[]) => void;
+  cargoDescription: string;
+  onCargoDescriptionChange: (value: string) => void;
+  /** Whether per-container hazardous / refrigerated ticks apply. */
+  showHazardous: boolean;
+  showReefer: boolean;
+  /** Surface field errors only after the operator tried to continue. */
+  showErrors: boolean;
+  error?: string;
+}
+
+export function ConsolidationPartnerPanel({
+  lines,
+  onLinesChange,
+  cargoDescription,
+  onCargoDescriptionChange,
+  showHazardous,
+  showReefer,
+  showErrors,
+  error,
+}: Props) {
+  const patchLine = (index: number, patch: Partial<PartnerLineDraft>) => {
+    onLinesChange(
+      lines.map((line, i) => (i === index ? { ...line, ...patch } : line)),
+    );
+  };
+
+  const patchUnit = (
+    lineIndex: number,
+    unitIndex: number,
+    patch: Partial<PartnerUnitDraft>,
+  ) => {
+    onLinesChange(
+      lines.map((line, i) => {
+        if (i !== lineIndex) return line;
+        const units = line.units.map((unit, u) =>
+          u === unitIndex ? { ...unit, ...patch } : unit,
+        );
+        return {
+          ...line,
+          units,
+          hazardousQuantity: String(units.filter((u) => u.isHazardous).length),
+          reeferQuantity: String(units.filter((u) => u.isReefer).length),
+        };
+      }),
+    );
+  };
+
+  return (
+    <Stack gap={14}>
+      {error && showErrors ? (
+        <Text fz={12.5} c="red.7">
+          {error}
+        </Text>
+      ) : null}
+
+      {lines.map((line, lineIdx) => (
+        <Box
+          key={`${line.containerSize}-${lineIdx}`}
+          className="rounded-xl"
+          style={{ border: "1px solid #E6ECF2", padding: 16 }}
+        >
+          <Text fz={14} fw={700} mb={10}>
+            {line.containerSize} containers
+          </Text>
+
+          <TextInput
+            type="number"
+            onKeyDown={blockNegative}
+            label="Quantity *"
+            min={0}
+            value={line.quantity}
+            onChange={(e) => patchLine(lineIdx, { quantity: e.currentTarget.value })}
+            // Sync off the typed value, not the captured `line` — that snapshot
+            // still holds the pre-edit quantity and would write it back.
+            onBlur={(e) => {
+              const typed = e.currentTarget.value;
+              patchLine(lineIdx, {
+                ...syncUnits({ ...line, quantity: typed }, Number(typed || 0)),
+                quantity: typed,
+              });
+            }}
+            mb={12}
+          />
+
+          {line.units.map((unit, unitIdx) => (
+            <Box key={unitIdx} mb={10}>
+              <Text fz={12} fw={600} c="#5B6B7B" mb={6}>
+                Container {unitIdx + 1}
+              </Text>
+              <Group gap={12} grow align="flex-start">
+                <TextInput
+                  label="Container number *"
+                  placeholder="e.g. MSCU1234567"
+                  value={unit.containerNumber}
+                  error={
+                    showErrors && !unit.containerNumber.trim()
+                      ? "Required."
+                      : undefined
+                  }
+                  onChange={(e) =>
+                    patchUnit(lineIdx, unitIdx, {
+                      containerNumber: e.currentTarget.value.toUpperCase(),
+                    })
+                  }
+                />
+                <TextInput
+                  label="Seal number"
+                  value={unit.sealNumber}
+                  onChange={(e) =>
+                    patchUnit(lineIdx, unitIdx, {
+                      sealNumber: e.currentTarget.value,
+                    })
+                  }
+                />
+                <TextInput
+                  type="number"
+                  onKeyDown={blockNegative}
+                  label="VGM (tons) *"
+                  min={0}
+                  value={unit.vgmTons}
+                  error={
+                    showErrors && !(Number(unit.vgmTons) > 0)
+                      ? "Required."
+                      : undefined
+                  }
+                  onChange={(e) =>
+                    patchUnit(lineIdx, unitIdx, { vgmTons: e.currentTarget.value })
+                  }
+                />
+              </Group>
+              {showHazardous || showReefer ? (
+                <Group gap={16} mt={8}>
+                  {showHazardous ? (
+                    <Checkbox
+                      size="xs"
+                      label="Hazardous"
+                      checked={unit.isHazardous}
+                      onChange={(e) =>
+                        patchUnit(lineIdx, unitIdx, {
+                          isHazardous: e.currentTarget.checked,
+                        })
+                      }
+                    />
+                  ) : null}
+                  {showReefer ? (
+                    <Checkbox
+                      size="xs"
+                      label="Refrigerated"
+                      checked={unit.isReefer}
+                      onChange={(e) =>
+                        patchUnit(lineIdx, unitIdx, {
+                          isReefer: e.currentTarget.checked,
+                        })
+                      }
+                    />
+                  ) : null}
+                </Group>
+              ) : null}
+            </Box>
+          ))}
+        </Box>
+      ))}
+
+      <TextInput
+        label="Cargo description *"
+        placeholder="What these containers carry"
+        value={cargoDescription}
+        error={
+          showErrors && !cargoDescription.trim() ? "Required." : undefined
+        }
+        onChange={(e) => onCargoDescriptionChange(e.currentTarget.value)}
+      />
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/contracts/gl-booking-form/ConsolidationPartnerPicker.tsx b/apps/edr-freight-web/backoffice/src/components/contracts/gl-booking-form/ConsolidationPartnerPicker.tsx
new file mode 100644
index 000000000..c20c08994
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/contracts/gl-booking-form/ConsolidationPartnerPicker.tsx
@@ -0,0 +1,137 @@
+import {
+  Alert,
+  Badge,
+  Box,
+  Button,
+  Center,
+  Group,
+  Loader,
+  Modal,
+  Stack,
+  Text,
+  ThemeIcon,
+} from "@mantine/core";
+import { AlertCircle, Link2 } from "lucide-react";
+
+import type { ConsolidationCandidate } from "@/services/contracts.service";
+
+/**
+ * Picker for the booking that shares this booking's wagon. The server has
+ * already narrowed the list to bookings that can legally pair — same route and
+ * direction, customs clearing, an odd 20ft count of their own and not already
+ * linked to someone else — so every row here is a valid choice.
+ */
+interface Props {
+  opened: boolean;
+  onClose: () => void;
+  candidates: ConsolidationCandidate[];
+  isLoading: boolean;
+  isError: boolean;
+  onSelect: (candidate: ConsolidationCandidate) => void;
+}
+
+export function ConsolidationPartnerPicker({
+  opened,
+  onClose,
+  candidates,
+  isLoading,
+  isError,
+  onSelect,
+}: Props) {
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      centered
+      radius="lg"
+      size="lg"
+      title={
+        <Group gap={10}>
+          <ThemeIcon variant="light" color="blue" radius="md" size={34}>
+            <Link2 size={18} />
+          </ThemeIcon>
+          <Box>
+            <Text fw={800} fz={16}>
+              Pick the parent booking
+            </Text>
+            <Text fz="xs" c="dimmed">
+              Customs bookings on the same route that also carry an odd number of
+              20ft containers.
+            </Text>
+          </Box>
+        </Group>
+      }
+    >
+      {isLoading ? (
+        <Center py="xl">
+          <Loader size="sm" color="edr-green" />
+        </Center>
+      ) : isError ? (
+        <Alert
+          color="red"
+          variant="light"
+          radius="md"
+          icon={<AlertCircle size={16} />}
+        >
+          Could not load the candidate bookings. Close this and try again.
+        </Alert>
+      ) : candidates.length === 0 ? (
+        <Alert
+          color="yellow"
+          variant="light"
+          radius="md"
+          icon={<AlertCircle size={16} />}
+          title="No booking available to share this wagon"
+        >
+          <Text fz="sm">
+            No other customs booking on this route currently carries an odd
+            number of 20ft containers. Either wait for one, or switch the
+            shared-wagon option off and book an even number of 20ft containers.
+          </Text>
+        </Alert>
+      ) : (
+        <Stack gap={10}>
+          {candidates.map((candidate) => (
+            <Box
+              key={candidate.id}
+              className="rounded-xl"
+              style={{ border: "1px solid #E6ECF2", padding: 14 }}
+            >
+              <Group justify="space-between" align="center" wrap="wrap" gap={10}>
+                <Box style={{ minWidth: 0 }}>
+                  <Group gap={8} align="center" wrap="wrap">
+                    <Text fz={14} fw={700} c="#10202F">
+                      {candidate.reference}
+                    </Text>
+                    <Badge size="sm" variant="light" color="gray" radius="sm">
+                      {candidate.status.replaceAll("_", " ")}
+                    </Badge>
+                  </Group>
+                  <Text fz={12.5} c="dimmed" mt={2}>
+                    {candidate.companyName ?? "—"}
+                    {candidate.tradeDirection
+                      ? ` · ${candidate.tradeDirection}`
+                      : ""}
+                    {" · "}
+                    {candidate.hasCargo
+                      ? `${candidate.ft20Quantity} × 20ft`
+                      : "cargo not entered yet"}
+                  </Text>
+                </Box>
+                <Button
+                  size="xs"
+                  radius="md"
+                  variant="light"
+                  color="edr-green"
+                  onClick={() => onSelect(candidate)}
+                >
+                  Select
+                </Button>
+              </Group>
+            </Box>
+          ))}
+        </Stack>
+      )}
+    </Modal>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/ChangeRequestReview.tsx b/apps/edr-freight-web/backoffice/src/components/customers/ChangeRequestReview.tsx
index 196161f92..7f4cf30ce 100644
--- a/apps/edr-freight-web/backoffice/src/components/customers/ChangeRequestReview.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/customers/ChangeRequestReview.tsx
@@ -20,11 +20,10 @@ import {
   FileX2,
 } from "lucide-react";
 import { useState } from "react";
-import { useFileViewer } from "@edr/ui-common";
 
 import { useAuth } from "@/auth/useAuth";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
-import { fetchViewableFile } from "@/services/files.service";
+import { openFileInNewTab } from "@/services/files.service";
 import { api } from "@/services/api";
 import type { Company } from "@/types/customer";
 import { formatDate, humanize } from "./format";
@@ -32,8 +31,6 @@ import { formatDate, humanize } from "./format";
 /** Friendly labels for the proposed-change snapshot keys (UpdateProfileDto). */
 export const FIELD_LABELS: Record<string, string> = {
   companyName: "Company name",
-  companyEmail: "Company email",
-  companyPhone: "Company phone",
   companyLocation: "Location",
   companyAddress: "Address",
   tin: "TIN",
@@ -45,9 +42,17 @@ export const FIELD_LABELS: Record<string, string> = {
   contactPersonPosition: "Contact position",
   contactPersonEmail: "Contact email",
   contactPersonPhone: "Contact phone",
-  generalManagerName: "General manager",
-  generalManagerEmail: "GM email",
-  generalManagerPhone: "GM phone",
+  ownerName: "Owner name",
+  ownerEmail: "Owner email",
+  ownerPhone: "Owner phone",
+  poaDeclared: "Has a Power of Attorney",
+  poaPassportNumber: "PoA passport number",
+  // Nothing writes these any more — the general manager was removed — but
+  // change requests filed before that still carry them, and without a label
+  // the reviewer sees a raw attribute key.
+  generalManagerName: "General manager (retired)",
+  generalManagerEmail: "GM email (retired)",
+  generalManagerPhone: "GM phone (retired)",
   poaName: "PoA name",
   poaPhone: "PoA phone",
   poaEmail: "PoA email",
@@ -73,8 +78,6 @@ export function currentValue(company: Company, key: string): string {
   const attrs = (company.attributes ?? {}) as Record<string, unknown>;
   const map: Record<string, unknown> = {
     companyName: c.name,
-    companyEmail: c.email,
-    companyPhone: c.phone,
     companyLocation: c.country,
     companyAddress: c.address,
     tin: c.tin,
@@ -83,9 +86,9 @@ export function currentValue(company: Company, key: string): string {
     nationality: c.nationality,
     contactPersonName: c.contactPersonName ?? attrs.contactPersonName,
     contactPersonPhone: c.contactPersonPhone ?? attrs.contactPersonPhone,
-    generalManagerName: c.generalManagerName ?? attrs.generalManagerName,
-    generalManagerEmail: c.generalManagerEmail ?? attrs.generalManagerEmail,
-    generalManagerPhone: c.generalManagerPhone ?? attrs.generalManagerPhone,
+    ownerName: c.ownerName ?? attrs.ownerName,
+    ownerEmail: c.ownerEmail ?? attrs.ownerEmail,
+    ownerPhone: c.ownerPhone ?? attrs.ownerPhone,
   };
   const v = key in map ? map[key] : (c[key] ?? attrs[key]);
   return v === null || v === undefined || v === "" ? "—" : String(v);
@@ -118,7 +121,8 @@ function FaydaIdentityDiff({
   if (!subject) return null;
   const current =
     subject === "owner" ? company.identity?.owner : company.identity?.poa;
-  const read = (key: string) => snapshot[`${subject}${key}`] as string | undefined;
+  const read = (key: string) =>
+    snapshot[`${subject}${key}`] as string | undefined;
   const verifiedAt = read("FaydaVerifiedAt");
   const fields: { label: string; from?: string | null; to?: string }[] = [
     { label: "Name", from: current?.name, to: read("Name") },
@@ -131,7 +135,9 @@ function FaydaIdentityDiff({
     <Stack gap={8}>
       <Group gap={8}>
         <Text size="sm" fw={600} c="edr-text">
-          {subject === "owner" ? "Owner re-verification" : "PoA re-verification"}
+          {subject === "owner"
+            ? "Owner re-verification"
+            : "PoA re-verification"}
         </Text>
         {verifiedAt && (
           <Text size="xs" c="dimmed">
@@ -220,7 +226,6 @@ export function ChangeRequestReview({ company }: { company: Company }) {
     api.customers.requestChangeRequestChanges.mutationOptions(),
   );
 
-  const { view, viewer } = useFileViewer();
   const [actionTarget, setActionTarget] = useState<{
     id: string;
     kind: "reject" | "request-changes";
@@ -283,8 +288,8 @@ export function ChangeRequestReview({ company }: { company: Company }) {
                 icon={<AlertTriangle size={16} />}
               >
                 Changes were requested on an earlier round of this same
-                submission: <strong>{pending.note}</strong> — check whether
-                this resubmission actually addresses it before approving.
+                submission: <strong>{pending.note}</strong> — check whether this
+                resubmission actually addresses it before approving.
               </Alert>
             )}
 
@@ -297,8 +302,8 @@ export function ChangeRequestReview({ company }: { company: Company }) {
                     from={currentValue(company, key)}
                     to={
                       pending.snapshot[key] === null ||
-                      pending.snapshot[key] === undefined ||
-                      pending.snapshot[key] === ""
+                        pending.snapshot[key] === undefined ||
+                        pending.snapshot[key] === ""
                         ? "—"
                         : String(pending.snapshot[key])
                     }
@@ -312,7 +317,10 @@ export function ChangeRequestReview({ company }: { company: Company }) {
             ) : null}
 
             {faydaIdentitySnapshot && (
-              <FaydaIdentityDiff company={company} snapshot={faydaIdentitySnapshot} />
+              <FaydaIdentityDiff
+                company={company}
+                snapshot={faydaIdentitySnapshot}
+              />
             )}
 
             {documentChanges.length > 0 && (
@@ -340,10 +348,10 @@ export function ChangeRequestReview({ company }: { company: Company }) {
                       type="button"
                       size="sm"
                       onClick={() =>
-                        void fetchViewableFile(
+                        openFileInNewTab(
                           c.fileId,
                           c.fileName ?? humanize(c.code),
-                        ).then(view)
+                        )
                       }
                       style={{
                         textDecoration:
@@ -372,11 +380,7 @@ export function ChangeRequestReview({ company }: { company: Company }) {
                       component="button"
                       type="button"
                       size="sm"
-                      onClick={() =>
-                        void fetchViewableFile(fileId, `Document ${i + 1}`).then(
-                          view,
-                        )
-                      }
+                      onClick={() => openFileInNewTab(fileId, `Document ${i + 1}`)}
                     >
                       Document {i + 1}
                     </Anchor>
@@ -410,10 +414,10 @@ export function ChangeRequestReview({ company }: { company: Company }) {
                       type="button"
                       size="sm"
                       onClick={() =>
-                        void fetchViewableFile(
+                        openFileInNewTab(
                           c.fileId,
                           c.fileName ?? "License document",
-                        ).then(view)
+                        )
                       }
                       style={{
                         textDecoration:
@@ -446,7 +450,10 @@ export function ChangeRequestReview({ company }: { company: Company }) {
                   variant="light"
                   color="yellow"
                   onClick={() => {
-                    setActionTarget({ id: pending.id, kind: "request-changes" });
+                    setActionTarget({
+                      id: pending.id,
+                      kind: "request-changes",
+                    });
                     setNote("");
                   }}
                 >
@@ -518,14 +525,16 @@ export function ChangeRequestReview({ company }: { company: Company }) {
           </Group>
         </Stack>
       </Modal>
-
-      {viewer}
     </>
   );
 }
 
 /** Compact "N changes pending" pill for the customer list/detail header. */
-export function ChangeRequestPendingBadge({ companyId }: { companyId: string }) {
+export function ChangeRequestPendingBadge({
+  companyId,
+}: {
+  companyId: string;
+}) {
   const query = useQuery(
     api.customers.changeRequests.queryOptions({ input: { id: companyId } }),
   );
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/CompanyTimeline.tsx b/apps/edr-freight-web/backoffice/src/components/customers/CompanyTimeline.tsx
index cd421d9bd..8469e4031 100644
--- a/apps/edr-freight-web/backoffice/src/components/customers/CompanyTimeline.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/customers/CompanyTimeline.tsx
@@ -1,9 +1,8 @@
 import { Alert, Anchor, Badge, Card, Group, SimpleGrid, Stack, Text } from "@mantine/core";
 import { useQuery } from "@tanstack/react-query";
 import { FilePlus2, FileX2, History } from "lucide-react";
-import { useFileViewer } from "@edr/ui-common";
 
-import { fetchViewableFile } from "@/services/files.service";
+import { openFileInNewTab } from "@/services/files.service";
 import { api } from "@/services/api";
 import type {
   Company,
@@ -36,6 +35,12 @@ interface TimelineEntry {
   at: string;
   note?: string | null;
   summary?: string;
+  /** Who filed the change (the customer, or staff editing during onboarding). */
+  requestedBy?: string | null;
+  /** When they filed it — the "asked" half of the ask/decide pair below. */
+  requestedAt?: string | null;
+  /** Who decided (approved / rejected / sent it back to marketing). */
+  decidedBy?: string | null;
   fieldDiffs: FieldDiff[];
   docDiffs: DocDiff[];
 }
@@ -43,10 +48,18 @@ interface TimelineEntry {
 const KIND_BADGE: Record<TimelineEntry["kind"], { label: string; color: string }> = {
   approved: { label: "Approved", color: "edr-green" },
   rejected: { label: "Rejected", color: "red" },
-  changes_requested: { label: "Changes requested", color: "yellow" },
+  // Sending a request back is what "reverted to marketing" means here: the
+  // request stays open and marketing owns the follow-up with the customer.
+  changes_requested: { label: "Sent back to marketing", color: "yellow" },
   revision: { label: "Recorded", color: "blue" },
 };
 
+/** "Requested by X" / "Reviewed by X", with the id-less case reading sanely. */
+function actorLine(verb: string, who?: string | null, when?: string | null) {
+  if (!who && !when) return null;
+  return `${verb}${who ? ` by ${who}` : ""}${when ? ` · ${formatDate(when)}` : ""}`;
+}
+
 /**
  * Pair adjacent remove-then-add intents into one before/after doc diff — a
  * "replace" is always staged as `[{op:'remove'}, {op:'add'}]` pushed together
@@ -132,6 +145,9 @@ function fromChangeRequest(
     kind: r.status as TimelineEntry["kind"],
     at: r.reviewedAt ?? r.updatedAt,
     note: r.note,
+    requestedBy: r.submittedByName,
+    requestedAt: r.submittedAt ?? r.createdAt,
+    decidedBy: r.reviewedByName,
     fieldDiffs,
     docDiffs,
   };
@@ -156,6 +172,7 @@ function fromRevision(rev: CompanyRevision): TimelineEntry {
     kind: "revision",
     at: rev.createdAt,
     summary: rev.summary,
+    requestedBy: rev.actorName,
     fieldDiffs,
     docDiffs,
   };
@@ -170,7 +187,6 @@ function fromRevision(rev: CompanyRevision): TimelineEntry {
  * single answer instead of two places to check.
  */
 export function CompanyTimeline({ company }: { company: Company }) {
-  const { view, viewer } = useFileViewer();
   const changeRequestsQuery = useQuery(
     api.customers.changeRequests.queryOptions({ input: { id: company.id } }),
   );
@@ -186,7 +202,7 @@ export function CompanyTimeline({ company }: { company: Company }) {
   ].sort((a, b) => new Date(b.at).getTime() - new Date(a.at).getTime());
 
   const openFile = (file: { id: string; name: string }) =>
-    void fetchViewableFile(file.id, file.name).then(view);
+    openFileInNewTab(file.id, file.name);
 
   if (entries.length === 0) {
     return (
@@ -205,6 +221,20 @@ export function CompanyTimeline({ company }: { company: Company }) {
     <Stack gap="md">
       {entries.map((entry) => {
         const badge = KIND_BADGE[entry.kind];
+        const requestedLine = actorLine(
+          entry.kind === "revision" ? "Edited" : "Requested",
+          entry.requestedBy,
+          entry.requestedAt,
+        );
+        const decidedLine = actorLine(
+          entry.kind === "changes_requested"
+            ? "Sent back to marketing"
+            : entry.kind === "rejected"
+              ? "Rejected"
+              : "Approved",
+          entry.decidedBy,
+          entry.kind === "revision" ? null : entry.at,
+        );
         return (
           <Card key={entry.id} withBorder>
             <Stack gap="sm">
@@ -224,10 +254,33 @@ export function CompanyTimeline({ company }: { company: Company }) {
                 </Text>
               </Group>
 
+              {/* Who asked, and who decided. Without this the feed said what
+                  changed and when, but never named a person — the first thing
+                  anyone auditing a returned request needs. */}
+              {(requestedLine || decidedLine) && (
+                <Stack gap={2}>
+                  {requestedLine && (
+                    <Text size="xs" c="dimmed">
+                      {requestedLine}
+                    </Text>
+                  )}
+                  {decidedLine && (
+                    <Text size="xs" c="dimmed">
+                      {decidedLine}
+                    </Text>
+                  )}
+                </Stack>
+              )}
+
               {entry.note && (
                 <Alert color="yellow" variant="light">
                   <Text size="sm">
-                    <strong>Note:</strong> {entry.note}
+                    <strong>
+                      {entry.kind === "changes_requested"
+                        ? "What was asked for:"
+                        : "Note:"}
+                    </strong>{" "}
+                    {entry.note}
                   </Text>
                 </Alert>
               )}
@@ -293,7 +346,6 @@ export function CompanyTimeline({ company }: { company: Company }) {
           </Card>
         );
       })}
-      {viewer}
     </Stack>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/PersonCard.tsx b/apps/edr-freight-web/backoffice/src/components/customers/PersonCard.tsx
new file mode 100644
index 000000000..b4a201fd1
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/customers/PersonCard.tsx
@@ -0,0 +1,112 @@
+import { Badge, Card, Divider, Group, Stack, Text } from "@mantine/core";
+import type { ReactNode } from "react";
+
+export interface PersonField {
+  label: string;
+  value?: string | null;
+}
+
+export interface PersonCardProps {
+  /** OWNER / POA / CONTACT PERSON — the person's role, not their name. */
+  title: string;
+  icon?: ReactNode;
+  /**
+   * Identity state. `undefined` = this person has no identity check at all
+   * (contact person), so no badge is rendered rather than a misleading "not
+   * verified" one.
+   */
+  verified?: boolean;
+  /** Extra pills after the verification badge (e.g. "Verifies for this company"). */
+  badges?: ReactNode;
+  /** Rendered between the header and the fields — alerts, match warnings. */
+  notice?: ReactNode;
+  fields: PersonField[];
+  /** Shown when the API returned nothing for every field. */
+  emptyMessage: string;
+  /** Attachments or anything else that belongs to this person. */
+  children?: ReactNode;
+}
+
+/**
+ * One person in the customer's people column: owner, power of attorney, contact
+ * person. Empty fields are dropped rather than rendered as "—", so a field the
+ * API stops sending simply disappears instead of leaving a dead row behind.
+ */
+export function PersonCard({
+  title,
+  icon,
+  verified,
+  badges,
+  notice,
+  fields,
+  emptyMessage,
+  children,
+}: PersonCardProps) {
+  const filled = fields.filter(
+    (f) => f.value != null && String(f.value).trim(),
+  );
+
+  return (
+    <Card>
+      <Stack gap="sm">
+        <Group gap={8} wrap="wrap">
+          {icon}
+          <Text
+            size="xs"
+            fw={700}
+            c="edr-muted"
+            tt="uppercase"
+            style={{ letterSpacing: "0.06em" }}
+          >
+            {title}
+          </Text>
+          {verified !== undefined &&
+            (verified ? (
+              <Badge size="xs" color="edr-green" variant="light">
+                Fayda verified
+              </Badge>
+            ) : (
+              <Badge size="xs" color="gray" variant="light">
+                Not verified
+              </Badge>
+            ))}
+          {badges}
+        </Group>
+
+        {notice}
+
+        {filled.length > 0 ? (
+          <Stack gap="xs">
+            {filled.map((f) => (
+              <Stack key={f.label} gap={0}>
+                <Text size="xs" c="edr-muted">
+                  {f.label}
+                </Text>
+                <Text
+                  size="sm"
+                  c="edr-text"
+                  style={{ wordBreak: "break-word" }}
+                >
+                  {f.value}
+                </Text>
+              </Stack>
+            ))}
+          </Stack>
+        ) : (
+          <Text size="sm" c="dimmed">
+            {emptyMessage}
+          </Text>
+        )}
+
+        {children && (
+          <>
+            <Divider />
+            {children}
+          </>
+        )}
+      </Stack>
+    </Card>
+  );
+}
+
+export default PersonCard;
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx b/apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx
deleted file mode 100644
index f0e9b266a..000000000
--- a/apps/edr-freight-web/backoffice/src/components/customers/ResetPasswordAction.tsx
+++ /dev/null
@@ -1,151 +0,0 @@
-import { Alert, Button, Loader, Modal, Radio, Stack, Text } from "@mantine/core";
-import { useMutation, useQuery } 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">;
-}
-
-/**
- * Staff-triggered password reset. Sends a single-use link to the customer's
- * primary contact; the customer opens it and 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 allowed = hasPermission(user, FREIGHT_PERMS.customers.resetPassword);
-
-  // The destination is the primary contact's IAM account, not the company
-  // record — those are different fields and routinely hold different values, so
-  // showing `company.phone` here would tell staff the wrong number. Only fetched
-  // once the modal is open.
-  const targetQuery = useQuery(
-    api.customers.resetTarget.queryOptions({
-      input: { companyId: company.id },
-      enabled: allowed && opened,
-    }),
-  );
-  const target = targetQuery.data;
-
-  const { mutate, isPending } = useMutation(
-    api.customers.resetPassword.mutationOptions({
-      onSuccess: (result) => {
-        setOpened(false);
-        toast({
-          title: "Reset link sent",
-          description: `The customer can set a new password using the link sent to ${result.maskedTarget}. It expires in 24 hours.`,
-        });
-      },
-      onError: (error) => {
-        toast({
-          title: "Could not send reset link",
-          description: error.message,
-          variant: "destructive",
-        });
-      },
-    }),
-  );
-
-  if (!allowed) return null;
-
-  // SMS is domestic-only: a foreign number counts as unavailable, same as a
-  // missing one, so staff can't send a link that will never arrive.
-  const phoneUsable = !!target?.phone && target.phoneIsDomestic !== false;
-  const channelMissing =
-    !!target && (channel === "email" ? !target.email : !phoneUsable);
-
-  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 link"
-        centered
-      >
-        <Stack gap="md">
-          <Text size="sm" c="dimmed">
-            We&apos;ll send a single-use link to this customer&apos;s primary
-            contact. They choose their own new password — you will not see it.
-            The link expires in 24 hours.
-          </Text>
-
-          {targetQuery.isLoading ? (
-            <Stack align="center" py="md">
-              <Loader size="sm" />
-            </Stack>
-          ) : targetQuery.isError ? (
-            <Alert color="red" variant="light">
-              {targetQuery.error.message}
-            </Alert>
-          ) : target ? (
-            <>
-              <Radio.Group
-                value={channel}
-                onChange={(v) => setChannel(v as ResetChannel)}
-                label={`Send the link to ${target.name || "the primary contact"} via`}
-              >
-                <Stack gap="xs" mt="xs">
-                  <Radio
-                    value="phone"
-                    label="SMS"
-                    disabled={!phoneUsable}
-                    description={
-                      !target.phone
-                        ? "No phone number on this account"
-                        : target.phoneIsDomestic === false
-                          ? `${target.phone} — foreign number, SMS unavailable; use email`
-                          : target.phone
-                    }
-                  />
-                  <Radio
-                    value="email"
-                    label="Email"
-                    disabled={!target.email}
-                    description={
-                      target.email ?? "No email address on this account"
-                    }
-                  />
-                </Stack>
-              </Radio.Group>
-
-              <Text size="xs" c="dimmed">
-                These are the primary contact&apos;s own login details, which may
-                differ from the company contact details on the profile.
-              </Text>
-
-              <Button
-                color="edr-green"
-                loading={isPending}
-                disabled={channelMissing}
-                onClick={() => mutate({ companyId: company.id, channel })}
-              >
-                Send reset link
-              </Button>
-            </>
-          ) : null}
-        </Stack>
-      </Modal>
-    </>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/badges.tsx b/apps/edr-freight-web/backoffice/src/components/customers/badges.tsx
index 046493b0f..3127a39f8 100644
--- a/apps/edr-freight-web/backoffice/src/components/customers/badges.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/customers/badges.tsx
@@ -16,6 +16,7 @@ import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import { api } from "@/services/api";
 
 import type {
+  CompanyNationality,
   CompanyProfile,
   CompanyStatus,
   CompanyType,
@@ -88,10 +89,66 @@ export function CompanyTypeBadge({ type }: { type: CompanyType }) {
   );
 }
 
+const NATIONALITY_COLOR: Record<CompanyNationality, string> = {
+  ethiopian: "edr-green",
+  foreign: "blue",
+};
+
+export function CompanyNationalityBadge({
+  nationality,
+}: {
+  nationality?: CompanyNationality | null;
+}) {
+  if (!nationality) return null;
+  return (
+    <Badge
+      color={NATIONALITY_COLOR[nationality] ?? "gray"}
+      variant="light"
+      size="sm"
+      radius="md"
+      fw={600}
+      style={badgeStyle}
+    >
+      {humanize(nationality)}
+    </Badge>
+  );
+}
+
+/**
+ * The company's registration was typed, not fetched from eTrade — nothing in it
+ * has been checked against a licence. Loud on purpose: it is the one thing a
+ * reviewer must not miss about this customer. Two kinds of company land here
+ * for different reasons, and the badge names which.
+ */
+export function ManualRegistrationBadge({
+  cooperative,
+  investorLicence,
+}: {
+  cooperative?: boolean | null;
+  investorLicence?: boolean | null;
+}) {
+  if (!cooperative && !investorLicence) return null;
+  return (
+    <Badge
+      color="orange"
+      variant="light"
+      size="sm"
+      radius="md"
+      fw={600}
+      style={badgeStyle}
+    >
+      {cooperative
+        ? "Manual entry · co-operative"
+        : "Manual entry · investment licence"}
+    </Badge>
+  );
+}
+
 /**
  * Profile chips for a company row: one chip per role (Importer / Exporter / …)
- * carrying its reference code. Caps at three (a company has at most three
- * profiles); any extra collapse into a `+N` chip.
+ * carrying its reference code, colored by the profile's status (green active,
+ * amber pending, red rejected/blacklisted). Caps at three (a company has at
+ * most three profiles); any extra collapse into a `+N` chip.
  */
 export function ProfileChips({
   profiles,
@@ -126,14 +183,15 @@ export function ProfileChips({
           withArrow
         >
           <Badge
-            color={PROFILE_TYPE_COLOR[profile.type] ?? "gray"}
+            color={STATUS_COLOR[profile.status] ?? "gray"}
             variant="light"
             size="sm"
             radius="md"
             fw={600}
             style={badgeStyle}
           >
-            {humanize(profile.type)} · {profile.reference}
+            {humanize(profile.type)}
+            {profile.reference ? ` · ${profile.reference}` : ""}
           </Badge>
         </Tooltip>
       ))}
@@ -280,9 +338,11 @@ export function InvoiceStatusBadge({
 
 /**
  * Inline approval action buttons for a profile row.
- * Transitions: pending → approve / reject-with-note | rejected → approve (override) |
+ * Transitions: pending → approve / reject-with-note | rejected → undo-rejection (→ pending) |
  * active → suspend | suspended → reactivate/blacklist | blacklisted → reinstate.
- * Rejecting captures a note the customer sees so they can fix and reapply.
+ * Rejecting captures a note the customer sees so they can fix and reapply — a
+ * rejected role is theirs to resubmit, so it cannot be approved from here until
+ * they do (the API refuses it); undoing the rejection is the only way back.
  *
  * `locked` (customer hasn't submitted onboarding) withholds the review decision
  * only — there's no application to judge yet, and the API rejects the call
@@ -468,18 +528,33 @@ export function ProfileApprovalActions({
   }
 
   if (status === "rejected") {
-    if (!canSet("active")) return null;
+    // No Approve here: the role is waiting on the customer to fix what was
+    // flagged and resubmit it, and the API refuses rejected → active outright.
+    // All that's left is undoing a rejection that shouldn't have happened,
+    // which puts the role back in the queue rather than into service.
+    if (!canSet("pending")) return null;
     return (
-      <Button
-        size="xs"
-        variant="light"
-        color="edr-green"
-        radius="md"
-        loading={isPending}
-        onClick={() => act("active")}
-      >
-        Approve
-      </Button>
+      <Group gap={8} wrap="nowrap">
+        <Text size="xs" c="dimmed" fs="italic">
+          Awaiting customer resubmission
+        </Text>
+        <Tooltip
+          multiline
+          w={260}
+          label="Puts the role back in the pending queue and clears the rejection note. Use only if the rejection itself was a mistake — it does not approve the role."
+        >
+          <Button
+            size="xs"
+            variant="subtle"
+            color="gray"
+            radius="md"
+            loading={isPending}
+            onClick={() => act("pending")}
+          >
+            Undo rejection
+          </Button>
+        </Tooltip>
+      </Group>
     );
   }
 
diff --git a/apps/edr-freight-web/backoffice/src/components/customers/format.ts b/apps/edr-freight-web/backoffice/src/components/customers/format.ts
index 0397c1cee..341170931 100644
--- a/apps/edr-freight-web/backoffice/src/components/customers/format.ts
+++ b/apps/edr-freight-web/backoffice/src/components/customers/format.ts
@@ -1,38 +1,2 @@
-/** Shared formatting helpers for the customer-management pages. */
-
-/** snake_case / SCREAMING_CASE → Title Case. */
-export function humanize(value: string): string {
-  return value
-    .toLowerCase()
-    .split(/[_\s]+/)
-    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-    .join(" ");
-}
-
-export function formatDate(value: string | null | undefined): string {
-  if (!value) return "—";
-  const d = new Date(value);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      });
-}
-
-export function formatMoney(amount: number, currency: string): string {
-  return new Intl.NumberFormat(undefined, {
-    style: "currency",
-    currency,
-    maximumFractionDigits: 0,
-  }).format(amount);
-}
-
-export function formatBytes(bytes: number): string {
-  if (!bytes) return "0 B";
-  const units = ["B", "KB", "MB", "GB"];
-  const i = Math.floor(Math.log(bytes) / Math.log(1024));
-  const value = bytes / Math.pow(1024, i);
-  return `${value.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;
-}
+/** @deprecated import from "@/lib/format" (or ../../lib/format) instead. */
+export { humanize, formatDate, formatDateTime, formatMoney, formatBytes } from "../../lib/format";
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 1ccd29f41..864a89ae6 100644
--- a/apps/edr-freight-web/backoffice/src/components/customers/index.ts
+++ b/apps/edr-freight-web/backoffice/src/components/customers/index.ts
@@ -1,8 +1,10 @@
 export {
   BookingStatusBadge,
+  CompanyNationalityBadge,
   CompanyStatusBadge,
   CompanyTypeBadge,
   InvoiceStatusBadge,
+  ManualRegistrationBadge,
   PaymentStatusBadge,
   ProfileApprovalActions,
   ProfileChips,
@@ -18,9 +20,10 @@ export {
   RequestDocumentChangeModal,
   type RequestDocumentChangeModalProps,
 } from "./RequestDocumentChangeModal";
-export {
-  default as ResetPasswordAction,
-  type ResetPasswordActionProps,
-} from "./ResetPasswordAction";
 export { formatBytes, formatDate, formatMoney, humanize } from "./format";
+export {
+  PersonCard,
+  type PersonCardProps,
+  type PersonField,
+} from "./PersonCard";
 export { TableCard, type TableCardProps } from "./TableCard";
diff --git a/apps/edr-freight-web/backoffice/src/components/detail/EntityLink.tsx b/apps/edr-freight-web/backoffice/src/components/detail/EntityLink.tsx
new file mode 100644
index 000000000..497c59d6c
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/detail/EntityLink.tsx
@@ -0,0 +1,63 @@
+import type { ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
+import { ArrowUpRight } from "lucide-react";
+import { Anchor, Group, Text } from "@mantine/core";
+import { Link } from "react-router-dom";
+
+export interface EntityLinkProps {
+  /** Route to the related record's detail page. Renders nothing if falsy — a
+   * link with no id would be a dead one (e.g. a government booking with no
+   * company). */
+  to?: string | null;
+  label: ReactNode;
+  icon?: LucideIcon;
+  /** Monospace label — for references/codes (e.g. "CT-2024-0117"). */
+  mono?: boolean;
+  size?: "xs" | "sm" | "md";
+  fw?: number;
+  className?: string;
+}
+
+/**
+ * Inline link to another record's detail page, with a small "go to" glyph so
+ * it reads as navigation rather than plain emphasis. `stopPropagation` matters
+ * wherever this sits inside a clickable table row (booking/invoice rows
+ * navigate on click) — without it a nested link races the row handler.
+ */
+export function EntityLink({
+  to,
+  label,
+  icon: Icon,
+  mono,
+  size = "sm",
+  fw = 600,
+  className,
+}: EntityLinkProps) {
+  if (!to) {
+    return (
+      <Text size={size} fw={fw} c="dimmed" ff={mono ? "monospace" : undefined}>
+        {label}
+      </Text>
+    );
+  }
+
+  return (
+    <Anchor
+      component={Link}
+      to={to}
+      onClick={(e) => e.stopPropagation()}
+      underline="hover"
+      c="edr-green"
+      fw={fw}
+      fz={size}
+      ff={mono ? "monospace" : undefined}
+      className={className}
+    >
+      <Group gap={4} wrap="nowrap" component="span" style={{ display: "inline-flex" }}>
+        {Icon ? <Icon size={14} /> : null}
+        <span>{label}</span>
+        <ArrowUpRight size={13} style={{ flexShrink: 0 }} />
+      </Group>
+    </Anchor>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/detail/Field.tsx b/apps/edr-freight-web/backoffice/src/components/detail/Field.tsx
new file mode 100644
index 000000000..7300005b9
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/detail/Field.tsx
@@ -0,0 +1,59 @@
+import type { ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
+import { Group, Stack, Text } from "@mantine/core";
+
+export interface FieldProps {
+  label: string;
+  value?: ReactNode;
+}
+
+/**
+ * Stacked label-over-value pair — uppercase dimmed label, value below. Used in
+ * grids of facts (e.g. an invoice summary, a contract's key figures).
+ */
+export function Field({ label, value }: FieldProps) {
+  const isEmpty = value === undefined || value === null || value === "";
+  return (
+    <Stack gap={2}>
+      <Text
+        size="xs"
+        fw={600}
+        c="edr-muted"
+        tt="uppercase"
+        style={{ letterSpacing: "0.04em" }}
+      >
+        {label}
+      </Text>
+      <Text size="sm" c="edr-text">
+        {isEmpty ? "—" : value}
+      </Text>
+    </Stack>
+  );
+}
+
+export interface FieldRowProps {
+  icon?: LucideIcon;
+  label: string;
+  value?: ReactNode;
+}
+
+/**
+ * Left icon+label / right bold value row, divider-separated when stacked in a
+ * list. Used inside quick-info cards (see `LinkedEntityCard`).
+ */
+export function FieldRow({ icon: Icon, label, value }: FieldRowProps) {
+  const isEmpty = value === undefined || value === null || value === "";
+  return (
+    <Group justify="space-between" wrap="nowrap" py={6} gap="md">
+      <Group gap="xs" wrap="nowrap">
+        {Icon ? <Icon size={15} color="var(--mantine-color-gray-5)" /> : null}
+        <Text size="sm" c="dimmed">
+          {label}
+        </Text>
+      </Group>
+      <Text size="sm" fw={600} ta="right" style={{ minWidth: 0 }} truncate>
+        {isEmpty ? "—" : value}
+      </Text>
+    </Group>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/detail/LinkedEntityCard.tsx b/apps/edr-freight-web/backoffice/src/components/detail/LinkedEntityCard.tsx
new file mode 100644
index 000000000..931932fb5
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/detail/LinkedEntityCard.tsx
@@ -0,0 +1,67 @@
+import type { ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
+import { Divider, Stack, Text } from "@mantine/core";
+
+import { SectionCard } from "@/components/bookings/detail/SectionCard";
+import { FieldRow, type FieldRowProps } from "./Field";
+import { EntityLink } from "./EntityLink";
+
+export interface LinkedEntityCardProps {
+  icon: LucideIcon;
+  /** Card title, e.g. "Customer" or "Contract". */
+  title: string;
+  /** The entity's own name/reference, rendered as the linked subtitle. */
+  name: ReactNode;
+  /** Route to the entity's detail page. Omit when there's nothing to link to
+   * (e.g. a government booking with no company) — the name renders as plain
+   * dimmed text instead of a dead link. */
+  to?: string | null;
+  accent?: string;
+  /** Quick-info rows shown below the linked name — empty ones are dropped. */
+  rows?: FieldRowProps[];
+  /** Extra content under the rows (e.g. a summary paragraph, an action). */
+  footer?: ReactNode;
+  /** Shown instead of rows/footer when there's nothing to display at all. */
+  emptyMessage?: string;
+}
+
+/**
+ * "Customer at a glance" / "Contract at a glance" card for a detail page's
+ * sticky rail: a linked title plus a handful of quick-info rows, so the
+ * related record's essentials are visible without navigating away.
+ */
+export function LinkedEntityCard({
+  icon,
+  title,
+  name,
+  to,
+  accent = "blue",
+  rows = [],
+  footer,
+  emptyMessage,
+}: LinkedEntityCardProps) {
+  const visibleRows = rows.filter((r) => r.value !== undefined && r.value !== null && r.value !== "");
+
+  return (
+    <SectionCard icon={icon} title={title} accent={accent}>
+      <Stack gap={4}>
+        <EntityLink to={to} label={name} size="sm" fw={700} />
+        {visibleRows.length > 0 ? (
+          <Stack gap={0} mt={4}>
+            {visibleRows.map((row, index) => (
+              <div key={row.label}>
+                {index > 0 && <Divider color="var(--mantine-color-gray-2)" />}
+                <FieldRow {...row} />
+              </div>
+            ))}
+          </Stack>
+        ) : emptyMessage ? (
+          <Text size="sm" c="dimmed" mt={4}>
+            {emptyMessage}
+          </Text>
+        ) : null}
+        {footer}
+      </Stack>
+    </SectionCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/detail/index.ts b/apps/edr-freight-web/backoffice/src/components/detail/index.ts
new file mode 100644
index 000000000..15e379099
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/detail/index.ts
@@ -0,0 +1,14 @@
+export { Field, FieldRow } from "./Field";
+export type { FieldProps, FieldRowProps } from "./Field";
+export { EntityLink } from "./EntityLink";
+export type { EntityLinkProps } from "./EntityLink";
+export { LinkedEntityCard } from "./LinkedEntityCard";
+export type { LinkedEntityCardProps } from "./LinkedEntityCard";
+
+// Re-exported so pages under this restructure have one import path for both
+// the new quick-info primitives and the existing section-card shell. Imported
+// from the file directly (not the bookings/detail barrel) — that barrel also
+// re-exports cards that import from this module, and going through it would
+// create a circular import.
+export { SectionCard } from "@/components/bookings/detail/SectionCard";
+export type { SectionCardProps } from "@/components/bookings/detail/SectionCard";
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/FilterBar.tsx b/apps/edr-freight-web/backoffice/src/components/filters/FilterBar.tsx
new file mode 100644
index 000000000..e42b70252
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/FilterBar.tsx
@@ -0,0 +1,160 @@
+import { useState, type ReactNode } from "react";
+import { Anchor, Divider, Group, TextInput } from "@mantine/core";
+import { Search, Trash2 } from "lucide-react";
+
+import type { FilterDef, SortOption } from "./types";
+import type { UseFilters } from "./useFilters";
+import { FilterPill } from "./FilterPill";
+import { MoreFiltersMenu } from "./MoreFiltersMenu";
+import { SaveViewButton } from "./SaveViewButton";
+import { SavedViewCards } from "./SavedViewCards";
+import { SortControl } from "./SortControl";
+import { useSavedViews } from "./useSavedViews";
+
+export interface FilterBarProps {
+  defs: FilterDef[];
+  controls: UseFilters;
+  searchPlaceholder?: string;
+  showSearch?: boolean;
+  /** value already "field:DIR" — the page's existing SORT_OPTIONS, moved not rewritten. */
+  sortOptions?: SortOption[];
+  /** localStorage namespace for saved views. Omit to hide the control. */
+  viewId?: string;
+  /** Escape hatch: tabs, row count, a "New" button — rendered at the far right. */
+  children?: ReactNode;
+}
+
+export function FilterBar({
+  defs,
+  controls,
+  searchPlaceholder = "Search…",
+  showSearch = true,
+  sortOptions,
+  viewId,
+  children,
+}: FilterBarProps) {
+  // Filters just picked from "More filters" render as an already-open pill
+  // until the popover closes, then fall back to the ordinary pinned/active split.
+  const [justPicked, setJustPicked] = useState<string[]>([]);
+
+  const pinned = defs.filter((d) => !d.secondary || controls.values[d.key] || justPicked.includes(d.key));
+  const secondary = defs.filter((d) => !pinned.includes(d));
+  // Applied filters read first, left to right — a stable partition keeps
+  // each group in its original def order rather than resorting on every apply.
+  const orderedPinned = [
+    ...pinned.filter((d) => controls.values[d.key]),
+    ...pinned.filter((d) => !controls.values[d.key]),
+  ];
+
+  // Unconditional call (rules of hooks) — viewId is a per-page constant, and
+  // the hook is a no-op storage key when saved views aren't wired up.
+  const savedViews = useSavedViews(viewId ?? "__unset__");
+  const activeQuery = controls.currentQueryString();
+  const hasMatchingView = savedViews.views.some((v) => v.query === activeQuery);
+  const canSaveView = Boolean(viewId) && activeQuery.length > 0 && !hasMatchingView;
+
+  return (
+    <div>
+      {viewId && (
+        <SavedViewCards
+          defs={defs}
+          views={savedViews.views}
+          activeQuery={activeQuery}
+          applyQueryString={controls.applyQueryString}
+          onRemove={savedViews.remove}
+        />
+      )}
+
+      {/*
+        Two independent zones on wide screens — left (search + pills + more
+        filters + clear) wraps to as many lines as it needs, right (sort +
+        save) stays pinned on the first line via `sm:flex-nowrap` +
+        `sm:shrink-0`. `nowrap` unconditionally (the old inline style) forced
+        that same two-column layout on a phone too: neither zone had room and
+        both got squeezed/clipped. Below the `sm` breakpoint this stacks to a
+        single column instead — full-width left row, full-width right row.
+      */}
+      <div className="flex flex-col sm:flex-row sm:flex-nowrap items-start gap-2">
+      <Group gap="xs" wrap="wrap" align="center" className="flex-1 min-w-0 w-full">
+        {showSearch && (
+          <TextInput
+            placeholder={searchPlaceholder}
+            leftSection={<Search size={14} />}
+            value={controls.searchText}
+            onChange={(e) => controls.setSearchText(e.currentTarget.value)}
+            size="xs"
+            radius="lg"
+            // Regular weight (not the Button-driven 600 the rest of the bar
+            // uses) and a solid, fully-opaque border/text — same "opaque, not
+            // faint" fix the inactive pill trigger got.
+            styles={{
+              input: {
+                fontWeight: 400,
+                borderColor: "var(--mantine-color-gray-6)",
+                color: "var(--mantine-color-gray-9)",
+              },
+            }}
+            style={{ minWidth: 160, flex: "1 1 160px" }}
+          />
+        )}
+
+        {orderedPinned.map((def) => (
+          <FilterPill
+            key={def.key}
+            def={def}
+            value={controls.values[def.key]}
+            onChange={(v) => controls.setFilter(def.key, v)}
+            autoOpen={justPicked.includes(def.key)}
+          />
+        ))}
+
+        <MoreFiltersMenu
+          defs={secondary}
+          onPick={(key) => setJustPicked((prev) => [...prev, key])}
+        />
+
+        {controls.activeCount > 0 && (
+          <Anchor
+            size="sm"
+            c="red.6"
+            underline="never"
+            onClick={() => {
+              controls.clearFilters();
+              setJustPicked([]);
+            }}
+            style={{ display: "inline-flex", alignItems: "center", gap: 4 }}
+          >
+            <Trash2 size={14} />
+            Clear
+          </Anchor>
+        )}
+      </Group>
+
+      {/* Sorting is a different kind of control (view order, not scope) —
+          cut off from the filter pills by a vertical divider and pinned to
+          the right, independent of how the left side wraps. */}
+      {/*
+        Plain div, not <Group>: Group's `wrap` prop sets an inline
+        flex-wrap style, which always beats a Tailwind class regardless of
+        breakpoint — `sm:flex-nowrap` would never win against `wrap="wrap"`.
+        Wrap on mobile (own row, room is tight), pinned nowrap from `sm` up.
+      */}
+      <div className="flex flex-wrap sm:flex-nowrap items-center gap-2 shrink-0">
+        {children}
+        {sortOptions && sortOptions.length > 0 && (
+          <>
+            <Divider orientation="vertical" />
+            <SortControl options={sortOptions} value={controls.sort} onChange={controls.setSort} />
+          </>
+        )}
+        {canSaveView && (
+          <>
+            <Divider orientation="vertical" />
+            <SaveViewButton defs={defs} query={activeQuery} onSave={savedViews.save} />
+          </>
+        )}
+      </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/FilterPill.tsx b/apps/edr-freight-web/backoffice/src/components/filters/FilterPill.tsx
new file mode 100644
index 000000000..af97d2fcf
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/FilterPill.tsx
@@ -0,0 +1,89 @@
+import { useState } from "react";
+import { ActionIcon, Button, Popover } from "@mantine/core";
+import { ChevronDown, X } from "lucide-react";
+
+import type { FilterDef, FilterValue } from "./types";
+import { formatFilterValue } from "./format";
+import { BooleanBody } from "./bodies/BooleanBody";
+import { DateBody } from "./bodies/DateBody";
+import { EnumBody } from "./bodies/EnumBody";
+import { NumberBody } from "./bodies/NumberBody";
+import { RouteBody } from "./bodies/RouteBody";
+import { TextBody } from "./bodies/TextBody";
+
+const BODIES: Record<FilterDef["type"], React.ComponentType<any>> = {
+  text: TextBody,
+  enum: EnumBody,
+  date: DateBody,
+  number: NumberBody,
+  boolean: BooleanBody,
+  route: RouteBody,
+};
+
+// Most bodies fit a narrow popover; a date range needs room for the presets
+// sidebar next to the calendar, so it gets a wider minimum.
+const DROPDOWN_WIDTH: Partial<Record<FilterDef["type"], number>> = { date: 340 };
+
+export interface FilterPillProps {
+  def: FilterDef;
+  value: FilterValue | undefined;
+  onChange: (v: FilterValue | undefined) => void;
+  /** Opened immediately (used when picked from "More filters"). */
+  autoOpen?: boolean;
+}
+
+export function FilterPill({ def, value, onChange, autoOpen }: FilterPillProps) {
+  const [opened, setOpened] = useState(Boolean(autoOpen));
+  const Body = BODIES[def.type];
+  const active = Boolean(value);
+
+  return (
+    <Popover position="bottom-start" withinPortal shadow="md" opened={opened} onChange={setOpened}>
+      <Popover.Target>
+        <Button
+          size="xs"
+          radius="xl"
+          // Inactive: styled like a closed Mantine Select trigger — solid
+          // (opaque, not dashed) border, label + trailing chevron, no leading
+          // "+" — just a smaller/pill-shaped version of that same control.
+          // Active: "light" (soft tinted fill), not "filled" — a whole row of
+          // solid green buttons was the "too loud" complaint; light keeps the
+          // active/inactive contrast without shouting. Popover side/position
+          // is untouched either way.
+          variant={active ? "light" : "default"}
+          color={active ? "edr-green" : undefined}
+          styles={
+            active
+              ? undefined
+              : { root: { borderColor: "var(--mantine-color-gray-6)", color: "var(--mantine-color-gray-9)" } }
+          }
+          rightSection={
+            active ? (
+              <ActionIcon
+                component="span"
+                size={22}
+                radius="xl"
+                variant="subtle"
+                color="edr-green"
+                onClick={(e) => {
+                  e.stopPropagation();
+                  onChange(undefined);
+                }}
+              >
+                <X size={16} />
+              </ActionIcon>
+            ) : (
+              <ChevronDown size={14} />
+            )
+          }
+          onClick={() => setOpened((o) => !o)}
+        >
+          {active ? `${def.label} | ${formatFilterValue(def, value!)}` : def.label}
+        </Button>
+      </Popover.Target>
+      <Popover.Dropdown miw={DROPDOWN_WIDTH[def.type] ?? 260} p="xs">
+        <Body def={def} value={value} onChange={onChange} onClose={() => setOpened(false)} />
+      </Popover.Dropdown>
+    </Popover>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/MoreFiltersMenu.tsx b/apps/edr-freight-web/backoffice/src/components/filters/MoreFiltersMenu.tsx
new file mode 100644
index 000000000..c557bbbc3
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/MoreFiltersMenu.tsx
@@ -0,0 +1,83 @@
+import { useMemo, useState } from "react";
+import { Button, Popover, ScrollArea, Stack, Text, TextInput, UnstyledButton } from "@mantine/core";
+import { Plus, Search } from "lucide-react";
+
+import type { FilterDef } from "./types";
+
+export interface MoreFiltersMenuProps {
+  defs: FilterDef[];
+  /** Called with the picked def's key — the caller pins it and opens its popover. */
+  onPick: (key: string) => void;
+}
+
+/** Searchable list over the page's secondary/inactive filters. Plain filter + list,
+ * not cmdk — a handful of static strings doesn't need a Combobox store. */
+export function MoreFiltersMenu({ defs, onPick }: MoreFiltersMenuProps) {
+  const [opened, setOpened] = useState(false);
+  const [query, setQuery] = useState("");
+
+  const visible = useMemo(
+    () => defs.filter((d) => d.label.toLowerCase().includes(query.toLowerCase())),
+    [defs, query],
+  );
+
+  if (defs.length === 0) return null;
+
+  return (
+    <Popover position="bottom-start" withinPortal shadow="md" opened={opened} onChange={setOpened}>
+      <Popover.Target>
+        <Button
+          size="xs"
+          radius="xl"
+          // "default" (opaque border + solid text), not "outline" (faint
+          // color-tinted border/text) — same fix as the inactive filter pill.
+          variant="default"
+          leftSection={<Plus size={16} />}
+          onClick={() => setOpened((o) => !o)}
+        >
+          More filters
+        </Button>
+      </Popover.Target>
+      <Popover.Dropdown miw={220} p="xs">
+        <Stack gap="xs">
+          <TextInput
+            placeholder="Search filters…"
+            leftSection={<Search size={14} />}
+            value={query}
+            onChange={(e) => setQuery(e.currentTarget.value)}
+            size="sm"
+            autoFocus
+          />
+          <ScrollArea.Autosize mah={280}>
+            <Stack gap={2}>
+              {visible.map((d) => (
+                <UnstyledButton
+                  key={d.key}
+                  px="xs"
+                  py={6}
+                  className="hover:bg-gray-100 transition-colors"
+                  style={{ borderRadius: 6, display: "flex", alignItems: "center", gap: 8 }}
+                  onClick={() => {
+                    setOpened(false);
+                    setQuery("");
+                    onPick(d.key);
+                  }}
+                >
+                  <Plus size={14} className="text-[var(--mantine-color-edr-green-6)]" />
+                  <Text size="sm" c="edr-green.7">
+                    {d.label}
+                  </Text>
+                </UnstyledButton>
+              ))}
+              {visible.length === 0 && (
+                <Text size="xs" c="dimmed" px="xs" py={6}>
+                  No matching filters
+                </Text>
+              )}
+            </Stack>
+          </ScrollArea.Autosize>
+        </Stack>
+      </Popover.Dropdown>
+    </Popover>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/OperatorSelect.tsx b/apps/edr-freight-web/backoffice/src/components/filters/OperatorSelect.tsx
new file mode 100644
index 000000000..a769ebf93
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/OperatorSelect.tsx
@@ -0,0 +1,25 @@
+import { SegmentedControl } from "@mantine/core";
+import { DEFAULT_OP, OPERATOR_LABELS, type FilterDef, type Operator } from "./types";
+
+export interface OperatorSelectProps {
+  def: FilterDef;
+  value: Operator;
+  onChange: (op: Operator) => void;
+}
+
+/** Renders nothing when a def has <= 1 operator — most defs, by design: type-aware
+ * operators are a capability, not a dropdown forced into every popover. */
+export function OperatorSelect({ def, value, onChange }: OperatorSelectProps) {
+  const operators = def.operators ?? [DEFAULT_OP[def.type]];
+  if (operators.length <= 1) return null;
+  return (
+    <SegmentedControl
+      size="sm"
+      fullWidth
+      value={value}
+      onChange={(v) => onChange(v as Operator)}
+      data={operators.map((op) => ({ value: op, label: OPERATOR_LABELS[op] }))}
+      mb="xs"
+    />
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/SaveViewButton.tsx b/apps/edr-freight-web/backoffice/src/components/filters/SaveViewButton.tsx
new file mode 100644
index 000000000..54db1da70
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/SaveViewButton.tsx
@@ -0,0 +1,46 @@
+import { useState } from "react";
+import { Button } from "@mantine/core";
+import { Check, Save } from "lucide-react";
+
+import { useToast } from "@/hooks/use-toast";
+import type { FilterDef } from "./types";
+import { describeQuery } from "./format";
+import type { SavedView } from "./useSavedViews";
+
+export interface SaveViewButtonProps {
+  defs: FilterDef[];
+  query: string;
+  onSave: (query: string) => SavedView;
+}
+
+/** Filled, not outline — this is the one action-y button in the bar (every
+ * other control here is a filter), so it needs to actually look like a
+ * button. One click, no name prompt: the card grid's label is generated
+ * from the active filters (see `describeQuery`). */
+export function SaveViewButton({ defs, query, onSave }: SaveViewButtonProps) {
+  const { toast } = useToast();
+  const [justSaved, setJustSaved] = useState(false);
+
+  const handleSave = () => {
+    onSave(query);
+    toast({ title: "View saved", description: describeQuery(defs, query), duration: 4000 });
+    // The toast is in the corner; this flash is right where the eye already
+    // is — the actual confirmation that "the saving" registered.
+    setJustSaved(true);
+    setTimeout(() => setJustSaved(false), 1500);
+  };
+
+  return (
+    <Button
+      size="sm"
+      radius="xl"
+      variant="filled"
+      color={justSaved ? "teal" : "edr-green"}
+      leftSection={justSaved ? <Check size={15} /> : <Save size={15} />}
+      onClick={handleSave}
+      disabled={justSaved}
+    >
+      {justSaved ? "Saved" : "Save"}
+    </Button>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/SavedViewCards.tsx b/apps/edr-freight-web/backoffice/src/components/filters/SavedViewCards.tsx
new file mode 100644
index 000000000..9cf8c40be
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/SavedViewCards.tsx
@@ -0,0 +1,70 @@
+import { ActionIcon, Card, SimpleGrid, Text } from "@mantine/core";
+import { Trash2 } from "lucide-react";
+
+import { useToast } from "@/hooks/use-toast";
+import type { FilterDef } from "./types";
+import { describeQuery } from "./format";
+import type { SavedView } from "./useSavedViews";
+
+export interface SavedViewCardsProps {
+  defs: FilterDef[];
+  views: SavedView[];
+  activeQuery: string;
+  applyQueryString: (query: string) => void;
+  onRemove: (id: string) => void;
+}
+
+/** Saved views up front as a grid of cards — not one more item buried in a
+ * dropdown nobody opens. Renders nothing until there's at least one saved. */
+export function SavedViewCards({ defs, views, activeQuery, applyQueryString, onRemove }: SavedViewCardsProps) {
+  const { toast } = useToast();
+  if (views.length === 0) return null;
+
+  return (
+    // base: 1 — a phone-width viewport forcing 2 columns is what clipped
+    // card text and overflowed the row; one full-width card per row until
+    // there's actually room for more.
+    <SimpleGrid cols={{ base: 1, xs: 2, sm: 3, md: 4, lg: 5 }} spacing="xs" mb="sm">
+      {views.map((v) => {
+        const active = v.query === activeQuery;
+        const label = describeQuery(defs, v.query);
+        return (
+          <Card
+            key={v.id}
+            withBorder
+            padding="xs"
+            radius="md"
+            onClick={() => {
+              applyQueryString(v.query);
+              toast({ title: `Switched to "${label}"` });
+            }}
+            style={{
+              cursor: "pointer",
+              borderColor: active ? "var(--mantine-color-edr-green-6)" : undefined,
+              borderWidth: active ? 2 : 1,
+              backgroundColor: active ? "var(--mantine-color-edr-green-0)" : undefined,
+            }}
+          >
+            <div style={{ display: "flex", alignItems: "flex-start", justifyContent: "space-between", gap: 6 }}>
+              <Text size="xs" fw={500} lineClamp={2} style={{ flex: 1 }}>
+                {label}
+              </Text>
+              <ActionIcon
+                size="xs"
+                color="red"
+                variant="subtle"
+                onClick={(e) => {
+                  e.stopPropagation();
+                  onRemove(v.id);
+                  toast({ title: "View deleted", description: label, variant: "destructive" });
+                }}
+              >
+                <Trash2 size={12} />
+              </ActionIcon>
+            </div>
+          </Card>
+        );
+      })}
+    </SimpleGrid>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/SortControl.tsx b/apps/edr-freight-web/backoffice/src/components/filters/SortControl.tsx
new file mode 100644
index 000000000..cdb9dde33
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/SortControl.tsx
@@ -0,0 +1,40 @@
+import { Button, Menu } from "@mantine/core";
+import { ArrowUpDown, Check } from "lucide-react";
+
+import type { SortOption } from "./types";
+
+export interface SortControlProps {
+  options: SortOption[];
+  value: string;
+  onChange: (value: string) => void;
+}
+
+/** A control, not a form field — Menu (not Select) gives the check-mark +
+ * trigger-label read Stripe's sort control has. Rendered only when a page
+ * passes sortOptions; inventing options for an endpoint without sortBy
+ * support would ship a control that silently does nothing. */
+export function SortControl({ options, value, onChange }: SortControlProps) {
+  if (options.length === 0) return null;
+  const current = options.find((o) => o.value === value);
+
+  return (
+    <Menu position="bottom-end" withinPortal shadow="md">
+      <Menu.Target>
+        <Button size="xs" variant="outline" color="gray" leftSection={<ArrowUpDown size={14} />}>
+          {current?.label ?? "Sort"}
+        </Button>
+      </Menu.Target>
+      <Menu.Dropdown>
+        {options.map((o) => (
+          <Menu.Item
+            key={o.value}
+            leftSection={o.value === value ? <Check size={14} /> : <span style={{ width: 14 }} />}
+            onClick={() => onChange(o.value)}
+          >
+            {o.label}
+          </Menu.Item>
+        ))}
+      </Menu.Dropdown>
+    </Menu>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/bodies/BooleanBody.tsx b/apps/edr-freight-web/backoffice/src/components/filters/bodies/BooleanBody.tsx
new file mode 100644
index 000000000..cd9f8ed11
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/bodies/BooleanBody.tsx
@@ -0,0 +1,32 @@
+import { useState } from "react";
+import { Radio, Stack } from "@mantine/core";
+
+import { DEFAULT_OP } from "../types";
+import type { BooleanFilterDef, Operator } from "../types";
+import { OperatorSelect } from "../OperatorSelect";
+import type { FilterBodyProps } from "./TextBody";
+
+export function BooleanBody({ def, value, onChange, onClose }: FilterBodyProps<BooleanFilterDef>) {
+  const [op, setOp] = useState<Operator>(value?.op ?? DEFAULT_OP.boolean);
+  const [v, setV] = useState(value?.v[0] ?? "");
+
+  // Two mutually-exclusive options — apply the moment one is picked, same as
+  // EnumBody's single-select radio. No Apply button needed.
+  const pick = (next: string) => {
+    setV(next);
+    onChange({ op, v: [next] });
+    onClose();
+  };
+
+  return (
+    <Stack gap="xs">
+      <OperatorSelect def={def} value={op} onChange={setOp} />
+      <Radio.Group value={v} onChange={pick}>
+        <Stack gap={6}>
+          <Radio value="true" label={def.trueLabel ?? "Yes"} size="sm" />
+          <Radio value="false" label={def.falseLabel ?? "No"} size="sm" />
+        </Stack>
+      </Radio.Group>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/bodies/DateBody.tsx b/apps/edr-freight-web/backoffice/src/components/filters/bodies/DateBody.tsx
new file mode 100644
index 000000000..32970abef
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/bodies/DateBody.tsx
@@ -0,0 +1,96 @@
+import { useState } from "react";
+import { Button, Stack } from "@mantine/core";
+import { DatePickerInput } from "@mantine/dates";
+import { CalendarDays } from "lucide-react";
+
+import { getDateRangePresets } from "@/components/common/dateRangePresets";
+import { startOfDayIso, endOfDayIso, parseDateStr } from "../dates";
+import { DEFAULT_OP } from "../types";
+import type { DateFilterDef, Operator } from "../types";
+import { OperatorSelect } from "../OperatorSelect";
+import type { FilterBodyProps } from "./TextBody";
+
+// ponytail: Gregorian only. Record-management pages need the Ethiopian
+// calendar (see shared/common/form/fields/AmharicDatePicker.tsx) — add an
+// i18n.language !== "en" branch here when this body is first wired into a
+// record-management page (Phase 4 of the filter-bar rollout).
+export function DateBody({ def, value, onChange, onClose }: FilterBodyProps<DateFilterDef>) {
+  // DEFAULT_OP.date is always "between" — a def restricted to a single
+  // non-default operator (e.g. `operators: ["before"]` for an exact-date
+  // filter) would otherwise open on the range UI with no way to switch off
+  // it, since OperatorSelect hides itself when there's only one choice.
+  const [op, setOp] = useState<Operator>(value?.op ?? def.operators?.[0] ?? DEFAULT_OP.date);
+  // Mantine 9's date inputs speak `YYYY-MM-DD` strings, not Date objects.
+  const [from, setFrom] = useState<string | null>(value?.v[0]?.slice(0, 10) ?? null);
+  const [to, setTo] = useState<string | null>(value?.v[1]?.slice(0, 10) ?? null);
+
+  const apply = () => {
+    if (op === "between") {
+      onChange(
+        from && to
+          ? { op, v: [startOfDayIso(parseDateStr(from)), endOfDayIso(parseDateStr(to))] }
+          : undefined,
+      );
+    } else {
+      onChange(
+        from
+          ? {
+              op,
+              v: [
+                op === "before"
+                  ? startOfDayIso(parseDateStr(from))
+                  : endOfDayIso(parseDateStr(from)),
+              ],
+            }
+          : undefined,
+      );
+    }
+    onClose();
+  };
+
+  // This popover already lives inside FilterPill's own Popover. Mantine's
+  // DatePickerInput opens ITS calendar in a separate portal by default, so a
+  // click on a day registers as "outside" the outer Popover and closes the
+  // whole filter before the range can be picked (or Apply reached) — the
+  // reported "date picker doesn't work". Keeping the calendar un-portalled
+  // renders it inside the outer popover's own DOM subtree instead, so
+  // outside-click detection sees it as inside.
+  const nestedPopoverProps = { withinPortal: false } as const;
+
+  return (
+    <Stack gap="xs">
+      <OperatorSelect def={def} value={op} onChange={setOp} />
+      {op === "between" ? (
+        <DatePickerInput
+          type="range"
+          size="sm"
+          leftSection={<CalendarDays size={14} />}
+          placeholder="Any"
+          value={[from, to]}
+          onChange={([f, t]) => {
+            setFrom(f);
+            setTo(t);
+          }}
+          presets={getDateRangePresets()}
+          popoverProps={nestedPopoverProps}
+          clearable
+          autoFocus
+        />
+      ) : (
+        <DatePickerInput
+          size="sm"
+          leftSection={<CalendarDays size={14} />}
+          placeholder="Any"
+          value={from}
+          onChange={setFrom}
+          popoverProps={nestedPopoverProps}
+          clearable
+          autoFocus
+        />
+      )}
+      <Button size="sm" onClick={apply} disabled={op === "between" ? !(from && to) : !from}>
+        Apply
+      </Button>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/bodies/EnumBody.tsx b/apps/edr-freight-web/backoffice/src/components/filters/bodies/EnumBody.tsx
new file mode 100644
index 000000000..3bc352dcb
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/bodies/EnumBody.tsx
@@ -0,0 +1,139 @@
+import { useMemo, useState } from "react";
+import { Button, Checkbox, Group, Radio, Stack, Text, TextInput, UnstyledButton } from "@mantine/core";
+import { Search } from "lucide-react";
+
+import { DEFAULT_OP } from "../types";
+import type { EnumFilterDef, Operator } from "../types";
+import { OperatorSelect } from "../OperatorSelect";
+import type { FilterBodyProps } from "./TextBody";
+
+/** How many options before a search box appears above the list. */
+const SEARCH_THRESHOLD = 8;
+
+/**
+ * Stretches the Checkbox/Radio's native <label> across the full popover
+ * width and pads it, so the clickable/tappable area is the whole row —
+ * not just the ~14px input square — plus a hover cue. `body`/`labelWrapper`
+ * are Mantine's part names for this; `cursor: pointer` on the row (not just
+ * the input) makes the affordance visible before you even click.
+ */
+const ROW_STYLES = {
+  root: { padding: "10px 10px", borderRadius: 6 },
+  body: { alignItems: "center" as const },
+  labelWrapper: { flex: 1 },
+  label: { cursor: "pointer", paddingLeft: 8 },
+};
+
+function OptionLabel({ label, count }: { label: string; count?: number }) {
+  return (
+    <Group justify="space-between" wrap="nowrap" gap="sm">
+      <Text size="sm">{label}</Text>
+      {count !== undefined && (
+        <Text size="sm" c="dimmed">
+          {count}
+        </Text>
+      )}
+    </Group>
+  );
+}
+
+export function EnumBody({ def, value, onChange, onClose }: FilterBodyProps<EnumFilterDef>) {
+  const [op, setOp] = useState<Operator>(value?.op ?? DEFAULT_OP.enum);
+  const [selected, setSelected] = useState<string[]>(value?.v ?? []);
+  const [query, setQuery] = useState("");
+  const [showAll, setShowAll] = useState(false);
+  const multiple = def.multiple ?? true;
+
+  const visible = useMemo(() => {
+    const byQuery = query
+      ? def.options.filter((o) => o.label.toLowerCase().includes(query.toLowerCase()))
+      : def.options;
+    if (!def.counts || showAll) return byQuery;
+    // Hide zero-count options, but never hide one the user already picked —
+    // otherwise a filter that narrows to zero rows becomes impossible to un-select.
+    return byQuery.filter((o) => (def.counts![o.value] ?? 0) > 0 || selected.includes(o.value));
+  }, [def.options, def.counts, query, showAll, selected]);
+
+  const hiddenCount = def.options.length - visible.length;
+
+  const apply = (v: string[] = selected) => {
+    onChange(v.length ? { op, v } : undefined);
+    onClose();
+  };
+
+  // Single-select is a radio pick, not a build-up-a-set gesture — apply the
+  // instant one is chosen, same as picking an option in a plain Select.
+  // Checkbox (multiple) still needs the explicit Apply: picking several
+  // options is a multi-step gesture the popover shouldn't close mid-way through.
+  const applyRadio = (v: string) => {
+    setSelected([v]);
+    apply([v]);
+  };
+
+  return (
+    <Stack gap="xs">
+      <OperatorSelect def={def} value={op} onChange={setOp} />
+      {def.options.length > SEARCH_THRESHOLD && (
+        <TextInput
+          placeholder="Search options…"
+          leftSection={<Search size={14} />}
+          value={query}
+          onChange={(e) => setQuery(e.currentTarget.value)}
+          size="sm"
+        />
+      )}
+      <Stack gap={0} mah={260} style={{ overflowY: "auto" }}>
+        {multiple ? (
+          <Checkbox.Group value={selected} onChange={setSelected} aria-label={`Filter by ${def.label}`}>
+            <Stack gap={0}>
+              {visible.map((o) => (
+                <Checkbox
+                  key={o.value}
+                  value={o.value}
+                  size="sm"
+                  // The count sits INSIDE the label, so it's part of the
+                  // native <label> the input is bound to — clicking it (not
+                  // just the tiny checkbox square) toggles the option too.
+                  label={<OptionLabel label={o.label} count={def.counts?.[o.value]} />}
+                  styles={ROW_STYLES}
+                  classNames={{ root: "hover:bg-gray-100 transition-colors" }}
+                />
+              ))}
+            </Stack>
+          </Checkbox.Group>
+        ) : (
+          <Radio.Group
+            value={selected[0] ?? ""}
+            onChange={(v) => v && applyRadio(v)}
+            aria-label={`Filter by ${def.label}`}
+          >
+            <Stack gap={0}>
+              {visible.map((o) => (
+                <Radio
+                  key={o.value}
+                  value={o.value}
+                  size="sm"
+                  label={<OptionLabel label={o.label} count={def.counts?.[o.value]} />}
+                  styles={ROW_STYLES}
+                  classNames={{ root: "hover:bg-gray-100 transition-colors" }}
+                />
+              ))}
+            </Stack>
+          </Radio.Group>
+        )}
+        {!showAll && hiddenCount > 0 && (
+          <UnstyledButton onClick={() => setShowAll(true)}>
+            <Text size="sm" c="edr-green.6">
+              Show all {def.options.length} options
+            </Text>
+          </UnstyledButton>
+        )}
+      </Stack>
+      {multiple && (
+        <Button size="sm" onClick={() => apply()}>
+          Apply
+        </Button>
+      )}
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/bodies/NumberBody.tsx b/apps/edr-freight-web/backoffice/src/components/filters/bodies/NumberBody.tsx
new file mode 100644
index 000000000..59ef66b9e
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/bodies/NumberBody.tsx
@@ -0,0 +1,39 @@
+import { useState } from "react";
+import { Button, Group, NumberInput, Stack } from "@mantine/core";
+
+import { DEFAULT_OP } from "../types";
+import type { NumberFilterDef, Operator } from "../types";
+import { OperatorSelect } from "../OperatorSelect";
+import type { FilterBodyProps } from "./TextBody";
+
+export function NumberBody({ def, value, onChange, onClose }: FilterBodyProps<NumberFilterDef>) {
+  const [op, setOp] = useState<Operator>(value?.op ?? DEFAULT_OP.number);
+  const [from, setFrom] = useState<number | "">(value?.v[0] ? Number(value.v[0]) : "");
+  const [to, setTo] = useState<number | "">(op === "between" ? (Number(value?.v[1]) || "") : "");
+
+  const apply = () => {
+    if (op === "between") {
+      onChange(from !== "" && to !== "" ? { op, v: [String(from), String(to)] } : undefined);
+    } else {
+      onChange(from !== "" ? { op, v: [String(from)] } : undefined);
+    }
+    onClose();
+  };
+
+  return (
+    <Stack gap="xs">
+      <OperatorSelect def={def} value={op} onChange={setOp} />
+      {op === "between" ? (
+        <Group gap="xs" wrap="nowrap">
+          <NumberInput placeholder="Min" value={from} onChange={(v) => setFrom(v as number | "")} rightSection={def.unit} autoFocus />
+          <NumberInput placeholder="Max" value={to} onChange={(v) => setTo(v as number | "")} rightSection={def.unit} />
+        </Group>
+      ) : (
+        <NumberInput placeholder="Value" value={from} onChange={(v) => setFrom(v as number | "")} rightSection={def.unit} autoFocus />
+      )}
+      <Button size="sm" onClick={apply}>
+        Apply
+      </Button>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/bodies/RouteBody.tsx b/apps/edr-freight-web/backoffice/src/components/filters/bodies/RouteBody.tsx
new file mode 100644
index 000000000..55097b05b
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/bodies/RouteBody.tsx
@@ -0,0 +1,59 @@
+import { useState } from "react";
+import { Button, Select, Stack } from "@mantine/core";
+import { ArrowRight } from "lucide-react";
+
+import type { RouteFilterDef } from "../types";
+import type { FilterBodyProps } from "./TextBody";
+
+/**
+ * Origin + destination picked together, each a searchable `Select` over the
+ * page's yard list — typing filters by yard name, same as any Mantine
+ * Select. No `OperatorSelect`: a route pair has exactly one operator ("is"),
+ * which is why DEFAULT_OP.route is the only entry the generic bar needs.
+ */
+export function RouteBody({ def, value, onChange, onClose }: FilterBodyProps<RouteFilterDef>) {
+  const [origin, setOrigin] = useState<string | null>(value?.v[0] ?? null);
+  const [destination, setDestination] = useState<string | null>(value?.v[1] ?? null);
+
+  const apply = () => {
+    onChange(origin && destination ? { op: "is", v: [origin, destination] } : undefined);
+    onClose();
+  };
+
+  // This popover already lives inside FilterPill's own Popover. A Select's
+  // dropdown portals separately by default, so a click on an option registers
+  // as "outside" the outer Popover and closes the whole filter before a pick
+  // lands — same nested-portal bug DateBody had. Un-portalling keeps it
+  // inside the outer popover's DOM subtree instead.
+  const comboboxProps = { withinPortal: false } as const;
+
+  return (
+    <Stack gap="xs" w={240}>
+      <Select
+        label="Origin"
+        placeholder="Any"
+        data={def.options}
+        value={origin}
+        onChange={setOrigin}
+        comboboxProps={comboboxProps}
+        searchable
+        clearable
+        autoFocus
+      />
+      <ArrowRight size={14} className="text-gray-400" style={{ alignSelf: "center" }} />
+      <Select
+        label="Destination"
+        placeholder="Any"
+        data={def.options}
+        value={destination}
+        onChange={setDestination}
+        comboboxProps={comboboxProps}
+        searchable
+        clearable
+      />
+      <Button size="sm" onClick={apply} disabled={!(origin && destination)}>
+        Apply
+      </Button>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/bodies/TextBody.tsx b/apps/edr-freight-web/backoffice/src/components/filters/bodies/TextBody.tsx
new file mode 100644
index 000000000..7685ad4ae
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/bodies/TextBody.tsx
@@ -0,0 +1,39 @@
+import { useState } from "react";
+import { Button, Stack, TextInput } from "@mantine/core";
+
+import { DEFAULT_OP } from "../types";
+import type { TextFilterDef, FilterValue, Operator } from "../types";
+import { OperatorSelect } from "../OperatorSelect";
+
+export interface FilterBodyProps<Def> {
+  def: Def;
+  value: FilterValue | undefined;
+  onChange: (v: FilterValue | undefined) => void;
+  onClose: () => void;
+}
+
+export function TextBody({ def, value, onChange, onClose }: FilterBodyProps<TextFilterDef>) {
+  const [op, setOp] = useState<Operator>(value?.op ?? DEFAULT_OP.text);
+  const [text, setText] = useState(value?.v[0] ?? "");
+
+  const apply = () => {
+    onChange(text.trim() ? { op, v: [text.trim()] } : undefined);
+    onClose();
+  };
+
+  return (
+    <Stack gap="xs">
+      <OperatorSelect def={def} value={op} onChange={setOp} />
+      <TextInput
+        placeholder={def.placeholder ?? `Filter by ${def.label.toLowerCase()}…`}
+        value={text}
+        onChange={(e) => setText(e.currentTarget.value)}
+        onKeyDown={(e) => e.key === "Enter" && apply()}
+        autoFocus
+      />
+      <Button size="sm" onClick={apply}>
+        Apply
+      </Button>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/clientFilter.ts b/apps/edr-freight-web/backoffice/src/components/filters/clientFilter.ts
new file mode 100644
index 000000000..ae0034cbb
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/clientFilter.ts
@@ -0,0 +1,93 @@
+import { matchesDayRange, toDayString } from "@/hooks/useListControls";
+import type { FilterDef, FilterValue } from "./types";
+
+export { matchesDayRange, toDayString };
+
+const readField = (row: unknown, key: string): unknown =>
+  row && typeof row === "object" ? (row as Record<string, unknown>)[key] : undefined;
+
+export interface ClientFilterOptions<T> {
+  /** Row fields matched against the free-text search box. */
+  searchKeys?: (keyof T)[];
+  /** Custom search extractor when the value isn't a top-level field. */
+  searchValue?: (row: T) => string;
+}
+
+/**
+ * Client-side bridge for pages whose endpoint doesn't (yet) accept
+ * filter/sort/pagination params — the Family-B pages this app inherited from
+ * `ListControls`/`useListControls`. Same idea, generalized: instead of one
+ * hardcoded search box + one date range, every `FilterDef` is matched
+ * against `row[def.key]` (override the def's `key` to line up with the row
+ * shape, or filter/map the rows before calling this).
+ *
+ * Flip a page to server mode later by deleting the `applyClientFilters` call
+ * and passing `controls.params` straight to the API — `useFilters`'s output
+ * shape doesn't change either way.
+ *
+ * ponytail: linear scan per keystroke, no debounce — matches
+ * `useListControls`'s existing behavior at this data size (~1k rows,
+ * `useListControls.ts:4-18`). Move to server-side filtering if a list
+ * outgrows that.
+ */
+export function applyClientFilters<T>(
+  rows: T[],
+  defs: FilterDef[],
+  values: Record<string, FilterValue>,
+  searchText: string,
+  options: ClientFilterOptions<T> = {},
+): T[] {
+  const term = searchText.trim().toLowerCase();
+  const { searchKeys = [], searchValue } = options;
+
+  return rows.filter((row) => {
+    if (term) {
+      const haystack = searchValue
+        ? searchValue(row)
+        : searchKeys.map((k) => String(readField(row, String(k)) ?? "")).join(" ");
+      if (!haystack.toLowerCase().includes(term)) return false;
+    }
+    for (const def of defs) {
+      const value = values[def.key];
+      if (!value) continue;
+      if (!matchesFilter(def, value, readField(row, def.key))) return false;
+    }
+    return true;
+  });
+}
+
+function matchesFilter(def: FilterDef, value: FilterValue, raw: unknown): boolean {
+  switch (def.type) {
+    case "enum": {
+      const inSet = value.v.includes(String(raw ?? ""));
+      return value.op === "isNot" ? !inSet : inSet;
+    }
+    case "date": {
+      if (value.op === "between") {
+        return matchesDayRange(raw, value.v[0]?.slice(0, 10) ?? null, value.v[1]?.slice(0, 10) ?? null);
+      }
+      const day = toDayString(raw);
+      const target = value.v[0]?.slice(0, 10);
+      if (!day || !target) return false;
+      return value.op === "before" ? day <= target : day >= target;
+    }
+    case "number": {
+      const num = Number(raw);
+      if (Number.isNaN(num)) return false;
+      if (value.op === "between") {
+        const [min, max] = value.v.map(Number);
+        return num >= min && num <= max;
+      }
+      return value.op === "isNot" ? num !== Number(value.v[0]) : num === Number(value.v[0]);
+    }
+    case "boolean":
+      return Boolean(raw) === (value.v[0] === "true");
+    case "text": {
+      const rawStr = String(raw ?? "").toLowerCase();
+      const target = (value.v[0] ?? "").toLowerCase();
+      return value.op === "isNot" ? !rawStr.includes(target) : rawStr.includes(target);
+    }
+    default:
+      return true;
+  }
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/dates.ts b/apps/edr-freight-web/backoffice/src/components/filters/dates.ts
new file mode 100644
index 000000000..b51ef493c
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/dates.ts
@@ -0,0 +1,51 @@
+import type { FilterValue } from "./types";
+
+/** Local start-of-day -> ISO, for inclusive "from" date filters. Lifted out of
+ * ContractRequestsPage (where it was duplicated into BookingRequestsPage) so
+ * every date filter shares one definition. */
+export function startOfDayIso(d: Date): string {
+  const x = new Date(d);
+  x.setHours(0, 0, 0, 0);
+  return x.toISOString();
+}
+
+/** Local end-of-day -> ISO, for inclusive "to" date filters. */
+export function endOfDayIso(d: Date): string {
+  const x = new Date(d);
+  x.setHours(23, 59, 59, 999);
+  return x.toISOString();
+}
+
+/**
+ * Parse a `YYYY-MM-DD` date-picker string into a LOCAL-midnight Date.
+ *
+ * `new Date("2026-01-01")` is a date-ONLY ISO string, which the spec parses
+ * as UTC midnight, not local midnight. For anyone east of UTC (Ethiopia is
+ * UTC+3) that instant already falls on the PREVIOUS local day, so
+ * `startOfDayIso`/`endOfDayIso` built from it silently shift the picked date
+ * back by one — the picker looks fine, the filtered results are wrong. This
+ * constructor form (`new Date(y, m, d)`) is local by definition; use it for
+ * every date-only string instead of `new Date(dateString)`.
+ */
+export function parseDateStr(dateStr: string): Date {
+  const [y, m, d] = dateStr.split("-").map(Number);
+  return new Date(y, (m || 1) - 1, d || 1);
+}
+
+/**
+ * `toParams` for a date `FilterDef` widened to `["between", "before", "after"]`
+ * operators. `DateBody` always emits a single-element `v` for before/after —
+ * a plain positional `{[fromKey]: v[0], [toKey]: v[1]}` mapping (the
+ * between-only default) would wrongly land a "before" pick in `fromKey`
+ * instead of `toKey`. This routes each operator to the right bound.
+ */
+export function dateRangeParams(
+  fromKey: string,
+  toKey: string,
+): (v: FilterValue) => Record<string, string | undefined> {
+  return (value) => {
+    if (value.op === "before") return { [toKey]: value.v[0] };
+    if (value.op === "after") return { [fromKey]: value.v[0] };
+    return { [fromKey]: value.v[0], [toKey]: value.v[1] };
+  };
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/format.ts b/apps/edr-freight-web/backoffice/src/components/filters/format.ts
new file mode 100644
index 000000000..24489abf8
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/format.ts
@@ -0,0 +1,40 @@
+import { parseFilters } from "./url";
+import type { FilterDef, FilterValue } from "./types";
+
+/** Human-readable text for one filter's current value — same text a
+ * FilterPill shows, and what a saved view's auto-generated label is built
+ * from, so both read identically with zero duplicated logic. */
+export function formatFilterValue(def: FilterDef, value: FilterValue): string {
+  if (def.format) return def.format(value, def);
+  if (def.type === "enum") {
+    const labels = value.v.map((v) => def.options.find((o) => o.value === v)?.label ?? v);
+    return labels.join(", ");
+  }
+  if (def.type === "date" && value.v.length === 2) {
+    return `${value.v[0].slice(0, 10)} → ${value.v[1].slice(0, 10)}`;
+  }
+  if (def.type === "route" && value.v.length === 2) {
+    const label = (id: string) => def.options.find((o) => o.value === id)?.label ?? id;
+    return `${label(value.v[0])} → ${label(value.v[1])}`;
+  }
+  return value.v.join(", ");
+}
+
+/**
+ * Auto-generated label for a saved view — "Status: Active, Draft · Direction:
+ * Import" — built straight from the filters it holds, instead of asking the
+ * user to type a name (which drifts out of sync with what the view actually
+ * filters the moment they edit it). Falls back to "All" when nothing decodes,
+ * though a view is only ever offered for saving with at least one active filter.
+ *
+ * Namespace-aware pages (`useFilters({ ns })`, for a second table on the same
+ * page) aren't decoded here — every current saved-view page is single-table.
+ * Thread `ns` through if/when that changes.
+ */
+export function describeQuery(defs: FilterDef[], query: string): string {
+  const values = parseFilters(defs, new URLSearchParams(query));
+  const parts = defs
+    .filter((d) => values[d.key])
+    .map((d) => `${d.label}: ${formatFilterValue(d, values[d.key])}`);
+  return parts.length ? parts.join(" · ") : "All";
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/index.ts b/apps/edr-freight-web/backoffice/src/components/filters/index.ts
new file mode 100644
index 000000000..ea2c28fb2
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/index.ts
@@ -0,0 +1,15 @@
+export * from "./types";
+export * from "./url";
+export * from "./dates";
+export * from "./format";
+export * from "./clientFilter";
+export * from "./ruleEngineFooterProps";
+export * from "./useFilters";
+export * from "./useSavedViews";
+export { FilterBar } from "./FilterBar";
+export type { FilterBarProps } from "./FilterBar";
+export { FilterPill } from "./FilterPill";
+export { SortControl } from "./SortControl";
+export { SaveViewButton } from "./SaveViewButton";
+export { SavedViewCards } from "./SavedViewCards";
+export { MoreFiltersMenu } from "./MoreFiltersMenu";
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/ruleEngineFooterProps.ts b/apps/edr-freight-web/backoffice/src/components/filters/ruleEngineFooterProps.ts
new file mode 100644
index 000000000..e8cd32dab
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/ruleEngineFooterProps.ts
@@ -0,0 +1,32 @@
+import type { OnChangeFn, PaginationState } from "@edr/ui-common";
+import type { UseFilters } from "./useFilters";
+
+/**
+ * Adapts `useFilters`'s URL-backed page/pageSize to `RuleEngineListFooter`'s
+ * prop shape, for the client-bridge pages that render a plain `<Table>` +
+ * that footer instead of `<DataTable>` (which has `tableProps()` for this).
+ * Routes page-index vs page-size changes to the right setter — the same
+ * pageSize-gets-silently-dropped bug `tableProps()` had before it was fixed.
+ */
+export function toRuleEngineFooterProps(
+  controls: Pick<UseFilters, "page" | "pageSize" | "setPage" | "setPageSize">,
+  totalCount: number,
+): {
+  pagination: PaginationState;
+  pageCount: number;
+  totalCount: number;
+  onPaginationChange: OnChangeFn<PaginationState>;
+} {
+  const { page, pageSize, setPage, setPageSize } = controls;
+  return {
+    pagination: { pageIndex: page - 1, pageSize },
+    pageCount: Math.max(1, Math.ceil(totalCount / pageSize)),
+    totalCount,
+    onPaginationChange: (updater) => {
+      const current = { pageIndex: page - 1, pageSize };
+      const next = typeof updater === "function" ? updater(current) : updater;
+      if (next.pageSize !== pageSize) setPageSize(next.pageSize);
+      else if (next.pageIndex !== current.pageIndex) setPage(next.pageIndex + 1);
+    },
+  };
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/types.ts b/apps/edr-freight-web/backoffice/src/components/filters/types.ts
new file mode 100644
index 000000000..9f0c35d43
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/types.ts
@@ -0,0 +1,115 @@
+export type FilterType = "text" | "enum" | "date" | "number" | "boolean" | "route";
+
+export type Operator = "is" | "isNot" | "contains" | "between" | "before" | "after";
+
+/** Operator implied by a filter's type when the def doesn't say otherwise. */
+export const DEFAULT_OP: Record<FilterType, Operator> = {
+  text: "contains",
+  enum: "is",
+  date: "between",
+  number: "is",
+  boolean: "is",
+  route: "is",
+};
+
+export const OPERATOR_LABELS: Record<Operator, string> = {
+  is: "is",
+  isNot: "is not",
+  contains: "contains",
+  between: "is between",
+  before: "is before",
+  after: "is after",
+};
+
+/**
+ * A filter's current value. `v` holds:
+ * - 1 entry for is / isNot / contains / before / after
+ * - 2 entries for between (range)
+ * - n entries for a multi-select enum (isAnyOf is expressed as op "is" + n values)
+ */
+export interface FilterValue {
+  op: Operator;
+  v: string[];
+}
+
+export interface FilterOption {
+  value: string;
+  label: string;
+}
+
+export interface FacetBucket {
+  value: string;
+  count: number;
+}
+
+interface FilterDefBase {
+  /** URL key and, by default, the API param name. */
+  key: string;
+  /** Plain string — the caller applies i18n's t() before passing it in. */
+  label: string;
+  type: FilterType;
+  /** Defaults to `[DEFAULT_OP[type]]`. Widen only where the endpoint implements it. */
+  operators?: Operator[];
+  /** Pill text override. Default: "Label | value(s)". */
+  format?: (v: FilterValue, def: FilterDef) => string;
+  /** Map to API query params. Default `{ [key]: v.join(",") }`. */
+  toParams?: (v: FilterValue) => Record<string, string | undefined>;
+  /** Lives behind "More filters" until it has a value. Default false. */
+  secondary?: boolean;
+}
+
+export interface TextFilterDef extends FilterDefBase {
+  type: "text";
+  placeholder?: string;
+}
+
+export interface EnumFilterDef extends FilterDefBase {
+  type: "enum";
+  options: FilterOption[];
+  /** Default true — checkbox list. false renders a single-select radio list. */
+  multiple?: boolean;
+  /** value -> count in the current (filtered) result set. Absent = no counts, hide nothing. */
+  counts?: Record<string, number>;
+}
+
+export interface DateFilterDef extends FilterDefBase {
+  type: "date";
+  calendar?: "gregorian" | "ethiopian";
+}
+
+export interface NumberFilterDef extends FilterDefBase {
+  type: "number";
+  unit?: string;
+}
+
+export interface BooleanFilterDef extends FilterDefBase {
+  type: "boolean";
+  trueLabel?: string;
+  falseLabel?: string;
+}
+
+/**
+ * Origin + destination picked together as one pill — `v` is always the
+ * 2-slot pair `[originYardId, destinationYardId]`, never partial (the body's
+ * Apply button stays disabled until both sides are chosen, same rule
+ * `DateBody` uses for a `between` range). One shared `options` list drives
+ * both selects.
+ */
+export interface RouteFilterDef extends FilterDefBase {
+  type: "route";
+  options: FilterOption[];
+}
+
+export type FilterDef =
+  | TextFilterDef
+  | EnumFilterDef
+  | DateFilterDef
+  | NumberFilterDef
+  | BooleanFilterDef
+  | RouteFilterDef;
+
+/** A page's sort options — value is already `"field:DIR"`, the codebase's existing convention. */
+export interface SortOption {
+  value: string;
+  label: string;
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/url.test.ts b/apps/edr-freight-web/backoffice/src/components/filters/url.test.ts
new file mode 100644
index 000000000..55cc42bf2
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/url.test.ts
@@ -0,0 +1,170 @@
+import { describe, expect, it } from "vitest";
+
+import type { FilterDef, FilterValue } from "./types";
+import {
+  decodeFilterValue,
+  encodeFilterValue,
+  parseFilters,
+  parseSort,
+  toApiParams,
+  writeFilter,
+} from "./url";
+
+const STATUS: FilterDef = {
+  key: "statuses",
+  label: "Status",
+  type: "enum",
+  options: [
+    { value: "ACTIVE", label: "Active" },
+    { value: "DRAFT", label: "Draft" },
+  ],
+};
+
+const DIRECTION: FilterDef = {
+  key: "tradeDirection",
+  label: "Direction",
+  type: "enum",
+  multiple: false,
+  options: [{ value: "IMPORT", label: "Import" }],
+};
+
+const SEARCH: FilterDef = { key: "q", label: "Search", type: "text" };
+
+const CREATED: FilterDef = {
+  key: "created",
+  label: "Created",
+  type: "date",
+  toParams: ({ v }) => ({ createdFrom: v[0], createdTo: v[1] }),
+};
+
+describe("encodeFilterValue / decodeFilterValue round-trip", () => {
+  const cases: Array<{ name: string; type: FilterDef["type"]; value: FilterValue }> = [
+    { name: "text contains (default op omitted)", type: "text", value: { op: "contains", v: ["maersk"] } },
+    { name: "enum is (default op omitted, multi value)", type: "enum", value: { op: "is", v: ["ACTIVE", "DRAFT"] } },
+    { name: "enum isNot (non-default op prefixed)", type: "enum", value: { op: "isNot", v: ["GOV"] } },
+    { name: "date between (default op omitted)", type: "date", value: { op: "between", v: ["2026-01-01", "2026-03-01"] } },
+    { name: "date before (non-default op prefixed)", type: "date", value: { op: "before", v: ["2026-01-01"] } },
+    { name: "number is", type: "number", value: { op: "is", v: ["42"] } },
+    { name: "boolean is", type: "boolean", value: { op: "is", v: ["true"] } },
+  ];
+
+  for (const { name, type, value } of cases) {
+    it(`round-trips: ${name}`, () => {
+      const encoded = encodeFilterValue(type, value);
+      const decoded = decodeFilterValue(type, encoded);
+      expect(decoded).toEqual(value);
+    });
+  }
+
+  it("omits the operator prefix only when it is the type default", () => {
+    expect(encodeFilterValue("enum", { op: "is", v: ["ACTIVE"] })).toBe("ACTIVE");
+    expect(encodeFilterValue("enum", { op: "isNot", v: ["ACTIVE"] })).toBe("isNot:ACTIVE");
+  });
+
+  it("never comma-splits a text value, so a literal comma survives", () => {
+    const encoded = encodeFilterValue("text", { op: "contains", v: ["Addis, Ethiopia"] });
+    expect(decodeFilterValue("text", encoded)).toEqual({ op: "contains", v: ["Addis, Ethiopia"] });
+  });
+});
+
+describe("decodeFilterValue malformed-input tolerance", () => {
+  it("returns null for an empty string", () => {
+    expect(decodeFilterValue("text", "")).toBeNull();
+  });
+
+  it("does not treat an unknown prefix as an operator", () => {
+    // "foo" isn't a known Operator, so "foo:bar" is a literal text value, not op:value.
+    expect(decodeFilterValue("text", "foo:bar")).toEqual({ op: "contains", v: ["foo:bar"] });
+  });
+
+  it("degrades a one-sided 'between' to null (not applied) instead of guessing a half-open range", () => {
+    expect(decodeFilterValue("date", "between:2026-01-01")).toBeNull();
+  });
+
+  it("never throws on garbage input", () => {
+    expect(() => decodeFilterValue("enum", "isNot:")).not.toThrow();
+    expect(() => decodeFilterValue("date", "between:")).not.toThrow();
+    expect(() => decodeFilterValue("number", ":::")).not.toThrow();
+  });
+});
+
+describe("parseFilters / writeFilter", () => {
+  it("parses only the defs present, ignoring unrelated params", () => {
+    const params = new URLSearchParams("statuses=ACTIVE,DRAFT&unrelated=x&q=addis");
+    const values = parseFilters([STATUS, SEARCH], params);
+    expect(values).toEqual({
+      statuses: { op: "is", v: ["ACTIVE", "DRAFT"] },
+      q: { op: "contains", v: ["addis"] },
+    });
+  });
+
+  it("writeFilter deletes the param when value is undefined", () => {
+    const params = new URLSearchParams("statuses=ACTIVE");
+    const next = writeFilter(params, STATUS, undefined);
+    expect(next.has("statuses")).toBe(false);
+  });
+
+  it("writeFilter round-trips through parseFilters", () => {
+    const value: FilterValue = { op: "is", v: ["IMPORT"] };
+    const next = writeFilter(new URLSearchParams(), DIRECTION, value);
+    expect(parseFilters([DIRECTION], next)).toEqual({ tradeDirection: value });
+  });
+
+  it("namespaces keys when ns is given, so two tables on one page don't collide", () => {
+    const next = writeFilter(new URLSearchParams(), STATUS, { op: "is", v: ["ACTIVE"] }, "a");
+    expect(next.get("a.statuses")).toBe("ACTIVE");
+    expect(parseFilters([STATUS], new URLSearchParams(), "b")).toEqual({});
+  });
+});
+
+describe("existing deep-link backward compatibility", () => {
+  it("parses the BookingRequestsPage-style ?statuses=A,B&tradeDirection=IMPORT link unchanged", () => {
+    const params = new URLSearchParams("statuses=SUBMITTED,APPROVED&tradeDirection=IMPORT");
+    expect(parseFilters([STATUS, DIRECTION], params)).toEqual({
+      statuses: { op: "is", v: ["SUBMITTED", "APPROVED"] },
+      tradeDirection: { op: "is", v: ["IMPORT"] },
+    });
+  });
+});
+
+describe("parseSort", () => {
+  const options = [
+    { value: "createdAt:DESC", label: "Newest first" },
+    { value: "createdAt:ASC", label: "Oldest first" },
+  ];
+
+  it("returns the fallback when sort is absent", () => {
+    expect(parseSort(new URLSearchParams(), options, "createdAt:DESC")).toBe("createdAt:DESC");
+  });
+
+  it("returns the fallback for an unrecognized sort value", () => {
+    expect(parseSort(new URLSearchParams("sort=bogus:DESC"), options, "createdAt:DESC")).toBe(
+      "createdAt:DESC",
+    );
+  });
+
+  it("returns the URL value when it is a known option", () => {
+    expect(parseSort(new URLSearchParams("sort=createdAt:ASC"), options, "createdAt:DESC")).toBe(
+      "createdAt:ASC",
+    );
+  });
+});
+
+describe("toApiParams", () => {
+  it("uses the default mapping (key: joined csv) when toParams is absent", () => {
+    const values = { statuses: { op: "is" as const, v: ["ACTIVE", "DRAFT"] } };
+    expect(toApiParams([STATUS], values)).toEqual({ statuses: "ACTIVE,DRAFT" });
+  });
+
+  it("uses a custom toParams to reproduce an existing API's exact param names", () => {
+    const values = { created: { op: "between" as const, v: ["2026-01-01", "2026-03-01"] } };
+    expect(toApiParams([CREATED], values)).toEqual({
+      createdFrom: "2026-01-01",
+      createdTo: "2026-03-01",
+    });
+  });
+
+  it("omits defs with no value", () => {
+    expect(toApiParams([STATUS, SEARCH], {})).toEqual({});
+  });
+});
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/url.ts b/apps/edr-freight-web/backoffice/src/components/filters/url.ts
new file mode 100644
index 000000000..014ca5540
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/url.ts
@@ -0,0 +1,117 @@
+import { DEFAULT_OP, type FilterDef, type FilterValue, type Operator } from "./types";
+
+const OPERATORS: readonly Operator[] = ["is", "isNot", "contains", "between", "before", "after"];
+
+/**
+ * Encode one filter value as `[op:]csv`, omitting the operator prefix when it
+ * matches the type's default — that keeps the common case short and, more
+ * importantly, keeps the existing `?statuses=A,B` deep links this app already
+ * generates (e.g. the header document-review alarm) parsing identically.
+ *
+ * `,` and `:` are structural inside an encoded value. A `text` filter is
+ * never comma-split (its `v` always has exactly one entry), which is what
+ * lets a free-text search contain a literal comma safely.
+ * ponytail: if a value ever legitimately needs a literal "op:" prefix or a
+ * comma inside a multi-value filter, switch that filter to a JSON-in-one-param
+ * encoding rather than trying to escape these two characters.
+ */
+export function encodeFilterValue(type: FilterDef["type"], value: FilterValue): string {
+  const csv = value.v.map(encodeURIComponent).join(",");
+  return value.op === DEFAULT_OP[type] ? csv : `${value.op}:${csv}`;
+}
+
+/** Inverse of `encodeFilterValue`. Returns null for anything malformed — a bad
+ * URL is user input and must degrade to "filter not applied", never throw. */
+export function decodeFilterValue(type: FilterDef["type"], raw: string): FilterValue | null {
+  if (!raw) return null;
+  const firstColon = raw.indexOf(":");
+  let op: Operator = DEFAULT_OP[type];
+  let rest = raw;
+  if (firstColon > 0) {
+    const prefix = raw.slice(0, firstColon);
+    if ((OPERATORS as string[]).includes(prefix)) {
+      op = prefix as Operator;
+      rest = raw.slice(firstColon + 1);
+    }
+  }
+  // Text filters are single-value and never comma-split, so a literal comma
+  // in a search term round-trips unchanged.
+  const v =
+    type === "text"
+      ? [decodeURIComponent(rest)]
+      : rest.split(",").filter(Boolean).map(decodeURIComponent);
+  if (v.length === 0) return null;
+  // A malformed range (wrong arity) has no safe single-sided interpretation —
+  // "between:2026-01-01" doesn't say whether that's the from or the to — so
+  // it degrades to "filter not applied" rather than guessing a half-open range.
+  if (op === "between" && v.length !== 2) return null;
+  return { op, v };
+}
+
+/** Every FilterDef's current value, parsed from the URL. Unknown/malformed entries are dropped. */
+export function parseFilters(
+  defs: FilterDef[],
+  params: URLSearchParams,
+  ns?: string,
+): Record<string, FilterValue> {
+  const out: Record<string, FilterValue> = {};
+  for (const def of defs) {
+    const raw = params.get(nsKey(def.key, ns));
+    if (!raw) continue;
+    const value = decodeFilterValue(def.type, raw);
+    if (value) out[def.key] = value;
+  }
+  return out;
+}
+
+/** Write (or delete) one filter's value into a URLSearchParams, returning a new instance. */
+export function writeFilter(
+  params: URLSearchParams,
+  def: FilterDef,
+  value: FilterValue | undefined,
+  ns?: string,
+): URLSearchParams {
+  const next = new URLSearchParams(params);
+  const key = nsKey(def.key, ns);
+  if (!value || value.v.length === 0) next.delete(key);
+  else next.set(key, encodeFilterValue(def.type, value));
+  return next;
+}
+
+function nsKey(key: string, ns?: string): string {
+  return ns ? `${ns}.${key}` : key;
+}
+
+/** `?sort=field:DIR` -> `"field:DIR"`, defaulting when absent/unrecognized. */
+export function parseSort(params: URLSearchParams, options: { value: string }[], fallback: string): string {
+  const raw = params.get("sort");
+  if (raw && options.some((o) => o.value === raw)) return raw;
+  return fallback;
+}
+
+/**
+ * Flatten every def's parsed value into the flat param object a page's
+ * react-query filter object / axios params already expect. `toParams`
+ * defaults to `{ [key]: v.join(",") }`, which reproduces exactly what
+ * `?statuses=A,B` meant before this bar existed.
+ */
+export function toApiParams(
+  defs: FilterDef[],
+  values: Record<string, FilterValue>,
+): Record<string, string | undefined> {
+  const out: Record<string, string | undefined> = {};
+  for (const def of defs) {
+    const value = values[def.key];
+    if (!value) continue;
+    const mapped = def.toParams ? def.toParams(value) : { [def.key]: value.v.join(",") };
+    Object.assign(out, mapped);
+  }
+  return out;
+}
+
+/** Delete emptystring/undefined/null entries — never send them, never write them to the URL. */
+export function cleanParams<T extends Record<string, unknown>>(params: T): Partial<T> {
+  return Object.fromEntries(
+    Object.entries(params).filter(([, v]) => v !== undefined && v !== null && v !== ""),
+  ) as Partial<T>;
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/useFilters.ts b/apps/edr-freight-web/backoffice/src/components/filters/useFilters.ts
new file mode 100644
index 000000000..7c4dfbf43
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/useFilters.ts
@@ -0,0 +1,236 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useSearchParams } from "react-router-dom";
+import { useDebouncedValue } from "@mantine/hooks";
+
+import type { DataTablePagination, DataTableProps } from "@edr/ui-common";
+import type { FilterDef, FilterValue } from "./types";
+import { cleanParams, parseFilters, toApiParams, writeFilter } from "./url";
+
+export interface UseFiltersOptions {
+  /** value = "field:DIR", matching the codebase's existing sort convention. */
+  defaultSort?: string;
+  pageSize?: number;
+  /** "page" (freight: {page,pageSize}) or "skip" (record-management: {skip,take}). */
+  paginationStyle?: "page" | "skip";
+  /** Namespaces URL keys ("<ns>.<key>") for pages with two independent tables. */
+  ns?: string;
+  /** Search box debounce, ms. */
+  searchDebounceMs?: number;
+}
+
+export interface UseFilters {
+  values: Record<string, FilterValue>;
+  /** Flat params ready for the react-query key + axios `params` — IS the query key input. */
+  params: Record<string, string | number>;
+  sort: string;
+  page: number;
+  pageSize: number;
+  searchText: string;
+  setSearchText: (s: string) => void;
+  setFilter: (key: string, value: FilterValue | undefined) => void;
+  removeFilter: (key: string) => void;
+  clearFilters: () => void;
+  setSort: (s: string) => void;
+  setPage: (p: number) => void;
+  setPageSize: (size: number) => void;
+  activeCount: number;
+  /** Spread onto <DataTable/>. Same shape useListControls.tableProps returns today. */
+  tableProps: (total: number) => Pick<DataTableProps<any, any>, "pagination" | "tableOptions">;
+  /** Replace the whole URL (saved-view restore). Pushes, so Back undoes it. */
+  applyQueryString: (query: string) => void;
+  /** Current filter state as a raw query string, for saving as a view (page stripped). */
+  currentQueryString: () => string;
+}
+
+const DEFAULT_PAGE_SIZE = 10;
+
+export function useFilters(defs: FilterDef[], options: UseFiltersOptions = {}): UseFilters {
+  const {
+    defaultSort = "",
+    pageSize: defaultPageSize = DEFAULT_PAGE_SIZE,
+    paginationStyle = "page",
+    ns,
+    searchDebounceMs = 300,
+  } = options;
+
+  const [sp, setSp] = useSearchParams();
+  const searchKey = ns ? `${ns}.q` : "q";
+  const pageKey = ns ? `${ns}.page` : "page";
+  const sizeKey = ns ? `${ns}.size` : "size";
+
+  const values = useMemo(() => parseFilters(defs, sp, ns), [defs, sp, ns]);
+  const sort = sp.get(ns ? `${ns}.sort` : "sort") ?? defaultSort;
+  const page = Math.max(1, Number(sp.get(pageKey)) || 1);
+  const pageSize = Math.max(1, Number(sp.get(sizeKey)) || defaultPageSize);
+
+  // Free text: local draft debounced into the URL with `replace`, so typing
+  // leaves exactly one history entry instead of one per keystroke.
+  const [searchText, setSearchTextState] = useState(() => sp.get(searchKey) ?? "");
+  const [debouncedSearch] = useDebouncedValue(searchText, searchDebounceMs);
+
+  useEffect(() => {
+    const urlValue = sp.get(searchKey) ?? "";
+    if (urlValue === debouncedSearch) return;
+    setSp(
+      (prev) => {
+        const next = new URLSearchParams(prev);
+        if (debouncedSearch) next.set(searchKey, debouncedSearch);
+        else next.delete(searchKey);
+        next.delete(pageKey);
+        return next;
+      },
+      { replace: true },
+    );
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [debouncedSearch]);
+
+  useEffect(() => {
+    // External navigation (back/forward, saved-view restore, deep link) —
+    // sync the local draft from the URL. Comparing against the debounced
+    // value (not `searchText`) is what stops this from clobbering an
+    // in-flight keystroke: mid-type, urlValue !== debouncedSearch is expected.
+    const urlValue = sp.get(searchKey) ?? "";
+    if (urlValue !== debouncedSearch) setSearchTextState(urlValue);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [sp]);
+
+  const setFilter = useCallback(
+    (key: string, value: FilterValue | undefined) => {
+      const def = defs.find((d) => d.key === key);
+      if (!def) return;
+      setSp((prev) => {
+        const next = writeFilter(prev, def, value, ns);
+        next.delete(pageKey);
+        return next;
+      });
+    },
+    [defs, ns, pageKey, setSp],
+  );
+
+  const removeFilter = useCallback((key: string) => setFilter(key, undefined), [setFilter]);
+
+  const clearFilters = useCallback(() => {
+    setSp((prev) => {
+      const next = new URLSearchParams(prev);
+      for (const def of defs) next.delete(ns ? `${ns}.${def.key}` : def.key);
+      next.delete(searchKey);
+      next.delete(pageKey);
+      return next;
+    });
+    setSearchTextState("");
+  }, [defs, ns, pageKey, searchKey, setSp]);
+
+  const setSort = useCallback(
+    (value: string) => {
+      setSp((prev) => {
+        const next = new URLSearchParams(prev);
+        const key = ns ? `${ns}.sort` : "sort";
+        if (value === defaultSort) next.delete(key);
+        else next.set(key, value);
+        next.delete(pageKey);
+        return next;
+      });
+    },
+    [defaultSort, ns, pageKey, setSp],
+  );
+
+  const setPage = useCallback(
+    (p: number) => {
+      setSp((prev) => {
+        const next = new URLSearchParams(prev);
+        if (p <= 1) next.delete(pageKey);
+        else next.set(pageKey, String(p));
+        return next;
+      });
+    },
+    [pageKey, setSp],
+  );
+
+  const setPageSize = useCallback(
+    (size: number) => {
+      setSp((prev) => {
+        const next = new URLSearchParams(prev);
+        if (size === defaultPageSize) next.delete(sizeKey);
+        else next.set(sizeKey, String(size));
+        next.delete(pageKey); // a different page size invalidates the current page index
+        return next;
+      });
+    },
+    [defaultPageSize, sizeKey, pageKey, setSp],
+  );
+
+  const params = useMemo(() => {
+    const filterParams = toApiParams(defs, values);
+    const base: Record<string, string | number | undefined> =
+      paginationStyle === "skip"
+        ? { skip: (page - 1) * pageSize, take: pageSize }
+        : { page, pageSize };
+    if (debouncedSearch) base.search = debouncedSearch;
+    if (sort) {
+      if (paginationStyle === "skip") base.orderBy = sort;
+      else {
+        const [sortBy, sortOrder] = sort.split(":");
+        base.sortBy = sortBy;
+        base.sortOrder = sortOrder;
+      }
+    }
+    return cleanParams({ ...filterParams, ...base }) as Record<string, string | number>;
+  }, [defs, values, paginationStyle, page, pageSize, debouncedSearch, sort]);
+
+  const activeCount = Object.keys(values).length + (debouncedSearch ? 1 : 0);
+
+  const tableProps = useCallback(
+    (total: number): Pick<DataTableProps<any, any>, "pagination" | "tableOptions"> => {
+      const pageCount = Math.max(1, Math.ceil(total / pageSize));
+      const pagination: DataTablePagination = { pageIndex: page - 1, pageSize, pageCount, totalCount: total };
+      return {
+        pagination,
+        tableOptions: {
+          manualPagination: true,
+          pageCount,
+          state: { pagination: { pageIndex: page - 1, pageSize } },
+          onPaginationChange: (updater) => {
+            const current = { pageIndex: page - 1, pageSize };
+            const next = typeof updater === "function" ? updater(current) : updater;
+            if (next.pageSize !== pageSize) setPageSize(next.pageSize);
+            else if (next.pageIndex !== current.pageIndex) setPage(next.pageIndex + 1);
+          },
+        },
+      };
+    },
+    [page, pageSize, setPage, setPageSize],
+  );
+
+  const applyQueryString = useCallback(
+    (query: string) => setSp(new URLSearchParams(query)),
+    [setSp],
+  );
+
+  const currentQueryString = useCallback(() => {
+    const next = new URLSearchParams(sp);
+    next.delete(pageKey);
+    return next.toString();
+  }, [sp, pageKey]);
+
+  return {
+    values,
+    params,
+    sort,
+    page,
+    pageSize,
+    searchText,
+    setSearchText: setSearchTextState,
+    setFilter,
+    removeFilter,
+    clearFilters,
+    setSort,
+    setPage,
+    setPageSize,
+    activeCount,
+    tableProps,
+    applyQueryString,
+    currentQueryString,
+  };
+}
+
+export { toApiParams } from "./url";
diff --git a/apps/edr-freight-web/backoffice/src/components/filters/useSavedViews.ts b/apps/edr-freight-web/backoffice/src/components/filters/useSavedViews.ts
new file mode 100644
index 000000000..f08738562
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/filters/useSavedViews.ts
@@ -0,0 +1,32 @@
+import { useLocalStorage } from "@mantine/hooks";
+
+export interface SavedView {
+  id: string;
+  /** Raw query string ("statuses=ACTIVE&sort=createdAt:DESC") — the label is
+   * derived from this at render time (see format.ts's describeQuery), so
+   * there's nothing else to keep in sync. */
+  query: string;
+  savedAt: number;
+}
+
+/**
+ * localStorage namespace is per PAGE (viewId), not per user — this is a
+ * backoffice, one staff login per browser profile.
+ * ponytail: add ":<userId>" if shared-terminal login appears.
+ */
+export function useSavedViews(viewId: string) {
+  const [views, setViews] = useLocalStorage<SavedView[]>({
+    key: `edr:saved-views:${viewId}`,
+    defaultValue: [],
+  });
+
+  const save = (query: string): SavedView => {
+    const view: SavedView = { id: crypto.randomUUID(), query, savedAt: Date.now() };
+    setViews((prev) => [...prev, view]);
+    return view;
+  };
+
+  const remove = (id: string) => setViews((prev) => prev.filter((v) => v.id !== id));
+
+  return { views, save, remove };
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/invoices/EimsFilingCard.tsx b/apps/edr-freight-web/backoffice/src/components/invoices/EimsFilingCard.tsx
new file mode 100644
index 000000000..c668c0570
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/invoices/EimsFilingCard.tsx
@@ -0,0 +1,585 @@
+import { useState } from "react";
+import {
+  Alert,
+  Badge,
+  Button,
+  Card,
+  Group,
+  Modal,
+  NumberInput,
+  Radio,
+  Select,
+  SimpleGrid,
+  Stack,
+  Table,
+  Text,
+  Textarea,
+  TextInput,
+} from "@mantine/core";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { AlertTriangle, Ban, Download, FileText, RefreshCw, Send, ShieldCheck } from "lucide-react";
+
+import { useAuth } from "@/auth/useAuth";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { api } from "@/services/api";
+import { eimsService } from "@/services/eims.service";
+import { openPdfBlob } from "@/components/warehouses/pdf";
+import { EIMS_MODE_OF_PAYMENT, type EimsInvoiceStatus, type EimsModeOfPayment } from "@/types/eims";
+import { useToast } from "@/hooks/use-toast";
+
+const STATUS_COLOR: Record<EimsInvoiceStatus, string> = {
+  NOT_SUBMITTED: "gray",
+  SUBMITTING: "yellow",
+  REGISTERED: "edr-green",
+  FAILED: "red",
+  UNKNOWN: "orange",
+  CANCELLED: "gray",
+};
+
+const STATUS_LABEL: Record<EimsInvoiceStatus, string> = {
+  NOT_SUBMITTED: "Not filed",
+  SUBMITTING: "Filing…",
+  REGISTERED: "Filed",
+  FAILED: "Rejected",
+  UNKNOWN: "Unacknowledged",
+  CANCELLED: "Cancelled",
+};
+
+function Field({ label, value }: { label: string; value?: string | number | null }) {
+  return (
+    <Stack gap={2}>
+      <Text size="xs" fw={600} c="edr-muted" tt="uppercase">
+        {label}
+      </Text>
+      <Text size="sm" c="edr-text" style={{ wordBreak: "break-all" }}>
+        {value === null || value === undefined || value === "" ? "—" : value}
+      </Text>
+    </Stack>
+  );
+}
+
+/** Reason codes from the collection docs, e.g. "1" (Duplicate), "6" (Calculation Error). */
+const CANCEL_REASON_CODES = [
+  { value: "1", label: "1 — Duplicate" },
+  { value: "2", label: "2 — Buyer request" },
+  { value: "3", label: "3 — Data entry error" },
+  { value: "6", label: "6 — Calculation error" },
+];
+
+function CancelModal({
+  invoiceId,
+  opened,
+  onClose,
+}: {
+  invoiceId: string;
+  opened: boolean;
+  onClose: () => void;
+}) {
+  const { toast } = useToast();
+  const [reasonCode, setReasonCode] = useState<string | null>(null);
+  const [remark, setRemark] = useState("");
+
+  const cancel = useMutation(
+    api.invoices.eimsCancel.mutationOptions({
+      onSuccess: () => {
+        onClose();
+        toast({ title: "Cancelled with MoR" });
+      },
+      onError: (error) => toast({ title: "Could not cancel", description: error.message, variant: "destructive" }),
+    }),
+  );
+
+  return (
+    <Modal opened={opened} onClose={onClose} title="Cancel EIMS registration" centered>
+      <Stack gap="md">
+        <Text size="sm" c="dimmed">
+          Cancels this invoice&apos;s registered document at MoR. Irreversible — an already-cancelled
+          invoice refuses a second attempt.
+        </Text>
+        <Select
+          label="Reason code"
+          withAsterisk
+          data={CANCEL_REASON_CODES}
+          value={reasonCode}
+          onChange={setReasonCode}
+          placeholder="Select a reason"
+        />
+        <Textarea
+          label="Remark"
+          placeholder="Optional note"
+          value={remark}
+          onChange={(e) => setRemark(e.currentTarget.value)}
+          autosize
+          minRows={2}
+        />
+        <Button
+          color="red"
+          leftSection={<Ban size={16} />}
+          loading={cancel.isPending}
+          disabled={!reasonCode}
+          onClick={() => cancel.mutate({ id: invoiceId, reasonCode: reasonCode!, remark: remark.trim() || undefined })}
+        >
+          Cancel with MoR
+        </Button>
+      </Stack>
+    </Modal>
+  );
+}
+
+function SalesReceiptModal({
+  invoiceId,
+  opened,
+  onClose,
+}: {
+  invoiceId: string;
+  opened: boolean;
+  onClose: () => void;
+}) {
+  const { toast } = useToast();
+  const [modeOfPayment, setModeOfPayment] = useState<EimsModeOfPayment | null>(null);
+  const [collectedAmount, setCollectedAmount] = useState<number | "">("");
+  const [reason, setReason] = useState("");
+
+  const register = useMutation(
+    api.invoices.eimsRegisterSalesReceipt.mutationOptions({
+      onSuccess: (receipt) => {
+        onClose();
+        toast({ title: "Sales receipt filed", description: `RRN ${receipt.rrn ?? "—"}` });
+      },
+      onError: (error) => toast({ title: "Could not file receipt", description: error.message, variant: "destructive" }),
+    }),
+  );
+
+  return (
+    <Modal opened={opened} onClose={onClose} title="File sales receipt" centered>
+      <Stack gap="md">
+        <Select
+          label="Mode of payment"
+          withAsterisk
+          data={EIMS_MODE_OF_PAYMENT.map((v) => ({ value: v, label: v }))}
+          value={modeOfPayment}
+          onChange={(v) => setModeOfPayment(v as EimsModeOfPayment)}
+          placeholder="Select"
+        />
+        <NumberInput
+          label="Collected amount"
+          placeholder="Defaults to the invoice's paid amount"
+          min={0}
+          decimalScale={2}
+          value={collectedAmount}
+          onChange={(v) => setCollectedAmount(v === "" ? "" : Number(v))}
+        />
+        <TextInput
+          label="Reason"
+          placeholder='Defaults to "Payment received"'
+          value={reason}
+          onChange={(e) => setReason(e.currentTarget.value)}
+        />
+        <Button
+          color="edr-green"
+          leftSection={<Send size={16} />}
+          loading={register.isPending}
+          disabled={!modeOfPayment}
+          onClick={() =>
+            register.mutate({
+              id: invoiceId,
+              modeOfPayment: modeOfPayment!,
+              collectedAmount: collectedAmount === "" ? undefined : collectedAmount,
+              reason: reason.trim() || undefined,
+            })
+          }
+        >
+          File with MoR
+        </Button>
+      </Stack>
+    </Modal>
+  );
+}
+
+function WithholdingReceiptModal({
+  invoiceId,
+  opened,
+  onClose,
+}: {
+  invoiceId: string;
+  opened: boolean;
+  onClose: () => void;
+}) {
+  const { toast } = useToast();
+  const [type, setType] = useState("TWHT");
+  const [preTaxAmount, setPreTaxAmount] = useState<number | "">("");
+  const [withholdingAmount, setWithholdingAmount] = useState<number | "">("");
+  const [reason, setReason] = useState("");
+
+  const register = useMutation(
+    api.invoices.eimsRegisterWithholdingReceipt.mutationOptions({
+      onSuccess: (receipt) => {
+        onClose();
+        toast({ title: "Withholding receipt filed", description: `RRN ${receipt.rrn ?? "—"}` });
+      },
+      onError: (error) => toast({ title: "Could not file receipt", description: error.message, variant: "destructive" }),
+    }),
+  );
+
+  const valid = preTaxAmount !== "" && withholdingAmount !== "";
+
+  return (
+    <Modal opened={opened} onClose={onClose} title="File withholding receipt" centered>
+      <Stack gap="md">
+        <TextInput label="Type" withAsterisk value={type} onChange={(e) => setType(e.currentTarget.value)} />
+        <NumberInput
+          label="Pre-tax amount"
+          withAsterisk
+          min={0}
+          decimalScale={2}
+          value={preTaxAmount}
+          onChange={(v) => setPreTaxAmount(v === "" ? "" : Number(v))}
+        />
+        <NumberInput
+          label="Withholding amount"
+          withAsterisk
+          min={0}
+          decimalScale={2}
+          value={withholdingAmount}
+          onChange={(v) => setWithholdingAmount(v === "" ? "" : Number(v))}
+        />
+        <TextInput
+          label="Reason"
+          placeholder='Defaults to "Withholding"'
+          value={reason}
+          onChange={(e) => setReason(e.currentTarget.value)}
+        />
+        <Button
+          color="edr-green"
+          leftSection={<Send size={16} />}
+          loading={register.isPending}
+          disabled={!valid}
+          onClick={() =>
+            register.mutate({
+              id: invoiceId,
+              type,
+              preTaxAmount: preTaxAmount as number,
+              withholdingAmount: withholdingAmount as number,
+              reason: reason.trim() || undefined,
+            })
+          }
+        >
+          File with MoR
+        </Button>
+      </Stack>
+    </Modal>
+  );
+}
+
+function MemoModal({
+  invoiceId,
+  opened,
+  onClose,
+}: {
+  invoiceId: string;
+  opened: boolean;
+  onClose: () => void;
+}) {
+  const { toast } = useToast();
+  const [type, setType] = useState<"CRE" | "DEB">("CRE");
+  const [reason, setReason] = useState("");
+
+  const issue = useMutation(
+    api.invoices.issueMemo.mutationOptions({
+      onSuccess: (memo) => {
+        onClose();
+        toast({ title: "Memo issued", description: `${memo.invoiceNumber} — file it with MoR separately` });
+      },
+      onError: (error) => toast({ title: "Could not issue memo", description: error.message, variant: "destructive" }),
+    }),
+  );
+
+  return (
+    <Modal opened={opened} onClose={onClose} title="Issue credit/debit memo" centered>
+      <Stack gap="md">
+        <Text size="sm" c="dimmed">
+          Creates a new invoice linked to this one, with every line copied verbatim. Filing it with
+          MoR is a separate step — it does not happen automatically here.
+        </Text>
+        <Radio.Group value={type} onChange={(v) => setType(v as "CRE" | "DEB")} label="Type">
+          <Stack gap="xs" mt="xs">
+            <Radio value="CRE" label="Credit memo" description="Reduces what the buyer owes; created settled." />
+            <Radio value="DEB" label="Debit memo" description="An additional charge; created as a new open invoice." />
+          </Stack>
+        </Radio.Group>
+        <Textarea
+          label="Reason"
+          withAsterisk
+          placeholder="Why this memo is being issued"
+          value={reason}
+          onChange={(e) => setReason(e.currentTarget.value)}
+          autosize
+          minRows={2}
+        />
+        <Button
+          color="edr-green"
+          loading={issue.isPending}
+          disabled={!reason.trim()}
+          onClick={() => issue.mutate({ id: invoiceId, type, reason: reason.trim() })}
+        >
+          Issue memo
+        </Button>
+      </Stack>
+    </Modal>
+  );
+}
+
+function ReceiptsSection({ invoiceId, canFile }: { invoiceId: string; canFile: boolean }) {
+  const { toast } = useToast();
+  const { data: receipts } = useQuery(api.invoices.eimsReceipts.queryOptions({ input: { id: invoiceId } }));
+  const [salesOpen, setSalesOpen] = useState(false);
+  const [withholdingOpen, setWithholdingOpen] = useState(false);
+  const [downloadingId, setDownloadingId] = useState<string | null>(null);
+
+  const download = async (receiptId: string, receiptNumber: string) => {
+    setDownloadingId(receiptId);
+    try {
+      const { data } = await eimsService.downloadReceiptDocument(invoiceId, receiptId);
+      openPdfBlob(data, `${receiptNumber}.pdf`);
+    } catch (error) {
+      toast({
+        title: "Could not download receipt",
+        description: error instanceof Error ? error.message : undefined,
+        variant: "destructive",
+      });
+    } finally {
+      setDownloadingId(null);
+    }
+  };
+
+  return (
+    <Stack gap="sm">
+      <Group justify="space-between">
+        <Text fw={600} size="sm" c="edr-text">
+          Receipts
+        </Text>
+        {canFile && (
+          <Group gap="xs">
+            <Button size="xs" variant="light" onClick={() => setSalesOpen(true)}>
+              File sales receipt
+            </Button>
+            <Button size="xs" variant="light" onClick={() => setWithholdingOpen(true)}>
+              File withholding receipt
+            </Button>
+          </Group>
+        )}
+      </Group>
+
+      {receipts && receipts.length > 0 ? (
+        <Table striped withTableBorder={false} verticalSpacing="xs">
+          <Table.Thead>
+            <Table.Tr>
+              <Table.Th>Kind</Table.Th>
+              <Table.Th>Status</Table.Th>
+              <Table.Th>RRN</Table.Th>
+              <Table.Th />
+            </Table.Tr>
+          </Table.Thead>
+          <Table.Tbody>
+            {receipts.map((r) => (
+              <Table.Tr key={r.id}>
+                <Table.Td>{r.kind}</Table.Td>
+                <Table.Td>
+                  <Badge color={STATUS_COLOR[r.status] ?? "gray"} variant="light" size="sm">
+                    {STATUS_LABEL[r.status] ?? r.status}
+                  </Badge>
+                </Table.Td>
+                <Table.Td style={{ fontFamily: "monospace" }}>{r.rrn ?? "—"}</Table.Td>
+                <Table.Td>
+                  {r.status === "REGISTERED" && (
+                    <Button
+                      size="xs"
+                      variant="subtle"
+                      leftSection={<Download size={14} />}
+                      loading={downloadingId === r.id}
+                      onClick={() => void download(r.id, r.receiptNumber)}
+                    >
+                      PDF
+                    </Button>
+                  )}
+                </Table.Td>
+              </Table.Tr>
+            ))}
+          </Table.Tbody>
+        </Table>
+      ) : (
+        <Text size="sm" c="dimmed">
+          No receipts filed yet.
+        </Text>
+      )}
+
+      <SalesReceiptModal invoiceId={invoiceId} opened={salesOpen} onClose={() => setSalesOpen(false)} />
+      <WithholdingReceiptModal invoiceId={invoiceId} opened={withholdingOpen} onClose={() => setWithholdingOpen(false)} />
+    </Stack>
+  );
+}
+
+/**
+ * MoR EIMS filing state for one invoice, with the manual actions.
+ *
+ * Filing normally happens on the API's cron sweep, not here — these controls exist for controlled
+ * testing and for the exceptional cases the sweep deliberately refuses: a rejected invoice that
+ * needs re-filing, and an unacknowledged one that has blocked all further filing.
+ */
+export function EimsFilingCard({ invoiceId }: { invoiceId: string }) {
+  const { user } = useAuth();
+  const { toast } = useToast();
+  const canFile = hasPermission(user, FREIGHT_PERMS.invoices.eimsRegister);
+  const canCancel = hasPermission(user, FREIGHT_PERMS.invoices.eimsCancel);
+  const canFileReceipt = hasPermission(user, FREIGHT_PERMS.invoices.eimsReceiptRegister);
+  const canIssueMemo = hasPermission(user, FREIGHT_PERMS.invoices.memoIssue);
+
+  const [cancelOpen, setCancelOpen] = useState(false);
+  const [memoOpen, setMemoOpen] = useState(false);
+
+  const { data: eims, isLoading } = useQuery(
+    api.invoices.eimsStatus.queryOptions({ input: { id: invoiceId }, enabled: Boolean(invoiceId) }),
+  );
+
+  const register = useMutation(
+    api.invoices.eimsRegister.mutationOptions({
+      onSuccess: (result) =>
+        toast({
+          title: result.eimsIrn ? "Filed with MoR" : "Filing finished",
+          description: result.eimsIrn ? `IRN ${result.eimsIrn}` : `Status ${result.eimsStatus}`,
+        }),
+    }),
+  );
+
+  const verify = useMutation(
+    api.invoices.eimsVerify.mutationOptions({
+      onSuccess: (result) =>
+        toast({
+          title: "MoR confirmed the filing",
+          description: `Document ${result.body?.DocumentDetails?.DocumentNumber ?? "—"}`,
+        }),
+    }),
+  );
+
+  if (isLoading || !eims) return null;
+
+  const status = eims.eimsStatus;
+  const busy = register.isPending || verify.isPending;
+
+  return (
+    <Card>
+      <Stack gap="lg">
+        <Group justify="space-between">
+          <Text fw={600} c="edr-text">
+            MoR e-invoicing
+          </Text>
+          <Badge color={STATUS_COLOR[status] ?? "gray"} variant="light" size="sm" radius="md" fw={600}>
+            {STATUS_LABEL[status] ?? status}
+          </Badge>
+        </Group>
+
+        <SimpleGrid cols={{ base: 1, sm: 2, lg: 4 }} spacing="lg">
+          <Field label="IRN" value={eims.eimsIrn} />
+          <Field label="Invoice counter" value={eims.eimsInvoiceCounter} />
+          <Field
+            label="Submitted"
+            value={eims.eimsSubmittedAt ? new Date(eims.eimsSubmittedAt).toLocaleString() : null}
+          />
+          <Field label="Acknowledged" value={eims.eimsAckDate} />
+        </SimpleGrid>
+
+        {status === "UNKNOWN" && (
+          <Alert color="orange" icon={<AlertTriangle size={16} />} title="All filing is blocked">
+            This invoice was sent but never acknowledged, so its IRN is unknown and no further
+            invoice can be filed. Confirm its status with MoR, then have a supervisor record the IRN
+            or discard the attempt.
+          </Alert>
+        )}
+
+        {eims.eimsLastError && (
+          <Alert
+            color={status === "FAILED" ? "red" : "orange"}
+            icon={<AlertTriangle size={16} />}
+            title={`MoR reported: ${eims.eimsLastError.kind}`}
+          >
+            {eims.eimsLastError.message}
+          </Alert>
+        )}
+
+        {status === "CANCELLED" && (
+          <Alert color="gray" icon={<Ban size={16} />} title="Cancelled with MoR">
+            {eims.eimsCancellationDate ? `Confirmed ${eims.eimsCancellationDate}. ` : ""}
+            {eims.eimsCancellationRemark}
+          </Alert>
+        )}
+
+        <Group gap="sm">
+          {canFile && (
+            <>
+              {/* UNKNOWN is never re-filed from here: resubmitting risks a duplicate registration. */}
+              {status !== "REGISTERED" && status !== "UNKNOWN" && status !== "CANCELLED" && (
+                <Button
+                  size="xs"
+                  variant="light"
+                  radius="md"
+                  loading={register.isPending}
+                  disabled={busy}
+                  leftSection={status === "FAILED" ? <RefreshCw size={14} /> : <Send size={14} />}
+                  onClick={() => register.mutate({ id: invoiceId })}
+                >
+                  {status === "FAILED" ? "File again" : "File with MoR"}
+                </Button>
+              )}
+
+              {eims.eimsIrn && (
+                <Button
+                  size="xs"
+                  variant="light"
+                  radius="md"
+                  loading={verify.isPending}
+                  disabled={busy}
+                  leftSection={<ShieldCheck size={14} />}
+                  onClick={() => verify.mutate({ id: invoiceId })}
+                >
+                  Verify with MoR
+                </Button>
+              )}
+            </>
+          )}
+
+          {canCancel && eims.eimsIrn && status !== "CANCELLED" && (
+            <Button
+              size="xs"
+              variant="light"
+              color="red"
+              radius="md"
+              leftSection={<Ban size={14} />}
+              onClick={() => setCancelOpen(true)}
+            >
+              Cancel with MoR
+            </Button>
+          )}
+
+          {canIssueMemo && status === "REGISTERED" && (
+            <Button
+              size="xs"
+              variant="light"
+              radius="md"
+              leftSection={<FileText size={14} />}
+              onClick={() => setMemoOpen(true)}
+            >
+              Issue credit/debit memo
+            </Button>
+          )}
+        </Group>
+
+        {eims.eimsIrn && <ReceiptsSection invoiceId={invoiceId} canFile={canFileReceipt} />}
+      </Stack>
+
+      <CancelModal invoiceId={invoiceId} opened={cancelOpen} onClose={() => setCancelOpen(false)} />
+      <MemoModal invoiceId={invoiceId} opened={memoOpen} onClose={() => setMemoOpen(false)} />
+    </Card>
+  );
+}
+
+export default EimsFilingCard;
diff --git a/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardHeader.tsx b/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardHeader.tsx
index 2ca73f10a..0144db306 100644
--- a/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardHeader.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardHeader.tsx
@@ -15,9 +15,7 @@ import {
   FileSignature,
   Languages,
   LogOut,
-  Moon,
   Search,
-  Sun,
   User,
 } from "lucide-react";
 import { type ReactNode } from "react";
@@ -31,13 +29,10 @@ import type { PageMeta } from "./types";
 export interface FreightDashboardHeaderProps {
   pageMeta: PageMeta;
   headerRight?: ReactNode;
-  enableThemeToggle?: boolean;
   userName?: string;
   userEmail?: string;
   userInitials?: string;
   onLogout?: () => void;
-  theme: "light" | "dark";
-  onToggleTheme: () => void;
   mobileOpened: boolean;
   onToggleMobile: () => void;
   /** Hide the mobile burger when the shell has no sidebar to open. */
@@ -51,13 +46,10 @@ const ISLAND =
 
 const FreightDashboardHeader = ({
   headerRight,
-  enableThemeToggle = false,
   userName = "User",
   userEmail,
   userInitials,
   onLogout,
-  theme,
-  onToggleTheme,
   mobileOpened,
   onToggleMobile,
   hideSidebarBurger = false,
@@ -129,26 +121,6 @@ const FreightDashboardHeader = ({
 
           <NotificationBellContainer />
 
-          {enableThemeToggle && (
-            <Tooltip
-              label={theme === "dark" ? "Light mode" : "Dark mode"}
-              withArrow
-              openDelay={300}
-            >
-              <UnstyledButton
-                className={ISLAND}
-                onClick={onToggleTheme}
-                aria-label="Toggle theme"
-              >
-                {theme === "dark" ? (
-                  <Sun size={17} strokeWidth={1.8} />
-                ) : (
-                  <Moon size={17} strokeWidth={1.8} />
-                )}
-              </UnstyledButton>
-            </Tooltip>
-          )}
-
           {/* Avatar pill */}
           <Menu width={240} position="bottom-end" withinPortal shadow="md" offset={8} radius="md">
             <Menu.Target>
diff --git a/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardLayout.tsx b/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardLayout.tsx
index f3772cd76..7e6f1c523 100644
--- a/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardLayout.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/layout/FreightDashboardLayout.tsx
@@ -1,26 +1,15 @@
 import { AppShell, Box } from "@mantine/core";
 import { useDisclosure } from "@mantine/hooks";
-import { type ReactNode, useEffect, useState } from "react";
+import { type ReactNode } from "react";
 
 import FreightDashboardHeader from "./FreightDashboardHeader";
 import FreightSidebar from "./FreightSidebar";
 import { getPageMeta } from "./route-meta";
 import type { SidebarSection } from "./types";
 
-type Theme = "light" | "dark";
-const THEME_STORAGE_KEY = "edr-theme";
 const HEADER_HEIGHT = 64;
 const NAVBAR_WIDTH = 280;
 
-function getInitialTheme(): Theme {
-  if (typeof window === "undefined") return "light";
-  const stored = window.localStorage.getItem(THEME_STORAGE_KEY);
-  if (stored === "dark" || stored === "light") return stored;
-  return window.matchMedia?.("(prefers-color-scheme: dark)").matches
-    ? "dark"
-    : "light";
-}
-
 export interface FreightDashboardLayoutProps {
   sidebarSections: SidebarSection[];
   /** Render the shell with no navbar at all (used by GL clearance-only users). */
@@ -28,7 +17,6 @@ export interface FreightDashboardLayoutProps {
   activeHref?: string;
   onNavigate?: (href: string) => void;
   headerRight?: ReactNode;
-  enableThemeToggle?: boolean;
   userName?: string;
   userEmail?: string;
   userInitials?: string;
@@ -42,7 +30,6 @@ const FreightDashboardLayout = ({
   activeHref = "",
   onNavigate,
   headerRight,
-  enableThemeToggle = false,
   userName,
   userEmail,
   userInitials,
@@ -53,20 +40,6 @@ const FreightDashboardLayout = ({
   const [mobileOpened, { toggle: toggleMobile, close: closeMobile }] =
     useDisclosure(false);
 
-  const [theme, setTheme] = useState<Theme>(() =>
-    enableThemeToggle ? getInitialTheme() : "light",
-  );
-
-  useEffect(() => {
-    if (!enableThemeToggle) return;
-    const root = document.documentElement;
-    root.classList.toggle("dark", theme === "dark");
-    window.localStorage.setItem(THEME_STORAGE_KEY, theme);
-  }, [theme, enableThemeToggle]);
-
-  const toggleTheme = () =>
-    setTheme((current) => (current === "dark" ? "light" : "dark"));
-
   const navigate = (href: string) => {
     closeMobile();
     onNavigate?.(href);
@@ -93,13 +66,10 @@ const FreightDashboardLayout = ({
       <FreightDashboardHeader
         pageMeta={pageMeta}
         headerRight={headerRight}
-        enableThemeToggle={enableThemeToggle}
         userName={userName}
         userEmail={userEmail}
         userInitials={userInitials}
         onLogout={onLogout}
-        theme={theme}
-        onToggleTheme={toggleTheme}
         mobileOpened={mobileOpened}
         onToggleMobile={toggleMobile}
         hideSidebarBurger={hideSidebar}
diff --git a/apps/edr-freight-web/backoffice/src/components/layout/route-meta.ts b/apps/edr-freight-web/backoffice/src/components/layout/route-meta.ts
index 9aa11043b..691040c0a 100644
--- a/apps/edr-freight-web/backoffice/src/components/layout/route-meta.ts
+++ b/apps/edr-freight-web/backoffice/src/components/layout/route-meta.ts
@@ -36,6 +36,34 @@ const ROUTE_META: Array<{ prefix: string; meta: PageMeta }> = [
       subtitle: "Dashboard summary and key metrics",
     },
   },
+  {
+    prefix: "/dashboard/overview/bookings",
+    meta: { title: "Bookings", subtitle: "Booking volume, pipeline, and recent activity" },
+  },
+  {
+    prefix: "/dashboard/overview/contracts",
+    meta: { title: "Contracts", subtitle: "Contract volume, pipeline, and recent activity" },
+  },
+  {
+    prefix: "/dashboard/overview/billing",
+    meta: { title: "Billing", subtitle: "Revenue, payments, and collection status" },
+  },
+  {
+    prefix: "/dashboard/overview/operations",
+    meta: { title: "Operations", subtitle: "Trains, schedules, containers, and cargo" },
+  },
+  {
+    prefix: "/dashboard/overview/fleet",
+    meta: { title: "Fleet", subtitle: "Wagon and train fleet status" },
+  },
+  {
+    prefix: "/dashboard/overview/customers",
+    meta: { title: "Customers", subtitle: "Customer growth and top accounts" },
+  },
+  {
+    prefix: "/dashboard/overview/staff",
+    meta: { title: "Staff", subtitle: "Employee and user account status" },
+  },
   {
     prefix: "/dashboard/profile",
     meta: {
@@ -44,10 +72,19 @@ const ROUTE_META: Array<{ prefix: string; meta: PageMeta }> = [
     },
   },
   {
-    prefix: "/dashboard/payments",
+    prefix: "/dashboard/chat",
     meta: {
-      title: "Payments",
-      subtitle: "View booking payment transactions",
+      title: "Chat",
+      subtitle: "Internal messaging for EDR staff",
+    },
+  },
+  {
+    // Invoices, Payments, and USD Payments are tabs on one page now
+    // (FinanceHubPage); the header title itself is set per-tab there.
+    prefix: "/dashboard/invoices",
+    meta: {
+      title: "Invoices",
+      subtitle: "Invoices, payments, and USD bank transfers",
     },
   },
   {
@@ -184,13 +221,6 @@ const ROUTE_META: Array<{ prefix: string; meta: PageMeta }> = [
       subtitle: "Manage dropdown options used across the platform",
     },
   },
-  {
-    prefix: "/dashboard/audit-logs",
-    meta: {
-      title: "Audit Logs",
-      subtitle: "Request and entity-level activity recorded across the freight API",
-    },
-  },
   {
     prefix: "/dashboard/configuration/contract-validity-periods",
     meta: {
diff --git a/apps/edr-freight-web/backoffice/src/components/layout/sidebar-sections.tsx b/apps/edr-freight-web/backoffice/src/components/layout/sidebar-sections.tsx
index 914a9cceb..fc5b90dbf 100644
--- a/apps/edr-freight-web/backoffice/src/components/layout/sidebar-sections.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/layout/sidebar-sections.tsx
@@ -1,5 +1,6 @@
 import {
   ArrowLeftRight,
+  BookOpen,
   Boxes,
   Building2,
   BarChart3,
@@ -8,8 +9,10 @@ import {
   FileText,
   Hammer,
   History,
+  Image as ImageIcon,
   LayoutDashboard,
   LayoutGrid,
+  Link2,
   MapPin,
   Network,
   Package,
@@ -17,10 +20,12 @@ import {
   PackageOpen,
   Paperclip,
   Receipt,
+  Stamp,
   ScrollText,
   Send,
   Settings,
   ShieldCheck,
+  HandCoins,
   Ship,
   SlidersHorizontal,
   Train,
@@ -28,6 +33,7 @@ import {
   Users,
   Wallet,
   LifeBuoy,
+  MessageSquare,
   TrainFront,
   XCircle,
 } from "lucide-react";
@@ -38,8 +44,6 @@ import type { SidebarItem, SidebarSection } from "./types";
 import {
   FREIGHT_PERMS,
   hasPermission as hasFreightPermission,
-  isDjiboutiGl,
-  isEthiopianGl,
   isSuperAdmin,
 } from "@/lib/permissions";
 import { getCategorySidebarChildren } from "@/pages/ruleEngine/config/resources";
@@ -50,529 +54,556 @@ import { getCategorySidebarChildren } from "@/pages/ruleEngine/config/resources"
  * a user's first reachable route without importing the route tree (App.tsx
  * imports RequirePermission, which imports landing — that would cycle).
  */
-export const buildSidebarSections = (demoItems: SidebarItem[]): SidebarSection[] => [
-  {
-    title: "Main menu",
-    items: [
-      {
-        label: "Overview",
-        href: "/dashboard/overview",
-        icon: <LayoutDashboard />,
-        permission: FREIGHT_PERMS.overview.view,
-      },
-      {
-        label: "Reports",
-        href: "/dashboard/reports",
-        icon: <BarChart3 />,
-        permission: FREIGHT_PERMS.reports.view,
-      },
-      {
-        label: "Customers",
-        href: "/dashboard/customers",
-        icon: <Building2 />,
-        permission: FREIGHT_PERMS.customers.view,
-      },
-      {
-        label: "Contracts",
-        href: "/dashboard/contract-requests",
-        icon: <FileSignature />,
-        permission: FREIGHT_PERMS.contracts.view,
-      },
-      {
-        label: "Bookings",
-        href: "/dashboard/booking-requests",
-        icon: <FileText />,
-        permission: FREIGHT_PERMS.bookings.view,
-      },
-      {
-        label: "Wagon cancellations",
-        href: "/dashboard/wagon-cancellations",
-        icon: <XCircle />,
-        permission: FREIGHT_PERMS.bookings.wagonCancellationView,
-      },
-      // Operations hub: per-shipment clearance-document review for services
-      // WITHOUT customs clearing (self-clearance) — bookings only.
-      {
-        label: "Clearance Documents",
-        href: "/dashboard/contracts/clearance-documents",
-        icon: <ShieldCheck />,
-        permission: FREIGHT_PERMS.contracts.opsClearanceReview,
-      },
-      {
-        label: "Payments",
-        href: "/dashboard/payments",
-        icon: <Wallet />,
-        permission: FREIGHT_PERMS.payments.view,
-      },
-      {
-        label: "Invoices",
-        href: "/dashboard/invoices",
-        icon: <Receipt />,
-        permission: FREIGHT_PERMS.invoices.view,
-      },
-      {
-        label: "Support",
-        href: "/dashboard/support",
-        icon: <LifeBuoy />,
-        permission: FREIGHT_PERMS.support.agentView,
-      },
-      ...demoItems,
-    ],
-  },
-  {
-    // title: "Port & Terminal",
-    items: [
-      {
-        label: "Operations",
-        icon: <Settings />,
-        children: [
-          {
-            label: "Clearance",
-            href: "/dashboard/contracts/clearance",
-            icon: <ShieldCheck />,
-            permission: [
-              FREIGHT_PERMS.contracts.clearanceReview,
-              FREIGHT_PERMS.contracts.clearanceEtActions,
-            ],
-          },
-          // {
-          //   label: "Shipment Requests",
-          //   href: "/dashboard/shipment-requests",
-          //   icon: <Send />,
-          //   permission: FREIGHT_PERMS.contracts.createBooking,
-          // },
-          // Operations Path A queue: per-booking self-clearance review for
-          // GENERAL non-customs booking instances (and legacy self-clear bookings).
-          // {
-          //   label: "Self-Clearance Review",
-          //   href: "/dashboard/contracts/ops-clearance",
-          //   icon: <ShieldCheck />,
-          //   permission: FREIGHT_PERMS.contracts.opsClearanceReview,
-          // },
-          {
-            label: "GL Djibouti Clearance",
-            href: "/dashboard/gl-djibouti/clearance",
-            icon: <Ship />,
-            permission: FREIGHT_PERMS.contracts.clearanceDjActions,
-          },
-          {
-            label: "Train Schedules",
-            href: "/dashboard/operations/train-scheduling-v2",
-            icon: <Train />,
-            permission: FREIGHT_PERMS.trainScheduling.view,
-          },
-          {
-            label: "Batch Board",
-            href: "/dashboard/operations/batch-board",
-            icon: <LayoutGrid />,
-            permission: FREIGHT_PERMS.trainScheduling.view,
-          },
-          {
-            label: "First Mile",
-            href: "/dashboard/operations/first-mile",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.firstMile.view,
-          },
-          {
-            label: "Last Mile",
-            href: "/dashboard/operations/last-mile",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.lastMile.view,
-          },
-        ],
-      },
-      {
-        label: "Fleet Management",
-        icon: <Truck />,
-        children: [
-          {
-            label: "Fleet Dashboard",
-            href: "/dashboard/fleet-dashboard",
-            icon: <LayoutDashboard />,
-            permission: FREIGHT_PERMS.fleetDashboard.view,
-          },
-          {
-            label: "Routes",
-            href: "/dashboard/routes",
-            icon: <Network />,
-            permission: [FREIGHT_PERMS.routes.view, FREIGHT_PERMS.fleet.view],
-          },
-          {
-            label: "Locomotives",
-            href: "/dashboard/locomotives",
-            icon: <Train />,
-            permission: [
-              FREIGHT_PERMS.locomotives.view,
-              FREIGHT_PERMS.fleet.view,
-            ],
-          },
-          {
-            label: "Train Builder",
-            href: "/dashboard/train-builder",
-            icon: <Hammer />,
-            permission: [FREIGHT_PERMS.trains.view, FREIGHT_PERMS.fleet.view],
-          },
+export const buildSidebarSections = (
+  demoItems: SidebarItem[],
+  reportItems: SidebarItem[] = [],
+): SidebarSection[] => [
+    {
+      title: "Main menu",
+      items: [
+        {
+          label: "Overview",
+          href: "/dashboard/overview",
+          icon: <LayoutDashboard />,
+          permission: FREIGHT_PERMS.overview.view,
+        },
+        {
+          label: "Customers",
+          href: "/dashboard/customers",
+          icon: <Building2 />,
+          permission: FREIGHT_PERMS.customers.view,
+        },
+        {
+          label: "Shipping Lines",
+          href: "/dashboard/shipping-lines",
+          icon: <Ship />,
+          permission: FREIGHT_PERMS.shippingLines.view,
+        },
+        {
+          label: "Shipping Line Credits",
+          href: "/dashboard/shipping-line-credits",
+          icon: <HandCoins />,
+          permission: FREIGHT_PERMS.shippingLineCredits.view,
+        },
+        {
+          label: "Contracts",
+          href: "/dashboard/contract-requests",
+          icon: <FileSignature />,
+          permission: FREIGHT_PERMS.contracts.view,
+        },
+        {
+          label: "Bookings",
+          href: "/dashboard/booking-requests",
+          icon: <FileText />,
+          permission: FREIGHT_PERMS.bookings.view,
+        },
+        // Shared-wagon gate: a consolidated pair waits for a human decision
+        // before either half reaches Operations.
+        {
+          label: "Shared wagon approvals",
+          href: "/dashboard/consolidation-approvals",
+          icon: <Link2 />,
+          permission: FREIGHT_PERMS.bookings.approveConsolidation,
+        },
+        {
+          label: "Wagon cancellations",
+          href: "/dashboard/wagon-cancellations",
+          icon: <XCircle />,
+          permission: FREIGHT_PERMS.bookings.wagonCancellationView,
+        },
+        // Operations hub: per-shipment clearance-document review for services
+        // WITHOUT customs clearing (self-clearance) — bookings only.
+        {
+          label: "Clearance Documents",
+          href: "/dashboard/contracts/clearance-documents",
+          icon: <ShieldCheck />,
+          permission: FREIGHT_PERMS.contracts.opsClearanceReview,
+        },
+        {
+          // Invoices, Payments, and USD Payments live on one page as tabs
+          // (FinanceHubPage) — single nav entry, OR'd across both keys so
+          // either permission alone still gets a user in.
+          label: "Transactions",
+          href: "/dashboard/invoices",
+          icon: <Receipt />,
+          permission: [FREIGHT_PERMS.invoices.view, FREIGHT_PERMS.payments.view],
+        },
+        {
+          label: "Support",
+          href: "/dashboard/support",
+          icon: <LifeBuoy />,
+          permission: FREIGHT_PERMS.support.agentView,
+        },
+        {
+          label: "Chat",
+          href: "/dashboard/chat",
+          icon: <MessageSquare />,
+          permission: FREIGHT_PERMS.chat.view,
+        },
+        ...demoItems,
+      ],
+    },
+    {
+      // title: "Port & Terminal",
+      items: [
+        {
+          label: "Operations",
+          icon: <Settings />,
+          children: [
+            {
+              label: "Clearance",
+              href: "/dashboard/contracts/clearance",
+              icon: <ShieldCheck />,
+              permission: [
+                FREIGHT_PERMS.contracts.clearanceReview,
+                FREIGHT_PERMS.contracts.clearanceEtActions,
+              ],
+            },
+            // {
+            //   label: "Shipment Requests",
+            //   href: "/dashboard/shipment-requests",
+            //   icon: <Send />,
+            //   permission: FREIGHT_PERMS.contracts.createBooking,
+            // },
+            // Operations Path A queue: per-booking self-clearance review for
+            // GENERAL non-customs booking instances (and legacy self-clear bookings).
+            // {
+            //   label: "Self-Clearance Review",
+            //   href: "/dashboard/contracts/ops-clearance",
+            //   icon: <ShieldCheck />,
+            //   permission: FREIGHT_PERMS.contracts.opsClearanceReview,
+            // },
+            {
+              label: "GL Djibouti Clearance",
+              href: "/dashboard/gl-djibouti/clearance",
+              icon: <Ship />,
+              permission: FREIGHT_PERMS.contracts.clearanceDjActions,
+            },
+            {
+              label: "Train Schedules",
+              href: "/dashboard/operations/train-scheduling-v2",
+              icon: <Train />,
+              permission: FREIGHT_PERMS.trainScheduling.view,
+            },
+            {
+              label: "Batch Board",
+              href: "/dashboard/operations/batch-board",
+              icon: <LayoutGrid />,
+              permission: FREIGHT_PERMS.trainScheduling.view,
+            },
+            {
+              label: "First Mile",
+              href: "/dashboard/operations/first-mile",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.firstMile.view,
+            },
+            {
+              label: "Last Mile",
+              href: "/dashboard/operations/last-mile",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.lastMile.view,
+            },
+          ],
+        },
+        {
+          label: "Fleet Management",
+          icon: <Truck />,
+          children: [
+            {
+              label: "Fleet Dashboard",
+              href: "/dashboard/fleet-dashboard",
+              icon: <LayoutDashboard />,
+              permission: FREIGHT_PERMS.fleetDashboard.view,
+            },
+            {
+              label: "Routes",
+              href: "/dashboard/routes",
+              icon: <Network />,
+              permission: FREIGHT_PERMS.routes.view,
+            },
+            {
+              label: "Locomotives",
+              href: "/dashboard/locomotives",
+              icon: <Train />,
+              permission: FREIGHT_PERMS.locomotives.view,
+            },
+            {
+              label: "Train Builder",
+              href: "/dashboard/train-builder",
+              icon: <Hammer />,
+              permission: FREIGHT_PERMS.trains.view,
+            },
 
-          // {
-          //   label: "Wagon types",
-          //   href: "/dashboard/wagon-types",
-          //   icon: <Boxes />,
-          // },
-          {
-            label: "Wagons",
-            href: "/dashboard/wagons",
-            icon: <Truck />,
-            permission: [FREIGHT_PERMS.wagons.view, FREIGHT_PERMS.fleet.view],
-          },
-          {
-            label: "Wagon Transfers",
-            href: "/dashboard/wagon-transfers",
-            icon: <ArrowLeftRight />,
-            permission: [
-              FREIGHT_PERMS.wagons.transferView,
-              FREIGHT_PERMS.wagons.view,
-            ],
-          },
-          {
-            label: "Vehicles",
-            href: "/dashboard/vehicles",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.vehicles.view,
-          },
-          {
-            label: "Drivers",
-            href: "/dashboard/drivers",
-            icon: <Users />,
-            permission: FREIGHT_PERMS.drivers.view,
-          },
-          {
-            label: "Track Vehicles",
-            href: "/dashboard/tracking",
-            icon: <MapPin />,
-            permission: FREIGHT_PERMS.tracking.view,
-          },
-          {
-            label: "Fuel Purchases",
-            href: "/dashboard/fuel-purchases",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.fuel.view,
-          },
-          {
-            label: "Fuel Analytics",
-            href: "/dashboard/fuel-stats",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.fuel.view,
-          },
-          {
-            label: "Maintenance",
-            href: "/dashboard/maintenance",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.maintenance.view,
-          },
-          {
-            label: "Work Orders",
-            href: "/dashboard/work-orders",
-            icon: <SlidersHorizontal />,
-            permission: FREIGHT_PERMS.maintenance.view,
-          },
-          {
-            label: "Compliance & Alerts",
-            href: "/dashboard/compliance",
-            icon: <ShieldCheck />,
-            permission: FREIGHT_PERMS.fleet.view,
-          },
-          {
-            label: "Incidents",
-            href: "/dashboard/incidents",
-            icon: <FileText />,
-            permission: FREIGHT_PERMS.fleet.view,
-          },
-          {
-            label: "Procurement",
-            href: "/dashboard/procurement",
-            icon: <Package />,
-            permission: FREIGHT_PERMS.fleet.view,
-          },
-          {
-            label: "Financial Reports",
-            href: "/dashboard/financial-reports",
-            icon: <Wallet />,
-            permission: FREIGHT_PERMS.fleetReports.view,
-          },
-          // {
-          //   label: "Containers",
-          //   href: "/dashboard/containers",
-          //   icon: <Container />,
-          // },
-          // {
-          //   label: "Cargoes",
-          //   href: "/dashboard/cargoes",
-          //   icon: <Package />,
-          // },
-        ],
-      },
-      {
-        label: "Imports",
-        href: "/dashboard/import-warehouse",
-        icon: <PackageOpen />,
-        permission: FREIGHT_PERMS.warehouseInventory.view,
-        children: [
-          {
-            label: "Import Overview",
-            href: "/dashboard/import-warehouse",
-            icon: <PackageOpen />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Arrival Queue",
-            href: "/dashboard/arrival-queue",
-            icon: <PackageOpen />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Import Trucks",
-            href: "/dashboard/import-trucks",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "EDR Last Mile Returns",
-            href: "/dashboard/edr-last-mile-returns",
-            icon: <Container />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Container Returns",
-            href: "/dashboard/container-returns",
-            icon: <Container />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Terminal Inventory",
-            href: "/dashboard/warehouse-inventory?direction=IMPORT",
-            icon: <Package />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Inventory Inquiry",
-            href: "/dashboard/inventory-inquiry",
-            icon: <Boxes />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-        ],
-      },
-      {
-        label: "Exports",
-        href: "/dashboard/export-warehouse",
-        icon: <Truck />,
-        permission: FREIGHT_PERMS.warehouseInventory.view,
-        children: [
-          {
-            label: "Export Overview",
-            href: "/dashboard/export-warehouse",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Loading Queue",
-            href: "/dashboard/loading-queue",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Loaded Inventory",
-            href: "/dashboard/loaded-inventory",
-            icon: <PackageCheck />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Dispatch Queue",
-            href: "/dashboard/dispatch-queue",
-            icon: <Send />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Djibouti Unloading",
-            href: "/dashboard/export-djibouti-unloading",
-            icon: <PackageOpen />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Interchange Documents",
-            href: "/dashboard/interchange-documents",
-            icon: <FileText />,
-            permission: FREIGHT_PERMS.interchangeDocuments.view,
-          },
-          {
-            label: "Terminal Inventory",
-            href: "/dashboard/warehouse-inventory?direction=EXPORT",
-            icon: <Package />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-        ],
-      },
-      {
-        label: "Intercity",
-        href: "/dashboard/intercity",
-        icon: <TrainFront />,
-        permission: FREIGHT_PERMS.trainScheduling.view,
-        children: [
-          {
-            label: "Intercity Cargo",
-            href: "/dashboard/intercity",
-            icon: <TrainFront />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-        ],
-      },
-      {
-        label: "Warehouse Management",
-        icon: <Container />,
-        children: [
-          {
-            label: "Warehouse Dashboard",
-            href: "/dashboard/warehouse-dashboard",
-            icon: <LayoutDashboard />,
-            permission: FREIGHT_PERMS.warehouseDashboard.view,
-          },
-          {
-            // Yard-wide, not per-direction: the gate sees import and export
-            // trucks at the same barrier.
-            label: "Trucks on Site",
-            href: "/dashboard/trucks-on-site",
-            icon: <Truck />,
-            permission: FREIGHT_PERMS.warehouseInventory.view,
-          },
-          {
-            label: "Warehouses",
-            href: "/dashboard/warehouses",
-            icon: <Container />,
-            permission: FREIGHT_PERMS.warehouses.view,
-          },
-          {
-            label: "Allocation & Fees",
-            href: "/dashboard/warehouse-rules",
-            icon: <SlidersHorizontal />,
-            permission: [
-              FREIGHT_PERMS.warehouseAllocationRules.view,
-              FREIGHT_PERMS.warehouseFeeRules.view,
-            ],
-          },
-          {
-            label: "Fee Invoices",
-            href: "/dashboard/warehouse-fee-invoices",
-            icon: <Wallet />,
-            permission: FREIGHT_PERMS.warehouseFeeInvoices.view,
-          },
-        ],
-      },
-    ],
-  },
-  {
-    title: "Freight configuration",
-    mutedTitle: true,
-    items: [
-      {
-        label: "File settings",
-        href: "/dashboard/file-settings",
-        icon: <Paperclip />,
-        permission: FREIGHT_PERMS.admin,
-      },
-      {
-        label: "Dropdown settings",
-        href: "/dashboard/dropdown-settings",
-        icon: <Settings />,
-        permission: FREIGHT_PERMS.admin,
-      },
-      {
-        label: "Contract templates",
-        href: "/dashboard/contract-templates",
-        icon: <ScrollText />,
-        permission: FREIGHT_PERMS.admin,
-      },
-      {
-        label: "Audit logs",
-        href: "/dashboard/audit-logs",
-        icon: <History />,
-        permission: FREIGHT_PERMS.audit.view,
-      },
-      {
-        label: "Configuration",
-        href: "/dashboard/configuration",
-        icon: <Boxes />,
-        children: [
-          ...getCategorySidebarChildren("configuration"),
-          {
-            label: "Train scheduling rules",
-            href: "/dashboard/configuration/train-scheduling-rules",
-            permission: FREIGHT_PERMS.trainScheduling.rulesManage,
-          },
-          {
-            label: "Trade access",
-            href: "/dashboard/configuration/trade-access",
-            permission: FREIGHT_PERMS.admin,
-          },
-          {
-            label: "Exchange rate",
-            href: "/dashboard/configuration/exchange-rate",
-            permission: FREIGHT_PERMS.admin,
-          },
-        ],
-      },
-      {
-        label: "Rules",
-        href: "/dashboard/rules",
-        icon: <SlidersHorizontal />,
-        children: getCategorySidebarChildren("rules"),
-      },
+            // {
+            //   label: "Wagon types",
+            //   href: "/dashboard/wagon-types",
+            //   icon: <Boxes />,
+            // },
+            {
+              label: "Wagons",
+              href: "/dashboard/wagons",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.wagons.view,
+            },
+            {
+              label: "Wagon Transfers",
+              href: "/dashboard/wagon-transfers",
+              icon: <ArrowLeftRight />,
+              permission: [
+                FREIGHT_PERMS.wagons.transferView,
+                FREIGHT_PERMS.wagons.view,
+              ],
+            },
+            {
+              label: "Vehicles",
+              href: "/dashboard/vehicles",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.vehicles.view,
+            },
+            {
+              label: "Drivers",
+              href: "/dashboard/drivers",
+              icon: <Users />,
+              permission: FREIGHT_PERMS.drivers.view,
+            },
+            {
+              label: "Track Vehicles",
+              href: "/dashboard/tracking",
+              icon: <MapPin />,
+              permission: FREIGHT_PERMS.tracking.view,
+            },
+            {
+              label: "Fuel Purchases",
+              href: "/dashboard/fuel-purchases",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.fuel.view,
+            },
+            {
+              label: "Fuel Analytics",
+              href: "/dashboard/fuel-stats",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.fuel.view,
+            },
+            {
+              label: "Maintenance",
+              href: "/dashboard/maintenance",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.maintenance.view,
+            },
+            {
+              label: "Work Orders",
+              href: "/dashboard/work-orders",
+              icon: <SlidersHorizontal />,
+              permission: FREIGHT_PERMS.maintenance.view,
+            },
+            {
+              label: "Compliance & Alerts",
+              href: "/dashboard/compliance",
+              icon: <ShieldCheck />,
+              permission: FREIGHT_PERMS.compliance.view,
+            },
+            {
+              label: "Incidents",
+              href: "/dashboard/incidents",
+              icon: <FileText />,
+              // No dedicated backend key exists for incidents yet. Not part of
+              // the fleet.view/admin fallback cleanup — removing fleet.view
+              // here with nothing to replace it would lock the page to
+              // super-admin only, so it stays as the sole (if coarse) gate.
+              permission: FREIGHT_PERMS.fleet.view,
+            },
+            {
+              label: "Procurement",
+              href: "/dashboard/procurement",
+              icon: <Package />,
+              permission: FREIGHT_PERMS.procurement.view,
+            },
+            {
+              label: "Financial Reports",
+              href: "/dashboard/financial-reports",
+              icon: <Wallet />,
+              permission: FREIGHT_PERMS.fleetReports.view,
+            },
+            // {
+            //   label: "Containers",
+            //   href: "/dashboard/containers",
+            //   icon: <Container />,
+            // },
+            // {
+            //   label: "Cargoes",
+            //   href: "/dashboard/cargoes",
+            //   icon: <Package />,
+            // },
+          ],
+        },
+        {
+          label: "Imports",
+          href: "/dashboard/import-warehouse",
+          icon: <PackageOpen />,
+          permission: FREIGHT_PERMS.warehouseInventory.view,
+          children: [
+            {
+              label: "Import Overview",
+              href: "/dashboard/import-warehouse",
+              icon: <PackageOpen />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Arrival Queue",
+              href: "/dashboard/arrival-queue",
+              icon: <PackageOpen />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Import Trucks",
+              href: "/dashboard/import-trucks",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Container Returns",
+              href: "/dashboard/container-returns",
+              icon: <Container />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Terminal Inventory",
+              href: "/dashboard/warehouse-inventory?direction=IMPORT",
+              icon: <Package />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Inventory Inquiry",
+              href: "/dashboard/inventory-inquiry",
+              icon: <Boxes />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+          ],
+        },
+        {
+          label: "Exports",
+          href: "/dashboard/export-warehouse",
+          icon: <Truck />,
+          permission: FREIGHT_PERMS.warehouseInventory.view,
+          children: [
+            {
+              label: "Export Overview",
+              href: "/dashboard/export-warehouse",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Loading Queue",
+              href: "/dashboard/loading-queue",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Loaded Inventory",
+              href: "/dashboard/loaded-inventory",
+              icon: <PackageCheck />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Dispatch Queue",
+              href: "/dashboard/dispatch-queue",
+              icon: <Send />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Djibouti Unloading",
+              href: "/dashboard/export-djibouti-unloading",
+              icon: <PackageOpen />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Interchange Documents",
+              href: "/dashboard/interchange-documents",
+              icon: <FileText />,
+              permission: FREIGHT_PERMS.interchangeDocuments.view,
+            },
+            {
+              label: "Terminal Inventory",
+              href: "/dashboard/warehouse-inventory?direction=EXPORT",
+              icon: <Package />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+          ],
+        },
+        {
+          label: "Intercity",
+          href: "/dashboard/intercity",
+          icon: <TrainFront />,
+          permission: FREIGHT_PERMS.trainScheduling.view,
+          children: [
+            {
+              label: "Intercity Cargo",
+              href: "/dashboard/intercity",
+              icon: <TrainFront />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+          ],
+        },
+        {
+          label: "Warehouse Management",
+          icon: <Container />,
+          children: [
+            {
+              label: "Warehouse Dashboard",
+              href: "/dashboard/warehouse-dashboard",
+              icon: <LayoutDashboard />,
+              permission: FREIGHT_PERMS.warehouseDashboard.view,
+            },
+            {
+              // Yard-wide, not per-direction: the gate sees import and export
+              // trucks at the same barrier.
+              label: "Trucks on Site",
+              href: "/dashboard/trucks-on-site",
+              icon: <Truck />,
+              permission: FREIGHT_PERMS.warehouseInventory.view,
+            },
+            {
+              label: "Warehouses",
+              href: "/dashboard/warehouses",
+              icon: <Container />,
+              permission: FREIGHT_PERMS.warehouses.view,
+            },
+            {
+              label: "Allocation & Fees",
+              href: "/dashboard/warehouse-rules",
+              icon: <SlidersHorizontal />,
+              permission: [
+                FREIGHT_PERMS.warehouseAllocationRules.view,
+                FREIGHT_PERMS.warehouseFeeRules.view,
+              ],
+            },
+            {
+              label: "Fee Invoices",
+              href: "/dashboard/warehouse-fee-invoices",
+              icon: <Wallet />,
+              permission: FREIGHT_PERMS.warehouseFeeInvoices.view,
+            },
+          ],
+        },
 
-      {
-        label: "Staff",
-        href: "/user-management",
-        icon: <Users />,
-        permission: [
-          FREIGHT_PERMS.admin,
-          FREIGHT_PERMS.staff.roles.view,
-          FREIGHT_PERMS.staff.employeeRegistration.view,
-          FREIGHT_PERMS.staff.roleAssignment.view,
-        ],
-      },
-    ],
-  },
-];
+        {
+          label: "Reports",
+          href: "/dashboard/reports",
+          icon: <BarChart3 />,
+          permission: FREIGHT_PERMS.reports.view,
+          // Populated from the live GET /reports catalog (already permission-
+          // filtered server-side) — no report key is ever hand-listed here.
+          ...(reportItems.length ? { children: reportItems } : {}),
+        },
+      ],
+    },
+    {
+      title: "Freight configuration",
+      mutedTitle: true,
+      items: [
+        {
+          label: "File settings",
+          href: "/dashboard/file-settings",
+          icon: <Paperclip />,
+          permission: FREIGHT_PERMS.settings.fileUpload.view,
+        },
+        {
+          label: "Dropdown settings",
+          href: "/dashboard/dropdown-settings",
+          icon: <Settings />,
+          permission: FREIGHT_PERMS.settings.dropdown.view,
+        },
+        {
+          // One entry, one stamp. The former "Stamp settings" entry here pointed
+          // at the per-officer teeter (ማህተም), not a company seal — it moved to
+          // /user-management/teeter-and-signature.
+          label: "Company stamp",
+          href: "/dashboard/stamp-settings",
+          icon: <Stamp />,
+          permission: FREIGHT_PERMS.settings.stamp.view,
+        },
+        {
+          label: "Company logo",
+          href: "/dashboard/logo-settings",
+          icon: <ImageIcon />,
+          permission: FREIGHT_PERMS.settings.logo.view,
+        },
+        {
+          label: "Contract templates",
+          href: "/dashboard/contract-templates",
+          icon: <ScrollText />,
+          // `view` opens the page; `read` alone is API-only and shows no menu.
+          permission: FREIGHT_PERMS.settings.contractTemplates.view,
+        },
+        {
+          label: "Portal content",
+          href: "/dashboard/portal-content",
+          icon: <BookOpen />,
+          permission: [
+            FREIGHT_PERMS.settings.supportContent.view,
+            FREIGHT_PERMS.settings.supportContent.manage,
+          ],
+        },
+        {
+          label: "Audit logs",
+          href: "/dashboard/audit-logs",
+          icon: <History />,
+          permission: FREIGHT_PERMS.auditLog.view,
+        },
+        {
+          label: "Configuration",
+          href: "/dashboard/configuration",
+          icon: <Boxes />,
+          children: [
+            ...getCategorySidebarChildren("configuration"),
+            {
+              label: "Train scheduling rules",
+              href: "/dashboard/configuration/train-scheduling-rules",
+              permission: FREIGHT_PERMS.trainScheduling.rulesManage,
+            },
+            {
+              label: "Trade access",
+              href: "/dashboard/configuration/trade-access",
+              permission: FREIGHT_PERMS.tradeAccess.view,
+            },
+            {
+              label: "Exchange rate",
+              href: "/dashboard/configuration/exchange-rate",
+              permission: FREIGHT_PERMS.settings.exchangeRate.view,
+            },
+            {
+              label: "Manual payments",
+              href: "/dashboard/configuration/manual-payments",
+              permission: FREIGHT_PERMS.settings.manualPayment.view,
+            },
+          ],
+        },
+        {
+          label: "Rules",
+          href: "/dashboard/rules",
+          icon: <SlidersHorizontal />,
+          children: getCategorySidebarChildren("rules"),
+        },
 
-/** Hrefs of the two document-clearance menu items (stable identifiers). */
-export const ET_CLEARANCE_HREF = "/dashboard/contracts/clearance";
-export const DJ_CLEARANCE_HREF = "/dashboard/gl-djibouti/clearance";
-
-// Routes a GL officer may reach beyond their clearance hub. Path B booking is
-// part of their job (create/rebook under a cleared contract, then view that
-// booking's clearance), but those routes live outside the clearance prefix —
-// without this allowlist the single-prefix lock bounces them out of their own
-// workflow. Matched against location.pathname (no query string).
-export const GL_WORKFLOW_PATH_PATTERNS: RegExp[] = [
-  /^\/dashboard\/contracts\/[^/]+\/create-booking(\/|$)/,
-  /^\/dashboard\/bookings\/[^/]+\/clearance(\/|$)/,
-  // The ET hub's rows open the shipment clearance detail at this URL.
-  /^\/dashboard\/clearance\/[^/]+(\/|$)/,
-];
-
-const isEtClearanceItem = (item: SidebarItem): boolean =>
-  item.href === ET_CLEARANCE_HREF;
-const isDjClearanceItem = (item: SidebarItem): boolean =>
-  item.href === DJ_CLEARANCE_HREF;
-const isClearanceItem = (item: SidebarItem): boolean =>
-  isEtClearanceItem(item) || isDjClearanceItem(item);
+        {
+          label: "Staff",
+          href: "/user-management",
+          icon: <Users />,
+          permission: [
+            FREIGHT_PERMS.admin,
+            FREIGHT_PERMS.staff.roles.view,
+            FREIGHT_PERMS.staff.employeeRegistration.view,
+            FREIGHT_PERMS.staff.roleAssignment.view,
+          ],
+        },
+      ],
+    },
+  ];
 
 /**
  * Keep only items the user is permitted to see; drop now-empty sections.
- *
- * Position-scoped visibility (super_admin sees everything):
- * - Super Admin → sees all items (all permissions pass, all tabs visible)
- * - Ethiopian GL  → sees ONLY the ET document-clearance page.
- * - Djibouti GL   → sees ONLY the DJ clearance page.
- * - Everyone else → sees everything they have permission for, EXCEPT the two
- *   clearance pages (those are GL-only).
+ * Super Admin sees everything; everyone else is filtered purely by each
+ * item's `permission` field (OR across the array when one is given).
  */
 export const filterSidebarByPermission = (
   sections: SidebarSection[],
@@ -581,9 +612,6 @@ export const filterSidebarByPermission = (
   // Superadmin sees every section and item — no permission filtering.
   if (isSuperAdmin(user)) return sections;
 
-  const etGl = isEthiopianGl(user);
-  const djGl = isDjiboutiGl(user);
-
   const permissionAllowed = (item: SidebarItem): boolean => {
     if (!item.permission) return true;
     const keys = Array.isArray(item.permission)
@@ -603,14 +631,6 @@ export const filterSidebarByPermission = (
           : item,
       )
       .filter((item) => {
-        if (etGl || djGl) {
-          // GL positions are locked to their single clearance page (parents
-          // survive only as the path to that page).
-          const isTarget = etGl ? isEtClearanceItem : isDjClearanceItem;
-          return isTarget(item) || (item.children?.length ?? 0) > 0;
-        }
-        // Everyone else: hide the GL-only clearance pages entirely.
-        if (isClearanceItem(item)) return false;
         if (!permissionAllowed(item)) return false;
         if (item.children) return item.children.length > 0;
         return true;
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/OverviewKpiSection.tsx b/apps/edr-freight-web/backoffice/src/components/overview/OverviewKpiSection.tsx
deleted file mode 100644
index ea99d098e..000000000
--- a/apps/edr-freight-web/backoffice/src/components/overview/OverviewKpiSection.tsx
+++ /dev/null
@@ -1,167 +0,0 @@
-import {
-  AlertCircle,
-  Banknote,
-  Box,
-  Clock,
-  Container,
-  CreditCard,
-  FileText,
-  Train,
-  Truck,
-  UserCheck,
-  Users,
-  Wallet,
-} from "lucide-react";
-import { Group, Paper, Stack, Text } from "@mantine/core";
-
-import type { IOverviewKpis } from "@/types/overview";
-import { OverviewKpiCard } from "./OverviewKpiCard";
-
-function formatCurrency(amount: number, currency: "ETB" | "USD") {
-  return new Intl.NumberFormat("en-US", {
-    style: "currency",
-    currency,
-    maximumFractionDigits: 0,
-  }).format(amount);
-}
-
-export function OverviewKpiSection({ kpis }: { kpis: IOverviewKpis }) {
-  const bookingItems = [
-    {
-      label: "Active bookings",
-      value: kpis.bookings.totalActive,
-      icon: FileText,
-      accent: "emerald" as const,
-    },
-    {
-      label: "Needs action",
-      value: kpis.bookings.needsAction,
-      icon: AlertCircle,
-      accent: "amber" as const,
-    },
-    {
-      label: "Urgent",
-      value: kpis.bookings.urgent,
-      icon: Clock,
-      accent: "rose" as const,
-    },
-    {
-      label: "In approval",
-      value: kpis.bookings.inApproval,
-      icon: UserCheck,
-      accent: "sky" as const,
-    },
-    {
-      label: "Submitted today",
-      value: kpis.bookings.submittedToday,
-      icon: FileText,
-    },
-  ];
-
-  const operationsItems = [
-    {
-      label: "Active trains",
-      value: kpis.operations.trainsActive,
-      icon: Train,
-      accent: "emerald" as const,
-    },
-    {
-      label: "Wagons available",
-      value: kpis.operations.wagonsAvailable,
-      icon: Truck,
-    },
-    {
-      label: "Containers in transit",
-      value: kpis.operations.containersInTransit,
-      icon: Container,
-    },
-    {
-      label: "Cargoes loaded",
-      value: kpis.operations.cargoesLoaded,
-      icon: Box,
-    },
-  ];
-
-  const billingItems = [
-    {
-      label: "Revenue MTD (ETB)",
-      value: formatCurrency(kpis.billing.revenueMtdEtb, "ETB"),
-      icon: Banknote,
-      accent: "emerald" as const,
-    },
-    {
-      label: "Revenue MTD (USD)",
-      value: formatCurrency(kpis.billing.revenueMtdUsd, "USD"),
-      icon: Wallet,
-    },
-    {
-      label: "Pending payments",
-      value: kpis.billing.pendingPayments,
-      icon: CreditCard,
-      accent: "amber" as const,
-    },
-    {
-      label: "Successful MTD",
-      value: kpis.billing.successfulPaymentsMtd,
-      icon: Banknote,
-    },
-  ];
-
-  const peopleItems = [
-    {
-      label: "Total customers",
-      value: kpis.customers.totalCustomers,
-      icon: Users,
-    },
-    {
-      label: "New this month",
-      value: kpis.customers.newCustomersThisMonth,
-      icon: Users,
-      accent: "emerald" as const,
-    },
-    {
-      label: "Active employees",
-      value: kpis.staff.activeEmployees,
-      icon: UserCheck,
-    },
-    {
-      label: "Active users",
-      value: kpis.staff.activeUsers,
-      icon: Users,
-    },
-  ];
-
-  const sections = [
-    { title: "Bookings", items: bookingItems },
-    { title: "Operations", items: operationsItems },
-    { title: "Billing", items: billingItems },
-    { title: "Customers & staff", items: peopleItems },
-  ];
-
-  return (
-    <Stack gap="md">
-      {sections.map((section) => (
-        <Paper
-          key={section.title}
-          p="md"
-          radius="lg"
-          withBorder
-          style={{
-            background: "white",
-            border: "1px solid var(--mantine-color-gray-2)",
-            overflowX: "auto",
-          }}
-        >
-          <Text size="sm" fw={600} mb="sm" c="dimmed">
-            {section.title}
-          </Text>
-          <Group gap="md" style={{ flexWrap: "nowrap", minWidth: "min-content" }}>
-            {section.items.map((item) => (
-              <OverviewKpiCard key={item.label} item={item} />
-            ))}
-          </Group>
-        </Paper>
-      ))}
-    </Stack>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/OverviewPageHeader.tsx b/apps/edr-freight-web/backoffice/src/components/overview/OverviewPageHeader.tsx
deleted file mode 100644
index 529981add..000000000
--- a/apps/edr-freight-web/backoffice/src/components/overview/OverviewPageHeader.tsx
+++ /dev/null
@@ -1,66 +0,0 @@
-import { ActionIcon, Group, SegmentedControl, Text } from "@mantine/core";
-import { RefreshCw } from "lucide-react";
-
-import type { OverviewRange } from "@/types/overview";
-
-const RANGE_OPTIONS = [
-  { label: "7 days", value: "7d" },
-  { label: "30 days", value: "30d" },
-  { label: "90 days", value: "90d" },
-];
-
-function formatRelativeTime(iso: string | undefined) {
-  if (!iso) return "—";
-  const diffMs = Date.now() - new Date(iso).getTime();
-  const minutes = Math.floor(diffMs / 60_000);
-  if (minutes < 1) return "just now";
-  if (minutes < 60) return `${minutes}m ago`;
-  const hours = Math.floor(minutes / 60);
-  if (hours < 24) return `${hours}h ago`;
-  return new Date(iso).toLocaleString();
-}
-
-interface OverviewPageHeaderProps {
-  range: OverviewRange;
-  onRangeChange: (range: OverviewRange) => void;
-  generatedAt?: string;
-  onRefresh: () => void;
-  isRefreshing?: boolean;
-}
-
-export function OverviewPageHeader({
-  range,
-  onRangeChange,
-  generatedAt,
-  onRefresh,
-  isRefreshing,
-}: OverviewPageHeaderProps) {
-  return (
-    <Group justify="space-between" align="center" wrap="wrap" gap="md">
-      <Text size="sm" c="dimmed">
-        Updated {formatRelativeTime(generatedAt)}
-      </Text>
-      <Group gap="sm">
-        <SegmentedControl
-          value={range}
-          onChange={(value) => onRangeChange(value as OverviewRange)}
-          data={RANGE_OPTIONS}
-          size="sm"
-          radius="lg"
-          color="edr-green"
-        />
-        <ActionIcon
-          variant="light"
-          color="edr-green"
-          size="lg"
-          radius="lg"
-          aria-label="Refresh dashboard"
-          onClick={onRefresh}
-          loading={isRefreshing}
-        >
-          <RefreshCw size={18} />
-        </ActionIcon>
-      </Group>
-    </Group>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/OverviewRecentBookingsTable.tsx b/apps/edr-freight-web/backoffice/src/components/overview/OverviewRecentBookingsTable.tsx
index b13f5c473..e1ceaec1c 100644
--- a/apps/edr-freight-web/backoffice/src/components/overview/OverviewRecentBookingsTable.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/overview/OverviewRecentBookingsTable.tsx
@@ -1,9 +1,11 @@
-import { useNavigate } from "react-router-dom";
-import { Paper, Stack, Table, Text } from "@mantine/core";
+import { History } from "lucide-react";
+import { Link, useNavigate } from "react-router-dom";
+import { Table, Text } from "@mantine/core";
 
 import { BookingPriorityBadge } from "@/components/bookings/BookingPriorityBadge";
 import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
 import type { IOverviewRecentBooking } from "@/types/overview";
+import { SummaryCard } from "./summary/SummaryCard";
 
 function formatAmount(amount: number | null, currency: string | null) {
   if (amount == null) return "—";
@@ -23,56 +25,90 @@ export function OverviewRecentBookingsTable({
   const navigate = useNavigate();
 
   return (
-    <Paper p="lg" radius="lg" withBorder>
-      <Stack gap="md">
-        <Text fw={600}>Recent bookings</Text>
-        {bookings.length === 0 ? (
-          <Text size="sm" c="dimmed" ta="center" py="lg">
-            No recent bookings
-          </Text>
-        ) : (
-          <Table highlightOnHover verticalSpacing="sm">
-            <Table.Thead>
-              <Table.Tr>
-                <Table.Th>Reference</Table.Th>
-                <Table.Th>Customer</Table.Th>
-                <Table.Th>Status</Table.Th>
-                <Table.Th>Priority</Table.Th>
-                <Table.Th>Amount</Table.Th>
-                <Table.Th>Created</Table.Th>
-              </Table.Tr>
-            </Table.Thead>
-            <Table.Tbody>
-              {bookings.map((booking) => (
-                <Table.Tr
-                  key={booking.id}
-                  style={{ cursor: "pointer" }}
-                  onClick={() => navigate(`/dashboard/booking-requests/${booking.id}`)}
-                >
-                  <Table.Td>
-                    <Text fw={600} size="sm">
-                      {booking.reference}
-                    </Text>
-                  </Table.Td>
-                  <Table.Td>{booking.customerLabel}</Table.Td>
-                  <Table.Td>
-                    <BookingStatusBadge status={booking.status} />
-                  </Table.Td>
-                  <Table.Td>
-                    <BookingPriorityBadge score={booking.priorityScore} />
-                  </Table.Td>
-                  <Table.Td>
+    <SummaryCard
+      icon={History}
+      accent="gray"
+      title="Recent bookings"
+      subtitle="Latest submissions, newest first"
+      minHeight={260}
+      action={
+        <Text
+          component={Link}
+          to="/dashboard/booking-requests"
+          size="xs"
+          fw={600}
+          c="edr-green"
+          style={{ whiteSpace: "nowrap", textDecoration: "none" }}
+        >
+          View all →
+        </Text>
+      }
+    >
+      {bookings.length === 0 ? (
+        <Text size="sm" c="dimmed" ta="center" py="lg">
+          No recent bookings
+        </Text>
+      ) : (
+        <Table highlightOnHover verticalSpacing="sm" horizontalSpacing="sm">
+          <Table.Thead>
+            <Table.Tr>
+              {["Reference", "Customer", "Status", "Priority", "Amount", "Created"].map(
+                (header) => (
+                  <Table.Th
+                    key={header}
+                    style={{
+                      fontSize: 11,
+                      fontWeight: 700,
+                      textTransform: "uppercase",
+                      letterSpacing: 0.3,
+                      color: "var(--mantine-color-edr-muted-6)",
+                      borderBottom: "1px solid var(--mantine-color-gray-2)",
+                    }}
+                  >
+                    {header}
+                  </Table.Th>
+                ),
+              )}
+            </Table.Tr>
+          </Table.Thead>
+          <Table.Tbody>
+            {bookings.map((booking) => (
+              <Table.Tr
+                key={booking.id}
+                style={{ cursor: "pointer" }}
+                onClick={() => navigate(`/dashboard/booking-requests/${booking.id}`)}
+              >
+                <Table.Td>
+                  <Text fw={600} size="sm">
+                    {booking.reference}
+                  </Text>
+                </Table.Td>
+                <Table.Td>
+                  <Text size="sm" truncate style={{ maxWidth: 180 }}>
+                    {booking.customerLabel}
+                  </Text>
+                </Table.Td>
+                <Table.Td>
+                  <BookingStatusBadge status={booking.status} />
+                </Table.Td>
+                <Table.Td>
+                  <BookingPriorityBadge score={booking.priorityScore} />
+                </Table.Td>
+                <Table.Td>
+                  <Text size="sm" style={{ fontVariantNumeric: "tabular-nums" }}>
                     {formatAmount(booking.totalAmount, booking.paymentCurrency)}
-                  </Table.Td>
-                  <Table.Td>
+                  </Text>
+                </Table.Td>
+                <Table.Td>
+                  <Text size="sm" c="dimmed">
                     {new Date(booking.createdAt).toLocaleDateString()}
-                  </Table.Td>
-                </Table.Tr>
-              ))}
-            </Table.Tbody>
-          </Table>
-        )}
-      </Stack>
-    </Paper>
+                  </Text>
+                </Table.Td>
+              </Table.Tr>
+            ))}
+          </Table.Tbody>
+        </Table>
+      )}
+    </SummaryCard>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/OverviewTabContent.tsx b/apps/edr-freight-web/backoffice/src/components/overview/OverviewTabContent.tsx
deleted file mode 100644
index cf71198a6..000000000
--- a/apps/edr-freight-web/backoffice/src/components/overview/OverviewTabContent.tsx
+++ /dev/null
@@ -1,119 +0,0 @@
-import { AlertCircle } from "lucide-react";
-import { Alert, Button, Center, Loader, Paper, Skeleton, Stack } from "@mantine/core";
-
-import {
-  useOverviewBillingTab,
-  useOverviewBookingsTab,
-  useOverviewContractsTab,
-  useOverviewCustomersTab,
-  useOverviewOperationsTab,
-  useOverviewStaffTab,
-} from "@/hooks/useOverview";
-import type { OverviewRange, OverviewTabKey } from "@/types/overview";
-import { OverviewBillingTabPanel } from "./tabs/OverviewBillingTabPanel";
-import { OverviewBookingsTabPanel } from "./tabs/OverviewBookingsTabPanel";
-import { OverviewContractsTabPanel } from "./tabs/OverviewContractsTabPanel";
-import { OverviewCustomersTabPanel } from "./tabs/OverviewCustomersTabPanel";
-import { OverviewFleetTabPanel } from "./tabs/OverviewFleetTabPanel";
-import { OverviewOperationsTabPanel } from "./tabs/OverviewOperationsTabPanel";
-import { OverviewStaffTabPanel } from "./tabs/OverviewStaffTabPanel";
-
-function TabSkeleton() {
-  return (
-    <Stack gap="lg">
-      <Skeleton height={120} radius="lg" />
-      <Skeleton height={320} radius="lg" />
-      <Skeleton height={320} radius="lg" />
-    </Stack>
-  );
-}
-
-interface OverviewTabContentProps {
-  tab: OverviewTabKey;
-  range: OverviewRange;
-}
-
-export function OverviewTabContent({ tab, range }: OverviewTabContentProps) {
-  const bookings = useOverviewBookingsTab(range, tab === "bookings");
-  const contracts = useOverviewContractsTab(range, tab === "contracts");
-  const billing = useOverviewBillingTab(range, tab === "billing");
-  // Fleet reuses the operations dataset — same query key, so switching between
-  // the two tabs costs one fetch.
-  const operations = useOverviewOperationsTab(
-    range,
-    tab === "operations" || tab === "fleet",
-  );
-  const customers = useOverviewCustomersTab(range, tab === "customers");
-  const staff = useOverviewStaffTab(range, tab === "staff");
-
-  const query =
-    tab === "bookings"
-      ? bookings
-      : tab === "contracts"
-        ? contracts
-        : tab === "billing"
-          ? billing
-          : tab === "operations" || tab === "fleet"
-            ? operations
-            : tab === "customers"
-              ? customers
-              : staff;
-
-  const { isLoading, isError, refetch, isFetching } = query;
-
-  if (isLoading) {
-    return <TabSkeleton />;
-  }
-
-  if (isError || !query.data) {
-    return (
-      <Paper p="xl" radius="lg" withBorder>
-        <Alert
-          icon={<AlertCircle size={16} />}
-          color="red"
-          title="Failed to load tab data"
-          variant="light"
-        >
-          <Stack gap="sm" align="flex-start">
-            <span>Could not load {tab} metrics. Please try again.</span>
-            <Button size="xs" variant="light" color="red" onClick={() => void refetch()}>
-              Retry
-            </Button>
-          </Stack>
-        </Alert>
-      </Paper>
-    );
-  }
-
-  return (
-    <Stack gap="md" pos="relative">
-      {isFetching && (
-        <Center style={{ position: "absolute", top: 8, right: 8, zIndex: 2 }}>
-          <Loader size="sm" color="edr-green" />
-        </Center>
-      )}
-
-      {tab === "bookings" && bookings.data && (
-        <OverviewBookingsTabPanel data={bookings.data} />
-      )}
-      {tab === "contracts" && contracts.data && (
-        <OverviewContractsTabPanel data={contracts.data} />
-      )}
-      {tab === "billing" && billing.data && (
-        <OverviewBillingTabPanel data={billing.data} />
-      )}
-      {tab === "operations" && operations.data && (
-        <OverviewOperationsTabPanel data={operations.data} />
-      )}
-      {tab === "fleet" && operations.data && (
-        <OverviewFleetTabPanel data={operations.data} />
-      )}
-      {tab === "customers" && customers.data && (
-        <OverviewCustomersTabPanel data={customers.data} />
-      )}
-      {tab === "staff" && staff.data && (
-        <OverviewStaffTabPanel data={staff.data} />
-      )}
-    </Stack>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/ClearanceOverview.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/ClearanceOverview.tsx
new file mode 100644
index 000000000..1484cb5e9
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/ClearanceOverview.tsx
@@ -0,0 +1,154 @@
+import { Grid, Stack } from "@mantine/core";
+
+import { OverviewDonutChart } from "@/components/overview/OverviewDonutChart";
+import { OverviewHorizontalBarChart } from "@/components/overview/OverviewHorizontalBarChart";
+import { OverviewStackedBarChart } from "@/components/overview/OverviewStackedBarChart";
+import { OverviewAttentionCard } from "@/components/overview/summary/OverviewAttentionCard";
+import { OverviewPipelineFunnel } from "@/components/overview/summary/OverviewPipelineFunnel";
+import {
+  useOverviewClearanceTab,
+  useOverviewOperationsTab,
+} from "@/hooks/useOverview";
+import {
+  AsyncBand,
+  Band,
+  DIRECTION_SERIES,
+  formatDayLabel,
+  labelsToDonut,
+  pivotMatrix,
+  toDonut,
+  type RoleOverviewProps,
+} from "./layout-kit";
+
+/**
+ * The GL desks (Ethiopia / Djibouti) work cargo through clearance: containers
+ * and cargo state first, the trains carrying them second, and the bookings
+ * waiting on a human third. Clearance-document counts are not aggregated by
+ * the overview API yet, so this stops at cargo state.
+ */
+export function ClearanceOverview({ data, range }: RoleOverviewProps) {
+  const ops = useOverviewOperationsTab(range, true);
+  const clearance = useOverviewClearanceTab(true);
+  const handovers = pivotMatrix(clearance.data?.handoversByMile);
+
+  return (
+    <Stack gap="xl" mt="xl">
+      {/* Work queue first: it is what a GL desk acts on, and it is the band
+          that always has rows even when no cargo is in the yard. */}
+      <Band index={1} title="Waiting on someone">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 5 }}>
+            <OverviewAttentionCard
+              bookings={data.kpis.bookings}
+              contracts={data.kpis.contracts}
+              billing={data.kpis.billing}
+            />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 7 }}>
+            <OverviewPipelineFunnel data={data.bookingsByPipeline} />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      <AsyncBand index={2} title="Documents & invoices" query={clearance}>
+        {(tab) => (
+          <Grid gap="md">
+            {/* Donuts stay at lg 4 — their legends ellipsise below ~300px. */}
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Booking documents"
+                data={toDonut(tab.bookingDocumentsByStatus)}
+                emptyMessage="No documents uploaded"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Contract documents"
+                data={toDonut(tab.contractDocumentsByStatus)}
+                emptyMessage="No documents uploaded"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Invoices by status"
+                data={toDonut(tab.invoicesByStatus)}
+                emptyMessage="No invoices raised"
+              />
+            </Grid.Col>
+            <Grid.Col span={12}>
+              <OverviewStackedBarChart
+                title="Handover papers"
+                data={handovers.rows}
+                series={handovers.series}
+                xKey="group"
+                emptyMessage="No handovers generated"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+      <AsyncBand index={3} title="Cargo & containers" query={ops}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, md: 4 }}>
+              <OverviewDonutChart
+                title="Container status"
+                data={toDonut(tab.containerStatusBreakdown)}
+                emptyMessage="No containers tracked"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, md: 4 }}>
+              <OverviewDonutChart
+                title="Containers by size"
+                data={labelsToDonut(tab.containersBySize)}
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, md: 4 }}>
+              <OverviewDonutChart
+                title="Cargo status"
+                data={toDonut(tab.cargoStatusBreakdown)}
+                emptyMessage="No cargo recorded"
+              />
+            </Grid.Col>
+            <Grid.Col span={12}>
+              <OverviewHorizontalBarChart
+                title="Cargo tonnage by type"
+                data={(tab.cargoTonnageByType ?? []).map((item) => ({
+                  label: item.label,
+                  value: item.tons,
+                }))}
+                valueLabel="Tons"
+                emptyMessage="No cargo recorded"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+      <AsyncBand index={4} title="Train movement" query={ops}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, lg: 8 }}>
+              <OverviewStackedBarChart
+                title="Train departures by direction"
+                data={tab.departureTrend ?? []}
+                series={DIRECTION_SERIES}
+                formatXLabel={formatDayLabel}
+                emptyMessage="No scheduled departures in this period"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Schedule status"
+                data={toDonut(tab.scheduleStatusBreakdown)}
+                emptyMessage="No train schedules yet"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/ExecutiveOverview.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/ExecutiveOverview.tsx
new file mode 100644
index 000000000..6b6e12fa2
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/ExecutiveOverview.tsx
@@ -0,0 +1,76 @@
+import { Grid, Stack } from "@mantine/core";
+
+import { OverviewActivityHeatmap } from "@/components/overview/summary/OverviewActivityHeatmap";
+import { OverviewAttentionCard } from "@/components/overview/summary/OverviewAttentionCard";
+import { OverviewNetworkCard } from "@/components/overview/summary/OverviewNetworkCard";
+import { OverviewPipelineFunnel } from "@/components/overview/summary/OverviewPipelineFunnel";
+import { OverviewRevenueMix } from "@/components/overview/summary/OverviewRevenueMix";
+import { OverviewRevenueVolumeChart } from "@/components/overview/summary/OverviewRevenueVolumeChart";
+import { OverviewSankeyFlow } from "@/components/overview/summary/OverviewSankeyFlow";
+import { Band, type RoleOverviewProps } from "./layout-kit";
+
+const RANGE_DAYS: Record<string, number> = { "7d": 7, "30d": 30, "90d": 90 };
+
+/**
+ * The default layout — money, attention, network, pipeline. Kept for the CEO,
+ * director and org-manager roles, and for anyone whose role has no dedicated
+ * dashboard (superadmin, IAM admins).
+ */
+export function ExecutiveOverview({ data, range }: RoleOverviewProps) {
+  return (
+    <Stack gap="xl" mt="xl">
+      {/* Band 1 — revenue & volume: growing, making money, pacing vs last period. */}
+      <Band index={1} title="Revenue & volume">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 8 }}>
+            <OverviewRevenueVolumeChart
+              bookingTrend={data.bookingTrend}
+              paymentTrend={data.paymentTrend}
+              previousPaymentTrend={data.previousPaymentTrend}
+              rangeDays={RANGE_DAYS[range] ?? 30}
+            />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 4 }}>
+            <OverviewRevenueMix
+              byDirection={data.revenueByDirection}
+              byFreightType={data.revenueByFreightType}
+            />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      {/* Band 2 — where the money runs, and what's waiting on someone. */}
+      <Band index={2} title="Money flow & attention">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 7 }}>
+            <OverviewSankeyFlow flows={data.revenueFlows} />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 5 }}>
+            <OverviewAttentionCard
+              bookings={data.kpis.bookings}
+              contracts={data.kpis.contracts}
+              billing={data.kpis.billing}
+            />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      {/* Band 3 — the network now, and when demand arrives. */}
+      <Band index={3} title="Network & rhythm">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 5 }}>
+            <OverviewNetworkCard kpis={data.kpis.operations} />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 7 }}>
+            <OverviewActivityHeatmap cells={data.bookingHeatmap} />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      {/* Band 4 — the booking pipeline, full width so every stage bar has room. */}
+      <Band index={4} title="Pipeline">
+        <OverviewPipelineFunnel data={data.bookingsByPipeline} />
+      </Band>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/FinanceOverview.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/FinanceOverview.tsx
new file mode 100644
index 000000000..78205d29b
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/FinanceOverview.tsx
@@ -0,0 +1,58 @@
+import { Grid, Stack } from "@mantine/core";
+
+import { OverviewBillingTabPanel } from "@/components/overview/tabs/OverviewBillingTabPanel";
+import { OverviewAttentionCard } from "@/components/overview/summary/OverviewAttentionCard";
+import { OverviewRevenueMix } from "@/components/overview/summary/OverviewRevenueMix";
+import { OverviewRevenueVolumeChart } from "@/components/overview/summary/OverviewRevenueVolumeChart";
+import { OverviewSankeyFlow } from "@/components/overview/summary/OverviewSankeyFlow";
+import { useOverviewBillingTab } from "@/hooks/useOverview";
+import { AsyncBand, Band, type RoleOverviewProps } from "./layout-kit";
+
+const RANGE_DAYS: Record<string, number> = { "7d": 7, "30d": 30, "90d": 90 };
+
+/** Money only: what was earned, how it was collected, and what is still owed. */
+export function FinanceOverview({ data, range }: RoleOverviewProps) {
+  const billing = useOverviewBillingTab(range, true);
+
+  return (
+    <Stack gap="xl" mt="xl">
+      <Band index={1} title="Revenue & volume">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 8 }}>
+            <OverviewRevenueVolumeChart
+              bookingTrend={data.bookingTrend}
+              paymentTrend={data.paymentTrend}
+              previousPaymentTrend={data.previousPaymentTrend}
+              rangeDays={RANGE_DAYS[range] ?? 30}
+            />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 4 }}>
+            <OverviewRevenueMix
+              byDirection={data.revenueByDirection}
+              byFreightType={data.revenueByFreightType}
+            />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      <AsyncBand index={2} title="Payments" query={billing}>
+        {(tab) => <OverviewBillingTabPanel data={tab} />}
+      </AsyncBand>
+
+      <Band index={3} title="Money flow & attention">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 7 }}>
+            <OverviewSankeyFlow flows={data.revenueFlows} />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 5 }}>
+            <OverviewAttentionCard
+              bookings={data.kpis.bookings}
+              contracts={data.kpis.contracts}
+              billing={data.kpis.billing}
+            />
+          </Grid.Col>
+        </Grid>
+      </Band>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/MarketingOverview.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/MarketingOverview.tsx
new file mode 100644
index 000000000..892f351e6
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/MarketingOverview.tsx
@@ -0,0 +1,154 @@
+import { Grid, Stack } from "@mantine/core";
+
+import { OverviewDonutChart } from "@/components/overview/OverviewDonutChart";
+import { OverviewHorizontalBarChart } from "@/components/overview/OverviewHorizontalBarChart";
+import { OverviewStackedBarChart } from "@/components/overview/OverviewStackedBarChart";
+import { OverviewCustomersTabPanel } from "@/components/overview/tabs/OverviewCustomersTabPanel";
+import { OverviewPipelineFunnel } from "@/components/overview/summary/OverviewPipelineFunnel";
+import { OverviewRevenueMix } from "@/components/overview/summary/OverviewRevenueMix";
+import {
+  useOverviewClearanceTab,
+  useOverviewContractsTab,
+  useOverviewCustomersTab,
+  useOverviewOperationsTab,
+} from "@/hooks/useOverview";
+import { humanize } from "@/lib/format";
+import {
+  AsyncBand,
+  Band,
+  DIRECTION_SERIES,
+  enumLabelsToBars,
+  enumLabelsToDonut,
+  formatDayLabel,
+  pivotMatrix,
+  toDonut,
+  type RoleOverviewProps,
+} from "./layout-kit";
+
+/**
+ * Customer-facing view: who is buying, what they booked, what they signed and
+ * what it earned. Customs-declaration document counts and the Djibouti invoice
+ * queue are part of the marketing brief but have no overview aggregation yet.
+ */
+export function MarketingOverview({ data, range }: RoleOverviewProps) {
+  const customers = useOverviewCustomersTab(range, true);
+  const contracts = useOverviewContractsTab(range, true);
+  const ops = useOverviewOperationsTab(range, true);
+  const clearance = useOverviewClearanceTab(true);
+  const profilesByType = pivotMatrix(customers.data?.profilesByTypeStatus);
+
+  return (
+    <Stack gap="xl" mt="xl">
+      <AsyncBand index={1} title="Customers" query={customers}>
+        {(tab) => (
+          <Stack gap="md">
+            <OverviewCustomersTabPanel data={tab} />
+            {/* Statuses live on the profile, not the company — so active vs
+                pending vs suspended is only meaningful per trade role. */}
+            <OverviewStackedBarChart
+              title="Profiles by trade role and status"
+              data={profilesByType.rows}
+              series={profilesByType.series}
+              xKey="group"
+              formatXLabel={humanize}
+              emptyMessage="No customer profiles yet"
+            />
+          </Stack>
+        )}
+      </AsyncBand>
+
+      <Band index={2} title="Booking demand">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 7 }}>
+            <OverviewPipelineFunnel data={data.bookingsByPipeline} />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 5 }}>
+            <OverviewDonutChart
+              title="Bookings by status"
+              data={toDonut(data.bookingsByStatus)}
+              emptyMessage="No bookings yet"
+            />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      <AsyncBand index={3} title="Contracts" query={contracts}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Contracts by status"
+                data={toDonut(tab.contractsByStatus)}
+                emptyMessage="No contracts yet"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Contracts by kind"
+                data={enumLabelsToDonut(tab.contractsByKind)}
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewHorizontalBarChart
+                title="Contracts by freight type"
+                data={enumLabelsToBars(tab.contractsByFreightType)}
+                valueLabel="Contracts"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+      <AsyncBand index={4} title="Documents & invoicing" query={clearance}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, md: 4 }}>
+              <OverviewDonutChart
+                title="Customs documents"
+                data={toDonut(tab.bookingDocumentsByStatus)}
+                emptyMessage="No documents uploaded"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, md: 4 }}>
+              <OverviewDonutChart
+                title="Invoices by status"
+                data={toDonut(tab.invoicesByStatus)}
+                emptyMessage="No invoices raised"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, md: 4 }}>
+              <OverviewHorizontalBarChart
+                title="Invoices by type"
+                data={enumLabelsToBars(tab.invoicesByType)}
+                valueLabel="Invoices"
+                emptyMessage="No invoices raised"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+      <Band index={5} title="Revenue & movement">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 4 }}>
+            <OverviewRevenueMix
+              byDirection={data.revenueByDirection}
+              byFreightType={data.revenueByFreightType}
+            />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 8 }}>
+            {ops.data ? (
+              <OverviewStackedBarChart
+                title="Train departures by direction"
+                data={ops.data.departureTrend ?? []}
+                series={DIRECTION_SERIES}
+                formatXLabel={formatDayLabel}
+                emptyMessage="No scheduled departures in this period"
+              />
+            ) : null}
+          </Grid.Col>
+        </Grid>
+      </Band>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/OccOverview.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/OccOverview.tsx
new file mode 100644
index 000000000..f30468c48
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/OccOverview.tsx
@@ -0,0 +1,181 @@
+import { CalendarClock, Send, Timer, Train, Truck } from "lucide-react";
+import { Grid, Stack } from "@mantine/core";
+
+import { OverviewDonutChart } from "@/components/overview/OverviewDonutChart";
+import { OverviewHorizontalBarChart } from "@/components/overview/OverviewHorizontalBarChart";
+import { OverviewKpiStrip } from "@/components/overview/OverviewKpiStrip";
+import { OverviewStackedBarChart } from "@/components/overview/OverviewStackedBarChart";
+import { useOverviewFleetTab, useOverviewOperationsTab } from "@/hooks/useOverview";
+import {
+  AsyncBand,
+  DIRECTION_SERIES,
+  formatDayLabel,
+  labelsToBars,
+  pivotMatrix,
+  sumCounts,
+  toDonut,
+  type RoleOverviewProps,
+} from "./layout-kit";
+
+/**
+ * Operation control centre view: what rolling stock sits where, and what is
+ * moving today. Locomotive availability per station and train turn-around are
+ * part of the OCC brief but have no overview aggregation yet — they are absent
+ * rather than approximated.
+ */
+export function OccOverview({ range }: RoleOverviewProps) {
+  const ops = useOverviewOperationsTab(range, true);
+  const fleet = useOverviewFleetTab(range, true);
+  const wagonsByYard = pivotMatrix(fleet.data?.wagonStatusByYard);
+  const locomotivesByYard = pivotMatrix(fleet.data?.locomotivesByYard);
+
+  return (
+    <Stack gap="xl" mt="xl">
+      <AsyncBand index={1} title="Network right now" query={ops}>
+        {(tab) => (
+          <Stack gap="md">
+            <OverviewKpiStrip
+              items={[
+                {
+                  label: "Active trains",
+                  value: tab.kpis?.trainsActive ?? 0,
+                  icon: Train,
+                  accent: "emerald",
+                },
+                {
+                  label: "Departures due",
+                  value: tab.kpis?.schedulesUpcoming ?? 0,
+                  icon: CalendarClock,
+                  accent: "sky",
+                },
+                {
+                  label: "Dispatched today",
+                  value: tab.kpis?.dispatchedToday ?? 0,
+                  icon: Send,
+                  accent: "amber",
+                },
+                // Labels stay short: five cells share ~1100px at 1440 wide,
+                // and a hint pushes the last two into truncation.
+                {
+                  label: "Wagons free",
+                  value: tab.kpis?.wagonsAvailable ?? 0,
+                  icon: Truck,
+                },
+                {
+                  label: "Turnaround",
+                  value:
+                    fleet.data?.avgTurnaroundHours != null
+                      ? `${fleet.data.avgTurnaroundHours}h`
+                      : "—",
+                  icon: Timer,
+                  accent: "violet",
+                },
+              ]}
+            />
+            {/* Yard and type are long-tailed lists — bars read better than
+                donuts, and the donuts stay at lg 4 so their legends fit. */}
+            <Grid gap="md">
+              <Grid.Col span={{ base: 12, lg: 7 }}>
+                {/* Per-yard status, not a plain per-yard count: the OCC needs to
+                    know which of the wagons standing at a yard can actually run. */}
+                <OverviewStackedBarChart
+                  title="Wagons by yard and status"
+                  data={wagonsByYard.rows}
+                  series={wagonsByYard.series}
+                  xKey="group"
+                  emptyMessage="No wagons positioned"
+                />
+              </Grid.Col>
+              <Grid.Col span={{ base: 12, lg: 5 }}>
+                <OverviewHorizontalBarChart
+                  title="Wagons by type"
+                  data={labelsToBars(tab.wagonsByType)}
+                  valueLabel="Wagons"
+                  emptyMessage="No wagons registered"
+                />
+              </Grid.Col>
+              <Grid.Col span={{ base: 12, lg: 4 }}>
+                <OverviewDonutChart
+                  title={`Wagon status (${sumCounts(tab.wagonStatusBreakdown)})`}
+                  data={toDonut(tab.wagonStatusBreakdown)}
+                  emptyMessage="No wagons registered"
+                />
+              </Grid.Col>
+              <Grid.Col span={{ base: 12, lg: 4 }}>
+                <OverviewDonutChart
+                  title="Train status"
+                  data={toDonut(tab.trainStatusBreakdown)}
+                  emptyMessage="No trains registered"
+                />
+              </Grid.Col>
+              <Grid.Col span={{ base: 12, lg: 4 }}>
+                <OverviewDonutChart
+                  title="Container status"
+                  data={toDonut(tab.containerStatusBreakdown)}
+                  emptyMessage="No containers tracked"
+                />
+              </Grid.Col>
+            </Grid>
+          </Stack>
+        )}
+      </AsyncBand>
+
+      <AsyncBand index={2} title="Locomotives" query={fleet}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, lg: 7 }}>
+              <OverviewStackedBarChart
+                title="Locomotives by station and status"
+                data={locomotivesByYard.rows}
+                series={locomotivesByYard.series}
+                xKey="group"
+                emptyMessage="No locomotives registered"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 5 }}>
+              <OverviewDonutChart
+                title={`Locomotive status (${sumCounts(tab.locomotiveStatusBreakdown)})`}
+                data={toDonut(tab.locomotiveStatusBreakdown)}
+                emptyMessage="No locomotives registered"
+              />
+            </Grid.Col>
+            <Grid.Col span={12}>
+              <OverviewHorizontalBarChart
+                title="Turnaround per train set (departure to departure)"
+                data={(tab.turnaroundByTrain ?? []).map((row) => ({
+                  label: row.trainSet,
+                  value: row.hours,
+                }))}
+                valueLabel="Hours"
+                emptyMessage="No train set has two recorded departures in this period"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+      <AsyncBand index={3} title="Train movement" query={ops}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, lg: 8 }}>
+              <OverviewStackedBarChart
+                title="Departures by direction"
+                data={tab.departureTrend ?? []}
+                series={DIRECTION_SERIES}
+                formatXLabel={formatDayLabel}
+                emptyMessage="No scheduled departures in this period"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Schedule status"
+                data={toDonut(tab.scheduleStatusBreakdown)}
+                emptyMessage="No train schedules yet"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/OperationsOverview.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/OperationsOverview.tsx
new file mode 100644
index 000000000..544def510
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/OperationsOverview.tsx
@@ -0,0 +1,181 @@
+import { CircleCheck, Link2, OctagonAlert, Truck, Wrench } from "lucide-react";
+import { Grid, Stack } from "@mantine/core";
+
+import { OverviewDonutChart } from "@/components/overview/OverviewDonutChart";
+import { OverviewHorizontalBarChart } from "@/components/overview/OverviewHorizontalBarChart";
+import { OverviewKpiStrip } from "@/components/overview/OverviewKpiStrip";
+import { OverviewStackedBarChart } from "@/components/overview/OverviewStackedBarChart";
+import { OverviewPipelineFunnel } from "@/components/overview/summary/OverviewPipelineFunnel";
+import { useOverviewFleetTab, useOverviewOperationsTab } from "@/hooks/useOverview";
+import { TrainLoadCard } from "./TrainLoadCard";
+import {
+  AsyncBand,
+  Band,
+  DIRECTION_SERIES,
+  countByStatus,
+  formatDayLabel,
+  labelsToBars,
+  labelsToDonut,
+  pivotMatrix,
+  sumCounts,
+  toDonut,
+  type RoleOverviewProps,
+} from "./layout-kit";
+
+/**
+ * Wagon fleet, booking demand and freight moved — the operations officer's
+ * three questions. Wagon counts come from the status breakdown rather than the
+ * headline KPI so every lifecycle state (including detained / out of service)
+ * is accounted for against the same total.
+ */
+export function OperationsOverview({ data, range }: RoleOverviewProps) {
+  const ops = useOverviewOperationsTab(range, true);
+  const fleet = useOverviewFleetTab(range, true);
+  const statusByType = pivotMatrix(fleet.data?.wagonStatusByType);
+  const bookingsByPort = pivotMatrix(ops.data?.bookingStatusByPort);
+
+  return (
+    <Stack gap="xl" mt="xl">
+      <AsyncBand index={1} title="Wagon fleet" query={ops}>
+        {(tab) => {
+          const wagons = tab.wagonStatusBreakdown ?? [];
+          const total = sumCounts(wagons);
+          const available = countByStatus(wagons, "AVAILABLE", "IMPORT_READY", "EXPORT_READY");
+          const assigned = countByStatus(wagons, "ASSIGNED");
+
+          return (
+            <Stack gap="md">
+              {/* Five cells fit a 1440px screen only without hints — the
+                  status donut below carries the same detail anyway. */}
+              <OverviewKpiStrip
+                items={[
+                  { label: "Total wagons", value: total, icon: Truck },
+                  {
+                    label: "Available",
+                    value: available,
+                    icon: CircleCheck,
+                    accent: "emerald",
+                  },
+                  { label: "Assigned", value: assigned, icon: Link2, accent: "sky" },
+                  {
+                    label: "Maintenance",
+                    value: countByStatus(wagons, "MAINTENANCE"),
+                    icon: Wrench,
+                    accent: "amber",
+                  },
+                  {
+                    label: "Detained / OOS",
+                    value: countByStatus(wagons, "DETAINED", "OUT_OF_SERVICE"),
+                    icon: OctagonAlert,
+                    accent: "rose",
+                  },
+                ]}
+              />
+              <Grid gap="md">
+                <Grid.Col span={{ base: 12, lg: 4 }}>
+                  <OverviewDonutChart
+                    title="Wagons by status"
+                    data={toDonut(wagons)}
+                    emptyMessage="No wagons registered"
+                  />
+                </Grid.Col>
+                <Grid.Col span={{ base: 12, lg: 8 }}>
+                  {/* Status per type answers "how many flat wagons can I use
+                      today", which the plain per-type count could not. */}
+                  <OverviewStackedBarChart
+                    title="Wagons by type and status"
+                    data={statusByType.rows}
+                    series={statusByType.series}
+                    xKey="group"
+                    emptyMessage="No wagons registered"
+                  />
+                </Grid.Col>
+                <Grid.Col span={12}>
+                  <OverviewHorizontalBarChart
+                    title="Wagons by yard"
+                    data={labelsToBars(tab.wagonsByYard)}
+                    valueLabel="Wagons"
+                  />
+                </Grid.Col>
+              </Grid>
+            </Stack>
+          );
+        }}
+      </AsyncBand>
+
+      <Band index={2} title="Booking demand">
+        <Grid gap="md">
+          <Grid.Col span={{ base: 12, lg: 7 }}>
+            <OverviewPipelineFunnel data={data.bookingsByPipeline} />
+          </Grid.Col>
+          <Grid.Col span={{ base: 12, lg: 5 }}>
+            <OverviewDonutChart
+              title="Bookings by status"
+              data={toDonut(data.bookingsByStatus)}
+              emptyMessage="No bookings yet"
+            />
+          </Grid.Col>
+        </Grid>
+      </Band>
+
+      <AsyncBand index={3} title="Freight moved" query={ops}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, lg: 8 }}>
+              <OverviewStackedBarChart
+                title="Train departures by direction"
+                data={tab.departureTrend ?? []}
+                series={DIRECTION_SERIES}
+                formatXLabel={formatDayLabel}
+                emptyMessage="No scheduled departures in this period"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 4 }}>
+              <OverviewDonutChart
+                title="Train status"
+                data={toDonut(tab.trainStatusBreakdown)}
+                emptyMessage="No trains registered"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, md: 6 }}>
+              <OverviewHorizontalBarChart
+                title="Cargo tonnage by type"
+                data={(tab.cargoTonnageByType ?? []).map((item) => ({
+                  label: item.label,
+                  value: item.tons,
+                }))}
+                valueLabel="Tons"
+                emptyMessage="No cargo recorded"
+              />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, md: 6 }}>
+              <OverviewDonutChart
+                title="Containers by size"
+                data={labelsToDonut(tab.containersBySize)}
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+
+      <AsyncBand index={4} title="Trains & ports" query={ops}>
+        {(tab) => (
+          <Grid gap="md">
+            <Grid.Col span={{ base: 12, lg: 7 }}>
+              <TrainLoadCard loads={tab.trainLoads ?? []} />
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, lg: 5 }}>
+              <OverviewStackedBarChart
+                title="Bookings by port and status"
+                data={bookingsByPort.rows}
+                series={bookingsByPort.series}
+                xKey="group"
+                emptyMessage="No bookings in this period"
+              />
+            </Grid.Col>
+          </Grid>
+        )}
+      </AsyncBand>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/TrainLoadCard.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/TrainLoadCard.tsx
new file mode 100644
index 000000000..334b59624
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/TrainLoadCard.tsx
@@ -0,0 +1,74 @@
+import { TrainFront } from "lucide-react";
+import { Badge, Group, Progress, Stack, Text } from "@mantine/core";
+
+import { humanize } from "@/lib/format";
+import type { IOverviewTrainLoad } from "@/types/overview";
+import { SummaryCard } from "@/components/overview/summary/SummaryCard";
+
+const DIRECTION_COLOR: Record<string, string> = {
+  IMPORT: "blue",
+  EXPORT: "yellow",
+  DOMESTIC: "violet",
+};
+
+/**
+ * Wagon fill per scheduled train: the bar is allocated slots against the train
+ * set's own wagon count, so a short train at 100% reads as full rather than as
+ * a small number next to a big one.
+ */
+export function TrainLoadCard({ loads = [] }: { loads: IOverviewTrainLoad[] }) {
+  return (
+    <SummaryCard
+      icon={TrainFront}
+      accent="blue"
+      title="Wagons allocated per train"
+      subtitle="Slots filled and tonnage loaded"
+    >
+      {loads.length === 0 ? (
+        <Text size="sm" c="dimmed" ta="center" py="xl">
+          No scheduled trains
+        </Text>
+      ) : (
+        <Stack gap="sm">
+          {loads.map((load) => {
+            const percent = load.wagonsTotal
+              ? Math.round((load.wagonsAllocated / load.wagonsTotal) * 100)
+              : 0;
+            return (
+              <Stack key={load.scheduleId} gap={4}>
+                <Group justify="space-between" gap="xs" wrap="nowrap">
+                  <Group gap={8} wrap="nowrap" style={{ minWidth: 0 }}>
+                    <Text size="sm" fw={600} truncate>
+                      {load.trainNumber}
+                    </Text>
+                    <Badge
+                      size="xs"
+                      variant="light"
+                      color={DIRECTION_COLOR[load.direction] ?? "gray"}
+                      style={{ textTransform: "none" }}
+                    >
+                      {humanize(load.direction)}
+                    </Badge>
+                    <Text size="xs" c="dimmed">
+                      {load.date}
+                    </Text>
+                  </Group>
+                  <Text size="xs" c="dimmed" style={{ whiteSpace: "nowrap" }}>
+                    {load.wagonsAllocated}/{load.wagonsTotal} wagons ·{" "}
+                    {Math.round(load.tons).toLocaleString()} t
+                  </Text>
+                </Group>
+                <Progress
+                  value={percent}
+                  color={percent >= 90 ? "edr-green" : percent > 0 ? "yellow" : "gray"}
+                  size="sm"
+                  radius="xl"
+                />
+              </Stack>
+            );
+          })}
+        </Stack>
+      )}
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/layouts/layout-kit.tsx b/apps/edr-freight-web/backoffice/src/components/overview/layouts/layout-kit.tsx
new file mode 100644
index 000000000..421284689
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/layouts/layout-kit.tsx
@@ -0,0 +1,164 @@
+import type { ReactNode } from "react";
+import { AlertCircle } from "lucide-react";
+import { Alert, Skeleton, Stack, Text } from "@mantine/core";
+
+import { humanize } from "@/lib/format";
+import { overviewChartColors } from "@/components/overview/overview.styles";
+import type {
+  IOverviewDashboard,
+  IOverviewLabelCount,
+  IOverviewMatrixCell,
+  IOverviewStatusCount,
+  OverviewRange,
+} from "@/types/overview";
+
+/** Every role layout takes the same summary payload + the selected range. */
+export interface RoleOverviewProps {
+  data: IOverviewDashboard;
+  range: OverviewRange;
+}
+
+/** Uppercase section eyebrow — matches the WarehouseDashboardPage convention. */
+export function SectionTitle({ children }: { children: string }) {
+  return (
+    <Text fw={700} fz="sm" tt="uppercase" c="edr-muted" style={{ letterSpacing: 0.4 }}>
+      {children}
+    </Text>
+  );
+}
+
+/** One page band: eyebrow + content, with a staggered entrance by index. */
+export function Band({
+  index,
+  title,
+  children,
+}: {
+  index: number;
+  title: string;
+  children: ReactNode;
+}) {
+  return (
+    <Stack gap="sm" className="ov-band" style={{ animationDelay: `${index * 70}ms` }}>
+      <SectionTitle>{title}</SectionTitle>
+      {children}
+    </Stack>
+  );
+}
+
+/** Minimal shape of the react-query result a band consumes. */
+interface BandQuery<T> {
+  data?: T;
+  isLoading: boolean;
+  isError: boolean;
+}
+
+/**
+ * A band fed by one of the per-domain overview endpoints. Loading shows a
+ * skeleton, a failure degrades to an inline notice — a role dashboard stitches
+ * several endpoints together and one 403 (a role without that domain's
+ * permission) must not blank the whole page.
+ */
+export function AsyncBand<T>({
+  index,
+  title,
+  query,
+  children,
+}: {
+  index: number;
+  title: string;
+  query: BandQuery<T>;
+  children: (data: T) => ReactNode;
+}) {
+  return (
+    <Band index={index} title={title}>
+      {query.isLoading ? (
+        <Skeleton height={300} radius="lg" />
+      ) : query.isError || !query.data ? (
+        <Alert
+          icon={<AlertCircle size={16} />}
+          color="gray"
+          variant="light"
+          title={`${title} unavailable`}
+        >
+          This section could not be loaded for your account.
+        </Alert>
+      ) : (
+        children(query.data)
+      )}
+    </Band>
+  );
+}
+
+/** Fixed direction colors (CVD-validated pair + violet): color follows the entity. */
+export const DIRECTION_SERIES = [
+  { key: "exportCount", label: "Export", color: "#D98A0B" },
+  { key: "importCount", label: "Import", color: "#0369a1" },
+  { key: "domesticCount", label: "Domestic", color: "#7c3aed" },
+];
+
+export function formatDayLabel(date: string) {
+  return new Date(`${date}T00:00:00`).toLocaleDateString(undefined, {
+    month: "short",
+    day: "numeric",
+  });
+}
+
+export function sumCounts(items: IOverviewStatusCount[] = []) {
+  return items.reduce((sum, item) => sum + item.count, 0);
+}
+
+export function countByStatus(items: IOverviewStatusCount[] = [], ...statuses: string[]) {
+  return items
+    .filter((item) => statuses.includes(item.status))
+    .reduce((sum, item) => sum + item.count, 0);
+}
+
+/** Status breakdown → donut slices; statuses are enum keys, so humanize them. */
+export function toDonut(items: IOverviewStatusCount[] = []) {
+  return items.map((item) => ({ name: humanize(item.status), value: item.count }));
+}
+
+/** Label breakdown → donut slices. Labels are names (yards, sizes) — left verbatim. */
+export function labelsToDonut(items: IOverviewLabelCount[] = []) {
+  return items.map((item) => ({ name: item.label, value: item.count }));
+}
+
+export function labelsToBars(items: IOverviewLabelCount[] = []) {
+  return items.map((item) => ({ label: item.label, value: item.count }));
+}
+
+/**
+ * Matrix cells → the row/series shape OverviewStackedBarChart wants: one row
+ * per `group`, one series per distinct `series` value, colors fixed by the
+ * series' position so a status keeps its color across charts.
+ */
+export function pivotMatrix(cells: IOverviewMatrixCell[] = []) {
+  const seriesKeys = [...new Set(cells.map((cell) => cell.series))].sort();
+  const groups = [...new Set(cells.map((cell) => cell.group))];
+
+  const rows = groups.map((group) => {
+    const row: Record<string, string | number> = { group };
+    for (const key of seriesKeys) row[key] = 0;
+    for (const cell of cells) {
+      if (cell.group === group) row[cell.series] = cell.count;
+    }
+    return row;
+  });
+
+  const series = seriesKeys.map((key, index) => ({
+    key,
+    label: humanize(key),
+    color: overviewChartColors.pipeline[index % overviewChartColors.pipeline.length],
+  }));
+
+  return { rows, series };
+}
+
+/** Same, for breakdowns whose labels are enum values (ONE_TIME, BULK, …). */
+export function enumLabelsToDonut(items: IOverviewLabelCount[] = []) {
+  return items.map((item) => ({ name: humanize(item.label), value: item.count }));
+}
+
+export function enumLabelsToBars(items: IOverviewLabelCount[] = []) {
+  return items.map((item) => ({ label: humanize(item.label), value: item.count }));
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/overview-domains.config.ts b/apps/edr-freight-web/backoffice/src/components/overview/overview-domains.config.ts
new file mode 100644
index 000000000..4d106eeeb
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/overview-domains.config.ts
@@ -0,0 +1,88 @@
+import {
+  Banknote,
+  FileSignature,
+  FileText,
+  Train,
+  TrainFront,
+  UserCheck,
+  Users,
+  type LucideIcon,
+} from "lucide-react";
+
+import { FREIGHT_PERMS } from "@/lib/permissions";
+import type { OverviewTabKey } from "@/types/overview";
+
+/**
+ * Single source of truth for the seven overview drill-down pages — used both
+ * to build the `/dashboard/overview/:domain` routes in App.tsx and to render
+ * each page's header in OverviewDomainPage. One list, no duplicated permission
+ * arrays to drift out of sync.
+ */
+export const OVERVIEW_DOMAINS: Array<{
+  key: OverviewTabKey;
+  label: string;
+  subtitle: string;
+  icon: LucideIcon;
+  /** Any of these keys grants the page. */
+  permission: string[];
+}> = [
+  {
+    key: "bookings",
+    label: "Bookings",
+    subtitle: "Booking volume, pipeline, and recent activity",
+    icon: FileText,
+    permission: [FREIGHT_PERMS.bookings.view],
+  },
+  {
+    key: "contracts",
+    label: "Contracts",
+    subtitle: "Contract volume, pipeline, and recent activity",
+    icon: FileSignature,
+    permission: [FREIGHT_PERMS.contracts.view],
+  },
+  {
+    key: "billing",
+    label: "Billing",
+    subtitle: "Revenue, payments, and collection status",
+    icon: Banknote,
+    permission: [FREIGHT_PERMS.bookings.view, FREIGHT_PERMS.payments.view],
+  },
+  {
+    key: "operations",
+    label: "Operations",
+    subtitle: "Trains, schedules, containers, and cargo",
+    icon: Train,
+    permission: [
+      FREIGHT_PERMS.trainScheduling.view,
+      FREIGHT_PERMS.warehouseInventory.view,
+      FREIGHT_PERMS.firstMile.view,
+      FREIGHT_PERMS.lastMile.view,
+    ],
+  },
+  {
+    key: "fleet",
+    label: "Fleet",
+    subtitle: "Wagon and train fleet status",
+    icon: TrainFront,
+    permission: [FREIGHT_PERMS.wagons.view, FREIGHT_PERMS.trainScheduling.view],
+  },
+  {
+    key: "customers",
+    label: "Customers",
+    subtitle: "Customer growth and top accounts",
+    icon: Users,
+    permission: [FREIGHT_PERMS.customers.view],
+  },
+  {
+    key: "staff",
+    label: "Staff",
+    subtitle: "Employee and user account status",
+    icon: UserCheck,
+    permission: [
+      FREIGHT_PERMS.admin,
+      FREIGHT_PERMS.staff.roles.view,
+      FREIGHT_PERMS.staff.employeeRegistration.view,
+      FREIGHT_PERMS.staff.roleAssignment.view,
+    ],
+  },
+];
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/overview.css b/apps/edr-freight-web/backoffice/src/components/overview/overview.css
index 86b468df3..10b358bbd 100644
--- a/apps/edr-freight-web/backoffice/src/components/overview/overview.css
+++ b/apps/edr-freight-web/backoffice/src/components/overview/overview.css
@@ -1,5 +1,8 @@
 /* ============================================================
-   EDR Freight — Overview page styles (hero controls + tabs)
+   EDR Freight — shared "premium" tab bar + segmented control styles.
+   Named after the overview page they were first built for, but now shared
+   by BookingStatusTabs, ContractStatusTabs, and ReceiveInventoryModal —
+   do not remove `.ov-tablist` / `.ov-tab` without checking those importers.
    ============================================================ */
 
 /* ---- Hero range segmented control (on gradient) ---- */
@@ -19,7 +22,7 @@
   color: var(--mantine-color-edr-green-7);
 }
 
-/* ---- Premium tab bar ---- */
+/* ---- Premium tab bar (BookingStatusTabs, ContractStatusTabs, ReceiveInventoryModal) ---- */
 .ov-tablist {
   display: flex;
   flex-wrap: wrap;
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/role-dashboards.config.ts b/apps/edr-freight-web/backoffice/src/components/overview/role-dashboards.config.ts
new file mode 100644
index 000000000..509f17a3c
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/role-dashboards.config.ts
@@ -0,0 +1,50 @@
+import type { AuthUser } from "@/auth/types";
+import { getPositionKeys } from "@/lib/permissions";
+
+/** One overview composition. Every backoffice user lands on exactly one of these. */
+export type OverviewLayoutKey =
+  | "executive"
+  | "operations"
+  | "occ"
+  | "marketing"
+  | "finance"
+  | "clearance";
+
+export const OVERVIEW_LAYOUT_LABEL: Record<OverviewLayoutKey, string> = {
+  executive: "Executive dashboard",
+  operations: "Operations dashboard",
+  occ: "Control centre dashboard",
+  marketing: "Marketing dashboard",
+  finance: "Finance dashboard",
+  clearance: "Clearance & logistics dashboard",
+};
+
+/**
+ * Role/position key → layout, in match priority order: a user holding several
+ * of these keys gets the first match, so the specific operational view wins
+ * over the broad executive one. Position keys are matched too because the IAM
+ * payload models the GL desks as positions (`ethiopian_gl`) on some accounts
+ * and as roles (`edr_gl_ethiopia`) on others — see `getPositionKeys`.
+ */
+const ROLE_LAYOUTS: Array<[key: string, layout: OverviewLayoutKey]> = [
+  ["edr_operations_officer", "operations"],
+  ["truck_machinery_chief", "operations"],
+  ["edr_line_staff", "occ"],
+  ["edr_gl_ethiopia", "clearance"],
+  ["edr_gl_djibouti", "clearance"],
+  ["ethiopian_gl", "clearance"],
+  ["djibouti_gl", "clearance"],
+  ["edr_marketing", "marketing"],
+  ["edr_finance", "finance"],
+  ["edr_director", "executive"],
+  ["edr_ceo", "executive"],
+  ["edr_org_manager", "executive"],
+];
+
+/** Unmapped roles (superadmin, IAM admins, new roles) keep the executive layout. */
+export function resolveOverviewLayout(
+  user: AuthUser | null | undefined,
+): OverviewLayoutKey {
+  const held = new Set(getPositionKeys(user));
+  return ROLE_LAYOUTS.find(([key]) => held.has(key))?.[1] ?? "executive";
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/CountUp.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/CountUp.tsx
new file mode 100644
index 000000000..28802e321
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/CountUp.tsx
@@ -0,0 +1,44 @@
+import { useEffect, useRef, useState } from "react";
+
+const DURATION_MS = 750;
+
+function prefersReducedMotion() {
+  return (
+    typeof window !== "undefined" &&
+    window.matchMedia("(prefers-reduced-motion: reduce)").matches
+  );
+}
+
+/**
+ * Animates a number from 0 to `value` (ease-out) on mount and whenever the
+ * value changes — the hero-KPI count-up. Renders the final value immediately
+ * when the user prefers reduced motion.
+ */
+export function CountUp({
+  value,
+  format = (n) => Math.round(n).toLocaleString(),
+}: {
+  value: number;
+  format?: (n: number) => string;
+}) {
+  const [display, setDisplay] = useState(() => (prefersReducedMotion() ? value : 0));
+  const frame = useRef<number>(0);
+
+  useEffect(() => {
+    if (prefersReducedMotion()) {
+      setDisplay(value);
+      return;
+    }
+    const start = performance.now();
+    const tick = (now: number) => {
+      const t = Math.min(1, (now - start) / DURATION_MS);
+      const eased = 1 - (1 - t) ** 3;
+      setDisplay(value * eased);
+      if (t < 1) frame.current = requestAnimationFrame(tick);
+    };
+    frame.current = requestAnimationFrame(tick);
+    return () => cancelAnimationFrame(frame.current);
+  }, [value]);
+
+  return <>{format(display)}</>;
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewActivityHeatmap.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewActivityHeatmap.tsx
new file mode 100644
index 000000000..7524c1f20
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewActivityHeatmap.tsx
@@ -0,0 +1,125 @@
+import { Fragment } from "react";
+import { CalendarClock } from "lucide-react";
+import { Badge, Group, Stack, Text, Tooltip } from "@mantine/core";
+
+import type { IOverviewHeatmapCell } from "@/types/overview";
+import { SummaryCard } from "./SummaryCard";
+
+/** ISO weekday order, 1 = Monday. */
+const DAY_LABELS = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
+/** 3-hour blocks, 0 = 00–03 … 7 = 21–24. */
+const BLOCK_LABELS = ["12a", "3a", "6a", "9a", "12p", "3p", "6p", "9p"];
+
+/** Map an intensity in (0, 1] to the brand-green ramp; zero stays neutral. */
+function cellColor(count: number, max: number) {
+  if (count === 0) return "var(--mantine-color-gray-1)";
+  const shade = Math.max(1, Math.min(7, Math.ceil((count / max) * 7)));
+  return `var(--mantine-color-edr-green-${shade})`;
+}
+
+interface OverviewActivityHeatmapProps {
+  cells: IOverviewHeatmapCell[];
+}
+
+/**
+ * When demand arrives: booking submissions by weekday × 3-hour block for the
+ * selected range. The bright cells (and the peak badge) are the hours the
+ * intake team needs to be staffed for.
+ */
+export function OverviewActivityHeatmap({ cells = [] }: OverviewActivityHeatmapProps) {
+  const countByCell = new Map(cells.map((c) => [`${c.dow}-${c.block}`, c.count]));
+  const max = Math.max(0, ...cells.map((c) => c.count));
+  const peak = cells.reduce<IOverviewHeatmapCell | null>(
+    (best, c) => (c.count > (best?.count ?? 0) ? c : best),
+    null,
+  );
+
+  return (
+    <SummaryCard
+      icon={CalendarClock}
+      accent="violet"
+      title="Booking rhythm"
+      subtitle="When bookings arrive, by weekday and time"
+      action={
+        peak ? (
+          <Badge variant="light" color="violet" size="sm" style={{ textTransform: "none" }}>
+            Peak {DAY_LABELS[peak.dow - 1]} {BLOCK_LABELS[peak.block]}
+          </Badge>
+        ) : null
+      }
+    >
+      {max === 0 ? (
+        <Text size="sm" c="dimmed" ta="center" py="xl">
+          No bookings in this period
+        </Text>
+      ) : (
+        <Stack gap={4}>
+          <div
+            style={{
+              display: "grid",
+              gridTemplateColumns: "36px repeat(8, 1fr)",
+              gap: 3,
+            }}
+          >
+            <span />
+            {BLOCK_LABELS.map((label) => (
+              <Text key={label} size="xs" c="dimmed" ta="center">
+                {label}
+              </Text>
+            ))}
+            {DAY_LABELS.map((day, dayIndex) => (
+              <Fragment key={day}>
+                <Text size="xs" c="dimmed" style={{ lineHeight: "24px" }}>
+                  {day}
+                </Text>
+                {BLOCK_LABELS.map((_, block) => {
+                  const count = countByCell.get(`${dayIndex + 1}-${block}`) ?? 0;
+                  return (
+                    <Tooltip
+                      key={`${day}-${block}`}
+                      label={`${day} ${BLOCK_LABELS[block]}–${BLOCK_LABELS[(block + 1) % 8]} · ${count} booking${count === 1 ? "" : "s"}`}
+                      withArrow
+                      openDelay={150}
+                    >
+                      <div
+                        style={{
+                          height: 24,
+                          borderRadius: 6,
+                          background: cellColor(count, max),
+                          cursor: "default",
+                          transition: "transform 120ms ease",
+                        }}
+                      />
+                    </Tooltip>
+                  );
+                })}
+              </Fragment>
+            ))}
+          </div>
+          <Group gap={6} justify="flex-end" mt={4}>
+            <Text size="xs" c="dimmed">
+              Less
+            </Text>
+            {[0, 2, 4, 6].map((shade) => (
+              <div
+                key={shade}
+                style={{
+                  width: 14,
+                  height: 14,
+                  borderRadius: 4,
+                  background:
+                    shade === 0
+                      ? "var(--mantine-color-gray-1)"
+                      : `var(--mantine-color-edr-green-${shade + 1})`,
+                }}
+              />
+            ))}
+            <Text size="xs" c="dimmed">
+              More
+            </Text>
+          </Group>
+        </Stack>
+      )}
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewAttentionCard.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewAttentionCard.tsx
new file mode 100644
index 000000000..c36db5e57
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewAttentionCard.tsx
@@ -0,0 +1,149 @@
+import {
+  AlertCircle,
+  Banknote,
+  BellRing,
+  Check,
+  ChevronRight,
+  Clock,
+  FileSignature,
+  ShieldCheck,
+} from "lucide-react";
+import { Link } from "react-router-dom";
+import { Badge, Group, Stack, Text, ThemeIcon } from "@mantine/core";
+
+import type { IOverviewBillingKpis, IOverviewBookingKpis, IOverviewContractKpis } from "@/types/overview";
+import { SummaryCard } from "./SummaryCard";
+
+interface OverviewAttentionCardProps {
+  bookings: IOverviewBookingKpis;
+  contracts: IOverviewContractKpis;
+  billing: IOverviewBillingKpis;
+}
+
+/**
+ * The work queue, demoted below the money/volume story but still one glance
+ * away — this page is read by executives first, staff second. Every row
+ * links to the real filtered (or closest available) list; none are dead ends.
+ */
+export function OverviewAttentionCard({ bookings, contracts, billing }: OverviewAttentionCardProps) {
+  const rows = [
+    {
+      key: "needsAction",
+      label: "Bookings needing action",
+      count: bookings.needsAction ?? 0,
+      icon: AlertCircle,
+      href: "/dashboard/booking-requests",
+    },
+    {
+      key: "urgent",
+      label: "Urgent bookings",
+      count: bookings.urgent ?? 0,
+      icon: Clock,
+      href: "/dashboard/booking-requests",
+    },
+    {
+      key: "contractsApproval",
+      label: "Contracts in approval",
+      count: contracts.inApproval ?? 0,
+      icon: FileSignature,
+      href: "/dashboard/contract-requests",
+    },
+    {
+      key: "contractsClearance",
+      label: "Contracts in clearance",
+      count: contracts.inClearance ?? 0,
+      icon: ShieldCheck,
+      href: "/dashboard/contracts/clearance",
+    },
+    {
+      key: "pendingPayments",
+      label: "Pending payments",
+      count: billing.pendingPayments ?? 0,
+      icon: Banknote,
+      href: "/dashboard/payments",
+    },
+  ];
+  const openItems = rows.reduce((sum, row) => sum + row.count, 0);
+  const allClear = openItems === 0;
+
+  return (
+    <SummaryCard
+      icon={BellRing}
+      accent="orange"
+      title="Needs attention"
+      subtitle="Waiting on someone here"
+      minHeight={260}
+      action={
+        allClear ? null : (
+          <Badge variant="light" color="orange" size="sm" style={{ textTransform: "none" }}>
+            {openItems.toLocaleString()} open
+          </Badge>
+        )
+      }
+    >
+      {allClear ? (
+        <Stack align="center" gap={8} py="lg">
+          <ThemeIcon variant="light" color="edr-green" size={48} radius="xl">
+            <Check size={26} />
+          </ThemeIcon>
+          <Text fw={700}>All clear</Text>
+          <Text size="sm" c="dimmed">
+            Nothing waiting on you right now.
+          </Text>
+        </Stack>
+      ) : (
+        <Stack gap={4}>
+          {rows.map((row) => {
+            const Icon = row.icon;
+            const active = row.count > 0;
+            return (
+              <Link
+                key={row.key}
+                to={row.href}
+                className="ov-row"
+                style={{ textDecoration: "none", color: "inherit", padding: "7px 10px" }}
+              >
+                <Group justify="space-between" wrap="nowrap">
+                  <Group gap={10} wrap="nowrap" style={{ minWidth: 0 }}>
+                    <ThemeIcon
+                      variant="light"
+                      color={active ? "orange" : "gray"}
+                      size={30}
+                      radius={10}
+                      style={{ flexShrink: 0 }}
+                    >
+                      <Icon size={16} />
+                    </ThemeIcon>
+                    <Text size="sm" c="edr-text" truncate>
+                      {row.label}
+                    </Text>
+                  </Group>
+                  <Group gap={6} wrap="nowrap" style={{ flexShrink: 0 }}>
+                    <Text
+                      size="sm"
+                      fw={700}
+                      ta="center"
+                      c={active ? "orange.8" : "dimmed"}
+                      style={{
+                        minWidth: 34,
+                        background: active
+                          ? "var(--mantine-color-orange-0)"
+                          : "var(--mantine-color-gray-0)",
+                        borderRadius: 999,
+                        padding: "1px 8px",
+                        fontVariantNumeric: "tabular-nums",
+                      }}
+                    >
+                      {row.count}
+                    </Text>
+                    <ChevronRight size={14} style={{ color: "var(--mantine-color-edr-muted-6)" }} />
+                  </Group>
+                </Group>
+              </Link>
+            );
+          })}
+        </Stack>
+      )}
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewHero.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewHero.tsx
new file mode 100644
index 000000000..4e0fcdc10
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewHero.tsx
@@ -0,0 +1,157 @@
+import { RefreshCw } from "lucide-react";
+import { ActionIcon, Badge, Group, SegmentedControl, Stack, Text } from "@mantine/core";
+
+import { useAuth } from "@/auth/useAuth";
+import { formatDateTime } from "@/lib/format";
+import { freightBrand } from "@/theme/freight-brand";
+import type { OverviewRange } from "@/types/overview";
+import "@/components/overview/overview.css";
+
+const RANGE_OPTIONS = [
+  { label: "7 days", value: "7d" },
+  { label: "30 days", value: "30d" },
+  { label: "90 days", value: "90d" },
+];
+
+function formatRelativeTime(iso: string | undefined) {
+  if (!iso) return "—";
+  const diffMs = Date.now() - new Date(iso).getTime();
+  const minutes = Math.floor(diffMs / 60_000);
+  if (minutes < 1) return "just now";
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  return formatDateTime(iso);
+}
+
+function greeting(hour: number) {
+  if (hour < 12) return "Good morning";
+  if (hour < 18) return "Good afternoon";
+  return "Good evening";
+}
+
+interface OverviewHeroProps {
+  range: OverviewRange;
+  onRangeChange: (range: OverviewRange) => void;
+  generatedAt?: string;
+  onRefresh: () => void;
+  isRefreshing?: boolean;
+  /** Name of the role-specific layout rendered below, e.g. "Operations dashboard". */
+  label?: string;
+}
+
+/**
+ * Brand-gradient greeting banner: time-of-day greeting with the signed-in
+ * user's first name, today's date, freshness badge, and the range controls.
+ * Extra bottom padding leaves room for the KPI strip to overlap it.
+ */
+export function OverviewHero({
+  range,
+  onRangeChange,
+  generatedAt,
+  onRefresh,
+  isRefreshing,
+  label,
+}: OverviewHeroProps) {
+  const { user } = useAuth();
+  const fullName = (user?.name?.en ?? user?.name?.am)?.trim();
+  const firstName = fullName ? fullName.split(/\s+/)[0] : undefined;
+  const now = new Date();
+  const dateLabel = now.toLocaleDateString(undefined, {
+    weekday: "long",
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+  });
+
+  return (
+    <div
+      style={{
+        background: freightBrand.gradient,
+        borderRadius: 20,
+        padding: "28px 28px 76px",
+        position: "relative",
+        overflow: "hidden",
+      }}
+    >
+      {/* Soft highlight so the flat gradient reads as a lit surface. */}
+      <div
+        style={{
+          position: "absolute",
+          inset: 0,
+          background:
+            "radial-gradient(640px 240px at 85% -40%, rgba(255, 255, 255, 0.2), transparent)",
+          pointerEvents: "none",
+        }}
+      />
+      <Group
+        justify="space-between"
+        align="flex-start"
+        wrap="wrap"
+        gap="md"
+        style={{ position: "relative" }}
+      >
+        <Stack gap={6}>
+          <Text c="white" fw={800} fz={26} lh={1.15} style={{ letterSpacing: "-0.02em" }}>
+            {greeting(now.getHours())}
+            {firstName ? `, ${firstName}` : ""} 👋
+          </Text>
+          <Group gap={10}>
+            <Text c="rgba(255,255,255,0.75)" size="sm">
+              {dateLabel}
+            </Text>
+            {label ? (
+              <Badge
+                size="sm"
+                variant="light"
+                style={{
+                  background: "rgba(255,255,255,0.16)",
+                  color: "rgba(255,255,255,0.9)",
+                  textTransform: "none",
+                }}
+              >
+                {label}
+              </Badge>
+            ) : null}
+            <Badge
+              size="sm"
+              variant="light"
+              style={{
+                background: "rgba(255,255,255,0.16)",
+                color: "rgba(255,255,255,0.9)",
+                textTransform: "none",
+              }}
+            >
+              Updated {formatRelativeTime(generatedAt)}
+            </Badge>
+          </Group>
+        </Stack>
+        <Group gap="sm">
+          <SegmentedControl
+            value={range}
+            onChange={(value) => onRangeChange(value as OverviewRange)}
+            data={RANGE_OPTIONS}
+            size="sm"
+            radius="lg"
+            classNames={{
+              root: "ov-seg-root",
+              indicator: "ov-seg-indicator",
+              label: "ov-seg-label",
+            }}
+          />
+          <ActionIcon
+            variant="white"
+            color="edr-green"
+            size="lg"
+            radius="lg"
+            aria-label="Refresh dashboard"
+            onClick={onRefresh}
+            loading={isRefreshing}
+          >
+            <RefreshCw size={18} />
+          </ActionIcon>
+        </Group>
+      </Group>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewHeroKpis.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewHeroKpis.tsx
new file mode 100644
index 000000000..e076b1f18
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewHeroKpis.tsx
@@ -0,0 +1,83 @@
+import { Banknote, FileSignature, FileText, Package } from "lucide-react";
+
+import { KpiStrip, type KpiItem } from "@/components/page";
+import type { IOverviewKpis, IOverviewPeriodTotals } from "@/types/overview";
+import { CountUp } from "./CountUp";
+
+function formatCurrency(amount: number, currency: "ETB" | "USD") {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency,
+    maximumFractionDigits: 0,
+  }).format(amount);
+}
+
+/** Compact form ("ETB 58.6M") — the hero cell is too narrow for nine digits. */
+function formatCompactCurrency(amount: number, currency: "ETB" | "USD") {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency,
+    notation: "compact",
+    maximumFractionDigits: 1,
+  }).format(amount);
+}
+
+/** Period-over-period % change, or undefined when there's no prior baseline to compare against. */
+function pctDelta(current: number, previous: number): number | undefined {
+  if (previous === 0) return undefined;
+  return Math.round(((current - previous) / previous) * 100);
+}
+
+interface OverviewHeroKpisProps {
+  kpis: IOverviewKpis;
+  current: IOverviewPeriodTotals;
+  previous: IOverviewPeriodTotals;
+  rangeLabel: string;
+}
+
+/**
+ * The four numbers an executive reads first: money and volume for the
+ * selected range, plus what's currently in flight. Revenue and cargo carry a
+ * real vs-prior-period delta; the two workflow snapshots don't, because
+ * "active bookings/contracts" is a point-in-time gauge, not a period total —
+ * showing a delta for it would mean inventing a comparison that isn't real.
+ */
+export function OverviewHeroKpis({ kpis, current, previous, rangeLabel }: OverviewHeroKpisProps) {
+  const items: KpiItem[] = [
+    // An API deployed before the overview revamp omits the period totals —
+    // drop the two tiles that need them rather than crash (or hide the strip).
+    ...(current
+      ? [
+          {
+            label: `Revenue (${rangeLabel})`,
+            value: <CountUp value={current.revenueEtb} format={(n) => formatCompactCurrency(n, "ETB")} />,
+            hint: formatCurrency(current.revenueUsd, "USD"),
+            icon: Banknote,
+            color: "yellow",
+            delta: pctDelta(current.revenueEtb, previous?.revenueEtb ?? 0),
+          },
+          {
+            label: "Cargo moved",
+            value: <CountUp value={current.tons} format={(n) => `${Math.round(n).toLocaleString()} t`} />,
+            icon: Package,
+            color: "edr-green",
+            delta: pctDelta(current.tons, previous?.tons ?? 0),
+          },
+        ]
+      : []),
+    {
+      label: "Active bookings",
+      value: <CountUp value={kpis.bookings.totalActive} />,
+      icon: FileText,
+      color: "edr-green",
+    },
+    {
+      label: "Active contracts",
+      value: <CountUp value={kpis.contracts.totalActive} />,
+      icon: FileSignature,
+      color: "edr-green",
+    },
+  ];
+
+  return <KpiStrip items={items} />;
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewNetworkCard.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewNetworkCard.tsx
new file mode 100644
index 000000000..9c9bef563
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewNetworkCard.tsx
@@ -0,0 +1,91 @@
+import {
+  CalendarClock,
+  Container as ContainerIcon,
+  Send,
+  Train,
+  TrainFront,
+} from "lucide-react";
+import { Group, SimpleGrid, Stack, Text } from "@mantine/core";
+
+import { MiniRing } from "@/components/common/MiniGraph";
+import type { IOverviewOperationsKpis } from "@/types/overview";
+import { CountUp } from "./CountUp";
+import { SummaryCard } from "./SummaryCard";
+
+const STATS: Array<{
+  key: keyof IOverviewOperationsKpis;
+  label: string;
+  icon: typeof Train;
+}> = [
+  { key: "trainsActive", label: "Trains active", icon: Train },
+  { key: "dispatchedToday", label: "Dispatched today", icon: Send },
+  { key: "schedulesUpcoming", label: "Upcoming departures", icon: CalendarClock },
+  { key: "containersInTransit", label: "Containers in transit", icon: ContainerIcon },
+];
+
+/** Network snapshot: four operational stats plus real wagon-utilization (available / total), not a decorative gauge. */
+export function OverviewNetworkCard({ kpis }: { kpis: IOverviewOperationsKpis }) {
+  // An API deployed before the overview revamp omits the wagon counters.
+  const wagonsTotal = kpis.wagonsTotal ?? 0;
+  const wagonsAvailable = kpis.wagonsAvailable ?? 0;
+  const utilizationPct = wagonsTotal > 0 ? (wagonsAvailable / wagonsTotal) * 100 : null;
+
+  return (
+    <SummaryCard
+      icon={TrainFront}
+      accent="edr-green"
+      title="Network"
+      subtitle="Fleet and movement, right now"
+      to="/dashboard/overview/fleet"
+      action={
+        <Text size="xs" fw={600} c="edr-green" style={{ whiteSpace: "nowrap" }}>
+          View fleet →
+        </Text>
+      }
+    >
+      <Stack gap="sm">
+        <Group align="center" gap="lg" className="ov-inset" p={14} wrap="nowrap">
+          <MiniRing pct={utilizationPct} accent="emerald" size={76} stroke={8}>
+            <Text size="16px" fw={800} lh={1}>
+              {utilizationPct != null ? `${Math.round(utilizationPct)}%` : "—"}
+            </Text>
+          </MiniRing>
+          <Stack gap={2}>
+            <Text size="xs" fw={700} tt="uppercase" c="dimmed" style={{ letterSpacing: 0.3 }}>
+              Wagons available
+            </Text>
+            <Text fw={800} fz={22} lh={1.1}>
+              {wagonsAvailable.toLocaleString()}
+              <Text component="span" fz="sm" fw={600} c="dimmed">
+                {" "}
+                / {wagonsTotal.toLocaleString()}
+              </Text>
+            </Text>
+          </Stack>
+        </Group>
+
+        <SimpleGrid cols={2} spacing="sm">
+          {STATS.map((stat) => {
+            const Icon = stat.icon;
+            return (
+              <Group key={stat.label} gap={10} wrap="nowrap" className="ov-inset" p={12}>
+                <Icon
+                  size={18}
+                  style={{ flexShrink: 0, color: "var(--mantine-color-edr-green-6)" }}
+                />
+                <Stack gap={0} style={{ minWidth: 0 }}>
+                  <Text fw={800} fz="lg" lh={1.15}>
+                    <CountUp value={kpis[stat.key] ?? 0} />
+                  </Text>
+                  <Text size="xs" c="dimmed" truncate>
+                    {stat.label}
+                  </Text>
+                </Stack>
+              </Group>
+            );
+          })}
+        </SimpleGrid>
+      </Stack>
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewPipelineFunnel.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewPipelineFunnel.tsx
new file mode 100644
index 000000000..a1c18c281
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewPipelineFunnel.tsx
@@ -0,0 +1,113 @@
+import { Filter } from "lucide-react";
+import { Link } from "react-router-dom";
+import { Badge, Stack, Text } from "@mantine/core";
+
+import { BOOKING_LIST_TABS } from "@/features/bookings/booking-status.config";
+import type { IOverviewPipelineCount } from "@/types/overview";
+import { SummaryCard } from "./SummaryCard";
+
+/** Sequential green ramp from the theme's own edr-green scale — rising intensity as bookings progress through the pipeline. */
+const RAMP_SHADES = [3, 4, 5, 5, 6, 6, 7, 8, 9];
+
+interface OverviewPipelineFunnelProps {
+  data: IOverviewPipelineCount[];
+}
+
+/** Booking pipeline by stage, in workflow order. Each row deep-links to the exact statuses it represents. */
+export function OverviewPipelineFunnel({ data = [] }: OverviewPipelineFunnelProps) {
+  const rows = data
+    .map((item) => ({
+      ...item,
+      tab: BOOKING_LIST_TABS.find((t) => t.key === item.stage),
+    }))
+    .filter((row) => row.tab);
+  const maxCount = Math.max(1, ...rows.map((r) => r.count));
+  const total = rows.reduce((sum, r) => sum + r.count, 0);
+  const hasData = total > 0;
+
+  return (
+    <SummaryCard
+      icon={Filter}
+      accent="edr-green"
+      title="Booking pipeline"
+      subtitle="Every row opens the exact filtered list"
+      action={
+        hasData ? (
+          <Badge variant="light" color="edr-green" size="sm" style={{ textTransform: "none" }}>
+            {total.toLocaleString()} in pipeline
+          </Badge>
+        ) : null
+      }
+    >
+      {!hasData ? (
+        <Text size="sm" c="dimmed" ta="center" py="xl">
+          No bookings in pipeline
+        </Text>
+      ) : (
+        <Stack gap={4}>
+          {rows.map((row, index) => {
+            const statuses = row.tab?.statuses;
+            const href = statuses?.length
+              ? `/dashboard/booking-requests?statuses=${statuses.join(",")}`
+              : "/dashboard/booking-requests";
+            const shade = RAMP_SHADES[Math.min(index, RAMP_SHADES.length - 1)];
+
+            return (
+              <Link
+                key={row.stage}
+                to={href}
+                className="ov-row"
+                style={{
+                  display: "flex",
+                  alignItems: "center",
+                  gap: 12,
+                  textDecoration: "none",
+                  padding: "7px 10px",
+                }}
+              >
+                <Text size="sm" fw={500} c="edr-text" style={{ width: 140, flexShrink: 0 }} truncate>
+                  {row.tab?.label ?? row.stage}
+                </Text>
+                <div
+                  style={{
+                    flex: 1,
+                    height: 20,
+                    borderRadius: 999,
+                    background: "var(--mantine-color-gray-1)",
+                    overflow: "hidden",
+                  }}
+                >
+                  <div
+                    style={{
+                      width: `${(row.count / maxCount) * 100}%`,
+                      height: "100%",
+                      borderRadius: 999,
+                      background: `linear-gradient(90deg, var(--mantine-color-edr-green-${Math.max(shade - 2, 1)}), var(--mantine-color-edr-green-${shade}))`,
+                      transition: "width 300ms ease",
+                    }}
+                  />
+                </div>
+                <Text
+                  size="sm"
+                  fw={700}
+                  ta="center"
+                  style={{
+                    minWidth: 44,
+                    flexShrink: 0,
+                    background: "var(--mantine-color-gray-0)",
+                    border: "1px solid var(--mantine-color-gray-2)",
+                    borderRadius: 999,
+                    padding: "1px 8px",
+                    fontVariantNumeric: "tabular-nums",
+                  }}
+                >
+                  {row.count}
+                </Text>
+              </Link>
+            );
+          })}
+        </Stack>
+      )}
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewRevenueMix.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewRevenueMix.tsx
new file mode 100644
index 000000000..0603ac095
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewRevenueMix.tsx
@@ -0,0 +1,143 @@
+import { PieChart } from "lucide-react";
+import { Stack, Text } from "@mantine/core";
+
+import type { IOverviewRevenueSlice } from "@/types/overview";
+import { DIRECTION_COLORS, FLOW_FALLBACK_COLOR, FREIGHT_TYPE_COLORS } from "./flow-colors";
+import { CountUp } from "./CountUp";
+import { SummaryCard } from "./SummaryCard";
+
+function formatEtb(amount: number) {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "ETB",
+    maximumFractionDigits: 0,
+  }).format(amount);
+}
+
+const DIRECTION_LABELS: Record<string, string> = {
+  IMPORT: "Import",
+  EXPORT: "Export",
+  DOMESTIC: "Domestic",
+};
+
+const FREIGHT_TYPE_LABELS: Record<string, string> = {
+  CONTAINER: "Container",
+  BULK: "Bulk",
+};
+
+/** One breakdown's proportion bar + legend, sized by ETB revenue (no FX rate exists to fold USD in). */
+function MixRow({
+  title,
+  slices,
+  labels,
+  colors,
+}: {
+  title: string;
+  slices: IOverviewRevenueSlice[];
+  labels: Record<string, string>;
+  colors: Record<string, string>;
+}) {
+  const total = slices.reduce((sum, s) => sum + s.amountEtb, 0);
+
+  return (
+    <Stack gap={8} className="ov-inset" p={12}>
+      <Text size="xs" fw={700} tt="uppercase" c="dimmed" style={{ letterSpacing: 0.3 }}>
+        {title}
+      </Text>
+      {total === 0 ? (
+        <Text size="sm" c="dimmed">
+          No revenue in this period
+        </Text>
+      ) : (
+        <>
+          <div
+            style={{
+              display: "flex",
+              height: 12,
+              borderRadius: 999,
+              overflow: "hidden",
+              gap: 2,
+            }}
+          >
+            {slices
+              .filter((s) => s.amountEtb > 0)
+              .map((s) => (
+                <div
+                  key={s.label}
+                  style={{
+                    width: `${(s.amountEtb / total) * 100}%`,
+                    background: colors[s.label] ?? FLOW_FALLBACK_COLOR,
+                    borderRadius: 999,
+                  }}
+                />
+              ))}
+          </div>
+          <Stack gap={4}>
+            {slices
+              .filter((s) => s.amountEtb > 0)
+              .map((s) => (
+                <div
+                  key={s.label}
+                  style={{ display: "flex", alignItems: "center", gap: 8, fontSize: 12 }}
+                >
+                  <span
+                    style={{
+                      width: 8,
+                      height: 8,
+                      borderRadius: 999,
+                      flexShrink: 0,
+                      background: colors[s.label] ?? FLOW_FALLBACK_COLOR,
+                    }}
+                  />
+                  <span style={{ flex: 1, color: "var(--mantine-color-edr-muted-6)" }}>
+                    {labels[s.label] ?? s.label}
+                  </span>
+                  <span style={{ fontWeight: 600 }}>{formatEtb(s.amountEtb)}</span>
+                  <span style={{ color: "var(--mantine-color-edr-muted-6)", minWidth: 32, textAlign: "right" }}>
+                    {Math.round((s.amountEtb / total) * 100)}%
+                  </span>
+                </div>
+              ))}
+          </Stack>
+        </>
+      )}
+    </Stack>
+  );
+}
+
+interface OverviewRevenueMixProps {
+  byDirection: IOverviewRevenueSlice[];
+  byFreightType: IOverviewRevenueSlice[];
+}
+
+/** ETB revenue split two ways — trade direction and freight type — anchored by the range total. */
+export function OverviewRevenueMix({ byDirection = [], byFreightType = [] }: OverviewRevenueMixProps) {
+  const total = byDirection.reduce((sum, s) => sum + s.amountEtb, 0);
+
+  return (
+    <SummaryCard icon={PieChart} accent="yellow" title="Revenue mix" subtitle="ETB, selected range">
+      <Stack gap="md">
+        <div>
+          <Text fw={800} fz={24} lh={1.1} style={{ letterSpacing: "-0.02em" }}>
+            <CountUp value={total} format={formatEtb} />
+          </Text>
+          <Text size="xs" c="dimmed">
+            attributed to a trade direction
+          </Text>
+        </div>
+        <MixRow
+          title="By trade direction"
+          slices={byDirection}
+          labels={DIRECTION_LABELS}
+          colors={DIRECTION_COLORS}
+        />
+        <MixRow
+          title="By freight type"
+          slices={byFreightType}
+          labels={FREIGHT_TYPE_LABELS}
+          colors={FREIGHT_TYPE_COLORS}
+        />
+      </Stack>
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewRevenueVolumeChart.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewRevenueVolumeChart.tsx
new file mode 100644
index 000000000..04a359e92
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewRevenueVolumeChart.tsx
@@ -0,0 +1,172 @@
+import {
+  Area,
+  Bar,
+  CartesianGrid,
+  ComposedChart,
+  Line,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis,
+} from "recharts";
+import { ChartColumnBig } from "lucide-react";
+import { Group, Text } from "@mantine/core";
+
+import type { IOverviewPaymentTrendPoint, IOverviewTrendPoint } from "@/types/overview";
+import { overviewChartColors } from "../overview.styles";
+import { chartAxisTick, chartGridStroke, chartTooltipStyle } from "./chart-style";
+import { mergeTrend } from "./mergeTrend";
+import { SummaryCard } from "./SummaryCard";
+
+function formatDateLabel(date: string) {
+  return new Date(`${date}T00:00:00`).toLocaleDateString(undefined, {
+    month: "short",
+    day: "numeric",
+  });
+}
+
+function formatEtb(amount: number) {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "ETB",
+    maximumFractionDigits: 0,
+  }).format(amount);
+}
+
+const compact = new Intl.NumberFormat("en-US", { notation: "compact" });
+
+/** Dot-and-label legend row rendered in the card header instead of recharts' default. */
+function LegendDot({ color, dashed, label }: { color: string; dashed?: boolean; label: string }) {
+  return (
+    <Group gap={5} wrap="nowrap">
+      {dashed ? (
+        <svg width={14} height={4} aria-hidden>
+          <line x1={0} y1={2} x2={14} y2={2} stroke={color} strokeWidth={2} strokeDasharray="3 2" />
+        </svg>
+      ) : (
+        <span style={{ width: 8, height: 8, borderRadius: 999, background: color }} />
+      )}
+      <Text size="xs" c="dimmed">
+        {label}
+      </Text>
+    </Group>
+  );
+}
+
+interface OverviewRevenueVolumeChartProps {
+  bookingTrend: IOverviewTrendPoint[];
+  paymentTrend: IOverviewPaymentTrendPoint[];
+  previousPaymentTrend: IOverviewPaymentTrendPoint[];
+  rangeDays: number;
+}
+
+/**
+ * Volume and money in one read: bars are bookings created per day, the gold
+ * area is ETB revenue per day, and the dashed ghost line is the preceding
+ * period's revenue shifted onto the same axis — "are we pacing ahead of last
+ * period" at a glance.
+ */
+export function OverviewRevenueVolumeChart({
+  bookingTrend = [],
+  paymentTrend = [],
+  previousPaymentTrend = [],
+  rangeDays,
+}: OverviewRevenueVolumeChartProps) {
+  const data = mergeTrend(bookingTrend, paymentTrend, previousPaymentTrend, rangeDays);
+  const hasData = data.some((point) => point.bookings > 0 || point.revenueEtb > 0);
+
+  return (
+    <SummaryCard
+      icon={ChartColumnBig}
+      accent="yellow"
+      title="Bookings & revenue"
+      subtitle="Daily volume vs ETB revenue"
+      action={
+        <Group gap="md" wrap="nowrap">
+          <LegendDot color="var(--mantine-color-edr-green-4)" label="Bookings" />
+          <LegendDot color={overviewChartColors.primary} label="Revenue" />
+          <LegendDot color="var(--mantine-color-gray-5)" dashed label="Prev period" />
+        </Group>
+      }
+    >
+      {!hasData ? (
+          <Text size="sm" c="dimmed" ta="center" py="xl">
+            No activity in this period
+          </Text>
+        ) : (
+          <ResponsiveContainer width="100%" height={280}>
+            <ComposedChart data={data} margin={{ top: 8, right: 4, left: 0, bottom: 0 }}>
+              <defs>
+                <linearGradient id="ov-revenue-fill" x1="0" y1="0" x2="0" y2="1">
+                  <stop offset="0%" stopColor={overviewChartColors.primary} stopOpacity={0.22} />
+                  <stop offset="100%" stopColor={overviewChartColors.primary} stopOpacity={0} />
+                </linearGradient>
+              </defs>
+              <CartesianGrid vertical={false} stroke={chartGridStroke} />
+              <XAxis
+                dataKey="date"
+                tickFormatter={formatDateLabel}
+                tick={chartAxisTick}
+                axisLine={false}
+                tickLine={false}
+                minTickGap={24}
+              />
+              <YAxis
+                yAxisId="bookings"
+                allowDecimals={false}
+                tick={chartAxisTick}
+                axisLine={false}
+                tickLine={false}
+                width={32}
+              />
+              <YAxis
+                yAxisId="revenue"
+                orientation="right"
+                tickFormatter={(value) => compact.format(Number(value))}
+                tick={chartAxisTick}
+                axisLine={false}
+                tickLine={false}
+                width={44}
+              />
+              <Tooltip
+                labelFormatter={(value) => formatDateLabel(String(value))}
+                formatter={(value, name) =>
+                  name === "Bookings" ? [value, name] : [formatEtb(Number(value)), name]
+                }
+                contentStyle={chartTooltipStyle}
+              />
+              <Bar
+                yAxisId="bookings"
+                dataKey="bookings"
+                name="Bookings"
+                fill="var(--mantine-color-edr-green-4)"
+                radius={[5, 5, 0, 0]}
+                barSize={14}
+              />
+              <Line
+                yAxisId="revenue"
+                type="monotone"
+                dataKey="prevRevenueEtb"
+                name="Prev period"
+                stroke="var(--mantine-color-gray-5)"
+                strokeWidth={1.5}
+                strokeDasharray="5 4"
+                dot={false}
+              />
+              <Area
+                yAxisId="revenue"
+                type="monotone"
+                dataKey="revenueEtb"
+                name="Revenue"
+                stroke={overviewChartColors.primary}
+                strokeWidth={2.5}
+                fill="url(#ov-revenue-fill)"
+                dot={false}
+                activeDot={{ r: 4 }}
+              />
+            </ComposedChart>
+        </ResponsiveContainer>
+      )}
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewSankeyFlow.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewSankeyFlow.tsx
new file mode 100644
index 000000000..b7974ea48
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/OverviewSankeyFlow.tsx
@@ -0,0 +1,170 @@
+import { Waypoints } from "lucide-react";
+import { ResponsiveContainer, Sankey, Tooltip, type SankeyLinkProps } from "recharts";
+import { Text } from "@mantine/core";
+
+import type { IOverviewRevenueFlow } from "@/types/overview";
+import { chartTooltipStyle } from "./chart-style";
+import { SummaryCard } from "./SummaryCard";
+import {
+  DIRECTION_COLORS,
+  FLOW_FALLBACK_COLOR,
+  FLOW_LABELS,
+  FREIGHT_TYPE_COLORS,
+} from "./flow-colors";
+
+function formatEtb(amount: number) {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "ETB",
+    maximumFractionDigits: 0,
+  }).format(amount);
+}
+
+interface SankeyNodeDatum {
+  name: string;
+  key: string;
+  color: string;
+}
+
+/** Build recharts Sankey data: direction nodes on the left, freight types on the right. */
+function toSankeyData(flows: IOverviewRevenueFlow[]) {
+  const active = flows.filter((f) => f.amountEtb > 0);
+  const nodes: SankeyNodeDatum[] = [];
+  const indexByKey = new Map<string, number>();
+  const nodeIndex = (key: string, color: string) => {
+    const existing = indexByKey.get(key);
+    if (existing != null) return existing;
+    nodes.push({ name: FLOW_LABELS[key] ?? key, key, color });
+    indexByKey.set(key, nodes.length - 1);
+    return nodes.length - 1;
+  };
+
+  // Register directions first so they all land on the left column.
+  for (const flow of active) {
+    nodeIndex(flow.direction, DIRECTION_COLORS[flow.direction] ?? FLOW_FALLBACK_COLOR);
+  }
+  const links = active.map((flow) => ({
+    source: indexByKey.get(flow.direction)!,
+    target: nodeIndex(
+      flow.freightType,
+      FREIGHT_TYPE_COLORS[flow.freightType] ?? FLOW_FALLBACK_COLOR,
+    ),
+    value: flow.amountEtb,
+  }));
+
+  return { nodes, links };
+}
+
+function FlowNode({
+  x,
+  y,
+  width,
+  height,
+  index,
+  payload,
+}: {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  index: number;
+  payload: { name?: string; value?: number; color?: string };
+}) {
+  // Labels sit to the right of every bar: the right margin reserves room for
+  // the last column, and the pale ribbons stay readable under the left one.
+  return (
+    <g key={`node-${index}`}>
+      <rect x={x} y={y} width={width} height={height} fill={payload.color} rx={3} />
+      <text
+        x={x + width + 8}
+        y={y + height / 2 - 6}
+        textAnchor="start"
+        dominantBaseline="central"
+        fontSize={12}
+        fontWeight={600}
+        fill="#1f2937"
+      >
+        {payload.name}
+      </text>
+      <text
+        x={x + width + 8}
+        y={y + height / 2 + 9}
+        textAnchor="start"
+        dominantBaseline="central"
+        fontSize={11}
+        fill="var(--mantine-color-gray-6)"
+      >
+        {formatEtb(payload.value ?? 0)}
+      </text>
+    </g>
+  );
+}
+
+/** Ribbon tinted by its source direction — the corridor keeps its color across the chart. */
+function FlowLink({
+  sourceX,
+  targetX,
+  sourceY,
+  targetY,
+  sourceControlX,
+  targetControlX,
+  linkWidth,
+  index,
+  payload,
+}: SankeyLinkProps) {
+  // Custom node fields (color) ride along on the layout node recharts hands back.
+  const source = payload.source as { color?: string };
+  return (
+    <path
+      key={`link-${index}`}
+      d={`M${sourceX},${sourceY} C${sourceControlX},${sourceY} ${targetControlX},${targetY} ${targetX},${targetY}`}
+      fill="none"
+      stroke={source.color ?? FLOW_FALLBACK_COLOR}
+      strokeOpacity={0.3}
+      strokeWidth={linkWidth}
+    />
+  );
+}
+
+interface OverviewSankeyFlowProps {
+  flows: IOverviewRevenueFlow[];
+}
+
+/**
+ * Where the money runs: ETB revenue as ribbons from trade direction to
+ * freight type. Ribbon thickness is proportional to revenue, so the biggest
+ * corridor is unmissable.
+ */
+export function OverviewSankeyFlow({ flows = [] }: OverviewSankeyFlowProps) {
+  const data = toSankeyData(flows);
+
+  return (
+    <SummaryCard
+      icon={Waypoints}
+      accent="sky"
+      title="Revenue flow"
+      subtitle="Trade direction → freight type, sized by ETB revenue"
+    >
+      {data.links.length === 0 ? (
+        <Text size="sm" c="dimmed" ta="center" py="xl">
+          No revenue in this period
+        </Text>
+      ) : (
+        <ResponsiveContainer width="100%" height={252}>
+          <Sankey
+            data={data}
+            node={FlowNode}
+            link={FlowLink}
+            nodePadding={32}
+            margin={{ top: 20, right: 96, bottom: 12, left: 4 }}
+          >
+            <Tooltip
+              formatter={(value) => formatEtb(Number(value))}
+              contentStyle={chartTooltipStyle}
+            />
+          </Sankey>
+        </ResponsiveContainer>
+      )}
+    </SummaryCard>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/SummaryCard.tsx b/apps/edr-freight-web/backoffice/src/components/overview/summary/SummaryCard.tsx
new file mode 100644
index 000000000..cfd022fe9
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/SummaryCard.tsx
@@ -0,0 +1,65 @@
+import type { LucideIcon } from "lucide-react";
+import { Group, Stack, Text, ThemeIcon } from "@mantine/core";
+import type { ElementType, ReactNode } from "react";
+import { Link } from "react-router-dom";
+
+import "./overview-summary.css";
+
+interface SummaryCardProps {
+  icon: LucideIcon;
+  /** Mantine color for the icon chip. */
+  accent?: string;
+  title: string;
+  subtitle?: string;
+  /** Right side of the header — a legend, badge, or link. */
+  action?: ReactNode;
+  /** Makes the whole card a link (adds the hover lift). */
+  to?: string;
+  minHeight?: number;
+  children: ReactNode;
+}
+
+/**
+ * Shared chrome for every overview card: soft gradient surface, layered
+ * shadow, icon-chip header with title/subtitle, optional action slot.
+ * One look for the whole page instead of eight flat white boxes.
+ */
+export function SummaryCard({
+  icon: Icon,
+  accent = "edr-green",
+  title,
+  subtitle,
+  action,
+  to,
+  minHeight = 340,
+  children,
+}: SummaryCardProps) {
+  const Root: ElementType = to ? Link : "div";
+  return (
+    <Root
+      {...(to ? { to } : {})}
+      className={to ? "ov-card ov-card--link" : "ov-card"}
+      style={{ minHeight }}
+    >
+      <Group justify="space-between" align="flex-start" wrap="nowrap" mb="md" gap="sm">
+        <Group gap={12} wrap="nowrap" style={{ minWidth: 0 }}>
+          <ThemeIcon variant="light" color={accent} size={38} radius={12} style={{ flexShrink: 0 }}>
+            <Icon size={20} />
+          </ThemeIcon>
+          <Stack gap={1} style={{ minWidth: 0 }}>
+            <Text fw={700} lh={1.25} c="edr-text" truncate>
+              {title}
+            </Text>
+            {subtitle ? (
+              <Text size="xs" c="dimmed" truncate>
+                {subtitle}
+              </Text>
+            ) : null}
+          </Stack>
+        </Group>
+        {action}
+      </Group>
+      {children}
+    </Root>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/chart-style.ts b/apps/edr-freight-web/backoffice/src/components/overview/summary/chart-style.ts
new file mode 100644
index 000000000..9f7dbae8d
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/chart-style.ts
@@ -0,0 +1,14 @@
+import type { CSSProperties } from "react";
+
+/** Shared recharts styling for the overview summary charts. */
+export const chartGridStroke = "#EEF1F5";
+
+export const chartAxisTick = { fontSize: 11, fill: "#8fa0b2" } as const;
+
+export const chartTooltipStyle: CSSProperties = {
+  borderRadius: 12,
+  border: "1px solid #EEF1F5",
+  boxShadow: "0 8px 24px rgba(16, 32, 47, 0.1)",
+  fontSize: 12,
+  padding: "8px 12px",
+};
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/flow-colors.ts b/apps/edr-freight-web/backoffice/src/components/overview/summary/flow-colors.ts
new file mode 100644
index 000000000..f3c7a2ace
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/flow-colors.ts
@@ -0,0 +1,25 @@
+/**
+ * Fixed colors + labels for trade directions and freight types, shared by the
+ * revenue mix and Sankey so the same entity is always the same color (and
+ * matches the operations departure chart's direction hexes).
+ */
+export const DIRECTION_COLORS: Record<string, string> = {
+  EXPORT: "#D98A0B",
+  IMPORT: "#0369a1",
+  DOMESTIC: "#7c3aed",
+};
+
+export const FREIGHT_TYPE_COLORS: Record<string, string> = {
+  CONTAINER: "#1B9E7A",
+  BULK: "#34D9AE",
+};
+
+export const FLOW_LABELS: Record<string, string> = {
+  IMPORT: "Import",
+  EXPORT: "Export",
+  DOMESTIC: "Domestic",
+  CONTAINER: "Container",
+  BULK: "Bulk",
+};
+
+export const FLOW_FALLBACK_COLOR = "#94a3b8";
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/mergeTrend.test.ts b/apps/edr-freight-web/backoffice/src/components/overview/summary/mergeTrend.test.ts
new file mode 100644
index 000000000..369b19237
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/mergeTrend.test.ts
@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+
+import { mergeTrend } from "./mergeTrend";
+
+describe("mergeTrend", () => {
+  it("unions dates from both trends, zero-filling the side that has no row", () => {
+    const result = mergeTrend(
+      [
+        { date: "2026-06-01", count: 3 },
+        { date: "2026-06-02", count: 5 },
+      ],
+      [{ date: "2026-06-02", amountEtb: 1000, amountUsd: 0 }],
+    );
+
+    expect(result).toEqual([
+      { date: "2026-06-01", bookings: 3, revenueEtb: 0 },
+      { date: "2026-06-02", bookings: 5, revenueEtb: 1000 },
+    ]);
+  });
+
+  it("sorts chronologically regardless of input order", () => {
+    const result = mergeTrend(
+      [{ date: "2026-06-03", count: 1 }],
+      [{ date: "2026-06-01", amountEtb: 500, amountUsd: 0 }],
+    );
+
+    expect(result.map((p) => p.date)).toEqual(["2026-06-01", "2026-06-03"]);
+  });
+
+  it("returns an empty series when both trends are empty", () => {
+    expect(mergeTrend([], [])).toEqual([]);
+  });
+
+  it("shifts the previous period forward so day N lands on day N of the current window", () => {
+    const result = mergeTrend(
+      [{ date: "2026-06-08", count: 2 }],
+      [],
+      [
+        // 7d range: 2026-06-01 + 7 = 2026-06-08 (existing row), 06-02 + 7 = 06-09 (new row)
+        { date: "2026-06-01", amountEtb: 400, amountUsd: 0 },
+        { date: "2026-06-02", amountEtb: 250, amountUsd: 0 },
+      ],
+      7,
+    );
+
+    expect(result).toEqual([
+      { date: "2026-06-08", bookings: 2, revenueEtb: 0, prevRevenueEtb: 400 },
+      { date: "2026-06-09", bookings: 0, revenueEtb: 0, prevRevenueEtb: 250 },
+    ]);
+  });
+
+  it("shifts across a month boundary without timezone drift", () => {
+    const result = mergeTrend([], [], [{ date: "2026-05-28", amountEtb: 100, amountUsd: 0 }], 7);
+    expect(result[0].date).toBe("2026-06-04");
+  });
+});
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/mergeTrend.ts b/apps/edr-freight-web/backoffice/src/components/overview/summary/mergeTrend.ts
new file mode 100644
index 000000000..0ddc0d705
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/mergeTrend.ts
@@ -0,0 +1,63 @@
+import type { IOverviewPaymentTrendPoint, IOverviewTrendPoint } from "@/types/overview";
+
+export interface RevenueVolumePoint {
+  date: string;
+  bookings: number;
+  revenueEtb: number;
+  /** Same-offset day of the preceding period — the ghost comparison line. */
+  prevRevenueEtb?: number;
+}
+
+/** `date` (YYYY-MM-DD) plus `days` days, in UTC so no DST/timezone drift. */
+export function shiftDate(date: string, days: number): string {
+  const parsed = new Date(`${date}T00:00:00Z`);
+  parsed.setUTCDate(parsed.getUTCDate() + days);
+  return parsed.toISOString().slice(0, 10);
+}
+
+/**
+ * Merge the booking-count trend and the payment trend into one date-keyed
+ * series for the combined volume/revenue chart. Both trends only carry rows
+ * for days with activity (no zero-filled gaps), so this unions the dates
+ * rather than assuming they line up.
+ *
+ * When the previous period's payment trend is provided, each of its days is
+ * shifted forward by `shiftDays` (the range length) so day N of the prior
+ * window lands on day N of the current one, and lands in `prevRevenueEtb`.
+ */
+export function mergeTrend(
+  bookingTrend: IOverviewTrendPoint[],
+  paymentTrend: IOverviewPaymentTrendPoint[],
+  previousPaymentTrend: IOverviewPaymentTrendPoint[] = [],
+  shiftDays = 0,
+): RevenueVolumePoint[] {
+  const byDate = new Map<string, RevenueVolumePoint>();
+
+  for (const point of bookingTrend) {
+    byDate.set(point.date, { date: point.date, bookings: point.count, revenueEtb: 0 });
+  }
+  for (const point of paymentTrend) {
+    const existing = byDate.get(point.date);
+    if (existing) {
+      existing.revenueEtb = point.amountEtb;
+    } else {
+      byDate.set(point.date, { date: point.date, bookings: 0, revenueEtb: point.amountEtb });
+    }
+  }
+  for (const point of previousPaymentTrend) {
+    const date = shiftDate(point.date, shiftDays);
+    const existing = byDate.get(date);
+    if (existing) {
+      existing.prevRevenueEtb = point.amountEtb;
+    } else {
+      byDate.set(date, {
+        date,
+        bookings: 0,
+        revenueEtb: 0,
+        prevRevenueEtb: point.amountEtb,
+      });
+    }
+  }
+
+  return [...byDate.values()].sort((a, b) => a.date.localeCompare(b.date));
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/summary/overview-summary.css b/apps/edr-freight-web/backoffice/src/components/overview/summary/overview-summary.css
new file mode 100644
index 000000000..0391010b8
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/overview/summary/overview-summary.css
@@ -0,0 +1,65 @@
+/* Staggered fade-up entrance for the overview bands. Delay is set inline per
+   band; disabled entirely for reduced-motion users. */
+.ov-band {
+  animation: ov-rise 420ms ease-out both;
+}
+
+@keyframes ov-rise {
+  from {
+    opacity: 0;
+    transform: translateY(14px);
+  }
+  to {
+    opacity: 1;
+    transform: none;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-band {
+    animation: none;
+  }
+}
+
+/* ---- Shared card chrome (SummaryCard) ---- */
+.ov-card {
+  display: block;
+  height: 100%;
+  background: linear-gradient(180deg, #ffffff 0%, #fbfdfc 100%);
+  border: 1px solid var(--mantine-color-edr-border-0);
+  border-radius: 20px;
+  padding: 20px;
+  color: inherit;
+  text-decoration: none;
+  box-shadow:
+    0 1px 2px rgba(16, 32, 47, 0.04),
+    0 12px 32px -18px rgba(16, 32, 47, 0.14);
+  transition:
+    box-shadow 180ms ease,
+    transform 180ms ease,
+    border-color 180ms ease;
+}
+/* The lift is a click affordance — only linked cards get it. */
+.ov-card--link:hover {
+  box-shadow:
+    0 2px 4px rgba(16, 32, 47, 0.05),
+    0 20px 44px -18px rgba(16, 32, 47, 0.2);
+  border-color: var(--mantine-color-edr-green-2);
+  transform: translateY(-2px);
+}
+
+/* Soft inset panel for grouping content inside a card. */
+.ov-inset {
+  background: var(--mantine-color-gray-0);
+  border: 1px solid var(--mantine-color-gray-1);
+  border-radius: 14px;
+}
+
+/* Interactive list row inside a card. */
+.ov-row {
+  border-radius: 12px;
+  transition: background 140ms ease;
+}
+.ov-row:hover {
+  background: var(--mantine-color-gray-0);
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewBookingsTabPanel.tsx b/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewBookingsTabPanel.tsx
index cacba63e1..696741873 100644
--- a/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewBookingsTabPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewBookingsTabPanel.tsx
@@ -59,12 +59,6 @@ export function OverviewBookingsTabPanel({ data }: OverviewBookingsTabPanelProps
             accent: "sky",
             hint: "Pending sign-off",
           },
-          {
-            label: "Submitted today",
-            value: data.kpis.submittedToday,
-            icon: FileText,
-            hint: "New since midnight",
-          },
         ]}
       />
 
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewContractsTabPanel.tsx b/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewContractsTabPanel.tsx
index e185f40d2..9265da37d 100644
--- a/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewContractsTabPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewContractsTabPanel.tsx
@@ -76,12 +76,6 @@ export function OverviewContractsTabPanel({
             accent: "rose",
             hint: "Customs / documents",
           },
-          {
-            label: "Created today",
-            value: data.kpis.createdToday,
-            icon: FileSignature,
-            hint: "New since midnight",
-          },
         ]}
       />
 
diff --git a/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewOperationsTabPanel.tsx b/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewOperationsTabPanel.tsx
index 675a81b32..b335ccf9c 100644
--- a/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewOperationsTabPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/overview/tabs/OverviewOperationsTabPanel.tsx
@@ -1,5 +1,4 @@
 import {
-  Box,
   CalendarClock,
   Container as ContainerIcon,
   Send,
@@ -78,11 +77,6 @@ export function OverviewOperationsTabPanel({ data }: OverviewOperationsTabPanelP
             value: data.kpis.containersInTransit,
             icon: ContainerIcon,
           },
-          {
-            label: "Cargoes loaded",
-            value: data.kpis.cargoesLoaded,
-            icon: Box,
-          },
         ]}
       />
 
diff --git a/apps/edr-freight-web/backoffice/src/components/page/KpiStrip.tsx b/apps/edr-freight-web/backoffice/src/components/page/KpiStrip.tsx
index 6b90d6c8a..15e2f4425 100644
--- a/apps/edr-freight-web/backoffice/src/components/page/KpiStrip.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/page/KpiStrip.tsx
@@ -19,8 +19,8 @@ export interface KpiItem {
    */
   color?: string;
   /**
-   * Optional change vs a prior period, rendered as a ▲/▼ chip next to the value
-   * (green up, red down, muted zero). E.g. today's count minus yesterday's.
+   * Optional percent change vs a prior period, rendered as a tinted ▲/▼ pill
+   * next to the value (green up, red down; zero and null hidden).
    */
   delta?: number;
   /**
@@ -64,7 +64,9 @@ export function KpiStrip({ items, loading = false }: KpiStripProps) {
               key={item.label}
               {...(linkProps as Record<string, unknown>)}
               className={cn(
-                "flex flex-1 items-center gap-3 px-5 py-4",
+                // min-w-0 lets a crowded strip (five cells, long labels)
+                // truncate its labels instead of overflowing the card.
+                "flex min-w-0 flex-1 items-center gap-3 px-5 py-4",
                 index > 0 &&
                   "border-t border-edr-border sm:border-l sm:border-t-0",
                 item.href &&
@@ -103,11 +105,19 @@ export function KpiStrip({ items, loading = false }: KpiStripProps) {
                         component="span"
                         fz="xs"
                         fw={700}
-                        c={item.delta > 0 ? "edr-green" : "red"}
-                        style={{ whiteSpace: "nowrap" }}
+                        c={item.delta > 0 ? "edr-green.7" : "red.7"}
+                        style={{
+                          whiteSpace: "nowrap",
+                          background:
+                            item.delta > 0
+                              ? "var(--mantine-color-edr-green-0)"
+                              : "var(--mantine-color-red-0)",
+                          borderRadius: 999,
+                          padding: "1px 7px",
+                        }}
                       >
                         {item.delta > 0 ? "▲" : "▼"}
-                        {Math.abs(item.delta)}
+                        {Math.abs(item.delta)}%
                       </Text>
                     ) : null}
                   </div>
diff --git a/apps/edr-freight-web/backoffice/src/components/page/PageHeader.tsx b/apps/edr-freight-web/backoffice/src/components/page/PageHeader.tsx
index 087567585..86beb22fb 100644
--- a/apps/edr-freight-web/backoffice/src/components/page/PageHeader.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/page/PageHeader.tsx
@@ -7,7 +7,7 @@ import Breadcrumbs, { type BreadcrumbItem } from "@/components/ui/Breadcrumbs";
 
 export interface PageHeaderProps {
   title: string;
-  subtitle?: string;
+  subtitle?: ReactNode;
   /** Breadcrumb trail — pass only on nested pages (details, sub-resources). */
   breadcrumbs?: BreadcrumbItem[];
   /** Route to return to; renders a back arrow before the title. */
@@ -50,15 +50,15 @@ export function PageHeader({
             </ActionIcon>
           ) : null}
 
-          <div style={{ minWidth: 0 }}>
+          <div style={{ minWidth: 0, maxWidth: 640 }}>
             <Group gap="sm" align="center" wrap="nowrap">
-              <Title order={2} className="truncate">
+              <Title order={2} className="truncate" style={{ minWidth: 0 }}>
                 {title}
               </Title>
               {meta}
             </Group>
             {subtitle ? (
-              <Text c="dimmed" size="sm" mt={4}>
+              <Text c="dimmed" size="sm" mt={4} className="truncate">
                 {subtitle}
               </Text>
             ) : null}
diff --git a/apps/edr-freight-web/backoffice/src/components/profile/ChangeEmailCard.tsx b/apps/edr-freight-web/backoffice/src/components/profile/ChangeEmailCard.tsx
new file mode 100644
index 000000000..650616049
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/profile/ChangeEmailCard.tsx
@@ -0,0 +1,172 @@
+import { useState } from "react";
+import { Mail, Loader2 } from "lucide-react";
+import { useMutation } from "@tanstack/react-query";
+import toast from "react-hot-toast";
+
+import { api } from "@/services/api";
+import { useAuth } from "@/auth/useAuth";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import {
+  Button,
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+  Input,
+  Label,
+} from "@edr/ui-common";
+
+/**
+ * Lets the signed-in backoffice user change their own email. Goes through
+ * /me/contact/otp + /me/contact rather than the generic (unverified)
+ * /auth/update-profile route, so the new address is proven before it's
+ * written — see account.controller.ts on the API side.
+ */
+export function ChangeEmailCard() {
+  const { user } = useAuth();
+  const sendOtpMutation = useMutation(
+    api.account.sendContactOtp.mutationOptions(),
+  );
+  const updateContactMutation = useMutation(
+    api.account.updateContact.mutationOptions(),
+  );
+
+  const [open, setOpen] = useState(false);
+  const [step, setStep] = useState<"enterEmail" | "enterOtp">("enterEmail");
+  const [newEmail, setNewEmail] = useState("");
+  const [otp, setOtp] = useState("");
+  const [formError, setFormError] = useState("");
+
+  const closeDialog = () => {
+    setOpen(false);
+    setStep("enterEmail");
+    setNewEmail("");
+    setOtp("");
+    setFormError("");
+  };
+
+  const sendOtp = () => {
+    setFormError("");
+    if (!newEmail.trim()) {
+      setFormError("Enter the new email address.");
+      return;
+    }
+
+    sendOtpMutation.mutate(
+      { channel: "email", value: newEmail.trim() },
+      {
+        onSuccess: (result) => {
+          toast.success(`Verification code sent to ${result.sentTo}`);
+          setStep("enterOtp");
+        },
+      },
+    );
+  };
+
+  const confirmOtp = () => {
+    setFormError("");
+    if (!otp.trim()) {
+      setFormError("Enter the verification code.");
+      return;
+    }
+
+    updateContactMutation.mutate(
+      { channel: "email", value: newEmail.trim(), otp: otp.trim() },
+      {
+        onSuccess: () => {
+          toast.success("Email updated.");
+          closeDialog();
+          // Refetches the session so the new email shows everywhere — simplest
+          // way to refresh the cached user without a dedicated context method.
+          window.location.reload();
+        },
+      },
+    );
+  };
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2">
+          <Mail className="size-4" />
+          Email
+        </CardTitle>
+        <CardDescription>
+          {user?.email ? `Current email: ${user.email}` : "Change your account email."}
+        </CardDescription>
+      </CardHeader>
+      <CardContent>
+        <Button variant="outline" size="sm" onClick={() => setOpen(true)}>
+          Change email
+        </Button>
+      </CardContent>
+
+      <Dialog open={open} onOpenChange={(next) => !next && closeDialog()}>
+        <DialogContent className="sm:max-w-md">
+          <DialogHeader>
+            <DialogTitle>Change email</DialogTitle>
+            <DialogDescription>
+              {step === "enterEmail"
+                ? "We'll send a verification code to the new address."
+                : `Enter the code sent to ${newEmail}.`}
+            </DialogDescription>
+          </DialogHeader>
+
+          {step === "enterEmail" ? (
+            <div className="space-y-2">
+              <Label htmlFor="newEmail">New email</Label>
+              <Input
+                id="newEmail"
+                type="email"
+                value={newEmail}
+                onChange={(e) => setNewEmail(e.target.value)}
+              />
+              {formError && <p className="text-sm text-destructive">{formError}</p>}
+            </div>
+          ) : (
+            <div className="space-y-2">
+              <Label htmlFor="otp">Verification code</Label>
+              <Input
+                id="otp"
+                value={otp}
+                onChange={(e) => setOtp(e.target.value)}
+              />
+              {formError && <p className="text-sm text-destructive">{formError}</p>}
+            </div>
+          )}
+
+          <DialogFooter>
+            <Button variant="outline" onClick={closeDialog}>
+              Cancel
+            </Button>
+            {step === "enterEmail" ? (
+              <Button disabled={sendOtpMutation.isPending} onClick={sendOtp}>
+                {sendOtpMutation.isPending ? (
+                  <Loader2 className="size-4 animate-spin" />
+                ) : (
+                  "Send code"
+                )}
+              </Button>
+            ) : (
+              <Button disabled={updateContactMutation.isPending} onClick={confirmOtp}>
+                {updateContactMutation.isPending ? (
+                  <Loader2 className="size-4 animate-spin" />
+                ) : (
+                  "Confirm"
+                )}
+              </Button>
+            )}
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </Card>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/profile/ChangePasswordCard.tsx b/apps/edr-freight-web/backoffice/src/components/profile/ChangePasswordCard.tsx
new file mode 100644
index 000000000..fb5f9086e
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/profile/ChangePasswordCard.tsx
@@ -0,0 +1,154 @@
+import { useState } from "react";
+import { KeyRound, Loader2 } from "lucide-react";
+import { useMutation } from "@tanstack/react-query";
+import toast from "react-hot-toast";
+
+import { api } from "@/services/api";
+import { useAuth } from "@/auth/useAuth";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
+import {
+  Button,
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+  Input,
+  Label,
+} from "@edr/ui-common";
+
+/**
+ * Lets the signed-in backoffice user change their own password. The account
+ * is logged out on success — the old token was issued under the old
+ * password, and this forces a clean re-login rather than trusting the
+ * server to keep the existing session valid.
+ */
+export function ChangePasswordCard() {
+  const { logout } = useAuth();
+  const changePasswordMutation = useMutation(
+    api.account.changePassword.mutationOptions(),
+  );
+
+  const [open, setOpen] = useState(false);
+  const [oldPassword, setOldPassword] = useState("");
+  const [newPassword, setNewPassword] = useState("");
+  const [confirmPassword, setConfirmPassword] = useState("");
+  const [formError, setFormError] = useState("");
+
+  const closeDialog = () => {
+    setOpen(false);
+    setOldPassword("");
+    setNewPassword("");
+    setConfirmPassword("");
+    setFormError("");
+  };
+
+  const submit = () => {
+    setFormError("");
+
+    if (!oldPassword || !newPassword || !confirmPassword) {
+      setFormError("All fields are required.");
+      return;
+    }
+    if (newPassword.length < 8) {
+      setFormError("New password must be at least 8 characters.");
+      return;
+    }
+    if (newPassword === oldPassword) {
+      setFormError("New password must be different from the current one.");
+      return;
+    }
+    if (newPassword !== confirmPassword) {
+      setFormError("New password and confirmation do not match.");
+      return;
+    }
+
+    changePasswordMutation.mutate(
+      { oldPassword, newPassword, confirmPassword },
+      {
+        onSuccess: () => {
+          toast.success("Password changed. Please sign in again.");
+          closeDialog();
+          setTimeout(logout, 1200);
+        },
+      },
+    );
+  };
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2">
+          <KeyRound className="size-4" />
+          Password
+        </CardTitle>
+        <CardDescription>Change the password for your account.</CardDescription>
+      </CardHeader>
+      <CardContent>
+        <Button variant="outline" size="sm" onClick={() => setOpen(true)}>
+          Change password
+        </Button>
+      </CardContent>
+
+      <Dialog open={open} onOpenChange={(next) => !next && closeDialog()}>
+        <DialogContent className="sm:max-w-md">
+          <DialogHeader>
+            <DialogTitle>Change password</DialogTitle>
+            <DialogDescription>
+              You'll be signed out and asked to log in again once it's changed.
+            </DialogDescription>
+          </DialogHeader>
+          <div className="space-y-4">
+            <div className="space-y-2">
+              <Label htmlFor="oldPassword">Current password</Label>
+              <Input
+                id="oldPassword"
+                type="password"
+                value={oldPassword}
+                onChange={(e) => setOldPassword(e.target.value)}
+              />
+            </div>
+            <div className="space-y-2">
+              <Label htmlFor="newPassword">New password</Label>
+              <Input
+                id="newPassword"
+                type="password"
+                value={newPassword}
+                onChange={(e) => setNewPassword(e.target.value)}
+              />
+            </div>
+            <div className="space-y-2">
+              <Label htmlFor="confirmPassword">Confirm new password</Label>
+              <Input
+                id="confirmPassword"
+                type="password"
+                value={confirmPassword}
+                onChange={(e) => setConfirmPassword(e.target.value)}
+              />
+            </div>
+            {formError && <p className="text-sm text-destructive">{formError}</p>}
+          </div>
+          <DialogFooter>
+            <Button variant="outline" onClick={closeDialog}>
+              Cancel
+            </Button>
+            <Button disabled={changePasswordMutation.isPending} onClick={submit}>
+              {changePasswordMutation.isPending ? (
+                <Loader2 className="size-4 animate-spin" />
+              ) : (
+                "Change password"
+              )}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </Card>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/profile/MySignatureCard.tsx b/apps/edr-freight-web/backoffice/src/components/profile/MySignatureCard.tsx
index 0a70b3aec..b13ba4291 100644
--- a/apps/edr-freight-web/backoffice/src/components/profile/MySignatureCard.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/profile/MySignatureCard.tsx
@@ -1,11 +1,10 @@
 import { useState } from "react";
-import { FileSignature, Loader2, Stamp } from "lucide-react";
+import { FileSignature, Loader2 } from "lucide-react";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import toast from "react-hot-toast";
 
 import { api } from "@/services/api";
 import { ContractSignaturePad } from "@/components/bookings/ContractSignaturePad";
-import { StampUpload } from "@/components/contracts/StampUpload";
 import {
   Card,
   CardContent,
@@ -27,9 +26,13 @@ import {
 } from "@edr/ui-common";
 
 /**
- * Lets the signed-in user view and update the reusable signature and company
- * stamp stored on their profile — managed independently of each other. Both
- * are offered when signing a booking contract.
+ * Lets the signed-in user view and update the reusable signature stored on
+ * their profile, offered for approval when signing a contract.
+ *
+ * Signature only — there is no per-employee stamp. EDR seals with ONE global
+ * company stamp, managed under Settings and applied server-side, so a staff
+ * member never uploads or picks a stamp. (Customers do upload their own, in
+ * the portal — that is a different card.)
  */
 export function MySignatureCard() {
   const { user } = useAuth();
@@ -39,10 +42,8 @@ export function MySignatureCard() {
   const saveMutation = useMutation(api.signatures.save.mutationOptions());
 
   const [signatureOpen, setSignatureOpen] = useState(false);
-  const [stampOpen, setStampOpen] = useState(false);
   const [signerName, setSignerName] = useState("");
   const [signatureData, setSignatureData] = useState<string | null>(null);
-  const [stampData, setStampData] = useState<string | null>(null);
 
   const defaultName =
     user?.name?.en || user?.username || user?.email || "";
@@ -60,7 +61,6 @@ export function MySignatureCard() {
       {
         signerDisplayName: signerName.trim(),
         signatureImageBase64: signatureData,
-        // Stamp untouched — it is managed by its own dialog.
       },
       {
         onSuccess: () => {
@@ -72,38 +72,16 @@ export function MySignatureCard() {
     );
   };
 
-  const openStampDialog = () => {
-    setStampData(saved?.stampImageUrl ?? null);
-    setStampOpen(true);
-  };
-
-  const saveStamp = () => {
-    if (!stampData) return;
-    saveMutation.mutate(
-      {
-        signerDisplayName: savedName || defaultName,
-        // Signature untouched — stamp-only update.
-        stampImageBase64: stampData,
-      },
-      {
-        onSuccess: () => {
-          toast.success("Stamp saved");
-          setStampOpen(false);
-        },
-        onError: () => toast.error("Failed to save stamp"),
-      },
-    );
-  };
-
   return (
     <Card>
       <CardHeader>
         <CardTitle className="flex items-center gap-2">
           <FileSignature className="size-4" />
-          Signature &amp; Stamp
+          Signature
         </CardTitle>
         <CardDescription>
-          This signature can be reused to sign booking contracts.
+          This signature can be reused to sign booking contracts. The EDR
+          company stamp is applied automatically — you do not upload one.
         </CardDescription>
       </CardHeader>
       <CardContent className="space-y-6">
@@ -112,54 +90,29 @@ export function MySignatureCard() {
             <Loader2 className="size-6 animate-spin text-primary" />
           </div>
         ) : (
-          <>
-            <div className="space-y-2">
-              {saved?.signatureImageUrl ? (
-                <>
-                  <div className="overflow-hidden rounded-lg border-2 border-dashed border-border bg-white">
-                    <img
-                      src={saved.signatureImageUrl}
-                      alt="My saved signature"
-                      className="mx-auto h-36 w-full object-contain"
-                    />
-                  </div>
-                  <p className="text-xs text-muted-foreground">
-                    Saved as {saved.signerDisplayName}
-                  </p>
-                </>
-              ) : (
-                <p className="text-sm text-muted-foreground">
-                  You have not saved a signature yet.
+          <div className="space-y-2">
+            {saved?.signatureImageUrl ? (
+              <>
+                <div className="overflow-hidden rounded-lg border-2 border-dashed border-border bg-white">
+                  <img
+                    src={saved.signatureImageUrl}
+                    alt="My saved signature"
+                    className="mx-auto h-36 w-full object-contain"
+                  />
+                </div>
+                <p className="text-xs text-muted-foreground">
+                  Saved as {saved.signerDisplayName}
                 </p>
-              )}
-              <Button variant="outline" size="sm" onClick={openSignatureDialog}>
-                {saved?.signatureImageUrl ? "Update signature" : "Add signature"}
-              </Button>
-            </div>
-
-            <div className="space-y-2">
-              {saved?.stampImageUrl ? (
-                <>
-                  <div className="overflow-hidden rounded-lg border-2 border-dashed border-border bg-white">
-                    <img
-                      src={saved.stampImageUrl}
-                      alt="My saved company stamp"
-                      className="mx-auto h-24 w-full object-contain"
-                    />
-                  </div>
-                  <p className="text-xs text-muted-foreground">Company stamp</p>
-                </>
-              ) : (
-                <p className="text-sm text-muted-foreground">
-                  You have not uploaded a company stamp yet.
-                </p>
-              )}
-              <Button variant="outline" size="sm" onClick={openStampDialog}>
-                <Stamp className="size-4" />
-                {saved?.stampImageUrl ? "Update stamp" : "Upload stamp"}
-              </Button>
-            </div>
-          </>
+              </>
+            ) : (
+              <p className="text-sm text-muted-foreground">
+                You have not saved a signature yet.
+              </p>
+            )}
+            <Button variant="outline" size="sm" onClick={openSignatureDialog}>
+              {saved?.signatureImageUrl ? "Update signature" : "Add signature"}
+            </Button>
+          </div>
         )}
       </CardContent>
 
@@ -203,39 +156,6 @@ export function MySignatureCard() {
           </DialogFooter>
         </DialogContent>
       </Dialog>
-
-      <Dialog open={stampOpen} onOpenChange={setStampOpen}>
-        <DialogContent className="sm:max-w-md">
-          <DialogHeader>
-            <DialogTitle>Company stamp</DialogTitle>
-            <DialogDescription>
-              Upload your official company stamp or seal as an image. It is
-              stored on your profile and applied next to your signature on
-              contracts.
-            </DialogDescription>
-          </DialogHeader>
-          <StampUpload
-            value={stampData}
-            onChange={setStampData}
-            description="Stored on your profile and prefilled when you sign contracts."
-          />
-          <DialogFooter>
-            <Button variant="outline" onClick={() => setStampOpen(false)}>
-              Cancel
-            </Button>
-            <Button
-              disabled={saveMutation.isPending || !stampData}
-              onClick={saveStamp}
-            >
-              {saveMutation.isPending ? (
-                <Loader2 className="size-4 animate-spin" />
-              ) : (
-                "Save stamp"
-              )}
-            </Button>
-          </DialogFooter>
-        </DialogContent>
-      </Dialog>
     </Card>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/components/reports/ReportChart.tsx b/apps/edr-freight-web/backoffice/src/components/reports/ReportChart.tsx
new file mode 100644
index 000000000..0be5384be
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/reports/ReportChart.tsx
@@ -0,0 +1,83 @@
+import { Box, Text } from "@mantine/core";
+import {
+  Bar,
+  BarChart,
+  CartesianGrid,
+  Legend,
+  Line,
+  LineChart,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis,
+} from "recharts";
+
+import { overviewChartColors } from "@/components/overview/overview.styles";
+import type { ReportChartDef, ReportColumn } from "@/types/reports";
+
+import { formatReportCell } from "./report-format";
+
+interface ReportChartProps {
+  chart: ReportChartDef;
+  items: Record<string, unknown>[];
+  columns: ReportColumn[];
+  /** Filtered row count on the server. Chart is capped at 100 rows (the API's
+   * page-size ceiling) — surface it plainly rather than silently truncate. */
+  total?: number;
+}
+
+const COLORS = overviewChartColors.pipeline;
+
+/** Plots the same rows the table gets — chart.x/chart.y are just column keys. */
+export function ReportChart({ chart, items, columns, total }: ReportChartProps) {
+  const columnByKey = new Map(columns.map((c) => [c.key, c]));
+  const yLabel = (key: string) => columnByKey.get(key)?.label ?? key;
+  const yType = (key: string) => columnByKey.get(key)?.type ?? "number";
+
+  if (!items.length) {
+    return (
+      <Text size="sm" c="dimmed" ta="center" py="xl">
+        No data for the selected filters.
+      </Text>
+    );
+  }
+
+  const Chart = chart.type === "line" ? LineChart : BarChart;
+
+  const truncated = typeof total === "number" && total > items.length;
+
+  return (
+    <Box px="md" pb="md">
+      {truncated ? (
+        <Text size="xs" c="dimmed" mb="xs">
+          Showing first {items.length} of {total} rows. Narrow the filters to see the rest charted.
+        </Text>
+      ) : null}
+      <ResponsiveContainer width="100%" height={320}>
+        <Chart data={items} margin={{ top: 8, right: 16, left: 0, bottom: 24 }}>
+          <CartesianGrid strokeDasharray="3 3" stroke="#e5e7eb" />
+          <XAxis
+            dataKey={chart.x}
+            tick={{ fontSize: 11 }}
+            angle={-20}
+            textAnchor="end"
+            height={50}
+            stroke="#94a3b8"
+          />
+          <YAxis tick={{ fontSize: 12 }} stroke="#94a3b8" />
+          <Tooltip formatter={(value, name) => [formatReportCell(value, yType(String(name))), yLabel(String(name))]} />
+          {chart.y.length > 1 ? <Legend formatter={(name) => yLabel(String(name))} /> : null}
+          {chart.y.map((key, i) =>
+            chart.type === "line" ? (
+              <Line key={key} type="monotone" dataKey={key} stroke={COLORS[i % COLORS.length]} strokeWidth={2} dot={false} />
+            ) : (
+              <Bar key={key} dataKey={key} fill={COLORS[i % COLORS.length]} radius={[4, 4, 0, 0]} />
+            ),
+          )}
+        </Chart>
+      </ResponsiveContainer>
+    </Box>
+  );
+}
+
+export default ReportChart;
diff --git a/apps/edr-freight-web/backoffice/src/components/reports/ReportExportButton.tsx b/apps/edr-freight-web/backoffice/src/components/reports/ReportExportButton.tsx
new file mode 100644
index 000000000..76ff7d628
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/reports/ReportExportButton.tsx
@@ -0,0 +1,158 @@
+import { Button, Checkbox, Group, Modal, Radio, Select, SimpleGrid, Stack, Text } from "@mantine/core";
+import { Download, FileSpreadsheet, FileText } from "lucide-react";
+import { useState } from "react";
+
+import { reportsService } from "@/services/reports.service";
+import type { ReportCatalogEntry, ReportRunParams } from "@/types/reports";
+
+interface ReportExportButtonProps {
+  def: ReportCatalogEntry;
+  /** Filters + sort currently applied on screen — no key/page/pageSize. */
+  params: Omit<ReportRunParams, "key" | "page" | "pageSize">;
+}
+
+const RECORD_OPTIONS = [
+  { value: "all", label: "All (up to format limit)" },
+  { value: "100", label: "First 100" },
+  { value: "500", label: "First 500" },
+  { value: "1000", label: "First 1,000" },
+];
+
+/** Triggers a browser save for a blob without leaving the SPA. */
+function saveBlob(blob: Blob, filename: string) {
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(url);
+}
+
+/** One export button: format, which fields, how many records — applies the
+ * filters/sort already on screen. Record count defaults to all (capped
+ * server-side per format). */
+export function ReportExportButton({ def, params }: ReportExportButtonProps) {
+  const [opened, setOpened] = useState(false);
+  const [format, setFormat] = useState<"xlsx" | "pdf">("xlsx");
+  const [fields, setFields] = useState<string[]>(def.columns.map((c) => c.key));
+  const [records, setRecords] = useState("all");
+  const [exporting, setExporting] = useState(false);
+
+  const allSelected = fields.length === def.columns.length;
+  const toggleField = (key: string) =>
+    setFields((prev) => (prev.includes(key) ? prev.filter((k) => k !== key) : [...prev, key]));
+  const toggleAll = () => setFields(allSelected ? [] : def.columns.map((c) => c.key));
+
+  const handleDownload = async () => {
+    setExporting(true);
+    try {
+      const blob = await reportsService.download(def.key, format, {
+        ...params,
+        fields: allSelected ? undefined : fields.join(","),
+        limit: records === "all" ? undefined : records,
+      });
+      saveBlob(blob, `${def.key}.${format}`);
+      setOpened(false);
+    } finally {
+      setExporting(false);
+    }
+  };
+
+  return (
+    <>
+      <Button
+        variant="default"
+        radius="md"
+        size="sm"
+        leftSection={<Download size={16} />}
+        onClick={() => setOpened(true)}
+      >
+        Export
+      </Button>
+
+      <Modal opened={opened} onClose={() => setOpened(false)} title="Export report" radius="md" size="md">
+        <Stack gap="lg">
+          <div>
+            <Text size="sm" fw={600} mb="xs">
+              Format
+            </Text>
+            <Radio.Group value={format} onChange={(v) => setFormat(v as "xlsx" | "pdf")}>
+              <SimpleGrid cols={2}>
+                <Radio.Card value="xlsx" radius="md" p="md">
+                  <Group wrap="nowrap" gap="sm">
+                    <Radio.Indicator />
+                    <FileSpreadsheet size={22} />
+                    <Text size="sm" fw={500}>
+                      Excel (.xlsx)
+                    </Text>
+                  </Group>
+                </Radio.Card>
+                <Radio.Card value="pdf" radius="md" p="md">
+                  <Group wrap="nowrap" gap="sm">
+                    <Radio.Indicator />
+                    <FileText size={22} />
+                    <Text size="sm" fw={500}>
+                      PDF
+                    </Text>
+                  </Group>
+                </Radio.Card>
+              </SimpleGrid>
+            </Radio.Group>
+          </div>
+
+          <div>
+            <Group justify="space-between" mb="xs">
+              <Text size="sm" fw={600}>
+                Fields
+              </Text>
+              <Button variant="subtle" size="compact-sm" onClick={toggleAll}>
+                {allSelected ? "Clear all" : "Select all"}
+              </Button>
+            </Group>
+            <SimpleGrid cols={2} spacing="xs">
+              {def.columns.map((col) => (
+                <Checkbox
+                  key={col.key}
+                  label={col.label}
+                  checked={fields.includes(col.key)}
+                  onChange={() => toggleField(col.key)}
+                />
+              ))}
+            </SimpleGrid>
+          </div>
+
+          <Select
+            label="Records"
+            value={records}
+            onChange={(v) => setRecords(v ?? "all")}
+            data={RECORD_OPTIONS}
+            allowDeselect={false}
+            radius="md"
+            size="sm"
+          />
+
+          <Text size="xs" c="dimmed">
+            Uses the filters and sorting currently applied to the report.
+          </Text>
+
+          <Group justify="flex-end">
+            <Button variant="default" radius="md" onClick={() => setOpened(false)}>
+              Cancel
+            </Button>
+            <Button
+              radius="md"
+              loading={exporting}
+              disabled={!fields.length}
+              leftSection={<Download size={16} />}
+              onClick={() => void handleDownload()}
+            >
+              Download
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </>
+  );
+}
+
+export default ReportExportButton;
diff --git a/apps/edr-freight-web/backoffice/src/components/reports/ReportSection.tsx b/apps/edr-freight-web/backoffice/src/components/reports/ReportSection.tsx
new file mode 100644
index 000000000..e686bc9d0
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/reports/ReportSection.tsx
@@ -0,0 +1,41 @@
+import { Stack, Text, Title } from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+
+import { api } from "@/services/api";
+
+import { ReportView } from "./ReportView";
+
+interface ReportSectionProps {
+  reportKey: string;
+  /** Scopes the report to one entity, e.g. the contract this page is showing. */
+  idKeyValue?: string;
+  /** Opens on the chart instead of the table — for dashboard tiles. */
+  defaultView?: "table" | "chart";
+}
+
+/**
+ * Drops a report inline on any page — a contract detail page embedding
+ * `contract-utilization`, for instance. Renders nothing while the catalog is
+ * loading or if the caller lacks the report's permission, so pages can embed
+ * it unconditionally without their own permission check.
+ */
+export function ReportSection({ reportKey, idKeyValue, defaultView }: ReportSectionProps) {
+  const { data: catalog } = useQuery(api.reports.catalog.queryOptions());
+  const def = catalog?.find((r) => r.key === reportKey);
+
+  if (!def) return null;
+
+  return (
+    <Stack gap="xs">
+      <div>
+        <Title order={4}>{def.title}</Title>
+        <Text size="sm" c="dimmed">
+          {def.description}
+        </Text>
+      </div>
+      <ReportView reportKey={reportKey} idKeyValue={idKeyValue} defaultView={defaultView} />
+    </Stack>
+  );
+}
+
+export default ReportSection;
diff --git a/apps/edr-freight-web/backoffice/src/components/reports/ReportView.tsx b/apps/edr-freight-web/backoffice/src/components/reports/ReportView.tsx
new file mode 100644
index 000000000..2634e882c
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/reports/ReportView.tsx
@@ -0,0 +1,307 @@
+import { ActionIcon, Alert, Box, Card, Group, SegmentedControl, Stack, Text, Tooltip, UnstyledButton } from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import type { Column, SortingState } from "@tanstack/react-table";
+import { ArrowDown, ArrowUp, ArrowUpDown, LayoutGrid, LineChart, RefreshCw } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+import { useNavigate } from "react-router-dom";
+
+import { PageHeader } from "@/components/page";
+import { KpiStrip } from "@/components/page/KpiStrip";
+import { FilterBar, dateRangeParams, useFilters, type FilterDef } from "@/components/filters";
+import { api } from "@/services/api";
+import type { ReportFilterDef, ReportRunParams } from "@/types/reports";
+import { DataTable, DataTableFooter, usePagination, type ColumnDef } from "@edr/ui-common";
+
+import { ReportChart } from "./ReportChart";
+import { ReportExportButton } from "./ReportExportButton";
+import { formatKpiValue, formatReportCell } from "./report-format";
+
+/**
+ * Maps the report catalog's own filter vocabulary onto the shared FilterBar's
+ * `FilterDef`. "search" is skipped — FilterBar already renders its own search
+ * box wired to the same `search` param, so keeping the catalog's declared
+ * "search" filter too would just double it up as a redundant pill.
+ */
+function toFilterDefs(filters: ReportFilterDef[]): FilterDef[] {
+  return filters
+    .filter((f) => f.key !== "search")
+    .map((f): FilterDef => {
+      switch (f.type) {
+        case "daterange":
+          return {
+            key: f.key,
+            label: f.label,
+            type: "date",
+            operators: ["between", "before", "after"],
+            toParams: dateRangeParams(`${f.key}From`, `${f.key}To`),
+          };
+        case "date":
+          // Every report's single-date filter (e.g. "as of") is an exact
+          // cutoff, not a range — one fixed operator keeps DateBody on its
+          // single-date UI instead of the range picker.
+          return { key: f.key, label: f.label, type: "date", operators: ["before"] };
+        case "select":
+          return { key: f.key, label: f.label, type: "enum", multiple: false, options: f.options ?? [] };
+        case "multiselect":
+          return { key: f.key, label: f.label, type: "enum", multiple: true, options: f.options ?? [] };
+        default:
+          return { key: f.key, label: f.label, type: "text" };
+      }
+    });
+}
+
+function SortableHeader({ label, column }: { label: string; column: Column<Record<string, unknown>, unknown> }) {
+  const sorted = column.getIsSorted();
+  const Icon = sorted === "asc" ? ArrowUp : sorted === "desc" ? ArrowDown : ArrowUpDown;
+  return (
+    <UnstyledButton
+      onClick={column.getToggleSortingHandler()}
+      style={{ display: "flex", alignItems: "center", gap: 4 }}
+    >
+      <Text size="sm" fw={600} c="edr-text">
+        {label}
+      </Text>
+      <Icon size={13} opacity={sorted ? 1 : 0.4} />
+    </UnstyledButton>
+  );
+}
+
+interface ReportViewProps {
+  reportKey: string;
+  /** Scopes the report to one entity when embedded (e.g. a contract detail page). */
+  idKeyValue?: string;
+  /** Full-page usage: renders the title/description as a PageHeader (no back
+   * arrow) with export/refresh as its actions, instead of inline above the
+   * table. Off by default for embedded sections. */
+  pageHeader?: boolean;
+  /** Opens on the chart instead of the table — for dashboard tiles. */
+  defaultView?: "table" | "chart";
+}
+
+/**
+ * The report engine: one component renders any report the catalog describes —
+ * filters, KPI strip, sortable/paginated table or chart, xlsx/pdf export.
+ * Adding a report never touches this file.
+ */
+export function ReportView({ reportKey, idKeyValue, pageHeader, defaultView }: ReportViewProps) {
+  const { data: catalog } = useQuery(api.reports.catalog.queryOptions());
+  const def = catalog?.find((r) => r.key === reportKey);
+
+  const navigate = useNavigate();
+
+  const { pagination, setPagination } = usePagination({ pageSize: 20 });
+  const [sorting, setSorting] = useState<SortingState>([]);
+  const [view, setView] = useState<"table" | "chart">(defaultView ?? "table");
+
+  // FilterBar's own state — reads/writes the URL directly, same as
+  // BookingRequestsPage, so a drilled-into or shared report URL opens
+  // already filtered.
+  const reportFilterDefs = useMemo(() => toFilterDefs(def?.filters ?? []), [def?.filters]);
+  const controls = useFilters(reportFilterDefs);
+  // useFilters also tracks its own page/pageSize — unused here, this report
+  // view paginates itself (and overrides pageSize for the chart view below).
+  const filterParams = useMemo(() => {
+    const rest = { ...controls.params };
+    delete rest.page;
+    delete rest.pageSize;
+    return rest;
+  }, [controls.params]);
+
+  // Filters + sort as the user currently has them — independent of the view
+  // toggle's paging, so export always matches what's on screen either way.
+  const appliedParams = useMemo(() => {
+    const sort = sorting[0];
+    return {
+      sortBy: sort?.id,
+      sortOrder: sort ? (sort.desc ? "DESC" as const : "ASC" as const) : undefined,
+      ...filterParams,
+      ...(def?.idKey && idKeyValue ? { [def.idKey.key]: idKeyValue } : {}),
+    };
+  }, [def, sorting, filterParams, idKeyValue]);
+
+  // A filter change should land back on page 1, same as every other
+  // FilterBar page — but pagination here is local (not URL-driven via
+  // controls.tableProps), so it needs an explicit reset.
+  useEffect(() => {
+    setPagination((prev) => ({ ...prev, pageIndex: 0 }));
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [filterParams]);
+
+  const runParams: ReportRunParams | undefined = useMemo(() => {
+    if (!def) return undefined;
+    return {
+      key: def.key,
+      // Chart view isn't paginated on screen — pull the server's max page (100)
+      // in one shot instead of just whatever page the table happens to be on,
+      // so the chart doesn't silently plot a fraction of the filtered rows.
+      page: view === "chart" ? 1 : pagination.pageIndex + 1,
+      pageSize: view === "chart" ? 100 : pagination.pageSize,
+      ...appliedParams,
+    };
+  }, [def, view, pagination, appliedParams]);
+
+  const { data, isLoading, isError, isFetching, refetch } = useQuery({
+    ...api.reports.run.queryOptions({ input: runParams as ReportRunParams }),
+    enabled: Boolean(runParams),
+  });
+
+  /**
+   * Row click carries this row's values into the target report as filter
+   * params — the "summary to transaction level" drill-down. Undefined unless
+   * the report declares `drill`, which is what leaves the row unclickable.
+   */
+  const handleRowClick = useMemo(() => {
+    const drill = def?.drill;
+    if (!drill) return undefined;
+    return (row: Record<string, unknown>) => {
+      const params = new URLSearchParams();
+      for (const [column, filterKey] of Object.entries(drill.carry)) {
+        const value = row[column];
+        if (value !== null && value !== undefined && value !== "") {
+          params.set(filterKey, String(value));
+        }
+      }
+      // Carry the filters already applied, so the drill narrows rather than resets.
+      for (const [key, value] of Object.entries(appliedParams)) {
+        if (typeof value === "string" && value && !params.has(key)) params.set(key, value);
+      }
+      navigate(`/dashboard/reports/${drill.to}?${params.toString()}`);
+    };
+  }, [def?.drill, appliedParams, navigate]);
+
+  const total = data?.meta.total ?? 0;
+  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
+
+  const columns: ColumnDef<Record<string, unknown>>[] = useMemo(
+    () =>
+      (def?.columns ?? []).map((col) => ({
+        id: col.key,
+        accessorKey: col.key,
+        header: col.sortable
+          ? ({ column }) => <SortableHeader label={col.label} column={column} />
+          : col.label,
+        enableSorting: col.sortable,
+        cell: ({ row }) => (
+          <Text size="sm" c="edr-text">
+            {formatReportCell(row.original[col.key], col.type)}
+          </Text>
+        ),
+      })),
+    [def?.columns],
+  );
+
+  if (!def) {
+    return catalog ? (
+      <Alert color="red">You don't have access to this report.</Alert>
+    ) : null;
+  }
+
+  const chartToggle = def.chart ? (
+    <SegmentedControl
+      size="xs"
+      value={view}
+      onChange={(v) => setView(v as "table" | "chart")}
+      data={[
+        { label: <LayoutGrid size={14} />, value: "table" },
+        { label: <LineChart size={14} />, value: "chart" },
+      ]}
+    />
+  ) : null;
+
+  const refreshButton = (
+    <Tooltip label="Refresh">
+      <ActionIcon
+        variant="default"
+        radius="md"
+        loading={isFetching}
+        onClick={() => void refetch()}
+        aria-label="Refresh"
+      >
+        <RefreshCw size={16} />
+      </ActionIcon>
+    </Tooltip>
+  );
+
+  const exportButton = <ReportExportButton def={def} params={appliedParams} />;
+
+  return (
+    <Stack gap="md">
+      {pageHeader ? (
+        <PageHeader
+          title={def.title}
+          subtitle={def.description}
+          action={
+            <Group gap="xs">
+              {exportButton}
+              {refreshButton}
+            </Group>
+          }
+        />
+      ) : null}
+
+      {data?.kpis.length ? (
+        <KpiStrip
+          loading={isLoading}
+          items={data.kpis.map((k) => ({ label: k.label, value: formatKpiValue(k.value, k.unit) }))}
+        />
+      ) : null}
+
+      <Card p={0}>
+        <Stack gap={0}>
+          <Box px="md" pt="md" pb="sm">
+            <FilterBar
+              defs={reportFilterDefs}
+              controls={controls}
+              // Only a handful of reports actually implement the `search`
+              // param server-side (see toFilterDefs) — showing the box on
+              // every report would be a dead control on the rest.
+              showSearch={def.filters.some((f) => f.key === "search")}
+              searchPlaceholder="Search…"
+            >
+              {chartToggle}
+              {pageHeader ? null : (
+                <>
+                  {exportButton}
+                  {refreshButton}
+                </>
+              )}
+            </FilterBar>
+          </Box>
+
+          {view === "chart" && def.chart ? (
+            <ReportChart chart={def.chart} items={data?.items ?? []} columns={def.columns} total={total} />
+          ) : (
+            <Box style={{ overflowX: "auto" }} w="100%">
+              <DataTable
+                columns={columns}
+                data={data?.items ?? []}
+                onRowClick={handleRowClick}
+                status={isLoading ? "loading" : isError ? "error" : "success"}
+                emptyMessage="No data for the selected filters."
+                error={isError ? { message: "Failed to load report.", onRetry: () => void refetch() } : undefined}
+                pagination={{
+                  pageIndex: pagination.pageIndex,
+                  pageSize: pagination.pageSize,
+                  pageCount,
+                  totalCount: total,
+                }}
+                tableOptions={{
+                  state: { sorting },
+                  onSortingChange: setSorting,
+                  onPaginationChange: setPagination,
+                  manualPagination: true,
+                  manualSorting: true,
+                  pageCount,
+                }}
+                containerClassName="border-0 shadow-none bg-transparent"
+                footer={DataTableFooter}
+              />
+            </Box>
+          )}
+        </Stack>
+      </Card>
+    </Stack>
+  );
+}
+
+export default ReportView;
diff --git a/apps/edr-freight-web/backoffice/src/components/reports/report-format.ts b/apps/edr-freight-web/backoffice/src/components/reports/report-format.ts
new file mode 100644
index 000000000..d9b174ef1
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/reports/report-format.ts
@@ -0,0 +1,42 @@
+import type { ReportColumnType } from "@/types/reports";
+
+/** Cell formatting shared by the on-screen table and (indirectly) exports. */
+export function formatReportCell(value: unknown, type: ReportColumnType): string {
+  if (value === null || value === undefined || value === "") return "—";
+  switch (type) {
+    case "money":
+      return new Intl.NumberFormat(undefined, {
+        style: "currency",
+        currency: "ETB",
+        maximumFractionDigits: 2,
+      }).format(Number(value));
+    case "tons":
+      return `${Number(value).toLocaleString()} t`;
+    case "percent":
+      return `${value}%`;
+    case "number":
+      return Number(value).toLocaleString();
+    case "date": {
+      const d = new Date(String(value));
+      return Number.isNaN(d.getTime())
+        ? String(value)
+        : d.toLocaleDateString(undefined, { year: "numeric", month: "short", day: "numeric" });
+    }
+    default:
+      return String(value);
+  }
+}
+
+export function formatKpiValue(value: number, unit?: string): string {
+  const formatted = value.toLocaleString(undefined, { maximumFractionDigits: 1 });
+  if (unit === "ETB") {
+    return new Intl.NumberFormat(undefined, {
+      style: "currency",
+      currency: "ETB",
+      maximumFractionDigits: 0,
+    }).format(value);
+  }
+  if (unit === "%") return `${formatted}%`;
+  if (unit === "t") return `${formatted} t`;
+  return formatted;
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineCardGrid.tsx b/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineCardGrid.tsx
index 762f5bc84..e3fe9cb37 100644
--- a/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineCardGrid.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineCardGrid.tsx
@@ -253,7 +253,7 @@ const RuleEngineCardGrid = ({
                   config={config}
                   layout="compact"
                   readOnly={readOnly}
-                  onEdit={onEdit ?? (() => { })}
+                  onEdit={onEdit}
                   onDelete={onDelete ?? (() => { })}
                   onViewChain={onViewChain}
                   onSubmitRate={onSubmitRate}
diff --git a/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineFormDialog.tsx b/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineFormDialog.tsx
index 4684a3ad1..8c67b9eb3 100644
--- a/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineFormDialog.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineFormDialog.tsx
@@ -227,6 +227,12 @@ const RuleEngineFormDialog = ({
       current[name] ? { ...current, [name]: "" } : current,
     );
     setValues((current) => {
+      // Mantine fires onChange even when the same option is re-picked, and the
+      // cascades below clear dependent answers (yards, unit, scope). Re-picking
+      // an unchanged value must be a no-op, or an untouched direction silently
+      // wipes the yard pair and the submit fails with "origin/destination
+      // missing" data the admin did fill in.
+      if (current[name] === value) return current;
       const next = { ...current, [name]: value };
       // Changing what a rate applies to (or its surcharge trigger) can invalidate
       // the previously-chosen unit — reset it so the admin re-picks from the new
@@ -250,13 +256,41 @@ const RuleEngineFormDialog = ({
         next.containerTypeId = "";
         next.cargoTypeId = "";
       }
-      // Cargo kind (customs / lashing) decides both the container-type scope
+      // Cargo kind (customs / cancellation) decides both the container-type scope
       // and the legal units (container → per box/wagon, bulk → per ton/wagon).
       if (name === "cargoKind") {
         next.containerTypeId = "";
         next.cargoTypeId = "";
         next.rateUnit = "";
       }
+      // Turning the shipping-line toggle on or off swaps the entire form, so
+      // nothing answered under the other shape may survive into the payload.
+      if (name === "isShippingLineRate") {
+        next.shippingLineCompanyId = "";
+        next.shippingLineRateKind = "";
+        next.shippingLineCargoKind = "";
+        next.appliesTo = "";
+        next.trigger = "";
+        next.containerTypeId = "";
+        next.cargoTypeId = "";
+        next.originYardId = "";
+        next.destinationYardId = "";
+        next.rateUnit = "";
+      }
+      // Base-vs-surcharge and container-vs-bulk each decide the scope field and
+      // the legal units for a shipping-line rate, exactly as appliesTo and
+      // cargoKind do on the customer form.
+      if (name === "shippingLineRateKind" || name === "shippingLineCargoKind") {
+        next.containerTypeId = "";
+        next.cargoTypeId = "";
+        next.rateUnit = "";
+        if (name === "shippingLineRateKind") {
+          next.shippingLineCargoKind = "";
+          next.trigger = "";
+          next.originYardId = "";
+          next.destinationYardId = "";
+        }
+      }
       return next;
     });
   };
@@ -347,12 +381,23 @@ const RuleEngineFormDialog = ({
             borderRadius: "var(--mantine-radius-md)",
           }}
         >
-          <Text size="sm" fw={600}>
-            {field.label}
-          </Text>
+          <Stack gap={2}>
+            <Text size="sm" fw={600}>
+              {field.label}
+            </Text>
+            {field.description ? (
+              <Text size="xs" c="dimmed">
+                {field.description}
+              </Text>
+            ) : null}
+          </Stack>
           <Switch
             checked={Boolean(values[field.name])}
             onChange={(e) => setField(field.name, e.currentTarget.checked)}
+            // A toggle that re-targets what an existing record means (e.g. who
+            // a rate is priced for) is create-only — flipping it on a saved row
+            // would silently change every booking that prices off it.
+            disabled={field.disabled || (field.disabledOnEdit && !!initialRecord)}
             size="md"
             color="edr-green"
           />
@@ -493,6 +538,12 @@ const RuleEngineFormDialog = ({
       // Dynamic options (e.g. rate unit) resolve from the live form values so
       // the choices track the other fields the admin has picked.
       const options = field.optionsFromValues ? field.optionsFromValues(values) : (field.options ?? []);
+      // A derived select shows (and submits) its computed value and is locked,
+      // matching the text-input branch — used by fields the shape decides on the
+      // admin's behalf, e.g. a shipping-line rate's import-only direction.
+      const computedSelect = field.computeValue
+        ? String(field.computeValue(values) ?? "")
+        : undefined;
       return (
         <Select
           key={field.name}
@@ -501,9 +552,18 @@ const RuleEngineFormDialog = ({
           placeholder={
             selectOptionsLoading ? "Loading options..." : (field.placeholder ?? "Select an option")
           }
-          value={resolveSelectValue(field, values)}
+          value={
+            computedSelect !== undefined
+              ? computedSelect
+              : resolveSelectValue(field, values)
+          }
           onChange={(v) => setField(field.name, v === RULE_ENGINE_SELECT_NONE ? "" : v)}
-          disabled={selectOptionsLoading}
+          disabled={
+            selectOptionsLoading ||
+            field.disabled ||
+            (field.disabledOnEdit && !!initialRecord) ||
+            computedSelect !== undefined
+          }
           // Mantine's Select is not a native input, so `required` only marks it
           // visually — handleSubmit is what actually blocks an empty one.
           required={field.required}
@@ -561,7 +621,7 @@ const RuleEngineFormDialog = ({
         // numbers (@IsInt on points/sizes/order, @IsNumber on money, tons, km),
         // so let the field carry decimals and let a 400 catch the rest.
         step={isNumber ? "any" : undefined}
-        disabled={field.disabled || computed !== undefined}
+        disabled={field.disabled || (field.disabledOnEdit && !!initialRecord) || computed !== undefined}
         value={String((computed !== undefined ? computed : values[field.name]) ?? "")}
         onChange={(e) => {
           const next = e.currentTarget.value;
diff --git a/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineRecordActions.tsx b/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineRecordActions.tsx
index 96440c001..f724d5b60 100644
--- a/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineRecordActions.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/ruleEngine/RuleEngineRecordActions.tsx
@@ -14,7 +14,7 @@ import type { RuleEngineRecord } from "@/types/rule-engine";
 export interface RuleEngineRecordActionsProps {
   record: RuleEngineRecord;
   config: RuleEngineResourceConfig;
-  onEdit: (record: RuleEngineRecord) => void;
+  onEdit?: (record: RuleEngineRecord) => void;
   onDelete: (record: RuleEngineRecord) => void;
   onViewChain?: () => void;
   onSubmitRate?: (id: string) => void;
@@ -93,17 +93,19 @@ const RuleEngineRecordActions = ({
         ) : null}
 
         <div style={actionGroupStyle}>
-          <Button
-            variant="subtle"
-            color="gray"
-            size="compact-sm"
-            radius="md"
-            onClick={() => onEdit(record)}
-            leftSection={<Pencil size={14} />}
-            styles={{ root: { fontWeight: 600 } }}
-          >
-            Edit
-          </Button>
+          {onEdit ? (
+            <Button
+              variant="subtle"
+              color="gray"
+              size="compact-sm"
+              radius="md"
+              onClick={() => onEdit(record)}
+              leftSection={<Pencil size={14} />}
+              styles={{ root: { fontWeight: 600 } }}
+            >
+              Edit
+            </Button>
+          ) : null}
           <Button
             variant="subtle"
             color="red"
@@ -151,21 +153,23 @@ const RuleEngineRecordActions = ({
       ) : null}
 
       <div style={actionGroupStyle}>
-        <Tooltip label="Edit">
-          <ActionIcon
-            variant="subtle"
-            color="gray"
-            size="md"
-            radius="md"
-            onClick={() => onEdit(record)}
-            aria-label="Edit record"
-            style={{
-              background: "white",
-            }}
-          >
-            <Pencil size={16} />
-          </ActionIcon>
-        </Tooltip>
+        {onEdit ? (
+          <Tooltip label="Edit">
+            <ActionIcon
+              variant="subtle"
+              color="gray"
+              size="md"
+              radius="md"
+              onClick={() => onEdit(record)}
+              aria-label="Edit record"
+              style={{
+                background: "white",
+              }}
+            >
+              <Pencil size={16} />
+            </ActionIcon>
+          </Tooltip>
+        ) : null}
         <Tooltip label="Delete">
           <ActionIcon
             variant="subtle"
diff --git a/apps/edr-freight-web/backoffice/src/components/shipping-lines/CreditInvoiceActions.tsx b/apps/edr-freight-web/backoffice/src/components/shipping-lines/CreditInvoiceActions.tsx
new file mode 100644
index 000000000..6088d58f1
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/shipping-lines/CreditInvoiceActions.tsx
@@ -0,0 +1,363 @@
+import {
+  Badge,
+  Button,
+  Group,
+  Modal,
+  Stack,
+  Text,
+  Textarea,
+  TextInput,
+} from "@mantine/core";
+import { useMutation } from "@tanstack/react-query";
+import { Ban, Check, HandCoins, X } from "lucide-react";
+import { useState } from "react";
+
+import { useAuth } from "@/auth/useAuth";
+import { formatMoney } from "@/components/customers";
+import { useToast } from "@/hooks/use-toast";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { api } from "@/services/api";
+import type {
+  CreditInvoiceActionType,
+  CreditInvoicePendingAction,
+} from "@/types/shippingLineCredit";
+
+/** The slice of an invoice row the actions need — both list pages have it. */
+export interface CreditInvoiceActionTarget {
+  id: string;
+  invoiceNumber: string;
+  status: string;
+  currency: string;
+  totalAmount: string | number;
+  paidAmount: string | number;
+  balanceAmount: string | number;
+}
+
+/** Statuses an offline payment can still be recorded against. */
+const MARK_PAID_STATUSES = new Set([
+  "ISSUED",
+  "PENDING",
+  "PAYMENT_PROCESSING",
+  "PARTIALLY_PAID",
+  "OVERDUE",
+]);
+
+const ACTION_LABEL: Record<CreditInvoiceActionType, string> = {
+  MARK_PAID: "Mark paid",
+  CANCEL: "Cancel invoice",
+};
+
+export interface CreditInvoiceActionsProps {
+  invoice: CreditInvoiceActionTarget;
+  pendingAction: CreditInvoicePendingAction | null;
+}
+
+/**
+ * Two-step actions for ONE shipping-line credit invoice, embeddable in any
+ * invoice list. Gated purely by permission: the request grants raise
+ * mark-paid / cancel, the approve/reject grants decide ANY pending request —
+ * the holder's own included. Renders only the buttons the signed-in user's
+ * grants allow; the API enforces the same gates server-side.
+ */
+export default function CreditInvoiceActions({
+  invoice,
+  pendingAction,
+}: CreditInvoiceActionsProps) {
+  const { user } = useAuth();
+  const { toast } = useToast();
+
+  const canRequestPaid = hasPermission(
+    user,
+    FREIGHT_PERMS.shippingLineCredits.invoiceMarkPaid,
+  );
+  const canRequestCancel = hasPermission(
+    user,
+    FREIGHT_PERMS.shippingLineCredits.invoiceCancel,
+  );
+  const canApprove = hasPermission(
+    user,
+    FREIGHT_PERMS.shippingLineCredits.invoiceApprove,
+  );
+  const canReject = hasPermission(
+    user,
+    FREIGHT_PERMS.shippingLineCredits.invoiceReject,
+  );
+
+  const [requestAction, setRequestActionModal] =
+    useState<CreditInvoiceActionType | null>(null);
+  const [reason, setReason] = useState("");
+  const [paymentReference, setPaymentReference] = useState("");
+  const [decideApprove, setDecideApprove] = useState<boolean | null>(null);
+  const [decisionNote, setDecisionNote] = useState("");
+
+  const closeRequest = () => {
+    setRequestActionModal(null);
+    setReason("");
+    setPaymentReference("");
+  };
+  const closeDecide = () => {
+    setDecideApprove(null);
+    setDecisionNote("");
+  };
+
+  const { mutate: submitRequest, isPending: isRequesting } = useMutation(
+    api.shippingLineCredits.requestInvoiceAction.mutationOptions({
+      onSuccess: (_, variables) => {
+        closeRequest();
+        toast({
+          title: "Request submitted",
+          description: `${ACTION_LABEL[variables.action]} on ${invoice.invoiceNumber} now awaits a chief's approval.`,
+        });
+      },
+      onError: (err) =>
+        toast({
+          title: "Could not submit request",
+          description: err.message,
+          variant: "destructive",
+        }),
+    }),
+  );
+
+  const { mutate: submitDecision, isPending: isDeciding } = useMutation(
+    api.shippingLineCredits.decideInvoiceAction.mutationOptions({
+      onSuccess: (_, variables) => {
+        closeDecide();
+        toast({
+          title: variables.approve ? "Request approved" : "Request rejected",
+          description: variables.approve
+            ? pendingAction?.action === "MARK_PAID"
+              ? "The offline payment was recorded; the invoice and its credits are now paid."
+              : "The invoice was cancelled; its credits returned to the unbilled pool."
+            : "The request was rejected and nothing was changed.",
+        });
+      },
+      onError: (err) =>
+        toast({
+          title: "Could not decide request",
+          description: err.message,
+          variant: "destructive",
+        }),
+    }),
+  );
+
+  let body = null;
+  if (pendingAction) {
+    body = (
+      <Stack gap={6} py={4}>
+        <Badge variant="light" color="orange" title={pendingAction.reason}>
+          {ACTION_LABEL[pendingAction.action]} — awaiting approval
+        </Badge>
+        {canApprove || canReject ? (
+          <Group gap={6} wrap="nowrap">
+            {canApprove ? (
+              <Button
+                size="compact-xs"
+                color="edr-green"
+                leftSection={<Check size={12} />}
+                onClick={() => setDecideApprove(true)}
+              >
+                Approve
+              </Button>
+            ) : null}
+            {canReject ? (
+              <Button
+                size="compact-xs"
+                variant="outline"
+                color="red"
+                leftSection={<X size={12} />}
+                onClick={() => setDecideApprove(false)}
+              >
+                Reject
+              </Button>
+            ) : null}
+          </Group>
+        ) : null}
+      </Stack>
+    );
+  } else {
+    const showMarkPaid =
+      canRequestPaid && MARK_PAID_STATUSES.has(invoice.status);
+    const showCancel =
+      canRequestCancel &&
+      invoice.status !== "CANCELLED" &&
+      invoice.status !== "PAID" &&
+      invoice.status !== "REFUNDED" &&
+      Number(invoice.paidAmount) === 0;
+    body =
+      !showMarkPaid && !showCancel ? (
+        <Text size="sm" c="dimmed">
+          —
+        </Text>
+      ) : (
+        <Group gap={6} wrap="nowrap">
+          {showMarkPaid ? (
+            <Button
+              size="compact-xs"
+              variant="light"
+              color="edr-green"
+              leftSection={<HandCoins size={12} />}
+              onClick={() => setRequestActionModal("MARK_PAID")}
+            >
+              Mark paid
+            </Button>
+          ) : null}
+          {showCancel ? (
+            <Button
+              size="compact-xs"
+              variant="light"
+              color="red"
+              leftSection={<Ban size={12} />}
+              onClick={() => setRequestActionModal("CANCEL")}
+            >
+              Cancel
+            </Button>
+          ) : null}
+        </Group>
+      );
+  }
+
+  return (
+    <>
+      {body}
+
+      {/* Maker: raise the request. */}
+      <Modal
+        opened={requestAction !== null}
+        onClose={closeRequest}
+        title={
+          requestAction
+            ? `${ACTION_LABEL[requestAction]} — ${invoice.invoiceNumber}`
+            : ""
+        }
+        centered
+      >
+        <Stack gap="md">
+          <Text size="sm" c="dimmed">
+            {requestAction === "MARK_PAID"
+              ? "Records a full offline settlement of the outstanding balance. Takes effect only after a chief approves."
+              : "Voids the invoice and returns its credits to the unbilled pool. Takes effect only after a chief approves."}
+          </Text>
+          {requestAction === "MARK_PAID" ? (
+            <TextInput
+              label="Payment reference"
+              description="Bank slip / transfer number, if any."
+              value={paymentReference}
+              onChange={(e) => setPaymentReference(e.currentTarget.value)}
+            />
+          ) : null}
+          <Textarea
+            label="Reason"
+            withAsterisk
+            minRows={2}
+            placeholder={
+              requestAction === "MARK_PAID"
+                ? "Paid by bank transfer, slip #…"
+                : "Raised in error / rebilling with corrections…"
+            }
+            value={reason}
+            onChange={(e) => setReason(e.currentTarget.value)}
+          />
+          <Group justify="flex-end" gap="sm">
+            <Button
+              variant="default"
+              onClick={closeRequest}
+              disabled={isRequesting}
+            >
+              Cancel
+            </Button>
+            <Button
+              loading={isRequesting}
+              disabled={reason.trim().length < 3}
+              onClick={() =>
+                requestAction &&
+                submitRequest({
+                  invoiceId: invoice.id,
+                  action: requestAction,
+                  reason: reason.trim(),
+                  paymentReference: paymentReference.trim() || undefined,
+                })
+              }
+            >
+              Submit for approval
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+
+      {/* Checker: decide the request. */}
+      <Modal
+        opened={decideApprove !== null}
+        onClose={closeDecide}
+        title={
+          pendingAction
+            ? `${decideApprove ? "Approve" : "Reject"}: ${ACTION_LABEL[pendingAction.action]} — ${invoice.invoiceNumber}`
+            : ""
+        }
+        centered
+      >
+        <Stack gap="md">
+          {pendingAction ? (
+            <Stack gap={4}>
+              <Text size="sm">
+                <Text component="span" c="dimmed">
+                  Requested reason:{" "}
+                </Text>
+                {pendingAction.reason}
+              </Text>
+              {pendingAction.paymentReference ? (
+                <Text size="sm">
+                  <Text component="span" c="dimmed">
+                    Payment reference:{" "}
+                  </Text>
+                  {pendingAction.paymentReference}
+                </Text>
+              ) : null}
+            </Stack>
+          ) : null}
+          {decideApprove && pendingAction ? (
+            <Text size="sm" c="dimmed">
+              {pendingAction.action === "MARK_PAID"
+                ? `Approving records ${formatMoney(
+                    Number(invoice.balanceAmount ?? invoice.totalAmount),
+                    invoice.currency,
+                  )} as paid offline and settles the invoice's credits.`
+                : "Approving cancels the invoice and returns its credits to the unbilled pool."}
+            </Text>
+          ) : null}
+          <Textarea
+            label={decideApprove ? "Note (optional)" : "Rejection note"}
+            withAsterisk={!decideApprove}
+            minRows={2}
+            value={decisionNote}
+            onChange={(e) => setDecisionNote(e.currentTarget.value)}
+          />
+          <Group justify="flex-end" gap="sm">
+            <Button
+              variant="default"
+              onClick={closeDecide}
+              disabled={isDeciding}
+            >
+              Back
+            </Button>
+            <Button
+              color={decideApprove ? "edr-green" : "red"}
+              loading={isDeciding}
+              disabled={!decideApprove && !decisionNote.trim()}
+              onClick={() =>
+                pendingAction &&
+                decideApprove !== null &&
+                submitDecision({
+                  approvalId: pendingAction.id,
+                  approve: decideApprove,
+                  note: decisionNote.trim() || undefined,
+                })
+              }
+            >
+              {decideApprove ? "Approve & execute" : "Reject request"}
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/shipping-lines/ResendActivationAction.tsx b/apps/edr-freight-web/backoffice/src/components/shipping-lines/ResendActivationAction.tsx
new file mode 100644
index 000000000..ae271a57b
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/shipping-lines/ResendActivationAction.tsx
@@ -0,0 +1,168 @@
+import {
+  ActionIcon,
+  Alert,
+  Button,
+  Modal,
+  Radio,
+  Stack,
+  Text,
+  Tooltip,
+} from "@mantine/core";
+import { useMutation } from "@tanstack/react-query";
+import { Send } 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 {
+  ResetChannel,
+  ShippingLineCompany,
+} from "@/types/shippingLineCompany";
+
+/**
+ * Whether the SMS gateway can actually reach this number.
+ *
+ * The carrier integration is domestic-only: anything else is queued and
+ * silently lost, so a foreign number counts as unavailable rather than as a
+ * send that quietly fails. Mirrors `isDomesticPhone` in the API's otp.service.
+ */
+function isDomesticPhone(rawPhone: string): boolean {
+  const digits = rawPhone.trim().replace(/[^\d+]/g, "");
+  const normalized = digits.startsWith("+")
+    ? digits
+    : /^251\d{9}$/.test(digits)
+      ? `+${digits}`
+      : /^9\d{8}$|^7\d{8}$/.test(digits.replace(/^0+/, ""))
+        ? `+251${digits.replace(/^0+/, "")}`
+        : digits;
+  return /^\+2519\d{8}$/.test(normalized);
+}
+
+export interface ResendActivationActionProps {
+  shippingLine: Pick<ShippingLineCompany, "id" | "name" | "email" | "phoneNumber">;
+}
+
+/**
+ * Resend a shipping line's activation link.
+ *
+ * The same single-use link registration sends: the carrier opens it and picks
+ * their own password, so no credential is ever shown to or handled by staff.
+ * Needed whenever the original send failed, expired (24h), or never arrived.
+ */
+export default function ResendActivationAction({
+  shippingLine,
+}: ResendActivationActionProps) {
+  const { user } = useAuth();
+  const { toast } = useToast();
+  const [opened, setOpened] = useState(false);
+  const [channel, setChannel] = useState<ResetChannel>("email");
+
+  const allowed = hasPermission(user, FREIGHT_PERMS.shippingLines.resetPassword);
+
+  const { mutate, isPending } = useMutation(
+    api.shippingLineCompanies.resendActivation.mutationOptions({
+      onSuccess: (result) => {
+        setOpened(false);
+        toast({
+          title: "Activation link sent",
+          description: `The shipping line can set their password using the link sent to ${result.maskedTarget}. It expires in 24 hours.`,
+        });
+      },
+      onError: (error) => {
+        toast({
+          title: "Could not send activation link",
+          description: error.message,
+          variant: "destructive",
+        });
+      },
+    }),
+  );
+
+  if (!allowed) return null;
+
+  const phoneUsable =
+    !!shippingLine.phoneNumber && isDomesticPhone(shippingLine.phoneNumber);
+  const channelMissing = channel === "phone" && !phoneUsable;
+
+  return (
+    <>
+      <Tooltip label="Resend activation link" withArrow>
+        <ActionIcon
+          variant="subtle"
+          color="gray"
+          aria-label={`Resend activation link to ${shippingLine.name}`}
+          onClick={(event) => {
+            // The row itself is not clickable today, but stop here anyway so
+            // adding a detail-page navigation later cannot swallow this click.
+            event.stopPropagation();
+            setOpened(true);
+          }}
+        >
+          <Send size={16} />
+        </ActionIcon>
+      </Tooltip>
+
+      <Modal
+        opened={opened}
+        onClose={() => setOpened(false)}
+        title="Resend activation link"
+        centered
+      >
+        <Stack gap="md">
+          <Text size="sm" c="dimmed">
+            We&apos;ll send a single-use link to {shippingLine.name}. They choose
+            their own password — you will not see it. The link expires in 24
+            hours, and sending a new one invalidates nothing they haven&apos;t
+            already used.
+          </Text>
+
+          <Radio.Group
+            value={channel}
+            onChange={(v) => setChannel(v as ResetChannel)}
+            label="Send the link via"
+          >
+            <Stack gap="xs" mt="xs">
+              <Radio
+                value="email"
+                label="Email"
+                description={shippingLine.email}
+              />
+              <Radio
+                value="phone"
+                label="SMS"
+                disabled={!phoneUsable}
+                description={
+                  !shippingLine.phoneNumber
+                    ? "No phone number on this account"
+                    : !phoneUsable
+                      ? `${shippingLine.phoneNumber} — foreign number, SMS unavailable; use email`
+                      : shippingLine.phoneNumber
+                }
+              />
+            </Stack>
+          </Radio.Group>
+
+          {channelMissing ? (
+            <Alert color="yellow" variant="light" p="sm">
+              <Text size="sm">
+                This account has no number the SMS gateway can reach. Send the
+                link by email instead.
+              </Text>
+            </Alert>
+          ) : null}
+
+          <Button
+            color="edr-green"
+            loading={isPending}
+            disabled={channelMissing}
+            onClick={() => mutate({ id: shippingLine.id, channel })}
+          >
+            Send activation link
+          </Button>
+        </Stack>
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/trainBuilder/AvailableWagonsPanel.tsx b/apps/edr-freight-web/backoffice/src/components/trainBuilder/AvailableWagonsPanel.tsx
index 1bddb77cd..7077f3fdf 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainBuilder/AvailableWagonsPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainBuilder/AvailableWagonsPanel.tsx
@@ -4,34 +4,40 @@ import {
   Button,
   Checkbox,
   Group,
+  Pagination,
   ScrollArea,
   Select,
   Stack,
   Text,
   TextInput,
 } from "@mantine/core";
+import { useDebouncedValue } from "@mantine/hooks";
 import { useQuery } from "@tanstack/react-query";
-import { Plus, Search } from "lucide-react";
-import { useMemo, useState } from "react";
+import { MapPin, Plus, Search } from "lucide-react";
+import { memo, useCallback, useEffect, useMemo, useState } from "react";
+
+const PAGE_SIZE = 20;
 
 import { api } from "@/services/api";
 
 /**
- * AVAILABLE wagons standing in the train's own yard — the only ones that can
- * be coupled. Pick any number and append them to the consist.
+ * AVAILABLE, unassigned wagons from every yard — filtered and paged on the API,
+ * so the picker never page-walks the whole fleet into the browser.
  */
-export default function AvailableWagonsPanel({
-  yardId,
-  yardLabel,
+function AvailableWagonsPanel({
+  homeYardId,
   onAssign,
   assigning,
   exportTrainNumber,
   importTrainNumber,
 }: AvailableWagonsPanelProps) {
   const [search, setSearch] = useState("");
+  const [debouncedSearch] = useDebouncedValue(search, 300);
   const [typeFilter, setTypeFilter] = useState<string>("ALL");
+  const [yardFilter, setYardFilter] = useState<string>("ALL");
   const [runOnly, setRunOnly] = useState(false);
-  const [selected, setSelected] = useState<string[]>([]);
+  const [selected, setSelected] = useState<ReadonlySet<string>>(() => new Set());
+  const [page, setPage] = useState(1);
 
   // The train's own run, e.g. "8001-8002" — only offered when the train has one.
   const runLabel = exportTrainNumber
@@ -39,86 +45,95 @@ export default function AvailableWagonsPanel({
     : null;
 
   const wagonsQuery = useQuery(
-    api.wagons.list.queryOptions({
+    api.wagons.listPaged.queryOptions({
       input: {
         filters: {
           status: Freight.WagonStatus.Available,
-          currentYardId: yardId,
           // Loose wagons only — one already on another train cannot be coupled.
           unassigned: true,
+          search: debouncedSearch.trim() || undefined,
+          currentYardId: yardFilter === "ALL" ? undefined : yardFilter,
+          wagonTypeId: typeFilter === "ALL" ? undefined : typeFilter,
+          // Rostered to this train's run — the API matches either run column.
+          trainNumber: runOnly && exportTrainNumber ? exportTrainNumber : undefined,
+          page,
+          pageSize: PAGE_SIZE,
         },
       },
-      enabled: Boolean(yardId),
+      // Keep the previous page on screen while the next one loads — otherwise
+      // paging and typing flash the list to "Loading wagons…" on every stroke.
+      placeholderData: (prev) => prev,
     }),
   );
 
-  const wagons = useMemo(() => {
-    const q = search.trim().toLowerCase();
-    return (wagonsQuery.data ?? []).filter((wagon) => {
-      if (typeFilter !== "ALL" && wagon.wagonTypeId !== typeFilter) return false;
-      // Rostered to this train's run — match on the export run, which fixes the
-      // import run anyway.
-      if (runOnly && wagon.exportTrainNumber !== exportTrainNumber) return false;
-      if (q && !wagon.wagonNumber.toLowerCase().includes(q)) return false;
-      return true;
-    });
-  }, [wagonsQuery.data, search, typeFilter, runOnly, exportTrainNumber]);
+  const wagons = wagonsQuery.data?.items ?? [];
+  const total = wagonsQuery.data?.meta.total ?? 0;
+  const totalPages = Math.max(1, wagonsQuery.data?.meta.totalPages ?? 1);
 
-  const runMatchCount = useMemo(
-    () =>
-      exportTrainNumber
-        ? (wagonsQuery.data ?? []).filter(
-            (w) => w.exportTrainNumber === exportTrainNumber,
-          ).length
-        : 0,
-    [wagonsQuery.data, exportTrainNumber],
+  // Filters change → back to page 1 (and clamp when the list shrinks).
+  useEffect(() => {
+    setPage(1);
+  }, [debouncedSearch, typeFilter, yardFilter, runOnly]);
+  useEffect(() => {
+    if (page > totalPages) setPage(totalPages);
+  }, [page, totalPages]);
+
+  // Dropdowns come from the reference lists, not the current page — a yard or
+  // type must stay pickable even when this page holds none of it.
+  const yardsQuery = useQuery(api.routes.yards.queryOptions({ staleTime: 5 * 60_000 }));
+  const wagonTypesQuery = useQuery(api.wagonTypes.list.queryOptions({ staleTime: 5 * 60_000 }));
+
+  const yardOptions = useMemo(() => {
+    const yards = [...(yardsQuery.data ?? [])].sort((a, b) =>
+      a.id === homeYardId ? -1 : b.id === homeYardId ? 1 : a.label.localeCompare(b.label),
+    );
+    return [
+      { value: "ALL", label: "All yards" },
+      ...yards.map((yard) => ({
+        value: yard.id,
+        label: `${yard.label}${yard.id === homeYardId ? " · train's yard" : ""}`,
+      })),
+    ];
+  }, [yardsQuery.data, homeYardId]);
+
+  const typeOptions = useMemo(
+    () => [
+      { value: "ALL", label: "All types" },
+      // e.g. "Flat wagon (NW5)" — name with its type code.
+      ...(wagonTypesQuery.data ?? []).map((type) => ({
+        value: type.id,
+        label: type.code ? `${type.name} (${type.code})` : type.name,
+      })),
+    ],
+    [wagonTypesQuery.data],
   );
 
-  const typeOptions = useMemo(() => {
-    const byId = new Map<string, string>();
-    for (const wagon of wagonsQuery.data ?? []) {
-      if (wagon.wagonType) {
-        // e.g. "Flat wagon (NW5)" — name with its type code.
-        byId.set(
-          wagon.wagonType.id,
-          wagon.wagonType.code
-            ? `${wagon.wagonType.name} (${wagon.wagonType.code})`
-            : wagon.wagonType.name,
-        );
-      }
-    }
-    return [
-      { value: "ALL", label: "All types" },
-      ...[...byId.entries()].map(([value, label]) => ({ value, label })),
-    ];
-  }, [wagonsQuery.data]);
+  const toggle = useCallback((wagonId: string, checked: boolean) => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (checked) next.add(wagonId);
+      else next.delete(wagonId);
+      return next;
+    });
+  }, []);
 
-  const toggle = (wagonId: string, checked: boolean) => {
-    setSelected((prev) =>
-      checked ? [...prev, wagonId] : prev.filter((id) => id !== wagonId),
-    );
-  };
-
-  const allSelected =
-    wagons.length > 0 && wagons.every((w) => selected.includes(w.id));
-  const someSelected = wagons.some((w) => selected.includes(w.id));
+  // Select-all covers this page only — the rest of the matches are not loaded.
+  const allSelected = wagons.length > 0 && wagons.every((w) => selected.has(w.id));
+  const someSelected = wagons.some((w) => selected.has(w.id));
 
   const toggleAll = (checked: boolean) => {
     setSelected((prev) => {
-      if (checked) {
-        const ids = new Set(prev);
-        wagons.forEach((w) => ids.add(w.id));
-        return [...ids];
-      }
-      const visible = new Set(wagons.map((w) => w.id));
-      return prev.filter((id) => !visible.has(id));
+      const next = new Set(prev);
+      if (checked) wagons.forEach((w) => next.add(w.id));
+      else wagons.forEach((w) => next.delete(w.id));
+      return next;
     });
   };
 
   const handleAssign = () => {
-    if (!selected.length) return;
-    onAssign(selected);
-    setSelected([]);
+    if (!selected.size) return;
+    onAssign([...selected]);
+    setSelected(new Set());
   };
 
   return (
@@ -138,100 +153,102 @@ export default function AvailableWagonsPanel({
           onChange={(v) => setTypeFilter(v ?? "ALL")}
         />
       </Group>
+      <Select
+        size="sm"
+        leftSection={<MapPin size={14} />}
+        data={yardOptions}
+        value={yardFilter}
+        onChange={(v) => setYardFilter(v ?? "ALL")}
+        searchable
+        aria-label="Filter by yard"
+      />
 
       {runLabel ? (
         <Checkbox
           size="sm"
-          label={`Only wagons on this train's run (${runLabel}) — ${runMatchCount} here`}
+          label={`Only wagons on this train's run (${runLabel})`}
           checked={runOnly}
           onChange={(e) => setRunOnly(e.currentTarget.checked)}
         />
       ) : null}
 
       {wagons.length ? (
-        <Checkbox
-          size="sm"
-          label={`Select all (${wagons.length})`}
-          checked={allSelected}
-          indeterminate={!allSelected && someSelected}
-          onChange={(e) => toggleAll(e.currentTarget.checked)}
-        />
+        <Group justify="space-between" wrap="nowrap">
+          <Checkbox
+            size="sm"
+            label={`Select all on this page (${wagons.length})`}
+            checked={allSelected}
+            indeterminate={!allSelected && someSelected}
+            onChange={(e) => toggleAll(e.currentTarget.checked)}
+          />
+          {selected.size ? (
+            <Text size="xs" c="dimmed">
+              {selected.size} selected
+            </Text>
+          ) : null}
+        </Group>
       ) : null}
 
       <ScrollArea.Autosize mah={380} type="auto">
-        <Stack gap={6}>
+        {/* Previous results stay put while the next page loads (placeholderData),
+            so dim them rather than blanking the list. */}
+        <Stack
+          gap={6}
+          style={{
+            opacity: wagonsQuery.isFetching && !wagonsQuery.isLoading ? 0.55 : 1,
+            transition: "opacity 120ms ease",
+          }}
+        >
           {wagonsQuery.isLoading ? (
             <Text py="md" ta="center" c="dimmed" size="sm">
               Loading wagons…
             </Text>
           ) : !wagons.length ? (
             <Text py="md" ta="center" c="dimmed" size="sm">
-              No available wagons in {yardLabel ?? "this yard"}
+              No available wagons match
             </Text>
           ) : (
             wagons.map((wagon) => (
-              <Group
+              <WagonOption
                 key={wagon.id}
-                gap="sm"
-                wrap="nowrap"
-                p="xs"
-                style={{
-                  border: "1px solid var(--mantine-color-gray-2)",
-                  borderRadius: "var(--mantine-radius-md)",
-                }}
-              >
-                <Checkbox
-                  size="sm"
-                  checked={selected.includes(wagon.id)}
-                  onChange={(e) => toggle(wagon.id, e.currentTarget.checked)}
-                  aria-label={`Select wagon ${wagon.wagonNumber}`}
-                />
-                <Stack gap={0} style={{ flex: 1, minWidth: 0 }}>
-                  <Group gap={6} wrap="nowrap">
-                    <Text size="sm" fw={600} ff="monospace" truncate>
-                      {wagon.wagonNumber}
-                    </Text>
-                    {wagon.exportTrainNumber ? (
-                      <Badge
-                        size="xs"
-                        radius="sm"
-                        variant="light"
-                        color={
-                          wagon.exportTrainNumber === exportTrainNumber ? "edr-green" : "gray"
-                        }
-                      >
-                        {wagon.exportTrainNumber}
-                        {wagon.importTrainNumber ? `-${wagon.importTrainNumber}` : ""}
-                      </Badge>
-                    ) : null}
-                  </Group>
-                  <Text size="xs" c="dimmed" truncate>
-                    {wagon.wagonType
-                      ? `${wagon.wagonType.name} · ${wagon.wagonType.capacityTons ?? "—"}T cap`
-                      : "Unknown type"}
-                  </Text>
-                </Stack>
-              </Group>
+                wagon={wagon}
+                selected={selected.has(wagon.id)}
+                homeYardId={homeYardId}
+                exportTrainNumber={exportTrainNumber}
+                onToggle={toggle}
+              />
             ))
           )}
         </Stack>
       </ScrollArea.Autosize>
 
+      {totalPages > 1 ? (
+        <Group justify="space-between" wrap="nowrap">
+          <Text size="xs" c="dimmed">
+            {(page - 1) * PAGE_SIZE + 1}–{Math.min(page * PAGE_SIZE, total)} of {total}
+          </Text>
+          <Pagination size="sm" value={page} onChange={setPage} total={totalPages} />
+        </Group>
+      ) : null}
+
       <Button
         leftSection={<Plus size={16} />}
-        disabled={!selected.length}
+        disabled={!selected.size}
         loading={assigning}
         onClick={handleAssign}
       >
-        Add {selected.length ? `${selected.length} wagon${selected.length > 1 ? "s" : ""}` : "wagons"} to consist
+        Add {selected.size ? `${selected.size} wagon${selected.size > 1 ? "s" : ""}` : "wagons"} to consist
       </Button>
     </Stack>
   );
 }
 
+/** Memoized: the workspace re-renders on every pending mutation. */
+export default memo(AvailableWagonsPanel);
+
 export interface AvailableWagonsPanelProps {
-  yardId: string;
-  yardLabel?: string | null;
+  /** The train's own yard — sorted first and highlighted; not a restriction. */
+  homeYardId: string | null;
   onAssign: (wagonIds: string[]) => void;
   assigning: boolean;
   /** This train's odd EXPORT run — drives the "only this run" filter. */
@@ -239,3 +256,81 @@ export interface AvailableWagonsPanelProps {
   /** This train's even IMPORT run — label only; the export run does the matching. */
   importTrainNumber?: string | null;
 }
+
+/**
+ * One selectable wagon row. Memoized: the picker re-renders on every keystroke
+ * and every selection change, but a row only actually changes when its own
+ * checkbox flips — so a full page of rows stays untouched.
+ */
+const WagonOption = memo(function WagonOption({
+  wagon,
+  selected,
+  homeYardId,
+  exportTrainNumber,
+  onToggle,
+}: {
+  wagon: {
+    id: string;
+    wagonNumber: string;
+    currentYardId?: string | null;
+    currentYard?: { label?: string | null; code?: string | null } | null;
+    exportTrainNumber?: string | null;
+    importTrainNumber?: string | null;
+    wagonType?: { name?: string | null; capacityTons?: number | null } | null;
+  };
+  selected: boolean;
+  homeYardId: string | null;
+  exportTrainNumber?: string | null;
+  onToggle: (wagonId: string, checked: boolean) => void;
+}) {
+  return (
+    <Group
+      gap="sm"
+      wrap="nowrap"
+      p="xs"
+      style={{
+        border: "1px solid var(--mantine-color-gray-2)",
+        borderRadius: "var(--mantine-radius-md)",
+      }}
+    >
+      <Checkbox
+        size="sm"
+        checked={selected}
+        onChange={(e) => onToggle(wagon.id, e.currentTarget.checked)}
+        aria-label={`Select wagon ${wagon.wagonNumber}`}
+      />
+      <Stack gap={0} style={{ flex: 1, minWidth: 0 }}>
+        <Group gap={6} wrap="nowrap">
+          <Text size="sm" fw={600} ff="monospace" truncate>
+            {wagon.wagonNumber}
+          </Text>
+          <Badge
+            size="xs"
+            radius="sm"
+            variant="outline"
+            color={wagon.currentYardId === homeYardId ? "edr-green" : "gray"}
+            leftSection={<MapPin size={10} />}
+          >
+            {wagon.currentYard?.label ?? wagon.currentYard?.code ?? "No yard"}
+          </Badge>
+          {wagon.exportTrainNumber ? (
+            <Badge
+              size="xs"
+              radius="sm"
+              variant="light"
+              color={wagon.exportTrainNumber === exportTrainNumber ? "edr-green" : "gray"}
+            >
+              {wagon.exportTrainNumber}
+              {wagon.importTrainNumber ? `-${wagon.importTrainNumber}` : ""}
+            </Badge>
+          ) : null}
+        </Group>
+        <Text size="xs" c="dimmed" truncate>
+          {wagon.wagonType
+            ? `${wagon.wagonType.name} · ${wagon.wagonType.capacityTons ?? "—"}T cap`
+            : "Unknown type"}
+        </Text>
+      </Stack>
+    </Group>
+  );
+});
diff --git a/apps/edr-freight-web/backoffice/src/components/trainBuilder/BuildTrainModal.tsx b/apps/edr-freight-web/backoffice/src/components/trainBuilder/BuildTrainModal.tsx
index 21033e7fe..23c6fb220 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainBuilder/BuildTrainModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainBuilder/BuildTrainModal.tsx
@@ -88,7 +88,7 @@ export default function BuildTrainModal({ opened, onClose, onBuilt }: BuildTrain
   const handleBuild = async () => {
     if (!trainName.trim()) {
       toast({
-        title: "Enter the vogue number",
+        title: "Enter the voyage number",
         variant: "destructive",
       });
       return;
@@ -150,8 +150,8 @@ export default function BuildTrainModal({ opened, onClose, onBuilt }: BuildTrain
           wagons are attached on the next screen.
         </Text>
         <TextInput
-          label="Vogue number"
-          placeholder="Enter vogue number"
+          label="Voyage number"
+          placeholder="Enter voyage number"
           value={trainName}
           onChange={(e) => setTrainName(e.currentTarget.value)}
           maxLength={100}
diff --git a/apps/edr-freight-web/backoffice/src/components/trainBuilder/ConsistWagonList.tsx b/apps/edr-freight-web/backoffice/src/components/trainBuilder/ConsistWagonList.tsx
index 2aab0ca10..d206fca83 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainBuilder/ConsistWagonList.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainBuilder/ConsistWagonList.tsx
@@ -6,11 +6,13 @@ import {
   type DraggableStateSnapshot,
   type DropResult,
 } from "@hello-pangea/dnd";
-import { ActionIcon, Badge, Box, Group, Stack, Text, Tooltip } from "@mantine/core";
-import { GripVertical, Trash2, Wrench } from "lucide-react";
-import { type ReactNode } from "react";
+import { ActionIcon, Badge, Box, Group, Menu, Stack, Text, Tooltip } from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import { GripVertical, MapPin, Trash2, Wrench } from "lucide-react";
+import { memo, useCallback, useMemo, type ReactNode } from "react";
 import { createPortal } from "react-dom";
 
+import { api } from "@/services/api";
 import type { TrainCompositionWagon } from "@/services/trainBuilder.service";
 import { wagonTypeColor } from "./trainStatus";
 
@@ -32,15 +34,16 @@ const PortalAwareRow = ({
  * The train's ordered wagon consist. Drag to reorder (persisted on drop),
  * trash to detach a wagon back to the yard.
  */
-export default function ConsistWagonList({
+function ConsistWagonList({
   wagons,
   editable,
   onReorder,
   onRemove,
   onMaintenance,
+  onChangeYard,
   busy = false,
 }: ConsistWagonListProps) {
-  const onDragEnd = (result: DropResult) => {
+  const onDragEnd = useCallback((result: DropResult) => {
     if (!result.destination) return;
     const from = result.source.index;
     const to = result.destination.index;
@@ -49,7 +52,18 @@ export default function ConsistWagonList({
     const [moved] = next.splice(from, 1);
     next.splice(to, 0, moved!);
     onReorder(next.map((w) => w.id));
-  };
+  }, [wagons, onReorder]);
+
+  // Legend of the types actually coupled, in consist order — the colour code is
+  // only readable if the row tints are keyed somewhere.
+  const legend = useMemo(
+    () => [
+      ...new Map(
+        wagons.filter((w) => w.wagonType).map((w) => [w.wagonType!.code, w.wagonType!]),
+      ).values(),
+    ],
+    [wagons],
+  );
 
   if (!wagons.length) {
     return (
@@ -59,16 +73,6 @@ export default function ConsistWagonList({
     );
   }
 
-  // Legend of the types actually coupled, in consist order — the colour code is
-  // only readable if the row tints are keyed somewhere.
-  const legend = [
-    ...new Map(
-      wagons
-        .filter((w) => w.wagonType)
-        .map((w) => [w.wagonType!.code, w.wagonType!]),
-    ).values(),
-  ];
-
   return (
     <DragDropContext onDragEnd={onDragEnd}>
       <Droppable droppableId="train-consist-wagons" isDropDisabled={!editable || busy}>
@@ -106,6 +110,7 @@ export default function ConsistWagonList({
                     busy={busy}
                     onRemove={onRemove}
                     onMaintenance={onMaintenance}
+                    onChangeYard={onChangeYard}
                   />
                 )}
               </Draggable>
@@ -118,6 +123,9 @@ export default function ConsistWagonList({
   );
 }
 
+/** Memoized: a 40-wagon consist re-renders every row otherwise. */
+export default memo(ConsistWagonList);
+
 export interface ConsistWagonListProps {
   wagons: TrainCompositionWagon[];
   editable: boolean;
@@ -125,10 +133,69 @@ export interface ConsistWagonListProps {
   onRemove: (wagonId: string) => void;
   /** Detach the wagon and move it to MAINTENANCE status (page confirms first). */
   onMaintenance: (wagon: TrainCompositionWagon) => void;
+  /** Move one wagon to another yard from its yard badge; absent = read-only badge. */
+  onChangeYard?: (wagonId: string, currentYardId: string) => void;
   busy?: boolean;
 }
 
-function WagonRow({
+/** Yard badge that opens a yard picker when `onChange` is provided. */
+function WagonYardBadge({
+  wagon,
+  busy,
+  onChange,
+}: {
+  wagon: TrainCompositionWagon;
+  busy: boolean;
+  onChange?: (wagonId: string, currentYardId: string) => void;
+}) {
+  const label = wagon.currentYard?.label ?? wagon.currentYard?.code ?? "No yard";
+  const yardsQuery = useQuery(
+    api.routes.yards.queryOptions({ staleTime: 5 * 60_000, enabled: Boolean(onChange) }),
+  );
+  if (!onChange) {
+    return wagon.currentYard ? (
+      <Badge variant="outline" color="gray" size="xs" radius="sm" leftSection={<MapPin size={10} />}>
+        {label}
+      </Badge>
+    ) : null;
+  }
+  return (
+    <Menu shadow="md" width={240} withinPortal>
+      <Menu.Target>
+        <Badge
+          component="button"
+          type="button"
+          variant="outline"
+          color="blue"
+          size="xs"
+          radius="sm"
+          leftSection={<MapPin size={10} />}
+          disabled={busy}
+          style={{ cursor: busy ? "default" : "pointer" }}
+          // Stop the drag handle from swallowing the click.
+          onMouseDown={(e) => e.stopPropagation()}
+          aria-label={`Change yard of wagon ${wagon.wagonNumber}`}
+        >
+          {label}
+        </Badge>
+      </Menu.Target>
+      <Menu.Dropdown>
+        <Menu.Label>Move wagon to yard</Menu.Label>
+        {(yardsQuery.data ?? []).map((y) => (
+          <Menu.Item
+            key={y.id}
+            disabled={y.id === wagon.currentYard?.id}
+            onClick={() => onChange(wagon.id, y.id)}
+          >
+            {y.label ?? y.code}
+          </Menu.Item>
+        ))}
+      </Menu.Dropdown>
+    </Menu>
+  );
+}
+
+const WagonRow = memo(function WagonRow({
   wagon,
   index,
   dragProvided,
@@ -137,6 +204,7 @@ function WagonRow({
   busy,
   onRemove,
   onMaintenance,
+  onChangeYard,
 }: {
   wagon: TrainCompositionWagon;
   index: number;
@@ -146,6 +214,7 @@ function WagonRow({
   busy: boolean;
   onRemove: (wagonId: string) => void;
   onMaintenance: (wagon: TrainCompositionWagon) => void;
+  onChangeYard?: (wagonId: string, currentYardId: string) => void;
 }) {
   const color = wagonTypeColor(wagon.wagonType?.code);
 
@@ -191,6 +260,7 @@ function WagonRow({
                 {wagon.wagonType.code}
               </Badge>
             ) : null}
+            <WagonYardBadge wagon={wagon} busy={busy} onChange={onChangeYard} />
           </Group>
           <Text size="xs" c="dimmed" truncate>
             {wagon.wagonType
@@ -227,4 +297,4 @@ function WagonRow({
       </Group>
     </PortalAwareRow>
   );
-}
+});
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/BookingWindowSettingsModal.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/BookingWindowSettingsModal.tsx
index d09bce567..9bf95a01f 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/BookingWindowSettingsModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/BookingWindowSettingsModal.tsx
@@ -27,7 +27,8 @@ import type { UpdateScheduleWindowRulePayload } from "@/types/trainScheduling";
 /** Fallbacks matching the API's global-rules defaults (used when a field is null). */
 const DEFAULTS = {
   windowOpenHour: 8,
-  windowCloseHour: 17,
+  // Equal to open ⇒ 24-hour desk (the default).
+  windowCloseHour: 8,
   windowDurationHours: 3,
   docReviewMinutes: 30,
   paymentWindowMinutes: 60,
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/CheckpointTimeModal.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/CheckpointTimeModal.tsx
new file mode 100644
index 000000000..6d748b559
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/CheckpointTimeModal.tsx
@@ -0,0 +1,103 @@
+import { Button, Group, Modal, Stack, Text, Textarea } from "@mantine/core";
+import { DateTimePicker } from "@mantine/dates";
+import { useEffect, useState } from "react";
+
+/**
+ * Time + note for one leg of a train's journey — used both to log a pass
+ * (defaults to now) and to correct an already-logged leg (prefilled). Past
+ * times are allowed (staff record after the fact); the future is not, and the
+ * server additionally keeps legs in corridor order.
+ */
+export function CheckpointTimeModal({
+  opened,
+  onClose,
+  title,
+  icon,
+  description,
+  initialOccurredAt,
+  initialNote,
+  submitLabel,
+  submitColor = "edr-green",
+  loading,
+  onSubmit,
+}: {
+  opened: boolean;
+  onClose: () => void;
+  title: string;
+  icon?: React.ReactNode;
+  description?: string;
+  /** ISO; omit to default to now. */
+  initialOccurredAt?: string | null;
+  initialNote?: string | null;
+  submitLabel: string;
+  submitColor?: string;
+  loading: boolean;
+  onSubmit: (values: { occurredAt: string; note: string }) => void;
+}) {
+  const [at, setAt] = useState<Date | null>(null);
+  const [note, setNote] = useState("");
+  useEffect(() => {
+    if (!opened) return;
+    setAt(initialOccurredAt ? new Date(initialOccurredAt) : new Date());
+    setNote(initialNote ?? "");
+  }, [opened, initialOccurredAt, initialNote]);
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      centered
+      radius="lg"
+      title={
+        <Group gap={8}>
+          {icon}
+          <Text fw={700}>{title}</Text>
+        </Group>
+      }
+    >
+      <Stack gap="md">
+        {description ? (
+          <Text size="sm" c="dimmed">
+            {description}
+          </Text>
+        ) : null}
+        <DateTimePicker
+          label="Time"
+          description="Defaults to now — pick an earlier time if you are recording after the fact."
+          value={at}
+          onChange={(v) => setAt(v ? new Date(v) : null)}
+          maxDate={new Date()}
+          valueFormat="DD MMM YYYY HH:mm"
+          clearable={false}
+          radius="md"
+        />
+        <Textarea
+          label="Note"
+          placeholder="Optional"
+          value={note}
+          onChange={(e) => setNote(e.currentTarget.value)}
+          autosize
+          minRows={2}
+          maxRows={4}
+          maxLength={500}
+          radius="md"
+        />
+        <Group justify="flex-end" gap="sm">
+          <Button variant="default" onClick={onClose} disabled={loading}>
+            Cancel
+          </Button>
+          <Button
+            color={submitColor}
+            loading={loading}
+            disabled={!at}
+            onClick={() =>
+              at && onSubmit({ occurredAt: at.toISOString(), note: note.trim() })
+            }
+          >
+            {submitLabel}
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/CreateScheduleWindowFields.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/CreateScheduleWindowFields.tsx
index b0de39baa..6d618eb64 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/CreateScheduleWindowFields.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/CreateScheduleWindowFields.tsx
@@ -22,7 +22,8 @@ import type { CreateScheduleWindowRulePayload } from "@/types/trainScheduling";
 /** Fallbacks matching the API's global-rules defaults (used if the fetch fails). */
 const DEFAULTS = {
   windowOpenHour: 8,
-  windowCloseHour: 17,
+  // Equal to open ⇒ 24-hour desk (the default).
+  windowCloseHour: 8,
   windowDurationHours: 3,
   docReviewMinutes: 30,
   paymentWindowMinutes: 60,
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/EligibleBookingsPanel.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/EligibleBookingsPanel.tsx
index 27122d68c..641903b58 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/EligibleBookingsPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/EligibleBookingsPanel.tsx
@@ -1,7 +1,9 @@
 import { useMemo } from "react";
+import { Link } from "react-router-dom";
 import { ArrowRight, Landmark, Package } from "lucide-react";
 import {
   Accordion,
+  Anchor,
   Badge,
   Button,
   Checkbox,
@@ -50,9 +52,20 @@ function EligibleBookingRow({
       <Stack gap={4} style={{ flex: 1 }}>
         <Group gap="xs" wrap="wrap">
           <Package size={14} />
-          <Text fw={600} size="sm">
+          {/* Opens the booking in a new tab: the row is a selection control in
+              an allocation flow, so navigating away would lose staff's picks. */}
+          <Anchor
+            component={Link}
+            to={`/dashboard/booking-requests/${booking.id}`}
+            target="_blank"
+            fw={600}
+            size="sm"
+            c="edr-green.8"
+            underline="hover"
+            onClick={(e) => e.stopPropagation()}
+          >
             {booking.reference}
-          </Text>
+          </Anchor>
           {resolvedFreightType ? (
             <Badge variant="outline" size="xs">
               {resolvedFreightType}
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegCapacityPanel.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegCapacityPanel.tsx
index c98a020a5..c006c9e03 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegCapacityPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegCapacityPanel.tsx
@@ -14,6 +14,7 @@ import {
 } from "@mantine/core";
 import { ChevronDown, ChevronRight, Info, Train, Weight } from "lucide-react";
 
+import { EntityLink } from "@/components/detail";
 import type { TrainScheduleDetail } from "@/types/trainScheduling";
 
 /**
@@ -254,15 +255,19 @@ export function LegCapacityPanel({ schedule }: { schedule: TrainScheduleDetail }
                                     {e.bookings.map((b) => (
                                       <Table.Tr key={b.bookingId}>
                                         <Table.Td w="50%">
-                                          <Text size="sm" fw={500} style={{ whiteSpace: "nowrap" }}>
-                                            {b.reference}
+                                          <Group gap={4} wrap="nowrap" style={{ whiteSpace: "nowrap" }}>
+                                            <EntityLink
+                                              to={`/dashboard/booking-requests/${b.bookingId}`}
+                                              label={b.reference}
+                                              size="sm"
+                                              fw={500}
+                                            />
                                             {b.route ? (
                                               <Text span size="xs" c="dimmed">
-                                                {" "}
                                                 ({b.route})
                                               </Text>
                                             ) : null}
-                                          </Text>
+                                          </Group>
                                         </Table.Td>
                                         <Table.Td w="25%">
                                           <Group gap={4} wrap="nowrap">
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegLoadBoardPanel.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegLoadBoardPanel.tsx
new file mode 100644
index 000000000..04b5e77de
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LegLoadBoardPanel.tsx
@@ -0,0 +1,423 @@
+import { Fragment, useEffect, useMemo, useState } from "react";
+import { useMutation } from "@tanstack/react-query";
+import { isAxiosError } from "axios";
+import {
+  Alert,
+  Badge,
+  Button,
+  Group,
+  Paper,
+  Stack,
+  Table,
+  Text,
+  Tooltip,
+} from "@mantine/core";
+import { ArrowLeftRight, Boxes, Info, MoveRight, Wheat, X } from "lucide-react";
+
+import { api } from "@/services/api";
+import { useToast } from "@/hooks/use-toast";
+import type { TrainScheduleDetail } from "@/types/trainScheduling";
+
+type Slot = NonNullable<TrainScheduleDetail["trainSet"]>["wagons"][number];
+type Stop = { yardId: string; label: string };
+type Span = [number, number];
+
+/** One physical wagon of the consist with every slot (leg load) pinned to it. */
+interface WagonRow {
+  key: string;
+  physicalWagonId: string | null;
+  label: string;
+  position: number;
+  typeCode: string | null;
+  capacityTons: number;
+  slots: Array<{ slot: Slot; span: Span; loaded: boolean }>;
+}
+
+const round1 = (n: number) => Math.round(n * 10) / 10;
+const overlaps = (a: Span, b: Span) => a[0] < b[1] && b[0] < a[1];
+
+/**
+ * Leg board: rows = physical wagons in coupling order, columns = corridor legs
+ * (A→B, B→C, …). A wagon reused on disjoint legs shows one load per leg on the
+ * same row, so a "53 full on A→B, 53 full on C→D" train reads at a glance.
+ * Loads move by click: pick a load, then click a wagon that is free on that
+ * load's legs (move) or another load (swap). Same API as the consist strip.
+ */
+export function LegLoadBoardPanel({
+  schedule,
+  onChanged,
+}: {
+  schedule: TrainScheduleDetail;
+  onChanged?: () => void;
+}) {
+  const { toast } = useToast();
+  const stops: Stop[] = schedule.stops ?? [];
+  const legs = useMemo(
+    () => stops.slice(0, -1).map((from, i) => ({ from, to: stops[i + 1], idx: i })),
+    [stops],
+  );
+  const canRearrange = !["DISPATCHED", "ARRIVED", "CANCELLED"].includes(schedule.status);
+
+  const spanOf = (slot: Slot): Span => {
+    const from = slot.boardYardId ? stops.findIndex((s) => s.yardId === slot.boardYardId) : 0;
+    const to = slot.alightYardId
+      ? stops.findIndex((s) => s.yardId === slot.alightYardId)
+      : stops.length - 1;
+    return [from < 0 ? 0 : from, to < 0 ? Math.max(1, stops.length - 1) : to];
+  };
+
+  const rows: WagonRow[] = useMemo(() => {
+    const byKey = new Map<string, WagonRow>();
+    for (const slot of schedule.trainSet?.wagons ?? []) {
+      const key = slot.physicalWagonId ?? `slot:${slot.id}`;
+      let row = byKey.get(key);
+      if (!row) {
+        row = {
+          key,
+          physicalWagonId: slot.physicalWagonId ?? null,
+          label: slot.physicalWagonNumber ?? `#${slot.position ?? slot.sequenceNo}`,
+          position: slot.position ?? slot.sequenceNo,
+          typeCode: slot.wagonType?.code ?? null,
+          capacityTons: slot.capacityTons ?? 0,
+          slots: [],
+        };
+        byKey.set(key, row);
+      }
+      row.position = Math.min(row.position, slot.position ?? slot.sequenceNo);
+      // Coupled-but-empty consist wagons carry no slot row: they are a target only.
+      if (!slot.consistOnly) {
+        row.slots.push({
+          slot,
+          span: spanOf(slot),
+          loaded: (slot.allocations?.length ?? 0) > 0,
+        });
+      }
+    }
+    return [...byKey.values()].sort((a, b) => a.position - b.position);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [schedule.trainSet?.wagons, stops]);
+
+  const [picked, setPicked] = useState<{ slotId: string; rowKey: string; span: Span } | null>(
+    null,
+  );
+  useEffect(() => {
+    if (!picked) return;
+    const onKey = (e: KeyboardEvent) => e.key === "Escape" && setPicked(null);
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [picked]);
+
+  const moveMutation = useMutation(api.trainScheduling.moveWagonLoad.mutationOptions());
+  const doMove = async (targetWagonId: string, swap: boolean) => {
+    if (!picked || moveMutation.isPending) return;
+    try {
+      await moveMutation.mutateAsync({
+        scheduleId: schedule.id,
+        wagonId: picked.slotId,
+        targetWagonId,
+      });
+      toast({ title: swap ? "Loads swapped" : "Load moved" });
+      setPicked(null);
+      onChanged?.();
+    } catch (error) {
+      const message = isAxiosError(error)
+        ? ((error.response?.data as { message?: string | string[] } | undefined)?.message ??
+          null)
+        : null;
+      toast({
+        title: "Could not move the load",
+        description: Array.isArray(message)
+          ? message.join(", ")
+          : (message ?? "The move was rejected — check wagon type, payload and leg."),
+        variant: "destructive",
+      });
+    }
+  };
+
+  if (stops.length < 2) {
+    return (
+      <Alert color="gray" icon={<Info size={16} />} radius="md">
+        This schedule has no corridor stops yet — the leg board needs a route with at least
+        two stops.
+      </Alert>
+    );
+  }
+  if (!rows.length) {
+    return (
+      <Alert color="gray" icon={<Info size={16} />} radius="md">
+        No wagons on this train yet.
+      </Alert>
+    );
+  }
+
+  const sharedRows = rows.filter((r) => r.slots.filter((s) => s.loaded).length > 1).length;
+
+  return (
+    <Stack gap="md">
+      <Group justify="space-between" align="flex-start" wrap="wrap">
+        <Stack gap={2}>
+          <Text fw={700} size="sm">
+            Loads per wagon per leg
+          </Text>
+          <Text size="xs" c="dimmed">
+            One row per physical wagon, one column per leg. A wagon reused on different legs
+            shows one load per leg.{" "}
+            {canRearrange
+              ? "Click a load to pick it up, then click a wagon free on those legs to move it, or another load to swap."
+              : "Read-only — the train has departed."}
+          </Text>
+        </Stack>
+        <Group gap="xs">
+          {sharedRows > 0 ? (
+            <Badge variant="light" color="violet" radius="sm">
+              {sharedRows} wagon{sharedRows === 1 ? "" : "s"} shared across legs
+            </Badge>
+          ) : null}
+          {picked ? (
+            <Button
+              size="xs"
+              variant="default"
+              leftSection={<X size={14} />}
+              onClick={() => setPicked(null)}
+            >
+              Cancel move (Esc)
+            </Button>
+          ) : null}
+        </Group>
+      </Group>
+
+      <Paper withBorder radius="md" style={{ overflowX: "auto" }}>
+        <Table verticalSpacing={6} horizontalSpacing="sm" style={{ minWidth: 640 }}>
+          <Table.Thead>
+            <Table.Tr>
+              <Table.Th style={{ position: "sticky", left: 0, background: "var(--mantine-color-body)", zIndex: 1, width: 180 }}>
+                Wagon
+              </Table.Th>
+              {legs.map((leg) => (
+                <Table.Th key={leg.idx} style={{ minWidth: 200 }}>
+                  <Group gap={4} wrap="nowrap">
+                    <Text size="xs" fw={700} truncate>
+                      {leg.from.label}
+                    </Text>
+                    <MoveRight size={12} />
+                    <Text size="xs" fw={700} truncate>
+                      {leg.to.label}
+                    </Text>
+                  </Group>
+                </Table.Th>
+              ))}
+              <Table.Th style={{ width: 110 }}>Cargo</Table.Th>
+            </Table.Tr>
+          </Table.Thead>
+          <Table.Tbody>
+            {rows.map((row) => {
+              const cargoTons = row.slots.reduce(
+                (s, x) =>
+                  s +
+                  ((x.slot.allocations ?? []).reduce(
+                    (a, al) => a + (al.allocatedWeightTons ?? 0),
+                    0,
+                  ) || x.slot.assignedWeightTons || 0),
+                0,
+              );
+              const isPickedRow = picked?.rowKey === row.key;
+              // A row can take the picked load when nothing loaded on it rides
+              // any of the picked load's legs.
+              const rowFreeForPicked =
+                !!picked &&
+                !isPickedRow &&
+                !row.slots.some((s) => s.loaded && overlaps(s.span, picked.span));
+              // Where a "move here" lands: an existing empty slot on those legs,
+              // else the physical wagon itself (the API mints the slot).
+              const emptyTargetSlot = picked
+                ? row.slots.find((s) => !s.loaded && overlaps(s.span, picked.span))
+                : undefined;
+              const moveTargetId = emptyTargetSlot?.slot.id ?? row.physicalWagonId ?? null;
+
+              // Lay slots into leg columns; uncovered legs render as empty cells.
+              const cells: React.ReactNode[] = [];
+              let col = 0;
+              const sorted = [...row.slots].sort((a, b) => a.span[0] - b.span[0]);
+              // Empty cell = uncovered leg (target: the physical wagon) or an
+              // empty slot (target: that slot). Both take the picked load when
+              // the row is free on its legs.
+              const emptyCell = (from: number, to: number, targetId = moveTargetId) => {
+                const droppable = rowFreeForPicked && canRearrange && !!targetId &&
+                  !!picked && overlaps([from, to], picked.span);
+                return (
+                  <Table.Td
+                    key={`e-${from}`}
+                    colSpan={Math.max(1, to - from)}
+                    onClick={droppable ? () => void doMove(targetId!, false) : undefined}
+                    style={{
+                      cursor: droppable ? "pointer" : "default",
+                      background: droppable ? "var(--mantine-color-teal-0)" : undefined,
+                      outline: droppable ? "1px dashed var(--mantine-color-teal-5)" : undefined,
+                      outlineOffset: -3,
+                      borderRadius: 6,
+                    }}
+                  >
+                    {droppable ? (
+                      <Text size="xs" c="teal.7" fw={600} ta="center">
+                        Move here
+                      </Text>
+                    ) : (
+                      <Text size="xs" c="dimmed" ta="center">
+                        —
+                      </Text>
+                    )}
+                  </Table.Td>
+                );
+              };
+              for (const s of sorted) {
+                if (s.span[0] > col) cells.push(emptyCell(col, s.span[0]));
+                if (!s.loaded) {
+                  cells.push(emptyCell(s.span[0], s.span[1], s.slot.id));
+                  col = Math.max(col, s.span[1]);
+                  continue;
+                }
+                const isPicked = picked?.slotId === s.slot.id;
+                const swappable =
+                  !!picked && !isPicked && !isPickedRow && s.loaded && canRearrange;
+                const allocs = s.slot.allocations ?? [];
+                const bulk = allocs.some((a) => (a.loadType ?? "CONTAINER").toUpperCase() === "BULK");
+                const containers = allocs.flatMap((a) => a.containerItems ?? []);
+                cells.push(
+                  <Table.Td
+                    key={s.slot.id}
+                    colSpan={Math.max(1, s.span[1] - s.span[0])}
+                    onClick={
+                      !canRearrange
+                        ? undefined
+                        : s.loaded && !picked
+                          ? () => setPicked({ slotId: s.slot.id, rowKey: row.key, span: s.span })
+                          : swappable
+                            ? () => void doMove(s.slot.id, true)
+                            : isPicked
+                              ? () => setPicked(null)
+                              : undefined
+                    }
+                    style={{
+                      cursor: canRearrange && (s.loaded || swappable) ? "pointer" : "default",
+                      padding: 4,
+                    }}
+                  >
+                    {s.loaded ? (
+                      <Paper
+                        radius="sm"
+                        px={8}
+                        py={6}
+                        style={{
+                          background: bulk
+                            ? "var(--mantine-color-orange-0)"
+                            : "var(--mantine-color-cyan-0)",
+                          borderLeft: `4px solid ${
+                            bulk ? "var(--mantine-color-orange-6)" : "var(--mantine-color-cyan-6)"
+                          }`,
+                          outline: isPicked
+                            ? "2px solid var(--mantine-color-edr-green-6)"
+                            : swappable
+                              ? "1px dashed var(--mantine-color-orange-6)"
+                              : undefined,
+                          outlineOffset: 1,
+                        }}
+                      >
+                        <Group gap={6} wrap="nowrap" justify="space-between">
+                          <Group gap={6} wrap="nowrap">
+                            {bulk ? <Wheat size={13} /> : <Boxes size={13} />}
+                            <Text size="xs" fw={700} truncate>
+                              {[...new Set(allocs.map((a) => a.bookingReference ?? "—"))].join(", ")}
+                            </Text>
+                          </Group>
+                          <Text size="xs" c="dimmed" style={{ whiteSpace: "nowrap" }}>
+                            {round1(
+                              allocs.reduce((a, al) => a + (al.allocatedWeightTons ?? 0), 0),
+                            )}{" "}
+                            t
+                          </Text>
+                        </Group>
+                        <Group gap={4} mt={2} wrap="wrap">
+                          {bulk
+                            ? allocs.map((a) =>
+                                a.bulkLoad ? (
+                                  <Badge key={a.id} size="xs" variant="light" color="orange" radius="sm">
+                                    {a.bulkLoad.cargoDescription ?? "Bulk"} · {round1(a.bulkLoad.weightTons)} t
+                                  </Badge>
+                                ) : null,
+                              )
+                            : containers.map((c) => (
+                                <Badge key={c.id} size="xs" variant="light" color="cyan" radius="sm">
+                                  {c.containerNumber ?? "no number"}
+                                </Badge>
+                              ))}
+                          {swappable ? (
+                            <Badge size="xs" color="orange" radius="sm" leftSection={<ArrowLeftRight size={10} />}>
+                              swap
+                            </Badge>
+                          ) : null}
+                        </Group>
+                      </Paper>
+                    ) : (
+                      <Text size="xs" c="dimmed" ta="center">
+                        empty
+                      </Text>
+                    )}
+                  </Table.Td>,
+                );
+                col = Math.max(col, s.span[1]);
+              }
+              if (col < legs.length) cells.push(emptyCell(col, legs.length));
+
+              return (
+                <Table.Tr
+                  key={row.key}
+                  style={{
+                    background: isPickedRow
+                      ? "var(--mantine-color-green-0)"
+                      : rowFreeForPicked
+                        ? undefined
+                        : picked
+                          ? "var(--mantine-color-gray-0)"
+                          : undefined,
+                    opacity: picked && !isPickedRow && !rowFreeForPicked ? 0.55 : 1,
+                  }}
+                >
+                  <Table.Td style={{ position: "sticky", left: 0, background: "var(--mantine-color-body)", zIndex: 1 }}>
+                    <Group gap={6} wrap="nowrap">
+                      <Badge variant="outline" color="gray" radius="sm" size="sm">
+                        #{row.position}
+                      </Badge>
+                      <Stack gap={0}>
+                        <Text size="sm" fw={700}>
+                          {row.label}
+                        </Text>
+                        <Text size="xs" c="dimmed">
+                          {row.typeCode ?? "—"} · {round1(row.capacityTons)} t
+                        </Text>
+                      </Stack>
+                      {row.slots.filter((s) => s.loaded).length > 1 ? (
+                        <Tooltip label="This wagon carries different loads on different legs">
+                          <Badge size="xs" color="violet" variant="light" radius="sm">
+                            shared
+                          </Badge>
+                        </Tooltip>
+                      ) : null}
+                    </Group>
+                  </Table.Td>
+                  {cells.map((c, i) => (
+                    <Fragment key={i}>{c}</Fragment>
+                  ))}
+                  <Table.Td>
+                    <Text size="xs" fw={600} c={cargoTons > row.capacityTons + 0.001 ? "red.7" : undefined}>
+                      {round1(cargoTons)} / {round1(row.capacityTons)} t
+                    </Text>
+                  </Table.Td>
+                </Table.Tr>
+              );
+            })}
+          </Table.Tbody>
+        </Table>
+      </Paper>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/LoadEmptyContainersModal.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LoadEmptyContainersModal.tsx
new file mode 100644
index 000000000..eadd18f85
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LoadEmptyContainersModal.tsx
@@ -0,0 +1,249 @@
+import { useMemo, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  Alert,
+  Badge,
+  Button,
+  Checkbox,
+  Group,
+  Loader,
+  Modal,
+  SegmentedControl,
+  Stack,
+  Table,
+  Text,
+} from "@mantine/core";
+
+import { useToast } from "@/hooks/use-toast";
+import { importOperationsService } from "@/services/importOperations.service";
+import type {
+  EmptyContainerReturn,
+  EmptyContainerSize,
+} from "@/types/importOperations";
+import type { TrainScheduleDetail } from "@/types/trainScheduling";
+import { packEmptiesOntoWagons, wagonsNeeded } from "./emptyContainerLoad.util";
+
+/** Empties still on the ground — past these the box has already left the yard. */
+const LOADABLE_STATUSES = ["RETURNED", "ASSIGNED_STORAGE", "DOCUMENTATION_CLEARED"];
+
+interface LoadEmptyContainersModalProps {
+  opened: boolean;
+  onClose: () => void;
+  schedule: TrainScheduleDetail;
+}
+
+/**
+ * Loads returned empty containers onto an export departure. Wagons are filled
+ * one 40ft OR two 20ft each (see `packEmptiesOntoWagons`), drawing only on
+ * wagons of this train that carry no cargo booking and no empty already.
+ */
+export function LoadEmptyContainersModal({
+  opened,
+  onClose,
+  schedule,
+}: LoadEmptyContainersModalProps) {
+  const { toast } = useToast();
+  const qc = useQueryClient();
+  const [selected, setSelected] = useState<string[]>([]);
+  const [sizeOverrides, setSizeOverrides] = useState<Record<string, EmptyContainerSize>>({});
+
+  const returnsQuery = useQuery({
+    queryKey: ["empty-container-returns"],
+    queryFn: () => importOperationsService.listEmptyReturns(),
+    enabled: opened,
+  });
+
+  const returns = returnsQuery.data ?? [];
+  const loaded = useMemo(
+    () => returns.filter((ret) => ret.trainScheduleId === schedule.id),
+    [returns, schedule.id],
+  );
+  const available = useMemo(
+    () =>
+      returns.filter(
+        (ret) => !ret.trainScheduleId && LOADABLE_STATUSES.includes(ret.status),
+      ),
+    [returns],
+  );
+
+  const sizeOf = (ret: EmptyContainerReturn): EmptyContainerSize =>
+    sizeOverrides[ret.id] ?? (ret.containerSize === "20" ? "20" : "40");
+
+  // A wagon is up for grabs when no booking rides it and no empty sits on it.
+  const freeWagons = useMemo(() => {
+    const takenByEmpties = new Set(
+      loaded.map((ret) => ret.wagonSequenceNo).filter((no): no is number => no != null),
+    );
+    return (schedule.trainSet?.wagons ?? [])
+      .filter((wagon) => !wagon.allocations?.length && !takenByEmpties.has(wagon.sequenceNo))
+      .map((wagon) => wagon.sequenceNo)
+      .sort((a, b) => a - b);
+  }, [schedule.trainSet?.wagons, loaded]);
+
+  const picks = useMemo(
+    () =>
+      available
+        .filter((ret) => selected.includes(ret.id))
+        .map((ret) => ({ id: ret.id, containerSize: sizeOf(ret) })),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [available, selected, sizeOverrides],
+  );
+  const needed = wagonsNeeded(picks);
+  const { assignments, unplaced } = packEmptiesOntoWagons(picks, freeWagons);
+
+  const load = useMutation({
+    mutationFn: () =>
+      importOperationsService.loadEmptyContainersOnTrain({
+        trainScheduleId: schedule.id,
+        trainNumber: schedule.trainNumber ?? undefined,
+        items: assignments,
+      }),
+    onSuccess: () => {
+      toast({ title: `${assignments.length} empty container(s) loaded` });
+      qc.invalidateQueries({ queryKey: ["empty-container-returns"] });
+      qc.invalidateQueries({ queryKey: ["train-scheduling"] });
+      setSelected([]);
+      onClose();
+    },
+    onError: (error: any) => {
+      toast({
+        variant: "destructive",
+        title: "Failed to load empty containers",
+        description: error?.response?.data?.message || error?.message,
+      });
+    },
+  });
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      title="Load Empty Containers"
+      size="xl"
+    >
+      <Stack gap="md">
+        <Text size="sm" c="dimmed">
+          One 40ft or two 20ft containers per wagon. {freeWagons.length} free wagon
+          {freeWagons.length === 1 ? "" : "s"} on this train.
+        </Text>
+
+        {loaded.length > 0 ? (
+          <Alert color="gray" title={`${loaded.length} empty container(s) already loaded`}>
+            <Group gap="xs">
+              {loaded.map((ret) => (
+                <Badge key={ret.id} size="sm" variant="light">
+                  {ret.containerNumber} · wagon {ret.wagonSequenceNo ?? "—"}
+                </Badge>
+              ))}
+            </Group>
+          </Alert>
+        ) : null}
+
+        {returnsQuery.isLoading ? (
+          <Group justify="center" py="md">
+            <Loader size="sm" />
+          </Group>
+        ) : available.length === 0 ? (
+          <Alert color="gray">
+            No returned empty containers are waiting — record returns in Container Returns.
+          </Alert>
+        ) : (
+          <Table.ScrollContainer minWidth={700}>
+            <Table highlightOnHover>
+              <Table.Thead>
+                <Table.Tr>
+                  <Table.Th w={40} />
+                  <Table.Th>Container</Table.Th>
+                  <Table.Th>Size</Table.Th>
+                  <Table.Th>Facility</Table.Th>
+                  <Table.Th>Returned</Table.Th>
+                  <Table.Th>Status</Table.Th>
+                </Table.Tr>
+              </Table.Thead>
+              <Table.Tbody>
+                {available.map((ret) => {
+                  const checked = selected.includes(ret.id);
+                  return (
+                    <Table.Tr key={ret.id}>
+                      <Table.Td>
+                        <Checkbox
+                          checked={checked}
+                          onChange={(event) =>
+                            setSelected(
+                              event.currentTarget.checked
+                                ? [...selected, ret.id]
+                                : selected.filter((id) => id !== ret.id),
+                            )
+                          }
+                        />
+                      </Table.Td>
+                      <Table.Td>
+                        <Text fw={600} size="sm">
+                          {ret.containerNumber}
+                        </Text>
+                      </Table.Td>
+                      <Table.Td>
+                        {/* Legacy returns carry no size — the operator sets it here
+                            because the wagon rule cannot be applied without it. */}
+                        <SegmentedControl
+                          size="xs"
+                          value={sizeOf(ret)}
+                          onChange={(value) =>
+                            setSizeOverrides({
+                              ...sizeOverrides,
+                              [ret.id]: value as EmptyContainerSize,
+                            })
+                          }
+                          data={[
+                            { label: "20ft", value: "20" },
+                            { label: "40ft", value: "40" },
+                          ]}
+                        />
+                      </Table.Td>
+                      <Table.Td>{ret.facility ?? "—"}</Table.Td>
+                      <Table.Td>
+                        {ret.returnDate ? new Date(ret.returnDate).toLocaleDateString() : "—"}
+                      </Table.Td>
+                      <Table.Td>
+                        <Badge size="sm" variant="light">
+                          {ret.status}
+                        </Badge>
+                      </Table.Td>
+                    </Table.Tr>
+                  );
+                })}
+              </Table.Tbody>
+            </Table>
+          </Table.ScrollContainer>
+        )}
+
+        {unplaced.length > 0 ? (
+          <Alert color="red">
+            {needed} wagon(s) needed but only {freeWagons.length} free — unselect{" "}
+            {unplaced.length} container(s) or add wagons to the consist.
+          </Alert>
+        ) : picks.length > 0 ? (
+          <Text size="sm">
+            {picks.length} container(s) → wagons{" "}
+            {[...new Set(assignments.map((a) => a.wagonSequenceNo))].join(", ")}
+          </Text>
+        ) : null}
+
+        <Group justify="flex-end" gap="sm">
+          <Button variant="default" onClick={onClose} disabled={load.isPending}>
+            Cancel
+          </Button>
+          <Button
+            disabled={!picks.length || unplaced.length > 0}
+            loading={load.isPending}
+            onClick={() => load.mutate()}
+          >
+            Load {picks.length || ""} on train
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
+
+export default LoadEmptyContainersModal;
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/LogPassYardWorkModal.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LogPassYardWorkModal.tsx
index 0e1db09be..06d15da77 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/LogPassYardWorkModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/LogPassYardWorkModal.tsx
@@ -12,6 +12,7 @@ import {
   ThemeIcon,
   Tooltip,
 } from "@mantine/core";
+import { DateTimePicker } from "@mantine/dates";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import {
   CheckCircle2,
@@ -111,7 +112,12 @@ export function LogPassYardWorkModal({
 }) {
   const { toast } = useToast();
   const [justLogged, setJustLogged] = useState(false);
-  useEffect(() => setJustLogged(false), [station?.sequenceNo, opened]);
+  // When the train was here — defaults to now, past allowed (recorded after the fact).
+  const [passAt, setPassAt] = useState<Date | null>(null);
+  useEffect(() => {
+    setJustLogged(false);
+    setPassAt(new Date());
+  }, [station?.sequenceNo, opened]);
   const logged = alreadyLogged || justLogged;
 
   const yardWorkQuery = useQuery(
@@ -133,7 +139,13 @@ export function LogPassYardWorkModal({
   const doLogPass = () => {
     if (!station) return;
     recordCheckpoint.mutate(
-      { id: scheduleId, payload: { sequenceNo: station.sequenceNo } },
+      {
+        id: scheduleId,
+        payload: {
+          sequenceNo: station.sequenceNo,
+          ...(passAt ? { occurredAt: passAt.toISOString() } : {}),
+        },
+      },
       {
         onSuccess: () => {
           setJustLogged(true);
@@ -373,6 +385,20 @@ export function LogPassYardWorkModal({
           </>
         )}
 
+        {!logged ? (
+          <DateTimePicker
+            label={isFinal ? "Arrival time" : "Time at station"}
+            description="Defaults to now — pick an earlier time if you are recording after the fact."
+            value={passAt}
+            onChange={(v) => setPassAt(v ? new Date(v) : null)}
+            maxDate={new Date()}
+            valueFormat="DD MMM YYYY HH:mm"
+            clearable={false}
+            radius="md"
+            maw={320}
+          />
+        ) : null}
+
         <Group justify="space-between" mt="xs">
           <Text size="xs" c="dimmed">
             {logged && pendingBoarders.length > 0
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/MergeScheduleTrainModal.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/MergeScheduleTrainModal.tsx
new file mode 100644
index 000000000..a713918b4
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/MergeScheduleTrainModal.tsx
@@ -0,0 +1,344 @@
+import {
+  Alert,
+  Badge,
+  Box,
+  Button,
+  Card,
+  Group,
+  Loader,
+  Modal,
+  Stack,
+  Text,
+  Textarea,
+  TextInput,
+  ThemeIcon,
+} from "@mantine/core";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { isAxiosError } from "axios";
+import {
+  ArrowRight,
+  Ban,
+  CircleAlert,
+  Merge,
+  Search,
+  TriangleAlert,
+} from "lucide-react";
+import { useMemo, useState } from "react";
+
+import { api } from "@/services/api";
+import { useToast } from "@/hooks/use-toast";
+
+function parseError(error: unknown, fallback: string): string {
+  if (isAxiosError(error)) {
+    const message = error.response?.data?.message;
+    if (Array.isArray(message)) return message.join(", ");
+    if (typeof message === "string") return message;
+  }
+  return fallback;
+}
+
+const fmtDate = (iso: string) =>
+  new Date(iso).toLocaleDateString("en-GB", {
+    day: "numeric",
+    month: "short",
+    year: "numeric",
+  });
+
+export interface MergeScheduleTrainModalProps {
+  scheduleId: string | null;
+  /** This schedule's current train — excluded from the picker. */
+  currentTrainId: string | null;
+  scheduleReference?: string | null;
+  opened: boolean;
+  onClose: () => void;
+  onMerged?: () => void;
+}
+
+/**
+ * Merge another train into this schedule.
+ *
+ * This schedule always survives: its train set is repointed at the chosen
+ * train, that train's wagons join this consist, and the emptied train is
+ * deactivated. When the chosen train also runs a schedule on the SAME DAY, that
+ * schedule's bookings move here and it is removed — its other-day schedules
+ * gain the wagons only. The server computes all of that in `previewMerge`, so
+ * the summary below is exactly what the commit will perform.
+ */
+export default function MergeScheduleTrainModal({
+  scheduleId,
+  currentTrainId,
+  scheduleReference,
+  opened,
+  onClose,
+  onMerged,
+}: MergeScheduleTrainModalProps) {
+  const { toast } = useToast();
+  const [selectedTrainId, setSelectedTrainId] = useState<string | null>(null);
+  const [search, setSearch] = useState("");
+  const [reason, setReason] = useState("");
+
+  const { data: trains = [], isLoading: trainsLoading } = useQuery({
+    ...api.trains.list.queryOptions(),
+    enabled: opened,
+  });
+
+  // The schedule's own train cannot be merged into itself.
+  const options = useMemo(() => {
+    const q = search.trim().toLowerCase();
+    return trains
+      .filter((t) => t.id !== currentTrainId)
+      .filter((t) =>
+        q
+          ? `${t.code} ${t.trainNumber ?? ""} ${t.trainName ?? ""}`
+              .toLowerCase()
+              .includes(q)
+          : true,
+      );
+  }, [trains, currentTrainId, search]);
+
+  const { data: preview, isFetching: previewLoading } = useQuery({
+    ...api.trainScheduling.previewScheduleMerge.queryOptions({
+      input: { id: scheduleId ?? "", targetTrainId: selectedTrainId ?? "" },
+    }),
+    enabled: opened && Boolean(scheduleId && selectedTrainId),
+  });
+
+  const merge = useMutation(api.trainScheduling.mergeScheduleTrain.mutationOptions());
+
+  const close = () => {
+    setSelectedTrainId(null);
+    setSearch("");
+    setReason("");
+    onClose();
+  };
+
+  const submit = async () => {
+    if (!scheduleId || !selectedTrainId || !preview?.canMerge) return;
+    try {
+      await merge.mutateAsync({
+        id: scheduleId,
+        targetTrainId: selectedTrainId,
+        ...(reason.trim() ? { reason: reason.trim() } : {}),
+      });
+      toast({ title: "Trains merged" });
+      onMerged?.();
+      close();
+    } catch (err) {
+      toast({
+        title: "Merge failed",
+        description: parseError(err, "Could not merge the trains"),
+        variant: "destructive",
+      });
+    }
+  };
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={close}
+      centered
+      size="lg"
+      radius="lg"
+      title={
+        <Group gap="sm">
+          <ThemeIcon variant="light" color="edr-green" radius="md" size={34}>
+            <Merge size={18} />
+          </ThemeIcon>
+          <Box>
+            <Text fw={600} lh={1.2}>
+              Merge another train into this one
+            </Text>
+            <Text size="xs" c="dimmed" lh={1.2}>
+              {scheduleReference ?? "This departure survives the merge"}
+            </Text>
+          </Box>
+        </Group>
+      }
+    >
+      <Stack gap="md">
+        <TextInput
+          placeholder="Search train code or number…"
+          leftSection={<Search size={15} />}
+          value={search}
+          onChange={(e) => setSearch(e.currentTarget.value)}
+          radius="md"
+        />
+
+        {trainsLoading ? (
+          <Group justify="center" py="lg">
+            <Loader size="sm" />
+          </Group>
+        ) : options.length === 0 ? (
+          <Text size="sm" c="dimmed" py="sm">
+            No other trains available to merge.
+          </Text>
+        ) : (
+          <Box
+            style={{
+              display: "grid",
+              gridTemplateColumns: "repeat(auto-fill, minmax(160px, 1fr))",
+              gap: 8,
+              maxHeight: 190,
+              overflowY: "auto",
+            }}
+          >
+            {options.map((t) => {
+              const on = t.id === selectedTrainId;
+              return (
+                <Card
+                  key={t.id}
+                  withBorder
+                  radius="md"
+                  padding="xs"
+                  onClick={() => setSelectedTrainId(t.id)}
+                  style={{
+                    cursor: "pointer",
+                    borderColor: on
+                      ? "var(--mantine-color-edr-green-5)"
+                      : undefined,
+                    background: on
+                      ? "var(--mantine-color-edr-green-0)"
+                      : undefined,
+                  }}
+                >
+                  <Text size="sm" fw={on ? 700 : 600} truncate>
+                    {t.code}
+                  </Text>
+                  <Text size="xs" c="dimmed" truncate>
+                    {t.trainNumber ? `No. ${t.trainNumber}` : "—"}
+                  </Text>
+                </Card>
+              );
+            })}
+          </Box>
+        )}
+
+        {selectedTrainId && previewLoading ? (
+          <Group justify="center" py="md">
+            <Loader size="sm" />
+          </Group>
+        ) : null}
+
+        {selectedTrainId && preview && !previewLoading ? (
+          <Stack gap="sm">
+            {preview.blockers.length ? (
+              <Alert
+                variant="light"
+                color="red"
+                icon={<CircleAlert size={16} />}
+                title="This merge is blocked"
+              >
+                <Stack gap={4}>
+                  {preview.blockers.map((b) => (
+                    <Text size="sm" key={b}>
+                      {b}
+                    </Text>
+                  ))}
+                </Stack>
+              </Alert>
+            ) : (
+              <Alert
+                variant="light"
+                color="orange"
+                icon={<TriangleAlert size={16} />}
+              >
+                This cannot be undone. Wagons are appended last — reorder them
+                afterwards in the train builder.
+              </Alert>
+            )}
+
+            <Card withBorder radius="md" padding="sm">
+              <Group gap={8} wrap="nowrap" mb={8}>
+                <Text size="sm" fw={700}>
+                  {preview.wagons.current} wagons
+                </Text>
+                <ArrowRight size={15} />
+                <Text size="sm" fw={700} c="edr-green.8">
+                  {preview.wagons.merged} wagons
+                </Text>
+                <Badge variant="light" color="edr-green" radius="sm">
+                  +{preview.wagons.incoming} from {preview.targetTrain.code}
+                </Badge>
+              </Group>
+
+              {preview.absorbedSchedule ? (
+                <Group gap={6} wrap="nowrap" mb={6}>
+                  <Badge size="sm" color="grape" variant="light" radius="sm">
+                    {fmtDate(preview.absorbedSchedule.scheduledDepartureDate)}
+                  </Badge>
+                  <Text size="sm">
+                    {preview.absorbedSchedule.reference ?? "Same-day schedule"} —{" "}
+                    <Text span fw={700}>
+                      {preview.absorbedSchedule.bookingsMoving} booking(s)
+                    </Text>{" "}
+                    move here, then it is removed
+                  </Text>
+                </Group>
+              ) : null}
+
+              {preview.affectedSchedules.map((s) => (
+                <Group gap={6} wrap="nowrap" mb={4} key={s.id}>
+                  <Badge size="sm" color="blue" variant="light" radius="sm">
+                    {fmtDate(s.scheduledDepartureDate)}
+                  </Badge>
+                  <Text size="sm" c="dimmed">
+                    {s.reference ?? s.id.slice(0, 8)} — gains the wagons, keeps
+                    its own bookings
+                  </Text>
+                </Group>
+              ))}
+
+              {preview.untouchedSchedules.map((s) => (
+                <Group gap={6} wrap="nowrap" mb={4} key={s.id}>
+                  <Badge size="sm" color="gray" variant="light" radius="sm">
+                    {fmtDate(s.scheduledDepartureDate)}
+                  </Badge>
+                  <Text size="sm" c="dimmed">
+                    {s.reference ?? s.id.slice(0, 8)} — {s.status.toLowerCase()},
+                    not affected
+                  </Text>
+                </Group>
+              ))}
+
+              {preview.sourceTrainWillDeactivate ? (
+                <Group gap={6} mt={6} wrap="nowrap">
+                  <Ban size={14} color="var(--mantine-color-red-6)" />
+                  <Text size="sm" c="red.7">
+                    This schedule&apos;s current train is emptied and deactivated.
+                  </Text>
+                </Group>
+              ) : null}
+            </Card>
+
+            {preview.canMerge ? (
+              <Textarea
+                label="Reason"
+                placeholder="Why the trains are being merged (kept on the audit trail)"
+                maxLength={500}
+                autosize
+                minRows={2}
+                value={reason}
+                onChange={(e) => setReason(e.currentTarget.value)}
+              />
+            ) : null}
+          </Stack>
+        ) : null}
+
+        <Group justify="flex-end" mt="xs">
+          <Button variant="default" onClick={close}>
+            Cancel
+          </Button>
+          <Button
+            color="edr-green"
+            leftSection={<Merge size={16} />}
+            loading={merge.isPending}
+            disabled={!preview?.canMerge || previewLoading}
+            onClick={() => void submit()}
+          >
+            Merge trains
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/RouteCorridorTrack.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/RouteCorridorTrack.tsx
index d6f0b92e5..d3181b424 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/RouteCorridorTrack.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/RouteCorridorTrack.tsx
@@ -1,6 +1,6 @@
 import { Fragment } from "react";
 import { Badge, Box, Button, Group, Stack, Text } from "@mantine/core";
-import { Check, Flag, MapPin, Train } from "lucide-react";
+import { Check, Flag, MapPin, Pencil, Train } from "lucide-react";
 
 import { freightBrand } from "@/theme/freight-brand";
 import type { TrainCheckpoint, TrackStation } from "@/types/trainScheduling";
@@ -14,6 +14,8 @@ export interface RouteCorridorTrackProps {
   canLog: boolean;
   loggingSeq?: number | null;
   onLogCheckpoint?: (sequenceNo: number) => void;
+  /** Present when logged legs may be corrected (dispatched or arrived). */
+  onEditCheckpoint?: (checkpoint: TrainCheckpoint) => void;
 }
 
 const COLUMN_WIDTH = 150;
@@ -31,6 +33,7 @@ export function RouteCorridorTrack({
   canLog,
   loggingSeq,
   onLogCheckpoint,
+  onEditCheckpoint,
 }: RouteCorridorTrackProps) {
   const bySeq = new Map(checkpoints.map((c) => [c.sequenceNo, c]));
   const lastIndex = stations.length - 1;
@@ -160,14 +163,28 @@ export function RouteCorridorTrack({
 
                 {/* checkpoint time or action */}
                 {checkpoint ? (
-                  <Text size="10px" c="dimmed" ta="center">
-                    {new Date(checkpoint.occurredAt).toLocaleString(undefined, {
-                      month: "short",
-                      day: "numeric",
-                      hour: "2-digit",
-                      minute: "2-digit",
-                    })}
-                  </Text>
+                  <Stack gap={2} align="center">
+                    <Text size="10px" c="dimmed" ta="center">
+                      {new Date(checkpoint.occurredAt).toLocaleString(undefined, {
+                        month: "short",
+                        day: "numeric",
+                        hour: "2-digit",
+                        minute: "2-digit",
+                      })}
+                    </Text>
+                    {onEditCheckpoint ? (
+                      <Button
+                        size="compact-xs"
+                        radius="md"
+                        variant="subtle"
+                        color="gray"
+                        leftSection={<Pencil size={11} />}
+                        onClick={() => onEditCheckpoint(checkpoint)}
+                      >
+                        Edit time
+                      </Button>
+                    ) : null}
+                  </Stack>
                 ) : isNext ? (
                   <Button
                     size="compact-xs"
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleBookingsStep.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleBookingsStep.tsx
index fec3d78e9..777003545 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleBookingsStep.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleBookingsStep.tsx
@@ -1,4 +1,5 @@
 import {
+  Anchor,
   Badge,
   Button,
   Group,
@@ -7,7 +8,16 @@ import {
   Tabs,
   Text,
 } from "@mantine/core";
-import { ArrowRight, FileText, Landmark, MapPin, Package, Train } from "lucide-react";
+import { Link } from "react-router-dom";
+import {
+  ArrowRight,
+  Building2,
+  FileText,
+  Landmark,
+  MapPin,
+  Package,
+  Train,
+} from "lucide-react";
 
 import type { EligibleContainerBooking, FreightType } from "@/types/trainScheduling";
 
@@ -16,6 +26,8 @@ import { EligibleBookingsPanel } from "./EligibleBookingsPanel";
 export type AssignedBookingRow = {
   id: string;
   reference: string;
+  /** Who booked it — staff scan this list by customer, not by reference. */
+  customer?: string | null;
   weightTons?: number;
   isGovernment?: boolean;
   wagonsRequired?: number | null;
@@ -90,9 +102,19 @@ export function ScheduleBookingsStep({
                 >
                   <Stack gap={4}>
                     <Group gap="xs">
-                      <Text fw={600} size="sm">
+                      {/* Only the reference is the link — the row also carries a
+                          Remove button, so an interactive control must not nest
+                          inside the anchor. */}
+                      <Anchor
+                        component={Link}
+                        to={`/dashboard/booking-requests/${booking.id}`}
+                        fw={600}
+                        size="sm"
+                        c="edr-green.8"
+                        underline="hover"
+                      >
                         {booking.reference}
-                      </Text>
+                      </Anchor>
                       {booking.weightTons != null ? (
                         <Badge variant="outline" size="xs" color="edr-green">
                           {booking.weightTons}T
@@ -119,6 +141,14 @@ export function ScheduleBookingsStep({
                         </Badge>
                       ) : null}
                     </Group>
+                    {booking.customer ? (
+                      <Group gap={4}>
+                        <Building2 size={12} />
+                        <Text size="xs" c="dimmed">
+                          {booking.customer}
+                        </Text>
+                      </Group>
+                    ) : null}
                     {booking.contractReference || booking.origin || booking.destination ? (
                       <Group gap="xs">
                         {booking.contractReference ? (
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleWorkspacePanel.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleWorkspacePanel.tsx
index de954742e..a023aeb88 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleWorkspacePanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/ScheduleWorkspacePanel.tsx
@@ -29,6 +29,7 @@ import {
   // Repeat, // used by the hidden Move (reassign) button
   Train,
   TrainFront,
+  Truck,
   Weight,
   X,
 } from "lucide-react";
@@ -36,7 +37,9 @@ import {
 import { CountdownTimer } from "@edr/ui-common";
 
 import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
+import { EntityLink } from "@/components/detail";
 import { api } from "@/services/api";
+import { bookingsService } from "@/services/bookings.service";
 import { useToast } from "@/hooks/use-toast";
 import type {
   EligibleContainerBooking,
@@ -411,6 +414,31 @@ export function ScheduleWorkspacePanel({
       );
   };
 
+  // Export cargo that skipped the warehouse (customer truck straight onto the
+  // wagon) has no GRN and never will — loadBooking's GRN gate would keep
+  // rejecting it forever. Setting DIRECT_TO_TRAIN tells that gate the carriage
+  // acceptance sheet is the handover document instead, then loads in one click.
+  const [truckToTrainPending, setTruckToTrainPending] = useState<string | null>(null);
+  const doTruckToTrain = (bookingId: string, ref: string) => {
+    setTruckToTrainPending(bookingId);
+    bookingsService
+      .setExportHandoverMode(bookingId, "DIRECT_TO_TRAIN")
+      .then(() => loadJourney.mutateAsync({ scheduleId: schedule.id, bookingId }))
+      .then(() => {
+        toast({ title: `${ref} loaded — direct truck-to-train handover` });
+        onChanged();
+        void yardWorkQuery.refetch();
+      })
+      .catch((error) =>
+        toast({
+          title: "Could not load as direct truck-to-train",
+          description: apiErrorMessage(error, "Please try again."),
+          variant: "destructive",
+        }),
+      )
+      .finally(() => setTruckToTrainPending(null));
+  };
+
   const doUnload = (bookingId: string, ref: string) => {
     unloadJourney
       .mutateAsync({ scheduleId: schedule.id, bookingId })
@@ -601,6 +629,7 @@ export function ScheduleWorkspacePanel({
             {pool.map((b) => (
               <BookingCard
                 key={b.id}
+                bookingId={b.id}
                 reference={b.reference}
                 customer={b.customer}
                 weightTons={b.weightTons}
@@ -708,9 +737,16 @@ export function ScheduleWorkspacePanel({
                     const alightHere = trainAtYardId != null && b.destinationYardId === trainAtYardId;
                     const showLoad = canWork && !riding && !done && (journey?.canLoad ?? false);
                     const showUnload = canWork && riding && (journey?.canUnload ?? false);
+                    const showTruckToTrain =
+                      canWork &&
+                      !riding &&
+                      !done &&
+                      boardHere &&
+                      b.tradeDirection === "EXPORT";
                     return (
                       <BookingCard
                         key={b.id}
+                        bookingId={b.id}
                         reference={ref}
                         customer={b.customer}
                         weightTons={b.weightTons}
@@ -764,6 +800,24 @@ export function ScheduleWorkspacePanel({
                                 </Button>
                               </Tooltip>
                             ) : null}
+                            {showTruckToTrain ? (
+                              <Tooltip
+                                label="Customer truck loaded straight onto the wagon — no warehouse receipt, no GRN. Sets direct truck-to-train handover and loads."
+                                withArrow
+                              >
+                                <Button
+                                  size="compact-sm"
+                                  variant="light"
+                                  color="blue"
+                                  radius="md"
+                                  leftSection={<Truck size={13} />}
+                                  loading={truckToTrainPending === b.id}
+                                  onClick={() => doTruckToTrain(b.id, ref)}
+                                >
+                                  Truck to Train
+                                </Button>
+                              </Tooltip>
+                            ) : null}
                             {showUnload ? (
                               <Tooltip
                                 label={
@@ -985,6 +1039,7 @@ function PanelColumn({
 }
 
 function BookingCard({
+  bookingId,
   reference,
   customer,
   weightTons,
@@ -996,6 +1051,8 @@ function BookingCard({
   leg,
   right,
 }: {
+  /** When set, the reference links to the booking's detail page. */
+  bookingId?: string;
   reference: string;
   customer?: string | null;
   weightTons?: number | null;
@@ -1030,9 +1087,18 @@ function BookingCard({
       <Group justify="space-between" align="center" wrap="nowrap" gap="sm">
         <Stack gap={3} style={{ minWidth: 0 }}>
           <Group gap={8} align="center" wrap="nowrap">
-            <Text size="sm" fw={700} truncate>
-              {reference}
-            </Text>
+            {bookingId ? (
+              <EntityLink
+                to={`/dashboard/booking-requests/${bookingId}`}
+                label={reference}
+                size="sm"
+                fw={700}
+              />
+            ) : (
+              <Text size="sm" fw={700} truncate>
+                {reference}
+              </Text>
+            )}
             {status ? <BookingStatusBadge status={status} /> : null}
             {intercity ? (
               <Tooltip
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/TrainCompositionDiagram.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/TrainCompositionDiagram.tsx
index 6a89af519..79bc9ece2 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/TrainCompositionDiagram.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/TrainCompositionDiagram.tsx
@@ -1,4 +1,4 @@
-import { useMemo } from "react";
+import { memo, useMemo } from "react";
 import { Box, Group, Paper, Progress, Stack, Text, Tooltip } from "@mantine/core";
 import { useElementSize } from "@mantine/hooks";
 import { Box as BoxIcon, Container as ContainerIcon, Fuel, Gauge, TrainFront } from "lucide-react";
@@ -132,7 +132,7 @@ function Coupler() {
   );
 }
 
-function LocomotiveCar({
+const LocomotiveCar = memo(function LocomotiveCar({
   code,
   name,
   maxPullWeightTons,
@@ -260,7 +260,7 @@ function LocomotiveCar({
       </Box>
     </Tooltip>
   );
-}
+});
 
 const CONTAINER_GRADIENTS = [
   "linear-gradient(180deg, var(--mantine-color-cyan-5), var(--mantine-color-cyan-7))",
@@ -271,7 +271,7 @@ const CONTAINER_BORDERS = [
   "var(--mantine-color-blue-8)",
 ];
 
-function WagonCar({ wagon }: { wagon: NormalizedWagon }) {
+const WagonCar = memo(function WagonCar({ wagon }: { wagon: NormalizedWagon }) {
   // GROSS on both sides: cargo + tare vs rated payload + tare.
   const grossTons = round1(wagon.assignedWeightTons + wagon.tareWeightTons);
   const maxGrossTons = round1(wagon.capacityTons + wagon.tareWeightTons);
@@ -468,7 +468,7 @@ function WagonCar({ wagon }: { wagon: NormalizedWagon }) {
       </Box>
     </Tooltip>
   );
-}
+});
 
 /** Railway track: two rails over evenly-spaced sleepers. */
 function TrackBed() {
@@ -520,7 +520,7 @@ function TrackBed() {
   );
 }
 
-export function TrainCompositionDiagram({
+export const TrainCompositionDiagram = memo(function TrainCompositionDiagram({
   locomotive,
   locomotives,
   wagons,
@@ -818,7 +818,7 @@ export function TrainCompositionDiagram({
       </Stack>
     </Paper>
   );
-}
+});
 
 function LegendDot({ color, label }: { color: string; label: string }) {
   return (
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/WagonPlanGrid.tsx b/apps/edr-freight-web/backoffice/src/components/trainScheduling/WagonPlanGrid.tsx
index 73297884d..5dc5f09ca 100644
--- a/apps/edr-freight-web/backoffice/src/components/trainScheduling/WagonPlanGrid.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/WagonPlanGrid.tsx
@@ -1,5 +1,6 @@
 import { Badge, Card, Group, Progress, SimpleGrid, Stack, Text, ThemeIcon } from "@mantine/core";
 import { Box, Package } from "lucide-react";
+import { EntityLink } from "@/components/detail";
 import type { TrainScheduleWagonAllocation, WagonPlanRow } from "@/types/trainScheduling";
 
 type WagonSlot = (WagonPlanRow & {
@@ -159,9 +160,12 @@ export function WagonPlanGrid({
                       <Card key={`${alloc.bookingId}-${index}`} padding="xs" radius="md" bg="gray.0">
                         <Stack gap={2}>
                           <Group justify="space-between" gap="xs">
-                            <Text size="xs" fw={500} lineClamp={1}>
-                              {alloc.bookingReference ?? alloc.bookingId}
-                            </Text>
+                            <EntityLink
+                              to={`/dashboard/booking-requests/${alloc.bookingId}`}
+                              label={alloc.bookingReference ?? alloc.bookingId}
+                              size="xs"
+                              fw={500}
+                            />
                             {label === "BULK" ? (
                               <Text size="xs" c="dimmed">
                                 {alloc.allocatedWeightTons}T cargo
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/emptyContainerLoad.util.spec.ts b/apps/edr-freight-web/backoffice/src/components/trainScheduling/emptyContainerLoad.util.spec.ts
new file mode 100644
index 000000000..9094f3139
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/emptyContainerLoad.util.spec.ts
@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { packEmptiesOntoWagons, wagonsNeeded, type EmptyLoadPick } from './emptyContainerLoad.util';
+
+const pick = (id: string, containerSize: '20' | '40'): EmptyLoadPick => ({ id, containerSize });
+
+describe('emptyContainerLoad.util', () => {
+  it('gives each 40ft its own wagon', () => {
+    const { assignments, unplaced } = packEmptiesOntoWagons(
+      [pick('a', '40'), pick('b', '40')],
+      [1, 2, 3],
+    );
+    expect(unplaced).toEqual([]);
+    expect(assignments.map((a) => a.wagonSequenceNo)).toEqual([1, 2]);
+  });
+
+  it('pairs 20ft two to a wagon, last odd one alone', () => {
+    const { assignments } = packEmptiesOntoWagons(
+      [pick('a', '20'), pick('b', '20'), pick('c', '20')],
+      [4, 5],
+    );
+    expect(assignments.map((a) => [a.id, a.wagonSequenceNo])).toEqual([
+      ['a', 4],
+      ['b', 4],
+      ['c', 5],
+    ]);
+  });
+
+  it('never mixes a 40ft and a 20ft on one wagon', () => {
+    const { assignments } = packEmptiesOntoWagons(
+      [pick('a', '20'), pick('b', '40'), pick('c', '20')],
+      [1, 2],
+    );
+    const bySizeOnWagon = new Map<number, string[]>();
+    for (const a of assignments) {
+      bySizeOnWagon.set(a.wagonSequenceNo, [
+        ...(bySizeOnWagon.get(a.wagonSequenceNo) ?? []),
+        a.containerSize,
+      ]);
+    }
+    for (const sizes of bySizeOnWagon.values()) {
+      expect(sizes.includes('40') ? sizes.length : 0).toBeLessThan(2);
+      expect(sizes.length).toBeLessThanOrEqual(2);
+    }
+  });
+
+  it('reports picks that ran out of wagons instead of dropping them', () => {
+    const { assignments, unplaced } = packEmptiesOntoWagons(
+      [pick('a', '40'), pick('b', '40'), pick('c', '20'), pick('d', '20')],
+      [7],
+    );
+    expect(assignments).toHaveLength(1);
+    expect(unplaced.map((p) => p.id)).toEqual(['b', 'c', 'd']);
+  });
+
+  it('counts wagons needed', () => {
+    expect(wagonsNeeded([])).toBe(0);
+    expect(wagonsNeeded([pick('a', '40'), pick('b', '20'), pick('c', '20')])).toBe(2);
+    expect(wagonsNeeded([pick('a', '20')])).toBe(1);
+  });
+});
diff --git a/apps/edr-freight-web/backoffice/src/components/trainScheduling/emptyContainerLoad.util.ts b/apps/edr-freight-web/backoffice/src/components/trainScheduling/emptyContainerLoad.util.ts
new file mode 100644
index 000000000..588fe7649
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/trainScheduling/emptyContainerLoad.util.ts
@@ -0,0 +1,54 @@
+import type { EmptyContainerSize } from "@/types/importOperations";
+
+export interface EmptyLoadPick {
+  id: string;
+  containerSize: EmptyContainerSize;
+}
+
+export interface EmptyLoadAssignment extends EmptyLoadPick {
+  wagonSequenceNo: number;
+}
+
+/**
+ * Fill wagons with the picked empties: a wagon takes ONE 40ft or TWO 20ft,
+ * never a mix. 40ft boxes are seated first so a half-filled 20ft wagon can
+ * never block them, and the 20s pair up behind them.
+ *
+ * `freeWagons` is the caller's ordered list of wagon sequence numbers with no
+ * cargo allocation. Returns the assignments that fit plus the picks that had
+ * no wagon left — the caller surfaces the shortfall instead of silently
+ * dropping boxes.
+ */
+export function packEmptiesOntoWagons(
+  picks: EmptyLoadPick[],
+  freeWagons: number[],
+): { assignments: EmptyLoadAssignment[]; unplaced: EmptyLoadPick[] } {
+  const forty = picks.filter((pick) => pick.containerSize === "40");
+  const twenty = picks.filter((pick) => pick.containerSize === "20");
+
+  const assignments: EmptyLoadAssignment[] = [];
+  const unplaced: EmptyLoadPick[] = [];
+  const wagons = [...freeWagons];
+
+  for (const pick of forty) {
+    const wagon = wagons.shift();
+    if (wagon == null) unplaced.push(pick);
+    else assignments.push({ ...pick, wagonSequenceNo: wagon });
+  }
+
+  for (let index = 0; index < twenty.length; index += 2) {
+    const pair = twenty.slice(index, index + 2);
+    const wagon = wagons.shift();
+    if (wagon == null) unplaced.push(...pair);
+    else assignments.push(...pair.map((pick) => ({ ...pick, wagonSequenceNo: wagon })));
+  }
+
+  return { assignments, unplaced };
+}
+
+/** Wagons the picks consume, whether or not enough are free. */
+export function wagonsNeeded(picks: EmptyLoadPick[]): number {
+  const forty = picks.filter((pick) => pick.containerSize === "40").length;
+  const twenty = picks.length - forty;
+  return forty + Math.ceil(twenty / 2);
+}
diff --git a/apps/edr-freight-web/backoffice/src/components/wagons/WagonPicker.tsx b/apps/edr-freight-web/backoffice/src/components/wagons/WagonPicker.tsx
new file mode 100644
index 000000000..e0bfdc0a3
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/components/wagons/WagonPicker.tsx
@@ -0,0 +1,209 @@
+import {
+  Badge,
+  Box,
+  Button,
+  Checkbox,
+  Group,
+  ScrollArea,
+  Stack,
+  Text,
+  TextInput,
+  ThemeIcon,
+  UnstyledButton,
+} from "@mantine/core";
+import { Check, Search, Train, X } from "lucide-react";
+import { useMemo, useState } from "react";
+
+import type { Wagon } from "@/services/wagon.service";
+
+export interface WagonPickerProps {
+  /** The wagons on offer — already filtered to what the yard can hand over. */
+  wagons: Wagon[];
+  selected: Set<string>;
+  onChange: (next: Set<string>) => void;
+  /** Hard ceiling on the selection; further picks are refused once reached. */
+  max?: number;
+  emptyMessage?: string;
+  maxHeight?: number;
+}
+
+/**
+ * Searchable multi-select over a list of wagons, used wherever staff name the
+ * physical wagons rather than a count. Search matches the wagon number as typed
+ * (case-insensitively, ignoring the dashes and spaces operators leave out) so
+ * "1042" finds "GON-1042".
+ */
+export function WagonPicker({
+  wagons,
+  selected,
+  onChange,
+  max,
+  emptyMessage = "No wagons available here right now.",
+  maxHeight = 260,
+}: WagonPickerProps) {
+  const [query, setQuery] = useState("");
+
+  const normalise = (s: string) => s.toLowerCase().replace(/[\s-]/g, "");
+
+  const shown = useMemo(() => {
+    const q = normalise(query.trim());
+    if (!q) return wagons;
+    return wagons.filter((w) => normalise(w.wagonNumber).includes(q));
+  }, [wagons, query]);
+
+  const ceiling = max ?? Number.MAX_SAFE_INTEGER;
+  const full = selected.size >= ceiling;
+
+  const toggle = (id: string) => {
+    const next = new Set(selected);
+    if (next.has(id)) next.delete(id);
+    else if (next.size >= ceiling) return; // at the cap — ignore the click
+    else next.add(id);
+    onChange(next);
+  };
+
+  /** Select as many of the currently-visible wagons as the cap allows. */
+  const selectShown = () => {
+    const next = new Set(selected);
+    for (const w of shown) {
+      if (next.size >= ceiling) break;
+      next.add(w.id);
+    }
+    onChange(next);
+  };
+
+  return (
+    <Stack gap="xs">
+      <Group gap="xs" wrap="nowrap">
+        <TextInput
+          style={{ flex: 1 }}
+          placeholder="Search wagon number…"
+          leftSection={<Search size={15} />}
+          value={query}
+          onChange={(e) => setQuery(e.currentTarget.value)}
+          rightSection={
+            query ? (
+              <UnstyledButton onClick={() => setQuery("")} aria-label="Clear search">
+                <X size={14} />
+              </UnstyledButton>
+            ) : null
+          }
+          radius="md"
+          size="sm"
+        />
+        <Button
+          size="compact-sm"
+          variant="light"
+          radius="md"
+          onClick={selectShown}
+          disabled={shown.length === 0 || full}
+        >
+          Select {query ? "matches" : "all"}
+        </Button>
+        {selected.size > 0 ? (
+          <Button
+            size="compact-sm"
+            variant="subtle"
+            color="gray"
+            radius="md"
+            onClick={() => onChange(new Set())}
+          >
+            Clear
+          </Button>
+        ) : null}
+      </Group>
+
+      <Group gap="xs" justify="space-between">
+        <Text size="xs" c="dimmed">
+          {shown.length} of {wagons.length} shown
+        </Text>
+        <Badge
+          variant="light"
+          color={full ? "orange" : selected.size > 0 ? "teal" : "gray"}
+          radius="sm"
+        >
+          {selected.size} selected{max != null ? ` / ${max}` : ""}
+        </Badge>
+      </Group>
+
+      {wagons.length === 0 ? (
+        <Text size="sm" c="dimmed" py="sm">
+          {emptyMessage}
+        </Text>
+      ) : shown.length === 0 ? (
+        <Text size="sm" c="dimmed" py="sm">
+          No wagon matches “{query}”.
+        </Text>
+      ) : (
+        <ScrollArea.Autosize mah={maxHeight} type="auto">
+          <Box
+            style={{
+              display: "grid",
+              gridTemplateColumns: "repeat(auto-fill, minmax(150px, 1fr))",
+              gap: 8,
+              paddingRight: 4,
+            }}
+          >
+            {shown.map((w) => {
+              const on = selected.has(w.id);
+              // At the cap, unpicked wagons stop responding — grey them out so
+              // the dead click is explained before it happens.
+              const blocked = !on && full;
+              return (
+                <UnstyledButton
+                  key={w.id}
+                  onClick={() => toggle(w.id)}
+                  disabled={blocked}
+                  style={{
+                    display: "flex",
+                    alignItems: "center",
+                    gap: 8,
+                    padding: "8px 10px",
+                    borderRadius: 8,
+                    border: `1px solid var(--mantine-color-${
+                      on ? "edr-green-5" : "gray-3"
+                    })`,
+                    background: on
+                      ? "var(--mantine-color-edr-green-0)"
+                      : "var(--mantine-color-body)",
+                    opacity: blocked ? 0.45 : 1,
+                    cursor: blocked ? "not-allowed" : "pointer",
+                    transition: "border-color 120ms, background 120ms",
+                  }}
+                >
+                  <Checkbox
+                    checked={on}
+                    onChange={() => toggle(w.id)}
+                    disabled={blocked}
+                    size="xs"
+                    color="edr-green"
+                    tabIndex={-1}
+                    styles={{ input: { cursor: blocked ? "not-allowed" : "pointer" } }}
+                  />
+                  <ThemeIcon
+                    variant="light"
+                    color={on ? "edr-green" : "gray"}
+                    size="sm"
+                    radius="sm"
+                  >
+                    {on ? <Check size={12} /> : <Train size={12} />}
+                  </ThemeIcon>
+                  <Text
+                    size="sm"
+                    fw={on ? 700 : 500}
+                    style={{ fontVariantNumeric: "tabular-nums" }}
+                    truncate
+                  >
+                    {w.wagonNumber}
+                  </Text>
+                </UnstyledButton>
+              );
+            })}
+          </Box>
+        </ScrollArea.Autosize>
+      )}
+    </Stack>
+  );
+}
+
+export default WagonPicker;
diff --git a/apps/edr-freight-web/backoffice/src/components/wagons/WagonYardWorkspaceModal.tsx b/apps/edr-freight-web/backoffice/src/components/wagons/WagonYardWorkspaceModal.tsx
index 4a92695ca..336b9e4ee 100644
--- a/apps/edr-freight-web/backoffice/src/components/wagons/WagonYardWorkspaceModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/wagons/WagonYardWorkspaceModal.tsx
@@ -26,6 +26,8 @@ import { api } from "@/services/api";
 import { useToast } from "@/hooks/use-toast";
 import type { Wagon } from "@/services/wagon.service";
 
+import WagonPicker from "./WagonPicker";
+
 const stripHtml = (html: string) => html.replace(/<[^>]*>/g, "").trim();
 
 export interface WagonYardWorkspaceModalProps {
@@ -44,9 +46,8 @@ const clampInt = (v: number | string, max: number): number => {
 
 /**
  * NumberInput + Slider + All/Half presets, kept in sync. `max` bounds the field
- * for actions that move real wagons; omit it for a transfer REQUEST, which may
- * legitimately ask for more than the yard holds today (OCC fulfils it in
- * instalments) — the slider then just tracks the current value.
+ * to the wagons on hand; omitting it leaves the field unbounded and the slider
+ * simply tracks the current value.
  */
 const QuantityField = ({
   value,
@@ -141,6 +142,8 @@ const WagonYardWorkspaceModal = ({ opened, onClose }: WagonYardWorkspaceModalPro
   const [transferYardId, setTransferYardId] = useState<string | null>(null);
   const [transferQty, setTransferQty] = useState(0);
   const [transferReason, setTransferReason] = useState("");
+  /** Specific wagons the requester named — optional; empty means "any N". */
+  const [pickedWagons, setPickedWagons] = useState<Set<string>>(new Set());
 
   const createRequest = useMutation(
     api.wagonTransferRequests.create.mutationOptions(),
@@ -241,8 +244,25 @@ const WagonYardWorkspaceModal = ({ opened, onClose }: WagonYardWorkspaceModalPro
     setTransferYardId(null);
     setTransferQty(0);
     setTransferReason("");
+    setPickedWagons(new Set());
   }, [yardId, typeId]);
 
+  // Naming wagons IS the ask: the count follows the picks so the two can never
+  // disagree. Lowering the count by hand (below) trims the selection instead.
+  const handlePick = (next: Set<string>) => {
+    setPickedWagons(next);
+    if (next.size > 0) setTransferQty(next.size);
+  };
+
+  const handleQtyChange = (n: number) => {
+    setTransferQty(n);
+    // Asking for fewer than were picked would send a selection the API rejects
+    // (picks may not exceed quantity) — drop the extras, keeping pick order.
+    if (pickedWagons.size > n) {
+      setPickedWagons(new Set([...pickedWagons].slice(0, n)));
+    }
+  };
+
   // Reset the whole workspace when closed.
   useEffect(() => {
     if (!opened) {
@@ -275,16 +295,23 @@ const WagonYardWorkspaceModal = ({ opened, onClose }: WagonYardWorkspaceModalPro
         wagonTypeId: typeId,
         quantity: transferQty,
         reason: transferReason,
+        ...(pickedWagons.size > 0
+          ? { preferredWagonIds: [...pickedWagons] }
+          : {}),
       });
       toast({
         title: `Requested ${transferQty} ${typeInfo.code(typeId)} wagon(s) · ${yardName(
           yardId,
         )} → ${yardName(transferYardId)}`,
-        description: "OCC will pick the wagons and complete the move.",
+        description:
+          pickedWagons.size > 0
+            ? `OCC will send the ${pickedWagons.size} wagon(s) you named where it can.`
+            : "OCC will pick the wagons and complete the move.",
       });
       setTransferQty(0);
       setTransferYardId(null);
       setTransferReason("");
+      setPickedWagons(new Set());
     } catch (err) {
       showError(err, "Request failed");
     }
@@ -434,10 +461,41 @@ const WagonYardWorkspaceModal = ({ opened, onClose }: WagonYardWorkspaceModalPro
                           {availableCount} available
                         </Badge>
                       </Group>
-                      {/* No max: the request may exceed what the yard holds
-                          today — OCC fulfils it in instalments. */}
-                      <QuantityField value={transferQty} onChange={setTransferQty} />
+                      {/* Capped at the wagons actually available in this yard
+                          right now (uncoupled + Available) — a request may not
+                          ask for more than the yard can hand over. */}
+                      <QuantityField
+                        value={transferQty}
+                        onChange={handleQtyChange}
+                        max={availableCount}
+                      />
                     </div>
+
+                    {/* Optional: name the exact wagons. Leaving this empty files
+                        a plain count request and OCC picks whatever is free. */}
+                    <div>
+                      <Group justify="space-between" mb={4} wrap="wrap" gap={4}>
+                        <Text size="sm" fw={500}>
+                          Which wagons{" "}
+                          <Text span size="xs" c="dimmed" fw={400}>
+                            (optional)
+                          </Text>
+                        </Text>
+                        <Text size="xs" c="dimmed">
+                          {pickedWagons.size > 0
+                            ? `${pickedWagons.size} named — OCC will prioritise these`
+                            : "Leave empty and OCC picks any available"}
+                        </Text>
+                      </Group>
+                      <WagonPicker
+                        wagons={availableWagons}
+                        selected={pickedWagons}
+                        onChange={handlePick}
+                        max={availableCount}
+                        emptyMessage="No available wagons of this type in this yard right now."
+                      />
+                    </div>
+
                     <Select
                       label="Destination yard"
                       placeholder="Select destination"
@@ -460,23 +518,42 @@ const WagonYardWorkspaceModal = ({ opened, onClose }: WagonYardWorkspaceModalPro
                     </div>
                     {transferYardId && transferQty > 0 ? (
                       <Card bg="var(--mantine-color-gray-0)" radius="md" padding="sm" withBorder>
-                        <Group gap={8} wrap="nowrap">
-                          <Text size="sm" fw={600}>
-                            {yardName(yardId!)} {total}
-                            <Text span c="red.6" fw={700}>
-                              {" "}
-                              −{transferQty}
+                        <Stack gap={6}>
+                          <Group gap={8} wrap="nowrap">
+                            <Text size="sm" fw={600}>
+                              {yardName(yardId!)} {total}
+                              <Text span c="red.6" fw={700}>
+                                {" "}
+                                −{transferQty}
+                              </Text>
                             </Text>
-                          </Text>
-                          <ArrowRight size={16} />
-                          <Text size="sm" fw={600}>
-                            {yardName(transferYardId)}
-                            <Text span c="teal.7" fw={700}>
-                              {" "}
-                              +{transferQty}
+                            <ArrowRight size={16} />
+                            <Text size="sm" fw={600}>
+                              {yardName(transferYardId)}
+                              <Text span c="teal.7" fw={700}>
+                                {" "}
+                                +{transferQty}
+                              </Text>
                             </Text>
-                          </Text>
-                        </Group>
+                          </Group>
+                          {pickedWagons.size > 0 ? (
+                            <Group gap={4} wrap="wrap">
+                              {availableWagons
+                                .filter((w) => pickedWagons.has(w.id))
+                                .map((w) => (
+                                  <Badge
+                                    key={w.id}
+                                    size="sm"
+                                    variant="light"
+                                    color="edr-green"
+                                    radius="sm"
+                                  >
+                                    {w.wagonNumber}
+                                  </Badge>
+                                ))}
+                            </Group>
+                          ) : null}
+                        </Stack>
                       </Card>
                     ) : null}
                     <Button
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 8ea4ade67..f0cef75b1 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/ReceiveInventoryModal.tsx
@@ -4,7 +4,9 @@ import {
   Alert,
   Badge,
   Button,
+  Card,
   Checkbox,
+  CopyButton,
   Group,
   Loader,
   Menu,
@@ -12,20 +14,25 @@ import {
   NumberInput,
   ScrollArea,
   Select,
+  SimpleGrid,
   Stack,
   Table,
   Tabs,
   Text,
   Textarea,
   TextInput,
+  ThemeIcon,
   Tooltip,
 } from '@mantine/core';
 import {
   ArrowRightLeft,
+  Calendar,
   Check,
+  CheckCheck,
   ChevronDown,
   ChevronRight,
   ClipboardCheck,
+  Copy,
   Eye,
   FileText,
   History,
@@ -83,6 +90,9 @@ import { StoreInventoryModal } from './StoreInventoryModal';
 import { WarehouseInquiryTable } from './WarehouseInquiryTable';
 import { extractDownloadErrorMessage, extractErrorMessage, formatDate, formatNumber, inventoryStatusOptions, warehousesAtStation, yardsForBooking } from './options';
 import { openPdfBlob } from './pdf';
+import ListControls from '@/components/common/ListControls';
+import RuleEngineListFooter from '@/components/ruleEngine/RuleEngineListFooter';
+import { useListControls } from '@/hooks/useListControls';
 import '@/components/overview/overview.css';
 
 type ImportUnloadAssignment = { bookingId: string; warehouseId: string; yardId: string; zoneId: string };
@@ -915,7 +925,10 @@ function EligibleTab({
       ),
     [rows, statusOptions],
   );
-  const selectableRows = statusFilteredRows.filter(canReceiveBooking);
+  const controls = useListControls(statusFilteredRows, {
+    searchKeys: ['reference', 'customer', 'origin', 'destination', 'containerNumber', 'cargo', 'cargoDescription'],
+  });
+  const selectableRows = controls.filteredRows.filter(canReceiveBooking);
   const allSelected = selectableRows.length > 0 && selected.size === selectableRows.length;
   const someSelected = selected.size > 0 && !allSelected;
   const pendingReceiveRows = useMemo(
@@ -1075,7 +1088,7 @@ function EligibleTab({
 
       <Group justify="space-between">
         <Text size="sm" c="dimmed">
-          Selected: <b>{selected.size}</b> / {statusFilteredRows.length} eligible
+          Selected: <b>{selected.size}</b> / {controls.filteredRows.length} eligible
         </Text>
         <Group gap="xs">
           <Button
@@ -1118,6 +1131,19 @@ function EligibleTab({
             : `No eligible PAID ${direction.toLowerCase()} bookings to receive.`}
         </Text>
       ) : (
+        <Stack gap="sm">
+        <ListControls
+          search={controls.search}
+          onSearchChange={controls.setSearch}
+          searchPlaceholder="Booking, customer, route, container, cargo…"
+          dateFrom={controls.dateFrom}
+          onDateFromChange={controls.setDateFrom}
+          dateTo={controls.dateTo}
+          onDateToChange={controls.setDateTo}
+          hasFilters={controls.hasFilters}
+          onReset={controls.reset}
+          showDateRange={false}
+        />
         <Table.ScrollContainer minWidth={1350}>
           <Table highlightOnHover verticalSpacing="xs" striped>
             <Table.Thead>
@@ -1146,7 +1172,7 @@ function EligibleTab({
               </Table.Tr>
             </Table.Thead>
             <Table.Tbody>
-              {statusFilteredRows.map((r) => {
+              {controls.pagedRows.map((r) => {
                 const canReceive = canReceiveBooking(r);
                 return (
                 <Table.Tr key={r.id}>
@@ -1242,6 +1268,14 @@ function EligibleTab({
             </Table.Tbody>
           </Table>
         </Table.ScrollContainer>
+        <RuleEngineListFooter
+          pagination={controls.pagination}
+          pageCount={controls.pageCount}
+          totalCount={controls.totalCount}
+          itemLabel="bookings"
+          onPaginationChange={controls.setPagination}
+        />
+        </Stack>
       )}
 
       <Modal
@@ -1340,7 +1374,10 @@ function ExportReceivedTab({ enabled, onChanged }: { enabled: boolean; onChanged
   const [expandedRow, setExpandedRow] = useState<string | null>(null);
   const [inspectId, setInspectId] = useState<string | null>(null);
 
-  const pendingRows = rows.filter((r) => r.inspectionStatus !== 'PASSED');
+  const controls = useListControls(rows, {
+    searchKeys: ['bookingReference', 'customerName', 'containerNumber', 'cargoType', 'grnNumber', 'origin', 'destination'],
+  });
+  const pendingRows = controls.filteredRows.filter((r) => r.inspectionStatus !== 'PASSED');
   const allSelected = pendingRows.length > 0 && selected.size === pendingRows.length;
   const someSelected = selected.size > 0 && !allSelected;
   const toggleAll = () =>
@@ -1404,6 +1441,19 @@ function ExportReceivedTab({ enabled, onChanged }: { enabled: boolean; onChanged
           No received export items awaiting inspection.
         </Text>
       ) : (
+        <Stack gap="sm">
+        <ListControls
+          search={controls.search}
+          onSearchChange={controls.setSearch}
+          searchPlaceholder="Booking, GRN, customer, container, cargo, route…"
+          dateFrom={controls.dateFrom}
+          onDateFromChange={controls.setDateFrom}
+          dateTo={controls.dateTo}
+          onDateToChange={controls.setDateTo}
+          hasFilters={controls.hasFilters}
+          onReset={controls.reset}
+          showDateRange={false}
+        />
         <Table.ScrollContainer minWidth={1350}>
           <Table highlightOnHover verticalSpacing="xs" striped>
             <Table.Thead>
@@ -1430,7 +1480,7 @@ function ExportReceivedTab({ enabled, onChanged }: { enabled: boolean; onChanged
               </Table.Tr>
             </Table.Thead>
             <Table.Tbody>
-              {rows.map((r: ReadyToLoadRow) => {
+              {controls.pagedRows.map((r: ReadyToLoadRow) => {
                 const selectable = r.inspectionStatus !== 'PASSED';
                 return (
                   <Fragment key={r.id}>
@@ -1493,6 +1543,14 @@ function ExportReceivedTab({ enabled, onChanged }: { enabled: boolean; onChanged
             </Table.Tbody>
           </Table>
         </Table.ScrollContainer>
+        <RuleEngineListFooter
+          pagination={controls.pagination}
+          pageCount={controls.pageCount}
+          totalCount={controls.totalCount}
+          itemLabel="items"
+          onPaginationChange={controls.setPagination}
+        />
+        </Stack>
       )}
 
       <InspectionReportModal
@@ -1517,9 +1575,12 @@ function ReadyToLoadTab({ enabled, onChanged }: { enabled: boolean; onChanged?:
   const [targetScheduleId, setTargetScheduleId] = useState<string | null>(null);
   const [selected, setSelected] = useState<Set<string>>(new Set());
 
-  const allSelected = rows.length > 0 && selected.size === rows.length;
+  const controls = useListControls(rows, {
+    searchKeys: ['bookingReference', 'customerName', 'containerNumber', 'cargoType', 'grnNumber', 'origin', 'destination'],
+  });
+  const allSelected = controls.filteredRows.length > 0 && selected.size === controls.filteredRows.length;
   const someSelected = selected.size > 0 && !allSelected;
-  const toggleAll = () => setSelected(allSelected ? new Set() : new Set(rows.map((r) => r.id)));
+  const toggleAll = () => setSelected(allSelected ? new Set() : new Set(controls.filteredRows.map((r) => r.id)));
   const toggleOne = (id: string) =>
     setSelected((prev) => {
       const next = new Set(prev);
@@ -1589,9 +1650,9 @@ function ReadyToLoadTab({ enabled, onChanged }: { enabled: boolean; onChanged?:
       <Group justify="space-between">
         <Text size="sm" c="dimmed">
           {selected.size > 0 ? (
-            <><b>{selected.size}</b> of {rows.length} selected</>
+            <><b>{selected.size}</b> of {controls.filteredRows.length} selected</>
           ) : (
-            <><b>{rows.length}</b> item{rows.length !== 1 ? 's' : ''} ready to load</>
+            <><b>{controls.filteredRows.length}</b> item{controls.filteredRows.length !== 1 ? 's' : ''} ready to load</>
           )}
         </Text>
         <Button
@@ -1660,6 +1721,19 @@ function ReadyToLoadTab({ enabled, onChanged }: { enabled: boolean; onChanged?:
           No EXPORT items with inspection PASSED waiting to be loaded.
         </Text>
       ) : (
+        <Stack gap="sm">
+        <ListControls
+          search={controls.search}
+          onSearchChange={controls.setSearch}
+          searchPlaceholder="Booking, GRN, customer, container, cargo, route…"
+          dateFrom={controls.dateFrom}
+          onDateFromChange={controls.setDateFrom}
+          dateTo={controls.dateTo}
+          onDateToChange={controls.setDateTo}
+          hasFilters={controls.hasFilters}
+          onReset={controls.reset}
+          showDateRange={false}
+        />
         <Table.ScrollContainer minWidth={1200}>
           <Table highlightOnHover verticalSpacing="xs" striped>
             <Table.Thead>
@@ -1685,7 +1759,7 @@ function ReadyToLoadTab({ enabled, onChanged }: { enabled: boolean; onChanged?:
               </Table.Tr>
             </Table.Thead>
             <Table.Tbody>
-              {rows.map((r: ReadyToLoadRow) => (
+              {controls.pagedRows.map((r: ReadyToLoadRow) => (
                 <Fragment key={r.id}>
                 <Table.Tr>
                   <Table.Td>
@@ -1739,6 +1813,14 @@ function ReadyToLoadTab({ enabled, onChanged }: { enabled: boolean; onChanged?:
             </Table.Tbody>
           </Table>
         </Table.ScrollContainer>
+        <RuleEngineListFooter
+          pagination={controls.pagination}
+          pageCount={controls.pageCount}
+          totalCount={controls.totalCount}
+          itemLabel="items"
+          onPaginationChange={controls.setPagination}
+        />
+        </Stack>
       )}
     </Stack>
   );
@@ -1768,9 +1850,12 @@ function LoadedExportTab({
   );
   const [selected, setSelected] = useState<Set<string>>(new Set());
 
-  const allSelected = rows.length > 0 && selected.size === rows.length;
+  const controls = useListControls(rows, {
+    searchKeys: ['bookingReference', 'customerName', 'containerNumber', 'cargoType', 'grnNumber', 'origin', 'destination'],
+  });
+  const allSelected = controls.filteredRows.length > 0 && selected.size === controls.filteredRows.length;
   const someSelected = selected.size > 0 && !allSelected;
-  const toggleAll = () => setSelected(allSelected ? new Set() : new Set(rows.map((r) => r.id)));
+  const toggleAll = () => setSelected(allSelected ? new Set() : new Set(controls.filteredRows.map((r) => r.id)));
   const toggleOne = (id: string) =>
     setSelected((prev) => {
       const next = new Set(prev);
@@ -1802,11 +1887,11 @@ function LoadedExportTab({
         <Text size="sm" c="dimmed">
           {dispatchable ? (
             <>
-              Selected: <b>{selected.size}</b> / {rows.length} loaded
+              Selected: <b>{selected.size}</b> / {controls.filteredRows.length} loaded
             </>
           ) : (
             <>
-              <b>{rows.length}</b> item{rows.length !== 1 ? 's' : ''} loaded
+              <b>{controls.filteredRows.length}</b> item{controls.filteredRows.length !== 1 ? 's' : ''} loaded
             </>
           )}
         </Text>
@@ -1858,6 +1943,19 @@ function LoadedExportTab({
           No LOADED export items {dispatchable ? 'waiting to dispatch' : 'yet'}.
         </Text>
       ) : (
+        <Stack gap="sm">
+        <ListControls
+          search={controls.search}
+          onSearchChange={controls.setSearch}
+          searchPlaceholder="Booking, GRN, customer, container, cargo, route…"
+          dateFrom={controls.dateFrom}
+          onDateFromChange={controls.setDateFrom}
+          dateTo={controls.dateTo}
+          onDateToChange={controls.setDateTo}
+          hasFilters={controls.hasFilters}
+          onReset={controls.reset}
+          showDateRange={false}
+        />
         <Table.ScrollContainer minWidth={1200}>
           <Table highlightOnHover verticalSpacing="xs" striped>
             <Table.Thead>
@@ -1884,7 +1982,7 @@ function LoadedExportTab({
               </Table.Tr>
             </Table.Thead>
             <Table.Tbody>
-              {rows.map((r: ReadyToLoadRow) => (
+              {controls.pagedRows.map((r: ReadyToLoadRow) => (
                 <Fragment key={r.id}>
                 <Table.Tr>
                   {dispatchable && (
@@ -1935,6 +2033,14 @@ function LoadedExportTab({
             </Table.Tbody>
           </Table>
         </Table.ScrollContainer>
+        <RuleEngineListFooter
+          pagination={controls.pagination}
+          pageCount={controls.pageCount}
+          totalCount={controls.totalCount}
+          itemLabel="items"
+          onPaginationChange={controls.setPagination}
+        />
+        </Stack>
       )}
       <ConfirmActionModal action={confirmAction} onClose={() => setConfirmAction(null)} />
     </Stack>
@@ -2218,6 +2324,11 @@ export function ImportArriveQueueTab({
   >({});
   const [readyBySchedule, setReadyBySchedule] = useState<Record<string, boolean>>({});
 
+  const controls = useListControls(trains, {
+    searchKeys: ['trainNumber', 'route', 'origin', 'destination', 'status'],
+    dateKey: 'arrivalTime',
+  });
+
   const autoUnload = async (train: ImportTrain) => {
     const assignments = Object.entries(assignmentsBySchedule[train.scheduleId] ?? {})
       .filter((entry): entry is [string, Required<ImportUnloadAssignmentDraft>] =>
@@ -2272,10 +2383,6 @@ export function ImportArriveQueueTab({
 
   return (
     <Stack gap="sm" mt="sm">
-      <Text size="sm" c="dimmed">
-        <b>{trains.length}</b> arrived import train{trains.length !== 1 ? 's' : ''}
-      </Text>
-
       {isLoading ? (
         <Group justify="center" py="lg">
           <Loader size="sm" />
@@ -2285,6 +2392,25 @@ export function ImportArriveQueueTab({
           No arrived import trains. Trains appear here once their schedule status is ARRIVED.
         </Text>
       ) : (
+        <Stack gap="sm">
+          <Group justify="space-between" align="flex-end" wrap="wrap">
+            <Text size="sm" c="dimmed">
+              <b>{controls.totalCount}</b> arrived import train{controls.totalCount !== 1 ? 's' : ''}
+            </Text>
+            <ListControls
+              search={controls.search}
+              onSearchChange={controls.setSearch}
+              searchPlaceholder="Train #, route, origin, destination…"
+              dateFrom={controls.dateFrom}
+              onDateFromChange={controls.setDateFrom}
+              dateTo={controls.dateTo}
+              onDateToChange={controls.setDateTo}
+              dateLabel="Arrival"
+              hasFilters={controls.hasFilters}
+              onReset={controls.reset}
+            />
+          </Group>
+
         <Table.ScrollContainer minWidth={1500}>
           <Table highlightOnHover verticalSpacing="xs" striped>
             <Table.Thead>
@@ -2303,7 +2429,16 @@ export function ImportArriveQueueTab({
               </Table.Tr>
             </Table.Thead>
             <Table.Tbody>
-              {trains.map((t: ImportTrain) => {
+              {controls.pagedRows.length === 0 ? (
+                <Table.Tr>
+                  <Table.Td colSpan={11}>
+                    <Text c="dimmed" ta="center" py="lg" size="sm">
+                      No trains match the current filters.
+                    </Text>
+                  </Table.Td>
+                </Table.Tr>
+              ) : (
+              controls.pagedRows.map((t: ImportTrain) => {
                 const isOpen = openId === t.scheduleId;
                 const fullyUnloaded = isFullyUnloaded(t);
                 const unloadedBookings = t.unloadedBookings ?? t.totalBookings - getPendingUnloadBookings(t);
@@ -2311,7 +2446,18 @@ export function ImportArriveQueueTab({
                   <Fragment key={t.scheduleId}>
                     <Table.Tr>
                       <Table.Td>
-                        <Text size="xs" c="dimmed">{t.scheduleId.slice(0, 8)}…</Text>
+                        <Group gap={4} wrap="nowrap">
+                          <Text size="xs" c="dimmed">{t.scheduleId.slice(0, 8)}…</Text>
+                          <CopyButton value={t.scheduleId}>
+                            {({ copied, copy }) => (
+                              <Tooltip label={copied ? 'Copied' : 'Copy schedule ID'} withArrow>
+                                <ActionIcon size="xs" variant="subtle" color={copied ? 'teal' : 'gray'} onClick={copy}>
+                                  {copied ? <CheckCheck size={12} /> : <Copy size={12} />}
+                                </ActionIcon>
+                              </Tooltip>
+                            )}
+                          </CopyButton>
+                        </Group>
                       </Table.Td>
                       <Table.Td>
                         <Text size="sm" fw={600}>{t.trainNumber ?? '—'}</Text>
@@ -2390,10 +2536,19 @@ export function ImportArriveQueueTab({
                     )}
                   </Fragment>
                 );
-              })}
+              }))}
             </Table.Tbody>
           </Table>
         </Table.ScrollContainer>
+
+          <RuleEngineListFooter
+            pagination={controls.pagination}
+            pageCount={controls.pageCount}
+            totalCount={controls.totalCount}
+            itemLabel="trains"
+            onPaginationChange={controls.setPagination}
+          />
+        </Stack>
       )}
       <ConfirmActionModal action={confirmAction} onClose={() => setConfirmAction(null)} />
     </Stack>
@@ -2872,6 +3027,41 @@ interface WarehouseFlowWorkbenchProps {
   focusedBookingLabel?: string;
 }
 
+function WarehouseStatCard({
+  icon,
+  label,
+  value,
+  sub,
+  color,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  value: React.ReactNode;
+  sub: string;
+  color: string;
+}) {
+  return (
+    <Card withBorder radius="md" padding="md">
+      <Group gap="sm" wrap="nowrap">
+        <ThemeIcon color={color} variant="light" size={40} radius="md">
+          {icon}
+        </ThemeIcon>
+        <Stack gap={0} style={{ minWidth: 0 }}>
+          <Text fw={800} fz={22} lh={1.1}>
+            {value}
+          </Text>
+          <Text size="sm" fw={600}>
+            {label}
+          </Text>
+          <Text size="xs" c="dimmed">
+            {sub}
+          </Text>
+        </Stack>
+      </Group>
+    </Card>
+  );
+}
+
 function WarehouseQueueTabs<TValue extends string>({
   value,
   onChange,
@@ -2939,6 +3129,7 @@ function LocateBookingTab({ enabled }: { enabled: boolean }) {
       applied.status,
   );
   const { data: results = [], isFetching } = useInventoryInquiry(applied, enabled && hasSearch);
+  const controls = useListControls(results);
 
   const normalizeDraft = (): InventoryInquiryFilter => ({
     bookingReference: draft.bookingReference?.trim() || undefined,
@@ -3022,7 +3213,16 @@ function LocateBookingTab({ enabled }: { enabled: boolean }) {
           No inventory found for the current filters.
         </Text>
       ) : (
-        <WarehouseInquiryTable results={results} onView={setViewResult} />
+        <Stack gap="sm">
+          <WarehouseInquiryTable results={controls.pagedRows} onView={setViewResult} />
+          <RuleEngineListFooter
+            pagination={controls.pagination}
+            pageCount={controls.pageCount}
+            totalCount={controls.totalCount}
+            itemLabel="results"
+            onPaginationChange={controls.setPagination}
+          />
+        </Stack>
       )}
 
       <InventoryInquiryDetailModal
@@ -3039,6 +3239,7 @@ function ImportWarehouseTabs({ enabled, onChanged }: { enabled: boolean; onChang
   const { data: arriveRows = [] } = useQuery(api.warehouses.importArriveQueue.queryOptions({ enabled }));
   const { data: unloadedRows = [] } = useQuery(api.warehouses.importUnloadedQueue.queryOptions({ enabled }));
   const { data: dispatchRows = [] } = useQuery(api.warehouses.importPickupReadyQueue.queryOptions({ enabled }));
+  const totalBookings = arriveRows.reduce((sum, t) => sum + t.totalBookings, 0);
   const tabs: WarehouseQueueTab<ImportWarehouseTab>[] = [
     {
       value: 'arrive-queue',
@@ -3067,6 +3268,13 @@ function ImportWarehouseTabs({ enabled, onChanged }: { enabled: boolean; onChang
 
   return (
     <Stack gap="md">
+      <SimpleGrid cols={{ base: 1, xs: 2, md: 4 }} spacing="sm">
+        <WarehouseStatCard icon={<PackageOpen size={18} />} label="Arrived" value={arriveRows.length} sub="Import trains" color="edr-green" />
+        <WarehouseStatCard icon={<ClipboardCheck size={18} />} label="Unloaded" value={unloadedRows.length} sub="Import trains" color="blue" />
+        <WarehouseStatCard icon={<Send size={18} />} label="Dispatch Ready" value={dispatchRows.length} sub="Import trains" color="violet" />
+        <WarehouseStatCard icon={<Calendar size={18} />} label="Total Bookings" value={totalBookings} sub="Across arrived trains" color="orange" />
+      </SimpleGrid>
+
       <WarehouseQueueTabs value={activeTab} onChange={setActiveTab} tabs={tabs} />
 
       {activeTab === 'arrive-queue' && (
@@ -3152,6 +3360,14 @@ function ExportWarehouseTabs({
 
   return (
     <Stack gap="md">
+      <SimpleGrid cols={{ base: 1, xs: 2, md: 5 }} spacing="sm">
+        <WarehouseStatCard icon={<Truck size={18} />} label="Eligible" value={exportEligibleCount} sub="Export bookings" color="edr-green" />
+        <WarehouseStatCard icon={<ClipboardCheck size={18} />} label="Received" value={receivedRows.length} sub="Export bookings" color="blue" />
+        <WarehouseStatCard icon={<Train size={18} />} label="Ready To Load" value={readyRows.length} sub="Export bookings" color="teal" />
+        <WarehouseStatCard icon={<PackageCheck size={18} />} label="Loaded" value={loadedRows.length} sub="Export bookings" color="indigo" />
+        <WarehouseStatCard icon={<Send size={18} />} label="Dispatch Ready" value={loadedRows.length} sub="Export bookings" color="violet" />
+      </SimpleGrid>
+
       <WarehouseQueueTabs value={activeTab} onChange={setActiveTab} tabs={tabs} />
 
       {activeTab === 'receive-queue' && (
diff --git a/apps/edr-freight-web/backoffice/src/components/warehouses/options.ts b/apps/edr-freight-web/backoffice/src/components/warehouses/options.ts
index 8b12d33e6..5fd393268 100644
--- a/apps/edr-freight-web/backoffice/src/components/warehouses/options.ts
+++ b/apps/edr-freight-web/backoffice/src/components/warehouses/options.ts
@@ -99,18 +99,8 @@ export const formatDays = (value: number | null | undefined) => {
   return `${rounded} ${rounded === 1 ? 'day' : 'days'}`;
 };
 
-export const formatDate = (value: string | null | undefined) => {
-  if (!value) return '—';
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) return '—';
-  return date.toLocaleString(undefined, {
-    year: 'numeric',
-    month: 'short',
-    day: 'numeric',
-    hour: '2-digit',
-    minute: '2-digit',
-  });
-};
+// Despite the name, this has always rendered date + time — hence formatDateTime.
+export { formatDateTime as formatDate } from '@/lib/format';
 
 // Name fields (warehouse / fee rule / allocation rule) accept letters and spaces only — no numbers.
 export const lettersOnly = (value: string) => value.replace(/[^A-Za-z\s]/g, '');
diff --git a/apps/edr-freight-web/backoffice/src/constants/QUERY_KEYS.ts b/apps/edr-freight-web/backoffice/src/constants/QUERY_KEYS.ts
index f34fa6470..7f6f4993c 100644
--- a/apps/edr-freight-web/backoffice/src/constants/QUERY_KEYS.ts
+++ b/apps/edr-freight-web/backoffice/src/constants/QUERY_KEYS.ts
@@ -28,6 +28,48 @@ export const QUERY_KEYS = {
     byCode: (code: string) => ["dropdown-settings", "by-code", code] as const,
   },
 
+  SHIPPING_LINE_COMPANIES: {
+    ROOT: ["shipping-line-companies"] as const,
+    list: (page: number, limit: number) =>
+      ["shipping-line-companies", "list", page, limit] as const,
+    byId: (id: string) =>
+      ["shipping-line-companies", "detail", id] as const,
+  },
+
+  SHIPPING_LINE_CREDITS: {
+    ROOT: ["shipping-line-credits"] as const,
+    invoices: (
+      page: number,
+      pageSize: number,
+      status?: string,
+      shippingLineId?: string,
+    ) =>
+      [
+        "shipping-line-credits",
+        "invoices",
+        shippingLineId ?? "all",
+        page,
+        pageSize,
+        status ?? "all",
+      ] as const,
+    summary: (shippingLineId?: string) =>
+      ["shipping-line-credits", "summary", shippingLineId ?? "all"] as const,
+    list: (
+      page: number,
+      pageSize: number,
+      status?: string,
+      shippingLineId?: string,
+    ) =>
+      [
+        "shipping-line-credits",
+        "list",
+        shippingLineId ?? "all",
+        page,
+        pageSize,
+        status ?? "all",
+      ] as const,
+  },
+
   CUSTOMERS: {
     ROOT: ["customers"] as const,
     stats: ["customers", "stats"] as const,
@@ -51,6 +93,12 @@ export const QUERY_KEYS = {
     list: (filter?: InvoiceListFilter) =>
       ["invoices", "list", filter ?? {}] as const,
     byId: (id: string) => ["invoices", "detail", id] as const,
+    offlineUsd: (filter?: InvoiceListFilter) =>
+      ["invoices", "offline-usd", filter ?? {}] as const,
+    summary: (filter?: Omit<InvoiceListFilter, "page" | "pageSize">) =>
+      ["invoices", "summary", filter ?? {}] as const,
+    eimsStatus: (id: string) => ["invoices", "eims", id] as const,
+    eimsReceipts: (id: string) => ["invoices", "eims", id, "receipts"] as const,
   },
 
   BOOKINGS: {
@@ -78,6 +126,8 @@ export const QUERY_KEYS = {
       ["contracts", "clearance-history", region ?? "ET"] as const,
     milestones: (id: string) => ["contracts", "milestones", id] as const,
     capacity: (id: string) => ["contracts", "capacity", id] as const,
+    bookingRequests: (id: string) =>
+      ["contracts", "booking-requests", id] as const,
     bookingMilestones: (bookingId: string) =>
       ["contracts", "booking-milestones", bookingId] as const,
     bookingIncidents: (bookingId: string) =>
@@ -195,6 +245,8 @@ export const QUERY_KEYS = {
       ["overview", "billing", range ?? "30d"] as const,
     operationsTab: (range?: string) =>
       ["overview", "operations", range ?? "30d"] as const,
+    fleetTab: (range?: string) => ["overview", "fleet", range ?? "30d"] as const,
+    clearanceTab: () => ["overview", "clearance"] as const,
     customersTab: (range?: string) =>
       ["overview", "customers", range ?? "30d"] as const,
     staffTab: (range?: string) =>
diff --git a/apps/edr-freight-web/backoffice/src/constants/URLS.ts b/apps/edr-freight-web/backoffice/src/constants/URLS.ts
index cb45a34ae..745ab7fd8 100644
--- a/apps/edr-freight-web/backoffice/src/constants/URLS.ts
+++ b/apps/edr-freight-web/backoffice/src/constants/URLS.ts
@@ -57,6 +57,14 @@ export const URL_CONSTANTS = {
     BASE: "/exchange-settings",
   },
 
+  MANUAL_PAYMENT_SETTINGS: {
+    BASE: "/payment-settings/manual",
+  },
+
+  AUDIT_LOGS: {
+    BASE: "/audit",
+  },
+
   DROPDOWN_SETTINGS: {
     BASE: "/dropdown-settings",
     BY_ID: (id: string) => `/api/dropdown-settings/${id}`,
@@ -73,6 +81,33 @@ export const URL_CONSTANTS = {
     BOOKINGS: (id: string | number) => `/customers/${id}/bookings`,
   },
 
+  /**
+   * Carriers with a portal login. Distinct from `/shipping-lines`, which is the
+   * rule-engine's pricing lookup list (a code/label bookings reference).
+   */
+  SHIPPING_LINE_COMPANIES: {
+    BASE: "/shipping-line-companies",
+    BY_ID: (id: string) => `/shipping-line-companies/${id}`,
+    RESEND_ACTIVATION: (id: string) =>
+      `/shipping-line-companies/${id}/resend-activation`,
+  },
+
+  /** Finance's view of what shipping lines owe (use now, pay later). */
+  SHIPPING_LINE_CREDITS: {
+    BASE: "/shipping-line-credits",
+    SUMMARY: "/shipping-line-credits/summary",
+    INVOICE: "/shipping-line-credits/invoice",
+    INVOICES: "/shipping-line-credits/invoices",
+    MARK_PAID_REQUEST: (invoiceId: string) =>
+      `/shipping-line-credits/invoices/${invoiceId}/mark-paid-request`,
+    CANCEL_REQUEST: (invoiceId: string) =>
+      `/shipping-line-credits/invoices/${invoiceId}/cancel-request`,
+    APPROVE_ACTION: (approvalId: string) =>
+      `/shipping-line-credits/invoice-actions/${approvalId}/approve`,
+    REJECT_ACTION: (approvalId: string) =>
+      `/shipping-line-credits/invoice-actions/${approvalId}/reject`,
+  },
+
   COMPANIES: {
     BASE: "/companies",
     STATS: "/companies/stats",
@@ -103,8 +138,26 @@ export const URL_CONSTANTS = {
 
   BILLING: {
     INVOICES: "/billing/invoices",
+    INVOICES_SUMMARY: "/billing/invoices/summary",
     INVOICE_BY_ID: (id: string) => `/billing/invoices/${id}`,
     INVOICE_DOCUMENT: (id: string) => `/billing/invoices/${id}/document`,
+    INVOICE_MEMO: (id: string) => `/billing/invoices/${id}/memo`,
+    OFFLINE_USD: "/billing/offline-usd",
+    CONFIRM_OFFLINE: (id: string) => `/billing/invoices/${id}/confirm-offline`,
+  },
+
+  // MoR EIMS filing. Mounted on /invoices, not /billing/invoices — see EimsInvoiceController.
+  EIMS: {
+    STATUS: (id: string) => `/invoices/${id}/eims/status`,
+    REGISTER: (id: string) => `/invoices/${id}/eims/register`,
+    VERIFY: (id: string) => `/invoices/${id}/eims/verify`,
+    RESOLVE: (id: string) => `/invoices/${id}/eims/resolve`,
+    CANCEL: (id: string) => `/invoices/${id}/eims/cancel`,
+    RECEIPT_SALES: (id: string) => `/invoices/${id}/eims/receipt/sales`,
+    RECEIPT_WITHHOLDING: (id: string) => `/invoices/${id}/eims/receipt/withholding`,
+    RECEIPTS: (id: string) => `/invoices/${id}/eims/receipts`,
+    RECEIPT_DOCUMENT: (id: string, receiptId: string) =>
+      `/invoices/${id}/eims/receipts/${receiptId}/document`,
   },
 
   CUSTOMERS_API: {
@@ -114,7 +167,9 @@ export const URL_CONSTANTS = {
   },
 
   REPORTS: {
+    CATALOG: "/reports",
     RUN: (key: string) => `/reports/${key}`,
+    EXPORT: (key: string) => `/reports/${key}/export`,
   },
 
   OVERVIEW: {
@@ -123,6 +178,8 @@ export const URL_CONSTANTS = {
     CONTRACTS: "/overview/contracts",
     BILLING: "/overview/billing",
     OPERATIONS: "/overview/operations",
+    FLEET: "/overview/fleet",
+    CLEARANCE: "/overview/clearance",
     CUSTOMERS: "/overview/customers",
     STAFF: "/overview/staff",
   },
@@ -134,6 +191,17 @@ export const URL_CONSTANTS = {
     BY_ID: (id: string) => `/bookings/${id}`,
     QUEUE: (queue: string) => `/bookings/queues/${queue}`,
     STAFF_ACCEPT: (id: string) => `/bookings/${id}/staff/accept`,
+    // Consolidated pair: one staff decision applied to both halves at once.
+    PAIRED_DECISION: (id: string) => `/bookings/${id}/paired-decision`,
+    // Shared-wagon approval gate: a consolidated pair waits for a human
+    // decision before either half reaches Operations.
+    CONSOLIDATION_APPROVAL_QUEUE: "/bookings/consolidation-approvals/queue",
+    CONSOLIDATION_APPROVAL_HISTORY: (id: string) =>
+      `/bookings/${id}/consolidation-approvals`,
+    CONSOLIDATION_APPROVE: (approvalId: string) =>
+      `/bookings/consolidation-approvals/${approvalId}/approve`,
+    CONSOLIDATION_REJECT: (approvalId: string) =>
+      `/bookings/consolidation-approvals/${approvalId}/reject`,
     STAFF_REQUEST_CHANGES: (id: string) =>
       `/bookings/${id}/staff/request-changes`,
     STAFF_REJECT: (id: string) => `/bookings/${id}/staff/reject`,
@@ -145,6 +213,8 @@ export const URL_CONSTANTS = {
     CONTRACT_DOWNLOAD: (id: string) => `/bookings/${id}/contract`,
     CARRIAGE_ACCEPTANCE_SHEET: (id: string) =>
       `/bookings/${id}/carriage-acceptance-sheet`,
+    EXPORT_HANDOVER_MODE: (id: string) =>
+      `/bookings/${id}/export-handover-mode`,
     SUMMARY: (id: string) => `/bookings/${id}/summary`,
     CUSTOMER_SIGN: (id: string) => `/bookings/${id}/customer/sign`,
     MARKETING_APPROVE: (id: string) => `/bookings/${id}/marketing/approve`,
@@ -258,6 +328,12 @@ export const URL_CONSTANTS = {
     AWAITING_SHIPMENT: "/contracts/awaiting-shipment",
     BOOKINGS_COMPLETE: (id: string, bookingId: string) =>
       `/contracts/${id}/bookings/${bookingId}/complete`,
+    // Odd-20ft shared-wagon consolidation (customs/Path B): candidates GL may
+    // link, and the all-or-nothing completion of both halves together.
+    CONSOLIDATION_CANDIDATES: (id: string, bookingId: string) =>
+      `/contracts/${id}/bookings/${bookingId}/consolidation-candidates`,
+    BOOKINGS_COMPLETE_CONSOLIDATED: (id: string, bookingId: string) =>
+      `/contracts/${id}/bookings/${bookingId}/complete-consolidated`,
     VALIDATE_SHIPMENT: (id: string) => `/contracts/${id}/validate-shipment`,
     CAPACITY: (id: string) => `/contracts/${id}/capacity`,
     // Shipment requests (GENERAL + customs, Path B): customer → GL queue → booking.
@@ -309,10 +385,6 @@ export const URL_CONSTANTS = {
     SUMMARY: "/payments/summary",
   },
 
-  AUDIT: {
-    LOGS: "/audit/logs",
-  },
-
   LOCOMOTIVES: {
     BASE: "/locomotives",
     BY_ID: (id: string) => `/locomotives/${id}`,
@@ -347,6 +419,9 @@ export const URL_CONSTANTS = {
       `/train-scheduling/schedules/${id}/window-rule`,
     SCHEDULE_DATE: (id: string) =>
       `/train-scheduling/schedules/${id}/schedule-date`,
+    MERGE_PREVIEW: (id: string, targetTrainId: string) =>
+      `/train-scheduling/schedules/${id}/merge-preview/${targetTrainId}`,
+    MERGE_TRAIN: (id: string) => `/train-scheduling/schedules/${id}/merge`,
     CONTRACT_BOOKING_WINDOWS: (contractId: string) =>
       `/train-scheduling/contracts/${contractId}/booking-windows`,
     MARK_BOOKING_PAID: (bookingId: string) =>
@@ -436,6 +511,8 @@ export const URL_CONSTANTS = {
       `/train-scheduling/schedules/${id}/intercity/marshalling/document`,
     CHECKPOINTS: (id: string) =>
       `/train-scheduling/schedules/${id}/checkpoints`,
+    CHECKPOINT: (id: string, sequenceNo: number) =>
+      `/train-scheduling/schedules/${id}/checkpoints/${sequenceNo}`,
     ARRIVE: (id: string) => `/train-scheduling/schedules/${id}/arrive`,
     RESCHEDULE_PREVIEW: (id: string) =>
       `/train-scheduling/schedules/${id}/reschedule/preview`,
@@ -687,6 +764,8 @@ export const URL_CONSTANTS = {
     EMPTY_CONTAINER_RETURNS: "/import-operations/empty-container-returns",
     EMPTY_CONTAINER_RETURN_STATUS: (id: string) =>
       `/import-operations/empty-container-returns/${id}/status`,
+    EMPTY_CONTAINER_RETURNS_LOAD_ON_TRAIN:
+      "/import-operations/empty-container-returns/load-on-train",
   },
 
   VEHICLES: {
diff --git a/apps/edr-freight-web/backoffice/src/features/bookings/booking-actions.config.ts b/apps/edr-freight-web/backoffice/src/features/bookings/booking-actions.config.ts
index 5600f6cfb..eba31130c 100644
--- a/apps/edr-freight-web/backoffice/src/features/bookings/booking-actions.config.ts
+++ b/apps/edr-freight-web/backoffice/src/features/bookings/booking-actions.config.ts
@@ -59,6 +59,9 @@ export type BookingActionContext = Pick<
   | "reference"
   | "schedulingStatus"
   | "customsClearingEnabled"
+  // Set when this booking shares a wagon: the pairable staff decisions then
+  // apply to both halves at once rather than to this booking alone.
+  | "consolidationPartnerId"
 >;
 
 const ALLOCATABLE_SCHEDULING_STATUSES = new Set([
diff --git a/apps/edr-freight-web/backoffice/src/features/bookings/booking-status.config.ts b/apps/edr-freight-web/backoffice/src/features/bookings/booking-status.config.ts
index 07dbae7ce..cd3cef570 100644
--- a/apps/edr-freight-web/backoffice/src/features/bookings/booking-status.config.ts
+++ b/apps/edr-freight-web/backoffice/src/features/bookings/booking-status.config.ts
@@ -102,6 +102,11 @@ export const BOOKING_STATUS_STYLES: Record<string, StatusStyle> = {
     label: "Operation Changes",
     color: "bg-orange-50 text-orange-700 border-orange-200",
   },
+  // Shared-wagon gate: held for a human decision before reaching Operations.
+  CONSOLIDATION_APPROVAL_PENDING: {
+    label: "Wagon Approval",
+    color: "bg-amber-50 text-amber-700 border-amber-200",
+  },
   OPERATION_PRICE_PENDING_CONFIRM: {
     label: "Price Confirm",
     color: "bg-amber-50 text-amber-700 border-amber-200",
@@ -309,6 +314,9 @@ export const BOOKING_LIST_TABS = [
       "OPERATION_REQUEST_PENDING",
       "OPERATION_CHANGES_REQUESTED",
       "OPERATION_PRICE_PENDING_CONFIRM",
+      // Held at the shared-wagon gate — still an ops-review-stage booking, it
+      // just needs the pairing signed off before Operations can act on it.
+      "CONSOLIDATION_APPROVAL_PENDING",
     ],
   },
   {
diff --git a/apps/edr-freight-web/backoffice/src/features/bookings/mapBookingListRow.ts b/apps/edr-freight-web/backoffice/src/features/bookings/mapBookingListRow.ts
index d7ee13562..66f991989 100644
--- a/apps/edr-freight-web/backoffice/src/features/bookings/mapBookingListRow.ts
+++ b/apps/edr-freight-web/backoffice/src/features/bookings/mapBookingListRow.ts
@@ -20,9 +20,13 @@ export function toBookingListRow(booking: BookingDetail): BookingListRow {
     reference: booking.reference,
     contractReference: booking.contractReference ?? null,
     contractId: booking.contractId ?? null,
-    customerLabel: booking.isGovernment
-      ? (booking.governmentInstitution ?? "Government")
-      : labelFromRef(booking.company, booking.companyId ?? undefined),
+    // Shipping-line bookings have no customer company — the line IS the customer.
+    customerLabel: booking.shippingLineCompany
+      ? booking.shippingLineCompany.name
+      : booking.isGovernment
+        ? (booking.governmentInstitution ?? "Government")
+        : labelFromRef(booking.company, booking.companyId ?? undefined),
+    isShippingLine: Boolean(booking.shippingLineCompany ?? booking.shippingLineCompanyId),
     // customerLabel: labelFromRef(booking.customer, booking.customerId),
     status: booking.status,
     scheduledDate: booking.scheduledDate,
diff --git a/apps/edr-freight-web/backoffice/src/features/chat/chatApi.ts b/apps/edr-freight-web/backoffice/src/features/chat/chatApi.ts
new file mode 100644
index 000000000..65522aafd
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/features/chat/chatApi.ts
@@ -0,0 +1,13 @@
+import { api } from "@/auth/http";
+
+/**
+ * Internal chat (Matrix/Element) REST calls. Just the one endpoint — Chat
+ * itself is a separate app (chat.edr.et); this backoffice only ever asks for
+ * a fresh sign-in link into it.
+ */
+export const chatApi = {
+  getSsoUrl: async (): Promise<string> => {
+    const { data } = await api.get<{ url: string }>("/chat/sso");
+    return data.url;
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/hooks/bookings/useBookings.ts b/apps/edr-freight-web/backoffice/src/hooks/bookings/useBookings.ts
index 2fce8aa8f..64e993207 100644
--- a/apps/edr-freight-web/backoffice/src/hooks/bookings/useBookings.ts
+++ b/apps/edr-freight-web/backoffice/src/hooks/bookings/useBookings.ts
@@ -121,7 +121,38 @@ export function useBookingMutations(bookingId: string) {
     onError: (error) => toast.error(parseApiError(error, "Failed to cancel booking")),
   });
 
+  /**
+   * One staff decision applied to both halves of a consolidated pair. Both
+   * bookings are invalidated on success so whichever tab is open reflects the
+   * new state immediately.
+   */
+  const pairedDecision = useMutation({
+    mutationFn: (payload: {
+      decision: "accept" | "cancel" | "operationAccept" | "requestChanges";
+      reason?: string;
+      note?: string;
+      validityDays?: number;
+    }) => {
+      const { decision, ...options } = payload;
+      return bookingsService.pairedDecision(bookingId, decision, options);
+    },
+    onSuccess: (data) => {
+      toast.success("Applied to both bookings on the shared wagon");
+      void invalidateBookingDetail(qc, data.booking.id);
+      void invalidateBookingDetail(qc, data.partner.id);
+    },
+    onError: (error) => {
+      toast.error(
+        parseApiError(error, "Failed to apply the decision to both bookings"),
+      );
+      // Nothing should have committed (the server runs both halves in one
+      // transaction), but refetch so the UI never shows a stale guess.
+      void invalidateBookingDetail(qc, bookingId);
+    },
+  });
+
   const isPending =
+    pairedDecision.isPending ||
     staffAccept.isPending ||
     requestChanges.isPending ||
     staffReject.isPending ||
@@ -134,6 +165,7 @@ export function useBookingMutations(bookingId: string) {
     cancel.isPending;
 
   return {
+    pairedDecision,
     staffAccept,
     requestChanges,
     staffReject,
diff --git a/apps/edr-freight-web/backoffice/src/hooks/contract-templates/useContractTemplates.ts b/apps/edr-freight-web/backoffice/src/hooks/contract-templates/useContractTemplates.ts
index 7e01d883c..0d7d78b56 100644
--- a/apps/edr-freight-web/backoffice/src/hooks/contract-templates/useContractTemplates.ts
+++ b/apps/edr-freight-web/backoffice/src/hooks/contract-templates/useContractTemplates.ts
@@ -4,6 +4,7 @@ import toast from "react-hot-toast";
 import {
   contractTemplatesService,
   type ArticlePayload,
+  type CreateContractTemplatePayload,
   type UpdateContractTemplatePayload,
 } from "@/services/contract-templates.service";
 
@@ -59,6 +60,21 @@ function useTemplateMutation<TVariables>(
   });
 }
 
+export function useCreateContractTemplate() {
+  return useTemplateMutation(
+    (payload: CreateContractTemplatePayload) =>
+      contractTemplatesService.create(payload),
+    "Template created",
+  );
+}
+
+export function useDeleteContractTemplate() {
+  return useTemplateMutation(
+    (code: string) => contractTemplatesService.remove(code),
+    "Template deleted",
+  );
+}
+
 export function useUpdateContractTemplate(code: string) {
   return useTemplateMutation(
     (payload: UpdateContractTemplatePayload) =>
diff --git a/apps/edr-freight-web/backoffice/src/hooks/portal-content/usePortalContentAdmin.ts b/apps/edr-freight-web/backoffice/src/hooks/portal-content/usePortalContentAdmin.ts
new file mode 100644
index 000000000..49e76c80b
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/hooks/portal-content/usePortalContentAdmin.ts
@@ -0,0 +1,78 @@
+import type { SupportDocPayload, SupportDocSlug } from "@edr/types";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import toast from "react-hot-toast";
+
+import { portalContentService } from "@/services/portal-content.service";
+
+/**
+ * Every key shares the `portal-content` prefix so one invalidate after a save
+ * or a restore sweeps the document and its version list together.
+ */
+const KEYS = {
+  ROOT: ["portal-content"] as const,
+  bySlug: (slug: string) => ["portal-content", "detail", slug] as const,
+  versions: (slug: string) => ["portal-content", "versions", slug] as const,
+};
+
+export function usePortalDoc(slug: SupportDocSlug) {
+  return useQuery({
+    queryKey: KEYS.bySlug(slug),
+    queryFn: () => portalContentService.getBySlug(slug),
+  });
+}
+
+/** Version history. Stays idle until the history modal is opened. */
+export function usePortalDocVersions(slug: SupportDocSlug, enabled: boolean) {
+  return useQuery({
+    queryKey: KEYS.versions(slug),
+    queryFn: () => portalContentService.listVersions(slug),
+    enabled,
+  });
+}
+
+/** One historical payload, fetched only when a version is previewed. */
+export function usePortalDocVersion(
+  slug: SupportDocSlug,
+  version: number | null,
+) {
+  return useQuery({
+    queryKey: [...KEYS.versions(slug), version],
+    queryFn: () => portalContentService.getVersion(slug, version as number),
+    enabled: version !== null,
+  });
+}
+
+function usePortalContentMutation<TVariables>(
+  mutationFn: (vars: TVariables) => Promise<unknown>,
+  successMessage: string,
+) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn,
+    onSuccess: () => {
+      toast.success(successMessage);
+      void queryClient.invalidateQueries({ queryKey: KEYS.ROOT });
+    },
+    onError: (error: unknown) => {
+      const message =
+        (error as { response?: { data?: { message?: string } } })?.response?.data
+          ?.message ?? "Something went wrong";
+      toast.error(Array.isArray(message) ? message.join(", ") : message);
+    },
+  });
+}
+
+export function useUpdatePortalDoc(slug: SupportDocSlug) {
+  return usePortalContentMutation(
+    (vars: { payload: SupportDocPayload; note?: string }) =>
+      portalContentService.update(slug, vars.payload, vars.note),
+    "Portal content saved",
+  );
+}
+
+export function useRestorePortalVersion(slug: SupportDocSlug) {
+  return usePortalContentMutation(
+    (version: number) => portalContentService.restore(slug, version),
+    "Version restored",
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/hooks/rule-engine/useRuleEngine.ts b/apps/edr-freight-web/backoffice/src/hooks/rule-engine/useRuleEngine.ts
index 378ff1fb8..dd5078983 100644
--- a/apps/edr-freight-web/backoffice/src/hooks/rule-engine/useRuleEngine.ts
+++ b/apps/edr-freight-web/backoffice/src/hooks/rule-engine/useRuleEngine.ts
@@ -3,6 +3,8 @@ import toast from "react-hot-toast";
 
 import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
 import { api } from "@/services/api";
+import { shippingLineCompaniesService } from "@/services/shippingLineCompanies.service";
+import type { PaginatedShippingLineCompanies } from "@/types/shippingLineCompany";
 import {
   ruleEngineService,
   type RuleEngineListParams,
@@ -165,6 +167,28 @@ export const useContainerTypeOptions = (
     select: (rows) => buildContainerTypeSelectOptions(rows, includeNone),
   });
 
+/**
+ * Shipping lines a rate can be scoped to. Only ACTIVE lines are offered — the
+ * API refuses a rate filed against a suspended one, so listing them would only
+ * produce an error on submit. Sorted by name so the picker is scannable.
+ */
+export const useShippingLineCompanyOptions = (enabled = true) =>
+  useQuery({
+    queryKey: QUERY_KEYS.RULE_ENGINE.selectOptions("shipping-line-companies", {}),
+    // One page well past the number of carriers on the corridor; the picker
+    // needs the whole list, not a page of it.
+    queryFn: () => shippingLineCompaniesService.list(1, 200),
+    enabled,
+    select: (page: PaginatedShippingLineCompanies) =>
+      page.items
+        .filter((line) => line.status === "active")
+        .map((line) => ({
+          label: line.scacCode ? `${line.name} (${line.scacCode})` : line.name,
+          value: line.id,
+        }))
+        .sort((a, b) => a.label.localeCompare(b.label)),
+  });
+
 /**
  * Approval-step role options, sourced from the live IAM position types. The
  * three pre-IAM role strings are appended (marked "(legacy)") so an approval
diff --git a/apps/edr-freight-web/backoffice/src/hooks/useLogoSettings.ts b/apps/edr-freight-web/backoffice/src/hooks/useLogoSettings.ts
new file mode 100644
index 000000000..662906f42
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/hooks/useLogoSettings.ts
@@ -0,0 +1,45 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+
+import { logoSettingsService } from "@/services/logoSettings.service";
+import { useErrorHandler } from "@/shared/hooks/useErrorHandler";
+
+const QUERY_KEY = ["logoSettings"];
+
+export const useLogoSettingsQuery = () =>
+  useQuery({
+    queryKey: QUERY_KEY,
+    queryFn: () => logoSettingsService.get(),
+  });
+
+export const useSetLogo = () => {
+  const queryClient = useQueryClient();
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+
+  return useMutation({
+    mutationFn: (logoImageBase64: string) =>
+      logoSettingsService.set(logoImageBase64),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: QUERY_KEY });
+      toast.success(t("logoSettings.updated", "Company logo updated"));
+    },
+    onError: handleError,
+  });
+};
+
+export const useClearLogo = () => {
+  const queryClient = useQueryClient();
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+
+  return useMutation({
+    mutationFn: () => logoSettingsService.clear(),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: QUERY_KEY });
+      toast.success(t("logoSettings.cleared", "Company logo removed"));
+    },
+    onError: handleError,
+  });
+};
diff --git a/apps/edr-freight-web/backoffice/src/hooks/useManualPaymentSettings.ts b/apps/edr-freight-web/backoffice/src/hooks/useManualPaymentSettings.ts
new file mode 100644
index 000000000..b49f33376
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/hooks/useManualPaymentSettings.ts
@@ -0,0 +1,39 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+
+import {
+  manualPaymentSettingsService,
+  type ManualPaymentSettings,
+} from "@/services/manualPaymentSettings.service";
+import { useErrorHandler } from "@/shared/hooks/useErrorHandler";
+
+export const MANUAL_PAYMENT_SETTINGS_KEY = ["manualPaymentSettings"];
+
+export const useManualPaymentSettingsQuery = () =>
+  useQuery({
+    queryKey: MANUAL_PAYMENT_SETTINGS_KEY,
+    queryFn: () => manualPaymentSettingsService.get(),
+    staleTime: 60_000,
+  });
+
+export const useUpdateManualPaymentSettings = () => {
+  const queryClient = useQueryClient();
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+
+  return useMutation({
+    mutationFn: (
+      patch: Partial<Pick<ManualPaymentSettings, "etbEnabled" | "usdEnabled">>,
+    ) => manualPaymentSettingsService.update(patch),
+    onSuccess: (data) => {
+      queryClient.setQueryData(MANUAL_PAYMENT_SETTINGS_KEY, data);
+      // The Manual Payments worklist only lists enabled currencies.
+      queryClient.invalidateQueries({ queryKey: ["invoices"] });
+      toast.success(
+        t("manualPaymentSettings.updated", "Manual payment settings updated"),
+      );
+    },
+    onError: handleError,
+  });
+};
diff --git a/apps/edr-freight-web/backoffice/src/hooks/useOverview.ts b/apps/edr-freight-web/backoffice/src/hooks/useOverview.ts
index f46fe865f..7225ee5bc 100644
--- a/apps/edr-freight-web/backoffice/src/hooks/useOverview.ts
+++ b/apps/edr-freight-web/backoffice/src/hooks/useOverview.ts
@@ -43,6 +43,22 @@ export function useOverviewOperationsTab(range: OverviewRange, enabled: boolean)
   });
 }
 
+export function useOverviewFleetTab(range: OverviewRange, enabled: boolean) {
+  return useQuery({
+    queryKey: QUERY_KEYS.OVERVIEW.fleetTab(range),
+    queryFn: () => overviewService.getFleetTab(range),
+    enabled,
+  });
+}
+
+export function useOverviewClearanceTab(enabled: boolean) {
+  return useQuery({
+    queryKey: QUERY_KEYS.OVERVIEW.clearanceTab(),
+    queryFn: () => overviewService.getClearanceTab(),
+    enabled,
+  });
+}
+
 export function useOverviewCustomersTab(range: OverviewRange, enabled: boolean) {
   return useQuery({
     queryKey: QUERY_KEYS.OVERVIEW.customersTab(range),
diff --git a/apps/edr-freight-web/backoffice/src/hooks/useStampSettings.ts b/apps/edr-freight-web/backoffice/src/hooks/useStampSettings.ts
new file mode 100644
index 000000000..9d1594602
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/hooks/useStampSettings.ts
@@ -0,0 +1,45 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+
+import { stampSettingsService } from "@/services/stampSettings.service";
+import { useErrorHandler } from "@/shared/hooks/useErrorHandler";
+
+const QUERY_KEY = ["stampSettings"];
+
+export const useStampSettingsQuery = () =>
+  useQuery({
+    queryKey: QUERY_KEY,
+    queryFn: () => stampSettingsService.get(),
+  });
+
+export const useSetStamp = () => {
+  const queryClient = useQueryClient();
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+
+  return useMutation({
+    mutationFn: (stampImageBase64: string) =>
+      stampSettingsService.set(stampImageBase64),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: QUERY_KEY });
+      toast.success(t("stampSettings.updated", "Company stamp updated"));
+    },
+    onError: handleError,
+  });
+};
+
+export const useClearStamp = () => {
+  const queryClient = useQueryClient();
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+
+  return useMutation({
+    mutationFn: () => stampSettingsService.clear(),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: QUERY_KEY });
+      toast.success(t("stampSettings.cleared", "Company stamp removed"));
+    },
+    onError: handleError,
+  });
+};
diff --git a/apps/edr-freight-web/backoffice/src/layout/TopBar.tsx b/apps/edr-freight-web/backoffice/src/layout/TopBar.tsx
index 87a56efde..c7bd1b197 100644
--- a/apps/edr-freight-web/backoffice/src/layout/TopBar.tsx
+++ b/apps/edr-freight-web/backoffice/src/layout/TopBar.tsx
@@ -6,8 +6,6 @@ import {
   LogOut,
   User,
   Key,
-  Moon,
-  Sun,
   Home,
   Menu,
 } from "lucide-react";
@@ -25,7 +23,6 @@ import { NavLink, useNavigate, useLocation } from "react-router-dom";
 import { useRef, useEffect, useState } from "react";
 import { FiBell } from "react-icons/fi";
 import { useUser } from "@/shared/context/UserContext";
-import { useDarkMode } from "@/shared/hooks/useDarkMode";
 import {
   UI_LANGUAGE_OPTIONS,
   getUiLanguageLabel,
@@ -49,7 +46,6 @@ export const TopBar = () => {
   const { pathname } = useLocation();
   const { logout } = useAuthUser();
   const userDetails = useUser();
-  const { isDarkMode, toggleDarkMode } = useDarkMode();
   const { config: tenantConfig } = useTenantConfig();
   const moduleConfig = resolveModuleConfig(tenantConfig);
   const isAdminModuleVisible = userDetails?.roles?.some(
@@ -66,7 +62,6 @@ export const TopBar = () => {
     moduleConfig.siteManagement && isAdminModuleVisible,
   ].filter(Boolean).length;
   const shouldShowHomePageLink = visibleModuleCount > 1;
-  const isObjectiveManagementRoute = pathname.startsWith("/objective-management");
   const fullName = userDetails?.name?.en || t("user");
   const splittedName = fullName.trim().split(" ");
   const initials =
@@ -269,19 +264,6 @@ export const TopBar = () => {
           )}
         </div>
 
-        <Button
-          onClick={toggleDarkMode}
-          aria-label="Toggle Dark Mode"
-          className="p-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors duration-200"
-          title={isDarkMode ? "Switch to light mode" : "Switch to dark mode"}
-          style={{ display: isObjectiveManagementRoute ? "none" : "block" }}>
-          {isDarkMode ? (
-            <Sun className="h-5 w-5 text-yellow-500" />
-          ) : (
-            <Moon className="h-5 w-5 text-gray-600" />
-          )}
-        </Button>
-
         <DropdownMenu>
           <DropdownMenuTrigger asChild>
             <Button
@@ -337,7 +319,7 @@ export const TopBar = () => {
               {t("header.viewProfile")}
             </DropdownMenuItem>
             <DropdownMenuItem
-              onClick={() => navigate("/change-password")}
+              onClick={() => navigate("/dashboard/profile")}
               className="cursor-pointer hover:bg-primary-50 dark:hover:bg-primary-900/30 hover:text-primary-700 dark:hover:text-primary-400 py-2.5">
               <Key className="w-4 h-4 mr-3" />
               {t("header.changePassword")}
diff --git a/apps/edr-freight-web/backoffice/src/layout/components/Header.tsx b/apps/edr-freight-web/backoffice/src/layout/components/Header.tsx
index 9d075f347..c94eb6171 100644
--- a/apps/edr-freight-web/backoffice/src/layout/components/Header.tsx
+++ b/apps/edr-freight-web/backoffice/src/layout/components/Header.tsx
@@ -18,11 +18,8 @@ import {
   Info,
   Menu,
   X,
-  Moon,
-  Sun,
 } from "lucide-react";
 import { useUser } from "@/shared/context/UserContext";
-import { useDarkMode } from "@/shared/hooks/useDarkMode";
 import { useTenantConfig, resolveModuleConfig } from "@/layout/components/TenantConfig";
 import {
   UI_LANGUAGE_OPTIONS,
@@ -55,7 +52,6 @@ const Header = () => {
   const location = useLocation();
   const isComplaintContext = isComplaintAuthContext(location.pathname);
   const { isAuthenticated, showExternalPortalChrome } = useExternalPortalSession();
-  const { isDarkMode, toggleDarkMode } = useDarkMode();
   const { config: tenantConfig } = useTenantConfig();
   const moduleConfig = resolveModuleConfig(tenantConfig);
 
@@ -480,22 +476,6 @@ const Header = () => {
                     </SelectContent>
                   </Select>
                 </div>
-                {/* Dark Mode Toggle */}
-                <motion.button
-                  onClick={toggleDarkMode}
-                  whileHover={{ scale: 1.05 }}
-                  whileTap={{ scale: 0.95 }}
-                  className="p-2 rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-100 dark:bg-gray-700 hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors duration-200"
-                  title={
-                    isDarkMode ? "Switch to light mode" : "Switch to dark mode"
-                  }
-                >
-                  {isDarkMode ? (
-                    <Sun className="h-5 w-5 text-yellow-500" />
-                  ) : (
-                    <Moon className="h-5 w-5 text-gray-600" />
-                  )}
-                </motion.button>
                 <motion.button
                   onClick={handleSignIn}
                   whileHover={{
@@ -646,26 +626,6 @@ const Header = () => {
                       </Select>
                     </div>
 
-                    {/* Dark Mode Toggle for Mobile */}
-                    <motion.button
-                      onClick={toggleDarkMode}
-                      whileHover={{ scale: 1.02 }}
-                      whileTap={{ scale: 0.98 }}
-                      className="block w-full px-4 py-3 text-base font-medium text-center text-gray-700 dark:text-gray-200 bg-gray-100 dark:bg-gray-700 rounded-lg shadow hover:bg-gray-200 dark:hover:bg-gray-600 transition-all duration-200 flex items-center justify-center gap-2"
-                    >
-                      {isDarkMode ? (
-                        <>
-                          <Sun className="h-5 w-5 text-yellow-500" />
-                          {t("landingPage.lightMode")}
-                        </>
-                      ) : (
-                        <>
-                          <Moon className="h-5 w-5 text-gray-600" />
-                          {t("landingPage.darkMode")}
-                        </>
-                      )}
-                    </motion.button>
-
                     <motion.button
                       onClick={() => {
                         handleSignIn();
diff --git a/apps/edr-freight-web/backoffice/src/lib/format.ts b/apps/edr-freight-web/backoffice/src/lib/format.ts
new file mode 100644
index 000000000..4c5c6b639
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/lib/format.ts
@@ -0,0 +1,62 @@
+/** Shared display-formatting helpers for the backoffice. */
+
+/** snake_case / SCREAMING_CASE → Title Case. */
+export function humanize(value: string): string {
+  return value
+    .toLowerCase()
+    .split(/[_\s]+/)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+export function formatDate(value: string | null | undefined): string {
+  if (!value) return "—";
+  const d = new Date(value);
+  return Number.isNaN(d.getTime())
+    ? "—"
+    : d.toLocaleDateString(undefined, {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+      });
+}
+
+export function formatDateTime(value: string | null | undefined): string {
+  if (!value) return "—";
+  const d = new Date(value);
+  return Number.isNaN(d.getTime())
+    ? "—"
+    : d.toLocaleString(undefined, {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+      });
+}
+
+/** Pass `fractionDigits` where cents matter; the default matches the legacy whole-figure display. */
+export function formatMoney(
+  amount: number,
+  currency: string,
+  fractionDigits?: number,
+): string {
+  return new Intl.NumberFormat(undefined, {
+    style: "currency",
+    currency,
+    ...(fractionDigits === undefined
+      ? { maximumFractionDigits: 0 }
+      : {
+          minimumFractionDigits: fractionDigits,
+          maximumFractionDigits: fractionDigits,
+        }),
+  }).format(amount);
+}
+
+export function formatBytes(bytes: number): string {
+  if (!bytes) return "0 B";
+  const units = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  const value = bytes / Math.pow(1024, i);
+  return `${value.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;
+}
diff --git a/apps/edr-freight-web/backoffice/src/lib/permissions.ts b/apps/edr-freight-web/backoffice/src/lib/permissions.ts
index 368e9e74b..995137999 100644
--- a/apps/edr-freight-web/backoffice/src/lib/permissions.ts
+++ b/apps/edr-freight-web/backoffice/src/lib/permissions.ts
@@ -33,6 +33,10 @@ export const FREIGHT_PERMS = {
   staffUsers: {
     view: "edr_freight_app:staff:users:view",
   },
+  chat: {
+    view: "edr_freight_app:chat:view",
+    sync: "edr_freight_app:chat:sync",
+  },
   bookings: {
     view: "edr_freight_app:bookings:view",
     create: "edr_freight_app:bookings:create",
@@ -57,6 +61,7 @@ export const FREIGHT_PERMS = {
     wagonCancellationVoid: "edr_freight_app:bookings:wagon_cancellation_void",
     wagonCancellationRebook:
       "edr_freight_app:bookings:wagon_cancellation_rebook",
+    approveConsolidation: "edr_freight_app:bookings:approve_consolidation",
   },
   contracts: {
     view: "edr_freight_app:contracts:view",
@@ -105,6 +110,7 @@ export const FREIGHT_PERMS = {
     dispatch: "edr_freight_app:train_scheduling:dispatch",
     markPaid: "edr_freight_app:train_scheduling:mark_paid",
     expireBooking: "edr_freight_app:train_scheduling:expire_booking",
+    editTrainNumber: "edr_freight_app:train_scheduling:edit_train_number",
   },
   fleet: {
     view: "edr_freight_app:fleet:view",
@@ -122,12 +128,38 @@ export const FREIGHT_PERMS = {
     verify: "edr_freight_app:customers:verify",
     resetPassword: "edr_freight_app:customers:reset-password",
   },
+  shippingLines: {
+    view: "edr_freight_app:shipping_lines:view",
+    create: "edr_freight_app:shipping_lines:create",
+    update: "edr_freight_app:shipping_lines:update",
+    resetPassword: "edr_freight_app:shipping_lines:reset-password",
+  },
+  shippingLineCredits: {
+    view: "edr_freight_app:shipping_line_credits:view",
+    invoice: "edr_freight_app:shipping_line_credits:invoice",
+    cancel: "edr_freight_app:shipping_line_credits:cancel",
+    invoiceMarkPaid: "edr_freight_app:shipping_line_credits:invoice_mark_paid",
+    invoiceCancel: "edr_freight_app:shipping_line_credits:invoice_cancel",
+    invoiceApprove: "edr_freight_app:shipping_line_credits:invoice_approve",
+    invoiceReject: "edr_freight_app:shipping_line_credits:invoice_reject",
+  },
   payments: {
     view: "edr_freight_app:payments:view",
   },
   invoices: {
     view: "edr_freight_app:invoices:view",
     export: "edr_freight_app:invoices:export",
+    confirmOffline: "edr_freight_app:invoices:confirm_offline",
+    // Filing with MoR EIMS. Off the general Finance role — automatic filing needs no permission
+    // at all (the cron sweep runs as the system); these are the manual, exceptional-operations
+    // actions, granted to the `chief` position (maker-checker, same as shipping-line credit
+    // mark-paid/cancel approval) rather than every Finance user.
+    eimsRegister: "edr_freight_app:invoices:eims_register",
+    eimsResolve: "edr_freight_app:invoices:eims_resolve",
+    eimsCancel: "edr_freight_app:invoices:eims_cancel",
+    eimsReceiptRegister: "edr_freight_app:invoices:eims_receipt_register",
+    // Issuing a credit/debit memo is filing-equivalent — same restricted grant as the eims_* keys.
+    memoIssue: "edr_freight_app:invoices:memo_issue",
   },
   firstMile: {
     view: "edr_freight_app:first_mile:view",
@@ -183,6 +215,13 @@ export const FREIGHT_PERMS = {
     update: "edr_freight_app:trains:update",
     delete: "edr_freight_app:trains:delete",
     assignWagons: "edr_freight_app:trains:assign_wagons",
+    /** Train-builder detail Actions menu — each item its own grant. */
+    changeLocomotives: "edr_freight_app:trains:change_locomotives",
+    changeYard: "edr_freight_app:trains:change_yard",
+    /** Move ONE coupled wagon to another yard from the Wagon order list. */
+    changeWagonYard: "edr_freight_app:trains:change_wagon_yard",
+    toggleActive: "edr_freight_app:trains:toggle_active",
+    disband: "edr_freight_app:trains:disband",
   },
   routes: {
     view: "edr_freight_app:routes:view",
@@ -301,6 +340,13 @@ export const FREIGHT_PERMS = {
     cancel: "edr_freight_app:warehouse_fee_invoices:cancel",
     pay: "edr_freight_app:warehouse_fee_invoices:pay",
   },
+  /**
+   * Audit trail. View-only — the API exposes no write routes for audit rows,
+   * so there is no manage/delete counterpart to grant.
+   */
+  auditLog: {
+    view: "edr_freight_app:audit_log:view",
+  },
   settings: {
     fileUpload: {
       view: "edr_freight_app:settings:file_upload:view",
@@ -310,17 +356,48 @@ export const FREIGHT_PERMS = {
       view: "edr_freight_app:settings:dropdown:view",
       manage: "edr_freight_app:settings:dropdown:manage",
     },
+    // The ONE company stamp/seal, applied to every generated document
+    // (invoices, receipts, warehouse papers, the EDR side of contracts).
+    stamp: {
+      view: "edr_freight_app:settings:stamp:view",
+      manage: "edr_freight_app:settings:stamp:manage",
+    },
+    // The ONE company logo, applied to every generated document (invoices,
+    // receipts, contracts, warehouse papers, train-scheduling manifests).
+    logo: {
+      view: "edr_freight_app:settings:logo:view",
+      manage: "edr_freight_app:settings:logo:manage",
+    },
+    // The per-officer approval teeter (ማህተም) + signature — genuinely per-person,
+    // and NOT the company seal above. Retired: `invoiceStamp`, which used to
+    // gate the company stamp before the two were untangled.
+    teeter: {
+      view: "edr_freight_app:settings:teeter:view",
+      manage: "edr_freight_app:settings:teeter:manage",
+    },
     exchangeRate: {
       view: "edr_freight_app:settings:exchange_rate:view",
       manage: "edr_freight_app:settings:exchange_rate:manage",
     },
+    // Whether Finance may settle invoices by hand, per currency. Finance holds
+    // `view` (the worklist offers only enabled currencies); `manage` is admin.
+    manualPayment: {
+      view: "edr_freight_app:settings:manual_payment:view",
+      manage: "edr_freight_app:settings:manual_payment:manage",
+    },
     contractTemplates: {
       view: "edr_freight_app:settings:contract_templates:view",
       manage: "edr_freight_app:settings:contract_templates:manage",
+      create: "edr_freight_app:settings:contract_templates:create",
+      update: "edr_freight_app:settings:contract_templates:update",
+      delete: "edr_freight_app:settings:contract_templates:delete",
+      read: "edr_freight_app:settings:contract_templates:read",
+    },
+    // Portal-facing help/FAQ/legal copy, edited from Portal content.
+    supportContent: {
+      view: "edr_freight_app:settings:support_content:view",
+      manage: "edr_freight_app:settings:support_content:manage",
     },
-  },
-  audit: {
-    view: "edr_freight_app:audit:view",
   },
   staff: {
     roles: {
@@ -645,19 +722,13 @@ export type FleetCrudResource =
   | "vehicles"
   | "drivers";
 
-/**
- * Per-resource fleet CRUD check. The legacy coarse fleet:manage key still
- * grants every action (mirrors the API's one-of guard fallback).
- */
+/** Per-resource fleet CRUD check — each resource needs its own grant. */
 export function canFleetAction(
   user: AuthUser | null | undefined,
   resource: FleetCrudResource,
   action: "create" | "update" | "delete",
 ): boolean {
-  return (
-    hasPermission(user, FREIGHT_PERMS[resource][action]) ||
-    hasPermission(user, FREIGHT_PERMS.fleet.manage)
-  );
+  return hasPermission(user, FREIGHT_PERMS[resource][action]);
 }
 
 /**
diff --git a/apps/edr-freight-web/backoffice/src/lib/queryClient.test.ts b/apps/edr-freight-web/backoffice/src/lib/queryClient.test.ts
new file mode 100644
index 000000000..81a91d8ee
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/lib/queryClient.test.ts
@@ -0,0 +1,58 @@
+import { describe, expect, it } from "vitest";
+
+import { queryClient } from "./queryClient";
+
+/**
+ * The MutationCache seeds `meta.updates` entries into the cache and then skips
+ * exactly those keys when running `meta.invalidates`. Getting that skip wrong
+ * silently reintroduces the refetch it exists to avoid, so it is worth pinning.
+ */
+const runOnSuccess = (meta: Record<string, unknown>, data: unknown, variables: unknown) => {
+  const handler = (queryClient.getMutationCache() as unknown as {
+    config: {
+      onSuccess?: (
+        data: unknown,
+        variables: unknown,
+        context: unknown,
+        mutation: { meta?: Record<string, unknown> },
+      ) => void;
+    };
+  }).config.onSuccess;
+  handler?.(data, variables, undefined, { meta });
+};
+
+describe("MutationCache updates/invalidates", () => {
+  it("writes the mutation response into the seeded key and leaves it fresh", () => {
+    const seededKey = ["train-builder", "composition", "t1"] as const;
+    const siblingKey = ["train-builder", "list", {}] as const;
+
+    queryClient.setQueryData(seededKey, { code: "STALE" });
+    queryClient.setQueryData(siblingKey, { items: [] });
+
+    const response = { code: "FRESH" };
+    runOnSuccess(
+      {
+        updates: (_v: unknown, d: unknown) => [[seededKey, d]],
+        invalidates: () => [["train-builder"]],
+      },
+      response,
+      { id: "t1" },
+    );
+
+    // Seeded key holds the response, and was NOT invalidated back to stale.
+    expect(queryClient.getQueryData(seededKey)).toStrictEqual(response);
+    expect(queryClient.getQueryState(seededKey)?.isInvalidated).toBe(false);
+
+    // Its siblings under the same root still get invalidated.
+    expect(queryClient.getQueryState(siblingKey)?.isInvalidated).toBe(true);
+  });
+
+  it("invalidates everything when a mutation declares no updates", () => {
+    const key = ["train-builder", "composition", "t2"] as const;
+    queryClient.setQueryData(key, { code: "X" });
+
+    runOnSuccess({ invalidates: () => [["train-builder"]] }, undefined, undefined);
+
+    expect(queryClient.getQueryState(key)?.isInvalidated).toBe(true);
+  });
+});
diff --git a/apps/edr-freight-web/backoffice/src/lib/queryClient.ts b/apps/edr-freight-web/backoffice/src/lib/queryClient.ts
index ee072b330..e372e3255 100644
--- a/apps/edr-freight-web/backoffice/src/lib/queryClient.ts
+++ b/apps/edr-freight-web/backoffice/src/lib/queryClient.ts
@@ -1,6 +1,6 @@
 import { MutationCache, QueryClient } from "@tanstack/react-query";
 
-import type { InvalidatesMeta } from "@/utils/endpoint";
+import type { InvalidatesMeta, UpdatesMeta } from "@/utils/endpoint";
 
 /**
  * Single app-wide React Query client (do not nest additional providers).
@@ -14,13 +14,37 @@ import type { InvalidatesMeta } from "@/utils/endpoint";
 export const queryClient = new QueryClient({
   mutationCache: new MutationCache({
     onSuccess: (data, variables, _context, mutation) => {
+      // Seed first: endpoints that return the entity they just changed write it
+      // straight into its cache key, so the screen updates from the response
+      // instead of round-tripping for data it already holds.
+      const updates = mutation.meta?.updates as UpdatesMeta | undefined;
+      const seeded: readonly unknown[][] = [];
+      if (typeof updates === "function") {
+        for (const [queryKey, value] of updates(variables, data)) {
+          queryClient.setQueryData(queryKey, value);
+          seeded.push(queryKey as unknown[]);
+        }
+      }
+
       const invalidates = mutation.meta?.invalidates as
         | InvalidatesMeta
         | undefined;
       if (typeof invalidates !== "function") return;
 
       for (const queryKey of invalidates(variables, data)) {
-        void queryClient.invalidateQueries({ queryKey });
+        void queryClient.invalidateQueries({
+          queryKey,
+          // A seeded key already holds the authoritative value from this very
+          // response — invalidating it would refetch it right back.
+          predicate: seeded.length
+            ? (query) =>
+                !seeded.some(
+                  (key) =>
+                    key.length === query.queryKey.length &&
+                    key.every((part, i) => Object.is(part, query.queryKey[i])),
+                )
+            : undefined,
+        });
       }
     },
     // Mutation failures are surfaced globally by the axios interceptor in
diff --git a/apps/edr-freight-web/backoffice/src/main.tsx b/apps/edr-freight-web/backoffice/src/main.tsx
index 3de483c5b..055557ae9 100644
--- a/apps/edr-freight-web/backoffice/src/main.tsx
+++ b/apps/edr-freight-web/backoffice/src/main.tsx
@@ -31,24 +31,19 @@ import { QueryClientProvider } from "@tanstack/react-query";
 
 const THEME_STORAGE_KEY = "edr-theme";
 
-const applyStoredTheme = () => {
-  const storedTheme = window.localStorage.getItem(THEME_STORAGE_KEY);
-  const prefersDark = window.matchMedia?.("(prefers-color-scheme: dark)").matches;
-  const theme = storedTheme === "dark" || storedTheme === "light"
-    ? storedTheme
-    : prefersDark
-      ? "dark"
-      : "light";
-
-  if (theme === "dark") {
-    document.documentElement.classList.add("dark");
-    return;
-  }
-
+/**
+ * The backoffice is light-only. This runs before render for two reasons:
+ * strip the `dark` class in case anything ever adds it, and evict the
+ * `edr-theme` key that earlier builds persisted — without the eviction, a user
+ * who had toggled dark before this change keeps a "dark" value in
+ * localStorage that any future re-read would resurrect.
+ */
+const forceLightTheme = () => {
   document.documentElement.classList.remove("dark");
+  window.localStorage.removeItem(THEME_STORAGE_KEY);
 };
 
-applyStoredTheme();
+forceLightTheme();
 
 // Must run before render so replay and exception capture cover startup errors.
 // No-ops when VITE_POSTHOG_KEY is unset.
@@ -63,7 +58,7 @@ if (!rootElement) {
 createRoot(rootElement).render(
   <PostHogProvider client={posthog}>
     <QueryClientProvider client={queryClient}>
-      <MantineProvider theme={freightMantineTheme}>
+      <MantineProvider theme={freightMantineTheme} forceColorScheme="light">
         <StrictMode>
           <BrowserRouter>
             <AuthProvider>
diff --git a/apps/edr-freight-web/backoffice/src/pages/AuditLog.tsx b/apps/edr-freight-web/backoffice/src/pages/AuditLog.tsx
index 5374bcee7..1f2c9461e 100644
--- a/apps/edr-freight-web/backoffice/src/pages/AuditLog.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/AuditLog.tsx
@@ -1,5 +1,6 @@
 import React, { useEffect, useState } from "react";
 import { Input } from "@/shared/common/ui/input";
+import { DateRangePicker, parseDay, formatDay } from "@/shared/common/ui/date-range-picker";
 import {
   Select,
   SelectTrigger,
@@ -134,21 +135,12 @@ const buildQuery = (): CollectionQueryDTO => {
           className="w-64"
         />
 
-        <div className="flex gap-2 items-center">
-          <Input
-            type="date"
-            onChange={(e) =>
-              setDateRange({ ...dateRange, start: e.target.value })
-            }
-          />
-          <span className="text-muted-foreground text-sm">to</span>
-          <Input
-            type="date"
-            onChange={(e) =>
-              setDateRange({ ...dateRange, end: e.target.value })
-            }
-          />
-        </div>
+        <DateRangePicker
+          value={{ from: parseDay(dateRange.start), to: parseDay(dateRange.end) }}
+          onChange={(range) =>
+            setDateRange({ start: formatDay(range.from), end: formatDay(range.to) })
+          }
+        />
 
         <Select value={sort} onValueChange={setSort}>
           <SelectTrigger className="w-[180px]">
diff --git a/apps/edr-freight-web/backoffice/src/pages/AuditLogsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/AuditLogsPage.tsx
new file mode 100644
index 000000000..eac18ca2a
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/AuditLogsPage.tsx
@@ -0,0 +1,340 @@
+import { useMemo, useState } from "react";
+import { useQuery } from "@tanstack/react-query";
+import {
+  Badge,
+  Card,
+  Code,
+  Group,
+  Loader,
+  Modal,
+  Select,
+  Stack,
+  Table,
+  Text,
+  Tooltip,
+} from "@mantine/core";
+import {
+  usePagination,
+  type OnChangeFn,
+  type PaginationState,
+} from "@edr/ui-common";
+
+import { PageContainer, PageHeader } from "@/components/page";
+import ListControls from "@/components/common/ListControls";
+import RuleEngineListFooter from "@/components/ruleEngine/RuleEngineListFooter";
+import {
+  AUDIT_METHODS,
+  auditLogsService,
+  type AuditLog,
+  type AuditMethod,
+} from "@/services/auditLogs.service";
+
+/** Method → badge colour. Destructive actions read as the loudest. */
+const METHOD_COLORS: Record<AuditMethod, string> = {
+  POST: "green",
+  PUT: "blue",
+  PATCH: "yellow",
+  DELETE: "red",
+};
+
+const OUTCOME_OPTIONS = [
+  { value: "true", label: "Succeeded" },
+  { value: "false", label: "Failed" },
+];
+
+/** `YYYY-MM-DD` → inclusive ISO bounds, so a single day covers its full range. */
+const startOfDay = (date: string) => `${date}T00:00:00.000Z`;
+const endOfDay = (date: string) => `${date}T23:59:59.999Z`;
+
+const formatTimestamp = (value: string) => new Date(value).toLocaleString();
+
+const AuditLogsPage = () => {
+  // Server-side filters. Unlike most freight lists (which filter an
+  // already-fetched array via useListControls), audit_logs is append-only and
+  // grows without bound, so filtering and paging both happen in the API.
+  const [search, setSearch] = useState("");
+  const [dateFrom, setDateFrom] = useState<string | null>(null);
+  const [dateTo, setDateTo] = useState<string | null>(null);
+  const [type, setType] = useState<string | null>(null);
+  const [method, setMethod] = useState<string | null>(null);
+  const [outcome, setOutcome] = useState<string | null>(null);
+  const [selected, setSelected] = useState<AuditLog | null>(null);
+
+  const { pagination, setPagination } = usePagination({ pageIndex: 0, pageSize: 25 });
+
+  const query = useMemo(
+    () => ({
+      page: pagination.pageIndex + 1,
+      pageSize: pagination.pageSize,
+      type: type ?? undefined,
+      method: (method as AuditMethod | null) ?? undefined,
+      isSuccess: outcome === null ? undefined : outcome === "true",
+      // The API filters by record id; the search box is the natural place to
+      // paste one when tracing what happened to a specific contract/booking.
+      resourceId: search.trim() || undefined,
+      from: dateFrom ? startOfDay(dateFrom) : undefined,
+      to: dateTo ? endOfDay(dateTo) : undefined,
+    }),
+    [pagination, type, method, outcome, search, dateFrom, dateTo],
+  );
+
+  const logsQuery = useQuery({
+    queryKey: ["audit-logs", query],
+    queryFn: () => auditLogsService.list(query),
+  });
+
+  const typesQuery = useQuery({
+    queryKey: ["audit-logs", "types"],
+    queryFn: () => auditLogsService.types(),
+  });
+
+  const rows = logsQuery.data?.items ?? [];
+  const totalCount = logsQuery.data?.meta.total ?? 0;
+  const pageCount = logsQuery.data?.meta.totalPages ?? 0;
+
+  const hasFilters = Boolean(
+    search || dateFrom || dateTo || type || method || outcome,
+  );
+
+  const resetFilters = () => {
+    setSearch("");
+    setDateFrom(null);
+    setDateTo(null);
+    setType(null);
+    setMethod(null);
+    setOutcome(null);
+    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
+  };
+
+  /** Any filter change must return to page 1, or the view can land out of range. */
+  const onFilterChange = <T,>(setter: (value: T) => void) => (value: T) => {
+    setter(value);
+    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
+  };
+
+  // `OnChangeFn` may hand back either a new value or an updater, so both forms
+  // are resolved before storing.
+  const handlePaginationChange: OnChangeFn<PaginationState> = (updater) => {
+    setPagination((prev) =>
+      typeof updater === "function" ? updater(prev) : updater,
+    );
+  };
+
+  // `PageContainer` gives the page the same horizontal inset and vertical
+  // rhythm as every other dashboard screen; `fluid` lifts the max-width cap
+  // because the log table is wide.
+  return (
+    <PageContainer fluid>
+      <PageHeader
+        title="Audit logs"
+        subtitle="Every state-changing action taken by backoffice staff. Read-only — entries cannot be edited or removed."
+      />
+
+      <Card withBorder padding="md">
+        <Stack gap="md">
+          <ListControls
+            search={search}
+            onSearchChange={onFilterChange(setSearch)}
+            searchPlaceholder="Filter by record id…"
+            dateFrom={dateFrom}
+            onDateFromChange={onFilterChange(setDateFrom)}
+            dateTo={dateTo}
+            onDateToChange={onFilterChange(setDateTo)}
+            dateLabel="Action date"
+            hasFilters={hasFilters}
+            onReset={resetFilters}
+          >
+            <Select
+              label="Entity"
+              placeholder="All entities"
+              data={typesQuery.data ?? []}
+              value={type}
+              onChange={onFilterChange(setType)}
+              clearable
+              searchable
+              w={200}
+            />
+            <Select
+              label="Method"
+              placeholder="All methods"
+              data={[...AUDIT_METHODS]}
+              value={method}
+              onChange={onFilterChange(setMethod)}
+              clearable
+              w={150}
+            />
+            <Select
+              label="Outcome"
+              placeholder="Any outcome"
+              data={OUTCOME_OPTIONS}
+              value={outcome}
+              onChange={onFilterChange(setOutcome)}
+              clearable
+              w={160}
+            />
+          </ListControls>
+
+          {logsQuery.isLoading ? (
+            <Group justify="center" py="xl">
+              <Loader />
+            </Group>
+          ) : logsQuery.isError ? (
+            <Text c="red" ta="center" py="xl">
+              Could not load audit logs.
+            </Text>
+          ) : rows.length === 0 ? (
+            <Text c="dimmed" ta="center" py="xl">
+              No audit entries match these filters.
+            </Text>
+          ) : (
+            <Table.ScrollContainer minWidth={900}>
+              <Table highlightOnHover striped>
+                <Table.Thead>
+                  <Table.Tr>
+                    <Table.Th>Action</Table.Th>
+                    <Table.Th>Entity</Table.Th>
+                    <Table.Th>Method</Table.Th>
+                    <Table.Th>User</Table.Th>
+                    <Table.Th>Outcome</Table.Th>
+                    <Table.Th>When</Table.Th>
+                  </Table.Tr>
+                </Table.Thead>
+                <Table.Tbody>
+                  {rows.map((log) => (
+                    <Table.Tr
+                      key={log.id}
+                      onClick={() => setSelected(log)}
+                      style={{ cursor: "pointer" }}
+                    >
+                      <Table.Td maw={340}>
+                        <Text size="sm" lineClamp={2}>
+                          {log.title}
+                        </Text>
+                      </Table.Td>
+                      <Table.Td>
+                        <Badge variant="light">{log.type}</Badge>
+                      </Table.Td>
+                      <Table.Td>
+                        <Badge color={METHOD_COLORS[log.method]} variant="light">
+                          {log.method}
+                        </Badge>
+                      </Table.Td>
+                      <Table.Td>
+                        <Text size="sm">{log.userName ?? "—"}</Text>
+                        {log.userRole ? (
+                          <Text size="xs" c="dimmed">
+                            {log.userRole}
+                          </Text>
+                        ) : null}
+                      </Table.Td>
+                      <Table.Td>
+                        {log.isSuccess ? (
+                          <Badge color="green" variant="light">
+                            Success
+                          </Badge>
+                        ) : (
+                          // The status code separates "denied" (403) from
+                          // "broke" (500) — both are simply a failure here.
+                          <Tooltip
+                            label={log.errorMessage ?? "Failed"}
+                            multiline
+                            w={280}
+                            disabled={!log.errorMessage}
+                          >
+                            <Badge color="red" variant="light">
+                              Failed{log.statusCode ? ` · ${log.statusCode}` : ""}
+                            </Badge>
+                          </Tooltip>
+                        )}
+                      </Table.Td>
+                      <Table.Td>
+                        <Text size="sm">{formatTimestamp(log.createdAt)}</Text>
+                      </Table.Td>
+                    </Table.Tr>
+                  ))}
+                </Table.Tbody>
+              </Table>
+            </Table.ScrollContainer>
+          )}
+
+          <RuleEngineListFooter
+            pagination={pagination}
+            pageCount={pageCount}
+            totalCount={totalCount}
+            itemLabel="entries"
+            onPaginationChange={handlePaginationChange}
+          />
+        </Stack>
+        </Card>
+
+      <Modal
+        opened={selected !== null}
+        onClose={() => setSelected(null)}
+        title="Audit entry"
+        size="lg"
+      >
+        {selected ? (
+          <Stack gap="sm">
+            <DetailRow label="Action" value={selected.title} />
+            <DetailRow label="Entity" value={selected.type} />
+            <DetailRow label="Record id" value={selected.resourceId} />
+            <DetailRow label="Method" value={selected.method} />
+            <DetailRow label="URL" value={selected.url} />
+            <DetailRow label="Route" value={selected.routePath} />
+            <DetailRow
+              label="Outcome"
+              value={
+                selected.isSuccess
+                  ? `Success${selected.statusCode ? ` (${selected.statusCode})` : ""}`
+                  : `Failed${selected.statusCode ? ` (${selected.statusCode})` : ""}`
+              }
+            />
+            {selected.errorMessage ? (
+              <DetailRow label="Error" value={selected.errorMessage} />
+            ) : null}
+            <DetailRow label="User" value={selected.userName} />
+            <DetailRow label="Role" value={selected.userRole} />
+            <DetailRow label="User id" value={selected.userId} />
+            <DetailRow label="IP address" value={selected.ipAddress} />
+            <DetailRow label="Request id" value={selected.requestId} />
+            <DetailRow
+              label="Duration"
+              value={selected.durationMs === null ? null : `${selected.durationMs} ms`}
+            />
+            <DetailRow label="When" value={formatTimestamp(selected.createdAt)} />
+
+            <div>
+              <Text size="sm" fw={600} mb={4}>
+                Request payload
+              </Text>
+              {selected.request ? (
+                // Secrets are already redacted and uploads reduced to
+                // descriptors by the API before storage.
+                <Code block style={{ maxHeight: 320, overflow: "auto" }}>
+                  {JSON.stringify(selected.request, null, 2)}
+                </Code>
+              ) : (
+                <Text size="sm" c="dimmed">
+                  No payload recorded.
+                </Text>
+              )}
+            </div>
+          </Stack>
+        ) : null}
+      </Modal>
+    </PageContainer>
+  );
+};
+
+const DetailRow = ({ label, value }: { label: string; value: string | null }) => (
+  <Group gap="xs" wrap="nowrap" align="flex-start">
+    <Text size="sm" fw={600} w={120} style={{ flexShrink: 0 }}>
+      {label}
+    </Text>
+    <Text size="sm" style={{ wordBreak: "break-all" }}>
+      {value ?? "—"}
+    </Text>
+  </Group>
+);
+
+export default AuditLogsPage;
diff --git a/apps/edr-freight-web/backoffice/src/pages/HomePage/Header.tsx b/apps/edr-freight-web/backoffice/src/pages/HomePage/Header.tsx
index 645b72d9c..46ddcfe7d 100644
--- a/apps/edr-freight-web/backoffice/src/pages/HomePage/Header.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/HomePage/Header.tsx
@@ -25,8 +25,6 @@ import {
   Cog,
   Bolt,
   Globe,
-  Moon,
-  Sun,
 } from "lucide-react";
 import {
   DropdownMenu,
@@ -39,7 +37,6 @@ import { Button } from "@/shared/common/ui/button";
 import { useTheme } from "@/user-management/web-Management/hooks/useTheme";
 import { useLocalizedName } from "@/shared/common/localizedName";
 import { useModules } from "@/user-management/web-Management/hooks/useModules";
-import { useDarkMode } from "@/shared/hooks/useDarkMode";
 import {
   useTenantConfig,
   resolveModuleConfig,
@@ -98,7 +95,6 @@ const Header = () => {
     logout();
   };
 
-  const { isDarkMode, toggleDarkMode } = useDarkMode();
 
   useEffect(() => {
     if (!localStorage.getItem("i18nextLng")) {
@@ -440,22 +436,6 @@ const Header = () => {
               ))}
             </div>
             <div className="hidden md:flex items-center gap-3 lg:gap-4">
-              <motion.button
-                onClick={toggleDarkMode}
-                className="p-2 rounded-lg text-gray-700 hover:bg-gray-100 dark:text-gray-300 dark:hover:bg-gray-800 transition-colors"
-                whileHover={{ scale: 1.05 }}
-                whileTap={{ scale: 0.95 }}
-                aria-label={
-                  isDarkMode ? t("header.lightMode") : t("header.darkMode")
-                }
-              >
-                {isDarkMode ? (
-                  <Sun className="w-5 h-5" />
-                ) : (
-                  <Moon className="w-5 h-5" />
-                )}
-              </motion.button>
-
               <div className="w-32 lg:w-36">
                 <Select
                   value={currentLanguage}
@@ -522,7 +502,7 @@ const Header = () => {
 
                   <DropdownMenuItem
                     className="flex items-center gap-3 px-3 py-2.5 text-sm text-gray-700 dark:text-gray-300 hover:bg-primary-50 dark:hover:bg-primary-900/30 hover:text-primary-700 dark:hover:text-primary-400 rounded-lg cursor-pointer transition-colors"
-                    onClick={() => navigate("/change-password")}
+                    onClick={() => navigate("/dashboard/profile")}
                   >
                     <Key className="w-4 h-4 text-primary-600 dark:text-primary-400" />
                     <span className="font-medium">
@@ -544,21 +524,6 @@ const Header = () => {
             </div>
 
             <div className="flex items-center md:hidden gap-2">
-              <motion.button
-                onClick={toggleDarkMode}
-                className="p-2 rounded-lg text-gray-600 hover:bg-gray-100 dark:text-gray-300 dark:hover:bg-gray-800 transition-colors"
-                whileTap={{ scale: 0.9 }}
-                aria-label={
-                  isDarkMode ? t("header.lightMode") : t("header.darkMode")
-                }
-              >
-                {isDarkMode ? (
-                  <Sun className="h-5 w-5" />
-                ) : (
-                  <Moon className="h-5 w-5" />
-                )}
-              </motion.button>
-
               <motion.button
                 onClick={() => setMobileMenuOpen(!mobileMenuOpen)}
                 className="inline-flex items-center justify-center p-2 rounded-lg text-gray-600 hover:text-gray-900 hover:bg-gray-100 focus:outline-none focus:ring-2 focus:ring-primary-500 transition-all"
diff --git a/apps/edr-freight-web/backoffice/src/pages/audit/AuditLogsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/audit/AuditLogsPage.tsx
deleted file mode 100644
index ef3412a3a..000000000
--- a/apps/edr-freight-web/backoffice/src/pages/audit/AuditLogsPage.tsx
+++ /dev/null
@@ -1,190 +0,0 @@
-import { Badge, Box, Card, Stack, Text } from "@mantine/core";
-import { useQuery } from "@tanstack/react-query";
-
-import { PageContainer, PageHeader } from "@/components/page";
-import { api } from "@/services/api";
-import type {
-  AuditLogRow,
-  AuditQueryMethod,
-  AuditUser,
-  LocalizedText,
-} from "@/services/audit.service";
-import {
-  DataTable,
-  DataTableFooter,
-  usePagination,
-  type ColumnDef,
-} from "@edr/ui-common";
-
-const ACTION_LABELS: Record<AuditQueryMethod, string> = {
-  INSERT: "Created",
-  UPDATE: "Updated",
-  DELETE: "Deleted",
-  INSERT_CHILD: "Linked child",
-  DELETE_CHILD: "Unlinked child",
-};
-
-const ACTION_COLORS: Record<AuditQueryMethod, string> = {
-  INSERT: "edr-green",
-  UPDATE: "yellow",
-  DELETE: "red",
-  INSERT_CHILD: "indigo",
-  DELETE_CHILD: "gray",
-};
-
-function formatDateTime(iso: string): string {
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleString(undefined, {
-      year: "numeric",
-      month: "short",
-      day: "numeric",
-      hour: "2-digit",
-      minute: "2-digit",
-    });
-}
-
-// See LocalizedText: `name`/`title` lifted from a raw audited entity can be
-// a plain string or IAM's { am, en } — never render either directly.
-// "undefined  undefined" is the producer's own broken template when no user
-// was attached at all (unauthenticated/customer flows, e.g. Fayda
-// verification) — filtered out here rather than shown as raw garbage.
-function localize(value: LocalizedText | null | undefined): string | undefined {
-  if (!value) return undefined;
-  if (typeof value === "object") return value.en ?? value.am ?? undefined;
-  if (/^undefined(\s+undefined)?$/.test(value.trim())) return undefined;
-  return value;
-}
-
-function formatUser(user: AuditUser | null | undefined): string {
-  return localize(user?.name) ?? user?.id ?? "—";
-}
-
-function summarize(row: AuditLogRow): string {
-  if (row.changes?.length) {
-    return row.changes
-      .slice(0, 2)
-      .map((c) => c.field)
-      .join(", ") + (row.changes.length > 2 ? `, +${row.changes.length - 2} more` : "");
-  }
-  if (row.payload) {
-    return (
-      localize(row.payload.name) ?? localize(row.payload.title) ?? row.payload.id ?? "—"
-    );
-  }
-  return "—";
-}
-
-const tableHeader =
-  "text-xs font-semibold uppercase tracking-wide text-muted-foreground";
-
-export default function AuditLogsPage() {
-  const { pagination, setPagination } = usePagination({ pageSize: 20 });
-
-  const filter = {
-    skip: pagination.pageIndex * pagination.pageSize,
-    take: pagination.pageSize,
-  };
-
-  const { data, isLoading, isError } = useQuery(
-    api.audit.list.queryOptions({ input: { filter } }),
-  );
-
-  const rows = data?.items ?? [];
-  const total = data?.count ?? 0;
-  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
-
-  const columns: ColumnDef<AuditLogRow>[] = [
-    {
-      id: "time",
-      header: () => <span className={tableHeader}>Time</span>,
-      cell: ({ row }) => (
-        <span className="text-sm text-muted-foreground">
-          {formatDateTime(row.original.createdAt)}
-        </span>
-      ),
-    },
-    {
-      id: "action",
-      header: () => <span className={tableHeader}>Action</span>,
-      cell: ({ row }) => (
-        <Badge
-          color={ACTION_COLORS[row.original.queryMethod] ?? "gray"}
-          variant="light"
-          radius="sm"
-        >
-          {ACTION_LABELS[row.original.queryMethod] ?? row.original.queryMethod}
-        </Badge>
-      ),
-    },
-    {
-      id: "entity",
-      header: () => <span className={tableHeader}>Entity</span>,
-      cell: ({ row }) => (
-        <span className="font-mono text-sm text-foreground">
-          {row.original.entityName}
-        </span>
-      ),
-    },
-    {
-      id: "user",
-      header: () => <span className={tableHeader}>User</span>,
-      cell: ({ row }) => (
-        <span className="text-sm text-foreground">
-          {formatUser(row.original.auditLog?.user)}
-        </span>
-      ),
-    },
-    {
-      id: "summary",
-      header: () => <span className={tableHeader}>Summary</span>,
-      cell: ({ row }) => (
-        <span className="truncate text-sm text-muted-foreground">
-          {summarize(row.original)}
-        </span>
-      ),
-    },
-  ];
-
-  return (
-    <PageContainer>
-      <PageHeader
-        title="Audit Logs"
-        subtitle="Request and entity-level activity recorded across the freight API."
-      />
-
-      <Card p={0}>
-        <Stack gap={0}>
-          <Box px="md" pt="md" pb="sm" w="100%">
-            <Text size="sm" c="dimmed">
-              {total} record{total !== 1 ? "s" : ""}
-            </Text>
-          </Box>
-
-          <Box style={{ overflowX: "auto" }} w="100%">
-            <DataTable
-              columns={columns}
-              data={rows}
-              status={isLoading ? "loading" : isError ? "error" : "success"}
-              pagination={{
-                pageIndex: pagination.pageIndex,
-                pageSize: pagination.pageSize,
-                pageCount,
-                totalCount: total,
-              }}
-              tableOptions={{
-                state: { pagination },
-                onPaginationChange: setPagination,
-                manualPagination: true,
-                pageCount,
-              }}
-              containerClassName="border-0 shadow-none bg-transparent"
-              footer={DataTableFooter}
-            />
-          </Box>
-        </Stack>
-      </Card>
-    </PageContainer>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/BookingContractPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/BookingContractPage.tsx
index f176fc05d..e4d570da6 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/BookingContractPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/BookingContractPage.tsx
@@ -12,7 +12,6 @@ import toast from "react-hot-toast";
 
 import Breadcrumbs from "@/components/ui/Breadcrumbs";
 import { ContractSignaturePad } from "@/components/bookings/ContractSignaturePad";
-import { StampUpload } from "@/components/contracts/StampUpload";
 import { bookingSurface } from "@/components/bookings/booking-ui.styles";
 import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
 import { invalidateBookingDetail } from "@/utils/queryInvalidation";
@@ -41,9 +40,6 @@ export default function BookingContractPage() {
   const [signOpen, setSignOpen] = useState(false);
   const [signerName, setSignerName] = useState("");
   const [signatureData, setSignatureData] = useState<string | null>(null);
-  // Company stamp: prefilled from the profile, or uploaded here when none is
-  // saved yet.
-  const [stampData, setStampData] = useState<string | null>(null);
   // When the user has a saved signature we offer it for approval first; they
   // can switch to drawing a fresh one.
   const [drawNew, setDrawNew] = useState(false);
@@ -59,7 +55,6 @@ export default function BookingContractPage() {
 
   const savedSignature = data?.savedSignature ?? null;
   const savedSignatureImage = savedSignature?.signatureImageUrl ?? null;
-  const savedStampImage = savedSignature?.stampImageUrl ?? null;
   // Show the approval view only while a saved signature exists and the user
   // hasn't opted to draw a new one.
   const usingSaved = Boolean(savedSignatureImage) && !drawNew;
@@ -103,8 +98,6 @@ export default function BookingContractPage() {
     // approve it; otherwise start with an empty pad.
     setSignerName(savedSignature?.signerDisplayName ?? "");
     setSignatureData(null);
-    // Prefill with the reusable stamp saved on the profile; still replaceable.
-    setStampData(savedStampImage);
     setDrawNew(false);
     setSignOpen(true);
   };
@@ -113,12 +106,12 @@ export default function BookingContractPage() {
     if (!canSign || !signerName.trim()) return;
     // Approve the saved signature, or submit the freshly drawn one.
     const image = usingSaved ? savedSignatureImage : signatureData;
-    // The API rejects a STAFF signature without a stamp.
-    if (!image || !stampData) return;
+    if (!image) return;
+    // No stamp is sent: EDR's seal is the ONE global company stamp, applied
+    // server-side at render time (see StampSettingsService).
     signMutation.mutate({
       role: "STAFF",
       signatureImageBase64: image,
-      stampImageBase64: stampData,
       signerDisplayName: signerName.trim(),
       consentText: "I agree to the terms of this contract.",
     });
@@ -243,15 +236,6 @@ export default function BookingContractPage() {
               ) : (
                 <ContractSignaturePad onChange={setSignatureData} />
               )}
-              <StampUpload
-                value={stampData}
-                onChange={setStampData}
-                description={
-                  savedStampImage
-                    ? "Your saved company stamp — replace it for this contract if needed."
-                    : "Required. Attach your official company stamp or seal."
-                }
-              />
             </div>
             <DialogFooter>
               <Button variant="outline" onClick={() => setSignOpen(false)}>
@@ -261,7 +245,6 @@ export default function BookingContractPage() {
                 disabled={
                   signMutation.isPending ||
                   (!usingSaved && !signatureData) ||
-                  !stampData ||
                   !signerName.trim()
                 }
                 onClick={confirmSign}
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestDetailPage.tsx
index e77b4c44b..f0783ab82 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestDetailPage.tsx
@@ -2,43 +2,63 @@ import { useNavigate, useParams, useSearchParams } from "react-router-dom";
 import toast from "react-hot-toast";
 import {
   ArrowLeft,
+  Container as ContainerIcon,
   FileSignature,
   FileText,
+  Flame,
   FolderOpen,
   Layers,
   LayoutGrid,
+  Link2,
   Milestone,
+  MoreHorizontal,
   Package,
+  RefreshCw,
+  Ship,
   Truck,
+  Wallet,
+  Weight,
 } from "lucide-react";
 import {
-  Container,
-  Stack,
-  Grid,
+  ActionIcon,
+  Alert,
+  Badge,
+  Box,
+  Button,
   Center,
+  Container,
+  Grid,
+  Group,
   Loader,
+  Menu,
+  Paper,
+  SegmentedControl,
+  Stack,
   Tabs,
   Text,
-  Paper,
-  Button,
-  Box,
 } from "@mantine/core";
 
-import { PageContainer } from "@/components/page";
-import Breadcrumbs from "@/components/ui/Breadcrumbs";
+import { PageContainer, PageHeader, KpiStrip } from "@/components/page";
+import type { KpiItem } from "@/components/page";
+import { EntityLink } from "@/components/detail";
 import { BookingActionsToolbar } from "@/components/bookings/BookingActionsToolbar";
 import { BookingPricingSummary } from "@/components/bookings/BookingPricingSummary";
 import { BookingWorkflowStepper } from "@/components/bookings/BookingWorkflowStepper";
+import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
+import { BookingPriorityBadge } from "@/components/bookings/BookingPriorityBadge";
+import { NextStepBanner } from "@/components/bookings/NextStepBanner";
+import { SchedulingStatusBadge } from "@/components/trainScheduling/ScheduleStatusBadge";
 import { ConsolidationWaitingBanner } from "@/components/bookings/detail/ConsolidationWaitingBanner";
+import { ConsolidationApprovalCard } from "@/components/bookings/detail/ConsolidationApprovalCard";
 import {
   detailStyles,
-  BookingRequestHero,
   BookingRouteServiceCard,
   BookingMileServicesCard,
   BookingCargoCard,
   BookingCompanyCard,
-  BookingContractSummaryCard,
+  BookingContractCard,
   BookingContainerUnitsCard,
+  BookingSchedulingWindowCard,
   BookingDocumentsPanel,
   BookingTrucksPanel,
   ContractOrdersPanel,
@@ -46,6 +66,8 @@ import {
 import { WarehouseInfoCard } from "@/components/warehouses";
 import { getStatusMeta } from "@/features/bookings/booking-status.config";
 import { toBookingListRow } from "@/features/bookings/mapBookingListRow";
+import { formatDateTime, formatMoney } from "@/lib/format";
+import { cargoTonsAndItems } from "@/utils/cargoWeight";
 import type { BookingDetail } from "@/types/booking";
 import {
   useBookingDetail,
@@ -60,14 +82,50 @@ export default function BookingRequestDetailPage() {
   const [searchParams, setSearchParams] = useSearchParams();
   // Deep-link from a warehouse fee invoice → this booking's warehouse section.
   useScrollToHash();
+
+  // Consolidated pair: `?booking=<partnerId>` swaps the WHOLE page over to the
+  // other half of the shared wagon. Everything below — KPIs, stepper, the
+  // overview/orders/documents/trucks sub-tabs, the action toolbar — then reads
+  // from the selected booking, so each half gets its own complete detail page
+  // under a top-level tab. The URL id stays put so Back still works.
+  const selectedId = searchParams.get("booking") || id;
   const {
     data: booking,
     isLoading,
     isError,
     refetch,
     isFetching,
-  } = useBookingDetail(id);
-  const mutations = useBookingMutations(id ?? "");
+  } = useBookingDetail(selectedId);
+  const mutations = useBookingMutations(selectedId ?? "");
+
+  // The pair is discovered from whichever half is on screen: each booking
+  // carries a reference to the other.
+  const routeBookingId = id ?? "";
+  const partnerId = booking?.consolidationPartnerId ?? null;
+  const isPaired = Boolean(partnerId);
+  const viewingPartner = selectedId !== routeBookingId;
+  // Tab identities: the booking named by the URL is always the first tab, the
+  // other half the second — regardless of which one is currently displayed.
+  const firstTabId = routeBookingId;
+  const secondTabId = viewingPartner ? selectedId : partnerId;
+
+  // Only for the tab label (reference + customer) — the displayed half is
+  // loaded above. Skipped entirely when the booking is not part of a pair.
+  const { data: otherBooking } = useBookingDetail(
+    secondTabId && secondTabId !== selectedId ? secondTabId : undefined,
+  );
+  const firstTabBooking = viewingPartner ? otherBooking : booking;
+  const secondTabBooking = viewingPartner ? booking : otherBooking;
+
+  const selectBooking = (bookingId: string) => {
+    const next = new URLSearchParams(searchParams);
+    if (bookingId === routeBookingId) next.delete("booking");
+    else next.set("booking", bookingId);
+    // Switching booking resets the sub-tab: the other half has its own content
+    // and may not even have the tab that was open (e.g. Orders).
+    next.delete("tab");
+    setSearchParams(next, { replace: true });
+  };
 
   if (isLoading) {
     return (
@@ -131,7 +189,6 @@ export default function BookingRequestDetailPage() {
     );
   }
 
-  const row = toBookingListRow(booking);
   const statusMeta = getStatusMeta(booking.status);
   // Clearance review + finalize now lives solely on the Operations "Clearance
   // Documents" hub (/dashboard/contracts/clearance-documents → detail page), so
@@ -157,23 +214,242 @@ export default function BookingRequestDetailPage() {
     setSearchParams(next, { replace: true });
   };
 
+  const company = booking.company;
+  const shippingLine = booking.shippingLineCompany ?? null;
+  const customerName = toBookingListRow(booking).customerLabel;
+  // What is being shipped, in words: bulk → the commodity (Wheat, Steel…);
+  // containers → the shipper's own description when given.
+  const cargoLabel =
+    booking.freightType === "BULK"
+      ? (booking.cargoType?.label ?? booking.cargoType?.name ?? null)
+      : (booking.cargoFreeText?.trim() || null);
+
+  const amount = Number(booking.totalAmount);
+  const containers = booking.bookingContainers ?? [];
+  const containerCount = containers.reduce(
+    (sum, c) => sum + Number(c.quantity ?? 0),
+    0,
+  );
+  const { tons: weight, items: itemCount } = cargoTonsAndItems(booking);
+
+  const kpis: KpiItem[] = [
+    {
+      label: "Total value",
+      value: formatMoney(amount, booking.paymentCurrency, 2),
+      hint: booking.paymentStatus,
+      icon: Wallet,
+      color: "edr-green",
+    },
+    {
+      label: "Cargo weight",
+      value: `${weight} T`,
+      hint: itemCount != null ? `${itemCount} items` : "VGM total",
+      icon: Weight,
+      color: "blue",
+    },
+    {
+      label: "Containers",
+      value: containerCount || "—",
+      hint: `${containers.length} line${containers.length === 1 ? "" : "s"}`,
+      icon: ContainerIcon,
+      color: "teal",
+    },
+    {
+      label: "Priority score",
+      value: booking.priorityScore ?? 0,
+      hint: booking.tradeDirection,
+      icon: Flame,
+      color: "orange",
+    },
+  ];
+
+  const hasSignableContract = booking.isGovernment && booking.contractSummary;
+
   return (
     <PageContainer>
-      <Breadcrumbs
-        items={[
+      <PageHeader
+        breadcrumbs={[
           { label: "Booking requests", href: "/dashboard/booking-requests" },
           { label: booking.reference },
         ]}
+        backTo="/dashboard/booking-requests"
+        title={booking.reference}
+        meta={
+          <Group gap={6} wrap="wrap">
+            <BookingStatusBadge status={booking.status} />
+            <BookingPriorityBadge score={booking.priorityScore} />
+            {booking.schedulingStatus ? (
+              <SchedulingStatusBadge status={booking.schedulingStatus} />
+            ) : null}
+          </Group>
+        }
+        subtitle={
+          <Group gap={6} wrap="wrap">
+            {shippingLine ? (
+              <Group gap={6} wrap="nowrap">
+                <Ship size={14} />
+                <Text size="sm" fw={600}>
+                  {shippingLine.name}
+                </Text>
+                <Badge size="xs" radius="sm" variant="light" color="teal">
+                  Shipping line
+                </Badge>
+              </Group>
+            ) : (
+              <EntityLink
+                to={company?.id ? `/dashboard/customers/${company.id}` : null}
+                label={customerName ?? "—"}
+              />
+            )}
+            {cargoLabel ? (
+              <Text size="sm" c="dimmed">
+                · {cargoLabel}
+              </Text>
+            ) : null}
+            <Text size="sm" c="dimmed">
+              · Scheduled {booking.scheduledDate}
+            </Text>
+          </Group>
+        }
+        action={
+          <Group gap="sm" wrap="nowrap">
+            <ActionIcon
+              variant="light"
+              color="edr-green"
+              size="lg"
+              radius="md"
+              loading={isFetching}
+              aria-label="Refresh"
+              onClick={() => refetch()}
+            >
+              <RefreshCw size={16} />
+            </ActionIcon>
+            <Menu position="bottom-end" width={260} withinPortal>
+              <Menu.Target>
+                <ActionIcon
+                  variant="default"
+                  size="lg"
+                  radius="md"
+                  aria-label="More actions"
+                >
+                  <MoreHorizontal size={16} />
+                </ActionIcon>
+              </Menu.Target>
+              <Menu.Dropdown>
+                {hasSignableContract && (
+                  <Menu.Item
+                    leftSection={<FileSignature size={15} />}
+                    onClick={() =>
+                      navigate(`/dashboard/booking-requests/${booking.id}/contract`)
+                    }
+                  >
+                    View / sign contract
+                  </Menu.Item>
+                )}
+                <Menu.Item
+                  leftSection={<FileText size={15} />}
+                  onClick={async () => {
+                    try {
+                      const blob =
+                        await bookingsService.downloadCarriageAcceptanceSheet(
+                          booking.id,
+                        );
+                      const url = URL.createObjectURL(blob);
+                      const a = document.createElement("a");
+                      a.href = url;
+                      a.download = `carriage-acceptance-${booking.reference}.pdf`;
+                      a.click();
+                      URL.revokeObjectURL(url);
+                    } catch (error) {
+                      toast.error(
+                        error instanceof Error
+                          ? error.message
+                          : "Carriage acceptance sheet is not available yet",
+                      );
+                    }
+                  }}
+                >
+                  Carriage acceptance sheet
+                </Menu.Item>
+                {booking.customsClearingEnabled && (
+                  <Menu.Item
+                    leftSection={<Milestone size={15} />}
+                    onClick={() =>
+                      navigate(`/dashboard/bookings/${booking.id}/clearance`)
+                    }
+                  >
+                    View document clearance
+                  </Menu.Item>
+                )}
+              </Menu.Dropdown>
+            </Menu>
+          </Group>
+        }
       />
 
       <Stack gap="lg">
-        <BookingRequestHero
-          booking={booking}
-          customerLabel={row.customerLabel}
-          onBack={() => navigate("/dashboard/booking-requests")}
-          onRefresh={() => refetch()}
-          isFetching={isFetching}
-        />
+        {/* Consolidated pair: one tab per booking, switching the ENTIRE page
+            below. The overview/orders/documents/trucks tabs further down are
+            sub-tabs of whichever booking is selected here. */}
+        {isPaired && secondTabId ? (
+          <Tabs
+            value={selectedId ?? undefined}
+            onChange={(value) => value && selectBooking(value)}
+            variant="pills"
+            radius="md"
+          >
+            <Tabs.List>
+              <Tabs.Tab value={firstTabId} leftSection={<Link2 size={15} />}>
+                <Stack gap={0} align="flex-start">
+                  <Text fz={13} fw={700}>
+                    {firstTabBooking?.reference ?? "Booking"}
+                  </Text>
+                  <Text fz={11} c="dimmed">
+                    {firstTabBooking?.company?.name ?? "—"}
+                  </Text>
+                </Stack>
+              </Tabs.Tab>
+              <Tabs.Tab value={secondTabId} leftSection={<Link2 size={15} />}>
+                <Stack gap={0} align="flex-start">
+                  <Text fz={13} fw={700}>
+                    {secondTabBooking?.reference ?? "Partner booking"}
+                  </Text>
+                  <Text fz={11} c="dimmed">
+                    {secondTabBooking?.company?.name ?? "—"}
+                  </Text>
+                </Stack>
+              </Tabs.Tab>
+            </Tabs.List>
+          </Tabs>
+        ) : null}
+
+        {isPaired ? (
+          <Text size="xs" c="dimmed">
+            These two bookings share one wagon. Accepting or cancelling applies
+            to both; each is invoiced and paid separately.
+          </Text>
+        ) : null}
+
+        <KpiStrip items={kpis} />
+
+        {booking.holdExpiresAt && booking.schedulingStatus === "HOLDING" ? (
+          <Text size="xs" c="orange.7">
+            Hold expires {formatDateTime(booking.holdExpiresAt)}
+          </Text>
+        ) : null}
+
+        {booking.nextStep ? (
+          <Paper
+            radius="lg"
+            p={4}
+            style={{
+              background: "var(--mantine-color-gray-0)",
+              border: "1px solid var(--mantine-color-gray-2)",
+            }}
+          >
+            <NextStepBanner nextStep={booking.nextStep} />
+          </Paper>
+        ) : null}
 
         <BookingWorkflowStepper
           status={booking.status}
@@ -186,6 +462,21 @@ export default function BookingRequestDetailPage() {
           <ConsolidationWaitingBanner bookingId={booking.id} />
         )}
 
+        {booking.status === "CONSOLIDATION_APPROVAL_PENDING" && (
+          <Alert
+            color="yellow"
+            radius="md"
+            icon={<Link2 size={18} />}
+            title="Waiting for shared-wagon approval"
+          >
+            <Text size="sm">
+              This booking shares a wagon with another customer&apos;s booking.
+              Both are held here until the pairing is approved — neither reaches
+              Operations before then.
+            </Text>
+          </Alert>
+        )}
+
         <Grid gap="lg">
           {/* LEFT — primary content, split into tabs to keep each view focused.
               The Documents tab is always present, so the tab bar always renders. */}
@@ -221,7 +512,7 @@ export default function BookingRequestDetailPage() {
                 </Tabs.List>
 
                 <Tabs.Panel value="overview">
-                  <OverviewPanel booking={booking} row={row} />
+                  <OverviewPanel booking={booking} onRefetch={refetch} />
                 </Tabs.Panel>
                 {isGeneralContract && (
                   <Tabs.Panel value="orders">
@@ -245,6 +536,7 @@ export default function BookingRequestDetailPage() {
             <Box style={{ position: "sticky", top: 24 }}>
               <Stack gap="lg">
                 <BookingCompanyCard booking={booking} />
+                <BookingContractCard booking={booking} />
                 <BookingPricingSummary booking={booking} />
                 <Box id="warehouse-payments">
                   <WarehouseInfoCard
@@ -254,63 +546,17 @@ export default function BookingRequestDetailPage() {
                     tradeDirection={booking.tradeDirection}
                   />
                 </Box>
+                {/* Sits directly above the staff actions: reviewing an operation
+                    request means approving the booking onto a specific train, so
+                    that train and its clock must be readable before the approve
+                    button. */}
+                <BookingSchedulingWindowCard booking={booking} />
+                {/* Renders itself only when this booking has a shared wagon. */}
+                <ConsolidationApprovalCard bookingId={booking.id} />
                 <BookingActionsToolbar
                   booking={booking}
                   mutations={mutations}
                 />
-                {booking.isGovernment && booking.contractSummary && (
-                  <Button
-                    fullWidth
-                    variant="default"
-                    leftSection={<FileSignature size={16} />}
-                    onClick={() =>
-                      navigate(
-                        `/dashboard/booking-requests/${booking.id}/contract`,
-                      )
-                    }
-                  >
-                    View / sign contract
-                  </Button>
-                )}
-                <Button
-                  fullWidth
-                  variant="default"
-                  leftSection={<FileText size={16} />}
-                  onClick={async () => {
-                    try {
-                      const blob =
-                        await bookingsService.downloadCarriageAcceptanceSheet(
-                          booking.id,
-                        );
-                      const url = URL.createObjectURL(blob);
-                      const a = document.createElement("a");
-                      a.href = url;
-                      a.download = `carriage-acceptance-${booking.reference}.pdf`;
-                      a.click();
-                      URL.revokeObjectURL(url);
-                    } catch (error) {
-                      toast.error(
-                        error instanceof Error
-                          ? error.message
-                          : "Carriage acceptance sheet is not available yet",
-                      );
-                    }
-                  }}
-                >
-                  Carriage acceptance sheet
-                </Button>
-                {booking.customsClearingEnabled && (
-                  <Button
-                    fullWidth
-                    variant="default"
-                    leftSection={<Milestone size={16} />}
-                    onClick={() =>
-                      navigate(`/dashboard/bookings/${booking.id}/clearance`)
-                    }
-                  >
-                    View document clearance
-                  </Button>
-                )}
               </Stack>
             </Box>
           </Grid.Col>
@@ -323,11 +569,13 @@ export default function BookingRequestDetailPage() {
 /** The booking's primary detail cards — route, services, cargo, containers. */
 function OverviewPanel({
   booking,
-  row,
+  onRefetch,
 }: {
   booking: BookingDetail;
-  row: ReturnType<typeof toBookingListRow>;
+  onRefetch: () => void;
 }) {
+  const row = toBookingListRow(booking);
+
   return (
     <Stack gap="lg">
       <BookingRouteServiceCard
@@ -335,12 +583,49 @@ function OverviewPanel({
         originLabel={row.originLabel}
         destinationLabel={row.destinationLabel}
       />
-      <BookingMileServicesCard booking={booking} />
+      <BookingMileServicesCard
+        booking={booking}
+        handoverSection={
+          booking.tradeDirection === "EXPORT" ? (
+            <Stack gap={6}>
+              <Text size="sm" fw={600}>
+                How the cargo reaches the train
+              </Text>
+              <SegmentedControl
+                fullWidth
+                size="xs"
+                value={booking.exportHandoverMode ?? "WAREHOUSE"}
+                data={[
+                  { value: "WAREHOUSE", label: "Warehouse then train" },
+                  { value: "DIRECT_TO_TRAIN", label: "Direct truck to train" },
+                ]}
+                onChange={async (value) => {
+                  try {
+                    await bookingsService.setExportHandoverMode(
+                      booking.id,
+                      value as "DIRECT_TO_TRAIN" | "WAREHOUSE",
+                    );
+                    onRefetch();
+                  } catch (error) {
+                    toast.error(
+                      error instanceof Error
+                        ? error.message
+                        : "Could not change the handover mode",
+                    );
+                  }
+                }}
+              />
+              <Text size="xs" c="dimmed">
+                {booking.exportHandoverMode === "DIRECT_TO_TRAIN"
+                  ? "No warehouse receipt and no GRN — the carriage acceptance sheet is the handover document."
+                  : "Cargo is received at the warehouse and issued a GRN before loading."}
+              </Text>
+            </Stack>
+          ) : null
+        }
+      />
       <BookingCargoCard booking={booking} />
       <BookingContainerUnitsCard booking={booking} />
-      {booking.contractSummary && (
-        <BookingContractSummaryCard summary={booking.contractSummary} />
-      )}
     </Stack>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestsPage.tsx
index 91eb52033..d0ae6bba3 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/BookingRequestsPage.tsx
@@ -1,40 +1,34 @@
 import { useMyTradeAccess } from "@/hooks/useMyTradeAccess";
 import {
-  ActionIcon,
   Box,
   Button,
   Card,
-  Checkbox,
   Group,
   Modal,
-  MultiSelect,
-  Select,
   Stack,
   Text,
-  TextInput,
 } from "@mantine/core";
-import { DateInput } from "@mantine/dates";
-import { useDebouncedValue } from "@mantine/hooks";
 import {
   AlertTriangle,
   ArrowRight,
   Calendar,
   CheckCircle2,
   Clock,
-  FilterX,
   LayoutList,
+  Link2,
   Package,
   Plus,
   RefreshCw,
-  Search,
+  Ship,
   User,
-  X,
 } from "lucide-react";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { useNavigate, useSearchParams } from "react-router-dom";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { useNavigate } from "react-router-dom";
 import { useQuery } from "@tanstack/react-query";
 
 import { BookingActionsMenu } from "@/components/bookings/BookingActionsMenu";
+import { formatDate, humanize } from "@/lib/format";
+import { FilterBar, dateRangeParams, useFilters, type FilterDef } from "@/components/filters";
 import { BookingPriorityBadge } from "@/components/bookings/BookingPriorityBadge";
 import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
 // BookingStatusTabs / Operations* queues removed — replaced by booking-kind tabs.
@@ -49,7 +43,6 @@ import {
   useBookingList,
   useBookingListSummary,
 } from "@/hooks/bookings/useBookings";
-import { ContractReferenceLink } from "@/components/bookings/ContractReferenceLink";
 import { api } from "@/services/api";
 import type { BookingListFilter } from "@/services/bookings.service";
 import { trainSchedulingService } from "@/services/trainScheduling.service";
@@ -60,7 +53,6 @@ import {
   Badge,
   DataTable,
   DataTableFooter,
-  usePagination,
   type ColumnDef,
 } from "@edr/ui-common";
 
@@ -72,6 +64,12 @@ const BOOKING_KIND_OPTIONS: { value: BookingKind; label: string }[] = [
   { value: "GENERAL_CONTRACT", label: "General booking" },
 ];
 
+/** Who booked: shipping lines own bookings via `shippingLineCompanyId`, not a customer company. */
+const CUSTOMER_KIND_OPTIONS = [
+  { value: "SHIPPING_LINE", label: "Shipping line" },
+  { value: "CUSTOMER", label: "Customer" },
+];
+
 /** Status options for the filter select — built from the shared status styles. */
 const STATUS_OPTIONS = Object.entries(BOOKING_STATUS_STYLES).map(
   ([value, { label }]) => ({ value, label }),
@@ -101,68 +99,11 @@ const OWNERSHIP_OPTIONS = [
   { value: "false", label: "Private" },
 ];
 
-/** Local start-of-day → ISO, for inclusive "from" date filters. */
-function startOfDayIso(d: Date): string {
-  const x = new Date(d);
-  x.setHours(0, 0, 0, 0);
-  return x.toISOString();
-}
-
-/** Local end-of-day → ISO, for inclusive "to" date filters. */
-function endOfDayIso(d: Date): string {
-  const x = new Date(d);
-  x.setHours(23, 59, 59, 999);
-  return x.toISOString();
-}
-
-function formatDate(value: string | null | undefined): string {
-  if (!value) return "—";
-  const d = new Date(value);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      });
-}
-
 export default function BookingRequestsPage() {
   const navigate = useNavigate();
-  // Deep links land here pre-filtered (?statuses=A,B&tradeDirection=IMPORT) —
-  // the header's document-review alarm opens exactly the undecided requests it
-  // is counting down for. Read once as the initial state so staff can then
-  // change the filters like any other visit.
-  const [searchParams] = useSearchParams();
-  const { pagination, setPagination } = usePagination({ pageSize: 10 });
-  const [query, setQuery] = useState("");
-  const [debouncedQuery] = useDebouncedValue(query, 300);
-  // Booking kind is a filter now — one list holds both kinds (null = "all").
-  const [kindFilter, setKindFilter] = useState<BookingKind | null>(null);
-  // Filter controls (empty/null = "all").
-  const paramStatuses = searchParams.get("statuses") ?? "";
-  const paramDirection = searchParams.get("tradeDirection");
-  const [statusFilter, setStatusFilter] = useState<string[]>(() =>
-    paramStatuses.split(",").filter(Boolean),
-  );
   const { filterOptions } = useMyTradeAccess();
-  const [directionFilter, setDirectionFilter] = useState<string | null>(
-    paramDirection,
-  );
-  const [freightTypeFilter, setFreightTypeFilter] = useState<string | null>(null);
-  const [paymentStatusFilter, setPaymentStatusFilter] = useState<string | null>(null);
-  const [ownershipFilter, setOwnershipFilter] = useState<string | null>(null);
-  const [originYardFilter, setOriginYardFilter] = useState<string | null>(null);
-  const [destinationYardFilter, setDestinationYardFilter] = useState<string | null>(null);
-  const [createdFrom, setCreatedFrom] = useState<Date | null>(null);
-  const [createdTo, setCreatedTo] = useState<Date | null>(null);
-  const [scheduledFrom, setScheduledFrom] = useState<Date | null>(null);
-  const [scheduledTo, setScheduledTo] = useState<Date | null>(null);
   const [allocateOpen, setAllocateOpen] = useState(false);
   const [allocateIds, setAllocateIds] = useState<string[]>([]);
-  // Paid bookings with no train attached (staff removed them or a sweep
-  // detached them) — the queue the per-row Allocate action works through.
-  const [paidUnallocated, setPaidUnallocated] = useState(false);
   const [allocatingId, setAllocatingId] = useState<string | null>(null);
   const [otherDayModal, setOtherDayModal] = useState<{
     booking: BookingListRow;
@@ -177,76 +118,6 @@ export default function BookingRequestsPage() {
     }, 400);
   }, []);
 
-  // Follow the URL when a deep link arrives while the page is already open
-  // (clicking the header alarm from this very list). Same-value writes are
-  // dropped so a manual filter change is never undone.
-  useEffect(() => {
-    const next = paramStatuses.split(",").filter(Boolean);
-    setStatusFilter((prev) => (prev.join(",") === next.join(",") ? prev : next));
-    setDirectionFilter(paramDirection);
-  }, [paramStatuses, paramDirection]);
-
-  const filter: BookingListFilter = useMemo(() => {
-    return {
-      page: pagination.pageIndex + 1,
-      pageSize: pagination.pageSize,
-      sortBy: "createdAt",
-      sortOrder: "DESC",
-      // React Query cache key per kind selection ("ALL" when unfiltered).
-      tab: kindFilter ?? "ALL",
-      ...(kindFilter ? { bookingType: kindFilter } : {}),
-      // Server-side free-text search (booking ref, customer, contract ref).
-      ...(debouncedQuery.trim() ? { search: debouncedQuery.trim() } : {}),
-      ...(statusFilter.length ? { statuses: statusFilter.join(",") } : {}),
-      ...(directionFilter ? { tradeDirection: directionFilter } : {}),
-      ...(freightTypeFilter ? { freightType: freightTypeFilter } : {}),
-      ...(paymentStatusFilter ? { paymentStatus: paymentStatusFilter } : {}),
-      // Wins over the payment-status select — the queue is by definition PAID.
-      ...(paidUnallocated
-        ? { paymentStatus: "PAID", assignedToSchedule: "false" as const }
-        : {}),
-      ...(ownershipFilter
-        ? { isGovernment: ownershipFilter as "true" | "false" }
-        : {}),
-      ...(originYardFilter ? { originYardId: originYardFilter } : {}),
-      ...(destinationYardFilter
-        ? { destinationYardId: destinationYardFilter }
-        : {}),
-      ...(createdFrom ? { createdFrom: startOfDayIso(createdFrom) } : {}),
-      ...(createdTo ? { createdTo: endOfDayIso(createdTo) } : {}),
-      ...(scheduledFrom ? { scheduledFrom: startOfDayIso(scheduledFrom) } : {}),
-      ...(scheduledTo ? { scheduledTo: endOfDayIso(scheduledTo) } : {}),
-    };
-  }, [
-    pagination.pageIndex,
-    pagination.pageSize,
-    kindFilter,
-    debouncedQuery,
-    statusFilter,
-    directionFilter,
-    freightTypeFilter,
-    paymentStatusFilter,
-    paidUnallocated,
-    ownershipFilter,
-    originYardFilter,
-    destinationYardFilter,
-    createdFrom,
-    createdTo,
-    scheduledFrom,
-    scheduledTo,
-  ]);
-
-  const { data, isLoading, isError, refetch, isFetching } = useBookingList(filter);
-  const primaryAllocateId = allocateIds[0];
-  const { data: allocateBooking } = useBookingDetail(
-    allocateOpen ? primaryAllocateId : undefined,
-  );
-  const {
-    data: summary,
-    isLoading: summaryLoading,
-    refetch: refetchSummary,
-  } = useBookingListSummary(filter);
-
   // Yard options for the origin/destination filters (shared routes reference list).
   const { data: yardRefs } = useQuery(
     api.routes.yards.queryOptions({ staleTime: 5 * 60_000 }),
@@ -260,50 +131,111 @@ export default function BookingRequestsPage() {
     [yardRefs],
   );
 
-  const resetPage = useCallback(() => {
-    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
-  }, [setPagination, pagination.pageSize]);
+  // Service-type options — same reference-data payload the booking form uses.
+  const { data: refData } = useQuery(
+    api.bookings.referenceData.queryOptions({ staleTime: 5 * 60_000 }),
+  );
+  const serviceTypeOptions = useMemo(
+    () => (refData?.service ?? []).map((s) => ({ value: s.id, label: s.name })),
+    [refData],
+  );
 
-  const activeFilterCount =
-    (kindFilter ? 1 : 0) +
-    (statusFilter.length ? 1 : 0) +
-    (directionFilter ? 1 : 0) +
-    (freightTypeFilter ? 1 : 0) +
-    (paymentStatusFilter ? 1 : 0) +
-    (paidUnallocated ? 1 : 0) +
-    (ownershipFilter ? 1 : 0) +
-    (originYardFilter ? 1 : 0) +
-    (destinationYardFilter ? 1 : 0) +
-    (createdFrom || createdTo ? 1 : 0) +
-    (scheduledFrom || scheduledTo ? 1 : 0);
+  // Deep links land here pre-filtered (?statuses=A,B&tradeDirection=IMPORT) —
+  // the header's document-review alarm opens exactly the undecided requests
+  // it is counting down for. No sync effect needed any more: controls.values
+  // reads live off the URL every render, so a link opened while this page is
+  // already mounted just works, and every filter — direction included —
+  // auto-pins its own pill the moment it has a value (FilterBar's `secondary`
+  // split), so a deep link can never land behind "More filters" unseen.
+  const bookingFilterDefs: FilterDef[] = useMemo(
+    () => [
+      { key: "customerKind", label: "Booked by", type: "enum", multiple: false, options: CUSTOMER_KIND_OPTIONS },
+      { key: "bookingType", label: "Kind", type: "enum", multiple: false, options: BOOKING_KIND_OPTIONS },
+      { key: "statuses", label: "Status", type: "enum", options: STATUS_OPTIONS },
+      {
+        key: "tradeDirection", label: "Direction", type: "enum", multiple: false,
+        options: filterOptions(TRADE_DIRECTION_OPTIONS),
+      },
+      { key: "freightType", label: "Freight", type: "enum", multiple: false, options: FREIGHT_TYPE_OPTIONS },
+      { key: "serviceTypeId", label: "Service", type: "enum", multiple: false, options: serviceTypeOptions },
+      { key: "paymentStatus", label: "Payment", type: "enum", multiple: false, options: PAYMENT_STATUS_OPTIONS, secondary: true },
+      {
+        // Wins over the `paymentStatus` filter above — the queue is by
+        // definition PAID — because it's later in this array: toApiParams
+        // merges defs in order, so a later toParams overwrites an earlier one.
+        key: "paidUnallocated", label: "Allocation", type: "boolean", secondary: true,
+        trueLabel: "Paid, not allocated",
+        toParams: (v) => (v.v[0] === "true" ? { paymentStatus: "PAID", assignedToSchedule: "false" } : {}),
+      },
+      { key: "isGovernment", label: "Ownership", type: "enum", multiple: false, options: OWNERSHIP_OPTIONS, secondary: true },
+      {
+        key: "route", label: "Route", type: "route", options: yardOptions,
+        toParams: ({ v }) => ({ originYardId: v[0], destinationYardId: v[1] }),
+      },
+      {
+        key: "created", label: "Created", type: "date", secondary: true,
+        operators: ["between", "before", "after"],
+        toParams: dateRangeParams("createdFrom", "createdTo"),
+      },
+      {
+        key: "scheduled", label: "Scheduled", type: "date", secondary: true,
+        operators: ["between", "before", "after"],
+        toParams: dateRangeParams("scheduledFrom", "scheduledTo"),
+      },
+    ],
+    [filterOptions, yardOptions, serviceTypeOptions],
+  );
 
-  const clearFilters = useCallback(() => {
-    setKindFilter(null);
-    setStatusFilter([]);
-    setDirectionFilter(null);
-    setFreightTypeFilter(null);
-    setPaymentStatusFilter(null);
-    setPaidUnallocated(false);
-    setOwnershipFilter(null);
-    setOriginYardFilter(null);
-    setDestinationYardFilter(null);
-    setCreatedFrom(null);
-    setCreatedTo(null);
-    setScheduledFrom(null);
-    setScheduledTo(null);
-    resetPage();
-  }, [resetPage]);
+  const controls = useFilters(bookingFilterDefs, { defaultSort: "createdAt:DESC", pageSize: 10 });
+
+  const filter: BookingListFilter = useMemo(
+    () => ({
+      ...(controls.params as unknown as BookingListFilter),
+      // React Query cache key per kind selection ("ALL" when unfiltered) —
+      // kept as a param the API ignores, matching the pre-migration cache key.
+      tab: (controls.values.bookingType?.v[0] as BookingKind | undefined) ?? "ALL",
+    }),
+    [controls.params, controls.values.bookingType],
+  );
+
+  const { data, isLoading, isError, refetch, isFetching } = useBookingList(filter);
+  const primaryAllocateId = allocateIds[0];
+  const { data: allocateBooking } = useBookingDetail(
+    allocateOpen ? primaryAllocateId : undefined,
+  );
+  const {
+    data: summary,
+    isLoading: summaryLoading,
+    refetch: refetchSummary,
+  } = useBookingListSummary(filter);
 
   // Search is applied server-side (via the `search` filter param) — no
   // client-side filtering here.
-  const rows = useMemo(
-    () => (data?.items ?? []).map(toBookingListRow),
-    [data?.items],
-  );
+  const rows = useMemo(() => {
+    const mapped = (data?.items ?? []).map(toBookingListRow);
+    // Consolidated pairs share one wagon and are decided together, so they show
+    // as ONE row. Keep the half that appears first in the current sort and hang
+    // the other on it as `pairedWith`; the row renders both bookings' details
+    // and opens the detail page, where each half gets its own tab.
+    const byId = new Map(mapped.map((row) => [row.id, row]));
+    const absorbed = new Set<string>();
+    const merged: BookingListRow[] = [];
+    for (const row of mapped) {
+      if (absorbed.has(row.id)) continue;
+      const partnerId = row.consolidationPartnerId;
+      const partner = partnerId ? byId.get(partnerId) : undefined;
+      if (partner && !absorbed.has(partner.id)) {
+        absorbed.add(partner.id);
+        merged.push({ ...row, pairedWith: partner });
+        continue;
+      }
+      merged.push(row);
+    }
+    return merged;
+  }, [data?.items]);
 
   const total = data?.total ?? 0;
-  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
-  const hasSearch = query.trim().length > 0;
+  const hasSearch = controls.searchText.trim().length > 0;
   const showEmpty = !isLoading && !isError && rows.length === 0;
 
   const metrics = summary?.metrics;
@@ -389,65 +321,56 @@ export default function BookingRequestsPage() {
       header: () => <span className={bookingTable.headerCell}>Booking</span>,
       cell: ({ row }) => {
         const b = row.original;
+        const isGeneral = b.bookingKind === "GENERAL_CONTRACT";
         return (
           <div className="flex items-center gap-3 py-1.5">
             <div className={bookingTable.rowIcon}>
               <Package className="size-4" strokeWidth={1.75} />
             </div>
-            <div className="min-w-0">
-              <p className="truncate font-medium text-foreground">{b.reference}</p>
+            <div className="min-w-0 max-w-[220px]">
+              <div className="flex items-center gap-1.5">
+                <p className="truncate font-medium text-foreground">{b.reference}</p>
+                <Badge
+                  variant={isGeneral ? "secondary" : "outline"}
+                  className="h-5 shrink-0 px-1.5 text-[10px] font-medium"
+                >
+                  {isGeneral ? "General" : "One-time"}
+                </Badge>
+              </div>
               <p className="mt-0.5 flex items-center gap-1 truncate text-xs text-muted-foreground">
-                <User className="size-3 shrink-0 opacity-70" />
+                {b.isShippingLine ? (
+                  <Ship className="size-3 shrink-0 opacity-70" />
+                ) : (
+                  <User className="size-3 shrink-0 opacity-70" />
+                )}
                 {b.customerLabel}
+                {b.isShippingLine ? (
+                  <Badge variant="secondary" className="h-4 shrink-0 px-1 text-[9px] font-medium">
+                    Shipping line
+                  </Badge>
+                ) : null}
               </p>
+              {/* Shared wagon: the second booking rides in the same row, so the
+                  operator sees both customers before opening the pair. */}
+              {b.pairedWith ? (
+                <div className="mt-1.5 border-l-2 border-muted pl-2">
+                  <div className="flex items-center gap-1.5">
+                    <Link2 className="size-3 shrink-0 opacity-70" />
+                    <p className="truncate text-xs font-medium text-foreground">
+                      {b.pairedWith.reference}
+                    </p>
+                  </div>
+                  <p className="mt-0.5 flex items-center gap-1 truncate text-xs text-muted-foreground">
+                    <User className="size-3 shrink-0 opacity-70" />
+                    {b.pairedWith.customerLabel}
+                  </p>
+                </div>
+              ) : null}
             </div>
           </div>
         );
       },
     },
-    {
-      id: "contract",
-      header: () => <span className={bookingTable.headerCell}>Contract</span>,
-      cell: ({ row }) => {
-        const ref = row.original.contractReference;
-        return (
-          <div className="py-1">
-            {ref ? (
-              // Fall back to plain text when the id is missing — the reference is
-              // still worth showing, it just has nowhere to link to.
-              (row.original.contractId ? (
-                <ContractReferenceLink
-                  contractId={row.original.contractId}
-                  contractReference={ref}
-                  className="truncate font-mono text-xs text-foreground underline underline-offset-2 hover:text-primary"
-                />
-              ) : (
-                <span className="truncate font-mono text-xs text-foreground">{ref}</span>
-              ))
-            ) : (
-              <span className="text-xs text-muted-foreground">—</span>
-            )}
-          </div>
-        );
-      },
-    },
-    {
-      id: "bookingKind",
-      header: () => <span className={bookingTable.headerCell}>Type</span>,
-      cell: ({ row }) => {
-        const isGeneral = row.original.bookingKind === "GENERAL_CONTRACT";
-        return (
-          <div className="py-1">
-            <Badge
-              variant={isGeneral ? "secondary" : "outline"}
-              className="h-5 px-1.5 text-[10px] font-medium"
-            >
-              {isGeneral ? "General" : "One-time"}
-            </Badge>
-          </div>
-        );
-      },
-    },
     {
       id: "route",
       header: () => <span className={bookingTable.headerCell}>Route</span>,
@@ -463,15 +386,15 @@ export default function BookingRequestsPage() {
             <div className="flex gap-1.5">
               <Badge
                 variant="outline"
-                className="h-5 border-border/50 bg-background/50 px-1.5 text-[10px] font-medium uppercase backdrop-blur-sm"
+                className="h-5 border-border/50 bg-background/50 px-1.5 text-[10px] font-medium backdrop-blur-sm"
               >
-                {b.tradeDirection}
+                {humanize(b.tradeDirection)}
               </Badge>
               <Badge
                 variant="secondary"
                 className="h-5 bg-muted/40 px-1.5 text-[10px] font-medium"
               >
-                {b.freightType}
+                {humanize(b.freightType)}
               </Badge>
             </div>
           </div>
@@ -618,213 +541,13 @@ export default function BookingRequestsPage() {
 
           <Card p={0}>
             <Stack gap={0}>
-              <Box px="md" pt="md" pb="sm" w="100%">
-                <Stack gap="sm">
-                  <Group justify="space-between" gap="md" wrap="wrap">
-                    <TextInput
-                      placeholder="Search booking, contract or customer…"
-                      leftSection={<Search size={18} />}
-                      value={query}
-                      onChange={(e) => {
-                        setQuery(e.target.value);
-                        resetPage();
-                      }}
-                      rightSection={
-                        query && (
-                          <ActionIcon
-                            size="sm"
-                            color="gray"
-                            radius="md"
-                            variant="transparent"
-                            onClick={() => {
-                              setQuery("");
-                              resetPage();
-                            }}
-                          >
-                            <X size={16} />
-                          </ActionIcon>
-                        )
-                      }
-                      style={{ flex: 1, minWidth: "200px" }}
-                      radius="lg"
-                    />
-                    <Text size="sm" c="dimmed">
-                      {total} record{total !== 1 ? "s" : ""}
-                    </Text>
-                  </Group>
-                  <Group gap="sm" wrap="wrap">
-                    <Select
-                      placeholder="All booking types"
-                      data={BOOKING_KIND_OPTIONS}
-                      value={kindFilter}
-                      onChange={(v) => {
-                        setKindFilter((v as BookingKind | null) ?? null);
-                        resetPage();
-                      }}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 190 }}
-                    />
-                    <MultiSelect
-                      placeholder={statusFilter.length ? undefined : "All statuses"}
-                      data={STATUS_OPTIONS}
-                      value={statusFilter}
-                      onChange={(v) => {
-                        setStatusFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      searchable
-                      radius="lg"
-                      style={{ minWidth: 220 }}
-                    />
-                    <Select
-                      placeholder="All origins"
-                      data={yardOptions}
-                      value={originYardFilter}
-                      onChange={(v) => {
-                        setOriginYardFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      searchable
-                      radius="lg"
-                      style={{ minWidth: 180 }}
-                    />
-                    <Select
-                      placeholder="All destinations"
-                      data={yardOptions}
-                      value={destinationYardFilter}
-                      onChange={(v) => {
-                        setDestinationYardFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      searchable
-                      radius="lg"
-                      style={{ minWidth: 180 }}
-                    />
-                    <Select
-                      placeholder="All directions"
-                      data={filterOptions(TRADE_DIRECTION_OPTIONS)}
-                      value={directionFilter}
-                      onChange={(v) => {
-                        setDirectionFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 150 }}
-                    />
-                    <Select
-                      placeholder="All freight types"
-                      data={FREIGHT_TYPE_OPTIONS}
-                      value={freightTypeFilter}
-                      onChange={(v) => {
-                        setFreightTypeFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 150 }}
-                    />
-                  </Group>
-                  <Group gap="sm" wrap="wrap">
-                    <Select
-                      placeholder="All payment statuses"
-                      data={PAYMENT_STATUS_OPTIONS}
-                      value={paymentStatusFilter}
-                      onChange={(v) => {
-                        setPaymentStatusFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 180 }}
-                    />
-                    <Checkbox
-                      label="Paid, not allocated"
-                      checked={paidUnallocated}
-                      onChange={(e) => {
-                        setPaidUnallocated(e.currentTarget.checked);
-                        resetPage();
-                      }}
-                      radius="sm"
-                      style={{ alignSelf: "center" }}
-                    />
-                    <Select
-                      placeholder="Gov / Private"
-                      data={OWNERSHIP_OPTIONS}
-                      value={ownershipFilter}
-                      onChange={(v) => {
-                        setOwnershipFilter(v);
-                        resetPage();
-                      }}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 140 }}
-                    />
-                    <DateInput
-                      placeholder="Created from"
-                      value={createdFrom}
-                      onChange={(v) => {
-                        setCreatedFrom(v ? new Date(v) : null);
-                        resetPage();
-                      }}
-                      maxDate={createdTo ?? undefined}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 140 }}
-                    />
-                    <DateInput
-                      placeholder="Created to"
-                      value={createdTo}
-                      onChange={(v) => {
-                        setCreatedTo(v ? new Date(v) : null);
-                        resetPage();
-                      }}
-                      minDate={createdFrom ?? undefined}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 140 }}
-                    />
-                    <DateInput
-                      placeholder="Scheduled from"
-                      value={scheduledFrom}
-                      onChange={(v) => {
-                        setScheduledFrom(v ? new Date(v) : null);
-                        resetPage();
-                      }}
-                      maxDate={scheduledTo ?? undefined}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 150 }}
-                    />
-                    <DateInput
-                      placeholder="Scheduled to"
-                      value={scheduledTo}
-                      onChange={(v) => {
-                        setScheduledTo(v ? new Date(v) : null);
-                        resetPage();
-                      }}
-                      minDate={scheduledFrom ?? undefined}
-                      clearable
-                      radius="lg"
-                      style={{ minWidth: 150 }}
-                    />
-                    {activeFilterCount > 0 ? (
-                      <Button
-                        variant="subtle"
-                        color="gray"
-                        radius="lg"
-                        leftSection={<FilterX size={16} />}
-                        onClick={clearFilters}
-                      >
-                        Clear filters ({activeFilterCount})
-                      </Button>
-                    ) : null}
-                  </Group>
-                </Stack>
+              <Box px="md" pt="sm" pb="xs" w="100%">
+                <FilterBar
+                  defs={bookingFilterDefs}
+                  controls={controls}
+                  searchPlaceholder="Search booking, contract, customer or shipping line…"
+                  viewId="booking-requests"
+                />
               </Box>
 
               {showEmpty ? (
@@ -842,18 +565,7 @@ export default function BookingRequestsPage() {
                     data={rows}
                     status={isLoading ? "loading" : isError ? "error" : "success"}
                     onRowClick={handleRowClick}
-                    pagination={{
-                      pageIndex: pagination.pageIndex,
-                      pageSize: pagination.pageSize,
-                      pageCount,
-                      totalCount: total,
-                    }}
-                    tableOptions={{
-                      state: { pagination },
-                      onPaginationChange: setPagination,
-                      manualPagination: true,
-                      pageCount,
-                    }}
+                    {...controls.tableProps(total)}
                     containerClassName="border-0 shadow-none bg-transparent"
                     footer={DataTableFooter}
                   />
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/ConsolidationApprovalsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/ConsolidationApprovalsPage.tsx
new file mode 100644
index 000000000..1aebe90c3
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/ConsolidationApprovalsPage.tsx
@@ -0,0 +1,284 @@
+import { useState } from "react";
+import { Link } from "react-router-dom";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  Alert,
+  Badge,
+  Box,
+  Button,
+  Center,
+  Group,
+  Loader,
+  Modal,
+  Paper,
+  Stack,
+  Text,
+  Textarea,
+  ThemeIcon,
+} from "@mantine/core";
+import { AlertCircle, Check, Clock, Link2, X } from "lucide-react";
+import toast from "react-hot-toast";
+
+import { PageContainer, PageHeader } from "@/components/page";
+import {
+  bookingsService,
+  type ConsolidationApprovalRow,
+} from "@/services/bookings.service";
+import { formatDateTime } from "@/lib/format";
+import { extractErrorMessage } from "@/utils/errorExtractor";
+
+const QUEUE_KEY = ["consolidation-approvals", "queue"];
+
+/**
+ * Review queue for shared-wagon pairings.
+ *
+ * A booking that fills its own wagons goes straight to Operations. A
+ * consolidated one waits here: two customers' cargo rides one physical wagon
+ * under two separate invoices, so a person signs off on the pairing first.
+ * Approving releases BOTH bookings to Operations; rejecting sends BOTH back to
+ * GL with the reason.
+ */
+export default function ConsolidationApprovalsPage() {
+  const qc = useQueryClient();
+  const [decision, setDecision] = useState<{
+    row: ConsolidationApprovalRow;
+    kind: "approve" | "reject";
+  } | null>(null);
+  const [note, setNote] = useState("");
+
+  const {
+    data: rows,
+    isLoading,
+    isError,
+  } = useQuery({
+    queryKey: QUEUE_KEY,
+    queryFn: () => bookingsService.consolidationApprovalQueue(),
+  });
+
+  const close = () => {
+    setDecision(null);
+    setNote("");
+  };
+
+  const decide = useMutation({
+    mutationFn: () => {
+      if (!decision) throw new Error("No pairing selected");
+      return decision.kind === "approve"
+        ? bookingsService.approveConsolidation(decision.row.id, note.trim() || undefined)
+        : bookingsService.rejectConsolidation(decision.row.id, note.trim());
+    },
+    onSuccess: () => {
+      toast.success(
+        decision?.kind === "approve"
+          ? "Shared wagon approved — both bookings sent to Operations"
+          : "Shared wagon rejected — both bookings returned to GL",
+      );
+      void qc.invalidateQueries({ queryKey: QUEUE_KEY });
+      close();
+    },
+    onError: (error) =>
+      toast.error(extractErrorMessage(error, "Could not record the decision")),
+  });
+
+  // A rejection has to tell GL what to fix, so the reason is mandatory there.
+  const confirmDisabled =
+    decide.isPending || (decision?.kind === "reject" && !note.trim());
+
+  return (
+    <PageContainer>
+      <PageHeader
+        title="Shared wagon approvals"
+        subtitle="Two customers' cargo on one wagon — review the pairing before it reaches Operations."
+      />
+
+      {isLoading ? (
+        <Center py={80}>
+          <Loader color="edr-green" />
+        </Center>
+      ) : isError ? (
+        <Alert color="red" radius="md" icon={<AlertCircle size={16} />}>
+          Could not load the approval queue.
+        </Alert>
+      ) : !rows?.length ? (
+        <Alert color="gray" radius="md" icon={<Check size={16} />}>
+          Nothing waiting for approval.
+        </Alert>
+      ) : (
+        <Stack gap="md">
+          {rows.map((row) => (
+            <Paper
+              key={row.id}
+              withBorder
+              radius="lg"
+              p="lg"
+              style={{ borderColor: "#E6ECF2" }}
+            >
+              <Group justify="space-between" align="flex-start" wrap="wrap" gap="md">
+                <Box style={{ minWidth: 0, flex: 1 }}>
+                  <Group gap={8} align="center" mb={10}>
+                    <ThemeIcon variant="light" color="blue" radius="md" size={30}>
+                      <Link2 size={16} />
+                    </ThemeIcon>
+                    <Text fw={800} fz={15}>
+                      Shared wagon
+                    </Text>
+                    <Badge color="yellow" variant="light" radius="sm">
+                      Awaiting approval
+                    </Badge>
+                  </Group>
+
+                  <Group gap="xl" wrap="wrap">
+                    <BookingSide
+                      id={row.bookingId}
+                      reference={row.booking?.reference ?? row.bookingReference}
+                      company={row.booking?.company?.name}
+                    />
+                    <BookingSide
+                      id={row.partnerBookingId}
+                      reference={
+                        row.partnerBooking?.reference ??
+                        row.partnerBookingReference
+                      }
+                      company={row.partnerBooking?.company?.name}
+                    />
+                  </Group>
+
+                  <Group gap={6} mt={12} c="dimmed">
+                    <Clock size={13} />
+                    <Text fz={12}>
+                      Requested {formatDateTime(row.requestedAt)}
+                      {row.scheduledDate
+                        ? ` · ships ${formatDateTime(row.scheduledDate)}`
+                        : ""}
+                    </Text>
+                  </Group>
+                </Box>
+
+                <Group gap="sm">
+                  <Button
+                    color="edr-green"
+                    radius="md"
+                    leftSection={<Check size={15} />}
+                    onClick={() => {
+                      setDecision({ row, kind: "approve" });
+                      setNote("");
+                    }}
+                  >
+                    Approve
+                  </Button>
+                  <Button
+                    color="red"
+                    variant="light"
+                    radius="md"
+                    leftSection={<X size={15} />}
+                    onClick={() => {
+                      setDecision({ row, kind: "reject" });
+                      setNote("");
+                    }}
+                  >
+                    Reject
+                  </Button>
+                </Group>
+              </Group>
+            </Paper>
+          ))}
+        </Stack>
+      )}
+
+      <Modal
+        opened={Boolean(decision)}
+        onClose={() => {
+          if (!decide.isPending) close();
+        }}
+        centered
+        radius="lg"
+        title={
+          <Text fw={800} fz={16}>
+            {decision?.kind === "approve"
+              ? "Approve this shared wagon?"
+              : "Reject this shared wagon?"}
+          </Text>
+        }
+      >
+        <Stack gap="md">
+          <Text fz="sm" c="dimmed">
+            {decision?.kind === "approve"
+              ? "Both bookings leave the gate together and continue to Operations. Each is still invoiced and paid separately."
+              : "Both bookings go back to GL as “changes requested” with your reason. Neither reaches Operations."}
+          </Text>
+
+          <Textarea
+            label={
+              decision?.kind === "approve"
+                ? "Note (optional)"
+                : "Reason (required)"
+            }
+            description={
+              decision?.kind === "approve"
+                ? "Recorded with the approval for the audit trail."
+                : "GL sees this on both bookings — say what has to change."
+            }
+            placeholder={
+              decision?.kind === "approve"
+                ? "Anything worth recording…"
+                : "e.g. the partner's cargo weights are unbalanced for one wagon"
+            }
+            value={note}
+            onChange={(e) => setNote(e.currentTarget.value)}
+            autosize
+            minRows={3}
+          />
+
+          <Group justify="flex-end" gap="sm">
+            <Button
+              variant="default"
+              radius="md"
+              onClick={close}
+              disabled={decide.isPending}
+            >
+              Cancel
+            </Button>
+            <Button
+              color={decision?.kind === "approve" ? "edr-green" : "red"}
+              radius="md"
+              loading={decide.isPending}
+              disabled={confirmDisabled}
+              onClick={() => decide.mutate()}
+            >
+              {decision?.kind === "approve" ? "Approve both" : "Reject both"}
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </PageContainer>
+  );
+}
+
+/** One half of the wagon: its reference (linked) and whose cargo it is. */
+function BookingSide({
+  id,
+  reference,
+  company,
+}: {
+  id: string;
+  reference?: string | null;
+  company?: string | null;
+}) {
+  return (
+    <Box style={{ minWidth: 0 }}>
+      <Text
+        component={Link}
+        to={`/dashboard/booking-requests/${id}`}
+        fz={14}
+        fw={700}
+        c="blue.7"
+        style={{ textDecoration: "none" }}
+      >
+        {reference ?? "—"}
+      </Text>
+      <Text fz={12.5} c="dimmed">
+        {company ?? "—"}
+      </Text>
+    </Box>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceDetailPage.tsx
index dd7513a42..d98039947 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceDetailPage.tsx
@@ -10,11 +10,9 @@ import {
   Group,
   Loader,
   Paper,
-  Progress,
   RingProgress,
   Stack,
   Text,
-  ThemeIcon,
 } from "@mantine/core";
 import {
   AlertCircle,
@@ -29,9 +27,14 @@ import {
 import type { Freight } from "@edr/types";
 
 import { ClearanceOpsTabs } from "@/components/contracts/ClearanceOpsTabs";
-import { PageContainer } from "@/components/page/PageContainer";
-import { PageHeader } from "@/components/page/PageHeader";
-import { SectionCard } from "@/components/bookings/detail";
+import { BookingChangesRequestedAlert } from "@/components/contracts/BookingChangesRequestedAlert";
+import { PageContainer, PageHeader, KpiStrip } from "@/components/page";
+import type { KpiItem } from "@/components/page";
+import {
+  SectionCard,
+  BookingCompanyCard,
+  BookingContractCard,
+} from "@/components/bookings/detail";
 import { ClearanceReviewSection } from "@/components/bookings/detail/ClearanceReviewSection";
 import { ClearancePhaseStepper } from "@/components/contracts/ClearancePhaseStepper";
 import { PhasedClearanceActionPanel } from "@/components/contracts/PhasedClearanceActionPanel";
@@ -102,8 +105,15 @@ export default function DocumentClearanceDetailPage() {
     const queried = docs.filter((d) => d.reviewStatus === "QUERIED").length;
     const pending = total - approved - queried;
     const pct = total === 0 ? 0 : Math.round((approved / total) * 100);
-    return { total, approved, queried, pending, pct };
+    // Documents actually sitting with GL: a file is present but not approved.
+    // Excludes required slots the customer never filled — those are on the
+    // customer, not on GL.
+    const awaitingReview = docs.filter(
+      (d) => d.file && d.reviewStatus !== "APPROVED",
+    ).length;
+    return { total, approved, queried, pending, pct, awaitingReview };
   }, [clearance]);
+  const awaitingReview = stats.awaitingReview;
 
   const reference = booking?.reference ?? "Clearance";
   // Phased customs clearance runs on every contract booking now — ONE_TIME and
@@ -132,13 +142,26 @@ export default function DocumentClearanceDetailPage() {
     hasPermission(user, FREIGHT_PERMS.contracts.createBooking) &&
     !isDjiboutiGl(user);
 
-  const docsPhaseComplete =
-    clearance?.milestones?.some(
-      (m) => m.milestoneCode === "DOCUMENTS_APPROVED" && m.status === "COMPLETED",
-    ) ?? false;
-  const queriesLocked = Boolean(
-    (clearance as Freight.ContractClearanceView | undefined)?.preClearanceFinalized,
-  );
+  // Operations sent this GL-created booking back for changes. Customs bookings
+  // are never self-booked (see BookingChangesRequestedAlert) — the note and the
+  // resubmit belong here, on the page GL works from, not the customer's portal.
+  const bookingNeedsChanges = booking?.status === "OPERATION_CHANGES_REQUESTED";
+  const isGlBookingOwner =
+    hasPermission(user, FREIGHT_PERMS.contracts.createBooking) &&
+    !isDjiboutiGl(user);
+  const changeRequestNote =
+    [...(booking?.reviewNotes ?? [])]
+      .filter((n) => n.type === "CHANGES_REQUESTED")
+      .sort(
+        (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),
+      )[0]?.note ?? null;
+
+  // Documents stay reviewable for as long as the customer can still submit
+  // them — until the shipment is paid, not merely until clearance is
+  // finalized. `documentsOpen` is the server's own predicate (the same one
+  // both the upload and review endpoints gate on), so the buttons are shown
+  // exactly when the API would accept them.
+  const documentsClosed = clearance?.documentsOpen === false;
   const workflowFiles =
     (clearance as Freight.ContractClearanceView | undefined)?.workflowFiles ?? [];
 
@@ -171,6 +194,18 @@ export default function DocumentClearanceDetailPage() {
     );
   }
 
+  const direction = booking?.tradeDirection ?? "—";
+  const origin = booking?.originYard?.label ?? booking?.originYard?.code ?? "Origin";
+  const destination =
+    booking?.destinationYard?.label ?? booking?.destinationYard?.code ?? "Destination";
+
+  const kpis: KpiItem[] = [
+    { label: "Approved", value: stats.approved, icon: CheckCircle2, color: "edr-green" },
+    { label: "Queried", value: stats.queried, icon: AlertCircle, color: "red" },
+    { label: "Pending", value: stats.pending, icon: Clock, color: "gray" },
+    { label: "Review progress", value: `${stats.pct}%`, icon: PackageCheck, color: "blue" },
+  ];
+
   return (
     <PageContainer>
       <Stack gap="lg">
@@ -182,25 +217,58 @@ export default function DocumentClearanceDetailPage() {
             { label: reference },
           ]}
           meta={
-            clearance.allApproved ? (
-              <Badge
-                variant="light"
-                color="edr-green"
-                radius="sm"
-                leftSection={<CheckCircle2 size={13} />}
-              >
-                All approved
+            <Group gap={6} wrap="wrap">
+              <Badge variant="light" color={direction === "IMPORT" ? "edr-green" : "gray"} radius="sm">
+                {direction}
               </Badge>
-            ) : (
-              <Badge
-                variant="light"
-                color="gray"
-                radius="sm"
-                leftSection={<Clock size={13} />}
-              >
-                Review pending
-              </Badge>
-            )
+              {clearance.includesCustoms ? (
+                <Badge variant="light" color="edr-green" radius="sm" leftSection={<ShieldCheck size={12} />}>
+                  Customs
+                </Badge>
+              ) : null}
+              {/* Waiting on GL: an uploaded document with no decision yet, or
+                  one under query. `allApproved` only covers the REQUIRED set,
+                  so an ad-hoc file added after clearance never moves it. */}
+              {awaitingReview > 0 ? (
+                <Badge
+                  variant="filled"
+                  color="orange"
+                  radius="sm"
+                  leftSection={<Clock size={13} />}
+                >
+                  {awaitingReview} needs approval
+                </Badge>
+              ) : clearance.allApproved ? (
+                <Badge
+                  variant="light"
+                  color="edr-green"
+                  radius="sm"
+                  leftSection={<CheckCircle2 size={13} />}
+                >
+                  All approved
+                </Badge>
+              ) : (
+                <Badge
+                  variant="light"
+                  color="gray"
+                  radius="sm"
+                  leftSection={<Clock size={13} />}
+                >
+                  Review pending
+                </Badge>
+              )}
+            </Group>
+          }
+          subtitle={
+            <Group gap={8} wrap="nowrap">
+              <Text size="sm" c="dimmed" fw={600}>
+                {origin}
+              </Text>
+              <ArrowRight size={14} className="shrink-0 text-muted-foreground" />
+              <Text size="sm" c="dimmed" fw={600}>
+                {destination}
+              </Text>
+            </Group>
           }
           action={
             canCompleteBooking ? (
@@ -233,12 +301,32 @@ export default function DocumentClearanceDetailPage() {
           }
         />
 
-        <ClearanceHero
-          booking={booking}
-          clearance={clearance}
-          stats={stats}
-          requestedLines={requestedLines}
-        />
+        {bookingNeedsChanges ? (
+          <BookingChangesRequestedAlert
+            bookingId={id!}
+            reference={booking?.reference}
+            note={changeRequestNote}
+            scheduledDate={booking?.scheduledDate}
+            canResubmit={isGlBookingOwner}
+            editHref={
+              booking?.contractId
+                ? `/dashboard/contracts/${booking.contractId}/bookings/${id}/complete?copyFrom=${id}`
+                : undefined
+            }
+            onResubmitted={() => void refetch()}
+          />
+        ) : null}
+
+        <KpiStrip items={kpis} />
+
+        {requestedLines ? (
+          <Group gap={10} align="center" wrap="wrap">
+            <Text size="xs" fw={700} tt="uppercase" c="dimmed" lts="0.05em">
+              Requested cargo
+            </Text>
+            <RequestedCargoChips lines={requestedLines} size="sm" />
+          </Group>
+        ) : null}
 
         {isPhasedGeneral ? (
           <Paper withBorder radius="md" p="lg">
@@ -265,75 +353,62 @@ export default function DocumentClearanceDetailPage() {
                 <ClearanceReviewSection
                   bookingId={id!}
                   hideSummary
-                  approvalsLocked={isPhasedGeneral && docsPhaseComplete}
-                  queriesLocked={queriesLocked}
+                  approvalsLocked={documentsClosed}
+                  queriesLocked={documentsClosed}
                   phasedCustoms={isPhasedGeneral}
                   onChanged={() => void refetch()}
                 />
               </Grid.Col>
 
               <Grid.Col span={{ base: 12, lg: isPhasedGeneral ? 5 : 4 }}>
-                {isPhasedGeneral ? (
-                  <PhasedClearanceActionPanel
-                    bookingId={id!}
-                    clearance={clearance}
-                    tradeDirection={booking?.tradeDirection ?? "IMPORT"}
-                    workflowFiles={workflowFiles}
-                    roleMode="ET"
-                    // A bare initiated instance still has no cargo/price — the
-                    // stepper's "Create booking" step must read as NOT-yet-created
-                    // so it never claims the booking is done before GL completes it.
-                    bookingCreated={Number(booking?.totalAmount ?? 0) > 0}
-                    bookingMilestones={bookingMilestones ?? []}
-                    onChanged={() => void refetch()}
-                    onViewFile={view}
-                    onDownloadFile={(f) => void downloadBookingFile(f.id, f.name)}
-                  />
-                ) : (
-                  <Box style={{ position: "sticky", top: 24 }}>
-                    <SectionCard
-                      icon={PackageCheck}
-                      title="Review progress"
-                      accent="edr-green"
-                    >
-                      <Stack align="center" gap="sm">
-                        <RingProgress
-                          size={140}
-                          thickness={12}
-                          roundCaps
-                          sections={[{ value: stats.pct, color: "edr-green" }]}
-                          label={
-                            <Stack gap={0} align="center">
-                              <Text fw={800} fz={26} lh={1}>
-                                {stats.pct}%
-                              </Text>
-                              <Text size="xs" c="dimmed">
-                                approved
-                              </Text>
-                            </Stack>
-                          }
-                        />
-                        <Group gap="lg" justify="center">
-                          <ProgressStat
-                            color="edr-green"
-                            label="Approved"
-                            value={stats.approved}
+                <Box style={{ position: "sticky", top: 24 }}>
+                  <Stack gap="lg">
+                    {booking ? <BookingCompanyCard booking={booking} /> : null}
+                    {booking ? <BookingContractCard booking={booking} /> : null}
+                    {isPhasedGeneral ? (
+                      <PhasedClearanceActionPanel
+                        bookingId={id!}
+                        clearance={clearance}
+                        tradeDirection={booking?.tradeDirection ?? "IMPORT"}
+                        workflowFiles={workflowFiles}
+                        roleMode="ET"
+                        // A bare initiated instance still has no cargo/price — the
+                        // stepper's "Create booking" step must read as NOT-yet-created
+                        // so it never claims the booking is done before GL completes it.
+                        bookingCreated={Number(booking?.totalAmount ?? 0) > 0}
+                        bookingMilestones={bookingMilestones ?? []}
+                        onChanged={() => void refetch()}
+                        onViewFile={view}
+                        onDownloadFile={(f) => void downloadBookingFile(f.id, f.name)}
+                      />
+                    ) : (
+                      <SectionCard
+                        icon={PackageCheck}
+                        title="Review progress"
+                        accent="edr-green"
+                      >
+                        <Stack align="center" gap="sm">
+                          <RingProgress
+                            size={140}
+                            thickness={12}
+                            roundCaps
+                            sections={[{ value: stats.pct, color: "edr-green" }]}
+                            label={
+                              <Stack gap={0} align="center">
+                                <Text fw={800} fz={26} lh={1}>
+                                  {stats.pct}%
+                                </Text>
+                                <Text size="xs" c="dimmed">
+                                  approved
+                                </Text>
+                              </Stack>
+                            }
                           />
-                          <ProgressStat
-                            color="red"
-                            label="Queried"
-                            value={stats.queried}
-                          />
-                          <ProgressStat
-                            color="gray"
-                            label="Pending"
-                            value={stats.pending}
-                          />
-                        </Group>
-                      </Stack>
-                    </SectionCard>
-                  </Box>
-                )}
+                        </Stack>
+                      </SectionCard>
+                    )}
+                  </Stack>
+                </Box>
               </Grid.Col>
             </Grid>
           }
@@ -347,125 +422,3 @@ export default function DocumentClearanceDetailPage() {
     </PageContainer>
   );
 }
-
-function ClearanceHero({
-  booking,
-  clearance,
-  stats,
-  requestedLines,
-}: {
-  booking: ReturnType<typeof useBookingDetail>["data"];
-  clearance: Freight.ClearanceView;
-  stats: { pct: number; approved: number; total: number };
-  requestedLines?: Freight.RequestedShipmentLines | null;
-}) {
-  const direction = booking?.tradeDirection ?? "—";
-  const origin =
-    booking?.originYard?.label ?? booking?.originYard?.code ?? "Origin";
-  const destination =
-    booking?.destinationYard?.label ??
-    booking?.destinationYard?.code ??
-    "Destination";
-
-  return (
-    <Paper withBorder radius="md" p="lg">
-      <Group justify="space-between" align="flex-start" wrap="wrap" gap="lg">
-        <Group gap="md" wrap="nowrap" style={{ minWidth: 0 }}>
-          <ThemeIcon variant="light" color="edr-green" radius="md" size={52}>
-            <ShieldCheck size={26} />
-          </ThemeIcon>
-          <Box style={{ minWidth: 0 }}>
-            <Group gap={8} wrap="nowrap">
-              <Text fw={800} fz={20} c="edr-text" truncate>
-                {booking?.reference ?? "Clearance"}
-              </Text>
-              <Badge
-                size="sm"
-                variant="light"
-                color={direction === "IMPORT" ? "edr-green" : "gray"}
-                radius="sm"
-              >
-                {direction}
-              </Badge>
-              {clearance.includesCustoms ? (
-                <Badge
-                  size="sm"
-                  variant="light"
-                  color="edr-green"
-                  radius="sm"
-                  leftSection={<ShieldCheck size={12} />}
-                >
-                  Customs
-                </Badge>
-              ) : null}
-            </Group>
-            <Group gap={8} mt={6} wrap="nowrap">
-              <Text size="sm" fw={600} truncate maw={160}>
-                {origin}
-              </Text>
-              <ArrowRight size={15} className="shrink-0 text-muted-foreground" />
-              <Text size="sm" fw={600} truncate maw={160}>
-                {destination}
-              </Text>
-            </Group>
-          </Box>
-        </Group>
-
-        <Box style={{ minWidth: 200, flex: 1, maxWidth: 320 }}>
-          <Group justify="space-between" mb={6}>
-            <Text size="xs" c="dimmed" fw={600}>
-              Document review
-            </Text>
-            <Text size="xs" c="dimmed">
-              {stats.approved}/{stats.total}
-            </Text>
-          </Group>
-          <Progress value={stats.pct} color="edr-green" radius="xl" size="md" />
-        </Box>
-      </Group>
-
-      {requestedLines ? (
-        <>
-          <Box my="md" h={1} bg="var(--mantine-color-default-border)" />
-          <Group gap={10} align="center" wrap="wrap">
-            <Text size="xs" fw={700} tt="uppercase" c="dimmed" lts="0.05em">
-              Requested cargo
-            </Text>
-            <RequestedCargoChips lines={requestedLines} size="sm" />
-          </Group>
-        </>
-      ) : null}
-    </Paper>
-  );
-}
-
-function ProgressStat({
-  color,
-  label,
-  value,
-}: {
-  color: string;
-  label: string;
-  value: number;
-}) {
-  return (
-    <Stack gap={2} align="center">
-      <Text fw={700} fz={18} c="edr-text">
-        {value}
-      </Text>
-      <Group gap={4} wrap="nowrap">
-        <Box
-          style={{
-            width: 7,
-            height: 7,
-            borderRadius: 999,
-            background: `var(--mantine-color-${color}-6)`,
-          }}
-        />
-        <Text fz="11px" c="dimmed">
-          {label}
-        </Text>
-      </Group>
-    </Stack>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceListPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceListPage.tsx
index b0e199d12..2476bc24e 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceListPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/DocumentClearanceListPage.tsx
@@ -471,9 +471,6 @@ export default function DocumentClearanceListPage({
                   style={{ flex: 1, minWidth: 220 }}
                 />
                 <Group gap="sm" wrap="nowrap">
-                  <Text size="sm" c="dimmed">
-                    {total} record{total !== 1 ? "s" : ""}
-                  </Text>
                   <SegmentedControl
                     size="sm"
                     radius="md"
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/NewBookingPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/NewBookingPage.tsx
index 489e324e8..4062c439a 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/NewBookingPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/NewBookingPage.tsx
@@ -42,6 +42,7 @@ import Breadcrumbs from "@/components/ui/Breadcrumbs";
 import { api as appApi } from "@/services/api";
 import { bookingsService } from "@/services/bookings.service";
 import { customersService } from "@/services/customers.service";
+import { formatDateTime } from "@/lib/format";
 
 interface RefNamed {
   id: string;
@@ -529,10 +530,7 @@ export default function NewBookingPage() {
                 />
                 <Select
                   label="Payment currency"
-                  data={[
-                    { value: "ETB", label: "ETB — Birr" },
-                    { value: "USD", label: "USD — Dollar" },
-                  ]}
+                  data={[{ value: "ETB", label: "ETB — Birr" }]}
                   value={paymentCurrency}
                   onChange={(v) => setPaymentCurrency(v ?? "ETB")}
                 />
@@ -708,7 +706,7 @@ export default function NewBookingPage() {
                 />
                 <SummaryRow
                   label="Departure"
-                  value={effectiveDepartureIso ? new Date(effectiveDepartureIso).toLocaleString() : "Not set"}
+                  value={effectiveDepartureIso ? formatDateTime(effectiveDepartureIso) : "Not set"}
                 />
               </Stack>
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/bookings/WagonCancellationsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/bookings/WagonCancellationsPage.tsx
index fff83d479..091a8d5a2 100644
--- a/apps/edr-freight-web/backoffice/src/pages/bookings/WagonCancellationsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/bookings/WagonCancellationsPage.tsx
@@ -11,7 +11,8 @@ import {
   Text,
   TextInput,
 } from "@mantine/core";
-import { DateInput } from "@mantine/dates";
+import { DatePickerInput } from "@mantine/dates";
+import { getDateRangePresets } from "@/components/common/dateRangePresets";
 import { useDebouncedValue } from "@mantine/hooks";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { Search, XCircle } from "lucide-react";
@@ -23,6 +24,7 @@ import { api } from "@/auth/http";
 import { useAuth } from "@/auth/useAuth";
 import { PageContainer, PageHeader } from "@/components/page";
 import { toDayString } from "@/hooks/useListControls";
+import { formatDate, formatMoney } from "@/lib/format";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import {
   DataTable,
@@ -95,24 +97,6 @@ function StatusChip({ status }: { status: WagonCancellationStatus }) {
   );
 }
 
-function formatDate(iso: string | null | undefined): string {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      });
-}
-
-function formatAmount(amount: number, currency: string): string {
-  return `${currency} ${Number(amount).toLocaleString(undefined, {
-    minimumFractionDigits: 2,
-  })}`;
-}
-
 /**
  * Staff view of partial wagon cancellations: every slice of capacity a
  * customer gave back, its cancellation fee, and where the credit went
@@ -195,7 +179,9 @@ export default function WagonCancellationsPage() {
       id: "company",
       header: () => <span>Company</span>,
       cell: ({ row }) => (
-        <Text size="sm">{row.original.booking?.company?.name ?? "—"}</Text>
+        <Text size="sm" truncate maw={200}>
+          {row.original.booking?.company?.name ?? "—"}
+        </Text>
       ),
     },
     {
@@ -208,7 +194,7 @@ export default function WagonCancellationsPage() {
       header: () => <span>Fee</span>,
       cell: ({ row }) => (
         <Text size="sm" style={{ fontVariantNumeric: "tabular-nums" }}>
-          {formatAmount(row.original.feeAmount, row.original.feeCurrency)}
+          {formatMoney(row.original.feeAmount, row.original.feeCurrency, 2)}
         </Text>
       ),
     },
@@ -217,7 +203,7 @@ export default function WagonCancellationsPage() {
       header: () => <span>Credit</span>,
       cell: ({ row }) => (
         <Text size="sm" style={{ fontVariantNumeric: "tabular-nums" }}>
-          {formatAmount(row.original.creditAmount, row.original.feeCurrency)}
+          {formatMoney(row.original.creditAmount, row.original.feeCurrency, 2)}
         </Text>
       ),
     },
@@ -304,29 +290,19 @@ export default function WagonCancellationsPage() {
                 w={190}
                 radius="md"
               />
-              <DateInput
-                placeholder="From"
-                value={from}
-                onChange={(v) => {
-                  setFrom(v ? new Date(v) : null);
+              <DatePickerInput
+                type="range"
+                placeholder="Date range"
+                value={[from, to]}
+                onChange={([newFrom, newTo]) => {
+                  setFrom(newFrom ? new Date(newFrom) : null);
+                  setTo(newTo ? new Date(newTo) : null);
                   resetPage();
                 }}
-                maxDate={to ?? undefined}
+                presets={getDateRangePresets()}
                 clearable
                 radius="md"
-                style={{ minWidth: 140 }}
-              />
-              <DateInput
-                placeholder="To"
-                value={to}
-                onChange={(v) => {
-                  setTo(v ? new Date(v) : null);
-                  resetPage();
-                }}
-                minDate={from ?? undefined}
-                clearable
-                radius="md"
-                style={{ minWidth: 140 }}
+                style={{ minWidth: 220 }}
               />
               <Button
                 variant="subtle"
@@ -379,7 +355,7 @@ export default function WagonCancellationsPage() {
             <Text size="sm">
               {voiding.booking?.reference ?? voiding.bookingId} ·{" "}
               {voiding.wagonsCancelled} wagon(s) · fee{" "}
-              {formatAmount(voiding.feeAmount, voiding.feeCurrency)}
+              {formatMoney(voiding.feeAmount, voiding.feeCurrency, 2)}
             </Text>
             <Text size="sm" c="dimmed">
               The pending fee is dropped and the wagons stay on the booking.
diff --git a/apps/edr-freight-web/backoffice/src/pages/chat/ChatLaunchPage.tsx b/apps/edr-freight-web/backoffice/src/pages/chat/ChatLaunchPage.tsx
new file mode 100644
index 000000000..78f0e7c36
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/chat/ChatLaunchPage.tsx
@@ -0,0 +1,78 @@
+import { Alert, Button, Card, Center, Stack, Text } from "@mantine/core";
+import { MessageSquare, TriangleAlert } from "lucide-react";
+import { useState } from "react";
+
+import { PageContainer, PageHeader } from "@/components/page";
+import { chatApi } from "@/features/chat/chatApi";
+
+/**
+ * Chat itself lives at chat.edr.et (Element), not in this app — this page's
+ * only job is a one-click sign-in link into it. No iframe: Element's own CSP
+ * refuses to be framed.
+ *
+ * The link is minted per click, never on mount and never cached: Synapse's
+ * login_token is single-use and expires in 5 minutes, and Element reports a
+ * spent one as "Incorrect username and/or password". A held-onto url is
+ * therefore wrong on the second click, on a remount served from cache, and on
+ * any click more than 5 minutes after the page loaded.
+ */
+export default function ChatLaunchPage() {
+  const [state, setState] = useState<"idle" | "loading" | "error">("idle");
+
+  const open = async () => {
+    // Opened before the await so it still counts as the user's click — a
+    // window.open() after it is treated as a popup and blocked.
+    //
+    // No "noopener" in the features: passing it makes window.open return null,
+    // which would leave this blank tab orphaned and send Element into the
+    // current tab instead. Clearing .opener on the handle does the same job.
+    const tab = window.open("", "_blank");
+    if (tab) tab.opener = null;
+    setState("loading");
+    try {
+      const url = await chatApi.getSsoUrl();
+      if (tab) tab.location.replace(url);
+      else window.location.assign(url); // popup blocked — go in this tab
+      setState("idle");
+    } catch {
+      tab?.close();
+      setState("error");
+    }
+  };
+
+  return (
+    <PageContainer>
+      <PageHeader title="Chat" subtitle="Internal messaging for EDR staff" />
+      <Card withBorder radius="md" p="xl">
+        <Center>
+          <Stack align="center" gap="md" py="xl">
+            {state === "error" && (
+              <Alert
+                icon={<TriangleAlert size={18} />}
+                color="red"
+                title="Couldn't get a sign-in link"
+                variant="light"
+              >
+                Something went wrong reaching chat. Try again.
+              </Alert>
+            )}
+
+            <Stack align="center" gap="sm">
+              <MessageSquare size={40} strokeWidth={1.5} />
+              <Text c="dimmed" ta="center" maw={360}>
+                Opens EDR Chat in a new tab, already signed in as you.
+              </Text>
+              <Button
+                onClick={open}
+                loading={state === "loading"}
+                leftSection={<MessageSquare size={16} />}
+              >
+                Open EDR Chat
+              </Button>
+            </Stack>
+          </Stack>
+        </Center>
+      </Card>
+    </PageContainer>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/contract_templates/ContractTemplatesPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contract_templates/ContractTemplatesPage.tsx
index 30b31f54d..1adcd2e6c 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contract_templates/ContractTemplatesPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contract_templates/ContractTemplatesPage.tsx
@@ -1,11 +1,15 @@
-import { useState } from "react";
+import { useMemo, useState } from "react";
 import { useNavigate } from "react-router-dom";
+import { useQuery } from "@tanstack/react-query";
 import {
   Badge,
   Box,
   Button,
   Card,
   Group,
+  Modal,
+  SegmentedControl,
+  Select,
   SimpleGrid,
   Skeleton,
   Stack,
@@ -19,12 +23,25 @@ import {
   Container,
   Eye,
   FileText,
+  Lock,
   Pencil,
+  Plus,
+  Trash2,
 } from "lucide-react";
 
+import { useAuth } from "@/auth/useAuth";
 import { PageContainer, PageHeader } from "@/components/page";
-import { useContractTemplates } from "@/hooks/contract-templates/useContractTemplates";
-import type { ContractTemplate } from "@/services/contract-templates.service";
+import {
+  useContractTemplates,
+  useCreateContractTemplate,
+  useDeleteContractTemplate,
+} from "@/hooks/contract-templates/useContractTemplates";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { cargoTypesService } from "@/services/cargo-types.service";
+import type {
+  BulkTemplateDirection,
+  ContractTemplate,
+} from "@/services/contract-templates.service";
 import TemplatePreviewModal from "./TemplatePreviewModal";
 
 const DIRECTION_LABEL: Record<string, string> = {
@@ -39,25 +56,29 @@ const DIRECTION_DOT: Record<string, string> = {
   INTERCITY: "var(--mantine-color-orange-5)",
 };
 
-function templateDirection(code: ContractTemplate["code"]): string {
-  return code.split("_")[0];
+function isBulk(template: ContractTemplate): boolean {
+  return Boolean(template.cargoTypeId);
 }
 
-// Codes are DIRECTION_FREIGHT_{CUSTOMS,NO_CUSTOMS}, so the freight segment is
-// the second one — never the suffix.
-function isBulk(code: ContractTemplate["code"]): boolean {
-  return code.split("_")[1] === "BULK";
-}
-
-// Intercity is domestic and crosses no border, so it has no customs variant at
-// all — hence null rather than false, which would wrongly read as a deliberate
-// "client clears its own customs" choice.
-function customsVariant(code: ContractTemplate["code"]): boolean | null {
-  if (code.endsWith("_NO_CUSTOMS")) return false;
-  if (code.endsWith("_CUSTOMS")) return true;
+// System container codes are DIRECTION_CONTAINER(_CUSTOMS); intercity is
+// domestic and crosses no border, so it has no customs variant at all — hence
+// null rather than false, which would wrongly read as a deliberate "client
+// clears its own customs" choice.
+function customsVariant(template: ContractTemplate): boolean | null {
+  if (isBulk(template)) return template.withCustoms ?? null;
+  if (template.code.endsWith("_NO_CUSTOMS")) return false;
+  if (template.code.endsWith("_CUSTOMS")) return true;
   return null;
 }
 
+// Bulk templates carry the direction on the row; the fixed container codes
+// carry it as the code prefix.
+function directionOf(template: ContractTemplate): string {
+  return isBulk(template)
+    ? template.tradeDirection ?? "INTERCITY"
+    : template.code.split("_")[0];
+}
+
 function formatUpdated(value: string): string {
   return new Date(value).toLocaleDateString("en-GB", {
     day: "numeric",
@@ -66,10 +87,28 @@ function formatUpdated(value: string): string {
   });
 }
 
+interface CargoTypeOption {
+  id: string;
+  cargoTypeName?: string;
+  hasContractTemplate?: boolean;
+}
+
 export default function ContractTemplatesPage() {
   const navigate = useNavigate();
+  const { user } = useAuth();
   const { data: templates, isLoading } = useContractTemplates();
   const [previewCode, setPreviewCode] = useState<string | null>(null);
+  const [createOpen, setCreateOpen] = useState(false);
+  const [deleteTarget, setDeleteTarget] = useState<ContractTemplate | null>(null);
+
+  const perms = FREIGHT_PERMS.settings.contractTemplates;
+  const isAdmin = hasPermission(user, FREIGHT_PERMS.admin);
+  const canManage = isAdmin || hasPermission(user, perms.manage);
+  const canCreate = canManage || hasPermission(user, perms.create);
+  const canUpdate = canManage || hasPermission(user, perms.update);
+  const canDelete = isAdmin || hasPermission(user, perms.delete);
+
+  const deleteTemplate = useDeleteContractTemplate();
 
   const previewTemplate = templates?.find((t) => t.code === previewCode);
 
@@ -77,20 +116,34 @@ export default function ContractTemplatesPage() {
     <PageContainer>
       <PageHeader
         title="Contract templates"
-        subtitle="The ten contract documents generated when a contract is approved — one per trade direction, freight type, and customs-clearing option. Intercity is domestic, so it has no customs variant. Articles are fully editable."
+        subtitle="The five container contract documents are built in — one per trade direction and customs-clearing option. Bulk contracts are written per cargo type: create one template per trade direction, customs option and commodity. Articles are fully editable."
+        action={
+          canCreate ? (
+            <Button
+              color="edr-green"
+              leftSection={<Plus size={16} />}
+              onClick={() => setCreateOpen(true)}
+            >
+              New bulk template
+            </Button>
+          ) : undefined
+        }
       />
 
       <SimpleGrid cols={{ base: 1, md: 2, xl: 3 }} spacing="lg">
         {isLoading
-          ? Array.from({ length: 10 }, (_, i) => <TemplateCardSkeleton key={i} />)
+          ? Array.from({ length: 6 }, (_, i) => <TemplateCardSkeleton key={i} />)
           : (templates ?? []).map((template) => (
               <TemplateCard
                 key={template.code}
                 template={template}
+                canUpdate={canUpdate}
+                canDelete={canDelete}
                 onPreview={() => setPreviewCode(template.code)}
                 onEdit={() =>
                   navigate(`/dashboard/contract-templates/${template.code}`)
                 }
+                onDelete={() => setDeleteTarget(template)}
               />
             ))}
       </SimpleGrid>
@@ -100,22 +153,210 @@ export default function ContractTemplatesPage() {
         title={previewTemplate ? `${previewTemplate.name} — preview` : undefined}
         onClose={() => setPreviewCode(null)}
       />
+
+      <CreateTemplateModal
+        opened={createOpen}
+        onClose={() => setCreateOpen(false)}
+        onCreated={(code) => {
+          setCreateOpen(false);
+          navigate(`/dashboard/contract-templates/${code}`);
+        }}
+      />
+
+      {/* ── Delete confirm ─────────────────────────────────────── */}
+      <Modal
+        opened={Boolean(deleteTarget)}
+        onClose={() => setDeleteTarget(null)}
+        title="Delete contract template?"
+        centered
+        size="sm"
+      >
+        <Stack gap="md">
+          <Text size="sm">
+            This will delete{" "}
+            <Text span fw={600}>
+              {deleteTarget?.name}
+            </Text>{" "}
+            and its articles. Contracts already generated keep their frozen
+            document; new contracts for this combination fall back to the
+            generic layout until a new template is created.
+          </Text>
+          <Group justify="flex-end" gap="sm">
+            <Button variant="default" onClick={() => setDeleteTarget(null)}>
+              Cancel
+            </Button>
+            <Button
+              color="red"
+              loading={deleteTemplate.isPending}
+              onClick={() => {
+                if (!deleteTarget) return;
+                deleteTemplate.mutate(deleteTarget.code, {
+                  onSuccess: () => setDeleteTarget(null),
+                });
+              }}
+            >
+              Delete
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
     </PageContainer>
   );
 }
 
+/**
+ * Staff pick the trade direction, then the customs option, then a bulk cargo
+ * type that has "has contract template" enabled. One template per
+ * (direction, customs, cargo type) combination — the API rejects duplicates,
+ * so an existing combination must be edited instead.
+ *
+ * Intercity is domestic and crosses no border, so the customs choice does not
+ * apply there and is hidden.
+ */
+function CreateTemplateModal({
+  opened,
+  onClose,
+  onCreated,
+}: {
+  opened: boolean;
+  onClose: () => void;
+  onCreated: (code: string) => void;
+}) {
+  const [direction, setDirection] = useState<BulkTemplateDirection>("IMPORT");
+  const [withCustoms, setWithCustoms] = useState<string>("true");
+  const [cargoTypeId, setCargoTypeId] = useState<string | null>(null);
+  const create = useCreateContractTemplate();
+  const intercity = direction === "INTERCITY";
+
+  const { data: cargoTypes, isLoading } = useQuery({
+    queryKey: ["cargo-types", "contract-template-options"],
+    queryFn: () => cargoTypesService.getCargoTypes(),
+    enabled: opened,
+  });
+
+  const options = useMemo(
+    () =>
+      ((cargoTypes ?? []) as CargoTypeOption[])
+        .filter((cargoType) => cargoType.hasContractTemplate)
+        .map((cargoType) => ({
+          value: cargoType.id,
+          label: cargoType.cargoTypeName ?? "Untitled",
+        })),
+    [cargoTypes],
+  );
+
+  const close = () => {
+    setCargoTypeId(null);
+    onClose();
+  };
+
+  return (
+    <Modal opened={opened} onClose={close} title="New bulk contract template" centered>
+      <Stack gap="md">
+        <div>
+          <Text size="sm" fw={500} mb={6}>
+            Trade direction
+          </Text>
+          <SegmentedControl
+            fullWidth
+            value={direction}
+            onChange={(value) => setDirection(value as BulkTemplateDirection)}
+            data={[
+              { value: "IMPORT", label: "Import" },
+              { value: "EXPORT", label: "Export" },
+              { value: "INTERCITY", label: "Intercity" },
+            ]}
+          />
+        </div>
+
+        {intercity ? (
+          <Text size="xs" c="dimmed">
+            Intercity contracts are domestic and cross no border, so they have
+            no customs clearing variant — one template per cargo type.
+          </Text>
+        ) : (
+          <div>
+            <Text size="sm" fw={500} mb={6}>
+              Customs clearing
+            </Text>
+            <SegmentedControl
+              fullWidth
+              value={withCustoms}
+              onChange={setWithCustoms}
+              data={[
+                { value: "true", label: "With customs clearing" },
+                { value: "false", label: "Without customs clearing" },
+              ]}
+            />
+          </div>
+        )}
+
+        <Select
+          label="Bulk cargo type"
+          description="Only cargo types with “has contract template” enabled are listed"
+          placeholder={isLoading ? "Loading…" : "Select a cargo type"}
+          data={options}
+          value={cargoTypeId}
+          onChange={setCargoTypeId}
+          searchable
+          nothingFoundMessage="No cargo type allows contract templates yet — enable the flag on the cargo type first"
+        />
+
+        <Group justify="flex-end" gap="sm">
+          <Button variant="default" onClick={close}>
+            Cancel
+          </Button>
+          <Button
+            color="edr-green"
+            disabled={!cargoTypeId}
+            loading={create.isPending}
+            onClick={() => {
+              if (!cargoTypeId) return;
+              create.mutate(
+                {
+                  cargoTypeId,
+                  tradeDirection: direction,
+                  // Omitted for intercity — the API rejects the flag there.
+                  ...(intercity ? {} : { withCustoms: withCustoms === "true" }),
+                },
+                {
+                  onSuccess: (template) =>
+                    onCreated((template as ContractTemplate).code),
+                },
+              );
+            }}
+          >
+            Create template
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
+
 function TemplateCard({
   template,
+  canUpdate,
+  canDelete,
   onPreview,
   onEdit,
+  onDelete,
 }: {
   template: ContractTemplate;
+  canUpdate: boolean;
+  canDelete: boolean;
   onPreview: () => void;
   onEdit: () => void;
+  onDelete: () => void;
 }) {
-  const direction = templateDirection(template.code);
-  const bulk = isBulk(template.code);
-  const customs = customsVariant(template.code);
+  const bulk = isBulk(template);
+  const direction = directionOf(template);
+  const customs = customsVariant(template);
+  const kicker = bulk
+    ? `${template.cargoType?.cargoTypeName ?? "Bulk cargo"} · ${
+        DIRECTION_LABEL[direction] ?? direction
+      } · Bulk`
+    : `${DIRECTION_LABEL[direction] ?? direction} · Container`;
 
   return (
     <Card
@@ -142,12 +383,12 @@ function TemplateCard({
                 style={{
                   borderRadius: 999,
                   flexShrink: 0,
-                  background: DIRECTION_DOT[direction] ?? "var(--mantine-color-gray-5)",
+                  background:
+                    DIRECTION_DOT[direction] ?? "var(--mantine-color-gray-5)",
                 }}
               />
               <Text size="xs" fw={600} tt="uppercase" lts="0.06em" c="dimmed">
-                {DIRECTION_LABEL[direction] ?? direction} ·{" "}
-                {bulk ? "Bulk" : "Container"}
+                {kicker}
               </Text>
             </Group>
           </Group>
@@ -166,6 +407,18 @@ function TemplateCard({
                 </Badge>
               </Tooltip>
             )}
+            {template.isSystem && (
+              <Tooltip label="Built-in template — cannot be deleted" withArrow>
+                <Badge
+                  size="sm"
+                  variant="light"
+                  color="gray"
+                  leftSection={<Lock size={11} />}
+                >
+                  System
+                </Badge>
+              </Tooltip>
+            )}
             {!template.isActive && (
               <Tooltip label="Not used for new contracts" withArrow>
                 <Badge size="sm" variant="light" color="red">
@@ -221,16 +474,34 @@ function TemplateCard({
           >
             Preview
           </Button>
-          <Button
-            variant="light"
-            color="edr-green"
-            size="compact-sm"
-            radius="md"
-            leftSection={<Pencil size={14} />}
-            onClick={onEdit}
-          >
-            Edit articles
-          </Button>
+          <Group gap={6} wrap="nowrap">
+            {canDelete && !template.isSystem && (
+              <Tooltip label="Delete template" withArrow>
+                <Button
+                  variant="subtle"
+                  color="red"
+                  size="compact-sm"
+                  radius="md"
+                  px={8}
+                  onClick={onDelete}
+                >
+                  <Trash2 size={14} />
+                </Button>
+              </Tooltip>
+            )}
+            {canUpdate && (
+              <Button
+                variant="light"
+                color="edr-green"
+                size="compact-sm"
+                radius="md"
+                leftSection={<Pencil size={14} />}
+                onClick={onEdit}
+              >
+                Edit articles
+              </Button>
+            )}
+          </Group>
         </Group>
       </Box>
     </Card>
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ClearanceDocumentsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ClearanceDocumentsPage.tsx
index ca4ed18ce..9cbc0e5e0 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ClearanceDocumentsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ClearanceDocumentsPage.tsx
@@ -3,33 +3,28 @@ import {
   ActionIcon,
   Box,
   Card,
-  Group,
-  Select,
   Stack,
   Text,
-  TextInput,
   ThemeIcon,
 } from "@mantine/core";
-import { DateInput } from "@mantine/dates";
-import { useDebouncedValue } from "@mantine/hooks";
 import { keepPreviousData, useQuery } from "@tanstack/react-query";
-import { FileText, Inbox, RefreshCw, Search, User, X } from "lucide-react";
-import { useCallback, useMemo, useState } from "react";
+import { FileText, Inbox, RefreshCw, Ship, User } from "lucide-react";
+import { useMemo } from "react";
 import { useNavigate } from "react-router-dom";
 
 import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
 import { ContractReferenceLink } from "@/components/bookings/ContractReferenceLink";
 import { bookingTable } from "@/components/bookings/booking-ui.styles";
 import { PageContainer, PageHeader } from "@/components/page";
-import { bookingsService } from "@/services/bookings.service";
+import { bookingsService, type BookingListFilter } from "@/services/bookings.service";
 import type { BookingDetail } from "@/types/booking";
 import {
   Badge,
   DataTable,
   DataTableFooter,
-  usePagination,
   type ColumnDef,
 } from "@edr/ui-common";
+import { dateRangeParams, FilterBar, useFilters, type FilterDef } from "@/components/filters";
 
 /**
  * Operations "Clearance Documents" hub — the worklist for self-clearance
@@ -42,16 +37,14 @@ import {
 const PAGE_SIZE = 10;
 
 /**
- * Status filter options (values = `statuses` param). FULLY_EXECUTED is the
- * post-approval status of intercity (domestic) bookings — kept in the list as
- * history, otherwise an approved intercity row vanishes from the hub.
+ * The hub's baseline scope — FULLY_EXECUTED is the post-approval status of
+ * intercity (domestic) bookings, kept in as history so an approved intercity
+ * row doesn't just vanish. Sent whenever the Status pill has no narrower pick.
  */
-const BOOKING_STATUS_OPTIONS = [
-  {
-    value:
-      "AWAITING_DOCUMENTS,DOCUMENTS_UNDER_REVIEW,CLEARANCE_READY,FULLY_EXECUTED",
-    label: "All statuses",
-  },
+const DEFAULT_STATUSES =
+  "AWAITING_DOCUMENTS,DOCUMENTS_UNDER_REVIEW,CLEARANCE_READY,FULLY_EXECUTED";
+
+const STATUS_OPTIONS = [
   { value: "AWAITING_DOCUMENTS", label: "Awaiting documents" },
   { value: "DOCUMENTS_UNDER_REVIEW", label: "Under review" },
   { value: "CLEARANCE_READY", label: "Clearance ready" },
@@ -74,72 +67,65 @@ const OWNERSHIP_OPTIONS = [
   { value: "false", label: "Private" },
 ];
 
-function startOfDayIso(d: Date): string {
-  const x = new Date(d);
-  x.setHours(0, 0, 0, 0);
-  return x.toISOString();
-}
-
-function endOfDayIso(d: Date): string {
-  const x = new Date(d);
-  x.setHours(23, 59, 59, 999);
-  return x.toISOString();
-}
+/** Who booked: shipping lines own bookings via `shippingLineCompanyId`, not a customer company. */
+const CUSTOMER_KIND_OPTIONS = [
+  { value: "SHIPPING_LINE", label: "Shipping line" },
+  { value: "CUSTOMER", label: "Customer" },
+];
 
 export default function ClearanceDocumentsPage() {
   const navigate = useNavigate();
-  const [query, setQuery] = useState("");
-  const [debouncedQuery] = useDebouncedValue(query, 300);
-  const [bookingStatuses, setBookingStatuses] = useState(
-    BOOKING_STATUS_OPTIONS[0].value,
-  );
   const { filterOptions } = useMyTradeAccess();
-  const [directionFilter, setDirectionFilter] = useState<string | null>(null);
-  const [freightTypeFilter, setFreightTypeFilter] = useState<string | null>(null);
-  const [ownershipFilter, setOwnershipFilter] = useState<string | null>(null);
-  const [createdFrom, setCreatedFrom] = useState<Date | null>(null);
-  const [createdTo, setCreatedTo] = useState<Date | null>(null);
-  const { pagination, setPagination } = usePagination({ pageSize: PAGE_SIZE });
 
-  const search = debouncedQuery.trim() || undefined;
+  const filterDefs: FilterDef[] = useMemo(
+    () => [
+      {
+        key: "status",
+        label: "Status",
+        type: "enum",
+        multiple: false,
+        options: STATUS_OPTIONS,
+        // No pick ⇒ no `statuses` param at all; the query fills in
+        // DEFAULT_STATUSES itself, same as the old Select's "All statuses" row.
+        toParams: ({ v }) => ({ statuses: v[0] }),
+      },
+      {
+        key: "tradeDirection",
+        label: "Direction",
+        type: "enum",
+        multiple: false,
+        options: filterOptions(TRADE_DIRECTION_OPTIONS),
+      },
+      { key: "freightType", label: "Freight", type: "enum", multiple: false, options: FREIGHT_TYPE_OPTIONS },
+      { key: "customerKind", label: "Booked by", type: "enum", multiple: false, options: CUSTOMER_KIND_OPTIONS },
+      { key: "isGovernment", label: "Ownership", type: "enum", multiple: false, options: OWNERSHIP_OPTIONS },
+      {
+        key: "created",
+        label: "Created",
+        type: "date",
+        toParams: dateRangeParams("createdFrom", "createdTo"),
+      },
+    ],
+    [filterOptions],
+  );
 
-  const resetPage = useCallback(() => {
-    setPagination({ pageIndex: 0, pageSize: PAGE_SIZE });
-  }, [setPagination]);
+  const controls = useFilters(filterDefs, { pageSize: PAGE_SIZE });
 
-  const page = pagination.pageIndex + 1;
+  const filter: BookingListFilter = useMemo(
+    () => ({
+      ...(controls.params as unknown as BookingListFilter),
+      // Self-clearance instances carry bookingType=ONE_TIME whatever their
+      // contract kind, so customsClearingEnabled=false + the status scope
+      // above are what isolate exactly this worklist.
+      customsClearingEnabled: "false",
+      statuses: (controls.params.statuses as string | undefined) ?? DEFAULT_STATUSES,
+    }),
+    [controls.params],
+  );
 
   const bookingsQuery = useQuery({
-    queryKey: [
-      "clearance-documents",
-      "bookings",
-      bookingStatuses,
-      directionFilter,
-      freightTypeFilter,
-      ownershipFilter,
-      createdFrom,
-      createdTo,
-      page,
-      search,
-    ],
-    queryFn: () =>
-      // Self-clearance instances carry bookingType=ONE_TIME whatever their
-      // contract kind, so customsClearingEnabled=false + the three per-booking
-      // clearance statuses are what isolate exactly this worklist.
-      bookingsService.list({
-        statuses: bookingStatuses,
-        customsClearingEnabled: "false",
-        page,
-        pageSize: PAGE_SIZE,
-        search,
-        ...(directionFilter ? { tradeDirection: directionFilter } : {}),
-        ...(freightTypeFilter ? { freightType: freightTypeFilter } : {}),
-        ...(ownershipFilter
-          ? { isGovernment: ownershipFilter as "true" | "false" }
-          : {}),
-        ...(createdFrom ? { createdFrom: startOfDayIso(createdFrom) } : {}),
-        ...(createdTo ? { createdTo: endOfDayIso(createdTo) } : {}),
-      }),
+    queryKey: ["clearance-documents", "bookings", filter],
+    queryFn: () => bookingsService.list(filter),
     placeholderData: keepPreviousData,
   });
 
@@ -152,17 +138,29 @@ export default function ClearanceDocumentsPage() {
         header: () => <span className={bookingTable.headerCell}>Customer</span>,
         cell: ({ row }) => {
           const b = row.original;
-          const customer = b.isGovernment
-            ? (b.governmentInstitution ?? "Government")
-            : (b.company?.name ?? "—");
+          const isShippingLine = Boolean(b.shippingLineCompany ?? b.shippingLineCompanyId);
+          const customer = isShippingLine
+            ? (b.shippingLineCompany?.name ?? "Shipping line")
+            : b.isGovernment
+              ? (b.governmentInstitution ?? "Government")
+              : (b.company?.name ?? "—");
           return (
             <div className="flex items-center gap-3 py-1.5">
               <div className={bookingTable.rowIcon}>
-                <User className="size-4" strokeWidth={1.75} />
+                {isShippingLine ? (
+                  <Ship className="size-4" strokeWidth={1.75} />
+                ) : (
+                  <User className="size-4" strokeWidth={1.75} />
+                )}
               </div>
               <div className="min-w-0">
-                <p className="font-medium text-foreground">
+                <p className="flex items-center gap-1.5 font-medium text-foreground">
                   {customer}
+                  {isShippingLine ? (
+                    <Badge variant="secondary" className="h-4 shrink-0 px-1 text-[9px] font-medium">
+                      Shipping line
+                    </Badge>
+                  ) : null}
                 </p>
                 <p className="mt-0.5 flex items-center gap-1 text-xs text-muted-foreground">
                   <FileText className="size-3 shrink-0 opacity-70" />
@@ -232,7 +230,6 @@ export default function ClearanceDocumentsPage() {
   );
 
   const total = bookingsQuery.data?.total ?? 0;
-  const pageCount = Math.max(1, Math.ceil(total / PAGE_SIZE));
   const showEmpty =
     !bookingsQuery.isLoading && !bookingsQuery.isError && bookingRows.length === 0;
   const tableStatus = bookingsQuery.isLoading
@@ -264,117 +261,12 @@ export default function ClearanceDocumentsPage() {
         <Card p={0}>
           <Stack gap={0}>
             <Box px="md" pt="md" pb="sm" w="100%">
-              <Group justify="space-between" gap="md" wrap="wrap">
-                <TextInput
-                  placeholder="Search booking, contract or customer…"
-                  leftSection={<Search size={18} />}
-                  value={query}
-                  onChange={(e) => {
-                    setQuery(e.target.value);
-                    resetPage();
-                  }}
-                  rightSection={
-                    query && (
-                      <ActionIcon
-                        size="sm"
-                        color="gray"
-                        radius="md"
-                        variant="transparent"
-                        onClick={() => {
-                          setQuery("");
-                          resetPage();
-                        }}
-                      >
-                        <X size={16} />
-                      </ActionIcon>
-                    )
-                  }
-                  style={{ flex: 1, minWidth: "200px" }}
-                  radius="lg"
-                />
-                <Select
-                  data={BOOKING_STATUS_OPTIONS}
-                  value={bookingStatuses}
-                  onChange={(v) => {
-                    setBookingStatuses(v ?? BOOKING_STATUS_OPTIONS[0].value);
-                    resetPage();
-                  }}
-                  allowDeselect={false}
-                  radius="lg"
-                  w={220}
-                  aria-label="Filter by status"
-                />
-                <Text size="sm" c="dimmed">
-                  {total} record{total !== 1 ? "s" : ""}
-                </Text>
-              </Group>
-              <Group gap="sm" mt="sm" wrap="wrap">
-                <Select
-                  placeholder="Direction"
-                  data={filterOptions(TRADE_DIRECTION_OPTIONS)}
-                  value={directionFilter}
-                  onChange={(v) => {
-                    setDirectionFilter(v);
-                    resetPage();
-                  }}
-                  clearable
-                  radius="lg"
-                  style={{ minWidth: 130 }}
-                  aria-label="Filter by direction"
-                />
-                <Select
-                  placeholder="Freight type"
-                  data={FREIGHT_TYPE_OPTIONS}
-                  value={freightTypeFilter}
-                  onChange={(v) => {
-                    setFreightTypeFilter(v);
-                    resetPage();
-                  }}
-                  clearable
-                  radius="lg"
-                  style={{ minWidth: 140 }}
-                  aria-label="Filter by freight type"
-                />
-                <Select
-                  placeholder="Gov / Private"
-                  data={OWNERSHIP_OPTIONS}
-                  value={ownershipFilter}
-                  onChange={(v) => {
-                    setOwnershipFilter(v);
-                    resetPage();
-                  }}
-                  clearable
-                  radius="lg"
-                  style={{ minWidth: 140 }}
-                  aria-label="Filter by ownership"
-                />
-                <DateInput
-                  placeholder="Created from"
-                  value={createdFrom}
-                  onChange={(v) => {
-                    setCreatedFrom(v ? new Date(v) : null);
-                    resetPage();
-                  }}
-                  maxDate={createdTo ?? undefined}
-                  clearable
-                  radius="lg"
-                  style={{ minWidth: 140 }}
-                  aria-label="Created from"
-                />
-                <DateInput
-                  placeholder="Created to"
-                  value={createdTo}
-                  onChange={(v) => {
-                    setCreatedTo(v ? new Date(v) : null);
-                    resetPage();
-                  }}
-                  minDate={createdFrom ?? undefined}
-                  clearable
-                  radius="lg"
-                  style={{ minWidth: 140 }}
-                  aria-label="Created to"
-                />
-              </Group>
+              <FilterBar
+                defs={filterDefs}
+                controls={controls}
+                searchPlaceholder="Search booking, contract, customer or shipping line…"
+                viewId="clearance-documents"
+              />
             </Box>
 
             {showEmpty ? (
@@ -397,18 +289,7 @@ export default function ClearanceDocumentsPage() {
                       state: { from: "/dashboard/contracts/clearance-documents" },
                     })
                   }
-                  pagination={{
-                    pageIndex: pagination.pageIndex,
-                    pageSize: pagination.pageSize,
-                    pageCount,
-                    totalCount: total,
-                  }}
-                  tableOptions={{
-                    state: { pagination },
-                    onPaginationChange: setPagination,
-                    manualPagination: true,
-                    pageCount,
-                  }}
+                  {...controls.tableProps(total)}
                   containerClassName="border-0 shadow-none bg-transparent [&_th]:max-w-[100px] [&_td]:max-w-[100px] [&_td]:break-words"
                   footer={DataTableFooter}
                 />
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceDetailPage.tsx
index b49eb419c..dacae6cea 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceDetailPage.tsx
@@ -10,12 +10,9 @@ import {
   Grid,
   Group,
   Loader,
-  Paper,
-  Progress,
   RingProgress,
   Stack,
   Text,
-  ThemeIcon,
 } from "@mantine/core";
 import {
   AlertCircle,
@@ -37,9 +34,11 @@ import {
 
 import { BookingChangesRequestedAlert } from "@/components/contracts/BookingChangesRequestedAlert";
 import { ClearanceOpsTabs } from "@/components/contracts/ClearanceOpsTabs";
-import { PageContainer } from "@/components/page/PageContainer";
-import { PageHeader } from "@/components/page/PageHeader";
+import { PageContainer, PageHeader, KpiStrip } from "@/components/page";
+import type { KpiItem } from "@/components/page";
+import { EntityLink } from "@/components/detail";
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
+import { RequestCustomerCard } from "@/components/contracts/detail/RequestDetailCards";
 import { ContractClearanceReviewSection } from "@/components/contracts/ContractClearanceReviewSection";
 import { GlUpcomingWindowsSection } from "@/components/contracts/GlUpcomingWindowsSection";
 import { PhasedClearanceActionPanel } from "@/components/contracts/PhasedClearanceActionPanel";
@@ -196,6 +195,29 @@ export default function ContractClearanceDetailPage() {
 
   const workflowFiles = clearance.workflowFiles ?? [];
 
+  const direction = contract?.tradeDirection ?? "—";
+  const customs =
+    contract?.serviceType?.includesCustoms ??
+    contract?.customsClearingEnabled ??
+    false;
+  const routes = [...(contract?.routes ?? [])].sort(
+    (a, b) => a.sortOrder - b.sortOrder,
+  );
+  const origin =
+    routes[0]?.originYard?.label ?? routes[0]?.originYard?.code ?? "Origin";
+  const lastRoute = routes[routes.length - 1] ?? routes[0];
+  const destination =
+    lastRoute?.destinationYard?.label ??
+    lastRoute?.destinationYard?.code ??
+    "Destination";
+
+  const kpis: KpiItem[] = [
+    { label: "Approved", value: stats.approved, icon: CheckCircle2, color: "edr-green" },
+    { label: "Queried", value: stats.queried, icon: AlertCircle, color: "red" },
+    { label: "Pending", value: stats.pending, icon: Clock, color: "gray" },
+    { label: "Review progress", value: `${stats.pct}%`, icon: PackageCheck, color: "blue" },
+  ];
+
   return (
     <PageContainer>
       <Stack gap="lg">
@@ -206,57 +228,81 @@ export default function ContractClearanceDetailPage() {
             { label: hubLabel, href: hubHref },
             { label: reference },
           ]}
+          subtitle={
+            <Group gap={8} wrap="nowrap">
+              {id ? (
+                <EntityLink to={`/dashboard/contract-requests/${id}`} label="Contract details" />
+              ) : null}
+              <Text size="sm" c="dimmed">
+                · {origin}
+              </Text>
+              <ArrowRight size={14} className="shrink-0 text-muted-foreground" />
+              <Text size="sm" c="dimmed">
+                {destination}
+              </Text>
+            </Group>
+          }
           meta={
-            bookingExpired ? (
-              <Badge
-                variant="light"
-                color="orange"
-                radius="sm"
-                leftSection={<RefreshCw size={13} />}
-              >
-                Payment expired — rebook
+            <Group gap={6} wrap="wrap">
+              <Badge variant="light" color={direction === "IMPORT" ? "edr-green" : "gray"} radius="sm">
+                {directionLabel(direction)}
               </Badge>
-            ) : bookingAlreadyCreated ? (
-              <Badge
-                variant="light"
-                color="blue"
-                radius="sm"
-                leftSection={<PackageCheck size={13} />}
-              >
-                Booking created
-              </Badge>
-            ) : ready ? (
-              <Badge
-                variant="light"
-                color="edr-green"
-                radius="sm"
-                leftSection={<PackageCheck size={13} />}
-              >
-                Ready — create booking
-              </Badge>
-            ) : clearance.allApproved ? (
-              <Badge
-                variant="light"
-                color="edr-green"
-                radius="sm"
-                leftSection={<CheckCircle2 size={13} />}
-              >
-                All approved
-              </Badge>
-            ) : (
-              <Badge
-                variant="light"
-                color="gray"
-                radius="sm"
-                leftSection={<Clock size={13} />}
-              >
-                Review pending
-              </Badge>
-            )
+              {customs ? (
+                <Badge variant="light" color="edr-green" radius="sm" leftSection={<ShieldCheck size={12} />}>
+                  Customs
+                </Badge>
+              ) : null}
+              {bookingExpired ? (
+                <Badge
+                  variant="light"
+                  color="orange"
+                  radius="sm"
+                  leftSection={<RefreshCw size={13} />}
+                >
+                  Payment expired — rebook
+                </Badge>
+              ) : bookingAlreadyCreated ? (
+                <Badge
+                  variant="light"
+                  color="blue"
+                  radius="sm"
+                  leftSection={<PackageCheck size={13} />}
+                >
+                  Booking created
+                </Badge>
+              ) : ready ? (
+                <Badge
+                  variant="light"
+                  color="edr-green"
+                  radius="sm"
+                  leftSection={<PackageCheck size={13} />}
+                >
+                  Ready — create booking
+                </Badge>
+              ) : clearance.allApproved ? (
+                <Badge
+                  variant="light"
+                  color="edr-green"
+                  radius="sm"
+                  leftSection={<CheckCircle2 size={13} />}
+                >
+                  All approved
+                </Badge>
+              ) : (
+                <Badge
+                  variant="light"
+                  color="gray"
+                  radius="sm"
+                  leftSection={<Clock size={13} />}
+                >
+                  Review pending
+                </Badge>
+              )}
+            </Group>
           }
         />
 
-        <ClearanceHero contract={contract} stats={stats} />
+        <KpiStrip items={kpis} />
 
         {/* Windows on this contract's routes/direction only — tells GL ET when
             it can actually create the booking without checking the schedule board. */}
@@ -383,6 +429,7 @@ export default function ContractClearanceDetailPage() {
 
               <Grid.Col span={{ base: 12, lg: 5 }}>
                 <Stack gap="md">
+                  <RequestCustomerCard contract={contract} />
                   {phasedCustoms ? (
                     <PhasedClearanceActionPanel
                       contractId={id!}
@@ -425,23 +472,6 @@ export default function ContractClearanceDetailPage() {
                               </Stack>
                             }
                           />
-                          <Group gap="lg" justify="center">
-                            <ProgressStat
-                              color="edr-green"
-                              label="Approved"
-                              value={stats.approved}
-                            />
-                            <ProgressStat
-                              color="red"
-                              label="Queried"
-                              value={stats.queried}
-                            />
-                            <ProgressStat
-                              color="gray"
-                              label="Pending"
-                              value={stats.pending}
-                            />
-                          </Group>
                         </Stack>
                       </SectionCard>
                     </Box>
@@ -457,126 +487,3 @@ export default function ContractClearanceDetailPage() {
   );
 }
 
-function ClearanceHero({
-  contract,
-  stats,
-}: {
-  contract: ReturnType<typeof useContractDetail>["data"];
-  stats: { pct: number; approved: number; total: number };
-}) {
-  const direction = contract?.tradeDirection ?? "—";
-  const serviceName = contract?.serviceType?.serviceName ?? null;
-  const customs =
-    contract?.serviceType?.includesCustoms ??
-    contract?.customsClearingEnabled ??
-    false;
-  const routes = [...(contract?.routes ?? [])].sort(
-    (a, b) => a.sortOrder - b.sortOrder,
-  );
-  const origin =
-    routes[0]?.originYard?.label ?? routes[0]?.originYard?.code ?? "Origin";
-  const last = routes[routes.length - 1] ?? routes[0];
-  const destination =
-    last?.destinationYard?.label ??
-    last?.destinationYard?.code ??
-    "Destination";
-
-  return (
-    <Paper withBorder radius="md" p="lg">
-      <Group justify="space-between" align="flex-start" wrap="wrap" gap="lg">
-        <Group gap="md" wrap="nowrap" style={{ minWidth: 0 }}>
-          <ThemeIcon variant="light" color="edr-green" radius="md" size={52}>
-            <ShieldCheck size={26} />
-          </ThemeIcon>
-          <Box style={{ minWidth: 0 }}>
-            <Group gap={8} wrap="nowrap">
-              <Text fw={800} fz={20} c="edr-text" truncate>
-                {contract?.reference ?? "Clearance"}
-              </Text>
-              <Badge
-                size="sm"
-                variant="light"
-                color={direction === "IMPORT" ? "edr-green" : "gray"}
-                radius="sm"
-              >
-                {directionLabel(direction)}
-              </Badge>
-              {customs ? (
-                <Badge
-                  size="sm"
-                  variant="light"
-                  color="edr-green"
-                  radius="sm"
-                  leftSection={<ShieldCheck size={12} />}
-                >
-                  Customs
-                </Badge>
-              ) : (
-                <Badge size="sm" variant="light" color="gray" radius="sm">
-                  No customs
-                </Badge>
-              )}
-            </Group>
-            {serviceName && (
-              <Text size="sm" fw={600} c="edr-text" mt={6} truncate maw={280}>
-                {serviceName}
-              </Text>
-            )}
-            <Group gap={8} mt={6} wrap="nowrap">
-              <Text size="sm" fw={600} truncate maw={160}>
-                {origin}
-              </Text>
-              <ArrowRight size={15} className="shrink-0 text-muted-foreground" />
-              <Text size="sm" fw={600} truncate maw={160}>
-                {destination}
-              </Text>
-            </Group>
-          </Box>
-        </Group>
-
-        <Box style={{ minWidth: 200, flex: 1, maxWidth: 320 }}>
-          <Group justify="space-between" mb={6}>
-            <Text size="xs" c="dimmed" fw={600}>
-              Document review
-            </Text>
-            <Text size="xs" c="dimmed">
-              {stats.approved}/{stats.total}
-            </Text>
-          </Group>
-          <Progress value={stats.pct} color="edr-green" radius="xl" size="md" />
-        </Box>
-      </Group>
-    </Paper>
-  );
-}
-
-function ProgressStat({
-  color,
-  label,
-  value,
-}: {
-  color: string;
-  label: string;
-  value: number;
-}) {
-  return (
-    <Stack gap={2} align="center">
-      <Text fw={700} fz={18} c="edr-text">
-        {value}
-      </Text>
-      <Group gap={4} wrap="nowrap">
-        <Box
-          style={{
-            width: 7,
-            height: 7,
-            borderRadius: 999,
-            background: `var(--mantine-color-${color}-6)`,
-          }}
-        />
-        <Text fz="11px" c="dimmed">
-          {label}
-        </Text>
-      </Group>
-    </Stack>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceListPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceListPage.tsx
index 8719f644a..392c028aa 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceListPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractClearanceListPage.tsx
@@ -52,6 +52,47 @@ import {
   summarizeRequestedCargo,
 } from "@/features/clearance/requestedCargo";
 import { contractsService } from "@/services/contracts.service";
+import "./contract-clearance-table.css";
+
+/** Yards carry `label` (API) — older shapes used `name`/`code`. */
+function yardLabel(
+  yard?: { label?: string; code?: string; name?: string } | null,
+): string {
+  if (!yard) return "—";
+  return yard.label ?? yard.name ?? yard.code ?? "—";
+}
+
+/**
+ * "Origin → Destination", wrapping past 120px as "Addis Ababa" /
+ * "→ Djibouti": the arrow is glued to the destination with an nbsp, and
+ * text wraps normally (the table's cells are otherwise nowrap) so a long
+ * lane never spills into the next column.
+ */
+function RouteLabel({
+  origin,
+  destination,
+}: {
+  origin: string;
+  destination: string;
+}) {
+  return (
+    <Text
+      size="sm"
+      maw={120}
+      lh={1.35}
+      style={{ whiteSpace: "normal", overflowWrap: "anywhere" }}
+    >
+      {origin}{" "}
+      <ArrowRight
+        size={13}
+        className="text-muted-foreground"
+        style={{ display: "inline-block", verticalAlign: "-2px" }}
+      />
+      {"\u00A0"}
+      {destination}
+    </Text>
+  );
+}
 
 function CustomsBadge({ customs }: { customs: boolean }) {
   return customs ? (
@@ -118,11 +159,13 @@ export default function ContractClearanceListPage() {
       id: b.id,
       reference: b.reference,
       customerLabel: b.company?.name ?? b.governmentInstitution ?? "—",
-      originLabel: b.originYard?.name ?? "—",
-      destinationLabel: b.destinationYard?.name ?? "—",
+      originLabel: yardLabel(b.originYard),
+      destinationLabel: yardLabel(b.destinationYard),
       tradeDirection: b.tradeDirection ?? "—",
       freightType: b.freightType ?? "—",
       status: b.status,
+      allDocsApproved: Boolean(b.allDocsApproved),
+      hasDocumentsAwaitingReview: Boolean(b.hasDocumentsAwaitingReview),
       requested: requestedByBooking.get(b.id) ?? null,
       contractId: b.contractId ?? null,
       contractReference: b.contractReference ?? null,
@@ -152,8 +195,13 @@ export default function ContractClearanceListPage() {
   const counts = useMemo(
     () => ({
       all: allRows.length,
+      // Counts anything actually waiting on GL, including a document added
+      // after clearance was finalized (the status stays CLEARANCE_READY).
       review: allRows.filter(
-        (r) => r.status === "AWAITING_DOCUMENTS" || r.status === "DOCUMENTS_UNDER_REVIEW",
+        (r) =>
+          r.status === "AWAITING_DOCUMENTS" ||
+          r.status === "DOCUMENTS_UNDER_REVIEW" ||
+          r.hasDocumentsAwaitingReview,
       ).length,
       ready: allRows.filter((r) => r.status === "CLEARANCE_READY" || r.bookingCreated)
         .length,
@@ -303,6 +351,10 @@ interface ShipmentBookingRow {
   tradeDirection: string;
   freightType: string;
   status: string;
+  /** Every required document approved, even before clearance is finalized. */
+  allDocsApproved: boolean;
+  /** A customer document is waiting on GL — including one added post-clearance. */
+  hasDocumentsAwaitingReview: boolean;
   /** Requested quantities from the originating shipment request. */
   requested: Freight.RequestedShipmentLines | null;
   /** Contract this shipment booking was created under. */
@@ -430,11 +482,10 @@ function ShipmentBookingsTable({
         id: "route",
         header: () => <span className={bookingTable.headerCell}>Route</span>,
         cell: ({ row }) => (
-          <Group gap={6} wrap="nowrap">
-            <Text size="sm">{row.original.originLabel}</Text>
-            <ArrowRight size={13} className="shrink-0 text-muted-foreground" />
-            <Text size="sm">{row.original.destinationLabel}</Text>
-          </Group>
+          <RouteLabel
+            origin={row.original.originLabel}
+            destination={row.original.destinationLabel}
+          />
         ),
       },
       {
@@ -478,13 +529,29 @@ function ShipmentBookingsTable({
         header: () => <span className={bookingTable.headerCell}>Status</span>,
         cell: ({ row }) => (
           <Group gap={6} wrap="nowrap">
-            <Badge
-              variant="light"
-              color={shipmentStatusColor(row.original.status)}
-              radius="sm"
-            >
-              {prettyStatus(row.original.status)}
-            </Badge>
+            {/* A document is waiting on GL. This outranks the booking status:
+                a file added after clearance was finalized leaves the status at
+                CLEARANCE_READY, and the row must still call for the review. */}
+            {row.original.hasDocumentsAwaitingReview ? (
+              <Badge variant="filled" color="orange" radius="sm">
+                Needs approval
+              </Badge>
+            ) : /* All docs approved but not yet finalized: the booking status is
+                still DOCUMENTS_UNDER_REVIEW — show the real review state. */
+            row.original.status === "DOCUMENTS_UNDER_REVIEW" &&
+              row.original.allDocsApproved ? (
+              <Badge variant="light" color="edr-green" radius="sm">
+                Documents approved
+              </Badge>
+            ) : (
+              <Badge
+                variant="light"
+                color={shipmentStatusColor(row.original.status)}
+                radius="sm"
+              >
+                {prettyStatus(row.original.status)}
+              </Badge>
+            )}
             {row.original.bookingCreated ? (
               <Tooltip label="Booking created by GL Ethiopia" withArrow>
                 <Badge
@@ -600,13 +667,13 @@ function ShipmentBookingsTable({
   }
 
   return (
-    <Box style={{ overflowX: "auto" }} px="xs" pb="xs">
+    <Box w="100%" miw={0} style={{ overflowX: "auto" }}>
       <DataTable<ShipmentBookingRow, unknown>
         columns={columns}
         data={rows}
         status={loading ? "loading" : error ? "error" : "success"}
         onRowClick={(row) => onOpen(row.id)}
-        containerClassName="border-0 shadow-none bg-transparent [&_th]:max-w-[100px] [&_td]:max-w-[100px] [&_td]:break-words"
+        containerClassName="edr-clearance-table border-0 shadow-none rounded-none bg-transparent"
       />
     </Box>
   );
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestDetailPage.tsx
index 8c0ef7b5c..8238f042e 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestDetailPage.tsx
@@ -1,3 +1,4 @@
+import { formatDate, formatDateTime } from "@/lib/format";
 import { directionLabel } from "@/lib/utils";
 import { useNavigate, useParams, useSearchParams } from "react-router-dom";
 import { useQuery } from "@tanstack/react-query";
@@ -6,9 +7,8 @@ import {
   ArrowLeft,
   ArrowRight,
   Box as BoxIcon,
-  Building2,
-  Calendar,
   CalendarClock,
+  ClipboardList,
   Download,
   FileSignature,
   FileText,
@@ -18,15 +18,16 @@ import {
   Info,
   LayoutGrid,
   Milestone,
+  MoreHorizontal,
   Package,
   Receipt,
   RefreshCw,
   Route as RouteIcon,
-  ShieldCheck,
   Snowflake,
-  Users,
+  Wallet,
 } from "lucide-react";
 import {
+  ActionIcon,
   Alert,
   Badge,
   Box,
@@ -36,21 +37,22 @@ import {
   Grid,
   Group,
   Loader,
+  Menu,
   Paper,
   SimpleGrid,
   Stack,
   Tabs,
   Text,
-  Title,
 } from "@mantine/core";
 
 import toast from "react-hot-toast";
 
-import "@/components/overview/overview.css";
-import { PageContainer } from "@/components/page";
-import Breadcrumbs from "@/components/ui/Breadcrumbs";
+import { PageContainer, PageHeader, KpiStrip } from "@/components/page";
+import type { KpiItem } from "@/components/page";
+import { EntityLink } from "@/components/detail";
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
 import { detailStyles } from "@/components/bookings/detail/booking-detail.styles";
+import { TableCard } from "@/components/customers";
 import {
   ContractCourtBadge,
   ContractStatusBadge,
@@ -60,14 +62,18 @@ import { ContractActionsToolbar } from "@/components/contracts/ContractActionsTo
 import { ContractApprovalStepsCard } from "@/components/contracts/ContractApprovalStepsCard";
 import { HazardDeclarationPanel } from "@/components/contracts/HazardDeclarationPanel";
 import { ClearanceWorkflowFilesPanel } from "@/components/contracts/ClearanceWorkflowFilesPanel";
+import { BookingRequestStatusBadge } from "@/components/contracts/BookingRequestStatusBadge";
 import { ContractRevisionTimeline } from "@/components/contracts/ContractRevisionTimeline";
 import { ContractMilestonesTimeline } from "@/components/contracts/ContractMilestonesTimeline";
 import {
   ContractCustomerCard,
   ContractDocumentsCard,
 } from "@/components/contracts/detail/ContractDetailTabCards";
+import { BookingStatusBadge } from "@/components/bookings/BookingStatusBadge";
 import { getContractStatusMeta } from "@/features/contracts/contract-status.config";
+import { toBookingListRow } from "@/features/bookings/mapBookingListRow";
 import { useFileViewer } from "@/hooks/useFileViewer";
+import { useBookingList } from "@/hooks/bookings/useBookings";
 import {
   useContractDetail,
   useContractMutations,
@@ -75,11 +81,14 @@ import {
 import { contractsService } from "@/services/contracts.service";
 import { api } from "@/services/api";
 import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
+import { formatMoney } from "@/components/customers";
 import {
   downloadBookingFile,
   fetchViewableFile,
 } from "@/services/files.service";
 import type { CustomerDocument } from "@/types/customer";
+import type { BookingDetail } from "@/types/booking";
+import { DataTable, type ColumnDef } from "@edr/ui-common";
 import type { Freight } from "@edr/types";
 
 // Clearance phase — actionable (docs approve / query / finalize on the hub).
@@ -106,33 +115,6 @@ const CLEARANCE_REVIEW_STATUSES = [
   ...CLEARANCE_DONE_STATUSES,
 ];
 
-function formatDate(value: string | null | undefined): string {
-  if (!value) return "—";
-  const d = new Date(value);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      });
-}
-
-/** Same, plus the clock — for values the staff pick to the minute. */
-function formatDateTime(value: string | null | undefined): string {
-  if (!value) return "—";
-  const d = new Date(value);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-        hour: "2-digit",
-        minute: "2-digit",
-      });
-}
-
 export default function ContractRequestDetailPage() {
   const { id } = useParams<{ id: string }>();
   const navigate = useNavigate();
@@ -147,11 +129,11 @@ export default function ContractRequestDetailPage() {
   const [searchParams, setSearchParams] = useSearchParams();
   const { view, viewer } = useFileViewer();
   const requestedTab = searchParams.get("tab");
-  const setTab = (tab: string) =>
+  const setTab = (tab: string | null) =>
     setSearchParams(
       (prev) => {
         const next = new URLSearchParams(prev);
-        if (tab === "details") next.delete("tab");
+        if (!tab || tab === "details") next.delete("tab");
         else next.set("tab", tab);
         return next;
       },
@@ -212,6 +194,18 @@ export default function ContractRequestDetailPage() {
       }) satisfies NonNullable<Freight.IContract["files"]>[number],
   );
 
+  // Bookings drawn down under this contract, and the customer's raw shipment
+  // requests against it — the two halves of "what has this contract produced".
+  const { data: contractBookings, isLoading: bookingsLoading } = useBookingList(
+    { contractId: id, pageSize: 100 },
+    Boolean(id),
+  );
+  const bookingRequestsQuery = useQuery({
+    queryKey: QUERY_KEYS.CONTRACTS.bookingRequests(id ?? ""),
+    queryFn: () => contractsService.listBookingRequests(id!),
+    enabled: Boolean(id),
+  });
+
   const downloadContractPdf = async () => {
     if (!contract?.id) return;
     try {
@@ -313,12 +307,12 @@ export default function ContractRequestDetailPage() {
       contract.status === "SIGNED_CUSTOMER") &&
     Boolean(contract.contractGeneratedAt);
   // Resolve the active tab from the URL, falling back to details when the
-  // requested tab isn't available for this contract (e.g. clearance pre-phase).
+  // requested tab isn't available for this contract.
   const currentTab =
-    requestedTab === "documents"
-      ? "documents"
-      : requestedTab === "customer"
-        ? "customer"
+    requestedTab === "shipments"
+      ? "shipments"
+      : requestedTab === "documents"
+        ? "documents"
         : requestedTab === "history"
           ? "history"
           : "details";
@@ -327,98 +321,111 @@ export default function ContractRequestDetailPage() {
     ? (contract.governmentInstitution ?? "Government")
     : (contract.company?.name ?? "—");
 
+  const kpis: KpiItem[] = [
+    {
+      label: "Shipments",
+      value: contract.activeBookingCount ?? 0,
+      hint: "active",
+      icon: Package,
+      color: "edr-green",
+    },
+    {
+      label: "Valid until",
+      value: contract.contractValidUntil ? formatDate(contract.contractValidUntil) : "—",
+      icon: CalendarClock,
+      color: "blue",
+    },
+    {
+      label: "Routes",
+      value: routes.length,
+      icon: RouteIcon,
+      color: "teal",
+    },
+    {
+      label: "Currency",
+      value: contract.paymentCurrency,
+      icon: Wallet,
+      color: "orange",
+    },
+  ];
+
   return (
     <PageContainer>
-      <Breadcrumbs
-        items={[
+      <PageHeader
+        breadcrumbs={[
           { label: "Contract requests", href: "/dashboard/contract-requests" },
           { label: contract.reference },
         ]}
-      />
-
-      <Stack gap="lg">
-        {/* Hero */}
-        <Paper radius="xl" p="xl" style={{ position: "relative", overflow: "hidden" }}>
-          <Stack gap="lg">
-            <Group justify="space-between" align="flex-start" wrap="wrap">
-              <Button
-                variant="default"
-                size="compact-sm"
-                radius="lg"
-                leftSection={<ArrowLeft size={16} />}
-                onClick={() => navigate("/dashboard/contract-requests")}
-              >
-                Back to list
-              </Button>
-              <Button
-                variant="light"
-                color="edr-green"
-                size="compact-sm"
-                radius="lg"
-                leftSection={<RefreshCw size={15} />}
-                loading={isFetching}
-                onClick={() => refetch()}
-              >
-                Refresh
-              </Button>
-            </Group>
-
-            <Stack gap="sm">
-              <Text
-                size="xs"
-                fw={700}
-                tt="uppercase"
-                style={{ letterSpacing: 1, color: "#B26C09" }}
-              >
-                Contract reference
-              </Text>
-              <Group gap="sm" align="center" wrap="wrap">
-                <Title order={2} fw={700} style={{ letterSpacing: "-0.4px" }}>
-                  {contract.reference}
-                </Title>
-                <ContractStatusBadge
-                  status={contract.status}
-                  isRenewal={Boolean(contract.renewalOfId)}
-                />
-                <ContractCourtBadge status={contract.status} />
-                <Badge variant="light" color="gray" radius="sm" tt="uppercase">
-                  {contract.contractKind === "GENERAL" ? "General" : "One-time"}
-                </Badge>
-              </Group>
-              <Group gap="lg" mt={4}>
-                <MetaItem icon={Building2} text={customerLabel} />
-                <MetaItem
-                  icon={Calendar}
-                  text={`Created ${formatDate(contract.createdAt)}`}
-                />
-                {contract.contractValidUntil ? (
-                  <MetaItem
-                    icon={CalendarClock}
-                    // Validity is accepted to the minute — show the time.
-                    text={`Valid until ${formatDateTime(contract.contractValidUntil)}`}
-                  />
-                ) : null}
-              </Group>
-              {hasContractDocument && (
-                <Group gap="sm" mt="sm">
+        backTo="/dashboard/contract-requests"
+        title={contract.reference}
+        meta={
+          <Group gap={6} wrap="wrap">
+            <ContractStatusBadge
+              status={contract.status}
+              isRenewal={Boolean(contract.renewalOfId)}
+            />
+            <ContractCourtBadge status={contract.status} />
+            <Badge variant="light" color="gray" radius="sm" tt="uppercase">
+              {contract.contractKind === "GENERAL" ? "General" : "One-time"}
+            </Badge>
+          </Group>
+        }
+        subtitle={
+          <Group gap={6} wrap="wrap">
+            <EntityLink
+              to={
+                !contract.isGovernment && contract.companyId
+                  ? `/dashboard/customers/${contract.companyId}`
+                  : null
+              }
+              label={customerLabel}
+            />
+            <Text size="sm" c="dimmed">
+              · Created {formatDate(contract.createdAt)}
+              {contract.contractValidUntil
+                ? ` · Valid until ${formatDateTime(contract.contractValidUntil)}`
+                : ""}
+            </Text>
+          </Group>
+        }
+        action={
+          <Group gap="sm" wrap="nowrap">
+            <ActionIcon
+              variant="light"
+              color="edr-green"
+              size="lg"
+              radius="md"
+              loading={isFetching}
+              aria-label="Refresh"
+              onClick={() => refetch()}
+            >
+              <RefreshCw size={16} />
+            </ActionIcon>
+            {hasContractDocument && (
+              <Menu position="bottom-end" width={240} withinPortal>
+                <Menu.Target>
+                  <ActionIcon
+                    variant="default"
+                    size="lg"
+                    radius="md"
+                    aria-label="More actions"
+                  >
+                    <MoreHorizontal size={16} />
+                  </ActionIcon>
+                </Menu.Target>
+                <Menu.Dropdown>
                   {canViewSign && (
-                    <Button
-                      color="edr-green"
-                      size="compact-sm"
-                      radius="lg"
+                    <Menu.Item
                       leftSection={<FileSignature size={15} />}
                       onClick={() =>
                         navigate(`/dashboard/contract-requests/${contract.id}/view`)
                       }
                     >
                       View &amp; sign contract
-                    </Button>
+                    </Menu.Item>
                   )}
                   {contractPdf && (
-                    <Button
-                      variant="default"
-                      size="compact-sm"
-                      radius="lg"
+                    <Menu.Item
                       leftSection={<FileText size={15} />}
                       onClick={() =>
                         void fetchViewableFile(contractPdf.id, contractPdf.name).then(
@@ -427,22 +434,23 @@ export default function ContractRequestDetailPage() {
                       }
                     >
                       View contract
-                    </Button>
+                    </Menu.Item>
                   )}
-                  <Button
-                    variant="default"
-                    size="compact-sm"
-                    radius="lg"
+                  <Menu.Item
                     leftSection={<Download size={15} />}
                     onClick={() => void downloadContractPdf()}
                   >
                     Download PDF
-                  </Button>
-                </Group>
-              )}
-            </Stack>
-          </Stack>
-        </Paper>
+                  </Menu.Item>
+                </Menu.Dropdown>
+              </Menu>
+            )}
+          </Group>
+        }
+      />
+
+      <Stack gap="lg">
+        <KpiStrip items={kpis} />
 
         <ContractWorkflowStepper
           status={contract.status}
@@ -505,71 +513,375 @@ export default function ContractRequestDetailPage() {
           </Alert>
         ) : null}
 
-        <Tabs
-          value={currentTab}
-          onChange={(v) => setTab(v ?? "details")}
-          variant="pills"
-          color="edr-green"
-          classNames={{ list: "ov-tablist", tab: "ov-tab" }}
-        >
-          <Tabs.List>
-            <Tabs.Tab value="details" leftSection={<LayoutGrid size={16} />}>
-              Details
-            </Tabs.Tab>
-            <Tabs.Tab
-              value="documents"
-              leftSection={<Files size={16} />}
-              rightSection={
-                contractDocuments.length + profileDocuments.length > 0 ? (
-                  <Badge size="xs" variant="light" color="gray" radius="sm">
-                    {contractDocuments.length + profileDocuments.length}
-                  </Badge>
-                ) : null
-              }
-            >
-              Documents
-            </Tabs.Tab>
-            <Tabs.Tab value="customer" leftSection={<Users size={16} />}>
-              Customer
-            </Tabs.Tab>
-            <Tabs.Tab value="history" leftSection={<History size={16} />}>
-              History
-            </Tabs.Tab>
-          </Tabs.List>
-        </Tabs>
-
         <Grid gap="lg">
           {/* LEFT — primary content */}
           <Grid.Col span={{ base: 12, lg: 8 }}>
-            {currentTab === "documents" ? (
-              <Stack gap="lg">
-                <ContractDocumentsCard
-                  files={contractDocuments}
-                  onView={handleViewFile}
-                  onDownload={handleDownloadFile}
-                />
-                <ContractDocumentsCard
-                  files={profileDocuments}
-                  title="Customer profile documents"
-                  emptyText={
-                    profileDocumentsQuery.isLoading
-                      ? "Loading customer documents…"
-                      : "No profile documents on file for this customer."
+            <Tabs
+              value={currentTab}
+              onChange={setTab}
+              variant="pills"
+              color="edr-green"
+              keepMounted={false}
+            >
+              <Tabs.List mb="lg">
+                <Tabs.Tab value="details" leftSection={<LayoutGrid size={16} />}>
+                  Details
+                </Tabs.Tab>
+                <Tabs.Tab value="shipments" leftSection={<Package size={16} />}>
+                  Shipments
+                </Tabs.Tab>
+                <Tabs.Tab
+                  value="documents"
+                  leftSection={<Files size={16} />}
+                  rightSection={
+                    contractDocuments.length + profileDocuments.length > 0 ? (
+                      <Badge size="xs" variant="light" color="gray" radius="sm">
+                        {contractDocuments.length + profileDocuments.length}
+                      </Badge>
+                    ) : null
                   }
-                  onView={handleViewFile}
-                  onDownload={handleDownloadFile}
-                />
-                {(clearanceView?.workflowFiles?.length ?? 0) > 0 ? (
-                  <ClearanceWorkflowFilesPanel
-                    files={clearanceView!.workflowFiles!}
-                    title="Customs workflow documents"
-                    onView={view}
-                    onDownload={(f) => void handleDownloadFile({ id: f.id, name: f.name } as never)}
+                >
+                  Documents
+                </Tabs.Tab>
+                <Tabs.Tab value="history" leftSection={<History size={16} />}>
+                  History
+                </Tabs.Tab>
+              </Tabs.List>
+
+              <Tabs.Panel value="details">
+                <Stack gap="lg">
+                  <SectionCard
+                    icon={Info}
+                    title="Contract information"
+                    subtitle="Full commercial and operational detail for this contract."
+                  >
+                    <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="lg">
+                      <InfoRow
+                        label="Service type"
+                        value={contract.serviceType?.serviceName ?? "—"}
+                      />
+                      <InfoRow
+                        label="Payment currency"
+                        value={contract.paymentCurrency ?? "—"}
+                      />
+                      <InfoRow
+                        label="Customs clearing"
+                        value={
+                          contract.customsClearingEnabled
+                            ? "Included automatically"
+                            : contract.customsClearingAgent
+                              ? `Customer's agent — ${contract.customsClearingAgent}`
+                              : "Not included"
+                        }
+                      />
+                      {contract.equipmentReturn ? (
+                        <InfoRow
+                          label="Equipment return"
+                          value={
+                            contract.equipmentReturn === "WITH_RETURN"
+                              ? "With return"
+                              : "Without return"
+                          }
+                        />
+                      ) : null}
+                      <InfoRow
+                        label="Contract type"
+                        value={contract.contractType ?? "Standard"}
+                      />
+                      {contract.contractValidityDays != null ? (
+                        <InfoRow
+                          label="Validity period"
+                          value={`${contract.contractValidityDays} days`}
+                        />
+                      ) : null}
+                      {contract.estimatedShipmentDate ? (
+                        <InfoRow
+                          label="Estimated shipment date"
+                          value={formatDate(contract.estimatedShipmentDate)}
+                        />
+                      ) : null}
+                      {contract.firstMilePickupAddress ? (
+                        <InfoRow
+                          label="First-mile pickup"
+                          value={contract.firstMilePickupAddress}
+                        />
+                      ) : null}
+                      {contract.lastMileDeliveryAddress ? (
+                        <InfoRow
+                          label="Last-mile delivery"
+                          value={contract.lastMileDeliveryAddress}
+                        />
+                      ) : null}
+                    </SimpleGrid>
+                    {contract.financialTerms ? (
+                      <Box
+                        mt="md"
+                        pt="md"
+                        style={{ borderTop: "1px solid var(--mantine-color-gray-2)" }}
+                      >
+                        <Text
+                          size="xs"
+                          c="dimmed"
+                          fw={600}
+                          tt="uppercase"
+                          mb={4}
+                          style={{ letterSpacing: 0.3 }}
+                        >
+                          Financial terms
+                        </Text>
+                        <Text size="sm" style={{ whiteSpace: "pre-wrap" }}>
+                          {contract.financialTerms}
+                        </Text>
+                      </Box>
+                    ) : null}
+                  </SectionCard>
+
+                  <SectionCard icon={RouteIcon} title="Routes">
+                    {routes.length === 0 ? (
+                      <Text size="sm" c="dimmed">
+                        No routes on this contract.
+                      </Text>
+                    ) : (
+                      <Stack gap="sm">
+                        {routes.map((r) => (
+                          <Group
+                            key={r.id}
+                            justify="space-between"
+                            wrap="nowrap"
+                            px="sm"
+                            py="xs"
+                            style={{
+                              borderRadius: 8,
+                              border: "1px solid var(--mantine-color-gray-2)",
+                            }}
+                          >
+                            <Group gap={8} wrap="nowrap" style={{ minWidth: 0 }}>
+                              <Text size="sm" fw={600} truncate maw={160}>
+                                {r.originYard?.label ??
+                                  r.originYard?.code ??
+                                  "Origin"}
+                              </Text>
+                              <ArrowRight
+                                size={15}
+                                className="shrink-0 text-muted-foreground"
+                              />
+                              <Text size="sm" fw={600} truncate maw={160}>
+                                {r.destinationYard?.label ??
+                                  r.destinationYard?.code ??
+                                  "Destination"}
+                              </Text>
+                            </Group>
+                            {r.km != null ? (
+                              <Badge variant="light" color="gray" radius="sm">
+                                {r.km} km
+                              </Badge>
+                            ) : null}
+                          </Group>
+                        ))}
+                      </Stack>
+                    )}
+                  </SectionCard>
+
+                  <SectionCard icon={Package} title="Cargo scope">
+                    <Group gap="sm" mb="md">
+                      <Badge variant="light" color="gray" radius="sm" tt="uppercase">
+                        {directionLabel(contract.tradeDirection)}
+                      </Badge>
+                      <Badge variant="light" color="gray" radius="sm" tt="uppercase">
+                        {contract.freightType}
+                      </Badge>
+                      {contract.isHazardous ? (
+                        <Badge
+                          variant="light"
+                          color="orange"
+                          radius="sm"
+                          leftSection={<Flame size={12} />}
+                        >
+                          Hazardous
+                        </Badge>
+                      ) : null}
+                      {contract.isReefer ? (
+                        <Badge
+                          variant="light"
+                          color="cyan"
+                          radius="sm"
+                          leftSection={<Snowflake size={12} />}
+                        >
+                          Reefer
+                        </Badge>
+                      ) : null}
+                    </Group>
+                    {contract.isHazardous ? (
+                      <Box mb="md">
+                        <HazardDeclarationPanel contract={contract} />
+                      </Box>
+                    ) : null}
+                    {(contract.cargoScope ?? []).length === 0 ? (
+                      <Text size="sm" c="dimmed">
+                        No cargo scope lines.
+                      </Text>
+                    ) : (
+                      <Stack gap="sm">
+                        {(contract.cargoScope ?? []).map((s) => {
+                          const isContainer = Boolean(s.containerSize);
+                          // Bulk lines carry their commodity detail (name + unit);
+                          // container lines carry the size (20ft / 40ft).
+                          const title = isContainer
+                            ? `${s.containerSize} container`
+                            : (s.cargoType?.cargoTypeName ??
+                              s.cargoFreeText ??
+                              s.cargoType?.code ??
+                              "Bulk cargo");
+                          // quantityCap unit: containers for a size line, else the
+                          // cargo type's unit of measure (tons / items / …), default tons.
+                          const capUnit = isContainer
+                            ? "containers"
+                            : (s.cargoType?.unitOfMeasure?.toLowerCase() ?? "tons");
+                          return (
+                            <Group key={s.id} gap={8} wrap="nowrap" align="flex-start">
+                              <BoxIcon
+                                size={15}
+                                color="var(--mantine-color-edr-green-6)"
+                                style={{ marginTop: 2, flexShrink: 0 }}
+                              />
+                              <div>
+                                <Text size="sm" fw={500}>
+                                  {title}
+                                </Text>
+                                <Group gap={6} mt={2}>
+                                  <Badge
+                                    variant="light"
+                                    color={isContainer ? "blue" : "grape"}
+                                    radius="sm"
+                                    size="xs"
+                                    tt="uppercase"
+                                  >
+                                    {isContainer ? "Container" : "Bulk"}
+                                  </Badge>
+                                  {s.cargoType?.code ? (
+                                    <Text size="xs" c="dimmed">
+                                      Code: {s.cargoType.code}
+                                    </Text>
+                                  ) : null}
+                                  <Text size="xs" c="dimmed">
+                                    {s.quantityCap != null
+                                      ? `Cap: ${s.quantityCap} ${capUnit}`
+                                      : "Cap: uncapped"}
+                                  </Text>
+                                </Group>
+                              </div>
+                            </Group>
+                          );
+                        })}
+                      </Stack>
+                    )}
+                  </SectionCard>
+
+                  {contract.pricingBreakdown?.lineItems?.length ? (
+                    <SectionCard icon={Receipt} title="Unit rates">
+                      <Stack gap="xs">
+                        {contract.pricingBreakdown.lineItems.map((li) => (
+                          <Group
+                            key={li.code}
+                            justify="space-between"
+                            wrap="nowrap"
+                          >
+                            <Text size="sm" truncate>
+                              {li.label}
+                              {li.containerSize ? ` · ${li.containerSize}` : ""}
+                            </Text>
+                            <Text size="sm" fw={600}>
+                              {contract.pricingBreakdown?.currency} {li.unitPrice} /{" "}
+                              {li.unit}
+                            </Text>
+                          </Group>
+                        ))}
+                      </Stack>
+                    </SectionCard>
+                  ) : null}
+
+                  {contract.contractSummary ? (
+                    <SectionCard icon={FileText} title="Contract summary">
+                      <Text size="sm" style={{ whiteSpace: "pre-wrap" }}>
+                        {contract.contractSummary}
+                      </Text>
+                    </SectionCard>
+                  ) : null}
+                </Stack>
+              </Tabs.Panel>
+
+              <Tabs.Panel value="shipments">
+                <Stack gap="lg">
+                  <SectionCard
+                    icon={Package}
+                    title="Bookings"
+                    subtitle="Shipments drawn down under this contract."
+                  >
+                    <TableCard minWidth={760}>
+                      <DataTable
+                        columns={bookingColumns}
+                        data={contractBookings?.items ?? []}
+                        status={bookingsLoading ? "loading" : "success"}
+                        emptyMessage="No bookings under this contract yet."
+                        containerClassName="border-0 shadow-none bg-transparent"
+                        onRowClick={(row) =>
+                          navigate(`/dashboard/booking-requests/${row.id}`)
+                        }
+                      />
+                    </TableCard>
+                  </SectionCard>
+
+                  <SectionCard
+                    icon={ClipboardList}
+                    title="Shipment requests"
+                    subtitle="Customer-submitted requests against this contract, before they become a booking."
+                  >
+                    <TableCard minWidth={640}>
+                      <DataTable
+                        columns={requestColumns}
+                        data={bookingRequestsQuery.data ?? []}
+                        status={bookingRequestsQuery.isLoading ? "loading" : "success"}
+                        emptyMessage="No shipment requests on this contract yet."
+                        containerClassName="border-0 shadow-none bg-transparent"
+                        onRowClick={(row) =>
+                          navigate(`/dashboard/shipment-requests/${row.id}`)
+                        }
+                      />
+                    </TableCard>
+                  </SectionCard>
+                </Stack>
+              </Tabs.Panel>
+
+              <Tabs.Panel value="documents">
+                <Stack gap="lg">
+                  <ContractDocumentsCard
+                    files={contractDocuments}
+                    onView={handleViewFile}
+                    onDownload={handleDownloadFile}
                   />
-                ) : null}
-              </Stack>
-            ) : currentTab === "history" ? (
-              <Stack gap="lg">
+                  <ContractDocumentsCard
+                    files={profileDocuments}
+                    title="Customer profile documents"
+                    emptyText={
+                      profileDocumentsQuery.isLoading
+                        ? "Loading customer documents…"
+                        : "No profile documents on file for this customer."
+                    }
+                    onView={handleViewFile}
+                    onDownload={handleDownloadFile}
+                  />
+                  {(clearanceView?.workflowFiles?.length ?? 0) > 0 ? (
+                    <ClearanceWorkflowFilesPanel
+                      files={clearanceView!.workflowFiles!}
+                      title="Customs workflow documents"
+                      onView={view}
+                      onDownload={(f) => void handleDownloadFile({ id: f.id, name: f.name } as never)}
+                    />
+                  ) : null}
+                </Stack>
+              </Tabs.Panel>
+
+              <Tabs.Panel value="history">
                 <SectionCard
                   icon={Milestone}
                   title="Key milestones"
@@ -577,291 +889,24 @@ export default function ContractRequestDetailPage() {
                 >
                   <ContractMilestonesTimeline contract={contract} />
                 </SectionCard>
-                <SectionCard
-                  icon={History}
-                  title="Change history"
-                  subtitle="Every recorded edit to this contract — who changed what, and when."
-                >
-                  <ContractRevisionTimeline contractId={contract.id} bare />
-                </SectionCard>
-              </Stack>
-            ) : currentTab === "customer" ? (
-              <ContractCustomerCard contract={contract} />
-            ) : (
-            <Stack gap="lg">
-              <SectionCard
-                icon={Info}
-                title="Contract information"
-                subtitle="Full commercial and operational detail for this contract."
-              >
-                <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="lg">
-                  <InfoRow
-                    label="Service type"
-                    value={contract.serviceType?.serviceName ?? "—"}
-                  />
-                  <InfoRow
-                    label="Payment currency"
-                    value={contract.paymentCurrency ?? "—"}
-                  />
-                  <InfoRow
-                    label="Customs clearing"
-                    value={
-                      contract.customsClearingEnabled
-                        ? "Included automatically"
-                        : contract.customsClearingAgent
-                          ? `Customer's agent — ${contract.customsClearingAgent}`
-                          : "Not included"
-                    }
-                  />
-                  {contract.equipmentReturn ? (
-                    <InfoRow
-                      label="Equipment return"
-                      value={
-                        contract.equipmentReturn === "WITH_RETURN"
-                          ? "With return"
-                          : "Without return"
-                      }
-                    />
-                  ) : null}
-                  <InfoRow
-                    label="Contract type"
-                    value={contract.contractType ?? "Standard"}
-                  />
-                  {contract.contractValidityDays != null ? (
-                    <InfoRow
-                      label="Validity period"
-                      value={`${contract.contractValidityDays} days`}
-                    />
-                  ) : null}
-                  {contract.estimatedShipmentDate ? (
-                    <InfoRow
-                      label="Estimated shipment date"
-                      value={formatDate(contract.estimatedShipmentDate)}
-                    />
-                  ) : null}
-                  {contract.firstMilePickupAddress ? (
-                    <InfoRow
-                      label="First-mile pickup"
-                      value={contract.firstMilePickupAddress}
-                    />
-                  ) : null}
-                  {contract.lastMileDeliveryAddress ? (
-                    <InfoRow
-                      label="Last-mile delivery"
-                      value={contract.lastMileDeliveryAddress}
-                    />
-                  ) : null}
-                </SimpleGrid>
-                {contract.financialTerms ? (
-                  <Box
-                    mt="md"
-                    pt="md"
-                    style={{ borderTop: "1px solid var(--mantine-color-gray-2)" }}
+                <Box mt="lg">
+                  <SectionCard
+                    icon={History}
+                    title="Change history"
+                    subtitle="Every recorded edit to this contract — who changed what, and when."
                   >
-                    <Text
-                      size="xs"
-                      c="dimmed"
-                      fw={600}
-                      tt="uppercase"
-                      mb={4}
-                      style={{ letterSpacing: 0.3 }}
-                    >
-                      Financial terms
-                    </Text>
-                    <Text size="sm" style={{ whiteSpace: "pre-wrap" }}>
-                      {contract.financialTerms}
-                    </Text>
-                  </Box>
-                ) : null}
-              </SectionCard>
-
-              <SectionCard
-                icon={ShieldCheck}
-                title="Approval & signing timeline"
-                subtitle="Every dated step in this contract's approval chain, plus signatures — the same record kept in the sidebar, always visible here."
-              >
-                <ContractMilestonesTimeline contract={contract} />
-              </SectionCard>
-
-              <SectionCard icon={RouteIcon} title="Routes">
-                {routes.length === 0 ? (
-                  <Text size="sm" c="dimmed">
-                    No routes on this contract.
-                  </Text>
-                ) : (
-                  <Stack gap="sm">
-                    {routes.map((r) => (
-                      <Group
-                        key={r.id}
-                        justify="space-between"
-                        wrap="nowrap"
-                        px="sm"
-                        py="xs"
-                        style={{
-                          borderRadius: 8,
-                          border: "1px solid var(--mantine-color-gray-2)",
-                        }}
-                      >
-                        <Group gap={8} wrap="nowrap" style={{ minWidth: 0 }}>
-                          <Text size="sm" fw={600} truncate maw={160}>
-                            {r.originYard?.label ??
-                              r.originYard?.code ??
-                              "Origin"}
-                          </Text>
-                          <ArrowRight
-                            size={15}
-                            className="shrink-0 text-muted-foreground"
-                          />
-                          <Text size="sm" fw={600} truncate maw={160}>
-                            {r.destinationYard?.label ??
-                              r.destinationYard?.code ??
-                              "Destination"}
-                          </Text>
-                        </Group>
-                        {r.km != null ? (
-                          <Badge variant="light" color="gray" radius="sm">
-                            {r.km} km
-                          </Badge>
-                        ) : null}
-                      </Group>
-                    ))}
-                  </Stack>
-                )}
-              </SectionCard>
-
-              <SectionCard icon={Package} title="Cargo scope">
-                <Group gap="sm" mb="md">
-                  <Badge variant="light" color="gray" radius="sm" tt="uppercase">
-                    {directionLabel(contract.tradeDirection)}
-                  </Badge>
-                  <Badge variant="light" color="gray" radius="sm" tt="uppercase">
-                    {contract.freightType}
-                  </Badge>
-                  {contract.isHazardous ? (
-                    <Badge
-                      variant="light"
-                      color="orange"
-                      radius="sm"
-                      leftSection={<Flame size={12} />}
-                    >
-                      Hazardous
-                    </Badge>
-                  ) : null}
-                  {contract.isReefer ? (
-                    <Badge
-                      variant="light"
-                      color="cyan"
-                      radius="sm"
-                      leftSection={<Snowflake size={12} />}
-                    >
-                      Reefer
-                    </Badge>
-                  ) : null}
-                </Group>
-                {contract.isHazardous ? (
-                  <Box mb="md">
-                    <HazardDeclarationPanel contract={contract} />
-                  </Box>
-                ) : null}
-                {(contract.cargoScope ?? []).length === 0 ? (
-                  <Text size="sm" c="dimmed">
-                    No cargo scope lines.
-                  </Text>
-                ) : (
-                  <Stack gap="sm">
-                    {(contract.cargoScope ?? []).map((s) => {
-                      const isContainer = Boolean(s.containerSize);
-                      // Bulk lines carry their commodity detail (name + unit);
-                      // container lines carry the size (20ft / 40ft).
-                      const title = isContainer
-                        ? `${s.containerSize} container`
-                        : (s.cargoType?.cargoTypeName ??
-                          s.cargoFreeText ??
-                          s.cargoType?.code ??
-                          "Bulk cargo");
-                      // quantityCap unit: containers for a size line, else the
-                      // cargo type's unit of measure (tons / items / …), default tons.
-                      const capUnit = isContainer
-                        ? "containers"
-                        : (s.cargoType?.unitOfMeasure?.toLowerCase() ?? "tons");
-                      return (
-                        <Group key={s.id} gap={8} wrap="nowrap" align="flex-start">
-                          <BoxIcon
-                            size={15}
-                            color="var(--mantine-color-edr-green-6)"
-                            style={{ marginTop: 2, flexShrink: 0 }}
-                          />
-                          <div>
-                            <Text size="sm" fw={500}>
-                              {title}
-                            </Text>
-                            <Group gap={6} mt={2}>
-                              <Badge
-                                variant="light"
-                                color={isContainer ? "blue" : "grape"}
-                                radius="sm"
-                                size="xs"
-                                tt="uppercase"
-                              >
-                                {isContainer ? "Container" : "Bulk"}
-                              </Badge>
-                              {s.cargoType?.code ? (
-                                <Text size="xs" c="dimmed">
-                                  Code: {s.cargoType.code}
-                                </Text>
-                              ) : null}
-                              <Text size="xs" c="dimmed">
-                                {s.quantityCap != null
-                                  ? `Cap: ${s.quantityCap} ${capUnit}`
-                                  : "Cap: uncapped"}
-                              </Text>
-                            </Group>
-                          </div>
-                        </Group>
-                      );
-                    })}
-                  </Stack>
-                )}
-              </SectionCard>
-
-              {contract.pricingBreakdown?.lineItems?.length ? (
-                <SectionCard icon={Receipt} title="Unit rates">
-                  <Stack gap="xs">
-                    {contract.pricingBreakdown.lineItems.map((li) => (
-                      <Group
-                        key={li.code}
-                        justify="space-between"
-                        wrap="nowrap"
-                      >
-                        <Text size="sm" truncate>
-                          {li.label}
-                          {li.containerSize ? ` · ${li.containerSize}` : ""}
-                        </Text>
-                        <Text size="sm" fw={600}>
-                          {contract.pricingBreakdown?.currency} {li.unitPrice} /{" "}
-                          {li.unit}
-                        </Text>
-                      </Group>
-                    ))}
-                  </Stack>
-                </SectionCard>
-              ) : null}
-
-              {contract.contractSummary ? (
-                <SectionCard icon={FileText} title="Contract summary">
-                  <Text size="sm" style={{ whiteSpace: "pre-wrap" }}>
-                    {contract.contractSummary}
-                  </Text>
-                </SectionCard>
-              ) : null}
-            </Stack>
-            )}
+                    <ContractRevisionTimeline contractId={contract.id} bare />
+                  </SectionCard>
+                </Box>
+              </Tabs.Panel>
+            </Tabs>
           </Grid.Col>
 
           {/* RIGHT — sticky action rail */}
           <Grid.Col span={{ base: 12, lg: 4 }}>
             <Box style={{ position: "sticky", top: 24 }}>
               <Stack gap="lg">
+                <ContractCustomerCard contract={contract} />
                 <ContractActionsToolbar
                   contract={contract}
                   mutations={mutations}
@@ -891,6 +936,97 @@ export default function ContractRequestDetailPage() {
   );
 }
 
+const bookingColumns: ColumnDef<BookingDetail>[] = [
+  {
+    id: "reference",
+    header: "Booking",
+    cell: ({ row }) => (
+      <Text size="sm" fw={600} c="edr-text">
+        {row.original.reference}
+      </Text>
+    ),
+  },
+  {
+    id: "route",
+    header: "Route",
+    cell: ({ row }) => {
+      const r = toBookingListRow(row.original);
+      return (
+        <Group gap={6} wrap="nowrap">
+          <Text size="sm" c="edr-text">
+            {r.originLabel}
+          </Text>
+          <ArrowRight size={14} className="shrink-0 text-muted-foreground" />
+          <Text size="sm" c="edr-text">
+            {r.destinationLabel}
+          </Text>
+        </Group>
+      );
+    },
+  },
+  {
+    id: "status",
+    header: "Status",
+    cell: ({ row }) => <BookingStatusBadge status={row.original.status} />,
+  },
+  {
+    id: "amount",
+    header: "Amount",
+    meta: { headerClassName: "text-right", cellClassName: "text-right" },
+    cell: ({ row }) => (
+      <Text size="sm" fw={600} c="edr-text">
+        {formatMoney(Number(row.original.totalAmount), row.original.paymentCurrency)}
+      </Text>
+    ),
+  },
+  {
+    id: "createdAt",
+    header: "Created",
+    meta: { headerClassName: "text-right", cellClassName: "text-right" },
+    cell: ({ row }) => (
+      <Text size="sm" c="dimmed">
+        {formatDate(row.original.createdAt)}
+      </Text>
+    ),
+  },
+];
+
+const requestColumns: ColumnDef<Freight.IBookingRequest>[] = [
+  {
+    id: "reference",
+    header: "Request",
+    cell: ({ row }) => (
+      <Text size="sm" fw={600} c="edr-text">
+        {row.original.reference}
+      </Text>
+    ),
+  },
+  {
+    id: "status",
+    header: "Status",
+    cell: ({ row }) => <BookingRequestStatusBadge status={row.original.status} />,
+  },
+  {
+    id: "scheduledDate",
+    header: "Requested for",
+    cell: ({ row }) => (
+      <Text size="sm" c="dimmed">
+        {row.original.scheduledDate ? formatDate(row.original.scheduledDate) : "—"}
+      </Text>
+    ),
+  },
+  {
+    id: "createdAt",
+    header: "Submitted",
+    meta: { headerClassName: "text-right", cellClassName: "text-right" },
+    cell: ({ row }) => (
+      <Text size="sm" c="dimmed">
+        {formatDate(row.original.createdAt)}
+      </Text>
+    ),
+  },
+];
+
 function InfoRow({ label, value }: { label: string; value: string }) {
   return (
     <div>
@@ -909,20 +1045,3 @@ function InfoRow({ label, value }: { label: string; value: string }) {
     </div>
   );
 }
-
-function MetaItem({
-  icon: Icon,
-  text,
-}: {
-  icon: typeof Building2;
-  text: string;
-}) {
-  return (
-    <Group gap={6} wrap="nowrap">
-      <Icon size={14} color="var(--mantine-color-gray-5)" />
-      <Text size="sm" fw={600} c="dark">
-        {text}
-      </Text>
-    </Group>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestsPage.tsx
index 3ff989bb5..aa8b5ed8f 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractRequestsPage.tsx
@@ -3,18 +3,11 @@ import { useMyTradeAccess } from "@/hooks/useMyTradeAccess";
 import {
   ActionIcon,
   Box,
-  Button,
   Card,
-  Group,
-  MultiSelect,
-  Select,
   Stack,
   Text,
-  TextInput,
   ThemeIcon,
 } from "@mantine/core";
-import { DateInput } from "@mantine/dates";
-import { useDebouncedValue } from "@mantine/hooks";
 import {
   AlertTriangle,
   ArrowRight,
@@ -22,38 +15,32 @@ import {
   CheckCircle2,
   Clock,
   FileText,
-  FilterX,
   Inbox,
   LayoutList,
   RefreshCw,
   Repeat,
-  Search,
   User,
-  X,
 } from "lucide-react";
-import { useCallback, useMemo, useState } from "react";
+import { useCallback, useMemo, type ReactNode } from "react";
 import { useNavigate } from "react-router-dom";
+import { useQuery } from "@tanstack/react-query";
+import { api } from "@/services/api";
 
-import { ContractApprovalProgressCell } from "@/components/contracts/ContractApprovalProgressCell";
-import {
-  ContractCourtBadge,
-  ContractStatusBadge,
-} from "@/components/contracts/ContractStatusBadge";
-import {
-  ContractStatusTabs,
-  type ContractStatusTabKey,
-} from "@/components/contracts/ContractStatusTabs";
+import { ContractStatusBadge } from "@/components/contracts/ContractStatusBadge";
 import { bookingTable } from "@/components/bookings/booking-ui.styles";
 import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
 import {
   CONTRACT_LIST_TABS,
   CONTRACT_STATUS_STYLES,
+  contractCourt,
 } from "@/features/contracts/contract-status.config";
+import { formatContractApprovalProgress } from "@/features/contracts/contract-approval-progress";
 import {
   getStaffRowAction,
   toContractListRow,
   type ContractListRow,
 } from "@/features/contracts/mapContractListRow";
+import { formatDate, humanize } from "@/lib/format";
 import {
   useContractList,
   useContractListSummary,
@@ -63,29 +50,17 @@ import {
   Badge,
   DataTable,
   DataTableFooter,
-  usePagination,
   type ColumnDef,
 } from "@edr/ui-common";
+import { FilterBar, dateRangeParams, useFilters, type FilterDef } from "@/components/filters";
 
-function getStatusesForTab(tab: ContractStatusTabKey): string | undefined {
-  const match = CONTRACT_LIST_TABS.find((t) => t.key === tab);
-  if (!match?.statuses?.length) return undefined;
-  return match.statuses.join(",");
-}
-
-/** Statuses selectable in the status filter for a given tab ("all" → every tab status). */
-function getStatusOptionsForTab(
-  tab: ContractStatusTabKey,
-): { value: string; label: string }[] {
-  const match = CONTRACT_LIST_TABS.find((t) => t.key === tab);
-  const statuses = match?.statuses?.length
-    ? match.statuses
-    : CONTRACT_LIST_TABS.flatMap((t) => t.statuses ?? []);
-  return statuses.map((s) => ({
+/** Every filterable status — the pill tabs are gone, so the select carries them all. */
+const STATUS_OPTIONS = CONTRACT_LIST_TABS.flatMap((t) => t.statuses ?? []).map(
+  (s) => ({
     value: s,
     label: CONTRACT_STATUS_STYLES[s]?.label ?? s,
-  }));
-}
+  }),
+);
 
 const TRADE_DIRECTION_OPTIONS = [
   { value: "IMPORT", label: "Import" },
@@ -116,126 +91,117 @@ const SORT_OPTIONS = [
   { value: "contractValidUntil:DESC", label: "Expiring latest" },
 ];
 
-/** Every column is 120px wide and wraps its content instead of truncating. */
-const COLUMN_WIDTH = 120;
+/**
+ * Per-column widths — they must sum to the table's min-w (960px, set on the
+ * containerClassName below) because table-fixed distributes any difference.
+ */
+const COLUMN_WIDTHS = { contract: 250, route: 270, status: 250, validity: 190 };
 const COLUMN_META = {
   headerClassName: "whitespace-normal break-words",
   cellClassName: "whitespace-normal break-words align-top",
 };
 
-/** Local start-of-day → ISO, for inclusive "from" date filters. */
-function startOfDayIso(d: Date): string {
-  const x = new Date(d);
-  x.setHours(0, 0, 0, 0);
-  return x.toISOString();
-}
-
-/** Local end-of-day → ISO, for inclusive "to" date filters. */
-function endOfDayIso(d: Date): string {
-  const x = new Date(d);
-  x.setHours(23, 59, 59, 999);
-  return x.toISOString();
-}
-
-function formatDate(value: string | null | undefined): string {
-  if (!value) return "—";
-  const d = new Date(value);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      });
-}
-
 export default function ContractRequestsPage() {
   const navigate = useNavigate();
-  const { pagination, setPagination } = usePagination({ pageSize: 10 });
-  const [query, setQuery] = useState("");
-  const [debouncedQuery] = useDebouncedValue(query, 300);
-  const [activeTab, setActiveTab] = useState<ContractStatusTabKey>("all");
-  // Filter controls (empty/null = "all").
-  const [statusFilter, setStatusFilter] = useState<string[]>([]);
   const { filterOptions } = useMyTradeAccess();
-  const [directionFilter, setDirectionFilter] = useState<string | null>(null);
-  const [freightTypeFilter, setFreightTypeFilter] = useState<string | null>(
-    null,
-  );
-  const [kindFilter, setKindFilter] = useState<string | null>(null);
-  const [currencyFilter, setCurrencyFilter] = useState<string | null>(null);
-  const [createdFrom, setCreatedFrom] = useState<Date | null>(null);
-  const [createdTo, setCreatedTo] = useState<Date | null>(null);
-  const [sort, setSort] = useState<string>("createdAt:DESC");
 
-  const tabStatuses = getStatusesForTab(activeTab);
-  const statusOptions = useMemo(
-    () => getStatusOptionsForTab(activeTab),
-    [activeTab],
+  // Yard options for the route filter (shared routes reference list, same
+  // query BookingRequestsPage uses).
+  const { data: yardRefs } = useQuery(
+    api.routes.yards.queryOptions({ staleTime: 5 * 60_000 }),
+  );
+  const yardOptions = useMemo(
+    () => (yardRefs ?? []).map((y) => ({ value: y.id, label: y.label ?? y.code })),
+    [yardRefs],
   );
 
-  const resetPage = useCallback(() => {
-    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
-  }, [setPagination, pagination.pageSize]);
+  // Service-type options — same reference-data payload the booking form uses.
+  const { data: refData } = useQuery(
+    api.bookings.referenceData.queryOptions({ staleTime: 5 * 60_000 }),
+  );
+  const serviceTypeOptions = useMemo(
+    () => (refData?.service ?? []).map((s) => ({ value: s.id, label: s.name })),
+    [refData],
+  );
 
-  const filter: ContractListFilter = useMemo(() => {
-    const [sortBy, sortOrder] = sort.split(":") as [string, "ASC" | "DESC"];
-    return {
-      page: pagination.pageIndex + 1,
-      pageSize: pagination.pageSize,
-      sortBy,
-      sortOrder,
-      tab: activeTab,
-      // Server-side free-text search (contract reference, customer name).
-      ...(debouncedQuery.trim() ? { search: debouncedQuery.trim() } : {}),
-      // Explicit status picks narrow within the tab; otherwise the tab's
-      // status group applies.
-      ...(statusFilter.length
-        ? { statuses: statusFilter.join(",") }
-        : tabStatuses
-          ? { statuses: tabStatuses }
-          : {}),
-      ...(directionFilter ? { tradeDirection: directionFilter } : {}),
-      ...(freightTypeFilter ? { freightType: freightTypeFilter } : {}),
-      ...(kindFilter ? { contractKind: kindFilter } : {}),
-      ...(currencyFilter ? { paymentCurrency: currencyFilter } : {}),
-      ...(createdFrom ? { createdFrom: startOfDayIso(createdFrom) } : {}),
-      ...(createdTo ? { createdTo: endOfDayIso(createdTo) } : {}),
-    };
-  }, [
-    pagination.pageIndex,
-    pagination.pageSize,
-    activeTab,
-    tabStatuses,
-    debouncedQuery,
-    statusFilter,
-    directionFilter,
-    freightTypeFilter,
-    kindFilter,
-    currencyFilter,
-    createdFrom,
-    createdTo,
-    sort,
-  ]);
+  // Static shape only (no facet counts) — this is what useFilters needs to
+  // parse the URL and build API params. Counts are attached separately below,
+  // for rendering only, once the summary query (which itself depends on
+  // these params) has resolved.
+  const filterDefs: FilterDef[] = useMemo(
+    () => [
+      { key: "statuses", label: "Status", type: "enum", options: STATUS_OPTIONS },
+      {
+        key: "contractKind",
+        label: "Kind",
+        type: "enum",
+        multiple: false,
+        options: CONTRACT_KIND_OPTIONS,
+      },
+      {
+        key: "tradeDirection",
+        label: "Direction",
+        type: "enum",
+        multiple: false,
+        options: filterOptions(TRADE_DIRECTION_OPTIONS),
+      },
+      {
+        key: "freightType",
+        label: "Freight",
+        type: "enum",
+        multiple: false,
+        options: FREIGHT_TYPE_OPTIONS,
+      },
+      {
+        key: "serviceTypeId",
+        label: "Service",
+        type: "enum",
+        multiple: false,
+        options: serviceTypeOptions,
+      },
+      {
+        key: "paymentCurrency",
+        label: "Currency",
+        type: "enum",
+        multiple: false,
+        options: CURRENCY_OPTIONS,
+        secondary: true,
+      },
+      {
+        key: "created",
+        label: "Created",
+        type: "date",
+        secondary: true,
+        // Before/after are safe to expose: the repository applies
+        // createdFrom/createdTo independently, so a single-sided bound
+        // already works server-side.
+        operators: ["between", "before", "after"],
+        toParams: dateRangeParams("createdFrom", "createdTo"),
+      },
+      {
+        key: "route",
+        label: "Route",
+        type: "route",
+        options: yardOptions,
+        toParams: ({ v }) => ({ originYardId: v[0], destinationYardId: v[1] }),
+      },
+    ],
+    [filterOptions, yardOptions, serviceTypeOptions],
+  );
 
-  const activeFilterCount =
-    (statusFilter.length ? 1 : 0) +
-    (directionFilter ? 1 : 0) +
-    (freightTypeFilter ? 1 : 0) +
-    (kindFilter ? 1 : 0) +
-    (currencyFilter ? 1 : 0) +
-    (createdFrom || createdTo ? 1 : 0);
+  const controls = useFilters(filterDefs, {
+    defaultSort: "createdAt:DESC",
+    pageSize: 10,
+  });
 
-  const clearFilters = useCallback(() => {
-    setStatusFilter([]);
-    setDirectionFilter(null);
-    setFreightTypeFilter(null);
-    setKindFilter(null);
-    setCurrencyFilter(null);
-    setCreatedFrom(null);
-    setCreatedTo(null);
-    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
-  }, [setPagination, pagination.pageSize]);
+  const filter: ContractListFilter = useMemo(
+    () => ({
+      ...(controls.params as unknown as ContractListFilter),
+      // Kept as the React Query cache-key discriminator (tabs themselves are gone).
+      tab: "all",
+    }),
+    [controls.params],
+  );
 
   const { data, isLoading, isError, refetch, isFetching } =
     useContractList(filter);
@@ -245,13 +211,27 @@ export default function ContractRequestsPage() {
     refetch: refetchSummary,
   } = useContractListSummary(filter);
 
+  const statusCounts = useMemo(
+    () => Object.fromEntries((summary?.facets?.status ?? []).map((b) => [b.value, b.count])),
+    [summary?.facets],
+  );
+
+  // filterDefs + counts, for the bar to render. Kept separate from filterDefs
+  // itself so the URL-parsing hook above never has to wait on this query.
+  const defs: FilterDef[] = useMemo(
+    () =>
+      filterDefs.map((d) =>
+        d.key === "statuses" && d.type === "enum" ? { ...d, counts: statusCounts } : d,
+      ),
+    [filterDefs, statusCounts],
+  );
+
   const rows = useMemo(
     () => (data?.items ?? []).map(toContractListRow),
     [data?.items],
   );
 
   const total = data?.total ?? 0;
-  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
   const showEmpty = !isLoading && !isError && rows.length === 0;
 
   const metrics = summary?.metrics;
@@ -272,7 +252,7 @@ export default function ContractRequestsPage() {
   const columns: ColumnDef<ContractListRow>[] = [
     {
       id: "contract",
-      size: COLUMN_WIDTH,
+      size: COLUMN_WIDTHS.contract,
       meta: COLUMN_META,
       header: () => <span className={bookingTable.headerCell}>Customer</span>,
       cell: ({ row }) => {
@@ -295,7 +275,7 @@ export default function ContractRequestsPage() {
     },
     {
       id: "route",
-      size: COLUMN_WIDTH,
+      size: COLUMN_WIDTHS.route,
       meta: COLUMN_META,
       header: () => <span className={bookingTable.headerCell}>Route</span>,
       cell: ({ row }) => {
@@ -310,7 +290,7 @@ export default function ContractRequestsPage() {
             <div className="flex gap-1.5">
               <Badge
                 variant="outline"
-                className="h-5 border-border/50 bg-background/50 px-1.5 text-[10px] font-medium uppercase backdrop-blur-sm"
+                className="h-5 border-border/50 bg-background/50 px-1.5 text-[10px] font-medium backdrop-blur-sm"
               >
                 {directionLabel(c.tradeDirection)}
               </Badge>
@@ -318,7 +298,7 @@ export default function ContractRequestsPage() {
                 variant="secondary"
                 className="h-5 bg-muted/40 px-1.5 text-[10px] font-medium"
               >
-                {c.freightType}
+                {humanize(c.freightType)}
               </Badge>
             </div>
           </div>
@@ -327,47 +307,77 @@ export default function ContractRequestsPage() {
     },
     {
       id: "status",
-      size: COLUMN_WIDTH,
+      size: COLUMN_WIDTHS.status,
       meta: COLUMN_META,
       header: () => <span className={bookingTable.headerCell}>Status</span>,
-      cell: ({ row }) => (
-        <div className="py-1">
-          <ContractStatusBadge
-            status={row.original.status}
-            isRenewal={row.original.isRenewal}
-          />
-        </div>
-      ),
-    },
-    {
-      id: "court",
-      size: COLUMN_WIDTH,
-      meta: COLUMN_META,
-      header: () => (
-        <span className={bookingTable.headerCell}>Waiting on</span>
-      ),
-      cell: ({ row }) => (
-        <div className="py-1">
-          <ContractCourtBadge status={row.original.status} />
-        </div>
-      ),
-    },
-    {
-      id: "approval",
-      size: COLUMN_WIDTH,
-      meta: COLUMN_META,
-      header: () => <span className={bookingTable.headerCell}>Approval</span>,
-      cell: ({ row }) => <ContractApprovalProgressCell row={row.original} />,
+      cell: ({ row }) => {
+        const c = row.original;
+        const court = contractCourt(c.status);
+        const progress = formatContractApprovalProgress(
+          c.status,
+          c.approvalSteps,
+        );
+        const action = getStaffRowAction(c);
+        // One dimmed line: who it's waiting on, the staff verb, and the
+        // approval chain when one exists. "Open" adds nothing — row click
+        // already opens the detail page.
+        const pieces: ReactNode[] = [];
+        if (court) {
+          pieces.push(court === "customer" ? "With customer" : "With EDR");
+        }
+        if (action && action.variant === "filled") {
+          pieces.push(
+            // "View & sign" pointed at the contract-view page, not the
+            // detail page — keep that deep link as an inline link.
+            action.to(c.id).endsWith("/view") ? (
+              <button
+                type="button"
+                className="underline underline-offset-2 hover:text-primary"
+                onClick={(e) => {
+                  e.stopPropagation();
+                  navigate(action.to(c.id));
+                }}
+              >
+                {action.label}
+              </button>
+            ) : (
+              action.label
+            ),
+          );
+        }
+        if ((c.approvalSteps ?? []).length > 0) {
+          pieces.push(progress.label);
+          if (!progress.complete && progress.detail.startsWith("Next:")) {
+            pieces.push(progress.detail);
+          }
+        }
+        return (
+          <div className="space-y-1 py-1">
+            <ContractStatusBadge status={c.status} isRenewal={c.isRenewal} />
+            {pieces.length ? (
+              <div className="text-xs text-muted-foreground">
+                {pieces.map((piece, i) => (
+                  <span key={i}>
+                    {i > 0 ? " · " : null}
+                    {piece}
+                  </span>
+                ))}
+              </div>
+            ) : null}
+          </div>
+        );
+      },
     },
     {
       id: "validity",
-      size: COLUMN_WIDTH,
+      size: COLUMN_WIDTHS.validity,
       meta: COLUMN_META,
       header: () => <span className={bookingTable.headerCell}>Validity</span>,
       cell: ({ row }) => {
         const c = row.original;
+        const isGeneral = c.contractKind === "GENERAL";
         return (
-          <Stack gap={2}>
+          <Stack gap={2} align="flex-start">
             <span className="inline-flex items-center gap-1.5 text-sm text-muted-foreground">
               <CalendarClock className="size-3.5" />
               {c.validUntil
@@ -381,58 +391,22 @@ export default function ContractRequestsPage() {
                 From {formatDate(c.validFrom)}
               </Text>
             ) : null}
+            <Badge
+              variant="outline"
+              className="h-5 border-border/50 bg-background/50 px-1.5 text-[10px] font-medium uppercase"
+            >
+              {isGeneral ? (
+                <span className="inline-flex items-center gap-1">
+                  <Repeat className="size-3" /> General
+                </span>
+              ) : (
+                "One-time"
+              )}
+            </Badge>
           </Stack>
         );
       },
     },
-    {
-      id: "kind",
-      size: COLUMN_WIDTH,
-      meta: COLUMN_META,
-      header: () => <span className={bookingTable.headerCell}>Kind</span>,
-      cell: ({ row }) => {
-        const isGeneral = row.original.contractKind === "GENERAL";
-        return (
-          <Badge
-            variant="outline"
-            className="h-5 border-border/50 bg-background/50 px-1.5 text-[10px] font-medium uppercase"
-          >
-            {isGeneral ? (
-              <span className="inline-flex items-center gap-1">
-                <Repeat className="size-3" /> General
-              </span>
-            ) : (
-              "One-time"
-            )}
-          </Badge>
-        );
-      },
-    },
-    {
-      id: "actions",
-      size: COLUMN_WIDTH,
-      meta: COLUMN_META,
-      header: () => <span className={bookingTable.headerCell}>Action</span>,
-      cell: ({ row }) => {
-        const action = getStaffRowAction(row.original);
-        if (!action) return null;
-        return (
-          <Button
-            size="compact-sm"
-            radius="md"
-            variant={action.variant === "filled" ? "filled" : action.variant}
-            color="edr-green"
-            onClick={(e) => {
-              // Don't let the row-click navigation fire as well.
-              e.stopPropagation();
-              navigate(action.to(row.original.id));
-            }}
-          >
-            {action.label}
-          </Button>
-        );
-      },
-    },
   ];
 
   return (
@@ -485,173 +459,16 @@ export default function ContractRequestsPage() {
           ]}
         />
 
-        <ContractStatusTabs
-          active={activeTab}
-          onChange={(tab) => {
-            setActiveTab(tab);
-            // Status picks belong to the previous tab's option set — reset.
-            setStatusFilter([]);
-            setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
-          }}
-          counts={tabCounts}
-        />
-
         <Card p={0}>
           <Stack gap={0}>
-            <Box px="md" pt="md" pb="sm" w="100%">
-              <Stack gap="sm">
-                <Group justify="space-between" gap="md" wrap="wrap">
-                  <TextInput
-                    placeholder="Search reference or customer…"
-                    leftSection={<Search size={18} />}
-                    value={query}
-                    onChange={(e) => {
-                      setQuery(e.target.value);
-                      resetPage();
-                    }}
-                    rightSection={
-                      query && (
-                        <ActionIcon
-                          size="sm"
-                          color="gray"
-                          radius="md"
-                          variant="transparent"
-                          onClick={() => {
-                            setQuery("");
-                            resetPage();
-                          }}
-                        >
-                          <X size={16} />
-                        </ActionIcon>
-                      )
-                    }
-                    style={{ flex: 1, minWidth: "200px" }}
-                    radius="lg"
-                  />
-                  <Select
-                    data={SORT_OPTIONS}
-                    value={sort}
-                    onChange={(v) => {
-                      setSort(v ?? "createdAt:DESC");
-                      resetPage();
-                    }}
-                    allowDeselect={false}
-                    radius="lg"
-                    style={{ minWidth: 170 }}
-                    aria-label="Sort contracts"
-                  />
-                  <Text size="sm" c="dimmed">
-                    {total} record{total !== 1 ? "s" : ""}
-                  </Text>
-                </Group>
-                <Group gap="sm" wrap="wrap">
-                  <MultiSelect
-                    placeholder={
-                      statusFilter.length ? undefined : "All statuses"
-                    }
-                    data={statusOptions}
-                    value={statusFilter}
-                    onChange={(v) => {
-                      setStatusFilter(v);
-                      resetPage();
-                    }}
-                    clearable
-                    searchable
-                    radius="lg"
-                    style={{ minWidth: 220 }}
-                    aria-label="Filter by status"
-                  />
-                  <Select
-                    placeholder="All directions"
-                    data={filterOptions(TRADE_DIRECTION_OPTIONS)}
-                    value={directionFilter}
-                    onChange={(v) => {
-                      setDirectionFilter(v);
-                      resetPage();
-                    }}
-                    clearable
-                    radius="lg"
-                    style={{ minWidth: 150 }}
-                    aria-label="Filter by trade direction"
-                  />
-                  <Select
-                    placeholder="All freight types"
-                    data={FREIGHT_TYPE_OPTIONS}
-                    value={freightTypeFilter}
-                    onChange={(v) => {
-                      setFreightTypeFilter(v);
-                      resetPage();
-                    }}
-                    clearable
-                    radius="lg"
-                    style={{ minWidth: 160 }}
-                    aria-label="Filter by freight type"
-                  />
-                  <Select
-                    placeholder="All kinds"
-                    data={CONTRACT_KIND_OPTIONS}
-                    value={kindFilter}
-                    onChange={(v) => {
-                      setKindFilter(v);
-                      resetPage();
-                    }}
-                    clearable
-                    radius="lg"
-                    style={{ minWidth: 160 }}
-                    aria-label="Filter by contract kind"
-                  />
-                  <Select
-                    placeholder="All currencies"
-                    data={CURRENCY_OPTIONS}
-                    value={currencyFilter}
-                    onChange={(v) => {
-                      setCurrencyFilter(v);
-                      resetPage();
-                    }}
-                    clearable
-                    radius="lg"
-                    style={{ minWidth: 140 }}
-                    aria-label="Filter by payment currency"
-                  />
-                  <DateInput
-                    placeholder="Created from"
-                    value={createdFrom}
-                    onChange={(v) => {
-                      setCreatedFrom(v ? new Date(v) : null);
-                      resetPage();
-                    }}
-                    maxDate={createdTo ?? undefined}
-                    clearable
-                    radius="lg"
-                    style={{ minWidth: 140 }}
-                    aria-label="Created from"
-                  />
-                  <DateInput
-                    placeholder="Created to"
-                    value={createdTo}
-                    onChange={(v) => {
-                      setCreatedTo(v ? new Date(v) : null);
-                      resetPage();
-                    }}
-                    minDate={createdFrom ?? undefined}
-                    clearable
-                    radius="lg"
-                    style={{ minWidth: 140 }}
-                    aria-label="Created to"
-                  />
-                  {activeFilterCount > 0 ? (
-                    <Button
-                      variant="subtle"
-                      color="gray"
-                      radius="lg"
-                      leftSection={<FilterX size={16} />}
-                      onClick={clearFilters}
-                    >
-                      Clear filters ({activeFilterCount})
-                    </Button>
-                  ) : null}
-                </Group>
-              </Stack>
+            <Box px="md" pt="sm" pb="xs" w="100%">
+              <FilterBar
+                defs={defs}
+                controls={controls}
+                searchPlaceholder="Search reference or customer…"
+                sortOptions={SORT_OPTIONS}
+                viewId="contract-requests"
+              />
             </Box>
 
             {showEmpty ? (
@@ -670,19 +487,8 @@ export default function ContractRequestsPage() {
                     isLoading ? "loading" : isError ? "error" : "success"
                   }
                   onRowClick={handleRowClick}
-                  pagination={{
-                    pageIndex: pagination.pageIndex,
-                    pageSize: pagination.pageSize,
-                    pageCount,
-                    totalCount: total,
-                  }}
-                  tableOptions={{
-                    state: { pagination },
-                    onPaginationChange: setPagination,
-                    manualPagination: true,
-                    pageCount,
-                  }}
-                  // table-fixed makes the per-column 120px widths stick; without
+                  {...controls.tableProps(total)}
+                  // table-fixed makes the per-column widths stick; without
                   // it auto-layout re-widens columns once cells wrap.
                   containerClassName="border-0 shadow-none bg-transparent [&_table]:table-fixed [&_table]:min-w-[960px]"
                   footer={DataTableFooter}
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractViewPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractViewPage.tsx
index b49b0e25c..205413891 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ContractViewPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ContractViewPage.tsx
@@ -18,7 +18,6 @@ import toast from "react-hot-toast";
 
 import { ContractSignSuccessModal } from "@/components/contracts/ContractSignSuccessModal";
 import { ContractSignaturePad } from "@/components/bookings/ContractSignaturePad";
-import { StampUpload } from "@/components/contracts/StampUpload";
 import { contractsService } from "@/services/contracts.service";
 import { extractApiError } from "@/utils/result";
 import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
@@ -40,7 +39,6 @@ export default function ContractViewPage() {
   const [successOpen, setSuccessOpen] = useState(false);
   const [signerName, setSignerName] = useState("");
   const [signatureData, setSignatureData] = useState<string | null>(null);
-  const [stampData, setStampData] = useState<string | null>(null);
   const [drawNew, setDrawNew] = useState(false);
 
   const { data, isLoading, isError, refetch } = useQuery({
@@ -56,10 +54,11 @@ export default function ContractViewPage() {
     mutationFn: () =>
       contractsService.signContract(id!, {
         role: "STAFF",
+        // No stamp is sent: EDR's seal is the ONE global company stamp, applied
+        // server-side from StampSettingsService when the signature is stored.
         signatureImageBase64: usingSaved
           ? (savedSignatureImage as string)
           : (signatureData ?? ""),
-        stampImageBase64: stampData ?? "",
         signerDisplayName: signerName.trim(),
         consentText: "I confirm this contract on behalf of EDR.",
       }),
@@ -98,14 +97,12 @@ export default function ContractViewPage() {
   const openSign = () => {
     setSignerName(data?.savedSignature?.signerDisplayName ?? "");
     setSignatureData(null);
-    // Prefill with the reusable stamp saved on the profile; still replaceable.
-    setStampData(data?.savedSignature?.stampImageUrl ?? null);
     setDrawNew(false);
     setSignOpen(true);
   };
 
   const confirmSign = () => {
-    if (!signerName.trim() || !stampData) return;
+    if (!signerName.trim()) return;
     const image = usingSaved ? savedSignatureImage : signatureData;
     if (!image) return;
     signMutation.mutate();
@@ -243,13 +240,6 @@ export default function ContractViewPage() {
             <ContractSignaturePad onChange={setSignatureData} />
           )}
 
-          <StampUpload
-            value={stampData}
-            onChange={setStampData}
-            label="EDR company stamp"
-            description="Attach the official EDR stamp or seal — it is applied to the contract next to the signature."
-          />
-
           <Group justify="flex-end" gap="sm">
             <Button variant="default" onClick={() => setSignOpen(false)}>
               Cancel
@@ -260,8 +250,7 @@ export default function ContractViewPage() {
               disabled={
                 signMutation.isPending ||
                 !signerName.trim() ||
-                (!usingSaved && !signatureData) ||
-                !stampData
+                (!usingSaved && !signatureData)
               }
               onClick={confirmSign}
             >
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/GlClearanceDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/GlClearanceDetailPage.tsx
index a501cd50a..e8041e271 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/GlClearanceDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/GlClearanceDetailPage.tsx
@@ -20,6 +20,8 @@ import {
   AlertTriangle,
   ClipboardList,
   FileText,
+  History,
+  Receipt,
   Share2,
   Upload,
 } from "lucide-react";
@@ -29,12 +31,15 @@ import { useAuth } from "@/auth/useAuth";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import type { BookingDetail } from "@/types/booking";
 
-import { PageContainer } from "@/components/page/PageContainer";
-import { PageHeader } from "@/components/page/PageHeader";
+import { PageContainer, PageHeader } from "@/components/page";
+import { EntityLink } from "@/components/detail";
 import { ClearanceReviewSection } from "@/components/bookings/detail/ClearanceReviewSection";
+import { BookingCompanyCard } from "@/components/bookings/detail/BookingCompanyCard";
 import { ContractClearanceReviewSection } from "@/components/contracts/ContractClearanceReviewSection";
 import { ClearanceWorkflowFilesPanel } from "@/components/contracts/ClearanceWorkflowFilesPanel";
 import { GlExchangePanel } from "@/components/contracts/GlExchangePanel";
+import { ClearanceChargesTab } from "@/components/contracts/ClearanceChargesTab";
+import { ClearanceHistoryTab } from "@/components/contracts/ClearanceHistoryTab";
 import {
   GlClearanceUploadModal,
   type GlClearanceUploadKind,
@@ -42,6 +47,7 @@ import {
 import { PhasedClearanceActionPanel } from "@/components/contracts/PhasedClearanceActionPanel";
 import { TransitAssigneePanel } from "@/components/contracts/TransitAssigneePanel";
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
+import { RequestCustomerCard } from "@/components/contracts/detail/RequestDetailCards";
 import { IncidentReportCard } from "@/components/contracts/gl-actions/IncidentReportCard";
 import { findWorkflowFile } from "@/components/contracts/PhasedUploadedFileRow";
 import { useFileViewer } from "@/hooks/useFileViewer";
@@ -56,6 +62,7 @@ type GlClearanceDetail =
       reference: string;
       tradeDirection: string;
       clearance: Freight.ContractClearanceView;
+      contract: Freight.IContract;
     }
   | {
       kind: "booking";
@@ -79,6 +86,7 @@ async function loadGlClearanceDetail(id: string): Promise<GlClearanceDetail> {
       reference: contract.reference,
       tradeDirection: contract.tradeDirection,
       clearance,
+      contract,
     };
   } catch {
     const [clearance, booking] = await Promise.all([
@@ -181,6 +189,16 @@ export default function GlClearanceDetailPage() {
             { label: "GL Djibouti Clearance", href: backTo },
             { label: data.reference },
           ]}
+          subtitle={
+            <EntityLink
+              to={
+                data.kind === "contract"
+                  ? `/dashboard/contract-requests/${id}`
+                  : `/dashboard/booking-requests/${id}`
+              }
+              label={data.kind === "contract" ? "Contract details" : "Booking details"}
+            />
+          }
           meta={
             <Badge variant="light" color={isImport ? "edr-green" : "gray"} radius="sm">
               {directionLabel(data.tradeDirection)}
@@ -233,6 +251,16 @@ export default function GlClearanceDetailPage() {
             <Tabs.Tab value="exchange" leftSection={<Share2 size={14} />}>
               Document exchange
             </Tabs.Tab>
+            {data.kind === "booking" ? (
+              <Tabs.Tab value="charges" leftSection={<Receipt size={14} />}>
+                Customer charges
+              </Tabs.Tab>
+            ) : null}
+            {data.kind === "booking" ? (
+              <Tabs.Tab value="history" leftSection={<History size={14} />}>
+                History
+              </Tabs.Tab>
+            ) : null}
             {incidentBookingId ? (
               <Tabs.Tab value="incidents" leftSection={<AlertTriangle size={14} />}>
                 Incidents
@@ -278,37 +306,44 @@ export default function GlClearanceDetailPage() {
               </Grid.Col>
 
               <Grid.Col span={{ base: 12, lg: 5 }}>
-                <PhasedClearanceActionPanel
-                  contractId={data.kind === "contract" ? id : undefined}
-                  bookingId={data.kind === "booking" ? id : linkedBookingId}
-                  // For a per-booking instance, "created" means COMPLETED (has
-                  // cargo/price), not merely that a booking row exists — a bare
-                  // instance is not yet a real booking. Contract-level clearance
-                  // keeps its linked-booking signal.
-                  bookingCreated={
-                    data.kind === "booking"
-                      ? bookingCompleted
-                      : Boolean(linkedBookingId)
-                  }
-                  bookingMilestones={
-                    data.kind === "booking"
-                      ? (data.clearance.milestones ?? [])
-                      : (bookingMilestones ?? [])
-                  }
-                  clearance={data.clearance}
-                  tradeDirection={data.tradeDirection}
-                  workflowFiles={workflowFiles}
-                  roleMode="DJ"
-                  useUploadModals
-                  onUploadDoRequest={() => setUploadKind("do")}
-                  onUploadRoRequest={() => setUploadKind("ro")}
-                  onChanged={() => {
-                    void refetch();
-                    refetchBookingMilestonesIfLinked();
-                  }}
-                  onViewFile={view}
-                  onDownloadFile={(f) => void downloadBookingFile(f.id, f.name)}
-                />
+                <Stack gap="md">
+                  {data.kind === "contract" ? (
+                    <RequestCustomerCard contract={data.contract} />
+                  ) : (
+                    <BookingCompanyCard booking={data.booking} />
+                  )}
+                  <PhasedClearanceActionPanel
+                    contractId={data.kind === "contract" ? id : undefined}
+                    bookingId={data.kind === "booking" ? id : linkedBookingId}
+                    // For a per-booking instance, "created" means COMPLETED (has
+                    // cargo/price), not merely that a booking row exists — a bare
+                    // instance is not yet a real booking. Contract-level clearance
+                    // keeps its linked-booking signal.
+                    bookingCreated={
+                      data.kind === "booking"
+                        ? bookingCompleted
+                        : Boolean(linkedBookingId)
+                    }
+                    bookingMilestones={
+                      data.kind === "booking"
+                        ? (data.clearance.milestones ?? [])
+                        : (bookingMilestones ?? [])
+                    }
+                    clearance={data.clearance}
+                    tradeDirection={data.tradeDirection}
+                    workflowFiles={workflowFiles}
+                    roleMode="DJ"
+                    useUploadModals
+                    onUploadDoRequest={() => setUploadKind("do")}
+                    onUploadRoRequest={() => setUploadKind("ro")}
+                    onChanged={() => {
+                      void refetch();
+                      refetchBookingMilestonesIfLinked();
+                    }}
+                    onViewFile={view}
+                    onDownloadFile={(f) => void downloadBookingFile(f.id, f.name)}
+                  />
+                </Stack>
               </Grid.Col>
             </Grid>
           </Tabs.Panel>
@@ -348,6 +383,18 @@ export default function GlClearanceDetailPage() {
             <GlExchangePanel entityId={id!} />
           </Tabs.Panel>
 
+          {data.kind === "booking" ? (
+            <Tabs.Panel value="charges">
+              <ClearanceChargesTab bookingId={id!} roleMode="DJ" onViewFile={view} />
+            </Tabs.Panel>
+          ) : null}
+
+          {data.kind === "booking" ? (
+            <Tabs.Panel value="history">
+              <ClearanceHistoryTab bookingId={id!} />
+            </Tabs.Panel>
+          ) : null}
+
           {incidentBookingId ? (
             <Tabs.Panel value="incidents">
               <SectionCard icon={AlertTriangle} title="Incident reports" accent="edr-green">
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/GlDjiboutiClearanceListPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/GlDjiboutiClearanceListPage.tsx
index 77ad33f56..6e34da29a 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/GlDjiboutiClearanceListPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/GlDjiboutiClearanceListPage.tsx
@@ -1,3 +1,4 @@
+import { formatDate } from "@/lib/format";
 import { directionLabel } from "@/lib/utils";
 import { useCallback, useMemo, useState } from "react";
 import { useNavigate } from "react-router-dom";
@@ -44,6 +45,7 @@ import { KpiStrip } from "@/components/page/KpiStrip";
 import { bookingTable } from "@/components/bookings/booking-ui.styles";
 import { useBookingDjClearanceQueue } from "@/hooks/bookings/useBookings";
 import type { BookingDetail } from "@/types/booking";
+import "./contract-clearance-table.css";
 
 const prettyStatus = (s?: string | null) =>
   (s ?? "")
@@ -51,18 +53,6 @@ const prettyStatus = (s?: string | null) =>
     .replace(/_/g, " ")
     .replace(/^\w/, (c) => c.toUpperCase());
 
-function formatDate(value?: string | null): string {
-  if (!value) return "—";
-  const d = new Date(value);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-      });
-}
-
 function yardLabel(
   yard?: { label?: string; code?: string; name?: string } | null,
   fallback = "—",
@@ -225,15 +215,24 @@ function RouteCell({
 }) {
   return (
     <Stack gap={4} py={2}>
-      <Group gap={6} wrap="nowrap">
-        <Text size="sm" fw={500}>
-          {origin}
-        </Text>
-        <ArrowRight size={14} className="shrink-0 text-muted-foreground" />
-        <Text size="sm" fw={500}>
-          {destination}
-        </Text>
-      </Group>
+      {/* Wraps past 120px as "Addis Ababa" / "→ Djibouti"; text wraps
+          normally (cells are otherwise nowrap) so it never spills over. */}
+      <Text
+        size="sm"
+        fw={500}
+        maw={120}
+        lh={1.35}
+        style={{ whiteSpace: "normal", overflowWrap: "anywhere" }}
+      >
+        {origin}{" "}
+        <ArrowRight
+          size={13}
+          className="text-muted-foreground"
+          style={{ display: "inline-block", verticalAlign: "-2px" }}
+        />
+        {"\u00A0"}
+        {destination}
+      </Text>
       <Group gap={8} align="center">
         <DirectionIcon direction={direction} />
         <Badge size="xs" variant="default" radius="sm">
@@ -661,9 +660,6 @@ export default function GlDjiboutiClearanceListPage() {
                     Clear
                   </Button>
                 ) : null}
-                <Text size="sm" c="dimmed" ml="auto">
-                  {total} record{total !== 1 ? "s" : ""}
-                </Text>
               </Group>
             </Box>
 
@@ -690,7 +686,7 @@ export default function GlDjiboutiClearanceListPage() {
                 ) : null}
               </Stack>
             ) : (
-              <Box style={{ overflowX: "auto" }} px="xs" pb="xs">
+              <Box w="100%" miw={0} style={{ overflowX: "auto" }}>
                 <DataTable<ShipmentRow, unknown>
                   columns={shipmentColumns}
                   data={pagedShipmentRows}
@@ -708,7 +704,7 @@ export default function GlDjiboutiClearanceListPage() {
                     manualPagination: true,
                     pageCount,
                   }}
-                  containerClassName="border-0 shadow-none bg-transparent [&_th]:max-w-[100px] [&_td]:max-w-[100px] [&_td]:break-words"
+                  containerClassName="edr-clearance-table border-0 shadow-none rounded-none bg-transparent"
                   footer={DataTableFooter}
                 />
               </Box>
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestDetailPage.tsx
index 89237af1f..54d0fb419 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestDetailPage.tsx
@@ -25,6 +25,7 @@ import type { Freight } from "@edr/types";
 import { PageContainer } from "@/components/page/PageContainer";
 import { PageHeader } from "@/components/page/PageHeader";
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
+import { EntityLink } from "@/components/detail";
 import {
   RequestCustomerCard,
   RequestContractSummaryCard,
@@ -113,7 +114,17 @@ export default function ShipmentRequestDetailPage() {
       <Stack gap="lg">
         <PageHeader
           title={`Shipment request ${request.reference}`}
-          subtitle={`On contract ${contractRef}`}
+          subtitle={
+            <Group gap={6} wrap="wrap">
+              <Text size="sm" c="dimmed">
+                On contract
+              </Text>
+              <EntityLink
+                to={`/dashboard/contract-requests/${request.contractId}`}
+                label={contractRef}
+              />
+            </Group>
+          }
           backTo="/dashboard/shipment-requests"
           breadcrumbs={[
             { label: "Shipment Requests", href: "/dashboard/shipment-requests" },
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestsPage.tsx
index 4eb93cafd..73b9907f5 100644
--- a/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/ShipmentRequestsPage.tsx
@@ -17,7 +17,8 @@ import {
   Textarea,
   TextInput,
 } from "@mantine/core";
-import { DateInput } from "@mantine/dates";
+import { DatePickerInput } from "@mantine/dates";
+import { getDateRangePresets } from "@/components/common/dateRangePresets";
 import {
   ArrowUpDown,
   FilterX,
@@ -293,7 +294,7 @@ export default function ShipmentRequestsPage() {
               {row.original.contractReference}
             </Text>
             {row.original.customerName ? (
-              <Text size="xs" c="dimmed" mt={2}>
+              <Text size="xs" c="dimmed" mt={2} truncate maw={200}>
                 {row.original.customerName}
               </Text>
             ) : null}
@@ -460,25 +461,19 @@ export default function ShipmentRequestsPage() {
                 allowDeselect={false}
                 aria-label="Cargo type"
               />
-              <DateInput
+              <DatePickerInput
+                type="range"
                 radius="md"
-                w={150}
-                placeholder="Preferred from"
-                value={preferredFrom}
-                onChange={(v) => setPreferredFrom(v ? new Date(v) : null)}
-                maxDate={preferredTo ?? undefined}
+                w={230}
+                placeholder="Preferred date range"
+                value={[preferredFrom, preferredTo]}
+                onChange={([from, to]) => {
+                  setPreferredFrom(from ? new Date(from) : null);
+                  setPreferredTo(to ? new Date(to) : null);
+                }}
+                presets={getDateRangePresets()}
                 clearable
-                aria-label="Preferred date from"
-              />
-              <DateInput
-                radius="md"
-                w={150}
-                placeholder="Preferred to"
-                value={preferredTo}
-                onChange={(v) => setPreferredTo(v ? new Date(v) : null)}
-                minDate={preferredFrom ?? undefined}
-                clearable
-                aria-label="Preferred date to"
+                aria-label="Preferred date range"
               />
               <Select
                 radius="md"
diff --git a/apps/edr-freight-web/backoffice/src/pages/contracts/contract-clearance-table.css b/apps/edr-freight-web/backoffice/src/pages/contracts/contract-clearance-table.css
new file mode 100644
index 000000000..bdc615fb8
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/contracts/contract-clearance-table.css
@@ -0,0 +1,94 @@
+/*
+ * Scoped to .edr-clearance-table — the DataTable container div on the
+ * Document Clearance hubs (GL Ethiopia + GL Djibouti). Mirrors the portal's /bookings table
+ * (bookings-table.css): content-sized columns with a 100px floor, no
+ * truncation, horizontal scroll when the table outgrows the card, sticky
+ * header row and a sticky shadowed action column.
+ */
+.edr-clearance-table {
+  overflow-x: auto;
+  max-width: 100%;
+  min-width: 0;
+}
+
+/*
+ * width: max-content — the table is exactly as wide as its columns' content
+ * needs, never squeezed to fit the viewport; the container scrolls instead.
+ * min-width: 100% keeps it filling the card when content is narrow.
+ */
+.edr-clearance-table table {
+  table-layout: auto;
+  width: max-content;
+  min-width: 100%;
+}
+
+/* 100px floor, no ceiling: cells grow to fit their text, nothing is clipped. */
+.edr-clearance-table th,
+.edr-clearance-table td:not([colspan]) {
+  min-width: 100px;
+  max-width: none;
+  overflow: visible;
+  text-overflow: clip;
+  white-space: nowrap;
+}
+
+/*
+ * Mantine Badge caps itself at max-width: 100%; inside an auto-layout table
+ * cell that resolves against min-content and clips the label. Let badges size
+ * to their text so the column grows to fit them.
+ */
+.edr-clearance-table .mantine-Badge-root {
+  max-width: none;
+}
+
+/*
+ * Mantine Group's preventGrowOverflow caps every child at 100%/N of the cell.
+ * In an auto-width table cell that resolves against min-content and collapses
+ * the badges/text in the Type, Route and Status columns to nothing. Let group
+ * children size to their content; the column grows and the container scrolls.
+ */
+.edr-clearance-table .mantine-Group-root > * {
+  max-width: none;
+  flex-shrink: 0;
+}
+
+/* Sticky header row. */
+.edr-clearance-table thead th {
+  position: sticky;
+  top: 0;
+  z-index: 1;
+}
+
+/*
+ * Sticky action column, shrunk to its content. The width overrides the inline
+ * width DataTable stamps from tanstack's column size — hence !important.
+ * `:not([colspan])` keeps the full-width error/empty rows out.
+ */
+.edr-clearance-table th:last-child,
+.edr-clearance-table td:last-child:not([colspan]) {
+  width: 1% !important;
+  min-width: 0;
+  position: sticky;
+  right: 0;
+  box-shadow: -12px 0 16px -6px rgba(16, 32, 47, 0.3);
+}
+
+/*
+ * Sticky cells sit above the scrolling ones, so they need their own opaque
+ * background or the columns underneath show through.
+ */
+.edr-clearance-table td:last-child:not([colspan]) {
+  background: #f5f8fb;
+  z-index: 2;
+}
+
+/* Row hover uses the tailwind `hover:bg-accent` class on the <tr>. */
+.edr-clearance-table tbody tr:hover td:last-child:not([colspan]) {
+  background: var(--accent, #f4fbf8);
+}
+
+/* Header cell is sticky on both axes — it must outrank the body's sticky column. */
+.edr-clearance-table th:last-child {
+  background: #f4f7fa;
+  z-index: 3;
+}
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 a9e56a6d8..a81f07c8b 100644
--- a/apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx
@@ -8,7 +8,7 @@ import {
   Card,
   Center,
   Container,
-  Divider,
+  Grid,
   Group,
   Loader,
   SimpleGrid,
@@ -17,11 +17,15 @@ import {
   Text,
 } from "@mantine/core";
 import {
+  AlertTriangle,
   ArrowLeft,
   ArrowRight,
   Banknote,
+  Contact,
   Download,
+  ExternalLink,
   Eye,
+  FileSignature,
   FileText,
   History,
   Hourglass,
@@ -31,6 +35,8 @@ import {
   FilePen,
   Paperclip,
   Receipt,
+  UserCheck,
+  UserRound,
 } from "lucide-react";
 import { useQuery } from "@tanstack/react-query";
 import { useMemo, useState } from "react";
@@ -44,13 +50,14 @@ import {
   CompanyTimeline,
   CompanyTypeBadge,
   InvoiceStatusBadge,
+  ManualRegistrationBadge,
   PaymentStatusBadge,
+  PersonCard,
   ProfileApprovalActions,
   ProfileChips,
   ProfileStatusBadge,
   ProfileTypeBadge,
   RequestDocumentChangeModal,
-  ResetPasswordAction,
   TableCard,
   formatBytes,
   formatDate,
@@ -58,11 +65,13 @@ import {
   humanize,
 } from "@/components/customers";
 import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
+import { ContractStatusBadge } from "@/components/contracts/ContractStatusBadge";
+import { useContractList } from "@/hooks/contracts/useContracts";
 import { useAuth } from "@/auth/useAuth";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import {
   downloadBookingFile,
-  fetchViewableFile,
+  openFileInNewTab,
 } from "@/services/files.service";
 import { api } from "@/services/api";
 import type {
@@ -74,12 +83,8 @@ import type {
 } from "@/types/customer";
 import { hasSubmittedOnboarding, isOnboardingDraft } from "@/types/customer";
 import type { Invoice } from "@/types/invoice";
-import {
-  DataTable,
-  useFileViewer,
-  usePagination,
-  type ColumnDef,
-} from "@edr/ui-common";
+import { DataTable, usePagination, type ColumnDef } from "@edr/ui-common";
+import type { Freight } from "@edr/types";
 
 /** Plain-text summary of the company's eTrade-sourced record, downloaded client-side (eTrade returns data, not a document). */
 function downloadTinRecord(company: Company) {
@@ -138,7 +143,6 @@ const POA_DELEGATION_PENDING_CODE = "poa_delegation_letter_pending";
 export default function CustomerDetailPage() {
   const { id } = useParams<{ id: string }>();
   const navigate = useNavigate();
-  const { view, viewer } = useFileViewer();
   const { user } = useAuth();
 
   const { data: company, isLoading } = useQuery(
@@ -165,6 +169,10 @@ export default function CustomerDetailPage() {
       enabled: Boolean(id),
     }),
   );
+  const contractsQuery = useContractList(
+    { companyId: id, pageSize: 100 },
+    Boolean(id),
+  );
 
   const { pagination: invoicePagination, setPagination: setInvoicePagination } =
     usePagination({
@@ -186,6 +194,7 @@ export default function CustomerDetailPage() {
   );
 
   const bookings = Array.isArray(bookingsQuery.data) ? bookingsQuery.data : [];
+  const contracts = contractsQuery.data?.items ?? [];
   const documents = Array.isArray(documentsQuery.data)
     ? documentsQuery.data
     : [];
@@ -258,7 +267,7 @@ export default function CustomerDetailPage() {
                     variant="subtle"
                     color="gray"
                     aria-label={`View ${f.name}`}
-                    onClick={() => void fetchViewableFile(f.id, f.name).then(view)}
+                    onClick={() => openFileInNewTab(f.id, f.name)}
                   >
                     <Eye size={14} />
                   </ActionIcon>
@@ -267,7 +276,7 @@ export default function CustomerDetailPage() {
                     type="button"
                     size="xs"
                     lineClamp={1}
-                    onClick={() => void fetchViewableFile(f.id, f.name).then(view)}
+                    onClick={() => openFileInNewTab(f.id, f.name)}
                     style={{
                       maxWidth: 170,
                       textAlign: "left",
@@ -322,7 +331,7 @@ export default function CustomerDetailPage() {
         ),
       },
     ],
-    [view, canReview],
+    [canReview],
   );
 
   const bookingColumns: ColumnDef<CustomerBooking>[] = useMemo(
@@ -393,44 +402,86 @@ export default function CustomerDetailPage() {
     [],
   );
 
-  const documentColumns: ColumnDef<CustomerDocument>[] = useMemo(
+  const contractColumns: ColumnDef<Freight.IContract>[] = useMemo(
     () => [
       {
-        id: "name",
-        header: "Document",
-        cell: ({ row }) => {
-          const doc = row.original;
-          return (
-            <Stack gap={2}>
-              <Group gap="sm" wrap="nowrap">
-                <FileText size={16} className="shrink-0 text-edr-muted" />
-                <Text size="sm" c="edr-text" truncate>
-                  {doc.name}
-                </Text>
-                {doc.reviewStatus === "change_requested" && (
-                  <Badge size="xs" color="orange" variant="light">
-                    Change requested
-                  </Badge>
-                )}
-              </Group>
-              {/* The note is the whole point of the request — show it inline so a
-                  second reviewer sees what was already asked for. */}
-              {doc.reviewStatus === "change_requested" && doc.reviewNote && (
-                <Text size="xs" c="dimmed" pl={24}>
-                  {doc.reviewNote}
-                </Text>
-              )}
-            </Stack>
-          );
-        },
+        id: "reference",
+        header: "Contract",
+        cell: ({ row }) => (
+          <Text size="sm" fw={600} c="edr-text">
+            {row.original.reference}
+          </Text>
+        ),
       },
+      {
+        id: "kind",
+        header: "Kind",
+        cell: ({ row }) => (
+          <Text size="sm" c="dimmed">
+            {row.original.contractKind === "GENERAL" ? "General" : "One-time"}
+          </Text>
+        ),
+      },
+      {
+        id: "status",
+        header: "Status",
+        cell: ({ row }) => (
+          <ContractStatusBadge
+            status={row.original.status}
+            isRenewal={Boolean(row.original.renewalOfId)}
+          />
+        ),
+      },
+      {
+        id: "validUntil",
+        header: "Valid until",
+        cell: ({ row }) => (
+          <Text size="sm" c="dimmed">
+            {formatDate(row.original.contractValidUntil)}
+          </Text>
+        ),
+      },
+      {
+        id: "createdAt",
+        header: "Created",
+        meta: { headerClassName: "text-right", cellClassName: "text-right" },
+        cell: ({ row }) => (
+          <Text size="sm" c="dimmed">
+            {formatDate(row.original.createdAt)}
+          </Text>
+        ),
+      },
+    ],
+    [],
+  );
+
+  const documentColumns: ColumnDef<CustomerDocument>[] = useMemo(
+    () => [
       {
         id: "code",
         header: "Type",
         cell: ({ row }) => (
-          <Text size="sm" c="dimmed">
-            {humanize(row.original.code)}
-          </Text>
+          <Stack gap={2}>
+            <Group gap="sm" wrap="nowrap">
+              <FileText size={16} className="shrink-0 text-edr-muted" />
+              <Text size="sm" c="edr-text" truncate>
+                {humanize(row.original.code)}
+              </Text>
+              {row.original.reviewStatus === "change_requested" && (
+                <Badge size="xs" color="orange" variant="light">
+                  Change requested
+                </Badge>
+              )}
+            </Group>
+            {/* The note is the whole point of the request — show it inline so a
+                  second reviewer sees what was already asked for. */}
+            {row.original.reviewStatus === "change_requested" &&
+              row.original.reviewNote && (
+                <Text size="xs" c="dimmed" pl={24}>
+                  {row.original.reviewNote}
+                </Text>
+              )}
+          </Stack>
         ),
       },
       {
@@ -463,9 +514,7 @@ export default function CustomerDetailPage() {
               aria-label="View"
               data-stop-row-click
               onClick={() =>
-                void fetchViewableFile(row.original.id, row.original.name).then(
-                  view,
-                )
+                openFileInNewTab(row.original.id, row.original.name)
               }
             >
               <Eye size={16} />
@@ -505,7 +554,7 @@ export default function CustomerDetailPage() {
         ),
       },
     ],
-    [view, canRequestDocChange],
+    [canRequestDocChange],
   );
 
   const paymentColumns: ColumnDef<CustomerPayment>[] = useMemo(
@@ -614,7 +663,10 @@ export default function CustomerDetailPage() {
     [],
   );
 
-  const licenseProfiles = (company?.companyProfiles ?? []).filter(
+  /** Never read `company.companyProfiles` directly — an endpoint that stops
+   *  loading the relation would otherwise crash the whole page. */
+  const profiles = company?.companyProfiles ?? [];
+  const licenseProfiles = profiles.filter(
     (p) => p.licenseFiles && p.licenseFiles.length > 0,
   );
 
@@ -628,26 +680,24 @@ export default function CustomerDetailPage() {
     [documents],
   );
   const poaLive = poaDocuments.filter((d) => d.code === POA_DELEGATION_CODE);
-  const poaFields = [
-    { label: "PoA name", value: company?.poaName },
-    { label: "PoA email", value: company?.poaEmail },
-    { label: "PoA phone", value: company?.poaPhone },
-    { label: "PoA location", value: company?.poaLocation },
-    { label: "PoA address", value: company?.poaAddress },
-  ];
-  const hasPoaDetails = poaFields.some((f) => f.value?.trim());
+  const hasPoaDetails = [
+    company?.poaName,
+    company?.poaEmail,
+    company?.poaPhone,
+    company?.poaLocation,
+    company?.poaAddress,
+  ].some((v) => v?.trim());
   // Shared with the portal (buildCompanyIdentityState) — same derivation, so
   // this page can never disagree with the rule the API actually enforces.
-  const ownerIdentity = company?.identity?.owner;
-  const poaIdentity = company?.identity?.poa;
+  const identityState = company?.identity;
+  const ownerIdentity = identityState?.owner;
+  const poaIdentity = identityState?.poa;
   const hasEtradeRecord = Boolean(company?.licenceNumber?.trim());
   // A freight forwarder acts on other companies' behalf, so its PoA — details
   // and DARS delegation paper both — is mandatory rather than optional.
-  const poaMandatory = (company?.companyProfiles ?? []).some(
-    (p) => p.type === "freight_forwarder",
-  );
+  const poaMandatory = profiles.some((p) => p.type === "freight_forwarder");
   const delegationMissing =
-    (hasPoaDetails || poaMandatory) && poaLive.length === 0;
+    company?.identity?.poaDeclared === "yes" && poaLive.length === 0;
 
   if (isLoading) {
     return (
@@ -695,10 +745,13 @@ export default function CustomerDetailPage() {
             ) : (
               <CompanyStatusBadge status={company.status} />
             )}
+            <ManualRegistrationBadge
+              cooperative={company.cooperative}
+              investorLicence={company.investorLicence}
+            />
             <ChangeRequestPendingBadge companyId={company.id} />
           </Group>
         }
-        action={<ResetPasswordAction company={company} />}
       />
 
       <Tabs defaultValue="overview">
@@ -709,6 +762,9 @@ export default function CustomerDetailPage() {
           <Tabs.Tab value="bookings" leftSection={<Package size={16} />}>
             Bookings
           </Tabs.Tab>
+          <Tabs.Tab value="contracts" leftSection={<FileSignature size={16} />}>
+            Contracts
+          </Tabs.Tab>
           <Tabs.Tab value="documents" leftSection={<FileText size={16} />}>
             Documents
           </Tabs.Tab>
@@ -741,13 +797,32 @@ export default function CustomerDetailPage() {
               </Alert>
             )}
 
+            {/* Nothing below came from eTrade for these customers. A
+                co-operative holds no trade licence at all; a foreign investor's
+                comes from the Investment Commission, not the trade registry.
+                Either way every registration field was typed, and the reviewer
+                is the only check there is. */}
+            {(company.cooperative || company.investorLicence) && (
+              <Alert
+                color="orange"
+                variant="light"
+                radius="md"
+                icon={<AlertTriangle size={18} />}
+                title="Registration entered by hand — not verified against eTrade"
+              >
+                {company.cooperative
+                  ? "This company onboarded as a co-operative union or farm, which holds no trade licence, so eTrade had no record to look its TIN up in. The company name, registration and address below are the customer's own statement. Check them against the Co-operative Registration Certificate on the Documents tab before approving."
+                  : "This company onboarded on a foreign investment licence, so we could not look its TIN up on eTrade. The company name, registration and address below are the customer's own statement. Check them against the Investment Licence on the Documents tab before approving."}
+              </Alert>
+            )}
+
             <ChangeRequestReview company={company} />
 
             <KpiStrip
               items={[
                 {
                   label: "Profiles",
-                  value: company.companyProfiles.length,
+                  value: profiles.length,
                   icon: IdCard,
                   color: "edr-green",
                 },
@@ -759,9 +834,7 @@ export default function CustomerDetailPage() {
                     : "Pending approval",
                   value: stillOnboarding
                     ? "—"
-                    : company.companyProfiles.filter(
-                        (p) => p.status === "pending",
-                      ).length,
+                    : profiles.filter((p) => p.status === "pending").length,
                   icon: IdCard,
                   color: "yellow",
                 },
@@ -780,358 +853,390 @@ export default function CustomerDetailPage() {
               ]}
             />
 
-            <Card>
-              <Stack gap="lg">
-                <Text fw={600} c="edr-text">
-                  Company information
-                </Text>
-                <SimpleGrid cols={{ base: 1, sm: 2, lg: 3 }} spacing="lg">
-                  <InfoField label="TIN" value={company.tin} />
-                  <InfoField label="VAT number" value={company.vatNumber} />
-                  <InfoField label="FAN number" value={company.fanNumber} />
-                  <InfoField
-                    label="Submitted on"
-                    value={formatDate(company.createdAt)}
-                  />
-                  <InfoField
-                    label="Approved on"
-                    value={
-                      company.approvedAt
-                        ? formatDate(company.approvedAt)
-                        : "Not yet approved"
-                    }
-                  />
-                  <InfoField
-                    label="Owner identity"
-                    value={
-                      ownerIdentity?.verified
-                        ? "Fayda verified"
-                        : ownerIdentity?.passportNumber
-                          ? `Passport ${ownerIdentity.passportNumber}`
-                          : "Not verified"
-                    }
-                  />
-                  <InfoField label="Country" value={company.country} />
-                  <InfoField label="Address" value={company.address} />
-                  <InfoField label="Website" value={company.website} />
-                  <InfoField label="Email" value={company.email} />
-                  <InfoField label="Phone" value={company.phone} />
-                  <Box />
-                  <InfoField
-                    label="Contact person"
-                    value={company.contactPersonName}
-                  />
-                  <InfoField
-                    label="Contact phone"
-                    value={company.contactPersonPhone}
-                  />
-                  <Box />
-                  <InfoField
-                    label="General manager"
-                    value={company.generalManagerName}
-                  />
-                  <InfoField
-                    label="GM email"
-                    value={company.generalManagerEmail}
-                  />
-                  <InfoField
-                    label="GM phone"
-                    value={company.generalManagerPhone}
-                  />
-                </SimpleGrid>
-              </Stack>
-            </Card>
-
-            <Card>
-              <Stack gap="lg">
-                <Group gap="xs" wrap="nowrap" justify="space-between">
-                  <Group gap="xs" wrap="nowrap">
-                    <Text fw={600} c="edr-text">
-                      eTrade registration
-                    </Text>
-                    {hasEtradeRecord ? (
-                      <Badge size="sm" color="edr-green" variant="light">
-                        Verified with eTrade
-                      </Badge>
-                    ) : (
-                      <Badge size="sm" color="gray" variant="light">
-                        No eTrade record
-                      </Badge>
-                    )}
-                  </Group>
-                  {hasEtradeRecord && (
-                    <ActionIcon
-                      variant="default"
-                      aria-label="Download TIN record"
-                      onClick={() => downloadTinRecord(company)}
-                    >
-                      <Download size={16} />
-                    </ActionIcon>
-                  )}
-                </Group>
-                {hasEtradeRecord ? (
-                  <SimpleGrid cols={{ base: 1, sm: 2, lg: 3 }} spacing="lg">
-                    <InfoField
-                      label="License number"
-                      value={company.licenceNumber}
-                    />
-                    <InfoField label="Status" value={company.statusDescription} />
-                    <InfoField
-                      label="Date registered"
-                      value={company.dateRegistered}
-                    />
-                    <InfoField label="Renewed from" value={company.renewedFrom} />
-                    <InfoField label="Renewal date" value={company.renewalDate} />
-                    <InfoField label="Renewed to" value={company.renewedTo} />
-                    <InfoField label="Region" value={company.region} />
-                    <InfoField label="Zone" value={company.zone} />
-                    <InfoField label="Woreda" value={company.woreda} />
-                    <InfoField label="Kebele" value={company.kebele} />
-                    <InfoField label="House No" value={company.houseNo} />
-                  </SimpleGrid>
-                ) : (
-                  <Text size="sm" c="dimmed">
-                    No eTrade registration record on file for this customer's
-                    TIN.
-                  </Text>
-                )}
-              </Stack>
-            </Card>
-
-            <Card>
-              <Stack gap="lg">
-                <Group gap="xs" wrap="nowrap">
-                  <Text fw={600} c="edr-text">
-                    Owner identity
-                  </Text>
-                  {ownerIdentity?.verified ? (
-                    <Badge size="sm" color="edr-green" variant="light">
-                      Fayda verified
-                    </Badge>
-                  ) : (
-                    <Badge size="sm" color="gray" variant="light">
-                      Not verified
-                    </Badge>
-                  )}
-                </Group>
-                {ownerIdentity?.verified ? (
-                  <SimpleGrid cols={{ base: 1, sm: 2, lg: 3 }} spacing="lg">
-                    <InfoField label="Name" value={ownerIdentity.name} />
-                    <InfoField label="Phone" value={ownerIdentity.phone} />
-                    <InfoField label="Email" value={ownerIdentity.email} />
-                    <InfoField label="Address" value={ownerIdentity.address} />
-                    <InfoField
-                      label="Verified at"
-                      value={formatDate(ownerIdentity.verifiedAt)}
-                    />
-                    <InfoField
-                      label="Birthdate"
-                      value={ownerIdentity.birthdate}
-                    />
-                    <InfoField label="Gender" value={ownerIdentity.gender} />
-                    <InfoField
-                      label="Passport number"
-                      value={ownerIdentity.passportNumber}
-                    />
-                  </SimpleGrid>
-                ) : (
-                  <Text size="sm" c="dimmed">
-                    {ownerIdentity?.passportNumber
-                      ? `Not Fayda verified — identified by passport ${ownerIdentity.passportNumber}.`
-                      : "The company owner has not verified their identity with Fayda."}
-                  </Text>
-                )}
-              </Stack>
-            </Card>
-
-            <Card>
-              <Stack gap="lg">
-                <Group justify="space-between" wrap="nowrap">
-                  <Group gap="xs" wrap="nowrap">
-                    <Text fw={600} c="edr-text">
-                      Power of Attorney
-                    </Text>
-                    {poaMandatory && (
-                      <Badge size="xs" color="blue" variant="light">
-                        Required for freight forwarder
-                      </Badge>
-                    )}
-                  </Group>
-                  {delegationMissing ? (
-                    <Badge size="sm" color="red" variant="light">
-                      DARS delegation paper missing
-                    </Badge>
-                  ) : poaLive.length > 0 ? (
-                    <Badge size="sm" color="edr-green" variant="light">
-                      DARS delegation paper on file
-                    </Badge>
-                  ) : (
-                    <Badge size="sm" color="gray" variant="light">
-                      Not provided
-                    </Badge>
-                  )}
-                </Group>
-
-                {hasPoaDetails ? (
-                  <SimpleGrid cols={{ base: 1, sm: 2, lg: 3 }} spacing="lg">
-                    {poaFields.map((f) => (
-                      <InfoField
-                        key={f.label}
-                        label={f.label}
-                        value={f.value}
-                      />
-                    ))}
-                    <InfoField
-                      label="PoA Fayda"
-                      value={
-                        poaIdentity?.verified ? "Verified" : "Not verified"
-                      }
-                    />
-                    {poaIdentity?.verified && (
-                      <>
+            <Grid gap="lg" align="flex-start">
+              {/* Company facts — the wide column. People live in the narrow one
+                  beside it, so nothing about a person is stated twice. */}
+              <Grid.Col span={{ base: 12, lg: 8 }}>
+                <Stack gap="lg">
+                  <Card>
+                    <Stack gap="lg">
+                      <Text fw={600} c="edr-text">
+                        Company information
+                      </Text>
+                      <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="lg">
+                        <InfoField label="TIN" value={company.tin} />
                         <InfoField
-                          label="PoA verified at"
-                          value={formatDate(poaIdentity.verifiedAt)}
+                          label="VAT number"
+                          value={company.vatNumber}
+                        />
+                        <InfoField label="Country" value={company.country} />
+                        <InfoField
+                          label="Nationality"
+                          value={
+                            company.nationality
+                              ? humanize(company.nationality)
+                              : undefined
+                          }
+                        />
+                        {/* Why this company's registration was typed rather
+                            than fetched, and why it carries no licence. */}
+                        <InfoField
+                          label="Registration"
+                          value={
+                            company.cooperative
+                              ? "Co-operative union / farm (no trade licence)"
+                              : company.investorLicence
+                                ? "Foreign investment licence — typed by the customer, not from eTrade"
+                                : "eTrade trade licence"
+                          }
+                        />
+                        <InfoField label="Address" value={company.address} />
+                        <InfoField label="Email" value={company.email} />
+                        <InfoField label="Phone" value={company.phone} />
+                        <InfoField label="Website" value={company.website} />
+                        <InfoField
+                          label="Submitted on"
+                          value={formatDate(company.createdAt)}
                         />
                         <InfoField
-                          label="PoA birthdate"
-                          value={poaIdentity.birthdate}
+                          label="Approved on"
+                          value={
+                            company.approvedAt
+                              ? formatDate(company.approvedAt)
+                              : "Not yet approved"
+                          }
                         />
-                        <InfoField label="PoA gender" value={poaIdentity.gender} />
-                      </>
-                    )}
-                  </SimpleGrid>
-                ) : (
-                  <Text size="sm" c="dimmed">
-                    No Power of Attorney representative recorded for this
-                    customer.
-                  </Text>
-                )}
+                      </SimpleGrid>
+                    </Stack>
+                  </Card>
 
-                <Divider />
-
-                <Stack gap="sm">
-                  <Text
-                    size="xs"
-                    fw={600}
-                    c="edr-muted"
-                    tt="uppercase"
-                    style={{ letterSpacing: "0.04em" }}
-                  >
-                    DARS delegation paper
-                  </Text>
-
-                  {documentsQuery.isLoading ? (
-                    <Group gap="xs">
-                      <Loader size="xs" />
-                      <Text size="sm" c="dimmed">
-                        Loading documents…
-                      </Text>
-                    </Group>
-                  ) : documentsQuery.isError ? (
-                    <Group gap="sm">
-                      <Text size="sm" c="red">
-                        Failed to load documents.
-                      </Text>
-                      <Anchor
-                        component="button"
-                        type="button"
-                        size="xs"
-                        onClick={() => void documentsQuery.refetch()}
-                      >
-                        Retry
-                      </Anchor>
-                    </Group>
-                  ) : poaDocuments.length === 0 ? (
-                    <Text size="sm" c="dimmed">
-                      No DARS delegation paper uploaded.
-                    </Text>
-                  ) : (
-                    poaDocuments.map((doc) => (
-                      <Group key={doc.id} justify="space-between" wrap="nowrap">
-                        <Group gap="sm" wrap="nowrap" style={{ minWidth: 0 }}>
-                          <Paperclip
-                            size={14}
-                            className="shrink-0 text-edr-muted"
-                          />
-                          <Anchor
-                            component="button"
-                            type="button"
-                            size="sm"
-                            lineClamp={1}
-                            onClick={() =>
-                              void fetchViewableFile(doc.id, doc.name).then(view)
-                            }
-                          >
-                            {doc.name}
-                          </Anchor>
-                          <Text size="xs" c="dimmed" className="shrink-0">
-                            {formatBytes(doc.size)} ·{" "}
-                            {formatDate(doc.uploadedAt)}
+                  <Card>
+                    <Stack gap="lg">
+                      <Group gap="xs" wrap="nowrap" justify="space-between">
+                        <Group gap="xs" wrap="nowrap">
+                          <Text fw={600} c="edr-text">
+                            eTrade registration
                           </Text>
-                          {doc.code === POA_DELEGATION_PENDING_CODE && (
-                            <Badge
-                              size="xs"
-                              color="yellow"
-                              variant="light"
-                              className="shrink-0"
-                            >
-                              Pending approval
+                          {hasEtradeRecord ? (
+                            <Badge size="sm" color="edr-green" variant="light">
+                              Verified with eTrade
+                            </Badge>
+                          ) : (
+                            <Badge size="sm" color="gray" variant="light">
+                              No eTrade record
                             </Badge>
                           )}
                         </Group>
-                        <Group gap={4} wrap="nowrap">
+                        {hasEtradeRecord && (
                           <ActionIcon
-                            variant="subtle"
-                            color="gray"
-                            aria-label={`Preview ${doc.name}`}
-                            onClick={() =>
-                              void fetchViewableFile(doc.id, doc.name).then(view)
-                            }
-                          >
-                            <Eye size={16} />
-                          </ActionIcon>
-                          <ActionIcon
-                            component="button"
-                            type="button"
-                            onClick={() =>
-                              void downloadBookingFile(doc.id, doc.name)
-                            }
-                            variant="subtle"
-                            color="gray"
-                            aria-label={`Download ${doc.name}`}
+                            variant="default"
+                            aria-label="Download TIN record"
+                            onClick={() => downloadTinRecord(company)}
                           >
                             <Download size={16} />
                           </ActionIcon>
-                        </Group>
+                        )}
                       </Group>
-                    ))
-                  )}
-                </Stack>
-              </Stack>
-            </Card>
+                      {hasEtradeRecord ? (
+                        <SimpleGrid
+                          cols={{ base: 1, sm: 2, lg: 3 }}
+                          spacing="lg"
+                        >
+                          <InfoField
+                            label="License number"
+                            value={company.licenceNumber}
+                          />
+                          <InfoField
+                            label="Status"
+                            value={company.statusDescription}
+                          />
+                          <InfoField
+                            label="Date registered"
+                            value={company.dateRegistered}
+                          />
+                          <InfoField
+                            label="Renewed from"
+                            value={company.renewedFrom}
+                          />
+                          <InfoField
+                            label="Renewal date"
+                            value={company.renewalDate}
+                          />
+                          <InfoField
+                            label="Renewed to"
+                            value={company.renewedTo}
+                          />
+                          <InfoField label="Region" value={company.region} />
+                          <InfoField label="Zone" value={company.zone} />
+                          <InfoField label="Woreda" value={company.woreda} />
+                          <InfoField label="Kebele" value={company.kebele} />
+                          <InfoField label="House No" value={company.houseNo} />
+                        </SimpleGrid>
+                      ) : (
+                        <Text size="sm" c="dimmed">
+                          No eTrade registration record on file for this
+                          customer's TIN.
+                        </Text>
+                      )}
+                    </Stack>
+                  </Card>
 
-            <Card>
-              <Stack gap="md">
-                <Group justify="space-between">
-                  <Text fw={600} c="edr-text">
-                    Role profiles
-                  </Text>
-                  <ProfileChips profiles={company.companyProfiles} />
-                </Group>
-                <Box style={{ overflowX: "auto" }} w="100%">
-                  <Box miw={1040}>
-                    <DataTable
-                      columns={profileColumns}
-                      data={company.companyProfiles}
-                      status="success"
-                      emptyMessage="No profiles registered."
-                      containerClassName="border-0 shadow-none bg-transparent"
-                    />
-                  </Box>
-                </Box>
-              </Stack>
-            </Card>
+                  <Card>
+                    <Stack gap="md">
+                      <Group justify="space-between">
+                        <Text fw={600} c="edr-text">
+                          Role profiles
+                        </Text>
+                        <ProfileChips profiles={profiles} />
+                      </Group>
+                      {/* Narrower than the old full-width layout — the table
+                          shares the row with the people column now. */}
+                      <Box style={{ overflowX: "auto" }} w="100%">
+                        <Box miw={760}>
+                          <DataTable
+                            columns={profileColumns}
+                            data={profiles}
+                            status="success"
+                            emptyMessage="No profiles registered."
+                            containerClassName="border-0 shadow-none bg-transparent"
+                          />
+                        </Box>
+                      </Box>
+                    </Stack>
+                  </Card>
+                </Stack>
+              </Grid.Col>
+
+              {/* People: owner, then power of attorney, then contact person —
+                  the order a reviewer checks them in. */}
+              <Grid.Col span={{ base: 12, lg: 4 }}>
+                <Stack gap="md">
+                  <PersonCard
+                    title="Owner"
+                    icon={<UserRound size={15} className="text-edr-muted" />}
+                    verified={Boolean(ownerIdentity?.verified)}
+                    badges={
+                      <>
+                        {identityState?.subject === "owner" && (
+                          <Badge size="xs" color="blue" variant="light">
+                            Verifies for this company
+                          </Badge>
+                        )}
+                        {identityState?.ownerMatchesEtrade === true && (
+                          <Badge size="xs" color="edr-green" variant="light">
+                            Matches eTrade licence
+                          </Badge>
+                        )}
+                      </>
+                    }
+                    notice={
+                      /* THE check: is the owner the company put forward the
+                         person the eTrade licence actually names? Advisory —
+                         eTrade and Fayda transliterate Amharic names
+                         differently, so this is a prompt to look, not a
+                         verdict. */
+                      identityState?.ownerMatchesEtrade === false ? (
+                        <Alert
+                          color="amber"
+                          variant="light"
+                          p="xs"
+                          icon={<AlertTriangle size={16} />}
+                          title="Does not match the eTrade licence"
+                        >
+                          <Text size="xs">
+                            The licence names{" "}
+                            <strong>{identityState.etradeManagerName}</strong>,
+                            but this company recorded{" "}
+                            <strong>{company.ownerName ?? "nobody"}</strong>.
+                          </Text>
+                        </Alert>
+                      ) : !ownerIdentity?.verified &&
+                        ownerIdentity?.passportNumber ? (
+                        <Text size="xs" c="dimmed">
+                          Identified by passport rather than Fayda.
+                        </Text>
+                      ) : null
+                    }
+                    fields={[
+                      {
+                        label: "Name",
+                        value: company.ownerName ?? ownerIdentity?.name,
+                      },
+                      {
+                        label: "Email",
+                        value: company.ownerEmail ?? ownerIdentity?.email,
+                      },
+                      {
+                        label: "Phone",
+                        value: company.ownerPhone ?? ownerIdentity?.phone,
+                      },
+                      {
+                        label: "Passport number",
+                        value: ownerIdentity?.passportNumber,
+                      },
+                      { label: "Address", value: ownerIdentity?.address },
+                      { label: "Birthdate", value: ownerIdentity?.birthdate },
+                      { label: "Gender", value: ownerIdentity?.gender },
+                      {
+                        label: "Verified on",
+                        value: ownerIdentity?.verifiedAt
+                          ? formatDate(ownerIdentity.verifiedAt)
+                          : null,
+                      },
+                    ]}
+                    emptyMessage="No owner recorded for this company."
+                  />
+
+                  <PersonCard
+                    title="Power of attorney"
+                    icon={<UserCheck size={15} className="text-edr-muted" />}
+                    verified={
+                      // No PoA at all → no badge, rather than a "not verified"
+                      // that reads as a problem where none exists.
+                      hasPoaDetails || identityState?.poaDeclared === "yes"
+                        ? Boolean(poaIdentity?.verified)
+                        : undefined
+                    }
+                    badges={
+                      <>
+                        {identityState?.subject === "poa" && (
+                          <Badge size="xs" color="blue" variant="light">
+                            Verifies for this company
+                          </Badge>
+                        )}
+                        {poaMandatory && (
+                          <Badge size="xs" color="blue" variant="light">
+                            Required for freight forwarder
+                          </Badge>
+                        )}
+                        {delegationMissing && (
+                          <Badge size="xs" color="red" variant="light">
+                            Delegation paper missing
+                          </Badge>
+                        )}
+                      </>
+                    }
+                    fields={[
+                      { label: "Name", value: company.poaName },
+                      { label: "Email", value: company.poaEmail },
+                      { label: "Phone", value: company.poaPhone },
+                      { label: "Location", value: company.poaLocation },
+                      { label: "Address", value: company.poaAddress },
+                      { label: "Birthdate", value: poaIdentity?.birthdate },
+                      { label: "Gender", value: poaIdentity?.gender },
+                      {
+                        label: "Verified on",
+                        value: poaIdentity?.verifiedAt
+                          ? formatDate(poaIdentity.verifiedAt)
+                          : null,
+                      },
+                    ]}
+                    emptyMessage="No representative recorded for this customer."
+                  >
+                    <Stack gap="xs">
+                      <Text size="xs" c="edr-muted">
+                        DARS delegation paper
+                      </Text>
+
+                      {documentsQuery.isLoading ? (
+                        <Group gap="xs">
+                          <Loader size="xs" />
+                          <Text size="sm" c="dimmed">
+                            Loading…
+                          </Text>
+                        </Group>
+                      ) : documentsQuery.isError ? (
+                        <Group gap="sm">
+                          <Text size="sm" c="red">
+                            Failed to load documents.
+                          </Text>
+                          <Anchor
+                            component="button"
+                            type="button"
+                            size="xs"
+                            onClick={() => void documentsQuery.refetch()}
+                          >
+                            Retry
+                          </Anchor>
+                        </Group>
+                      ) : poaDocuments.length === 0 ? (
+                        <Text size="sm" c="dimmed">
+                          Not uploaded.
+                        </Text>
+                      ) : (
+                        poaDocuments.map((doc) => (
+                          <Stack key={doc.id} gap={2}>
+                            <Group gap={6} wrap="nowrap">
+                              <Paperclip
+                                size={13}
+                                className="shrink-0 text-edr-muted"
+                              />
+                              <Anchor
+                                component="button"
+                                type="button"
+                                size="sm"
+                                lineClamp={1}
+                                style={{ flex: 1, textAlign: "left" }}
+                                onClick={() =>
+                                  openFileInNewTab(doc.id, doc.name)
+                                }
+                              >
+                                {doc.name}
+                              </Anchor>
+                              <ActionIcon
+                                size="sm"
+                                variant="subtle"
+                                color="gray"
+                                aria-label={`Preview ${doc.name}`}
+                                onClick={() =>
+                                  openFileInNewTab(doc.id, doc.name)
+                                }
+                              >
+                                <Eye size={15} />
+                              </ActionIcon>
+                              <ActionIcon
+                                size="sm"
+                                component="button"
+                                type="button"
+                                variant="subtle"
+                                color="gray"
+                                aria-label={`Download ${doc.name}`}
+                                onClick={() =>
+                                  void downloadBookingFile(doc.id, doc.name)
+                                }
+                              >
+                                <Download size={15} />
+                              </ActionIcon>
+                            </Group>
+                            <Group gap={6} pl={19} wrap="wrap">
+                              <Text size="xs" c="dimmed">
+                                {formatBytes(doc.size)} ·{" "}
+                                {formatDate(doc.uploadedAt)}
+                              </Text>
+                              {doc.code === POA_DELEGATION_PENDING_CODE && (
+                                <Badge size="xs" color="yellow" variant="light">
+                                  Pending approval
+                                </Badge>
+                              )}
+                            </Group>
+                          </Stack>
+                        ))
+                      )}
+                    </Stack>
+                  </PersonCard>
+
+                  <PersonCard
+                    title="Contact person"
+                    icon={<Contact size={15} className="text-edr-muted" />}
+                    fields={[
+                      { label: "Name", value: company.contactPersonName },
+                      { label: "Phone", value: company.contactPersonPhone },
+                    ]}
+                    emptyMessage="No contact person recorded."
+                  />
+                </Stack>
+              </Grid.Col>
+            </Grid>
           </Stack>
         </Tabs.Panel>
 
@@ -1144,6 +1249,9 @@ export default function CustomerDetailPage() {
               status={tableStatus(bookingsQuery)}
               emptyMessage="No bookings for this customer."
               containerClassName="border-0 shadow-none bg-transparent"
+              onRowClick={(row) =>
+                navigate(`/dashboard/booking-requests/${row.id}`)
+              }
               error={
                 bookingsQuery.isError
                   ? {
@@ -1156,9 +1264,50 @@ export default function CustomerDetailPage() {
           </TableCard>
         </Tabs.Panel>
 
+        {/* CONTRACTS */}
+        <Tabs.Panel value="contracts" pt="lg">
+          <TableCard minWidth={860}>
+            <DataTable
+              columns={contractColumns}
+              data={contracts}
+              status={tableStatus(contractsQuery)}
+              emptyMessage="No contracts for this customer."
+              containerClassName="border-0 shadow-none bg-transparent"
+              onRowClick={(row) =>
+                navigate(`/dashboard/contract-requests/${row.id}`)
+              }
+              error={
+                contractsQuery.isError
+                  ? {
+                    message: "Failed to load contracts.",
+                    onRetry: () => void contractsQuery.refetch(),
+                  }
+                  : undefined
+              }
+            />
+          </TableCard>
+        </Tabs.Panel>
+
         {/* DOCUMENTS */}
         <Tabs.Panel value="documents" pt="lg">
           <Stack gap="lg">
+            {/* Reviewing a customer means reading every document, so offer the
+                whole set at once — each opens in its own tab. The loop is
+                synchronous inside the click handler on purpose: that is what
+                keeps the browser treating all of them as user-initiated. */}
+            <Group justify="flex-end">
+              <Button
+                variant="light"
+                leftSection={<ExternalLink size={16} />}
+                disabled={documents.length === 0}
+                onClick={() =>
+                  documents.forEach((d) => openFileInNewTab(d.id, d.name))
+                }
+              >
+                Open all {documents.length > 0 && `(${documents.length})`}
+              </Button>
+            </Group>
+
             <TableCard minWidth={760}>
               <DataTable
                 columns={documentColumns}
@@ -1195,9 +1344,7 @@ export default function CustomerDetailPage() {
                             <Anchor
                               component="button"
                               type="button"
-                              onClick={() =>
-                                void fetchViewableFile(f.id, f.name).then(view)
-                              }
+                              onClick={() => openFileInNewTab(f.id, f.name)}
                               size="xs"
                               style={{
                                 textDecoration:
@@ -1303,7 +1450,6 @@ export default function CustomerDetailPage() {
         onClose={() => setChangeRequestDoc(null)}
       />
 
-      {viewer}
     </PageContainer>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/customers/CustomersPage.tsx b/apps/edr-freight-web/backoffice/src/pages/customers/CustomersPage.tsx
index 34f90ffff..3825f0165 100644
--- a/apps/edr-freight-web/backoffice/src/pages/customers/CustomersPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/customers/CustomersPage.tsx
@@ -5,13 +5,10 @@ import {
   Card,
   Group,
   SegmentedControl,
-  Select,
   Stack,
   Text,
-  TextInput,
   Tooltip,
 } from "@mantine/core";
-import { useDebouncedValue } from "@mantine/hooks";
 import { useQuery } from "@tanstack/react-query";
 import {
   Building2,
@@ -22,16 +19,16 @@ import {
   Mail,
   Phone,
   RefreshCw,
-  Search,
   ShieldOff,
   Users,
-  X,
 } from "lucide-react";
 import { useMemo, useState } from "react";
 import { useNavigate } from "react-router-dom";
 
 import {
+  CompanyNationalityBadge,
   CompanyStatusBadge,
+  ManualRegistrationBadge,
   ProfileChips,
   formatDate,
 } from "@/components/customers";
@@ -39,12 +36,8 @@ import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
 import { api } from "@/services/api";
 import type { Company, CompanyStatus } from "@/types/customer";
 import { isOnboardingDraft } from "@/types/customer";
-import {
-  DataTable,
-  DataTableFooter,
-  usePagination,
-  type ColumnDef,
-} from "@edr/ui-common";
+import { DataTable, DataTableFooter, type ColumnDef } from "@edr/ui-common";
+import { FilterBar, useFilters, type FilterDef } from "@/components/filters";
 
 /**
  * The list's segmented views. "Pending approval" means submitted-and-awaiting-
@@ -91,28 +84,29 @@ const SORT_OPTIONS = [
   { value: "name:DESC", label: "Name (Z–A)" },
 ] as const;
 
+/** No filter pills — search/sort/page are the only real filter dimensions;
+ * `view` below is a tab (mutually exclusive, navigational), not a filter. */
+const NO_FILTER_DEFS: FilterDef[] = [];
+
 export default function CustomersPage() {
   const navigate = useNavigate();
-  const { pagination, setPagination } = usePagination({ pageSize: 10 });
-  const [query, setQuery] = useState("");
-  const [debouncedQuery] = useDebouncedValue(query, 300);
   const [view, setView] = useState<CustomerView>("all");
-  const [sort, setSort] = useState<string>("review:DESC");
+  const controls = useFilters(NO_FILTER_DEFS, { defaultSort: "review:DESC", pageSize: 10 });
 
   const filter = useMemo(() => {
-    const [sortBy, sortOrder] = sort.split(":") as [
+    const [sortBy, sortOrder] = controls.sort.split(":") as [
       "review" | "name" | "createdAt" | "updatedAt",
       "ASC" | "DESC",
     ];
     return {
-      page: pagination.pageIndex + 1,
-      pageSize: pagination.pageSize,
-      search: debouncedQuery,
+      page: controls.page,
+      pageSize: controls.pageSize,
+      search: String(controls.params.search ?? ""),
       sortBy,
       sortOrder,
       ...VIEW_FILTERS[view],
     };
-  }, [pagination.pageIndex, pagination.pageSize, debouncedQuery, view, sort]);
+  }, [controls.page, controls.pageSize, controls.params.search, controls.sort, view]);
 
   const { data: stats } = useQuery(
     api.customers.stats.queryOptions({ input: {} }),
@@ -124,7 +118,6 @@ export default function CustomersPage() {
 
   const rows = data?.items ?? [];
   const total = data?.total ?? 0;
-  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
 
   const columns: ColumnDef<Company>[] = useMemo(
     () => [
@@ -146,14 +139,22 @@ export default function CustomersPage() {
               </Box>
               <div style={{ minWidth: 0 }}>
                 <Group gap={8} wrap="nowrap">
-                  <Text fw={600} c="edr-text" truncate>
+                  <Text fw={600} c="edr-text" truncate maw={200}>
                     {c.name}
                   </Text>
+                  <CompanyNationalityBadge nationality={c.nationality} />
+                  <ManualRegistrationBadge
+                    cooperative={c.cooperative}
+                    investorLicence={c.investorLicence}
+                  />
                 </Group>
                 <Text size="xs" c="dimmed">
                   TIN {c.tin}
                   {c.country ? ` · ${c.country}` : ""}
                 </Text>
+                <Box mt={4}>
+                  <CompanyStatusBadge status={c.status} />
+                </Box>
               </div>
             </Group>
           );
@@ -162,16 +163,9 @@ export default function CustomersPage() {
       {
         id: "profiles",
         header: "Profiles",
-        cell: ({ row }) => (
-          <ProfileChips profiles={row.original.companyProfiles} />
-        ),
-      },
-      {
-        id: "status",
-        header: "Status",
         cell: ({ row }) => {
-          // A draft's profiles are all `pending` by construction, so the
-          // "N pending" review hint would be a lie until they submit.
+          // A draft's profiles are all `pending` by construction — the
+          // status-colored chips would be a lie until they submit.
           if (isOnboardingDraft(row.original)) {
             return (
               <Tooltip label="Customer is still filling in the onboarding wizard">
@@ -181,23 +175,7 @@ export default function CustomersPage() {
               </Tooltip>
             );
           }
-          const pending = (row.original.companyProfiles ?? []).filter(
-            (p) => p.status === "pending",
-          ).length;
-          return (
-            <Group gap={6} wrap="nowrap">
-              <CompanyStatusBadge status={row.original.status} />
-              {pending > 0 ? (
-                <Tooltip
-                  label={`${pending} profile${pending > 1 ? "s" : ""} awaiting approval`}
-                >
-                  <Badge color="yellow" variant="light" size="sm" radius="sm">
-                    {pending} pending
-                  </Badge>
-                </Tooltip>
-              ) : null}
-            </Group>
-          );
+          return <ProfileChips profiles={row.original.companyProfiles} />;
         },
       },
       {
@@ -227,6 +205,7 @@ export default function CustomersPage() {
                   c="dimmed"
                   className="inline-flex items-center gap-1"
                   truncate
+                  maw={200}
                 >
                   <Mail size={12} /> {c.email}
                 </Text>
@@ -245,16 +224,6 @@ export default function CustomersPage() {
           </Text>
         ),
       },
-      {
-        id: "approved",
-        header: "Approved",
-        meta: { headerClassName: "text-right", cellClassName: "text-right" },
-        cell: ({ row }) => (
-          <Text size="sm" c="dimmed">
-            {row.original.approvedAt ? formatDate(row.original.approvedAt) : "—"}
-          </Text>
-        ),
-      },
     ],
     [],
   );
@@ -322,35 +291,24 @@ export default function CustomersPage() {
       <Card p={0}>
         <Stack gap={0}>
           <Box px="md" pt="md" pb="sm" w="100%">
-            <Group justify="space-between" gap="md" wrap="wrap">
-              <TextInput
-                placeholder="Search by company, TIN, email or profile reference…"
-                leftSection={<Search size={18} />}
-                value={query}
-                onChange={(e) => setQuery(e.target.value)}
-                rightSection={
-                  query ? (
-                    <ActionIcon
-                      size="sm"
-                      color="gray"
-                      radius="md"
-                      variant="transparent"
-                      onClick={() => setQuery("")}
-                    >
-                      <X size={16} />
-                    </ActionIcon>
-                  ) : null
-                }
-                style={{ flex: 1, minWidth: "240px" }}
-                radius="lg"
-              />
+            <FilterBar
+              defs={NO_FILTER_DEFS}
+              controls={controls}
+              searchPlaceholder="Search by company, TIN, email or profile reference…"
+              sortOptions={SORT_OPTIONS.map((o) => ({ ...o }))}
+              viewId="customers"
+            >
               <SegmentedControl
                 size="sm"
                 radius="md"
                 value={view}
                 onChange={(v) => {
+                  // `view` lives outside useFilters (it's a tab, not a
+                  // filter pill), so switching it needs its own page reset —
+                  // the same "stranded on page 5" hazard useFilters guards
+                  // against for its own filters.
                   setView(v as CustomerView);
-                  setPagination((prev) => ({ ...prev, pageIndex: 0 }));
+                  controls.setPage(1);
                 }}
                 data={[
                   { label: "All", value: "all" },
@@ -360,24 +318,7 @@ export default function CustomersPage() {
                   { label: "Active", value: "active" },
                 ]}
               />
-              <Select
-                size="sm"
-                radius="md"
-                w={160}
-                allowDeselect={false}
-                aria-label="Sort customers"
-                value={sort}
-                onChange={(v) => {
-                  if (!v) return;
-                  setSort(v);
-                  setPagination((prev) => ({ ...prev, pageIndex: 0 }));
-                }}
-                data={SORT_OPTIONS.map((o) => ({ ...o }))}
-              />
-              <Text size="sm" c="dimmed">
-                {total} record{total !== 1 ? "s" : ""}
-              </Text>
-            </Group>
+            </FilterBar>
           </Box>
 
           <Box style={{ overflowX: "auto" }} w="100%">
@@ -388,7 +329,7 @@ export default function CustomersPage() {
                 status={isLoading ? "loading" : isError ? "error" : "success"}
                 onRowClick={(row) => navigate(`/dashboard/customers/${row.id}`)}
                 emptyMessage={
-                  debouncedQuery
+                  controls.searchText
                     ? "No companies match your search."
                     : "No companies yet."
                 }
@@ -400,18 +341,7 @@ export default function CustomersPage() {
                     }
                     : undefined
                 }
-                pagination={{
-                  pageIndex: pagination.pageIndex,
-                  pageSize: pagination.pageSize,
-                  pageCount,
-                  totalCount: total,
-                }}
-                tableOptions={{
-                  state: { pagination },
-                  onPaginationChange: setPagination,
-                  manualPagination: true,
-                  pageCount,
-                }}
+                {...controls.tableProps(total)}
                 containerClassName="border-0 shadow-none bg-transparent"
                 footer={DataTableFooter}
               />
diff --git a/apps/edr-freight-web/backoffice/src/pages/dashboard/MyProfilePage.tsx b/apps/edr-freight-web/backoffice/src/pages/dashboard/MyProfilePage.tsx
index baf548d92..37f91909e 100644
--- a/apps/edr-freight-web/backoffice/src/pages/dashboard/MyProfilePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/dashboard/MyProfilePage.tsx
@@ -1,8 +1,12 @@
 import { MySignatureCard } from "@/components/profile/MySignatureCard";
+import { ChangePasswordCard } from "@/components/profile/ChangePasswordCard";
+import { ChangeEmailCard } from "@/components/profile/ChangeEmailCard";
 
 export default function MyProfilePage() {
   return (
     <div className="mx-auto w-full max-w-2xl space-y-6 p-4">
+      <ChangeEmailCard />
+      <ChangePasswordCard />
       <div id="signature">
         <MySignatureCard />
       </div>
diff --git a/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewDomainPage.tsx b/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewDomainPage.tsx
new file mode 100644
index 000000000..25ede8b4e
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewDomainPage.tsx
@@ -0,0 +1,145 @@
+import { useState } from "react";
+import { useParams } from "react-router-dom";
+import { AlertCircle, RefreshCw } from "lucide-react";
+import { ActionIcon, Alert, Button, Center, Loader, Paper, SegmentedControl, Skeleton, Stack } from "@mantine/core";
+
+import { PageContainer, PageHeader } from "@/components/page";
+import { OVERVIEW_DOMAINS } from "@/components/overview/overview-domains.config";
+import { OverviewBillingTabPanel } from "@/components/overview/tabs/OverviewBillingTabPanel";
+import { OverviewBookingsTabPanel } from "@/components/overview/tabs/OverviewBookingsTabPanel";
+import { OverviewContractsTabPanel } from "@/components/overview/tabs/OverviewContractsTabPanel";
+import { OverviewCustomersTabPanel } from "@/components/overview/tabs/OverviewCustomersTabPanel";
+import { OverviewFleetTabPanel } from "@/components/overview/tabs/OverviewFleetTabPanel";
+import { OverviewOperationsTabPanel } from "@/components/overview/tabs/OverviewOperationsTabPanel";
+import { OverviewStaffTabPanel } from "@/components/overview/tabs/OverviewStaffTabPanel";
+import {
+  useOverviewBillingTab,
+  useOverviewBookingsTab,
+  useOverviewContractsTab,
+  useOverviewCustomersTab,
+  useOverviewOperationsTab,
+  useOverviewStaffTab,
+} from "@/hooks/useOverview";
+import type { OverviewRange, OverviewTabKey } from "@/types/overview";
+
+const RANGE_OPTIONS = [
+  { label: "7 days", value: "7d" },
+  { label: "30 days", value: "30d" },
+  { label: "90 days", value: "90d" },
+];
+
+function DomainSkeleton() {
+  return (
+    <Stack gap="lg">
+      <Skeleton height={92} radius="lg" />
+      <Skeleton height={320} radius="lg" />
+      <Skeleton height={320} radius="lg" />
+    </Stack>
+  );
+}
+
+/**
+ * One domain's full depth — what used to be a tab panel on the overview page
+ * is now its own page, reached from that domain's "View all →" link. Same
+ * per-domain hooks and panel components as before; only the tab-switch
+ * wrapper (OverviewTabContent) is gone, replaced by a route param.
+ */
+export default function OverviewDomainPage() {
+  const { domain } = useParams<{ domain: OverviewTabKey }>();
+  const [range, setRange] = useState<OverviewRange>("30d");
+
+  const meta = OVERVIEW_DOMAINS.find((d) => d.key === domain);
+
+  const bookings = useOverviewBookingsTab(range, domain === "bookings");
+  const contracts = useOverviewContractsTab(range, domain === "contracts");
+  const billing = useOverviewBillingTab(range, domain === "billing");
+  // Fleet reuses the operations dataset — same query key, so switching between
+  // the two pages costs no extra fetch.
+  const operations = useOverviewOperationsTab(
+    range,
+    domain === "operations" || domain === "fleet",
+  );
+  const customers = useOverviewCustomersTab(range, domain === "customers");
+  const staff = useOverviewStaffTab(range, domain === "staff");
+
+  const query =
+    domain === "bookings"
+      ? bookings
+      : domain === "contracts"
+        ? contracts
+        : domain === "billing"
+          ? billing
+          : domain === "operations" || domain === "fleet"
+            ? operations
+            : domain === "customers"
+              ? customers
+              : staff;
+
+  const { isLoading, isError, refetch, isFetching } = query;
+
+  return (
+    <PageContainer>
+      <PageHeader
+        title={meta?.label ?? "Overview"}
+        subtitle={meta?.subtitle}
+        backTo="/dashboard/overview"
+        action={
+          <>
+            <SegmentedControl
+              value={range}
+              onChange={(value) => setRange(value as OverviewRange)}
+              data={RANGE_OPTIONS}
+              size="sm"
+              radius="lg"
+              color="edr-green"
+            />
+            <ActionIcon
+              variant="light"
+              color="edr-green"
+              size="lg"
+              radius="lg"
+              aria-label="Refresh"
+              onClick={() => void refetch()}
+              loading={isFetching && !isLoading}
+            >
+              <RefreshCw size={18} />
+            </ActionIcon>
+          </>
+        }
+      />
+
+      {isLoading ? (
+        <DomainSkeleton />
+      ) : isError || !query.data ? (
+        <Paper p="xl" radius="lg" withBorder>
+          <Alert icon={<AlertCircle size={16} />} color="red" title="Failed to load" variant="light">
+            <Stack gap="sm" align="flex-start">
+              <span>Could not load {meta?.label ?? "this"} metrics. Please try again.</span>
+              <Button size="xs" variant="light" color="red" onClick={() => void refetch()}>
+                Retry
+              </Button>
+            </Stack>
+          </Alert>
+        </Paper>
+      ) : (
+        <Stack gap="md" pos="relative">
+          {isFetching && (
+            <Center style={{ position: "absolute", top: 8, right: 8, zIndex: 2 }}>
+              <Loader size="sm" color="edr-green" />
+            </Center>
+          )}
+
+          {domain === "bookings" && bookings.data && <OverviewBookingsTabPanel data={bookings.data} />}
+          {domain === "contracts" && contracts.data && <OverviewContractsTabPanel data={contracts.data} />}
+          {domain === "billing" && billing.data && <OverviewBillingTabPanel data={billing.data} />}
+          {domain === "operations" && operations.data && (
+            <OverviewOperationsTabPanel data={operations.data} />
+          )}
+          {domain === "fleet" && operations.data && <OverviewFleetTabPanel data={operations.data} />}
+          {domain === "customers" && customers.data && <OverviewCustomersTabPanel data={customers.data} />}
+          {domain === "staff" && staff.data && <OverviewStaffTabPanel data={staff.data} />}
+        </Stack>
+      )}
+    </PageContainer>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewPage.tsx b/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewPage.tsx
index 12bce6aae..0d1f5a6e7 100644
--- a/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/dashboard/OverviewPage.tsx
@@ -1,145 +1,63 @@
-import { useState } from "react";
-import {
-  AlertCircle,
-  Banknote,
-  FileSignature,
-  FileText,
-  Train,
-  TrainFront,
-  UserCheck,
-  Users,
-} from "lucide-react";
-import {
-  Alert,
-  Badge,
-  Button,
-  Container,
-  Skeleton,
-  Stack,
-  Tabs,
-} from "@mantine/core";
+import { useState, type ReactElement } from "react";
+import { AlertCircle } from "lucide-react";
+import { Alert, Button, Skeleton, Stack } from "@mantine/core";
 import { useQueryClient } from "@tanstack/react-query";
 
 import { useAuth } from "@/auth/useAuth";
-import { OverviewPageHeader } from "@/components/overview/OverviewPageHeader";
-import { OverviewTabContent } from "@/components/overview/OverviewTabContent";
-import "@/components/overview/overview.css";
+import { PageContainer } from "@/components/page";
+import { ClearanceOverview } from "@/components/overview/layouts/ClearanceOverview";
+import { ExecutiveOverview } from "@/components/overview/layouts/ExecutiveOverview";
+import { FinanceOverview } from "@/components/overview/layouts/FinanceOverview";
+import { MarketingOverview } from "@/components/overview/layouts/MarketingOverview";
+import { OccOverview } from "@/components/overview/layouts/OccOverview";
+import { OperationsOverview } from "@/components/overview/layouts/OperationsOverview";
+import type { RoleOverviewProps } from "@/components/overview/layouts/layout-kit";
+import {
+  OVERVIEW_LAYOUT_LABEL,
+  resolveOverviewLayout,
+  type OverviewLayoutKey,
+} from "@/components/overview/role-dashboards.config";
+import { OverviewHero } from "@/components/overview/summary/OverviewHero";
+import { OverviewHeroKpis } from "@/components/overview/summary/OverviewHeroKpis";
 import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
 import { useOverview } from "@/hooks/useOverview";
-import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
-import type { OverviewRange, OverviewTabKey } from "@/types/overview";
+import type { OverviewRange } from "@/types/overview";
+import "@/components/overview/summary/overview-summary.css";
 
-const TAB_ITEMS: Array<{
-  value: OverviewTabKey;
-  label: string;
-  icon: typeof FileText;
-  kpiKey:
-    | "bookings"
-    | "contracts"
-    | "billing"
-    | "operations"
-    | "customers"
-    | "staff";
-  metricKey: string;
-  /** Any of these keys grants the tab. */
-  permission: string[];
-}> = [
-  {
-    value: "bookings",
-    label: "Bookings",
-    icon: FileText,
-    kpiKey: "bookings",
-    metricKey: "totalActive",
-    permission: [FREIGHT_PERMS.bookings.view],
-  },
-  {
-    value: "contracts",
-    label: "Contracts",
-    icon: FileSignature,
-    kpiKey: "contracts",
-    metricKey: "totalActive",
-    permission: [FREIGHT_PERMS.contracts.view],
-  },
-  {
-    value: "billing",
-    label: "Billing",
-    icon: Banknote,
-    kpiKey: "billing",
-    metricKey: "successfulPaymentsMtd",
-    permission: [FREIGHT_PERMS.bookings.view, FREIGHT_PERMS.payments.view],
-  },
-  {
-    value: "operations",
-    label: "Operations",
-    icon: Train,
-    kpiKey: "operations",
-    metricKey: "trainsActive",
-    permission: [
-      FREIGHT_PERMS.trainScheduling.view,
-      FREIGHT_PERMS.warehouseInventory.view,
-      FREIGHT_PERMS.firstMile.view,
-      FREIGHT_PERMS.lastMile.view,
-    ],
-  },
-  {
-    value: "fleet",
-    label: "Fleet",
-    icon: TrainFront,
-    kpiKey: "operations",
-    metricKey: "wagonsAvailable",
-    permission: [
-      FREIGHT_PERMS.fleet.view,
-      FREIGHT_PERMS.wagons.view,
-      FREIGHT_PERMS.trainScheduling.view,
-    ],
-  },
-  {
-    value: "customers",
-    label: "Customers",
-    icon: Users,
-    kpiKey: "customers",
-    metricKey: "totalCustomers",
-    permission: [FREIGHT_PERMS.customers.view],
-  },
-  {
-    value: "staff",
-    label: "Staff",
-    icon: UserCheck,
-    kpiKey: "staff",
-    metricKey: "activeEmployees",
-    permission: [
-      FREIGHT_PERMS.admin,
-      FREIGHT_PERMS.staff.roles.view,
-      FREIGHT_PERMS.staff.employeeRegistration.view,
-      FREIGHT_PERMS.staff.roleAssignment.view,
-    ],
-  },
-];
+const RANGE_LABEL: Record<OverviewRange, string> = { "7d": "7d", "30d": "30d", "90d": "90d" };
 
-function HeaderSkeleton() {
+/** Which composition each role sees below the hero. */
+const LAYOUTS: Record<OverviewLayoutKey, (props: RoleOverviewProps) => ReactElement> = {
+  executive: ExecutiveOverview,
+  operations: OperationsOverview,
+  occ: OccOverview,
+  marketing: MarketingOverview,
+  finance: FinanceOverview,
+  clearance: ClearanceOverview,
+};
+
+function OverviewSkeleton() {
   return (
-    <Stack gap="md">
-      <Skeleton height={48} radius="md" />
-      <Skeleton height={52} radius="lg" />
+    <Stack gap="lg">
+      <Skeleton height={92} radius="lg" />
+      <Skeleton height={340} radius="lg" />
+      <Skeleton height={340} radius="lg" />
+      <Skeleton height={340} radius="lg" />
     </Stack>
   );
 }
 
 const OverviewPage = () => {
   const [range, setRange] = useState<OverviewRange>("30d");
-  const [activeTab, setActiveTab] = useState<OverviewTabKey>("bookings");
   const queryClient = useQueryClient();
   const { user } = useAuth();
-  const { data: summary, isLoading, isError, error, refetch, isFetching } = useOverview(range);
+  const { data, isLoading, isError, error, refetch, isFetching } = useOverview(range);
+
+  // Hero, range control and headline KPIs are role-neutral; everything below
+  // them is chosen by role key.
+  const layoutKey = resolveOverviewLayout(user);
+  const RoleLayout = LAYOUTS[layoutKey];
 
-  // Permission-scoped view: only tabs the user may see; a restricted role
-  // (e.g. operations) gets a summary 403 — that is not a connection problem.
-  const visibleTabs = TAB_ITEMS.filter((tab) =>
-    tab.permission.some((key) => hasPermission(user, key)),
-  );
-  const currentTab = visibleTabs.some((t) => t.value === activeTab)
-    ? activeTab
-    : visibleTabs[0]?.value;
   const accessDenied =
     (error as { response?: { status?: number } } | null)?.response?.status === 403;
 
@@ -148,97 +66,61 @@ const OverviewPage = () => {
     void queryClient.invalidateQueries({ queryKey: QUERY_KEYS.OVERVIEW.ROOT });
   };
 
-  const getTabBadge = (tab: (typeof TAB_ITEMS)[number]) => {
-    if (!summary?.kpis) return 0;
-    const group = summary.kpis[tab.kpiKey] as unknown as Record<string, number>;
-    return group[tab.metricKey] ?? 0;
-  };
-
   return (
-    <Container fluid px="md" py="md">
-      <Stack gap="lg">
-        {isLoading && !summary ? (
-          <HeaderSkeleton />
-        ) : (
-          <OverviewPageHeader
-            range={range}
-            onRangeChange={setRange}
-            generatedAt={summary?.generatedAt}
-            onRefresh={handleRefresh}
-            isRefreshing={isFetching && !isLoading}
-          />
-        )}
+    <PageContainer>
+      {/* Gradient greeting hero; the KPI strip overlaps its bottom edge. */}
+      <div className="ov-band">
+        <OverviewHero
+          range={range}
+          onRangeChange={setRange}
+          generatedAt={data?.generatedAt}
+          onRefresh={handleRefresh}
+          isRefreshing={isFetching && !isLoading}
+          label={OVERVIEW_LAYOUT_LABEL[layoutKey]}
+        />
+        {data ? (
+          <div style={{ marginTop: -52, paddingInline: 20, position: "relative" }}>
+            <OverviewHeroKpis
+              kpis={data.kpis}
+              current={data.current}
+              previous={data.previous}
+              rangeLabel={RANGE_LABEL[range]}
+            />
+          </div>
+        ) : null}
+      </div>
 
-        {isError && !accessDenied && (
-          <Alert
-            icon={<AlertCircle size={16} />}
-            color="red"
-            title="Unable to load dashboard summary"
-            variant="light"
-          >
-            <Stack gap="sm" align="flex-start">
-              <span>Check your connection and try again.</span>
-              <Button size="xs" variant="light" color="red" onClick={() => void refetch()}>
-                Retry
-              </Button>
-            </Stack>
-          </Alert>
-        )}
+      {isError && !accessDenied && (
+        <Alert
+          icon={<AlertCircle size={16} />}
+          color="red"
+          title="Unable to load dashboard summary"
+          variant="light"
+          mt="lg"
+        >
+          <Stack gap="sm" align="flex-start">
+            <span>Check your connection and try again.</span>
+            <Button size="xs" variant="light" color="red" onClick={() => void refetch()}>
+              Retry
+            </Button>
+          </Stack>
+        </Alert>
+      )}
 
-        {visibleTabs.length === 0 && !isLoading && !isError && (
-          <Alert color="gray" variant="light" title="No dashboard sections available">
-            Your role has no access to any overview section.
-          </Alert>
-        )}
+      {accessDenied && (
+        <Alert color="gray" variant="light" title="No dashboard access" mt="lg">
+          Your role has no access to the overview.
+        </Alert>
+      )}
 
-        {visibleTabs.length > 0 && (
-          <Tabs
-            value={currentTab}
-            onChange={(value) =>
-              setActiveTab((value as OverviewTabKey) ?? visibleTabs[0].value)
-            }
-            variant="pills"
-            color="edr-green"
-            keepMounted={false}
-            classNames={{ list: "ov-tablist", tab: "ov-tab" }}
-          >
-            <Tabs.List>
-              {visibleTabs.map((tab) => {
-                const Icon = tab.icon;
-                const isActive = currentTab === tab.value;
-                return (
-                  <Tabs.Tab
-                    key={tab.value}
-                    value={tab.value}
-                    leftSection={<Icon size={17} />}
-                    rightSection={
-                      summary ? (
-                        <Badge
-                          size="sm"
-                          radius="sm"
-                          variant={isActive ? "white" : "light"}
-                          color={isActive ? "edr-green" : "gray"}
-                        >
-                          {getTabBadge(tab)}
-                        </Badge>
-                      ) : undefined
-                    }
-                  >
-                    {tab.label}
-                  </Tabs.Tab>
-                );
-              })}
-            </Tabs.List>
-
-            {visibleTabs.map((tab) => (
-              <Tabs.Panel key={tab.value} value={tab.value} pt="lg">
-                <OverviewTabContent tab={tab.value} range={range} />
-              </Tabs.Panel>
-            ))}
-          </Tabs>
-        )}
-      </Stack>
-    </Container>
+      {isLoading && !data ? (
+        <Stack mt="lg">
+          <OverviewSkeleton />
+        </Stack>
+      ) : data ? (
+        <RoleLayout data={data} range={range} />
+      ) : null}
+    </PageContainer>
   );
 };
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/CompliancePage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/CompliancePage.tsx
index f31bf5e76..9cb305bbb 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/CompliancePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/CompliancePage.tsx
@@ -18,11 +18,16 @@ import {
 } from "@mantine/core";
 import { Plus, AlertTriangle } from "lucide-react";
 import Breadcrumbs from "@/components/ui/Breadcrumbs";
-import ListControls from "@/components/common/ListControls";
 // Generic list footer — already shared by the fleet and train-scheduling lists
 // despite the ruleEngine path.
 import RuleEngineListFooter from "@/components/ruleEngine/RuleEngineListFooter";
-import { useListControls } from "@/hooks/useListControls";
+import {
+  applyClientFilters,
+  FilterBar,
+  toRuleEngineFooterProps,
+  useFilters,
+  type FilterDef,
+} from "@/components/filters";
 import { useToast } from "@/hooks/use-toast";
 import {
   complianceService,
@@ -52,6 +57,8 @@ const statusColor = (status: ComplianceRecord["status"]) => {
 const formatDate = (value?: string | null) =>
   value ? new Date(value).toLocaleDateString() : "—";
 
+const COMPLIANCE_FILTER_DEFS: FilterDef[] = [{ key: "expiryDate", label: "Expiry", type: "date" }];
+
 const emptyForm = {
   vehicleId: "",
   type: "INSPECTION" as ComplianceType,
@@ -91,10 +98,18 @@ export default function CompliancePage() {
     },
   });
 
-  const controls = useListControls(records as ComplianceRecord[], {
-    searchKeys: ["type", "status", "documentNumber"],
-    dateKey: "expiryDate",
-  });
+  const controls = useFilters(COMPLIANCE_FILTER_DEFS, { pageSize: 10 });
+  const filteredRecords = applyClientFilters(
+    records as ComplianceRecord[],
+    COMPLIANCE_FILTER_DEFS,
+    controls.values,
+    controls.searchText,
+    { searchKeys: ["type", "status", "documentNumber"] },
+  );
+  const pagedRecords = filteredRecords.slice(
+    (controls.page - 1) * controls.pageSize,
+    controls.page * controls.pageSize,
+  );
 
   const createMutation = useMutation({
     mutationFn: async (data: typeof formData) => {
@@ -220,17 +235,11 @@ export default function CompliancePage() {
         Compliance Records
       </Title>
       <Card withBorder>
-        <ListControls
-          search={controls.search}
-          onSearchChange={controls.setSearch}
+        <FilterBar
+          defs={COMPLIANCE_FILTER_DEFS}
+          controls={controls}
           searchPlaceholder="Search type, status, document no…"
-          dateFrom={controls.dateFrom}
-          onDateFromChange={controls.setDateFrom}
-          dateTo={controls.dateTo}
-          onDateToChange={controls.setDateTo}
-          dateLabel="Expiry"
-          hasFilters={controls.hasFilters}
-          onReset={controls.reset}
+          viewId="fleet-compliance"
         />
         <Table striped highlightOnHover>
           <Table.Thead>
@@ -261,7 +270,7 @@ export default function CompliancePage() {
                 </Table.Td>
               </Table.Tr>
             ) : null}
-            {controls.pagedRows.map((record) => (
+            {pagedRecords.map((record) => (
               <Table.Tr key={record.id}>
                 <Table.Td>{vehicleLabel(record)}</Table.Td>
                 <Table.Td>
@@ -282,11 +291,8 @@ export default function CompliancePage() {
           </Table.Tbody>
         </Table>
         <RuleEngineListFooter
-          pagination={controls.pagination}
-          pageCount={controls.pageCount}
-          totalCount={controls.totalCount}
           itemLabel="records"
-          onPaginationChange={controls.setPagination}
+          {...toRuleEngineFooterProps(controls, filteredRecords.length)}
         />
       </Card>
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/DriverDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/DriverDetailPage.tsx
index 3633b1942..9e8105c54 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/DriverDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/DriverDetailPage.tsx
@@ -43,17 +43,13 @@ import {
   fetchViewableFile,
 } from "@/services/files.service";
 import { useToast } from "@/hooks/use-toast";
+import { formatDateTime } from "@/lib/format";
 
 const fmtDate = (iso?: string | null) => {
   if (!iso) return "—";
   const d = new Date(iso);
   return Number.isNaN(d.getTime()) ? "—" : d.toLocaleDateString();
 };
-const fmtDateTime = (iso?: string | null) => {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime()) ? "—" : d.toLocaleString();
-};
 const meta = (e: FleetHistoryEvent, k: string) => {
   const v = e.metadata?.[k];
   return typeof v === "string" && v ? v : null;
@@ -400,7 +396,7 @@ const VehiclesTab = ({ driverId }: { driverId: string }) => {
             {rows.map((r) => (
               <Table.Tr key={r.id}>
                 <Table.Td>{r.plate}</Table.Td>
-                <Table.Td>{fmtDateTime(r.at)}</Table.Td>
+                <Table.Td>{formatDateTime(r.at)}</Table.Td>
               </Table.Tr>
             ))}
           </Table.Tbody>
@@ -425,7 +421,7 @@ const HistoryTab = ({ driverId }: { driverId: string }) => {
                 .join(" · ")}
             </Text>
           )}
-          <Text size="xs" c="dimmed" mt={2}>{fmtDateTime(e.createdAt)}</Text>
+          <Text size="xs" c="dimmed" mt={2}>{formatDateTime(e.createdAt)}</Text>
         </Timeline.Item>
       ))}
     </Timeline>
@@ -471,7 +467,7 @@ const TripsTab = ({ driverId }: { driverId: string }) => {
                   <Table.Td>{t.booking}</Table.Td>
                   <Table.Td>{t.vehicle}</Table.Td>
                   <Table.Td>{t.status}</Table.Td>
-                  <Table.Td>{fmtDateTime(t.at)}</Table.Td>
+                  <Table.Td>{formatDateTime(t.at)}</Table.Td>
                 </Table.Tr>
               ))}
             </Table.Tbody>
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/FleetCrudPages.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/FleetCrudPages.tsx
index 74ea2c3eb..cf86434ea 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/FleetCrudPages.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/FleetCrudPages.tsx
@@ -1,5 +1,5 @@
 import { useMutation, useQuery } from '@tanstack/react-query';
-import { Edit, Eye, Plus, Search, Trash2 } from 'lucide-react';
+import { Edit, Eye, Plus, Trash2 } from 'lucide-react';
 import { FormEvent, ReactNode, useMemo, useState } from 'react';
 
 import { api } from '@/services/api';
@@ -44,6 +44,13 @@ import type { Train } from '@/services/trains.service';
 import type { WagonType } from '@/services/wagon-types.service';
 import type { Wagon } from '@/services/wagon.service';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@edr/ui-common';
+import {
+    applyClientFilters,
+    FilterBar,
+    useFilters,
+    type FilterDef,
+    type FilterOption,
+} from '@/components/filters';
 
 type FormValue = string | number | boolean | string[];
 
@@ -86,6 +93,8 @@ type FleetCrudPageProps<T extends { id: string }> = {
   hideViewAction?: boolean;
   /** Optional custom actions rendered before the view/edit/delete buttons in each row. */
   rowActions?: (item: T) => React.ReactNode;
+  /** Enables the Status filter pill; the item's `status` field is matched against these. */
+  statusOptions?: FilterOption[];
 };
 
 const normalizePayload = (values: Record<string, FormValue>) =>
@@ -172,9 +181,16 @@ function FleetCrudPage<T extends { id: string }>({
   removeSuccessMessage,
   hideViewAction = false,
   rowActions,
+  statusOptions,
 }: FleetCrudPageProps<T>) {
-  const [search, setSearch] = useState('');
-  const [page, setPage] = useState(1);
+  const filterDefs: FilterDef[] = useMemo(
+    () =>
+      statusOptions
+        ? [{ key: 'status', label: 'Status', type: 'enum', multiple: false, options: statusOptions }]
+        : [],
+    [statusOptions],
+  );
+  const controls = useFilters(filterDefs, { pageSize: 10 });
   const [sortKey, setSortKey] = useState<string>('');
   const [sortDirection, setSortDirection] = useState<'asc' | 'desc'>('asc');
   const [formOpen, setFormOpen] = useState(false);
@@ -184,11 +200,13 @@ function FleetCrudPage<T extends { id: string }>({
   const [fieldErrors, setFieldErrors] = useState<Record<string, string>>({});
   const { toast } = useToast();
 
-  const filtered = useMemo(() => {
-    const query = search.trim().toLowerCase();
-    if (!query) return data ?? [];
-    return (data ?? []).filter((item) => searchText(item).toLowerCase().includes(query));
-  }, [data, search, searchText]);
+  const filtered = useMemo(
+    () =>
+      applyClientFilters(data ?? [], filterDefs, controls.values, controls.searchText, {
+        searchValue: searchText,
+      }),
+    [data, filterDefs, controls.values, controls.searchText, searchText],
+  );
   const sorted = useMemo(() => {
     if (!sortKey) return filtered;
     return [...filtered].sort((a, b) => {
@@ -198,12 +216,13 @@ function FleetCrudPage<T extends { id: string }>({
       return sortDirection === 'asc' ? result : -result;
     });
   }, [filtered, sortDirection, sortKey]);
-  const pageSize = 10;
+  const pageSize = controls.pageSize;
+  const page = controls.page;
   const pageCount = Math.max(1, Math.ceil(sorted.length / pageSize));
   const paged = sorted.slice((page - 1) * pageSize, page * pageSize);
 
   const toggleSort = (key: string) => {
-    setPage(1);
+    controls.setPage(1);
     if (sortKey === key) {
       setSortDirection((current) => (current === 'asc' ? 'desc' : 'asc'));
       return;
@@ -298,18 +317,11 @@ function FleetCrudPage<T extends { id: string }>({
         </Button>
       </div>
 
-      <div className="flex max-w-md items-center gap-2 rounded-md border bg-background px-3">
-        <Search className="size-4 text-muted-foreground" />
-        <Input
-          className="border-0 px-0 shadow-none focus-visible:ring-0"
-          placeholder={`Search ${title.toLowerCase()}`}
-          value={search}
-          onChange={(event) => {
-            setSearch(event.target.value);
-            setPage(1);
-          }}
-        />
-      </div>
+      <FilterBar
+        defs={filterDefs}
+        controls={controls}
+        searchPlaceholder={`Search ${title.toLowerCase()}`}
+      />
 
       <div className="overflow-hidden rounded-lg border bg-card">
         <Table>
@@ -379,10 +391,10 @@ function FleetCrudPage<T extends { id: string }>({
           Showing {sorted.length === 0 ? 0 : (page - 1) * pageSize + 1}-{Math.min(page * pageSize, sorted.length)} of {sorted.length}
         </span>
         <div className="flex gap-2">
-          <Button variant="outline" size="sm" disabled={page === 1} onClick={() => setPage((current) => current - 1)}>
+          <Button variant="outline" size="sm" disabled={page === 1} onClick={() => controls.setPage(page - 1)}>
             Previous
           </Button>
-          <Button variant="outline" size="sm" disabled={page === pageCount} onClick={() => setPage((current) => current + 1)}>
+          <Button variant="outline" size="sm" disabled={page === pageCount} onClick={() => controls.setPage(page + 1)}>
             Next
           </Button>
         </div>
@@ -487,6 +499,47 @@ const statusBadge = (status?: string) => <Badge variant="outline">{status ?? '-'
 const optionLabel = (options: { value: string; label: string }[], value?: string | null) =>
   options.find((option) => option.value === value)?.label ?? value ?? '-';
 
+const TRAIN_STATUS_OPTIONS: FilterOption[] = [
+  { value: 'AVAILABLE', label: 'Available' },
+  { value: 'SCHEDULED', label: 'Scheduled' },
+  { value: 'IN_SERVICE', label: 'In service' },
+  { value: 'UNDER_MAINTENANCE', label: 'Under maintenance' },
+  { value: 'OUT_OF_SERVICE', label: 'Out of service' },
+  { value: 'DEACTIVATED', label: 'Deactivated' },
+];
+
+const WAGON_STATUS_OPTIONS: FilterOption[] = [
+  { value: 'AVAILABLE', label: 'Available' },
+  { value: 'IMPORT_READY', label: 'Import ready' },
+  { value: 'EXPORT_READY', label: 'Export ready' },
+  { value: 'ASSIGNED', label: 'Assigned' },
+  { value: 'MAINTENANCE', label: 'Maintenance' },
+  { value: 'DETAINED', label: 'Detained' },
+];
+
+const CONTAINER_STATUS_OPTIONS: FilterOption[] = [
+  { value: 'AVAILABLE', label: 'Available' },
+  { value: 'LOADED', label: 'Loaded' },
+  { value: 'IN_TRANSIT', label: 'In transit' },
+  { value: 'MAINTENANCE', label: 'Maintenance' },
+  { value: 'DAMAGED', label: 'Damaged' },
+];
+
+const CARGO_STATUS_OPTIONS: FilterOption[] = [
+  { value: 'PENDING', label: 'Pending' },
+  { value: 'LOADED', label: 'Loaded' },
+  { value: 'IN_TRANSIT', label: 'In transit' },
+  { value: 'DELIVERED', label: 'Delivered' },
+  { value: 'UNLOADED', label: 'Unloaded' },
+];
+
+const LOCOMOTIVE_STATUS_OPTIONS: FilterOption[] = [
+  { value: 'AVAILABLE', label: 'Available' },
+  { value: 'MAINTENANCE', label: 'Maintenance' },
+  { value: 'ASSIGNED', label: 'Assigned' },
+  { value: 'OUT_OF_SERVICE', label: 'Out of service' },
+];
+
 export function TrainMasterDataPage() {
   const query = useQuery(api.trains.list.queryOptions());
   return (
@@ -499,6 +552,7 @@ export function TrainMasterDataPage() {
       create={useMutation(api.trains.create.mutationOptions())}
       update={useMutation(api.trains.update.mutationOptions())}
       remove={useMutation(api.trains.remove.mutationOptions())}
+      statusOptions={TRAIN_STATUS_OPTIONS}
       searchText={(train) => [train.code, train.trainNumber, train.trainName, train.status].join(' ')}
       columns={[
         { key: 'code', label: 'Code' },
@@ -522,14 +576,17 @@ export function TrainMasterDataPage() {
   );
 }
 
+const WAGON_TYPE_FILTER_DEFS: FilterDef[] = [
+  { key: 'isActive', label: 'Status', type: 'boolean', trueLabel: 'Active', falseLabel: 'Inactive' },
+];
+
 export function WagonTypesCrudPage() {
   const query = useQuery(api.wagonTypes.list.queryOptions());
   const create = useMutation(api.wagonTypes.create.mutationOptions());
   const update = useMutation(api.wagonTypes.update.mutationOptions());
   const remove = useMutation(api.wagonTypes.remove.mutationOptions());
   const { toast } = useToast();
-  const [search, setSearch] = useState('');
-  const [page, setPage] = useState(1);
+  const controls = useFilters(WAGON_TYPE_FILTER_DEFS, { pageSize: 10 });
   const [sortKey, setSortKey] = useState<keyof WagonType>('code');
   const [sortDirection, setSortDirection] = useState<'asc' | 'desc'>('asc');
   const [formOpen, setFormOpen] = useState(false);
@@ -546,18 +603,15 @@ export function WagonTypesCrudPage() {
   });
   const [fieldErrors, setFieldErrors] = useState<Record<string, string>>({});
 
-  const pageSize = 10;
-  const filtered = useMemo(() => {
-    const queryText = search.trim().toLowerCase();
-    const rows = query.data ?? [];
-    if (!queryText) return rows;
-    return rows.filter((type) =>
-      [type.code, type.name, type.supportedLoadTypes?.join(' '), type.isActive ? 'active' : 'inactive']
-        .join(' ')
-        .toLowerCase()
-        .includes(queryText),
-    );
-  }, [query.data, search]);
+  const pageSize = controls.pageSize;
+  const page = controls.page;
+  const filtered = useMemo(
+    () =>
+      applyClientFilters(query.data ?? [], WAGON_TYPE_FILTER_DEFS, controls.values, controls.searchText, {
+        searchValue: (type) => [type.code, type.name, type.supportedLoadTypes?.join(' ')].join(' '),
+      }),
+    [query.data, controls.values, controls.searchText],
+  );
 
   const sorted = useMemo(() => {
     return [...filtered].sort((left, right) => {
@@ -573,7 +627,7 @@ export function WagonTypesCrudPage() {
   const isSaving = create.isPending || update.isPending;
 
   const toggleSort = (key: keyof WagonType) => {
-    setPage(1);
+    controls.setPage(1);
     if (sortKey === key) {
       setSortDirection((current) => (current === 'asc' ? 'desc' : 'asc'));
       return;
@@ -689,16 +743,7 @@ export function WagonTypesCrudPage() {
           </MantineButton>
         </Group>
 
-        <TextInput
-          maw={420}
-          leftSection={<Search size={16} />}
-          placeholder="Search wagon types"
-          value={search}
-          onChange={(event) => {
-            setSearch(event.currentTarget.value);
-            setPage(1);
-          }}
-        />
+        <FilterBar defs={WAGON_TYPE_FILTER_DEFS} controls={controls} searchPlaceholder="Search wagon types" />
 
         <Paper withBorder radius="md">
           <ScrollArea>
@@ -789,7 +834,7 @@ export function WagonTypesCrudPage() {
             Showing {sorted.length === 0 ? 0 : (page - 1) * pageSize + 1}-{Math.min(page * pageSize, sorted.length)} of{' '}
             {sorted.length}
           </Text>
-          <Pagination total={pageCount} value={page} onChange={setPage} size="sm" />
+          <Pagination total={pageCount} value={page} onChange={controls.setPage} size="sm" />
         </Group>
       </Stack>
 
@@ -906,6 +951,7 @@ export function WagonsCrudPage() {
       create={useMutation(api.wagons.create.mutationOptions())}
       update={useMutation(api.wagons.update.mutationOptions())}
       remove={useMutation(api.wagons.remove.mutationOptions())}
+      statusOptions={WAGON_STATUS_OPTIONS}
       searchText={(wagon) => [
         wagon.wagonNumber,
         wagon.wagonTypeId,
@@ -959,14 +1005,7 @@ export function WagonsCrudPage() {
           key: 'status',
           label: 'Status',
           type: 'select',
-          options: [
-            { value: 'AVAILABLE', label: 'Available' },
-            { value: 'IMPORT_READY', label: 'Import ready' },
-            { value: 'EXPORT_READY', label: 'Export ready' },
-            { value: 'ASSIGNED', label: 'Assigned' },
-            { value: 'MAINTENANCE', label: 'Maintenance' },
-            { value: 'DETAINED', label: 'Detained' },
-          ],
+          options: WAGON_STATUS_OPTIONS,
         },
         { key: 'notes', label: 'Notes' },
       ]}
@@ -999,6 +1038,7 @@ export function ContainersCrudPage() {
       create={useMutation(api.containers.create.mutationOptions())}
       update={useMutation(api.containers.update.mutationOptions())}
       remove={useMutation(api.containers.remove.mutationOptions())}
+      statusOptions={CONTAINER_STATUS_OPTIONS}
       searchText={(container) => [container.containerNumber, container.containerTypeId, container.wagonId, container.status].join(' ')}
       columns={[
         { key: 'containerNumber', label: 'Number' },
@@ -1058,6 +1098,7 @@ export function CargoesCrudPage() {
       create={useMutation(api.cargoes.create.mutationOptions())}
       update={useMutation(api.cargoes.update.mutationOptions())}
       remove={useMutation(api.cargoes.remove.mutationOptions())}
+      statusOptions={CARGO_STATUS_OPTIONS}
       searchText={(cargo) => [cargo.cargoReference, cargo.description, cargo.containerId, cargo.status].join(' ')}
       columns={[
         { key: 'cargoReference', label: 'Reference' },
@@ -1122,6 +1163,7 @@ export function LocomotivesCrudPage() {
       removeActionLabel="Decommission"
       removeConfirmMessage="Decommission this locomotive?"
       removeSuccessMessage="Locomotive decommissioned"
+      statusOptions={LOCOMOTIVE_STATUS_OPTIONS}
       searchText={(locomotive) =>
         [
           locomotive.code,
@@ -1166,12 +1208,7 @@ export function LocomotivesCrudPage() {
           label: 'Status',
           type: 'select',
           required: true,
-          options: [
-            { value: 'AVAILABLE', label: 'Available' },
-            { value: 'MAINTENANCE', label: 'Maintenance' },
-            { value: 'ASSIGNED', label: 'Assigned' },
-            { value: 'OUT_OF_SERVICE', label: 'Out of service' },
-          ],
+          options: LOCOMOTIVE_STATUS_OPTIONS,
         },
         { key: 'maxPullWeightTons', label: 'Max pulling weight (tons)', type: 'number', required: true },
         { key: 'maxTrainLengthMeters', label: 'Max train length (meters)', type: 'number', required: true },
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/FleetResourcePage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/FleetResourcePage.tsx
index 6bea10a8c..23dc6b76b 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/FleetResourcePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/FleetResourcePage.tsx
@@ -1,6 +1,5 @@
 import type { ColumnDef } from "@edr/ui-common";
-import { Box, Button, Card, Container, Group, Modal, Select, Stack, Text, TextInput, Title } from "@mantine/core";
-import { DatePickerInput } from "@mantine/dates";
+import { Box, Button, Card, Container, Group, Modal, SegmentedControl, Select, Stack, Text, TextInput, Title } from "@mantine/core";
 import { keepPreviousData, useMutation, useQuery } from "@tanstack/react-query";
 
 import { api } from "@/services/api";
@@ -12,7 +11,7 @@ import {
   FREIGHT_PERMS,
 } from "@/lib/permissions";
 import Breadcrumbs from "@/components/ui/Breadcrumbs";
-import { Inbox, Plus, Warehouse } from "lucide-react";
+import { Inbox, LayoutGrid, Plus, Table2, Warehouse } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 import { Link, Navigate, useLocation } from "react-router-dom";
 
@@ -20,13 +19,12 @@ import FleetCardGrid from "@/components/fleet/FleetCardGrid";
 import FleetFormDialog from "@/components/fleet/FleetFormDialog";
 import FleetHistoryModal from "@/components/fleet/FleetHistoryModal";
 import FleetRecordActions from "@/components/fleet/FleetRecordActions";
-import FleetToolbar from "@/components/fleet/FleetToolbar";
 import { matchesDayRange } from "@/hooks/useListControls";
 import WagonMovementHistoryModal from "@/components/fleet/WagonMovementHistoryModal";
 import WagonStatusActions from "@/components/wagons/WagonStatusActions";
 import WagonYardWorkspaceModal from "@/components/wagons/WagonYardWorkspaceModal";
 import { formatFleetCell, registerFleetOptionLabels } from "@/components/fleet/fleetFormat";
-import { useFleetViewMode } from "@/components/fleet/useFleetViewMode";
+import { useFleetViewMode, type FleetViewMode } from "@/components/fleet/useFleetViewMode";
 import { ruleEngineTable } from "@/components/ruleEngine/ruleEngineStyles";
 import { useToast } from "@/hooks/use-toast";
 import {
@@ -42,11 +40,46 @@ import {
   type FleetListFilters,
   type FleetRecord,
 } from "@/services/fleet/fleet.service";
-import { DataTable, DataTableFooter, usePagination } from "@edr/ui-common";
-import { useDebouncedValue } from "@mantine/hooks";
+import { DataTable, DataTableFooter } from "@edr/ui-common";
+import { dateRangeParams, FilterBar, useFilters, type FilterDef, type FilterOption } from "@/components/filters";
 
 const DEFAULT_SLUG: FleetResourceSlug = "locomotives";
 
+const SERVER_FILTERED_SLUGS: FleetResourceSlug[] = ["wagons", "locomotives", "vehicles", "drivers"];
+
+// trains/containers/cargoes have no server-side `listFilters` config (see
+// resources.ts) — they get a plain client-only Status filter instead, off a
+// fixed enum rather than "whatever status happens to exist in the currently
+// loaded rows" (which would create a circular dependency: filterDefs feeds
+// useFilters, which feeds the query that produces those rows).
+const TRAIN_STATUS_OPTIONS: FilterOption[] = [
+  { value: "AVAILABLE", label: "Available" },
+  { value: "SCHEDULED", label: "Scheduled" },
+  { value: "IN_SERVICE", label: "In service" },
+  { value: "UNDER_MAINTENANCE", label: "Under maintenance" },
+  { value: "OUT_OF_SERVICE", label: "Out of service" },
+  { value: "DEACTIVATED", label: "Deactivated" },
+];
+const CONTAINER_STATUS_OPTIONS: FilterOption[] = [
+  { value: "AVAILABLE", label: "Available" },
+  { value: "LOADED", label: "Loaded" },
+  { value: "IN_TRANSIT", label: "In transit" },
+  { value: "MAINTENANCE", label: "Maintenance" },
+  { value: "DAMAGED", label: "Damaged" },
+];
+const CARGO_STATUS_OPTIONS: FilterOption[] = [
+  { value: "PENDING", label: "Pending" },
+  { value: "LOADED", label: "Loaded" },
+  { value: "IN_TRANSIT", label: "In transit" },
+  { value: "DELIVERED", label: "Delivered" },
+  { value: "UNLOADED", label: "Unloaded" },
+];
+const FALLBACK_STATUS_OPTIONS: Partial<Record<FleetResourceSlug, FilterOption[]>> = {
+  trains: TRAIN_STATUS_OPTIONS,
+  containers: CONTAINER_STATUS_OPTIONS,
+  cargoes: CARGO_STATUS_OPTIONS,
+};
+
 const FleetResourcePage = () => {
   const location = useLocation();
   const slug = getFleetSlugFromPath(location.pathname) ?? DEFAULT_SLUG;
@@ -69,18 +102,9 @@ const FleetResourcePage = () => {
     hasPermission(user, FREIGHT_PERMS.wagons.transferFulfill) ||
     hasPermission(user, FREIGHT_PERMS.wagons.transferHistoryAll);
 
-  const { pagination, setPagination } = usePagination({ pageSize: 10 });
-  const [search, setSearch] = useState("");
-  const [debouncedSearch] = useDebouncedValue(search, 300);
   // Wagons and locomotives page in the database; the rest still list in full
   // and page in the browser (see `pagedHandlers` in fleet.service).
   const serverPaged = isFleetServerPaginated(slug);
-  const [statusFilter, setStatusFilter] = useState("ALL");
-  // Registration date range. Server-side list filters (status/yard/train) are
-  // applied by the API; this narrows what comes back, alongside search.
-  const [dateFrom, setDateFrom] = useState<string | null>(null);
-  const [dateTo, setDateTo] = useState<string | null>(null);
-  const [listFilterValues, setListFilterValues] = useState<Record<string, string>>({});
   const [formOpen, setFormOpen] = useState(false);
   const [editing, setEditing] = useState<FleetRecord | null>(null);
   const [removeTarget, setRemoveTarget] = useState<FleetRecord | null>(null);
@@ -94,73 +118,6 @@ const FleetResourcePage = () => {
   const [wagonWorkspaceOpen, setWagonWorkspaceOpen] = useState(false);
   const { viewMode, setViewMode } = useFleetViewMode(slug);
 
-  const serverListFilters = useMemo((): FleetListFilters | undefined => {
-    const serverFilteredSlugs: FleetResourceSlug[] = ["wagons", "locomotives", "vehicles", "drivers"];
-    if (!serverFilteredSlugs.includes(slug)) return undefined;
-    const filters: FleetListFilters = {};
-    const status = listFilterValues.status;
-    const currentYardId = listFilterValues.currentYardId;
-    const availability = listFilterValues.availability;
-    const trainNumber = listFilterValues.trainNumber;
-    if (status && status !== "ALL") {
-      (filters as { status?: string }).status = status;
-    }
-    if (currentYardId && currentYardId !== "ALL") {
-      filters.currentYardId = currentYardId;
-    }
-    if (availability && availability !== "ALL") {
-      (filters as { availability?: string }).availability = availability;
-    }
-    if (trainNumber && trainNumber !== "ALL") {
-      (filters as { trainNumber?: string }).trainNumber = trainNumber;
-    }
-    // Wagons only: narrow the fleet to one wagon type (the API filters on it).
-    const wagonTypeId = listFilterValues.wagonTypeId;
-    if (wagonTypeId && wagonTypeId !== "ALL") {
-      (filters as { wagonTypeId?: string }).wagonTypeId = wagonTypeId;
-    }
-    // The plain locomotives list has no server-side search — its page window
-    // does, so the term is only sent on the paginated path.
-    if ((serverPaged || slug !== "locomotives") && debouncedSearch.trim()) {
-      filters.search = debouncedSearch.trim();
-    }
-    return filters;
-  }, [slug, listFilterValues, debouncedSearch, serverPaged]);
-
-  // On the server-paged path the page window, the search and the registration
-  // date range are all resolved by the API — nothing is filtered client-side.
-  const pagedFilters = useMemo(
-    (): FleetListFilters => ({
-      ...serverListFilters,
-      page: pagination.pageIndex + 1,
-      pageSize: pagination.pageSize,
-      ...(dateFrom ? { createdFrom: dateFrom } : {}),
-      ...(dateTo ? { createdTo: dateTo } : {}),
-    }),
-    [serverListFilters, pagination.pageIndex, pagination.pageSize, dateFrom, dateTo],
-  );
-
-  const listQuery = useQuery({
-    ...api.fleet.list.queryOptions({ input: { slug, filters: serverListFilters } }),
-    enabled: !serverPaged,
-  });
-  const pagedQuery = useQuery({
-    ...api.fleet.listPaged.queryOptions({ input: { slug, filters: pagedFilters } }),
-    enabled: serverPaged,
-    placeholderData: keepPreviousData,
-  });
-
-  const activeQuery = serverPaged ? pagedQuery : listQuery;
-  const { isLoading, isError, error } = activeQuery;
-  const allRows = useMemo(
-    () => (serverPaged ? (pagedQuery.data?.items ?? []) : (listQuery.data ?? [])),
-    [serverPaged, pagedQuery.data, listQuery.data],
-  );
-  const create = useMutation(api.fleet.create.mutationOptions());
-  const update = useMutation(api.fleet.update.mutationOptions());
-  const remove = useMutation(api.fleet.remove.mutationOptions());
-  const purge = useMutation(api.fleet.purge.mutationOptions());
-
   const { data: wagonTypes = [], isLoading: wagonTypesLoading } = useQuery(
     api.wagonTypes.list.queryOptions(),
   );
@@ -191,41 +148,14 @@ const FleetResourcePage = () => {
   const { data: drivers = [] } = useQuery(
     api.fleet.list.queryOptions({ input: { slug: "drivers" } }),
   );
+  // Wagons-only: "Train" list filter needs every train's code to pick from.
+  const { data: trains = [], isLoading: trainsLoading } = useQuery({
+    ...api.trains.list.queryOptions(),
+    enabled: slug === "wagons",
+  });
 
-  useEffect(() => {
-    setPagination((prev) => ({ pageIndex: 0, pageSize: prev.pageSize }));
-    setSearch("");
-    setStatusFilter("ALL");
-    setListFilterValues({});
-  }, [slug, setPagination]);
-
-  useEffect(() => {
-    setPagination((prev) => ({ pageIndex: 0, pageSize: prev.pageSize }));
-  }, [search, listFilterValues, dateFrom, dateTo, setPagination]);
-
-  const hasStatusColumn = Boolean(config?.columns.some((col) => col.accessorKey === "status"));
   const usesServerListFilters = Boolean(config?.listFilters?.length);
 
-  const statusFilterOptions = useMemo(() => {
-    if (!hasStatusColumn || usesServerListFilters) return [];
-    if (slug === "vehicles" || slug === "drivers") {
-      return [
-        { value: "ALL", label: "All statuses" },
-        { value: "ACTIVE", label: "Active" },
-        { value: "INACTIVE", label: "Inactive" },
-      ];
-    }
-    const statuses = new Set(
-      allRows
-        .map((row) => String((row as unknown as Record<string, unknown>).status ?? ""))
-        .filter(Boolean),
-    );
-    return [
-      { value: "ALL", label: "All statuses" },
-      ...[...statuses].sort().map((status) => ({ value: status, label: status })),
-    ];
-  }, [allRows, hasStatusColumn, usesServerListFilters, slug]);
-
   const dynamicOptions = useMemo(() => {
     const wagonTypeOpts = (wagonTypes as Array<{ id: string; code: string; name?: string }>).map(
       (t) => ({ value: t.id, label: `${t.code}${t.name ? ` - ${t.name}` : ""}` }),
@@ -247,6 +177,9 @@ const FleetResourcePage = () => {
     const yardOpts = (yards as Array<{ id: string; label?: string; code?: string }>).map(
       (y) => ({ value: y.id, label: y.label ?? y.code ?? y.id }),
     );
+    const trainOpts = (trains as Array<{ id: string; code: string; trainName?: string | null }>).map(
+      (t) => ({ value: t.id, label: t.trainName ? `${t.code} - ${t.trainName}` : t.code }),
+    );
 
     // Carries capacity + trailer configuration so picking a truck type can
     // pre-fill the vehicle's capacity and drop the trailer plate on a rigid type.
@@ -274,28 +207,82 @@ const FleetResourcePage = () => {
       wagons: [{ label: "Unassigned", value: FLEET_SELECT_NONE }, ...wagonOpts],
       containers: containerOpts,
       yards: yardOpts,
+      trains: trainOpts,
     };
-  }, [wagonTypes, containerTypes, cargoTypes, truckTypes, wagons, containers, yards]);
+  }, [wagonTypes, containerTypes, cargoTypes, truckTypes, wagons, containers, yards, trains]);
 
-  const listFilterSelects = useMemo(() => {
-    if (!config?.listFilters?.length) return null;
-    return config.listFilters.map((filter) => {
-      const dynamicOpts = filter.dynamicOptions
-        ? (dynamicOptions[filter.dynamicOptions] ?? [])
-        : [];
-      const staticOpts =
-        filter.options?.map((opt) => ({ value: opt.value, label: opt.label })) ?? [];
-      const opts = filter.dynamicOptions ? dynamicOpts : staticOpts;
-      return {
-        ...filter,
-        value: listFilterValues[filter.key] ?? "ALL",
-        data: [
-          { value: "ALL", label: filter.allLabel ?? `All ${filter.label.toLowerCase()}` },
-          ...opts,
-        ],
-      };
-    });
-  }, [config?.listFilters, listFilterValues, dynamicOptions]);
+  // One pill per configured server list filter (status/yard/wagon type/train…),
+  // built off `config.listFilters` — same source the old plain `<Select>` row
+  // read, just reshaped into FilterDefs. Falls back to a plain client-only
+  // Status filter for the 3 slugs with no server-side list filters at all.
+  const filterDefs: FilterDef[] = useMemo(() => {
+    const dateDef: FilterDef = {
+      key: "created",
+      label: "Registered",
+      type: "date",
+      secondary: true,
+      toParams: dateRangeParams("createdFrom", "createdTo"),
+    };
+    if (config?.listFilters?.length) {
+      return [
+        ...config.listFilters.map((filter): FilterDef => ({
+          key: filter.key,
+          label: filter.label,
+          type: "enum",
+          multiple: false,
+          options: filter.dynamicOptions
+            ? (dynamicOptions[filter.dynamicOptions] ?? [])
+            : (filter.options ?? []),
+        })),
+        dateDef,
+      ];
+    }
+    const fallback = FALLBACK_STATUS_OPTIONS[slug];
+    return fallback
+      ? [{ key: "status", label: "Status", type: "enum", multiple: false, options: fallback }, dateDef]
+      : [dateDef];
+  }, [config, dynamicOptions, slug]);
+
+  const controls = useFilters(filterDefs, { pageSize: 10 });
+
+  // On the server-paged path the page window, the search and the registration
+  // date range are all resolved by the API — nothing is filtered client-side.
+  // `controls.params` already carries every filter's mapped param name (status/
+  // currentYardId/wagonTypeId/… default to `{key: value}`, "created" maps to
+  // createdFrom/createdTo) plus search/page/pageSize — it IS the paged filter
+  // object; the unpaged one is the same minus pagination and the date range
+  // (which stays client-only for the non-server-paged slugs, see below).
+  const serverListFilters = useMemo((): FleetListFilters | undefined => {
+    if (!SERVER_FILTERED_SLUGS.includes(slug)) return undefined;
+    const { page: _page, pageSize: _pageSize, createdFrom: _cf, createdTo: _ct, ...rest } = controls.params;
+    return rest as FleetListFilters;
+  }, [slug, controls.params]);
+
+  const pagedFilters = useMemo(
+    (): FleetListFilters => controls.params as unknown as FleetListFilters,
+    [controls.params],
+  );
+
+  const listQuery = useQuery({
+    ...api.fleet.list.queryOptions({ input: { slug, filters: serverListFilters } }),
+    enabled: !serverPaged,
+  });
+  const pagedQuery = useQuery({
+    ...api.fleet.listPaged.queryOptions({ input: { slug, filters: pagedFilters } }),
+    enabled: serverPaged,
+    placeholderData: keepPreviousData,
+  });
+
+  const activeQuery = serverPaged ? pagedQuery : listQuery;
+  const { isLoading, isError, error } = activeQuery;
+  const allRows = useMemo(
+    () => (serverPaged ? (pagedQuery.data?.items ?? []) : (listQuery.data ?? [])),
+    [serverPaged, pagedQuery.data, listQuery.data],
+  );
+  const create = useMutation(api.fleet.create.mutationOptions());
+  const update = useMutation(api.fleet.update.mutationOptions());
+  const remove = useMutation(api.fleet.remove.mutationOptions());
+  const purge = useMutation(api.fleet.purge.mutationOptions());
 
   useEffect(() => {
     registerFleetOptionLabels("wagonTypeId", dynamicOptions.wagonTypes);
@@ -327,23 +314,30 @@ const FleetResourcePage = () => {
     truckTypesLoading ||
     wagonsLoading ||
     containersLoading ||
-    yardsLoading;
+    yardsLoading ||
+    trainsLoading;
 
   const filteredRows = useMemo(() => {
     if (!config) return allRows;
     // The API already applied every filter and cut the page — re-filtering here
     // would drop rows the server deliberately returned.
     if (serverPaged) return allRows;
-    const term = search.trim().toLowerCase();
     return allRows.filter((row) => {
       const record = row as unknown as Record<string, unknown>;
       // The date range applies even when the API already filtered the list —
       // it is not one of the server-side filters.
-      if (!matchesDayRange(record.createdAt, dateFrom, dateTo)) return false;
-      if (usesServerListFilters) return true;
-      if (statusFilter !== "ALL" && String(record.status ?? "") !== statusFilter) {
+      const created = controls.values.created;
+      if (created && !matchesDayRange(record.createdAt, created.v[0]?.slice(0, 10) ?? null, created.v[1]?.slice(0, 10) ?? null)) {
         return false;
       }
+      // Every other filter (status/yard/wagon type/…) was already applied
+      // server-side for these slugs — re-checking here against a plain field
+      // equality would be wrong for one (a wagon's "trainNumber" filter
+      // matches either of two DIFFERENT columns server-side, not one).
+      if (usesServerListFilters) return true;
+      const status = controls.values.status;
+      if (status && String(record.status ?? "") !== status.v[0]) return false;
+      const term = controls.searchText.trim().toLowerCase();
       if (!term) return true;
       return config.searchKeys.some((key) =>
         String(record[key] ?? "")
@@ -351,19 +345,23 @@ const FleetResourcePage = () => {
           .includes(term),
       );
     });
-  }, [allRows, search, statusFilter, config, usesServerListFilters, dateFrom, dateTo, serverPaged]);
+  }, [allRows, config, usesServerListFilters, controls.values, controls.searchText, serverPaged]);
 
   const totalCount = serverPaged
     ? (pagedQuery.data?.meta.total ?? 0)
     : filteredRows.length;
   const pageCount = serverPaged
     ? Math.max(1, pagedQuery.data?.meta.totalPages ?? 1)
-    : Math.max(1, Math.ceil(filteredRows.length / pagination.pageSize));
+    : Math.max(1, Math.ceil(filteredRows.length / controls.pageSize));
   const pagedRows = useMemo(() => {
     if (serverPaged) return filteredRows;
-    const start = pagination.pageIndex * pagination.pageSize;
-    return filteredRows.slice(start, start + pagination.pageSize);
-  }, [filteredRows, pagination.pageIndex, pagination.pageSize, serverPaged]);
+    const start = (controls.page - 1) * controls.pageSize;
+    return filteredRows.slice(start, start + controls.pageSize);
+  }, [filteredRows, controls.page, controls.pageSize, serverPaged]);
+
+  // Same {pagination, tableOptions} shape DataTable takes directly; FleetCardGrid
+  // (not a DataTable) just needs the raw pieces out of it below.
+  const { pagination: dtPagination, tableOptions: dtTableOptions } = controls.tableProps(totalCount);
 
   const columns = useMemo((): ColumnDef<FleetRecord>[] => {
     if (!config) return [];
@@ -589,84 +587,41 @@ const FleetResourcePage = () => {
       <Card radius="lg" padding={0} withBorder style={{ borderColor: "var(--mantine-color-gray-2)" }}>
         <Stack gap={0}>
           <Box px="md" pt="md" pb="md" w="100%" style={{ borderBottom: "1px solid var(--mantine-color-gray-2)" }}>
-            <FleetToolbar
-              search={search}
-              onSearchChange={setSearch}
+            <FilterBar
+              defs={filterDefs}
+              controls={controls}
               searchPlaceholder={config.searchPlaceholder}
               showSearch={config.supportsSearch}
-              viewMode={viewMode}
-              onViewModeChange={setViewMode}
-              filters={
-                <Group gap="sm" wrap="wrap" align="center">
-                  <DatePickerInput
-                    aria-label="Created from"
-                    placeholder="Created from"
-                    value={dateFrom}
-                    onChange={setDateFrom}
-                    maxDate={dateTo ?? undefined}
-                    clearable
-                    size="sm"
-                    radius="lg"
-                    w={160}
-                  />
-                  <DatePickerInput
-                    aria-label="Created to"
-                    placeholder="Created to"
-                    value={dateTo}
-                    onChange={setDateTo}
-                    minDate={dateFrom ?? undefined}
-                    clearable
-                    size="sm"
-                    radius="lg"
-                    w={160}
-                  />
-                {listFilterSelects ? (
-                  <Group gap="sm" wrap="wrap" align="center">
-                    {listFilterSelects.map((filter) => (
-                      <Select
-                        key={filter.key}
-                        aria-label={filter.label}
-                        placeholder={filter.data[0]?.label ?? filter.label}
-                        data={filter.data}
-                        value={filter.value}
-                        onChange={(value) => {
-                          setListFilterValues((prev) => ({
-                            ...prev,
-                            [filter.key]: value ?? "ALL",
-                          }));
-                          setPagination((prev) => ({ ...prev, pageIndex: 0 }));
-                        }}
-                        size="sm"
-                        radius="lg"
-                        w={200}
-                        searchable={filter.data.length > 8}
-                        comboboxProps={{ withinPortal: true }}
-                        styles={{ input: { borderColor: "var(--mantine-color-gray-3)" } }}
-                      />
-                    ))}
-                  </Group>
-                ) : hasStatusColumn && statusFilterOptions.length > 1 ? (
-                  <Group gap={4} wrap="wrap">
-                    <Text size="xs" fw={500} c="dimmed">Status:</Text>
-                    <Group gap={4} wrap="wrap">
-                      {[{ value: "ALL", label: "All" }, ...statusFilterOptions].map((option) => (
-                        <Button
-                          key={option.value}
-                          size="xs"
-                          radius="md"
-                          variant={statusFilter === option.value ? "filled" : "outline"}
-                          styles={{ label: { fontWeight: 500 } }}
-                          onClick={() => setStatusFilter(option.value)}
-                        >
-                          {option.label}
-                        </Button>
-                      ))}
-                    </Group>
-                  </Group>
-                ) : null}
-                </Group>
-              }
-            />
+              viewId={`fleet-${slug}`}
+            >
+              <SegmentedControl
+                value={viewMode}
+                onChange={(value) => setViewMode(value as FleetViewMode)}
+                size="sm"
+                radius="lg"
+                data={[
+                  {
+                    value: "table",
+                    label: (
+                      <Group gap={6} justify="center" wrap="nowrap">
+                        <Table2 size={14} />
+                        <span>Table</span>
+                      </Group>
+                    ),
+                  },
+                  {
+                    value: "cards",
+                    label: (
+                      <Group gap={6} justify="center" wrap="nowrap">
+                        <LayoutGrid size={14} />
+                        <span>Cards</span>
+                      </Group>
+                    ),
+                  },
+                ]}
+                styles={{ root: { background: "var(--mantine-color-gray-1)" } }}
+              />
+            </FilterBar>
           </Box>
 
           {viewMode === "table" ? (
@@ -688,18 +643,8 @@ const FleetResourcePage = () => {
                     : undefined
                 }
                 emptyMessage={`No ${itemLabel} found`}
-                pagination={{
-                  pageIndex: pagination.pageIndex,
-                  pageSize: pagination.pageSize,
-                  pageCount,
-                  totalCount,
-                }}
-                tableOptions={{
-                  manualPagination: true,
-                  pageCount,
-                  state: { pagination },
-                  onPaginationChange: setPagination,
-                }}
+                pagination={dtPagination}
+                tableOptions={dtTableOptions}
                 containerClassName="border-0 shadow-none bg-transparent"
                 footer={({ table, pagination: footerPagination }) => (
                   <DataTableFooter
@@ -716,10 +661,10 @@ const FleetResourcePage = () => {
               rows={pagedRows}
               status={tableStatus}
               emptyMessage={`No ${itemLabel} found`}
-              pagination={pagination}
+              pagination={{ pageIndex: controls.page - 1, pageSize: controls.pageSize }}
               pageCount={pageCount}
               totalCount={totalCount}
-              onPaginationChange={setPagination}
+              onPaginationChange={dtTableOptions!.onPaginationChange!}
               onEdit={
                 canUpdate
                   ? (record) => {
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/FuelPurchasePage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/FuelPurchasePage.tsx
index 8ecedd712..ec9c93482 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/FuelPurchasePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/FuelPurchasePage.tsx
@@ -19,11 +19,16 @@ import {
 } from "@mantine/core";
 import { Plus } from "lucide-react";
 import Breadcrumbs from "@/components/ui/Breadcrumbs";
-import ListControls from "@/components/common/ListControls";
 // Generic list footer — already shared by the fleet and train-scheduling lists
 // despite the ruleEngine path.
 import RuleEngineListFooter from "@/components/ruleEngine/RuleEngineListFooter";
-import { useListControls } from "@/hooks/useListControls";
+import {
+  applyClientFilters,
+  FilterBar,
+  toRuleEngineFooterProps,
+  useFilters,
+  type FilterDef,
+} from "@/components/filters";
 import { useToast } from "@/hooks/use-toast";
 import { api } from "@/auth/http";
 import { QUERY_KEYS } from "@/constants/QUERY_KEYS";
@@ -45,6 +50,8 @@ interface FuelPurchase {
 }
 
 
+const FUEL_FILTER_DEFS: FilterDef[] = [{ key: "purchaseDate", label: "Purchased", type: "date" }];
+
 export default function FuelPurchasePage() {
   const { toast } = useToast();
   const qc = useQueryClient();
@@ -123,10 +130,18 @@ export default function FuelPurchasePage() {
   const totalCost = formData.liters * formData.costPerLiter;
 
   // Aggregate stats (guarded against divide-by-zero when there are no purchases)
-  const controls = useListControls(purchasesData as FuelPurchase[], {
-    searchKeys: ["fuelStation", "paymentMethod"],
-    dateKey: "purchaseDate",
-  });
+  const controls = useFilters(FUEL_FILTER_DEFS, { pageSize: 10 });
+  const filteredPurchases = applyClientFilters(
+    purchasesData as FuelPurchase[],
+    FUEL_FILTER_DEFS,
+    controls.values,
+    controls.searchText,
+    { searchKeys: ["fuelStation", "paymentMethod"] },
+  );
+  const pagedPurchases = filteredPurchases.slice(
+    (controls.page - 1) * controls.pageSize,
+    controls.page * controls.pageSize,
+  );
 
   const totalLiters = (purchasesData as FuelPurchase[]).reduce(
     (sum, p) => sum + Number(p.liters),
@@ -195,17 +210,11 @@ export default function FuelPurchasePage() {
 
       {/* Purchases Table */}
       <Card withBorder>
-        <ListControls
-          search={controls.search}
-          onSearchChange={controls.setSearch}
+        <FilterBar
+          defs={FUEL_FILTER_DEFS}
+          controls={controls}
           searchPlaceholder="Search station or payment method…"
-          dateFrom={controls.dateFrom}
-          onDateFromChange={controls.setDateFrom}
-          dateTo={controls.dateTo}
-          onDateToChange={controls.setDateTo}
-          dateLabel="Purchased"
-          hasFilters={controls.hasFilters}
-          onReset={controls.reset}
+          viewId="fleet-fuel-purchases"
         />
         <Table striped highlightOnHover>
           <Table.Thead>
@@ -237,7 +246,7 @@ export default function FuelPurchasePage() {
                 </Table.Td>
               </Table.Tr>
             ) : null}
-            {controls.pagedRows.map((purchase) => (
+            {pagedPurchases.map((purchase) => (
               <Table.Tr key={purchase.id}>
                 <Table.Td>{(purchase as any).vehicle?.registrationNumber || (purchase as any).vehicle?.plateNumber || purchase.vehicleId}</Table.Td>
                 <Table.Td>{new Date(purchase.purchaseDate).toLocaleDateString()}</Table.Td>
@@ -253,11 +262,8 @@ export default function FuelPurchasePage() {
           </Table.Tbody>
         </Table>
         <RuleEngineListFooter
-          pagination={controls.pagination}
-          pageCount={controls.pageCount}
-          totalCount={controls.totalCount}
           itemLabel="purchases"
-          onPaginationChange={controls.setPagination}
+          {...toRuleEngineFooterProps(controls, filteredPurchases.length)}
         />
       </Card>
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/IncidentsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/IncidentsPage.tsx
index 6276091b8..62c3d9e01 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/IncidentsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/IncidentsPage.tsx
@@ -20,11 +20,16 @@ import {
 } from "@mantine/core";
 import { Plus } from "lucide-react";
 import Breadcrumbs from "@/components/ui/Breadcrumbs";
-import ListControls from "@/components/common/ListControls";
 // Generic list footer — already shared by the fleet and train-scheduling lists
 // despite the ruleEngine path.
 import RuleEngineListFooter from "@/components/ruleEngine/RuleEngineListFooter";
-import { useListControls } from "@/hooks/useListControls";
+import {
+  applyClientFilters,
+  FilterBar,
+  toRuleEngineFooterProps,
+  useFilters,
+  type FilterDef,
+} from "@/components/filters";
 import { useToast } from "@/hooks/use-toast";
 import {
   incidentsService,
@@ -89,6 +94,8 @@ const initialForm = {
   reportedBy: "",
 };
 
+const INCIDENT_FILTER_DEFS: FilterDef[] = [{ key: "occurredAt", label: "Occurred", type: "date" }];
+
 export default function IncidentsPage() {
   const { toast } = useToast();
   const qc = useQueryClient();
@@ -166,10 +173,18 @@ export default function IncidentsPage() {
     })) || [];
 
   const incidents = incidentsData as Incident[];
-  const controls = useListControls(incidents, {
-    searchKeys: ["type", "severity", "status"],
-    dateKey: "occurredAt",
-  });
+  const controls = useFilters(INCIDENT_FILTER_DEFS, { pageSize: 10 });
+  const filteredIncidents = applyClientFilters(
+    incidents,
+    INCIDENT_FILTER_DEFS,
+    controls.values,
+    controls.searchText,
+    { searchKeys: ["type", "severity", "status"] },
+  );
+  const pagedIncidents = filteredIncidents.slice(
+    (controls.page - 1) * controls.pageSize,
+    controls.page * controls.pageSize,
+  );
   const totalCount = incidents.length;
   const openCount = incidents.filter((i) => OPEN_STATUSES.includes(i.status)).length;
   const underReviewCount = incidents.filter((i) => i.status === "UNDER_REVIEW").length;
@@ -246,17 +261,11 @@ export default function IncidentsPage() {
 
       {/* Incidents Table */}
       <Card withBorder>
-        <ListControls
-          search={controls.search}
-          onSearchChange={controls.setSearch}
+        <FilterBar
+          defs={INCIDENT_FILTER_DEFS}
+          controls={controls}
           searchPlaceholder="Search type, severity, status…"
-          dateFrom={controls.dateFrom}
-          onDateFromChange={controls.setDateFrom}
-          dateTo={controls.dateTo}
-          onDateToChange={controls.setDateTo}
-          dateLabel="Occurred"
-          hasFilters={controls.hasFilters}
-          onReset={controls.reset}
+          viewId="fleet-incidents"
         />
         <Table striped highlightOnHover>
           <Table.Thead>
@@ -288,7 +297,7 @@ export default function IncidentsPage() {
                 </Table.Td>
               </Table.Tr>
             ) : null}
-            {controls.pagedRows.map((incident) => (
+            {pagedIncidents.map((incident) => (
               <Table.Tr key={incident.id}>
                 <Table.Td>{new Date(incident.occurredAt).toLocaleDateString()}</Table.Td>
                 <Table.Td>
@@ -316,11 +325,8 @@ export default function IncidentsPage() {
           </Table.Tbody>
         </Table>
         <RuleEngineListFooter
-          pagination={controls.pagination}
-          pageCount={controls.pageCount}
-          totalCount={controls.totalCount}
           itemLabel="incidents"
-          onPaginationChange={controls.setPagination}
+          {...toRuleEngineFooterProps(controls, filteredIncidents.length)}
         />
       </Card>
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/TrackingPage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/TrackingPage.tsx
index 958d99775..bcfd9731a 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/TrackingPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/TrackingPage.tsx
@@ -30,13 +30,18 @@ import { useToast } from "@/hooks/use-toast";
 import { useAuth } from "@/auth/useAuth";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import { vehiclesService } from "@/services/vehicles.service";
-import { gpsTrackingService, type GpsDevice } from "@/services/gps-tracking.service";
+import {
+  gpsTrackingService,
+  type GpsDevice,
+} from "@/services/gps-tracking.service";
 import { freightBrand } from "@/theme/freight-brand";
+import { formatDateTime } from "@/lib/format";
 
-// Same default key + env override the portal's LocationPicker uses.
-const GOOGLE_MAPS_API_KEY =
-  import.meta.env.VITE_GOOGLE_MAPS_API_KEY ||
-  "AIzaSyBg4tN31-fgvH_2Ix_TPo6VSfOA2uA5CCI";
+// Maps JavaScript API keys are public client-side keys — lock them down by
+// HTTP-referrer in the Google Cloud console. No fallback: a hardcoded default
+// used to live here and expired, turning a missing env var into a blank map
+// that read as broken GPS rather than absent configuration.
+const GOOGLE_MAPS_API_KEY = import.meta.env.VITE_GOOGLE_MAPS_API_KEY?.trim();
 const DEFAULT_CENTER = { lat: 9.03, lng: 38.74 }; // Addis Ababa
 
 const toNum = (v: number | string | null | undefined): number | null =>
@@ -47,16 +52,15 @@ const deviceLabel = (d: GpsDevice) =>
     ? [d.vehicle.code, d.vehicle.plateNumber].filter(Boolean).join(" · ")
     : d.name || d.imei;
 
-const fmtTime = (iso?: string | null) => {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime()) ? "—" : d.toLocaleString();
-};
 
 const StatBox = ({ label, value }: { label: string; value: string }) => (
   <Box p="sm" style={{ backgroundColor: "#f8f9fa", borderRadius: 8 }}>
-    <Text size="xs" c="dimmed">{label}</Text>
-    <Text fw={600} size="sm">{value}</Text>
+    <Text size="xs" c="dimmed">
+      {label}
+    </Text>
+    <Text fw={600} size="sm">
+      {value}
+    </Text>
   </Box>
 );
 
@@ -95,11 +99,20 @@ function useAddress(lat: number, lng: number): string | null {
     if (typeof google === "undefined" || !google.maps?.Geocoder) return;
     setAddr(null);
     let cancelled = false;
-    new google.maps.Geocoder().geocode({ location: { lat, lng } }, (res, status) => {
-      if (cancelled) return;
-      setAddr(status === "OK" && res?.[0] ? res[0].formatted_address : "Unknown location");
-    });
-    return () => { cancelled = true; };
+    new google.maps.Geocoder().geocode(
+      { location: { lat, lng } },
+      (res, status) => {
+        if (cancelled) return;
+        setAddr(
+          status === "OK" && res?.[0]
+            ? res[0].formatted_address
+            : "Unknown location",
+        );
+      },
+    );
+    return () => {
+      cancelled = true;
+    };
   }, [lat, lng]);
   return addr;
 }
@@ -118,16 +131,24 @@ function HoverInfo({
 }) {
   const address = useAddress(lat, lng);
   return (
-    <InfoWindow position={{ lat, lng }} pixelOffset={[0, -46]} onCloseClick={onClose}>
+    <InfoWindow
+      position={{ lat, lng }}
+      pixelOffset={[0, -46]}
+      onCloseClick={onClose}
+    >
       <div style={{ minWidth: 190, fontSize: 13 }}>
-        <div style={{ fontWeight: 600, marginBottom: 2 }}>{deviceLabel(device)}</div>
+        <div style={{ fontWeight: 600, marginBottom: 2 }}>
+          {deviceLabel(device)}
+        </div>
         <div style={{ fontFamily: "monospace" }}>
           {lat.toFixed(5)}, {lng.toFixed(5)}
         </div>
         <div style={{ color: "#555" }}>
           {toNum(device.lastSpeed) ?? 0} km/h · {device.lastCourse ?? 0}°
         </div>
-        <div style={{ color: "#777", marginTop: 4 }}>{address ?? "Locating…"}</div>
+        <div style={{ color: "#777", marginTop: 4 }}>
+          {address ?? "Locating…"}
+        </div>
       </div>
     </InfoWindow>
   );
@@ -182,7 +203,8 @@ export function TrackingPage() {
 
   const { data: vehiclesData } = useQuery({
     queryKey: ["vehicles", "all"],
-    queryFn: async () => (await vehiclesService.getAll({ limit: 1000 })).data ?? [],
+    queryFn: async () =>
+      (await vehiclesService.getAll({ limit: 1000 })).data ?? [],
   });
   const vehicleOptions = useMemo(
     () =>
@@ -197,7 +219,10 @@ export function TrackingPage() {
     () =>
       devices
         .map((d) => ({ d, lat: toNum(d.lastLat), lng: toNum(d.lastLng) }))
-        .filter((x): x is { d: GpsDevice; lat: number; lng: number } => x.lat != null && x.lng != null),
+        .filter(
+          (x): x is { d: GpsDevice; lat: number; lng: number } =>
+            x.lat != null && x.lng != null,
+        ),
     [devices],
   );
 
@@ -207,19 +232,31 @@ export function TrackingPage() {
   // Route history for the selected device's vehicle (chronological trail).
   const { data: history = [] } = useQuery({
     queryKey: ["gps", "history", selected?.vehicleId],
-    queryFn: async () => (await gpsTrackingService.history(selected!.vehicleId!, 300)).data ?? [],
+    queryFn: async () =>
+      (await gpsTrackingService.history(selected!.vehicleId!, 300)).data ?? [],
     enabled: Boolean(selected?.vehicleId),
   });
   const trail = useMemo(
-    () => [...history].reverse().map((h) => ({ lat: Number(h.lat), lng: Number(h.lng) })),
+    () =>
+      [...history]
+        .reverse()
+        .map((h) => ({ lat: Number(h.lat), lng: Number(h.lng) })),
     [history],
   );
 
   // Teardrop pin colored by state with a white truck glyph inside.
-  const markerIcon = (d: GpsDevice, selectedFlag: boolean): google.maps.Icon | undefined => {
+  const markerIcon = (
+    d: GpsDevice,
+    selectedFlag: boolean,
+  ): google.maps.Icon | undefined => {
     // Maps API loads async — Size/Point classes may not exist yet at first render.
-    if (typeof google === "undefined" || !google.maps?.Size || !mapsReady) return undefined;
-    const color = selectedFlag ? freightBrand.primary : d.online ? "#2f80ed" : "#95a5a6";
+    if (typeof google === "undefined" || !google.maps?.Size || !mapsReady)
+      return undefined;
+    const color = selectedFlag
+      ? freightBrand.primary
+      : d.online
+        ? "#2f80ed"
+        : "#95a5a6";
     const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="40" height="48" viewBox="0 0 40 48">
       <path d="M20 2C10 2 2 10 2 20c0 12 18 26 18 26s18-14 18-26C38 10 30 2 20 2Z" fill="${color}" stroke="#ffffff" stroke-width="1.5"/>
       <g transform="translate(8,7)" fill="none" stroke="#ffffff" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
@@ -258,8 +295,13 @@ export function TrackingPage() {
     },
     onError: (err: unknown) => {
       const description =
-        (err as { response?: { data?: { message?: string } } })?.response?.data?.message ?? "Failed";
-      toast({ title: editDevice ? "Update failed" : "Registration failed", description, variant: "destructive" });
+        (err as { response?: { data?: { message?: string } } })?.response?.data
+          ?.message ?? "Failed";
+      toast({
+        title: editDevice ? "Update failed" : "Registration failed",
+        description,
+        variant: "destructive",
+      });
     },
   });
 
@@ -285,15 +327,25 @@ export function TrackingPage() {
 
   return (
     <Container size="xl" py="xl" px="lg">
-      <Breadcrumbs items={[{ label: "Fleet" }, { label: "Vehicle Tracking" }]} />
+      <Breadcrumbs
+        items={[{ label: "Fleet" }, { label: "Vehicle Tracking" }]}
+      />
 
       <Group justify="space-between" mb="xl">
         <div>
-          <Text fw={700} size="xl">Real-Time Vehicle Tracking</Text>
-          <Text c="dimmed" size="sm">Live GPS positions from GT06 trackers</Text>
+          <Text fw={700} size="xl">
+            Real-Time Vehicle Tracking
+          </Text>
+          <Text c="dimmed" size="sm">
+            Live GPS positions from GT06 trackers
+          </Text>
         </div>
         {canManage && (
-          <Button leftSection={<Plus size={16} />} color="edr-green" onClick={openRegister}>
+          <Button
+            leftSection={<Plus size={16} />}
+            color="edr-green"
+            onClick={openRegister}
+          >
             Register tracker
           </Button>
         )}
@@ -312,36 +364,82 @@ export function TrackingPage() {
               </Group>
             </Card.Section>
             <Card.Section p="md">
-              <Box style={{ height: 500, width: "100%", borderRadius: 8, overflow: "hidden" }}>
-                <APIProvider apiKey={GOOGLE_MAPS_API_KEY}>
-                  <GoogleMap
-                    defaultCenter={DEFAULT_CENTER}
-                    defaultZoom={7}
-                    gestureHandling="greedy"
-                    disableDefaultUI={false}
-                    style={{ width: "100%", height: "100%" }}
+              <Box
+                style={{
+                  height: 500,
+                  width: "100%",
+                  borderRadius: 8,
+                  overflow: "hidden",
+                }}
+              >
+                {!GOOGLE_MAPS_API_KEY ? (
+                  // Name the missing variable rather than showing an empty map: the
+                  // device list beside this still works, so a blank panel reads as
+                  // "no GPS fixes" instead of "no map key".
+                  <Box
+                    style={{
+                      height: "100%",
+                      display: "flex",
+                      alignItems: "center",
+                      justifyContent: "center",
+                      padding: 24,
+                      textAlign: "center",
+                      border: "1px solid #F0D2A8",
+                      borderRadius: 8,
+                      background: "#FFF9F0",
+                    }}
                   >
-                    <ReadyProbe onReady={() => setMapsReady(true)} />
-                    {positioned.map(({ d, lat, lng }) => (
-                      <Marker
-                        key={d.id}
-                        position={{ lat, lng }}
-                        title={`${deviceLabel(d)}\n${lat.toFixed(5)}, ${lng.toFixed(5)}`}
-                        icon={markerIcon(d, d.id === selectedId)}
-                        onClick={() => setSelectedId(d.id)}
-                        onMouseOver={() => setHoverId(d.id)}
+                    <Text fz="sm" c="#8A5A16">
+                      Map unavailable — <code>VITE_GOOGLE_MAPS_API_KEY</code> is
+                      not set. Add a Google Maps key with the Maps JavaScript
+                      API and Places API enabled to this app&apos;s{" "}
+                      <code>.env</code>, then restart the dev server. Device
+                      positions below are unaffected.
+                    </Text>
+                  </Box>
+                ) : (
+                  <APIProvider apiKey={GOOGLE_MAPS_API_KEY}>
+                    <GoogleMap
+                      defaultCenter={DEFAULT_CENTER}
+                      defaultZoom={7}
+                      gestureHandling="greedy"
+                      disableDefaultUI={false}
+                      style={{ width: "100%", height: "100%" }}
+                    >
+                      <ReadyProbe onReady={() => setMapsReady(true)} />
+                      {positioned.map(({ d, lat, lng }) => (
+                        <Marker
+                          key={d.id}
+                          position={{ lat, lng }}
+                          title={`${deviceLabel(d)}\n${lat.toFixed(5)}, ${lng.toFixed(5)}`}
+                          icon={markerIcon(d, d.id === selectedId)}
+                          onClick={() => setSelectedId(d.id)}
+                          onMouseOver={() => setHoverId(d.id)}
+                        />
+                      ))}
+                      {(() => {
+                        const h = positioned.find((p) => p.d.id === hoverId);
+                        return h ? (
+                          <HoverInfo
+                            device={h.d}
+                            lat={h.lat}
+                            lng={h.lng}
+                            onClose={() => setHoverId(null)}
+                          />
+                        ) : null;
+                      })()}
+                      <FitBounds
+                        points={positioned.map((p) => ({
+                          lat: p.lat,
+                          lng: p.lng,
+                        }))}
                       />
-                    ))}
-                    {(() => {
-                      const h = positioned.find((p) => p.d.id === hoverId);
-                      return h ? (
-                        <HoverInfo device={h.d} lat={h.lat} lng={h.lng} onClose={() => setHoverId(null)} />
-                      ) : null;
-                    })()}
-                    <FitBounds points={positioned.map((p) => ({ lat: p.lat, lng: p.lng }))} />
-                    {selected?.vehicleId && trail.length > 1 && <RouteTrail path={trail} />}
-                  </GoogleMap>
-                </APIProvider>
+                      {selected?.vehicleId && trail.length > 1 && (
+                        <RouteTrail path={trail} />
+                      )}
+                    </GoogleMap>
+                  </APIProvider>
+                )}
               </Box>
               {positioned.length === 0 && (
                 <Text size="sm" c="dimmed" ta="center" mt="sm">
@@ -361,11 +459,19 @@ export function TrackingPage() {
                   <Group justify="space-between">
                     <Text fw={500}>{deviceLabel(selected)}</Text>
                     <Group gap="xs">
-                      <Badge color={selected.online ? "edr-green" : "gray"} leftSection={<Activity size={12} />}>
+                      <Badge
+                        color={selected.online ? "edr-green" : "gray"}
+                        leftSection={<Activity size={12} />}
+                      >
                         {selected.online ? "Live" : "Offline"}
                       </Badge>
                       {canManage && (
-                        <ActionIcon variant="subtle" color="red" aria-label="Remove tracker" onClick={() => deleteMutation.mutate(selected.id)}>
+                        <ActionIcon
+                          variant="subtle"
+                          color="red"
+                          aria-label="Remove tracker"
+                          onClick={() => deleteMutation.mutate(selected.id)}
+                        >
                           <Trash2 size={16} />
                         </ActionIcon>
                       )}
@@ -373,21 +479,55 @@ export function TrackingPage() {
                   </Group>
 
                   <SimpleGrid cols={2} spacing="sm">
-                    <StatBox label="Latitude" value={toNum(selected.lastLat)?.toFixed(5) ?? "—"} />
-                    <StatBox label="Longitude" value={toNum(selected.lastLng)?.toFixed(5) ?? "—"} />
-                    <StatBox label="Speed" value={`${toNum(selected.lastSpeed) ?? 0} km/h`} />
-                    <StatBox label="Course" value={`${selected.lastCourse ?? 0}°`} />
-                    <StatBox label="Voltage" value={selected.voltageLevel != null ? `${selected.voltageLevel}/6` : "—"} />
-                    <StatBox label="GSM" value={selected.gsmLevel != null ? `${selected.gsmLevel}/4` : "—"} />
+                    <StatBox
+                      label="Latitude"
+                      value={toNum(selected.lastLat)?.toFixed(5) ?? "—"}
+                    />
+                    <StatBox
+                      label="Longitude"
+                      value={toNum(selected.lastLng)?.toFixed(5) ?? "—"}
+                    />
+                    <StatBox
+                      label="Speed"
+                      value={`${toNum(selected.lastSpeed) ?? 0} km/h`}
+                    />
+                    <StatBox
+                      label="Course"
+                      value={`${selected.lastCourse ?? 0}°`}
+                    />
+                    <StatBox
+                      label="Voltage"
+                      value={
+                        selected.voltageLevel != null
+                          ? `${selected.voltageLevel}/6`
+                          : "—"
+                      }
+                    />
+                    <StatBox
+                      label="GSM"
+                      value={
+                        selected.gsmLevel != null
+                          ? `${selected.gsmLevel}/4`
+                          : "—"
+                      }
+                    />
                   </SimpleGrid>
 
                   <div>
-                    <Text size="xs" c="dimmed">IMEI</Text>
-                    <Text fw={500} size="sm">{selected.imei}</Text>
+                    <Text size="xs" c="dimmed">
+                      IMEI
+                    </Text>
+                    <Text fw={500} size="sm">
+                      {selected.imei}
+                    </Text>
                   </div>
                   <div>
-                    <Text size="xs" c="dimmed">Last fix</Text>
-                    <Text fw={500} size="sm">{fmtTime(selected.lastFixAt)}</Text>
+                    <Text size="xs" c="dimmed">
+                      Last fix
+                    </Text>
+                    <Text fw={500} size="sm">
+                      {formatDateTime(selected.lastFixAt)}
+                    </Text>
                   </div>
                   {selected.vehicleId && (
                     <Text size="xs" c="dimmed">
@@ -400,7 +540,9 @@ export function TrackingPage() {
                     placeholder="Unassigned"
                     data={vehicleOptions}
                     value={selected.vehicleId ?? null}
-                    onChange={(v) => assignMutation.mutate({ id: selected.id, vehicleId: v })}
+                    onChange={(v) =>
+                      assignMutation.mutate({ id: selected.id, vehicleId: v })
+                    }
                     disabled={!canManage}
                     searchable
                     clearable
@@ -418,24 +560,43 @@ export function TrackingPage() {
                       {devices.map((d) => (
                         <Table.Tr
                           key={d.id}
-                          style={{ cursor: "pointer", backgroundColor: d.id === selectedId ? freightBrand.mutedBg : "transparent" }}
+                          style={{
+                            cursor: "pointer",
+                            backgroundColor:
+                              d.id === selectedId
+                                ? freightBrand.mutedBg
+                                : "transparent",
+                          }}
                           onClick={() => setSelectedId(d.id)}
                         >
                           <Table.Td>
                             <Stack gap={0}>
-                              <Text size="sm" fw={600}>{deviceLabel(d)}</Text>
-                              <Text size="xs" c="dimmed">{toNum(d.lastSpeed) ?? 0} km/h · {fmtTime(d.lastFixAt)}</Text>
+                              <Text size="sm" fw={600}>
+                                {deviceLabel(d)}
+                              </Text>
+                              <Text size="xs" c="dimmed">
+                                {toNum(d.lastSpeed) ?? 0} km/h ·{" "}
+                                {formatDateTime(d.lastFixAt)}
+                              </Text>
                             </Stack>
                           </Table.Td>
                           <Table.Td align="right">
                             <Group gap={6} justify="flex-end" wrap="nowrap">
-                              <Badge color={d.online ? "edr-green" : "gray"} size="sm">{d.online ? "Live" : "Offline"}</Badge>
+                              <Badge
+                                color={d.online ? "edr-green" : "gray"}
+                                size="sm"
+                              >
+                                {d.online ? "Live" : "Offline"}
+                              </Badge>
                               {canManage && (
                                 <ActionIcon
                                   variant="subtle"
                                   size="sm"
                                   aria-label="Edit tracker"
-                                  onClick={(e) => { e.stopPropagation(); openEdit(d); }}
+                                  onClick={(e) => {
+                                    e.stopPropagation();
+                                    openEdit(d);
+                                  }}
                                 >
                                   <Pencil size={15} />
                                 </ActionIcon>
@@ -447,7 +608,9 @@ export function TrackingPage() {
                       {devices.length === 0 && (
                         <Table.Tr>
                           <Table.Td colSpan={2}>
-                            <Text size="sm" c="dimmed" ta="center" py="md">No trackers registered yet.</Text>
+                            <Text size="sm" c="dimmed" ta="center" py="md">
+                              No trackers registered yet.
+                            </Text>
                           </Table.Td>
                         </Table.Tr>
                       )}
@@ -493,7 +656,9 @@ export function TrackingPage() {
             clearable
           />
           <Group justify="flex-end">
-            <Button variant="default" onClick={() => setModalOpen(false)}>Cancel</Button>
+            <Button variant="default" onClick={() => setModalOpen(false)}>
+              Cancel
+            </Button>
             <Button
               loading={saveMutation.isPending}
               disabled={!form.imei.trim()}
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/VehicleDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/fleet/VehicleDetailPage.tsx
index ae785a708..bcfadb698 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/VehicleDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/VehicleDetailPage.tsx
@@ -42,6 +42,7 @@ import {
 } from "@/services/vehicles.service";
 import { driversService } from "@/services/drivers.service";
 import { fleetHistoryService } from "@/services/fleet-history.service";
+import { formatDateTime } from "@/lib/format";
 
 interface MaintenanceCost {
   id: string;
@@ -77,11 +78,6 @@ const fmtDate = (iso?: string | null) => {
   const d = new Date(iso);
   return Number.isNaN(d.getTime()) ? "—" : d.toLocaleDateString();
 };
-const fmtDateTime = (iso?: string | null) => {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime()) ? "—" : d.toLocaleString();
-};
 const money = (n?: number | null) =>
   n == null ? "—" : `ETB ${Number(n).toLocaleString(undefined, { maximumFractionDigits: 2 })}`;
 
@@ -359,7 +355,7 @@ const DriverTab = ({
               {drivers.map((d) => (
                 <Table.Tr key={d.id}>
                   <Table.Td>{d.name}</Table.Td>
-                  <Table.Td>{fmtDateTime(d.at)}</Table.Td>
+                  <Table.Td>{formatDateTime(d.at)}</Table.Td>
                 </Table.Tr>
               ))}
             </Table.Tbody>
@@ -388,7 +384,7 @@ const HistoryTab = ({ vehicleId }: { vehicleId: string }) => {
                 .join(" · ")}
             </Text>
           )}
-          <Text size="xs" c="dimmed" mt={2}>{fmtDateTime(e.createdAt)}</Text>
+          <Text size="xs" c="dimmed" mt={2}>{formatDateTime(e.createdAt)}</Text>
         </Timeline.Item>
       ))}
     </Timeline>
diff --git a/apps/edr-freight-web/backoffice/src/pages/fleet/config/resources.ts b/apps/edr-freight-web/backoffice/src/pages/fleet/config/resources.ts
index 9ba826e6f..526181d44 100644
--- a/apps/edr-freight-web/backoffice/src/pages/fleet/config/resources.ts
+++ b/apps/edr-freight-web/backoffice/src/pages/fleet/config/resources.ts
@@ -33,7 +33,8 @@ export type FleetDynamicOptions =
   | "truckTypes"
   | "wagons"
   | "containers"
-  | "yards";
+  | "yards"
+  | "trains";
 
 /**
  * A dynamic select option that can carry the record it came from. Picking a
@@ -324,6 +325,12 @@ export const FLEET_RESOURCES: FleetResourceConfig[] = [
         allLabel: "All trains",
         options: TRAIN_RUN_FILTER_OPTIONS,
       },
+      {
+        key: "trainId",
+        label: "Train",
+        allLabel: "All trains",
+        dynamicOptions: "trains",
+      },
     ],
     cardTitleKey: "wagonNumber",
     cardSubtitleKey: "currentYard",
@@ -346,6 +353,10 @@ export const FLEET_RESOURCES: FleetResourceConfig[] = [
       { id: "importTrainNumber", header: "Import train no.", accessorKey: "importTrainNumber", format: "code" },
       { id: "currentYard", header: "Current Yard", accessorKey: "currentYard", format: "entityLabel" },
       { id: "status", header: "Status", accessorKey: "status", format: "statusBadge" },
+      // From the status-flip log: last time the wagon went to maintenance, and
+      // last time it became available again (dash = never logged).
+      { id: "lastMaintenanceAt", header: "Last to maintenance", accessorKey: "lastMaintenanceAt", format: "date" },
+      { id: "lastAvailableAt", header: "Available since", accessorKey: "lastAvailableAt", format: "date" },
     ],
     formFields: [
       // Run numbers are optional — a wagon sits in the fleet unassigned to any
diff --git a/apps/edr-freight-web/backoffice/src/pages/invoices/FinanceHubPage.tsx b/apps/edr-freight-web/backoffice/src/pages/invoices/FinanceHubPage.tsx
new file mode 100644
index 000000000..6465be167
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/invoices/FinanceHubPage.tsx
@@ -0,0 +1,120 @@
+import { Tabs } from "@mantine/core";
+import { Banknote, DollarSign, Receipt } from "lucide-react";
+import { useSearchParams } from "react-router-dom";
+
+import { useAuth } from "@/auth/useAuth";
+import { useManualPaymentSettingsQuery } from "@/hooks/useManualPaymentSettings";
+import { PageContainer, PageHeader } from "@/components/page";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+
+import InvoicesPanel from "./InvoicesPage";
+import UsdPaymentsPanel from "./UsdPaymentsPage";
+
+/**
+ * Invoices and USD Payments used to be separate routes/pages with
+ * near-identical chrome. They're merged here as URL-linkable tabs (`?tab=`)
+ * on one page — each tab keeps the permission it was individually gated on
+ * before, and just doesn't render if the user lacks it.
+ *
+ * The Payments tab was removed; its summary (total collected, ETB/USD) now
+ * lives as a card at the top of the Invoices tab instead. Manual payments are
+ * split into one tab per currency — ETB keeps the original `?tab=manual-payments`
+ * key so existing links and the old redirect still land somewhere valid.
+ */
+const TABS = [
+  {
+    key: "invoices",
+    label: "Invoices",
+    icon: Receipt,
+    permission: FREIGHT_PERMS.invoices.view,
+    subtitle:
+      "Every invoice issued across bookings, warehouse fees and clearance charges.",
+    Panel: InvoicesPanel,
+  },
+  {
+    key: "manual-payments",
+    label: "Manual Payments (ETB)",
+    icon: Banknote,
+    // Same gate as Invoices, not a dedicated key — mirrors the old route.
+    permission: FREIGHT_PERMS.invoices.view,
+    /** Hidden unless manual settlement is switched on for this currency. */
+    manualCurrency: "ETB",
+    subtitle:
+      "Import and export invoices in ETB that Finance settles by hand (bank transfer or counter). Upload the customer's slip and confirm the payment before the pay window closes.",
+    Panel: () => <UsdPaymentsPanel currency="ETB" />,
+  },
+  {
+    key: "manual-payments-usd",
+    label: "Manual Payments (USD)",
+    icon: DollarSign,
+    permission: FREIGHT_PERMS.invoices.view,
+    manualCurrency: "USD",
+    subtitle:
+      "Import and export invoices in USD that Finance settles by hand (bank transfer or counter). Upload the customer's slip and confirm the payment before the pay window closes.",
+    Panel: () => <UsdPaymentsPanel currency="USD" />,
+  },
+] as const;
+
+type TabKey = (typeof TABS)[number]["key"];
+
+export default function FinanceHubPage() {
+  const { user } = useAuth();
+  const [searchParams, setSearchParams] = useSearchParams();
+
+  // A currency whose manual-payment channel is switched off has no tab at all
+  // — the list would be empty and every confirmation refused.
+  const { data: manualSettings } = useManualPaymentSettingsQuery();
+  const manualEnabled = (currency: "ETB" | "USD") =>
+    !manualSettings ||
+    (currency === "ETB" ? manualSettings.etbEnabled : manualSettings.usdEnabled);
+
+  const visibleTabs = TABS.filter(
+    (tab) =>
+      hasPermission(user, tab.permission) &&
+      (!("manualCurrency" in tab) || manualEnabled(tab.manualCurrency)),
+  );
+  const requested = searchParams.get("tab");
+  const active: TabKey =
+    visibleTabs.find((tab) => tab.key === requested)?.key ??
+    visibleTabs[0]?.key ??
+    "invoices";
+  const activeTab = visibleTabs.find((tab) => tab.key === active);
+
+  const handleChange = (value: string | null) => {
+    if (!value) return;
+    setSearchParams(
+      (prev) => {
+        const next = new URLSearchParams(prev);
+        next.set("tab", value);
+        return next;
+      },
+      { replace: true },
+    );
+  };
+
+  return (
+    <PageContainer>
+      <PageHeader title={activeTab?.label ?? "Invoices"} subtitle={activeTab?.subtitle} />
+
+      <Tabs value={active} onChange={handleChange} keepMounted={false}>
+        <Tabs.List>
+          {visibleTabs.map((tab) => (
+            <Tabs.Tab
+              key={tab.key}
+              value={tab.key}
+              leftSection={<tab.icon size={16} />}
+            >
+              {tab.label}
+            </Tabs.Tab>
+          ))}
+        </Tabs.List>
+
+        {visibleTabs.map((tab) => (
+          <Tabs.Panel key={tab.key} value={tab.key} pt="lg">
+            <tab.Panel />
+          </Tabs.Panel>
+        ))}
+      </Tabs>
+    </PageContainer>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/invoices/InvoiceDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/invoices/InvoiceDetailPage.tsx
index 629f8ec7c..23a974856 100644
--- a/apps/edr-freight-web/backoffice/src/pages/invoices/InvoiceDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/invoices/InvoiceDetailPage.tsx
@@ -1,20 +1,25 @@
+import type { ReactNode } from "react";
 import {
   ActionIcon,
   Button,
   Card,
   Center,
   Container,
+  Grid,
   Group,
   Loader,
+  Menu,
   SimpleGrid,
   Stack,
   Table,
   Text,
 } from "@mantine/core";
 import { useQuery } from "@tanstack/react-query";
-import { ArrowLeft, Download } from "lucide-react";
+import { ArrowLeft, Building2, Download, FileText, Printer } from "lucide-react";
 import { useAuth } from "@/auth/useAuth";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { EimsFilingCard } from "@/components/invoices/EimsFilingCard";
+import { useToast } from "@/hooks/use-toast";
 import { useState } from "react";
 import { useNavigate, useParams } from "react-router-dom";
 
@@ -25,8 +30,11 @@ import {
   humanize,
 } from "@/components/customers";
 import { PageContainer, PageHeader } from "@/components/page";
+import { LinkedEntityCard, type FieldRowProps } from "@/components/detail";
+import { useBookingDetail } from "@/hooks/bookings/useBookings";
 import { api } from "@/services/api";
 import { invoicesService } from "@/services/invoices.service";
+import type { Invoice } from "@/types/invoice";
 
 function openPdfBlob(blob: Blob, filename: string) {
   const url = URL.createObjectURL(blob);
@@ -42,7 +50,17 @@ function openPdfBlob(blob: Blob, filename: string) {
   setTimeout(() => URL.revokeObjectURL(url), 60_000);
 }
 
-function InfoField({ label, value }: { label: string; value?: string | null }) {
+function InfoField({
+  label,
+  value,
+}: {
+  label: string;
+  value?: ReactNode;
+}) {
+  const isEmpty =
+    value === undefined ||
+    value === null ||
+    (typeof value === "string" && !value.trim());
   return (
     <Stack gap={2}>
       <Text
@@ -55,17 +73,103 @@ function InfoField({ label, value }: { label: string; value?: string | null }) {
         {label}
       </Text>
       <Text size="sm" c="edr-text">
-        {value && value.trim() ? value : "—"}
+        {isEmpty ? "—" : value}
       </Text>
     </Stack>
   );
 }
 
+/**
+ * Billed-to party: a customer company, or — for shipping-line credit invoices
+ * (`companyId` null) — the shipping line itself. The two payers are mutually
+ * exclusive (DB-enforced), so exactly one branch has data.
+ */
+function RecipientCard({ invoice }: { invoice: Invoice }) {
+  const company = invoice.company;
+  const shippingLine = invoice.shippingLineCompany;
+
+  if (!company && shippingLine) {
+    const rows: FieldRowProps[] = [
+      { label: "Phone", value: shippingLine.phoneNumber },
+      { label: "Email", value: shippingLine.email },
+    ];
+    return (
+      <LinkedEntityCard
+        icon={Building2}
+        title="Billed to"
+        name={shippingLine.name}
+        rows={rows}
+        emptyMessage="No additional shipping line details available."
+      />
+    );
+  }
+
+  const rows: FieldRowProps[] = [
+    { label: "Profile", value: invoice.companyProfile?.reference },
+    { label: "TIN", value: company?.tin },
+    { label: "VAT No.", value: company?.vatNumber },
+    { label: "Phone", value: company?.phone },
+    { label: "Email", value: company?.email },
+    { label: "Address", value: company?.address },
+  ];
+  return (
+    <LinkedEntityCard
+      icon={Building2}
+      title="Billed to"
+      name={company?.name ?? "Unnamed company"}
+      to={invoice.companyId ? `/dashboard/customers/${invoice.companyId}` : null}
+      rows={rows}
+      emptyMessage="No additional recipient details available."
+    />
+  );
+}
+
+/** What the invoice was raised for — a booking's route/wagons when the
+ *  source is a booking; otherwise just the source type and its raw id
+ *  (warehouse/demurrage/first-mile/last-mile ids don't link anywhere). */
+function SourceCard({ invoice }: { invoice: Invoice }) {
+  const isBooking = invoice.source === "booking";
+  const { data: booking } = useBookingDetail(
+    isBooking ? invoice.sourceId : undefined,
+  );
+
+  if (!isBooking) {
+    return (
+      <LinkedEntityCard
+        icon={FileText}
+        title="Source"
+        name={humanize(invoice.source)}
+        rows={[{ label: "Reference", value: invoice.sourceId }]}
+      />
+    );
+  }
+
+  const route =
+    booking?.originYard && booking?.destinationYard
+      ? `${booking.originYard.label} → ${booking.destinationYard.label}`
+      : undefined;
+
+  return (
+    <LinkedEntityCard
+      icon={FileText}
+      title="Source"
+      name={booking?.reference ?? invoice.sourceId}
+      to={`/dashboard/booking-requests/${invoice.sourceId}`}
+      rows={[
+        { label: "Type", value: humanize(invoice.type) },
+        { label: "Route", value: route },
+        { label: "Wagons", value: booking?.wagonsRequired ?? undefined },
+      ]}
+    />
+  );
+}
+
 export default function InvoiceDetailPage() {
   const { user } = useAuth();
   const canExport = hasPermission(user, FREIGHT_PERMS.invoices.export);
   const { id } = useParams<{ id: string }>();
   const navigate = useNavigate();
+  const { toast } = useToast();
   const [downloading, setDownloading] = useState(false);
 
   const { data: invoice, isLoading } = useQuery(
@@ -75,12 +179,27 @@ export default function InvoiceDetailPage() {
     }),
   );
 
-  const downloadDocument = async () => {
+  const downloadDocument = async (format?: "a4" | "thermal") => {
     if (!id) return;
     setDownloading(true);
     try {
-      const { data } = await invoicesService.downloadDocument(id);
-      openPdfBlob(data, `${invoice?.invoiceNumber ?? "invoice"}.pdf`);
+      const { data } = await invoicesService.downloadDocument(id, format);
+      const suffix = format === "thermal" ? "-thermal" : "";
+      openPdfBlob(data, `${invoice?.invoiceNumber ?? "invoice"}${suffix}.pdf`);
+    } catch (error) {
+      // Thermal rendering deliberately fails loudly rather than silently returning an A4-shaped,
+      // QR-less document (see PdfRenderService's `noFallback`) — surface that here rather than
+      // let it become a silent unhandled rejection with just a spinner stopping.
+      toast({
+        title: format === "thermal" ? "Could not generate the thermal invoice" : "Could not download the invoice",
+        description:
+          format === "thermal"
+            ? "Thermal rendering requires Chromium on the server. The A4 PDF is still available."
+            : error instanceof Error
+              ? error.message
+              : undefined,
+        variant: "destructive",
+      });
     } finally {
       setDownloading(false);
     }
@@ -120,140 +239,164 @@ export default function InvoiceDetailPage() {
         ]}
         backTo="/dashboard/invoices"
         title={invoice.invoiceNumber}
-        subtitle={`${humanize(invoice.source)} · ${invoice.sourceId}`}
+        subtitle={humanize(invoice.source)}
         meta={<InvoiceStatusBadge status={invoice.status} />}
         action={
-          <ActionIcon
-            variant="default"
-            size="lg"
-            radius="md"
-            aria-label="Download invoice"
-            disabled={!canExport}
-            loading={downloading}
-            onClick={() => void downloadDocument()}
-          >
-            <Download size={16} />
-          </ActionIcon>
+          <Menu position="bottom-end" withinPortal>
+            <Menu.Target>
+              <ActionIcon
+                variant="default"
+                size="lg"
+                radius="md"
+                aria-label="Download invoice"
+                disabled={!canExport}
+                loading={downloading}
+              >
+                <Download size={16} />
+              </ActionIcon>
+            </Menu.Target>
+            <Menu.Dropdown>
+              <Menu.Item
+                leftSection={<Download size={14} />}
+                onClick={() => void downloadDocument("a4")}
+              >
+                Download PDF (A4)
+              </Menu.Item>
+              <Menu.Item
+                leftSection={<Printer size={14} />}
+                onClick={() => void downloadDocument("thermal")}
+              >
+                Download thermal invoice (80mm)
+              </Menu.Item>
+            </Menu.Dropdown>
+          </Menu>
         }
       />
 
-      <Stack gap="lg">
-        <Card>
+      <Grid gap="lg">
+        <Grid.Col span={{ base: 12, lg: 8 }}>
           <Stack gap="lg">
-            <Text fw={600} c="edr-text">
-              Summary
-            </Text>
-            <SimpleGrid cols={{ base: 1, sm: 2, lg: 4 }} spacing="lg">
-              <InfoField label="Billed to" value={invoice.company?.name} />
-              <InfoField
-                label="Profile"
-                value={invoice.companyProfile?.reference}
-              />
-              <InfoField label="Type" value={humanize(invoice.type)} />
-              <InfoField label="Currency" value={invoice.currency} />
-              <InfoField label="Issued" value={formatDate(invoice.issuedAt)} />
-              <InfoField label="Due" value={formatDate(invoice.dueAt)} />
-              <InfoField
-                label="Total"
-                value={formatMoney(invoice.totalAmount, invoice.currency)}
-              />
-              <InfoField
-                label="Balance"
-                value={formatMoney(invoice.balanceAmount, invoice.currency)}
-              />
-            </SimpleGrid>
-          </Stack>
-        </Card>
+            <Card>
+              <Stack gap="lg">
+                <Text fw={600} c="edr-text">
+                  Amounts
+                </Text>
+                <SimpleGrid cols={{ base: 1, sm: 2, lg: 4 }} spacing="lg">
+                  <InfoField label="Currency" value={invoice.currency} />
+                  <InfoField label="Issued" value={formatDate(invoice.issuedAt)} />
+                  <InfoField label="Due" value={formatDate(invoice.dueAt)} />
+                  <InfoField
+                    label="Total"
+                    value={formatMoney(invoice.totalAmount, invoice.currency)}
+                  />
+                  <InfoField
+                    label="Balance"
+                    value={formatMoney(invoice.balanceAmount, invoice.currency)}
+                  />
+                </SimpleGrid>
+              </Stack>
+            </Card>
 
-        <Card>
-          <Stack gap="md">
-            <Text fw={600} c="edr-text">
-              Line items
-            </Text>
-            <Table striped withRowBorders={false} verticalSpacing="xs">
-              <Table.Thead>
-                <Table.Tr>
-                  <Table.Th>Description</Table.Th>
-                  <Table.Th>Charge type</Table.Th>
-                  <Table.Th ta="right">Quantity</Table.Th>
-                  <Table.Th ta="right">Unit rate</Table.Th>
-                  <Table.Th ta="right">Amount</Table.Th>
-                </Table.Tr>
-              </Table.Thead>
-              <Table.Tbody>
-                {(invoice.lines ?? []).map((line) => (
-                  <Table.Tr key={line.id}>
-                    <Table.Td>{line.description ?? line.chargeType}</Table.Td>
-                    <Table.Td>
-                      <Text size="sm" c="dimmed">
-                        {humanize(line.chargeType)}
-                      </Text>
-                    </Table.Td>
-                    <Table.Td ta="right">{line.quantity}</Table.Td>
-                    <Table.Td ta="right">
-                      {formatMoney(line.unitRate, line.currency)}
-                    </Table.Td>
-                    <Table.Td ta="right">
-                      {formatMoney(line.amount, line.currency)}
-                    </Table.Td>
-                  </Table.Tr>
-                ))}
-                {(invoice.lines ?? []).length === 0 && (
-                  <Table.Tr>
-                    <Table.Td colSpan={5}>
-                      <Text size="sm" c="dimmed" ta="center" py="md">
-                        No line items.
-                      </Text>
-                    </Table.Td>
-                  </Table.Tr>
-                )}
-              </Table.Tbody>
-            </Table>
+            <EimsFilingCard invoiceId={invoice.id} />
 
-            <Group
-              justify="flex-end"
-              gap="xl"
-              pt="sm"
-              style={{
-                borderTop: "1px solid var(--mantine-color-edr-border-0)",
-              }}
-            >
-              <Stack gap={2} align="flex-end">
-                <Text size="xs" c="edr-muted">
-                  Subtotal
-                </Text>
-                <Text size="sm">
-                  {formatMoney(invoice.subtotalAmount, invoice.currency)}
+            <Card>
+              <Stack gap="md">
+                <Text fw={600} c="edr-text">
+                  Line items
                 </Text>
+                <Table striped withRowBorders={false} verticalSpacing="xs">
+                  <Table.Thead>
+                    <Table.Tr>
+                      <Table.Th>Description</Table.Th>
+                      <Table.Th>Charge type</Table.Th>
+                      <Table.Th ta="right">Quantity</Table.Th>
+                      <Table.Th ta="right">Unit rate</Table.Th>
+                      <Table.Th ta="right">Amount</Table.Th>
+                    </Table.Tr>
+                  </Table.Thead>
+                  <Table.Tbody>
+                    {(invoice.lines ?? []).map((line) => (
+                      <Table.Tr key={line.id}>
+                        <Table.Td>{line.description ?? line.chargeType}</Table.Td>
+                        <Table.Td>
+                          <Text size="sm" c="dimmed">
+                            {humanize(line.chargeType)}
+                          </Text>
+                        </Table.Td>
+                        <Table.Td ta="right">{line.quantity}</Table.Td>
+                        <Table.Td ta="right">
+                          {formatMoney(line.unitRate, line.currency)}
+                        </Table.Td>
+                        <Table.Td ta="right">
+                          {formatMoney(line.amount, line.currency)}
+                        </Table.Td>
+                      </Table.Tr>
+                    ))}
+                    {(invoice.lines ?? []).length === 0 && (
+                      <Table.Tr>
+                        <Table.Td colSpan={5}>
+                          <Text size="sm" c="dimmed" ta="center" py="md">
+                            No line items.
+                          </Text>
+                        </Table.Td>
+                      </Table.Tr>
+                    )}
+                  </Table.Tbody>
+                </Table>
+
+                <Group
+                  justify="flex-end"
+                  gap="xl"
+                  pt="sm"
+                  style={{
+                    borderTop: "1px solid var(--mantine-color-edr-border-0)",
+                  }}
+                >
+                  <Stack gap={2} align="flex-end">
+                    <Text size="xs" c="edr-muted">
+                      Subtotal
+                    </Text>
+                    <Text size="sm">
+                      {formatMoney(invoice.subtotalAmount, invoice.currency)}
+                    </Text>
+                  </Stack>
+                  <Stack gap={2} align="flex-end">
+                    <Text size="xs" c="edr-muted">
+                      Tax
+                    </Text>
+                    <Text size="sm">
+                      {formatMoney(invoice.taxAmount, invoice.currency)}
+                    </Text>
+                  </Stack>
+                  <Stack gap={2} align="flex-end">
+                    <Text size="xs" c="edr-muted">
+                      Paid
+                    </Text>
+                    <Text size="sm">
+                      {formatMoney(invoice.paidAmount, invoice.currency)}
+                    </Text>
+                  </Stack>
+                  <Stack gap={2} align="flex-end">
+                    <Text size="xs" fw={700}>
+                      Total
+                    </Text>
+                    <Text size="sm" fw={700}>
+                      {formatMoney(invoice.totalAmount, invoice.currency)}
+                    </Text>
+                  </Stack>
+                </Group>
               </Stack>
-              <Stack gap={2} align="flex-end">
-                <Text size="xs" c="edr-muted">
-                  Tax
-                </Text>
-                <Text size="sm">
-                  {formatMoney(invoice.taxAmount, invoice.currency)}
-                </Text>
-              </Stack>
-              <Stack gap={2} align="flex-end">
-                <Text size="xs" c="edr-muted">
-                  Paid
-                </Text>
-                <Text size="sm">
-                  {formatMoney(invoice.paidAmount, invoice.currency)}
-                </Text>
-              </Stack>
-              <Stack gap={2} align="flex-end">
-                <Text size="xs" fw={700}>
-                  Total
-                </Text>
-                <Text size="sm" fw={700}>
-                  {formatMoney(invoice.totalAmount, invoice.currency)}
-                </Text>
-              </Stack>
-            </Group>
+            </Card>
           </Stack>
-        </Card>
-      </Stack>
+        </Grid.Col>
+
+        <Grid.Col span={{ base: 12, lg: 4 }}>
+          <Stack gap="lg">
+            <RecipientCard invoice={invoice} />
+            <SourceCard invoice={invoice} />
+          </Stack>
+        </Grid.Col>
+      </Grid>
     </PageContainer>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/invoices/InvoicesPage.tsx b/apps/edr-freight-web/backoffice/src/pages/invoices/InvoicesPage.tsx
index fd839de16..159157e2f 100644
--- a/apps/edr-freight-web/backoffice/src/pages/invoices/InvoicesPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/invoices/InvoicesPage.tsx
@@ -11,7 +11,14 @@ import {
 } from "@mantine/core";
 import { useDebouncedValue } from "@mantine/hooks";
 import { useQuery } from "@tanstack/react-query";
-import { RefreshCw, Search, X } from "lucide-react";
+import {
+  Banknote,
+  CircleDollarSign,
+  Landmark,
+  RefreshCw,
+  Search,
+  X,
+} from "lucide-react";
 import { useMemo, useState } from "react";
 import { useNavigate } from "react-router-dom";
 
@@ -21,7 +28,9 @@ import {
   formatMoney,
   humanize,
 } from "@/components/customers";
-import { PageContainer, PageHeader } from "@/components/page";
+import { KpiStrip } from "@/components/page";
+import CreditInvoiceActions from "@/components/shipping-lines/CreditInvoiceActions";
+import { useExchangeSettingsQuery } from "@/hooks/useExchangeSettings";
 import { api } from "@/services/api";
 import type { Invoice } from "@/types/invoice";
 import {
@@ -31,7 +40,8 @@ import {
   type ColumnDef,
 } from "@edr/ui-common";
 
-export default function InvoicesPage() {
+/** Invoices tab body of `FinanceHubPage` — page chrome lives in the parent. */
+export default function InvoicesPanel() {
   const navigate = useNavigate();
   const { pagination, setPagination } = usePagination({ pageSize: 10 });
   const [query, setQuery] = useState("");
@@ -58,6 +68,41 @@ export default function InvoicesPage() {
   const total = data?.total ?? 0;
   const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
 
+  // Shipping-line credit invoices carry maker–checker actions (mark paid /
+  // cancel). One batched lookup fetches the visible rows' pending requests.
+  const creditInvoiceIds = useMemo(
+    () =>
+      rows
+        .filter((inv) => inv.source === "shipping_line_credit")
+        .map((inv) => inv.id),
+    [rows],
+  );
+  const { data: pendingActions } = useQuery(
+    api.shippingLineCredits.pendingInvoiceActions.queryOptions({
+      input: { invoiceIds: creditInvoiceIds },
+      enabled: creditInvoiceIds.length > 0,
+    }),
+  );
+  const pendingByInvoice = useMemo(
+    () => new Map((pendingActions ?? []).map((p) => [p.invoiceId, p])),
+    [pendingActions],
+  );
+
+  // Summary card: total collected (paidAmount) across every invoice matching
+  // the current search/status filters, not just the visible page.
+  const { data: summary, isLoading: summaryLoading } = useQuery(
+    api.invoices.collectedSummary.queryOptions({
+      input: {
+        filter: { search: debouncedQuery, status: statusFilter || undefined },
+      },
+    }),
+  );
+  const { data: exchangeSettings } = useExchangeSettingsQuery();
+  const etbCollected = summary?.ETB ?? 0;
+  const usdCollected = summary?.USD ?? 0;
+  const rate = exchangeSettings?.feed?.rate ?? exchangeSettings?.fallbackRate;
+  const etbFromUsd = rate ? usdCollected * rate : null;
+
   const columns: ColumnDef<Invoice>[] = useMemo(
     () => [
       {
@@ -73,8 +118,10 @@ export default function InvoicesPage() {
         id: "billedTo",
         header: "Billed to",
         cell: ({ row }) => (
-          <Text size="sm" c="edr-text">
-            {row.original.company?.name ?? "—"}
+          <Text size="sm" c="edr-text" truncate maw={200}>
+            {row.original.company?.name ??
+              row.original.shippingLineCompany?.name ??
+              "—"}
           </Text>
         ),
       },
@@ -122,117 +169,154 @@ export default function InvoicesPage() {
           </Text>
         ),
       },
+      {
+        id: "actions",
+        header: "Actions",
+        cell: ({ row }) => {
+          const inv = row.original;
+          // Only shipping-line credit invoices have manual maker–checker
+          // actions; every other source settles through its own flow.
+          if (inv.source !== "shipping_line_credit") {
+            return (
+              <Text size="sm" c="dimmed">
+                —
+              </Text>
+            );
+          }
+          return (
+            <CreditInvoiceActions
+              invoice={inv}
+              pendingAction={pendingByInvoice.get(inv.id) ?? null}
+            />
+          );
+        },
+      },
     ],
-    [],
+    [pendingByInvoice],
   );
 
   return (
-    <PageContainer>
-      <PageHeader
-        title="Invoices"
-        subtitle="Every invoice issued across bookings, warehouse fees and clearance charges."
-        action={
-          <ActionIcon
-            variant="default"
-            size="lg"
-            radius="md"
-            aria-label="Refresh"
-            loading={isFetching}
-            onClick={() => void refetch()}
-          >
-            <RefreshCw size={16} />
-          </ActionIcon>
-        }
+    <Stack gap="md">
+      <KpiStrip
+        loading={summaryLoading}
+        items={[
+          {
+            label: "Total collected",
+            hint: etbFromUsd !== null ? "ETB + USD" : "ETB only",
+            value: formatMoney(etbCollected + (etbFromUsd ?? 0), "ETB"),
+            icon: CircleDollarSign,
+            color: "edr-green",
+          },
+          {
+            label: "Collected in ETB",
+            value: formatMoney(etbCollected, "ETB"),
+            icon: Banknote,
+            color: "blue",
+          },
+          {
+            label: "Collected in USD",
+            value: formatMoney(usdCollected, "USD"),
+            icon: Landmark,
+            color: "violet",
+          },
+        ]}
       />
 
       <Card p={0}>
-        <Stack gap={0}>
-          <Box px="md" pt="md" pb="sm" w="100%">
-            <Group justify="space-between" gap="md" wrap="wrap">
-              <TextInput
-                placeholder="Search by invoice number…"
-                leftSection={<Search size={18} />}
-                value={query}
-                onChange={(e) => setQuery(e.target.value)}
-                rightSection={
-                  query ? (
-                    <ActionIcon
-                      size="sm"
-                      color="gray"
-                      radius="md"
-                      variant="transparent"
-                      onClick={() => setQuery("")}
-                    >
-                      <X size={16} />
-                    </ActionIcon>
-                  ) : null
-                }
-                style={{ flex: 1, minWidth: "240px" }}
-                radius="lg"
-              />
-              <SegmentedControl
-                size="sm"
-                radius="md"
-                value={statusFilter || "all"}
-                onChange={(v) => {
-                  setStatusFilter(
-                    v === "all" ? "" : (v as Freight.InvoiceStatus),
-                  );
-                  setPagination((prev) => ({ ...prev, pageIndex: 0 }));
-                }}
-                data={[
-                  { label: "All", value: "all" },
-                  { label: "Pending", value: "PENDING" },
-                  { label: "Payment processing", value: "PAYMENT_PROCESSING" },
-                  { label: "Paid", value: "PAID" },
-                  { label: "Overdue", value: "OVERDUE" },
-                ]}
-              />
-              <Text size="sm" c="dimmed">
-                {total} record{total !== 1 ? "s" : ""}
-              </Text>
-            </Group>
-          </Box>
+      <Stack gap={0}>
+        <Box px="md" pt="md" pb="sm" w="100%">
+          <Group justify="space-between" gap="md" wrap="wrap">
+            <TextInput
+              placeholder="Search by invoice number…"
+              leftSection={<Search size={18} />}
+              value={query}
+              onChange={(e) => setQuery(e.target.value)}
+              rightSection={
+                query ? (
+                  <ActionIcon
+                    size="sm"
+                    color="gray"
+                    radius="md"
+                    variant="transparent"
+                    onClick={() => setQuery("")}
+                  >
+                    <X size={16} />
+                  </ActionIcon>
+                ) : null
+              }
+              style={{ flex: 1, minWidth: "240px" }}
+              radius="lg"
+            />
+            <SegmentedControl
+              size="sm"
+              radius="md"
+              value={statusFilter || "all"}
+              onChange={(v) => {
+                setStatusFilter(
+                  v === "all" ? "" : (v as Freight.InvoiceStatus),
+                );
+                setPagination((prev) => ({ ...prev, pageIndex: 0 }));
+              }}
+              data={[
+                { label: "All", value: "all" },
+                { label: "Pending", value: "PENDING" },
+                { label: "Payment processing", value: "PAYMENT_PROCESSING" },
+                { label: "Paid", value: "PAID" },
+                { label: "Overdue", value: "OVERDUE" },
+              ]}
+            />
+            <ActionIcon
+              variant="default"
+              size="lg"
+              radius="md"
+              aria-label="Refresh"
+              loading={isFetching}
+              onClick={() => void refetch()}
+            >
+              <RefreshCw size={16} />
+            </ActionIcon>
+          </Group>
+        </Box>
 
-          <Box style={{ overflowX: "auto" }} w="100%">
-            <Box miw={920}>
-              <DataTable
-                columns={columns}
-                data={rows}
-                status={isLoading ? "loading" : isError ? "error" : "success"}
-                onRowClick={(row) => navigate(`/dashboard/invoices/${row.id}`)}
-                emptyMessage={
-                  debouncedQuery
-                    ? "No invoices match your search."
-                    : "No invoices yet."
-                }
-                error={
-                  isError
-                    ? {
-                        message: "Failed to load invoices.",
-                        onRetry: () => void refetch(),
-                      }
-                    : undefined
-                }
-                pagination={{
-                  pageIndex: pagination.pageIndex,
-                  pageSize: pagination.pageSize,
-                  pageCount,
-                  totalCount: total,
-                }}
-                tableOptions={{
-                  state: { pagination },
-                  onPaginationChange: setPagination,
-                  manualPagination: true,
-                  pageCount,
-                }}
-                containerClassName="border-0 shadow-none bg-transparent"
-                footer={DataTableFooter}
-              />
-            </Box>
+        <Box style={{ overflowX: "auto" }} w="100%">
+          <Box miw={920}>
+            <DataTable
+              columns={columns}
+              data={rows}
+              status={isLoading ? "loading" : isError ? "error" : "success"}
+              onRowClick={(row) => navigate(`/dashboard/invoices/${row.id}`)}
+              emptyMessage={
+                debouncedQuery
+                  ? "No invoices match your search."
+                  : "No invoices yet."
+              }
+              error={
+                isError
+                  ? {
+                      message: "Failed to load invoices.",
+                      onRetry: () => void refetch(),
+                    }
+                  : undefined
+              }
+              pagination={{
+                pageIndex: pagination.pageIndex,
+                pageSize: pagination.pageSize,
+                pageCount,
+                totalCount: total,
+              }}
+              tableOptions={{
+                state: { pagination },
+                onPaginationChange: setPagination,
+                manualPagination: true,
+                pageCount,
+              }}
+              containerClassName="border-0 shadow-none bg-transparent"
+              footer={DataTableFooter}
+            />
           </Box>
-        </Stack>
+        </Box>
+      </Stack>
       </Card>
-    </PageContainer>
+    </Stack>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/invoices/UsdPaymentsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/invoices/UsdPaymentsPage.tsx
new file mode 100644
index 000000000..5b4da0f43
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/invoices/UsdPaymentsPage.tsx
@@ -0,0 +1,509 @@
+import type { Freight } from "@edr/types";
+import {
+  ActionIcon,
+  Badge,
+  Box,
+  Button,
+  Card,
+  Group,
+  Modal,
+  SegmentedControl,
+  Stack,
+  Text,
+  TextInput,
+  Tooltip,
+} from "@mantine/core";
+import { useDebouncedValue } from "@mantine/hooks";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { CheckCircle2, ExternalLink, RefreshCw, Search, X } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+import { useNavigate } from "react-router-dom";
+import toast from "react-hot-toast";
+
+import {
+  InvoiceStatusBadge,
+  formatMoney,
+  humanize,
+} from "@/components/customers";
+import { PhasedFileDropzone } from "@/components/contracts/PhasedFileDropzone";
+import { useAuth } from "@/auth/useAuth";
+import { useManualPaymentSettingsQuery } from "@/hooks/useManualPaymentSettings";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { api } from "@/services/api";
+import type { OfflineUsdInvoice } from "@/types/invoice";
+import {
+  DataTable,
+  DataTableFooter,
+  usePagination,
+  type ColumnDef,
+} from "@edr/ui-common";
+
+/**
+ * The customer's pay window, counted down live. Finance must confirm the bank
+ * transfer before it closes — past the deadline the booking expires like any
+ * unpaid one and the API refuses the confirmation.
+ */
+function formatRemaining(deadlineMs: number, now: number): string | null {
+  const diff = deadlineMs - now;
+  if (diff <= 0) return null;
+  const total = Math.floor(diff / 1000);
+  const days = Math.floor(total / 86400);
+  const hours = Math.floor((total % 86400) / 3600);
+  const minutes = Math.floor((total % 3600) / 60);
+  const seconds = total % 60;
+  const pad = (n: number) => String(n).padStart(2, "0");
+  return days > 0
+    ? `${days}d ${pad(hours)}:${pad(minutes)}:${pad(seconds)}`
+    : `${pad(hours)}:${pad(minutes)}:${pad(seconds)}`;
+}
+
+/** Ticks once a second while a deadline is set, so window state updates live. */
+function useNow(deadline: string | null): number {
+  const [now, setNow] = useState(() => Date.now());
+  useEffect(() => {
+    if (!deadline) return;
+    const interval = setInterval(() => setNow(Date.now()), 1000);
+    return () => clearInterval(interval);
+  }, [deadline]);
+  return now;
+}
+
+function PayWindowCell({ deadline }: { deadline: string | null }) {
+  const now = useNow(deadline);
+
+  if (!deadline) {
+    return (
+      <Text size="sm" c="dimmed">
+        —
+      </Text>
+    );
+  }
+
+  const remaining = formatRemaining(new Date(deadline).getTime(), now);
+  if (!remaining) {
+    return (
+      <Badge color="red" variant="light" radius="sm">
+        Window closed
+      </Badge>
+    );
+  }
+
+  return (
+    <Text size="sm" fw={600} c="edr-text" ff="monospace">
+      {remaining}
+    </Text>
+  );
+}
+
+/**
+ * "Confirm paid" for one row. Booking invoices are only confirmable while the
+ * booking's pay window is open (the API refuses otherwise): no window yet →
+ * no button; window closed → button disabled with the reason, and it flips
+ * live the second the countdown hits zero. Non-booking invoices (warehouse,
+ * clearance…) have no window and stay confirmable.
+ */
+function ConfirmCell({
+  row,
+  onConfirm,
+}: {
+  row: OfflineUsdInvoice;
+  onConfirm: (row: OfflineUsdInvoice) => void;
+}) {
+  const deadline = row.booking?.paymentDeadline ?? null;
+  const now = useNow(deadline);
+
+  if (row.booking && !deadline) return null;
+  const closed = Boolean(deadline && new Date(deadline).getTime() <= now);
+
+  return (
+    <Tooltip
+      label="Pay window closed — the booking can no longer be confirmed as paid."
+      disabled={!closed}
+      withArrow
+    >
+      <span>
+        <Button
+          size="compact-sm"
+          color="edr-green"
+          leftSection={<CheckCircle2 size={14} />}
+          disabled={closed}
+          onClick={(e) => {
+            e.stopPropagation();
+            onConfirm(row);
+          }}
+        >
+          Confirm paid
+        </Button>
+      </span>
+    </Tooltip>
+  );
+}
+
+/**
+ * Manual Payments tab body of `FinanceHubPage` — page chrome lives in the
+ * parent. Lists open USD and ETB invoices (import and export alike) that
+ * Finance settles by hand; confirming records the payment the same way an
+ * online payment would, so the booking advances identically.
+ */
+export default function UsdPaymentsPanel({
+  currency,
+}: {
+  currency: "USD" | "ETB";
+}) {
+  const navigate = useNavigate();
+  const { pagination, setPagination } = usePagination({ pageSize: 10 });
+  const [query, setQuery] = useState("");
+  const [debouncedQuery] = useDebouncedValue(query, 300);
+  const [statusFilter, setStatusFilter] = useState<"" | Freight.InvoiceStatus>(
+    "",
+  );
+  const [confirming, setConfirming] = useState<OfflineUsdInvoice | null>(null);
+  const [slip, setSlip] = useState<File | null>(null);
+  const [reference, setReference] = useState("");
+
+  const { user } = useAuth();
+  const canConfirm = hasPermission(
+    user,
+    FREIGHT_PERMS.invoices.confirmOffline,
+  );
+
+  // Manual settlement is switched on per currency in Configuration → Manual
+  // payments. FinanceHubPage hides the tab for a disabled currency; this is
+  // the fallback for a direct `?tab=` link, and the API refuses regardless.
+  const { data: manualSettings } = useManualPaymentSettingsQuery();
+  const currencyEnabled = manualSettings
+    ? currency === "ETB"
+      ? manualSettings.etbEnabled
+      : manualSettings.usdEnabled
+    : true;
+
+  const filter = useMemo(
+    () => ({
+      page: pagination.pageIndex + 1,
+      pageSize: pagination.pageSize,
+      search: debouncedQuery,
+      status: statusFilter || undefined,
+      currency,
+    }),
+    [
+      pagination.pageIndex,
+      pagination.pageSize,
+      debouncedQuery,
+      statusFilter,
+      currency,
+    ],
+  );
+
+  const { data, isLoading, isError, refetch, isFetching } = useQuery({
+    ...api.invoices.listOfflineUsd.queryOptions({ input: { filter } }),
+    enabled: currencyEnabled,
+  });
+
+  const confirm = useMutation(api.invoices.confirmOffline.mutationOptions());
+
+  const rows = data?.items ?? [];
+  const total = data?.total ?? 0;
+  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
+
+  const closeConfirm = () => {
+    setConfirming(null);
+    setSlip(null);
+    setReference("");
+  };
+
+  const submitConfirm = async () => {
+    if (!confirming || !slip) return;
+    try {
+      await confirm.mutateAsync({
+        id: confirming.id,
+        file: slip,
+        reference: reference.trim() || undefined,
+      });
+      toast.success(`${confirming.invoiceNumber} confirmed as paid`);
+      closeConfirm();
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "Confirmation failed");
+    }
+  };
+
+  const columns: ColumnDef<OfflineUsdInvoice>[] = useMemo(
+    () => [
+      {
+        id: "invoiceNumber",
+        header: "Invoice",
+        cell: ({ row }) => (
+          <Text size="sm" fw={600} c="edr-text">
+            {row.original.invoiceNumber}
+          </Text>
+        ),
+      },
+      {
+        id: "billedTo",
+        header: "Customer",
+        cell: ({ row }) => (
+          <Text size="sm" c="edr-text" truncate maw={200}>
+            {row.original.company?.name ??
+              row.original.shippingLineCompany?.name ??
+              "—"}
+          </Text>
+        ),
+      },
+      {
+        id: "booking",
+        header: "Booking",
+        cell: ({ row }) => {
+          const booking = row.original.booking;
+          const bookings = row.original.bookings ?? [];
+          if (!booking && bookings.length) {
+            // Shipping-line credit invoice: one link per billed booking.
+            return (
+              <Group gap={4} wrap="wrap" maw={280}>
+                {bookings.map((b) => (
+                  <Button
+                    key={b.id}
+                    variant="subtle"
+                    size="compact-xs"
+                    rightSection={<ExternalLink size={11} />}
+                    onClick={(e) => {
+                      e.stopPropagation();
+                      navigate(`/dashboard/booking-requests/${b.id}`);
+                    }}
+                  >
+                    {b.reference}
+                  </Button>
+                ))}
+              </Group>
+            );
+          }
+          if (!booking) {
+            return (
+              <Text size="sm" c="dimmed">
+                {humanize(row.original.source)}
+              </Text>
+            );
+          }
+          return (
+            <Group gap={6} wrap="nowrap">
+              <Button
+                variant="subtle"
+                size="compact-sm"
+                rightSection={<ExternalLink size={13} />}
+                onClick={(e) => {
+                  e.stopPropagation();
+                  navigate(`/dashboard/booking-requests/${booking.id}`);
+                }}
+              >
+                {booking.reference}
+              </Button>
+              {booking.tradeDirection && (
+                <Badge size="xs" variant="light" radius="sm" color="gray">
+                  {humanize(booking.tradeDirection)}
+                </Badge>
+              )}
+            </Group>
+          );
+        },
+      },
+      {
+        id: "status",
+        header: "Status",
+        cell: ({ row }) => <InvoiceStatusBadge status={row.original.status} />,
+      },
+      {
+        id: "amount",
+        header: "Amount",
+        meta: { headerClassName: "text-right", cellClassName: "text-right" },
+        cell: ({ row }) => (
+          <Text size="sm" fw={600} c="edr-text">
+            {formatMoney(row.original.totalAmount, row.original.currency)}
+          </Text>
+        ),
+      },
+      {
+        id: "balance",
+        header: "Balance",
+        meta: { headerClassName: "text-right", cellClassName: "text-right" },
+        cell: ({ row }) => (
+          <Text size="sm" c="dimmed">
+            {formatMoney(row.original.balanceAmount, row.original.currency)}
+          </Text>
+        ),
+      },
+      {
+        id: "payWindow",
+        header: "Pay window",
+        meta: { headerClassName: "text-right", cellClassName: "text-right" },
+        cell: ({ row }) => (
+          <PayWindowCell deadline={row.original.booking?.paymentDeadline ?? null} />
+        ),
+      },
+      {
+        id: "action",
+        header: "",
+        meta: { headerClassName: "text-right", cellClassName: "text-right" },
+        cell: ({ row }) => {
+          if (row.original.status === "PAID" || !canConfirm) return null;
+          if (!currencyEnabled) return null;
+          return <ConfirmCell row={row.original} onConfirm={setConfirming} />;
+        },
+      },
+    ],
+    [canConfirm, currencyEnabled, navigate],
+  );
+
+  return (
+    <>
+      <Card p={0}>
+        <Stack gap={0}>
+          <Box px="md" pt="md" pb="sm" w="100%">
+            <Group justify="space-between" gap="md" wrap="wrap">
+              <TextInput
+                placeholder="Search by invoice number…"
+                leftSection={<Search size={18} />}
+                value={query}
+                onChange={(e) => setQuery(e.target.value)}
+                rightSection={
+                  query ? (
+                    <ActionIcon
+                      size="sm"
+                      color="gray"
+                      radius="md"
+                      variant="transparent"
+                      onClick={() => setQuery("")}
+                    >
+                      <X size={16} />
+                    </ActionIcon>
+                  ) : null
+                }
+                style={{ flex: 1, minWidth: "240px" }}
+                radius="lg"
+              />
+              <SegmentedControl
+                size="sm"
+                radius="md"
+                value={statusFilter || "open"}
+                onChange={(v) => {
+                  setStatusFilter(
+                    v === "open" ? "" : (v as Freight.InvoiceStatus),
+                  );
+                  setPagination((prev) => ({ ...prev, pageIndex: 0 }));
+                }}
+                data={[
+                  { label: "Awaiting payment", value: "open" },
+                  { label: "Paid", value: "PAID" },
+                  { label: "Overdue", value: "OVERDUE" },
+                ]}
+              />
+              <ActionIcon
+                variant="default"
+                size="lg"
+                radius="md"
+                aria-label="Refresh"
+                loading={isFetching}
+                onClick={() => void refetch()}
+              >
+                <RefreshCw size={16} />
+              </ActionIcon>
+            </Group>
+          </Box>
+
+          <Box style={{ overflowX: "auto" }} w="100%">
+            <Box miw={1160}>
+              <DataTable
+                columns={columns}
+                data={rows}
+                status={isLoading ? "loading" : isError ? "error" : "success"}
+                onRowClick={(row) => navigate(`/dashboard/invoices/${row.id}`)}
+                emptyMessage={
+                  !currencyEnabled
+                    ? `Manual payment is switched off for ${currency} invoices. Enable it in Configuration → Manual payments.`
+                    : debouncedQuery
+                      ? "No invoices match your search."
+                      : `No ${currency} invoices awaiting manual payment confirmation.`
+                }
+                error={
+                  isError
+                    ? {
+                        message: "Failed to load invoices.",
+                        onRetry: () => void refetch(),
+                      }
+                    : undefined
+                }
+                pagination={{
+                  pageIndex: pagination.pageIndex,
+                  pageSize: pagination.pageSize,
+                  pageCount,
+                  totalCount: total,
+                }}
+                tableOptions={{
+                  state: { pagination },
+                  onPaginationChange: setPagination,
+                  manualPagination: true,
+                  pageCount,
+                }}
+                containerClassName="border-0 shadow-none bg-transparent"
+                footer={DataTableFooter}
+              />
+            </Box>
+          </Box>
+        </Stack>
+      </Card>
+
+      <Modal
+        opened={confirming !== null}
+        onClose={closeConfirm}
+        title={
+          <Text fw={700}>Confirm manual payment</Text>
+        }
+        radius="md"
+        size="md"
+      >
+        {confirming && (
+          <Stack gap="md">
+            <Text size="sm" c="dimmed">
+              Confirming settles {confirming.invoiceNumber} in full (
+              {formatMoney(confirming.balanceAmount, confirming.currency)}) and
+              marks the booking as paid — exactly as if the customer had paid
+              online. Upload the customer&apos;s bank slip or receipt first —
+              this cannot be undone.
+            </Text>
+
+            <PhasedFileDropzone
+              label="Payment slip / receipt"
+              description="PDF or image of the customer's bank transfer slip or payment receipt."
+              value={slip}
+              onChange={setSlip}
+            />
+
+            <TextInput
+              label="Payment reference"
+              description="Optional — the transfer or receipt reference from the slip."
+              placeholder="e.g. FT24091234567"
+              value={reference}
+              onChange={(e) => setReference(e.target.value)}
+            />
+
+            <Group justify="flex-end" gap="sm">
+              <Button
+                variant="default"
+                onClick={closeConfirm}
+                disabled={confirm.isPending}
+              >
+                Cancel
+              </Button>
+              <Button
+                color="edr-green"
+                loading={confirm.isPending}
+                disabled={!slip}
+                leftSection={<CheckCircle2 size={16} />}
+                onClick={() => void submitConfirm()}
+              >
+                Confirm as paid
+              </Button>
+            </Group>
+          </Stack>
+        )}
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/operations/EdrTruckExitPapersModal.tsx b/apps/edr-freight-web/backoffice/src/pages/operations/EdrTruckExitPapersModal.tsx
index b35af1e7c..6a8b25347 100644
--- a/apps/edr-freight-web/backoffice/src/pages/operations/EdrTruckExitPapersModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/operations/EdrTruckExitPapersModal.tsx
@@ -7,6 +7,7 @@ import { warehouseService } from "@/services/warehouse.service";
 import type { LastMileRecord } from "@/services/last-mile.service";
 import { extractDownloadErrorMessage } from "@/components/warehouses/options";
 import { openPdfBlob } from "@/components/warehouses/pdf";
+import { formatDateTime } from "@/lib/format";
 
 interface EdrTruckExitPapersModalProps {
   opened: boolean;
@@ -14,8 +15,6 @@ interface EdrTruckExitPapersModalProps {
   record: LastMileRecord | null;
 }
 
-const fmt = (value?: string | null) =>
-  value ? new Date(value).toLocaleString() : "—";
 
 /**
  * Per-truck exit papers for an EDR last-mile delivery. Each assigned truck has
@@ -87,11 +86,11 @@ export function EdrTruckExitPapersModal({ opened, onClose, record }: EdrTruckExi
                       <Text size="sm">{load}</Text>
                     </Table.Td>
                     <Table.Td>
-                      <Text size="sm">{fmt(t.arrivedAt)}</Text>
+                      <Text size="sm">{formatDateTime(t.arrivedAt)}</Text>
                     </Table.Td>
                     <Table.Td>
                       {t.departedAt ? (
-                        <Text size="sm">{fmt(t.departedAt)}</Text>
+                        <Text size="sm">{formatDateTime(t.departedAt)}</Text>
                       ) : (
                         <Badge size="sm" variant="light" color="gray">
                           Still on site
diff --git a/apps/edr-freight-web/backoffice/src/pages/operations/FirstMilePage.tsx b/apps/edr-freight-web/backoffice/src/pages/operations/FirstMilePage.tsx
index 192a748c3..ae9bd3b21 100644
--- a/apps/edr-freight-web/backoffice/src/pages/operations/FirstMilePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/operations/FirstMilePage.tsx
@@ -1139,7 +1139,11 @@ const FirstMilePage = () => {
         id: "customer",
         header: "Customer",
         meta: { headerClassName, cellClassName },
-        cell: ({ row }) => customerName(row.original),
+        cell: ({ row }) => (
+          <Text size="sm" truncate maw={200}>
+            {customerName(row.original)}
+          </Text>
+        ),
       },
       {
         id: "postPayment",
@@ -1189,7 +1193,7 @@ const FirstMilePage = () => {
         id: "exactKm",
         header: "Actual Distance (KM)",
         meta: { headerClassName, cellClassName },
-        cell: ({ row }) => row.original.exactKm != null ? row.original.exactKm : <Text c="dimmed">—</Text>,
+        cell: ({ row }) => row.original.exactKm != null ? `${row.original.exactKm} km` : <Text c="dimmed">—</Text>,
       },
       {
         id: "invoice",
diff --git a/apps/edr-freight-web/backoffice/src/pages/operations/LastMilePage.tsx b/apps/edr-freight-web/backoffice/src/pages/operations/LastMilePage.tsx
index 99c6e0416..9f7198609 100644
--- a/apps/edr-freight-web/backoffice/src/pages/operations/LastMilePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/operations/LastMilePage.tsx
@@ -1296,7 +1296,11 @@ const LastMilePage = () => {
         id: "customer",
         header: "Customer",
         meta: { headerClassName, cellClassName },
-        cell: ({ row }) => customerName(row.original),
+        cell: ({ row }) => (
+          <Text size="sm" truncate maw={200}>
+            {customerName(row.original)}
+          </Text>
+        ),
       },
       {
         id: "postPayment",
@@ -1346,7 +1350,7 @@ const LastMilePage = () => {
         id: "exactKm",
         header: "Actual Distance (KM)",
         meta: { headerClassName, cellClassName },
-        cell: ({ row }) => row.original.exactKm != null ? row.original.exactKm : <Text c="dimmed">—</Text>,
+        cell: ({ row }) => row.original.exactKm != null ? `${row.original.exactKm} km` : <Text c="dimmed">—</Text>,
       },
       {
         id: "invoice",
diff --git a/apps/edr-freight-web/backoffice/src/pages/payments/PaymentsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/payments/PaymentsPage.tsx
index 60044e550..a560b3291 100644
--- a/apps/edr-freight-web/backoffice/src/pages/payments/PaymentsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/payments/PaymentsPage.tsx
@@ -8,7 +8,6 @@ import {
   Select,
   Stack,
   Tabs,
-  Text,
   TextInput,
 } from "@mantine/core";
 import {
@@ -25,7 +24,8 @@ import { useMemo, useState } from "react";
 
 import { useQuery } from "@tanstack/react-query";
 
-import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
+import { KpiStrip } from "@/components/page";
+import { formatDate, formatMoney } from "@/lib/format";
 import { api } from "@/services/api";
 import type { PaymentMethod, PaymentRow } from "@/services/payments.service";
 import {
@@ -80,28 +80,11 @@ const STATUS_COLORS: Record<string, string> = {
   refunded: "indigo",
 };
 
-function formatAmount(amount: number, currency: string): string {
-  return `${currency} ${Number(amount).toLocaleString(undefined, {
-    minimumFractionDigits: 2,
-  })}`;
-}
-
-function formatDate(iso: string | null): string {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  return Number.isNaN(d.getTime())
-    ? "—"
-    : d.toLocaleDateString(undefined, {
-      year: "numeric",
-      month: "short",
-      day: "numeric",
-    });
-}
-
 const tableHeader =
   "text-xs font-semibold uppercase tracking-wide text-muted-foreground";
 
-export default function PaymentsPage() {
+/** Payments tab body of `FinanceHubPage` — page chrome lives in the parent. */
+export default function PaymentsPanel() {
   const { pagination, setPagination } = usePagination({ pageSize: 10 });
   const [query, setQuery] = useState("");
   const [statusTab, setStatusTab] = useState<StatusTabKey>("all");
@@ -165,7 +148,7 @@ export default function PaymentsPage() {
       header: () => <span className={tableHeader}>Amount</span>,
       cell: ({ row }) => (
         <span className="font-mono text-sm font-semibold tabular-nums text-foreground">
-          {formatAmount(row.original.amount, row.original.currency)}
+          {formatMoney(row.original.amount, row.original.currency, 2)}
         </span>
       ),
     },
@@ -205,12 +188,7 @@ export default function PaymentsPage() {
   ];
 
   return (
-    <PageContainer>
-      <PageHeader
-        title="Payments"
-        subtitle="View and reconcile booking payment transactions."
-      />
-
+    <Stack gap="lg">
       <KpiStrip
         loading={summaryLoading}
         items={[
@@ -331,9 +309,6 @@ export default function PaymentsPage() {
                 }}
                 style={{ minWidth: 180 }}
               />
-              <Text size="sm" c="dimmed">
-                {total} record{total !== 1 ? "s" : ""}
-              </Text>
             </Group>
           </Box>
 
@@ -360,6 +335,6 @@ export default function PaymentsPage() {
           </Box>
         </Stack>
       </Card>
-    </PageContainer>
+    </Stack>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/DocumentRail.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/DocumentRail.tsx
new file mode 100644
index 000000000..a5cea78b8
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/DocumentRail.tsx
@@ -0,0 +1,163 @@
+import { ActionIcon, Box, Button, Group, Stack, Text, Tooltip } from "@mantine/core";
+import { ChevronDown, ChevronUp, Plus } from "lucide-react";
+
+export interface RailItem {
+  id: string;
+  label: string;
+  /** Renders as a small caps heading above the items that follow it. */
+  heading?: string;
+  /** Nested one level (an FAQ question under its group). */
+  indented?: boolean;
+}
+
+interface DocumentRailProps {
+  items: RailItem[];
+  selectedId: string | null;
+  onSelect: (id: string) => void;
+  onMove: (id: string, delta: number) => void;
+  /** Whether this row can move in the given direction. */
+  canMove: (id: string, delta: number) => boolean;
+  addLabel: string;
+  onAdd: () => void;
+  emptyLabel: string;
+}
+
+/**
+ * The list of pages that make up a document, and the only navigation on the
+ * tab. Replaces the accordion stack: a public officer editing the privacy
+ * policy sees fifteen page names, clicks one, and edits it — instead of
+ * scrolling a mile of open text boxes trying to find the right one.
+ *
+ * Reorder arrows appear only on the selected row, so the resting state is a
+ * clean list rather than fifteen rows of buttons.
+ */
+export function DocumentRail({
+  items,
+  selectedId,
+  onSelect,
+  onMove,
+  canMove,
+  addLabel,
+  onAdd,
+  emptyLabel,
+}: DocumentRailProps) {
+  return (
+    <Stack
+      gap={4}
+      p="sm"
+      style={{
+        width: 280,
+        flexShrink: 0,
+        alignSelf: "flex-start",
+        background: "#FFFFFF",
+        border: "1px solid var(--mantine-color-gray-2)",
+        borderRadius: "var(--mantine-radius-lg)",
+      }}
+    >
+      {items.length === 0 && (
+        <Text size="sm" c="dimmed" p="sm">
+          {emptyLabel}
+        </Text>
+      )}
+
+      {items.map((item) => {
+        const selected = item.id === selectedId;
+
+        return (
+          <Box key={item.id}>
+            {item.heading && (
+              <Text
+                size="xs"
+                fw={700}
+                c="dimmed"
+                tt="uppercase"
+                mt="sm"
+                mb={4}
+                px="xs"
+                style={{ letterSpacing: "0.04em" }}
+              >
+                {item.heading}
+              </Text>
+            )}
+
+            <Group
+              gap={4}
+              wrap="nowrap"
+              px="xs"
+              py={6}
+              ml={item.indented ? "sm" : 0}
+              onClick={() => onSelect(item.id)}
+              style={{
+                borderRadius: "var(--mantine-radius-sm)",
+                cursor: "pointer",
+                background: selected
+                  ? "var(--mantine-primary-color-light)"
+                  : "transparent",
+              }}
+            >
+              <Text
+                size="sm"
+                fw={selected ? 600 : 400}
+                truncate
+                style={{ flex: 1, minWidth: 0 }}
+              >
+                {item.label || (
+                  <Text span c="dimmed" size="sm">
+                    Untitled
+                  </Text>
+                )}
+              </Text>
+
+              {selected && (
+                <Group gap={0} wrap="nowrap">
+                  <Tooltip label="Move up">
+                    <ActionIcon
+                      size="sm"
+                      variant="subtle"
+                      color="gray"
+                      disabled={!canMove(item.id, -1)}
+                      onClick={(e) => {
+                        e.stopPropagation();
+                        onMove(item.id, -1);
+                      }}
+                    >
+                      <ChevronUp size={14} />
+                    </ActionIcon>
+                  </Tooltip>
+                  <Tooltip label="Move down">
+                    <ActionIcon
+                      size="sm"
+                      variant="subtle"
+                      color="gray"
+                      disabled={!canMove(item.id, 1)}
+                      onClick={(e) => {
+                        e.stopPropagation();
+                        onMove(item.id, 1);
+                      }}
+                    >
+                      <ChevronDown size={14} />
+                    </ActionIcon>
+                  </Tooltip>
+                </Group>
+              )}
+            </Group>
+          </Box>
+        );
+      })}
+
+      <Button
+        variant="subtle"
+        size="sm"
+        mt="xs"
+        leftSection={<Plus size={16} />}
+        onClick={onAdd}
+        styles={{ inner: { justifyContent: "flex-start" } }}
+        fullWidth
+      >
+        {addLabel}
+      </Button>
+    </Stack>
+  );
+}
+
+export default DocumentRail;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/EditorPane.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/EditorPane.tsx
new file mode 100644
index 000000000..2641fe1d1
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/EditorPane.tsx
@@ -0,0 +1,100 @@
+import { Box, Button, Group, Stack, Text, TextInput } from "@mantine/core";
+import { Trash2 } from "lucide-react";
+import type { ReactNode } from "react";
+
+interface EditorPaneProps {
+  /** Large borderless field at the top — the page's own name. */
+  title: string;
+  titlePlaceholder: string;
+  onTitleChange: (next: string) => void;
+  onRemove: () => void;
+  removeLabel: string;
+  children: ReactNode;
+}
+
+/**
+ * The open page. One title, one body, one Remove — everything else about the
+ * document lives in the rail, so this pane stays as close to a blank sheet as
+ * the feature set allows.
+ */
+export function EditorPane({
+  title,
+  titlePlaceholder,
+  onTitleChange,
+  onRemove,
+  removeLabel,
+  children,
+}: EditorPaneProps) {
+  return (
+    <Stack
+      gap="md"
+      p="xl"
+      style={{
+        // Basis keeps the editor readable; it wraps below the rail rather than
+        // being crushed when the window cannot fit both side by side.
+        flex: "1 1 480px",
+        minWidth: 0,
+        background: "#FFFFFF",
+        border: "1px solid var(--mantine-color-gray-2)",
+        borderRadius: "var(--mantine-radius-lg)",
+      }}
+    >
+      <TextInput
+        value={title}
+        placeholder={titlePlaceholder}
+        onChange={(e) => onTitleChange(e.currentTarget.value)}
+        variant="unstyled"
+        styles={{
+          input: {
+            fontSize: "1.6rem",
+            fontWeight: 700,
+            lineHeight: 1.3,
+            height: "auto",
+            padding: 0,
+          },
+        }}
+      />
+
+      <Box
+        style={{ borderTop: "1px solid var(--mantine-color-gray-2)" }}
+        pt="md"
+      >
+        {children}
+      </Box>
+
+      <Group justify="flex-end" pt="xs">
+        <Button
+          variant="subtle"
+          color="red"
+          size="compact-sm"
+          leftSection={<Trash2 size={14} />}
+          onClick={onRemove}
+        >
+          {removeLabel}
+        </Button>
+      </Group>
+    </Stack>
+  );
+}
+
+/** Shown when a document has no pages yet. */
+export function EmptyPane({ message }: { message: string }) {
+  return (
+    <Stack
+      align="center"
+      justify="center"
+      p="xl"
+      style={{
+        flex: 1,
+        minHeight: 320,
+        background: "#FFFFFF",
+        border: "1px solid var(--mantine-color-gray-2)",
+        borderRadius: "var(--mantine-radius-lg)",
+      }}
+    >
+      <Text c="dimmed">{message}</Text>
+    </Stack>
+  );
+}
+
+export default EditorPane;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/FaqWorkspace.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/FaqWorkspace.tsx
new file mode 100644
index 000000000..a6a9db56d
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/FaqWorkspace.tsx
@@ -0,0 +1,231 @@
+import type { PortalFaqContent, PortalFaqGroup } from "@edr/types";
+import { Button, Group, Stack, Text, TextInput } from "@mantine/core";
+import { Plus } from "lucide-react";
+import { useEffect, useState } from "react";
+
+import { moveAt, newId, removeAt, replaceAt } from "./array-helpers";
+import { DocumentRail, type RailItem } from "./DocumentRail";
+import { EditorPane, EmptyPane } from "./EditorPane";
+import { MarkdownEditor } from "./MarkdownEditor";
+
+interface FaqWorkspaceProps {
+  value: PortalFaqContent;
+  onChange: (next: PortalFaqContent) => void;
+  /** Reseed counter — see the `key` on the editor below. */
+  seed: number;
+}
+
+/**
+ * The FAQ is two levels deep, so the rail shows each group as a heading with
+ * its questions beneath — the same outline a customer sees on the page. Picking
+ * a question opens it; picking the group's own row renames or removes it.
+ */
+export function FaqWorkspace({
+  value,
+  onChange,
+  seed,
+}: FaqWorkspaceProps) {
+  const groups = value.groups ?? [];
+
+  const [selectedId, setSelectedId] = useState<string | null>(
+    groups[0]?.items[0]?.id ?? groups[0]?.id ?? null,
+  );
+
+  const setGroups = (next: PortalFaqGroup[]) =>
+    onChange({ ...value, groups: next });
+
+  // Every selectable row, in display order: the group's own row, then its
+  // questions. Flattening once keeps selection and reordering simple.
+  const rows: RailItem[] = groups.flatMap((group) => [
+    { id: group.id, label: group.title || "Untitled group", heading: "Group" },
+    ...group.items.map((item) => ({
+      id: item.id,
+      label: item.question,
+      indented: true,
+    })),
+  ]);
+
+  useEffect(() => {
+    if (!rows.some((row) => row.id === selectedId)) {
+      setSelectedId(rows[0]?.id ?? null);
+    }
+  }, [rows, selectedId]);
+
+  const groupIndex = groups.findIndex((group) => group.id === selectedId);
+  const selectedGroup = groupIndex >= 0 ? groups[groupIndex] : null;
+
+  const ownerIndex = groups.findIndex((group) =>
+    group.items.some((item) => item.id === selectedId),
+  );
+  const owner = ownerIndex >= 0 ? groups[ownerIndex] : null;
+  const itemIndex =
+    owner?.items.findIndex((item) => item.id === selectedId) ?? -1;
+  const selectedItem = owner && itemIndex >= 0 ? owner.items[itemIndex] : null;
+
+  const move = (id: string, delta: number) => {
+    const asGroup = groups.findIndex((group) => group.id === id);
+    if (asGroup >= 0) {
+      setGroups(moveAt(groups, asGroup, delta));
+      return;
+    }
+
+    const at = groups.findIndex((group) =>
+      group.items.some((item) => item.id === id),
+    );
+    if (at < 0) return;
+    const within = groups[at].items.findIndex((item) => item.id === id);
+    setGroups(
+      replaceAt(groups, at, {
+        ...groups[at],
+        items: moveAt(groups[at].items, within, delta),
+      }),
+    );
+  };
+
+  const canMove = (id: string, delta: number) => {
+    const asGroup = groups.findIndex((group) => group.id === id);
+    if (asGroup >= 0) {
+      const target = asGroup + delta;
+      return target >= 0 && target < groups.length;
+    }
+
+    const at = groups.findIndex((group) =>
+      group.items.some((item) => item.id === id),
+    );
+    if (at < 0) return false;
+    const within = groups[at].items.findIndex((item) => item.id === id);
+    const target = within + delta;
+    return target >= 0 && target < groups[at].items.length;
+  };
+
+  const addQuestion = () => {
+    // Add into the group the author is currently in, or the last one.
+    const target = owner ?? selectedGroup ?? groups[groups.length - 1];
+    if (!target) return;
+
+    const at = groups.findIndex((group) => group.id === target.id);
+    const question = { id: newId(), question: "", answer: "" };
+    setGroups(
+      replaceAt(groups, at, {
+        ...target,
+        items: [...target.items, question],
+      }),
+    );
+    setSelectedId(question.id);
+  };
+
+  const addGroup = () => {
+    const group = { id: newId(), title: "New group", items: [] };
+    setGroups([...groups, group]);
+    setSelectedId(group.id);
+  };
+
+  return (
+    // Wraps rather than nowrap: with a fixed 280px rail, a narrow window
+    // squeezed the editor down to ~80px and every embedded picture rendered as
+    // an unreadable sliver. Below roughly 800px the editor now drops under the
+    // list instead.
+    <Group align="flex-start" gap="lg" wrap="wrap">
+      <Stack gap="xs" style={{ flexShrink: 0 }}>
+        <DocumentRail
+          items={rows}
+          selectedId={selectedId}
+          onSelect={setSelectedId}
+          onMove={move}
+          canMove={canMove}
+          addLabel="Add a question"
+          onAdd={addQuestion}
+          emptyLabel="No groups yet — add one to start."
+        />
+        <Button
+          variant="subtle"
+          size="sm"
+          leftSection={<Plus size={16} />}
+          onClick={addGroup}
+        >
+          Add a group
+        </Button>
+      </Stack>
+
+      {selectedItem && owner ? (
+        <EditorPane
+          title={selectedItem.question}
+          titlePlaceholder="What is the customer asking?"
+          onTitleChange={(question) =>
+            setGroups(
+              replaceAt(groups, ownerIndex, {
+                ...owner,
+                items: replaceAt(owner.items, itemIndex, {
+                  ...selectedItem,
+                  question,
+                }),
+              }),
+            )
+          }
+          onRemove={() =>
+            setGroups(
+              replaceAt(groups, ownerIndex, {
+                ...owner,
+                items: removeAt(owner.items, itemIndex),
+              }),
+            )
+          }
+          removeLabel="Delete this question"
+        >
+          <MarkdownEditor
+            // MDXEditor reads `markdown` only on mount — without a key,
+            // switching questions kept the previous answer on screen.
+            key={`${seed}:${selectedItem.id}`}
+            value={selectedItem.answer}
+            onChange={(answer) =>
+              setGroups(
+                replaceAt(groups, ownerIndex, {
+                  ...owner,
+                  items: replaceAt(owner.items, itemIndex, {
+                    ...selectedItem,
+                    answer,
+                  }),
+                }),
+              )
+            }
+          />
+        </EditorPane>
+      ) : selectedGroup ? (
+        <EditorPane
+          title={selectedGroup.title}
+          titlePlaceholder="Group name"
+          onTitleChange={(title) =>
+            setGroups(replaceAt(groups, groupIndex, { ...selectedGroup, title }))
+          }
+          onRemove={() => setGroups(removeAt(groups, groupIndex))}
+          removeLabel="Delete this group and its questions"
+        >
+          <Stack gap="sm">
+            <Text size="sm" c="dimmed">
+              A group is just a heading on the FAQ page. It holds{" "}
+              {selectedGroup.items.length} question
+              {selectedGroup.items.length === 1 ? "" : "s"} — pick one on the
+              left to edit it.
+            </Text>
+            <TextInput
+              label="Group name"
+              value={selectedGroup.title}
+              onChange={(e) =>
+                setGroups(
+                  replaceAt(groups, groupIndex, {
+                    ...selectedGroup,
+                    title: e.currentTarget.value,
+                  }),
+                )
+              }
+            />
+          </Stack>
+        </EditorPane>
+      ) : (
+        <EmptyPane message="Add a group to get started." />
+      )}
+    </Group>
+  );
+}
+
+export default FaqWorkspace;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/Markdown.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/Markdown.tsx
new file mode 100644
index 000000000..3a70754a5
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/Markdown.tsx
@@ -0,0 +1,103 @@
+import { isPortalVideoSrc, PORTAL_MEDIA_URI_SCHEME } from "@edr/types";
+import { Text } from "@mantine/core";
+import { useEffect, useState } from "react";
+import ReactMarkdown, { defaultUrlTransform } from "react-markdown";
+
+import { resolvePreview } from "./MarkdownEditor";
+// Same preflight fix the editor needs — Mantine's `Typography` defines its list
+// and margin rules with `:where()`, which Tailwind's preflight outranks, so
+// bullets rendered without markers here too.
+import "./markdown-editor.css";
+
+/**
+ * Renders one embedded picture or video. Stored copy holds `minio:<key>`, so
+ * the URL has to be signed before it can be shown; until it resolves the slot
+ * stays empty rather than flashing a broken image.
+ */
+function Embed({ src, alt }: { src: string; alt?: string }) {
+  const [resolved, setResolved] = useState<string | null>(
+    src.startsWith(PORTAL_MEDIA_URI_SCHEME) ? null : src,
+  );
+
+  useEffect(() => {
+    let active = true;
+    void resolvePreview(src).then((url) => {
+      if (active) setResolved(url);
+    });
+    return () => {
+      active = false;
+    };
+  }, [src]);
+
+  if (!resolved) return null;
+
+  // Spans, not <figure>: markdown wraps an image in a paragraph, and a
+  // <figure> inside a <p> is invalid HTML the browser silently re-parents —
+  // which dropped every embed after the first.
+  return (
+    <span style={{ display: "block", margin: "1rem 0" }}>
+      {isPortalVideoSrc(resolved) ? (
+        <video
+          src={resolved}
+          controls
+          preload="metadata"
+          style={{ width: "100%", borderRadius: 8, background: "#000" }}
+        />
+      ) : (
+        <img
+          src={resolved}
+          alt={alt ?? ""}
+          style={{ width: "100%", borderRadius: 8 }}
+        />
+      )}
+      {alt && (
+        <Text component="span" display="block" size="sm" c="dimmed" mt={4}>
+          {alt}
+        </Text>
+      )}
+    </span>
+  );
+}
+
+/**
+ * Read-only markdown rendering, used by the Preview toggle and the version
+ * history. Editing goes through `MarkdownEditor` (MDXEditor).
+ *
+ * Same options as the portal's renderer — no `rehype-raw`, no custom
+ * `urlTransform` — so neither app grows an HTML-injection surface.
+ */
+/**
+ * Module scope on purpose. Declared inline, this object is rebuilt on every
+ * render, so React sees a brand-new component type for `img` and remounts
+ * `Embed` each time — which threw away the URL it had just resolved and left
+ * every uploaded picture and video permanently blank.
+ */
+const COMPONENTS = {
+  img: ({ src, alt }: { src?: string; alt?: string }) =>
+    typeof src === "string" ? <Embed src={src} alt={alt} /> : null,
+};
+
+/**
+ * Lets our own `minio:` refs through, and defers everything else to
+ * react-markdown's default vetting (which drops `javascript:` and friends).
+ *
+ * Needed because the default transform allows only http/https/mailto/tel, so
+ * an unresolved `minio:` ref was silently blanked and every uploaded picture
+ * rendered as an empty paragraph. Only the backoffice needs this: the public
+ * bundle has already had these refs replaced with signed https URLs, so the
+ * portal's renderer keeps the stock transform untouched.
+ */
+const urlTransform = (url: string) =>
+  url.startsWith(PORTAL_MEDIA_URI_SCHEME) ? url : defaultUrlTransform(url);
+
+export function Markdown({ children }: { children: string }) {
+  return (
+    <div className="edr-md-content">
+      <ReactMarkdown components={COMPONENTS} urlTransform={urlTransform}>
+        {children}
+      </ReactMarkdown>
+    </div>
+  );
+}
+
+export default Markdown;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/MarkdownEditor.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/MarkdownEditor.tsx
new file mode 100644
index 000000000..81fb78c35
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/MarkdownEditor.tsx
@@ -0,0 +1,192 @@
+import { isPortalVideoSrc, PORTAL_MEDIA_URI_SCHEME } from "@edr/types";
+import { Box, Button, Group, SegmentedControl, Stack, Text } from "@mantine/core";
+import {
+  BlockTypeSelect,
+  BoldItalicUnderlineToggles,
+  CreateLink,
+  InsertThematicBreak,
+  ListsToggle,
+  MDXEditor,
+  type MDXEditorMethods,
+  UndoRedo,
+  headingsPlugin,
+  imagePlugin,
+  linkDialogPlugin,
+  linkPlugin,
+  listsPlugin,
+  markdownShortcutPlugin,
+  quotePlugin,
+  thematicBreakPlugin,
+  toolbarPlugin,
+} from "@mdxeditor/editor";
+import { ImagePlus } from "lucide-react";
+import { useRef, useState } from "react";
+import "@mdxeditor/editor/style.css";
+
+import { portalContentService } from "@/services/portal-content.service";
+
+import { Markdown } from "./Markdown";
+import { MediaDialog } from "./MediaDialog";
+import { videoPosterDataUrl, VIDEO_PLACEHOLDER } from "./video-poster";
+// Undoes Tailwind's preflight inside the editor's content area — see the file.
+import "./markdown-editor.css";
+
+interface MarkdownEditorProps {
+  value: string;
+  onChange: (next: string) => void;
+}
+
+/**
+ * Signed URLs are per-request and short-lived, so previews are memoised for the
+ * life of the page rather than re-signed on every keystroke re-render.
+ */
+const previewCache = new Map<string, Promise<string>>();
+
+/**
+ * Inserted media is stored as `minio:<key>`, never as the signed URL the upload
+ * returns: a presigned URL expires, so persisting one would leave every
+ * embedded picture broken a few hours later. This resolves the ref back to a
+ * temporary URL purely for display.
+ */
+export function resolvePreview(url: string): Promise<string> {
+  if (!url.startsWith(PORTAL_MEDIA_URI_SCHEME)) return Promise.resolve(url);
+
+  const key = url.slice(PORTAL_MEDIA_URI_SCHEME.length);
+  let pending = previewCache.get(key);
+  if (!pending) {
+    pending = portalContentService
+      .mediaUrl(key)
+      // The editor draws every embed as an <img>, so a video src rendered as a
+      // broken box. Swap in a frame grabbed from the video itself.
+      .then((signed) =>
+        isPortalVideoSrc(key) ? videoPosterDataUrl(signed) : signed,
+      )
+      .catch(() => (isPortalVideoSrc(key) ? VIDEO_PLACEHOLDER : url));
+    previewCache.set(key, pending);
+  }
+  return pending;
+}
+
+export function MarkdownEditor({ value, onChange }: MarkdownEditorProps) {
+  const editorRef = useRef<MDXEditorMethods>(null);
+  const [mediaOpen, setMediaOpen] = useState(false);
+  const [mode, setMode] = useState<"write" | "preview">("write");
+
+  return (
+    <Stack gap="sm" style={{ flex: 1, minHeight: 0 }}>
+      <Group justify="space-between" align="center">
+        <Text size="sm" fw={600} c="dimmed">
+          Page text
+        </Text>
+        <SegmentedControl
+          size="xs"
+          value={mode}
+          onChange={(next) => setMode(next as "write" | "preview")}
+          data={[
+            { label: "Write", value: "write" },
+            { label: "Preview", value: "preview" },
+          ]}
+        />
+      </Group>
+
+      {mode === "write" ? (
+        <Box
+          style={{
+            border: "1px solid var(--mantine-color-gray-3)",
+            borderRadius: "var(--mantine-radius-md)",
+            background: "#FFFFFF",
+            overflow: "hidden",
+          }}
+        >
+          <MDXEditor
+            ref={editorRef}
+            markdown={value}
+            contentEditableClassName="edr-md-content"
+            // MDXEditor re-serialises the markdown once on mount, which differs
+            // harmlessly from what was stored (spacing, escaping). Reporting
+            // that as an edit made every tab open "unsaved" and let a Save
+            // write a no-op version, so the normalisation pass is ignored.
+            onChange={(markdown, initialMarkdownNormalize) => {
+              if (!initialMarkdownNormalize) onChange(markdown);
+            }}
+            plugins={[
+              headingsPlugin(),
+              listsPlugin(),
+              quotePlugin(),
+              linkPlugin(),
+              linkDialogPlugin(),
+              thematicBreakPlugin(),
+              // Kept for rendering existing images; its own insert button is
+              // replaced by the one below, which also handles video.
+              imagePlugin({ imagePreviewHandler: resolvePreview }),
+              markdownShortcutPlugin(),
+              toolbarPlugin({
+                toolbarContents: () => (
+                  <>
+                    <UndoRedo />
+                    {/* No underline: markdown has none, so MDXEditor emits a
+                        raw <u> tag — and the portal's renderer drops raw HTML
+                        by design, so the author's emphasis would silently
+                        vanish for the customer. */}
+                    <BoldItalicUnderlineToggles options={["Bold", "Italic"]} />
+                    <BlockTypeSelect />
+                    <ListsToggle />
+                    <CreateLink />
+                    <Button
+                      size="compact-sm"
+                      variant="subtle"
+                      leftSection={<ImagePlus size={16} />}
+                      onClick={() => setMediaOpen(true)}
+                    >
+                      Picture or video
+                    </Button>
+                    <InsertThematicBreak />
+                  </>
+                ),
+              }),
+            ]}
+          />
+        </Box>
+      ) : (
+        <Box
+          p="lg"
+          style={{
+            border: "1px solid var(--mantine-color-gray-3)",
+            borderRadius: "var(--mantine-radius-md)",
+            background: "#FFFFFF",
+            minHeight: 240,
+          }}
+        >
+          {/* The same renderer the customer gets — the only place an author can
+              watch an embedded video actually play before publishing. */}
+          <Markdown>{value || "_This page is empty._"}</Markdown>
+        </Box>
+      )}
+
+      <MediaDialog
+        opened={mediaOpen}
+        onClose={() => setMediaOpen(false)}
+        onInsert={(markdown) => {
+          editorRef.current?.insertMarkdown(`\n\n${markdown}\n\n`);
+          // Inserting through the ref bypasses onChange, so push it ourselves.
+          const next = editorRef.current?.getMarkdown();
+          if (next !== undefined) onChange(next);
+        }}
+      />
+    </Stack>
+  );
+}
+
+/** Reminder of the substitution tokens, shown once per document. */
+export function MarkdownHint() {
+  return (
+    <Text size="xs" c="dimmed">
+      Type <code>{"{{supportEmail}}"}</code>, <code>{"{{supportPhone}}"}</code>,{" "}
+      <code>{"{{supportOffice}}"}</code> or <code>{"{{supportHours}}"}</code>{" "}
+      anywhere and it fills in from the Contact tab — change it once there and
+      every page updates.
+    </Text>
+  );
+}
+
+export default MarkdownEditor;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/MediaDialog.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/MediaDialog.tsx
new file mode 100644
index 000000000..eae3c6f52
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/MediaDialog.tsx
@@ -0,0 +1,230 @@
+import { PORTAL_MEDIA_URI_SCHEME, SUPPORT_MEDIA_MAX_BYTES } from "@edr/types";
+import {
+  Box,
+  Button,
+  Group,
+  Loader,
+  Modal,
+  Progress,
+  Stack,
+  Text,
+  TextInput,
+} from "@mantine/core";
+import { Film, Image as ImageIcon, UploadCloud } from "lucide-react";
+import { useRef, useState } from "react";
+import toast from "react-hot-toast";
+
+import { portalContentService } from "@/services/portal-content.service";
+
+interface MediaDialogProps {
+  opened: boolean;
+  onClose: () => void;
+  /** Receives the markdown to drop at the cursor. */
+  onInsert: (markdown: string) => void;
+}
+
+const MAX_MB = Math.round(SUPPORT_MEDIA_MAX_BYTES / (1024 * 1024));
+
+/**
+ * Adds a picture or video to the text — drop a file, or browse for one.
+ *
+ * Replaces MDXEditor's built-in image dialog, which asks for a URL, only takes
+ * images, and leaves an author who just wants to show a screenshot with nothing
+ * to do. There is deliberately no "paste a link" field: everything lives in the
+ * platform, so nothing an editor inserts can rot because someone else's server
+ * moved a file.
+ *
+ * Uploads return an object key; the markdown stores `minio:<key>` and the API
+ * signs it fresh on every read.
+ */
+export function MediaDialog({ opened, onClose, onInsert }: MediaDialogProps) {
+  const inputRef = useRef<HTMLInputElement>(null);
+  const [uploading, setUploading] = useState(false);
+  const [progress, setProgress] = useState<number | null>(null);
+  const [dragging, setDragging] = useState(false);
+  const [uploaded, setUploaded] = useState<{
+    key: string;
+    kind: "image" | "video";
+    url: string;
+  } | null>(null);
+  const [caption, setCaption] = useState("");
+
+  const reset = () => {
+    setUploaded(null);
+    setCaption("");
+    setDragging(false);
+    if (inputRef.current) inputRef.current.value = "";
+  };
+
+  const close = () => {
+    reset();
+    onClose();
+  };
+
+  const upload = async (file: File) => {
+    if (file.size > SUPPORT_MEDIA_MAX_BYTES) {
+      toast.error(`That file is over ${MAX_MB} MB.`);
+      return;
+    }
+
+    setUploading(true);
+    setProgress(0);
+    try {
+      setUploaded(await portalContentService.uploadMedia(file, setProgress));
+    } catch (error) {
+      const err = error as {
+        code?: string;
+        response?: { data?: { message?: string } };
+      };
+      const message =
+        err.code === "ECONNABORTED"
+          ? "That upload timed out. Check your connection and try again."
+          : (err.response?.data?.message ?? "Upload failed");
+      toast.error(Array.isArray(message) ? message.join(", ") : message);
+    } finally {
+      setUploading(false);
+      setProgress(null);
+      if (inputRef.current) inputRef.current.value = "";
+    }
+  };
+
+  const insert = () => {
+    if (!uploaded) return;
+    // The caption doubles as alt text, so it is worth prompting for.
+    onInsert(`![${caption}](${PORTAL_MEDIA_URI_SCHEME}${uploaded.key})`);
+    close();
+  };
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={close}
+      title="Add a picture or video"
+      size="lg"
+      centered
+    >
+      <Stack gap="md">
+        {!uploaded ? (
+          <Box
+            onDragOver={(e) => {
+              e.preventDefault();
+              setDragging(true);
+            }}
+            onDragLeave={() => setDragging(false)}
+            onDrop={(e) => {
+              e.preventDefault();
+              setDragging(false);
+              const file = e.dataTransfer.files?.[0];
+              if (file) void upload(file);
+            }}
+            onClick={() => inputRef.current?.click()}
+            style={{
+              border: `2px dashed var(--mantine-color-${dragging ? "green" : "gray"}-4)`,
+              background: dragging
+                ? "var(--mantine-color-green-0)"
+                : "var(--mantine-color-gray-0)",
+              borderRadius: "var(--mantine-radius-md)",
+              padding: "2.5rem 1.5rem",
+              textAlign: "center",
+              cursor: "pointer",
+              transition: "background 120ms, border-color 120ms",
+            }}
+          >
+            {uploading ? (
+              <Stack align="center" gap="xs">
+                <Loader size="sm" />
+                <Text size="sm" c="dimmed">
+                  {progress === null
+                    ? "Uploading…"
+                    : `Uploading… ${progress}%`}
+                </Text>
+                {progress !== null && (
+                  <Progress value={progress} w="60%" size="sm" />
+                )}
+              </Stack>
+            ) : (
+              <Stack align="center" gap="xs">
+                <UploadCloud size={32} strokeWidth={1.5} />
+                <Text fw={500}>Drop a file here, or click to browse</Text>
+                <Text size="sm" c="dimmed">
+                  Pictures (PNG, JPG, GIF) and videos (MP4, WebM) up to {MAX_MB} MB
+                </Text>
+              </Stack>
+            )}
+          </Box>
+        ) : (
+          <Stack gap="md">
+            <Box
+              style={{
+                border: "1px solid var(--mantine-color-gray-3)",
+                borderRadius: "var(--mantine-radius-md)",
+                padding: "0.75rem",
+                background: "var(--mantine-color-gray-0)",
+              }}
+            >
+              {uploaded.kind === "video" ? (
+                <video
+                  src={uploaded.url}
+                  controls
+                  style={{ width: "100%", maxHeight: 320, borderRadius: 8 }}
+                />
+              ) : (
+                <img
+                  src={uploaded.url}
+                  alt=""
+                  style={{
+                    width: "100%",
+                    maxHeight: 320,
+                    objectFit: "contain",
+                    borderRadius: 8,
+                  }}
+                />
+              )}
+            </Box>
+
+            <Group gap="xs" c="dimmed">
+              {uploaded.kind === "video" ? (
+                <Film size={16} />
+              ) : (
+                <ImageIcon size={16} />
+              )}
+              <Text size="sm">
+                {uploaded.kind === "video" ? "Video" : "Picture"} uploaded
+              </Text>
+            </Group>
+
+            <TextInput
+              label="Caption"
+              description="Shown under the picture, and read aloud by screen readers. Optional."
+              value={caption}
+              onChange={(e) => setCaption(e.currentTarget.value)}
+              autoFocus
+            />
+          </Stack>
+        )}
+
+        <input
+          ref={inputRef}
+          type="file"
+          accept="image/*,video/*"
+          hidden
+          onChange={(e) => {
+            const file = e.currentTarget.files?.[0];
+            if (file) void upload(file);
+          }}
+        />
+
+        <Group justify="space-between">
+          <Button variant="subtle" onClick={uploaded ? reset : close}>
+            {uploaded ? "Choose a different file" : "Cancel"}
+          </Button>
+          <Button onClick={insert} disabled={!uploaded}>
+            Add to the page
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
+
+export default MediaDialog;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/PortalContentPage.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/PortalContentPage.tsx
new file mode 100644
index 000000000..4fc51174d
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/PortalContentPage.tsx
@@ -0,0 +1,354 @@
+import type {
+  PortalFaqContent,
+  PortalHelpContent,
+  PortalLegalContent,
+  PortalSupportContact,
+  SupportDocPayload,
+  SupportDocSlug,
+} from "@edr/types";
+import {
+  Badge,
+  Button,
+  Card,
+  Group,
+  Loader,
+  Stack,
+  Tabs,
+  Text,
+  TextInput,
+} from "@mantine/core";
+import { History, RotateCcw, Save } from "lucide-react";
+import { useEffect, useRef, useState } from "react";
+
+import { PageContainer, PageHeader } from "@/components/page";
+import {
+  usePortalDoc,
+  useUpdatePortalDoc,
+} from "@/hooks/portal-content/usePortalContentAdmin";
+
+import { FaqWorkspace } from "./FaqWorkspace";
+import { MarkdownHint } from "./MarkdownEditor";
+import { SectionWorkspace } from "./SectionWorkspace";
+import { VersionHistoryModal } from "./VersionHistoryModal";
+
+const TABS: { slug: SupportDocSlug; label: string }[] = [
+  { slug: "CONTACT", label: "Contact" },
+  { slug: "HELP", label: "Help" },
+  { slug: "FAQ", label: "FAQ" },
+  { slug: "PRIVACY", label: "Privacy" },
+  { slug: "TERMS", label: "Terms" },
+];
+
+/**
+ * Edits the copy on the freight portal's public pages — /help, /faq, /terms,
+ * /privacy — and the support contact block all four quote.
+ *
+ * Each tab is a local draft saved in one PATCH of the whole document, rather
+ * than a mutation per field. That is what makes one editorial change equal one
+ * version, which is the difference between a history you can read and a history
+ * of keystrokes.
+ */
+export default function PortalContentPage() {
+  const [active, setActive] = useState<SupportDocSlug>("CONTACT");
+
+  return (
+    <PageContainer>
+      <PageHeader
+        title="Portal content"
+        subtitle="Help, FAQ and legal copy shown to customers on the public portal pages. Body text is markdown, every save is versioned, and any version can be restored."
+      />
+
+      <Tabs
+        value={active}
+        onChange={(value) => setActive(value as SupportDocSlug)}
+        keepMounted={false}
+      >
+        <Tabs.List mb="lg">
+          {TABS.map((tab) => (
+            <Tabs.Tab key={tab.slug} value={tab.slug}>
+              {tab.label}
+            </Tabs.Tab>
+          ))}
+        </Tabs.List>
+
+        {TABS.map((tab) => (
+          <Tabs.Panel key={tab.slug} value={tab.slug}>
+            <DocumentTab slug={tab.slug} />
+          </Tabs.Panel>
+        ))}
+      </Tabs>
+    </PageContainer>
+  );
+}
+
+function DocumentTab({ slug }: { slug: SupportDocSlug }) {
+  const { data, isLoading } = usePortalDoc(slug);
+  const update = useUpdatePortalDoc(slug);
+
+  const [draft, setDraft] = useState<SupportDocPayload | null>(null);
+  const [note, setNote] = useState("");
+  const [historyOpen, setHistoryOpen] = useState(false);
+
+  /**
+   * Bumped every time the draft is replaced wholesale rather than edited —
+   * initial load, save, restore, Reset. The editors key off it to remount,
+   * because MDXEditor reads its markdown only on mount and would otherwise
+   * keep showing text the draft no longer holds.
+   */
+  const [seed, setSeed] = useState(0);
+
+  // Reseed only when the server's version number moves (load, save, restore).
+  // Keying off `data` itself would let a background refetch wipe edits that are
+  // still in progress.
+  const seededVersion = useRef<number | null>(null);
+  useEffect(() => {
+    if (data && seededVersion.current !== data.version) {
+      seededVersion.current = data.version;
+      setDraft(data.payload);
+      setNote("");
+      setSeed((n) => n + 1);
+    }
+  }, [data]);
+
+  if (isLoading || !data || !draft) return <Loader size="sm" />;
+
+  const dirty = JSON.stringify(draft) !== JSON.stringify(data.payload);
+
+  const reset = () => {
+    setDraft(data.payload);
+    setNote("");
+    setSeed((n) => n + 1);
+  };
+
+  return (
+    <Stack gap="lg">
+      {/* Sticky: these tabs are long lists, and a Save button that scrolls out
+          of reach is the fastest way to lose an edit. */}
+      <Card
+        withBorder
+        padding="sm"
+        radius="md"
+        style={{
+          position: "sticky",
+          top: 0,
+          zIndex: 2,
+          backgroundColor: "var(--mantine-color-body)",
+        }}
+      >
+        <Group justify="space-between" align="center" wrap="wrap" gap="sm">
+          <Group gap="xs">
+            <Badge variant="light" color={dirty ? "orange" : "gray"}>
+              v{data.version}
+            </Badge>
+            <Text size="sm" c={dirty ? "orange" : "dimmed"}>
+              {dirty ? "Unsaved changes" : "Saved"}
+            </Text>
+          </Group>
+
+          <Group gap="xs" align="center">
+            {dirty && (
+              <TextInput
+                size="sm"
+                placeholder="Change note (optional)"
+                value={note}
+                onChange={(e) => setNote(e.currentTarget.value)}
+                w={240}
+              />
+            )}
+            <Button
+              variant="default"
+              leftSection={<History size={16} />}
+              onClick={() => setHistoryOpen(true)}
+            >
+              History
+            </Button>
+            <Button
+              variant="subtle"
+              leftSection={<RotateCcw size={16} />}
+              disabled={!dirty}
+              onClick={reset}
+            >
+              Reset
+            </Button>
+            <Button
+              leftSection={<Save size={16} />}
+              disabled={!dirty}
+              loading={update.isPending}
+              onClick={() =>
+                update.mutate({ payload: draft, note: note || undefined })
+              }
+            >
+              Save
+            </Button>
+          </Group>
+        </Group>
+      </Card>
+
+      <DocumentEditor
+        slug={slug}
+        value={draft}
+        onChange={setDraft}
+        seed={seed}
+      />
+
+      <VersionHistoryModal
+        slug={slug}
+        opened={historyOpen}
+        onClose={() => setHistoryOpen(false)}
+        hasUnsavedChanges={dirty}
+        onRestored={reset}
+      />
+    </Stack>
+  );
+}
+
+function DocumentEditor({
+  slug,
+  value,
+  onChange,
+  seed,
+}: {
+  slug: SupportDocSlug;
+  value: SupportDocPayload;
+  onChange: (next: SupportDocPayload) => void;
+  /** Reseed counter; bumping it remounts the editors. */
+  seed: number;
+}) {
+  switch (slug) {
+    case "CONTACT":
+      return (
+        <ContactEditor
+          value={value as PortalSupportContact}
+          onChange={onChange}
+        />
+      );
+    case "FAQ":
+      return (
+        <FaqWorkspace
+          value={value as PortalFaqContent}
+          onChange={onChange}
+          seed={seed}
+        />
+      );
+    case "HELP":
+    case "PRIVACY":
+    case "TERMS": {
+      // All three are a title, a subtitle and a list of pages, so they share
+      // one workspace. `sections` is guarded because a row written before the
+      // free-form conversion has none.
+      const doc = value as PortalHelpContent | PortalLegalContent;
+      return (
+        <DocumentShell
+          value={doc}
+          onChange={onChange}
+          showLastUpdated={slug !== "HELP"}
+          seed={seed}
+        />
+      );
+    }
+  }
+}
+
+/**
+ * Title, subtitle and (for the legal documents) the "last updated" line, above
+ * the page list. These three fields describe the whole document, so they sit
+ * apart from the page being edited.
+ */
+function DocumentShell({
+  value,
+  onChange,
+  showLastUpdated,
+  seed,
+}: {
+  value: PortalHelpContent | PortalLegalContent;
+  onChange: (next: SupportDocPayload) => void;
+  showLastUpdated: boolean;
+  seed: number;
+}) {
+  const legal = value as PortalLegalContent;
+
+  return (
+    <Stack gap="lg">
+      <Card withBorder padding="lg" radius="lg" bg="#FFFFFF">
+        <Stack gap="md">
+          <Group grow align="flex-start">
+            <TextInput
+              label="Page title"
+              description="The big heading customers see"
+              value={value.title}
+              onChange={(e) =>
+                onChange({ ...value, title: e.currentTarget.value })
+              }
+            />
+            {showLastUpdated && (
+              <TextInput
+                label="Last updated"
+                description="Free text, e.g. 6 August 2026"
+                value={legal.lastUpdated}
+                onChange={(e) =>
+                  onChange({ ...legal, lastUpdated: e.currentTarget.value })
+                }
+              />
+            )}
+          </Group>
+
+          <TextInput
+            label="Intro line"
+            description="One sentence under the heading"
+            value={value.subtitle}
+            onChange={(e) =>
+              onChange({ ...value, subtitle: e.currentTarget.value })
+            }
+          />
+
+          <MarkdownHint />
+        </Stack>
+      </Card>
+
+      <SectionWorkspace
+        sections={value.sections ?? []}
+        onChange={(sections) => onChange({ ...value, sections })}
+        seed={seed}
+      />
+    </Stack>
+  );
+}
+
+/**
+ * Four fields, so no separate file. These values feed the help page's contact
+ * cards and resolve the `{{supportEmail}}`-style placeholders used throughout
+ * the FAQ and legal copy — editing them here updates every page at once.
+ */
+function ContactEditor({
+  value,
+  onChange,
+}: {
+  value: PortalSupportContact;
+  onChange: (next: PortalSupportContact) => void;
+}) {
+  return (
+    <Stack gap="md" maw={640}>
+      <TextInput
+        label="Support email"
+        value={value.email}
+        onChange={(e) => onChange({ ...value, email: e.currentTarget.value })}
+      />
+      <TextInput
+        label="Support phone"
+        description="Displayed as typed; tel: links strip the spacing automatically."
+        value={value.phone}
+        onChange={(e) => onChange({ ...value, phone: e.currentTarget.value })}
+      />
+      <TextInput
+        label="Head office"
+        value={value.office}
+        onChange={(e) => onChange({ ...value, office: e.currentTarget.value })}
+      />
+      <TextInput
+        label="Support hours"
+        value={value.hours}
+        onChange={(e) => onChange({ ...value, hours: e.currentTarget.value })}
+      />
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/SectionWorkspace.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/SectionWorkspace.tsx
new file mode 100644
index 000000000..d9876391e
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/SectionWorkspace.tsx
@@ -0,0 +1,111 @@
+import type { PortalDocSection } from "@edr/types";
+import { Group, Stack } from "@mantine/core";
+import { useEffect, useState } from "react";
+
+import { moveAt, newId, removeAt, replaceAt } from "./array-helpers";
+import { DocumentRail } from "./DocumentRail";
+import { EditorPane, EmptyPane } from "./EditorPane";
+import { MarkdownEditor } from "./MarkdownEditor";
+
+interface SectionWorkspaceProps {
+  sections: PortalDocSection[];
+  onChange: (next: PortalDocSection[]) => void;
+  /** Reseed counter — see the `key` on the editor below. */
+  seed: number;
+}
+
+/**
+ * Page-at-a-time editing for any document that is a list of sections — the help
+ * page and both legal documents. The list on the left is the document's table
+ * of contents; the pane on the right is the page you are working on.
+ */
+export function SectionWorkspace({
+  sections,
+  onChange,
+  seed,
+}: SectionWorkspaceProps) {
+  const [selectedId, setSelectedId] = useState<string | null>(
+    sections[0]?.id ?? null,
+  );
+
+  // Keep a valid selection when the open page is deleted, or when the tab is
+  // reseeded after a save or a restore.
+  useEffect(() => {
+    if (!sections.some((section) => section.id === selectedId)) {
+      setSelectedId(sections[0]?.id ?? null);
+    }
+  }, [sections, selectedId]);
+
+  const index = sections.findIndex((section) => section.id === selectedId);
+  const selected = index >= 0 ? sections[index] : null;
+
+  const addSection = () => {
+    const section = { id: newId(), heading: "", body: "" };
+    onChange([...sections, section]);
+    setSelectedId(section.id);
+  };
+
+  return (
+    // Wraps rather than nowrap: with a fixed 280px rail, a narrow window
+    // squeezed the editor down to ~80px and every embedded picture rendered as
+    // an unreadable sliver. Below roughly 800px the editor now drops under the
+    // list instead.
+    <Group align="flex-start" gap="lg" wrap="wrap">
+      <DocumentRail
+        items={sections.map((section) => ({
+          id: section.id,
+          label: section.heading,
+        }))}
+        selectedId={selectedId}
+        onSelect={setSelectedId}
+        onMove={(id, delta) =>
+          onChange(
+            moveAt(
+              sections,
+              sections.findIndex((section) => section.id === id),
+              delta,
+            ),
+          )
+        }
+        canMove={(id, delta) => {
+          const at = sections.findIndex((section) => section.id === id);
+          const target = at + delta;
+          return target >= 0 && target < sections.length;
+        }}
+        addLabel="Add a page"
+        onAdd={addSection}
+        emptyLabel="This document has no pages yet."
+      />
+
+      {selected ? (
+        <EditorPane
+          title={selected.heading}
+          titlePlaceholder="Page heading"
+          onTitleChange={(heading) =>
+            onChange(replaceAt(sections, index, { ...selected, heading }))
+          }
+          onRemove={() => onChange(removeAt(sections, index))}
+          removeLabel="Delete this page"
+        >
+          <Stack gap="md">
+            <MarkdownEditor
+              // MDXEditor reads `markdown` only when it mounts, so without a
+              // key it keeps showing the previously-opened page's text. The
+              // counter is in the key too, so save, restore and Reset reseed it
+              // instead of leaving stale content on screen.
+              key={`${seed}:${selected.id}`}
+              value={selected.body}
+              onChange={(body) =>
+                onChange(replaceAt(sections, index, { ...selected, body }))
+              }
+            />
+          </Stack>
+        </EditorPane>
+      ) : (
+        <EmptyPane message="Add a page to get started." />
+      )}
+    </Group>
+  );
+}
+
+export default SectionWorkspace;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/VersionHistoryModal.tsx b/apps/edr-freight-web/backoffice/src/pages/portal_content/VersionHistoryModal.tsx
new file mode 100644
index 000000000..f9bcbb9d3
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/VersionHistoryModal.tsx
@@ -0,0 +1,198 @@
+import type { SupportDocSlug } from "@edr/types";
+import {
+  Alert,
+  Badge,
+  Button,
+  Card,
+  Group,
+  Loader,
+  Modal,
+  Stack,
+  Text,
+} from "@mantine/core";
+import { AlertTriangle } from "lucide-react";
+import { useState } from "react";
+
+import {
+  usePortalDocVersion,
+  usePortalDocVersions,
+  useRestorePortalVersion,
+} from "@/hooks/portal-content/usePortalContentAdmin";
+
+import { Markdown } from "./Markdown";
+import { summarizeVersion } from "./version-preview";
+
+interface VersionHistoryModalProps {
+  slug: SupportDocSlug;
+  opened: boolean;
+  onClose: () => void;
+  /** True when the tab holds unsaved edits a restore would discard. */
+  hasUnsavedChanges: boolean;
+  onRestored: () => void;
+}
+
+function formatSavedAt(value: string): string {
+  return new Date(value).toLocaleString("en-GB", {
+    day: "numeric",
+    month: "short",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+/**
+ * Version history for one document. Restoring re-saves the old payload as a new
+ * version server-side, so the list only ever grows and a restore is itself
+ * undoable — there is nothing here that can destroy history.
+ */
+export function VersionHistoryModal({
+  slug,
+  opened,
+  onClose,
+  hasUnsavedChanges,
+  onRestored,
+}: VersionHistoryModalProps) {
+  const { data: versions, isLoading } = usePortalDocVersions(slug, opened);
+  const [previewing, setPreviewing] = useState<number | null>(null);
+  const [confirming, setConfirming] = useState<number | null>(null);
+  const { data: preview } = usePortalDocVersion(slug, previewing);
+  const restore = useRestorePortalVersion(slug);
+
+  const close = () => {
+    setPreviewing(null);
+    setConfirming(null);
+    onClose();
+  };
+
+  const latest = versions?.[0]?.version;
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={close}
+      size="xl"
+      title={`Version history — ${slug}`}
+    >
+      <Stack gap="md">
+        {hasUnsavedChanges && (
+          <Alert
+            color="orange"
+            icon={<AlertTriangle size={16} />}
+            title="Unsaved changes"
+          >
+            This tab has edits that have not been saved. Restoring a version
+            discards them.
+          </Alert>
+        )}
+
+        {isLoading && <Loader size="sm" />}
+
+        {versions?.map((version) => (
+          <Card key={version.id} withBorder padding="md" radius="md">
+            <Group justify="space-between" align="flex-start" wrap="nowrap">
+              <Stack gap={2}>
+                <Group gap="xs">
+                  <Text fw={600}>v{version.version}</Text>
+                  {version.version === latest && (
+                    <Badge size="sm" variant="light">
+                      Current
+                    </Badge>
+                  )}
+                  <Text size="sm" c="dimmed">
+                    {formatSavedAt(version.createdAt)}
+                  </Text>
+                </Group>
+                {version.note && (
+                  <Text size="sm" c="dimmed">
+                    {version.note}
+                  </Text>
+                )}
+              </Stack>
+
+              {confirming === version.version ? (
+                <Group gap="xs" wrap="nowrap">
+                  <Text size="sm">Restore v{version.version}?</Text>
+                  <Button
+                    size="xs"
+                    color="red"
+                    loading={restore.isPending}
+                    onClick={() =>
+                      restore.mutate(version.version, {
+                        onSuccess: () => {
+                          onRestored();
+                          close();
+                        },
+                      })
+                    }
+                  >
+                    Confirm
+                  </Button>
+                  <Button
+                    size="xs"
+                    variant="subtle"
+                    onClick={() => setConfirming(null)}
+                  >
+                    Cancel
+                  </Button>
+                </Group>
+              ) : (
+                <Group gap="xs" wrap="nowrap">
+                  <Button
+                    size="xs"
+                    variant="light"
+                    onClick={() =>
+                      setPreviewing(
+                        previewing === version.version ? null : version.version,
+                      )
+                    }
+                  >
+                    {previewing === version.version ? "Hide" : "Preview"}
+                  </Button>
+                  <Button
+                    size="xs"
+                    variant="subtle"
+                    disabled={version.version === latest}
+                    onClick={() => {
+                      setConfirming(version.version);
+                      setPreviewing(null);
+                    }}
+                  >
+                    Restore
+                  </Button>
+                </Group>
+              )}
+            </Group>
+
+            {previewing === version.version && (
+              <Card mt="sm" withBorder padding="sm" radius="sm" bg="gray.0">
+                {preview ? (
+                  <Stack gap="sm">
+                    {summarizeVersion(slug, preview.payload).map((entry, i) => (
+                      <Stack key={`${entry.label}-${i}`} gap={2}>
+                        <Text size="sm" fw={600}>
+                          {entry.label}
+                        </Text>
+                        <Markdown>{entry.body}</Markdown>
+                      </Stack>
+                    ))}
+                  </Stack>
+                ) : (
+                  <Loader size="xs" />
+                )}
+              </Card>
+            )}
+          </Card>
+        ))}
+
+        {versions?.length === 0 && (
+          <Text size="sm" c="dimmed">
+            No history yet.
+          </Text>
+        )}
+      </Stack>
+    </Modal>
+  );
+}
+
+export default VersionHistoryModal;
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/array-helpers.ts b/apps/edr-freight-web/backoffice/src/pages/portal_content/array-helpers.ts
new file mode 100644
index 000000000..3a3ae40b0
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/array-helpers.ts
@@ -0,0 +1,24 @@
+/** Immutable list edits shared by the three payload editors. */
+
+export function replaceAt<T>(items: T[], index: number, next: T): T[] {
+  return items.map((item, i) => (i === index ? next : item));
+}
+
+export function removeAt<T>(items: T[], index: number): T[] {
+  return items.filter((_, i) => i !== index);
+}
+
+/**
+ * Swaps an item with its neighbour. Out-of-range moves return the list
+ * unchanged, so the ▲/▼ buttons need no disabled-state bookkeeping of their own.
+ */
+export function moveAt<T>(items: T[], index: number, delta: number): T[] {
+  const target = index + delta;
+  if (target < 0 || target >= items.length) return items;
+
+  const next = [...items];
+  [next[index], next[target]] = [next[target], next[index]];
+  return next;
+}
+
+export const newId = () => crypto.randomUUID();
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/markdown-editor.css b/apps/edr-freight-web/backoffice/src/pages/portal_content/markdown-editor.css
new file mode 100644
index 000000000..e5766ff1a
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/markdown-editor.css
@@ -0,0 +1,119 @@
+/*
+ * Tailwind's preflight zeroes margins on `p`, strips `list-style` from `ul`/`ol`
+ * and flattens heading sizes. MDXEditor's own stylesheet assumes browser
+ * defaults, so inside this app its content area renders as one undifferentiated
+ * block — paragraphs run together and bullets lose their markers.
+ *
+ * This restores the handful of element styles the editor needs, scoped to its
+ * content area so nothing leaks back into the rest of the backoffice. It is a
+ * deliberate alternative to pulling in @tailwindcss/typography for one widget.
+ */
+
+.edr-md-content p {
+  margin: 0 0 0.75rem;
+  line-height: 1.6;
+}
+
+.edr-md-content p:last-child {
+  margin-bottom: 0;
+}
+
+.edr-md-content ul,
+.edr-md-content ol {
+  margin: 0 0 0.75rem;
+  padding-left: 1.5rem;
+}
+
+.edr-md-content ul {
+  list-style: disc;
+}
+
+.edr-md-content ol {
+  list-style: decimal;
+}
+
+.edr-md-content li {
+  margin: 0.25rem 0;
+  line-height: 1.6;
+}
+
+/* Nested lists — the editor's indent button produces these. */
+.edr-md-content li > ul,
+.edr-md-content li > ol {
+  margin: 0.25rem 0 0;
+}
+
+.edr-md-content h1,
+.edr-md-content h2,
+.edr-md-content h3,
+.edr-md-content h4 {
+  font-weight: 700;
+  line-height: 1.3;
+  margin: 1rem 0 0.5rem;
+}
+
+.edr-md-content h1 {
+  font-size: 1.5rem;
+}
+
+.edr-md-content h2 {
+  font-size: 1.25rem;
+}
+
+.edr-md-content h3 {
+  font-size: 1.1rem;
+}
+
+.edr-md-content h4 {
+  font-size: 1rem;
+}
+
+.edr-md-content strong {
+  font-weight: 600;
+}
+
+.edr-md-content em {
+  font-style: italic;
+}
+
+.edr-md-content a {
+  color: var(--mantine-color-blue-6);
+  text-decoration: underline;
+}
+
+.edr-md-content blockquote {
+  margin: 0 0 0.75rem;
+  padding-left: 0.75rem;
+  border-left: 3px solid var(--mantine-color-gray-3);
+  color: var(--mantine-color-dimmed);
+}
+
+.edr-md-content hr {
+  border: 0;
+  border-top: 1px solid var(--mantine-color-gray-3);
+  margin: 1rem 0;
+}
+
+.edr-md-content code {
+  font-family: var(--mantine-font-family-monospace);
+  font-size: 0.875em;
+  background: var(--mantine-color-gray-1);
+  padding: 0.05rem 0.25rem;
+  border-radius: 3px;
+}
+
+/*
+ * MDXEditor renders its image node with `width="inherit" height="inherit"`
+ * attributes, which collapsed a 720px-wide picture into a ~56x124 sliver.
+ * The `!important` is aimed at those attributes rather than at another
+ * stylesheet — attribute-derived sizing otherwise wins here.
+ */
+.edr-md-content img {
+  display: block;
+  width: auto !important;
+  height: auto !important;
+  max-width: 100%;
+  max-height: 420px;
+  border-radius: 8px;
+  object-fit: contain;
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/version-preview.ts b/apps/edr-freight-web/backoffice/src/pages/portal_content/version-preview.ts
new file mode 100644
index 000000000..42e7fb8ab
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/version-preview.ts
@@ -0,0 +1,79 @@
+import type {
+  PortalFaqContent,
+  PortalHelpContent,
+  PortalLegalContent,
+  PortalSupportContact,
+  SupportDocPayload,
+  SupportDocSlug,
+} from "@edr/types";
+
+export interface PreviewEntry {
+  label: string;
+  /** Markdown, rendered read-only. */
+  body: string;
+}
+
+/**
+ * Flattens a stored payload into labelled markdown blocks for the history
+ * modal. An editor deciding whether to roll back needs to read the wording of
+ * that version — a raw JSON dump technically shows it, but not in a form
+ * anyone can compare legal prose in.
+ */
+export function summarizeVersion(
+  slug: SupportDocSlug,
+  payload: SupportDocPayload,
+): PreviewEntry[] {
+  switch (slug) {
+    case "CONTACT": {
+      const contact = payload as PortalSupportContact;
+      return [
+        { label: "Email", body: contact.email },
+        { label: "Phone", body: contact.phone },
+        { label: "Head office", body: contact.office },
+        { label: "Support hours", body: contact.hours },
+      ];
+    }
+
+    case "HELP": {
+      const help = payload as PortalHelpContent;
+      return [
+        { label: "Title", body: help.title },
+        { label: "Subtitle", body: help.subtitle },
+        // Pictures and videos live in the body, so they render in the preview
+        // alongside the text they belong to — nothing to summarise separately.
+        ...(help.sections ?? []).map((section) => ({
+          label: section.heading,
+          body: section.body,
+        })),
+      ];
+    }
+
+    case "FAQ": {
+      const faq = payload as PortalFaqContent;
+      return [
+        { label: "Title", body: faq.title },
+        ...faq.groups.flatMap((group) =>
+          group.items.map((item) => ({
+            label: `${group.title} — ${item.question}`,
+            body: item.answer,
+          })),
+        ),
+        ...(faq.footer
+          ? [{ label: faq.footer.heading, body: faq.footer.body }]
+          : []),
+      ];
+    }
+
+    case "PRIVACY":
+    case "TERMS": {
+      const legal = payload as PortalLegalContent;
+      return [
+        { label: "Last updated", body: legal.lastUpdated },
+        ...legal.sections.map((section) => ({
+          label: section.heading,
+          body: section.body,
+        })),
+      ];
+    }
+  }
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/portal_content/video-poster.ts b/apps/edr-freight-web/backoffice/src/pages/portal_content/video-poster.ts
new file mode 100644
index 000000000..646292744
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/portal_content/video-poster.ts
@@ -0,0 +1,84 @@
+/**
+ * A grey card with a play triangle, used when a real frame cannot be grabbed
+ * (the object store did not send CORS headers, the codec will not decode, or
+ * the seek timed out). Better than the broken-image icon the editor showed
+ * before, and it still says "this is a video".
+ */
+export const VIDEO_PLACEHOLDER =
+  "data:image/svg+xml;charset=utf-8," +
+  encodeURIComponent(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="640" height="360">
+       <rect width="640" height="360" fill="#1f2933"/>
+       <circle cx="320" cy="180" r="46" fill="#ffffff" fill-opacity="0.9"/>
+       <path d="M305 156 l40 24 -40 24 z" fill="#1f2933"/>
+       <text x="320" y="272" font-family="sans-serif" font-size="20"
+             fill="#ffffff" fill-opacity="0.75" text-anchor="middle">Video</text>
+     </svg>`,
+  );
+
+/** Give up rather than hang the editor on a file that will not decode. */
+const POSTER_TIMEOUT_MS = 8000;
+
+/**
+ * Grabs a single frame from a video URL and returns it as a data URL, so the
+ * editor can show a real thumbnail for an embedded video.
+ *
+ * Done in the browser at preview time on purpose: the alternative is
+ * generating posters server-side on upload, which means ffmpeg, a second
+ * stored object per video and a naming convention to tie them together — all
+ * to produce a picture only editors ever look at. Seeking with
+ * `preload="metadata"` makes the browser range-request just the bytes it needs
+ * rather than the whole file.
+ *
+ * `crossOrigin` is required or the canvas is tainted and `toDataURL` throws;
+ * if the object store does not allow it we fall back to the placeholder.
+ */
+export function videoPosterDataUrl(url: string): Promise<string> {
+  return new Promise((resolve) => {
+    const video = document.createElement("video");
+    let settled = false;
+
+    const finish = (result: string) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      video.removeAttribute("src");
+      video.load();
+      resolve(result);
+    };
+
+    const timer = setTimeout(() => finish(VIDEO_PLACEHOLDER), POSTER_TIMEOUT_MS);
+
+    video.crossOrigin = "anonymous";
+    video.preload = "metadata";
+    video.muted = true;
+    video.playsInline = true;
+
+    video.onloadedmetadata = () => {
+      // A frame just past the start: the very first frame of a screen
+      // recording is usually an empty desktop.
+      video.currentTime = Math.min(1, (video.duration || 2) / 2);
+    };
+
+    video.onseeked = () => {
+      try {
+        const canvas = document.createElement("canvas");
+        canvas.width = video.videoWidth;
+        canvas.height = video.videoHeight;
+        if (!canvas.width || !canvas.height) return finish(VIDEO_PLACEHOLDER);
+
+        const context = canvas.getContext("2d");
+        if (!context) return finish(VIDEO_PLACEHOLDER);
+
+        context.drawImage(video, 0, 0, canvas.width, canvas.height);
+        finish(canvas.toDataURL("image/jpeg", 0.7));
+      } catch {
+        // Tainted canvas — the object store did not send CORS headers.
+        finish(VIDEO_PLACEHOLDER);
+      }
+    };
+
+    video.onerror = () => finish(VIDEO_PLACEHOLDER);
+    video.src = url;
+  });
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/reports/ReportPage.tsx b/apps/edr-freight-web/backoffice/src/pages/reports/ReportPage.tsx
index 71a270a78..16651cdf2 100644
--- a/apps/edr-freight-web/backoffice/src/pages/reports/ReportPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/reports/ReportPage.tsx
@@ -1,445 +1,14 @@
-import {
-  Button,
-  Card,
-  Group,
-  MultiSelect,
-  Select,
-  Text,
-} from "@mantine/core";
-import { DateInput } from "@mantine/dates";
-import { keepPreviousData, useQuery } from "@tanstack/react-query";
-import {
-  DataTable,
-  DataTableFooter,
-  usePagination,
-  type ColumnDef,
-} from "@edr/ui-common";
-import { Download, FileSpreadsheet, Printer, RotateCcw } from "lucide-react";
-import { useMemo } from "react";
-import { useParams, useSearchParams, Link } from "react-router-dom";
-import {
-  Area,
-  AreaChart,
-  Bar,
-  BarChart,
-  CartesianGrid,
-  Legend,
-  Line,
-  LineChart,
-  ResponsiveContainer,
-  Tooltip,
-  XAxis,
-  YAxis,
-} from "recharts";
-import * as XLSX from "xlsx";
-import { ALL_TRADE_DIRECTIONS, TRADE_DIRECTION_LABELS } from "@edr/types";
+import { useParams } from "react-router-dom";
 
-import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
-import { overviewChartColors } from "@/components/overview/overview.styles";
-import { api } from "@/services/api";
-import type { ReportQueryInput, ReportRow } from "@/types/reports";
-import {
-  REPORT_CONFIG_BY_KEY,
-  type ReportColumn,
-  type ReportConfig,
-} from "./reportConfigs";
-
-const compact = new Intl.NumberFormat("en", { notation: "compact" });
-
-const UNIT_SUFFIX = { ETB: " ETB", t: " t", "%": "%", min: " min" } as const;
-
-function formatCell(value: unknown, col: ReportColumn): string {
-  if (value === null || value === undefined || value === "") return "—";
-  if (col.unit || col.numeric) {
-    const n = Number(value);
-    if (!Number.isNaN(n)) {
-      return `${n.toLocaleString()}${col.unit ? UNIT_SUFFIX[col.unit] : ""}`;
-    }
-  }
-  return String(value);
-}
-
-const toDate = (s: string | null): Date | null => (s ? new Date(s) : null);
-// Mantine DateInput onChange emits a date string (or null).
-const toParam = (d: Date | string | null): string | null => {
-  if (!d) return null;
-  return typeof d === "string" ? d.slice(0, 10) : d.toISOString().slice(0, 10);
-};
-
-function downloadBlob(content: BlobPart, type: string, filename: string) {
-  const url = URL.createObjectURL(new Blob([content], { type }));
-  const a = document.createElement("a");
-  a.href = url;
-  a.download = filename;
-  a.click();
-  URL.revokeObjectURL(url);
-}
-
-function exportCsv(config: ReportConfig, rows: ReportRow[]) {
-  const esc = (v: unknown) => `"${String(v ?? "").replace(/"/g, '""')}"`;
-  const lines = [
-    config.columns.map((c) => esc(c.label)).join(","),
-    ...rows.map((r) => config.columns.map((c) => esc(r[c.key])).join(",")),
-  ];
-  downloadBlob(lines.join("\n"), "text/csv;charset=utf-8", `${config.key}.csv`);
-}
-
-function exportXlsx(config: ReportConfig, rows: ReportRow[]) {
-  const sheetRows = rows.map((r) =>
-    Object.fromEntries(config.columns.map((c) => [c.label, r[c.key] ?? ""])),
-  );
-  const wb = XLSX.utils.book_new();
-  XLSX.utils.book_append_sheet(
-    wb,
-    XLSX.utils.json_to_sheet(sheetRows),
-    config.title.slice(0, 31),
-  );
-  XLSX.writeFile(wb, `${config.key}.xlsx`);
-}
-
-function ReportChartView({
-  config,
-  rows,
-}: {
-  config: ReportConfig;
-  rows: ReportRow[];
-}) {
-  const chart = config.chart;
-  const data = useMemo(() => {
-    if (!chart) return [];
-    const sliced = chart.topN ? rows.slice(0, chart.topN) : rows;
-    // xKey "a+b" concatenates columns (e.g. origin+destination → "A → B").
-    const keys = chart.xKey.split("+");
-    return sliced.map((r) => ({
-      ...r,
-      __x:
-        keys.length > 1
-          ? keys.map((k) => String(r[k] ?? "")).join(" → ")
-          : String(r[chart.xKey] ?? ""),
-    }));
-  }, [chart, rows]);
-
-  if (!chart) return null;
-  if (data.length === 0) {
-    return (
-      <Card withBorder shadow="sm">
-        <Text c="dimmed" ta="center" py="xl">
-          No data for the selected filters
-        </Text>
-      </Card>
-    );
-  }
-
-  const ChartComponent =
-    chart.type === "bar" ? BarChart : chart.type === "line" ? LineChart : AreaChart;
-
-  return (
-    <Card withBorder shadow="sm">
-      <ResponsiveContainer width="100%" height={280}>
-        <ChartComponent data={data} margin={{ top: 8, right: 8, left: 8, bottom: 0 }}>
-          <CartesianGrid strokeDasharray="3 3" stroke="#e5e7eb" />
-          <XAxis dataKey="__x" tick={{ fontSize: 12 }} interval="preserveStartEnd" />
-          <YAxis
-            tick={{ fontSize: 12 }}
-            tickFormatter={(v: number) => compact.format(v)}
-            width={56}
-          />
-          <Tooltip formatter={(value) => Number(value ?? 0).toLocaleString()} />
-          {chart.series.length > 1 ? <Legend /> : null}
-          {chart.series.map((s, i) => {
-            const color =
-              overviewChartColors.pipeline[i % overviewChartColors.pipeline.length];
-            if (chart.type === "bar") {
-              return (
-                <Bar key={s.key} dataKey={s.key} name={s.label} fill={color} radius={[4, 4, 0, 0]} />
-              );
-            }
-            if (chart.type === "line") {
-              return (
-                <Line
-                  key={s.key}
-                  type="monotone"
-                  dataKey={s.key}
-                  name={s.label}
-                  stroke={color}
-                  strokeWidth={2}
-                  dot={false}
-                />
-              );
-            }
-            return (
-              <Area
-                key={s.key}
-                type="monotone"
-                dataKey={s.key}
-                name={s.label}
-                stroke={color}
-                fill={color}
-                fillOpacity={0.15}
-                strokeWidth={2}
-              />
-            );
-          })}
-        </ChartComponent>
-      </ResponsiveContainer>
-    </Card>
-  );
-}
+import { ReportView } from "@/components/reports/ReportView";
+import { PageContainer } from "@/components/page";
 
 export default function ReportPage() {
   const { reportKey = "" } = useParams<{ reportKey: string }>();
-  const config = REPORT_CONFIG_BY_KEY.get(reportKey);
-  const [params, setParams] = useSearchParams();
-  const { pagination, setPagination } = usePagination({ pageSize: 20 });
-
-  const setParam = (name: string, value: string | null) => {
-    setParams(
-      (prev) => {
-        if (value) prev.set(name, value);
-        else prev.delete(name);
-        return prev;
-      },
-      { replace: true },
-    );
-    setPagination((p) => ({ ...p, pageIndex: 0 }));
-  };
-
-  const input: ReportQueryInput = {
-    key: reportKey,
-    dateFrom: params.get("dateFrom") ?? undefined,
-    dateTo: params.get("dateTo") ?? undefined,
-    granularity:
-      (params.get("granularity") as ReportQueryInput["granularity"]) ?? undefined,
-    yardIds: params.get("yardIds") ?? undefined,
-    statuses: params.get("statuses") ?? undefined,
-    direction: params.get("direction") ?? undefined,
-    freightType: params.get("freightType") ?? undefined,
-  };
-
-  const reportQuery = useQuery(
-    api.reports.run.queryOptions({
-      input,
-      placeholderData: keepPreviousData,
-      staleTime: 30_000,
-      enabled: Boolean(config),
-    }),
-  );
-
-  const yardsQuery = useQuery(
-    api.routes.yards.queryOptions({
-      staleTime: 5 * 60_000,
-      enabled: Boolean(config?.filters.includes("yards")),
-    }),
-  );
-
-  if (!config) {
-    return (
-      <PageContainer>
-        <PageHeader title="Unknown report" backTo="/dashboard/reports" />
-        <Text>
-          This report does not exist. <Link to="/dashboard/reports">Back to reports</Link>
-        </Text>
-      </PageContainer>
-    );
-  }
-
-  const rows = reportQuery.data?.rows ?? [];
-  const kpis = reportQuery.data?.kpis ?? [];
-  const pageCount = Math.max(1, Math.ceil(rows.length / pagination.pageSize));
-
-  const columns: ColumnDef<ReportRow, unknown>[] = config.columns.map((col) => ({
-    accessorKey: col.key,
-    header: col.label,
-    cell: (info) => formatCell(info.getValue(), col),
-  }));
-
-  const tableStatus = reportQuery.isLoading
-    ? "loading"
-    : reportQuery.isError
-      ? "error"
-      : "success";
 
   return (
     <PageContainer>
-      <PageHeader
-        title={config.title}
-        subtitle={config.description}
-        backTo="/dashboard/reports"
-        action={
-          <Group gap="xs">
-            <Button
-              variant="default"
-              size="xs"
-              leftSection={<Download size={14} />}
-              onClick={() => exportCsv(config, rows)}
-              disabled={rows.length === 0}
-            >
-              CSV
-            </Button>
-            <Button
-              variant="default"
-              size="xs"
-              leftSection={<FileSpreadsheet size={14} />}
-              onClick={() => exportXlsx(config, rows)}
-              disabled={rows.length === 0}
-            >
-              Excel
-            </Button>
-            <Button
-              variant="default"
-              size="xs"
-              leftSection={<Printer size={14} />}
-              onClick={() => window.print()}
-            >
-              Print
-            </Button>
-          </Group>
-        }
-      />
-
-      <Card withBorder shadow="sm">
-        <Group gap="sm" align="flex-end" wrap="wrap">
-          <DateInput
-            label="From"
-            size="xs"
-            clearable
-            value={toDate(params.get("dateFrom"))}
-            maxDate={toDate(params.get("dateTo")) ?? undefined}
-            onChange={(d) => setParam("dateFrom", toParam(d))}
-            placeholder="All time"
-          />
-          <DateInput
-            label="To"
-            size="xs"
-            clearable
-            value={toDate(params.get("dateTo"))}
-            minDate={toDate(params.get("dateFrom")) ?? undefined}
-            onChange={(d) => setParam("dateTo", toParam(d))}
-            placeholder="All time"
-          />
-          {config.filters.includes("granularity") ? (
-            <Select
-              label="Group by"
-              size="xs"
-              data={[
-                { value: "day", label: "Day" },
-                { value: "week", label: "Week" },
-                { value: "month", label: "Month" },
-              ]}
-              value={params.get("granularity") ?? "day"}
-              onChange={(v) => setParam("granularity", v)}
-              allowDeselect={false}
-            />
-          ) : null}
-          {config.filters.includes("yards") ? (
-            <MultiSelect
-              label="Yards"
-              size="xs"
-              searchable
-              clearable
-              w={220}
-              data={(yardsQuery.data ?? []).map((y) => ({
-                value: y.id,
-                label: y.label,
-              }))}
-              value={params.get("yardIds")?.split(",").filter(Boolean) ?? []}
-              onChange={(v) => setParam("yardIds", v.length ? v.join(",") : null)}
-              placeholder="All yards"
-            />
-          ) : null}
-          {config.filters.includes("direction") ? (
-            <Select
-              label="Direction"
-              size="xs"
-              clearable
-              data={ALL_TRADE_DIRECTIONS.map((d) => ({
-                value: d,
-                label: TRADE_DIRECTION_LABELS[d],
-              }))}
-              value={params.get("direction")}
-              onChange={(v) => setParam("direction", v)}
-              placeholder="All"
-            />
-          ) : null}
-          {config.filters.includes("freightType") ? (
-            <Select
-              label="Freight type"
-              size="xs"
-              clearable
-              data={["CONTAINER", "BULK"]}
-              value={params.get("freightType")}
-              onChange={(v) => setParam("freightType", v)}
-              placeholder="All"
-            />
-          ) : null}
-          {config.filters.includes("statuses") && config.statusOptions ? (
-            <MultiSelect
-              label="Status"
-              size="xs"
-              searchable
-              clearable
-              w={220}
-              data={config.statusOptions}
-              value={params.get("statuses")?.split(",").filter(Boolean) ?? []}
-              onChange={(v) => setParam("statuses", v.length ? v.join(",") : null)}
-              placeholder="Default (active)"
-            />
-          ) : null}
-          <Button
-            variant="subtle"
-            size="xs"
-            leftSection={<RotateCcw size={14} />}
-            onClick={() => setParams({}, { replace: true })}
-          >
-            Reset
-          </Button>
-        </Group>
-      </Card>
-
-      <KpiStrip
-        loading={reportQuery.isLoading}
-        items={kpis.map((k) => ({
-          label: k.label,
-          value: k.value.toLocaleString(),
-          hint: k.unit,
-        }))}
-      />
-
-      <ReportChartView config={config} rows={rows} />
-
-      <DataTable
-        columns={columns}
-        data={rows}
-        status={tableStatus}
-        emptyMessage="No data for the selected filters"
-        error={
-          reportQuery.isError
-            ? {
-                message: "Failed to load report",
-                onRetry: () => void reportQuery.refetch(),
-              }
-            : undefined
-        }
-        pagination={{
-          pageIndex: pagination.pageIndex,
-          pageSize: pagination.pageSize,
-          pageCount,
-          totalCount: rows.length,
-        }}
-        tableOptions={{
-          manualPagination: false,
-          state: { pagination },
-          onPaginationChange: setPagination,
-          autoResetPageIndex: false,
-        }}
-        footer={({ table, pagination: p }) => (
-          <DataTableFooter
-            table={table}
-            pagination={p}
-            options={{ labels: { items: "rows" } }}
-          />
-        )}
-      />
+      <ReportView reportKey={reportKey} pageHeader />
     </PageContainer>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/reports/ReportsHubPage.tsx b/apps/edr-freight-web/backoffice/src/pages/reports/ReportsHubPage.tsx
deleted file mode 100644
index f8f6f161d..000000000
--- a/apps/edr-freight-web/backoffice/src/pages/reports/ReportsHubPage.tsx
+++ /dev/null
@@ -1,159 +0,0 @@
-import {
-  ActionIcon,
-  Badge,
-  Card,
-  Group,
-  SimpleGrid,
-  Stack,
-  Text,
-  TextInput,
-  Title,
-} from "@mantine/core";
-import { Search, Star } from "lucide-react";
-import { useMemo, useState } from "react";
-import { useNavigate } from "react-router-dom";
-
-import { PageContainer, PageHeader } from "@/components/page";
-import {
-  REPORT_CONFIGS,
-  REPORT_DOMAINS,
-  type ReportConfig,
-} from "./reportConfigs";
-
-const FAVORITES_KEY = "reports.favorites";
-
-const loadFavorites = (): string[] => {
-  try {
-    return JSON.parse(localStorage.getItem(FAVORITES_KEY) ?? "[]");
-  } catch {
-    return [];
-  }
-};
-
-function ReportCard({
-  config,
-  favorite,
-  onToggleFavorite,
-}: {
-  config: ReportConfig;
-  favorite: boolean;
-  onToggleFavorite: () => void;
-}) {
-  const navigate = useNavigate();
-  return (
-    <Card
-      withBorder
-      shadow="sm"
-      className="cursor-pointer transition-colors hover:bg-gray-50"
-      onClick={() => navigate(`/dashboard/reports/${config.key}`)}
-    >
-      <Group justify="space-between" align="flex-start" wrap="nowrap">
-        <div style={{ minWidth: 0 }}>
-          <Text fw={600} truncate>
-            {config.title}
-          </Text>
-          <Text size="sm" c="dimmed" lineClamp={2}>
-            {config.description}
-          </Text>
-        </div>
-        <ActionIcon
-          variant="subtle"
-          color={favorite ? "yellow" : "gray"}
-          aria-label={favorite ? "Remove from favorites" : "Add to favorites"}
-          onClick={(e) => {
-            e.stopPropagation();
-            onToggleFavorite();
-          }}
-        >
-          <Star size={16} fill={favorite ? "currentColor" : "none"} />
-        </ActionIcon>
-      </Group>
-      <Badge mt="sm" size="sm" variant="light">
-        {config.domain}
-      </Badge>
-    </Card>
-  );
-}
-
-export default function ReportsHubPage() {
-  const [search, setSearch] = useState("");
-  const [favorites, setFavorites] = useState<string[]>(loadFavorites);
-
-  const toggleFavorite = (key: string) => {
-    setFavorites((prev) => {
-      const next = prev.includes(key)
-        ? prev.filter((k) => k !== key)
-        : [...prev, key];
-      localStorage.setItem(FAVORITES_KEY, JSON.stringify(next));
-      return next;
-    });
-  };
-
-  const visible = useMemo(() => {
-    const q = search.trim().toLowerCase();
-    if (!q) return REPORT_CONFIGS;
-    return REPORT_CONFIGS.filter(
-      (c) =>
-        c.title.toLowerCase().includes(q) ||
-        c.description.toLowerCase().includes(q),
-    );
-  }, [search]);
-
-  const pinned = visible.filter((c) => favorites.includes(c.key));
-
-  const renderGrid = (configs: ReportConfig[]) => (
-    <SimpleGrid cols={{ base: 1, sm: 2, lg: 3 }} spacing="md">
-      {configs.map((c) => (
-        <ReportCard
-          key={c.key}
-          config={c}
-          favorite={favorites.includes(c.key)}
-          onToggleFavorite={() => toggleFavorite(c.key)}
-        />
-      ))}
-    </SimpleGrid>
-  );
-
-  return (
-    <PageContainer>
-      <PageHeader
-        title="Reports"
-        subtitle="Operational, commercial and financial reporting"
-        action={
-          <TextInput
-            size="xs"
-            w={240}
-            leftSection={<Search size={14} />}
-            placeholder="Search reports…"
-            value={search}
-            onChange={(e) => setSearch(e.currentTarget.value)}
-          />
-        }
-      />
-
-      {pinned.length ? (
-        <Stack gap="sm">
-          <Title order={4}>Favorites</Title>
-          {renderGrid(pinned)}
-        </Stack>
-      ) : null}
-
-      {REPORT_DOMAINS.map((domain) => {
-        const configs = visible.filter((c) => c.domain === domain);
-        if (!configs.length) return null;
-        return (
-          <Stack key={domain} gap="sm">
-            <Title order={4}>{domain}</Title>
-            {renderGrid(configs)}
-          </Stack>
-        );
-      })}
-
-      {visible.length === 0 ? (
-        <Text c="dimmed" ta="center" py="xl">
-          No reports match “{search}”
-        </Text>
-      ) : null}
-    </PageContainer>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/pages/reports/ReportsLandingPage.tsx b/apps/edr-freight-web/backoffice/src/pages/reports/ReportsLandingPage.tsx
new file mode 100644
index 000000000..98ea19bfc
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/reports/ReportsLandingPage.tsx
@@ -0,0 +1,51 @@
+import { SimpleGrid, Stack } from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import { Navigate } from "react-router-dom";
+
+import { PageContainer, PageHeader } from "@/components/page";
+import { ReportSection } from "@/components/reports/ReportSection";
+import { api } from "@/services/api";
+
+/**
+ * The revenue dashboard the reporting spec asks for, assembled from reports
+ * that already exist rather than a second aggregation API: each tile is a
+ * `ReportSection` opened on its chart, and each one permission-gates itself by
+ * rendering nothing when the caller's catalog lacks that report.
+ */
+const TILES = [
+  "revenue-by-period",
+  "revenue-by-category",
+  "revenue-by-route",
+  "revenue-top-customers",
+];
+
+export default function ReportsLandingPage() {
+  const { data: catalog, isLoading } = useQuery(api.reports.catalog.queryOptions());
+
+  if (isLoading) return null;
+
+  const visible = TILES.filter((key) => catalog?.some((r) => r.key === key));
+
+  // No revenue reports for this user — fall back to the old behaviour and send
+  // them to the first report they can actually open.
+  if (!visible.length) {
+    const first = catalog?.[0];
+    return <Navigate to={first ? `/dashboard/reports/${first.key}` : "/dashboard"} replace />;
+  }
+
+  return (
+    <PageContainer>
+      <Stack gap="lg">
+        <PageHeader
+          title="Revenue dashboard"
+          subtitle="Billed rail revenue by period, category, corridor and customer. Pick any report in the sidebar for the full table, filters and export."
+        />
+        <SimpleGrid cols={{ base: 1, xl: 2 }} spacing="lg">
+          {visible.map((key) => (
+            <ReportSection key={key} reportKey={key} defaultView="chart" />
+          ))}
+        </SimpleGrid>
+      </Stack>
+    </PageContainer>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/reports/reportConfigs.ts b/apps/edr-freight-web/backoffice/src/pages/reports/reportConfigs.ts
deleted file mode 100644
index ced916fbb..000000000
--- a/apps/edr-freight-web/backoffice/src/pages/reports/reportConfigs.ts
+++ /dev/null
@@ -1,445 +0,0 @@
-import { BookingStatus } from "@edr/types";
-
-export type ReportDomain = "Commercial" | "Operations" | "Finance" | "Data";
-
-export type ReportColumnUnit = "ETB" | "t" | "%" | "min";
-
-export interface ReportColumn {
-  key: string;
-  label: string;
-  /** Numeric unit — formats the cell (thousands separators, suffix). */
-  unit?: ReportColumnUnit;
-  numeric?: boolean;
-}
-
-export interface ReportChart {
-  type: "area" | "line" | "bar";
-  xKey: string;
-  series: { key: string; label: string }[];
-  /** Chart only the first N rows (rows arrive sorted by the backend). */
-  topN?: number;
-}
-
-export type ReportFilterKey =
-  | "granularity"
-  | "yards"
-  | "direction"
-  | "freightType"
-  | "statuses";
-
-export interface ReportConfig {
-  key: string;
-  title: string;
-  description: string;
-  domain: ReportDomain;
-  filters: ReportFilterKey[];
-  /** Options for the `statuses` filter, when enabled. */
-  statusOptions?: string[];
-  chart?: ReportChart;
-  columns: ReportColumn[];
-}
-
-// Full enum from @edr/types; Set dedupes the deprecated AwaitingPayment alias.
-const BOOKING_STATUSES = [...new Set(Object.values(BookingStatus))];
-
-// Full list mirroring CONTRACT_STATUSES in contract.entity.ts (no shared enum
-// in @edr/types yet).
-const CONTRACT_STATUSES = [
-  "DRAFT",
-  "SUBMITTED",
-  "PRICE_CHANGED_PENDING_CONFIRM",
-  "CHANGES_REQUESTED",
-  "PENDING_APPROVAL",
-  "APPROVED",
-  "APPROVED_PENDING_SIGNATURE",
-  "CONTRACT_READY",
-  "SIGNED_CUSTOMER",
-  "FULLY_EXECUTED",
-  "CONTRACT_ACTIVE",
-  "AWAITING_CLEARANCE_DOCUMENTS",
-  "CLEARANCE_UNDER_REVIEW",
-  "CLEARANCE_READY_FOR_BOOKING",
-  "ACTIVE_SHIPMENT_IN_PROGRESS",
-  "SUSPENDED",
-  "CONTRACT_CLOSED",
-  "EXPIRED",
-  "REJECTED",
-  "CANCELLED",
-  "RENEWAL_DRAFT",
-  "RENEWAL_SUBMITTED",
-  "RENEWAL_PENDING_APPROVAL",
-  "AMENDMENTS_PROPOSED",
-  "ARCHIVED",
-];
-
-const INVOICE_STATUSES = [
-  "ISSUED",
-  "PENDING",
-  "PAYMENT_PROCESSING",
-  "PARTIALLY_PAID",
-  "PAID",
-  "OVERDUE",
-  "REFUNDED",
-];
-
-export const REPORT_CONFIGS: ReportConfig[] = [
-  {
-    key: "bookings-trend",
-    title: "Bookings Trend",
-    description: "Booking volume, tonnage and revenue over time",
-    domain: "Commercial",
-    filters: ["granularity", "yards", "direction", "freightType", "statuses"],
-    statusOptions: BOOKING_STATUSES,
-    chart: {
-      type: "area",
-      xKey: "period",
-      series: [{ key: "revenue", label: "Revenue (ETB)" }],
-    },
-    columns: [
-      { key: "period", label: "Period" },
-      { key: "bookings", label: "Bookings", numeric: true },
-      { key: "tons", label: "Tonnage", unit: "t" },
-      { key: "revenue", label: "Revenue", unit: "ETB" },
-    ],
-  },
-  {
-    key: "revenue-by-customer",
-    title: "Revenue by Customer",
-    description: "Ranked customers by booking revenue",
-    domain: "Commercial",
-    filters: ["yards", "direction", "freightType", "statuses"],
-    statusOptions: BOOKING_STATUSES,
-    chart: {
-      type: "bar",
-      xKey: "customer",
-      series: [{ key: "revenue", label: "Revenue (ETB)" }],
-      topN: 10,
-    },
-    columns: [
-      { key: "customer", label: "Customer" },
-      { key: "bookings", label: "Bookings", numeric: true },
-      { key: "tons", label: "Tonnage", unit: "t" },
-      { key: "revenue", label: "Revenue", unit: "ETB" },
-    ],
-  },
-  {
-    key: "revenue-by-lane",
-    title: "Revenue by Lane",
-    description: "Origin → destination lanes by tonnage and revenue",
-    domain: "Commercial",
-    filters: ["direction", "freightType", "statuses"],
-    statusOptions: BOOKING_STATUSES,
-    chart: {
-      type: "bar",
-      xKey: "origin+destination",
-      series: [{ key: "revenue", label: "Revenue (ETB)" }],
-      topN: 10,
-    },
-    columns: [
-      { key: "origin", label: "Origin" },
-      { key: "destination", label: "Destination" },
-      { key: "bookings", label: "Bookings", numeric: true },
-      { key: "tons", label: "Tonnage", unit: "t" },
-      { key: "revenue", label: "Revenue", unit: "ETB" },
-    ],
-  },
-  {
-    key: "contract-utilization",
-    title: "Contract Utilization",
-    description: "Committed scope caps vs booked tonnage per contract",
-    domain: "Commercial",
-    filters: ["direction", "statuses"],
-    statusOptions: CONTRACT_STATUSES,
-    columns: [
-      { key: "reference", label: "Contract" },
-      { key: "customer", label: "Customer" },
-      { key: "status", label: "Status" },
-      { key: "kind", label: "Kind" },
-      { key: "valid_from", label: "Valid from" },
-      { key: "valid_until", label: "Valid until" },
-      { key: "committed", label: "Committed", unit: "t" },
-      { key: "booked_tons", label: "Booked", unit: "t" },
-      { key: "bookings", label: "Bookings", numeric: true },
-      { key: "utilization_pct", label: "Utilization", unit: "%" },
-    ],
-  },
-  {
-    key: "train-on-time",
-    title: "Train On-Time Performance",
-    description: "Departure punctuality and delays by lane (60-min grace)",
-    domain: "Operations",
-    filters: ["yards", "direction"],
-    chart: {
-      type: "bar",
-      xKey: "origin+destination",
-      series: [{ key: "on_time_pct", label: "On-time %" }],
-      topN: 15,
-    },
-    columns: [
-      { key: "origin", label: "Origin" },
-      { key: "destination", label: "Destination" },
-      { key: "trips", label: "Trips", numeric: true },
-      { key: "departed", label: "Departed", numeric: true },
-      { key: "avg_dep_delay_min", label: "Avg dep. delay", unit: "min" },
-      { key: "avg_arr_delay_min", label: "Avg arr. delay", unit: "min" },
-      { key: "on_time_pct", label: "On-time", unit: "%" },
-    ],
-  },
-  {
-    key: "schedule-fill-rate",
-    title: "Schedule Fill Rate",
-    description: "Booked tonnage vs wagon capacity per train schedule",
-    domain: "Operations",
-    filters: ["yards", "direction"],
-    chart: {
-      type: "line",
-      xKey: "departure",
-      series: [{ key: "fill_pct", label: "Fill %" }],
-    },
-    columns: [
-      { key: "train_number", label: "Train" },
-      { key: "departure", label: "Departure" },
-      { key: "origin", label: "Origin" },
-      { key: "destination", label: "Destination" },
-      { key: "direction", label: "Direction" },
-      { key: "status", label: "Status" },
-      { key: "wagon_count", label: "Wagons", numeric: true },
-      { key: "capacity_tons", label: "Capacity", unit: "t" },
-      { key: "booked_tons", label: "Booked", unit: "t" },
-      { key: "fill_pct", label: "Fill", unit: "%" },
-    ],
-  },
-  {
-    key: "trips-per-route",
-    title: "Trips per Route",
-    description: "Completed trips and tonnage hauled per lane",
-    domain: "Operations",
-    filters: ["yards", "direction"],
-    chart: {
-      type: "bar",
-      xKey: "origin+destination",
-      series: [{ key: "trips", label: "Trips" }],
-      topN: 15,
-    },
-    columns: [
-      { key: "origin", label: "Origin" },
-      { key: "destination", label: "Destination" },
-      { key: "direction", label: "Direction" },
-      { key: "trips", label: "Trips", numeric: true },
-      { key: "tons_hauled", label: "Tonnage hauled", unit: "t" },
-      { key: "avg_tons_per_trip", label: "Avg per trip", unit: "t" },
-    ],
-  },
-  {
-    key: "invoiced-vs-collected",
-    title: "Invoiced vs Collected",
-    description: "Billing issued vs payments received over time",
-    domain: "Finance",
-    filters: ["granularity", "direction"],
-    chart: {
-      type: "line",
-      xKey: "period",
-      series: [
-        { key: "invoiced", label: "Invoiced (ETB)" },
-        { key: "collected", label: "Collected (ETB)" },
-      ],
-    },
-    columns: [
-      { key: "period", label: "Period" },
-      { key: "invoices", label: "Invoices", numeric: true },
-      { key: "invoiced", label: "Invoiced", unit: "ETB" },
-      { key: "collected", label: "Collected", unit: "ETB" },
-      { key: "outstanding", label: "Outstanding", unit: "ETB" },
-    ],
-  },
-  {
-    key: "aging-receivables",
-    title: "Aging Receivables",
-    description: "Outstanding invoice balances by age bucket per customer",
-    domain: "Finance",
-    filters: ["direction", "statuses"],
-    statusOptions: INVOICE_STATUSES,
-    chart: {
-      type: "bar",
-      xKey: "customer",
-      series: [{ key: "outstanding", label: "Outstanding (ETB)" }],
-      topN: 10,
-    },
-    columns: [
-      { key: "customer", label: "Customer" },
-      { key: "invoices", label: "Invoices", numeric: true },
-      { key: "outstanding", label: "Outstanding", unit: "ETB" },
-      { key: "current", label: "Current", unit: "ETB" },
-      { key: "overdue_0_30", label: "0–30d", unit: "ETB" },
-      { key: "overdue_31_60", label: "31–60d", unit: "ETB" },
-      { key: "overdue_61_90", label: "61–90d", unit: "ETB" },
-      { key: "overdue_90_plus", label: "90d+", unit: "ETB" },
-    ],
-  },
-  {
-    key: "revenue-by-payment-method",
-    title: "Revenue by Payment Method",
-    description: "Successful payments broken down by method",
-    domain: "Finance",
-    filters: ["direction"],
-    chart: {
-      type: "bar",
-      xKey: "method",
-      series: [{ key: "amount", label: "Amount (ETB)" }],
-    },
-    columns: [
-      { key: "method", label: "Method" },
-      { key: "payments", label: "Payments", numeric: true },
-      { key: "amount", label: "Amount", unit: "ETB" },
-    ],
-  },
-  // --- Record-level list exports (Data domain) — filtered or full dumps ---
-  {
-    key: "bookings-list",
-    title: "Bookings Export",
-    description: "Booking records with customer, lane, cargo, amounts",
-    domain: "Data",
-    filters: ["yards", "direction", "freightType", "statuses"],
-    statusOptions: BOOKING_STATUSES,
-    columns: [
-      { key: "reference", label: "Reference" },
-      { key: "created", label: "Created" },
-      { key: "customer", label: "Customer" },
-      { key: "status", label: "Status" },
-      { key: "freight_type", label: "Freight" },
-      { key: "direction", label: "Direction" },
-      { key: "origin", label: "Origin" },
-      { key: "destination", label: "Destination" },
-      { key: "cargo", label: "Cargo" },
-      { key: "tons", label: "Tonnage", unit: "t" },
-      { key: "amount", label: "Amount", unit: "ETB" },
-      { key: "payment_status", label: "Payment" },
-      { key: "scheduling_status", label: "Scheduling" },
-    ],
-  },
-  {
-    key: "contracts-list",
-    title: "Contracts Export",
-    description: "Contract records with validity, status, customer",
-    domain: "Data",
-    filters: ["direction", "statuses"],
-    statusOptions: CONTRACT_STATUSES,
-    columns: [
-      { key: "reference", label: "Reference" },
-      { key: "customer", label: "Customer" },
-      { key: "kind", label: "Kind" },
-      { key: "status", label: "Status" },
-      { key: "direction", label: "Direction" },
-      { key: "freight_type", label: "Freight" },
-      { key: "valid_from", label: "Valid from" },
-      { key: "valid_until", label: "Valid until" },
-      { key: "created", label: "Created" },
-    ],
-  },
-  {
-    key: "schedules-list",
-    title: "Train Schedules Export",
-    description: "Schedule records with planned vs actual times",
-    domain: "Data",
-    filters: ["yards", "direction", "statuses"],
-    statusOptions: ["DRAFT", "SCHEDULED", "DISPATCHED", "ARRIVED", "CANCELLED"],
-    columns: [
-      { key: "train_number", label: "Train" },
-      { key: "reference", label: "Reference" },
-      { key: "direction", label: "Direction" },
-      { key: "status", label: "Status" },
-      { key: "origin", label: "Origin" },
-      { key: "destination", label: "Destination" },
-      { key: "scheduled_departure", label: "Sched. departure" },
-      { key: "actual_departure", label: "Actual departure" },
-      { key: "scheduled_arrival", label: "Sched. arrival" },
-      { key: "actual_arrival", label: "Actual arrival" },
-      { key: "max_wagons", label: "Max wagons", numeric: true },
-      { key: "wagon_count", label: "Wagons", numeric: true },
-    ],
-  },
-  {
-    key: "fleet-wagons",
-    title: "Wagons Export",
-    description: "Wagon fleet with type, capacity, status, location",
-    domain: "Data",
-    filters: ["yards", "statuses"],
-    statusOptions: ["AVAILABLE", "ASSIGNED", "MAINTENANCE"],
-    columns: [
-      { key: "wagon_number", label: "Wagon" },
-      { key: "type", label: "Type" },
-      { key: "capacity_tons", label: "Capacity", unit: "t" },
-      { key: "status", label: "Status" },
-      { key: "current_yard", label: "Current yard" },
-    ],
-  },
-  {
-    key: "fleet-locomotives",
-    title: "Locomotives Export",
-    description: "Locomotive fleet with type, pull capacity, status",
-    domain: "Data",
-    filters: ["yards", "statuses"],
-    statusOptions: ["AVAILABLE", "OUT_OF_SERVICE"],
-    columns: [
-      { key: "code", label: "Code" },
-      { key: "name", label: "Name" },
-      { key: "locomotive_type", label: "Type" },
-      { key: "max_pull_tons", label: "Max pull", unit: "t" },
-      { key: "status", label: "Status" },
-      { key: "current_yard", label: "Current yard" },
-    ],
-  },
-  {
-    key: "customers-list",
-    title: "Customers Export",
-    description: "Company records with type, status, TIN",
-    domain: "Data",
-    filters: ["statuses"],
-    statusOptions: ["pending", "active"],
-    columns: [
-      { key: "name", label: "Name" },
-      { key: "type", label: "Type" },
-      { key: "kind", label: "Kind" },
-      { key: "status", label: "Status" },
-      { key: "tin", label: "TIN" },
-      { key: "approved", label: "Approved" },
-      { key: "created", label: "Created" },
-    ],
-  },
-  {
-    key: "payments-list",
-    title: "Payments Export",
-    description: "Payment transactions with method, status, references",
-    domain: "Data",
-    filters: ["direction", "statuses"],
-    statusOptions: [
-      "action-required",
-      "processing",
-      "success",
-      "failed",
-      "canceled",
-      "refunded",
-    ],
-    columns: [
-      { key: "created", label: "Created" },
-      { key: "method", label: "Method" },
-      { key: "status", label: "Status" },
-      { key: "currency", label: "Currency" },
-      { key: "amount", label: "Amount", unit: "ETB" },
-      { key: "transaction_id", label: "Transaction" },
-      { key: "merchant_order_id", label: "Merchant order" },
-      { key: "paid", label: "Paid" },
-    ],
-  },
-];
-
-export const REPORT_CONFIG_BY_KEY = new Map(
-  REPORT_CONFIGS.map((c) => [c.key, c]),
-);
-
-export const REPORT_DOMAINS: ReportDomain[] = [
-  "Commercial",
-  "Operations",
-  "Finance",
-  "Data",
-];
diff --git a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/CargoTypesPage.tsx b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/CargoTypesPage.tsx
index e3fb54526..769ae757c 100644
--- a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/CargoTypesPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/CargoTypesPage.tsx
@@ -55,6 +55,10 @@ interface CargoNode extends RuleEngineRecord {
   requiresDirectorApproval?: boolean;
   /** When true, bookings of this cargo type incur the flat LASHING surcharge. */
   hasLashing?: boolean;
+  /** When true, bookings of this cargo type incur the lane-scoped FUEL surcharge. */
+  hasFuel?: boolean;
+  /** Staff may write bulk contract templates for this cargo type (parent XOR children). */
+  hasContractTemplate?: boolean;
   /** How this cargo is measured (PER_TON / PER_ITEM); null for groups/unset. */
   unitOfMeasure?: string | null;
   /** Wagon types that can carry this bulk cargo during scheduling; empty if unset. */
@@ -112,6 +116,13 @@ const FORM_FIELDS: FormFieldDef[] = [
   // When on, every booking of this cargo type is charged the flat LASHING
   // surcharge (a rate with trigger = Lashing).
   { name: "hasLashing", label: "Charge lashing fee", type: "boolean" },
+  // When on, bookings of this cargo type incur the fuel surcharge, billed off
+  // the lane-scoped FUEL rate (direction + route + cargo type) under Rates.
+  { name: "hasFuel", label: "Charge fuel fee", type: "boolean" },
+  // Lets staff write bulk contract templates for this cargo type. The API
+  // rejects the save when the parent group (or a child) already has it on —
+  // the template must live on exactly one level.
+  { name: "hasContractTemplate", label: "Has contract template", type: "boolean" },
   { name: "isActive", label: "Active", type: "boolean" },
 ];
 
@@ -576,6 +587,13 @@ function CargoRow({
                   </Badge>
                 </Tooltip>
               ) : null}
+              {node.hasContractTemplate ? (
+                <Tooltip label="Bulk contract templates are written for this cargo type" withArrow>
+                  <Badge size="xs" variant="light" color="grape" radius="sm">
+                    Contract
+                  </Badge>
+                </Tooltip>
+              ) : null}
               {node.unitOfMeasure ? (
                 <Tooltip label="How bookings measure this cargo" withArrow>
                   <Badge size="xs" variant="light" color="teal" radius="sm">
diff --git a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/RuleEngineResourcePage.tsx b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/RuleEngineResourcePage.tsx
index 3a3629155..a83a90fb4 100644
--- a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/RuleEngineResourcePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/RuleEngineResourcePage.tsx
@@ -26,6 +26,7 @@ import { PageContainer, PageHeader } from "@/components/page";
 import ManageRuleEngineOrderDialog from "@/components/ruleEngine/ManageRuleEngineOrderDialog";
 import PriorityRuleApprovalsSection from "@/pages/ruleEngine/PriorityRuleApprovalsSection";
 import RateApprovalsSection from "@/pages/ruleEngine/RateApprovalsSection";
+import { YardDesksModal } from "@/pages/ruleEngine/YardDesksModal";
 import { nextPriorityRangeStart } from "@/pages/ruleEngine/priorityRuleRange";
 import RuleEngineCardGrid from "@/components/ruleEngine/RuleEngineCardGrid";
 import RuleEngineFormDialog from "@/components/ruleEngine/RuleEngineFormDialog";
@@ -43,6 +44,7 @@ import {
     useCargoTypeParentOptions,
     useContainerTypeOptions,
     useLiveRateOptions,
+    useShippingLineCompanyOptions,
     useWagonTypeOptions,
     useYardOptions,
     type YardOption,
@@ -93,6 +95,20 @@ const yardOptionsForLegEnd = (
   values: Record<string, unknown>,
   end: "origin" | "destination",
 ): { label: string; value: string }[] => {
+  // A shipping-line rate names its shape in its own fields and is always
+  // import; map it onto the appliesTo/direction pair the rest of this function
+  // reads so the country narrowing is shared rather than duplicated.
+  if (values.isShippingLineRate === true) {
+    if (!values.shippingLineCompanyId) return [];
+    const isBase = values.shippingLineRateKind === "BASE";
+    values = {
+      ...values,
+      appliesTo: isBase
+        ? String(values.shippingLineCargoKind ?? "")
+        : "OTHER",
+      tradeDirection: "IMPORT",
+    };
+  }
   const appliesTo = String(values.appliesTo ?? "");
   let country: string | undefined;
   if (appliesTo === "INTERCITY") {
@@ -100,19 +116,27 @@ const yardOptionsForLegEnd = (
   } else if (
     appliesTo === "CONTAINER" ||
     appliesTo === "BULK" ||
-    // Customs clearance + empty-container return are sold per direction +
-    // route, so their yard dropdowns narrow exactly like base freight.
+    // Customs clearance, empty-container return and fuel are sold per
+    // direction + route, so their yard dropdowns narrow exactly like base
+    // freight.
     (appliesTo === "OTHER" &&
-      ["CUSTOMS_CLEARANCE", "WITH_RETURN"].includes(String(values.trigger ?? "")))
+      ["CUSTOMS_CLEARANCE", "WITH_RETURN", "FUEL"].includes(
+        String(values.trigger ?? ""),
+      ))
   ) {
     const direction = String(values.tradeDirection ?? "");
     // Direction is what decides the countries, so offer nothing until it is set
     // rather than defaulting to one and letting it read as a real choice.
-    if (direction !== "IMPORT" && direction !== "EXPORT") return [];
-    const startsInEthiopia = direction === "EXPORT";
-    country = (end === "origin" ? startsInEthiopia : !startsInEthiopia)
-      ? "Ethiopia"
-      : "Djibouti";
+    if (direction === "DOMESTIC") {
+      // A fuel rate's intercity lane — stays inside Ethiopia.
+      country = "Ethiopia";
+    } else {
+      if (direction !== "IMPORT" && direction !== "EXPORT") return [];
+      const startsInEthiopia = direction === "EXPORT";
+      country = (end === "origin" ? startsInEthiopia : !startsInEthiopia)
+        ? "Ethiopia"
+        : "Djibouti";
+    }
   }
   if (!country) return [];
   return yards
@@ -144,6 +168,10 @@ const RuleEngineResourcePage = () => {
     null,
   );
   const [chainOpen, setChainOpen] = useState(false);
+  // Yards only: which desks work at this yard (input to yard access scoping).
+  const [desksYard, setDesksYard] = useState<Record<string, unknown> | null>(
+    null,
+  );
   const [orderDialogOpen, setOrderDialogOpen] = useState(false);
   const { viewMode, setViewMode } = useRuleEngineViewMode(
     config?.slug ?? DEFAULT_CONFIGURATION_SLUG,
@@ -272,6 +300,13 @@ const RuleEngineResourcePage = () => {
     useContainerTypeOptions(false, usesContainerTypeField);
   const { data: liveRateOptions, isLoading: liveRateOptionsLoading } =
     useLiveRateOptions(usesLiveRateField);
+  const usesShippingLineField = Boolean(
+    config?.formFields.some((f) => f.name === "shippingLineCompanyId"),
+  );
+  const {
+    data: shippingLineOptions,
+    isLoading: shippingLineOptionsLoading,
+  } = useShippingLineCompanyOptions(usesShippingLineField);
   const { data: wagonTypeOptions, isLoading: wagonTypeOptionsLoading } =
     useWagonTypeOptions(usesWagonTypeField);
   const usesYardField = Boolean(
@@ -382,6 +417,13 @@ const RuleEngineResourcePage = () => {
             ),
         };
       }
+      if (field.name === "shippingLineCompanyId") {
+        return {
+          ...field,
+          type: "select" as const,
+          options: shippingLineOptions ?? [],
+        };
+      }
       if (field.name === "rateId") {
         return {
           ...field,
@@ -529,6 +571,17 @@ const RuleEngineResourcePage = () => {
       cell: ({ row }) => (
         <div onClick={(e) => e.stopPropagation()} data-stop-row-click>
           <Group gap="xs" wrap="nowrap" justify="flex-end">
+            {config.slug === "yards" ? (
+              <Tooltip label="Desks that work at this yard">
+                <Button
+                  size="compact-xs"
+                  variant="light"
+                  onClick={() => setDesksYard(row.original)}
+                >
+                  Desks
+                </Button>
+              </Tooltip>
+            ) : null}
             {config.orderConfig && canUpdateControls ? (
               <RuleEngineOrderControls
                 record={row.original}
@@ -600,7 +653,39 @@ const RuleEngineResourcePage = () => {
 
   const handleFormSubmit = (values: Record<string, unknown>) => {
     let payload = values;
-    if (config.slug === "rates") {
+    if (config.slug === "rates" && values.isShippingLineRate === true) {
+      // A shipping-line rate asks its shape as "base freight vs surcharge" +
+      // "container vs bulk"; the API takes the same appliesTo/trigger pair as a
+      // customer rate, so translate here and drop the form-only fields. Always
+      // import (the only direction a line ships) and always USD.
+      const {
+        isShippingLineRate: _toggle,
+        shippingLineRateKind,
+        shippingLineCargoKind,
+        ...rest
+      } = values;
+      void _toggle;
+      const isBase = shippingLineRateKind === "BASE";
+      payload = {
+        ...rest,
+        appliesTo: isBase ? String(shippingLineCargoKind ?? "CONTAINER") : "OTHER",
+        trigger: isBase ? "ALWAYS" : values.trigger,
+        tradeDirection: "IMPORT",
+        currency: "USD",
+      };
+      if (editing?.id && editing.status === "LIVE") {
+        rateChangeWorkflow.submit.mutate(
+          { rateId: String(editing.id), update: payload },
+          {
+            onSuccess: () => {
+              setFormOpen(false);
+              setEditing(null);
+            },
+          },
+        );
+        return;
+      }
+    } else if (config.slug === "rates") {
       // Base-freight categories have no surcharge trigger field — the engine
       // treats them as ALWAYS. Surcharges (Applies to = Other) keep their
       // chosen trigger.
@@ -609,7 +694,11 @@ const RuleEngineResourcePage = () => {
       // ton·km, container = per km + distance band) and the currency stays as
       // chosen (birr or dollar). Everything else remains USD-only.
       const isLastMile = values.appliesTo === "LAST_MILE";
-      const { lastMileMode, ...rest } = values;
+      // The shipping-line toggle is form-only — the API's whitelist rejects the
+      // whole payload if it leaks through ("property isShippingLineRate should
+      // not exist").
+      const { lastMileMode, isShippingLineRate: _toggle, ...rest } = values;
+      void _toggle;
       payload = {
         ...rest,
         currency: isLastMile ? (values.currency ?? "ETB") : "USD",
@@ -895,6 +984,21 @@ const RuleEngineResourcePage = () => {
         </Stack>
       </Card>
 
+      <YardDesksModal
+        opened={!!desksYard}
+        onClose={() => setDesksYard(null)}
+        readOnly={!canUpdateControls}
+        yard={
+          desksYard
+            ? {
+                id: String(desksYard.id),
+                code: String(desksYard.code ?? ""),
+                label: String(desksYard.label ?? ""),
+              }
+            : null
+        }
+      />
+
       <RuleEngineFormDialog
         open={formOpen}
         onOpenChange={setFormOpen}
@@ -920,6 +1024,7 @@ const RuleEngineResourcePage = () => {
           (usesLiveRateField && liveRateOptionsLoading) ||
           (usesWagonTypeField && wagonTypeOptionsLoading) ||
           (usesYardField && yardOptionsLoading) ||
+          (usesShippingLineField && shippingLineOptionsLoading) ||
           (usesApprovalRoleField && approvalRoleOptionsLoading)
         }
         positionOptions={!editing ? createPositionOptions : undefined}
diff --git a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/YardDesksModal.tsx b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/YardDesksModal.tsx
new file mode 100644
index 000000000..5a9b6ccf6
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/YardDesksModal.tsx
@@ -0,0 +1,134 @@
+import { useEffect, useState } from "react";
+import {
+  Alert,
+  Button,
+  Group,
+  Loader,
+  Modal,
+  MultiSelect,
+  Stack,
+  Text,
+} from "@mantine/core";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import toast from "react-hot-toast";
+
+import { extractErrorMessage } from "@/utils/errorExtractor";
+import { yardPositionsService } from "@/services/yardPositions.service";
+
+interface YardDesksModalProps {
+  opened: boolean;
+  onClose: () => void;
+  yard: { id: string; code: string; label: string } | null;
+  /** Read-only when the caller lacks the yards update permission. */
+  readOnly?: boolean;
+}
+
+const positionLabel = (
+  name: { am?: string; en?: string } | null,
+  fallback: string,
+) => name?.en?.trim() || name?.am?.trim() || fallback;
+
+/**
+ * Which desks staff a yard — the input to yard access scoping.
+ *
+ * Saving REPLACES the yard's whole set (the API's PUT is a replace), which is
+ * why the control is a multi-select holding the complete list rather than
+ * add/remove buttons.
+ */
+export function YardDesksModal({
+  opened,
+  onClose,
+  yard,
+  readOnly = false,
+}: YardDesksModalProps) {
+  const queryClient = useQueryClient();
+  const [selected, setSelected] = useState<string[]>([]);
+
+  const positions = useQuery({
+    queryKey: ["yard-positions", "positions"],
+    queryFn: yardPositionsService.listPositions,
+    enabled: opened,
+    staleTime: 5 * 60 * 1000,
+  });
+
+  const mapping = useQuery({
+    queryKey: ["yard-positions", "yard", yard?.id],
+    queryFn: () => yardPositionsService.listByYard(yard!.id),
+    enabled: opened && !!yard?.id,
+  });
+
+  // Reset to what the server holds whenever the modal opens on a new yard, so a
+  // cancelled edit never leaks into the next one.
+  useEffect(() => {
+    if (mapping.data) setSelected(mapping.data.map((row) => row.positionId));
+  }, [mapping.data]);
+
+  const save = useMutation({
+    mutationFn: () => yardPositionsService.setForYard(yard!.id, selected),
+    onSuccess: () => {
+      toast.success("Yard desks updated");
+      queryClient.invalidateQueries({ queryKey: ["yard-positions"] });
+      onClose();
+    },
+    onError: (error) =>
+      toast.error(extractErrorMessage(error, "Failed to update yard desks")),
+  });
+
+  const options = (positions.data ?? []).map((position) => ({
+    value: position.id,
+    label: positionLabel(position.name, position.id.slice(0, 8)),
+  }));
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      title={yard ? `Desks at ${yard.label} (${yard.code})` : "Desks"}
+      size="lg"
+    >
+      <Stack gap="md">
+        <Alert color="blue" variant="light">
+          <Text size="sm">
+            Positions mapped here are the desks that work at this yard. Yard
+            access scoping reads this mapping — a staff member acting on this
+            desk is scoped to this yard.
+          </Text>
+        </Alert>
+
+        {positions.isLoading || mapping.isLoading ? (
+          <Group justify="center" py="lg">
+            <Loader size="sm" />
+          </Group>
+        ) : (
+          <MultiSelect
+            data={options}
+            value={selected}
+            onChange={setSelected}
+            disabled={readOnly}
+            label="Positions"
+            placeholder={selected.length ? undefined : "Select positions"}
+            description="Saving replaces the whole set — anything removed here loses this yard."
+            searchable
+            clearable
+            hidePickedOptions
+            maxDropdownHeight={280}
+          />
+        )}
+
+        <Group justify="flex-end">
+          <Button variant="default" onClick={onClose}>
+            Cancel
+          </Button>
+          <Button
+            onClick={() => save.mutate()}
+            loading={save.isPending}
+            disabled={readOnly || mapping.isLoading}
+            title={readOnly ? "You cannot edit yards" : undefined}
+          >
+            Save
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/config/resources.ts b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/config/resources.ts
index d5998515e..4ff9aa3fb 100644
--- a/apps/edr-freight-web/backoffice/src/pages/ruleEngine/config/resources.ts
+++ b/apps/edr-freight-web/backoffice/src/pages/ruleEngine/config/resources.ts
@@ -39,6 +39,8 @@ export interface FormFieldDef {
   placeholder?: string;
   description?: string;
   disabled?: boolean;
+  /** Editable on create, locked when editing an existing record. */
+  disabledOnEdit?: boolean;
   /** Trailing unit label shown inside the input (e.g. "USD" on a rate value). */
   suffix?: string;
   /** Hide this field when another field currently equals one of these values. */
@@ -95,7 +97,16 @@ export interface RuleEngineOrderConfig {
 export interface RuleEngineListTab {
   key: string;
   label: string;
-  filters: { appliesTo?: string; trigger?: string };
+  filters: {
+    appliesTo?: string;
+    trigger?: string;
+    /**
+     * "true" = only shipping-line rates, "false" = only standard customer
+     * rates. Sent as a string because tab filters go on the query string
+     * verbatim.
+     */
+    isShippingLineRate?: string;
+  };
 }
 
 export interface RuleEngineResourceConfig {
@@ -176,9 +187,20 @@ const RATE_TRIGGERS = [
   { label: "Shipping line mapped", value: "SHIPPING_LINE" },
   { label: "Penalty", value: "CONSOLIDATION" },
   { label: "Lashing (bulk, per cargo type)", value: "LASHING" },
-  { label: "Cancellation", value: "CANCELLATION" },
+  { label: "Cancellation (per wagon, per direction + cargo type)", value: "CANCELLATION" },
   { label: "Shipping line extra fee (PIL)", value: "PIL_EXTRA_FEE" },
   { label: "Customs clearance service fee (billed with the booking)", value: "CUSTOMS_CLEARANCE" },
+  { label: "Fuel (per lane + cargo type)", value: "FUEL" },
+];
+
+/**
+ * Fuel lanes: import/export like base freight, plus a domestic intercity lane
+ * (stored as DOMESTIC — matches the booking's own trade direction).
+ */
+const FUEL_TRADE_DIRECTIONS = [
+  { label: "Import", value: "IMPORT" },
+  { label: "Export", value: "EXPORT" },
+  { label: "Intercity", value: "DOMESTIC" },
 ];
 
 /**
@@ -192,6 +214,36 @@ const INTERCITY_KINDS = [
   { label: "Bulk", value: "BULK" },
 ];
 
+/**
+ * A shipping-line rate: priced for one carrier's own bookings instead of for
+ * every customer. The toggle drives the whole form — until a line is picked
+ * there is nothing to configure, and the shape questions (base freight vs
+ * surcharge, container vs bulk) are asked only after it is.
+ */
+const isShippingLineRate = (values: Record<string, unknown>) =>
+  values.isShippingLineRate === true;
+
+/** A shipping-line rate whose owning line has been chosen — the rest unlocks. */
+const hasShippingLine = (values: Record<string, unknown>) =>
+  isShippingLineRate(values) && Boolean(values.shippingLineCompanyId);
+
+/**
+ * What a shipping-line rate prices. Deliberately narrower than the customer
+ * form's `appliesTo`: a line buys base rail freight (its own containers or
+ * bulk) or a surcharge, and nothing else — intercity and first/last mile are
+ * customer products.
+ */
+const SHIPPING_LINE_RATE_KINDS = [
+  { label: "Base freight", value: "BASE" },
+  { label: "Surcharge", value: "SURCHARGE" },
+];
+
+/** Container vs bulk, asked once a shipping-line base-freight rate is chosen. */
+const SHIPPING_LINE_CARGO_KINDS = [
+  { label: "Container", value: "CONTAINER" },
+  { label: "Bulk", value: "BULK" },
+];
+
 /** True when the rate being edited is base rail freight, which is priced per leg. */
 const isBaseFreightRate = (values: Record<string, unknown>) =>
   ["BULK", "CONTAINER", "INTERCITY"].includes(String(values.appliesTo ?? ""));
@@ -201,9 +253,24 @@ const isBaseFreightRate = (values: Record<string, unknown>) =>
  * the empty-container return surcharge (sold per route + container type).
  */
 const isRouteScopedRate = (values: Record<string, unknown>) =>
-  isBaseFreightRate(values) ||
+  // A shipping line's base freight is priced per leg exactly like a customer's;
+  // its surcharges are route-scoped on the same triggers.
+  (isShippingLineRate(values)
+    ? hasShippingLine(values) &&
+      (values.shippingLineRateKind === "BASE" ||
+        ["CUSTOMS_CLEARANCE", "WITH_RETURN", "FUEL"].includes(
+          String(values.trigger ?? ""),
+        ))
+    : isBaseFreightRate(values)) ||
   (String(values.appliesTo ?? "") === "OTHER" &&
-    ["CUSTOMS_CLEARANCE", "WITH_RETURN"].includes(String(values.trigger ?? "")));
+    ["CUSTOMS_CLEARANCE", "WITH_RETURN", "FUEL"].includes(String(values.trigger ?? "")));
+
+/**
+ * Surcharges sold per cargo kind: the admin says container or bulk, then names
+ * the container type or bulk commodity the fee covers.
+ */
+const isCargoKindTrigger = (values: Record<string, unknown>) =>
+  ["CUSTOMS_CLEARANCE", "CANCELLATION"].includes(String(values.trigger ?? ""));
 
 const unitOption = (value: string) => ({ label: value.replace(/_/g, " "), value });
 
@@ -244,7 +311,8 @@ const unitsForShape = (
         // Container-only service — per returned container, per wagon, or flat.
         return ["PER_CONTAINER", "PER_WAGON", "FLAT"];
       case "CANCELLATION":
-        return ["FLAT", "PER_INVOICE"];
+        // Wagon cancellation fee — scales with the cancelled wagons only.
+        return ["PER_WAGON"];
       case "CUSTOMS_CLEARANCE":
         // Per cargo kind: container fees per box/wagon, bulk per ton/wagon.
         return cargoKind === "BULK"
@@ -253,6 +321,9 @@ const unitsForShape = (
       case "LASHING":
         // Bulk-only cargo securing — per ton or per wagon.
         return ["PER_TON", "PER_WAGON"];
+      case "FUEL":
+        // Per wagon (wagons × rate) or per liter (base liters × rate, once).
+        return ["PER_WAGON", "PER_LITER"];
       case "CONSOLIDATION":
       case "SHIPPING_LINE":
       case "PIL_EXTRA_FEE":
@@ -287,6 +358,31 @@ export const rateUnitOptions = (
   values: Record<string, unknown>,
   cargoUnitOfMeasure = "",
 ) => {
+  // A shipping-line rate answers the same two questions under different names —
+  // map them onto the shape the unit table is keyed by. Base freight for a line
+  // is CONTAINER/BULK freight; a line surcharge is OTHER + its trigger.
+  if (isShippingLineRate(values)) {
+    const { shippingLineRateKind: kind, shippingLineCargoKind: cargoKind } = values;
+    if (kind === "BASE") {
+      if (cargoKind !== "CONTAINER" && cargoKind !== "BULK") return [];
+      return allowedRateUnits(
+        String(cargoKind),
+        "ALWAYS",
+        "",
+        cargoUnitOfMeasure,
+      ).map(unitOption);
+    }
+    if (kind === "SURCHARGE" && values.trigger) {
+      return allowedRateUnits(
+        "OTHER",
+        String(values.trigger),
+        String(values.cargoKind ?? ""),
+        cargoUnitOfMeasure,
+      ).map(unitOption);
+    }
+    return [];
+  }
+
   const appliesTo = String(values.appliesTo ?? "");
   const trigger = appliesTo === "OTHER" ? String(values.trigger ?? "") : "ALWAYS";
   if (!appliesTo) return [];
@@ -369,6 +465,13 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
       },
       { name: "requiresDirectorApproval", label: "Requires director approval", type: "boolean" },
       { name: "hasLashing", label: "Charge lashing fee", type: "boolean" },
+      {
+        name: "hasFuel",
+        label: "Charge fuel fee",
+        type: "boolean",
+        description:
+          "Bookings of this cargo incur the fuel surcharge (configure the FUEL rate per lane under Rates).",
+      },
       { name: "isActive", label: "Active", type: "boolean" },
     ],
   },
@@ -389,7 +492,7 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
     ],
     formFields: [
       { name: "label", label: "Label", type: "text", required: true },
-      { name: "sizeFt", label: "Size (ft)", type: "number", required: true },
+      { name: "sizeFt", label: "Size (ft)", type: "number", required: true, disabledOnEdit: true },
       // Options injected at render from useWagonTypeOptions (RuleEngineResourcePage).
       {
         name: "wagonTypeIds",
@@ -807,36 +910,51 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
     supportsSearch: true,
     // Category tabs — each filters server-side by appliesTo / trigger.
     listTabs: [
-      { key: "all", label: "All", filters: {} },
-      { key: "container", label: "Container", filters: { appliesTo: "CONTAINER" } },
-      { key: "bulk", label: "Bulk", filters: { appliesTo: "BULK" } },
-      { key: "intercity", label: "Intercity", filters: { appliesTo: "INTERCITY" } },
+      // "All" and every shape tab show customer rates only — a shipping line's
+      // negotiated price is its own list, not an extra row in the standard one.
+      { key: "all", label: "All", filters: { isShippingLineRate: "false" } },
+      {
+        key: "shipping-line",
+        label: "Shipping line",
+        filters: { isShippingLineRate: "true" },
+      },
+      { key: "container", label: "Container", filters: { appliesTo: "CONTAINER", isShippingLineRate: "false" } },
+      { key: "bulk", label: "Bulk", filters: { appliesTo: "BULK", isShippingLineRate: "false" } },
+      { key: "intercity", label: "Intercity", filters: { appliesTo: "INTERCITY", isShippingLineRate: "false" } },
       {
         key: "trucking",
         label: "First / Last mile",
-        filters: { appliesTo: "FIRST_MILE,LAST_MILE" },
+        filters: { appliesTo: "FIRST_MILE,LAST_MILE", isShippingLineRate: "false" },
       },
       {
         key: "customs",
         label: "Customs clearance",
-        filters: { trigger: "CUSTOMS_CLEARANCE" },
+        filters: { trigger: "CUSTOMS_CLEARANCE", isShippingLineRate: "false" },
       },
       {
         key: "return",
         label: "Container return",
-        filters: { trigger: "WITH_RETURN" },
+        filters: { trigger: "WITH_RETURN", isShippingLineRate: "false" },
       },
       {
         key: "surcharges",
         label: "Surcharges",
         filters: {
           appliesTo: "OTHER",
+          isShippingLineRate: "false",
           trigger:
-            "HAZARDOUS,OVERWEIGHT,REEFER,SHIPPING_LINE,CONSOLIDATION,LASHING,CANCELLATION,PIL_EXTRA_FEE",
+            "HAZARDOUS,OVERWEIGHT,REEFER,SHIPPING_LINE,CONSOLIDATION,LASHING,CANCELLATION,PIL_EXTRA_FEE,FUEL",
         },
       },
     ],
     columns: [
+      // Blank on a standard customer rate; the owning carrier on a line rate.
+      {
+        id: "shippingLineCompany",
+        header: "Shipping line",
+        accessorKey: "shippingLineCompany",
+        format: "entityLabel",
+      },
       { id: "appliesTo", header: "Applies to", accessorKey: "appliesTo", format: "code" },
       { id: "trigger", header: "Trigger", accessorKey: "trigger" },
       // Base freight is priced per leg, so the route is what tells two otherwise
@@ -856,6 +974,59 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
       { id: "status", header: "Status", accessorKey: "status", format: "rateStatus" },
     ],
     formFields: [
+      // ── Shipping line rate ────────────────────────────────────────────────
+      // Flipping this on replaces the whole customer form: the only question
+      // is which line, and the shape questions follow once it is answered.
+      {
+        name: "isShippingLineRate",
+        label: "Shipping line rate",
+        type: "boolean",
+        description:
+          "Price this rate for one shipping line's own bookings instead of for every customer. A line rate replaces the standard rate on that lane — it does not add to it.",
+        // The owner is part of a rate's identity, so switching an existing rate
+        // between customer and line pricing would silently re-target every
+        // booking that prices off it. Create a new rate instead.
+        disabledOnEdit: true,
+        getInitialValue: (record) => Boolean(record.shippingLineCompanyId),
+      },
+      {
+        name: "shippingLineCompanyId",
+        label: "Shipping line",
+        type: "select",
+        required: true,
+        placeholder: "Which shipping line this rate is for",
+        description:
+          "Only this line's bookings price off this rate. A lane the line has no rate for is blocked at booking rather than falling back to the customer price.",
+        disabledOnEdit: true,
+        showIf: isShippingLineRate,
+      },
+      // What the line is buying. Asked only after a line is picked, so the form
+      // stays a single question until then.
+      {
+        name: "shippingLineRateKind",
+        label: "Rate type",
+        type: "select",
+        required: true,
+        options: SHIPPING_LINE_RATE_KINDS,
+        placeholder: "Base freight or a surcharge?",
+        showIf: hasShippingLine,
+        // Not stored: base freight carries trigger ALWAYS, a surcharge anything else.
+        getInitialValue: (record) =>
+          !record.trigger || record.trigger === "ALWAYS" ? "BASE" : "SURCHARGE",
+      },
+      // Container vs bulk — the line form asks this directly instead of folding
+      // it into `appliesTo` the way the customer form does.
+      {
+        name: "shippingLineCargoKind",
+        label: "Cargo kind",
+        type: "select",
+        required: true,
+        options: SHIPPING_LINE_CARGO_KINDS,
+        placeholder: "Is this rate for containers or bulk?",
+        showIf: (v) => hasShippingLine(v) && v.shippingLineRateKind === "BASE",
+        getInitialValue: (record) =>
+          record.appliesTo === "BULK" ? "BULK" : "CONTAINER",
+      },
       {
         name: "appliesTo",
         label: "Applies to",
@@ -864,6 +1035,8 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         options: RATE_APPLIES_TO,
         description:
           "Pick what this rate is for. Bulk/Container/Intercity are base freight; Other is an auto-applied surcharge.",
+        // Derived from the two questions above on a shipping-line rate.
+        showIf: (v) => !isShippingLineRate(v),
       },
       // ── Surcharge trigger — only when Applies to = Other ──────────────────
       {
@@ -874,29 +1047,72 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         options: RATE_TRIGGERS,
         placeholder: "What makes this surcharge apply?",
         showWhen: { field: "appliesTo", equals: ["OTHER"] },
+        showIf: (v) => !isShippingLineRate(v),
       },
-      // ── Trade direction — Bulk & Container base freight, plus the route-
-      // scoped surcharges (customs clearance; empty-container return, which is
-      // import-only for now so export is not offered) ────────────────────────
+      // The same trigger list for a shipping-line surcharge — a line incurs the
+      // same charges a customer does (hazard, reefer, demurrage …), just at its
+      // own negotiated price.
+      {
+        name: "trigger",
+        label: "Surcharge trigger",
+        type: "select",
+        required: true,
+        options: RATE_TRIGGERS,
+        placeholder: "What makes this surcharge apply?",
+        showIf: (v) =>
+          hasShippingLine(v) && v.shippingLineRateKind === "SURCHARGE",
+      },
+      // ── Trade direction — Bulk & Container base freight, plus the directed
+      // surcharges (customs clearance, cancellation, lashing, fuel; empty-
+      // container return, which is import-only for now so export is not
+      // offered) ─────────────────────────────────────────────────────────────
       {
         name: "tradeDirection",
         label: "Trade direction",
         type: "select",
         required: true,
         optionsFromValues: (v: Record<string, unknown>) =>
-          String(v.trigger ?? "") === "WITH_RETURN" &&
-          String(v.appliesTo ?? "") === "OTHER"
+          String(v.appliesTo ?? "") === "OTHER" &&
+          String(v.trigger ?? "") === "WITH_RETURN"
             ? TRADE_DIRECTIONS.filter((d) => d.value === "IMPORT")
-            : TRADE_DIRECTIONS.filter((d) => d.value !== "BOTH"),
+            : String(v.appliesTo ?? "") === "OTHER" &&
+                String(v.trigger ?? "") === "FUEL"
+              ? FUEL_TRADE_DIRECTIONS
+              : TRADE_DIRECTIONS.filter((d) => d.value !== "BOTH"),
         showIf: (v) =>
-          ["BULK", "CONTAINER"].includes(String(v.appliesTo ?? "")) ||
-          (String(v.appliesTo ?? "") === "OTHER" &&
-            ["CUSTOMS_CLEARANCE", "WITH_RETURN", "LASHING"].includes(
-              String(v.trigger ?? ""),
-            )),
+          !isShippingLineRate(v) &&
+          (["BULK", "CONTAINER"].includes(String(v.appliesTo ?? "")) ||
+            (String(v.appliesTo ?? "") === "OTHER" &&
+              [
+                "CUSTOMS_CLEARANCE",
+                "CANCELLATION",
+                "WITH_RETURN",
+                "LASHING",
+                "FUEL",
+              ].includes(String(v.trigger ?? "")))),
       },
-      // ── Cargo kind — customs clearance is priced separately for containers
-      // (one rate per container type) and bulk ───────────────────────────────
+      // Shipping lines only ever ship import — the export leg is sold through
+      // the customer's contract — so the direction is stated, not asked. Shown
+      // as a locked field rather than hidden so the lane the yard pickers are
+      // filtered by is visible.
+      {
+        name: "tradeDirection",
+        label: "Trade direction",
+        type: "select",
+        required: true,
+        options: [{ label: "Import", value: "IMPORT" }],
+        description: "Shipping line rates are import-only.",
+        disabled: true,
+        // No defaultValue: field names repeat across form variants and the
+        // seeded initial value is shared, so defaulting here would pre-select
+        // Import on the customer form's own direction field too. computeValue
+        // pins IMPORT on submit and locks the input regardless.
+        computeValue: () => "IMPORT",
+        showIf: hasShippingLine,
+      },
+      // ── Cargo kind — customs clearance and the cancellation fee are priced
+      // separately for containers (one rate per container type) and bulk (one
+      // rate per commodity) ──────────────────────────────────────────────────
       {
         name: "cargoKind",
         label: "Cargo kind",
@@ -905,11 +1121,10 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         options: INTERCITY_KINDS,
         placeholder: "Is this fee for containers or bulk?",
         description:
-          "Container fees bill per box or wagon (one rate per container type); bulk fees bill per ton or wagon.",
-        showIf: (v) =>
-          v.appliesTo === "OTHER" && v.trigger === "CUSTOMS_CLEARANCE",
+          "Container fees are set per container type; bulk fees per commodity. Customs: container per box or wagon, bulk per ton or wagon. Cancellation: per wagon.",
+        showIf: (v) => v.appliesTo === "OTHER" && isCargoKindTrigger(v),
         // Not a stored column: a container fee carries its containerTypeId, a
-        // bulk fee carries none.
+        // bulk fee its cargoTypeId.
         getInitialValue: (record) =>
           record.containerTypeId ? "CONTAINER" : "BULK",
       },
@@ -922,10 +1137,10 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         placeholder: "Which container type this fee covers",
         showIf: (v) =>
           v.appliesTo === "OTHER" &&
-          v.trigger === "CUSTOMS_CLEARANCE" &&
+          isCargoKindTrigger(v) &&
           v.cargoKind === "CONTAINER",
       },
-      // ── Bulk cargo type — the bulk customs fee names its commodity ────────
+      // ── Bulk cargo type — the bulk fee names its commodity ────────────────
       {
         name: "cargoTypeId",
         label: "Bulk cargo type",
@@ -934,9 +1149,21 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         placeholder: "Which bulk commodity this fee covers",
         showIf: (v) =>
           v.appliesTo === "OTHER" &&
-          v.trigger === "CUSTOMS_CLEARANCE" &&
+          isCargoKindTrigger(v) &&
           v.cargoKind === "BULK",
       },
+      // ── Cargo type — a fuel rate names the commodity it covers (different
+      // commodities price differently on the same lane) ──────────────────────
+      {
+        name: "cargoTypeId",
+        label: "Cargo type",
+        type: "select",
+        required: true,
+        placeholder: "Which cargo type this fuel rate covers",
+        description:
+          "Fuel is charged for bookings of this cargo type (needs “Charge fuel fee” enabled on the cargo type).",
+        showIf: (v) => v.appliesTo === "OTHER" && v.trigger === "FUEL",
+      },
       // ── Bulk cargo type — lashing is bulk-only; may narrow to one leaf
       // commodity (specific wins over the commodity-wide catch-all) ──────────
       {
@@ -1051,9 +1278,24 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         optional: true,
         placeholder: "Select container type (optional)",
         showIf: (v) =>
-          v.appliesTo === "CONTAINER" ||
-          (v.appliesTo === "INTERCITY" && v.intercityKind === "CONTAINER") ||
-          (v.appliesTo === "OTHER" && v.trigger === "WITH_RETURN"),
+          !isShippingLineRate(v) &&
+          (v.appliesTo === "CONTAINER" ||
+            (v.appliesTo === "INTERCITY" && v.intercityKind === "CONTAINER") ||
+            (v.appliesTo === "OTHER" && v.trigger === "WITH_RETURN")),
+      },
+      // Container type for a shipping-line base-freight rate. Required here,
+      // unlike the customer form's optional catch-all: a line negotiates a
+      // price per box size, so an unscoped line rate has no meaning.
+      {
+        name: "containerTypeId",
+        label: "Container type",
+        type: "select",
+        required: true,
+        placeholder: "Which container type this rate covers",
+        showIf: (v) =>
+          hasShippingLine(v) &&
+          v.shippingLineRateKind === "BASE" &&
+          v.shippingLineCargoKind === "CONTAINER",
       },
       // ── Bulk cargo (leaf commodity) — Bulk freight, and bulk-kind intercity ─
       {
@@ -1063,8 +1305,23 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
         optional: true,
         placeholder: "Select bulk commodity (optional)",
         showIf: (v) =>
-          v.appliesTo === "BULK" ||
-          (v.appliesTo === "INTERCITY" && v.intercityKind === "BULK"),
+          !isShippingLineRate(v) &&
+          (v.appliesTo === "BULK" ||
+            (v.appliesTo === "INTERCITY" && v.intercityKind === "BULK")),
+      },
+      // Bulk commodity for a shipping-line base-freight rate. Its unit of
+      // measure decides the rate unit offered below — a counted commodity
+      // (PER_ITEM) prices per item where a weighed one prices per ton.
+      {
+        name: "cargoTypeId",
+        label: "Bulk cargo type",
+        type: "select",
+        required: true,
+        placeholder: "Which bulk commodity this rate covers",
+        showIf: (v) =>
+          hasShippingLine(v) &&
+          v.shippingLineRateKind === "BASE" &&
+          v.shippingLineCargoKind === "BULK",
       },
       // ── The leg this rate prices — base freight only ──────────────────────
       // Options are narrowed to the countries the direction allows (import
@@ -1121,6 +1378,20 @@ export const RULE_ENGINE_RESOURCES: RuleEngineResourceConfig[] = [
           String(v.trigger ?? "") !== "OVERWEIGHT" &&
           String(v.appliesTo ?? "") !== "LAST_MILE",
       },
+      // ── Base liters — per-liter fuel rates only ────────────────────────────
+      {
+        name: "baseLiters",
+        label: "Base (liters)",
+        type: "number",
+        required: true,
+        placeholder: "e.g. 100",
+        description:
+          "Liters the surcharge covers — price = base liters × rate value, charged once per booking.",
+        showIf: (v) =>
+          v.appliesTo === "OTHER" &&
+          v.trigger === "FUEL" &&
+          v.rateUnit === "PER_LITER",
+      },
     ],
   },
   {
diff --git a/apps/edr-freight-web/backoffice/src/pages/settings/CompanyStampSettingsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/settings/CompanyStampSettingsPage.tsx
new file mode 100644
index 000000000..730458f2a
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/settings/CompanyStampSettingsPage.tsx
@@ -0,0 +1,96 @@
+import { useEffect, useState } from "react";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/common/ui/card";
+import { Button } from "@/shared/common/ui/button";
+import { Save, Trash2 } from "lucide-react";
+
+import { StampUpload } from "@/components/contracts/StampUpload";
+import {
+  useClearStamp,
+  useSetStamp,
+  useStampSettingsQuery,
+} from "@/hooks/useStampSettings";
+
+/**
+ * The ONE company stamp/seal, read by every document path server-side via
+ * StampSettingsService: invoices and receipts (InvoiceDocumentService),
+ * warehouse release + handover papers, and the EDR side of contract signature
+ * blocks. Single global image — no per-employee choice, and staff never upload
+ * one when signing.
+ *
+ * Not to be confused with the per-officer teeter (ማህተም) at
+ * /user-management/teeter-and-signature, which is genuinely per-person.
+ */
+export default function CompanyStampSettingsPage() {
+  const { data, isLoading } = useStampSettingsQuery();
+  const setStamp = useSetStamp();
+  const clearStamp = useClearStamp();
+  const [draft, setDraft] = useState<string | null>(null);
+
+  useEffect(() => {
+    setDraft(null);
+  }, [data?.stampImageUrl]);
+
+  const value = draft !== null ? draft : (data?.stampImageUrl ?? null);
+  const dirty = draft !== null && draft !== data?.stampImageUrl;
+
+  const handleSave = async () => {
+    if (!draft) return;
+    await setStamp.mutateAsync(draft);
+  };
+
+  const handleClear = async () => {
+    if (!data?.stampImageUrl) return;
+    await clearStamp.mutateAsync();
+  };
+
+  return (
+    <div className="p-4 w-full max-w-screen-sm mx-auto">
+      <Card className="shadow-lg border-gray-200 dark:border-gray-700">
+        <CardHeader>
+          <CardTitle>Company stamp</CardTitle>
+          <CardDescription>
+            The single EDR seal, applied to every generated document — invoices
+            and receipts, warehouse release and handover papers, and the EDR
+            side of signed contracts. Replacing it here changes it everywhere at
+            once; there is no per-document, per-invoice or per-employee choice.
+            Staff do not upload their own.
+          </CardDescription>
+        </CardHeader>
+        <CardContent className="space-y-4">
+          <StampUpload
+            value={isLoading ? null : value}
+            onChange={setDraft}
+            label="Company stamp"
+            description="Shown on every invoice/receipt PDF in place of the plain seal."
+          />
+
+          <div className="flex items-center gap-2">
+            <Button
+              onClick={handleSave}
+              disabled={!dirty || setStamp.isPending}
+            >
+              <Save className="mr-2 h-4 w-4" />
+              Save
+            </Button>
+            {data?.stampImageUrl && !dirty && (
+              <Button
+                variant="outline"
+                onClick={handleClear}
+                disabled={clearStamp.isPending}
+              >
+                <Trash2 className="mr-2 h-4 w-4" />
+                Remove
+              </Button>
+            )}
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/settings/ExchangeRateSettingsCard.tsx b/apps/edr-freight-web/backoffice/src/pages/settings/ExchangeRateSettingsCard.tsx
index 8527879fc..da01b51ce 100644
--- a/apps/edr-freight-web/backoffice/src/pages/settings/ExchangeRateSettingsCard.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/settings/ExchangeRateSettingsCard.tsx
@@ -15,6 +15,7 @@ import {
   useSetExchangeFallbackRate,
 } from "@/hooks/useExchangeSettings";
 import type { ExchangeRateSource } from "@/services/exchangeSettings.service";
+import { formatDateTime } from "@/lib/format";
 
 /** Feed health, phrased for an operator rather than a developer. */
 function feedLabel(source: ExchangeRateSource | null): {
@@ -35,7 +36,7 @@ function feedLabel(source: ExchangeRateSource | null): {
 }
 
 const formatTime = (value: string | null) =>
-  value ? new Date(value).toLocaleString() : "never";
+  value ? formatDateTime(value) : "never";
 
 /**
  * USD→ETB fallback used when the CBE exchange-rate endpoint is unreachable.
diff --git a/apps/edr-freight-web/backoffice/src/pages/settings/LogoSettingsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/settings/LogoSettingsPage.tsx
new file mode 100644
index 000000000..d2f09cd48
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/settings/LogoSettingsPage.tsx
@@ -0,0 +1,88 @@
+import { useEffect, useState } from "react";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/common/ui/card";
+import { Button } from "@/shared/common/ui/button";
+import { Save, Trash2 } from "lucide-react";
+
+import { LogoUpload } from "@/components/contracts/LogoUpload";
+import {
+  useClearLogo,
+  useSetLogo,
+  useLogoSettingsQuery,
+} from "@/hooks/useLogoSettings";
+
+/**
+ * The ONE company logo, read by every document path server-side via
+ * LogoSettingsService: invoices and receipts, contract cover pages, warehouse
+ * GRN/release/handover papers, train-scheduling manifests, and the payment
+ * receipt. Single global image — no per-document choice.
+ */
+export default function LogoSettingsPage() {
+  const { data, isLoading } = useLogoSettingsQuery();
+  const setLogo = useSetLogo();
+  const clearLogo = useClearLogo();
+  const [draft, setDraft] = useState<string | null>(null);
+
+  useEffect(() => {
+    setDraft(null);
+  }, [data?.logoImageUrl]);
+
+  const value = draft !== null ? draft : (data?.logoImageUrl ?? null);
+  const dirty = draft !== null && draft !== data?.logoImageUrl;
+
+  const handleSave = async () => {
+    if (!draft) return;
+    await setLogo.mutateAsync(draft);
+  };
+
+  const handleClear = async () => {
+    if (!data?.logoImageUrl) return;
+    await clearLogo.mutateAsync();
+  };
+
+  return (
+    <div className="p-4 w-full max-w-screen-sm mx-auto">
+      <Card className="shadow-lg border-gray-200 dark:border-gray-700">
+        <CardHeader>
+          <CardTitle>Company logo</CardTitle>
+          <CardDescription>
+            The single EDR logo, applied to every generated document —
+            invoices and receipts, contracts, warehouse papers, train-scheduling
+            manifests, and payment receipts. Replacing it here changes it
+            everywhere at once.
+          </CardDescription>
+        </CardHeader>
+        <CardContent className="space-y-4">
+          <LogoUpload
+            value={isLoading ? null : value}
+            onChange={setDraft}
+            label="Company logo"
+            description="Shown in the header of every generated document."
+          />
+
+          <div className="flex items-center gap-2">
+            <Button onClick={handleSave} disabled={!dirty || setLogo.isPending}>
+              <Save className="mr-2 h-4 w-4" />
+              Save
+            </Button>
+            {data?.logoImageUrl && !dirty && (
+              <Button
+                variant="outline"
+                onClick={handleClear}
+                disabled={clearLogo.isPending}
+              >
+                <Trash2 className="mr-2 h-4 w-4" />
+                Remove
+              </Button>
+            )}
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/settings/ManualPaymentSettingsCard.tsx b/apps/edr-freight-web/backoffice/src/pages/settings/ManualPaymentSettingsCard.tsx
new file mode 100644
index 000000000..3fe5c1e1e
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/settings/ManualPaymentSettingsCard.tsx
@@ -0,0 +1,132 @@
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/shared/common/ui/card";
+import { Badge } from "@/shared/common/ui/badge";
+import { Switch } from "@/shared/common/ui/switch";
+import { Skeleton } from "@/shared/common/ui/skeleton";
+import { AlertTriangle, Banknote, Landmark } from "lucide-react";
+
+import { useAuth } from "@/auth/useAuth";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import {
+  useManualPaymentSettingsQuery,
+  useUpdateManualPaymentSettings,
+} from "@/hooks/useManualPaymentSettings";
+
+type Currency = "ETB" | "USD";
+
+const CURRENCIES: {
+  code: Currency;
+  field: "etbEnabled" | "usdEnabled";
+  icon: typeof Banknote;
+  title: string;
+  description: string;
+}[] = [
+  {
+    code: "ETB",
+    field: "etbEnabled",
+    icon: Banknote,
+    title: "Birr (ETB) invoices",
+    description:
+      "ETB invoices are normally paid online by the customer. Switch this on when Finance also needs to settle them by hand — a bank transfer or a payment at the counter.",
+  },
+  {
+    code: "USD",
+    field: "usdEnabled",
+    icon: Landmark,
+    title: "Dollar (USD) invoices",
+    description:
+      "USD invoices are paid by bank transfer and have no online channel. Switching this off leaves USD customers with no way to be marked as paid.",
+  },
+];
+
+/**
+ * Switches the manual (offline) payment channel on or off per currency.
+ *
+ * Off means gone, not greyed out: the Manual Payments worklist lists only
+ * enabled currencies, and the API refuses a confirmation in a disabled one —
+ * so a stale tab or a direct call cannot slip a payment through.
+ */
+export default function ManualPaymentSettingsCard() {
+  const { user } = useAuth();
+  const canManage =
+    hasPermission(user, FREIGHT_PERMS.settings.manualPayment.manage) ||
+    hasPermission(user, FREIGHT_PERMS.admin);
+
+  const { data, isLoading } = useManualPaymentSettingsQuery();
+  const update = useUpdateManualPaymentSettings();
+
+  const noneEnabled = Boolean(data && !data.etbEnabled && !data.usdEnabled);
+
+  return (
+    <Card className="shadow-lg border-gray-200 dark:border-gray-700">
+      <CardHeader>
+        <CardTitle>Manual payments</CardTitle>
+        <CardDescription>
+          Whether Finance staff may mark invoices as paid by hand, from
+          Invoices → Manual Payments. Each currency is switched separately.
+          Confirming still requires the payment slip and the booking&apos;s pay
+          window to be open.
+        </CardDescription>
+      </CardHeader>
+
+      <CardContent className="space-y-4">
+        {noneEnabled && (
+          <div className="flex items-start gap-2 rounded-md border border-amber-200 bg-amber-50 p-3 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950 dark:text-amber-100">
+            <AlertTriangle className="mt-0.5 h-4 w-4 shrink-0" />
+            <p>
+              Both currencies are off — the Manual Payments list is empty and
+              Finance cannot settle any invoice by hand.
+            </p>
+          </div>
+        )}
+
+        {isLoading || !data
+          ? CURRENCIES.map((c) => (
+              <Skeleton key={c.code} className="h-[86px] w-full rounded-md" />
+            ))
+          : CURRENCIES.map(({ code, field, icon: Icon, title, description }) => {
+              const enabled = data[field];
+              return (
+                <div
+                  key={code}
+                  className="flex items-start justify-between gap-4 rounded-md border p-4 dark:border-gray-700"
+                >
+                  <div className="space-y-1">
+                    <div className="flex items-center gap-2">
+                      <Icon className="h-4 w-4 text-muted-foreground" />
+                      <p className="font-medium">{title}</p>
+                      <Badge variant={enabled ? "default" : "secondary"}>
+                        {enabled ? "Enabled" : "Disabled"}
+                      </Badge>
+                    </div>
+                    <p className="text-sm text-muted-foreground">
+                      {description}
+                    </p>
+                  </div>
+                  <Switch
+                    checked={enabled}
+                    disabled={!canManage || update.isPending}
+                    aria-label={`Allow manual payment for ${code} invoices`}
+                    onCheckedChange={(checked) =>
+                      update.mutate({ [field]: checked })
+                    }
+                  />
+                </div>
+              );
+            })}
+
+        {!canManage && (
+          <p className="text-sm text-muted-foreground">
+            You can see these settings but not change them — that needs the
+            manual-payment settings permission.
+          </p>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCompaniesPage.tsx b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCompaniesPage.tsx
new file mode 100644
index 000000000..d8e0bb0d6
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCompaniesPage.tsx
@@ -0,0 +1,405 @@
+import {
+  Alert,
+  Badge,
+  Box,
+  Button,
+  Card,
+  Group,
+  Modal,
+  Stack,
+  Text,
+  TextInput,
+} from "@mantine/core";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { Info, Mail, Phone, Plus, Ship } from "lucide-react";
+import { useMemo, useState } from "react";
+
+import { useAuth } from "@/auth/useAuth";
+import { PageContainer, PageHeader } from "@/components/page";
+import ResendActivationAction from "@/components/shipping-lines/ResendActivationAction";
+import { useToast } from "@/hooks/use-toast";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { api } from "@/services/api";
+import type { ShippingLineCompany } from "@/types/shippingLineCompany";
+import {
+  DataTable,
+  DataTableFooter,
+  usePagination,
+  type ColumnDef,
+} from "@edr/ui-common";
+
+/** SCAC is 2-4 letters; the API enforces the same rule. */
+const SCAC_PATTERN = /^[A-Za-z]{2,4}$/;
+
+interface FormValues {
+  name: string;
+  email: string;
+  phoneNumber: string;
+  scacCode: string;
+  imoNumber: string;
+  bicCode: string;
+}
+
+const EMPTY_FORM: FormValues = {
+  name: "",
+  email: "",
+  phoneNumber: "",
+  scacCode: "",
+  imoNumber: "",
+  bicCode: "",
+};
+
+const formatDate = (iso: string) =>
+  new Date(iso).toLocaleDateString(undefined, {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+  });
+
+/**
+ * Shipping line companies — carriers with their own portal login.
+ *
+ * Registration is staff-only: there is no self-signup. Staff never set a
+ * password; the system emails (and texts, when the number is domestic) a
+ * single-use activation link that the carrier uses to choose their own.
+ */
+export default function ShippingLineCompaniesPage() {
+  const { user } = useAuth();
+  const { toast } = useToast();
+  const { pagination, setPagination } = usePagination({ pageSize: 10 });
+  const [registerOpen, setRegisterOpen] = useState(false);
+
+  const canCreate = hasPermission(user, FREIGHT_PERMS.shippingLines.create);
+
+  const { data, isLoading, isError, error, refetch } = useQuery(
+    api.shippingLineCompanies.list.queryOptions({
+      input: {
+        page: pagination.pageIndex + 1,
+        limit: pagination.pageSize,
+      },
+    }),
+  );
+
+  const rows = data?.items ?? [];
+  const total = data?.total ?? 0;
+  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
+
+  const [values, setValues] = useState<FormValues>(EMPTY_FORM);
+  const [touched, setTouched] = useState(false);
+
+  const setField = (field: keyof FormValues) => (value: string) =>
+    setValues((prev) => ({ ...prev, [field]: value }));
+
+  // Mirrors the API's own validation, so the obvious mistakes are caught before
+  // a round trip. The server still enforces all of it.
+  const errors = {
+    name: values.name.trim() ? null : "Company name is required",
+    // Required, unlike a customer's: the activation link is sent here, so an
+    // account without one could never be signed in to.
+    email: /^\S+@\S+\.\S+$/.test(values.email.trim())
+      ? null
+      : "A valid email is required",
+    scacCode:
+      !values.scacCode.trim() || SCAC_PATTERN.test(values.scacCode.trim())
+        ? null
+        : "SCAC must be 2-4 letters",
+  };
+  const isValid = !errors.name && !errors.email && !errors.scacCode;
+
+  const closeRegister = () => {
+    setRegisterOpen(false);
+    setValues(EMPTY_FORM);
+    setTouched(false);
+  };
+
+  const { mutate: register, isPending: isRegistering } = useMutation(
+    api.shippingLineCompanies.register.mutationOptions({
+      onSuccess: (result) => {
+        closeRegister();
+        toast({
+          title: "Shipping line registered",
+          description: result.activationSentTo
+            ? `An activation link was sent to ${result.activationSentTo}. It expires in 24 hours.`
+            : // The account exists and is valid — only delivery failed, and the
+              // link can be resent, so this is a warning rather than an error.
+              "The account was created, but the activation link could not be sent. Use “Resend activation” to try again.",
+          variant: result.activationSentTo ? undefined : "destructive",
+        });
+      },
+      onError: (err) => {
+        toast({
+          title: "Could not register shipping line",
+          description: err.message,
+          variant: "destructive",
+        });
+      },
+    }),
+  );
+
+  const columns: ColumnDef<ShippingLineCompany>[] = useMemo(
+    () => [
+      {
+        id: "name",
+        header: "Shipping line",
+        cell: ({ row }) => {
+          const sl = row.original;
+          return (
+            <Group gap="sm" wrap="nowrap">
+              <Box
+                className="flex size-9 shrink-0 items-center justify-center rounded-lg"
+                style={{
+                  background: "var(--mantine-color-edr-green-1)",
+                  color: "var(--mantine-color-edr-green-7)",
+                }}
+              >
+                <Ship size={18} strokeWidth={1.9} />
+              </Box>
+              <div style={{ minWidth: 0 }}>
+                <Text fw={600} c="edr-text" truncate>
+                  {sl.name}
+                </Text>
+                {sl.scacCode ? (
+                  <Text size="xs" c="dimmed">
+                    SCAC {sl.scacCode}
+                  </Text>
+                ) : null}
+              </div>
+            </Group>
+          );
+        },
+      },
+      {
+        id: "contact",
+        header: "Contact",
+        cell: ({ row }) => {
+          const sl = row.original;
+          return (
+            <Stack gap={2}>
+              <Group gap={6} wrap="nowrap">
+                <Mail size={13} className="shrink-0 text-gray-400" />
+                <Text size="sm" truncate>
+                  {sl.email}
+                </Text>
+              </Group>
+              {sl.phoneNumber ? (
+                <Group gap={6} wrap="nowrap">
+                  <Phone size={13} className="shrink-0 text-gray-400" />
+                  <Text size="sm" c="dimmed">
+                    {sl.phoneNumber}
+                  </Text>
+                </Group>
+              ) : null}
+            </Stack>
+          );
+        },
+      },
+      {
+        id: "identifiers",
+        header: "Identifiers",
+        cell: ({ row }) => {
+          const { imoNumber, bicCode } = row.original;
+          if (!imoNumber && !bicCode) {
+            return (
+              <Text size="sm" c="dimmed">
+                —
+              </Text>
+            );
+          }
+          return (
+            <Stack gap={2}>
+              {imoNumber ? <Text size="sm">IMO {imoNumber}</Text> : null}
+              {bicCode ? (
+                <Text size="sm" c="dimmed">
+                  BIC {bicCode}
+                </Text>
+              ) : null}
+            </Stack>
+          );
+        },
+      },
+      {
+        id: "status",
+        header: "Status",
+        cell: ({ row }) => (
+          <Badge
+            variant="light"
+            color={row.original.status === "active" ? "green" : "red"}
+          >
+            {row.original.status === "active" ? "Active" : "Suspended"}
+          </Badge>
+        ),
+      },
+      {
+        id: "createdAt",
+        header: "Registered",
+        cell: ({ row }) => (
+          <Text size="sm" c="dimmed">
+            {formatDate(row.original.createdAt)}
+          </Text>
+        ),
+      },
+      {
+        id: "actions",
+        header: "",
+        cell: ({ row }) => (
+          <Group gap={4} justify="flex-end" wrap="nowrap">
+            <ResendActivationAction shippingLine={row.original} />
+          </Group>
+        ),
+      },
+    ],
+    [],
+  );
+
+  return (
+    <PageContainer>
+      <Stack gap="lg">
+        <PageHeader
+          title="Shipping Lines"
+          subtitle="Carriers with their own portal access. Registered by staff — there is no self-signup."
+          action={
+            canCreate ? (
+              <Button
+                leftSection={<Plus size={16} />}
+                onClick={() => setRegisterOpen(true)}
+              >
+                Register shipping line
+              </Button>
+            ) : null
+          }
+        />
+
+        <Card withBorder padding={0} radius="md">
+          <DataTable
+            columns={columns}
+            data={rows}
+            status={isLoading ? "loading" : isError ? "error" : "success"}
+            emptyMessage="No shipping lines registered yet."
+            error={
+              isError
+                ? {
+                    message: error?.message ?? "Failed to load shipping lines.",
+                    onRetry: () => void refetch(),
+                  }
+                : undefined
+            }
+            pagination={{
+              pageIndex: pagination.pageIndex,
+              pageSize: pagination.pageSize,
+              pageCount,
+              totalCount: total,
+            }}
+            tableOptions={{
+              state: { pagination },
+              onPaginationChange: setPagination,
+              manualPagination: true,
+              pageCount,
+            }}
+            containerClassName="border-0 shadow-none bg-transparent"
+            footer={DataTableFooter}
+          />
+        </Card>
+      </Stack>
+
+      <Modal
+        opened={registerOpen}
+        onClose={closeRegister}
+        title="Register shipping line"
+        centered
+      >
+        <form
+          onSubmit={(event) => {
+            event.preventDefault();
+            setTouched(true);
+            if (!isValid) return;
+            register({
+              name: values.name.trim(),
+              email: values.email.trim(),
+              phoneNumber: values.phoneNumber.trim() || undefined,
+              scacCode: values.scacCode.trim() || undefined,
+              imoNumber: values.imoNumber.trim() || undefined,
+              bicCode: values.bicCode.trim() || undefined,
+            });
+          }}
+        >
+          <Stack gap="md">
+            <Alert
+              icon={<Info size={16} />}
+              color="blue"
+              variant="light"
+              p="sm"
+            >
+              <Text size="sm">
+                No password is set here. The shipping line receives a single-use
+                activation link and chooses their own.
+              </Text>
+            </Alert>
+
+            <TextInput
+              label="Company name"
+              placeholder="Ethiopian Shipping Lines"
+              withAsterisk
+              value={values.name}
+              onChange={(e) => setField("name")(e.currentTarget.value)}
+              error={touched ? errors.name : null}
+            />
+
+            <TextInput
+              label="Email"
+              placeholder="ops@example.com"
+              description="The activation link is sent here."
+              withAsterisk
+              value={values.email}
+              onChange={(e) => setField("email")(e.currentTarget.value)}
+              error={touched ? errors.email : null}
+            />
+
+            <TextInput
+              label="Phone number"
+              placeholder="+251911223344"
+              description="Ethiopian numbers also receive the link by SMS."
+              value={values.phoneNumber}
+              onChange={(e) => setField("phoneNumber")(e.currentTarget.value)}
+            />
+
+            <Group grow align="flex-start">
+              <TextInput
+                label="SCAC"
+                placeholder="ESLK"
+                value={values.scacCode}
+                onChange={(e) => setField("scacCode")(e.currentTarget.value)}
+                error={touched ? errors.scacCode : null}
+              />
+              <TextInput
+                label="IMO number"
+                placeholder="IMO9074729"
+                value={values.imoNumber}
+                onChange={(e) => setField("imoNumber")(e.currentTarget.value)}
+              />
+            </Group>
+
+            <TextInput
+              label="BIC code"
+              placeholder="ESLU"
+              value={values.bicCode}
+              onChange={(e) => setField("bicCode")(e.currentTarget.value)}
+            />
+
+            <Group justify="flex-end" gap="sm" mt="xs">
+              <Button
+                variant="default"
+                onClick={closeRegister}
+                disabled={isRegistering}
+              >
+                Cancel
+              </Button>
+              <Button type="submit" loading={isRegistering}>
+                Register &amp; send link
+              </Button>
+            </Group>
+          </Stack>
+        </form>
+      </Modal>
+    </PageContainer>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditInvoicesPanel.tsx b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditInvoicesPanel.tsx
new file mode 100644
index 000000000..5dba366b6
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditInvoicesPanel.tsx
@@ -0,0 +1,279 @@
+import {
+  Badge,
+  Box,
+  Button,
+  Card,
+  Group,
+  Select,
+  Stack,
+  Text,
+} from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import { Calendar, FilterX, RefreshCw, Ship } from "lucide-react";
+import { useMemo, useState } from "react";
+
+import { bookingTable } from "@/components/bookings/booking-ui.styles";
+import { formatDate, formatMoney } from "@/components/customers";
+import CreditInvoiceActions from "@/components/shipping-lines/CreditInvoiceActions";
+import { api } from "@/services/api";
+import type { CreditInvoice } from "@/types/shippingLineCredit";
+import {
+  DataTable,
+  DataTableFooter,
+  usePagination,
+  type ColumnDef,
+} from "@edr/ui-common";
+
+const INVOICE_STATUS_META: Record<string, { label: string; color: string }> = {
+  DRAFT: { label: "Draft", color: "gray" },
+  ISSUED: { label: "Issued", color: "orange" },
+  PENDING: { label: "Pending", color: "orange" },
+  PAYMENT_PROCESSING: { label: "Processing", color: "blue" },
+  PARTIALLY_PAID: { label: "Partially paid", color: "yellow" },
+  PAID: { label: "Paid", color: "green" },
+  OVERDUE: { label: "Overdue", color: "red" },
+  CANCELLED: { label: "Cancelled", color: "gray" },
+  REFUNDED: { label: "Refunded", color: "blue" },
+  EXPIRED: { label: "Expired", color: "red" },
+};
+
+const STATUS_OPTIONS = Object.entries(INVOICE_STATUS_META).map(
+  ([value, meta]) => ({ value, label: meta.label }),
+);
+
+/**
+ * Invoices minted from credit batches. The actions column is the shared
+ * maker–checker component (also embedded on the Finance hub's invoice list):
+ * finance requests mark-paid / cancel, a chief approves or rejects.
+ */
+export default function ShippingLineCreditInvoicesPanel() {
+  const { pagination, setPagination } = usePagination({ pageSize: 10 });
+  const [status, setStatus] = useState<string | null>(null);
+  const [shippingLineId, setShippingLineId] = useState<string | null>(null);
+
+  const { data: companies } = useQuery(
+    api.shippingLineCompanies.list.queryOptions({
+      input: { page: 1, limit: 100 },
+    }),
+  );
+  const lineOptions = useMemo(
+    () =>
+      (companies?.items ?? []).map((sl) => ({ value: sl.id, label: sl.name })),
+    [companies],
+  );
+
+  const { data, isLoading, isError, error, refetch, isFetching } = useQuery(
+    api.shippingLineCredits.listInvoices.queryOptions({
+      input: {
+        page: pagination.pageIndex + 1,
+        pageSize: pagination.pageSize,
+        status: status ?? undefined,
+        shippingLineId: shippingLineId ?? undefined,
+      },
+    }),
+  );
+
+  const rows = data?.items ?? [];
+  const total = data?.total ?? 0;
+  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
+  const activeFilterCount = (shippingLineId ? 1 : 0) + (status ? 1 : 0);
+
+  const resetPage = () =>
+    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
+
+  const columns: ColumnDef<CreditInvoice>[] = useMemo(
+    () => [
+      {
+        id: "invoice",
+        header: () => <span className={bookingTable.headerCell}>Invoice</span>,
+        cell: ({ row }) => {
+          const inv = row.original;
+          return (
+            <div className="flex items-center gap-3 py-1.5">
+              <div className={bookingTable.rowIcon}>
+                <Ship className="size-4" strokeWidth={1.75} />
+              </div>
+              <div className="min-w-0">
+                <p className="truncate font-mono text-sm font-semibold text-foreground">
+                  {inv.invoiceNumber}
+                </p>
+                <p className="mt-0.5 truncate text-xs text-muted-foreground">
+                  {inv.shippingLineName ?? "—"}
+                </p>
+              </div>
+            </div>
+          );
+        },
+      },
+      {
+        id: "issued",
+        header: () => <span className={bookingTable.headerCell}>Issued</span>,
+        cell: ({ row }) => (
+          <span className="inline-flex items-center gap-1.5 text-sm text-muted-foreground">
+            <Calendar className="size-3.5" />
+            {row.original.issuedAt ? formatDate(row.original.issuedAt) : "—"}
+          </span>
+        ),
+      },
+      {
+        id: "due",
+        header: () => <span className={bookingTable.headerCell}>Due</span>,
+        cell: ({ row }) => (
+          <span className="text-sm text-muted-foreground">
+            {row.original.dueAt ? formatDate(row.original.dueAt) : "—"}
+          </span>
+        ),
+      },
+      {
+        id: "amount",
+        header: () => <span className={bookingTable.headerCell}>Amount</span>,
+        cell: ({ row }) => (
+          <span className="text-sm font-semibold text-foreground">
+            {formatMoney(
+              Number(row.original.totalAmount),
+              row.original.currency,
+            )}
+          </span>
+        ),
+      },
+      {
+        id: "balance",
+        header: () => <span className={bookingTable.headerCell}>Balance</span>,
+        cell: ({ row }) => (
+          <span className="text-sm text-muted-foreground">
+            {formatMoney(
+              Number(row.original.balanceAmount ?? row.original.totalAmount),
+              row.original.currency,
+            )}
+          </span>
+        ),
+      },
+      {
+        id: "status",
+        header: () => <span className={bookingTable.headerCell}>Status</span>,
+        cell: ({ row }) => {
+          const meta = INVOICE_STATUS_META[row.original.status] ?? {
+            label: row.original.status,
+            color: "gray",
+          };
+          return (
+            <Badge variant="light" color={meta.color}>
+              {meta.label}
+            </Badge>
+          );
+        },
+      },
+      {
+        id: "actions",
+        header: () => <span className={bookingTable.headerCell}>Actions</span>,
+        cell: ({ row }) => (
+          <CreditInvoiceActions
+            invoice={row.original}
+            pendingAction={row.original.pendingAction}
+          />
+        ),
+      },
+    ],
+    [],
+  );
+
+  return (
+    <Stack gap="lg">
+      <Card p={0}>
+        <Stack gap={0}>
+          <Box px="md" pt="md" pb="sm" w="100%">
+            <Group justify="space-between" gap="md" wrap="wrap">
+              <Group gap="sm" wrap="wrap">
+                <Select
+                  placeholder="All shipping lines"
+                  data={lineOptions}
+                  value={shippingLineId}
+                  onChange={(v) => {
+                    setShippingLineId(v);
+                    resetPage();
+                  }}
+                  clearable
+                  searchable
+                  radius="lg"
+                  style={{ minWidth: 220 }}
+                />
+                <Select
+                  placeholder="All statuses"
+                  data={STATUS_OPTIONS}
+                  value={status}
+                  onChange={(v) => {
+                    setStatus(v);
+                    resetPage();
+                  }}
+                  clearable
+                  radius="lg"
+                  style={{ minWidth: 160 }}
+                />
+                {activeFilterCount > 0 ? (
+                  <Button
+                    variant="subtle"
+                    color="gray"
+                    radius="lg"
+                    leftSection={<FilterX size={16} />}
+                    onClick={() => {
+                      setShippingLineId(null);
+                      setStatus(null);
+                      resetPage();
+                    }}
+                  >
+                    Clear filters ({activeFilterCount})
+                  </Button>
+                ) : null}
+              </Group>
+              <Group gap="sm" wrap="nowrap">
+                <Text size="sm" c="dimmed">
+                  {total} record{total !== 1 ? "s" : ""}
+                </Text>
+                <Button
+                  variant="default"
+                  size="compact-sm"
+                  leftSection={<RefreshCw size={14} />}
+                  loading={isFetching}
+                  onClick={() => void refetch()}
+                >
+                  Refresh
+                </Button>
+              </Group>
+            </Group>
+          </Box>
+
+          <Box style={{ overflowX: "auto" }} w="100%">
+            <DataTable
+              columns={columns}
+              data={rows}
+              status={isLoading ? "loading" : isError ? "error" : "success"}
+              emptyMessage="No credit invoices yet — generate one from the Credits tab."
+              error={
+                isError
+                  ? {
+                      message: error?.message ?? "Failed to load invoices.",
+                      onRetry: () => void refetch(),
+                    }
+                  : undefined
+              }
+              pagination={{
+                pageIndex: pagination.pageIndex,
+                pageSize: pagination.pageSize,
+                pageCount,
+                totalCount: total,
+              }}
+              tableOptions={{
+                state: { pagination },
+                onPaginationChange: setPagination,
+                manualPagination: true,
+                pageCount,
+              }}
+              containerClassName="border-0 shadow-none bg-transparent"
+              footer={DataTableFooter}
+            />
+          </Box>
+        </Stack>
+      </Card>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditsPage.tsx
new file mode 100644
index 000000000..aecaab753
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditsPage.tsx
@@ -0,0 +1,65 @@
+import { Stack, Tabs } from "@mantine/core";
+import { HandCoins, Receipt } from "lucide-react";
+import { useSearchParams } from "react-router-dom";
+
+import { PageContainer, PageHeader } from "@/components/page";
+
+import ShippingLineCreditInvoicesPanel from "./ShippingLineCreditInvoicesPanel";
+import ShippingLineCreditsPanel from "./ShippingLineCreditsPanel";
+
+/**
+ * Finance's view of what shipping lines owe. Two URL-linkable tabs (?tab=,
+ * FinanceHubPage convention): the credit ledger (select unbilled credits →
+ * generate an invoice) and the invoices minted from it (maker–checker
+ * mark-paid / cancel actions).
+ */
+export default function ShippingLineCreditsPage() {
+  const [searchParams, setSearchParams] = useSearchParams();
+  const activeTab =
+    searchParams.get("tab") === "invoices" ? "invoices" : "credits";
+
+  const handleTabChange = (value: string | null) => {
+    if (!value) return;
+    setSearchParams(
+      (prev) => {
+        const next = new URLSearchParams(prev);
+        next.set("tab", value);
+        return next;
+      },
+      { replace: true },
+    );
+  };
+
+  return (
+    <PageContainer>
+      <Stack gap="lg">
+        <PageHeader
+          title="Shipping Line Credits"
+          subtitle={
+            activeTab === "invoices"
+              ? "Invoices billed from credit batches. Manual mark-paid / cancel actions need a second approver."
+              : "What each line owes — outstanding totals and the full credit ledger."
+          }
+        />
+
+        <Tabs value={activeTab} onChange={handleTabChange} keepMounted={false}>
+          <Tabs.List>
+            <Tabs.Tab value="credits" leftSection={<HandCoins size={16} />}>
+              Credits
+            </Tabs.Tab>
+            <Tabs.Tab value="invoices" leftSection={<Receipt size={16} />}>
+              Invoices
+            </Tabs.Tab>
+          </Tabs.List>
+
+          <Tabs.Panel value="credits" pt="lg">
+            <ShippingLineCreditsPanel />
+          </Tabs.Panel>
+          <Tabs.Panel value="invoices" pt="lg">
+            <ShippingLineCreditInvoicesPanel />
+          </Tabs.Panel>
+        </Tabs>
+      </Stack>
+    </PageContainer>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditsPanel.tsx b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditsPanel.tsx
new file mode 100644
index 000000000..b4c01ab43
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/pages/shipping-lines/ShippingLineCreditsPanel.tsx
@@ -0,0 +1,553 @@
+import {
+  Badge,
+  Box,
+  Button,
+  Card,
+  Checkbox,
+  Divider,
+  Group,
+  Modal,
+  NumberInput,
+  Select,
+  Stack,
+  Text,
+} from "@mantine/core";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import {
+  Calendar,
+  Clock,
+  FilterX,
+  HandCoins,
+  Receipt,
+  RefreshCw,
+  Ship,
+} from "lucide-react";
+import { useMemo, useState } from "react";
+
+import { useAuth } from "@/auth/useAuth";
+import { bookingTable } from "@/components/bookings/booking-ui.styles";
+import { formatDate, formatMoney } from "@/components/customers";
+import { KpiStrip } from "@/components/page";
+import { useToast } from "@/hooks/use-toast";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { api } from "@/services/api";
+import type {
+  ShippingLineCredit,
+  ShippingLineCreditStatus,
+} from "@/types/shippingLineCredit";
+import {
+  DataTable,
+  DataTableFooter,
+  usePagination,
+  type ColumnDef,
+} from "@edr/ui-common";
+
+const STATUS_META: Record<
+  ShippingLineCreditStatus,
+  { label: string; color: string }
+> = {
+  UNBILLED: { label: "Unbilled", color: "orange" },
+  BILLED: { label: "Billed", color: "blue" },
+  PAID: { label: "Paid", color: "green" },
+  CANCELLED: { label: "Cancelled", color: "gray" },
+};
+
+const STATUS_OPTIONS = Object.entries(STATUS_META).map(([value, meta]) => ({
+  value,
+  label: meta.label,
+}));
+
+/**
+ * Every shipping line's credits in one list — finance's landing view, styled
+ * to match the booking-requests page. Summary cells total the current filter
+ * scope (all lines by default); the selects narrow both cells and ledger.
+ */
+export default function ShippingLineCreditsPanel() {
+  const { user } = useAuth();
+  const { toast } = useToast();
+  const [shippingLineId, setShippingLineId] = useState<string | null>(null);
+  const [status, setStatus] = useState<ShippingLineCreditStatus | null>(null);
+  const { pagination, setPagination } = usePagination({ pageSize: 10 });
+
+  const canInvoice = hasPermission(
+    user,
+    FREIGHT_PERMS.shippingLineCredits.invoice,
+  );
+
+  // Selection for batch invoicing, kept as id → credit so it survives page
+  // changes and can total itself. One invoice has one payer, so everything
+  // selected must belong to the same shipping line — enforced here so the
+  // API's rejection is never the first time staff hears about it.
+  const [selected, setSelected] = useState<Map<string, ShippingLineCredit>>(
+    new Map(),
+  );
+  const [invoiceOpen, setInvoiceOpen] = useState(false);
+  const [dueInDays, setDueInDays] = useState<number | "">("");
+
+  const selectedCredits = useMemo(() => [...selected.values()], [selected]);
+  const selectedLineId = selectedCredits[0]?.shippingLineCompanyId ?? null;
+  const selectedTotal = selectedCredits.reduce(
+    (sum, c) => sum + Number(c.amount),
+    0,
+  );
+
+  const toggleSelected = (credit: ShippingLineCredit) =>
+    setSelected((prev) => {
+      const next = new Map(prev);
+      if (next.has(credit.id)) next.delete(credit.id);
+      else next.set(credit.id, credit);
+      return next;
+    });
+
+  const clearSelection = () => setSelected(new Map());
+
+  // ponytail: first 100 lines in the picker; server-side search when a real
+  // deployment outgrows that.
+  const { data: companies } = useQuery(
+    api.shippingLineCompanies.list.queryOptions({
+      input: { page: 1, limit: 100 },
+    }),
+  );
+
+  const lineOptions = useMemo(
+    () =>
+      (companies?.items ?? []).map((sl) => ({
+        value: sl.id,
+        label: sl.scacCode ? `${sl.name} (${sl.scacCode})` : sl.name,
+      })),
+    [companies],
+  );
+
+  const {
+    data: summary,
+    isLoading: summaryLoading,
+    refetch: refetchSummary,
+  } = useQuery(
+    api.shippingLineCredits.summary.queryOptions({
+      input: { shippingLineId: shippingLineId ?? undefined },
+    }),
+  );
+
+  const {
+    data: ledger,
+    isLoading,
+    isError,
+    error,
+    refetch,
+    isFetching,
+  } = useQuery(
+    api.shippingLineCredits.list.queryOptions({
+      input: {
+        page: pagination.pageIndex + 1,
+        pageSize: pagination.pageSize,
+        status: status ?? undefined,
+        shippingLineId: shippingLineId ?? undefined,
+      },
+    }),
+  );
+
+  const rows = ledger?.items ?? [];
+  const total = ledger?.total ?? 0;
+  const pageCount = Math.max(1, Math.ceil(total / pagination.pageSize));
+  const activeFilterCount = (shippingLineId ? 1 : 0) + (status ? 1 : 0);
+
+  const resetPage = () =>
+    setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
+
+  const clearFilters = () => {
+    setShippingLineId(null);
+    setStatus(null);
+    resetPage();
+  };
+
+  const handleRefresh = () => {
+    void refetch();
+    void refetchSummary();
+  };
+
+  const { mutate: generateInvoice, isPending: isInvoicing } = useMutation(
+    api.shippingLineCredits.generateInvoice.mutationOptions({
+      onSuccess: (invoice) => {
+        setInvoiceOpen(false);
+        clearSelection();
+        setDueInDays("");
+        toast({
+          title: `Invoice ${invoice.invoiceNumber} generated`,
+          description: `${formatMoney(Number(invoice.totalAmount), invoice.currency)} billed across ${selectedCredits.length} credit${selectedCredits.length === 1 ? "" : "s"}.`,
+        });
+      },
+      onError: (err) => {
+        toast({
+          title: "Could not generate invoice",
+          description: err.message,
+          variant: "destructive",
+        });
+        // A concurrent edit (someone else billed a selected credit) is the
+        // usual cause — resync so stale rows drop out of the list.
+        handleRefresh();
+      },
+    }),
+  );
+
+  const columns: ColumnDef<ShippingLineCredit>[] = useMemo(
+    () => [
+      ...(canInvoice
+        ? [
+            {
+              id: "select",
+              size: 40,
+              header: () => null,
+              cell: ({ row }: { row: { original: ShippingLineCredit } }) => {
+                const credit = row.original;
+                const selectable =
+                  credit.status === "UNBILLED" &&
+                  (selectedLineId === null ||
+                    credit.shippingLineCompanyId === selectedLineId);
+                return (
+                  <Checkbox
+                    size="sm"
+                    checked={selected.has(credit.id)}
+                    disabled={!selectable}
+                    title={
+                      credit.status !== "UNBILLED"
+                        ? "Only unbilled credits can be invoiced"
+                        : !selectable
+                          ? "One invoice has one payer — selection already holds another line's credits"
+                          : undefined
+                    }
+                    onChange={() => toggleSelected(credit)}
+                    aria-label="Select credit for invoicing"
+                  />
+                );
+              },
+            },
+          ]
+        : []),
+      {
+        id: "shippingLine",
+        header: () => (
+          <span className={bookingTable.headerCell}>Shipping line</span>
+        ),
+        cell: ({ row }) => {
+          const credit = row.original;
+          return (
+            <div className="flex items-center gap-3 py-1.5">
+              <div className={bookingTable.rowIcon}>
+                <Ship className="size-4" strokeWidth={1.75} />
+              </div>
+              <div className="min-w-0">
+                <p className="truncate font-medium text-foreground">
+                  {credit.shippingLineCompany?.name ?? "—"}
+                </p>
+                <p className="mt-0.5 truncate font-mono text-xs text-muted-foreground">
+                  {credit.booking?.reference ?? "—"}
+                </p>
+              </div>
+            </div>
+          );
+        },
+      },
+      {
+        id: "description",
+        header: () => (
+          <span className={bookingTable.headerCell}>Description</span>
+        ),
+        cell: ({ row }) => (
+          <span className="block max-w-[16rem] truncate py-1 text-sm text-muted-foreground">
+            {row.original.description ?? "—"}
+          </span>
+        ),
+      },
+      {
+        id: "amount",
+        header: () => <span className={bookingTable.headerCell}>Amount</span>,
+        cell: ({ row }) => (
+          <span className="text-sm font-semibold text-foreground">
+            {formatMoney(Number(row.original.amount), row.original.currency)}
+          </span>
+        ),
+      },
+      {
+        id: "status",
+        header: () => <span className={bookingTable.headerCell}>Status</span>,
+        cell: ({ row }) => {
+          const meta = STATUS_META[row.original.status];
+          return (
+            <Badge variant="light" color={meta.color}>
+              {meta.label}
+            </Badge>
+          );
+        },
+      },
+      {
+        id: "invoice",
+        header: () => <span className={bookingTable.headerCell}>Invoice</span>,
+        cell: ({ row }) => {
+          const inv = row.original.invoice;
+          return inv ? (
+            <span className="truncate font-mono text-xs text-foreground">
+              {inv.invoiceNumber}
+            </span>
+          ) : (
+            <span className="text-xs text-muted-foreground">—</span>
+          );
+        },
+      },
+      {
+        id: "createdAt",
+        header: () => <span className={bookingTable.headerCell}>Recorded</span>,
+        cell: ({ row }) => (
+          <span className="inline-flex items-center gap-1.5 text-sm text-muted-foreground">
+            <Calendar className="size-3.5" />
+            {formatDate(row.original.createdAt)}
+          </span>
+        ),
+      },
+    ],
+    // Selection state drives the checkbox column's checked/disabled rendering.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [canInvoice, selected, selectedLineId],
+  );
+
+  return (
+    <Stack gap="lg">
+      <KpiStrip
+        loading={summaryLoading}
+        items={[
+          {
+            label: "Total outstanding",
+            value: summary
+              ? formatMoney(summary.totalOutstanding, summary.currency)
+              : "—",
+            hint: "unbilled + billed",
+            icon: HandCoins,
+            color: "edr-green",
+          },
+          {
+            label: "Unbilled",
+            value: summary
+              ? formatMoney(summary.unbilledAmount, summary.currency)
+              : "—",
+            hint: summary ? `${summary.unbilledCount} credits` : undefined,
+            icon: Clock,
+            color: "yellow",
+          },
+          {
+            label: "Billed",
+            value: summary
+              ? formatMoney(summary.billedAmount, summary.currency)
+              : "—",
+            hint: summary ? `${summary.billedCount} on invoices` : undefined,
+            icon: Receipt,
+            color: "blue",
+          },
+        ]}
+      />
+
+      <Card p={0}>
+        <Stack gap={0}>
+          <Box px="md" pt="md" pb="sm" w="100%">
+            <Group justify="space-between" gap="md" wrap="wrap">
+              <Group gap="sm" wrap="wrap">
+                <Select
+                  placeholder="All shipping lines"
+                  data={lineOptions}
+                  value={shippingLineId}
+                  onChange={(v) => {
+                    setShippingLineId(v);
+                    resetPage();
+                  }}
+                  clearable
+                  searchable
+                  radius="lg"
+                  style={{ minWidth: 220 }}
+                />
+                <Select
+                  placeholder="All statuses"
+                  data={STATUS_OPTIONS}
+                  value={status}
+                  onChange={(v) => {
+                    setStatus((v as ShippingLineCreditStatus | null) ?? null);
+                    resetPage();
+                  }}
+                  clearable
+                  radius="lg"
+                  style={{ minWidth: 160 }}
+                />
+                {activeFilterCount > 0 ? (
+                  <Button
+                    variant="subtle"
+                    color="gray"
+                    radius="lg"
+                    leftSection={<FilterX size={16} />}
+                    onClick={clearFilters}
+                  >
+                    Clear filters ({activeFilterCount})
+                  </Button>
+                ) : null}
+              </Group>
+              <Group gap="sm" wrap="nowrap">
+                <Text size="sm" c="dimmed">
+                  {total} record{total !== 1 ? "s" : ""}
+                </Text>
+                <Button
+                  variant="default"
+                  size="compact-sm"
+                  leftSection={<RefreshCw size={14} />}
+                  loading={isFetching}
+                  onClick={handleRefresh}
+                >
+                  Refresh
+                </Button>
+              </Group>
+            </Group>
+          </Box>
+
+          {selectedCredits.length > 0 ? (
+            <>
+              <Divider />
+              <Group
+                px="md"
+                py="sm"
+                justify="space-between"
+                wrap="wrap"
+                bg="var(--mantine-color-edr-green-0)"
+              >
+                <Text size="sm" fw={600}>
+                  {selectedCredits.length} credit
+                  {selectedCredits.length === 1 ? "" : "s"} selected ·{" "}
+                  {formatMoney(selectedTotal, selectedCredits[0].currency)}
+                  {" — "}
+                  {selectedCredits[0].shippingLineCompany?.name ?? ""}
+                </Text>
+                <Group gap="sm">
+                  <Button
+                    variant="subtle"
+                    color="gray"
+                    size="compact-sm"
+                    onClick={clearSelection}
+                  >
+                    Clear selection
+                  </Button>
+                  <Button
+                    size="compact-sm"
+                    leftSection={<Receipt size={14} />}
+                    onClick={() => setInvoiceOpen(true)}
+                  >
+                    Generate invoice
+                  </Button>
+                </Group>
+              </Group>
+            </>
+          ) : null}
+
+          <Box style={{ overflowX: "auto" }} w="100%">
+            <DataTable
+              columns={columns}
+              data={rows}
+              status={isLoading ? "loading" : isError ? "error" : "success"}
+              emptyMessage="No credits match this filter."
+              error={
+                isError
+                  ? {
+                      message: error?.message ?? "Failed to load credits.",
+                      onRetry: () => void refetch(),
+                    }
+                  : undefined
+              }
+              pagination={{
+                pageIndex: pagination.pageIndex,
+                pageSize: pagination.pageSize,
+                pageCount,
+                totalCount: total,
+              }}
+              tableOptions={{
+                state: { pagination },
+                onPaginationChange: setPagination,
+                manualPagination: true,
+                pageCount,
+              }}
+              containerClassName="border-0 shadow-none bg-transparent"
+              footer={DataTableFooter}
+            />
+          </Box>
+        </Stack>
+      </Card>
+
+      <Modal
+        opened={invoiceOpen}
+        onClose={() => setInvoiceOpen(false)}
+        title="Generate invoice"
+        centered
+      >
+        <Stack gap="md">
+          <Text size="sm" c="dimmed">
+            One invoice for{" "}
+            <Text component="span" fw={600} c="edr-text">
+              {selectedCredits[0]?.shippingLineCompany?.name ?? "this line"}
+            </Text>{" "}
+            billing the selected credits. The line pays it at any CBE channel —
+            there is no payment window.
+          </Text>
+
+          <Stack gap={6}>
+            {selectedCredits.map((credit) => (
+              <Group key={credit.id} justify="space-between" wrap="nowrap">
+                <Text size="sm" truncate>
+                  {credit.booking?.reference ?? credit.description ?? credit.id}
+                </Text>
+                <Text size="sm" fw={500} style={{ whiteSpace: "nowrap" }}>
+                  {formatMoney(Number(credit.amount), credit.currency)}
+                </Text>
+              </Group>
+            ))}
+            <Divider my={4} />
+            <Group justify="space-between">
+              <Text size="sm" fw={700}>
+                Total
+              </Text>
+              <Text size="sm" fw={700}>
+                {formatMoney(
+                  selectedTotal,
+                  selectedCredits[0]?.currency ?? "ETB",
+                )}
+              </Text>
+            </Group>
+          </Stack>
+
+          <NumberInput
+            label="Due in days"
+            description="Optional — defaults to the standard invoice term."
+            placeholder="14"
+            min={1}
+            value={dueInDays}
+            onChange={(v) => setDueInDays(typeof v === "number" ? v : "")}
+          />
+
+          <Group justify="flex-end" gap="sm">
+            <Button
+              variant="default"
+              onClick={() => setInvoiceOpen(false)}
+              disabled={isInvoicing}
+            >
+              Cancel
+            </Button>
+            <Button
+              loading={isInvoicing}
+              onClick={() =>
+                generateInvoice({
+                  creditIds: selectedCredits.map((c) => c.id),
+                  ...(typeof dueInDays === "number"
+                    ? { dueInDays }
+                    : {}),
+                })
+              }
+            >
+              Generate &amp; issue
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/pages/trainBuilder/TrainBuilderDetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/trainBuilder/TrainBuilderDetailPage.tsx
index 63f45617e..48799cccf 100644
--- a/apps/edr-freight-web/backoffice/src/pages/trainBuilder/TrainBuilderDetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/trainBuilder/TrainBuilderDetailPage.tsx
@@ -10,6 +10,7 @@ import {
   Progress,
   Stack,
   Text,
+  Textarea,
 } from "@mantine/core";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { isAxiosError } from "axios";
@@ -28,7 +29,7 @@ import {
   Weight,
   Wrench,
 } from "lucide-react";
-import { useState } from "react";
+import { useCallback, useMemo, useState } from "react";
 import { useNavigate, useParams } from "react-router-dom";
 
 import AvailableWagonsPanel from "@/components/trainBuilder/AvailableWagonsPanel";
@@ -47,7 +48,7 @@ import { TrainCompositionDiagram } from "@/components/trainScheduling/TrainCompo
 import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
 import { api } from "@/services/api";
 import { useAuth } from "@/auth/useAuth";
-import { canFleetAction, FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import { useToast } from "@/hooks/use-toast";
 import type { TrainCompositionWagon } from "@/services/trainBuilder.service";
 
@@ -82,18 +83,34 @@ export default function TrainBuilderDetailPage() {
   const [deactivateOpen, setDeactivateOpen] = useState(false);
   const [maintenanceTarget, setMaintenanceTarget] =
     useState<TrainCompositionWagon | null>(null);
+  const [maintenanceNote, setMaintenanceNote] = useState("");
+  // Clearing the note with the target stops one wagon's reason being carried
+  // over onto the next wagon sent to maintenance.
+  const closeMaintenance = () => {
+    setMaintenanceTarget(null);
+    setMaintenanceNote("");
+  };
   const { user } = useAuth();
-  const canUpdate = canFleetAction(user, "trains", "update");
-  const canDelete = canFleetAction(user, "trains", "delete");
-  const canAssign =
-    hasPermission(user, FREIGHT_PERMS.trains.assignWagons) ||
-    hasPermission(user, FREIGHT_PERMS.fleet.manage);
+  const canAssign = hasPermission(user, FREIGHT_PERMS.trains.assignWagons);
+  const canChangeLocomotives = hasPermission(user, FREIGHT_PERMS.trains.changeLocomotives);
+  const canChangeYard = hasPermission(user, FREIGHT_PERMS.trains.changeYard);
+  const canChangeWagonYard = hasPermission(user, FREIGHT_PERMS.trains.changeWagonYard);
+  const canToggleActive = hasPermission(user, FREIGHT_PERMS.trains.toggleActive);
+  const canDisband = hasPermission(user, FREIGHT_PERMS.trains.disband);
 
   const compositionQuery = useQuery(
-    api.trainBuilder.composition.queryOptions({ input: { id }, enabled: Boolean(id) }),
+    api.trainBuilder.composition.queryOptions({
+      input: { id },
+      enabled: Boolean(id),
+      // Mutations seed this key from their own response (see `seedComposition`
+      // in services/api.ts), so the cached consist is authoritative — the
+      // global staleTime of 0 would otherwise refetch it on every remount.
+      staleTime: 30_000,
+    }),
   );
   const assignWagons = useMutation(api.trainBuilder.assignWagons.mutationOptions());
   const removeWagon = useMutation(api.trainBuilder.removeWagon.mutationOptions());
+  const setWagonYard = useMutation(api.trainBuilder.setWagonYard.mutationOptions());
   const maintenanceWagon = useMutation(
     api.trainBuilder.sendWagonToMaintenance.mutationOptions(),
   );
@@ -103,23 +120,120 @@ export default function TrainBuilderDetailPage() {
   const activate = useMutation(api.trainBuilder.activate.mutationOptions());
 
   const composition = compositionQuery.data;
+
+  // The diagram memoizes off its `locomotives`/`wagons` props; building those
+  // arrays inline in JSX would hand it a new identity on every render and
+  // re-normalize + repaint every car for each keystroke or pending mutation.
+  const diagramLocomotives = useMemo(
+    () =>
+      (composition?.locomotives ?? []).map((loco) => ({
+        code: loco.code,
+        name: loco.name,
+        maxPullWeightTons: loco.maxPullWeightTons,
+      })),
+    [composition?.locomotives],
+  );
+  const diagramWagons = useMemo(
+    () =>
+      (composition?.wagons ?? []).map((wagon, index) => ({
+        sequenceNo: wagon.sequenceNumber ?? index + 1,
+        capacityTons: wagon.wagonType?.capacityTons ?? 0,
+        // No bookings at build time — wagons ride empty until allocation.
+        assignedWeightTons: 0,
+        tareWeightTons: wagon.wagonType?.tareWeightTons ?? 0,
+        wagonTypeCode: wagon.wagonType?.code ?? null,
+        physicalWagonNumber: wagon.wagonNumber,
+        allocations: [],
+      })),
+    [composition?.wagons],
+  );
+
+  // Staff identify a train by its operational run numbers, not the internal
+  // code — mirrors formatTrainRunLabel on the API, which writes the history note.
+  const trainRunLabel =
+    [
+      composition?.exportTrainNumber?.trim()
+        ? `export ${composition.exportTrainNumber.trim()}`
+        : null,
+      composition?.importTrainNumber?.trim()
+        ? `import ${composition.importTrainNumber.trim()}`
+        : null,
+    ]
+      .filter(Boolean)
+      .join(" / ") || composition?.code;
   const busy =
     assignWagons.isPending ||
     removeWagon.isPending ||
+    setWagonYard.isPending ||
     maintenanceWagon.isPending ||
     reorderWagons.isPending;
 
-  const withToast = async (action: () => Promise<unknown>, failTitle: string) => {
-    try {
-      await action();
-    } catch (err) {
-      toast({
-        title: failTitle,
-        description: parseError(err, "Something went wrong"),
-        variant: "destructive",
-      });
-    }
-  };
+  const withToast = useCallback(
+    async (action: () => Promise<unknown>, failTitle: string) => {
+      try {
+        await action();
+      } catch (err) {
+        toast({
+          title: failTitle,
+          description: parseError(err, "Something went wrong"),
+          variant: "destructive",
+        });
+      }
+    },
+    [toast],
+  );
+
+  // Stable handlers: the consist list and wagon picker are memoized, so a new
+  // closure each render would defeat the memo and re-render every wagon row
+  // (and re-mount the drag context) on unrelated state changes.
+  // `trainId` is only absent before the composition loads, and these handlers
+  // are wired to controls that render after that — the guard keeps the promise
+  // rather than leaning on a non-null assertion.
+  const trainId = composition?.id;
+  const handleAssign = useCallback(
+    (wagonIds: string[]) => {
+      if (!trainId) return;
+      void withToast(
+        () => assignWagons.mutateAsync({ id: trainId, wagonIds }),
+        "Could not add wagons",
+      );
+    },
+    [withToast, assignWagons.mutateAsync, trainId],
+  );
+  const handleReorder = useCallback(
+    (wagonIds: string[]) => {
+      if (!trainId) return;
+      void withToast(
+        () => reorderWagons.mutateAsync({ id: trainId, wagonIds }),
+        "Could not reorder wagons",
+      );
+    },
+    [withToast, reorderWagons.mutateAsync, trainId],
+  );
+  const handleRemove = useCallback(
+    (wagonId: string) => {
+      if (!trainId) return;
+      void withToast(
+        () => removeWagon.mutateAsync({ id: trainId, wagonId }),
+        "Could not detach wagon",
+      );
+    },
+    [withToast, removeWagon.mutateAsync, trainId],
+  );
+  const handleChangeWagonYard = useCallback(
+    (wagonId: string, currentYardId: string) => {
+      if (!trainId) return;
+      void withToast(
+        () => setWagonYard.mutateAsync({ id: trainId, wagonId, currentYardId }),
+        "Could not change wagon yard",
+      );
+    },
+    [withToast, setWagonYard.mutateAsync, trainId],
+  );
+  const handleMaintenance = useCallback(
+    (wagon: TrainCompositionWagon) => setMaintenanceTarget(wagon),
+    [],
+  );
 
   if (compositionQuery.isLoading) {
     return (
@@ -174,7 +288,7 @@ export default function TrainBuilderDetailPage() {
           </Group>
         }
         action={
-          canUpdate || canDelete ? (
+          canChangeLocomotives || canChangeYard || canToggleActive || canDisband ? (
             <Menu position="bottom-end" withinPortal shadow="md" width={220}>
               <Menu.Target>
                 <Button variant="default" rightSection={<MoreHorizontal size={16} />}>
@@ -182,47 +296,49 @@ export default function TrainBuilderDetailPage() {
                 </Button>
               </Menu.Target>
               <Menu.Dropdown>
-                {canUpdate ? (
-                  <>
-                    <Menu.Item
-                      leftSection={<Replace size={15} />}
-                      disabled={!composition.editable}
-                      onClick={() => setLocoModalOpen(true)}
-                    >
-                      Change locomotives
-                    </Menu.Item>
-                    <Menu.Item
-                      leftSection={<MapPin size={15} />}
-                      disabled={!composition.editable}
-                      onClick={() => setYardModalOpen(true)}
-                    >
-                      Change yard
-                    </Menu.Item>
-                    {composition.status === "DEACTIVATED" ? (
-                      <Menu.Item
-                        leftSection={<Power size={15} />}
-                        disabled={blockingLocomotives.length > 0}
-                        onClick={() =>
-                          void withToast(async () => {
-                            await activate.mutateAsync(composition.id);
-                            toast({ title: `Train ${composition.code} reactivated` });
-                          }, "Could not reactivate train")
-                        }
-                      >
-                        Reactivate train
-                      </Menu.Item>
-                    ) : (
-                      <Menu.Item
-                        leftSection={<PowerOff size={15} />}
-                        disabled={composition.activeSchedules.length > 0}
-                        onClick={() => setDeactivateOpen(true)}
-                      >
-                        Deactivate train
-                      </Menu.Item>
-                    )}
-                  </>
+                {canChangeLocomotives ? (
+                  <Menu.Item
+                    leftSection={<Replace size={15} />}
+                    disabled={!composition.editable}
+                    onClick={() => setLocoModalOpen(true)}
+                  >
+                    Change locomotives
+                  </Menu.Item>
                 ) : null}
-                {canDelete ? (
+                {canChangeYard ? (
+                  <Menu.Item
+                    leftSection={<MapPin size={15} />}
+                    disabled={!composition.editable}
+                    onClick={() => setYardModalOpen(true)}
+                  >
+                    Change yard
+                  </Menu.Item>
+                ) : null}
+                {canToggleActive ? (
+                  composition.status === "DEACTIVATED" ? (
+                    <Menu.Item
+                      leftSection={<Power size={15} />}
+                      disabled={blockingLocomotives.length > 0}
+                      onClick={() =>
+                        void withToast(async () => {
+                          await activate.mutateAsync(composition.id);
+                          toast({ title: `Train ${composition.code} reactivated` });
+                        }, "Could not reactivate train")
+                      }
+                    >
+                      Reactivate train
+                    </Menu.Item>
+                  ) : (
+                    <Menu.Item
+                      leftSection={<PowerOff size={15} />}
+                      disabled={composition.activeSchedules.length > 0}
+                      onClick={() => setDeactivateOpen(true)}
+                    >
+                      Deactivate train
+                    </Menu.Item>
+                  )
+                ) : null}
+                {canDisband ? (
                   <Menu.Item
                     color="red"
                     leftSection={<Trash2 size={15} />}
@@ -255,6 +371,29 @@ export default function TrainBuilderDetailPage() {
         ]}
       />
 
+      {composition.wagonYards.length > 1 ? (
+        <Alert color="blue" icon={<MapPin size={16} />}>
+          <Stack gap={4}>
+            <Text size="sm" fw={600}>
+              This train's wagons stand in {composition.wagonYards.length} yards
+            </Text>
+            <Group gap="xs">
+              {composition.wagonYards.map((group) => (
+                <Badge key={group.yardId ?? "none"} variant="light" color="blue">
+                  {group.label ?? group.code ?? "No yard"} · {group.wagonCount} wagon
+                  {group.wagonCount === 1 ? "" : "s"}
+                </Badge>
+              ))}
+            </Group>
+            <Text size="xs" c="dimmed">
+              The train collects each group when it reaches that yard, so the schedule's route
+              must pass through every one of them before its destination. Customers boarding at
+              a yard can only book the wagons standing there.
+            </Text>
+          </Stack>
+        </Alert>
+      ) : null}
+
       {!composition.editable ? (
         <Alert color="yellow" icon={<AlertTriangle size={16} />}>
           This train is out on a dispatched run — its composition is frozen until arrival.
@@ -279,7 +418,7 @@ export default function TrainBuilderDetailPage() {
               .
             </Text>
             <Group gap="xs">
-              {canUpdate ? (
+              {canChangeLocomotives ? (
                 <Button
                   size="compact-sm"
                   variant="light"
@@ -318,21 +457,8 @@ export default function TrainBuilderDetailPage() {
 
       <Stack gap="sm">
         <TrainCompositionDiagram
-          locomotives={composition.locomotives.map((loco) => ({
-            code: loco.code,
-            name: loco.name,
-            maxPullWeightTons: loco.maxPullWeightTons,
-          }))}
-          wagons={composition.wagons.map((wagon, index) => ({
-            sequenceNo: wagon.sequenceNumber ?? index + 1,
-            capacityTons: wagon.wagonType?.capacityTons ?? 0,
-            // No bookings at build time — wagons ride empty until allocation.
-            assignedWeightTons: 0,
-            tareWeightTons: wagon.wagonType?.tareWeightTons ?? 0,
-            wagonTypeCode: wagon.wagonType?.code ?? null,
-            physicalWagonNumber: wagon.wagonNumber,
-            allocations: [],
-          }))}
+          locomotives={diagramLocomotives}
+          wagons={diagramWagons}
           trainNumber={composition.code}
           totalLengthMeters={totals.totalLengthMeters}
         />
@@ -356,22 +482,17 @@ export default function TrainBuilderDetailPage() {
           <Grid.Col span={{ base: 12, md: 5 }}>
             <Card h="100%">
               <Stack gap="sm">
-                <Text fw={600}>Available wagons — {yard?.label ?? "yard"}</Text>
+                <Text fw={600}>Available wagons — all yards</Text>
                 <Text size="xs" c="dimmed">
-                  Only AVAILABLE wagons standing in the train's own yard can be coupled.
+                  AVAILABLE, unassigned wagons from every yard can be coupled. The schedule's
+                  route must pass through each wagon's yard before its destination.
                 </Text>
                 <AvailableWagonsPanel
-                  yardId={yard?.id ?? ""}
-                  yardLabel={yard?.label}
+                  homeYardId={yard?.id ?? null}
                   exportTrainNumber={composition.exportTrainNumber}
                   importTrainNumber={composition.importTrainNumber}
                   assigning={assignWagons.isPending}
-                  onAssign={(wagonIds) =>
-                    void withToast(
-                      () => assignWagons.mutateAsync({ id: composition.id, wagonIds }),
-                      "Could not add wagons",
-                    )
-                  }
+                  onAssign={handleAssign}
                 />
               </Stack>
             </Card>
@@ -388,19 +509,12 @@ export default function TrainBuilderDetailPage() {
                 wagons={composition.wagons}
                 editable={composition.editable && canAssign}
                 busy={busy}
-                onReorder={(wagonIds) =>
-                  void withToast(
-                    () => reorderWagons.mutateAsync({ id: composition.id, wagonIds }),
-                    "Could not reorder wagons",
-                  )
+                onReorder={handleReorder}
+                onRemove={handleRemove}
+                onMaintenance={handleMaintenance}
+                onChangeYard={
+                  composition.editable && canChangeWagonYard ? handleChangeWagonYard : undefined
                 }
-                onRemove={(wagonId) =>
-                  void withToast(
-                    () => removeWagon.mutateAsync({ id: composition.id, wagonId }),
-                    "Could not detach wagon",
-                  )
-                }
-                onMaintenance={(wagon) => setMaintenanceTarget(wagon)}
               />
             </Stack>
           </Card>
@@ -461,7 +575,7 @@ export default function TrainBuilderDetailPage() {
 
       <Modal
         opened={Boolean(maintenanceTarget)}
-        onClose={() => setMaintenanceTarget(null)}
+        onClose={closeMaintenance}
         title={<Text fw={600}>Send wagon to maintenance?</Text>}
         radius="lg"
         centered
@@ -474,14 +588,22 @@ export default function TrainBuilderDetailPage() {
             </Text>{" "}
             is detached from train{" "}
             <Text span fw={700} c="dark">
-              {composition.code}
+              {trainRunLabel}
             </Text>{" "}
             and set to MAINTENANCE — it stays out of the available pool until it
-            clears. The detach is stamped with the time and this train number in
-            the wagon's history.
+            clears. The detach is stamped with the time and this train's run
+            numbers in the wagon's history.
           </Text>
+          <Textarea
+            label="Note"
+            placeholder="Optional note (e.g. reason for maintenance)"
+            value={maintenanceNote}
+            onChange={(e) => setMaintenanceNote(e.currentTarget.value)}
+            autosize
+            minRows={2}
+          />
           <Group justify="flex-end">
-            <Button variant="default" onClick={() => setMaintenanceTarget(null)}>
+            <Button variant="default" onClick={closeMaintenance}>
               Keep in consist
             </Button>
             <Button
@@ -493,11 +615,12 @@ export default function TrainBuilderDetailPage() {
                   await maintenanceWagon.mutateAsync({
                     id: composition.id,
                     wagonId: maintenanceTarget!.id,
+                    note: maintenanceNote.trim() || undefined,
                   });
                   toast({
                     title: `Wagon ${maintenanceTarget!.wagonNumber} sent to maintenance`,
                   });
-                  setMaintenanceTarget(null);
+                  closeMaintenance();
                 }, "Could not send wagon to maintenance")
               }
             >
diff --git a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/BatchBoardPage.tsx b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/BatchBoardPage.tsx
index 6520c208e..3d77c1fc0 100644
--- a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/BatchBoardPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/BatchBoardPage.tsx
@@ -19,7 +19,8 @@ import {
   ThemeIcon,
   Tooltip,
 } from "@mantine/core";
-import { DateInput } from "@mantine/dates";
+import { DatePickerInput } from "@mantine/dates";
+import { getDateRangePresets } from "@/components/common/dateRangePresets";
 import { useDebouncedValue } from "@mantine/hooks";
 import {
   AlertTriangle,
@@ -792,24 +793,19 @@ export default function BatchBoardPage() {
                     w={140}
                     styles={{ input: { borderColor: "var(--mantine-color-gray-3)" } }}
                   />
-                  <DateInput
+                  <DatePickerInput
+                    type="range"
                     size="sm"
                     radius="lg"
-                    placeholder="Departs from"
-                    value={departureFrom}
-                    onChange={(v) => setDepartureFrom(v ? new Date(v) : null)}
+                    placeholder="Departure date range"
+                    value={[departureFrom, departureTo]}
+                    onChange={([from, to]) => {
+                      setDepartureFrom(from ? new Date(from) : null);
+                      setDepartureTo(to ? new Date(to) : null);
+                    }}
+                    presets={getDateRangePresets()}
                     clearable
-                    w={140}
-                    styles={{ input: { borderColor: "var(--mantine-color-gray-3)" } }}
-                  />
-                  <DateInput
-                    size="sm"
-                    radius="lg"
-                    placeholder="Departs to"
-                    value={departureTo}
-                    onChange={(v) => setDepartureTo(v ? new Date(v) : null)}
-                    clearable
-                    w={140}
+                    w={230}
                     styles={{ input: { borderColor: "var(--mantine-color-gray-3)" } }}
                   />
                   <Select
diff --git a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleTrackPage.tsx b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleTrackPage.tsx
index 781c241b6..844359bad 100644
--- a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleTrackPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleTrackPage.tsx
@@ -10,6 +10,7 @@ import {
   MapPin,
   Navigation,
   PackageCheck,
+  Pencil,
   Train,
 } from "lucide-react";
 import {
@@ -29,9 +30,10 @@ import {
 } from "@mantine/core";
 
 import { PageContainer } from "@/components/page";
+import { CheckpointTimeModal } from "@/components/trainScheduling/CheckpointTimeModal";
 import { LogPassYardWorkModal } from "@/components/trainScheduling/LogPassYardWorkModal";
 import { RouteCorridorTrack } from "@/components/trainScheduling/RouteCorridorTrack";
-import type { TrackStation } from "@/types/trainScheduling";
+import type { TrackStation, TrainCheckpoint } from "@/types/trainScheduling";
 import {
   RouteCorridor,
   StatusPill,
@@ -156,6 +158,16 @@ export default function TrainScheduleTrackPage() {
   const recordCheckpoint = useMutation(
     api.trainScheduling.recordCheckpoint.mutationOptions(),
   );
+  const updateCheckpoint = useMutation(
+    api.trainScheduling.updateCheckpoint.mutationOptions(),
+  );
+  // Time-entry dialogs: logging a pass at a yard with no work (the yard-work
+  // modal carries its own picker), and correcting an already-logged leg.
+  const [logModal, setLogModal] = useState<{
+    station: TrackStation;
+    isFinal: boolean;
+  } | null>(null);
+  const [editModal, setEditModal] = useState<TrainCheckpoint | null>(null);
   // Yard work drives the log-pass modal: which bookings board/alight per stop.
   const yardWorkQuery = useQuery(
     api.trainScheduling.yardWork.queryOptions({
@@ -241,15 +253,30 @@ export default function TrainScheduleTrackPage() {
 
   const handleLog = (sequenceNo: number) => {
     const station = track.stations.find((s) => s.sequenceNo === sequenceNo);
+    if (!station) return;
     const isFinal = sequenceNo === track.stations[totalStations - 1]?.sequenceNo;
-    if (station && stationHasWork(station)) {
+    if (stationHasWork(station)) {
       setYardModal({ station, isFinal, alreadyLogged: false });
       return;
     }
+    setLogModal({ station, isFinal });
+  };
+
+  const submitLog = (values: { occurredAt: string; note: string }) => {
+    if (!logModal) return;
+    const { station, isFinal } = logModal;
     recordCheckpoint.mutate(
-      { id: scheduleId, payload: { sequenceNo } },
+      {
+        id: scheduleId,
+        payload: {
+          sequenceNo: station.sequenceNo,
+          occurredAt: values.occurredAt,
+          ...(values.note ? { note: values.note } : {}),
+        },
+      },
       {
         onSuccess: () => {
+          setLogModal(null);
           toast({
             title: isFinal
               ? "Train arrived — assets freed, moved to destination yard"
@@ -266,6 +293,32 @@ export default function TrainScheduleTrackPage() {
     );
   };
 
+  const submitEdit = (values: { occurredAt: string; note: string }) => {
+    if (!editModal) return;
+    updateCheckpoint.mutate(
+      {
+        id: scheduleId,
+        sequenceNo: editModal.sequenceNo,
+        payload: { occurredAt: values.occurredAt, note: values.note || null },
+      },
+      {
+        onSuccess: () => {
+          setEditModal(null);
+          toast({ title: "Checkpoint updated" });
+        },
+        onError: (err) =>
+          toast({
+            title: "Could not update checkpoint",
+            description: parseError(err, "Please try again"),
+            variant: "destructive",
+          }),
+      },
+    );
+  };
+  // Legs stay correctable for as long as the journey exists — while rolling
+  // and after arrival.
+  const canEdit = track.status === "DISPATCHED" || track.status === "ARRIVED";
+
   // "Forgot to load" catch: while the train sits at the current station, any
   // boarder there that is still unloaded can be loaded until the next pass.
   const currentStationObj = track.stations.find(
@@ -502,6 +555,7 @@ export default function TrainScheduleTrackPage() {
                 : null
             }
             onLogCheckpoint={handleLog}
+            onEditCheckpoint={canEdit ? setEditModal : undefined}
           />
 
           {/* Cargo the operator forgot: boarders at the CURRENT station stay
@@ -595,24 +649,38 @@ export default function TrainScheduleTrackPage() {
                   )
                 }
                 title={
-                  <Group gap="sm">
-                    <Text fw={700} size="sm">
-                      {cp.label ?? `Station ${cp.sequenceNo}`}
-                    </Text>
-                    <Badge
-                      size="xs"
-                      radius="sm"
-                      variant="light"
-                      color={
-                        cp.kind === "ARRIVED"
-                          ? "teal"
-                          : cp.kind === "DEPARTED"
-                            ? "blue"
-                            : "edr-green"
-                      }
-                    >
-                      {cp.kind}
-                    </Badge>
+                  <Group gap="sm" justify="space-between" wrap="nowrap">
+                    <Group gap="sm">
+                      <Text fw={700} size="sm">
+                        {cp.label ?? `Station ${cp.sequenceNo}`}
+                      </Text>
+                      <Badge
+                        size="xs"
+                        radius="sm"
+                        variant="light"
+                        color={
+                          cp.kind === "ARRIVED"
+                            ? "teal"
+                            : cp.kind === "DEPARTED"
+                              ? "blue"
+                              : "edr-green"
+                        }
+                      >
+                        {cp.kind}
+                      </Badge>
+                    </Group>
+                    {canEdit ? (
+                      <Button
+                        size="compact-xs"
+                        radius="md"
+                        variant="light"
+                        color="gray"
+                        leftSection={<Pencil size={12} />}
+                        onClick={() => setEditModal(cp)}
+                      >
+                        Edit
+                      </Button>
+                    ) : null}
                   </Group>
                 }
               >
@@ -630,6 +698,39 @@ export default function TrainScheduleTrackPage() {
         )}
       </Paper>
 
+      <CheckpointTimeModal
+        opened={logModal !== null}
+        onClose={() => setLogModal(null)}
+        title={
+          logModal?.isFinal
+            ? `Mark arrived at ${logModal.station.label}`
+            : `Log pass at ${logModal?.station.label ?? "station"}`
+        }
+        icon={logModal?.isFinal ? <Flag size={18} /> : <MapPin size={18} />}
+        description={
+          logModal?.isFinal
+            ? "Marks the train arrived: remaining bookings arrive, assets are freed."
+            : undefined
+        }
+        submitLabel={logModal?.isFinal ? "Mark arrived" : "Log pass"}
+        submitColor={logModal?.isFinal ? "teal" : "edr-green"}
+        loading={recordCheckpoint.isPending}
+        onSubmit={submitLog}
+      />
+
+      <CheckpointTimeModal
+        opened={editModal !== null}
+        onClose={() => setEditModal(null)}
+        title={`Edit ${editModal?.label ?? "checkpoint"}`}
+        icon={<Pencil size={18} />}
+        description="Corrects this leg's time and note only — nothing else changes."
+        initialOccurredAt={editModal?.occurredAt}
+        initialNote={editModal?.note}
+        submitLabel="Save"
+        loading={updateCheckpoint.isPending}
+        onSubmit={submitEdit}
+      />
+
       <LogPassYardWorkModal
         opened={yardModal !== null}
         onClose={() => setYardModal(null)}
diff --git a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2DetailPage.tsx b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2DetailPage.tsx
index 9b32d19b6..c2a72146d 100644
--- a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2DetailPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2DetailPage.tsx
@@ -1,4 +1,5 @@
 import {
+  ActionIcon,
   Alert,
   Badge,
   Box,
@@ -7,6 +8,7 @@ import {
   Group,
   List,
   Loader,
+  Menu,
   Modal,
   Paper,
   RingProgress,
@@ -19,18 +21,20 @@ import {
 import { isAxiosError } from "axios";
 import {
   AlertTriangle,
-  ArrowLeft,
   CalendarClock,
   CheckCircle2,
   Clock,
+  Merge,
   Container as ContainerIcon,
   Eye,
   FileText,
   History as HistoryIcon,
   LayoutGrid,
+  MoreHorizontal,
   Navigation,
   Package,
   PackageCheck,
+  Grid3x3,
   Route as RouteIcon,
   Ruler,
   Send,
@@ -38,10 +42,11 @@ import {
   Weight,
   Workflow as WorkflowIcon,
 } from "lucide-react";
+import { DateTimePicker } from "@mantine/dates";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Link, useParams } from "react-router-dom";
 
-import { KpiStrip, PageContainer } from "@/components/page";
+import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
 import { useAuth } from "@/auth/useAuth";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
 import {
@@ -54,6 +59,9 @@ import { ContainerPlacementGrid } from "@/components/trainScheduling/ContainerPl
 import { FleetAvailabilitySummary } from "@/components/trainScheduling/FleetAvailabilitySummary";
 import { IntercityRideAlongPanel } from "@/components/trainScheduling/IntercityRideAlongPanel";
 import { LegCapacityPanel } from "@/components/trainScheduling/LegCapacityPanel";
+import { LegLoadBoardPanel } from "@/components/trainScheduling/LegLoadBoardPanel";
+import { LoadEmptyContainersModal } from "@/components/trainScheduling/LoadEmptyContainersModal";
+import MergeScheduleTrainModal from "@/components/trainScheduling/MergeScheduleTrainModal";
 import ScheduleHistoryPanel from "@/components/trainScheduling/ScheduleHistoryPanel";
 // import { ImportLoadingConfirmationPanel } from "@/components/trainScheduling/ImportLoadingConfirmationPanel";
 import { RescheduleTrainDialog } from "@/components/trainScheduling/RescheduleTrainDialog";
@@ -114,13 +122,22 @@ export default function TrainScheduleV2DetailPage() {
   const [containerPlacements, setContainerPlacements] = useState<ContainerPlacement[]>([]);
   const [maintenanceOpen, setMaintenanceOpen] = useState(false);
   const [windowSettingsOpen, setWindowSettingsOpen] = useState(false);
+  const [mergeModalOpen, setMergeModalOpen] = useState(false);
   const [gatepassSecuredAt, setGatepassSecuredAt] = useState("");
   const [gatepassReference, setGatepassReference] = useState("");
   const [gatepassFileUrl, setGatepassFileUrl] = useState("");
   const [gatepassNotes, setGatepassNotes] = useState("");
   const [dispatchConfirmOpen, setDispatchConfirmOpen] = useState(false);
+  // Actual departure — staff often dispatch on paper first and record it later,
+  // so the time is picked (defaults to now when the dialog opens).
+  const [dispatchAt, setDispatchAt] = useState<Date | null>(null);
+  const openDispatchConfirm = () => {
+    setDispatchAt(new Date());
+    setDispatchConfirmOpen(true);
+  };
   const [switchTarget, setSwitchTarget] = useState<EligibleContainerBooking | null>(null);
   const [visualization3DOpen, setVisualization3DOpen] = useState(false);
+  const [loadEmptiesOpen, setLoadEmptiesOpen] = useState(false);
   const autoPreviewedRef = useRef(false);
 
   const detailQuery = useQuery(
@@ -400,7 +417,6 @@ export default function TrainScheduleV2DetailPage() {
   const canDispatch =
     schedule.status === "SCHEDULED" &&
     hasPermission(authUser, FREIGHT_PERMS.trainScheduling.dispatch);
-
   // Dispatch readiness: bookings with no wagon, and wagon-loaded bookings whose
   // cargo staff never marked loaded. Both are warnings, not blockers — staff can
   // still dispatch after confirming.
@@ -471,7 +487,10 @@ export default function TrainScheduleV2DetailPage() {
   const runDispatch = async () => {
     setDispatchConfirmOpen(false);
     try {
-      await dispatch.mutateAsync(scheduleId);
+      await dispatch.mutateAsync({
+        id: scheduleId,
+        payload: dispatchAt ? { actualDepartureAt: dispatchAt.toISOString() } : {},
+      });
       await openMarshallingDocument({
         title: "Train dispatched",
         successDescription: "Marshalling document generated for the dispatched train.",
@@ -667,6 +686,7 @@ export default function TrainScheduleV2DetailPage() {
             assignedBookings={(schedule.bookings ?? []).map((b) => ({
               id: b.id,
               reference: b.reference ?? b.id.slice(0, 8),
+              customer: b.customer,
               weightTons: b.weightTons,
               isGovernment: b.isGovernment,
               wagonsRequired: b.wagonsRequired,
@@ -866,7 +886,7 @@ export default function TrainScheduleV2DetailPage() {
               radius="md"
               leftSection={<Send size={18} />}
               loading={dispatch.isPending}
-              onClick={() => setDispatchConfirmOpen(true)}
+              onClick={openDispatchConfirm}
             >
               Dispatch train
             </Button>
@@ -883,257 +903,262 @@ export default function TrainScheduleV2DetailPage() {
 
   return (
     <PageContainer>
-      <Button
-        component={Link}
-        to="/dashboard/operations/train-scheduling-v2"
-        variant="subtle"
-        color="gray"
-        size="compact-sm"
-        leftSection={<ArrowLeft size={16} />}
-        w="fit-content"
-      >
-        Back to schedules
-      </Button>
-
-      <Paper
-        radius="xl"
-        p="xl"
-        style={{ position: "relative", overflow: "hidden" }}
-      >
-        <Stack gap="lg" style={{ position: "relative" }}>
-          <Group justify="space-between" align="flex-start" wrap="wrap">
-            <Group gap="md" align="flex-start" wrap="nowrap">
-              <ThemeIcon size={56} radius="lg" variant="light" color="#F2A516">
-                <Train size={28} />
-              </ThemeIcon>
-              <Stack gap={6}>
-                <Group gap="sm" align="center" wrap="wrap">
-                  {schedule.reference ? (
-                    <Badge
-                      variant="filled"
-                      color="edr-green"
-                      radius="sm"
-                      style={{ fontWeight: 700, fontFamily: "monospace" }}
-                    >
-                      {schedule.reference}
-                    </Badge>
-                  ) : null}
-                  <Title order={2} fw={700} style={{ color: "#0f172a" }}>
-                    {schedule.route?.name ?? "Train schedule"}
-                  </Title>
-                  {schedule.train?.trainName ? (
-                    <Text fw={700} style={{ color: "#0f172a" }}>
-                      {schedule.train.trainName}
-                    </Text>
-                  ) : null}
-                  {schedule.train ? (
-                    <Text size="xs" c="dimmed" ff="monospace">
-                      Train {schedule.train.code}
-                    </Text>
-                  ) : null}
-                </Group>
-
-                {/* Voyage (train) number and trade direction — the two things
-                    operations identify a run by, so they read at a glance
-                    rather than as small badges among the rest. */}
-                <Group gap="lg" align="center" wrap="wrap">
-                  {schedule.trainNumber ? (
-                    <Box>
-                      <Text size="xs" c="dimmed" fw={600} tt="uppercase" lh={1.2}>
-                        Voyage No.
-                      </Text>
-                      <Text
-                        ff="monospace"
-                        fw={800}
-                        lh={1.1}
-                        style={{ fontSize: 32, color: "#0f172a" }}
-                      >
-                        {schedule.trainNumber}
-                      </Text>
-                    </Box>
-                  ) : null}
-                  {schedule.direction ? (
-                    <Box>
-                      <Text size="xs" c="dimmed" fw={600} tt="uppercase" lh={1.2}>
-                        Direction
-                      </Text>
-                      <Text
-                        fw={800}
-                        lh={1.1}
-                        tt="uppercase"
-                        style={{
-                          fontSize: 32,
-                          letterSpacing: 0.5,
-                          color:
-                            schedule.direction === "IMPORT"
-                              ? "#2E5B96"
-                              : schedule.direction === "EXPORT"
-                                ? "#0A6F4D"
-                                : "#0f172a",
-                        }}
-                      >
-                        {schedule.direction}
-                      </Text>
-                    </Box>
-                  ) : null}
-                </Group>
-                {(schedule.stops?.length ?? 0) >= 3 ||
-                (schedule.bookings ?? []).some(
-                  (b) => b.tradeDirection === "DOMESTIC",
-                ) ? (
-                  <SegmentOccupancyStrip
-                    stops={schedule.stops ?? []}
-                    bookings={schedule.bookings ?? []}
-                    maxWagons={schedule.maxWagons}
-                    maxGrossTons={schedule.maxGrossWeightTons}
+      <PageHeader
+        title={schedule.route?.name ?? "Train schedule"}
+        backTo="/dashboard/operations/train-scheduling-v2"
+        breadcrumbs={[
+          {
+            label: "Train schedules",
+            href: "/dashboard/operations/train-scheduling-v2",
+          },
+          { label: schedule.reference ?? "Schedule" },
+        ]}
+        subtitle={
+          schedule.train ? (
+            <Text size="sm" c="dimmed">
+              {schedule.train.trainName ?? `Train ${schedule.train.code}`}
+              {schedule.train.trainName ? ` · Train ${schedule.train.code}` : ""}
+            </Text>
+          ) : undefined
+        }
+        meta={
+          <Group gap={6} wrap="wrap">
+            {schedule.reference ? (
+              <Badge
+                variant="filled"
+                color="edr-green"
+                radius="sm"
+                style={{ fontWeight: 700, fontFamily: "monospace" }}
+              >
+                {schedule.reference}
+              </Badge>
+            ) : null}
+            <FreightTypeBadge freightType={schedule.freightType} />
+            <StatusPill status={schedule.status} />
+            {gatepassApplies && gatepassSecured ? (
+              <Badge
+                variant="light"
+                color="edr-green"
+                radius="sm"
+                leftSection={<CheckCircle2 size={12} />}
+              >
+                Gate pass secured
+              </Badge>
+            ) : null}
+            {previewResult ? (
+              <Badge
+                radius="sm"
+                variant="light"
+                color={previewResult.valid ? "edr-green" : "red"}
+                leftSection={
+                  <Box
+                    w={8}
+                    h={8}
+                    style={{
+                      borderRadius: 999,
+                      background: previewResult.valid
+                        ? "var(--mantine-color-edr-green-6)"
+                        : "var(--mantine-color-red-6)",
+                    }}
                   />
-                ) : (
-                  <Box maw={340}>
-                    <RouteCorridor
-                      origin={
-                        schedule.originStation?.label ?? schedule.originStation?.code
-                      }
-                      destination={
-                        schedule.destinationStation?.label ??
-                        schedule.destinationStation?.code
-                      }
-                    />
-                  </Box>
-                )}
-                <Group gap="sm" align="center">
-                  <FreightTypeBadge freightType={schedule.freightType} />
-                  <StatusPill status={schedule.status} />
-                </Group>
-              </Stack>
-            </Group>
-            <Group gap="sm">
-              {(schedule.trainSet?.wagons?.length ?? 0) > 0 ? (
-                <Button
-                  variant="gradient"
-                  gradient={{ from: "#0f172a", to: "#334155" }}
-                  radius="lg"
-                  size="sm"
-                  leftSection={<Eye size={16} />}
-                  onClick={() => setVisualization3DOpen(true)}
-                >
-                  3D Visualization
-                </Button>
-              ) : null}
-              {canPrintMarshalling ? (
-                <Button
-                  variant="light"
-                  color="edr-green"
-                  radius="lg"
-                  size="sm"
-                  leftSection={<FileText size={16} />}
-                  loading={downloadMarshalling.isPending}
-                  onClick={() => void openMarshallingDocument()}
-                >
-                  Marshalling PDF
-                </Button>
-              ) : null}
-              {["DISPATCHED", "ARRIVED"].includes(schedule.status) ? (
-                <Button
-                  variant="light"
-                  color="edr-green"
-                  radius="lg"
-                  size="sm"
-                  leftSection={<FileText size={16} />}
-                  loading={downloadMarshalling.isPending}
-                  onClick={() =>
-                    void openMarshallingDocument({
-                      title: "Intercity marshalling ready",
-                      variant: "INTERCITY",
-                    })
-                  }
-                >
-                  Intercity Marshalling
-                </Button>
-              ) : null}
-              {["DISPATCHED", "ARRIVED"].includes(schedule.status) ? (
-                <Button
-                  component={Link}
-                  to={`/dashboard/operations/train-scheduling-v2/${scheduleId}/track`}
-                  color="edr-green"
-                  radius="lg"
-                  size="sm"
-                  leftSection={<Navigation size={16} />}
-                >
-                  Track train
-                </Button>
-              ) : null}
-              {schedule.windowPhase === "PRE_WINDOW" ? (
-                <Button
-                  variant="light"
-                  color="edr-green"
-                  radius="lg"
-                  size="sm"
-                  leftSection={<Clock size={16} />}
-                  onClick={() => setWindowSettingsOpen(true)}
-                >
-                  Window settings
-                </Button>
-              ) : null}
-              {["DRAFT", "SCHEDULED"].includes(schedule.status) ? (
-                <Button
-                  variant="default"
-                  radius="lg"
-                  size="sm"
-                  onClick={() => setMaintenanceOpen(true)}
-                >
-                  Reschedule train
-                </Button>
-              ) : null}
-              {gatepassApplies ? (
-                gatepassSecured ? (
-                  <Button
-                    variant="light"
-                    color="edr-green"
-                    radius="lg"
-                    size="sm"
-                    leftSection={<CheckCircle2 size={16} />}
-                    disabled
+                }
+              >
+                Preview {previewResult.valid ? "valid" : "has issues"}
+              </Badge>
+            ) : null}
+          </Group>
+        }
+        action={
+          <Group gap="sm" wrap="nowrap">
+            {/* Merging rewrites the consist, so it is offered only while
+                the departure can still be edited. */}
+            {canEditBookings ? (
+              <Button
+                variant="light"
+                size="compact-sm"
+                leftSection={<Merge size={14} />}
+                onClick={() => setMergeModalOpen(true)}
+              >
+                Merge
+              </Button>
+            ) : null}
+            {/* Empties ride an export departure back to Djibouti — offered only
+                while the train can still take load. */}
+            {schedule.direction === "EXPORT" &&
+            ["DRAFT", "SCHEDULED"].includes(schedule.status) ? (
+              <Button
+                variant="light"
+                color="edr-green"
+                size="compact-sm"
+                leftSection={<ContainerIcon size={14} />}
+                onClick={() => setLoadEmptiesOpen(true)}
+              >
+                Load Empty Container
+              </Button>
+            ) : null}
+            {(schedule.trainSet?.wagons?.length ?? 0) > 0 ? (
+              <Button
+                variant="gradient"
+                gradient={{ from: "#0f172a", to: "#334155" }}
+                radius="lg"
+                size="compact-sm"
+                leftSection={<Eye size={16} />}
+                onClick={() => setVisualization3DOpen(true)}
+              >
+                3D Visualization
+              </Button>
+            ) : null}
+            <Menu position="bottom-end" width={240} withinPortal>
+              <Menu.Target>
+                <ActionIcon variant="default" size="lg" radius="md" aria-label="More actions">
+                  <MoreHorizontal size={16} />
+                </ActionIcon>
+              </Menu.Target>
+              <Menu.Dropdown>
+                {canPrintMarshalling ? (
+                  <Menu.Item
+                    leftSection={<FileText size={15} />}
+                    disabled={downloadMarshalling.isPending}
+                    onClick={() => void openMarshallingDocument()}
                   >
-                    Gate pass secured
-                  </Button>
-                ) : (
-                  <Button
-                    color="edr-green"
-                    radius="lg"
-                    size="sm"
-                    leftSection={<FileText size={16} />}
-                    loading={secureGatepass.isPending}
+                    Marshalling PDF
+                  </Menu.Item>
+                ) : null}
+                {["DISPATCHED", "ARRIVED"].includes(schedule.status) ? (
+                  <Menu.Item
+                    leftSection={<FileText size={15} />}
+                    disabled={downloadMarshalling.isPending}
+                    onClick={() =>
+                      void openMarshallingDocument({
+                        title: "Intercity marshalling ready",
+                        variant: "INTERCITY",
+                      })
+                    }
+                  >
+                    Intercity Marshalling
+                  </Menu.Item>
+                ) : null}
+                {["DISPATCHED", "ARRIVED"].includes(schedule.status) ? (
+                  <Menu.Item
+                    component={Link}
+                    to={`/dashboard/operations/train-scheduling-v2/${scheduleId}/track`}
+                    leftSection={<Navigation size={15} />}
+                  >
+                    Track train
+                  </Menu.Item>
+                ) : null}
+                {schedule.windowPhase === "PRE_WINDOW" ? (
+                  <Menu.Item
+                    leftSection={<Clock size={15} />}
+                    onClick={() => setWindowSettingsOpen(true)}
+                  >
+                    Window settings
+                  </Menu.Item>
+                ) : null}
+                {["DRAFT", "SCHEDULED"].includes(schedule.status) ? (
+                  <Menu.Item onClick={() => setMaintenanceOpen(true)}>
+                    Reschedule train
+                  </Menu.Item>
+                ) : null}
+                {gatepassApplies && !gatepassSecured ? (
+                  <Menu.Item
+                    leftSection={<FileText size={15} />}
+                    disabled={secureGatepass.isPending}
                     onClick={() => secureGatepass.mutate()}
                   >
                     Secure gate pass
-                  </Button>
-                )
-              ) : null}
-            </Group>
+                  </Menu.Item>
+                ) : null}
+              </Menu.Dropdown>
+            </Menu>
           </Group>
+        }
+      />
 
-          {previewResult ? (
-            <Badge
-              size="lg"
-              radius="sm"
-              variant="light"
-              color={previewResult.valid ? "edr-green" : "red"}
-              leftSection={
-                <Box
-                  w={8}
-                  h={8}
+      {/* Ops signage: Train No. / Voyage No. / Direction read at a glance from
+          across the room, so these stay large rather than folding into the
+          numeric KpiStrip below. */}
+      <Paper radius="xl" p="lg">
+        <Stack gap="md">
+          <Group gap="lg" align="center" wrap="wrap">
+            {schedule.trainNumber ? (
+              <Box>
+                <Text size="xs" c="dimmed" fw={600} tt="uppercase" lh={1.2}>
+                  Train No.
+                </Text>
+                <Text
+                  ff="monospace"
+                  fw={800}
+                  lh={1.1}
+                  style={{ fontSize: 32, color: "#0f172a" }}
+                >
+                  {schedule.trainNumber}
+                </Text>
+              </Box>
+            ) : null}
+            {schedule.voyageNumber ? (
+              <Box>
+                <Text size="xs" c="dimmed" fw={600} tt="uppercase" lh={1.2}>
+                  Voyage No.
+                </Text>
+                <Text
+                  ff="monospace"
+                  fw={800}
+                  lh={1.1}
+                  style={{ fontSize: 32, color: "#0f172a" }}
+                >
+                  {schedule.voyageNumber}
+                </Text>
+              </Box>
+            ) : null}
+            {schedule.direction ? (
+              <Box>
+                <Text size="xs" c="dimmed" fw={600} tt="uppercase" lh={1.2}>
+                  Direction
+                </Text>
+                <Text
+                  fw={800}
+                  lh={1.1}
+                  tt="uppercase"
                   style={{
-                    borderRadius: 999,
-                    background: previewResult.valid
-                      ? "var(--mantine-color-edr-green-6)"
-                      : "var(--mantine-color-red-6)",
+                    fontSize: 32,
+                    letterSpacing: 0.5,
+                    color:
+                      schedule.direction === "IMPORT"
+                        ? "#2E5B96"
+                        : schedule.direction === "EXPORT"
+                          ? "#0A6F4D"
+                          : "#0f172a",
                   }}
-                />
-              }
-            >
-              Preview {previewResult.valid ? "valid" : "has issues"}
-            </Badge>
-          ) : null}
+                >
+                  {schedule.direction}
+                </Text>
+              </Box>
+            ) : null}
+          </Group>
+          {(schedule.stops?.length ?? 0) >= 3 ||
+          (schedule.bookings ?? []).some(
+            (b) => b.tradeDirection === "DOMESTIC",
+          ) ? (
+            <SegmentOccupancyStrip
+              stops={schedule.stops ?? []}
+              bookings={schedule.bookings ?? []}
+              maxWagons={schedule.maxWagons}
+              maxGrossTons={schedule.maxGrossWeightTons}
+            />
+          ) : (
+            <Box maw={340}>
+              <RouteCorridor
+                origin={
+                  schedule.originStation?.label ?? schedule.originStation?.code
+                }
+                destination={
+                  schedule.destinationStation?.label ??
+                  schedule.destinationStation?.code
+                }
+              />
+            </Box>
+          )}
         </Stack>
       </Paper>
 
@@ -1259,6 +1284,9 @@ export default function TrainScheduleV2DetailPage() {
           <Tabs.Tab value="legs" leftSection={<RouteIcon size={16} />}>
             Leg capacity
           </Tabs.Tab>
+          <Tabs.Tab value="leg-board" leftSection={<Grid3x3 size={16} />}>
+            Leg board
+          </Tabs.Tab>
           <Tabs.Tab value="history" leftSection={<HistoryIcon size={16} />}>
             History
           </Tabs.Tab>
@@ -1347,6 +1375,13 @@ export default function TrainScheduleV2DetailPage() {
           <LegCapacityPanel schedule={schedule} />
         </Tabs.Panel>
 
+        <Tabs.Panel value="leg-board">
+          <LegLoadBoardPanel
+            schedule={schedule}
+            onChanged={() => void detailQuery.refetch()}
+          />
+        </Tabs.Panel>
+
         <Tabs.Panel value="history">
           {scheduleId ? <ScheduleHistoryPanel scheduleId={scheduleId} /> : null}
         </Tabs.Panel>
@@ -1369,6 +1404,21 @@ export default function TrainScheduleV2DetailPage() {
         onSaved={() => void detailQuery.refetch()}
       />
 
+      <LoadEmptyContainersModal
+        opened={loadEmptiesOpen}
+        onClose={() => setLoadEmptiesOpen(false)}
+        schedule={schedule}
+      />
+
+      <MergeScheduleTrainModal
+        scheduleId={scheduleId ?? null}
+        currentTrainId={schedule.trainSet?.trainId ?? null}
+        scheduleReference={schedule.reference ?? null}
+        opened={mergeModalOpen}
+        onClose={() => setMergeModalOpen(false)}
+        onMerged={() => void detailQuery.refetch()}
+      />
+
       <SwitchGovernmentBookingModal
         key={switchTarget?.id ?? "none"}
         opened={Boolean(switchTarget)}
@@ -1417,6 +1467,17 @@ export default function TrainScheduleV2DetailPage() {
             undone.
           </Text>
 
+          <DateTimePicker
+            label="Actual departure"
+            description="When the train left — defaults to now; a past time is fine."
+            value={dispatchAt}
+            onChange={(v) => setDispatchAt(v ? new Date(v) : null)}
+            maxDate={new Date()}
+            valueFormat="DD MMM YYYY HH:mm"
+            clearable={false}
+            radius="md"
+          />
+
           {hasDispatchWarnings ? (
             <Alert
               color="orange"
diff --git a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2ListPage.tsx b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2ListPage.tsx
index c132c2534..7aa6c77b2 100644
--- a/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2ListPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/trainScheduling/TrainScheduleV2ListPage.tsx
@@ -18,6 +18,7 @@ import {
   TextInput,
   ThemeIcon,
 } from "@mantine/core";
+import { DateTimePicker } from "@mantine/dates";
 import { useDebouncedValue } from "@mantine/hooks";
 import { isAxiosError } from "axios";
 import {
@@ -134,12 +135,20 @@ export default function TrainScheduleV2ListPage() {
   // confirmation.
   const [dispatchTarget, setDispatchTarget] =
     useState<TrainScheduleListItem | null>(null);
+  // Actual departure — defaults to now when the dialog opens; past is fine.
+  const [dispatchAt, setDispatchAt] = useState<Date | null>(null);
+  // Cancelling is likewise irreversible — confirmed before the mutation fires.
+  const [cancelTarget, setCancelTarget] =
+    useState<TrainScheduleListItem | null>(null);
   const [editDateSchedule, setEditDateSchedule] =
     useState<TrainScheduleListItem | null>(null);
   const [routeId, setRouteId] = useState("");
   const [scheduleDate, setScheduleDate] = useState("");
   const [trainId, setTrainId] = useState("");
   const [reverseWagonOrder, setReverseWagonOrder] = useState(false);
+  // "" = a normal customer train; an id dedicates the departure to that
+  // shipping line and hides it from every customer-facing view.
+  const [shippingLineCompanyId, setShippingLineCompanyId] = useState("");
   // Booking window for the schedule being created: off = inherit the live global
   // rules (the default), on = the values in `windowForm` are frozen onto it.
   const [configureWindow, setConfigureWindow] = useState(false);
@@ -216,6 +225,15 @@ export default function TrainScheduleV2ListPage() {
       enabled: Boolean(routeId),
     }),
   );
+  // For the create modal's dedication picker. 100 covers every line EDR deals
+  // with; fetched only while the modal is open.
+  const shippingLinesQuery = useQuery(
+    api.shippingLineCompanies.list.queryOptions({
+      input: { page: 1, limit: 100 },
+      enabled: createOpen,
+      staleTime: 5 * 60_000,
+    }),
+  );
   const create = useMutation(api.trainScheduling.createSchedule.mutationOptions());
   const dispatchSchedule = useMutation(
     api.trainScheduling.dispatchSchedule.mutationOptions(),
@@ -347,6 +365,7 @@ export default function TrainScheduleV2ListPage() {
                   {row.original.direction}
                 </Badge>
               ) : null}
+              <ShippingLineBadge schedule={row.original} />
             </Group>
             <Box maw={220}>
               <RouteCorridor
@@ -424,9 +443,7 @@ export default function TrainScheduleV2ListPage() {
         cell: ({ row }) => (
           <Group gap={6} wrap="nowrap">
             <MetricChip value={row.original.bookingsCount} label="bkg" />
-            {/* Wagon SLOTS this schedule's bookings occupy — not the coupled
-                consist. A built train shows 0 here until bookings are allocated. */}
-            <MetricChip value={row.original.wagonCount} label="wgn used" />
+            <WagonChips schedule={row.original} />
             <MetricChip value={`${row.original.totalWeightTons}T`} label="" subtle />
           </Group>
         ),
@@ -494,7 +511,10 @@ export default function TrainScheduleV2ListPage() {
                   {canDispatch && schedule.status === "SCHEDULED" ? (
                     <Menu.Item
                       leftSection={<Play size={15} />}
-                      onClick={() => setDispatchTarget(schedule)}
+                      onClick={() => {
+                        setDispatchAt(new Date());
+                        setDispatchTarget(schedule);
+                      }}
                     >
                       Start (dispatch) train
                     </Menu.Item>
@@ -503,21 +523,7 @@ export default function TrainScheduleV2ListPage() {
                     <Menu.Item
                       color="red"
                       leftSection={<Ban size={15} />}
-                      onClick={async () => {
-                        try {
-                          await cancel.mutateAsync({
-                            id: schedule.id,
-                            freightType: schedule.freightType ?? "CONTAINER",
-                          });
-                          toast({ title: "Schedule cancelled" });
-                        } catch (err) {
-                          toast({
-                            title: "Cancel failed",
-                            description: parseError(err, "Could not cancel"),
-                            variant: "destructive",
-                          });
-                        }
-                      }}
+                      onClick={() => setCancelTarget(schedule)}
                     >
                       Cancel schedule
                     </Menu.Item>
@@ -572,12 +578,14 @@ export default function TrainScheduleV2ListPage() {
           scheduleDate: new Date(scheduleDate).toISOString(),
           trainId,
           reverseWagonOrder,
+          ...(shippingLineCompanyId ? { shippingLineCompanyId } : {}),
           ...(windowRule ? { windowRule } : {}),
         },
       });
       toast({ title: "Train schedule created" });
       showScheduleWarnings(created.warnings);
       setReverseWagonOrder(false);
+      setShippingLineCompanyId("");
       setConfigureWindow(false);
       setWindowForm(null);
       setCreateOpen(false);
@@ -741,7 +749,11 @@ export default function TrainScheduleV2ListPage() {
               onRowClick={(schedule) =>
                 navigate(`/dashboard/operations/train-scheduling-v2/${schedule.id}`)
               }
-              rowStyle={(schedule) => directionRowStyle(schedule.direction)}
+              rowStyle={(schedule) =>
+                schedule.shippingLineCompanyId
+                  ? SHIPPING_LINE_ROW_STYLE
+                  : directionRowStyle(schedule.direction)
+              }
               error={
                 schedulesQuery.isError
                   ? {
@@ -870,6 +882,19 @@ export default function TrainScheduleV2ListPage() {
                 : "Select a route first"
             }
           />
+          <Select
+            label="Shipping line (optional)"
+            description="Dedicate this departure to one shipping line. The train is then hidden from customers and shown only in that line's portal."
+            placeholder="None — normal customer train"
+            clearable
+            searchable
+            data={(shippingLinesQuery.data?.items ?? [])
+              .filter((line) => line.status === "active")
+              .map((line) => ({ value: line.id, label: line.name }))}
+            value={shippingLineCompanyId || null}
+            onChange={(v) => setShippingLineCompanyId(v ?? "")}
+            comboboxProps={{ withinPortal: true }}
+          />
           <Checkbox
             label="Reverse wagon order"
             description="Place wagons on the train in reverse — the physically-last wagon becomes position 1. Composition and allocations are unchanged; only the order flips. Applies every time this schedule's wagon plan is built."
@@ -940,6 +965,16 @@ export default function TrainScheduleV2ListPage() {
             wagons or cargo not yet marked loaded — those warnings are shown
             there, not here.
           </Text>
+          <DateTimePicker
+            label="Actual departure"
+            description="When the train left — defaults to now; a past time is fine."
+            value={dispatchAt}
+            onChange={(v) => setDispatchAt(v ? new Date(v) : null)}
+            maxDate={new Date()}
+            valueFormat="DD MMM YYYY HH:mm"
+            clearable={false}
+            radius="md"
+          />
           <Group justify="flex-end" gap="sm">
             <Button variant="default" onClick={() => setDispatchTarget(null)}>
               Cancel
@@ -951,7 +986,12 @@ export default function TrainScheduleV2ListPage() {
               onClick={async () => {
                 if (!dispatchTarget) return;
                 try {
-                  await dispatchSchedule.mutateAsync(dispatchTarget.id);
+                  await dispatchSchedule.mutateAsync({
+                    id: dispatchTarget.id,
+                    payload: dispatchAt
+                      ? { actualDepartureAt: dispatchAt.toISOString() }
+                      : {},
+                  });
                   toast({ title: "Train dispatched" });
                   setDispatchTarget(null);
                   void schedulesQuery.refetch();
@@ -969,10 +1009,117 @@ export default function TrainScheduleV2ListPage() {
           </Group>
         </Stack>
       </Modal>
+
+      {/* Cancelling a schedule is destructive and cannot be undone, so it is
+          confirmed here rather than firing straight from the row menu. */}
+      <Modal
+        opened={cancelTarget != null}
+        onClose={() => setCancelTarget(null)}
+        title="Cancel this schedule?"
+        centered
+        radius="md"
+      >
+        <Stack gap="md">
+          <Text size="sm" c="dimmed">
+            <Text span fw={600} c="dark">
+              {cancelTarget?.trainNumber ?? cancelTarget?.reference ?? "This train"}
+            </Text>{" "}
+            will be cancelled and removed from the active schedule board. This
+            cannot be undone.
+          </Text>
+          {cancelTarget?.bookingsCount ? (
+            <Text size="sm" c="red.7" fw={500}>
+              {cancelTarget.bookingsCount} booking
+              {cancelTarget.bookingsCount === 1 ? "" : "s"} on this train will
+              need to be moved to another schedule.
+            </Text>
+          ) : null}
+          <Group justify="flex-end" gap="sm">
+            <Button variant="default" onClick={() => setCancelTarget(null)}>
+              Keep schedule
+            </Button>
+            <Button
+              color="red"
+              leftSection={<Ban size={16} />}
+              loading={cancel.isPending}
+              onClick={async () => {
+                if (!cancelTarget) return;
+                try {
+                  await cancel.mutateAsync({
+                    id: cancelTarget.id,
+                    freightType: cancelTarget.freightType ?? "CONTAINER",
+                  });
+                  toast({ title: "Schedule cancelled" });
+                  setCancelTarget(null);
+                  void schedulesQuery.refetch();
+                } catch (err) {
+                  toast({
+                    title: "Cancel failed",
+                    description: parseError(err, "Could not cancel"),
+                    variant: "destructive",
+                  });
+                }
+              }}
+            >
+              Cancel schedule
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
     </PageContainer>
   );
 }
 
+/**
+ * The row's wagon chips, matching the detail page's wagon plan: used is slots
+ * carrying a booking allocation, the denominator is the schedule's capacity
+ * (API-computed: the larger of coupled consist and planned `maxWagons`, since
+ * wagons are coupled on demand), and remaining excludes wagons reserved by
+ * bookings that have not paid yet — that space is claimed, so it is not
+ * bookable.
+ */
+/** Green tint for departures dedicated to a shipping line (overrides direction tint). */
+const SHIPPING_LINE_ROW_STYLE = {
+  backgroundColor: "var(--mantine-color-edr-green-0)",
+} as const;
+
+function ShippingLineBadge({ schedule }: { schedule: TrainScheduleListItem }) {
+  if (!schedule.shippingLineCompanyId) return null;
+  return (
+    <Badge size="xs" variant="light" color="edr-green">
+      {schedule.shippingLineCompanyName ?? "Shipping line"}
+    </Badge>
+  );
+}
+
+function WagonChips({ schedule }: { schedule: TrainScheduleListItem }) {
+  // Pre-deploy API rows carry only wagonCount; fall back so the chip still
+  // renders rather than reading 0 used on every train.
+  const total = schedule.wagonsTotal ?? schedule.wagonCount;
+  const used = schedule.wagonsUsed;
+  const reserved = schedule.wagonsReserved ?? 0;
+  const remaining = schedule.wagonsRemaining;
+
+  if (used == null) {
+    return <MetricChip value={total} label="wgn" subtle />;
+  }
+
+  return (
+    <>
+      <MetricChip
+        value={`${used}/${total}`}
+        label={schedule.wagonCount === 0 ? "wgn planned" : "wgn used"}
+      />
+      {reserved > used ? (
+        <MetricChip value={reserved} label="reserved" subtle />
+      ) : null}
+      {remaining != null ? (
+        <MetricChip value={remaining} label="bookable" subtle />
+      ) : null}
+    </>
+  );
+}
+
 function MetricChip({
   value,
   label,
@@ -1026,6 +1173,7 @@ function ScheduleCard({
       withBorder
       onClick={onOpen}
       className="cursor-pointer overflow-hidden transition-[transform,border-color] duration-150 hover:-translate-y-0.5 hover:border-edr-primary!"
+      style={schedule.shippingLineCompanyId ? SHIPPING_LINE_ROW_STYLE : undefined}
     >
       <Stack gap="sm" p="md">
         <Group justify="space-between" align="flex-start" wrap="nowrap">
@@ -1075,10 +1223,11 @@ function ScheduleCard({
                 {schedule.direction}
               </Badge>
             ) : null}
+            <ShippingLineBadge schedule={schedule} />
           </Group>
           <Group gap={6} wrap="nowrap">
             <MetricChip value={schedule.bookingsCount} label="bkg" />
-            <MetricChip value={schedule.wagonCount} label="wgn used" />
+            <WagonChips schedule={schedule} />
             <MetricChip value={`${schedule.totalWeightTons}T`} label="" subtle />
           </Group>
         </Group>
diff --git a/apps/edr-freight-web/backoffice/src/pages/wagons/TransferFulfillModal.tsx b/apps/edr-freight-web/backoffice/src/pages/wagons/TransferFulfillModal.tsx
index 6f5a0c129..4a4a3d870 100644
--- a/apps/edr-freight-web/backoffice/src/pages/wagons/TransferFulfillModal.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/wagons/TransferFulfillModal.tsx
@@ -2,19 +2,18 @@ import { Freight } from "@edr/types";
 import {
   Alert,
   Button,
-  Checkbox,
   Group,
   Loader,
   Modal,
-  ScrollArea,
   Stack,
   Text,
 } from "@mantine/core";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { AlertTriangle, ArrowRight, PackageCheck } from "lucide-react";
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import toast from "react-hot-toast";
 
+import WagonPicker from "@/components/wagons/WagonPicker";
 import { api } from "@/services/api";
 import type { WagonTransferRequest } from "@/services/wagon.service";
 
@@ -59,23 +58,21 @@ export function TransferFulfillModal({
 
   const fulfill = useMutation(api.wagonTransferRequests.fulfill.mutationOptions());
 
-  const canTake = useMemo(
-    () => Math.min(outstanding, wagons.length),
-    [outstanding, wagons.length],
-  );
+  /** The requester's picks that are still in this yard and still available. */
+  const preferredHere = useMemo(() => {
+    const asked = new Set(request?.preferredWagonIds ?? []);
+    return asked.size ? wagons.filter((w) => asked.has(w.id)) : [];
+  }, [request, wagons]);
 
-  const toggle = (id: string) =>
-    setPicked((prev) => {
-      const next = new Set(prev);
-      if (next.has(id)) next.delete(id);
-      // Never let staff pick more than is still owed — the API rejects it too.
-      else if (next.size >= outstanding) return prev;
-      else next.add(id);
-      return next;
-    });
+  const missingPreferred =
+    (request?.preferredWagonIds?.length ?? 0) - preferredHere.length;
 
-  const takeAllAvailable = () =>
-    setPicked(new Set(wagons.slice(0, canTake).map((w) => w.id)));
+  // Open on what the requester asked for: OCC confirms rather than re-picks.
+  // Re-runs when the wagon list arrives, and is capped at what is still owed.
+  useEffect(() => {
+    if (!request) return;
+    setPicked(new Set(preferredHere.slice(0, outstanding).map((w) => w.id)));
+  }, [request, preferredHere, outstanding]);
 
   const close = () => {
     setPicked(new Set());
@@ -120,27 +117,16 @@ export function TransferFulfillModal({
     >
       {!request ? null : (
         <Stack gap="sm">
-          <Group justify="space-between" wrap="wrap">
-            <Text size="sm">
-              <Text span fw={700}>
-                {outstanding}
-              </Text>{" "}
-              wagon(s) still owed ·{" "}
-              <Text span fw={700}>
-                {wagons.length}
-              </Text>{" "}
-              available in {yardLabel(request.fromYard)}
-            </Text>
-            <Button
-              variant="light"
-              size="xs"
-              radius="md"
-              disabled={canTake === 0}
-              onClick={takeAllAvailable}
-            >
-              Select {canTake}
-            </Button>
-          </Group>
+          <Text size="sm">
+            <Text span fw={700}>
+              {outstanding}
+            </Text>{" "}
+            wagon(s) still owed ·{" "}
+            <Text span fw={700}>
+              {wagons.length}
+            </Text>{" "}
+            available in {yardLabel(request.fromYard)}
+          </Text>
 
           {wagons.length < outstanding ? (
             <Alert color="yellow" radius="md" icon={<AlertTriangle size={15} />}>
@@ -150,27 +136,39 @@ export function TransferFulfillModal({
             </Alert>
           ) : null}
 
+          {preferredHere.length > 0 ? (
+            <Alert color="teal" radius="md" icon={<PackageCheck size={15} />}>
+              The requester named{" "}
+              <Text span fw={700}>
+                {preferredHere.length}
+              </Text>{" "}
+              specific wagon(s) — pre-selected below. You can change the
+              selection freely; the request is a count, not a reservation.
+            </Alert>
+          ) : null}
+
+          {missingPreferred > 0 ? (
+            <Alert color="orange" radius="md" icon={<AlertTriangle size={15} />}>
+              {missingPreferred} of the wagon(s) the requester named{" "}
+              {missingPreferred === 1 ? "is" : "are"} no longer available in this
+              yard. Pick replacements below.
+            </Alert>
+          ) : null}
+
           {isLoading ? (
             <Group justify="center" py="lg">
               <Loader size="sm" />
             </Group>
-          ) : wagons.length === 0 ? (
-            <Text c="dimmed" size="sm" py="md">
-              No available wagons of this type in the source yard right now.
-            </Text>
           ) : (
-            <ScrollArea.Autosize mah={320}>
-              <Stack gap={4}>
-                {wagons.map((w) => (
-                  <Checkbox
-                    key={w.id}
-                    checked={picked.has(w.id)}
-                    onChange={() => toggle(w.id)}
-                    label={w.wagonNumber}
-                  />
-                ))}
-              </Stack>
-            </ScrollArea.Autosize>
+            <WagonPicker
+              wagons={wagons}
+              selected={picked}
+              onChange={setPicked}
+              // Never let staff pick more than is still owed — the API rejects it too.
+              max={outstanding}
+              emptyMessage="No available wagons of this type in the source yard right now."
+              maxHeight={300}
+            />
           )}
 
           <Group justify="flex-end" gap="sm">
diff --git a/apps/edr-freight-web/backoffice/src/pages/wagons/TransferHistoryPanel.tsx b/apps/edr-freight-web/backoffice/src/pages/wagons/TransferHistoryPanel.tsx
index dff9cdaa3..807745b73 100644
--- a/apps/edr-freight-web/backoffice/src/pages/wagons/TransferHistoryPanel.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/wagons/TransferHistoryPanel.tsx
@@ -35,6 +35,7 @@ import {
   STATUS_META,
   TransferProgress,
   TransferStatusBadge,
+  stripHtmlToText,
   wagonTypeLabel,
   yardLabel,
 } from "./wagon-transfer-ui";
@@ -119,9 +120,9 @@ function RequestItem({ request }: { request: WagonTransferRequest }) {
               {wagonTypeLabel(request.wagonType)}
             </Badge>
           </Group>
-          {request.reason ? (
+          {stripHtmlToText(request.reason) ? (
             <Text size="xs" c="dimmed" lineClamp={1}>
-              {request.reason}
+              {stripHtmlToText(request.reason)}
             </Text>
           ) : null}
         </Stack>
diff --git a/apps/edr-freight-web/backoffice/src/pages/wagons/TransferRequestModals.tsx b/apps/edr-freight-web/backoffice/src/pages/wagons/TransferRequestModals.tsx
index df90a7683..f23ea6ed9 100644
--- a/apps/edr-freight-web/backoffice/src/pages/wagons/TransferRequestModals.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/wagons/TransferRequestModals.tsx
@@ -1,3 +1,4 @@
+import { Freight } from "@edr/types";
 import {
   Alert,
   Button,
@@ -14,6 +15,7 @@ import { AlertTriangle, Send, XCircle } from "lucide-react";
 import { useEffect, useState } from "react";
 import toast from "react-hot-toast";
 
+import WagonPicker from "@/components/wagons/WagonPicker";
 import { api } from "@/services/api";
 import type { WagonTransferRequest } from "@/services/wagon.service";
 
@@ -41,6 +43,33 @@ function useTransferOptions(enabled: boolean) {
   };
 }
 
+/**
+ * Wagons the source yard can hand over right now — AVAILABLE and not coupled to
+ * a built train. Mirrors `countAvailable` on the API, which rejects any request
+ * asking for more than this, so the field must not let one be filed. Returns
+ * the wagons themselves so the form can also offer them for picking; `count` is
+ * null until both a yard and a type are chosen.
+ */
+function useAvailableWagons(
+  enabled: boolean,
+  fromYardId: string | null,
+  wagonTypeId: string | null,
+) {
+  const { data: wagons = [] } = useQuery({
+    ...api.wagons.list.queryOptions({ input: {} }),
+    enabled: enabled && Boolean(fromYardId && wagonTypeId),
+  });
+  if (!fromYardId || !wagonTypeId) return { wagons: [], count: null };
+  const inYard = wagons.filter(
+    (w) =>
+      w.currentYardId === fromYardId &&
+      w.wagonTypeId === wagonTypeId &&
+      w.status === Freight.WagonStatus.Available &&
+      !w.trainId,
+  );
+  return { wagons: inYard, count: inYard.length };
+}
+
 export interface TransferRequestFormModalProps {
   opened: boolean;
   onClose: () => void;
@@ -54,9 +83,9 @@ export interface TransferRequestFormModalProps {
 }
 
 /**
- * File a wagon-transfer request. The count is deliberately NOT capped by what
- * the source yard holds today — OCC fulfils in instalments, so asking for 50
- * where 20 sit is a normal request.
+ * File a wagon-transfer request. The count is capped by what the source yard
+ * has available right now; the API enforces the same ceiling, so a larger ask
+ * is rejected rather than queued.
  */
 export function TransferRequestFormModal({
   opened,
@@ -70,6 +99,8 @@ export function TransferRequestFormModal({
   const [wagonTypeId, setWagonTypeId] = useState<string | null>(null);
   const [quantity, setQuantity] = useState<number | string>(1);
   const [reason, setReason] = useState("");
+  /** Specific wagons the requester named — optional; empty means "any N". */
+  const [picked, setPicked] = useState<Set<string>>(new Set());
 
   // Re-seed on every open so a carry-over never leaks into the next request.
   useEffect(() => {
@@ -79,14 +110,53 @@ export function TransferRequestFormModal({
     setWagonTypeId(prefillFrom?.wagonTypeId ?? null);
     setQuantity(prefillFrom ? outstandingOn(prefillFrom) : 1);
     setReason(prefillFrom?.reason ?? "");
+    setPicked(new Set());
   }, [opened, prefillFrom]);
 
   const create = useMutation(api.wagonTransferRequests.create.mutationOptions());
 
+  const { wagons: availableWagons, count: available } = useAvailableWagons(
+    opened,
+    fromYardId,
+    wagonTypeId,
+  );
+
+  // The picks belong to one yard+type pair; changing either invalidates them.
+  useEffect(() => {
+    setPicked(new Set());
+  }, [fromYardId, wagonTypeId]);
+
+  // Naming wagons IS the ask, so the count follows the picks.
+  const handlePick = (next: Set<string>) => {
+    setPicked(next);
+    if (next.size > 0) setQuantity(next.size);
+  };
+
+  // A prefilled outstanding count (or a count typed before the yard was picked)
+  // can exceed what the chosen source yard actually has — pull it back down so
+  // the field never holds a value the API would reject.
+  useEffect(() => {
+    if (available == null) return;
+    setQuantity((q) => (Number(q) > available ? available : q));
+  }, [available]);
+
+  // Asking for fewer than were picked would send a selection the API rejects
+  // (picks may not exceed quantity) — drop the extras, keeping pick order.
+  const handleQuantityChange = (value: number | string) => {
+    setQuantity(value);
+    const n = Number(value);
+    if (Number.isFinite(n) && picked.size > n) {
+      setPicked(new Set([...picked].slice(0, Math.max(0, n))));
+    }
+  };
+
   const sameYard = Boolean(fromYardId && fromYardId === toYardId);
+  const overAvailable = available != null && Number(quantity) > available;
   const valid =
     Boolean(fromYardId && toYardId && wagonTypeId && reason.trim()) &&
     !sameYard &&
+    !overAvailable &&
+    available !== 0 &&
     Number(quantity) >= 1;
 
   const submit = async () => {
@@ -98,6 +168,7 @@ export function TransferRequestFormModal({
         wagonTypeId: wagonTypeId!,
         quantity: Number(quantity),
         reason: reason.trim(),
+        ...(picked.size > 0 ? { preferredWagonIds: [...picked] } : {}),
       });
       toast.success("Transfer request filed");
       onClose();
@@ -155,12 +226,55 @@ export function TransferRequestFormModal({
         />
         <NumberInput
           label="How many"
-          description="Can exceed what the yard holds today — OCC delivers in instalments"
+          description={
+            available == null
+              ? "Pick a source yard and wagon type to see what is available"
+              : `${available} wagon(s) available in the source yard`
+          }
           min={1}
+          max={available ?? undefined}
+          clampBehavior={available == null ? "none" : "strict"}
+          allowNegative={false}
           value={quantity}
-          onChange={setQuantity}
+          onChange={handleQuantityChange}
+          disabled={available === 0}
+          error={
+            available === 0
+              ? "This yard has no wagons of that type available"
+              : overAvailable
+                ? `Only ${available} available`
+                : undefined
+          }
           required
         />
+
+        {/* Optional: name the exact wagons. Leaving this empty files a plain
+            count request and OCC picks whatever is free. */}
+        {availableWagons.length > 0 ? (
+          <div>
+            <Group justify="space-between" mb={4} wrap="wrap" gap={4}>
+              <Text size="sm" fw={500}>
+                Which wagons{" "}
+                <Text span size="xs" c="dimmed" fw={400}>
+                  (optional)
+                </Text>
+              </Text>
+              <Text size="xs" c="dimmed">
+                {picked.size > 0
+                  ? `${picked.size} named — OCC will prioritise these`
+                  : "Leave empty and OCC picks any available"}
+              </Text>
+            </Group>
+            <WagonPicker
+              wagons={availableWagons}
+              selected={picked}
+              onChange={handlePick}
+              max={available ?? undefined}
+              maxHeight={200}
+            />
+          </div>
+        ) : null}
+
         <Textarea
           label="Reason"
           placeholder="Why the wagons are needed"
diff --git a/apps/edr-freight-web/backoffice/src/pages/wagons/WagonTransfersPage.tsx b/apps/edr-freight-web/backoffice/src/pages/wagons/WagonTransfersPage.tsx
index 58eb5a3cd..323323da3 100644
--- a/apps/edr-freight-web/backoffice/src/pages/wagons/WagonTransfersPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/wagons/WagonTransfersPage.tsx
@@ -10,6 +10,7 @@ import {
   Tabs,
   Text,
   TextInput,
+  UnstyledButton,
 } from "@mantine/core";
 import { useDebouncedValue } from "@mantine/hooks";
 import { useQuery } from "@tanstack/react-query";
@@ -18,7 +19,6 @@ import {
   History,
   Inbox,
   PackageCheck,
-  Plus,
   RefreshCw,
   Search,
   Send,
@@ -32,6 +32,7 @@ import { useMutation } from "@tanstack/react-query";
 import { useAuth } from "@/auth/useAuth";
 import { KpiStrip, PageContainer, PageHeader } from "@/components/page";
 import { FREIGHT_PERMS, hasPermission } from "@/lib/permissions";
+import { sanitizeHtml } from "@/shared/lib/sanitize";
 import { api } from "@/services/api";
 import type {
   TransferRequestListFilter,
@@ -51,11 +52,13 @@ import {
   TransferRequestFormModal,
 } from "./TransferRequestModals";
 import {
+  PreferredWagonChips,
   TransferProgress,
   TransferStatusBadge,
   fmtDateTime,
   isOpenRequest,
   outstandingOn,
+  stripHtmlToText,
   wagonTypeLabel,
   yardLabel,
 } from "./wagon-transfer-ui";
@@ -109,6 +112,9 @@ export default function WagonTransfersPage() {
   const [closingShort, setClosingShort] = useState<WagonTransferRequest | null>(
     null,
   );
+  const [viewingReason, setViewingReason] = useState<WagonTransferRequest | null>(
+    null,
+  );
 
   const filter: TransferRequestListFilter = useMemo(
     () => ({
@@ -190,6 +196,11 @@ export default function WagonTransfersPage() {
         <Text size="sm">{wagonTypeLabel(row.original.wagonType)}</Text>
       ),
     },
+    {
+      id: "wagons",
+      header: () => <span>Wagons requested</span>,
+      cell: ({ row }) => <PreferredWagonChips request={row.original} />,
+    },
     {
       id: "progress",
       header: () => <span>Delivered</span>,
@@ -198,11 +209,29 @@ export default function WagonTransfersPage() {
     {
       id: "reason",
       header: () => <span>Reason</span>,
-      cell: ({ row }) => (
-        <Text size="sm" c="dimmed" lineClamp={2} maw={260}>
-          {row.original.reason || "—"}
-        </Text>
-      ),
+      cell: ({ row }) => {
+        const text = stripHtmlToText(row.original.reason);
+        return text ? (
+          <UnstyledButton
+            onClick={() => setViewingReason(row.original)}
+            data-stop-row-click
+          >
+            <Text
+              size="sm"
+              c="dimmed"
+              lineClamp={2}
+              maw={260}
+              style={{ textAlign: "left", textDecoration: "underline dotted" }}
+            >
+              {text}
+            </Text>
+          </UnstyledButton>
+        ) : (
+          <Text size="sm" c="dimmed">
+            —
+          </Text>
+        );
+      },
     },
     {
       id: "filed",
@@ -311,19 +340,6 @@ export default function WagonTransfersPage() {
               >
                 Refresh
               </Button>
-              {canRequest ? (
-                <Button
-                  color="edr-green"
-                  radius="md"
-                  leftSection={<Plus size={15} />}
-                  onClick={() => {
-                    setCarryOver(null);
-                    setFormOpen(true);
-                  }}
-                >
-                  New request
-                </Button>
-              ) : null}
             </Group>
           }
         />
@@ -536,6 +552,44 @@ export default function WagonTransfersPage() {
           </Stack>
         )}
       </Modal>
+      <Modal
+        opened={Boolean(viewingReason)}
+        onClose={() => setViewingReason(null)}
+        radius="md"
+        title="Reason"
+      >
+        {!viewingReason ? null : (
+          <Stack gap="sm">
+            <Text size="sm" fw={600}>
+              {yardLabel(viewingReason.fromYard)}{" "}
+              <ArrowRight
+                size={13}
+                className="inline-block opacity-60"
+              />{" "}
+              {yardLabel(viewingReason.toYard)} ·{" "}
+              {wagonTypeLabel(viewingReason.wagonType)} ·{" "}
+              {viewingReason.quantity} wagon(s)
+            </Text>
+            {viewingReason.preferredWagons?.length ? (
+              <div>
+                <Text size="xs" c="dimmed" mb={4}>
+                  Wagons requested
+                </Text>
+                <PreferredWagonChips
+                  request={viewingReason}
+                  limit={viewingReason.preferredWagons.length}
+                />
+              </div>
+            ) : null}
+            <Box
+              className="text-sm [&_p]:my-2 [&_ol]:list-decimal [&_ul]:list-disc [&_ol]:pl-5 [&_ul]:pl-5"
+              dangerouslySetInnerHTML={{
+                __html: sanitizeHtml(viewingReason.reason ?? ""),
+              }}
+            />
+          </Stack>
+        )}
+      </Modal>
     </PageContainer>
   );
 }
diff --git a/apps/edr-freight-web/backoffice/src/pages/wagons/wagon-transfer-ui.tsx b/apps/edr-freight-web/backoffice/src/pages/wagons/wagon-transfer-ui.tsx
index e60480590..130f37233 100644
--- a/apps/edr-freight-web/backoffice/src/pages/wagons/wagon-transfer-ui.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/wagons/wagon-transfer-ui.tsx
@@ -3,6 +3,75 @@ import { Badge, Box, Group, Progress, Text, Tooltip } from "@mantine/core";
 
 import type { WagonTransferRequest } from "@/services/wagon.service";
 
+/** How many wagon chips fit a table cell before the rest are rolled up. */
+const CHIP_LIMIT = 4;
+
+/**
+ * The wagons the requester actually named, when they picked any. Rendered as
+ * chips so a glance down the column separates "send me these 3" from a plain
+ * count request — the two are fulfilled differently.
+ */
+export function PreferredWagonChips({
+  request,
+  limit = CHIP_LIMIT,
+}: {
+  request: WagonTransferRequest;
+  limit?: number;
+}) {
+  const wagons = request.preferredWagons ?? [];
+  if (wagons.length === 0) {
+    return (
+      <Tooltip label="No specific wagons named — OCC picks any available" withArrow>
+        <Text size="xs" c="dimmed">
+          Any {request.quantity}
+        </Text>
+      </Tooltip>
+    );
+  }
+
+  const shown = wagons.slice(0, limit);
+  const rest = wagons.length - shown.length;
+
+  return (
+    <Tooltip
+      withArrow
+      multiline
+      maw={280}
+      label={`Requested: ${wagons.map((w) => w.wagonNumber).join(", ")}`}
+    >
+      <Group gap={4} wrap="wrap" maw={220}>
+        {shown.map((w) => (
+          <Badge
+            key={w.id}
+            size="sm"
+            variant="light"
+            color="edr-green"
+            radius="sm"
+            style={{ fontVariantNumeric: "tabular-nums" }}
+          >
+            {w.wagonNumber}
+          </Badge>
+        ))}
+        {rest > 0 ? (
+          <Badge size="sm" variant="outline" color="gray" radius="sm">
+            +{rest}
+          </Badge>
+        ) : null}
+      </Group>
+    </Tooltip>
+  );
+}
+
+/** Reason/note fields come from a rich-text editor and store HTML — this
+ * gives a plain-text preview for list/table contexts (full formatting is
+ * shown via `sanitizeHtml` + `dangerouslySetInnerHTML` where there's room). */
+export const stripHtmlToText = (html?: string | null): string =>
+  (html ?? "")
+    .replace(/<[^>]*>/g, " ")
+    .replace(/&nbsp;/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+
 export const yardLabel = (y?: { label?: string; code?: string } | null) =>
   y?.label || y?.code || "—";
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/ContainerReturnsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/ContainerReturnsPage.tsx
index 6f329c8d7..685e7d2a3 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/ContainerReturnsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/ContainerReturnsPage.tsx
@@ -36,7 +36,10 @@ import { importOperationsService } from "@/services/importOperations.service";
 import type {
   EmptyContainerReturn,
   EmptyContainerReturnStatus,
+  EmptyContainerSize,
 } from "@/types/importOperations";
+import type { TrainScheduleListItem } from "@/types/trainScheduling";
+import { formatDateTime } from "@/lib/format";
 
 type ReturnType = "all" | "edr" | "customer";
 
@@ -99,6 +102,7 @@ export default function ContainerReturnsPage() {
   const [standaloneModalOpen, setStandaloneModalOpen] = useState(false);
   const [activeKey, setActiveKey] = useState<string | null>(null);
   const [historyRow, setHistoryRow] = useState<any | null>(null);
+  const [allocateRow, setAllocateRow] = useState<EmptyContainerReturn | null>(null);
 
   const { data: unloadedQueue = [], isLoading: queueLoading } = useQuery({
     queryKey: ["import-unloaded-queue"],
@@ -264,6 +268,7 @@ export default function ContainerReturnsPage() {
         returnType: "EDR" | "CUSTOMER";
         containers: Array<{
           containerNumber: string;
+          containerSize?: EmptyContainerSize;
           returnDate: string;
           warehouse: string;
           condition?: string;
@@ -276,6 +281,7 @@ export default function ContainerReturnsPage() {
         for (const container of truck.containers) {
           const result = await importOperationsService.createEmptyReturn({
             containerNumber: container.containerNumber,
+            containerSize: container.containerSize,
             returnDate: new Date(container.returnDate).toISOString(),
             bookingId: truck.bookingId,
             customerId: truck.customerId ?? undefined,
@@ -305,15 +311,25 @@ export default function ContainerReturnsPage() {
   });
 
   const advanceStatusMutation = useMutation({
-    mutationFn: (id: string) => {
+    mutationFn: ({
+      id,
+      wagonAllocationReference,
+    }: {
+      id: string;
+      wagonAllocationReference?: string;
+    }) => {
       const current = returnedContainers.find((r: any) => r.id === id);
       const nextIndex = RETURN_STATUS_ORDER.indexOf(current?.status ?? "RETURNED") + 1;
       const status = RETURN_STATUS_ORDER[nextIndex] ?? "COMPLETED";
-      return importOperationsService.updateEmptyReturnStatus(id, { status });
+      return importOperationsService.updateEmptyReturnStatus(id, {
+        status,
+        wagonAllocationReference,
+      });
     },
     onSuccess: () => {
       toast({ title: "Return status updated" });
       qc.invalidateQueries({ queryKey: ["empty-container-returns"] });
+      setAllocateRow(null);
     },
     onError: (error: any) => {
       toast({
@@ -380,9 +396,16 @@ export default function ContainerReturnsPage() {
       id: "status",
       header: "Status",
       cell: ({ row }) => (
-        <Badge size="sm">
-          {RETURN_STATUS_LABEL[row.original.status] ?? row.original.status}
-        </Badge>
+        <Stack gap={2}>
+          <Badge size="sm">
+            {RETURN_STATUS_LABEL[row.original.status] ?? row.original.status}
+          </Badge>
+          {row.original.wagonAllocationReference && (
+            <Text size="xs" c="dimmed">
+              Train {row.original.wagonAllocationReference}
+            </Text>
+          )}
+        </Stack>
       ),
     },
     {
@@ -405,8 +428,15 @@ export default function ContainerReturnsPage() {
               <Button
                 size="xs"
                 variant="light"
-                loading={advanceStatusMutation.isPending && advanceStatusMutation.variables === ret.id}
-                onClick={() => advanceStatusMutation.mutate(ret.id)}
+                loading={
+                  advanceStatusMutation.isPending &&
+                  advanceStatusMutation.variables?.id === ret.id
+                }
+                onClick={() =>
+                  nextStatus === "WAGON_ALLOCATED"
+                    ? setAllocateRow(ret)
+                    : advanceStatusMutation.mutate({ id: ret.id })
+                }
               >
                 Advance to {RETURN_STATUS_LABEL[nextStatus]}
               </Button>
@@ -628,6 +658,19 @@ export default function ContainerReturnsPage() {
         loading={createReturnsMutation.isPending}
       />
 
+      <ExportTrainAllocationModal
+        row={allocateRow}
+        onClose={() => setAllocateRow(null)}
+        onSubmit={(reference) =>
+          allocateRow &&
+          advanceStatusMutation.mutate({
+            id: allocateRow.id,
+            wagonAllocationReference: reference,
+          })
+        }
+        loading={advanceStatusMutation.isPending}
+      />
+
       <Modal opened={!!historyRow} onClose={() => setHistoryRow(null)} title="Status History" size="sm">
         {historyRow && (
           <Stack gap="sm">
@@ -635,7 +678,7 @@ export default function ContainerReturnsPage() {
             {(historyRow.statusHistory ?? []).map((entry: any, idx: number) => (
               <Group key={idx} justify="space-between">
                 <Badge size="sm">{RETURN_STATUS_LABEL[entry.status as EmptyContainerReturnStatus] ?? entry.status}</Badge>
-                <Text size="sm" c="dimmed">{new Date(entry.changedAt).toLocaleString()}</Text>
+                <Text size="sm" c="dimmed">{formatDateTime(entry.changedAt)}</Text>
               </Group>
             ))}
             {!(historyRow.statusHistory ?? []).length && (
@@ -648,6 +691,123 @@ export default function ContainerReturnsPage() {
   );
 }
 
+/**
+ * Empties ride an EXPORT departure back to Djibouti, so wagon allocation picks
+ * from the export schedules that have not left yet (DRAFT/SCHEDULED). The pick
+ * is recorded as the return's `wagonAllocationReference`.
+ */
+function ExportTrainAllocationModal({
+  row,
+  onClose,
+  onSubmit,
+  loading,
+}: {
+  row: EmptyContainerReturn | null;
+  onClose: () => void;
+  onSubmit: (reference: string) => void;
+  loading: boolean;
+}) {
+  const [scheduleId, setScheduleId] = useState<string | null>(null);
+
+  const schedulesQuery = useQuery(
+    api.trainScheduling.scheduleList.queryOptions({
+      input: { filters: { pageSize: 100, sortBy: "scheduledDepartureDate", sortOrder: "ASC" } },
+      enabled: Boolean(row),
+    }),
+  );
+
+  const exportTrains = useMemo(
+    () =>
+      ((schedulesQuery.data?.items ?? []) as TrainScheduleListItem[]).filter(
+        (s) => s.direction === "EXPORT" && (s.status === "DRAFT" || s.status === "SCHEDULED"),
+      ),
+    [schedulesQuery.data],
+  );
+
+  const referenceOf = (train: TrainScheduleListItem) =>
+    train.trainNumber || train.reference || train.id;
+
+  return (
+    <Modal opened={!!row} onClose={onClose} title="Allocate to Export Train" size="lg">
+      {row && (
+        <Stack gap="md">
+          <Text fw={600}>{row.containerNumber}</Text>
+
+          {schedulesQuery.isLoading ? (
+            <Group justify="center" py="md">
+              <Loader size="sm" />
+            </Group>
+          ) : exportTrains.length === 0 ? (
+            <Alert color="gray">No export train is scheduled — create one in Train Scheduling.</Alert>
+          ) : (
+            <Table highlightOnHover>
+              <Table.Thead>
+                <Table.Tr>
+                  <Table.Th w={40} />
+                  <Table.Th>Train</Table.Th>
+                  <Table.Th>Departure</Table.Th>
+                  <Table.Th>Route</Table.Th>
+                  <Table.Th>Wagons</Table.Th>
+                  <Table.Th>Status</Table.Th>
+                </Table.Tr>
+              </Table.Thead>
+              <Table.Tbody>
+                {exportTrains.map((train) => (
+                  <Table.Tr
+                    key={train.id}
+                    onClick={() => setScheduleId(train.id)}
+                    style={{ cursor: "pointer" }}
+                  >
+                    <Table.Td>
+                      <Checkbox
+                        checked={scheduleId === train.id}
+                        onChange={() => setScheduleId(train.id)}
+                      />
+                    </Table.Td>
+                    <Table.Td>
+                      <Text fw={600} size="sm">
+                        {referenceOf(train)}
+                      </Text>
+                    </Table.Td>
+                    <Table.Td>
+                      {train.scheduleDate ? new Date(train.scheduleDate).toLocaleDateString() : "—"}
+                    </Table.Td>
+                    <Table.Td>
+                      {train.origin ?? "—"} → {train.destination ?? "—"}
+                    </Table.Td>
+                    <Table.Td>
+                      {train.wagonsUsed ?? 0}/{train.wagonCount}
+                    </Table.Td>
+                    <Table.Td>
+                      <Badge size="sm">{train.status}</Badge>
+                    </Table.Td>
+                  </Table.Tr>
+                ))}
+              </Table.Tbody>
+            </Table>
+          )}
+
+          <Group justify="flex-end" gap="sm">
+            <Button variant="default" onClick={onClose} disabled={loading}>
+              Cancel
+            </Button>
+            <Button
+              disabled={!scheduleId}
+              loading={loading}
+              onClick={() => {
+                const train = exportTrains.find((t) => t.id === scheduleId);
+                if (train) onSubmit(referenceOf(train));
+              }}
+            >
+              Allocate
+            </Button>
+          </Group>
+        </Stack>
+      )}
+    </Modal>
+  );
+}
+
 interface ContainerReturnModalProps {
   opened: boolean;
   onClose: () => void;
@@ -687,6 +847,8 @@ function ContainerReturnModal({ opened, onClose, group, onSubmit, loading }: Con
       .filter((c) => selectedContainers.includes(c.key))
       .map((c) => ({
         containerNumber: c.containerNumber,
+        // Inventory records "20ft"/"40ft"; the wagon rule only needs the number.
+        containerSize: c.size?.includes("40") ? ("40" as const) : c.size ? ("20" as const) : undefined,
         returnDate,
         warehouse: selectedWarehouse?.name || warehouse,
         condition: condition || undefined,
@@ -799,6 +961,7 @@ interface StandaloneReturnModalProps {
 
 function StandaloneReturnModal({ opened, onClose, onSubmit, loading }: StandaloneReturnModalProps) {
   const [containerNumber, setContainerNumber] = useState<string>("");
+  const [containerSize, setContainerSize] = useState<EmptyContainerSize | null>(null);
   const [returnedBy, setReturnedBy] = useState<"EDR" | "CUSTOMER" | null>(null);
   const [returnDate, setReturnDate] = useState<string>(new Date().toISOString().split("T")[0]);
   const [warehouse, setWarehouse] = useState<string | null>(null);
@@ -859,6 +1022,7 @@ function StandaloneReturnModal({ opened, onClose, onSubmit, loading }: Standalon
           containers: [
             {
               containerNumber,
+              containerSize: containerSize ?? undefined,
               returnDate,
               warehouse: selectedWarehouse?.name || warehouse,
               yard: selectedYard?.name,
@@ -872,6 +1036,7 @@ function StandaloneReturnModal({ opened, onClose, onSubmit, loading }: Standalon
     });
 
     setContainerNumber("");
+    setContainerSize(null);
     setReturnedBy(null);
     setReturnDate(new Date().toISOString().split("T")[0]);
     setWarehouse(null);
@@ -909,6 +1074,17 @@ function StandaloneReturnModal({ opened, onClose, onSubmit, loading }: Standalon
           required
         />
 
+        <Select
+          label="Container Type"
+          placeholder="Select container size"
+          value={containerSize}
+          onChange={(val) => setContainerSize(val as EmptyContainerSize | null)}
+          data={[
+            { value: "20", label: "20 ft" },
+            { value: "40", label: "40 ft" },
+          ]}
+        />
+
         <Select
           label="Return Warehouse"
           placeholder="Select warehouse for container return"
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/EDRLastMileReturnsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/EDRLastMileReturnsPage.tsx
deleted file mode 100644
index 4c38841f8..000000000
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/EDRLastMileReturnsPage.tsx
+++ /dev/null
@@ -1,406 +0,0 @@
-import { Fragment, useMemo, useState } from "react";
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import {
-  ActionIcon,
-  Alert,
-  Badge,
-  Button,
-  Group,
-  Loader,
-  Modal,
-  Stack,
-  Table,
-  Text,
-  TextInput,
-  Textarea,
-  Select,
-  Checkbox,
-} from "@mantine/core";
-import { ChevronDown, ChevronRight } from "lucide-react";
-
-import { PageContainer, PageHeader } from "@/components/page";
-import RuleEngineListFooter from "@/components/ruleEngine/RuleEngineListFooter";
-import { useListControls } from "@/hooks/useListControls";
-import { useToast } from "@/hooks/use-toast";
-import { api } from "@/services/api";
-import { warehouseService } from "@/services/warehouse.service";
-import { importOperationsService } from "@/services/importOperations.service";
-
-interface ReturnContainer {
-  containerNumber: string;
-  size: string | null;
-  type: string | null;
-  selected: boolean;
-}
-
-interface TruckReturn {
-  key: string;
-  plate: string;
-  companyName: string | null;
-  bookingRef: string;
-  bookingId: string;
-  customerId: string | null;
-  containers: ReturnContainer[];
-}
-
-
-export default function EDRLastMileReturnsPage() {
-  const { toast } = useToast();
-  const qc = useQueryClient();
-  const [expanded, setExpanded] = useState<string | null>(null);
-  const [returnModalOpen, setReturnModalOpen] = useState(false);
-  const [activeKey, setActiveKey] = useState<string | null>(null);
-
-  const { data: unloadedQueue = [], isLoading: queueLoading } = useQuery({
-    queryKey: ["import-unloaded-queue"],
-    queryFn: async () => {
-      const response = await api.warehouses.importUnloadedQueue.call();
-      return response ?? [];
-    },
-  });
-
-  const bookingIds = unloadedQueue.map((item) => item.bookingId).filter(Boolean) as string[];
-  const truckReturnsQuery = useQuery({
-    queryKey: ["edr-last-mile-returns", bookingIds],
-    queryFn: async () => {
-      const grouped = new Map<string, TruckReturn>();
-
-      for (const item of unloadedQueue) {
-        if (!item.bookingId) continue;
-
-        const edrTrucks = await warehouseService.getLastMileTrucks(item.bookingId).catch(() => []);
-        for (const truck of edrTrucks) {
-          const inventory = await api.warehouses.listInventory.call({ filter: { bookingId: item.bookingId } }).catch(() => []);
-
-          const returnContainers = inventory
-            .filter((inv: any) => inv.isReturn)
-            .map((inv: any) => ({
-              containerNumber: inv.containerNumber || "—",
-              size: inv.containerSize || null,
-              type: inv.containerType || null,
-              selected: false,
-            }));
-
-          if (returnContainers.length > 0) {
-            const key = `${item.bookingId}-${truck.vehicleId}`;
-            grouped.set(key, {
-              key,
-              plate: [truck.truckPlateNumber, truck.trailerPlateNumber].filter(Boolean).join(" + ") || "—",
-              companyName: item.customerName ?? null,
-              bookingRef: item.bookingReference ?? item.bookingId,
-              bookingId: item.bookingId,
-              customerId: item.customerId || null,
-              containers: returnContainers,
-            });
-          }
-        }
-      }
-
-      return Array.from(grouped.values());
-    },
-    enabled: bookingIds.length > 0 && !queueLoading,
-  });
-
-  const trucksWithReturns = useMemo(() => truckReturnsQuery.data ?? [], [truckReturnsQuery.data]);
-  const controls = useListControls(trucksWithReturns, {
-    searchKeys: ["plate", "companyName", "bookingRef"],
-  });
-
-  const createReturnsMutation = useMutation({
-    mutationFn: async (payload: { trucks: Array<{ bookingId: string; customerId: string | null; containers: Array<{ containerNumber: string; returnDate: string; facility: string; yard?: string; zone?: string; condition?: string; handoverNote?: string }> }> }) => {
-      const results = [];
-      for (const truck of payload.trucks) {
-        for (const container of truck.containers) {
-          const result = await importOperationsService.createEmptyReturn({
-            containerNumber: container.containerNumber,
-            returnDate: new Date(container.returnDate).toISOString(),
-            bookingId: truck.bookingId,
-            customerId: truck.customerId ?? undefined,
-            facility: container.facility,
-            yard: container.yard,
-            zone: container.zone,
-            condition: container.condition,
-            handoverNote: container.handoverNote,
-          });
-          results.push(result);
-        }
-      }
-      return results;
-    },
-    onSuccess: () => {
-      toast({ title: "Empty container returns recorded" });
-      qc.invalidateQueries({ queryKey: ["edr-last-mile-returns", bookingIds] });
-      setReturnModalOpen(false);
-      setActiveKey(null);
-    },
-    onError: (error: any) => {
-      toast({
-        variant: "destructive",
-        title: "Failed to record returns",
-        description: error?.response?.data?.message || error?.message,
-      });
-    },
-  });
-
-  const activeTruck = activeKey ? trucksWithReturns.find(t => t.key === activeKey) ?? null : null;
-
-  if (queueLoading || truckReturnsQuery.isLoading) {
-    return (
-      <PageContainer>
-        <Group justify="center" py="lg">
-          <Loader size="sm" />
-        </Group>
-      </PageContainer>
-    );
-  }
-
-  return (
-    <PageContainer>
-      <PageHeader
-        title="EDR Last Mile Returns"
-        subtitle="Empty containers returned by EDR-haulage trucks — single or bulk processing"
-      />
-
-      {trucksWithReturns.length === 0 ? (
-        <Alert color="gray">No EDR trucks with return containers found.</Alert>
-      ) : (
-        <>
-          <Table.ScrollContainer minWidth={1000}>
-            <Table highlightOnHover verticalSpacing="xs">
-              <Table.Thead>
-                <Table.Tr>
-                  <Table.Th w={40} />
-                  <Table.Th>Plate</Table.Th>
-                  <Table.Th>Company</Table.Th>
-                  <Table.Th>Booking Ref</Table.Th>
-                  <Table.Th>Return Containers</Table.Th>
-                  <Table.Th ta="right">Actions</Table.Th>
-                </Table.Tr>
-              </Table.Thead>
-              <Table.Tbody>
-                {controls.pagedRows.map((truck) => {
-                  const isOpen = expanded === truck.key;
-                  return (
-                    <Fragment key={truck.key}>
-                      <Table.Tr>
-                        <Table.Td>
-                          <ActionIcon
-                            variant="subtle"
-                            color="gray"
-                            onClick={() => setExpanded(isOpen ? null : truck.key)}
-                          >
-                            {isOpen ? <ChevronDown size={14} /> : <ChevronRight size={14} />}
-                          </ActionIcon>
-                        </Table.Td>
-                        <Table.Td>
-                          <Text fw={600}>{truck.plate}</Text>
-                        </Table.Td>
-                        <Table.Td>{truck.companyName ?? "—"}</Table.Td>
-                        <Table.Td>{truck.bookingRef}</Table.Td>
-                        <Table.Td>
-                          <Badge>{truck.containers.length} container{truck.containers.length !== 1 ? "s" : ""}</Badge>
-                        </Table.Td>
-                        <Table.Td ta="right">
-                          <Button
-                            size="xs"
-                            variant="light"
-                            onClick={() => {
-                              setActiveKey(truck.key);
-                              setReturnModalOpen(true);
-                            }}
-                          >
-                            Process Returns
-                          </Button>
-                        </Table.Td>
-                      </Table.Tr>
-                      {isOpen && (
-                        <Table.Tr>
-                          <Table.Td colSpan={6}>
-                            <Table striped>
-                              <Table.Thead>
-                                <Table.Tr>
-                                  <Table.Th w={40}>
-                                    <Checkbox disabled />
-                                  </Table.Th>
-                                  <Table.Th>Container</Table.Th>
-                                  <Table.Th>Size</Table.Th>
-                                  <Table.Th>Type</Table.Th>
-                                </Table.Tr>
-                              </Table.Thead>
-                              <Table.Tbody>
-                                {truck.containers.map((container, idx) => (
-                                  <Table.Tr key={idx}>
-                                    <Table.Td>
-                                      <Checkbox checked={container.selected} />
-                                    </Table.Td>
-                                    <Table.Td>{container.containerNumber}</Table.Td>
-                                    <Table.Td>{container.size ?? "—"}</Table.Td>
-                                    <Table.Td>{container.type ?? "—"}</Table.Td>
-                                  </Table.Tr>
-                                ))}
-                              </Table.Tbody>
-                            </Table>
-                          </Table.Td>
-                        </Table.Tr>
-                      )}
-                    </Fragment>
-                  );
-                })}
-              </Table.Tbody>
-            </Table>
-          </Table.ScrollContainer>
-          <RuleEngineListFooter
-            pagination={controls.pagination}
-            pageCount={controls.pageCount}
-            totalCount={controls.totalCount}
-            itemLabel="trucks"
-            onPaginationChange={controls.setPagination}
-          />
-        </>
-      )}
-
-      <EmptyContainerReturnModal
-        opened={returnModalOpen}
-        onClose={() => setReturnModalOpen(false)}
-        truck={activeTruck}
-        onSubmit={(payload) => createReturnsMutation.mutate(payload)}
-        loading={createReturnsMutation.isPending}
-      />
-    </PageContainer>
-  );
-}
-
-interface EmptyContainerReturnModalProps {
-  opened: boolean;
-  onClose: () => void;
-  truck: TruckReturn | null;
-  onSubmit: (payload: any) => void;
-  loading: boolean;
-}
-
-function EmptyContainerReturnModal({ opened, onClose, truck, onSubmit, loading }: EmptyContainerReturnModalProps) {
-  const [selectedContainers, setSelectedContainers] = useState<string[]>([]);
-  const [returnDate, setReturnDate] = useState<string>(new Date().toISOString().split("T")[0]);
-  const [warehouse, setWarehouse] = useState<string | null>(null);
-  const [condition, setCondition] = useState<string>("");
-  const [handoverNote, setHandoverNote] = useState<string>("");
-
-  const { data: warehousesResponse } = useQuery({
-    queryKey: ["warehouses-list"],
-    queryFn: async () => {
-      return await warehouseService.list({});
-    },
-  });
-
-  const warehouses = (warehousesResponse as any)?.data ?? warehousesResponse ?? [];
-  const warehouseOptions = Array.isArray(warehouses) ? warehouses.map((wh: any) => ({
-    value: wh.id,
-    label: `${wh.name} ${wh.code ? `(${wh.code})` : ""}`,
-  })) : [];
-
-  const selectedWarehouse = warehouse && Array.isArray(warehouses) ? warehouses.find((wh: any) => wh.id === warehouse) : null;
-
-  const handleSubmit = () => {
-    if (!truck || !selectedContainers.length || !warehouse) return;
-
-    const containers = truck.containers
-      .filter((c) => selectedContainers.includes(c.containerNumber))
-      .map((c) => ({
-        containerNumber: c.containerNumber,
-        returnDate,
-        facility: selectedWarehouse?.name || warehouse,
-        yard: selectedWarehouse?.code || undefined,
-        zone: undefined,
-        condition: condition || undefined,
-        handoverNote: handoverNote || undefined,
-      }));
-
-    onSubmit({
-      trucks: [{
-        bookingId: truck.bookingId,
-        customerId: truck.customerId,
-        containers,
-      }],
-    });
-  };
-
-  return (
-    <Modal opened={opened} onClose={onClose} title="Process Empty Container Returns" size="lg">
-      {truck && (
-        <Stack gap="md">
-          <Group>
-            <Text fw={600}>{truck.plate}</Text>
-            <Text size="sm" c="dimmed">{truck.bookingRef}</Text>
-          </Group>
-
-          <div>
-            <Text size="sm" fw={600} mb="xs">Select containers to return:</Text>
-            <Stack gap="xs">
-              {truck.containers.map((container) => (
-                <Checkbox
-                  key={container.containerNumber}
-                  label={`${container.containerNumber} (${container.size || "bulk"})`}
-                  checked={selectedContainers.includes(container.containerNumber)}
-                  onChange={(e) => {
-                    if (e.currentTarget.checked) {
-                      setSelectedContainers([...selectedContainers, container.containerNumber]);
-                    } else {
-                      setSelectedContainers(selectedContainers.filter(c => c !== container.containerNumber));
-                    }
-                  }}
-                />
-              ))}
-            </Stack>
-          </div>
-
-          <Select
-            label="Return Warehouse"
-            placeholder="Select warehouse for container return"
-            value={warehouse}
-            onChange={setWarehouse}
-            data={warehouseOptions}
-            required
-            searchable
-          />
-
-          <TextInput
-            label="Return Date"
-            type="date"
-            value={returnDate}
-            onChange={(e) => setReturnDate(e.currentTarget.value)}
-            required
-          />
-
-          <Textarea
-            label="Condition"
-            placeholder="Damage, residue, or cleanliness notes"
-            value={condition}
-            onChange={(e) => setCondition(e.currentTarget.value)}
-            rows={3}
-          />
-
-          <Textarea
-            label="Handover Note"
-            placeholder="Consignee, trucker, or authorization notes"
-            value={handoverNote}
-            onChange={(e) => setHandoverNote(e.currentTarget.value)}
-            rows={3}
-          />
-
-          <Group justify="flex-end" gap="sm">
-            <Button variant="default" onClick={onClose} disabled={loading}>
-              Cancel
-            </Button>
-            <Button
-              onClick={handleSubmit}
-              disabled={!selectedContainers.length || !warehouse}
-              loading={loading}
-            >
-              {selectedContainers.length > 1 ? "Bulk" : "Single"} Return ({selectedContainers.length})
-            </Button>
-          </Group>
-        </Stack>
-      )}
-    </Modal>
-  );
-}
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/ImportTrucksPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/ImportTrucksPage.tsx
index d2cc909f2..a074006d8 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/ImportTrucksPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/ImportTrucksPage.tsx
@@ -38,6 +38,7 @@ import {
   toReleaseInventoryItem,
 } from "@/components/warehouses/options";
 import { openPdfBlob } from "@/components/warehouses/pdf";
+import { formatDateTime } from "@/lib/format";
 import { useListControls } from "@/hooks/useListControls";
 import { useToast } from "@/hooks/use-toast";
 import { api } from "@/services/api";
@@ -79,8 +80,6 @@ const TRUCK_COLUMNS = [
 const money = (amount: number, currency: string) =>
   `${Number(amount).toLocaleString(undefined, { maximumFractionDigits: 2 })} ${currency === "ETB" ? "ETB" : currency}`;
 
-const formatTime = (iso: string | null | undefined) =>
-  iso ? new Date(iso).toLocaleString() : "—";
 
 export interface BookingGroup {
   bookingId: string;
@@ -376,10 +375,10 @@ export function TruckRows({ group }: { group: BookingGroup }) {
               <Text size="sm">{t.containers.length ? t.containers.join(", ") : "Bulk"}</Text>
             </Table.Td>
             <Table.Td>
-              <Text size="xs">{formatTime(t.arrivedAt)}</Text>
+              <Text size="xs">{formatDateTime(t.arrivedAt)}</Text>
             </Table.Td>
             <Table.Td>
-              <Text size="xs">{formatTime(t.departedAt)}</Text>
+              <Text size="xs">{formatDateTime(t.departedAt)}</Text>
             </Table.Td>
             <Table.Td>{formatNumber(t.weight)}</Table.Td>
             <Table.Td>{money(t.demurrage, feeCurrency)}</Table.Td>
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/InterchangeDocumentsPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/InterchangeDocumentsPage.tsx
index 3cc1f1ab6..fa2c704b2 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/InterchangeDocumentsPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/InterchangeDocumentsPage.tsx
@@ -28,6 +28,7 @@ import {
   useInterchangeDocuments,
 } from '@/hooks/useInterchangeDocuments';
 import { useToast } from '@/hooks/use-toast';
+import { humanize } from '@/lib/format';
 import { interchangeDocumentsService } from '@/services/interchange-documents.service';
 import type { InterchangeDocument, InterchangeDocumentStatus } from '@/types/interchangeDocument';
 
@@ -336,7 +337,7 @@ export default function InterchangeDocumentsPage() {
         </Text>
       ),
     },
-    { id: 'direction', header: 'Direction', cell: ({ row }) => row.original.direction },
+    { id: 'direction', header: 'Direction', cell: ({ row }) => humanize(row.original.direction) },
     { id: 'train', header: 'Train No', cell: ({ row }) => row.original.trainNo ?? '-' },
     { id: 'handoverLocation', header: 'Handover Location', cell: ({ row }) => row.original.handoverLocation },
     { id: 'handoverFrom', header: 'Handover From', cell: ({ row }) => row.original.handoverFrom },
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/LoadedInventoryPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/LoadedInventoryPage.tsx
index dbf7b14e3..d3a249395 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/LoadedInventoryPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/LoadedInventoryPage.tsx
@@ -1,7 +1,6 @@
 import { Badge, Card, Group, Text } from '@mantine/core';
 import { DataTable, type ColumnDef } from '@edr/ui-common';
-import ListControls from '@/components/common/ListControls';
-import { useListControls } from '@/hooks/useListControls';
+import { applyClientFilters, FilterBar, useFilters, type FilterDef } from '@/components/filters';
 
 import { PageContainer, PageHeader } from '@/components/page';
 import { useQuery } from '@tanstack/react-query';
@@ -63,16 +62,27 @@ const columns: ColumnDef<Loading>[] = [
   },
 ];
 
+const LOADING_FILTER_DEFS: FilterDef[] = [{ key: 'loadedAt', label: 'Loaded', type: 'date' }];
+
 /** Record of every inventory item loaded onto a wagon. */
 export default function LoadedInventoryPage() {
   const { data, isLoading } = useQuery(
     api.warehouses.loadings.queryOptions({ input: {} }),
   );
   const loadings = data ?? [];
-  const controls = useListControls(loadings, {
-    searchKeys: ['wagonNumber'],
-    dateKey: 'loadedAt',
-  });
+  const controls = useFilters(LOADING_FILTER_DEFS, { pageSize: 10 });
+  // Endpoint takes no params at all — everything filters client-side.
+  const filteredLoadings = applyClientFilters(
+    loadings,
+    LOADING_FILTER_DEFS,
+    controls.values,
+    controls.searchText,
+    { searchKeys: ['wagonNumber'] },
+  );
+  const pagedLoadings = filteredLoadings.slice(
+    (controls.page - 1) * controls.pageSize,
+    controls.page * controls.pageSize,
+  );
 
   return (
     <PageContainer>
@@ -90,24 +100,18 @@ export default function LoadedInventoryPage() {
           />
         ) : (
           <>
-            <ListControls
-              search={controls.search}
-              onSearchChange={controls.setSearch}
+            <FilterBar
+              defs={LOADING_FILTER_DEFS}
+              controls={controls}
               searchPlaceholder="Search by wagon…"
-              dateFrom={controls.dateFrom}
-              onDateFromChange={controls.setDateFrom}
-              dateTo={controls.dateTo}
-              onDateToChange={controls.setDateTo}
-              dateLabel="Loaded"
-              hasFilters={controls.hasFilters}
-              onReset={controls.reset}
+              viewId="loaded-inventory"
             />
             <DataTable
               columns={columns}
-              data={controls.pagedRows}
+              data={pagedLoadings}
               status={isLoading ? 'loading' : 'success'}
               containerClassName="border-0 shadow-none"
-              {...controls.tableProps}
+              {...controls.tableProps(filteredLoadings.length)}
             />
           </>
         )}
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/TrucksOnSitePage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/TrucksOnSitePage.tsx
index f095d94d4..7ddcef866 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/TrucksOnSitePage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/TrucksOnSitePage.tsx
@@ -11,13 +11,19 @@ import {
 } from "@mantine/core";
 
 import { PageContainer, PageHeader } from "@/components/page";
-import ListControls from "@/components/common/ListControls";
 // Generic list footer — already shared by the fleet and train-scheduling lists
 // despite the ruleEngine path; reused here rather than adding a second one.
 import RuleEngineListFooter from "@/components/ruleEngine/RuleEngineListFooter";
-import { useListControls } from "@/hooks/useListControls";
+import {
+  applyClientFilters,
+  FilterBar,
+  toRuleEngineFooterProps,
+  useFilters,
+  type FilterDef,
+} from "@/components/filters";
 import { useTrucksOnSite } from "@/hooks/useWarehouses";
 import type { TruckOnSite } from "@/types/warehouse";
+import { formatDateTime } from "@/lib/format";
 
 /**
  * Every truck inside the yard right now, across all bookings.
@@ -122,7 +128,7 @@ function Rows({ rows }: { rows: TruckOnSite[] }) {
                   </Text>
                 ) : isLongDwell(row.arrivedAt) ? (
                   <Tooltip
-                    label={`On site over ${LONG_DWELL_HOURS}h — arrived ${new Date(row.arrivedAt).toLocaleString()}`}
+                    label={`On site over ${LONG_DWELL_HOURS}h — arrived ${formatDateTime(row.arrivedAt)}`}
                     withArrow
                   >
                     <Text size="sm" c="red" fw={600}>
@@ -141,10 +147,14 @@ function Rows({ rows }: { rows: TruckOnSite[] }) {
   );
 }
 
+const TRUCK_FILTER_DEFS: FilterDef[] = [{ key: "arrivedAt", label: "Arrived", type: "date" }];
+
 export default function TrucksOnSitePage() {
   const { data: trucks = [], isLoading } = useTrucksOnSite();
   // The dashboard's "Trucks on-site" card counts only arrived trucks, so it
-  // deep-links here with ?scope=ON_SITE to land on the matching tab.
+  // deep-links here with ?scope=ON_SITE to land on the matching tab. Read
+  // once at mount, same as before — scope/source stay page-level tab state
+  // (mutually exclusive, dashboard-linked), not filter pills.
   const [searchParams] = useSearchParams();
   const scopeParam = searchParams.get("scope");
   const [scope, setScope] = useState<"ALL" | "ON_SITE" | "INBOUND">(
@@ -152,7 +162,7 @@ export default function TrucksOnSitePage() {
   );
   const [source, setSource] = useState<"ALL" | "CUSTOMER" | "EDR">("ALL");
 
-  // Scope/source are page filters and run first; the shared control then does
+  // Scope/source are page filters and run first; the filter bar then does
   // search + arrival-date range + pagination over what they leave.
   const scoped = useMemo(
     () =>
@@ -162,10 +172,14 @@ export default function TrucksOnSitePage() {
     [trucks, scope, source],
   );
 
-  const controls = useListControls(scoped, {
+  const controls = useFilters(TRUCK_FILTER_DEFS, { pageSize: 10 });
+  const filteredTrucks = applyClientFilters(scoped, TRUCK_FILTER_DEFS, controls.values, controls.searchText, {
     searchKeys: ["plateNumber", "driverName", "bookingReference", "customerName", "containers"],
-    dateKey: "arrivedAt",
   });
+  const pagedTrucks = filteredTrucks.slice(
+    (controls.page - 1) * controls.pageSize,
+    controls.page * controls.pageSize,
+  );
 
   const onSiteCount = trucks.filter((t) => t.status === "ON_SITE").length;
   const inboundCount = trucks.length - onSiteCount;
@@ -184,7 +198,10 @@ export default function TrucksOnSitePage() {
           <SegmentedControl
             size="xs"
             value={scope}
-            onChange={(v) => setScope(v as typeof scope)}
+            onChange={(v) => {
+              setScope(v as typeof scope);
+              controls.setPage(1);
+            }}
             data={[
               { label: `All (${trucks.length})`, value: "ALL" },
               { label: `On site (${onSiteCount})`, value: "ON_SITE" },
@@ -194,7 +211,10 @@ export default function TrucksOnSitePage() {
           <SegmentedControl
             size="xs"
             value={source}
-            onChange={(v) => setSource(v as typeof source)}
+            onChange={(v) => {
+              setSource(v as typeof source);
+              controls.setPage(1);
+            }}
             data={[
               { label: "All", value: "ALL" },
               { label: `Customer (${customerCount})`, value: "CUSTOMER" },
@@ -204,30 +224,21 @@ export default function TrucksOnSitePage() {
         </Group>
       </Group>
 
-      <ListControls
-        search={controls.search}
-        onSearchChange={controls.setSearch}
+      <FilterBar
+        defs={TRUCK_FILTER_DEFS}
+        controls={controls}
         searchPlaceholder="Plate, driver, booking, container…"
-        dateFrom={controls.dateFrom}
-        onDateFromChange={controls.setDateFrom}
-        dateTo={controls.dateTo}
-        onDateToChange={controls.setDateTo}
-        dateLabel="Arrived"
-        hasFilters={controls.hasFilters}
-        onReset={controls.reset}
+        viewId="trucks-on-site"
       />
 
       {isLoading ? (
         <Text size="sm">Loading…</Text>
       ) : (
         <>
-          <Rows rows={controls.pagedRows} />
+          <Rows rows={pagedTrucks} />
           <RuleEngineListFooter
-            pagination={controls.pagination}
-            pageCount={controls.pageCount}
-            totalCount={controls.totalCount}
             itemLabel="trucks"
-            onPaginationChange={controls.setPagination}
+            {...toRuleEngineFooterProps(controls, filteredTrucks.length)}
           />
         </>
       )}
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseDashboardPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseDashboardPage.tsx
index d8298761a..93dd830a2 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseDashboardPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseDashboardPage.tsx
@@ -1,18 +1,17 @@
 import { useNavigate } from 'react-router-dom';
 import { Badge, Card, Center, Divider, Group, Loader, SimpleGrid, Stack, Text, ThemeIcon } from '@mantine/core';
 import {
-  ClipboardCheck,
   ClipboardList,
-  ShieldCheck,
   PackageCheck,
+  PackageOpen,
   PackagePlus,
   PackageSearch,
   CircleCheck,
   Send,
+  Train,
   Truck,
   Warehouse as WarehouseIcon,
   Boxes,
-  Layers,
 } from 'lucide-react';
 
 import { PageContainer, PageHeader } from '@/components/page';
@@ -53,13 +52,13 @@ const METRICS: Metric[] = [
   { key: 'totalInventory', label: 'Total Inventory', icon: <Boxes size={22} />, to: '/dashboard/warehouse-inventory', theme: GREEN },
   { key: 'receivedToday', label: 'Received Today', icon: <PackagePlus size={22} />, to: '/dashboard/warehouse-inventory?status=RECEIVED', theme: ORANGE },
   { key: 'awaitingInspection', label: 'Awaiting Inspection', icon: <ClipboardList size={22} />, to: '/dashboard/warehouse-inventory?status=RECEIVED', theme: GREEN },
-  { key: 'inspected', label: 'Inspected', icon: <ShieldCheck size={22} />, to: '/dashboard/warehouse-inventory', theme: ORANGE },
-  { key: 'stored', label: 'Stored', icon: <Layers size={22} />, to: '/dashboard/warehouse-inventory?status=STORED', theme: GREEN },
-  { key: 'reserved', label: 'Reserved', icon: <ClipboardCheck size={22} />, to: '/dashboard/warehouse-inventory?status=RESERVED', theme: ORANGE },
-  { key: 'readyForLoading', label: 'Ready For Loading', icon: <PackageCheck size={22} />, to: '/dashboard/loading-queue', theme: GREEN },
-  { key: 'loaded', label: 'Loaded', icon: <Truck size={22} />, to: '/dashboard/loaded-inventory', theme: ORANGE },
-  { key: 'dispatched', label: 'Dispatched', icon: <Send size={22} />, to: '/dashboard/dispatch-queue', theme: GREEN },
-  { key: 'readyForPickup', label: 'Ready For Pickup', icon: <PackageSearch size={22} />, to: '/dashboard/warehouse-inventory?status=READY_FOR_PICKUP', theme: ORANGE },
+  { key: 'emptyContainers', label: 'Empty Containers', icon: <PackageOpen size={22} />, to: '/dashboard/containers', theme: ORANGE },
+  { key: 'importTrains', label: 'Import Trains', icon: <Train size={22} />, to: '/dashboard/import-warehouse', theme: GREEN },
+  { key: 'exportTrains', label: 'Export Trains', icon: <Train size={22} />, to: '/dashboard/export-warehouse', theme: ORANGE },
+  { key: 'loaded', label: 'Loaded', icon: <Truck size={22} />, to: '/dashboard/loaded-inventory', theme: GREEN },
+  { key: 'dispatched', label: 'Dispatched', icon: <Send size={22} />, to: '/dashboard/dispatch-queue', theme: ORANGE },
+  { key: 'readyForPickup', label: 'Ready For Pickup', icon: <PackageSearch size={22} />, to: '/dashboard/warehouse-inventory?status=READY_FOR_PICKUP', theme: GREEN },
+  { key: 'readyForLoading', label: 'Ready For Loading', icon: <PackageCheck size={22} />, to: '/dashboard/loading-queue', theme: ORANGE },
   { key: 'delivered', label: 'Delivered', icon: <CircleCheck size={22} />, to: '/dashboard/warehouse-inventory?status=DELIVERED', theme: GREEN },
 ];
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseInvoicesPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseInvoicesPage.tsx
index dc4ae4f86..974755a71 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseInvoicesPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseInvoicesPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import {
   ActionIcon,
   Badge,
@@ -18,8 +18,7 @@ import {
 import { Ban, CreditCard, DoorOpen, Download, ExternalLink, Eye, Receipt } from 'lucide-react';
 import { useNavigate } from 'react-router-dom';
 import { DataTable, type ColumnDef } from '@edr/ui-common';
-import ListControls from '@/components/common/ListControls';
-import { useListControls } from '@/hooks/useListControls';
+import { applyClientFilters, FilterBar, useFilters, type FilterDef } from '@/components/filters';
 
 import { PageContainer, PageHeader } from '@/components/page';
 import { AccrualDashboard } from '@/components/warehouses';
@@ -40,6 +39,7 @@ import { buildWarehouseExitPaperPdf } from '@/components/warehouses/warehousePdf
 import { extractErrorMessage } from '@/components/warehouses/options';
 import { useAuth } from '@/auth/useAuth';
 import { FREIGHT_PERMS, hasPermission } from '@/lib/permissions';
+import { formatMoney, humanize } from '@/lib/format';
 
 const STATUS_COLOR: Record<WarehouseInvoiceStatus, string> = {
   DRAFT: 'gray',
@@ -50,12 +50,24 @@ const STATUS_COLOR: Record<WarehouseInvoiceStatus, string> = {
   CANCELLED: 'gray',
 };
 
-const fmt = (n: number, c: string) => `${Number(n).toLocaleString()} ${c === 'ETB' ? 'Birr (ETB)' : c}`;
+const fmt = (n: number, c: string) => formatMoney(n, c, 2);
 const fmtDate = (d?: string | null) => (d ? new Date(d).toLocaleDateString() : '—');
 
+const INVOICE_FILTER_DEFS: FilterDef[] = [
+  {
+    key: 'status',
+    label: 'Status',
+    type: 'enum',
+    multiple: false,
+    options: WAREHOUSE_INVOICE_STATUSES.map((s) => ({ value: s, label: s.replace(/_/g, ' ') })),
+  },
+  { key: 'issuedAt', label: 'Issued', type: 'date' },
+];
+
 export default function WarehouseInvoicesPage() {
-  const [status, setStatus] = useState<WarehouseInvoiceStatus | null>(null);
   const [detailId, setDetailId] = useState<string | null>(null);
+  const controls = useFilters(INVOICE_FILTER_DEFS, { pageSize: 10 });
+  const status = (controls.values.status?.v[0] as WarehouseInvoiceStatus | undefined) ?? null;
 
   const { data, isLoading } = useQuery(
     api.warehouses.invoices.queryOptions({
@@ -64,10 +76,20 @@ export default function WarehouseInvoicesPage() {
   );
   const invoices = data ?? [];
 
-  const controls = useListControls(invoices, {
-    searchKeys: ['invoiceNumber', 'bookingReference', 'customerName', 'containerNumber'],
-    dateKey: 'issuedAt',
-  });
+  // Endpoint only filters by `status`; search + issued-date range are
+  // applied client-side (the client bridge — see components/filters/clientFilter.ts).
+  // Flip to server mode by deleting this call once the endpoint takes more params.
+  const filteredInvoices = applyClientFilters(
+    invoices,
+    INVOICE_FILTER_DEFS,
+    controls.values,
+    controls.searchText,
+    { searchKeys: ['invoiceNumber', 'bookingReference', 'customerName', 'containerNumber'] },
+  );
+  const pagedInvoices = useMemo(
+    () => filteredInvoices.slice((controls.page - 1) * controls.pageSize, controls.page * controls.pageSize),
+    [filteredInvoices, controls.page, controls.pageSize],
+  );
 
   const invoiceColumns: ColumnDef<WarehouseFeeInvoice>[] = [
     {
@@ -79,7 +101,7 @@ export default function WarehouseInvoicesPage() {
         </Text>
       ),
     },
-    { id: 'type', header: 'Type', cell: ({ row }) => row.original.invoiceType.replace(/_/g, ' ') },
+    { id: 'type', header: 'Type', cell: ({ row }) => humanize(row.original.invoiceType) },
     { id: 'total', header: 'Total', cell: ({ row }) => fmt(row.original.totalAmount, row.original.currency) },
     { id: 'paid', header: 'Paid', cell: ({ row }) => fmt(row.original.paidAmount, row.original.currency) },
     {
@@ -134,36 +156,20 @@ export default function WarehouseInvoicesPage() {
       </Stack>
 
       <Card>
-        <ListControls
-          search={controls.search}
-          onSearchChange={controls.setSearch}
+        <FilterBar
+          defs={INVOICE_FILTER_DEFS}
+          controls={controls}
           searchPlaceholder="Search invoice no / booking / customer"
-          dateFrom={controls.dateFrom}
-          onDateFromChange={controls.setDateFrom}
-          dateTo={controls.dateTo}
-          onDateToChange={controls.setDateTo}
-          dateLabel="Issued"
-          hasFilters={controls.hasFilters}
-          onReset={controls.reset}
-        >
-          <Select
-            label="Status"
-            placeholder="All statuses"
-            data={WAREHOUSE_INVOICE_STATUSES.map((s) => ({ value: s, label: s.replace(/_/g, ' ') }))}
-            value={status}
-            onChange={(v) => setStatus((v as WarehouseInvoiceStatus) ?? null)}
-            clearable
-            w={200}
-          />
-        </ListControls>
+          viewId="warehouse-invoices"
+        />
 
         <DataTable
           columns={invoiceColumns}
-          data={controls.pagedRows}
+          data={pagedInvoices}
           status={isLoading ? 'loading' : 'success'}
           emptyMessage="No invoices found."
           containerClassName="border-0 shadow-none"
-          {...controls.tableProps}
+          {...controls.tableProps(filteredInvoices.length)}
         />
       </Card>
 
diff --git a/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseRulesPage.tsx b/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseRulesPage.tsx
index a6339965a..8c432f92a 100644
--- a/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseRulesPage.tsx
+++ b/apps/edr-freight-web/backoffice/src/pages/warehouses/WarehouseRulesPage.tsx
@@ -46,6 +46,7 @@ import {
   type FeeRuleBasis,
   type FeeRuleType,
 } from '@/types/warehouse';
+import { humanize } from '@/lib/format';
 
 const RULE_TYPE_COLOR: Record<FeeRuleType, string> = {
   STORAGE_FEE: 'teal',
@@ -218,8 +219,8 @@ function AllocationRules() {
   const allocationColumns: ColumnDef<AllocationRule>[] = [
     { id: 'priority', header: 'Priority', cell: ({ row }) => row.original.priority },
     { id: 'name', header: 'Name', cell: ({ row }) => row.original.name },
-    { id: 'freight', header: 'Freight', cell: ({ row }) => row.original.freightType ?? dash },
-    { id: 'trade', header: 'Trade', cell: ({ row }) => row.original.tradeDirection ?? dash },
+    { id: 'freight', header: 'Freight', cell: ({ row }) => (row.original.freightType ? humanize(row.original.freightType) : dash) },
+    { id: 'trade', header: 'Trade', cell: ({ row }) => (row.original.tradeDirection ? humanize(row.original.tradeDirection) : dash) },
     { id: 'cargoCode', header: 'Cargo code', cell: ({ row }) => row.original.cargoTypeCode ?? dash },
     {
       id: 'targetYard',
@@ -615,10 +616,10 @@ function FeeRules() {
       ),
     },
     { id: 'name', header: 'Name', cell: ({ row }) => row.original.name },
-    { id: 'freight', header: 'Freight', cell: ({ row }) => row.original.freightType ?? dash },
-    { id: 'trade', header: 'Trade', cell: ({ row }) => row.original.tradeDirection ?? dash },
+    { id: 'freight', header: 'Freight', cell: ({ row }) => (row.original.freightType ? humanize(row.original.freightType) : dash) },
+    { id: 'trade', header: 'Trade', cell: ({ row }) => (row.original.tradeDirection ? humanize(row.original.tradeDirection) : dash) },
     { id: 'cargo', header: 'Cargo', cell: ({ row }) => row.original.cargoTypeCode ?? dash },
-    { id: 'container', header: 'Container', cell: ({ row }) => row.original.containerType ?? dash },
+    { id: 'container', header: 'Container', cell: ({ row }) => (row.original.containerType ? humanize(row.original.containerType) : dash) },
     {
       id: 'scope',
       header: 'Location scope',
diff --git a/apps/edr-freight-web/backoffice/src/record-management/common/RichTextEditor.tsx b/apps/edr-freight-web/backoffice/src/record-management/common/RichTextEditor.tsx
index 5d48b25e4..19cd96f0a 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/common/RichTextEditor.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/common/RichTextEditor.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useRef, useState } from "react";
+import { useEffect, useMemo, useRef } from "react";
 import { Editor } from "@tinymce/tinymce-react";
 import type { Editor as TinyMCEEditor } from "tinymce";
 
@@ -34,16 +34,10 @@ export default function RichTextEditor({
   shouldClear?: boolean;
 }) {
   const editorRef = useRef<TinyMCEEditor | null>(null);
-  const [isDarkMode, setIsDarkMode] = useState(() => {
-    if (typeof window === "undefined") {
-      return false;
-    }
-
-    const root = document.documentElement;
-    return (
-      root.classList.contains("dark") || root.getAttribute("data-theme") === "dark"
-    );
-  });
+  // The app is light-only — nothing sets `dark` / data-theme on <html>, so this
+  // is a constant rather than observed state. Kept as a named flag so the
+  // TinyMCE skin/content-style branches below stay readable.
+  const isDarkMode = false;
 
   // ✅ When shouldClear becomes true → clear editor + remove draft
   useEffect(() => {
@@ -54,28 +48,6 @@ export default function RichTextEditor({
     }
   }, [shouldClear]);
 
-  useEffect(() => {
-    const root = document.documentElement;
-    const updateThemeMode = () => {
-      setIsDarkMode(
-        root.classList.contains("dark") ||
-          root.getAttribute("data-theme") === "dark",
-      );
-    };
-
-    updateThemeMode();
-
-    const observer = new MutationObserver(updateThemeMode);
-    observer.observe(root, {
-      attributes: true,
-      attributeFilter: ["class", "data-theme"],
-    });
-
-    return () => {
-      observer.disconnect();
-    };
-  }, []);
-
   const init = useMemo(
     () => ({
       // Point self-hosted TinyMCE at the static assets copied into /public/tinymce.
diff --git a/apps/edr-freight-web/backoffice/src/record-management/components/Settings/uploadTeeterandSingature.tsx b/apps/edr-freight-web/backoffice/src/record-management/components/Settings/uploadTeeterandSingature.tsx
index 3035d58c7..a6855f540 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/components/Settings/uploadTeeterandSingature.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/components/Settings/uploadTeeterandSingature.tsx
@@ -609,10 +609,18 @@ const UploadTeeterAndSignature = () => {
           )}
         </TabsContent>
 
-        {/* Teeter Tab */}
+        {/* Teeter Tab — single active stamp only: remove the current one to upload a replacement. */}
         <TabsContent value="teeter" className="p-4 space-y-6">
           {teeters.length > 0 && (
             <div className="space-y-6">
+              {teeters.length > 1 && (
+                <p className="rounded border border-amber-200 bg-amber-50 p-2 text-sm text-amber-700 dark:border-amber-900 dark:bg-amber-950 dark:text-amber-300">
+                  {t(
+                    "signatureUpload.multipleStampsWarning",
+                    "Only one stamp is allowed. Remove the extras below to keep a single active stamp.",
+                  )}
+                </p>
+              )}
               {teeters.map(({ id, url }) => (
                 <div key={id} className="space-y-3">
                   <p className="text-sm text-gray-600 dark:text-gray-300">
@@ -635,6 +643,7 @@ const UploadTeeterAndSignature = () => {
             </div>
           )}
 
+          {teeters.length === 0 && (
           <div className="border-2 border-dashed border-primary-300 dark:border-primary-600 rounded-lg p-6 text-center space-y-4">
             {!stampBlocks && !showLanguagePicker && (
               <Button
@@ -792,6 +801,7 @@ const UploadTeeterAndSignature = () => {
               </>
             )}
           </div>
+          )}
         </TabsContent>
       </Tabs>
 
diff --git a/apps/edr-freight-web/backoffice/src/record-management/components/common/Top.tsx b/apps/edr-freight-web/backoffice/src/record-management/components/common/Top.tsx
index 82e716d66..4f58ae6b7 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/components/common/Top.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/components/common/Top.tsx
@@ -21,8 +21,6 @@ import {
   Key,
   LogOut,
   LucideIcon,
-  Moon,
-  Sun,
   User,
   UserPen,
   UsersRound,
@@ -37,7 +35,6 @@ import UserApprovalDropdown from "../PendingUsersList";
 import { usePendingUsers } from "@/user-management/userManagement/hooks/usePendingUsersHook";
 import { useUserDetail } from "../hooks/useUserDetail";
 import { MeDto } from "@/shared/dto/user/meDto";
-import { useDarkMode } from "@/shared/hooks/useDarkMode";
 import {
   UI_LANGUAGE_OPTIONS,
   getUiLanguageLabel,
@@ -133,7 +130,6 @@ const Top: React.FC<HeaderProps> = ({
     logout();
   };
 
-  const { isDarkMode, toggleDarkMode } = useDarkMode();
   const { pendingUsers } = usePendingUsers({ take: 5, skip: 0 });
   const pendingUsersCount = pendingUsers?.count || 0;
 
@@ -359,21 +355,6 @@ const Top: React.FC<HeaderProps> = ({
         </div>
 
         <div className="flex max-w-[56vw] flex-shrink-0 items-center space-x-1.5 sm:max-w-none sm:space-x-2.5">
-          <Button
-            variant="ghost"
-            size="icon"
-            className="h-9 w-9 rounded-xl bg-white/90 text-gray-600 shadow-sm ring-1 ring-inset ring-black/5 transition-colors hover:bg-primary-50 hover:text-primary-700 hover:ring-primary-200 dark:bg-gray-800/90 dark:text-gray-300 dark:ring-white/10 dark:hover:bg-primary-900/20 dark:hover:text-primary-300 dark:hover:ring-primary-700/40 sm:h-10 sm:w-10"
-            aria-label={isDarkMode ? "Light mode" : "Dark mode"}
-            onClick={toggleDarkMode}
-            title={isDarkMode ? "Switch to light mode" : "Switch to dark mode"}
-          >
-            {isDarkMode ? (
-              <Sun className="h-4 w-4 text-yellow-500" />
-            ) : (
-              <Moon className="h-4 w-4 text-gray-700 dark:text-gray-300" />
-            )}
-          </Button>
-
           {canActivateUsers && (
             <div className="relative">
               <Button
@@ -570,7 +551,7 @@ const Top: React.FC<HeaderProps> = ({
 
               <DropdownMenuItem
                 className="flex cursor-pointer items-center rounded-lg px-3 py-2.5 text-sm text-gray-700 transition-colors hover:bg-primary-50 dark:text-gray-200 dark:hover:bg-primary-900/20"
-                onClick={() => navigate("/change-password")}
+                onClick={() => navigate("/dashboard/profile")}
               >
                 <Key className="mr-2.5 h-4 w-4 text-primary-600 dark:text-primary-400" />
                 <span>{t("header.changePassword")}</span>
diff --git a/apps/edr-freight-web/backoffice/src/record-management/components/sectorReports/SectorReportFilters.tsx b/apps/edr-freight-web/backoffice/src/record-management/components/sectorReports/SectorReportFilters.tsx
index 1ad10b52b..1d148c594 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/components/sectorReports/SectorReportFilters.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/components/sectorReports/SectorReportFilters.tsx
@@ -14,6 +14,7 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/shared/common/ui/select";
+import { DateRangePicker, parseDay, formatDay } from "@/shared/common/ui/date-range-picker";
 
 export interface ReportFilterOption {
   id: string;
@@ -167,33 +168,18 @@ export function SectorReportFilters({
         </Select>
       </label>
 
-      <label className="space-y-1.5 text-xs font-medium">
+      <label className="space-y-1.5 text-xs font-medium sm:col-span-2">
         <span className="flex items-center gap-2">
           <CalendarDays className="size-4 text-primary" />
-          From date
+          Date range
         </span>
-        <input
-          type="date"
-          value={fromDate}
-          max={toDate || undefined}
+        <DateRangePicker
+          value={{ from: parseDay(fromDate), to: parseDay(toDate) }}
+          onChange={(range) => {
+            onFromDateChange(formatDay(range.from));
+            onToDateChange(formatDay(range.to));
+          }}
           disabled={!unitId || loading}
-          onChange={(event) => onFromDateChange(event.target.value)}
-          className="flex h-9 w-full rounded-md border border-input bg-background px-3 py-1 text-sm shadow-sm outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50"
-        />
-      </label>
-
-      <label className="space-y-1.5 text-xs font-medium">
-        <span className="flex items-center gap-2">
-          <CalendarDays className="size-4 text-primary" />
-          To date
-        </span>
-        <input
-          type="date"
-          value={toDate}
-          min={fromDate || undefined}
-          disabled={!unitId || loading}
-          onChange={(event) => onToDateChange(event.target.value)}
-          className="flex h-9 w-full rounded-md border border-input bg-background px-3 py-1 text-sm shadow-sm outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50"
         />
       </label>
 
diff --git a/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/externalIncomingRecords/externalIncomingRecordsV2.tsx b/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/externalIncomingRecords/externalIncomingRecordsV2.tsx
index 1b3d6bb1e..859892524 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/externalIncomingRecords/externalIncomingRecordsV2.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/externalIncomingRecords/externalIncomingRecordsV2.tsx
@@ -2,6 +2,7 @@ import { useState, useEffect, useMemo, useCallback } from "react";
 import { DataTable } from "@/record-management/common/DataTable";
 import { Button } from "@/shared/common/ui/button";
 import { Input } from "@/shared/common/ui/input";
+import { DateRangePicker, parseDay, formatDay } from "@/shared/common/ui/date-range-picker";
 import {
   Select,
   SelectContent,
@@ -383,23 +384,13 @@ const ExternalIncomingRecords = () => {
           ) : (
             <div className="flex flex-col sm:flex-row gap-2">
               {lang.startsWith("en") ? (
-                <>
-                  <label className="mt-2">From: </label>
-                  <Input
-                    type="date"
-                    value={fromDispatchedDate}
-                    onChange={(e) => setFromDispatchedDate(e.target.value)}
-                    className="w-[150px]"
-                  />
-                  <label className="mt-2">To: </label>
-                  <Input
-                    type="date"
-                    value={toDispatchedDate}
-                    onChange={(e) => setToDispatchedDate(e.target.value)}
-                    min={fromDispatchedDate}
-                    className="w-[150px]"
-                  />
-                </>
+                <DateRangePicker
+                  value={{ from: parseDay(fromDispatchedDate), to: parseDay(toDispatchedDate) }}
+                  onChange={(range) => {
+                    setFromDispatchedDate(formatDay(range.from));
+                    setToDispatchedDate(formatDay(range.to));
+                  }}
+                />
               ) : (
                 <div className="flex flex-wrap items-center gap-3">
                   {/* From Date */}
diff --git a/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/internalIncomingRecords/internalIncomingRecordsV2.tsx b/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/internalIncomingRecords/internalIncomingRecordsV2.tsx
index b7deb4247..25cdb4056 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/internalIncomingRecords/internalIncomingRecordsV2.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/components/userIncoming/internalIncomingRecords/internalIncomingRecordsV2.tsx
@@ -2,6 +2,7 @@ import { useState, useEffect, useMemo, useCallback } from "react";
 import { DataTable } from "@/record-management/common/DataTable";
 import { Button } from "@/shared/common/ui/button";
 import { Input } from "@/shared/common/ui/input";
+import { DateRangePicker, parseDay, formatDay } from "@/shared/common/ui/date-range-picker";
 import {
   Select,
   SelectContent,
@@ -326,23 +327,13 @@ const InternalIncomingRecordsV2 = () => {
           ) : (
             <div className="flex flex-col sm:flex-row gap-2">
               {lang.startsWith("en") ? (
-                <>
-                  <label className="mt-2">From: </label>
-                  <Input
-                    type="date"
-                    value={fromDispatchedDate}
-                    onChange={(e) => setFromDispatchedDate(e.target.value)}
-                    className="w-[150px]"
-                  />
-                  <label className="mt-2">To: </label>
-                  <Input
-                    type="date"
-                    value={toDispatchedDate}
-                    onChange={(e) => setToDispatchedDate(e.target.value)}
-                    min={fromDispatchedDate}
-                    className="w-[150px]"
-                  />
-                </>
+                <DateRangePicker
+                  value={{ from: parseDay(fromDispatchedDate), to: parseDay(toDispatchedDate) }}
+                  onChange={(range) => {
+                    setFromDispatchedDate(formatDay(range.from));
+                    setToDispatchedDate(formatDay(range.to));
+                  }}
+                />
               ) : (
                 <div className="flex flex-wrap items-center gap-3">
                   {/* From Date */}
diff --git a/apps/edr-freight-web/backoffice/src/record-management/components/userRecords/userRecords.tsx b/apps/edr-freight-web/backoffice/src/record-management/components/userRecords/userRecords.tsx
index c07e3610e..30df56009 100644
--- a/apps/edr-freight-web/backoffice/src/record-management/components/userRecords/userRecords.tsx
+++ b/apps/edr-freight-web/backoffice/src/record-management/components/userRecords/userRecords.tsx
@@ -17,6 +17,7 @@ import {
 } from "@/shared/common/ui/select";
 import { Input } from "@/shared/common/ui/input";
 import { Button } from "@/shared/common/ui/button";
+import { DateRangePicker, parseDay, formatDay } from "@/shared/common/ui/date-range-picker";
 import { Badge } from "@/shared/common/ui/badge";
 import { AdvancedTable } from "@/shared/common/ui/table/AdvancedTable";
 import { useLocalizedName } from "@/shared/common/localizedName";
@@ -521,29 +522,13 @@ const UserRecords = () => {
               {selectedFilter?.type === "dateRange" ? (
                 <div className="flex flex-col sm:flex-row gap-2">
                   {lang.startsWith("en") ? (
-                    <>
-                      <label className="mt-2">From: </label>
-                      <Input
-                        type="date"
-                        value={fromDate}
-                        onChange={(e) => setFromDate(e.target.value)}
-                        onKeyDown={(e) => {
-                          if (e.key === "Enter") handleAddFilter();
-                        }}
-                        className="w-[150px]"
-                      />
-                      <label className="mt-2">To: </label>
-                      <Input
-                        type="date"
-                        value={toDate}
-                        onChange={(e) => setToDate(e.target.value)}
-                        onKeyDown={(e) => {
-                          if (e.key === "Enter") handleAddFilter();
-                        }}
-                        min={fromDate}
-                        className="w-[150px]"
-                      />
-                    </>
+                    <DateRangePicker
+                      value={{ from: parseDay(fromDate), to: parseDay(toDate) }}
+                      onChange={(range) => {
+                        setFromDate(formatDay(range.from));
+                        setToDate(formatDay(range.to));
+                      }}
+                    />
                   ) : (
                     <div className="flex flex-wrap items-center gap-3">
                       <div className="relative">
diff --git a/apps/edr-freight-web/backoffice/src/services/account.service.ts b/apps/edr-freight-web/backoffice/src/services/account.service.ts
new file mode 100644
index 000000000..40511bf79
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/account.service.ts
@@ -0,0 +1,50 @@
+import { api as client } from "../auth/http";
+import { unwrap } from "@/utils/endpoint";
+
+export type ContactChannel = "email" | "phone";
+
+export interface ChangePasswordPayload {
+  oldPassword: string;
+  newPassword: string;
+  confirmPassword: string;
+}
+
+export interface SendContactOtpPayload {
+  channel: ContactChannel;
+  /** The NEW email/phone to verify — the OTP is sent here, not to the current one. */
+  value: string;
+}
+
+export interface UpdateContactPayload extends SendContactOtpPayload {
+  otp: string;
+}
+
+export const accountService = {
+  /** PATCH /auth/change-password — generic IAM route, works for any user type. */
+  changePassword: async (payload: ChangePasswordPayload): Promise<void> => {
+    const response = await client.patch("/auth/change-password", payload);
+    unwrap(response.data);
+  },
+
+  /** POST /me/contact/otp — sends a code to the new email/phone to prove ownership. */
+  sendContactOtp: async (
+    payload: SendContactOtpPayload,
+  ): Promise<{ sentTo: string }> => {
+    const response = await client.post<{ sentTo: string }>(
+      "/me/contact/otp",
+      payload,
+    );
+    return unwrap(response.data);
+  },
+
+  /** PATCH /me/contact — verifies the OTP and writes the new email/phone. */
+  updateContact: async (
+    payload: UpdateContactPayload,
+  ): Promise<{ success: true; value: string }> => {
+    const response = await client.patch<{ success: true; value: string }>(
+      "/me/contact",
+      payload,
+    );
+    return unwrap(response.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/api.ts b/apps/edr-freight-web/backoffice/src/services/api.ts
index e3f8dbf15..57d9d56ca 100644
--- a/apps/edr-freight-web/backoffice/src/services/api.ts
+++ b/apps/edr-freight-web/backoffice/src/services/api.ts
@@ -39,10 +39,26 @@ import type {
 } from "@/types/fileUploadSettings";
 import type {
   Invoice,
+  InvoiceCollectedSummary,
   InvoiceListFilter,
   PaginatedInvoices,
+  PaginatedOfflineUsdInvoices,
 } from "@/types/invoice";
 import type { IOverviewDashboard, OverviewRange } from "@/types/overview";
+import type {
+  CreateShippingLineCompanyDto,
+  PaginatedShippingLineCompanies,
+  RegisterShippingLineCompanyResult,
+  ShippingLineCompany,
+} from "@/types/shippingLineCompany";
+import type {
+  CreditInvoicePendingAction,
+  GeneratedCreditInvoice,
+  OutstandingTotals,
+  PaginatedCreditInvoices,
+  PaginatedShippingLineCredits,
+  ShippingLineCreditStatus,
+} from "@/types/shippingLineCredit";
 import {
   RuleEngineListResult,
   RuleEngineRecord,
@@ -65,7 +81,10 @@ import type {
   LocomotiveRecord,
   PinWagonsPayload,
   RecordCheckpointPayload,
+  UpdateCheckpointPayload,
+  DispatchSchedulePayload,
   StaffBookingWindow,
+  ScheduleMergePreview,
   TrainScheduleDetail,
   TrainScheduleFilters,
   TrainScheduleListFilters,
@@ -134,6 +153,12 @@ import type {
   WarehouseZone,
 } from "@/types/warehouse";
 import { endpoint } from "@/utils/endpoint";
+import {
+  accountService,
+  type ChangePasswordPayload,
+  type SendContactOtpPayload,
+  type UpdateContactPayload,
+} from "./account.service";
 import {
   BookingListFilter,
   bookingsService,
@@ -148,6 +173,10 @@ import {
 import { containerTypesService } from "./container-types.service";
 import { containerService, type Container } from "./containerService";
 import { customersService } from "./customers.service";
+import { shippingLineCompaniesService } from "./shippingLineCompanies.service";
+import { shippingLineCreditsService } from "./shippingLineCredits.service";
+import { eimsService } from "./eims.service";
+import type { EimsInvoiceStatusView, EimsModeOfPayment, EimsReceiptView, EimsVerifyResult } from "@/types/eims";
 import { invoicesService } from "./invoices.service";
 import { dropdownSettingsService } from "./dropdownSettings.service";
 import { fileUploadSettingsService } from "./fileUploadSettings.service";
@@ -163,13 +192,8 @@ import {
   type SaveLocomotivePayload,
 } from "./locomotives.service";
 import { overviewService } from "./overview.service";
-import {
-  auditService,
-  type AuditLogListFilter,
-  type PaginatedAuditLogs,
-} from "./audit.service";
 import { reportsService } from "./reports.service";
-import type { ReportQueryInput, ReportResult } from "@/types/reports";
+import type { ReportCatalogEntry, ReportRunParams, ReportRunResult } from "@/types/reports";
 import {
   paymentsService,
   type PaginatedPayments,
@@ -260,6 +284,32 @@ const TRAIN_BUILDER_INVALIDATIONS: ReadonlyArray<readonly unknown[]> = [
   QUERY_KEYS.FLEET.ROOT,
 ];
 
+/**
+ * Coupling/uncoupling wagons moves wagons between the available pool and one
+ * train — it does not touch locomotives, so those roots stay valid. Trimming
+ * the set keeps a drag-reorder from refetching the whole fleet.
+ */
+const TRAIN_BUILDER_WAGON_INVALIDATIONS: ReadonlyArray<readonly unknown[]> = [
+  QUERY_KEYS.TRAIN_BUILDER.ROOT,
+  QUERY_KEYS.TRAIN_SCHEDULING.ROOT,
+  ["wagons"],
+];
+
+/**
+ * Every train-builder mutation responds with the train's full, fresh
+ * composition — write it straight into the detail cache so the workspace
+ * repaints from the response instead of refetching what it was just handed.
+ */
+const seedComposition = (
+  input: { id: string } | string,
+  data: TrainComposition,
+): ReadonlyArray<readonly [readonly unknown[], unknown]> => [
+  [
+    QUERY_KEYS.TRAIN_BUILDER.composition(typeof input === "string" ? input : input.id),
+    data,
+  ],
+];
+
 export const api = {
   trainScheduling: {
     // ── Queries ────────────────────────────────────────────────────────────
@@ -598,6 +648,36 @@ export const api = {
       () => TRAIN_SCHEDULING_INVALIDATIONS,
     ),
 
+    previewScheduleMerge: endpoint<
+      { id: string; targetTrainId: string },
+      ScheduleMergePreview
+    >(
+      "train-scheduling",
+      "merge-preview",
+      ({ id, targetTrainId }) =>
+        trainSchedulingService.previewScheduleMerge(id, targetTrainId),
+      ({ id, targetTrainId }) => [
+        "train-scheduling",
+        "merge-preview",
+        id,
+        targetTrainId,
+      ],
+    ),
+
+    mergeScheduleTrain: endpoint<
+      { id: string; targetTrainId: string; reason?: string },
+      TrainScheduleDetail
+    >(
+      "train-scheduling",
+      "merge-train",
+      ({ id, ...payload }) =>
+        trainSchedulingService.mergeScheduleTrain(id, payload),
+      undefined,
+      // Wagons and bookings move between trains and schedules, so the wagon and
+      // train caches are stale too — not just the scheduling ones.
+      () => [...TRAIN_SCHEDULING_INVALIDATIONS, ["wagons"], ["trains"]],
+    ),
+
     markBookingPaid: endpoint<string, void>(
       "train-scheduling",
       "mark-booking-paid",
@@ -745,10 +825,13 @@ export const api = {
       ],
     ),
 
-    dispatchSchedule: endpoint<string, TrainScheduleDetail>(
+    dispatchSchedule: endpoint<
+      { id: string; payload?: DispatchSchedulePayload },
+      TrainScheduleDetail
+    >(
       "train-scheduling",
       "dispatch-schedule",
-      (id) => trainSchedulingService.dispatchSchedule(id),
+      ({ id, payload }) => trainSchedulingService.dispatchSchedule(id, payload),
       undefined,
       () => TRAIN_SCHEDULING_INVALIDATIONS,
     ),
@@ -866,6 +949,18 @@ export const api = {
       () => TRAIN_SCHEDULING_INVALIDATIONS,
     ),
 
+    updateCheckpoint: endpoint<
+      { id: string; sequenceNo: number; payload: UpdateCheckpointPayload },
+      TrainTrackResponse
+    >(
+      "train-scheduling",
+      "update-checkpoint",
+      ({ id, sequenceNo, payload }) =>
+        trainSchedulingService.updateCheckpoint(id, sequenceNo, payload),
+      undefined,
+      () => TRAIN_SCHEDULING_INVALIDATIONS,
+    ),
+
     arriveSchedule: endpoint<string, TrainScheduleDetail>(
       "train-scheduling",
       "arrive-schedule",
@@ -2001,6 +2096,7 @@ export const api = {
         trainBuilderService.setLocomotives(id, locomotiveIds).then((r) => r.data),
       undefined,
       () => TRAIN_BUILDER_INVALIDATIONS,
+      seedComposition,
     ),
 
     setYard: endpoint<{ id: string; currentYardId: string }, TrainComposition>(
@@ -2010,6 +2106,7 @@ export const api = {
         trainBuilderService.setYard(id, currentYardId).then((r) => r.data),
       undefined,
       () => TRAIN_BUILDER_INVALIDATIONS,
+      seedComposition,
     ),
 
     updateDetails: endpoint<
@@ -2022,6 +2119,7 @@ export const api = {
         trainBuilderService.updateDetails(id, payload).then((r) => r.data),
       undefined,
       () => TRAIN_BUILDER_INVALIDATIONS,
+      seedComposition,
     ),
 
     assignWagons: endpoint<{ id: string; wagonIds: string[] }, TrainComposition>(
@@ -2030,7 +2128,21 @@ export const api = {
       ({ id, wagonIds }) =>
         trainBuilderService.assignWagons(id, wagonIds).then((r) => r.data),
       undefined,
-      () => TRAIN_BUILDER_INVALIDATIONS,
+      () => TRAIN_BUILDER_WAGON_INVALIDATIONS,
+      seedComposition,
+    ),
+
+    setWagonYard: endpoint<
+      { id: string; wagonId: string; currentYardId: string },
+      TrainComposition
+    >(
+      "train-builder",
+      "setWagonYard",
+      ({ id, wagonId, currentYardId }) =>
+        trainBuilderService.setWagonYard(id, wagonId, currentYardId).then((r) => r.data),
+      undefined,
+      () => TRAIN_BUILDER_WAGON_INVALIDATIONS,
+      seedComposition,
     ),
 
     removeWagon: endpoint<{ id: string; wagonId: string }, TrainComposition>(
@@ -2039,16 +2151,21 @@ export const api = {
       ({ id, wagonId }) =>
         trainBuilderService.removeWagon(id, wagonId).then((r) => r.data),
       undefined,
-      () => TRAIN_BUILDER_INVALIDATIONS,
+      () => TRAIN_BUILDER_WAGON_INVALIDATIONS,
+      seedComposition,
     ),
 
-    sendWagonToMaintenance: endpoint<{ id: string; wagonId: string }, TrainComposition>(
+    sendWagonToMaintenance: endpoint<
+      { id: string; wagonId: string; note?: string },
+      TrainComposition
+    >(
       "train-builder",
       "sendWagonToMaintenance",
-      ({ id, wagonId }) =>
-        trainBuilderService.sendWagonToMaintenance(id, wagonId).then((r) => r.data),
+      ({ id, wagonId, note }) =>
+        trainBuilderService.sendWagonToMaintenance(id, wagonId, note).then((r) => r.data),
       undefined,
-      () => TRAIN_BUILDER_INVALIDATIONS,
+      () => TRAIN_BUILDER_WAGON_INVALIDATIONS,
+      seedComposition,
     ),
 
     reorderWagons: endpoint<{ id: string; wagonIds: string[] }, TrainComposition>(
@@ -2057,7 +2174,8 @@ export const api = {
       ({ id, wagonIds }) =>
         trainBuilderService.reorderWagons(id, wagonIds).then((r) => r.data),
       undefined,
-      () => TRAIN_BUILDER_INVALIDATIONS,
+      () => TRAIN_BUILDER_WAGON_INVALIDATIONS,
+      seedComposition,
     ),
 
     deactivate: endpoint<string, TrainComposition>(
@@ -2066,6 +2184,7 @@ export const api = {
       (id) => trainBuilderService.deactivate(id).then((r) => r.data),
       undefined,
       () => TRAIN_BUILDER_INVALIDATIONS,
+      seedComposition,
     ),
 
     activate: endpoint<string, TrainComposition>(
@@ -2074,6 +2193,7 @@ export const api = {
       (id) => trainBuilderService.activate(id).then((r) => r.data),
       undefined,
       () => TRAIN_BUILDER_INVALIDATIONS,
+      seedComposition,
     ),
 
     disband: endpoint<string, void>(
@@ -2150,12 +2270,26 @@ export const api = {
     ),
   },
 
-  audit: {
-    list: endpoint<{ filter?: AuditLogListFilter }, PaginatedAuditLogs>(
-      "audit",
-      "list",
-      ({ filter }) => auditService.list(filter),
-      ({ filter }) => ["audit", "list", filter ?? {}],
+  account: {
+    changePassword: endpoint<ChangePasswordPayload, void>(
+      "me",
+      "change-password",
+      (payload) => accountService.changePassword(payload),
+    ),
+
+    sendContactOtp: endpoint<SendContactOtpPayload, { sentTo: string }>(
+      "me",
+      "send-contact-otp",
+      (payload) => accountService.sendContactOtp(payload),
+    ),
+
+    updateContact: endpoint<
+      UpdateContactPayload,
+      { success: true; value: string }
+    >(
+      "me",
+      "update-contact",
+      (payload) => accountService.updateContact(payload),
     ),
   },
 
@@ -2655,6 +2789,13 @@ export const api = {
       ({ id }) => QUERY_KEYS.BOOKINGS.byId(id),
     ),
 
+    referenceData: endpoint<void, Freight.BookingReferenceData>(
+      "bookings",
+      "referenceData",
+      () => bookingsService.getReferenceData() as Promise<Freight.BookingReferenceData>,
+      () => ["bookings", "reference-data"],
+    ),
+
     remove: endpoint<{ id: string }, void>("bookings", "remove", ({ id }) =>
       bookingsService.remove(id),
     ),
@@ -2740,6 +2881,160 @@ export const api = {
     ),
   },
 
+  shippingLineCompanies: {
+    list: endpoint<{ page: number; limit: number }, PaginatedShippingLineCompanies>(
+      "shippingLineCompanies",
+      "list",
+      ({ page, limit }) => shippingLineCompaniesService.list(page, limit),
+      ({ page, limit }) => QUERY_KEYS.SHIPPING_LINE_COMPANIES.list(page, limit),
+    ),
+
+    getById: endpoint<{ id: string }, ShippingLineCompany>(
+      "shippingLineCompanies",
+      "getById",
+      ({ id }) => shippingLineCompaniesService.getById(id),
+      ({ id }) => QUERY_KEYS.SHIPPING_LINE_COMPANIES.byId(id),
+    ),
+
+    register: endpoint<
+      CreateShippingLineCompanyDto,
+      RegisterShippingLineCompanyResult
+    >(
+      "shippingLineCompanies",
+      "register",
+      (dto) => shippingLineCompaniesService.register(dto),
+      undefined,
+      () => [QUERY_KEYS.SHIPPING_LINE_COMPANIES.ROOT],
+    ),
+
+    resendActivation: endpoint<
+      { id: string; channel: ResetChannel },
+      ResetPasswordResult
+    >(
+      "shippingLineCompanies",
+      "resendActivation",
+      ({ id, channel }) =>
+        shippingLineCompaniesService.resendActivation(id, channel),
+    ),
+  },
+
+  shippingLineCredits: {
+    summary: endpoint<{ shippingLineId?: string }, OutstandingTotals>(
+      "shippingLineCredits",
+      "summary",
+      ({ shippingLineId }) => shippingLineCreditsService.summary(shippingLineId),
+      ({ shippingLineId }) =>
+        QUERY_KEYS.SHIPPING_LINE_CREDITS.summary(shippingLineId),
+    ),
+
+    list: endpoint<
+      {
+        page: number;
+        pageSize: number;
+        status?: ShippingLineCreditStatus;
+        shippingLineId?: string;
+      },
+      PaginatedShippingLineCredits
+    >(
+      "shippingLineCredits",
+      "list",
+      (filter) => shippingLineCreditsService.list(filter),
+      ({ page, pageSize, status, shippingLineId }) =>
+        QUERY_KEYS.SHIPPING_LINE_CREDITS.list(
+          page,
+          pageSize,
+          status,
+          shippingLineId,
+        ),
+    ),
+
+    generateInvoice: endpoint<
+      { creditIds: string[]; dueInDays?: number },
+      GeneratedCreditInvoice
+    >(
+      "shippingLineCredits",
+      "generateInvoice",
+      ({ creditIds, dueInDays }) =>
+        shippingLineCreditsService.generateInvoice(creditIds, dueInDays),
+      undefined,
+      // Billing a batch changes ledger rows, the summary totals and (via the
+      // draft invoice) the invoices list.
+      () => [QUERY_KEYS.SHIPPING_LINE_CREDITS.ROOT, QUERY_KEYS.INVOICES.ROOT],
+    ),
+
+    listInvoices: endpoint<
+      {
+        page: number;
+        pageSize: number;
+        status?: string;
+        shippingLineId?: string;
+      },
+      PaginatedCreditInvoices
+    >(
+      "shippingLineCredits",
+      "listInvoices",
+      (filter) => shippingLineCreditsService.listInvoices(filter),
+      ({ page, pageSize, status, shippingLineId }) =>
+        QUERY_KEYS.SHIPPING_LINE_CREDITS.invoices(
+          page,
+          pageSize,
+          status,
+          shippingLineId,
+        ),
+    ),
+
+    pendingInvoiceActions: endpoint<
+      { invoiceIds: string[] },
+      CreditInvoicePendingAction[]
+    >(
+      "shippingLineCredits",
+      "pendingInvoiceActions",
+      ({ invoiceIds }) =>
+        shippingLineCreditsService.pendingInvoiceActions(invoiceIds),
+      ({ invoiceIds }) =>
+        [
+          "shipping-line-credits",
+          "pending-actions",
+          [...invoiceIds].sort().join(","),
+        ] as const,
+    ),
+
+    requestInvoiceAction: endpoint<
+      {
+        invoiceId: string;
+        action: "MARK_PAID" | "CANCEL";
+        reason: string;
+        paymentReference?: string;
+      },
+      CreditInvoicePendingAction
+    >(
+      "shippingLineCredits",
+      "requestInvoiceAction",
+      ({ invoiceId, action, reason, paymentReference }) =>
+        shippingLineCreditsService.requestInvoiceAction(
+          invoiceId,
+          action,
+          reason,
+          paymentReference,
+        ),
+      undefined,
+      () => [QUERY_KEYS.SHIPPING_LINE_CREDITS.ROOT],
+    ),
+
+    decideInvoiceAction: endpoint<
+      { approvalId: string; approve: boolean; note?: string },
+      CreditInvoicePendingAction
+    >(
+      "shippingLineCredits",
+      "decideInvoiceAction",
+      ({ approvalId, approve, note }) =>
+        shippingLineCreditsService.decideInvoiceAction(approvalId, approve, note),
+      undefined,
+      // Approving executes a billing action, so both surfaces move.
+      () => [QUERY_KEYS.SHIPPING_LINE_CREDITS.ROOT, QUERY_KEYS.INVOICES.ROOT],
+    ),
+  },
+
   customers: {
     stats: endpoint<Record<string, never>, CompanyStats>(
       "customers",
@@ -2914,6 +3209,114 @@ export const api = {
       ({ id }) => invoicesService.getById(id),
       ({ id }) => QUERY_KEYS.INVOICES.byId(id),
     ),
+
+    collectedSummary: endpoint<
+      { filter: Omit<InvoiceListFilter, "page" | "pageSize"> },
+      InvoiceCollectedSummary
+    >(
+      "invoices",
+      "collectedSummary",
+      ({ filter }) => invoicesService.collectedSummary(filter),
+      ({ filter }) => QUERY_KEYS.INVOICES.summary(filter),
+    ),
+
+    listOfflineUsd: endpoint<
+      { filter: InvoiceListFilter },
+      PaginatedOfflineUsdInvoices
+    >(
+      "invoices",
+      "listOfflineUsd",
+      ({ filter }) => invoicesService.listOfflineUsd(filter),
+      ({ filter }) => QUERY_KEYS.INVOICES.offlineUsd(filter),
+    ),
+
+    confirmOffline: endpoint<
+      { id: string; file: File; reference?: string },
+      Invoice
+    >(
+      "invoices",
+      "confirmOffline",
+      ({ id, file, reference }) =>
+        invoicesService.confirmOffline(id, file, reference),
+      undefined,
+      // Settling the invoice also advances the booking, so refresh both trees.
+      () => [QUERY_KEYS.INVOICES.ROOT, QUERY_KEYS.BOOKINGS.ROOT],
+    ),
+
+    eimsStatus: endpoint<{ id: string }, EimsInvoiceStatusView>(
+      "invoices",
+      "eimsStatus",
+      ({ id }) => eimsService.status(id),
+      ({ id }) => QUERY_KEYS.INVOICES.eimsStatus(id),
+    ),
+
+    // Both mutations refresh the filing panel; register also moves the invoice's own row.
+    eimsRegister: endpoint<{ id: string }, EimsInvoiceStatusView>(
+      "invoices",
+      "eimsRegister",
+      ({ id }) => eimsService.register(id),
+      undefined,
+      ({ id }) => [QUERY_KEYS.INVOICES.eimsStatus(id), QUERY_KEYS.INVOICES.byId(id)],
+    ),
+
+    eimsVerify: endpoint<{ id: string }, EimsVerifyResult>(
+      "invoices",
+      "eimsVerify",
+      ({ id }) => eimsService.verify(id),
+    ),
+
+    eimsResolve: endpoint<{ id: string; irn?: string; discard?: boolean }, EimsInvoiceStatusView>(
+      "invoices",
+      "eimsResolve",
+      ({ id, irn, discard }) => eimsService.resolve(id, { irn, discard }),
+      undefined,
+      ({ id }) => [QUERY_KEYS.INVOICES.eimsStatus(id), QUERY_KEYS.INVOICES.byId(id)],
+    ),
+
+    eimsCancel: endpoint<{ id: string; reasonCode: string; remark?: string }, EimsInvoiceStatusView>(
+      "invoices",
+      "eimsCancel",
+      ({ id, reasonCode, remark }) => eimsService.cancel(id, { reasonCode, remark }),
+      undefined,
+      ({ id }) => [QUERY_KEYS.INVOICES.eimsStatus(id), QUERY_KEYS.INVOICES.byId(id)],
+    ),
+
+    eimsReceipts: endpoint<{ id: string }, EimsReceiptView[]>(
+      "invoices",
+      "eimsReceipts",
+      ({ id }) => eimsService.listReceipts(id),
+      ({ id }) => QUERY_KEYS.INVOICES.eimsReceipts(id),
+    ),
+
+    eimsRegisterSalesReceipt: endpoint<
+      { id: string; modeOfPayment: EimsModeOfPayment; reason?: string; collectedAmount?: number },
+      EimsReceiptView
+    >(
+      "invoices",
+      "eimsRegisterSalesReceipt",
+      ({ id, ...input }) => eimsService.registerSalesReceipt(id, input),
+      undefined,
+      ({ id }) => [QUERY_KEYS.INVOICES.eimsReceipts(id)],
+    ),
+
+    eimsRegisterWithholdingReceipt: endpoint<
+      { id: string; type: string; preTaxAmount: number; withholdingAmount: number; reason?: string },
+      EimsReceiptView
+    >(
+      "invoices",
+      "eimsRegisterWithholdingReceipt",
+      ({ id, ...input }) => eimsService.registerWithholdingReceipt(id, input),
+      undefined,
+      ({ id }) => [QUERY_KEYS.INVOICES.eimsReceipts(id)],
+    ),
+
+    issueMemo: endpoint<{ id: string; type: "CRE" | "DEB"; reason: string }, Invoice>(
+      "invoices",
+      "issueMemo",
+      ({ id, ...input }) => invoicesService.issueMemo(id, input),
+      undefined,
+      () => [QUERY_KEYS.INVOICES.ROOT],
+    ),
   },
 
   overview: {
@@ -2925,7 +3328,10 @@ export const api = {
   },
 
   reports: {
-    run: endpoint<ReportQueryInput, ReportResult>(
+    catalog: endpoint<void, ReportCatalogEntry[]>("reports", "catalog", () =>
+      reportsService.catalog(),
+    ),
+    run: endpoint<ReportRunParams, ReportRunResult>(
       "reports",
       "run",
       (input) => reportsService.run(input),
diff --git a/apps/edr-freight-web/backoffice/src/services/audit.service.ts b/apps/edr-freight-web/backoffice/src/services/audit.service.ts
deleted file mode 100644
index ed0642d83..000000000
--- a/apps/edr-freight-web/backoffice/src/services/audit.service.ts
+++ /dev/null
@@ -1,70 +0,0 @@
-import { api as client } from "../auth/http";
-import { unwrap } from "@/utils/endpoint";
-import { URL_CONSTANTS } from "@/constants/URLS";
-
-const A = URL_CONSTANTS.AUDIT;
-
-// Shape from @tria-plc/auditlog's AuditLogCommandController — see
-// local-packages/FRONTEND_GUIDE.md.
-export type AuditQueryMethod =
-  | "INSERT"
-  | "UPDATE"
-  | "DELETE"
-  | "INSERT_CHILD"
-  | "DELETE_CHILD";
-
-export interface AuditFieldChange {
-  field: string;
-  from: unknown;
-  to: unknown;
-}
-
-// IAM entities (users, orgs, positions, ...) name themselves bilingually —
-// see edr-org.seeder.ts. Any `name`/`title` field lifted from a raw audited
-// entity (auditLog.user, payload) can come back as either a plain string or
-// this shape; both `name` fields below reflect that.
-export type LocalizedText = string | { am?: string; en?: string };
-
-// The vendored interceptor's own broken template produces a plain string
-// ("undefined  undefined") when no user was attached at all (unauthenticated/
-// customer flows) — that's the non-bilingual string case for `name` here.
-export interface AuditUser {
-  id?: string;
-  name?: LocalizedText;
-  organizationId?: string;
-  organizationName?: string;
-  [key: string]: unknown;
-}
-
-export interface AuditLogRow {
-  id?: string;
-  createdAt: string;
-  deletedAt?: string | null;
-  entityName: string;
-  queryMethod: AuditQueryMethod;
-  changes?: AuditFieldChange[] | null;
-  payload?: { name?: LocalizedText; title?: LocalizedText; id?: string } | null;
-  auditLog?: { id?: string; user?: AuditUser | null };
-}
-
-export interface AuditLogListFilter {
-  skip?: number;
-  take?: number;
-}
-
-export interface PaginatedAuditLogs {
-  items: AuditLogRow[];
-  count: number;
-}
-
-export const auditService = {
-  list: async (filter?: AuditLogListFilter): Promise<PaginatedAuditLogs> => {
-    const params: Record<string, number | undefined> = {
-      skip: filter?.skip,
-      take: filter?.take,
-    };
-    const response = await client.get<PaginatedAuditLogs>(A.LOGS, { params });
-    const data = unwrap(response.data) as PaginatedAuditLogs;
-    return { items: data.items ?? [], count: data.count ?? 0 };
-  },
-};
diff --git a/apps/edr-freight-web/backoffice/src/services/auditLogs.service.ts b/apps/edr-freight-web/backoffice/src/services/auditLogs.service.ts
new file mode 100644
index 000000000..d52a60382
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/auditLogs.service.ts
@@ -0,0 +1,97 @@
+import type { PaginatedResponse } from "@edr/types";
+
+import { api as client } from "../auth/http";
+import { unwrap } from "@/utils/endpoint";
+import { URL_CONSTANTS } from "@/constants/URLS";
+import type { ApiResponse } from "@/types/apiResponse";
+
+const BASE = URL_CONSTANTS.AUDIT_LOGS.BASE;
+
+/** Methods the audit trail records. Reads are never audited. */
+export const AUDIT_METHODS = ["POST", "PUT", "PATCH", "DELETE"] as const;
+export type AuditMethod = (typeof AUDIT_METHODS)[number];
+
+/**
+ * One recorded backoffice action.
+ *
+ * Mirrors `AuditLog` in the freight API. `userName` / `userRole` are snapshots
+ * taken when the action happened, not live lookups — an old row keeps the name
+ * and role the actor had at the time.
+ */
+export interface AuditLog {
+  id: string;
+  /** Readable action, e.g. "Approve contract". */
+  title: string;
+  method: AuditMethod;
+  /** URL as called, query string included (secrets already redacted server-side). */
+  url: string;
+  /** Route template, e.g. `/api/contracts/:id/cancel`. */
+  routePath: string | null;
+  /** Entity the action touched, e.g. "Contract". */
+  type: string;
+  isSuccess: boolean;
+  statusCode: number | null;
+  errorMessage: string | null;
+  userId: string | null;
+  userName: string | null;
+  userRole: string | null;
+  resourceId: string | null;
+  /** Sanitized request body; files appear as `__file` descriptors. */
+  request: Record<string, unknown> | null;
+  ipAddress: string | null;
+  userAgent: string | null;
+  requestId: string | null;
+  durationMs: number | null;
+  createdAt: string;
+}
+
+export interface AuditLogQuery {
+  page?: number;
+  pageSize?: number;
+  type?: string;
+  userId?: string;
+  method?: AuditMethod;
+  resourceId?: string;
+  /** Omit for "any outcome". */
+  isSuccess?: boolean;
+  /** Inclusive ISO 8601 bounds. */
+  from?: string;
+  to?: string;
+}
+
+/**
+ * Drop empty filters so the request carries only what the user actually set —
+ * an empty string would otherwise be sent and fail the API's validation.
+ */
+function toParams(query: AuditLogQuery): Record<string, string | number> {
+  const params: Record<string, string | number> = {};
+
+  if (query.page) params.page = query.page;
+  if (query.pageSize) params.pageSize = query.pageSize;
+  if (query.type) params.type = query.type;
+  if (query.userId) params.userId = query.userId;
+  if (query.method) params.method = query.method;
+  if (query.resourceId) params.resourceId = query.resourceId;
+  if (query.isSuccess !== undefined) params.isSuccess = String(query.isSuccess);
+  if (query.from) params.from = query.from;
+  if (query.to) params.to = query.to;
+
+  return params;
+}
+
+export const auditLogsService = {
+  /** Paginated audit history, newest first. */
+  list: async (query: AuditLogQuery = {}): Promise<PaginatedResponse<AuditLog>> => {
+    const response = await client.get<ApiResponse<PaginatedResponse<AuditLog>>>(
+      `${BASE}/logs`,
+      { params: toParams(query) },
+    );
+    return unwrap(response.data);
+  },
+
+  /** Distinct entity types present, for the filter dropdown. */
+  types: async (): Promise<string[]> => {
+    const response = await client.get<ApiResponse<string[]>>(`${BASE}/types`);
+    return unwrap(response.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/bookings.service.ts b/apps/edr-freight-web/backoffice/src/services/bookings.service.ts
index 946a921b7..f2b6c3de6 100644
--- a/apps/edr-freight-web/backoffice/src/services/bookings.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/bookings.service.ts
@@ -6,6 +6,35 @@ import type { Freight } from "@edr/types";
 
 const B = URL_CONSTANTS.BOOKINGS;
 
+/**
+ * One shared-wagon approval. Covers BOTH bookings on the wagon — the pair is
+ * decided as a unit, never one side at a time.
+ */
+export interface ConsolidationApprovalRow {
+  id: string;
+  bookingId: string;
+  partnerBookingId: string;
+  status: "PENDING" | "APPROVED" | "REJECTED";
+  requestedBy?: string | null;
+  requestedAt: string;
+  decidedBy?: string | null;
+  decidedAt?: string | null;
+  decisionNote?: string | null;
+  scheduledDate?: string | null;
+  bookingReference?: string | null;
+  partnerBookingReference?: string | null;
+  booking?: {
+    id: string;
+    reference?: string;
+    company?: { name?: string } | null;
+  } | null;
+  partnerBooking?: {
+    id: string;
+    reference?: string;
+    company?: { name?: string } | null;
+  } | null;
+}
+
 export interface BookingListFilter {
   status?: string;
   /** Comma-separated statuses for grouped tabs */
@@ -16,7 +45,11 @@ export interface BookingListFilter {
   tab?: string;
   // customerId?: string;
   companyId?: string;
+  /** Bookings drawn down under this contract (contract detail's Shipments tab). */
+  contractId?: string;
   freightType?: string;
+  /** Service type (rule-engine service_types.id). */
+  serviceTypeId?: string;
   /** ONE_TIME | GENERAL_CONTRACT — the booking-kind tab filter. */
   bookingType?: string;
   /** 'true' → customs bookings, 'false' → self-clearance (non-customs). */
@@ -34,6 +67,8 @@ export interface BookingListFilter {
   scheduledTo?: string;
   originYardId?: string;
   destinationYardId?: string;
+  /** SHIPPING_LINE = booked by a shipping line; CUSTOMER = ordinary customer company. */
+  customerKind?: "SHIPPING_LINE" | "CUSTOMER";
   /** "true" = government bookings only, "false" = private only. */
   isGovernment?: "true" | "false";
   /** Free-text search: booking reference, customer name, contract reference (server-side). */
@@ -111,11 +146,14 @@ export interface ConsolidationDetails {
   splitBilling: { bookingShare: number; partnerShare: number } | null;
 }
 
+/**
+ * No stamp field: the backoffice only ever signs as STAFF, and EDR's seal is
+ * the ONE global company stamp applied server-side. Customer stamps are posted
+ * from the portal, not here.
+ */
 export interface SignContractPayload {
   role: "CUSTOMER" | "STAFF";
   signatureImageBase64: string;
-  /** Company stamp/seal image; the API requires one for CUSTOMER and STAFF. */
-  stampImageBase64?: string;
   signerDisplayName: string;
   consentText?: string;
 }
@@ -135,6 +173,7 @@ export const bookingsService = {
       if (filter.pageSize != null) params.pageSize = filter.pageSize;
       if (filter.companyId) params.companyId = filter.companyId;
       if (filter.freightType) params.freightType = filter.freightType;
+      if (filter.serviceTypeId) params.serviceTypeId = filter.serviceTypeId;
       if (filter.bookingType) params.bookingType = filter.bookingType;
       if (filter.tradeDirection) params.tradeDirection = filter.tradeDirection;
       if (filter.paymentCurrency) params.paymentCurrency = filter.paymentCurrency;
@@ -146,6 +185,7 @@ export const bookingsService = {
       if (filter.originYardId) params.originYardId = filter.originYardId;
       if (filter.destinationYardId) params.destinationYardId = filter.destinationYardId;
       if (filter.isGovernment) params.isGovernment = filter.isGovernment;
+      if (filter.customerKind) params.customerKind = filter.customerKind;
     }
     const response = await client.get<BookingListSummary>(B.LIST_SUMMARY, {
       params,
@@ -166,7 +206,9 @@ export const bookingsService = {
       if (filter.schedulingStatuses) params.schedulingStatuses = filter.schedulingStatuses;
       if (filter.assignedToSchedule) params.assignedToSchedule = filter.assignedToSchedule;
       if (filter.companyId) params.companyId = filter.companyId;
+      if (filter.contractId) params.contractId = filter.contractId;
       if (filter.freightType) params.freightType = filter.freightType;
+      if (filter.serviceTypeId) params.serviceTypeId = filter.serviceTypeId;
       if (filter.bookingType) params.bookingType = filter.bookingType;
       if (filter.tradeDirection) params.tradeDirection = filter.tradeDirection;
       if (filter.paymentCurrency) params.paymentCurrency = filter.paymentCurrency;
@@ -178,6 +220,7 @@ export const bookingsService = {
       if (filter.originYardId) params.originYardId = filter.originYardId;
       if (filter.destinationYardId) params.destinationYardId = filter.destinationYardId;
       if (filter.isGovernment) params.isGovernment = filter.isGovernment;
+      if (filter.customerKind) params.customerKind = filter.customerKind;
       if (filter.customsClearingEnabled)
         params.customsClearingEnabled = filter.customsClearingEnabled;
       if (filter.search) params.search = filter.search;
@@ -313,6 +356,60 @@ export const bookingsService = {
   cancel: (id: string, reason: string) =>
     postBooking<BookingDetail>(B.CANCEL(id), { reason }),
 
+  // ── Shared-wagon approval gate ──────────────────────────────────────────
+
+  /** Pairings awaiting a decision, oldest first. */
+  consolidationApprovalQueue: async (): Promise<ConsolidationApprovalRow[]> => {
+    const response = await client.get(B.CONSOLIDATION_APPROVAL_QUEUE);
+    return (unwrap(response.data) ?? []) as ConsolidationApprovalRow[];
+  },
+
+  /** Decision history for one booking's shared wagon — who, when, and why. */
+  consolidationApprovalHistory: async (
+    bookingId: string,
+  ): Promise<ConsolidationApprovalRow[]> => {
+    const response = await client.get(
+      B.CONSOLIDATION_APPROVAL_HISTORY(bookingId),
+    );
+    return (unwrap(response.data) ?? []) as ConsolidationApprovalRow[];
+  },
+
+  /** Approve: both bookings leave the gate and continue to Operations. */
+  approveConsolidation: async (approvalId: string, note?: string) => {
+    const response = await client.post(B.CONSOLIDATION_APPROVE(approvalId), {
+      note,
+    });
+    return unwrap(response.data);
+  },
+
+  /** Reject: both bookings go back to GL for changes with the reason. */
+  rejectConsolidation: async (approvalId: string, reason: string) => {
+    const response = await client.post(B.CONSOLIDATION_REJECT(approvalId), {
+      reason,
+    });
+    return unwrap(response.data);
+  },
+
+  /**
+   * Apply one staff decision to BOTH halves of a consolidated pair. The two
+   * bookings share a wagon, so they advance or cancel together — all-or-nothing
+   * on the server. Each half keeps its own invoice and payment.
+   */
+  pairedDecision: async (
+    id: string,
+    decision: "accept" | "cancel" | "operationAccept" | "requestChanges",
+    options: { reason?: string; note?: string; validityDays?: number } = {},
+  ): Promise<{ booking: BookingDetail; partner: BookingDetail }> => {
+    const response = await client.post(B.PAIRED_DECISION(id), {
+      decision,
+      ...options,
+    });
+    return unwrap(response.data) as {
+      booking: BookingDetail;
+      partner: BookingDetail;
+    };
+  },
+
   create: async (payload: Record<string, unknown>): Promise<BookingDetail> => {
     const response = await client.post<{ booking: BookingDetail } | BookingDetail>(
       B.BASE,
@@ -335,6 +432,77 @@ export const bookingsService = {
     return unwrap(response.data) as Freight.ClearanceView;
   },
 
+  /** Clearance action history — reviews, workflow steps, charges (newest first). */
+  getClearanceHistory: async (
+    id: string,
+  ): Promise<Freight.ClearanceHistoryEvent[]> => {
+    const response = await client.get(`/bookings/${id}/clearance/history`);
+    return unwrap(response.data) as Freight.ClearanceHistoryEvent[];
+  },
+
+  // ── Clearance charges (post-finalization customer billing) ──
+  getClearanceCharges: async (id: string): Promise<Freight.ClearanceCharge[]> => {
+    const response = await client.get(`/bookings/${id}/clearance/charges`);
+    return unwrap(response.data) as Freight.ClearanceCharge[];
+  },
+
+  /** GL Djibouti uploads (or replaces, until billed) the port-charges document. */
+  uploadPortChargeDocument: async (
+    id: string,
+    file: File,
+  ): Promise<Freight.ClearanceCharge[]> => {
+    const form = new FormData();
+    form.append("file", file);
+    const response = await client.post(
+      `/bookings/${id}/clearance/charges/port-document`,
+      form,
+      { headers: { "Content-Type": "multipart/form-data" } },
+    );
+    return unwrap(response.data) as Freight.ClearanceCharge[];
+  },
+
+  /** GL Ethiopia sets or revises a charge's amount + currency. */
+  billClearanceCharge: async (
+    id: string,
+    chargeId: string,
+    payload: { amount: number; currency: string },
+  ): Promise<Freight.ClearanceCharge[]> => {
+    const response = await client.patch(
+      `/bookings/${id}/clearance/charges/${chargeId}/bill`,
+      payload,
+    );
+    return unwrap(response.data) as Freight.ClearanceCharge[];
+  },
+
+  /** GL Ethiopia issues the charge's payable invoice to the customer. */
+  sendClearanceCharge: async (
+    id: string,
+    chargeId: string,
+  ): Promise<Freight.ClearanceCharge[]> => {
+    const response = await client.post(
+      `/bookings/${id}/clearance/charges/${chargeId}/send`,
+    );
+    return unwrap(response.data) as Freight.ClearanceCharge[];
+  },
+
+  /** GL Ethiopia creates the miscellaneous charge (document + amount + currency). */
+  createMiscellaneousCharge: async (
+    id: string,
+    file: File,
+    payload: { amount: number; currency: string },
+  ): Promise<Freight.ClearanceCharge[]> => {
+    const form = new FormData();
+    form.append("file", file);
+    form.append("amount", String(payload.amount));
+    form.append("currency", payload.currency);
+    const response = await client.post(
+      `/bookings/${id}/clearance/charges/miscellaneous`,
+      form,
+      { headers: { "Content-Type": "multipart/form-data" } },
+    );
+    return unwrap(response.data) as Freight.ClearanceCharge[];
+  },
+
   /** GL ET asks Djibouti to name the officer handling the shipment in transit. */
   requestTransitAssignee: (id: string, note?: string) =>
     postBooking<BookingDetail>(B.CLEARANCE_TRANSIT_ASSIGNEE_REQUEST(id), {
@@ -420,11 +588,11 @@ export const bookingsService = {
 
   uploadDeliveryOrder: async (
     id: string,
-    file: File,
+    files: File[],
     dates: { vesselArrivalDate: string; doCollectedDate: string },
   ): Promise<BookingDetail> => {
     const form = new FormData();
-    form.append("file", file);
+    files.forEach((file) => form.append("files", file));
     form.append("vesselArrivalDate", dates.vesselArrivalDate);
     form.append("doCollectedDate", dates.doCollectedDate);
     const response = await client.post(B.CLEARANCE_DELIVERY_ORDER(id), form, {
@@ -435,11 +603,11 @@ export const bookingsService = {
 
   uploadReleaseOrder: async (
     id: string,
-    file: File,
+    files: File[],
     vesselDepartureDate: string,
   ): Promise<{ hold?: boolean; holdReason?: string }> => {
     const form = new FormData();
-    form.append("file", file);
+    files.forEach((file) => form.append("files", file));
     form.append("vesselDepartureDate", vesselDepartureDate);
     const response = await client.post(B.CLEARANCE_RELEASE_ORDER(id), form, {
       headers: { "Content-Type": "multipart/form-data" },
@@ -458,6 +626,13 @@ export const bookingsService = {
     return (unwrap(response.data) ?? []) as BookingDetail[];
   },
 
+  setExportHandoverMode: async (
+    id: string,
+    exportHandoverMode: "DIRECT_TO_TRAIN" | "WAREHOUSE",
+  ): Promise<void> => {
+    await client.patch(B.EXPORT_HANDOVER_MODE(id), { exportHandoverMode });
+  },
+
   downloadCarriageAcceptanceSheet: async (id: string): Promise<Blob> => {
     const response = await client.get(B.CARRIAGE_ACCEPTANCE_SHEET(id), {
       responseType: "blob",
diff --git a/apps/edr-freight-web/backoffice/src/services/contract-templates.service.ts b/apps/edr-freight-web/backoffice/src/services/contract-templates.service.ts
index 267ee113a..f283b8af3 100644
--- a/apps/edr-freight-web/backoffice/src/services/contract-templates.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/contract-templates.service.ts
@@ -2,6 +2,10 @@ import { api as client } from "../auth/http";
 
 const BASE = "/contract-templates";
 
+export const BULK_TEMPLATE_DIRECTIONS = ["IMPORT", "EXPORT", "INTERCITY"] as const;
+
+export type BulkTemplateDirection = (typeof BULK_TEMPLATE_DIRECTIONS)[number];
+
 export interface ContractTemplateArticle {
   id: string;
   title: string;
@@ -11,29 +15,40 @@ export interface ContractTemplateArticle {
 
 export interface ContractTemplate {
   id: string;
-  // Import/export split by customs clearing; intercity is domestic, crosses no
-  // border, and so has a single template.
-  code:
-    | "IMPORT_BULK_CUSTOMS"
-    | "IMPORT_BULK_NO_CUSTOMS"
-    | "EXPORT_BULK_CUSTOMS"
-    | "EXPORT_BULK_NO_CUSTOMS"
-    | "INTERCITY_BULK"
-    | "IMPORT_CONTAINER_CUSTOMS"
-    | "IMPORT_CONTAINER_NO_CUSTOMS"
-    | "EXPORT_CONTAINER_CUSTOMS"
-    | "EXPORT_CONTAINER_NO_CUSTOMS"
-    | "INTERCITY_CONTAINER";
+  // System container templates use the fixed DIRECTION_CONTAINER(_CUSTOMS)
+  // codes; staff-created bulk templates get generated BULK_<cargo>_* codes.
+  code: string;
   name: string;
   description?: string | null;
   documentTitle: string;
   whereasClauses: string[];
   articles: ContractTemplateArticle[];
   isActive: boolean;
+  /** Bulk templates only: the cargo type this template is written for. */
+  cargoTypeId?: string | null;
+  cargoType?: { id: string; cargoTypeName: string } | null;
+  /** Bulk templates only: IMPORT, EXPORT or INTERCITY. */
+  tradeDirection?: BulkTemplateDirection | null;
+  /**
+   * Bulk templates only: whether this is the with-customs-clearing variant.
+   * Null for intercity — domestic movements have no customs leg.
+   */
+  withCustoms?: boolean | null;
+  /** The five seeded container templates — cannot be deleted. */
+  isSystem: boolean;
   createdAt: string;
   updatedAt: string;
 }
 
+export interface CreateContractTemplatePayload {
+  cargoTypeId: string;
+  tradeDirection: BulkTemplateDirection;
+  /** Omitted for INTERCITY — the API rejects the flag there. */
+  withCustoms?: boolean;
+  name?: string;
+  description?: string;
+}
+
 export interface UpdateContractTemplatePayload {
   name?: string;
   description?: string;
@@ -54,6 +69,15 @@ export const contractTemplatesService = {
     return data;
   },
 
+  async create(payload: CreateContractTemplatePayload): Promise<ContractTemplate> {
+    const { data } = await client.post<ContractTemplate>(BASE, payload);
+    return data;
+  },
+
+  async remove(code: string): Promise<void> {
+    await client.delete(`${BASE}/${code}`);
+  },
+
   async getByCode(code: string): Promise<ContractTemplate> {
     const { data } = await client.get<ContractTemplate>(`${BASE}/${code}`);
     return data;
diff --git a/apps/edr-freight-web/backoffice/src/services/contracts.service.ts b/apps/edr-freight-web/backoffice/src/services/contracts.service.ts
index 37971cb96..7303ef977 100644
--- a/apps/edr-freight-web/backoffice/src/services/contracts.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/contracts.service.ts
@@ -13,6 +13,8 @@ export interface ContractListFilter {
   tab?: string;
   companyId?: string;
   freightType?: string;
+  /** Service type (rule-engine service_types.id). */
+  serviceTypeId?: string;
   tradeDirection?: string;
   contractKind?: string;
   paymentCurrency?: string;
@@ -71,6 +73,32 @@ export interface ShipmentValidation {
   totalAmount?: number;
 }
 
+/**
+ * A booking GL may pick as the shared-wagon partner of an odd-20ft customs
+ * booking. `hasCargo` is false for a bare instance whose containers GL still
+ * enters on the split completion form.
+ */
+export interface ConsolidationCandidate {
+  id: string;
+  reference: string;
+  contractId: string | null;
+  companyName: string | null;
+  status: string;
+  tradeDirection: string | null;
+  originYardId: string | null;
+  destinationYardId: string | null;
+  scheduledDate: string | null;
+  ft20Quantity: number;
+  hasCargo: boolean;
+}
+
+/** Both halves of a shared-wagon completion, each with its own full payload. */
+export interface CompleteConsolidatedPairPayload {
+  partnerBookingId: string;
+  booking: Freight.CreateBookingUnderContractDto;
+  partner: Freight.CreateBookingUnderContractDto;
+}
+
 export interface ContractListSummaryMetrics {
   inQueue: number;
   needsAction: number;
@@ -91,6 +119,13 @@ export interface ContractListSummaryTabs {
 export interface ContractListSummary {
   metrics: ContractListSummaryMetrics;
   tabs: ContractListSummaryTabs;
+  /**
+   * Per-column value counts for the filter bar's enum popovers, scoped to
+   * every OTHER currently-active filter. Optional: pages built before the
+   * pill filter bar don't read it, and it degrades gracefully — an absent
+   * key just means that popover shows no counts.
+   */
+  facets?: Record<string, { value: string; count: number }[]>;
 }
 
 export interface ContractView {
@@ -118,11 +153,14 @@ export interface ContractView {
   } | null;
 }
 
+/**
+ * No stamp field: the backoffice only ever counter-signs as STAFF, and EDR's
+ * seal is the ONE global company stamp, snapshotted server-side from
+ * StampSettingsService when the signature is stored.
+ */
 export interface SignContractPayload {
   role: "CUSTOMER" | "STAFF";
   signatureImageBase64: string;
-  /** Company stamp/seal image; required to sign a contract. */
-  stampImageBase64?: string;
   signerDisplayName: string;
   consentText?: string;
 }
@@ -161,6 +199,7 @@ function buildListParams(filter?: ContractListFilter) {
     if (filter.sortOrder) params.sortOrder = filter.sortOrder;
     if (filter.companyId) params.companyId = filter.companyId;
     if (filter.freightType) params.freightType = filter.freightType;
+    if (filter.serviceTypeId) params.serviceTypeId = filter.serviceTypeId;
     if (filter.tradeDirection) params.tradeDirection = filter.tradeDirection;
     if (filter.contractKind) params.contractKind = filter.contractKind;
     if (filter.paymentCurrency) params.paymentCurrency = filter.paymentCurrency;
@@ -468,11 +507,11 @@ export const contractsService = {
 
   uploadDeliveryOrder: async (
     id: string,
-    file: File,
+    files: File[],
     dates: { vesselArrivalDate: string; doCollectedDate: string },
   ): Promise<Freight.IContract> => {
     const form = new FormData();
-    form.append("file", file);
+    files.forEach((file) => form.append("files", file));
     form.append("vesselArrivalDate", dates.vesselArrivalDate);
     form.append("doCollectedDate", dates.doCollectedDate);
     const response = await client.post(C.CLEARANCE_DELIVERY_ORDER(id), form, {
@@ -483,11 +522,11 @@ export const contractsService = {
 
   uploadReleaseOrder: async (
     id: string,
-    file: File,
+    files: File[],
     vesselDepartureDate: string,
   ): Promise<{ contract: Freight.IContract; hold: boolean; holdReason?: string }> => {
     const form = new FormData();
-    form.append("file", file);
+    files.forEach((file) => form.append("files", file));
     form.append("vesselDepartureDate", vesselDepartureDate);
     const response = await client.post(C.CLEARANCE_RELEASE_ORDER(id), form, {
       headers: { "Content-Type": "multipart/form-data" },
@@ -664,6 +703,46 @@ export const contractsService = {
     };
   },
 
+  /**
+   * Bookings GL may link to an odd-20ft customs booking as its shared-wagon
+   * partner (same route and direction, customs, odd 20ft, not already paired).
+   */
+  listConsolidationCandidates: async (
+    id: string,
+    bookingId: string,
+  ): Promise<ConsolidationCandidate[]> => {
+    const response = await client.get(
+      C.CONSOLIDATION_CANDIDATES(id, bookingId),
+    );
+    return (unwrap(response.data) ?? []) as ConsolidationCandidate[];
+  },
+
+  /**
+   * Complete an odd-20ft booking together with the partner booking sharing its
+   * wagon. All-or-nothing on the server: either both bookings complete and are
+   * linked, or neither does. Each booking keeps its own price and its own
+   * invoice — only the wagon is shared.
+   */
+  completeConsolidatedPair: async (
+    id: string,
+    bookingId: string,
+    payload: CompleteConsolidatedPairPayload,
+  ): Promise<{
+    booking: { id: string; reference: string };
+    partner: { id: string; reference: string };
+    warnings?: string[];
+  }> => {
+    const response = await client.post(
+      C.BOOKINGS_COMPLETE_CONSOLIDATED(id, bookingId),
+      payload,
+    );
+    return unwrap(response.data) as {
+      booking: { id: string; reference: string };
+      partner: { id: string; reference: string };
+      warnings?: string[];
+    };
+  },
+
   /**
    * Pre-create validation + authoritative price preview: the same
    * BookingPricingService pass that prices the booking on create (rail +
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 eb86dd752..5b3cc4527 100644
--- a/apps/edr-freight-web/backoffice/src/services/customers.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/customers.service.ts
@@ -24,7 +24,7 @@ const cleanParams = (params: object) =>
     ),
   );
 
-/** Lift attributes JSONB into the flat contact/manager fields the UI reads. */
+/** Lift attributes JSONB into the flat contact/owner fields the UI reads. */
 function mapCompany(dto: Record<string, unknown>): Company {
   const attrs = (dto.attributes as Record<string, unknown> | null) ?? {};
   return {
@@ -32,9 +32,9 @@ function mapCompany(dto: Record<string, unknown>): Company {
     companyProfiles: (dto.companyProfiles as Company["companyProfiles"]) ?? [],
     contactPersonName: (attrs.contactPersonName as string | null) ?? null,
     contactPersonPhone: (attrs.contactPersonPhone as string | null) ?? null,
-    generalManagerName: (attrs.generalManagerName as string | null) ?? null,
-    generalManagerEmail: (attrs.generalManagerEmail as string | null) ?? null,
-    generalManagerPhone: (attrs.generalManagerPhone as string | null) ?? null,
+    ownerName: (attrs.ownerName as string | null) ?? null,
+    ownerEmail: (attrs.ownerEmail as string | null) ?? null,
+    ownerPhone: (attrs.ownerPhone as string | null) ?? null,
     poaName: (attrs.poaName as string | null) ?? null,
     poaEmail: (attrs.poaEmail as string | null) ?? null,
     poaPhone: (attrs.poaPhone as string | null) ?? null,
diff --git a/apps/edr-freight-web/backoffice/src/services/eims.service.ts b/apps/edr-freight-web/backoffice/src/services/eims.service.ts
new file mode 100644
index 000000000..610ed4920
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/eims.service.ts
@@ -0,0 +1,85 @@
+import { api as apiClient } from "@/auth/http";
+import { URL_CONSTANTS } from "@/constants/URLS";
+import type {
+  EimsInvoiceStatusView,
+  EimsModeOfPayment,
+  EimsReceiptView,
+  EimsVerifyResult,
+} from "@/types/eims";
+
+/**
+ * MoR EIMS filing actions on an invoice.
+ *
+ * Registration is irreversible at the tax authority, so these are admin actions rather than part
+ * of the ordinary invoice screen: the normal production path is the API's cron sweep.
+ */
+export const eimsService = {
+  status(invoiceId: string): Promise<EimsInvoiceStatusView> {
+    return apiClient
+      .get<EimsInvoiceStatusView>(URL_CONSTANTS.EIMS.STATUS(invoiceId))
+      .then((r) => r.data);
+  },
+
+  register(invoiceId: string): Promise<EimsInvoiceStatusView> {
+    return apiClient
+      .post<EimsInvoiceStatusView>(URL_CONSTANTS.EIMS.REGISTER(invoiceId))
+      .then((r) => r.data);
+  },
+
+  verify(invoiceId: string): Promise<EimsVerifyResult> {
+    return apiClient
+      .post<EimsVerifyResult>(URL_CONSTANTS.EIMS.VERIFY(invoiceId))
+      .then((r) => r.data);
+  },
+
+  /** Record an IRN confirmed with MoR, or discard the attempt. Clears the system-wide block. */
+  resolve(
+    invoiceId: string,
+    input: { irn?: string; discard?: boolean },
+  ): Promise<EimsInvoiceStatusView> {
+    return apiClient
+      .post<EimsInvoiceStatusView>(URL_CONSTANTS.EIMS.RESOLVE(invoiceId), input)
+      .then((r) => r.data);
+  },
+
+  /** Cancel the invoice's registered EIMS document. Refuses (409) an already-cancelled one. */
+  cancel(
+    invoiceId: string,
+    input: { reasonCode: string; remark?: string },
+  ): Promise<EimsInvoiceStatusView> {
+    return apiClient
+      .post<EimsInvoiceStatusView>(URL_CONSTANTS.EIMS.CANCEL(invoiceId), input)
+      .then((r) => r.data);
+  },
+
+  registerSalesReceipt(
+    invoiceId: string,
+    input: { modeOfPayment: EimsModeOfPayment; reason?: string; collectedAmount?: number },
+  ): Promise<EimsReceiptView> {
+    return apiClient
+      .post<EimsReceiptView>(URL_CONSTANTS.EIMS.RECEIPT_SALES(invoiceId), input)
+      .then((r) => r.data);
+  },
+
+  registerWithholdingReceipt(
+    invoiceId: string,
+    input: { type: string; preTaxAmount: number; withholdingAmount: number; reason?: string },
+  ): Promise<EimsReceiptView> {
+    return apiClient
+      .post<EimsReceiptView>(URL_CONSTANTS.EIMS.RECEIPT_WITHHOLDING(invoiceId), input)
+      .then((r) => r.data);
+  },
+
+  listReceipts(invoiceId: string): Promise<EimsReceiptView[]> {
+    return apiClient
+      .get<EimsReceiptView[]>(URL_CONSTANTS.EIMS.RECEIPTS(invoiceId))
+      .then((r) => r.data);
+  },
+
+  /** Blob download — same pattern as `invoicesService.downloadDocument`. */
+  downloadReceiptDocument(invoiceId: string, receiptId: string) {
+    return apiClient.get<Blob>(URL_CONSTANTS.EIMS.RECEIPT_DOCUMENT(invoiceId, receiptId), {
+      responseType: "blob",
+    });
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/files.service.ts b/apps/edr-freight-web/backoffice/src/services/files.service.ts
index 038b5a86d..c86a3beb4 100644
--- a/apps/edr-freight-web/backoffice/src/services/files.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/files.service.ts
@@ -25,6 +25,53 @@ export async function downloadBookingFile(
   URL.revokeObjectURL(url);
 }
 
+/**
+ * Open a stored file in its own browser tab.
+ *
+ * Two things make this less trivial than an `<a target="_blank">`:
+ * - `GET /files/:id` is authenticated, so the bytes have to come through the
+ *   axios client and be handed over as a blob URL (same reason as
+ *   {@link fetchViewableFile}).
+ * - The tab therefore has to be opened *synchronously*, inside the click
+ *   gesture, and filled once the download resolves — a `window.open()` after an
+ *   `await` is blocked as a popup. That also means a loop over several
+ *   documents opens one tab each, all within the same gesture.
+ *
+ * `noopener` is deliberately not passed: it makes `window.open` return null, and
+ * the handle is what lets us navigate the tab. `opener` is nulled instead.
+ */
+export function openFileInNewTab(id: string, filename: string): void {
+  const tab = window.open("", "_blank");
+  if (tab) {
+    tab.opener = null;
+    tab.document.title = filename;
+    if (tab.document.body) {
+      tab.document.body.textContent = `Opening ${filename}…`;
+    }
+  }
+  void filesService.download(id).then(
+    (blob) => {
+      const url = URL.createObjectURL(blob);
+      if (tab) tab.location.replace(url);
+      // Popup blocked — fall back to a save, so the click still does something.
+      else {
+        const a = document.createElement("a");
+        a.href = url;
+        a.download = filename;
+        a.click();
+      }
+      // Revoking immediately would cancel the tab's own load of the URL.
+      setTimeout(() => URL.revokeObjectURL(url), 60_000);
+    },
+    (error: unknown) => {
+      if (tab?.document.body) {
+        tab.document.body.textContent = `Could not open ${filename}.`;
+      }
+      console.error(`Failed to open file ${id}`, error);
+    },
+  );
+}
+
 /**
  * GET /files/:id is authenticated (global JwtGuard) — raw browser loads
  * (<img>/<iframe>/<a href>) carry no Bearer token and 401. Fetch the bytes
diff --git a/apps/edr-freight-web/backoffice/src/services/importOperations.service.ts b/apps/edr-freight-web/backoffice/src/services/importOperations.service.ts
index 1025cd417..308388379 100644
--- a/apps/edr-freight-web/backoffice/src/services/importOperations.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/importOperations.service.ts
@@ -5,6 +5,7 @@ import type {
   AssignCustomsRiskPayload,
   CreateDjiboutiIncidentPayload,
   CreateEmptyContainerReturnPayload,
+  LoadEmptyContainersOnTrainPayload,
   DjiboutiIncident,
   EmptyContainerReturn,
   ImportCustomsFinalization,
@@ -123,6 +124,16 @@ export const importOperationsService = {
     return unwrap(response.data);
   },
 
+  loadEmptyContainersOnTrain: async (
+    payload: LoadEmptyContainersOnTrainPayload,
+  ): Promise<EmptyContainerReturn[]> => {
+    const response = await client.post<EmptyContainerReturn[]>(
+      URL_CONSTANTS.IMPORT_OPERATIONS.EMPTY_CONTAINER_RETURNS_LOAD_ON_TRAIN,
+      payload,
+    );
+    return unwrap(response.data);
+  },
+
   updateEmptyReturnStatus: async (
     id: string,
     payload: UpdateEmptyContainerReturnStatusPayload,
diff --git a/apps/edr-freight-web/backoffice/src/services/invoices.service.ts b/apps/edr-freight-web/backoffice/src/services/invoices.service.ts
index a4abc6ea2..8c39420ea 100644
--- a/apps/edr-freight-web/backoffice/src/services/invoices.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/invoices.service.ts
@@ -2,8 +2,10 @@ import { api as apiClient } from "@/auth/http";
 import { URL_CONSTANTS } from "@/constants/URLS";
 import type {
   Invoice,
+  InvoiceCollectedSummary,
   InvoiceListFilter,
   PaginatedInvoices,
+  PaginatedOfflineUsdInvoices,
 } from "@/types/invoice";
 
 const cleanParams = (params: object) =>
@@ -22,15 +24,59 @@ export const invoicesService = {
       .then((r) => r.data);
   },
 
+  /** Total collected (paidAmount) across every filtered invoice, by currency. */
+  collectedSummary(
+    filter: Omit<InvoiceListFilter, "page" | "pageSize">,
+  ): Promise<InvoiceCollectedSummary> {
+    return apiClient
+      .get<InvoiceCollectedSummary>(URL_CONSTANTS.BILLING.INVOICES_SUMMARY, {
+        params: cleanParams(filter),
+      })
+      .then((r) => r.data);
+  },
+
   getById(id: string): Promise<Invoice> {
     return apiClient
       .get<Invoice>(URL_CONSTANTS.BILLING.INVOICE_BY_ID(id))
       .then((r) => r.data);
   },
 
-  downloadDocument(id: string) {
+  /** `format` omitted or "a4" → standard A4 PDF; "thermal" → 80mm thermal layout (ADD-P001). */
+  downloadDocument(id: string, format?: "a4" | "thermal") {
     return apiClient.get<Blob>(URL_CONSTANTS.BILLING.INVOICE_DOCUMENT(id), {
       responseType: "blob",
+      params: format ? { format } : undefined,
     });
   },
+
+  /** Issue a credit/debit memo against a registered invoice (MoR DEB/CRE) — filing-equivalent. */
+  issueMemo(
+    id: string,
+    input: { type: "CRE" | "DEB"; reason: string },
+  ): Promise<Invoice> {
+    return apiClient
+      .post<Invoice>(URL_CONSTANTS.BILLING.INVOICE_MEMO(id), input)
+      .then((r) => r.data);
+  },
+
+  /** Finance worklist: USD and ETB invoices awaiting manual payment confirmation. */
+  listOfflineUsd(
+    filter: InvoiceListFilter,
+  ): Promise<PaginatedOfflineUsdInvoices> {
+    return apiClient
+      .get<PaginatedOfflineUsdInvoices>(URL_CONSTANTS.BILLING.OFFLINE_USD, {
+        params: cleanParams(filter),
+      })
+      .then((r) => r.data);
+  },
+
+  /** Confirm an invoice (USD or ETB) paid manually — the slip file is required. */
+  confirmOffline(id: string, file: File, reference?: string): Promise<Invoice> {
+    const body = new FormData();
+    body.append("file", file);
+    if (reference) body.append("reference", reference);
+    return apiClient
+      .post<Invoice>(URL_CONSTANTS.BILLING.CONFIRM_OFFLINE(id), body)
+      .then((r) => r.data);
+  },
 };
diff --git a/apps/edr-freight-web/backoffice/src/services/logoSettings.service.ts b/apps/edr-freight-web/backoffice/src/services/logoSettings.service.ts
new file mode 100644
index 000000000..fd89f2ed3
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/logoSettings.service.ts
@@ -0,0 +1,31 @@
+import { api as client } from "../auth/http";
+import { unwrap } from "@/utils/endpoint";
+import type { ApiResponse } from "@/types/apiResponse";
+
+const BASE = "/logo-settings";
+
+/** Company logo used on every generated document. */
+export interface LogoSettings {
+  logoImageUrl: string | null;
+  updatedById: string | null;
+  updatedAt: string | null;
+}
+
+export const logoSettingsService = {
+  get: async (): Promise<LogoSettings> => {
+    const response = await client.get<ApiResponse<LogoSettings>>(BASE);
+    return unwrap(response.data);
+  },
+
+  set: async (logoImageBase64: string): Promise<LogoSettings> => {
+    const response = await client.put<ApiResponse<LogoSettings>>(BASE, {
+      logoImageBase64,
+    });
+    return unwrap(response.data);
+  },
+
+  clear: async (): Promise<LogoSettings> => {
+    const response = await client.delete<ApiResponse<LogoSettings>>(BASE);
+    return unwrap(response.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/manualPaymentSettings.service.ts b/apps/edr-freight-web/backoffice/src/services/manualPaymentSettings.service.ts
new file mode 100644
index 000000000..6710730cb
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/manualPaymentSettings.service.ts
@@ -0,0 +1,36 @@
+import { api as client } from "../auth/http";
+import { unwrap } from "@/utils/endpoint";
+import { URL_CONSTANTS } from "@/constants/URLS";
+import type { ApiResponse } from "@/types/apiResponse";
+
+const BASE = URL_CONSTANTS.MANUAL_PAYMENT_SETTINGS.BASE;
+
+/**
+ * Whether Finance may settle invoices by hand (bank transfer / counter) rather
+ * than the customer paying online — switched per currency, because the two
+ * channels are operationally different.
+ */
+export interface ManualPaymentSettings {
+  etbEnabled: boolean;
+  usdEnabled: boolean;
+  updatedById: string | null;
+  updatedAt?: string;
+}
+
+export const manualPaymentSettingsService = {
+  get: async (): Promise<ManualPaymentSettings> => {
+    const response = await client.get<ApiResponse<ManualPaymentSettings>>(BASE);
+    return unwrap(response.data);
+  },
+
+  /** Partial: an omitted currency keeps its current setting. */
+  update: async (
+    patch: Partial<Pick<ManualPaymentSettings, "etbEnabled" | "usdEnabled">>,
+  ): Promise<ManualPaymentSettings> => {
+    const response = await client.patch<ApiResponse<ManualPaymentSettings>>(
+      BASE,
+      patch,
+    );
+    return unwrap(response.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/overview.service.ts b/apps/edr-freight-web/backoffice/src/services/overview.service.ts
index 71e7fb671..9229b0b4f 100644
--- a/apps/edr-freight-web/backoffice/src/services/overview.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/overview.service.ts
@@ -4,9 +4,11 @@ import { URL_CONSTANTS } from "@/constants/URLS";
 import type {
   IOverviewBillingTab,
   IOverviewBookingsTab,
+  IOverviewClearanceTab,
   IOverviewContractsTab,
   IOverviewCustomersTab,
   IOverviewDashboard,
+  IOverviewFleetTab,
   IOverviewOperationsTab,
   IOverviewStaffTab,
   OverviewRange,
@@ -52,6 +54,19 @@ export const overviewService = {
     return unwrap(response);
   },
 
+  getFleetTab: async (range?: OverviewRange): Promise<IOverviewFleetTab> => {
+    const response = await client.get<IOverviewFleetTab>(O.FLEET, {
+      params: range ? { range } : undefined,
+    });
+    return unwrap(response);
+  },
+
+  /** Document + invoice queues; not range-scoped — these are open work items. */
+  getClearanceTab: async (): Promise<IOverviewClearanceTab> => {
+    const response = await client.get<IOverviewClearanceTab>(O.CLEARANCE);
+    return unwrap(response);
+  },
+
   getCustomersTab: async (range?: OverviewRange): Promise<IOverviewCustomersTab> => {
     const response = await client.get<IOverviewCustomersTab>(O.CUSTOMERS, {
       params: range ? { range } : undefined,
diff --git a/apps/edr-freight-web/backoffice/src/services/portal-content.service.ts b/apps/edr-freight-web/backoffice/src/services/portal-content.service.ts
new file mode 100644
index 000000000..a1bbb3260
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/portal-content.service.ts
@@ -0,0 +1,107 @@
+import type {
+  PortalMediaKind,
+  SupportDocPayload,
+  SupportDocSlug,
+  SupportDocumentDetail,
+  SupportDocVersionDetail,
+  SupportDocVersionSummary,
+} from "@edr/types";
+
+import { api as client } from "../auth/http";
+
+const ROOT = "/support-content";
+const BASE = `${ROOT}/documents`;
+
+/**
+ * Customer-facing help/FAQ/legal copy for the freight portal. The client's
+ * response interceptor already unwraps the `{ success, data }` envelope, so
+ * every method is a one-liner.
+ */
+export const portalContentService = {
+  async getBySlug(slug: SupportDocSlug): Promise<SupportDocumentDetail> {
+    const { data } = await client.get<SupportDocumentDetail>(`${BASE}/${slug}`);
+    return data;
+  },
+
+  /**
+   * Replaces the document's whole payload. Whole-payload rather than per-field
+   * on purpose: one Save becomes exactly one version, which is what keeps the
+   * history list readable.
+   */
+  async update(
+    slug: SupportDocSlug,
+    payload: SupportDocPayload,
+    note?: string,
+  ): Promise<SupportDocumentDetail> {
+    const { data } = await client.patch<SupportDocumentDetail>(
+      `${BASE}/${slug}`,
+      { payload, note },
+    );
+    return data;
+  },
+
+  async listVersions(slug: SupportDocSlug): Promise<SupportDocVersionSummary[]> {
+    const { data } = await client.get<SupportDocVersionSummary[]>(
+      `${BASE}/${slug}/versions`,
+    );
+    return data;
+  },
+
+  async getVersion(
+    slug: SupportDocSlug,
+    version: number,
+  ): Promise<SupportDocVersionDetail> {
+    const { data } = await client.get<SupportDocVersionDetail>(
+      `${BASE}/${slug}/versions/${version}`,
+    );
+    return data;
+  },
+
+  /**
+   * Uploads an image or video and returns its object *key*. The key is what
+   * gets saved in the document; `url` is only for showing the editor a preview
+   * right now, and expires.
+   */
+  async uploadMedia(
+    file: File,
+    onProgress?: (percent: number | null) => void,
+  ): Promise<{ key: string; kind: PortalMediaKind; url: string }> {
+    const form = new FormData();
+    form.append("file", file);
+
+    const { data } = await client.post<{
+      key: string;
+      kind: PortalMediaKind;
+      url: string;
+    }>(`${ROOT}/media`, form, {
+      // A video is big enough that a stalled connection would otherwise sit on
+      // a spinner forever with nothing to tell the author it had failed.
+      timeout: 2 * 60 * 1000,
+      onUploadProgress: (event) =>
+        onProgress?.(
+          event.total ? Math.round((event.loaded / event.total) * 100) : null,
+        ),
+    });
+    return data;
+  },
+
+  /** Resolves one stored key to a temporary URL, for editor previews. */
+  async mediaUrl(key: string): Promise<string> {
+    const { data } = await client.get<{ url: string }>(`${ROOT}/media-url`, {
+      params: { key },
+    });
+    return data.url;
+  },
+
+  /** Re-saves an old payload as a new version — never destructive. */
+  async restore(
+    slug: SupportDocSlug,
+    version: number,
+  ): Promise<SupportDocumentDetail> {
+    const { data } = await client.post<SupportDocumentDetail>(
+      `${BASE}/${slug}/versions/${version}/restore`,
+      {},
+    );
+    return data;
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/rates.service.ts b/apps/edr-freight-web/backoffice/src/services/rates.service.ts
index b7e3dd377..c832b6f7e 100644
--- a/apps/edr-freight-web/backoffice/src/services/rates.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/rates.service.ts
@@ -11,6 +11,8 @@ export interface Rate {
   currency: string;
   rateValue: string;
   rateUnit: string;
+  /** PER_LITER fuel rates only: price = baseLiters × rateValue, once per booking. */
+  baseLiters?: string | null;
   status: string;
   proposedByStaffId: string;
   approvedByCeoId: string | null;
diff --git a/apps/edr-freight-web/backoffice/src/services/reports.service.ts b/apps/edr-freight-web/backoffice/src/services/reports.service.ts
index 6f6995614..f04bc8c8f 100644
--- a/apps/edr-freight-web/backoffice/src/services/reports.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/reports.service.ts
@@ -1,14 +1,31 @@
 import { api as client } from "../auth/http";
 import { unwrap } from "@/utils/endpoint";
 import { URL_CONSTANTS } from "@/constants/URLS";
-import type { ReportQueryInput, ReportResult } from "@/types/reports";
+import type { ReportCatalogEntry, ReportRunParams, ReportRunResult } from "@/types/reports";
+
+const R = URL_CONSTANTS.REPORTS;
 
 export const reportsService = {
-  run: async ({ key, ...params }: ReportQueryInput): Promise<ReportResult> => {
-    const response = await client.get<ReportResult>(
-      URL_CONSTANTS.REPORTS.RUN(key),
-      { params },
-    );
+  catalog: async (): Promise<ReportCatalogEntry[]> => {
+    const response = await client.get(R.CATALOG);
     return unwrap(response.data);
   },
+
+  run: async ({ key, ...params }: ReportRunParams): Promise<ReportRunResult> => {
+    const response = await client.get(R.RUN(key), { params });
+    return unwrap(response.data);
+  },
+
+  /** Streams the export file as a blob — caller triggers the browser save. */
+  download: async (
+    key: string,
+    format: "xlsx" | "pdf",
+    params: Omit<ReportRunParams, "key" | "page" | "pageSize">,
+  ): Promise<Blob> => {
+    const response = await client.get(R.EXPORT(key), {
+      params: { ...params, format },
+      responseType: "blob",
+    });
+    return response.data as Blob;
+  },
 };
diff --git a/apps/edr-freight-web/backoffice/src/services/ruleEngine/ruleEngine.service.ts b/apps/edr-freight-web/backoffice/src/services/ruleEngine/ruleEngine.service.ts
index 682da4fcc..48f944c21 100644
--- a/apps/edr-freight-web/backoffice/src/services/ruleEngine/ruleEngine.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/ruleEngine/ruleEngine.service.ts
@@ -20,6 +20,11 @@ export interface RuleEngineListParams {
   /** Rates category tabs — comma-separated appliesTo / trigger filters. */
   appliesTo?: string;
   trigger?: string;
+  /**
+   * Rates only: "true" lists shipping-line rates, "false" standard customer
+   * ones. Omitted lists both.
+   */
+  isShippingLineRate?: string;
 }
 
 export interface RuleEngineReorderPayload {
@@ -214,6 +219,7 @@ export const ruleEngineService = {
         requiresDirectorApproval: params?.requiresDirectorApproval,
         appliesTo: params?.appliesTo,
         trigger: params?.trigger,
+        isShippingLineRate: params?.isShippingLineRate,
       },
     });
     return normalizeList<T>(response.data, page, pageSize);
diff --git a/apps/edr-freight-web/backoffice/src/services/shippingLineCompanies.service.ts b/apps/edr-freight-web/backoffice/src/services/shippingLineCompanies.service.ts
new file mode 100644
index 000000000..82e97140f
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/shippingLineCompanies.service.ts
@@ -0,0 +1,54 @@
+import { api as apiClient } from "@/auth/http";
+import { URL_CONSTANTS } from "@/constants/URLS";
+import type {
+  CreateShippingLineCompanyDto,
+  PaginatedShippingLineCompanies,
+  RegisterShippingLineCompanyResult,
+  ResetChannel,
+  ResetPasswordResult,
+  ShippingLineCompany,
+} from "@/types/shippingLineCompany";
+
+export const shippingLineCompaniesService = {
+  list(page = 1, limit = 20): Promise<PaginatedShippingLineCompanies> {
+    return apiClient
+      .get<PaginatedShippingLineCompanies>(
+        URL_CONSTANTS.SHIPPING_LINE_COMPANIES.BASE,
+        { params: { page, limit } },
+      )
+      .then((r) => r.data);
+  },
+
+  getById(id: string): Promise<ShippingLineCompany> {
+    return apiClient
+      .get<ShippingLineCompany>(URL_CONSTANTS.SHIPPING_LINE_COMPANIES.BY_ID(id))
+      .then((r) => r.data);
+  },
+
+  /**
+   * Creates the carrier's account and record, then sends an activation link.
+   * Staff never set or see a password — the line chooses its own from the link.
+   */
+  register(
+    dto: CreateShippingLineCompanyDto,
+  ): Promise<RegisterShippingLineCompanyResult> {
+    return apiClient
+      .post<RegisterShippingLineCompanyResult>(
+        URL_CONSTANTS.SHIPPING_LINE_COMPANIES.BASE,
+        dto,
+      )
+      .then((r) => r.data);
+  },
+
+  resendActivation(
+    id: string,
+    channel: ResetChannel,
+  ): Promise<ResetPasswordResult> {
+    return apiClient
+      .post<ResetPasswordResult>(
+        URL_CONSTANTS.SHIPPING_LINE_COMPANIES.RESEND_ACTIVATION(id),
+        { channel },
+      )
+      .then((r) => r.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/shippingLineCredits.service.ts b/apps/edr-freight-web/backoffice/src/services/shippingLineCredits.service.ts
new file mode 100644
index 000000000..7f726a10b
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/shippingLineCredits.service.ts
@@ -0,0 +1,131 @@
+import { api as apiClient } from "@/auth/http";
+import { URL_CONSTANTS } from "@/constants/URLS";
+import type {
+  CreditInvoicePendingAction,
+  GeneratedCreditInvoice,
+  OutstandingTotals,
+  PaginatedCreditInvoices,
+  PaginatedShippingLineCredits,
+  ShippingLineCreditStatus,
+} from "@/types/shippingLineCredit";
+
+export interface ShippingLineCreditListFilter {
+  page?: number;
+  pageSize?: number;
+  status?: ShippingLineCreditStatus;
+  /** Narrow to one line; omit for all lines. */
+  shippingLineId?: string;
+}
+
+export const shippingLineCreditsService = {
+  /** Outstanding totals — every line, or one line when an id is given. */
+  summary(shippingLineId?: string): Promise<OutstandingTotals> {
+    return apiClient
+      .get<OutstandingTotals>(URL_CONSTANTS.SHIPPING_LINE_CREDITS.SUMMARY, {
+        params: shippingLineId ? { shippingLineId } : {},
+      })
+      .then((r) => r.data);
+  },
+
+  /** The whole credit ledger, newest first, optionally filtered. */
+  list(
+    filter: ShippingLineCreditListFilter = {},
+  ): Promise<PaginatedShippingLineCredits> {
+    const { page = 1, pageSize = 20, status, shippingLineId } = filter;
+    return apiClient
+      .get<PaginatedShippingLineCredits>(
+        URL_CONSTANTS.SHIPPING_LINE_CREDITS.BASE,
+        {
+          params: {
+            page,
+            pageSize,
+            ...(status ? { status } : {}),
+            ...(shippingLineId ? { shippingLineId } : {}),
+          },
+        },
+      )
+      .then((r) => r.data);
+  },
+
+  /**
+   * Bill a batch of unbilled credits as one invoice. The API enforces that all
+   * credits belong to one shipping line and share one currency.
+   */
+  generateInvoice(
+    creditIds: string[],
+    dueInDays?: number,
+  ): Promise<GeneratedCreditInvoice> {
+    return apiClient
+      .post<GeneratedCreditInvoice>(URL_CONSTANTS.SHIPPING_LINE_CREDITS.INVOICE, {
+        creditIds,
+        ...(dueInDays ? { dueInDays } : {}),
+      })
+      .then((r) => r.data);
+  },
+
+  /** Credit invoices with any pending manual-action request attached. */
+  listInvoices(filter: {
+    page?: number;
+    pageSize?: number;
+    status?: string;
+    shippingLineId?: string;
+  } = {}): Promise<PaginatedCreditInvoices> {
+    const { page = 1, pageSize = 20, status, shippingLineId } = filter;
+    return apiClient
+      .get<PaginatedCreditInvoices>(URL_CONSTANTS.SHIPPING_LINE_CREDITS.INVOICES, {
+        params: {
+          page,
+          pageSize,
+          ...(status ? { status } : {}),
+          ...(shippingLineId ? { shippingLineId } : {}),
+        },
+      })
+      .then((r) => r.data);
+  },
+
+  /** Undecided manual-action requests for a batch of invoice ids. */
+  pendingInvoiceActions(
+    invoiceIds: string[],
+  ): Promise<CreditInvoicePendingAction[]> {
+    if (!invoiceIds.length) return Promise.resolve([]);
+    return apiClient
+      .get<CreditInvoicePendingAction[]>(
+        `${URL_CONSTANTS.SHIPPING_LINE_CREDITS.BASE}/invoice-actions/pending`,
+        { params: { invoiceIds: invoiceIds.join(",") } },
+      )
+      .then((r) => r.data);
+  },
+
+  /** Maker step: raise a mark-paid or cancel request on a credit invoice. */
+  requestInvoiceAction(
+    invoiceId: string,
+    action: "MARK_PAID" | "CANCEL",
+    reason: string,
+    paymentReference?: string,
+  ): Promise<CreditInvoicePendingAction> {
+    const url =
+      action === "MARK_PAID"
+        ? URL_CONSTANTS.SHIPPING_LINE_CREDITS.MARK_PAID_REQUEST(invoiceId)
+        : URL_CONSTANTS.SHIPPING_LINE_CREDITS.CANCEL_REQUEST(invoiceId);
+    return apiClient
+      .post<CreditInvoicePendingAction>(url, {
+        reason,
+        ...(paymentReference ? { paymentReference } : {}),
+      })
+      .then((r) => r.data);
+  },
+
+  /** Decision step: approve (executes) or reject a pending request. */
+  decideInvoiceAction(
+    approvalId: string,
+    approve: boolean,
+    note?: string,
+  ): Promise<CreditInvoicePendingAction> {
+    const url = approve
+      ? URL_CONSTANTS.SHIPPING_LINE_CREDITS.APPROVE_ACTION(approvalId)
+      : URL_CONSTANTS.SHIPPING_LINE_CREDITS.REJECT_ACTION(approvalId);
+    return apiClient
+      .post<CreditInvoicePendingAction>(url, note ? { note } : {})
+      .then((r) => r.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/signatures.service.ts b/apps/edr-freight-web/backoffice/src/services/signatures.service.ts
index 6a71c1836..d0a2dfe17 100644
--- a/apps/edr-freight-web/backoffice/src/services/signatures.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/signatures.service.ts
@@ -9,12 +9,16 @@ export interface SavedSignature {
   stampImageUrl?: string | null;
 }
 
+/**
+ * Signature only. A backoffice employee has no personal stamp — EDR seals with
+ * the one global company stamp managed under Settings — so the stamp half of
+ * PUT /me/signature is deliberately not exposed here, even though the shared
+ * endpoint still accepts it for portal (customer) users.
+ */
 export interface SaveSignaturePayload {
   signerDisplayName: string;
-  /** Omit to keep the existing saved signature (stamp-only update). */
+  /** Omit to keep the existing saved signature. */
   signatureImageBase64?: string;
-  /** Omit to keep the existing saved stamp. */
-  stampImageBase64?: string;
 }
 
 export const signaturesService = {
diff --git a/apps/edr-freight-web/backoffice/src/services/stampSettings.service.ts b/apps/edr-freight-web/backoffice/src/services/stampSettings.service.ts
new file mode 100644
index 000000000..c88d4e08b
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/stampSettings.service.ts
@@ -0,0 +1,31 @@
+import { api as client } from "../auth/http";
+import { unwrap } from "@/utils/endpoint";
+import type { ApiResponse } from "@/types/apiResponse";
+
+const BASE = "/stamp-settings";
+
+/** Company stamp/seal used on generated invoice/receipt PDFs. */
+export interface StampSettings {
+  stampImageUrl: string | null;
+  updatedById: string | null;
+  updatedAt: string | null;
+}
+
+export const stampSettingsService = {
+  get: async (): Promise<StampSettings> => {
+    const response = await client.get<ApiResponse<StampSettings>>(BASE);
+    return unwrap(response.data);
+  },
+
+  set: async (stampImageBase64: string): Promise<StampSettings> => {
+    const response = await client.put<ApiResponse<StampSettings>>(BASE, {
+      stampImageBase64,
+    });
+    return unwrap(response.data);
+  },
+
+  clear: async (): Promise<StampSettings> => {
+    const response = await client.delete<ApiResponse<StampSettings>>(BASE);
+    return unwrap(response.data);
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/services/trainBuilder.service.ts b/apps/edr-freight-web/backoffice/src/services/trainBuilder.service.ts
index 3d2891415..3254051d3 100644
--- a/apps/edr-freight-web/backoffice/src/services/trainBuilder.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/trainBuilder.service.ts
@@ -67,6 +67,8 @@ export interface TrainCompositionWagon {
   wagonNumber: string;
   sequenceNumber: number | null;
   status: string;
+  currentYardId: string | null;
+  currentYard: YardRefLite | null;
   wagonType: {
     id: string;
     code: string;
@@ -77,6 +79,14 @@ export interface TrainCompositionWagon {
   } | null;
 }
 
+/** Where a built train's wagons physically stand, largest group first. */
+export interface TrainWagonYardGroup {
+  yardId: string | null;
+  code: string | null;
+  label: string | null;
+  wagonCount: number;
+}
+
 export interface TrainCompositionTotals {
   wagonCount: number;
   totalTareTons: number;
@@ -104,6 +114,7 @@ export interface TrainComposition {
   currentYard: YardRefLite | null;
   locomotives: TrainCompositionLocomotive[];
   wagons: TrainCompositionWagon[];
+  wagonYards: TrainWagonYardGroup[];
   totals: TrainCompositionTotals;
   activeSchedules: ActiveScheduleRef[];
   editable: boolean;
@@ -304,13 +315,19 @@ export const trainBuilderService = {
   /** Relocate the train — coupled locomotives and wagons move with it. */
   setYard: (id: string, currentYardId: string) =>
     apiClient.patch<TrainComposition>(`${BASE}/${id}/yard`, { currentYardId }),
+  /** Move one coupled wagon to another yard; the train stays put. */
+  setWagonYard: (id: string, wagonId: string, currentYardId: string) =>
+    apiClient.patch<TrainComposition>(`${BASE}/${id}/wagons/${wagonId}/yard`, { currentYardId }),
   assignWagons: (id: string, wagonIds: string[]) =>
     apiClient.post<TrainComposition>(`${BASE}/${id}/wagons`, { wagonIds }),
   removeWagon: (id: string, wagonId: string) =>
     apiClient.delete<TrainComposition>(`${BASE}/${id}/wagons/${wagonId}`),
   /** Detach a wagon and move it to MAINTENANCE status. */
-  sendWagonToMaintenance: (id: string, wagonId: string) =>
-    apiClient.post<TrainComposition>(`${BASE}/${id}/wagons/${wagonId}/maintenance`),
+  /** `note` is the maintenance reason — recorded with the train it came off. */
+  sendWagonToMaintenance: (id: string, wagonId: string, note?: string) =>
+    apiClient.post<TrainComposition>(`${BASE}/${id}/wagons/${wagonId}/maintenance`, {
+      note,
+    }),
   reorderWagons: (id: string, wagonIds: string[]) =>
     apiClient.post<TrainComposition>(`${BASE}/${id}/reorder-wagons`, { wagonIds }),
   /** Park the train indefinitely — only allowed with no active schedule. */
diff --git a/apps/edr-freight-web/backoffice/src/services/trainScheduling.service.ts b/apps/edr-freight-web/backoffice/src/services/trainScheduling.service.ts
index 35dc23684..999f160f7 100644
--- a/apps/edr-freight-web/backoffice/src/services/trainScheduling.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/trainScheduling.service.ts
@@ -28,7 +28,10 @@ import type {
   LocomotiveRecord,
   PinWagonsPayload,
   RecordCheckpointPayload,
+  UpdateCheckpointPayload,
+  DispatchSchedulePayload,
   StaffBookingWindow,
+  ScheduleMergePreview,
   TrainScheduleDetail,
   UpdateScheduleWindowRulePayload,
   TrainScheduleFilters,
@@ -294,6 +297,29 @@ export const trainSchedulingService = {
     return unwrap(response.data);
   },
 
+  /** What a merge would do — drives the confirmation modal. Read-only. */
+  previewScheduleMerge: async (
+    scheduleId: string,
+    targetTrainId: string,
+  ): Promise<ScheduleMergePreview> => {
+    const response = await client.get<ScheduleMergePreview>(
+      URL_CONSTANTS.TRAIN_SCHEDULING.MERGE_PREVIEW(scheduleId, targetTrainId),
+    );
+    return unwrap(response.data);
+  },
+
+  /** Merge another train into this schedule. This schedule always survives. */
+  mergeScheduleTrain: async (
+    scheduleId: string,
+    payload: { targetTrainId: string; reason?: string },
+  ): Promise<TrainScheduleDetail> => {
+    const response = await client.post<TrainScheduleDetail>(
+      URL_CONSTANTS.TRAIN_SCHEDULING.MERGE_TRAIN(scheduleId),
+      payload,
+    );
+    return unwrap(response.data);
+  },
+
   markBookingPaid: async (bookingId: string): Promise<void> => {
     await client.post(
       URL_CONSTANTS.TRAIN_SCHEDULING.MARK_BOOKING_PAID(bookingId),
@@ -500,10 +526,11 @@ export const trainSchedulingService = {
 
   dispatchSchedule: async (
     scheduleId: string,
+    payload: DispatchSchedulePayload = {},
   ): Promise<TrainScheduleDetail> => {
     const response = await client.post<TrainScheduleDetail>(
       URL_CONSTANTS.TRAIN_SCHEDULING.DISPATCH(scheduleId),
-      {},
+      payload,
     );
     return unwrap(response.data);
   },
@@ -672,6 +699,18 @@ export const trainSchedulingService = {
     return unwrap(response.data);
   },
 
+  updateCheckpoint: async (
+    scheduleId: string,
+    sequenceNo: number,
+    payload: UpdateCheckpointPayload,
+  ): Promise<TrainTrackResponse> => {
+    const response = await client.patch<TrainTrackResponse>(
+      URL_CONSTANTS.TRAIN_SCHEDULING.CHECKPOINT(scheduleId, sequenceNo),
+      payload,
+    );
+    return unwrap(response.data);
+  },
+
   arriveSchedule: async (scheduleId: string): Promise<TrainScheduleDetail> => {
     const response = await client.post<TrainScheduleDetail>(
       URL_CONSTANTS.TRAIN_SCHEDULING.ARRIVE(scheduleId),
diff --git a/apps/edr-freight-web/backoffice/src/services/wagon.service.ts b/apps/edr-freight-web/backoffice/src/services/wagon.service.ts
index 858d26412..f2c4ece8e 100644
--- a/apps/edr-freight-web/backoffice/src/services/wagon.service.ts
+++ b/apps/edr-freight-web/backoffice/src/services/wagon.service.ts
@@ -26,6 +26,9 @@ export interface Wagon {
     lengthMeters?: number;
   } | null;
   status: Freight.WagonStatus;
+  /** Latest status-log flip to MAINTENANCE / to AVAILABLE (list endpoint only). */
+  lastMaintenanceAt?: string | null;
+  lastAvailableAt?: string | null;
   currentYardId: string | null;
   currentYard?: { id: string; label?: string; code?: string } | null;
   /** Odd EXPORT run (Ethiopia → Djibouti); null when the wagon is not on a run. */
@@ -168,6 +171,10 @@ export interface WagonTransferRequest {
   closedShortByUserId?: string | null;
   /** Why the wagons are needed — required for new requests, shown on the queue. */
   reason?: string | null;
+  /** The wagons the requester hand-picked, if any. A preference, not a reservation. */
+  preferredWagonIds?: string[] | null;
+  /** Those same picks resolved to wagon numbers by the API, for display. */
+  preferredWagons?: Array<{ id: string; wagonNumber: string }>;
   note: string | null;
   fromYard?: { id: string; label?: string; code?: string } | null;
   toYard?: { id: string; label?: string; code?: string } | null;
@@ -182,6 +189,8 @@ export interface CreateTransferRequestPayload {
   quantity: number;
   /** Mandatory: why the wagons are needed. */
   reason: string;
+  /** Specific wagons the requester wants — at most `quantity` of them. */
+  preferredWagonIds?: string[];
   note?: string;
 }
 
diff --git a/apps/edr-freight-web/backoffice/src/services/yardPositions.service.ts b/apps/edr-freight-web/backoffice/src/services/yardPositions.service.ts
new file mode 100644
index 000000000..db8984827
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/services/yardPositions.service.ts
@@ -0,0 +1,64 @@
+import { api as apiClient } from "../auth/http";
+
+// NOTE: `auth/http`'s response interceptor already unwraps the API's
+// `{ success, data }` envelope, so `response.data` IS the payload here — a
+// second `.data` hop reads undefined and silently yields an empty list.
+
+/** A desk mapped to a yard, joined to its IAM position for display. */
+export interface YardPositionRow {
+  id: string;
+  yardId: string;
+  yardCode: string;
+  yardLabel: string;
+  positionId: string;
+  positionName: { am?: string; en?: string } | null;
+  positionTypeKey: string | null;
+}
+
+export interface SelectablePosition {
+  id: string;
+  name: { am?: string; en?: string } | null;
+  positionTypeKey: string | null;
+  unitKey: string | null;
+}
+
+export interface MyYardScope {
+  /** null = unrestricted (super admin or `yards:view_all`). */
+  yardIds: string[] | null;
+  unrestricted: boolean;
+  /** False while the backend is still shadow-logging instead of denying. */
+  enforced: boolean;
+}
+
+export const yardPositionsService = {
+  listByYard: async (yardId: string): Promise<YardPositionRow[]> => {
+    const { data } = await apiClient.get(`/yard-positions`, {
+      params: { yardId },
+    });
+    return data ?? [];
+  },
+
+  listPositions: async (): Promise<SelectablePosition[]> => {
+    const { data } = await apiClient.get(`/yard-positions/positions`);
+    return data ?? [];
+  },
+
+  myScope: async (): Promise<MyYardScope> => {
+    const { data } = await apiClient.get(`/yard-positions/my-yards`);
+    return data;
+  },
+
+  /**
+   * Replaces the yard's whole desk set — send every position that should remain
+   * mapped, not just the additions.
+   */
+  setForYard: async (
+    yardId: string,
+    positionIds: string[],
+  ): Promise<YardPositionRow[]> => {
+    const { data } = await apiClient.put(`/yard-positions/yard/${yardId}`, {
+      positionIds,
+    });
+    return data ?? [];
+  },
+};
diff --git a/apps/edr-freight-web/backoffice/src/shared/common/ui/date-range-picker.tsx b/apps/edr-freight-web/backoffice/src/shared/common/ui/date-range-picker.tsx
new file mode 100644
index 000000000..07df09353
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/shared/common/ui/date-range-picker.tsx
@@ -0,0 +1,197 @@
+import * as React from "react";
+import { CalendarIcon, ChevronDown } from "lucide-react";
+import {
+  format,
+  isSameDay,
+  isSameYear,
+  startOfDay,
+  endOfDay,
+  startOfMonth,
+  endOfMonth,
+  startOfYear,
+  subDays,
+  subMonths,
+} from "date-fns";
+
+import { cn } from "@/shared/lib/utils";
+import { Button } from "@/shared/common/ui/button";
+import { Calendar } from "@/shared/common/ui/calendar";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/shared/common/ui/popover";
+
+export interface DateRangeValue {
+  from?: Date;
+  to?: Date;
+}
+
+/** Parse a `YYYY-MM-DD` string as a local calendar day (avoids the UTC-midnight timezone shift `new Date(str)` has). */
+export function parseDay(value?: string | null): Date | undefined {
+  if (!value) return undefined;
+  const [y, m, d] = value.split("-").map(Number);
+  if (!y || !m || !d) return undefined;
+  return new Date(y, m - 1, d);
+}
+
+/** Format a `Date` back to `YYYY-MM-DD`, for call sites still storing plain date strings. */
+export function formatDay(date?: Date): string {
+  return date ? format(date, "yyyy-MM-dd") : "";
+}
+
+interface DateRangePreset {
+  label: string;
+  range: () => DateRangeValue;
+}
+
+const DEFAULT_PRESETS: DateRangePreset[] = [
+  { label: "Today", range: () => ({ from: startOfDay(new Date()), to: endOfDay(new Date()) }) },
+  {
+    label: "Yesterday",
+    range: () => ({ from: startOfDay(subDays(new Date(), 1)), to: endOfDay(subDays(new Date(), 1)) }),
+  },
+  { label: "Last 7 days", range: () => ({ from: startOfDay(subDays(new Date(), 6)), to: endOfDay(new Date()) }) },
+  { label: "Last 30 days", range: () => ({ from: startOfDay(subDays(new Date(), 29)), to: endOfDay(new Date()) }) },
+  { label: "This month", range: () => ({ from: startOfMonth(new Date()), to: endOfDay(new Date()) }) },
+  {
+    label: "Last month",
+    range: () => ({
+      from: startOfMonth(subMonths(new Date(), 1)),
+      to: endOfMonth(subMonths(new Date(), 1)),
+    }),
+  },
+  { label: "Year to date", range: () => ({ from: startOfYear(new Date()), to: endOfDay(new Date()) }) },
+];
+
+function formatRangeLabel(value?: DateRangeValue, placeholder = "Select date range") {
+  if (!value?.from) return placeholder;
+  if (!value.to || isSameDay(value.from, value.to)) {
+    return format(value.from, "MMM d, y");
+  }
+  if (isSameYear(value.from, value.to)) {
+    return `${format(value.from, "MMM d")} – ${format(value.to, "MMM d, y")}`;
+  }
+  return `${format(value.from, "MMM d, y")} – ${format(value.to, "MMM d, y")}`;
+}
+
+interface DateRangePickerProps {
+  value?: DateRangeValue;
+  onChange?: (range: DateRangeValue) => void;
+  presets?: DateRangePreset[];
+  placeholder?: string;
+  numberOfMonths?: number;
+  className?: string;
+  align?: "start" | "center" | "end";
+  disabled?: boolean;
+}
+
+export function DateRangePicker({
+  value,
+  onChange,
+  presets = DEFAULT_PRESETS,
+  placeholder = "Select date range",
+  numberOfMonths = 2,
+  className,
+  align = "start",
+  disabled = false,
+}: DateRangePickerProps) {
+  const [open, setOpen] = React.useState(false);
+  const [draft, setDraft] = React.useState<DateRangeValue | undefined>(value);
+
+  // Reset the draft to the committed value each time the popover opens
+  React.useEffect(() => {
+    if (open) setDraft(value);
+  }, [open, value]);
+
+  const activePresetLabel = React.useMemo(() => {
+    if (!draft?.from || !draft?.to) return null;
+    const match = presets.find((preset) => {
+      const r = preset.range();
+      return r.from && r.to && isSameDay(r.from, draft.from!) && isSameDay(r.to, draft.to!);
+    });
+    return match?.label ?? null;
+  }, [draft, presets]);
+
+  function applyPreset(preset: DateRangePreset) {
+    const range = preset.range();
+    setDraft(range);
+    onChange?.(range);
+    setOpen(false);
+  }
+
+  function handleApply() {
+    if (draft?.from) onChange?.({ from: draft.from, to: draft.to ?? draft.from });
+    setOpen(false);
+  }
+
+  function handleCancel() {
+    setDraft(value);
+    setOpen(false);
+  }
+
+  return (
+    <Popover open={open && !disabled} onOpenChange={(next: boolean) => setOpen(next && !disabled)}>
+      <PopoverTrigger asChild>
+        <Button
+          type="button"
+          variant="outline"
+          disabled={disabled}
+          className={cn(
+            "min-w-[240px] justify-start gap-2 font-normal text-slate-700 dark:text-slate-200",
+            !value?.from && "text-slate-500 dark:text-slate-400",
+            className,
+          )}
+        >
+          <CalendarIcon className="size-4 text-slate-500 dark:text-slate-400" />
+          <span className="flex-1 text-left">{formatRangeLabel(value, placeholder)}</span>
+          <ChevronDown className="size-4 text-slate-400" />
+        </Button>
+      </PopoverTrigger>
+      <PopoverContent align={align} className="w-auto p-0">
+        <div className="flex flex-col sm:flex-row">
+          <div className="flex shrink-0 flex-col gap-0.5 border-b p-2 sm:border-b-0 sm:border-r sm:w-[160px]">
+            {presets.map((preset) => (
+              <button
+                key={preset.label}
+                type="button"
+                onClick={() => applyPreset(preset)}
+                className={cn(
+                  "rounded-md px-2.5 py-1.5 text-left text-sm font-medium text-slate-600 hover:bg-slate-100 dark:text-slate-300 dark:hover:bg-slate-800",
+                  activePresetLabel === preset.label &&
+                    "bg-primary-50 text-primary-700 hover:bg-primary-50 dark:bg-primary-900/30 dark:text-primary-300",
+                )}
+              >
+                {preset.label}
+              </button>
+            ))}
+          </div>
+
+          <div className="flex flex-col">
+            <Calendar
+              mode="range"
+              selected={draft}
+              onSelect={(range: DateRangeValue | undefined) => setDraft(range ?? undefined)}
+              numberOfMonths={numberOfMonths}
+              defaultMonth={draft?.from ?? value?.from}
+              className="border-none shadow-none"
+            />
+            <div className="flex items-center justify-between gap-3 border-t p-3">
+              <span className="text-sm text-slate-500 dark:text-slate-400">
+                {formatRangeLabel(draft, "No dates selected")}
+              </span>
+              <div className="flex gap-2">
+                <Button variant="ghost" size="sm" onClick={handleCancel}>
+                  Cancel
+                </Button>
+                <Button size="sm" disabled={!draft?.from} onClick={handleApply}>
+                  Apply
+                </Button>
+              </div>
+            </div>
+          </div>
+        </div>
+      </PopoverContent>
+    </Popover>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/shared/common/ui/sonner.tsx b/apps/edr-freight-web/backoffice/src/shared/common/ui/sonner.tsx
index beb81624d..22a2d4022 100644
--- a/apps/edr-freight-web/backoffice/src/shared/common/ui/sonner.tsx
+++ b/apps/edr-freight-web/backoffice/src/shared/common/ui/sonner.tsx
@@ -1,12 +1,13 @@
-import { useTheme } from "next-themes"
 import { Toaster as Sonner, ToasterProps } from "sonner"
 
+// Pinned to "light": the app is light-only. This previously read next-themes'
+// useTheme, which falls back to "system" when no ThemeProvider is mounted (and
+// none is) — sonner then resolves "system" against prefers-color-scheme and
+// rendered dark toasts over a light UI on any OS set to dark.
 const Toaster = ({ ...props }: ToasterProps) => {
-  const { theme = "system" } = useTheme()
-
   return (
     <Sonner
-      theme={theme as ToasterProps["theme"]}
+      theme="light"
       className="toaster group"
       toastOptions={{
         classNames: {
diff --git a/apps/edr-freight-web/backoffice/src/shared/components/activity-log/activity-filters.tsx b/apps/edr-freight-web/backoffice/src/shared/components/activity-log/activity-filters.tsx
index f1dc6a849..61e4a2a3b 100644
--- a/apps/edr-freight-web/backoffice/src/shared/components/activity-log/activity-filters.tsx
+++ b/apps/edr-freight-web/backoffice/src/shared/components/activity-log/activity-filters.tsx
@@ -1,6 +1,5 @@
 'use client'
 
-import { useState } from 'react'
 import { useTranslation } from 'react-i18next'
 import { Input } from '@/shared/common/ui/input'
 import {
@@ -11,14 +10,8 @@ import {
 	SelectValue,
 } from '@/shared/common/ui/select'
 import { Button } from '@/shared/common/ui/button'
-import {
-	Popover,
-	PopoverContent,
-	PopoverTrigger,
-} from '@/shared/common/ui/popover'
-import { Calendar } from '@/shared/common/ui/calendar'
-import { Search, Filter, CalendarIcon, X } from 'lucide-react'
-import { format } from 'date-fns'
+import { DateRangePicker } from '@/shared/common/ui/date-range-picker'
+import { Search, Filter, X } from 'lucide-react'
 import { cn } from '@/shared/lib/utils'
 
 interface ActivityFiltersProps {
@@ -53,7 +46,6 @@ export function ActivityFilters({
 	onClearFilters,
 }: ActivityFiltersProps) {
 	const { t } = useTranslation()
-	const [datePickerOpen, setDatePickerOpen] = useState(false)
 
 	const textStrong = 'text-gray-900 dark:text-gray-100'
 	const textMuted = 'text-gray-500 dark:text-gray-400'
@@ -168,92 +160,11 @@ export function ActivityFilters({
 			</div>
 
 			<div className="flex items-center gap-4">
-				<Popover open={datePickerOpen} onOpenChange={setDatePickerOpen}>
-					<PopoverTrigger asChild>
-						<Button
-							variant="outline"
-							className={cn(
-								'w-full md:w-auto justify-start text-left font-normal',
-								border,
-								surface,
-								textStrong,
-							)}
-						>
-							<CalendarIcon
-								className={cn('mr-2 h-4 w-4', textMuted)}
-							/>
-							{dateRange.from ? (
-								dateRange.to ? (
-									<>
-										{format(dateRange.from, 'LLL dd, y')} -{' '}
-										{format(dateRange.to, 'LLL dd, y')}
-									</>
-								) : (
-									format(dateRange.from, 'LLL dd, y')
-								)
-							) : (
-								<span className={textMuted}>
-									{t('auditLog.filters.dateRange')}
-								</span>
-							)}
-						</Button>
-					</PopoverTrigger>
-					<PopoverContent
-						className={cn('w-auto p-0', border, surface)}
-						align="start"
-					>
-						<Calendar
-							initialFocus
-							mode="range"
-							defaultMonth={dateRange.from}
-							selected={{
-								from: dateRange.from,
-								to: dateRange.to,
-							}}
-							onSelect={(range) => {
-								onDateRangeChange({
-									from: range?.from,
-									to: range?.to,
-								})
-							}}
-							numberOfMonths={2}
-						/>
-					</PopoverContent>
-				</Popover>
-
-				<Button
-					variant="outline"
-					onClick={() => {
-						const today = new Date()
-						const last7Days = new Date(today)
-						last7Days.setDate(last7Days.getDate() - 7)
-
-						onDateRangeChange({
-							from: last7Days,
-							to: today,
-						})
-					}}
-					className={cn(border, surface, textStrong, hoverText)}
-				>
-					{t('auditLog.filters.last7Days')}
-				</Button>
-
-				<Button
-					variant="outline"
-					onClick={() => {
-						const today = new Date()
-						const last30Days = new Date(today)
-						last30Days.setDate(last30Days.getDate() - 30)
-
-						onDateRangeChange({
-							from: last30Days,
-							to: today,
-						})
-					}}
-					className={cn(border, surface, textStrong, hoverText)}
-				>
-					{t('auditLog.filters.last30Days')}
-				</Button>
+				<DateRangePicker
+					value={dateRange}
+					onChange={onDateRangeChange}
+					placeholder={t('auditLog.filters.dateRange')}
+				/>
 			</div>
 		</div>
 	)
diff --git a/apps/edr-freight-web/backoffice/src/shared/components/filters/CombinedFilterBar.tsx b/apps/edr-freight-web/backoffice/src/shared/components/filters/CombinedFilterBar.tsx
index 1ec063e4e..f21a86a61 100644
--- a/apps/edr-freight-web/backoffice/src/shared/components/filters/CombinedFilterBar.tsx
+++ b/apps/edr-freight-web/backoffice/src/shared/components/filters/CombinedFilterBar.tsx
@@ -8,6 +8,7 @@ import EthiopianDatePickerModal, {
 import { Badge } from "@/shared/common/ui/badge";
 import { Button } from "@/shared/common/ui/button";
 import { Input } from "@/shared/common/ui/input";
+import { DateRangePicker, parseDay, formatDay } from "@/shared/common/ui/date-range-picker";
 import {
   Select,
   SelectContent,
@@ -225,29 +226,13 @@ export function CombinedFilterBar({
         {selectedFilter?.type === "dateRange" ? (
           <div className="flex flex-col sm:flex-row gap-2">
             {lang.startsWith("en") ? (
-              <>
-                <label className="mt-2">From: </label>
-                <Input
-                  type="date"
-                  value={fromDate}
-                  onChange={(event) => setFromDate(event.target.value)}
-                  onKeyDown={(event) => {
-                    if (event.key === "Enter") addFilter();
-                  }}
-                  className="w-[150px]"
-                />
-                <label className="mt-2">To: </label>
-                <Input
-                  type="date"
-                  value={toDate}
-                  onChange={(event) => setToDate(event.target.value)}
-                  onKeyDown={(event) => {
-                    if (event.key === "Enter") addFilter();
-                  }}
-                  min={fromDate}
-                  className="w-[150px]"
-                />
-              </>
+              <DateRangePicker
+                value={{ from: parseDay(fromDate), to: parseDay(toDate) }}
+                onChange={(range) => {
+                  setFromDate(formatDay(range.from));
+                  setToDate(formatDay(range.to));
+                }}
+              />
             ) : (
               <div className="flex flex-wrap items-center gap-3">
                 <div className="relative">
diff --git a/apps/edr-freight-web/backoffice/src/shared/components/login/Login.tsx b/apps/edr-freight-web/backoffice/src/shared/components/login/Login.tsx
index 459b669d1..46b1b9e56 100644
--- a/apps/edr-freight-web/backoffice/src/shared/components/login/Login.tsx
+++ b/apps/edr-freight-web/backoffice/src/shared/components/login/Login.tsx
@@ -13,8 +13,6 @@ import {
   Mail,
   Phone,
   User,
-  Moon,
-  Sun,
 } from "lucide-react";
 import { useAuthUser } from "@/shared/hooks/useAuthUser";
 import { useTenantConfig } from "@/layout/components/TenantConfig";
@@ -26,13 +24,11 @@ import { Link } from "react-router-dom";
 import { useTranslation } from "react-i18next";
 import { useAuth } from "@/shared/context/AuthContext";
 import OTPModal from "./OTPModal";
-import { useDarkMode } from "@/shared/hooks/useDarkMode";
 import { getRememberMePreference } from "@/shared/utils/authPersistence";
 
 export const Login = () => {
   const { login: authLogin, isLoggingIn } = useAuthUser();
   const { config } = useTenantConfig();
-  const { isDarkMode, toggleDarkMode } = useDarkMode();
   const detectLoginMethod = (value: string): "email" | "phone" | "username" => {
     if (value.includes("@") && value.includes(".com")) return "email";
     if (/^\+?\d+$/.test(value)) return "phone";
@@ -121,19 +117,6 @@ export const Login = () => {
           </span>
         </Link>
 
-        {/* Dark Mode Toggle */}
-        <button
-          onClick={toggleDarkMode}
-          className="fixed top-4 right-4 md:top-6 md:right-6 z-50 p-2 rounded-full bg-white dark:bg-gray-800 shadow-md hover:shadow-lg transition-all duration-300 hover:scale-105 border border-gray-200 dark:border-gray-700"
-          title={isDarkMode ? "Switch to light mode" : "Switch to dark mode"}
-        >
-          {isDarkMode ? (
-            <Sun className="w-5 h-5 text-yellow-500" />
-          ) : (
-            <Moon className="w-5 h-5 text-gray-600 dark:text-gray-400" />
-          )}
-        </button>
-
         <div className="w-full max-w-6xl bg-white dark:bg-gray-800 rounded-2xl shadow-2xl overflow-hidden flex flex-col lg:flex-row">
           {/* Left Panel - Login Form */}
           <div className="lg:w-1/2 w-full p-6 sm:p-8 md:p-10 lg:p-12 xl:p-16 flex flex-col justify-center">
diff --git a/apps/edr-freight-web/backoffice/src/shared/hooks/useDarkMode.ts b/apps/edr-freight-web/backoffice/src/shared/hooks/useDarkMode.ts
deleted file mode 100644
index 273064cec..000000000
--- a/apps/edr-freight-web/backoffice/src/shared/hooks/useDarkMode.ts
+++ /dev/null
@@ -1,33 +0,0 @@
-import { useEffect, useState } from "react";
-
-// Same storage key/values as main.tsx and FreightDashboardLayout so the
-// vendored IAM UI toggle and the host dashboard toggle stay in sync.
-const THEME_STORAGE_KEY = "edr-theme";
-
-export const useDarkMode = () => {
-  const [isDarkMode, setIsDarkMode] = useState(() => {
-    // Initialize from localStorage or system preference
-    const savedTheme = localStorage.getItem(THEME_STORAGE_KEY);
-    if (savedTheme === "dark" || savedTheme === "light") {
-      return savedTheme === "dark";
-    }
-    return window.matchMedia("(prefers-color-scheme: dark)").matches;
-  });
-
-  useEffect(() => {
-    // Apply dark mode class on mount and when isDarkMode changes
-    if (isDarkMode) {
-      document.documentElement.classList.add("dark");
-      localStorage.setItem(THEME_STORAGE_KEY, "dark");
-    } else {
-      document.documentElement.classList.remove("dark");
-      localStorage.setItem(THEME_STORAGE_KEY, "light");
-    }
-  }, [isDarkMode]);
-
-  const toggleDarkMode = () => {
-    setIsDarkMode((prev) => !prev);
-  };
-
-  return { isDarkMode, toggleDarkMode };
-};
diff --git a/apps/edr-freight-web/backoffice/src/super-admin/components/templates/components/TemplateEditor.tsx b/apps/edr-freight-web/backoffice/src/super-admin/components/templates/components/TemplateEditor.tsx
index b6de030b1..4b85ebdbd 100644
--- a/apps/edr-freight-web/backoffice/src/super-admin/components/templates/components/TemplateEditor.tsx
+++ b/apps/edr-freight-web/backoffice/src/super-admin/components/templates/components/TemplateEditor.tsx
@@ -1,4 +1,4 @@
-import React, { useMemo, useState, useEffect } from "react";
+import React, { useMemo } from "react";
 import { Editor as TinyMCEEditor } from "@/record-management/common/editor/rte";
 import type { Editor as TinyMCEEditorType } from "tinymce";
 
@@ -21,18 +21,11 @@ export const TemplateEditor: React.FC<TemplateEditorProps> = ({
   placeholders,
 }) => {
   const hasPlaceholders = placeholders && placeholders.length > 0;
-  const [isDarkMode, setIsDarkMode] = useState(() => 
-    typeof window !== "undefined" && document.documentElement.classList.contains("dark")
-  );
-  
-  useEffect(() => {
-    const observer = new MutationObserver(() => {
-      setIsDarkMode(document.documentElement.classList.contains("dark"));
-    });
-    observer.observe(document.documentElement, { attributes: true, attributeFilter: ["class"] });
-    return () => observer.disconnect();
-  }, []);
-  
+  // The app is light-only — nothing sets the `dark` class on <html>, so this is
+  // a constant rather than observed state. Kept as a named flag so the TinyMCE
+  // skin/content-style branches below stay readable.
+  const isDarkMode = false;
+
   const init = useMemo(() => {
     return {
       height: 600,
diff --git a/apps/edr-freight-web/backoffice/src/types/booking.ts b/apps/edr-freight-web/backoffice/src/types/booking.ts
index cf18abb27..258203002 100644
--- a/apps/edr-freight-web/backoffice/src/types/booking.ts
+++ b/apps/edr-freight-web/backoffice/src/types/booking.ts
@@ -64,9 +64,9 @@ export interface BookingCompany {
   email?: string | null;
   contactPersonName?: string | null;
   contactPersonPhone?: string | null;
-  generalManagerName?: string | null;
-  generalManagerEmail?: string | null;
-  generalManagerPhone?: string | null;
+  ownerName?: string | null;
+  ownerEmail?: string | null;
+  ownerPhone?: string | null;
   website?: string | null;
 }
 
@@ -90,6 +90,9 @@ export interface BookingContainerLine {
   containerNumber?: string | null;
   quantity: number;
   vgmPerUnitTons: number;
+  /** How many of this line are hazardous / refrigerated — 0 when none. */
+  hazardousQuantity?: number;
+  reeferQuantity?: number;
   containerType?: {
     id: string;
     code?: string;
@@ -131,6 +134,26 @@ export interface BookingFile {
   size?: number;
 }
 
+/** The allocated train's identity, window phase, and planned/actual clock. */
+export interface BookingTrainScheduleSummary {
+  id: string;
+  reference: string | null;
+  trainNumber: string | null;
+  status: string | null;
+  scheduledDepartureDate: string | null;
+  scheduledArrivalDate: string | null;
+  actualDepartureAt: string | null;
+  actualArrivalAt: string | null;
+  windowPhase: string | null;
+  paymentPhaseEndsAt: string | null;
+  /**
+   * True when this is the train the customer requested at day-commit rather
+   * than a confirmed allocation — what staff see while reviewing an operation
+   * request, before accepting puts the booking into the batch pool.
+   */
+  isRequested?: boolean;
+}
+
 export interface BookingDetail {
   id: string;
   reference: string;
@@ -168,12 +191,18 @@ export interface BookingDetail {
   contractType: string;
   freightType: "CONTAINER" | "BULK";
   tradeDirection: string;
+  /**
+   * EXPORT only. DIRECT_TO_TRAIN = customer truck loads straight onto the wagon
+   * (no warehouse, no GRN). null/WAREHOUSE = received and GRN'd first.
+   */
+  exportHandoverMode?: "DIRECT_TO_TRAIN" | "WAREHOUSE" | null;
   /** What the containers carry / bulk commodity label — entered at booking time. */
   cargoFreeText?: string | null;
   cargoTotalWeightVgm: number;
   /** Break-bulk (PER_ITEM) only: real total tons — cargoTotalWeightVgm then holds the item count. */
   bulkTotalWeightTons?: number | null;
   isHazardous: boolean;
+  isReefer?: boolean;
   consolidationPartnerId?: string | null;
   consolidationPartner?: BookingNamedRef & { reference?: string } | null;
   priorityScore: number;
@@ -183,12 +212,32 @@ export interface BookingDetail {
   wagonsRequired?: number | null;
   scheduledAt?: string | null;
   trainScheduleId?: string | null;
+  /** Operational status of the allocated train (null until scheduled). */
+  trainScheduleStatus?: string | null;
+  /** The allocated train's identity + clock, attached by the detail endpoint. */
+  trainScheduleSummary?: BookingTrainScheduleSummary | null;
+  /**
+   * When the batch engine picked this booking and opened its pay window — the
+   * start paired with `paymentDeadline` (both are set and cleared together).
+   */
+  selectedForBatchAt?: string | null;
+  /** End of this booking's pay window (batch/offer deadline). */
+  paymentDeadline?: string | null;
+  /**
+   * End of the pay window including the settlement drain tail — the deadline
+   * staff should quote, since a payment landing inside the drain still counts.
+   */
+  paymentDrainEndsAt?: string | null;
   pnrCode?: string | null;
   firstMilePickupAddress?: string | null;
   lastMileDeliveryAddress?: string | null;
   equipmentReturn?: string;
   customsClearingEnabled?: boolean;
   customsClearingAgent?: string | null;
+  /** ET clearance queue: every required document approved (pre-finalize). */
+  allDocsApproved?: boolean;
+  /** ET clearance queue: a customer document is PENDING or QUERIED. */
+  hasDocumentsAwaitingReview?: boolean;
   contractKind?: "ONE_TIME" | "GENERAL" | null;
   contractId?: string | null;
   /** Reference of the contract this booking was created under (list column + search). */
@@ -206,6 +255,10 @@ export interface BookingDetail {
   updatedAt: string;
   // customer?: BookingNamedRef & { companyName?: string };
   company?: BookingNamedRef & Partial<BookingCompany>;
+  /** Set when booked by a shipping line (then `companyId`/`company` are null). */
+  shippingLineCompanyId?: string | null;
+  /** Owner when booked by a shipping line (then `company` is absent). Hydrated server-side. */
+  shippingLineCompany?: { id: string; name: string; email?: string | null; phoneNumber?: string | null };
   originYard?: BookingNamedRef;
   destinationYard?: BookingNamedRef;
   serviceType?: BookingNamedRef & { code?: string; includesCustoms?: boolean; includesFirstMile?: boolean; includesLastMile?: boolean };
@@ -228,6 +281,8 @@ export interface BookingListRow {
   /** Needed to link the reference to the contract's detail page. */
   contractId?: string | null;
   customerLabel: string;
+  /** True when the booking is owned by a shipping line rather than a customer company. */
+  isShippingLine?: boolean;
   status: BookingStatus;
   scheduledDate: string;
   totalAmount: number;
@@ -245,6 +300,12 @@ export interface BookingListRow {
   governmentInstitution?: string | null;
   consolidationPartnerId?: string | null;
   consolidationPartnerReference?: string | null;
+  /**
+   * The other half of a consolidated pair, folded into this row for display.
+   * Set client-side when both halves are present in the same page of results —
+   * the list shows one row per shared wagon, not one per booking.
+   */
+  pairedWith?: BookingListRow | null;
   customsClearingEnabled?: boolean;
   /**
    * Derived booking kind for the list "Type" column. Mirrors the server's
diff --git a/apps/edr-freight-web/backoffice/src/types/customer.ts b/apps/edr-freight-web/backoffice/src/types/customer.ts
index ed77307f9..8c95e7342 100644
--- a/apps/edr-freight-web/backoffice/src/types/customer.ts
+++ b/apps/edr-freight-web/backoffice/src/types/customer.ts
@@ -21,6 +21,9 @@ export type CompanyStatus = "active" | "pending" | "suspended" | "blacklisted";
 /** Mirrors backend `CompanyKind` — commercial customer vs. government entity. */
 export type CompanyKind = "commercial" | "government";
 
+/** Mirrors backend `CompanyNationality`. */
+export type CompanyNationality = "ethiopian" | "foreign";
+
 /** Mirrors backend `ProfileType` (the role a company plays). */
 export type ProfileType =
   | "importer"
@@ -108,7 +111,11 @@ export interface CompanyChangeRequest {
   /** Staged company-document add/remove intents (e.g. the PoA letter). */
   documentChanges: DocumentChangeIntent[];
   note: string | null;
+  /** Who filed the request — resolved from `iam.users`, null when unknown. */
+  submittedByName: string | null;
   submittedAt: string | null;
+  /** Who approved / rejected / sent it back. */
+  reviewedByName: string | null;
   reviewedAt: string | null;
   createdAt: string;
   updatedAt: string;
@@ -136,6 +143,8 @@ export interface CompanyRevision {
   id: string;
   companyId: string;
   actorId: string | null;
+  /** Who made the edit — resolved from `iam.users`, null when unknown. */
+  actorName: string | null;
   summary: string;
   changes: CompanyRevisionChange[];
   createdAt: string;
@@ -176,23 +185,34 @@ export interface IdentityVerificationState {
   verifiedAt: string | null;
   birthdate: string | null;
   gender: string | null;
-}
-
-/** Mirrors `OwnerIdentityStateDto`. */
-export interface OwnerIdentityState extends IdentityVerificationState {
+  /** Typed passport number — the foreign-company alternative to Fayda. */
   passportNumber: string | null;
 }
 
 /**
- * Owner/PoA Fayda verification, shared with the portal's derivation
+ * The company's single identity verification, shared with the portal's derivation
  * (`buildCompanyIdentityState`) so backoffice never re-derives — or
  * disagrees with — the rule the API actually enforces.
  */
 export interface CompanyIdentityState {
-  faydaRequired: boolean;
-  passportRequired: boolean;
-  owner: OwnerIdentityState;
+  /** Foreign company: a passport number proves the person as Fayda would. */
+  passportAccepted: boolean;
+  /** Whether the company named a representative. Null = never answered. */
+  poaDeclared: "yes" | "no" | null;
+  /** Whose verification the company is gated on — PoA if declared, else owner. */
+  subject: "owner" | "poa" | null;
+  owner: IdentityVerificationState;
   poa: IdentityVerificationState;
+  identityProven: boolean;
+  /** The manager named on the eTrade licence, captured at lookup. */
+  etradeManagerName: string | null;
+  /**
+   * Does the owner the company put forward match the eTrade licence?
+   * THE reviewer check. Null when there is nothing to compare. Advisory —
+   * eTrade and Fayda transliterate Amharic names differently, so a `false` is
+   * "look at this", not "reject this".
+   */
+  ownerMatchesEtrade: boolean | null;
   complete: boolean;
 }
 
@@ -207,14 +227,29 @@ export interface Company {
   vatNumber?: string | null;
   fanNumber?: string | null;
   country: string;
+  nationality?: CompanyNationality | null;
+  /**
+   * A co-operative union or farm: a TIN but no trade licence, so its
+   * registration was typed rather than fetched from eTrade, there is no eTrade
+   * manager to check the owner against, and it holds no freight-forwarder role.
+   */
+  cooperative?: boolean;
+  /**
+   * A foreign investor on an Ethiopian Investment Commission licence: eTrade
+   * holds no record for its TIN, so every registration field below was typed by
+   * the customer and verified by nobody. The reviewer is the check — compare
+   * them against the investment licence on the Documents tab.
+   */
+  investorLicence?: boolean;
   address?: string | null;
   phone?: string | null;
   email?: string | null;
   contactPersonName?: string | null;
   contactPersonPhone?: string | null;
-  generalManagerName?: string | null;
-  generalManagerEmail?: string | null;
-  generalManagerPhone?: string | null;
+  /** The owner — whoever the eTrade licence names as the business's manager. */
+  ownerName?: string | null;
+  ownerEmail?: string | null;
+  ownerPhone?: string | null;
   poaName?: string | null;
   poaEmail?: string | null;
   poaPhone?: string | null;
diff --git a/apps/edr-freight-web/backoffice/src/types/eims.ts b/apps/edr-freight-web/backoffice/src/types/eims.ts
new file mode 100644
index 000000000..bc2c10c17
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/types/eims.ts
@@ -0,0 +1,80 @@
+/**
+ * MoR EIMS filing state for one invoice.
+ *
+ * Mirrors `EimsInvoiceStatusView` in the freight API (`modules/eims/eims-registration.types.ts`).
+ * Kept local rather than in `@edr/types` because only the backoffice reads it.
+ */
+export type EimsInvoiceStatus =
+  | "NOT_SUBMITTED"
+  | "SUBMITTING"
+  | "REGISTERED"
+  | "FAILED"
+  | "UNKNOWN"
+  | "CANCELLED";
+
+/** Sanitized gateway failure: MoR's own error fields, never our signed envelope. */
+export interface EimsInvoiceError {
+  kind: string;
+  message: string;
+  httpStatus?: number;
+  details?: Record<string, unknown>;
+  at: string;
+}
+
+export interface EimsInvoiceStatusView {
+  invoiceId: string;
+  invoiceNumber: string;
+  eimsStatus: EimsInvoiceStatus;
+  eimsIrn: string | null;
+  eimsInvoiceCounter: number | null;
+  eimsSubmittedAt: string | null;
+  /** MoR returns a Java ZonedDateTime string, stored verbatim — display as-is. */
+  eimsAckDate: string | null;
+  eimsLastError: EimsInvoiceError | null;
+  /** Base64 PNG from MoR, already rendered on their side — embed as `data:image/png;base64,...`. */
+  eimsSignedQr: string | null;
+  eimsCancelledAt: string | null;
+  /** MoR's own confirmation string (a Java `Date#toString()`), stored verbatim — display as-is. */
+  eimsCancellationDate: string | null;
+  eimsCancellationReasonCode: string | null;
+  eimsCancellationRemark: string | null;
+}
+
+/** One `EimsReceipt` row — mirrors `entities/eims-receipt.entity.ts`. */
+export interface EimsReceiptView {
+  id: string;
+  invoiceId: string;
+  kind: "SALES" | "WITHHOLDING";
+  status: EimsInvoiceStatus;
+  receiptNumber: string;
+  rrn: string | null;
+  /** Base64 PNG, same convention as `eimsSignedQr`. */
+  qr: string | null;
+  ackStatus: string | null;
+  submittedAt: string | null;
+  lastError: EimsInvoiceError | null;
+}
+
+/** `POST /v1/verify` response, echoed back from the gateway. */
+export interface EimsVerifyResult {
+  statusCode?: number;
+  message?: string;
+  body?: {
+    Irn?: string;
+    DocumentDetails?: { Type?: string; DocumentNumber?: string; Date?: string };
+    [section: string]: unknown;
+  };
+}
+
+/** MoR `ModeOfPayment` enum — confirmed by a live schema error, verbatim spelling/casing. */
+export const EIMS_MODE_OF_PAYMENT = [
+  "CASH",
+  "CHEQUE",
+  "CPO",
+  "Local Bank Transfer",
+  "SWIFT",
+  "Wire Transfer",
+  "Letter of Credit",
+  "Card",
+] as const;
+export type EimsModeOfPayment = (typeof EIMS_MODE_OF_PAYMENT)[number];
diff --git a/apps/edr-freight-web/backoffice/src/types/importOperations.ts b/apps/edr-freight-web/backoffice/src/types/importOperations.ts
index ff5c1901f..ee8314d01 100644
--- a/apps/edr-freight-web/backoffice/src/types/importOperations.ts
+++ b/apps/edr-freight-web/backoffice/src/types/importOperations.ts
@@ -101,6 +101,11 @@ export interface EmptyContainerReturn {
   handoverNote: string | null;
   status: EmptyContainerReturnStatus;
   wagonAllocationReference: string | null;
+  /** '20' or '40' — one 40ft OR two 20ft ride a wagon. */
+  containerSize: EmptyContainerSize | null;
+  /** Export departure this empty is loaded on, once allocated. */
+  trainScheduleId: string | null;
+  wagonSequenceNo: number | null;
   performedBy: string | null;
   returnedBy: 'EDR' | 'CUSTOMER' | null;
   statusHistory: Array<{
@@ -110,8 +115,11 @@ export interface EmptyContainerReturn {
   }>;
 }
 
+export type EmptyContainerSize = '20' | '40';
+
 export interface CreateEmptyContainerReturnPayload {
   containerNumber: string;
+  containerSize?: EmptyContainerSize;
   bookingId?: string;
   customerId?: string;
   returnDate?: string;
@@ -124,6 +132,16 @@ export interface CreateEmptyContainerReturnPayload {
   returnedBy?: 'EDR' | 'CUSTOMER';
 }
 
+export interface LoadEmptyContainersOnTrainPayload extends ImportOperationActionPayload {
+  trainScheduleId: string;
+  trainNumber?: string;
+  items: Array<{
+    id: string;
+    containerSize: EmptyContainerSize;
+    wagonSequenceNo: number;
+  }>;
+}
+
 export interface UpdateEmptyContainerReturnStatusPayload extends ImportOperationActionPayload {
   status: EmptyContainerReturnStatus;
   wagonAllocationReference?: string;
diff --git a/apps/edr-freight-web/backoffice/src/types/invoice.ts b/apps/edr-freight-web/backoffice/src/types/invoice.ts
index 26ecfcafa..a266a6257 100644
--- a/apps/edr-freight-web/backoffice/src/types/invoice.ts
+++ b/apps/edr-freight-web/backoffice/src/types/invoice.ts
@@ -13,6 +13,8 @@ export interface InvoiceListFilter {
   companyId?: string;
   status?: Freight.InvoiceStatus;
   search?: string;
+  /** Manual-payments worklist only. */
+  currency?: "USD" | "ETB";
 }
 
 /** Standard paginated list envelope (matches the customers/bookings service shape). */
@@ -20,3 +22,29 @@ export interface PaginatedInvoices {
   items: Invoice[];
   total: number;
 }
+
+/**
+ * A USD or ETB invoice on Finance's manual-settlement worklist. Booking-sourced
+ * rows carry the shipment's trade direction and pay-window deadline so the list
+ * can show the same countdown the customer sees — Finance must confirm before
+ * it closes.
+ */
+export interface OfflineUsdInvoice extends Invoice {
+  booking: {
+    id: string;
+    reference: string;
+    tradeDirection: string | null;
+    paymentDeadline: string | null;
+    paymentStatus: string;
+  } | null;
+  /** Shipping-line credit invoices span many bookings — one entry per credit. */
+  bookings: { id: string; reference: string; tradeDirection: string | null }[];
+}
+
+export interface PaginatedOfflineUsdInvoices {
+  items: OfflineUsdInvoice[];
+  total: number;
+}
+
+/** Total collected (`paidAmount`) across every filtered invoice, keyed by currency. */
+export type InvoiceCollectedSummary = Record<string, number>;
diff --git a/apps/edr-freight-web/backoffice/src/types/overview.ts b/apps/edr-freight-web/backoffice/src/types/overview.ts
index f0553fc22..85cb5fa21 100644
--- a/apps/edr-freight-web/backoffice/src/types/overview.ts
+++ b/apps/edr-freight-web/backoffice/src/types/overview.ts
@@ -10,6 +10,10 @@ export type {
   IOverviewTrendPoint,
   IOverviewDirectionTrendPoint,
   IOverviewTonnagePoint,
+  IOverviewPeriodTotals,
+  IOverviewRevenueSlice,
+  IOverviewRevenueFlow,
+  IOverviewHeatmapCell,
   IOverviewStatusCount,
   IOverviewPipelineCount,
   IOverviewPaymentTrendPoint,
@@ -18,6 +22,11 @@ export type {
   IOverviewLabelCount,
   IOverviewPaymentMethodBreakdown,
   IOverviewCurrencyAmount,
+  IOverviewMatrixCell,
+  IOverviewTrainLoad,
+  IOverviewTurnaround,
+  IOverviewFleetTab,
+  IOverviewClearanceTab,
   IOverviewBookingsTab,
   IOverviewContractsTab,
   IOverviewBillingTab,
diff --git a/apps/edr-freight-web/backoffice/src/types/reports.ts b/apps/edr-freight-web/backoffice/src/types/reports.ts
index 72326788c..e3b6749da 100644
--- a/apps/edr-freight-web/backoffice/src/types/reports.ts
+++ b/apps/edr-freight-web/backoffice/src/types/reports.ts
@@ -1,27 +1,97 @@
+export type ReportColumnType =
+  | "string"
+  | "number"
+  | "money"
+  | "tons"
+  | "percent"
+  | "date";
+
+export interface ReportColumn {
+  key: string;
+  label: string;
+  type: ReportColumnType;
+  sortable?: boolean;
+}
+
+export type ReportFilterType = "daterange" | "date" | "select" | "multiselect" | "text";
+
+export interface ReportFilterOption {
+  value: string;
+  label: string;
+}
+
+export interface ReportFilterDef {
+  key: string;
+  label: string;
+  type: ReportFilterType;
+  options?: ReportFilterOption[];
+}
+
+export interface ReportIdKey {
+  key: string;
+  label: string;
+}
+
 export interface ReportKpi {
   label: string;
   value: number;
   unit?: string;
 }
 
-export type ReportRow = Record<string, unknown>;
+export type ReportChartType = "line" | "bar";
 
-export interface ReportResult {
-  kpis: ReportKpi[];
-  rows: ReportRow[];
+export interface ReportChartDef {
+  type: ReportChartType;
+  x: string;
+  y: string[];
 }
 
-/** Query params for GET /reports/:key. List filters are comma-separated. */
-export interface ReportQueryInput {
+/**
+ * Makes a summary row clickable: the row's values are carried into another
+ * report as filter params. Keys are this report's column keys; values are the
+ * target report's filter keys.
+ */
+export interface ReportDrillDef {
+  to: string;
+  carry: Record<string, string>;
+}
+
+/** Mirrors the backend's ReportCatalogEntry — one entry per GET /reports item. */
+export interface ReportCatalogEntry {
   key: string;
-  dateFrom?: string;
-  dateTo?: string;
-  granularity?: "day" | "week" | "month";
-  companyIds?: string;
-  routeIds?: string;
-  yardIds?: string;
-  cargoTypeIds?: string;
-  statuses?: string;
-  direction?: string;
-  freightType?: string;
+  title: string;
+  description: string;
+  group: "Commercial" | "Operations" | "Finance";
+  idKey?: ReportIdKey;
+  filters: ReportFilterDef[];
+  columns: ReportColumn[];
+  defaultSort?: { key: string; dir: "ASC" | "DESC" };
+  hasSummary: boolean;
+  chart?: ReportChartDef;
+  drill?: ReportDrillDef;
 }
+
+export interface ReportPageMeta {
+  page: number;
+  pageSize: number;
+  total: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+}
+
+export interface ReportRunResult {
+  columns: ReportColumn[];
+  items: Record<string, unknown>[];
+  meta: ReportPageMeta;
+  kpis: ReportKpi[];
+}
+
+/** Query params for GET /reports/:key — page/sort plus whatever filters the report declares. */
+export type ReportRunParams = Record<string, string | number | undefined> & {
+  key: string;
+  page?: number;
+  pageSize?: number;
+  sortBy?: string;
+  sortOrder?: "ASC" | "DESC";
+};
diff --git a/apps/edr-freight-web/backoffice/src/types/shippingLineCompany.ts b/apps/edr-freight-web/backoffice/src/types/shippingLineCompany.ts
new file mode 100644
index 000000000..9feb5c627
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/types/shippingLineCompany.ts
@@ -0,0 +1,50 @@
+import type { ResetChannel, ResetPasswordResult } from "./customer";
+
+export type ShippingLineStatus = "active" | "suspended";
+
+/**
+ * A carrier with its own portal login, registered by staff.
+ *
+ * Not to be confused with the rule-engine's `ShippingLine` (types/rule-engine):
+ * that is a pricing lookup — a code/label a booking points at — with no account
+ * and no login. This one is the account.
+ */
+export interface ShippingLineCompany {
+  id: string;
+  name: string;
+  email: string;
+  phoneNumber: string | null;
+  scacCode: string | null;
+  imoNumber: string | null;
+  bicCode: string | null;
+  status: ShippingLineStatus;
+  createdAt: string;
+}
+
+export interface CreateShippingLineCompanyDto {
+  name: string;
+  email: string;
+  phoneNumber?: string;
+  scacCode?: string;
+  imoNumber?: string;
+  bicCode?: string;
+  username?: string;
+}
+
+export interface RegisterShippingLineCompanyResult {
+  shippingLine: ShippingLineCompany;
+  /**
+   * Masked destination the activation link went to, or null when delivery
+   * failed. The registration still succeeded — the link is resendable.
+   */
+  activationSentTo: string | null;
+}
+
+export interface PaginatedShippingLineCompanies {
+  items: ShippingLineCompany[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export type { ResetChannel, ResetPasswordResult };
diff --git a/apps/edr-freight-web/backoffice/src/types/shippingLineCredit.ts b/apps/edr-freight-web/backoffice/src/types/shippingLineCredit.ts
new file mode 100644
index 000000000..3b7b936e0
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/types/shippingLineCredit.ts
@@ -0,0 +1,96 @@
+/**
+ * The credit ledger for shipping lines — "use the service now, pay later".
+ * Mirrors `shipping-line-credits` API responses.
+ */
+
+export type ShippingLineCreditStatus =
+  | "UNBILLED"
+  | "BILLED"
+  | "PAID"
+  | "CANCELLED";
+
+export interface ShippingLineCredit {
+  id: string;
+  shippingLineCompanyId: string;
+  bookingId: string;
+  /** Numeric column — serialized as a string by the API. */
+  amount: string;
+  currency: string;
+  status: ShippingLineCreditStatus;
+  description: string | null;
+  invoiceId: string | null;
+  billedAt: string | null;
+  paidAt: string | null;
+  cancelledAt: string | null;
+  cancellationReason: string | null;
+  createdAt: string;
+  booking?: { id: string; reference: string } | null;
+  invoice?: { id: string; invoiceNumber: string } | null;
+  shippingLineCompany?: { id: string; name: string } | null;
+}
+
+/** What one shipping line currently owes, split by billing stage. */
+export interface OutstandingTotals {
+  unbilledAmount: number;
+  billedAmount: number;
+  totalOutstanding: number;
+  unbilledCount: number;
+  billedCount: number;
+  currency: string;
+}
+
+export interface PaginatedShippingLineCredits {
+  items: ShippingLineCredit[];
+  total: number;
+  page: number;
+  pageSize: number;
+}
+
+/** The invoice minted from a batch of unbilled credits (subset of fields). */
+export interface GeneratedCreditInvoice {
+  id: string;
+  invoiceNumber: string;
+  totalAmount: string | number;
+  currency: string;
+  status: string;
+  dueDate: string | null;
+}
+
+export type CreditInvoiceActionType = "MARK_PAID" | "CANCEL";
+export type CreditInvoiceActionStatus = "PENDING" | "APPROVED" | "REJECTED";
+
+/** An undecided manual-action request attached to a credit invoice. */
+export interface CreditInvoicePendingAction {
+  id: string;
+  invoiceId: string;
+  action: CreditInvoiceActionType;
+  status: CreditInvoiceActionStatus;
+  requestedBy: string;
+  reason: string;
+  paymentReference: string | null;
+  createdAt: string;
+}
+
+/** A credit invoice row in the staff list, enriched by the API. */
+export interface CreditInvoice {
+  id: string;
+  invoiceNumber: string;
+  status: string;
+  currency: string;
+  totalAmount: string | number;
+  paidAmount: string | number;
+  balanceAmount: string | number;
+  issuedAt: string | null;
+  dueAt: string | null;
+  createdAt: string;
+  shippingLineCompanyId: string | null;
+  shippingLineName: string | null;
+  pendingAction: CreditInvoicePendingAction | null;
+}
+
+export interface PaginatedCreditInvoices {
+  items: CreditInvoice[];
+  total: number;
+  page: number;
+  pageSize: number;
+}
diff --git a/apps/edr-freight-web/backoffice/src/types/trainScheduling.ts b/apps/edr-freight-web/backoffice/src/types/trainScheduling.ts
index 94e393e1b..2330dc4b9 100644
--- a/apps/edr-freight-web/backoffice/src/types/trainScheduling.ts
+++ b/apps/edr-freight-web/backoffice/src/types/trainScheduling.ts
@@ -196,6 +196,9 @@ export interface TrainScheduleListItem {
   origin: string | null;
   destination: string | null;
   freightType?: FreightType | null;
+  /** Set when the departure is dedicated to one shipping line (hidden from customers). */
+  shippingLineCompanyId?: string | null;
+  shippingLineCompanyName?: string | null;
   /** Built train (Train Builder) behind this departure, when scheduled by train. */
   train?: {
     id: string;
@@ -217,7 +220,28 @@ export interface TrainScheduleListItem {
     name?: string | null;
     currentYardId?: string | null;
   }>;
+  /** Coupled consist size. NOT the used count — see `wagonsUsed`. */
   wagonCount: number;
+  /**
+   * Wagon slots actually carrying a booking allocation — the same figure the
+   * detail page's wagon plan shows. Optional until every API deploy carries it.
+   */
+  wagonsUsed?: number;
+  /** Coupled consist size; the denominator of `wagonsUsed`. */
+  wagonsTotal?: number;
+  /** Wagons claimed by bookings (including unpaid) — not bookable. */
+  wagonsReserved?: number;
+  /** Wagons still bookable: consist minus what bookings have claimed. */
+  wagonsRemaining?: number;
+  /**
+   * Planned wagon ceiling for the departure, set when the schedule is created.
+   * Independent of the coupled consist — a schedule can plan 37 wagons before a
+   * single one is coupled, which is why this is the bookable figure until the
+   * train set is built.
+   */
+  maxWagons?: number;
+  /** Plan ceiling minus the coupled consist — room left to couple. */
+  remainingWagons?: number;
   totalWeightTons: number;
   totalLengthMeters: number;
   bookingsCount: number;
@@ -571,6 +595,35 @@ export interface UpdateScheduleWindowRulePayload {
   exportBookingLeadHours?: number;
 }
 
+/** One schedule touched by a merge, as summarised for the confirmation modal. */
+export interface MergeAffectedSchedule {
+  id: string;
+  reference: string | null;
+  scheduledDepartureDate: string;
+  status: string;
+}
+
+/**
+ * What merging a train into a schedule would do, computed server-side so the
+ * modal shows exactly what the commit will perform.
+ */
+export interface ScheduleMergePreview {
+  canMerge: boolean;
+  /** Why the merge is refused. Empty when `canMerge` is true. */
+  blockers: string[];
+  targetTrain: { id: string; code: string; trainNumber: string | null };
+  wagons: { current: number; incoming: number; merged: number };
+  /** The same-day schedule whose bookings move here; it is then removed. */
+  absorbedSchedule:
+    | (MergeAffectedSchedule & { bookingsMoving: number })
+    | null;
+  /** Other draft/scheduled schedules on the target — they gain wagons only. */
+  affectedSchedules: MergeAffectedSchedule[];
+  /** On the target train but left alone (dispatched, cancelled, …). */
+  untouchedSchedules: MergeAffectedSchedule[];
+  sourceTrainWillDeactivate: boolean;
+}
+
 export interface TrainScheduleDetail {
   id: string;
   reference?: string | null;
@@ -578,6 +631,8 @@ export interface TrainScheduleDetail {
   deferredBookings?: DeferredBookingRow[];
   freightType?: FreightType | null;
   trainNumber?: string | null;
+  /** Voyage (sailing) number for this departure — editable until dispatch. */
+  voyageNumber?: string | null;
   /** Wagon cap for this departure (built-train consist size or configured limit). */
   maxWagons?: number | null;
   /** Built train (Train Builder) behind this departure, when scheduled by train. */
@@ -621,6 +676,8 @@ export interface TrainScheduleDetail {
   trainSet?: {
     id: string;
     status: string;
+    /** The built train this set runs on — null when it has none yet. */
+    trainId?: string | null;
     wagonCount: number;
     totalWeightTons: number;
     totalLengthMeters: number;
@@ -853,10 +910,22 @@ export interface TrainTrackResponse {
 export interface RecordCheckpointPayload {
   sequenceNo: number;
   kind?: TrainCheckpointKind;
+  /** When the train was at the station; defaults to now. Past OK, future rejected. */
   occurredAt?: string;
   note?: string;
 }
 
+/** Edit an already-logged leg — pure correction, no side effects. */
+export interface UpdateCheckpointPayload {
+  occurredAt?: string;
+  note?: string | null;
+}
+
+export interface DispatchSchedulePayload {
+  /** Actual departure; defaults to now. Past OK, future rejected. */
+  actualDepartureAt?: string;
+}
+
 export interface TrainScheduleFilters {
   originStationId?: string;
   destinationStationId?: string;
@@ -906,6 +975,11 @@ export interface CreateTrainSchedulePayload {
   maxWagonsPerTrain?: number;
   /** Reverse the wagon order on this train: physically-last wagon becomes position 1. */
   reverseWagonOrder?: boolean;
+  /**
+   * Dedicate this departure to one shipping line — hidden from customers,
+   * visible only to that line in its portal. Omit for a normal customer train.
+   */
+  shippingLineCompanyId?: string;
   /**
    * Configure the booking window for THIS schedule instead of inheriting the
    * live global rules. Omit to follow the global rules (the default).
diff --git a/apps/edr-freight-web/backoffice/src/types/warehouse.ts b/apps/edr-freight-web/backoffice/src/types/warehouse.ts
index 6b11d4dcd..1773fb9b9 100644
--- a/apps/edr-freight-web/backoffice/src/types/warehouse.ts
+++ b/apps/edr-freight-web/backoffice/src/types/warehouse.ts
@@ -85,14 +85,15 @@ export function getNextInventoryAction(item: WarehouseInventoryItem): InventoryA
       if (isImport) return inspected ? 'ready-for-pickup' : null;
       return 'store';
     case 'STORED':
-      // Reserve is retired: a stored export item goes straight to loading prep
-      // once inspection passes. An import item parked back into storage returns
-      // to pickup — otherwise Store would strand it with no action.
+      // Reserve is retired: a stored export item goes straight to loading prep.
+      // 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;
+      return 'ready-for-loading';
     case 'RESERVED':
-      // Export loading is gated on a passed inspection.
-      return inspected ? 'ready-for-loading' : null;
+      // Export loading is not gated on inspection — inspection is tracked, but a
+      // train is never held waiting for it.
+      return 'ready-for-loading';
     case 'READY_FOR_PICKUP':
       // Issue the DO / release order first, then hand over the goods.
       return item.releaseDate ? 'deliver' : 'release';
@@ -298,6 +299,9 @@ export interface WarehouseDashboard {
   dispatched: number;
   readyForPickup: number;
   delivered: number;
+  emptyContainers: number;
+  importTrains: number;
+  exportTrains: number;
 }
 
 // ── Loading (Batch 3) ────────────────────────────────────────────────────────
diff --git a/apps/edr-freight-web/backoffice/src/user-management/AppMenuTabs.tsx b/apps/edr-freight-web/backoffice/src/user-management/AppMenuTabs.tsx
index 127806334..4e8f30561 100644
--- a/apps/edr-freight-web/backoffice/src/user-management/AppMenuTabs.tsx
+++ b/apps/edr-freight-web/backoffice/src/user-management/AppMenuTabs.tsx
@@ -1,250 +1,258 @@
-import { Link, useLocation } from "react-router-dom";
-import {
-  Archive,
-  BarChart,
-  Building2,
-  ChartAreaIcon,
-  ClipboardList,
-  FileText,
-  Globe,
-  Settings,
-  Users2,
-  UsersRound,
-} from "lucide-react";
-import { useTranslation } from "react-i18next";
-
-import { useAuth } from "@/shared/context/AuthContext";
-import {
-  SidebarGroup,
-  SidebarGroupContent,
-  SidebarGroupLabel,
-  SidebarMenu,
-  SidebarMenuButton,
-  SidebarMenuItem,
-  useSidebar,
-} from "@/shared/common/ui/sidebar";
-
-export interface MenuItem {
-  label: string;
-  href: string;
-  icon: React.ReactNode;
-  roles?: string[];
-  /** Sidebar section this item is bucketed under. */
-  group: string;
-}
-
-// Section render order; groups with no role-visible items are skipped.
-const GROUP_ORDER = [
-  "Overview",
-  "Organizations",
-  "Content",
-  "Records",
-  "Configuration",
-  "Archive",
-  "System",
-];
-
-export const AppMenuTabs = () => {
-  const { user } = useAuth();
-  const { pathname } = useLocation();
-  const { setOpenMobile } = useSidebar();
-  const { t } = useTranslation();
-
-  const userRoles = user?.roles.map((role) => role.key) || [];
-
-  const menuItems: MenuItem[] = [
-    {
-      label: "dashboard",
-      href: "/user-management/dashboard",
-      icon: <BarChart className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Overview",
-    },
-    {
-      label: "organizations",
-      href: "/user-management/organizations",
-      icon: <Building2 className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Organizations",
-    },
-    {
-      label: "organizationAdmins",
-      href: "/user-management/organization_admins",
-      icon: <Users2 className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Organizations",
-    },
-    {
-      label: "externalUsers",
-      href: "/user-management/external_users",
-      icon: <Users2 className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Organizations",
-    },
-    {
-      label: "dashboard",
-      href: "/user-management/user_management-dashboard",
-      icon: <BarChart className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Overview",
-    },
-    {
-      label: "userManagement",
-      href: "/user-management/user_management",
-      icon: <UsersRound className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Overview",
-    },
-    {
-      label: "contentManagement",
-      href: "/user-management/content-management",
-      icon: <FileText className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Content",
-    },
-    {
-      label: "webManagement",
-      href: "/user-management/web-management",
-      icon: <Globe className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Content",
-    },
-    {
-      label: "Bulk",
-      href: "/user-management/bulk-upload",
-      icon: <FileText className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Content",
-    },
-    {
-      label: "Position",
-      href: "/user-management/position-management",
-      icon: <FileText className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin", "super_admin"],
-      group: "Configuration",
-    },
-    {
-      label: "settings",
-      href: "/user-management/organization-settings",
-      icon: <Settings className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Configuration",
-    },
-    {
-      label: "Add Site",
-      href: "/user-management/add-site",
-      icon: <Globe className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Configuration",
-    },
-    {
-      label: "migratedRecords",
-      href: "/user-management/migrated-records-management",
-      icon: <FileText className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Records",
-    },
-    {
-      label: "Sector Reports",
-      href: "/user-management/sector-reports",
-      icon: <ChartAreaIcon className="h-4 w-4" />,
-      roles: ["unit_admin", "admin", "organization_admin"],
-      group: "Records",
-    },
-    {
-      label: "Archive Users",
-      href: "/user-management/archive-users",
-      icon: <Archive className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Archive",
-    },
-    {
-      label: "Archived Organizations",
-      href: "/user-management/archived-organizations",
-      icon: <Archive className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "Archive",
-    },
-    {
-      label: "Archive Users",
-      href: "/user-management/archives",
-      icon: <Archive className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Archive",
-    },
-    {
-      label: "Archived Units & Positions",
-      href: "/user-management/archived",
-      icon: <Archive className="h-4 w-4" />,
-      roles: ["admin", "organization_admin", "unit_admin"],
-      group: "Archive",
-    },
-    {
-      label: "activityLog",
-      href: "/user-management/activity_log",
-      icon: <ClipboardList className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "System",
-    },
-    {
-      label: "setting",
-      href: "/user-management/settings",
-      icon: <Settings className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "System",
-    },
-    {
-      label: "Letter Template",
-      href: "/user-management/templates",
-      icon: <FileText className="h-4 w-4" />,
-      roles: ["super_admin"],
-      group: "System",
-    },
-  ];
-
-  const filteredMenu = menuItems.filter((item) =>
-    item.roles?.some((r) => userRoles.includes(r)),
-  );
-
-  const isActive = (href: string) =>
-    pathname === href || pathname.startsWith(`${href}/`);
-
-  return (
-    <>
-      {GROUP_ORDER.map((group) => {
-        const items = filteredMenu.filter((item) => item.group === group);
-        if (items.length === 0) return null;
-
-        return (
-          <SidebarGroup key={group} className="pb-0">
-            <SidebarGroupLabel>{group}</SidebarGroupLabel>
-            <SidebarGroupContent>
-              <SidebarMenu>
-                {items.map((item) => {
-                  const label = t(`organization.${item.label}`, item.label);
-                  return (
-                    <SidebarMenuItem key={item.href}>
-                      <SidebarMenuButton
-                        asChild
-                        isActive={isActive(item.href)}
-                        tooltip={label}
-                      >
-                        <Link
-                          to={item.href}
-                          onClick={() => setOpenMobile(false)}
-                        >
-                          {item.icon}
-                          <span>{label}</span>
-                        </Link>
-                      </SidebarMenuButton>
-                    </SidebarMenuItem>
-                  );
-                })}
-              </SidebarMenu>
-            </SidebarGroupContent>
-          </SidebarGroup>
-        );
-      })}
-    </>
-  );
-};
+import { Link, useLocation } from "react-router-dom";
+import {
+  Archive,
+  BarChart,
+  Building2,
+  ChartAreaIcon,
+  ClipboardList,
+  FileText,
+  Globe,
+  MapPin,
+  Settings,
+  Users2,
+  UsersRound,
+} from "lucide-react";
+import { useTranslation } from "react-i18next";
+
+import { useAuth } from "@/shared/context/AuthContext";
+import {
+  SidebarGroup,
+  SidebarGroupContent,
+  SidebarGroupLabel,
+  SidebarMenu,
+  SidebarMenuButton,
+  SidebarMenuItem,
+  useSidebar,
+} from "@/shared/common/ui/sidebar";
+
+export interface MenuItem {
+  label: string;
+  href: string;
+  icon: React.ReactNode;
+  roles?: string[];
+  /** Sidebar section this item is bucketed under. */
+  group: string;
+}
+
+// Section render order; groups with no role-visible items are skipped.
+const GROUP_ORDER = [
+  "Overview",
+  "Organizations",
+  "Content",
+  "Records",
+  "Configuration",
+  "Archive",
+  "System",
+];
+
+export const AppMenuTabs = () => {
+  const { user } = useAuth();
+  const { pathname } = useLocation();
+  const { setOpenMobile } = useSidebar();
+  const { t } = useTranslation();
+
+  const userRoles = user?.roles.map((role) => role.key) || [];
+
+  const menuItems: MenuItem[] = [
+    {
+      label: "dashboard",
+      href: "/user-management/dashboard",
+      icon: <BarChart className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Overview",
+    },
+    {
+      label: "organizations",
+      href: "/user-management/organizations",
+      icon: <Building2 className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Organizations",
+    },
+    {
+      label: "organizationAdmins",
+      href: "/user-management/organization_admins",
+      icon: <Users2 className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Organizations",
+    },
+    {
+      label: "externalUsers",
+      href: "/user-management/external_users",
+      icon: <Users2 className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Organizations",
+    },
+    {
+      label: "dashboard",
+      href: "/user-management/user_management-dashboard",
+      icon: <BarChart className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Overview",
+    },
+    {
+      label: "userManagement",
+      href: "/user-management/user_management",
+      icon: <UsersRound className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Overview",
+    },
+    {
+      label: "contentManagement",
+      href: "/user-management/content-management",
+      icon: <FileText className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Content",
+    },
+    {
+      label: "webManagement",
+      href: "/user-management/web-management",
+      icon: <Globe className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Content",
+    },
+    {
+      label: "Bulk",
+      href: "/user-management/bulk-upload",
+      icon: <FileText className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Content",
+    },
+    {
+      label: "Position",
+      href: "/user-management/position-management",
+      icon: <FileText className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin", "super_admin"],
+      group: "Configuration",
+    },
+    {
+      label: "Locations",
+      href: "/user-management/locations",
+      icon: <MapPin className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin", "super_admin"],
+      group: "Configuration",
+    },
+    {
+      label: "settings",
+      href: "/user-management/organization-settings",
+      icon: <Settings className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Configuration",
+    },
+    {
+      label: "Add Site",
+      href: "/user-management/add-site",
+      icon: <Globe className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Configuration",
+    },
+    {
+      label: "migratedRecords",
+      href: "/user-management/migrated-records-management",
+      icon: <FileText className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Records",
+    },
+    {
+      label: "Sector Reports",
+      href: "/user-management/sector-reports",
+      icon: <ChartAreaIcon className="h-4 w-4" />,
+      roles: ["unit_admin", "admin", "organization_admin"],
+      group: "Records",
+    },
+    {
+      label: "Archive Users",
+      href: "/user-management/archive-users",
+      icon: <Archive className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Archive",
+    },
+    {
+      label: "Archived Organizations",
+      href: "/user-management/archived-organizations",
+      icon: <Archive className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "Archive",
+    },
+    {
+      label: "Archive Users",
+      href: "/user-management/archives",
+      icon: <Archive className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Archive",
+    },
+    {
+      label: "Archived Units & Positions",
+      href: "/user-management/archived",
+      icon: <Archive className="h-4 w-4" />,
+      roles: ["admin", "organization_admin", "unit_admin"],
+      group: "Archive",
+    },
+    {
+      label: "activityLog",
+      href: "/user-management/activity_log",
+      icon: <ClipboardList className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "System",
+    },
+    {
+      label: "setting",
+      href: "/user-management/settings",
+      icon: <Settings className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "System",
+    },
+    {
+      label: "Letter Template",
+      href: "/user-management/templates",
+      icon: <FileText className="h-4 w-4" />,
+      roles: ["super_admin"],
+      group: "System",
+    },
+  ];
+
+  const filteredMenu = menuItems.filter((item) =>
+    item.roles?.some((r) => userRoles.includes(r)),
+  );
+
+  const isActive = (href: string) =>
+    pathname === href || pathname.startsWith(`${href}/`);
+
+  return (
+    <>
+      {GROUP_ORDER.map((group) => {
+        const items = filteredMenu.filter((item) => item.group === group);
+        if (items.length === 0) return null;
+
+        return (
+          <SidebarGroup key={group} className="pb-0">
+            <SidebarGroupLabel>{group}</SidebarGroupLabel>
+            <SidebarGroupContent>
+              <SidebarMenu>
+                {items.map((item) => {
+                  const label = t(`organization.${item.label}`, item.label);
+                  return (
+                    <SidebarMenuItem key={item.href}>
+                      <SidebarMenuButton
+                        asChild
+                        isActive={isActive(item.href)}
+                        tooltip={label}
+                      >
+                        <Link
+                          to={item.href}
+                          onClick={() => setOpenMobile(false)}
+                        >
+                          {item.icon}
+                          <span>{label}</span>
+                        </Link>
+                      </SidebarMenuButton>
+                    </SidebarMenuItem>
+                  );
+                })}
+              </SidebarMenu>
+            </SidebarGroupContent>
+          </SidebarGroup>
+        );
+      })}
+    </>
+  );
+};
diff --git a/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationForm.tsx b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationForm.tsx
new file mode 100644
index 000000000..aeb03cd71
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationForm.tsx
@@ -0,0 +1,365 @@
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { zodResolver } from "@hookform/resolvers/zod";
+import {
+  APIProvider,
+  Map as GoogleMap,
+  Marker,
+  type MapMouseEvent,
+} from "@vis.gl/react-google-maps";
+
+import { Button } from "@/shared/common/ui/button";
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@/shared/common/ui/form";
+import { Input } from "@/shared/common/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/shared/common/ui/select";
+import { Textarea } from "@/shared/common/ui/textarea";
+import { useLocalizedName } from "@/shared/common/localizedName";
+import type {
+  Location,
+  LocationPayload,
+  LocationType,
+} from "@/user-management/dto/locations/location.type";
+import { useLocations } from "@/user-management/hooks/useLocations";
+
+const GOOGLE_MAPS_API_KEY = import.meta.env.VITE_GOOGLE_MAPS_API_KEY?.trim();
+/** Addis Ababa — where every EDR location is within a map pan. */
+const DEFAULT_CENTER = { lat: 9.032, lng: 38.7469 };
+
+const NO_PARENT = "__none__";
+
+const numeric = (label: string) =>
+  z
+    .string()
+    .trim()
+    .optional()
+    .refine((v) => !v || !Number.isNaN(Number(v)), `${label} must be a number`);
+
+const locationSchema = z.object({
+  nameAm: z.string().trim().min(1, "Amharic name is required"),
+  nameEn: z.string().trim().optional(),
+  code: z.string().trim().min(1, "Code is required"),
+  locationTypeId: z.string().uuid("Location type is required"),
+  parentId: z.string().optional(),
+  latitude: numeric("Latitude"),
+  longitude: numeric("Longitude"),
+  area: numeric("Area"),
+  boundaryJson: z
+    .string()
+    .trim()
+    .optional()
+    .refine((v) => {
+      if (!v) return true;
+      try {
+        const parsed = JSON.parse(v);
+        return typeof parsed === "object" && parsed !== null;
+      } catch {
+        return false;
+      }
+    }, "Boundary must be a JSON object"),
+});
+
+export type LocationFormValues = z.infer<typeof locationSchema>;
+
+interface LocationFormProps {
+  mode: "create" | "edit";
+  location?: Location;
+  locationTypes: LocationType[];
+  /** Every location, for the parent picker — the API has no filter endpoint. */
+  allLocations: Location[];
+  onSuccess?: () => void;
+}
+
+export function LocationForm({
+  mode,
+  location,
+  locationTypes,
+  allLocations,
+  onSuccess,
+}: LocationFormProps) {
+  const localizedName = useLocalizedName();
+  const { createLocation, updateLocation, isCreatingLocation, isUpdatingLocation } =
+    useLocations();
+
+  const form = useForm<LocationFormValues>({
+    resolver: zodResolver(locationSchema),
+    defaultValues: {
+      nameAm: location?.names?.am ?? "",
+      nameEn: location?.names?.en ?? "",
+      code: location?.code ?? "",
+      locationTypeId: location?.locationTypeId ?? "",
+      parentId: location?.parentId ?? NO_PARENT,
+      latitude: location?.latitude ?? "",
+      longitude: location?.longitude ?? "",
+      area: location?.area ?? "",
+      boundaryJson: location?.boundaryJson
+        ? JSON.stringify(location.boundaryJson, null, 2)
+        : "",
+    },
+  });
+
+  const [lat, lng] = [form.watch("latitude"), form.watch("longitude")];
+  const pin =
+    lat && lng && !Number.isNaN(Number(lat)) && !Number.isNaN(Number(lng))
+      ? { lat: Number(lat), lng: Number(lng) }
+      : null;
+
+  const dropPin = (event: MapMouseEvent) => {
+    const point = event.detail.latLng;
+    if (!point) return;
+    form.setValue("latitude", point.lat.toFixed(6), { shouldDirty: true });
+    form.setValue("longitude", point.lng.toFixed(6), { shouldDirty: true });
+  };
+
+  // ponytail: self only, not descendants — the API accepts any parentId, so a
+  // deep cycle (A → B → A) is still possible. Walk the chain here if it bites.
+  const parentOptions = allLocations.filter((item) => item.id !== location?.id);
+
+  const submit = (values: LocationFormValues) => {
+    const payload: LocationPayload = {
+      names: {
+        am: values.nameAm,
+        ...(values.nameEn ? { en: values.nameEn } : {}),
+      },
+      code: values.code,
+      locationTypeId: values.locationTypeId,
+      parentId:
+        values.parentId && values.parentId !== NO_PARENT
+          ? values.parentId
+          : undefined,
+      latitude: values.latitude || undefined,
+      longitude: values.longitude || undefined,
+      area: values.area || undefined,
+      boundaryJson: values.boundaryJson
+        ? (JSON.parse(values.boundaryJson) as Record<string, unknown>)
+        : undefined,
+    };
+
+    if (mode === "create") {
+      createLocation(payload, {
+        onSuccess: () => {
+          form.reset();
+          onSuccess?.();
+        },
+      });
+      return;
+    }
+    if (location) {
+      updateLocation(
+        { id: location.id, payload },
+        { onSuccess: () => onSuccess?.() },
+      );
+    }
+  };
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(submit)} className="space-y-4">
+        <div className="grid grid-cols-2 gap-4">
+          <FormField
+            control={form.control}
+            name="nameAm"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Amharic Name *</FormLabel>
+                <FormControl>
+                  <Input placeholder="አዲስ አበባ" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="nameEn"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>English Name</FormLabel>
+                <FormControl>
+                  <Input placeholder="Addis Ababa" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="code"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Code *</FormLabel>
+                <FormControl>
+                  <Input placeholder="LOC-001" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="locationTypeId"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Location Type *</FormLabel>
+                <Select onValueChange={field.onChange} value={field.value}>
+                  <FormControl>
+                    <SelectTrigger>
+                      <SelectValue placeholder="Select a type" />
+                    </SelectTrigger>
+                  </FormControl>
+                  <SelectContent>
+                    {locationTypes.map((type) => (
+                      <SelectItem key={type.id} value={type.id}>
+                        {localizedName(type.names)} · L{type.level}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="parentId"
+            render={({ field }) => (
+              <FormItem className="col-span-2">
+                <FormLabel>Parent Location</FormLabel>
+                <Select onValueChange={field.onChange} value={field.value}>
+                  <FormControl>
+                    <SelectTrigger>
+                      <SelectValue placeholder="No parent (top level)" />
+                    </SelectTrigger>
+                  </FormControl>
+                  <SelectContent>
+                    <SelectItem value={NO_PARENT}>
+                      No parent (top level)
+                    </SelectItem>
+                    {parentOptions.map((item) => (
+                      <SelectItem key={item.id} value={item.id}>
+                        {localizedName(item.names)} ({item.code})
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+        </div>
+
+        <div className="space-y-2">
+          <FormLabel>Coordinates</FormLabel>
+          {GOOGLE_MAPS_API_KEY ? (
+            <div className="h-64 w-full overflow-hidden rounded-md border">
+              <APIProvider apiKey={GOOGLE_MAPS_API_KEY}>
+                <GoogleMap
+                  defaultCenter={pin ?? DEFAULT_CENTER}
+                  defaultZoom={pin ? 12 : 6}
+                  gestureHandling="greedy"
+                  disableDefaultUI={false}
+                  onClick={dropPin}
+                  style={{ width: "100%", height: "100%" }}
+                >
+                  {pin ? <Marker position={pin} /> : null}
+                </GoogleMap>
+              </APIProvider>
+            </div>
+          ) : (
+            // Name the missing variable rather than rendering a dead grey box.
+            <p className="rounded-md border border-amber-200 bg-amber-50 p-3 text-sm text-amber-800">
+              Map picker unavailable — <code>VITE_GOOGLE_MAPS_API_KEY</code> is
+              not set. Type the coordinates below instead.
+            </p>
+          )}
+          {GOOGLE_MAPS_API_KEY ? (
+            <p className="text-xs text-muted-foreground">
+              Click the map to drop a pin, or type the values.
+            </p>
+          ) : null}
+        </div>
+
+        <div className="grid grid-cols-3 gap-4">
+          <FormField
+            control={form.control}
+            name="latitude"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Latitude</FormLabel>
+                <FormControl>
+                  <Input placeholder="9.032000" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="longitude"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Longitude</FormLabel>
+                <FormControl>
+                  <Input placeholder="38.746900" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="area"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Area</FormLabel>
+                <FormControl>
+                  <Input placeholder="1000.25" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+        </div>
+
+        <FormField
+          control={form.control}
+          name="boundaryJson"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Boundary (GeoJSON)</FormLabel>
+              <FormControl>
+                <Textarea
+                  rows={4}
+                  placeholder='{"type":"Polygon","coordinates":[]}'
+                  className="font-mono text-xs"
+                  {...field}
+                />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+
+        <Button
+          type="submit"
+          className="w-full"
+          disabled={isCreatingLocation || isUpdatingLocation}
+        >
+          {mode === "create" ? "Create Location" : "Save Changes"}
+        </Button>
+      </form>
+    </Form>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationTypeForm.tsx b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationTypeForm.tsx
new file mode 100644
index 000000000..242a53c7a
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationTypeForm.tsx
@@ -0,0 +1,173 @@
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { zodResolver } from "@hookform/resolvers/zod";
+
+import { Button } from "@/shared/common/ui/button";
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@/shared/common/ui/form";
+import { Input } from "@/shared/common/ui/input";
+import { Textarea } from "@/shared/common/ui/textarea";
+import type {
+  LocationType,
+  LocationTypePayload,
+} from "@/user-management/dto/locations/location.type";
+import { useLocationTypes } from "@/user-management/hooks/useLocationTypes";
+
+const locationTypeSchema = z.object({
+  nameAm: z.string().trim().min(1, "Amharic name is required"),
+  nameEn: z.string().trim().optional(),
+  code: z.string().trim().min(1, "Code is required"),
+  description: z.string().trim().optional(),
+  // Level is the hierarchy depth (1 = country, 2 = region, …). Server takes a
+  // number, so an empty string would post NaN.
+  level: z.coerce.number().int().min(1, "Level must be 1 or greater"),
+});
+
+export type LocationTypeFormValues = z.input<typeof locationTypeSchema>;
+
+interface LocationTypeFormProps {
+  mode: "create" | "edit";
+  locationType?: LocationType;
+  onSuccess?: () => void;
+}
+
+export function LocationTypeForm({
+  mode,
+  locationType,
+  onSuccess,
+}: LocationTypeFormProps) {
+  const {
+    createLocationType,
+    updateLocationType,
+    isCreatingLocationType,
+    isUpdatingLocationType,
+  } = useLocationTypes();
+
+  const form = useForm<LocationTypeFormValues, unknown, z.output<typeof locationTypeSchema>>({
+    resolver: zodResolver(locationTypeSchema),
+    defaultValues: {
+      nameAm: locationType?.names?.am ?? "",
+      nameEn: locationType?.names?.en ?? "",
+      code: locationType?.code ?? "",
+      description: locationType?.description ?? "",
+      level: locationType?.level ?? 1,
+    },
+  });
+
+  const submit = (values: z.output<typeof locationTypeSchema>) => {
+    const payload: LocationTypePayload = {
+      names: {
+        am: values.nameAm,
+        ...(values.nameEn ? { en: values.nameEn } : {}),
+      },
+      code: values.code,
+      description: values.description || undefined,
+      level: values.level,
+    };
+
+    if (mode === "create") {
+      createLocationType(payload, {
+        onSuccess: () => {
+          form.reset();
+          onSuccess?.();
+        },
+      });
+      return;
+    }
+    if (locationType) {
+      updateLocationType(
+        { id: locationType.id, payload },
+        { onSuccess: () => onSuccess?.() },
+      );
+    }
+  };
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(submit)} className="space-y-4">
+        <div className="grid grid-cols-2 gap-4">
+          <FormField
+            control={form.control}
+            name="nameAm"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Amharic Name *</FormLabel>
+                <FormControl>
+                  <Input placeholder="ከተማ" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="nameEn"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>English Name</FormLabel>
+                <FormControl>
+                  <Input placeholder="City" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="code"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Code *</FormLabel>
+                <FormControl>
+                  <Input placeholder="CITY" {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+          <FormField
+            control={form.control}
+            name="level"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>Level *</FormLabel>
+                <FormControl>
+                  <Input type="number" min={1} {...field} />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
+        </div>
+
+        <FormField
+          control={form.control}
+          name="description"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Description</FormLabel>
+              <FormControl>
+                <Textarea rows={3} placeholder="City level location" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+
+        <Button
+          type="submit"
+          className="w-full"
+          disabled={isCreatingLocationType || isUpdatingLocationType}
+        >
+          {mode === "create" ? "Create Location Type" : "Save Changes"}
+        </Button>
+      </form>
+    </Form>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationTypesTab.tsx b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationTypesTab.tsx
new file mode 100644
index 000000000..0a6cdd11d
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationTypesTab.tsx
@@ -0,0 +1,204 @@
+import { useState } from "react";
+import { ColumnDef } from "@tanstack/react-table";
+import { Pencil, Trash2 } from "lucide-react";
+
+import { useAuth } from "@/auth/useAuth";
+import { isSuperAdmin } from "@/lib/permissions";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/common/ui/alert-dialog";
+import { Button } from "@/shared/common/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/common/ui/dialog";
+import { AdvancedTable } from "@/shared/common/ui/table/AdvancedTable";
+import { useLocalizedName } from "@/shared/common/localizedName";
+import { usePermissions } from "@/shared/context/PermissionContext";
+import type { LocationType } from "@/user-management/dto/locations/location.type";
+import { useLocationTypes } from "@/user-management/hooks/useLocationTypes";
+import { LocationTypeForm } from "./LocationTypeForm";
+
+const PAGE_SIZE = 10;
+
+export function LocationTypesTab() {
+  const [pageIndex, setPageIndex] = useState(0);
+  const [editing, setEditing] = useState<LocationType | null>(null);
+  const [creating, setCreating] = useState(false);
+  const [deleting, setDeleting] = useState<LocationType | null>(null);
+
+  const localizedName = useLocalizedName();
+  const { permissions } = usePermissions();
+  const { user } = useAuth();
+  const superAdmin = isSuperAdmin(user);
+  const can = (key: string) => superAdmin || permissions.includes(key);
+
+  const {
+    locationTypes,
+    isLoadingLocationTypes,
+    refetchLocationTypes,
+    deleteLocationType,
+    isDeletingLocationType,
+  } = useLocationTypes({
+    skip: pageIndex * PAGE_SIZE,
+    take: PAGE_SIZE,
+    orderBy: "level:ASC",
+  });
+
+  const columns: ColumnDef<LocationType>[] = [
+    {
+      accessorKey: "names",
+      header: () => "Name",
+      cell: ({ row }) => <span>{localizedName(row.original.names)}</span>,
+    },
+    {
+      accessorKey: "code",
+      header: () => "Code",
+      cell: ({ row }) => <span>{row.original.code}</span>,
+    },
+    {
+      accessorKey: "level",
+      header: () => "Level",
+      cell: ({ row }) => <span>{row.original.level}</span>,
+    },
+    {
+      accessorKey: "description",
+      header: () => "Description",
+      cell: ({ row }) => <span>{row.original.description || "--"}</span>,
+    },
+    {
+      id: "actions",
+      header: () => "Actions",
+      cell: ({ row }) => (
+        <div className="flex gap-2">
+          <Button
+            variant="ghost"
+            size="icon"
+            disabled={!can("can:update:location_type")}
+            title={
+              can("can:update:location_type")
+                ? "Edit"
+                : "You cannot edit location types"
+            }
+            onClick={() => setEditing(row.original)}
+          >
+            <Pencil className="h-4 w-4" />
+          </Button>
+          <Button
+            variant="ghost"
+            size="icon"
+            disabled={!can("can:delete:location_type")}
+            title={
+              can("can:delete:location_type")
+                ? "Delete"
+                : "You cannot delete location types"
+            }
+            onClick={() => setDeleting(row.original)}
+          >
+            <Trash2 className="h-4 w-4 text-red-600" />
+          </Button>
+        </div>
+      ),
+    },
+  ];
+
+  return (
+    <div className="space-y-4">
+      <div className="flex justify-end">
+        <Button
+          disabled={!can("can:create:location_type")}
+          title={
+            can("can:create:location_type")
+              ? undefined
+              : "You cannot create location types"
+          }
+          onClick={() => setCreating(true)}
+        >
+          New Location Type
+        </Button>
+      </div>
+
+      <AdvancedTable
+        columns={columns}
+        data={locationTypes?.items ?? []}
+        tableName="Location Types"
+        isLoading={isLoadingLocationTypes}
+        itemCount={locationTypes?.count ?? 0}
+        pageIndex={pageIndex}
+        pageSize={PAGE_SIZE}
+        onPageChange={setPageIndex}
+        nextFunction={() => setPageIndex((page) => page + 1)}
+        prevFunction={() => setPageIndex((page) => Math.max(page - 1, 0))}
+        refresh={refetchLocationTypes}
+      />
+
+      <Dialog
+        open={creating || !!editing}
+        onOpenChange={(open) => {
+          if (!open) {
+            setCreating(false);
+            setEditing(null);
+          }
+        }}
+      >
+        <DialogContent className="max-w-xl">
+          <DialogHeader>
+            <DialogTitle>
+              {editing ? "Edit Location Type" : "New Location Type"}
+            </DialogTitle>
+          </DialogHeader>
+          <LocationTypeForm
+            key={editing?.id ?? "create"}
+            mode={editing ? "edit" : "create"}
+            locationType={editing ?? undefined}
+            onSuccess={() => {
+              setCreating(false);
+              setEditing(null);
+            }}
+          />
+        </DialogContent>
+      </Dialog>
+
+      <AlertDialog
+        open={!!deleting}
+        onOpenChange={(open) => !open && setDeleting(null)}
+      >
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>
+              Delete {deleting ? localizedName(deleting.names) : ""}?
+            </AlertDialogTitle>
+            <AlertDialogDescription>
+              This is a permanent delete. Locations already using this type will
+              block it at the foreign key.
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogAction
+              disabled={isDeletingLocationType}
+              onClick={() => {
+                if (deleting) {
+                  deleteLocationType(deleting.id, {
+                    onSuccess: () => setDeleting(null),
+                  });
+                }
+              }}
+            >
+              Delete
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationsTab.tsx b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationsTab.tsx
new file mode 100644
index 000000000..d3c63035d
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/components/location-management/LocationsTab.tsx
@@ -0,0 +1,233 @@
+import { useMemo, useState } from "react";
+import { ColumnDef } from "@tanstack/react-table";
+import { Pencil, Trash2 } from "lucide-react";
+
+import { useAuth } from "@/auth/useAuth";
+import { isSuperAdmin } from "@/lib/permissions";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/shared/common/ui/alert-dialog";
+import { Button } from "@/shared/common/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+} from "@/shared/common/ui/dialog";
+import { AdvancedTable } from "@/shared/common/ui/table/AdvancedTable";
+import { useLocalizedName } from "@/shared/common/localizedName";
+import { usePermissions } from "@/shared/context/PermissionContext";
+import type { Location } from "@/user-management/dto/locations/location.type";
+import { useLocations } from "@/user-management/hooks/useLocations";
+import { useLocationTypes } from "@/user-management/hooks/useLocationTypes";
+import { LocationForm } from "./LocationForm";
+
+const PAGE_SIZE = 10;
+/** The API has no filter endpoint, so the parent picker and the type/parent
+ * name columns are resolved from one big list. */
+const LOOKUP_TAKE = 1000;
+
+export function LocationsTab() {
+  const [pageIndex, setPageIndex] = useState(0);
+  const [editing, setEditing] = useState<Location | null>(null);
+  const [creating, setCreating] = useState(false);
+  const [deleting, setDeleting] = useState<Location | null>(null);
+
+  const localizedName = useLocalizedName();
+  const { permissions } = usePermissions();
+  const { user } = useAuth();
+  const superAdmin = isSuperAdmin(user);
+  const can = (key: string) => superAdmin || permissions.includes(key);
+
+  const { locations, isLoadingLocations, refetchLocations, deleteLocation, isDeletingLocation } =
+    useLocations({ skip: pageIndex * PAGE_SIZE, take: PAGE_SIZE });
+  const { locations: allLocations } = useLocations({ take: LOOKUP_TAKE });
+  const { locationTypes } = useLocationTypes({ take: LOOKUP_TAKE });
+
+  const typeName = useMemo(() => {
+    const byId = new Map(
+      (locationTypes?.items ?? []).map((type) => [type.id, type]),
+    );
+    return (id: string) => {
+      const type = byId.get(id);
+      return type ? `${localizedName(type.names)} (L${type.level})` : "--";
+    };
+  }, [locationTypes, localizedName]);
+
+  const parentName = useMemo(() => {
+    const byId = new Map(
+      (allLocations?.items ?? []).map((item) => [item.id, item]),
+    );
+    return (id?: string | null) => {
+      if (!id) return "--";
+      const parent = byId.get(id);
+      return parent ? localizedName(parent.names) : id.slice(0, 8);
+    };
+  }, [allLocations, localizedName]);
+
+  const columns: ColumnDef<Location>[] = [
+    {
+      accessorKey: "names",
+      header: () => "Name",
+      cell: ({ row }) => <span>{localizedName(row.original.names)}</span>,
+    },
+    {
+      accessorKey: "code",
+      header: () => "Code",
+      cell: ({ row }) => <span>{row.original.code}</span>,
+    },
+    {
+      accessorKey: "locationTypeId",
+      header: () => "Type",
+      cell: ({ row }) => <span>{typeName(row.original.locationTypeId)}</span>,
+    },
+    {
+      accessorKey: "parentId",
+      header: () => "Parent",
+      cell: ({ row }) => <span>{parentName(row.original.parentId)}</span>,
+    },
+    {
+      id: "coordinates",
+      header: () => "Coordinates",
+      cell: ({ row }) => {
+        const { latitude, longitude } = row.original;
+        return (
+          <span>{latitude && longitude ? `${latitude}, ${longitude}` : "--"}</span>
+        );
+      },
+    },
+    {
+      id: "actions",
+      header: () => "Actions",
+      cell: ({ row }) => (
+        <div className="flex gap-2">
+          <Button
+            variant="ghost"
+            size="icon"
+            disabled={!can("can:update:location")}
+            title={
+              can("can:update:location") ? "Edit" : "You cannot edit locations"
+            }
+            onClick={() => setEditing(row.original)}
+          >
+            <Pencil className="h-4 w-4" />
+          </Button>
+          <Button
+            variant="ghost"
+            size="icon"
+            disabled={!can("can:delete:location")}
+            title={
+              can("can:delete:location")
+                ? "Delete"
+                : "You cannot delete locations"
+            }
+            onClick={() => setDeleting(row.original)}
+          >
+            <Trash2 className="h-4 w-4 text-red-600" />
+          </Button>
+        </div>
+      ),
+    },
+  ];
+
+  return (
+    <div className="space-y-4">
+      <div className="flex justify-end">
+        <Button
+          disabled={!can("can:create:location")}
+          title={
+            can("can:create:location")
+              ? undefined
+              : "You cannot create locations"
+          }
+          onClick={() => setCreating(true)}
+        >
+          New Location
+        </Button>
+      </div>
+
+      <AdvancedTable
+        columns={columns}
+        data={locations?.items ?? []}
+        tableName="Locations"
+        isLoading={isLoadingLocations}
+        itemCount={locations?.count ?? 0}
+        pageIndex={pageIndex}
+        pageSize={PAGE_SIZE}
+        onPageChange={setPageIndex}
+        nextFunction={() => setPageIndex((page) => page + 1)}
+        prevFunction={() => setPageIndex((page) => Math.max(page - 1, 0))}
+        refresh={refetchLocations}
+      />
+
+      <Dialog
+        open={creating || !!editing}
+        onOpenChange={(open) => {
+          if (!open) {
+            setCreating(false);
+            setEditing(null);
+          }
+        }}
+      >
+        <DialogContent className="max-w-2xl max-h-[90vh] overflow-y-auto">
+          <DialogHeader>
+            <DialogTitle>
+              {editing ? "Edit Location" : "New Location"}
+            </DialogTitle>
+          </DialogHeader>
+          <LocationForm
+            key={editing?.id ?? "create"}
+            mode={editing ? "edit" : "create"}
+            location={editing ?? undefined}
+            locationTypes={locationTypes?.items ?? []}
+            allLocations={allLocations?.items ?? []}
+            onSuccess={() => {
+              setCreating(false);
+              setEditing(null);
+            }}
+          />
+        </DialogContent>
+      </Dialog>
+
+      <AlertDialog
+        open={!!deleting}
+        onOpenChange={(open) => !open && setDeleting(null)}
+      >
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>
+              Delete {deleting ? localizedName(deleting.names) : ""}?
+            </AlertDialogTitle>
+            <AlertDialogDescription>
+              This is a permanent delete, not an archive. A location that still
+              has child locations or unit clusters attached will be refused by
+              the database.
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogAction
+              disabled={isDeletingLocation}
+              onClick={() => {
+                if (deleting) {
+                  deleteLocation(deleting.id, {
+                    onSuccess: () => setDeleting(null),
+                  });
+                }
+              }}
+            >
+              Delete
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/user-management/dto/locations/location.type.ts b/apps/edr-freight-web/backoffice/src/user-management/dto/locations/location.type.ts
new file mode 100644
index 000000000..92acbac3a
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/dto/locations/location.type.ts
@@ -0,0 +1,54 @@
+/**
+ * IAM organisation-structure locations. The API is `@tria-plc/iamapi-common`'s
+ * generic CRUD controller: list returns `{ count, items }` flattened into the
+ * response envelope (`/api/locations` is in `flatResponseModules`), and it
+ * joins nothing — `locationType` and `parent` are NOT expanded, so the UI
+ * resolves both from the type/location lists it already loaded.
+ */
+export interface LocaleName {
+  am: string;
+  en?: string;
+}
+
+export interface LocationType {
+  id: string;
+  code: string;
+  names: LocaleName;
+  description?: string | null;
+  level: number;
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+export interface Location {
+  id: string;
+  parentId?: string | null;
+  locationTypeId: string;
+  names: LocaleName;
+  code: string;
+  /** Decimal strings server-side, not numbers. */
+  latitude?: string | null;
+  longitude?: string | null;
+  area?: string | null;
+  boundaryJson?: Record<string, unknown> | null;
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+export interface ListResponse<T> {
+  count: number;
+  items: T[];
+}
+
+export interface ListQuery {
+  skip?: number;
+  take?: number;
+  /** `field:ASC` / `field:DESC`, comma separated. No search or filter exists. */
+  orderBy?: string;
+}
+
+export type LocationPayload = Omit<Location, "id" | "createdAt" | "updatedAt">;
+export type LocationTypePayload = Omit<
+  LocationType,
+  "id" | "createdAt" | "updatedAt"
+>;
diff --git a/apps/edr-freight-web/backoffice/src/user-management/hooks/useLocationTypes.ts b/apps/edr-freight-web/backoffice/src/user-management/hooks/useLocationTypes.ts
new file mode 100644
index 000000000..e33f62e40
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/hooks/useLocationTypes.ts
@@ -0,0 +1,93 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+
+import { useErrorHandler } from "@/shared/hooks/useErrorHandler";
+import type {
+  ListQuery,
+  ListResponse,
+  LocationType,
+  LocationTypePayload,
+} from "@/user-management/dto/locations/location.type";
+import { locationTypeService } from "../services/api/locationService";
+
+export const useLocationTypes = (params: ListQuery = {}) => {
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+  const queryClient = useQueryClient();
+
+  const invalidate = () =>
+    queryClient.invalidateQueries({ queryKey: ["location-types"] });
+
+  const {
+    data: locationTypes,
+    isLoading: isLoadingLocationTypes,
+    isError: isErrorLocationTypes,
+    refetch: refetchLocationTypes,
+  } = useQuery<ListResponse<LocationType>>({
+    queryKey: ["location-types", params],
+    queryFn: async () => {
+      const { data } = await locationTypeService.list(params);
+      return { count: data?.count ?? 0, items: data?.items ?? [] };
+    },
+    staleTime: 5 * 60 * 1000,
+  });
+
+  const { mutate: createLocationType, isPending: isCreatingLocationType } =
+    useMutation({
+      mutationFn: async (payload: LocationTypePayload) => {
+        const { data } = await locationTypeService.create(payload);
+        return data;
+      },
+      onSuccess: () => {
+        toast.success(t("locationType.created", "Location type created"));
+        invalidate();
+      },
+      onError: handleError,
+    });
+
+  const { mutate: updateLocationType, isPending: isUpdatingLocationType } =
+    useMutation({
+      mutationFn: async ({
+        id,
+        payload,
+      }: {
+        id: string;
+        payload: LocationTypePayload;
+      }) => {
+        const { data } = await locationTypeService.update(id, payload);
+        return data;
+      },
+      onSuccess: () => {
+        toast.success(t("locationType.updated", "Location type updated"));
+        invalidate();
+      },
+      onError: handleError,
+    });
+
+  const { mutate: deleteLocationType, isPending: isDeletingLocationType } =
+    useMutation({
+      mutationFn: async (id: string) => {
+        const { data } = await locationTypeService.remove(id);
+        return data;
+      },
+      onSuccess: () => {
+        toast.success(t("locationType.deleted", "Location type deleted"));
+        invalidate();
+      },
+      onError: handleError,
+    });
+
+  return {
+    locationTypes,
+    isLoadingLocationTypes,
+    isErrorLocationTypes,
+    refetchLocationTypes,
+    createLocationType,
+    isCreatingLocationType,
+    updateLocationType,
+    isUpdatingLocationType,
+    deleteLocationType,
+    isDeletingLocationType,
+  };
+};
diff --git a/apps/edr-freight-web/backoffice/src/user-management/hooks/useLocations.ts b/apps/edr-freight-web/backoffice/src/user-management/hooks/useLocations.ts
new file mode 100644
index 000000000..43e68b567
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/hooks/useLocations.ts
@@ -0,0 +1,95 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+
+import { useErrorHandler } from "@/shared/hooks/useErrorHandler";
+import type {
+  ListQuery,
+  ListResponse,
+  Location,
+  LocationPayload,
+} from "@/user-management/dto/locations/location.type";
+import { locationService } from "../services/api/locationService";
+
+/**
+ * `params` is the whole server-side query surface: skip/take/orderBy. There is
+ * no search or filter endpoint, so a caller that needs every location (parent
+ * picker, name lookups) asks for a large `take`.
+ */
+export const useLocations = (params: ListQuery = {}) => {
+  const { t } = useTranslation();
+  const { handleError } = useErrorHandler(t);
+  const queryClient = useQueryClient();
+
+  const invalidate = () =>
+    queryClient.invalidateQueries({ queryKey: ["locations"] });
+
+  const {
+    data: locations,
+    isLoading: isLoadingLocations,
+    isError: isErrorLocations,
+    refetch: refetchLocations,
+  } = useQuery<ListResponse<Location>>({
+    queryKey: ["locations", params],
+    queryFn: async () => {
+      const { data } = await locationService.list(params);
+      return { count: data?.count ?? 0, items: data?.items ?? [] };
+    },
+    staleTime: 5 * 60 * 1000,
+  });
+
+  const { mutate: createLocation, isPending: isCreatingLocation } = useMutation({
+    mutationFn: async (payload: LocationPayload) => {
+      const { data } = await locationService.create(payload);
+      return data;
+    },
+    onSuccess: () => {
+      toast.success(t("location.created", "Location created"));
+      invalidate();
+    },
+    onError: handleError,
+  });
+
+  const { mutate: updateLocation, isPending: isUpdatingLocation } = useMutation({
+    mutationFn: async ({
+      id,
+      payload,
+    }: {
+      id: string;
+      payload: LocationPayload;
+    }) => {
+      const { data } = await locationService.update(id, payload);
+      return data;
+    },
+    onSuccess: () => {
+      toast.success(t("location.updated", "Location updated"));
+      invalidate();
+    },
+    onError: handleError,
+  });
+
+  const { mutate: deleteLocation, isPending: isDeletingLocation } = useMutation({
+    mutationFn: async (id: string) => {
+      const { data } = await locationService.remove(id);
+      return data;
+    },
+    onSuccess: () => {
+      toast.success(t("location.deleted", "Location deleted"));
+      invalidate();
+    },
+    onError: handleError,
+  });
+
+  return {
+    locations,
+    isLoadingLocations,
+    isErrorLocations,
+    refetchLocations,
+    createLocation,
+    isCreatingLocation,
+    updateLocation,
+    isUpdatingLocation,
+    deleteLocation,
+    isDeletingLocation,
+  };
+};
diff --git a/apps/edr-freight-web/backoffice/src/user-management/pages/location-management/index.tsx b/apps/edr-freight-web/backoffice/src/user-management/pages/location-management/index.tsx
new file mode 100644
index 000000000..b8ac18350
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/pages/location-management/index.tsx
@@ -0,0 +1,35 @@
+import {
+  Tabs,
+  TabsContent,
+  TabsList,
+  TabsTrigger,
+} from "@/shared/common/ui/tabs";
+import { LocationsTab } from "@/user-management/components/location-management/LocationsTab";
+import { LocationTypesTab } from "@/user-management/components/location-management/LocationTypesTab";
+
+export default function LocationManagementPage() {
+  return (
+    <div className="w-full space-y-6 p-6">
+      <div>
+        <h1 className="text-2xl font-semibold">Location Management</h1>
+        <p className="text-sm text-muted-foreground">
+          Locations and their hierarchy levels, shared across the IAM
+          organisation structure.
+        </p>
+      </div>
+
+      <Tabs defaultValue="locations">
+        <TabsList>
+          <TabsTrigger value="locations">Locations</TabsTrigger>
+          <TabsTrigger value="types">Location Types</TabsTrigger>
+        </TabsList>
+        <TabsContent value="locations" className="pt-4">
+          <LocationsTab />
+        </TabsContent>
+        <TabsContent value="types" className="pt-4">
+          <LocationTypesTab />
+        </TabsContent>
+      </Tabs>
+    </div>
+  );
+}
diff --git a/apps/edr-freight-web/backoffice/src/user-management/route.tsx b/apps/edr-freight-web/backoffice/src/user-management/route.tsx
index f1e2a8611..93e414c50 100644
--- a/apps/edr-freight-web/backoffice/src/user-management/route.tsx
+++ b/apps/edr-freight-web/backoffice/src/user-management/route.tsx
@@ -3,13 +3,14 @@ import { Navigate, Outlet, Route } from "react-router-dom";
 
 import { useAuth } from "@/auth/useAuth";
 import { NO_ACCESS_PATH, resolveLandingPath } from "@/lib/landing";
-import { isSuperAdmin } from "@/lib/permissions";
+import { FREIGHT_PERMS, isSuperAdmin } from "@/lib/permissions";
 import { WithPermission } from "@/shared/hooks/useHas";
 import PendingExternalUsers from "@/super-admin/components/externalUsers/PendingExternalUsers";
 import TemplatePage from "@/super-admin/components/templates/components/templates";
 import CreatePositionPage from "./pages/position-management/create";
 import EditPositionPage from "./pages/position-management/edit";
 import PositionManagementPage from "./pages/position-management";
+import LocationManagementPage from "./pages/location-management";
 import MigratedDataManagementPage from "./pages/position-management/MigratedDataManagementPage";
 import UserPositionApprovalPage from "./pages/UserPositionApprovalPage";
 import ViewMigratedDataPage from "./components/MigratedRecords/ViewMigratedDataPage";
@@ -44,6 +45,8 @@ import { SidebarProvider } from "@/shared/common/ui/sidebar";
 import { AuthProvider as UmAuthProvider } from "@/shared/context/AuthContext";
 import { PermissionProvider } from "@/shared/context/PermissionContext";
 import UserManagementPage from "@/pages/UserManagementPage";
+import { RequirePermission } from "@/components/auth/RequirePermission";
+import UploadTeeterAndSignature from "@/record-management/components/Settings/uploadTeeterandSingature";
 
 /**
  * Provider shell for the vendored IAM UI. Feeds its Auth + Permission contexts
@@ -138,6 +141,33 @@ export function UserManagementRoutes(): ReactElement {
                           path="user-management/position-management"
                           element={<PositionManagementPage />}
                         />
+                        <Route
+                          path="user-management/locations"
+                          element={<LocationManagementPage />}
+                        />
+                        {/*
+                          The per-officer teeter (ማህተም) + signature upload. This
+                          is NOT the company stamp: it is the individual approval
+                          stamp a record officer applies to records, locale-aware
+                          (am/en) and genuinely per-person. It used to sit at
+                          /dashboard/stamp-settings under Settings, next to the
+                          single global company stamp, which read as duplication.
+
+                          Gated by settings:teeter:*, split out of settings:stamp:*
+                          when the two were untangled — settings:stamp:* now means
+                          the company stamp, so anyone who held it for the teeter
+                          needs the new key granted.
+                        */}
+                        <Route
+                          path="user-management/teeter-and-signature"
+                          element={
+                            <RequirePermission
+                              permission={FREIGHT_PERMS.settings.teeter.view}
+                            >
+                              <UploadTeeterAndSignature />
+                            </RequirePermission>
+                          }
+                        />
                         <Route
                           path="user-management/migrated-records-management"
                           element={<MigratedDataManagementPage />}
diff --git a/apps/edr-freight-web/backoffice/src/user-management/services/api/locationService.ts b/apps/edr-freight-web/backoffice/src/user-management/services/api/locationService.ts
new file mode 100644
index 000000000..56d2596ba
--- /dev/null
+++ b/apps/edr-freight-web/backoffice/src/user-management/services/api/locationService.ts
@@ -0,0 +1,55 @@
+import { withHeaders } from "@/record-management/services/api/withHeaders";
+import axiosInstance from "@/shared/services/axiosInstance";
+import type {
+  ListQuery,
+  ListResponse,
+  Location,
+  LocationPayload,
+  LocationType,
+  LocationTypePayload,
+} from "@/user-management/dto/locations/location.type";
+import { AxiosResponse } from "axios";
+
+export const locationService = {
+  list: (
+    params: ListQuery = {},
+  ): Promise<AxiosResponse<ListResponse<Location>>> =>
+    axiosInstance.get(`/locations`, { params, headers: withHeaders() }),
+
+  create: (payload: LocationPayload): Promise<AxiosResponse<Location>> =>
+    axiosInstance.post(`/locations`, payload, { headers: withHeaders() }),
+
+  update: (
+    id: string,
+    payload: LocationPayload,
+  ): Promise<AxiosResponse<Location>> =>
+    axiosInstance.put(`/locations/${id}`, payload, { headers: withHeaders() }),
+
+  // Hard delete server-side — a location with children or unit clusters fails
+  // on the foreign key rather than returning a tidy 409.
+  remove: (id: string): Promise<AxiosResponse<void>> =>
+    axiosInstance.delete(`/locations/${id}`, { headers: withHeaders() }),
+};
+
+export const locationTypeService = {
+  list: (
+    params: ListQuery = {},
+  ): Promise<AxiosResponse<ListResponse<LocationType>>> =>
+    axiosInstance.get(`/location-types`, { params, headers: withHeaders() }),
+
+  create: (
+    payload: LocationTypePayload,
+  ): Promise<AxiosResponse<LocationType>> =>
+    axiosInstance.post(`/location-types`, payload, { headers: withHeaders() }),
+
+  update: (
+    id: string,
+    payload: LocationTypePayload,
+  ): Promise<AxiosResponse<LocationType>> =>
+    axiosInstance.put(`/location-types/${id}`, payload, {
+      headers: withHeaders(),
+    }),
+
+  remove: (id: string): Promise<AxiosResponse<void>> =>
+    axiosInstance.delete(`/location-types/${id}`, { headers: withHeaders() }),
+};
diff --git a/apps/edr-freight-web/backoffice/src/utils/cargoWeight.ts b/apps/edr-freight-web/backoffice/src/utils/cargoWeight.ts
index 7e90313dd..45056ace2 100644
--- a/apps/edr-freight-web/backoffice/src/utils/cargoWeight.ts
+++ b/apps/edr-freight-web/backoffice/src/utils/cargoWeight.ts
@@ -1,18 +1,32 @@
 /**
  * Break-bulk (PER_ITEM) bulk bookings overload `cargoTotalWeightVgm` with the
- * ITEM COUNT; their real tonnage lives in `bulkTotalWeightTons`. Every other
- * booking stores tons in `cargoTotalWeightVgm` directly. Rendering the raw
- * VGM column showed a 20-item / 100T booking as "20 tons".
+ * ITEM COUNT; their real tonnage lives in `bulkTotalWeightTons`. Container
+ * bookings never store a total at all — `cargoTotalWeightVgm` stays 0 and the
+ * weight lives per line (`quantity × vgmPerUnitTons`). Every other booking
+ * stores tons in `cargoTotalWeightVgm` directly. Rendering the raw VGM column
+ * showed a 20-item / 100T booking as "20 tons" and every container booking as
+ * "0 tons".
  */
 export function cargoTonsAndItems(booking: {
   freightType?: string | null;
   cargoTotalWeightVgm?: number | string | null;
   bulkTotalWeightTons?: number | string | null;
+  bookingContainers?: Array<{
+    quantity?: number | string | null;
+    vgmPerUnitTons?: number | string | null;
+  }> | null;
 }): { tons: number; items: number | null } {
   const bulkTons = Number(booking.bulkTotalWeightTons ?? 0);
   const vgm = Number(booking.cargoTotalWeightVgm ?? 0);
   if (booking.freightType === "BULK" && bulkTons > 0) {
     return { tons: bulkTons, items: vgm > 0 ? vgm : null };
   }
+  if (vgm <= 0 && booking.bookingContainers?.length) {
+    const lineTons = booking.bookingContainers.reduce(
+      (sum, c) => sum + Number(c.quantity ?? 0) * Number(c.vgmPerUnitTons ?? 0),
+      0,
+    );
+    return { tons: Math.round(lineTons * 1000) / 1000, items: null };
+  }
   return { tons: vgm, items: null };
 }
diff --git a/apps/edr-freight-web/backoffice/src/utils/endpoint.ts b/apps/edr-freight-web/backoffice/src/utils/endpoint.ts
index 02bc70e85..bc0b01cd7 100644
--- a/apps/edr-freight-web/backoffice/src/utils/endpoint.ts
+++ b/apps/edr-freight-web/backoffice/src/utils/endpoint.ts
@@ -33,6 +33,27 @@ export type InvalidatesMeta = (
   data: unknown,
 ) => ReadonlyArray<readonly unknown[]>;
 
+/**
+ * Cache entries a mutation can write DIRECTLY from its own response, skipping
+ * a refetch. Many endpoints already return the fresh entity they just changed
+ * (e.g. every train-builder mutation returns the whole `TrainComposition`), so
+ * re-fetching that same key is a wasted round-trip and a visible flicker.
+ *
+ * Returned pairs are written with `setQueryData` by the app-wide MutationCache
+ * BEFORE the `invalidates` keys are invalidated, and any key seeded here is
+ * skipped by that invalidation pass — the value just written IS the fresh one.
+ */
+export type UpdatesFn<TInput, TResponse> = (
+  input: TInput,
+  data: TResponse,
+) => ReadonlyArray<readonly [readonly unknown[], unknown]>;
+
+/** Shape stored in `mutation.meta.updates` and consumed by the MutationCache. */
+export type UpdatesMeta = (
+  variables: unknown,
+  data: unknown,
+) => ReadonlyArray<readonly [readonly unknown[], unknown]>;
+
 // ---------------------------------------------------------------------------
 // Endpoint interfaces
 // ---------------------------------------------------------------------------
@@ -67,6 +88,7 @@ export function endpoint<TInput, TResponse>(
   execute: (input: TInput) => Promise<TResponse>,
   queryKeyBuilder?: (input: TInput) => readonly unknown[],
   invalidates?: InvalidatesFn<TInput, TResponse>,
+  updates?: UpdatesFn<TInput, TResponse>,
 ) {
   const buildKey = (input?: TInput): readonly unknown[] => {
     if (queryKeyBuilder && input !== undefined) {
@@ -101,16 +123,30 @@ export function endpoint<TInput, TResponse>(
   const mutationOptions = (
     config?: Omit<UseMutationOptions<TResponse, Error, TInput>, "mutationFn">,
   ): UseMutationOptions<TResponse, Error, TInput> => {
-    const meta = invalidates
-      ? {
-          ...config?.meta,
-          invalidates: ((variables, data) =>
-            invalidates(
-              variables as TInput,
-              data as TResponse,
-            )) satisfies InvalidatesMeta,
-        }
-      : config?.meta;
+    const meta =
+      invalidates || updates
+        ? {
+            ...config?.meta,
+            ...(invalidates
+              ? {
+                  invalidates: ((variables, data) =>
+                    invalidates(
+                      variables as TInput,
+                      data as TResponse,
+                    )) satisfies InvalidatesMeta,
+                }
+              : {}),
+            ...(updates
+              ? {
+                  updates: ((variables, data) =>
+                    updates(
+                      variables as TInput,
+                      data as TResponse,
+                    )) satisfies UpdatesMeta,
+                }
+              : {}),
+          }
+        : config?.meta;
 
     return {
       ...config,
diff --git a/apps/edr-freight-web/portal/index.css b/apps/edr-freight-web/portal/index.css
index 856c46262..be4447f57 100644
--- a/apps/edr-freight-web/portal/index.css
+++ b/apps/edr-freight-web/portal/index.css
@@ -1,10 +1,13 @@
 @import "tailwindcss";
 @import "@edr/ui-common/theme.css" layer(theme);
 
-/* Dark mode is toggled via the `dark` class on <html>. Without this, Tailwind
-   v4 compiles `dark:` utilities to `@media (prefers-color-scheme: dark)` and
-   they follow the OS setting instead of the in-app toggle. */
-@custom-variant dark (&:where(.dark, .dark *));
+/* The portal is light-only — there is no theme toggle and nothing sets the
+   `dark` class. This override is load-bearing: without it Tailwind v4 compiles
+   `dark:` utilities to `@media (prefers-color-scheme: dark)`, so every
+   leftover `dark:` class in the tree would activate on an OS-level dark
+   setting. Binding the variant to a class that is never rendered keeps those
+   utilities inert no matter what the OS (or a stray `.dark` class) says. */
+@custom-variant dark (&:where(.edr-dark-disabled));
 
 /* Bridge the central Mantine theme into Tailwind. Mantine (createTheme) is the
    single source of truth; these just alias its generated CSS variables so
diff --git a/apps/edr-freight-web/portal/package.json b/apps/edr-freight-web/portal/package.json
index 4bb96ee4f..81800f447 100644
--- a/apps/edr-freight-web/portal/package.json
+++ b/apps/edr-freight-web/portal/package.json
@@ -33,6 +33,7 @@
     "react-dom": "19.2.6",
     "react-hook-form": "^7.76.0",
     "react-hot-toast": "^2.6.0",
+    "react-markdown": "^9.1.0",
     "react-phone-number-input": "^3.4.17",
     "react-router-dom": "^6.27.0",
     "recharts": "^3.8.1",
diff --git a/apps/edr-freight-web/portal/public/assets/cbe.png b/apps/edr-freight-web/portal/public/assets/cbe.png
new file mode 100644
index 000000000..c1da424f4
Binary files /dev/null and b/apps/edr-freight-web/portal/public/assets/cbe.png differ
diff --git a/apps/edr-freight-web/portal/src/App.tsx b/apps/edr-freight-web/portal/src/App.tsx
index e14714334..8ab2f60d1 100644
--- a/apps/edr-freight-web/portal/src/App.tsx
+++ b/apps/edr-freight-web/portal/src/App.tsx
@@ -59,6 +59,15 @@ import CheckPaymentPage from "./pages/payments/CheckPaymentPage";
 import PaymentFailurePage from "./pages/payments/PaymentFailurePage";
 import FaydaCallbackPage from "./pages/FaydaCallbackPage";
 import PaymentSuccessPage from "./pages/payments/PaymentSuccessPage";
+import {
+  ShippingLineBookingDetailPage,
+  ShippingLineBookingsPage,
+  ShippingLineCompletePage,
+  ShippingLineHelpPage,
+  ShippingLineHomePage,
+  ShippingLineInvoicesPage,
+  ShippingLineSettingsPage,
+} from "./pages/shipping-line";
 import FaqPage from "./pages/support/FaqPage";
 import HelpPage from "./pages/support/HelpPage";
 import PrivacyPolicyPage from "./pages/support/PrivacyPolicyPage";
@@ -129,12 +138,20 @@ function isOnboardingAllowedPath(pathname: string): boolean {
  * can be dismissed to use those pages. Visiting any other page bounces back to
  * home and re-opens the wizard. New users (no company yet) are treated the same
  * as users who haven't completed onboarding.
+ *
+ * Shipping lines are exempt: staff register them with their details already
+ * captured, so there is nothing for them to onboard — they go straight to home.
  */
 function OnboardingGate() {
-  const { company, onboardingCompleted } = useAuth();
+  const { company, onboardingCompleted, isShippingLine } = useAuth();
   const location = useLocation();
 
-  const needsOnboarding = !company || !onboardingCompleted;
+  // Keyed off a positive shipping-line identification, never off "no company":
+  // that is also true mid-fetch and on error, which would let customers slip
+  // past onboarding whenever the request failed.
+  const needsOnboarding = isShippingLine
+    ? false
+    : !company || !onboardingCompleted;
   const allowedHere = isOnboardingAllowedPath(location.pathname);
 
   // Open by default while onboarding is pending (covers the login case).
@@ -176,21 +193,69 @@ function OnboardingGate() {
   );
 }
 
+/**
+ * Customer-only routes. A shipping line that lands on one (an old link, a
+ * bookmark, a hand-typed URL) is sent to its own home rather than shown a
+ * contract/company-shaped page that has no meaning for it.
+ */
+function RequireCustomer() {
+  const { isShippingLine, customerQuery } = useAuth();
+
+  // RequireCompany already awaits this query, but guard anyway: a refetch can
+  // flip `isPending` back on, and redirecting on a half-loaded account would
+  // throw the user into the wrong app.
+  if (customerQuery.isPending) return <FullScreenSpinner />;
+  if (isShippingLine) return <Navigate to="/shipping-line" replace />;
+  return <Outlet />;
+}
+
+/** The mirror of RequireCustomer: shipping-line routes, closed to customers. */
+function RequireShippingLine() {
+  const { isShippingLine, customerQuery } = useAuth();
+
+  if (customerQuery.isPending) return <FullScreenSpinner />;
+  if (!isShippingLine) return <Navigate to="/portal" replace />;
+  return <Outlet />;
+}
+
+/**
+ * Where a signed-in account belongs. Shipping lines and customers have separate
+ * apps, so every "you're already logged in" redirect has to pick between them.
+ * Waits for the company query: `isShippingLine` is false while that request is
+ * still in flight, which would land a shipping line on the customer home first.
+ */
+function useHomeRoute(): { ready: boolean; href: string } {
+  const { isShippingLine, customerQuery } = useAuth();
+
+  return {
+    ready: !customerQuery.isPending,
+    href: isShippingLine ? "/shipping-line" : "/portal",
+  };
+}
+
 /** Keeps authenticated users off the login/signup pages. */
 function RedirectIfAuthed() {
   const { isPending, isAuthenticated } = useAuth();
+  const home = useHomeRoute();
 
   if (isPending) return <FullScreenSpinner />;
-  if (isAuthenticated) return <Navigate to="/portal" replace />;
+  if (isAuthenticated) {
+    if (!home.ready) return <FullScreenSpinner />;
+    return <Navigate to={home.href} replace />;
+  }
   return <Outlet />;
 }
 
 /** Landing page for visitors; authenticated users go straight to the portal. */
 function LandingRoute() {
   const { isPending, isAuthenticated } = useAuth();
+  const home = useHomeRoute();
 
   if (isPending) return <FullScreenSpinner />;
-  if (isAuthenticated) return <Navigate to="/portal" replace />;
+  if (isAuthenticated) {
+    if (!home.ready) return <FullScreenSpinner />;
+    return <Navigate to={home.href} replace />;
+  }
   return <EDRFreightLandingPage />;
 }
 
@@ -230,6 +295,37 @@ const sidebarItems: SidebarItem[] = [
   },
 ];
 
+/**
+ * Sidebar for shipping lines. Intentionally its own list rather than a filtered
+ * view of `sidebarItems`: shipping lines have no contracts, and their Home /
+ * Bookings / Invoices pages are different pages at different routes.
+ */
+const shippingLineSidebarItems: SidebarItem[] = [
+  { label: "Home", href: "/shipping-line", icon: <Home size={18} /> },
+  {
+    label: "Bookings",
+    href: "/shipping-line/bookings",
+    icon: <Package size={18} />,
+  },
+  {
+    label: "Invoices",
+    href: "/shipping-line/invoices",
+    icon: <Receipt size={18} />,
+  },
+  {
+    section: "Account",
+    label: "Settings",
+    href: "/shipping-line/settings",
+    icon: <Settings size={18} />,
+  },
+  {
+    section: "Account",
+    label: "Help & Support",
+    href: "/shipping-line/help",
+    icon: <LifeBuoy size={18} />,
+  },
+];
+
 const App = () => {
   const navigate = useNavigate();
   const location = useLocation();
@@ -240,6 +336,7 @@ const App = () => {
     createProfile,
     reapplyProfile,
     isAuthenticated,
+    isShippingLine,
   } = useAuth();
 
   // Attribute replays and exceptions to the signed-in user (id/org only).
@@ -310,82 +407,158 @@ const App = () => {
 
         <Route element={<RequireAuth />}>
           <Route element={<RequireCompany />}>
-            <Route
-              element={
-                <AppLayout
-                  title="EDR Freight"
-                  sidebarItems={sidebarItems}
-                  activeHref={location.pathname}
-                  onNavigate={navigate}
-                  enableThemeToggle
-                  userName={displayName}
-                  userEmail={userEmail}
-                  companyProfiles={companyProfiles}
-                  companyType={companyType}
-                  onCreateProfile={createProfile}
-                  onReapplyProfile={reapplyProfile}
+            {/* Shipping-line app. Its own layout and sidebar, and its own pages
+              at their own routes — nothing here is shared with the customer
+              branch below beyond the shell component itself. Contracts are
+              absent by design: shipping lines request bookings directly. */}
+            {isShippingLine && (
+              <Route element={<RequireShippingLine />}>
+                <Route
+                  element={
+                    <AppLayout
+                      title="EDR Freight"
+                      sidebarItems={shippingLineSidebarItems}
+                      activeHref={location.pathname}
+                      onNavigate={navigate}
+                      userName={displayName}
+                      userEmail={userEmail}
+                      // Support chat is company-scoped; a shipping line has no
+                      // company, so every poll would 403.
+                      showSupportWidget={false}
+                    >
+                      <Outlet />
+                    </AppLayout>
+                  }
                 >
-                  <OnboardingGate />
-                </AppLayout>
-              }
-            >
-              <Route path="/portal" element={<MyPortalPage />} />
-              {/* Bookings are created against a contract, but the full list is
+                  <Route
+                    path="/shipping-line"
+                    element={<ShippingLineHomePage />}
+                  />
+                  <Route
+                    path="/shipping-line/bookings"
+                    element={<ShippingLineBookingsPage />}
+                  />
+                  <Route
+                    path="/shipping-line/bookings/:id"
+                    element={<ShippingLineBookingDetailPage />}
+                  />
+                  <Route
+                    path="/shipping-line/bookings/:id/complete"
+                    element={<ShippingLineCompletePage />}
+                  />
+                  <Route
+                    path="/shipping-line/invoices"
+                    element={<ShippingLineInvoicesPage />}
+                  />
+                  {/* Same detail component as the customer's /billing/:id — the
+                    API scopes my-invoices to the signed-in payer either way,
+                    and the page derives its back target from the URL. */}
+                  <Route
+                    path="/shipping-line/invoices/:id"
+                    element={<InvoiceDetailPage />}
+                  />
+                  <Route
+                    path="/shipping-line/settings"
+                    element={<ShippingLineSettingsPage />}
+                  />
+                  <Route
+                    path="/shipping-line/settings"
+                    element={<ShippingLineSettingsPage />}
+                  />
+                  <Route
+                    path="/shipping-line/help"
+                    element={<ShippingLineHelpPage />}
+                  />
+                  {/* Old shared links land on the shipping-line equivalents. */}
+                  <Route
+                    path="/settings"
+                    element={<Navigate to="/shipping-line/settings" replace />}
+                  />
+                </Route>
+              </Route>
+            )}
+
+            {/* Customer app — unchanged. */}
+            <Route element={<RequireCustomer />}>
+              <Route
+                element={
+                  <AppLayout
+                    title="EDR Freight"
+                    sidebarItems={sidebarItems}
+                    activeHref={location.pathname}
+                    onNavigate={navigate}
+                    userName={displayName}
+                    userEmail={userEmail}
+                    companyProfiles={companyProfiles}
+                    companyType={companyType}
+                    onCreateProfile={createProfile}
+                    onReapplyProfile={reapplyProfile}
+                  >
+                    <OnboardingGate />
+                  </AppLayout>
+                }
+              >
+                <Route path="/portal" element={<MyPortalPage />} />
+                {/* Bookings are created against a contract, but the full list is
                 browsable here. New-booking entry still routes via a contract. */}
-              <Route path="/bookings" element={<BookingsListPage />} />
-              <Route
-                path="/bookings/new"
-                element={<Navigate to="/contracts/new" replace />}
-              />
-              <Route path="/bookings/:id/edit" element={<EditBookingPage />} />
-              <Route path="/bookings/:id" element={<BookingDetailPage />} />
-              <Route
-                path="/bookings/:id/last-mile-confirm"
-                element={<LastMileConfirmPage />}
-              />
-              <Route
-                path="/bookings/:id/last-mile-contract"
-                element={<LastMileContractPage />}
-              />
-              <Route
-                path="/bookings/:id/contract"
-                element={<BookingContractPage />}
-              />
-              <Route path="/contracts" element={<ContractsList />} />
-              <Route path="/contracts/new" element={<NewContractPage />} />
-              <Route
-                path="/contracts/:id/edit"
-                element={<NewContractPage mode="edit" />}
-              />
-              <Route
-                path="/contracts/:id/shipment-requests/new"
-                element={<NewShipmentRequestPage />}
-              />
-              <Route
-                path="/contracts/:id/bookings/new"
-                element={<NewShipmentPage />}
-              />
-              {/* Completion of an initiated (bare) booking after per-booking
+                <Route path="/bookings" element={<BookingsListPage />} />
+                <Route
+                  path="/bookings/new"
+                  element={<Navigate to="/contracts/new" replace />}
+                />
+                <Route
+                  path="/bookings/:id/edit"
+                  element={<EditBookingPage />}
+                />
+                <Route path="/bookings/:id" element={<BookingDetailPage />} />
+                <Route
+                  path="/bookings/:id/last-mile-confirm"
+                  element={<LastMileConfirmPage />}
+                />
+                <Route
+                  path="/bookings/:id/last-mile-contract"
+                  element={<LastMileContractPage />}
+                />
+                <Route
+                  path="/bookings/:id/contract"
+                  element={<BookingContractPage />}
+                />
+                <Route path="/contracts" element={<ContractsList />} />
+                <Route path="/contracts/new" element={<NewContractPage />} />
+                <Route
+                  path="/contracts/:id/edit"
+                  element={<NewContractPage mode="edit" />}
+                />
+                <Route
+                  path="/contracts/:id/shipment-requests/new"
+                  element={<NewShipmentRequestPage />}
+                />
+                <Route
+                  path="/contracts/:id/bookings/new"
+                  element={<NewShipmentPage />}
+                />
+                {/* Completion of an initiated (bare) booking after per-booking
                 clearance — same form, submits to the complete endpoint. */}
-              <Route
-                path="/contracts/:id/bookings/:bookingId/complete"
-                element={<NewShipmentPage />}
-              />
-              <Route
-                path="/contracts/:id/view"
-                element={<ContractViewPage />}
-              />
-              <Route path="/contracts/:id" element={<ContractDetailPage />} />
-              <Route path="/tracking" element={<TrackingPage />} />
-              <Route path="/billing" element={<InvoicesList />} />
-              <Route path="/billing/:id" element={<InvoiceDetailPage />} />
-              {/* Profile was merged into Settings — keep old links working. */}
-              <Route
-                path="/profile"
-                element={<Navigate to="/settings" replace />}
-              />
-              <Route path="/signature" element={<MySignaturePage />} />
-              <Route path="/settings" element={<SettingsPage />} />
+                <Route
+                  path="/contracts/:id/bookings/:bookingId/complete"
+                  element={<NewShipmentPage />}
+                />
+                <Route
+                  path="/contracts/:id/view"
+                  element={<ContractViewPage />}
+                />
+                <Route path="/contracts/:id" element={<ContractDetailPage />} />
+                <Route path="/tracking" element={<TrackingPage />} />
+                <Route path="/billing" element={<InvoicesList />} />
+                <Route path="/billing/:id" element={<InvoiceDetailPage />} />
+                {/* Profile was merged into Settings — keep old links working. */}
+                <Route
+                  path="/profile"
+                  element={<Navigate to="/settings" replace />}
+                />
+                <Route path="/signature" element={<MySignaturePage />} />
+                <Route path="/settings" element={<SettingsPage />} />
+              </Route>
             </Route>
           </Route>
         </Route>
diff --git a/apps/edr-freight-web/portal/src/components/AppLayout.tsx b/apps/edr-freight-web/portal/src/components/AppLayout.tsx
index 6fce4ce82..cfe6b93f2 100644
--- a/apps/edr-freight-web/portal/src/components/AppLayout.tsx
+++ b/apps/edr-freight-web/portal/src/components/AppLayout.tsx
@@ -15,8 +15,6 @@ import {
   Stack,
   Text,
   UnstyledButton,
-  useComputedColorScheme,
-  useMantineColorScheme,
   useMantineTheme,
 } from "@mantine/core";
 import { useDisclosure } from "@mantine/hooks";
@@ -26,17 +24,15 @@ import {
   FileSignature,
   LogOut,
   Menu as MenuIcon,
-  Moon,
   Plus,
   RefreshCw,
-  Search,
+  // Search,
   Settings,
-  Sun,
   Upload,
   User,
   X,
 } from "lucide-react";
-import { type CSSProperties, Fragment, type ReactNode, useState } from "react";
+import { Fragment, type ReactNode, useState } from "react";
 import { PROFILE_TYPE_LABELS } from "@/constants/profileMode";
 import NotificationBellContainer from "@/features/notifications/NotificationBellContainer";
 import SupportWidget from "@/features/support/SupportWidget";
@@ -59,7 +55,6 @@ export interface AppLayoutProps {
    * to the new-booking wizard. Compatible with react-router's `navigate`.
    */
   onNavigate?: (href: string, options?: { state?: unknown }) => void;
-  enableThemeToggle?: boolean;
   userName?: string;
   userEmail?: string;
   /** Operational profiles for the company — surfaced as reference chips in the account menu. */
@@ -72,6 +67,12 @@ export interface AppLayoutProps {
   }[];
   /** Company type (e.g. "customer", "forwarder") — gates the "Add service" control. */
   companyType?: string | null;
+  /**
+   * Render the floating support-chat launcher. Defaults to true so the customer
+   * portal is unaffected; shipping lines pass false — support chat is scoped to
+   * a company, which they do not have.
+   */
+  showSupportWidget?: boolean;
   /** Create a new service profile of the given type (with business license). */
   onCreateProfile?: (
     type: ServiceType,
@@ -112,23 +113,20 @@ function getActivePage(
   activePath: string,
 ): { label: string } | null {
   const path = activePath.toLowerCase();
-  for (const item of items) {
-    if (
-      path === item.href.toLowerCase() ||
-      path.startsWith(item.href.toLowerCase() + "/")
-    ) {
-      return { label: item.label };
-    }
-    if (item.children) {
-      const childMatch = item.children.find(
-        (c) =>
-          path === c.href.toLowerCase() ||
-          path.startsWith(c.href.toLowerCase() + "/"),
-      );
-      if (childMatch) return { label: childMatch.label };
-    }
-  }
-  return null;
+
+  // Longest match wins, for the same reason as the sidebar's isItemActive:
+  // a nested href like "/shipping-line/bookings" must beat its "/shipping-line"
+  // parent, which a first-match-wins scan would report as "Home".
+  const best = items
+    .flatMap((item) => [item, ...(item.children ?? [])])
+    .filter(
+      (item) =>
+        path === item.href.toLowerCase() ||
+        path.startsWith(item.href.toLowerCase() + "/"),
+    )
+    .sort((a, b) => b.href.length - a.href.length)[0];
+
+  return best ? { label: best.label } : null;
 }
 
 const navClassNames = (active: boolean) => {
@@ -154,20 +152,17 @@ export function AppLayout({
   sidebarItems,
   activeHref = "",
   onNavigate,
-  enableThemeToggle = false,
   userName = "User",
   userEmail,
   companyProfiles = [],
   companyType,
   onCreateProfile,
   onReapplyProfile,
+  showSupportWidget = true,
   children,
 }: AppLayoutProps) {
   const [mobileOpen, { toggle: toggleMobile }] = useDisclosure();
   const theme = useMantineTheme();
-  const { setColorScheme } = useMantineColorScheme();
-  const computedColorScheme = useComputedColorScheme("light");
-
   const borderColor = theme.colors["edr-border"][6];
   const mutedColor = theme.colors["edr-muted"][6];
   const textColor = theme.colors["edr-text"][6];
@@ -178,10 +173,6 @@ export function AppLayout({
   const navigate = (href: string, options?: { state?: unknown }) =>
     onNavigate?.(href, options);
 
-  const toggleTheme = () => {
-    setColorScheme(computedColorScheme === "dark" ? "light" : "dark");
-  };
-
   const initials = getInitials(userName);
   const activePage = getActivePage(sidebarItems, activePath);
 
@@ -275,23 +266,19 @@ export function AppLayout({
   const serviceLabel = (m: ServiceType) => PROFILE_TYPE_LABELS[m] ?? m;
   const isSuspendedAppeal = reapplyStatus === "suspended";
 
-  const isItemActive = (item: SidebarItem) =>
-    activePath === item.href.toLowerCase() ||
-    activePath.startsWith(item.href.toLowerCase() + "/");
+  // Longest matching href wins. A plain prefix test would light up every
+  // ancestor: with a "/shipping-line" home item alongside "/shipping-line/
+  // bookings", Home would stay highlighted on every page beneath it. Exact
+  // matches still win outright, so customer routes are unaffected — their
+  // sidebar hrefs are siblings, never nested inside one another.
+  const bestMatchHref = sidebarItems
+    .flatMap((item) => [item, ...(item.children ?? [])])
+    .map((item) => item.href.toLowerCase())
+    .filter((href) => activePath === href || activePath.startsWith(href + "/"))
+    .sort((a, b) => b.length - a.length)[0];
 
-  // Shared header "island" styles — every control is a consistent 36px chip.
-  const islandStyle: CSSProperties = {
-    width: 36,
-    height: 36,
-    borderRadius: 999,
-    border: `1px solid ${borderColor}`,
-    backgroundColor: "#fff",
-    display: "flex",
-    alignItems: "center",
-    justifyContent: "center",
-    flexShrink: 0,
-    cursor: "pointer",
-  };
+  const isItemActive = (item: SidebarItem) =>
+    bestMatchHref === item.href.toLowerCase();
 
   return (
     <AppShell
@@ -398,7 +385,9 @@ export function AppLayout({
                           onClick={() =>
                             openServiceModal(p.type as ServiceType, p)
                           }
-                          leftSection={<RefreshCw size={15} strokeWidth={1.8} />}
+                          leftSection={
+                            <RefreshCw size={15} strokeWidth={1.8} />
+                          }
                         >
                           {serviceLabel(p.type as ServiceType)}
                         </Menu.Item>
@@ -434,7 +423,7 @@ export function AppLayout({
             )}
 
             {/* Search pill */}
-            <Group
+            {/* <Group
               gap={8}
               align="center"
               visibleFrom="sm"
@@ -452,25 +441,11 @@ export function AppLayout({
               <Text size="sm" style={{ color: mutedColor, userSelect: "none" }}>
                 Search shipments, bookings…
               </Text>
-            </Group>
+            </Group> */}
 
             {/* Notifications */}
             <NotificationBellContainer />
 
-            {enableThemeToggle && (
-              <UnstyledButton
-                onClick={toggleTheme}
-                style={islandStyle}
-                aria-label="Toggle theme"
-              >
-                {computedColorScheme === "dark" ? (
-                  <Sun size={17} color={textColor} strokeWidth={1.8} />
-                ) : (
-                  <Moon size={17} color={textColor} strokeWidth={1.8} />
-                )}
-              </UnstyledButton>
-            )}
-
             {/* Avatar pill */}
             <Menu
               width={220}
@@ -574,7 +549,7 @@ export function AppLayout({
                     navigate("/bookings/new", { state: { fresh: true } })
                   }
                 >
-                  New Booking
+                  New Contract
                 </Menu.Item>
                 <Divider />
                 <Menu.Item
@@ -891,8 +866,10 @@ export function AppLayout({
         {children}
       </AppShell.Main>
 
-      {/* Floating customer-support chat launcher. */}
-      <SupportWidget />
+      {/* Floating customer-support chat launcher. Hidden when the caller opts
+          out: support chat resolves the user's external profile → company, and
+          a shipping line has neither, so every poll would 403. */}
+      {showSupportWidget && <SupportWidget />}
 
       {/* Create-profile modal — opens when switching to a mode the company
           doesn't have a profile for yet. */}
@@ -934,7 +911,9 @@ export function AppLayout({
             </Alert>
           )}
           <FileInput
-            label={reapplyId ? "Business license (optional)" : "Business license"}
+            label={
+              reapplyId ? "Business license (optional)" : "Business license"
+            }
             multiple
             clearable
             accept="application/pdf,image/png,image/jpeg"
diff --git a/apps/edr-freight-web/portal/src/components/FaydaVerifyPanel.tsx b/apps/edr-freight-web/portal/src/components/FaydaVerifyPanel.tsx
index 4e6921e14..71cef57da 100644
--- a/apps/edr-freight-web/portal/src/components/FaydaVerifyPanel.tsx
+++ b/apps/edr-freight-web/portal/src/components/FaydaVerifyPanel.tsx
@@ -25,6 +25,10 @@ import {
   type IdentitySubject,
   type IdentityVerificationState,
 } from "@/services/verifayda.service";
+import { isBypassEnv } from "@/utils/dev-bypass";
+
+/** Sentinel code that skips the real eSignet exchange in dev/staging (see api's DEV_BYPASS_FAYDA_CODE). */
+const DEV_BYPASS_FAYDA_CODE = "DEV_BYPASS";
 
 interface FaydaVerifyPanelProps {
   subject: IdentitySubject;
@@ -80,6 +84,23 @@ export default function FaydaVerifyPanel({
     setError(null);
     setLoading(true);
     try {
+      // Dev/staging only: send the tab straight to /fayda/callback with the
+      // sentinel code instead of round-tripping through eSignet — that page's
+      // existing completeIdentity()/navigate-back logic runs unchanged.
+      if (isBypassEnv()) {
+        stashPendingVerification({
+          subject,
+          returnTo:
+            window.location.pathname +
+            window.location.search +
+            window.location.hash,
+        });
+        window.location.assign(
+          `/fayda/callback?code=${DEV_BYPASS_FAYDA_CODE}&state=bypass`,
+        );
+        return;
+      }
+
       const authorizationUrl = await verifaydaService.start();
       // Record who is being verified and where to come back to before the tab
       // leaves — /fayda/callback has no other way to know either.
diff --git a/apps/edr-freight-web/portal/src/components/onboarding/ETradeInfo.tsx b/apps/edr-freight-web/portal/src/components/onboarding/ETradeInfo.tsx
index 74e267a30..acedc57f5 100644
--- a/apps/edr-freight-web/portal/src/components/onboarding/ETradeInfo.tsx
+++ b/apps/edr-freight-web/portal/src/components/onboarding/ETradeInfo.tsx
@@ -1,7 +1,17 @@
-import { Alert, Button, Loader, Stack, TextInput } from "@mantine/core";
-import { useEffect, useRef } from "react";
+import {
+  Alert,
+  Button,
+  Card,
+  Group,
+  Loader,
+  Radio,
+  Stack,
+  Text,
+  TextInput,
+} from "@mantine/core";
+import { useEffect, useRef, useState } from "react";
 import type { UseFormRegisterReturn } from "react-hook-form";
-import { AlertCircle, Download } from "lucide-react";
+import { AlertCircle, Building2, Download, Info } from "lucide-react";
 import { useETradeData } from "@/hooks/useETradeData";
 import { extractApiError } from "@/utils/result";
 import type { CompanyRegistrationData } from "@edr/types";
@@ -12,6 +22,8 @@ export type ETradeStatus =
   | "verified"
   | "not-found"
   | "taken"
+  /** eTrade returned several business licences; the customer must pick one. */
+  | "choose-business"
   | "error";
 
 interface ETradeInfoProps {
@@ -36,6 +48,20 @@ interface ETradeInfoProps {
    * stays available for a deliberate re-verify.
    */
   alreadyVerified?: boolean;
+  /**
+   * The licence this company already operates under, if any. Pre-selects it in
+   * the picker so a deliberate re-verify refreshes that same business rather
+   * than silently snapping to eTrade's first one.
+   */
+  selectedLicenceNumber?: string;
+  /**
+   * A record is worth having but not required — a co-operative union or farm
+   * registers on a TIN alone, so eTrade may legitimately hold nothing for it.
+   * The lookup still runs (plenty of co-operatives DO have a record, and it
+   * beats typing), but "not found" stops being a red dead end and becomes the
+   * expected outcome, with the form below to fill in by hand.
+   */
+  registrationOptional?: boolean;
 }
 
 // Digits, not just length: a 10-character non-numeric TIN used to fire a lookup
@@ -51,6 +77,8 @@ export default function ETradeInfo({
   onStatusChange,
   onReset,
   alreadyVerified,
+  selectedLicenceNumber,
+  registrationOptional = false,
 }: ETradeInfoProps) {
   const mutation = useETradeData();
   const isLoading = mutation.isPending;
@@ -61,14 +89,39 @@ export default function ETradeInfo({
   // user has typed a different TIN and overwrite its fields with stale data.
   const requestIdRef = useRef(0);
 
-  const handleFetch = async () => {
+  // Which of the TIN's licences the customer operates as. A ref alongside the
+  // state because handleFetch is called from an effect that doesn't re-run on
+  // this value.
+  const [licence, setLicence] = useState<string | null>(
+    selectedLicenceNumber || null,
+  );
+  const licenceRef = useRef(licence);
+  licenceRef.current = licence;
+
+  const handleFetch = async (chosen = licenceRef.current) => {
     if (!isValidTin(tin)) return;
     const requestId = ++requestIdRef.current;
-    const result = await mutation.mutateAsync(tin);
+    const result = await mutation.mutateAsync({
+      tin,
+      licenceNumber: chosen ?? undefined,
+    });
     if (requestIdRef.current !== requestId) return;
-    if (result && !result.tinTaken) {
-      onDataLoaded(result);
-    }
+    if (!result || result.tinTaken) return;
+    // Several licences and no pick yet: the registration data describes only
+    // eTrade's first one, so it must not be adopted as this company's record
+    // until the customer says which business they're acting as.
+    if (!chosen && (result.businesses?.length ?? 0) > 1) return;
+    onDataLoaded(result);
+  };
+
+  // The picker collapses to a one-line summary + "Change" once a business is
+  // settled on; it only stays open while the choice is still outstanding.
+  const [pickerOpen, setPickerOpen] = useState(false);
+
+  const handleChooseBusiness = (value: string) => {
+    setLicence(value);
+    setPickerOpen(false);
+    handleFetch(value);
   };
 
   // Auto-fetch as soon as the TIN reaches its full 10-digit length — only
@@ -87,8 +140,12 @@ export default function ETradeInfo({
     if (tin !== lastFetchedTin.current) {
       // TIN moved away from whatever we last fetched — that result (verified
       // data, "taken", or an error) no longer describes this TIN. Drop it so
-      // the UI doesn't keep showing the previous TIN's outcome.
+      // the UI doesn't keep showing the previous TIN's outcome. The licence pick
+      // belongs to the old TIN too, so it goes with it (via the ref as well, so
+      // the fetch below doesn't reuse it before the state lands).
       requestIdRef.current++;
+      licenceRef.current = null;
+      setLicence(null);
       if (mutation.data || mutation.error) {
         mutation.reset();
         onReset?.();
@@ -116,17 +173,28 @@ export default function ETradeInfo({
         : apiError.message
       : null;
 
+  const businesses = mutation.data?.businesses ?? [];
+  const chosenBusiness = businesses.find((b) => b.licenceNumber === licence);
+  // More than one licence and none of them picked: the lookup succeeded but
+  // this company's record is still undecided, so it must not read as verified.
+  // Matched against the list rather than `licence` alone — a saved licence
+  // eTrade no longer lists is not a choice among what it offers today.
+  const needsChoice = businesses.length > 1 && !chosenBusiness;
+  const showPicker = needsChoice || pickerOpen;
+
   const status: ETradeStatus = isLoading
     ? "loading"
     : tinTaken
       ? "taken"
-      : mutation.isSuccess && mutation.data && !mutation.data.tinTaken
-        ? "verified"
-        : notFound
-          ? "not-found"
-          : errorMessage
-            ? "error"
-            : "idle";
+      : needsChoice
+        ? "choose-business"
+        : mutation.isSuccess && mutation.data && !mutation.data.tinTaken
+          ? "verified"
+          : notFound
+            ? "not-found"
+            : errorMessage
+              ? "error"
+              : "idle";
 
   const lastReportedStatus = useRef<ETradeStatus | null>(null);
   useEffect(() => {
@@ -142,7 +210,11 @@ export default function ETradeInfo({
   const willAutoFetch = isValidTin(tin) && lastFetchedTin.current !== tin;
   const showLoading = isLoading || willAutoFetch;
 
-  const showRetry = isValidTin(tin) && status !== "verified" && !showLoading;
+  const showRetry =
+    isValidTin(tin) &&
+    status !== "verified" &&
+    status !== "choose-business" &&
+    !showLoading;
 
   return (
     <Stack gap="md">
@@ -170,7 +242,7 @@ export default function ETradeInfo({
             className="max-w-none"
             variant="filled"
             color="edr-green"
-            onClick={handleFetch}
+            onClick={() => handleFetch()}
             disabled={!isValidTin(tin)}
             leftSection={<Download size={16} />}
           >
@@ -179,17 +251,112 @@ export default function ETradeInfo({
         )}
       </div>
 
-      {notFound && (
-        <Alert
-          icon={<AlertCircle size={16} />}
-          color="red"
-          title="No matching business record"
-        >
-          This TIN isn't registered with eTrade. Check the number — we can't
-          continue without a matching business record.
-        </Alert>
+      {businesses.length > 1 && !showPicker && chosenBusiness && (
+        <Card padding="sm" radius="md" withBorder>
+          <Group justify="space-between" wrap="nowrap" gap="sm">
+            <Group gap="sm" wrap="nowrap">
+              <Building2 size={18} className="shrink-0 text-edr-muted" />
+              <Stack gap={2}>
+                <Text fw={600} size="sm">
+                  {chosenBusiness.activity ||
+                    chosenBusiness.tradeName ||
+                    chosenBusiness.licenceNumber}
+                </Text>
+                <Group gap="xs">
+                  <Text size="xs" c="edr-muted" ff="monospace">
+                    {chosenBusiness.licenceNumber}
+                  </Text>
+                  {chosenBusiness.renewedTo && (
+                    <Text size="xs" c="edr-muted">
+                      · valid to {chosenBusiness.renewedTo}
+                    </Text>
+                  )}
+                </Group>
+              </Stack>
+            </Group>
+            <Button
+              size="xs"
+              variant="subtle"
+              onClick={() => setPickerOpen(true)}
+              disabled={isLoading}
+            >
+              Change
+            </Button>
+          </Group>
+        </Card>
       )}
 
+      {businesses.length > 1 && showPicker && (
+        <Stack gap="sm">
+          <Alert
+            icon={<Building2 size={16} />}
+            color={needsChoice ? "yellow" : "blue"}
+            title={
+              needsChoice
+                ? `This TIN holds ${businesses.length} business licences`
+                : "Change business"
+            }
+          >
+            Pick the business you're registering as — its licence and registered
+            address become this account's record.
+          </Alert>
+          <Radio.Group
+            value={licence}
+            onChange={handleChooseBusiness}
+            aria-label="Business licence"
+          >
+            <Stack gap="xs">
+              {businesses.map((b) => (
+                <Card key={b.licenceNumber} padding="sm" radius="md" withBorder>
+                  <Radio
+                    value={b.licenceNumber}
+                    disabled={isLoading}
+                    label={
+                      <Stack gap={2}>
+                        <Text fw={600} size="sm">
+                          {b.activity || b.tradeName || b.licenceNumber}
+                        </Text>
+                        <Group gap="xs">
+                          <Text size="xs" c="edr-muted" ff="monospace">
+                            {b.licenceNumber}
+                          </Text>
+                          {b.renewedTo && (
+                            <Text size="xs" c="edr-muted">
+                              · valid to {b.renewedTo}
+                            </Text>
+                          )}
+                        </Group>
+                      </Stack>
+                    }
+                  />
+                </Card>
+              ))}
+            </Stack>
+          </Radio.Group>
+        </Stack>
+      )}
+
+      {notFound &&
+        (registrationOptional ? (
+          <Alert
+            icon={<Info size={16} />}
+            color="blue"
+            title="Nothing on file at eTrade for this TIN"
+          >
+            That's expected without a trade licence. Fill in your registration
+            details below and we'll take them as you give them.
+          </Alert>
+        ) : (
+          <Alert
+            icon={<AlertCircle size={16} />}
+            color="red"
+            title="No matching business record"
+          >
+            This TIN isn't registered with eTrade. Check the number — we can't
+            continue without a matching business record.
+          </Alert>
+        ))}
+
       {errorMessage && (
         <Alert
           icon={<AlertCircle size={16} />}
diff --git a/apps/edr-freight-web/portal/src/components/onboarding/OnboardingResumeBanner.tsx b/apps/edr-freight-web/portal/src/components/onboarding/OnboardingResumeBanner.tsx
index 27b9eec43..696f62484 100644
--- a/apps/edr-freight-web/portal/src/components/onboarding/OnboardingResumeBanner.tsx
+++ b/apps/edr-freight-web/portal/src/components/onboarding/OnboardingResumeBanner.tsx
@@ -162,7 +162,15 @@ export default function OnboardingResumeBanner({
  * Self-hides when there's nothing outstanding.
  */
 export function AccountReviewBanner() {
-  const { company, companyStatus, reviewStatus, reviewNote } = useAuth();
+  const { company, companyStatus, reviewStatus, reviewNote, isShippingLine } =
+    useAuth();
+
+  // Shipping lines have no company approval, no operational profiles and no
+  // profile-edit review — every branch below is about customer state they do
+  // not have. Bail explicitly rather than relying on each check happening to
+  // fall through.
+  if (isShippingLine) return null;
+
   const profiles = company?.company?.companyProfiles ?? [];
   const pending = profiles.filter((p) => p.status === "pending");
   const approved = profiles.filter((p) => p.status === "active");
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 fa9c5919b..b06b1487c 100644
--- a/apps/edr-freight-web/portal/src/components/onboarding/OnboardingWizardDialog.tsx
+++ b/apps/edr-freight-web/portal/src/components/onboarding/OnboardingWizardDialog.tsx
@@ -1,6 +1,7 @@
 import {
   Box,
   Button,
+  Checkbox,
   Group,
   Modal,
   ScrollArea,
@@ -38,15 +39,21 @@ import type {
 } from "@/services/companies.service";
 import { companiesService } from "@/services/companies.service";
 import type { UpdateProfilePayload } from "@/types/profile";
+import { documentSettingCode } from "@/utils/documentSettingCode";
 import { extractApiError } from "@/utils/result";
 
 /** Form steps rendered by CompanyProfileForm. */
-type FormStep = "company" | "personnel" | "contact" | "poa" | "documents";
+type FormStep =
+  | "company"
+  | "owner"
+  | "representation"
+  | "contact"
+  | "documents";
 const FORM_STEPS: FormStep[] = [
   "company",
-  "personnel",
+  "owner",
+  "representation",
   "contact",
-  "poa",
   "documents",
 ];
 
@@ -68,23 +75,25 @@ const STEP_META: Record<
     icon: <Building2 size={20} />,
     title: "Company Information",
     description:
-      "Confirm your VAT number, verify the owner's identity, and we'll pull your registration from eTrade.",
+      "Confirm your VAT number and we'll pull your registration straight from eTrade.",
   },
-  personnel: {
+  owner: {
     icon: <User size={20} />,
-    title: "General Manager",
-    description: "Who is the general manager of the company?",
+    title: "Company Owner",
+    description:
+      "The person registered on your eTrade licence. We fill in what eTrade and Fayda gave us.",
+  },
+  representation: {
+    icon: <FileText size={20} />,
+    title: "Who Acts For You",
+    description:
+      "Tell us whether anyone holds power of attorney — your answer decides whose identity we verify.",
   },
   contact: {
     icon: <UserCheck size={20} />,
     title: "Contact Person",
     description: "Who should we reach out to about this account?",
   },
-  poa: {
-    icon: <FileText size={20} />,
-    title: "Power of Attorney",
-    description: "Optionally add a representative with power of attorney.",
-  },
   documents: {
     icon: <UploadCloud size={20} />,
     title: "Upload Documents",
@@ -108,13 +117,6 @@ function companyTypeForRoles(_roles: string[]): string {
   return "customer";
 }
 
-/** Document upload setting code per company nationality. */
-function documentSettingCode(nationality: CompanyNationality): string {
-  return nationality === "foreign"
-    ? "company_onboarding_documents_foreign"
-    : "company_onboarding_documents_ethiopian";
-}
-
 /**
  * First-run onboarding wizard with a "draft-first" flow: picking the role(s)
  * immediately creates a draft company + profile on the backend, so every
@@ -157,6 +159,39 @@ export default function OnboardingWizardDialog({
   const [roles, setRoles] = useState<string[]>(
     existingProfiles.map((p) => p.type),
   );
+  const [cooperative, setCooperative] = useState<boolean>(
+    company?.company?.attributes?.cooperative === true,
+  );
+  // A foreign company operating on an Ethiopian Investment Commission licence.
+  // eTrade holds nothing for its TIN, so it types the registration exactly as a
+  // co-operative does — but it still holds a licence per role, so nothing about
+  // the licence step changes.
+  const [investorLicence, setInvestorLicence] = useState<boolean>(
+    company?.company?.attributes?.investorLicence === true,
+  );
+  // Ticking the box drops the selections the company can no longer hold, rather
+  // than letting Continue fail on ones the API refuses: a co-op cannot forward
+  // freight, and is registered in Ethiopia so it is never foreign.
+  const handleCooperativeChange = useCallback((checked: boolean) => {
+    setCooperative(checked);
+    if (checked) {
+      setRoles((prev) => prev.filter((r) => r !== "freight_forwarder"));
+      // Ethiopian is then the only answer left, so it is made rather than asked.
+      setNationality("ethiopian");
+      // Which also rules out the investment licence — that is a foreign
+      // company's, and the API refuses the pair.
+      setInvestorLicence(false);
+    }
+  }, []);
+  // The investment licence is a foreign company's document. Moving the answer
+  // back to Ethiopian drops it rather than sending a pair the API refuses.
+  const handleNationalityChange = useCallback(
+    (value: CompanyNationality | null) => {
+      setNationality(value);
+      if (value !== "foreign") setInvestorLicence(false);
+    },
+    [],
+  );
   const [documentFiles, setDocumentFiles] = useState<
     Record<string, File | File[] | null>
   >({});
@@ -207,10 +242,12 @@ export default function OnboardingWizardDialog({
       companyType: string;
       roles: ProfileTypeValue[];
       nationality?: CompanyNationality;
+      cooperative?: boolean;
+      investorLicence?: boolean;
     }) => api.companies.startOnboarding.call(vars),
     onSuccess: async () => {
       // Nationality drives the server-resolved identity requirements (Fayda vs
-      // passport), the document set and the GM/PoA copy — all read from
+      // passport), the document set and the PoA copy — all read from
       // onboardingRequirements/profile. Re-entering role selection can change
       // it, so both must be refetched alongside getInfo or the form step would
       // keep rendering the previous nationality's requirements.
@@ -289,6 +326,8 @@ export default function OnboardingWizardDialog({
     resumedRef.current = true;
     setRoles(existingProfiles.map((p) => p.type));
     setNationality(savedNationality);
+    setCooperative(company?.company?.attributes?.cooperative === true);
+    setInvestorLicence(company?.company?.attributes?.investorLicence === true);
     // Resume into the form only when profiles exist; otherwise send the user to
     // role selection so the missing operational profiles get created.
     setPhase(hasOperationalProfiles ? "form" : "nationality-role");
@@ -303,8 +342,10 @@ export default function OnboardingWizardDialog({
       companyType: companyTypeForRoles(roles),
       roles: roles as ProfileTypeValue[],
       nationality: nationality ?? undefined,
+      cooperative,
+      investorLicence,
     });
-  }, [roles, nationality, startMutation]);
+  }, [roles, nationality, cooperative, investorLicence, startMutation]);
 
   // Back from the form's first step returns to nationality/role selection.
   // Safe to re-enter: startOnboarding is idempotent — it reuses the existing
@@ -399,7 +440,7 @@ export default function OnboardingWizardDialog({
   // after the draft — and thus the requirements — exist).
   const resolvedDocumentSettingCode =
     requirementsQuery.data?.documentSettingCode ??
-    documentSettingCode(effectiveNationality);
+    documentSettingCode(effectiveNationality, cooperative);
 
   // Server-confirmed document state, used both to badge already-uploaded fields
   // and to keep a refreshed resume from over-shooting the documents step.
@@ -414,15 +455,21 @@ export default function OnboardingWizardDialog({
   const requiredDocsMissing = requirementDocuments.some(
     (d) => d.isRequired && !d.uploaded,
   );
-  // The PoA gets the same treatment: a resumed draft that predates the
-  // delegation-letter requirement (or a forwarder whose PoA is blank) must land
-  // back on the PoA step, where both the details and the letter are entered.
-  const poaIncomplete = requirementsQuery.data?.poa?.complete === false;
+  // The representation step gets the same treatment. An unanswered
+  // power-of-attorney question, or a declared representative still missing
+  // details or the DARS paper, must land the customer back on the step where
+  // all of that is entered — including a draft that predates the question
+  // existing at all, whose `declared` comes back null.
+  const representationIncomplete =
+    requirementsQuery.data?.poa?.declared == null ||
+    requirementsQuery.data?.poa?.complete === false ||
+    requirementsQuery.data?.identity?.identityProven === false;
   // Each unmet requirement lowers the ceiling; resume never moves forward.
   let ceiling = FORM_STEPS.length - 1;
   if (requiredDocsMissing)
     ceiling = Math.min(ceiling, FORM_STEPS.indexOf("documents"));
-  if (poaIncomplete) ceiling = Math.min(ceiling, FORM_STEPS.indexOf("poa"));
+  if (representationIncomplete)
+    ceiling = Math.min(ceiling, FORM_STEPS.indexOf("representation"));
   const effectiveResumeStep: FormStep =
     FORM_STEPS[
     Math.min(Math.max(FORM_STEPS.indexOf(resumeFormStep), 0), ceiling)
@@ -445,11 +492,31 @@ export default function OnboardingWizardDialog({
     licenseFiles,
     onLicenseChange: setLicenseFiles,
     uploadedDocumentKeys,
+    // What the server says is already on file, per operational profile. The
+    // wizard's own `roleProfiles` cannot say: getInfo leaves `licenseFiles`
+    // empty, so a resumed wizard asked for a licence it had already been given
+    // and refused to submit until it was uploaded a second time.
+    uploadedLicenceProfileIds: (
+      requirementsQuery.data?.licenseProfiles ?? []
+    )
+      .filter((p) => p.uploaded)
+      .map((p) => p.profileId),
     onUploadDocuments: handleUploadDocuments,
-    // Fayda verification state for the owner and the PoA — the general manager
-    // stays a plain typed role. Mandatory (Fayda) for an Ethiopian company;
-    // a foreign one requires a typed passport number for the owner instead.
+    // The company's single identity verification, and whose it is. Fayda is
+    // mandatory for an Ethiopian company; a foreign one may instead type a
+    // passport number for the same person.
     identity: requirementsQuery.data?.identity,
+    // Server-confirmed, not the local checkbox: the flag is only real once
+    // startOnboarding has persisted it, and the form's whole company step
+    // branches on it.
+    cooperative: requirementsQuery.data?.cooperative ?? cooperative,
+    // Same rule, same reason: only a persisted flag changes what the company
+    // step asks for.
+    investorLicence:
+      requirementsQuery.data?.investorLicence ?? investorLicence,
+    // A freight forwarder cannot answer the power-of-attorney question — the
+    // API forces "yes" — so the step offers no way to change it.
+    declarationLocked: requirementsQuery.data?.poa?.locked ?? false,
     onIdentityChange: () => {
       void profileQuery.refetch();
       void requirementsQuery.refetch();
@@ -514,9 +581,39 @@ export default function OnboardingWizardDialog({
               </Text>
               <NationalitySelect
                 value={nationality}
-                onChange={setNationality}
+                onChange={handleNationalityChange}
                 embedded
+                // A co-op is registered in Ethiopia by the co-operative
+                // promotion agency — foreign is not on offer rather than
+                // refused later.
+                excludeForeign={cooperative}
               />
+              {/* A co-operative union or farm registers on a TIN alone. It
+                  changes what the next step asks for (typed registration, no
+                  eTrade lookup), which documents apply, and which roles are on
+                  offer — so it is answered here, alongside the other two. */}
+              <Checkbox
+                checked={cooperative}
+                onChange={(e) => handleCooperativeChange(e.currentTarget.checked)}
+                label="We're a co-operative union or farm"
+                description="For members with a TIN but no business licence. You'll type your registration details instead of us pulling them from eTrade, and upload your co-operative papers in place of a trade licence."
+              />
+              {/* Only a foreign company is offered this: the licence is the
+                  Investment Commission's, and it is the reason eTrade has
+                  nothing to look up. Same consequence as the co-operative box —
+                  typed registration instead of a lookup — but the per-role
+                  business licence still applies, so the documents step is
+                  unchanged. */}
+              {nationality === "foreign" && !cooperative && (
+                <Checkbox
+                  checked={investorLicence}
+                  onChange={(e) =>
+                    setInvestorLicence(e.currentTarget.checked)
+                  }
+                  label="We operate on a foreign investment licence"
+                  description="For investors registered with the Ethiopian Investment Commission rather than the trade registry. eTrade holds no record of your TIN, so you'll type your registration details instead — and our team reviews them by hand."
+                />
+              )}
               <Text fw={600} size="lg" c="edr-text">
                 What does your company do?(multiple)
               </Text>
@@ -524,6 +621,9 @@ export default function OnboardingWizardDialog({
                 value={roles}
                 onChange={setRoles}
                 embedded
+                // Forwarding is licensed work — a co-op holds no licence, so
+                // the role is not offered rather than refused later.
+                excludeTypes={cooperative ? ["freight_forwarder"] : undefined}
               />
               {startError && (
                 <Text size="sm" c="red">
diff --git a/apps/edr-freight-web/portal/src/components/onboarding/RoleLicenseStep.tsx b/apps/edr-freight-web/portal/src/components/onboarding/RoleLicenseStep.tsx
index a485d40c1..8270bce74 100644
--- a/apps/edr-freight-web/portal/src/components/onboarding/RoleLicenseStep.tsx
+++ b/apps/edr-freight-web/portal/src/components/onboarding/RoleLicenseStep.tsx
@@ -50,7 +50,7 @@ function buildLicenseSetting(
         isMultiple: true,
         maxFiles: 10,
         allowedExtensions: ["pdf", "png", "jpg", "jpeg"],
-        maxSizeMb: 10,
+        maxSizeMb: 25,
         order: 1,
       },
     ],
diff --git a/apps/edr-freight-web/portal/src/constants/URLS.ts b/apps/edr-freight-web/portal/src/constants/URLS.ts
index 88b310e84..cefef5ddc 100644
--- a/apps/edr-freight-web/portal/src/constants/URLS.ts
+++ b/apps/edr-freight-web/portal/src/constants/URLS.ts
@@ -103,6 +103,7 @@ export const URL_CONSTANTS = {
     ONBOARDING_STEP: "/api/companies/onboarding-step",
     ONBOARDING_COMPLETE: "/api/companies/onboarding/complete",
     ONBOARDING_REQUIREMENTS: "/api/companies/onboarding/requirements",
+    ONBOARDING_REVERT_TO_ETRADE: "/api/companies/onboarding/revert-to-etrade",
     DASHBOARD: "/api/companies/dashboard",
     FETCH_ETRADE_INFO: "/api/companies/fetch-etrade-info",
     DOCUMENTS: (id: string) => `/api/companies/${id}/documents`,
@@ -218,11 +219,17 @@ export const URL_CONSTANTS = {
     PAY_ONLINE: (id: string) => `/api/warehouse-fee-invoices/${id}/pay-online`,
   },
 
+  // Public — no session required; the sign-up screen links to these pages.
+  PORTAL_CONTENT: {
+    PUBLIC: "/api/support-content",
+  },
+
   LAST_MILE_REQUESTS: {
-    BY_ID: (id: string) => `/last-mile-requests/${id}`,
-    SUBMIT: (id: string) => `/last-mile-requests/${id}/submit`,
-    CONTRACT_VIEW: (id: string) => `/last-mile-requests/${id}/contract/view`,
-    CONTRACT_DOCUMENT: (id: string) => `/last-mile-requests/${id}/contract/document`,
-    CONTRACT_SIGN: (id: string) => `/last-mile-requests/${id}/contract/sign`,
+    BY_BOOKING: (bookingId: string) => `/api/last-mile-requests/by-booking/${bookingId}`,
+    BY_ID: (id: string) => `/api/last-mile-requests/${id}`,
+    SUBMIT: (id: string) => `/api/last-mile-requests/${id}/submit`,
+    CONTRACT_VIEW: (id: string) => `/api/last-mile-requests/${id}/contract/view`,
+    CONTRACT_DOCUMENT: (id: string) => `/api/last-mile-requests/${id}/contract/document`,
+    CONTRACT_SIGN: (id: string) => `/api/last-mile-requests/${id}/contract/sign`,
   },
 };
diff --git a/apps/edr-freight-web/portal/src/hooks/useAuth.ts b/apps/edr-freight-web/portal/src/hooks/useAuth.ts
index 3573750a9..d2fbb1026 100644
--- a/apps/edr-freight-web/portal/src/hooks/useAuth.ts
+++ b/apps/edr-freight-web/portal/src/hooks/useAuth.ts
@@ -1,6 +1,12 @@
 import { api } from "@/services/api";
-import type { ProfileTypeValue } from "@/services/companies.service";
-import { companiesService } from "@/services/companies.service";
+import type {
+  CompanyInfoResponse,
+  ProfileTypeValue,
+} from "@/services/companies.service";
+import {
+  companiesService,
+  isShippingLineAccount,
+} from "@/services/companies.service";
 import type {
   LoginPayload,
   LoginResponse,
@@ -40,10 +46,19 @@ const useAuth = () => {
     }),
   );
 
+  // `/companies/getInfo` is customer-only (PortalCustomerGuard). A staff
+  // account signed into the portal 403s on every call, and because a failed
+  // fetch leaves `company` null the onboarding gate redirects, which remounts
+  // the route tree, which refires the query — a request storm. Never ask.
+  const isCustomerAccount =
+    authQuery.data?.userType === "individual" ||
+    authQuery.data?.userType === "external_organization";
+
   const companyQuery = useQuery(
     api.companies.getInfo.queryOptions({
-      enabled: !!authQuery.data?.id,
+      enabled: !!authQuery.data?.id && isCustomerAccount,
       retry: false,
+      refetchOnMount: false,
 
       staleTime(query) {
         // Fast-poll while anything is awaiting a backoffice decision: an
@@ -55,7 +70,7 @@ const useAuth = () => {
             (p) => p.status !== "active",
           )
         )
-          return 60;
+          return 60_000;
 
         return 10 * 60 * 1000;
       },
@@ -158,7 +173,21 @@ const useAuth = () => {
     }
   };
 
-  const companyInfo = isAuthenticated ? (companyQuery.data ?? null) : null;
+  const accountInfo = isAuthenticated ? (companyQuery.data ?? null) : null;
+
+  /**
+   * Shipping lines share the portal with customers but have no company, no
+   * external profile and no onboarding. Identified positively from the
+   * backend's discriminator — never from "company is missing", which is also
+   * true while the fetch is in flight or after it fails.
+   */
+  const isShippingLine = isShippingLineAccount(accountInfo);
+  const shippingLine = isShippingLine ? accountInfo : null;
+
+  // Every customer-shaped field below is null/empty for a shipping line.
+  const companyInfo = isShippingLine
+    ? null
+    : (accountInfo as CompanyInfoResponse | null);
   const companyType = companyInfo?.company?.type ?? null;
   const companyStatus = companyInfo?.company?.status ?? null;
   // A company can create bookings only once an admin has approved it (active).
@@ -259,8 +288,11 @@ const useAuth = () => {
     isPending,
     isAuthenticated,
     user: isAuthenticated ? (authQuery.data ?? null) : null,
-    company: isAuthenticated ? (companyQuery.data ?? null) : null,
-    customer: isAuthenticated ? (companyQuery.data ?? null) : null,
+    // The whole getInfo payload, not the `company` field within it (historical
+    // name). Null for a shipping line: consumers read `.company` / `.profile`
+    // off it, and a shipping line has neither.
+    company: companyInfo,
+    customer: companyInfo,
     canBook,
     hasActiveProfile,
     hasPendingProfile,
@@ -272,6 +304,8 @@ const useAuth = () => {
     isUnderReview,
     onboardingCompleted,
     onboardingStep,
+    isShippingLine,
+    shippingLine,
     createProfile,
     reapplyProfile,
     login,
@@ -283,7 +317,11 @@ const useAuth = () => {
     logout,
     authQuery,
     companyQuery,
-    customerQuery: companyQuery,
+    // A disabled query reports `isPending` forever; the route gates read this
+    // to decide "still loading", so a staff account would sit on a spinner.
+    customerQuery: isCustomerAccount
+      ? companyQuery
+      : { ...companyQuery, isPending: false },
   };
 };
 
diff --git a/apps/edr-freight-web/portal/src/hooks/useETradeData.ts b/apps/edr-freight-web/portal/src/hooks/useETradeData.ts
index 9fbce53d9..e764ecad5 100644
--- a/apps/edr-freight-web/portal/src/hooks/useETradeData.ts
+++ b/apps/edr-freight-web/portal/src/hooks/useETradeData.ts
@@ -3,10 +3,17 @@ import { companiesService } from "@/services/companies.service";
 import { extractApiError } from "@/utils/result";
 import type { CompanyRegistrationData } from "@edr/types";
 
+/**
+ * `licenceNumber` picks which of the TIN's business licences to resolve — a TIN
+ * routinely holds several, and the customer says which one they operate as.
+ */
 export function useETradeData() {
   return useMutation({
-    mutationFn: async (tin: string): Promise<CompanyRegistrationData> => {
-      return companiesService.fetchETradeInfo({ tin });
+    mutationFn: async (vars: {
+      tin: string;
+      licenceNumber?: string;
+    }): Promise<CompanyRegistrationData> => {
+      return companiesService.fetchETradeInfo(vars);
     },
     onError: (error) => {
       const { message } = extractApiError(error);
diff --git a/apps/edr-freight-web/portal/src/hooks/usePortalContent.ts b/apps/edr-freight-web/portal/src/hooks/usePortalContent.ts
new file mode 100644
index 000000000..39d5d7a09
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/hooks/usePortalContent.ts
@@ -0,0 +1,39 @@
+import type { PortalContentBundle } from "@edr/types";
+import { useQuery } from "@tanstack/react-query";
+
+import { URL_CONSTANTS } from "@/constants/URLS";
+import {
+  FALLBACK_PORTAL_CONTENT,
+  withSupportVars,
+} from "@/pages/support/portal-content";
+import type { ApiResponse } from "@/types/apiResponse";
+import { client } from "@/utils/api";
+import { unwrap } from "@/utils/endpoint";
+
+/**
+ * The whole public help/FAQ/legal bundle in one request, shared by the four
+ * public pages (react-query dedupes it across the routes).
+ *
+ * The endpoint is unauthenticated and the shared axios client attaches a token
+ * only when the cookie exists, so this works for anonymous visitors as-is.
+ *
+ * `placeholderData` means `data` is never undefined: the pages render the
+ * shipped copy immediately and swap in the live copy when the fetch resolves.
+ * That is deliberate — it is what lets the four public pages skip loading and
+ * error states entirely. If the fallback is ever removed, those states are
+ * owed back.
+ */
+export function usePortalContent() {
+  return useQuery({
+    queryKey: ["portal-content"],
+    queryFn: async (): Promise<PortalContentBundle> => {
+      const response = await client.get<ApiResponse<PortalContentBundle>>(
+        URL_CONSTANTS.PORTAL_CONTENT.PUBLIC,
+      );
+      return unwrap(response.data);
+    },
+    placeholderData: FALLBACK_PORTAL_CONTENT,
+    select: withSupportVars,
+    staleTime: 5 * 60_000,
+  });
+}
diff --git a/apps/edr-freight-web/portal/src/main.tsx b/apps/edr-freight-web/portal/src/main.tsx
index 49fec0edf..b2f5896d9 100644
--- a/apps/edr-freight-web/portal/src/main.tsx
+++ b/apps/edr-freight-web/portal/src/main.tsx
@@ -48,7 +48,10 @@ if (!rootElement) {
 createRoot(document.getElementById("root")!).render(
   <StrictMode>
     <PostHogProvider client={posthog}>
-      <MantineProvider theme={mantineTheme} defaultColorScheme="light">
+      {/* forceColorScheme (not defaultColorScheme) — the app is light-only.
+          `default` still lets Mantine flip to dark via useMantineColorScheme
+          or a persisted color-scheme value; `force` pins it. */}
+      <MantineProvider theme={mantineTheme} forceColorScheme="light">
         <QueryClientProvider client={queryClient}>
           <BrowserRouter>
             <PostHogErrorBoundary fallback={<AppErrorFallback />}>
diff --git a/apps/edr-freight-web/portal/src/pages/EDRFreightLandingPage.tsx b/apps/edr-freight-web/portal/src/pages/EDRFreightLandingPage.tsx
index b6f4787d6..59e6f2ad6 100644
--- a/apps/edr-freight-web/portal/src/pages/EDRFreightLandingPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/EDRFreightLandingPage.tsx
@@ -1,139 +1,571 @@
+import { useEffect, useRef, useState } from "react";
 import { Link } from "react-router-dom";
 import {
   ArrowRight,
-  BarChart3,
+  BellRing,
+  Briefcase,
+  Building2,
+  ChartColumn,
+  Check,
   CheckCircle2,
   Clock3,
-  Globe2,
+  FileCheck,
+  FileText,
   Mail,
+  Map as MapIcon,
   MapPin,
   Menu,
+  Package,
+  PackageSearch,
   Phone,
-  ShieldCheck,
-  Train,
+  Radar,
+  Receipt,
+  Route as RouteIcon,
+  Satellite,
+  Ship,
+  Timer,
+  TrainFront,
+  TrendingDown,
+  TrendingUp,
   Truck,
-  Users,
 } from "lucide-react";
 
+/* ------------------------------------------------------------------ */
+/* Motion helpers                                                      */
+/* ------------------------------------------------------------------ */
+
+/** Reveals children once they scroll into view. No animation library needed. */
+function useReveal<T extends HTMLElement>() {
+  const ref = useRef<T | null>(null);
+  const [shown, setShown] = useState(false);
+
+  useEffect(() => {
+    const node = ref.current;
+    if (!node) return;
+    if (typeof IntersectionObserver === "undefined") {
+      setShown(true);
+      return;
+    }
+
+    const observer = new IntersectionObserver(
+      (entries) => {
+        if (entries.some((entry) => entry.isIntersecting)) {
+          setShown(true);
+          observer.disconnect();
+        }
+      },
+      { rootMargin: "0px 0px -12% 0px", threshold: 0.15 },
+    );
+
+    observer.observe(node);
+    return () => observer.disconnect();
+  }, []);
+
+  return { ref, shown };
+}
+
+function Reveal({
+  children,
+  delay = 0,
+  className = "",
+}: {
+  children: React.ReactNode;
+  delay?: number;
+  className?: string;
+}) {
+  const { ref, shown } = useReveal<HTMLDivElement>();
+
+  return (
+    <div
+      ref={ref}
+      className={`edr-reveal ${shown ? "is-visible" : ""} ${className}`}
+      style={{ transitionDelay: `${delay}ms` }}
+    >
+      {children}
+    </div>
+  );
+}
+
+/** Counts up to `value` when scrolled into view. Keeps prefix/suffix intact. */
+function CountUp({
+  value,
+  decimals = 0,
+  prefix = "",
+  suffix = "",
+  duration = 1400,
+}: {
+  value: number;
+  decimals?: number;
+  prefix?: string;
+  suffix?: string;
+  duration?: number;
+}) {
+  const { ref, shown } = useReveal<HTMLSpanElement>();
+  const [display, setDisplay] = useState(0);
+
+  useEffect(() => {
+    if (!shown) return;
+    if (window.matchMedia?.("(prefers-reduced-motion: reduce)").matches) {
+      setDisplay(value);
+      return;
+    }
+
+    let frame = 0;
+    const start = performance.now();
+
+    const tick = (now: number) => {
+      const progress = Math.min(1, (now - start) / duration);
+      // easeOutCubic
+      setDisplay(value * (1 - Math.pow(1 - progress, 3)));
+      if (progress < 1) frame = requestAnimationFrame(tick);
+    };
+
+    frame = requestAnimationFrame(tick);
+    return () => cancelAnimationFrame(frame);
+  }, [shown, value, duration]);
+
+  return (
+    <span ref={ref}>
+      {prefix}
+      {display.toFixed(decimals)}
+      {suffix}
+    </span>
+  );
+}
+
+/* ------------------------------------------------------------------ */
+/* Content                                                             */
+/* ------------------------------------------------------------------ */
+
+const navLinks = [
+  { label: "Features", href: "#features" },
+  { label: "Live ops", href: "#showcase" },
+  { label: "Corridors", href: "#corridors" },
+  { label: "How it works", href: "#how" },
+  { label: "Contact", href: "#contact" },
+];
+
+const heroTrust = [
+  "Telebirr & CBE Birr payments",
+  "Fayda ID verified",
+  "Customs-ready documents",
+];
+
+const trackingStops = [
+  { name: "Mojo Dry Port", time: "Loaded · 06:40", state: "done" },
+  { name: "Adama", time: "Departed · 08:15", state: "done" },
+  { name: "Dire Dawa", time: "ETA 14:30", state: "current" },
+  { name: "Dewele (Border)", time: "ETA 18:05", state: "idle" },
+  { name: "Djibouti Port", time: "ETA 22:40", state: "idle" },
+] as const;
+
 const stats = [
   {
-    label: "Active Corridors",
-    value: "24+",
-    icon: Globe2,
+    icon: RouteIcon,
+    value: <CountUp value={752} suffix=" km" />,
+    label: "Addis Ababa → Djibouti · electrified",
+    trend: "Standard gauge",
+    down: false,
+    chart: [20, 24, 28, 30, 34, 36, 40, 44],
   },
   {
-    label: "Monthly Shipments",
-    value: "12K+",
-    icon: Truck,
+    icon: Package,
+    value: <CountUp value={12.4} decimals={1} suffix="K" />,
+    label: "Monthly consignments booked",
+    trend: "+18% vs last month",
+    down: false,
+    chart: [16, 22, 19, 26, 30, 28, 36, 44],
   },
   {
-    label: "Fleet Coverage",
-    value: "16 Trains",
-    icon: Train,
+    icon: TrainFront,
+    value: <CountUp value={16} />,
+    label: "Train sets in active rotation",
+    trend: "14 running now",
+    down: false,
+    fleet: true,
   },
   {
-    label: "On-time Delivery",
-    value: "100%",
-    icon: Clock3,
+    icon: Timer,
+    value: <CountUp value={10} prefix="<" suffix=" min" />,
+    label: "Booking to confirmed wagon",
+    trend: "-62% since launch",
+    down: true,
+    chart: [44, 40, 36, 30, 26, 20, 16, 12],
   },
 ];
 
+const stations = [
+  { name: "Sebeta", hub: false },
+  { name: "Addis Ababa", hub: true, note: "Km 0" },
+  { name: "Mojo", hub: true },
+  { name: "Adama", hub: false },
+  { name: "Awash", hub: false },
+  { name: "Mieso", hub: false },
+  { name: "Dire Dawa", hub: true },
+  { name: "Dewele", hub: true, note: "Customs", border: true },
+  { name: "Ali Sabieh", hub: false },
+  { name: "Djibouti Port", hub: true, note: "Km 752" },
+];
+
+const lanes = [
+  { from: "Mojo Dry Port", to: "Djibouti Port", transit: "~16h", kind: "Containers" },
+  { from: "Addis Ababa", to: "Djibouti Port", transit: "~19h", kind: "Mixed cargo" },
+  { from: "Djibouti Port", to: "Mojo Dry Port", transit: "~16h", kind: "Imports" },
+  { from: "Dire Dawa", to: "Djibouti Port", transit: "~8h", kind: "Bulk" },
+];
+
+const steps = [
+  {
+    num: "01",
+    title: "Verify & register",
+    body: "Sign up with your company TIN, verify with Fayda ID, and get trade access approved by EDR.",
+  },
+  {
+    num: "02",
+    title: "Book & pay",
+    body: "Pick origin, destination, cargo type and schedule. Pay with Telebirr, CBE Birr or contract credit.",
+  },
+  {
+    num: "03",
+    title: "Load & clear",
+    body: "Wagon allocation, loading confirmation, interchange document and customs stamps — all digital.",
+  },
+  {
+    num: "04",
+    title: "Track & settle",
+    body: "Follow the train live, get gate notifications, and download the final invoice when the cargo is released.",
+  },
+];
+
+const audiences = [
+  {
+    icon: Building2,
+    title: "Shippers & importers",
+    body: "Book, pay, track and download documents from one dashboard.",
+    items: ["Consignment booking", "Live tracking", "Invoices & receipts"],
+  },
+  {
+    icon: Ship,
+    title: "Shipping lines",
+    body: "Manage container inventory, bookings and interchange with the railway.",
+    items: ["Container management", "Booking completion", "Interchange documents"],
+  },
+  {
+    icon: Briefcase,
+    title: "Transit agents",
+    body: "Handle customs declarations, stamps and signatures on behalf of clients.",
+    items: ["Digital stamps", "E-signatures", "Compliance checks"],
+  },
+  {
+    icon: TrainFront,
+    title: "EDR operations",
+    body: "Train sets, locomotives, wagons, schedules, maintenance and incidents.",
+    items: ["Train builder", "Fleet & fuel", "Incident reporting"],
+  },
+];
+
+/* ------------------------------------------------------------------ */
+/* Feature previews                                                    */
+/* ------------------------------------------------------------------ */
+
+function Chip({
+  children,
+  tone = "green",
+  icon: Icon,
+}: {
+  children: React.ReactNode;
+  tone?: "green" | "amber" | "muted";
+  icon?: React.ElementType;
+}) {
+  const tones = {
+    green: "bg-emerald-50 text-emerald-700",
+    amber: "bg-amber-50 text-amber-700",
+    muted: "bg-slate-100 text-slate-500",
+  };
+
+  return (
+    <span
+      className={`inline-flex shrink-0 items-center gap-1 rounded-full px-2 py-1 text-[11px] font-semibold ${tones[tone]}`}
+    >
+      {Icon ? <Icon className="size-3" /> : null}
+      {children}
+    </span>
+  );
+}
+
+function BookingPreview() {
+  return (
+    <div className="flex w-full flex-col gap-2.5">
+      <div className="flex items-center justify-between gap-3 rounded-xl border border-border bg-card px-3 py-2.5">
+        <div className="min-w-0">
+          <p className="truncate text-[13px] font-bold">CN-2026-08421</p>
+          <p className="truncate text-[11px] text-muted-foreground">
+            Mojo → Djibouti · 40ft × 8
+          </p>
+        </div>
+        <Chip icon={Check}>Confirmed</Chip>
+      </div>
+
+      <div className="flex items-center justify-between gap-3">
+        <span className="text-[11px] text-muted-foreground">
+          Depart Thu 21 Aug · TS-14
+        </span>
+        <span className="text-xs font-bold">ETB 184,200</span>
+      </div>
+    </div>
+  );
+}
+
+function GpsPreview() {
+  return (
+    <div className="flex w-full flex-col gap-2.5">
+      <div className="edr-minitrack" aria-hidden>
+        <span className="edr-minitrack-dot" />
+      </div>
+
+      <div className="flex justify-between text-[10px] text-muted-foreground">
+        {["Mojo", "Adama", "Awash", "Dire Dawa", "Djibouti"].map((s) => (
+          <span key={s}>{s}</span>
+        ))}
+      </div>
+
+      <div className="flex items-center justify-between gap-3">
+        <span className="text-[11px] font-semibold">Loco 3421 · 64 km/h</span>
+        <Chip tone="amber" icon={Clock3}>
+          ETA 14:30
+        </Chip>
+      </div>
+    </div>
+  );
+}
+
+function DocsPreview() {
+  const docs = [
+    { name: "Interchange document", status: "Signed" },
+    { name: "Customs declaration", status: "Stamped" },
+    { name: "Commercial invoice", status: "Pending" },
+  ];
+
+  return (
+    <div className="flex w-full flex-col gap-2.5">
+      {docs.map((doc) => {
+        const pending = doc.status === "Pending";
+
+        return (
+          <div key={doc.name} className="flex items-center gap-2">
+            <FileText
+              className={`size-3.5 shrink-0 ${pending ? "text-muted-foreground" : "text-edr-primary"}`}
+            />
+            <span className="min-w-0 flex-1 truncate text-xs">{doc.name}</span>
+            <Chip tone={pending ? "muted" : "green"} icon={pending ? undefined : Check}>
+              {doc.status}
+            </Chip>
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+
+function BillingPreview() {
+  return (
+    <div className="flex w-full flex-col gap-2.5">
+      <div className="flex items-center justify-between gap-3 rounded-xl border border-border bg-card px-3 py-2.5">
+        <div className="min-w-0">
+          <p className="truncate text-[13px] font-bold">INV-1042 · Aug</p>
+          <p className="truncate text-[11px] text-muted-foreground">
+            ETB 1,284,600
+          </p>
+        </div>
+        <Chip icon={Check}>Paid</Chip>
+      </div>
+
+      <div className="flex flex-wrap gap-1.5">
+        {["Telebirr", "CBE Birr", "eBirr", "Card"].map((method) => (
+          <span
+            key={method}
+            className="rounded-md border border-border bg-card px-2 py-1 text-[10px] font-semibold text-muted-foreground"
+          >
+            {method}
+          </span>
+        ))}
+      </div>
+    </div>
+  );
+}
+
+function MilePreview() {
+  const legs = [
+    { icon: Truck, name: "Truck" },
+    { icon: TrainFront, name: "Rail" },
+    { icon: Truck, name: "Truck" },
+  ];
+
+  return (
+    <div className="flex w-full flex-col gap-2.5">
+      <div className="flex items-center">
+        {legs.map((leg, index) => {
+          const Icon = leg.icon;
+          const isRail = index === 1;
+
+          return (
+            <div key={leg.name + index} className="contents">
+              <div className="flex flex-col items-center gap-1.5">
+                <span
+                  className={`flex size-10 items-center justify-center rounded-xl ${
+                    isRail
+                      ? "bg-edr-primary text-white shadow-md shadow-emerald-500/25"
+                      : "border border-border bg-card text-edr-primary"
+                  }`}
+                >
+                  <Icon className="size-4.5" />
+                </span>
+                <span className="text-[10px] text-muted-foreground">{leg.name}</span>
+              </div>
+
+              {index < legs.length - 1 ? (
+                <span className="edr-dashline mb-4 h-0.5 flex-1" />
+              ) : null}
+            </div>
+          );
+        })}
+      </div>
+
+      <div className="flex justify-between text-[10px] text-muted-foreground">
+        <span>Warehouse, Gerji</span>
+        <span>Consignee, Djibouti</span>
+      </div>
+    </div>
+  );
+}
+
+function AnalyticsPreview() {
+  const bars = [22, 30, 26, 36, 40, 34, 46, 52, 48, 56];
+
+  return (
+    <div className="flex w-full flex-col gap-2.5">
+      <div className="flex h-14 items-end gap-1.5">
+        {bars.map((height, index) => (
+          <span
+            key={index}
+            className={`edr-grow flex-1 rounded-sm ${
+              index >= 8 ? "bg-edr-primary" : "bg-emerald-200"
+            }`}
+            style={{
+              height: `${height}%`,
+              animationDelay: `${index * 60}ms`,
+            }}
+          />
+        ))}
+      </div>
+
+      <div className="flex items-center justify-between gap-3">
+        <span className="text-[11px] text-muted-foreground">
+          Corridor throughput · TEU/week
+        </span>
+        <Chip icon={TrendingUp}>+12%</Chip>
+      </div>
+    </div>
+  );
+}
+
 const features = [
   {
-    title: "Real-time Shipment Tracking",
-    description:
-      "Track consignments across Addis Ababa, Dire Dawa, Djibouti, Mojo, and all major freight corridors.",
+    icon: PackageSearch,
+    title: "Consignment booking",
+    body: "Book containers or bulk cargo, pick a train schedule, and get a confirmed wagon allocation in minutes.",
+    preview: <BookingPreview />,
+  },
+  {
+    icon: Radar,
+    title: "Live GPS tracking",
+    body: "Locomotive telemetry and wagon-level position across every station from Mojo to Djibouti Port.",
+    preview: <GpsPreview />,
+  },
+  {
+    icon: FileCheck,
+    title: "Customs & documents",
+    body: "Interchange documents, stamps and e-signatures generated and shared with transit agents automatically.",
+    preview: <DocsPreview />,
+  },
+  {
+    icon: Receipt,
+    title: "Billing & payments",
+    body: "Contract rates, invoices and settlement via Telebirr, CBE Birr, eBirr or card — with full audit trail.",
+    preview: <BillingPreview />,
+  },
+  {
     icon: Truck,
+    title: "First & last mile",
+    body: "Request trucking to and from the railhead and see it on the same timeline as the rail leg.",
+    preview: <MilePreview />,
   },
   {
-    title: "Rail Freight Operations",
-    description:
-      "Monitor train schedules, operational performance, maintenance, and corridor activity.",
-    icon: Train,
-  },
-  {
-    title: "Smart Analytics Dashboard",
-    description:
-      "Visualize operational insights, shipment trends, and corridor performance in real time.",
-    icon: BarChart3,
-  },
-  {
-    title: "Enterprise-grade Security",
-    description:
-      "Secure portal access, billing workflows, document management, and customer operations.",
-    icon: ShieldCheck,
+    icon: ChartColumn,
+    title: "Operations analytics",
+    body: "Corridor throughput, on-time performance, fleet utilisation and incident reporting for operators.",
+    preview: <AnalyticsPreview />,
   },
 ];
 
-const corridors = [
-  "Addis Ababa → Djibouti",
-  "Dire Dawa → Djibouti",
-  "Adama → Dire Dawa",
-  "Mojo → Djibouti",
-  "Awash → Holhol",
-  "Mieso → Aysha",
-];
+/* ------------------------------------------------------------------ */
+/* Page                                                                */
+/* ------------------------------------------------------------------ */
 
 export default function EDRFreightLandingPage() {
   return (
     <div className="min-h-screen bg-background text-foreground">
+      <LandingStyles />
+
       {/* Navbar */}
-      <header className="sticky top-0 z-50 border-b border-border bg-background/80 backdrop-blur-xl">
+      <header className="sticky top-0 z-50 border-b border-white/10 bg-edr-ink/90 backdrop-blur-xl">
         <div className="mx-auto flex h-20 max-w-7xl items-center justify-between px-6">
-          <div className="flex items-center gap-3">
-            <div className="flex size-12 items-center justify-center rounded-2xl bg-primary text-primary-foreground shadow-lg">
-              <Train className="size-6" />
-            </div>
+          <Link to="/" className="flex items-center gap-3">
+            <span className="flex size-10 items-center justify-center rounded-xl bg-edr-primary text-white shadow-lg shadow-emerald-500/25">
+              <TrainFront className="size-5" />
+            </span>
 
-            <div>
-              <h1 className="text-xl font-bold tracking-tight">EDR Freight</h1>
-
-              <p className="text-sm text-muted-foreground">
+            <span className="leading-tight">
+              <span className="block text-lg font-bold text-white">EDR Freight</span>
+              <span className="block text-[11px] tracking-wide text-slate-400">
                 Rail Logistics Platform
-              </p>
-            </div>
-          </div>
+              </span>
+            </span>
+          </Link>
 
-          <nav className="hidden items-center gap-8 md:flex">
-            <a
-              href="#features"
-              className="text-sm font-medium text-muted-foreground transition hover:text-foreground"
-            >
-              Features
-            </a>
-
-            <a
-              href="#corridors"
-              className="text-sm font-medium text-muted-foreground transition hover:text-foreground"
-            >
-              Corridors
-            </a>
-
-            <a
-              href="#contact"
-              className="text-sm font-medium text-muted-foreground transition hover:text-foreground"
-            >
-              Contact
-            </a>
+          <nav className="hidden items-center gap-9 lg:flex">
+            {navLinks.map((link) => (
+              <a
+                key={link.href}
+                href={link.href}
+                className="text-sm font-medium text-slate-300 transition hover:text-white"
+              >
+                {link.label}
+              </a>
+            ))}
           </nav>
 
           <div className="flex items-center gap-3">
             <Link
               to="/login"
-              className="hidden rounded-2xl border border-border bg-card px-5 py-2.5 text-sm font-medium transition hover:bg-accent md:block"
+              className="hidden rounded-lg border border-white/20 px-5 py-2.5 text-sm font-medium text-white transition hover:bg-white/10 md:block"
             >
-              Login
+              Log in
             </Link>
 
             <Link
               to="/signup"
-              className="hidden items-center gap-2 rounded-2xl bg-primary px-5 py-2.5 text-sm font-semibold text-primary-foreground shadow-lg transition hover:opacity-90 md:flex"
+              className="hidden items-center gap-2 rounded-lg bg-edr-primary px-5 py-2.5 text-sm font-semibold text-white shadow-lg shadow-emerald-500/25 transition hover:-translate-y-0.5 hover:bg-edr-primary-dark md:flex"
             >
-              Get Started
+              Get started
               <ArrowRight className="size-4" />
             </Link>
 
-            <button className="rounded-2xl border border-border p-2 md:hidden">
+            <button
+              type="button"
+              aria-label="Open menu"
+              className="rounded-lg border border-white/20 p-2 text-white lg:hidden"
+            >
               <Menu className="size-5" />
             </button>
           </div>
@@ -141,361 +573,554 @@ export default function EDRFreightLandingPage() {
       </header>
 
       {/* Hero */}
-      <section className="relative overflow-hidden">
-        <div className="absolute inset-0 bg-[radial-gradient(circle_at_top_right,rgba(16,185,129,0.16),transparent_35%)]" />
+      <section className="edr-hero relative overflow-hidden bg-edr-ink">
+        <div className="edr-rails" aria-hidden />
+        <div className="edr-hero-glow" aria-hidden />
 
-        <div className="mx-auto grid relative z-10 max-w-7xl gap-16 px-6 py-20 lg:grid-cols-2 lg:items-center">
+        <div className="relative z-10 mx-auto grid max-w-7xl gap-16 px-6 py-20 lg:grid-cols-[1.05fr_0.95fr] lg:items-center lg:py-24">
           <div>
-            <div className="mb-6 inline-flex items-center gap-2 rounded-full border border-border bg-accent px-4 py-2 text-sm font-medium text-primary shadow-sm">
-              <span className="size-2 rounded-full bg-primary" />
-              Ethiopia–Djibouti Railway Freight Platform
-            </div>
+            <Reveal>
+              <span className="inline-flex items-center gap-2 rounded-full border border-white/15 bg-white/5 py-1.5 pl-2 pr-3 text-[13px] font-medium text-white">
+                <span className="edr-pulse-dot" />
+                Live on the Addis Ababa – Djibouti corridor
+              </span>
+            </Reveal>
 
-            <h1 className="max-w-2xl text-5xl font-black leading-tight tracking-tight md:text-6xl">
-              Smarter Railway Freight Logistics For Modern Operations
-            </h1>
+            <Reveal delay={80}>
+              <h1 className="mt-7 text-5xl font-bold leading-[1.05] tracking-tight text-white md:text-6xl">
+                Move cargo by rail.
+                <span className="block text-emerald-400">Track every wagon.</span>
+              </h1>
+            </Reveal>
 
-            <p className="mt-6 max-w-2xl text-lg leading-8 text-muted-foreground">
-              EDR Freight enables logistics companies and railway operators to
-              manage shipments, monitor freight corridors, optimize train
-              operations, and streamline enterprise logistics workflows.
-            </p>
+            <Reveal delay={160}>
+              <p className="mt-6 max-w-xl text-lg leading-relaxed text-slate-300">
+                EDR Freight is the booking, tracking and billing platform for the
+                Ethio-Djibouti Railway. Book consignments, schedule train sets,
+                clear customs documents and settle invoices — in one portal.
+              </p>
+            </Reveal>
 
-            <div className="mt-10 flex flex-wrap gap-4">
-              <Link
-                to="/signup"
-                className="flex items-center gap-2 rounded-2xl bg-primary px-6 py-3 font-semibold text-primary-foreground shadow-lg transition hover:-translate-y-0.5 hover:opacity-90"
-              >
-                Get Started
-                <ArrowRight className="size-5" />
-              </Link>
-
-              <Link
-                to="/login"
-                className="rounded-2xl border border-border bg-card px-6 py-3 font-semibold transition hover:bg-accent"
-              >
-                Login
-              </Link>
-            </div>
-
-            <div className="mt-12 flex flex-wrap gap-6">
-              {[
-                "Real-time Tracking",
-                "Railway Analytics",
-                "Secure Operations",
-                "Multi-corridor Freight",
-              ].map((item) => (
-                <div
-                  key={item}
-                  className="flex items-center gap-2 text-sm text-muted-foreground"
+            <Reveal delay={240}>
+              <div className="mt-9 flex flex-wrap gap-3">
+                <Link
+                  to="/signup"
+                  className="flex items-center gap-2 rounded-xl bg-edr-primary px-6 py-3.5 font-semibold text-white shadow-xl shadow-emerald-500/30 transition hover:-translate-y-0.5 hover:bg-edr-primary-dark"
                 >
-                  <CheckCircle2 className="size-4 text-primary" />
-                  {item}
-                </div>
-              ))}
-            </div>
+                  Book a shipment
+                  <ArrowRight className="size-4.5" />
+                </Link>
+
+                <a
+                  href="#how"
+                  className="flex items-center gap-2 rounded-xl border border-white/20 px-6 py-3.5 font-medium text-white transition hover:bg-white/10"
+                >
+                  See how it works
+                </a>
+              </div>
+            </Reveal>
+
+            <Reveal delay={320}>
+              <div className="mt-10 flex flex-wrap gap-x-6 gap-y-3">
+                {heroTrust.map((item) => (
+                  <span
+                    key={item}
+                    className="flex items-center gap-2 text-[13px] text-slate-300"
+                  >
+                    <CheckCircle2 className="size-4 text-emerald-400" />
+                    {item}
+                  </span>
+                ))}
+              </div>
+            </Reveal>
           </div>
 
-          {/* Hero Dashboard Card */}
-          <div className="relative">
-            <div className="rounded-[32px] border border-border bg-card p-8 shadow-2xl">
-              <div className="flex items-center justify-between">
-                <div>
-                  <p className="text-sm text-muted-foreground">
-                    Freight Operations
+          {/* Live tracking card */}
+          <Reveal delay={200}>
+            <div className="edr-float overflow-hidden rounded-3xl bg-card shadow-2xl ring-1 ring-white/15">
+              <div className="flex items-center justify-between gap-4 border-b border-border px-6 py-4">
+                <div className="min-w-0">
+                  <p className="truncate text-base font-bold">CN-2026-08417</p>
+                  <p className="truncate text-xs text-muted-foreground">
+                    Mojo Dry Port → Djibouti Port · 40ft × 12
                   </p>
-
-                  <h3 className="mt-2 text-3xl font-bold">Live Statistics</h3>
                 </div>
 
-                <div className="rounded-2xl bg-primary/10 p-4 text-primary">
-                  <BarChart3 className="size-7" />
-                </div>
+                <span className="inline-flex shrink-0 items-center gap-1.5 rounded-full bg-emerald-50 px-2.5 py-1 text-xs font-semibold text-emerald-700">
+                  <span className="edr-pulse-dot edr-pulse-dot--green" />
+                  In transit
+                </span>
               </div>
 
-              <div className="mt-8 grid grid-cols-2 gap-4">
-                {stats.map((item) => {
-                  const Icon = item.icon;
+              <ol className="px-6 py-5">
+                {trackingStops.map((stop, index) => {
+                  const isLast = index === trackingStops.length - 1;
+                  const done = stop.state === "done";
+                  const current = stop.state === "current";
 
                   return (
-                    <div
-                      key={item.label}
-                      className="rounded-3xl border border-border bg-background p-5 transition hover:-translate-y-1 hover:shadow-lg"
-                    >
-                      <div className="mb-4 flex size-12 items-center justify-center rounded-2xl bg-accent text-primary">
-                        <Icon className="size-6" />
-                      </div>
+                    <li key={stop.name} className="flex items-stretch gap-3.5">
+                      <span className="flex w-4 flex-col items-center">
+                        <span
+                          className={`size-3 shrink-0 rounded-full border-2 ${
+                            done
+                              ? "border-edr-primary bg-edr-primary"
+                              : current
+                                ? "border-edr-accent bg-edr-accent edr-ping"
+                                : "border-slate-300 bg-white"
+                          }`}
+                        />
+                        {!isLast ? (
+                          <span
+                            className={`my-1 w-0.5 flex-1 ${
+                              done && trackingStops[index + 1].state === "done"
+                                ? "bg-edr-primary"
+                                : "bg-border"
+                            }`}
+                          />
+                        ) : null}
+                      </span>
 
-                      <h4 className="text-3xl font-black">{item.value}</h4>
-
-                      <p className="mt-1 text-sm text-muted-foreground">
-                        {item.label}
-                      </p>
-                    </div>
+                      <span className={`flex flex-1 items-center justify-between gap-3 ${isLast ? "" : "pb-5"}`}>
+                        <span
+                          className={`text-sm ${
+                            current
+                              ? "font-semibold"
+                              : done
+                                ? "font-medium"
+                                : "font-medium text-muted-foreground"
+                          }`}
+                        >
+                          {stop.name}
+                        </span>
+                        <span className="text-xs text-muted-foreground">
+                          {stop.time}
+                        </span>
+                      </span>
+                    </li>
                   );
                 })}
-              </div>
+              </ol>
 
-              <div className="mt-8 rounded-3xl border border-border bg-accent p-6">
-                <div className="flex items-center justify-between">
-                  <div>
-                    <p className="text-sm text-muted-foreground">
-                      Corridor Performance
+              <div className="grid grid-cols-3 gap-3 bg-background px-6 pb-5 pt-4">
+                {[
+                  ["Train", "TS-14 · 2 locos"],
+                  ["Wagons", "12 / 12 loaded"],
+                  ["Next gate", "Dewele customs"],
+                ].map(([key, value]) => (
+                  <div key={key}>
+                    <p className="text-[10px] font-semibold tracking-wider text-muted-foreground uppercase">
+                      {key}
                     </p>
-
-                    <h3 className="mt-2 text-4xl font-black text-primary">
-                      99%
-                    </h3>
+                    <p className="mt-0.5 text-[13px] font-semibold">{value}</p>
                   </div>
-
-                  <div className="rounded-2xl bg-primary px-4 py-2 text-sm font-semibold text-primary-foreground">
-                    Operational
-                  </div>
-                </div>
-
-                <div className="mt-6 h-3 overflow-hidden rounded-full bg-primary/10">
-                  <div className="h-full w-[99%] rounded-full bg-primary" />
-                </div>
+                ))}
               </div>
             </div>
+          </Reveal>
+        </div>
+      </section>
 
-            <div className="absolute -bottom-6 -left-6 hidden rounded-3xl border border-border bg-card p-5 shadow-xl lg:block">
-              <div className="flex items-center gap-4">
-                <div className="flex size-14 items-center justify-center rounded-2xl bg-primary/10 text-primary">
-                  <Train className="size-7" />
-                </div>
+      {/* Stats */}
+      <section className="mx-auto max-w-7xl px-6 py-14">
+        <div className="grid gap-5 sm:grid-cols-2 xl:grid-cols-4">
+          {stats.map((stat, index) => {
+            const Icon = stat.icon;
+            const TrendIcon = stat.down ? TrendingDown : TrendingUp;
 
-                <div>
-                  <h4 className="text-lg font-bold">16 Trains Active</h4>
+            return (
+              <Reveal key={stat.label} delay={index * 90}>
+                <div className="h-full rounded-2xl border border-border bg-card p-6 shadow-sm transition duration-300 hover:-translate-y-1 hover:shadow-xl">
+                  <div className="flex items-center justify-between">
+                    <span className="flex size-9 items-center justify-center rounded-[10px] bg-edr-soft text-edr-primary">
+                      <Icon className="size-4.5" />
+                    </span>
 
-                  <p className="text-sm text-muted-foreground">
-                    Across all freight corridors
+                    <Chip icon={TrendIcon}>{stat.trend}</Chip>
+                  </div>
+
+                  <p className="mt-4 text-[40px] font-bold leading-none tracking-tight">
+                    {stat.value}
                   </p>
+                  <p className="mt-1.5 text-[13px] text-muted-foreground">
+                    {stat.label}
+                  </p>
+
+                  {stat.fleet ? (
+                    <div className="mt-4 grid grid-cols-8 gap-1.5">
+                      {Array.from({ length: 16 }).map((_, unit) => (
+                        <span
+                          key={unit}
+                          className={`edr-fade-in h-3.5 rounded-sm ${
+                            unit < 14
+                              ? "bg-edr-primary"
+                              : unit === 14
+                                ? "bg-edr-accent"
+                                : "bg-slate-300"
+                          }`}
+                          style={{ animationDelay: `${unit * 45}ms` }}
+                        />
+                      ))}
+                    </div>
+                  ) : (
+                    <div className="mt-4 flex h-12 items-end gap-1">
+                      {stat.chart!.map((height, bar) => (
+                        <span
+                          key={bar}
+                          className={`edr-grow flex-1 rounded-sm ${
+                            bar === stat.chart!.length - 1
+                              ? "bg-edr-accent"
+                              : bar >= stat.chart!.length - 3
+                                ? "bg-edr-primary"
+                                : "bg-emerald-200"
+                          }`}
+                          style={{
+                            height: `${(height / 48) * 100}%`,
+                            animationDelay: `${bar * 60}ms`,
+                          }}
+                        />
+                      ))}
+                    </div>
+                  )}
                 </div>
-              </div>
-            </div>
-          </div>
+              </Reveal>
+            );
+          })}
         </div>
       </section>
 
       {/* Features */}
-      <section
-        id="features"
-        className="border-t border-border bg-card/40 py-24"
-      >
-        <div className="mx-auto max-w-7xl px-6">
-          <div className="max-w-3xl">
-            <div className="inline-flex rounded-full bg-accent px-4 py-2 text-sm font-semibold text-primary">
-              Platform Features
-            </div>
-
-            <h2 className="mt-6 text-4xl font-black tracking-tight">
-              Everything needed for freight operations
-            </h2>
-
-            <p className="mt-4 text-lg leading-8 text-muted-foreground">
-              Centralized railway freight operations with live shipment
-              visibility, operational monitoring, customer management, and
-              intelligent logistics insights.
+      <section id="features" className="mx-auto max-w-7xl scroll-mt-24 px-6 py-20">
+        <div className="flex flex-col justify-between gap-8 lg:flex-row lg:items-end">
+          <Reveal className="max-w-2xl">
+            <p className="text-xs font-bold tracking-[0.16em] text-edr-primary">
+              PLATFORM
             </p>
-          </div>
+            <h2 className="mt-3 text-4xl font-bold leading-tight tracking-tight md:text-[44px]">
+              Everything between the dry port and the quay
+            </h2>
+          </Reveal>
 
-          <div className="mt-16 grid gap-6 md:grid-cols-2 xl:grid-cols-4">
-            {features.map((feature) => {
-              const Icon = feature.icon;
+          <Reveal delay={120} className="max-w-md">
+            <p className="text-base leading-relaxed text-muted-foreground">
+              One portal for shippers, shipping lines, transit agents and railway
+              operations. Built around the real workflow of the corridor, not a
+              generic TMS.
+            </p>
+          </Reveal>
+        </div>
 
-              return (
-                <div
-                  key={feature.title}
-                  className="group rounded-[28px] border border-border bg-background p-7 shadow-sm transition duration-300 hover:-translate-y-2 hover:shadow-2xl"
-                >
-                  <div className="flex size-14 items-center justify-center rounded-2xl bg-accent text-primary transition group-hover:scale-110">
-                    <Icon className="size-7" />
+        <div className="mt-12 grid gap-6 md:grid-cols-2 xl:grid-cols-3">
+          {features.map((feature, index) => {
+            const Icon = feature.icon;
+
+            return (
+              <Reveal key={feature.title} delay={(index % 3) * 100}>
+                <article className="group h-full overflow-hidden rounded-[18px] border border-border bg-card shadow-sm transition duration-300 hover:-translate-y-1.5 hover:shadow-2xl">
+                  <div className="flex h-[150px] items-center border-b border-border bg-background px-5">
+                    {feature.preview}
                   </div>
 
-                  <h3 className="mt-6 text-xl font-bold">{feature.title}</h3>
+                  <div className="p-6">
+                    <div className="flex items-center gap-3">
+                      <span className="flex size-10 items-center justify-center rounded-[10px] bg-gradient-to-br from-edr-primary to-emerald-400 text-white shadow-md shadow-emerald-500/25 transition group-hover:scale-110">
+                        <Icon className="size-5" />
+                      </span>
+                      <h3 className="text-[19px] font-bold">{feature.title}</h3>
+                    </div>
 
-                  <p className="mt-3 leading-7 text-muted-foreground">
-                    {feature.description}
-                  </p>
-                </div>
-              );
-            })}
-          </div>
+                    <p className="mt-3 text-sm leading-relaxed text-muted-foreground">
+                      {feature.body}
+                    </p>
+
+                    <span className="mt-3 inline-flex items-center gap-1.5 text-[13px] font-semibold text-edr-primary">
+                      Learn more
+                      <ArrowRight className="size-3.5 transition group-hover:translate-x-1" />
+                    </span>
+                  </div>
+                </article>
+              </Reveal>
+            );
+          })}
+        </div>
+      </section>
+
+      {/* Showcase */}
+      <section id="showcase" className="mx-auto max-w-7xl scroll-mt-24 px-6 pb-20">
+        <div className="grid gap-14 lg:grid-cols-[1.15fr_1fr] lg:items-center">
+          <Reveal>
+            <div className="relative overflow-hidden rounded-3xl shadow-2xl">
+              <img
+                src="/assets/train-edr.jpg"
+                alt="Freight train hauling containers along the corridor"
+                loading="lazy"
+                className="h-[420px] w-full object-cover"
+              />
+
+              <div className="absolute inset-0 bg-gradient-to-t from-edr-ink/85 via-edr-ink/10 to-transparent" />
+
+              <div className="absolute left-6 top-6 flex items-center gap-2.5 rounded-xl bg-white/90 px-3.5 py-2.5 backdrop-blur">
+                <span className="edr-pulse-dot edr-pulse-dot--green" />
+                <span className="text-[13px] font-semibold">
+                  TS-14 · Awash → Mieso · 68 km/h
+                </span>
+              </div>
+
+              <div className="absolute inset-x-6 bottom-6 flex flex-wrap gap-7">
+                {[
+                  ["98.4%", "On-time"],
+                  ["312", "Wagons moving"],
+                  ["16h 20m", "Avg transit"],
+                ].map(([value, key]) => (
+                  <div key={key}>
+                    <p className="text-2xl font-bold text-white">{value}</p>
+                    <p className="text-xs text-slate-200">{key}</p>
+                  </div>
+                ))}
+              </div>
+            </div>
+          </Reveal>
+
+          <Reveal delay={140}>
+            <p className="text-xs font-bold tracking-[0.16em] text-edr-primary">
+              LIVE OPERATIONS
+            </p>
+            <h2 className="mt-3 text-4xl font-bold leading-tight tracking-tight">
+              See the whole train, not just a tracking number
+            </h2>
+            <p className="mt-4 text-base leading-relaxed text-muted-foreground">
+              GPS from every locomotive, wagon-level loading status, gate events at
+              Dewele customs and ETA that updates as the train moves. Shippers and
+              operators look at the same map.
+            </p>
+
+            <ul className="mt-7 space-y-3">
+              {[
+                { icon: Satellite, text: "Locomotive telemetry every 30 seconds" },
+                { icon: BellRing, text: "SMS & in-app alerts on gate and border events" },
+                { icon: MapIcon, text: "Shareable tracking link for your consignee" },
+              ].map((point) => {
+                const Icon = point.icon;
+
+                return (
+                  <li key={point.text} className="flex items-center gap-3">
+                    <span className="flex size-8 items-center justify-center rounded-lg bg-edr-soft text-edr-primary">
+                      <Icon className="size-4" />
+                    </span>
+                    <span className="text-[15px] font-medium">{point.text}</span>
+                  </li>
+                );
+              })}
+            </ul>
+          </Reveal>
         </div>
       </section>
 
       {/* Corridors */}
-      <section id="corridors" className="py-24">
+      <section id="corridors" className="scroll-mt-24 bg-edr-ink py-20">
         <div className="mx-auto max-w-7xl px-6">
-          <div className="grid gap-16 lg:grid-cols-2 lg:items-center">
-            <div>
-              <div className="inline-flex rounded-full bg-accent px-4 py-2 text-sm font-semibold text-primary">
-                Freight Corridors
-              </div>
+          <Reveal className="max-w-3xl">
+            <p className="text-xs font-bold tracking-[0.16em] text-emerald-400">
+              NETWORK
+            </p>
+            <h2 className="mt-3 text-4xl font-bold leading-tight tracking-tight text-white md:text-[44px]">
+              One line. Two countries. Every station on the timeline.
+            </h2>
+            <p className="mt-4 text-base leading-relaxed text-slate-300">
+              Standard-gauge, fully electrified. Book any origin–destination pair
+              along the corridor and see wagon position station by station.
+            </p>
+          </Reveal>
 
-              <h2 className="mt-6 text-4xl font-black tracking-tight">
-                Connected logistics infrastructure
-              </h2>
+          {/* Animated corridor */}
+          <Reveal delay={120} className="mt-14">
+            <div className="edr-corridor" aria-hidden>
+              <span className="edr-corridor-train" />
+              {stations.map((station) => (
+                <span
+                  key={station.name}
+                  className={`edr-corridor-node ${station.hub ? "is-hub" : "hidden lg:block"} ${
+                    station.border ? "is-border" : ""
+                  }`}
+                />
+              ))}
+            </div>
 
-              <p className="mt-5 text-lg leading-8 text-muted-foreground">
-                Efficiently move freight across strategic Ethiopia–Djibouti
-                railway corridors with operational visibility and optimized
-                transport coordination.
-              </p>
-
-              <div className="mt-10 grid gap-4 sm:grid-cols-2">
-                {corridors.map((corridor) => (
-                  <div
-                    key={corridor}
-                    className="flex items-center gap-3 rounded-2xl border border-border bg-card p-4 transition hover:border-primary/30 hover:bg-accent"
+            <div className="mt-3 flex justify-between gap-1 overflow-x-auto">
+              {stations.map((station) => (
+                <span
+                  key={station.name}
+                  className={`flex min-w-0 flex-col items-center text-center ${
+                    station.hub ? "" : "hidden lg:flex"
+                  }`}
+                >
+                  <span
+                    className={`whitespace-nowrap text-[11px] sm:text-[13px] ${
+                      station.hub ? "font-semibold text-white" : "text-slate-400"
+                    }`}
                   >
-                    <div className="size-3 rounded-full bg-primary" />
-
-                    <span className="font-medium">{corridor}</span>
-                  </div>
-                ))}
-              </div>
+                    {station.name}
+                  </span>
+                  {station.note ? (
+                    <span
+                      className={`whitespace-nowrap text-[11px] ${
+                        station.border ? "text-edr-accent" : "text-emerald-400"
+                      }`}
+                    >
+                      {station.note}
+                    </span>
+                  ) : null}
+                </span>
+              ))}
             </div>
+          </Reveal>
 
-            <div className="rounded-[32px] border border-border bg-card p-8 shadow-xl">
-              <div className="flex items-center justify-between">
-                <div>
-                  <p className="text-sm text-muted-foreground">
-                    Operational Insights
+          <div className="mt-12 grid gap-4 sm:grid-cols-2 xl:grid-cols-4">
+            {lanes.map((lane, index) => (
+              <Reveal key={lane.from + lane.to} delay={index * 90}>
+                <div className="h-full rounded-2xl border border-white/10 bg-white/5 p-5 transition duration-300 hover:-translate-y-1 hover:border-emerald-400/40 hover:bg-white/10">
+                  <p className="flex flex-wrap items-center gap-2 text-base font-bold text-white">
+                    {lane.from}
+                    <ArrowRight className="size-3.5 text-emerald-400" />
+                    {lane.to}
+                  </p>
+                  <p className="mt-2.5 text-[13px] text-slate-400">
+                    {lane.transit} transit · {lane.kind}
                   </p>
-
-                  <h3 className="mt-2 text-3xl font-bold">
-                    Freight Performance
-                  </h3>
                 </div>
-
-                <div className="rounded-2xl bg-primary/10 p-4 text-primary">
-                  <Users className="size-7" />
-                </div>
-              </div>
-
-              <div className="mt-10 space-y-6">
-                {[
-                  {
-                    label: "Bookings Processed",
-                    value: "9,842",
-                    progress: "92%",
-                  },
-                  {
-                    label: "On-time Shipments",
-                    value: "99%",
-                    progress: "99%",
-                  },
-                  {
-                    label: "Customer Satisfaction",
-                    value: "99%",
-                    progress: "99%",
-                  },
-                ].map((item) => (
-                  <div key={item.label}>
-                    <div className="mb-2 flex items-center justify-between">
-                      <span className="font-medium">{item.label}</span>
-
-                      <span className="text-muted-foreground">
-                        {item.value}
-                      </span>
-                    </div>
-
-                    <div className="h-3 overflow-hidden rounded-full bg-secondary">
-                      <div
-                        className="h-full rounded-full bg-primary transition-all duration-700"
-                        style={{ width: item.progress }}
-                      />
-                    </div>
-                  </div>
-                ))}
-              </div>
-
-              <div className="mt-10 rounded-3xl bg-accent p-6">
-                <div className="flex items-center gap-4">
-                  <div className="flex size-14 items-center justify-center rounded-2xl bg-primary text-primary-foreground">
-                    <CheckCircle2 className="size-7" />
-                  </div>
-
-                  <div>
-                    <h4 className="text-lg font-bold">
-                      Enterprise-ready Platform
-                    </h4>
-
-                    <p className="text-sm text-muted-foreground">
-                      Designed for large-scale freight and railway operations.
-                    </p>
-                  </div>
-                </div>
-              </div>
-            </div>
+              </Reveal>
+            ))}
           </div>
         </div>
       </section>
 
+      {/* How it works */}
+      <section id="how" className="mx-auto max-w-7xl scroll-mt-24 px-6 py-20">
+        <div className="grid gap-16 lg:grid-cols-[420px_1fr] lg:items-start">
+          <Reveal>
+            <p className="text-xs font-bold tracking-[0.16em] text-edr-primary">
+              HOW IT WORKS
+            </p>
+            <h2 className="mt-3 text-4xl font-bold leading-tight tracking-tight">
+              From booking to delivered in four steps
+            </h2>
+            <p className="mt-4 text-base leading-relaxed text-muted-foreground">
+              No phone calls, no paper manifests. Every party — shipper, shipping
+              line, transit agent and station — works from the same record.
+            </p>
+
+            <Link
+              to="/signup"
+              className="mt-7 inline-flex items-center gap-2 rounded-xl bg-edr-ink px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5 hover:opacity-90"
+            >
+              Create a free account
+              <ArrowRight className="size-4" />
+            </Link>
+          </Reveal>
+
+          <div>
+            {steps.map((step, index) => (
+              <Reveal key={step.num} delay={index * 90}>
+                <div
+                  className={`flex gap-6 py-6 ${index ? "border-t border-border" : ""}`}
+                >
+                  <span className="text-sm font-bold text-edr-accent">
+                    {step.num}
+                  </span>
+
+                  <div>
+                    <h3 className="text-xl font-bold">{step.title}</h3>
+                    <p className="mt-1.5 text-[15px] leading-relaxed text-muted-foreground">
+                      {step.body}
+                    </p>
+                  </div>
+                </div>
+              </Reveal>
+            ))}
+          </div>
+        </div>
+      </section>
+
+      {/* Audiences */}
+      <section className="mx-auto max-w-7xl px-6 pb-20">
+        <Reveal>
+          <h2 className="text-[32px] font-bold tracking-tight">
+            Built for everyone on the corridor
+          </h2>
+        </Reveal>
+
+        <div className="mt-10 grid gap-6 sm:grid-cols-2 xl:grid-cols-4">
+          {audiences.map((audience, index) => {
+            const Icon = audience.icon;
+
+            return (
+              <Reveal key={audience.title} delay={index * 90}>
+                <div className="h-full rounded-2xl border border-border bg-card p-7 transition duration-300 hover:-translate-y-1.5 hover:border-edr-primary/30 hover:shadow-xl">
+                  <Icon className="size-7 text-edr-primary" />
+                  <h3 className="mt-4 text-lg font-bold">{audience.title}</h3>
+                  <p className="mt-2 text-sm leading-relaxed text-muted-foreground">
+                    {audience.body}
+                  </p>
+
+                  <ul className="mt-4 space-y-2">
+                    {audience.items.map((item) => (
+                      <li key={item} className="flex items-center gap-2">
+                        <Check className="size-3.5 shrink-0 text-edr-primary" />
+                        <span className="text-[13px] font-medium">{item}</span>
+                      </li>
+                    ))}
+                  </ul>
+                </div>
+              </Reveal>
+            );
+          })}
+        </div>
+      </section>
+
       {/* Contact */}
-      <section id="contact" className="border-t border-border bg-card/40 py-24">
-        <div className="mx-auto max-w-7xl px-6">
-          <div className="grid gap-12 lg:grid-cols-2">
-            <div>
-              <div className="inline-flex rounded-full bg-accent px-4 py-2 text-sm font-semibold text-primary">
-                Contact Us
-              </div>
+      <section id="contact" className="scroll-mt-24 border-t border-border bg-card/40 py-20">
+        <div className="mx-auto grid max-w-7xl gap-12 px-6 lg:grid-cols-2">
+          <Reveal>
+            <p className="text-xs font-bold tracking-[0.16em] text-edr-primary">
+              CONTACT
+            </p>
+            <h2 className="mt-3 text-4xl font-bold leading-tight tracking-tight">
+              Let’s move freight smarter
+            </h2>
+            <p className="mt-4 text-base leading-relaxed text-muted-foreground">
+              Contact EDR Freight for partnership opportunities, enterprise
+              onboarding, or logistics support.
+            </p>
 
-              <h2 className="mt-6 text-4xl font-black tracking-tight">
-                Let’s move freight smarter
-              </h2>
+            <div className="mt-8 space-y-4">
+              {[
+                { icon: Mail, label: "Email", value: "support@edrfreight.com" },
+                { icon: Phone, label: "Phone", value: "+251 11 000 0000" },
+                { icon: MapPin, label: "Head Office", value: "Addis Ababa, Ethiopia" },
+              ].map((row) => {
+                const Icon = row.icon;
 
-              <p className="mt-5 text-lg leading-8 text-muted-foreground">
-                Contact EDR Freight for partnership opportunities, enterprise
-                onboarding, or logistics support.
-              </p>
-
-              <div className="mt-10 space-y-5">
-                <div className="flex items-center gap-4 rounded-2xl border border-border bg-background p-5">
-                  <div className="rounded-2xl bg-accent p-3 text-primary">
-                    <Mail className="size-5" />
+                return (
+                  <div
+                    key={row.label}
+                    className="flex items-center gap-4 rounded-2xl border border-border bg-background p-5 transition hover:border-edr-primary/30"
+                  >
+                    <span className="rounded-xl bg-edr-soft p-3 text-edr-primary">
+                      <Icon className="size-5" />
+                    </span>
+                    <div>
+                      <p className="font-semibold">{row.label}</p>
+                      <p className="text-muted-foreground">{row.value}</p>
+                    </div>
                   </div>
-
-                  <div>
-                    <p className="font-semibold">Email</p>
-                    <p className="text-muted-foreground">
-                      support@edrfreight.com
-                    </p>
-                  </div>
-                </div>
-
-                <div className="flex items-center gap-4 rounded-2xl border border-border bg-background p-5">
-                  <div className="rounded-2xl bg-accent p-3 text-primary">
-                    <Phone className="size-5" />
-                  </div>
-
-                  <div>
-                    <p className="font-semibold">Phone</p>
-                    <p className="text-muted-foreground">+251 11 000 0000</p>
-                  </div>
-                </div>
-
-                <div className="flex items-center gap-4 rounded-2xl border border-border bg-background p-5">
-                  <div className="rounded-2xl bg-accent p-3 text-primary">
-                    <MapPin className="size-5" />
-                  </div>
-
-                  <div>
-                    <p className="font-semibold">Head Office</p>
-                    <p className="text-muted-foreground">
-                      Addis Ababa, Ethiopia
-                    </p>
-                  </div>
-                </div>
-              </div>
+                );
+              })}
             </div>
+          </Reveal>
 
-            {/* Contact Form */}
-            <div className="rounded-[32px] border border-border bg-card p-8 shadow-xl">
+          <Reveal delay={140}>
+            <div className="rounded-3xl border border-border bg-card p-8 shadow-xl">
               <h3 className="text-2xl font-bold">Send us a message</h3>
-
               <p className="mt-2 text-muted-foreground">
                 We’ll get back to you as soon as possible.
               </p>
@@ -504,117 +1129,359 @@ export default function EDRFreightLandingPage() {
                 <input
                   type="text"
                   placeholder="Full Name"
-                  className="h-12 w-full rounded-2xl border border-input bg-background px-4 outline-none transition focus:border-primary focus:ring-4 focus:ring-primary/10"
+                  className="h-12 w-full rounded-2xl border border-input bg-background px-4 outline-none transition focus:border-edr-primary focus:ring-4 focus:ring-emerald-500/10"
                 />
 
                 <input
                   type="email"
                   placeholder="Email Address"
-                  className="h-12 w-full rounded-2xl border border-input bg-background px-4 outline-none transition focus:border-primary focus:ring-4 focus:ring-primary/10"
+                  className="h-12 w-full rounded-2xl border border-input bg-background px-4 outline-none transition focus:border-edr-primary focus:ring-4 focus:ring-emerald-500/10"
                 />
 
                 <textarea
                   rows={5}
                   placeholder="Write your message..."
-                  className="w-full rounded-2xl border border-input bg-background px-4 py-3 outline-none transition focus:border-primary focus:ring-4 focus:ring-primary/10"
+                  className="w-full rounded-2xl border border-input bg-background px-4 py-3 outline-none transition focus:border-edr-primary focus:ring-4 focus:ring-emerald-500/10"
                 />
 
-                <button className="flex w-full items-center justify-center gap-2 rounded-2xl bg-primary px-6 py-3 font-semibold text-primary-foreground shadow-lg transition hover:opacity-90">
+                <button
+                  type="button"
+                  className="flex w-full items-center justify-center gap-2 rounded-2xl bg-edr-primary px-6 py-3 font-semibold text-white shadow-lg transition hover:-translate-y-0.5 hover:bg-edr-primary-dark"
+                >
                   Send Message
                   <ArrowRight className="size-5" />
                 </button>
               </div>
             </div>
-          </div>
+          </Reveal>
         </div>
       </section>
 
       {/* CTA */}
-      <section className="border-t border-border py-24">
-        <div className="mx-auto max-w-5xl px-6">
-          <div className="rounded-[40px] bg-primary px-8 py-16 text-center text-primary-foreground shadow-2xl md:px-16">
-            <div className="mx-auto max-w-3xl">
-              <div className="inline-flex rounded-full bg-white/10 px-4 py-2 text-sm font-semibold">
-                EDR Freight Platform
-              </div>
-
-              <h2 className="mt-6 text-5xl font-black tracking-tight">
-                Transform railway freight operations
+      <section className="mx-auto max-w-7xl px-6 py-20">
+        <Reveal>
+          <div className="edr-cta flex flex-col items-start justify-between gap-8 rounded-3xl px-10 py-14 lg:flex-row lg:items-center lg:px-16">
+            <div className="max-w-2xl">
+              <h2 className="text-4xl font-bold leading-tight tracking-tight text-white">
+                Ready to put your cargo on the rails?
               </h2>
-
-              <p className="mt-6 text-lg leading-8 opacity-85">
-                Centralize logistics workflows, optimize freight movement, and
-                gain real-time operational visibility across all railway
-                corridors.
+              <p className="mt-3 text-base leading-relaxed text-emerald-50/85">
+                Create a shipper account in minutes, or talk to our team about
+                shipping-line and enterprise contracts.
               </p>
+            </div>
 
-              <div className="mt-10 flex flex-wrap items-center justify-center gap-4">
-                <Link
-                  to="/signup"
-                  className="flex items-center gap-2 rounded-2xl bg-white px-7 py-3 font-semibold text-primary shadow-lg transition hover:opacity-90"
-                >
-                  Create Account
-                  <ArrowRight className="size-5" />
-                </Link>
+            <div className="flex flex-wrap gap-3">
+              <Link
+                to="/signup"
+                className="flex items-center gap-2 rounded-xl bg-white px-6 py-3.5 font-semibold text-edr-ink shadow-lg transition hover:-translate-y-0.5"
+              >
+                Get started
+                <ArrowRight className="size-4.5" />
+              </Link>
 
-                <Link
-                  to="/login"
-                  className="rounded-2xl border border-white/20 bg-white/10 px-7 py-3 font-semibold backdrop-blur transition hover:bg-white/20"
-                >
-                  Sign In
-                </Link>
-              </div>
+              <a
+                href="#contact"
+                className="rounded-xl border border-white/40 px-6 py-3.5 font-medium text-white transition hover:bg-white/10"
+              >
+                Contact sales
+              </a>
             </div>
           </div>
-        </div>
+        </Reveal>
       </section>
 
       {/* Footer */}
-      <footer className="border-t border-border py-8">
-        <div className="mx-auto flex max-w-7xl flex-col items-center justify-between gap-4 px-6 text-sm text-muted-foreground md:flex-row">
-          <div className="flex items-center gap-3">
-            <div className="flex size-10 items-center justify-center rounded-2xl bg-primary text-primary-foreground">
-              <Train className="size-5" />
+      <footer className="bg-edr-ink pb-8 pt-14 text-slate-400">
+        <div className="mx-auto max-w-7xl px-6">
+          <div className="flex flex-col justify-between gap-12 lg:flex-row">
+            <div className="max-w-sm">
+              <div className="flex items-center gap-2.5">
+                <span className="flex size-8 items-center justify-center rounded-lg bg-edr-primary text-white">
+                  <TrainFront className="size-4" />
+                </span>
+                <span className="text-lg font-bold text-white">EDR Freight</span>
+              </div>
+
+              <p className="mt-3.5 text-sm leading-relaxed">
+                The digital freight platform of the Ethio-Djibouti Railway.
+                Booking, tracking, customs and billing on the 752 km
+                standard-gauge corridor.
+              </p>
+
+              <div className="mt-4 space-y-1.5 text-[13px]">
+                {[
+                  { icon: Phone, text: "+251 11 000 0000" },
+                  { icon: Mail, text: "freight@edr.et" },
+                  { icon: MapPin, text: "EDR Head Office, Addis Ababa" },
+                ].map((row) => {
+                  const Icon = row.icon;
+
+                  return (
+                    <p key={row.text} className="flex items-center gap-2">
+                      <Icon className="size-3.5 text-emerald-400" />
+                      {row.text}
+                    </p>
+                  );
+                })}
+              </div>
             </div>
 
-            <div>
-              <p className="font-semibold text-foreground">EDR Freight</p>
+            <div className="grid flex-1 gap-10 sm:grid-cols-2 lg:max-w-2xl lg:grid-cols-4">
+              {[
+                {
+                  head: "Product",
+                  items: [
+                    "Consignment booking",
+                    "Live tracking",
+                    "Customs documents",
+                    "Billing & payments",
+                  ],
+                },
+                {
+                  head: "Customers",
+                  items: ["Shippers", "Shipping lines", "Transit agents", "EDR operations"],
+                },
+                {
+                  head: "Company",
+                  items: ["About EDR", "Support", "Contact"],
+                  links: [
+                    { label: "Help & Support", to: "/help" },
+                    { label: "FAQ", to: "/faq" },
+                  ],
+                },
+                {
+                  head: "Legal",
+                  links: [
+                    { label: "Terms of Service", to: "/terms" },
+                    { label: "Privacy Policy", to: "/privacy" },
+                  ],
+                },
+              ].map((column) => (
+                <div key={column.head}>
+                  <p className="text-[13px] font-bold text-white">{column.head}</p>
 
-              <p>Modern railway logistics management platform</p>
+                  <ul className="mt-3 space-y-2.5 text-sm">
+                    {column.items?.map((item) => (
+                      <li key={item}>{item}</li>
+                    ))}
+                    {column.links?.map((link) => (
+                      <li key={link.to}>
+                        <Link to={link.to} className="transition hover:text-white">
+                          {link.label}
+                        </Link>
+                      </li>
+                    ))}
+                  </ul>
+                </div>
+              ))}
             </div>
           </div>
 
-          <div className="flex flex-col items-center gap-4 md:items-end">
-            <nav className="flex flex-wrap items-center justify-center gap-x-6 gap-y-2">
-              <Link
-                to="/help"
-                className="font-semibold text-foreground transition-colors hover:text-primary"
-              >
-                Help &amp; Support
-              </Link>
-              <Link
-                to="/faq"
-                className="font-semibold text-foreground transition-colors hover:text-primary"
-              >
-                FAQ
-              </Link>
-              <Link
-                to="/privacy"
-                className="font-semibold text-foreground transition-colors hover:text-primary"
-              >
-                Privacy Policy
-              </Link>
-              <Link
-                to="/terms"
-                className="font-semibold text-foreground transition-colors hover:text-primary"
-              >
-                Terms of Service
-              </Link>
-            </nav>
-            <div>© 2026 EDR Freight. All rights reserved.</div>
+          <div className="mt-12 flex flex-col items-center justify-between gap-3 border-t border-white/10 pt-6 text-[13px] md:flex-row">
+            <p>© 2026 Ethio-Djibouti Railway · EDR Freight. All rights reserved.</p>
+            <p className="flex gap-4">
+              <span>English</span>
+              <span>አማርኛ</span>
+              <span>Français</span>
+            </p>
           </div>
         </div>
       </footer>
     </div>
   );
 }
+
+/* ------------------------------------------------------------------ */
+/* Scoped animation styles                                             */
+/* ------------------------------------------------------------------ */
+
+function LandingStyles() {
+  return (
+    <style>{`
+.edr-reveal {
+  opacity: 0;
+  transform: translateY(24px);
+  transition: opacity .7s cubic-bezier(.16,1,.3,1), transform .7s cubic-bezier(.16,1,.3,1);
+}
+.edr-reveal.is-visible { opacity: 1; transform: none; }
+
+/* Hero: rail streaks racing toward the horizon */
+.edr-rails {
+  position: absolute;
+  inset: 0;
+  background-image: repeating-linear-gradient(
+    100deg,
+    transparent 0 46px,
+    rgba(52,211,153,.16) 46px 48px
+  );
+  mask-image: radial-gradient(120% 90% at 78% 40%, #000 0%, transparent 70%);
+  animation: edr-rails 9s linear infinite;
+}
+@keyframes edr-rails { to { background-position: 480px 0; } }
+
+.edr-hero-glow {
+  position: absolute;
+  inset: 0;
+  background:
+    radial-gradient(46% 60% at 12% 22%, rgba(10,138,95,.45), transparent 70%),
+    radial-gradient(40% 55% at 88% 82%, rgba(242,165,22,.22), transparent 70%);
+  animation: edr-breathe 11s ease-in-out infinite;
+}
+@keyframes edr-breathe {
+  0%, 100% { opacity: .75; transform: scale(1); }
+  50% { opacity: 1; transform: scale(1.06); }
+}
+
+.edr-float { animation: edr-float 7s ease-in-out infinite; }
+@keyframes edr-float {
+  0%, 100% { transform: translateY(0); }
+  50% { transform: translateY(-10px); }
+}
+
+/* Pulsing live dot */
+.edr-pulse-dot {
+  position: relative;
+  display: inline-block;
+  width: .5rem;
+  height: .5rem;
+  border-radius: 9999px;
+  background: #34d399;
+}
+.edr-pulse-dot--green { background: #0a8a5f; }
+.edr-pulse-dot::after {
+  content: "";
+  position: absolute;
+  inset: -3px;
+  border-radius: 9999px;
+  border: 2px solid currentColor;
+  color: inherit;
+  background: inherit;
+  opacity: .55;
+  animation: edr-ping 1.8s cubic-bezier(0,0,.2,1) infinite;
+}
+.edr-ping { position: relative; }
+.edr-ping::after {
+  content: "";
+  position: absolute;
+  inset: -4px;
+  border-radius: 9999px;
+  background: currentColor;
+  opacity: .35;
+  animation: edr-ping 1.8s cubic-bezier(0,0,.2,1) infinite;
+}
+@keyframes edr-ping {
+  0% { transform: scale(.6); opacity: .6; }
+  80%, 100% { transform: scale(2.1); opacity: 0; }
+}
+
+/* Corridor rail with a train travelling along it */
+.edr-corridor {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: 18px;
+}
+.edr-corridor::before {
+  content: "";
+  position: absolute;
+  left: 0; right: 0; top: 50%;
+  height: 2px;
+  transform: translateY(-50%);
+  background: rgba(52,211,153,.28);
+}
+.edr-corridor-node {
+  position: relative;
+  z-index: 1;
+  width: 10px; height: 10px;
+  border-radius: 9999px;
+  background: #10202f;
+  border: 2px solid #34d399;
+}
+.edr-corridor-node.is-hub { width: 16px; height: 16px; background: #34d399; }
+.edr-corridor-node.is-border { background: #f2a516; border-color: #f2a516; }
+.edr-corridor-train {
+  position: absolute;
+  top: 50%;
+  left: 0;
+  width: 74px; height: 4px;
+  transform: translateY(-50%);
+  border-radius: 9999px;
+  background: linear-gradient(90deg, transparent, #f2a516);
+  box-shadow: 0 0 18px 3px rgba(242,165,22,.55);
+  animation: edr-run 12s linear infinite;
+}
+@keyframes edr-run {
+  0% { left: -6%; }
+  100% { left: 100%; }
+}
+
+/* Mini track inside the GPS feature preview */
+.edr-minitrack {
+  position: relative;
+  height: 14px;
+  border-radius: 9999px;
+}
+.edr-minitrack::before {
+  content: "";
+  position: absolute;
+  left: 0; right: 0; top: 50%;
+  height: 2px;
+  transform: translateY(-50%);
+  background: #c9e9db;
+  border-radius: 9999px;
+}
+.edr-minitrack-dot {
+  position: absolute;
+  top: 50%;
+  width: 9px; height: 9px;
+  margin-top: -4.5px;
+  border-radius: 9999px;
+  background: #0a8a5f;
+  box-shadow: 0 0 0 4px rgba(10,138,95,.18), 0 0 14px 2px rgba(10,138,95,.5);
+  animation: edr-run-dot 6s ease-in-out infinite;
+}
+@keyframes edr-run-dot {
+  0%, 8% { left: 0%; }
+  92%, 100% { left: calc(100% - 9px); }
+}
+
+.edr-dashline {
+  background-image: linear-gradient(90deg, #c9e9db 0 6px, transparent 6px 12px);
+  background-size: 12px 2px;
+  animation: edr-dash 1.4s linear infinite;
+}
+@keyframes edr-dash { to { background-position: 12px 0; } }
+
+/* Bars growing from the baseline once revealed */
+.edr-grow {
+  transform-origin: bottom;
+  animation: edr-grow .8s cubic-bezier(.16,1,.3,1) both;
+}
+@keyframes edr-grow { from { transform: scaleY(0); } to { transform: scaleY(1); } }
+
+.edr-fade-in { animation: edr-fade-in .5s ease-out both; }
+@keyframes edr-fade-in { from { opacity: 0; transform: scale(.8); } to { opacity: 1; transform: none; } }
+
+/* CTA band: slowly drifting gradient */
+.edr-cta {
+  background: linear-gradient(120deg, #0a6f4d, #0c1a2b 45%, #0a8a5f 75%, #0c1a2b);
+  background-size: 280% 280%;
+  animation: edr-shift 16s ease infinite;
+}
+@keyframes edr-shift {
+  0%, 100% { background-position: 0% 50%; }
+  50% { background-position: 100% 50%; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .edr-reveal { opacity: 1; transform: none; transition: none; }
+  .edr-rails, .edr-hero-glow, .edr-float, .edr-pulse-dot::after, .edr-ping::after,
+  .edr-corridor-train, .edr-minitrack-dot, .edr-dashline, .edr-grow, .edr-fade-in, .edr-cta {
+    animation: none !important;
+  }
+}
+    `}</style>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/MyPortalPage/actions.ts b/apps/edr-freight-web/portal/src/pages/MyPortalPage/actions.ts
index 962b59bcc..b33017976 100644
--- a/apps/edr-freight-web/portal/src/pages/MyPortalPage/actions.ts
+++ b/apps/edr-freight-web/portal/src/pages/MyPortalPage/actions.ts
@@ -1,5 +1,7 @@
 import type { Freight } from "@edr/types";
 
+import { isUsdOfflineBooking } from "@/pages/bookings/payments/offline-payment";
+
 /** A pending customer action surfaced on the home "needs attention" card. */
 export interface ActionItem {
   id: string;
@@ -13,6 +15,8 @@ export interface ActionItem {
   targetId: string;
   /** Highlighted as action-required in the home card. */
   urgent?: boolean;
+  /** USD booking: paid by bank transfer, no online payment modal. */
+  offlinePay?: boolean;
 }
 
 /**
@@ -60,13 +64,17 @@ export function deriveActionItems(
         ? b.status === "FULLY_EXECUTED"
         : b.status === "SELECTED_FOR_BATCH");
     if (canPay) {
+      const offlinePay = isUsdOfflineBooking(b);
       items.push({
         id: `pay-${b.id}`,
         kind: "pay",
         reference: b.reference,
-        description: "Payment due for this shipment",
+        description: offlinePay
+          ? "Payment due — pay by bank transfer and send the slip to Finance"
+          : "Payment due for this shipment",
         targetId: b.id,
         urgent: true,
+        offlinePay,
       });
     }
   }
diff --git a/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/ActionNeededSection.tsx b/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/ActionNeededSection.tsx
index 4b16e132d..7e3be49c3 100644
--- a/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/ActionNeededSection.tsx
+++ b/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/ActionNeededSection.tsx
@@ -65,7 +65,10 @@ export function ActionNeededSection({ items: base }: ActionNeededSectionProps) {
   const handleClick = (item: ActionItem) => {
     switch (item.kind) {
       case "pay":
-        setPayItem(item);
+        // USD is paid by bank transfer — the booking page shows the countdown
+        // and the pay-by-bank instructions instead of the payment modal.
+        if (item.offlinePay) navigate(`/bookings/${item.targetId}`);
+        else setPayItem(item);
         break;
       case "sign":
         navigate(`/contracts/${item.targetId}/view`);
@@ -151,7 +154,9 @@ export function ActionNeededSection({ items: base }: ActionNeededSectionProps) {
                 leftSection={<FilePlus2 size={14} />}
               >
                 {item.kind === "pay"
-                  ? "Pay now"
+                  ? item.offlinePay
+                    ? "Pay by bank"
+                    : "Pay now"
                   : item.kind === "sign"
                     ? "Sign"
                     : "Book"}
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 7abc16192..20f148f3d 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
@@ -3,6 +3,7 @@ import { memo } from "react";
 import { ACTION_PROPS, STATUS_CONFIG, cv } from "../constants";
 import { Stepper } from "./Stepper";
 import { PayNowButton } from "@/pages/bookings/payments/PayNowButton";
+import { payWindowState } from "@/pages/bookings/payments/payment-drain";
 import { BookingActionButton } from "@/pages/bookings/clearance/BookingActionButton";
 import { bookingHasInlineAction } from "@/pages/bookings/clearance/bookingNextAction";
 import {
@@ -35,8 +36,13 @@ export const BookingRow = memo(function BookingRow({
     booking.bookingType === "GENERAL_CONTRACT"
       ? "FULLY_EXECUTED"
       : "SELECTED_FOR_BATCH";
+  // A fully-closed pay window (deadline + drain both elapsed) has nothing to pay
+  // against, so the row falls back to its normal action instead of an empty slot.
+  // The drain itself still routes here — PayNowButton renders the wait notice.
   const canPay =
-    booking.status === payableStatus && booking.paymentStatus !== "PAID";
+    booking.status === payableStatus &&
+    booking.paymentStatus !== "PAID" &&
+    payWindowState(booking).phase !== "closed";
   // Clearance/operation steps + changes-requested resubmit can be done in place
   // via a modal on the row.
   const hasInlineAction = bookingHasInlineAction(booking);
diff --git a/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/UpcomingWindowsSection.tsx b/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/UpcomingWindowsSection.tsx
index c4bb03ed6..556a96282 100644
--- a/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/UpcomingWindowsSection.tsx
+++ b/apps/edr-freight-web/portal/src/pages/MyPortalPage/components/UpcomingWindowsSection.tsx
@@ -321,6 +321,19 @@ export const UpcomingWindowsSection = memo(function UpcomingWindowsSection({
                       </Text>
                     </Fragment>
                   ))}
+                  {w.trainNumber && (
+                    <Text
+                      fz={13}
+                      fw={700}
+                      style={{
+                        color: INK,
+                        flexShrink: 0,
+                        fontVariantNumeric: "tabular-nums",
+                      }}
+                    >
+                      Train {w.trainNumber}
+                    </Text>
+                  )}
                   {w.reference && (
                     <Text
                       fz={11}
@@ -338,7 +351,8 @@ export const UpcomingWindowsSection = memo(function UpcomingWindowsSection({
                 <Group gap={5} wrap="nowrap" mt={2}>
                   <CalendarClock size={12} color={MUTED} style={{ flexShrink: 0 }} />
                   <Text fz={12} style={{ color: MUTED }} truncate>
-                    {windowLabel(w)} · Departs {fmtDay(w.departureDate)}
+                    {windowLabel(w)} · Departs {fmtDay(w.departureDate)},{" "}
+                    {fmtTime(w.departureDate)}
                   </Text>
                 </Group>
                 {(() => {
diff --git a/apps/edr-freight-web/portal/src/pages/MyPortalPage/constants.ts b/apps/edr-freight-web/portal/src/pages/MyPortalPage/constants.ts
index 2ee9cd719..6c92403ce 100644
--- a/apps/edr-freight-web/portal/src/pages/MyPortalPage/constants.ts
+++ b/apps/edr-freight-web/portal/src/pages/MyPortalPage/constants.ts
@@ -302,7 +302,7 @@ export const STATUS_CONFIG: Record<string, StageConfig> = {
     icon: Wallet,
     iconColor: "edr-amber-text",
     tile: "edr-amber-soft",
-    hint: "Selected for batch · payment due within 1 hour",
+    hint: "Selected for batch · payment due before the deadline",
     step: "edr-accent",
     badgeLabel: "Pay Now",
     badgeBg: "edr-amber-soft",
diff --git a/apps/edr-freight-web/portal/src/pages/SettingsPage.tsx b/apps/edr-freight-web/portal/src/pages/SettingsPage.tsx
index df3511d8f..53e0cf0a3 100644
--- a/apps/edr-freight-web/portal/src/pages/SettingsPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/SettingsPage.tsx
@@ -47,56 +47,49 @@ import useAuth from "@/hooks/useAuth";
 import { rolesForCompanyType } from "./settings/companyRoles";
 import TabAccount from "./settings/TabAccount";
 import TabCompanyProfile from "./settings/TabCompanyProfile";
+import RegistrationSourceCard from "./settings/RegistrationSourceCard";
 import TabContactPerson from "./settings/TabContactPerson";
 import TabDocuments from "./settings/TabDocuments";
-import TabGeneralManager from "./settings/TabGeneralManager";
+import TabOwner from "./settings/TabOwner";
 import TabPowerOfAttorney from "./settings/TabPowerOfAttorney";
 
 type SettingsTab =
   | "account"
   | "company"
   | "contact"
-  | "gm"
+  | "owner"
   | "poa"
   | "documents";
 
 /** A section is "incomplete" when its required fields aren't filled in yet. */
 function tabIncomplete(tabId: SettingsTab, profile: ProfileResponse): boolean {
   switch (tabId) {
-    case "company": {
-      // Identity proof lives here: the owner's Fayda verification for an
-      // Ethiopian company, or the owner's typed passport number for a foreign
-      // one.
-      const identity = profile.identity;
-      const identityIncomplete = identity
-        ? (identity.faydaRequired && !identity.owner.verified) ||
-          (identity.passportRequired && !identity.owner.passportNumber)
-        : false;
-      return (
-        !profile.companyEmail ||
-        !profile.companyPhone ||
-        !profile.companyAddress ||
-        identityIncomplete
-      );
-    }
+    case "company":
+      return !profile.companyAddress;
     case "contact":
       return !profile.contactPersonName || !profile.contactPersonPhone;
-    case "gm":
-      // The GM is established through Fayda — verified in their own right or
-      // declared the same person as the owner — so the identity answers this,
-      // not the typed columns. A company that may still type them (foreign,
-      // whose manager may hold no Fayda ID) is judged on those instead.
-      if (profile.identity?.gm.verified) return false;
-      if (profile.identity?.faydaRequired) return true;
+    case "owner":
+      // The owner is whoever the eTrade licence names. All three details are
+      // required whatever supplied them, and the identity verification lives
+      // on whichever person the PoA declaration points at — flagged here when
+      // it is the owner and still unproven.
       return (
-        !profile.generalManagerName ||
-        !profile.generalManagerEmail ||
-        !profile.generalManagerPhone
+        !profile.ownerName ||
+        !profile.ownerEmail ||
+        !profile.ownerPhone ||
+        (profile.identity?.subject === "owner" &&
+          !profile.identity.identityProven)
+      );
+    case "poa":
+      // Unanswered is itself incomplete — the answer decides whose identity is
+      // verified — as is a declared representative who has not proved theirs.
+      if (profile.identity?.poaDeclared == null) return true;
+      return (
+        profile.identity.subject === "poa" && !profile.identity.identityProven
       );
     case "account":
     // Account fields live on the IAM user, not the company profile, and are
     // always populated (signup requires them) — nothing to nag about here.
-    case "poa":
     case "documents":
       return false;
   }
@@ -106,7 +99,7 @@ const TABS: { id: SettingsTab; label: string; icon: React.ReactNode }[] = [
   { id: "account", label: "Account", icon: <UserCog size={16} /> },
   { id: "company", label: "Company", icon: <Building2 size={16} /> },
   { id: "contact", label: "Contact Person", icon: <User size={16} /> },
-  { id: "gm", label: "General Manager", icon: <Briefcase size={16} /> },
+  { id: "owner", label: "Owner", icon: <Briefcase size={16} /> },
   { id: "poa", label: "Power of Attorney", icon: <UserCheck size={16} /> },
   { id: "documents", label: "Documents", icon: <FileCheck size={16} /> },
 ];
@@ -399,15 +392,20 @@ export default function SettingsPage() {
               itself, not the panel. */}
           <Tabs.Panel value="company">
             <Fieldset disabled={locked} variant="unstyled" p={0}>
-              <TabCompanyProfile mode="edit" profile={profile} user={user ?? undefined} />
+              <TabCompanyProfile
+                mode="edit"
+                profile={profile}
+                user={user ?? undefined}
+              />
             </Fieldset>
             <OperationalServicesCard profile={profile} />
+            <RegistrationSourceCard profile={profile} disabled={locked} />
           </Tabs.Panel>
           <Tabs.Panel value="contact">
             <TabContactPerson profile={profile} mode="edit" />
           </Tabs.Panel>
-          <Tabs.Panel value="gm">
-            <TabGeneralManager profile={profile} mode="edit" />
+          <Tabs.Panel value="owner">
+            <TabOwner profile={profile} mode="edit" />
           </Tabs.Panel>
           <Tabs.Panel value="poa">
             <TabPowerOfAttorney profile={profile} mode="edit" />
@@ -476,110 +474,110 @@ function OperationalServicesCard({ profile }: { profile: ProfileResponse }) {
   return (
     <>
       <Card padding="lg" radius="lg" mt="lg">
-      <Group gap="sm" mb="md">
-        <Layers size={20} />
-        <Title order={3}>Operational Services</Title>
-      </Group>
-      <Stack gap="sm">
-        {roles.map((r) => {
-          const status = ROLE_STATUS[r.status] ?? {
-            color: "gray",
-            label: r.status,
-          };
-          return (
-            <Group
-              key={r.id}
-              justify="space-between"
-              align="flex-start"
-              wrap="nowrap"
-              py="xs"
-              style={{
-                borderTop: "1px solid var(--mantine-color-edr-border-0)",
-              }}
-            >
-              <Stack gap={4}>
-                <Group gap="xs">
-                  <Text fw={600}>{ROLE_LABELS[r.type] ?? r.type}</Text>
-                  <Badge color={status.color} variant="light" radius="sm">
-                    {status.label}
-                  </Badge>
-                  {r.reference && (
-                    <Text size="xs" c="dimmed" ff="monospace">
-                      {r.reference}
-                    </Text>
-                  )}
-                </Group>
-                {(r.status === "rejected" || r.status === "suspended") &&
-                  r.reviewNote && (
-                    <Text
-                      size="sm"
-                      c={r.status === "suspended" ? "orange.7" : "red.7"}
-                    >
-                      <strong>
-                        {r.status === "suspended"
-                          ? "Suspension reason:"
-                          : "Reviewer note:"}
-                      </strong>{" "}
-                      {r.reviewNote}
-                    </Text>
-                  )}
+        <Group gap="sm" mb="md">
+          <Layers size={20} />
+          <Title order={3}>Operational Services</Title>
+        </Group>
+        <Stack gap="sm">
+          {roles.map((r) => {
+            const status = ROLE_STATUS[r.status] ?? {
+              color: "gray",
+              label: r.status,
+            };
+            return (
+              <Group
+                key={r.id}
+                justify="space-between"
+                align="flex-start"
+                wrap="nowrap"
+                py="xs"
+                style={{
+                  borderTop: "1px solid var(--mantine-color-edr-border-0)",
+                }}
+              >
+                <Stack gap={4}>
+                  <Group gap="xs">
+                    <Text fw={600}>{ROLE_LABELS[r.type] ?? r.type}</Text>
+                    <Badge color={status.color} variant="light" radius="sm">
+                      {status.label}
+                    </Badge>
+                    {r.reference && (
+                      <Text size="xs" c="dimmed" ff="monospace">
+                        {r.reference}
+                      </Text>
+                    )}
+                  </Group>
+                  {(r.status === "rejected" || r.status === "suspended") &&
+                    r.reviewNote && (
+                      <Text
+                        size="sm"
+                        c={r.status === "suspended" ? "orange.7" : "red.7"}
+                      >
+                        <strong>
+                          {r.status === "suspended"
+                            ? "Suspension reason:"
+                            : "Reviewer note:"}
+                        </strong>{" "}
+                        {r.reviewNote}
+                      </Text>
+                    )}
 
-                {r.licenseFiles.length === 0 ? (
-                  <Text size="xs" c="edr-muted">
-                    No license document
-                  </Text>
-                ) : (
-                  <Stack gap={4}>
-                    {r.licenseFiles.map((f) => (
-                      <Group key={f.id} gap="xs" wrap="nowrap">
-                        <FileText
-                          size={14}
-                          className="text-edr-muted"
-                          style={{ flexShrink: 0 }}
-                        />
-                        <Anchor
-                          component="button"
-                          type="button"
-                          size="xs"
-                          lineClamp={1}
-                          onClick={() =>
-                            void fetchViewableFile(f.id, f.name).then(view)
-                          }
-                        >
-                          {f.name}
-                        </Anchor>
-                        {f.status !== "live" && (
-                          <Badge
+                  {r.licenseFiles.length === 0 ? (
+                    <Text size="xs" c="edr-muted">
+                      No license document
+                    </Text>
+                  ) : (
+                    <Stack gap={4}>
+                      {r.licenseFiles.map((f) => (
+                        <Group key={f.id} gap="xs" wrap="nowrap">
+                          <FileText
+                            size={14}
+                            className="text-edr-muted"
+                            style={{ flexShrink: 0 }}
+                          />
+                          <Anchor
+                            component="button"
+                            type="button"
                             size="xs"
-                            radius="sm"
-                            variant="light"
-                            color={
-                              f.status === "pending_remove" ? "red" : "yellow"
+                            lineClamp={1}
+                            onClick={() =>
+                              void fetchViewableFile(f.id, f.name).then(view)
                             }
                           >
-                            {f.status === "pending_remove"
-                              ? "Removal pending"
-                              : "Pending"}
-                          </Badge>
-                        )}
-                      </Group>
-                    ))}
-                  </Stack>
-                )}
-              </Stack>
+                            {f.name}
+                          </Anchor>
+                          {f.status !== "live" && (
+                            <Badge
+                              size="xs"
+                              radius="sm"
+                              variant="light"
+                              color={
+                                f.status === "pending_remove" ? "red" : "yellow"
+                              }
+                            >
+                              {f.status === "pending_remove"
+                                ? "Removal pending"
+                                : "Pending"}
+                            </Badge>
+                          )}
+                        </Group>
+                      ))}
+                    </Stack>
+                  )}
+                </Stack>
 
-              {r.status === "rejected" && (
-                <ResubmitService
-                  pending={resubmit.isPending}
-                  onResubmit={(files) =>
-                    resubmit.mutate({ profileId: r.id, files })
-                  }
-                />
-              )}
-            </Group>
-          );
-        })}
-      </Stack>
+                {r.status === "rejected" && (
+                  <ResubmitService
+                    pending={resubmit.isPending}
+                    onResubmit={(files) =>
+                      resubmit.mutate({ profileId: r.id, files })
+                    }
+                  />
+                )}
+              </Group>
+            );
+          })}
+        </Stack>
       </Card>
       {viewer}
     </>
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 15354cfd3..fd0e060e1 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/CompanyProfileForm.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/CompanyProfileForm.tsx
@@ -1,14 +1,4 @@
-import {
-  Alert,
-  Button,
-  Divider,
-  Group,
-  Loader,
-  SimpleGrid,
-  Stack,
-  Text,
-  TextInput,
-} from "@mantine/core";
+import { Alert, Button, Group, Stack } from "@mantine/core";
 import { zodResolver } from "@hookform/resolvers/zod";
 import { useQuery } from "@tanstack/react-query";
 import { AlertCircle, ArrowLeft, ArrowRight } from "lucide-react";
@@ -19,16 +9,10 @@ import type { AuthUser } from "@/types/auth";
 import type { CreateCompanyPayload } from "@/services/companies.service";
 import type { ProfileResponse, UpdateProfilePayload } from "@/types/profile";
 import type { CompanyRegistrationData } from "@edr/types";
-import { ControlledPhoneField, toEthiopianE164 } from "@/components/PhoneField";
-import { SmartFileInput } from "@edr/ui-common";
 import { getMinFiles } from "@/types/fileUploadSettings";
 import { api } from "@/services/api";
-import RoleLicenseStep, {
-  type RoleLicenseProfile,
-} from "@/components/onboarding/RoleLicenseStep";
-import ETradeInfo, {
-  type ETradeStatus,
-} from "@/components/onboarding/ETradeInfo";
+import type { RoleLicenseProfile } from "@/components/onboarding/RoleLicenseStep";
+import type { ETradeStatus } from "@/components/onboarding/ETradeInfo";
 import {
   buildOnboardingSchema,
   type CompanyStep,
@@ -42,16 +26,22 @@ import {
   firstValidEmail,
   firstValidPhone,
   normalizeIdentityPhones,
+  resolveOwnerSources,
   stepPayload,
   toFormValues,
 } from "./companyProfileForm/helpers";
-import FaydaVerifyPanel from "@/components/FaydaVerifyPanel";
 import { verifaydaService } from "@/services/verifayda.service";
-import type { CompanyIdentityState } from "@/services/verifayda.service";
-import { LinkCheckboxCard } from "./companyProfileForm/LinkCheckboxCard";
-import { ReadOnlyField } from "./companyProfileForm/ReadOnlyField";
-import ETradeCompanyCard from "./companyProfileForm/ETradeCompanyCard";
-import StepSection from "./companyProfileForm/StepSection";
+import type {
+  CompanyIdentityState,
+  PoaDeclaration,
+} from "@/services/verifayda.service";
+import CompanyInfoStep from "./companyProfileForm/steps/CompanyInfoStep";
+import OwnerStep from "./companyProfileForm/steps/OwnerStep";
+import ContactStep from "./companyProfileForm/steps/ContactStep";
+import RepresentationStep, {
+  type IdentityMethod,
+} from "./companyProfileForm/steps/RepresentationStep";
+import DocumentsStep from "./companyProfileForm/steps/DocumentsStep";
 
 export default function CompanyProfileForm({
   documentSettingCode,
@@ -71,9 +61,13 @@ export default function CompanyProfileForm({
   onLicenseChange,
   submitError,
   uploadedDocumentKeys,
+  uploadedLicenceProfileIds,
   onUploadDocuments,
   identity: rawIdentity,
   onIdentityChange,
+  cooperative = false,
+  investorLicence = false,
+  declarationLocked = false,
 }: {
   documentSettingCode: string;
   documentFiles?: Record<string, File | File[] | null>;
@@ -103,6 +97,16 @@ export default function CompanyProfileForm({
   submitError?: string | null;
   /** fileKeys whose company document is already uploaded server-side (resume). */
   uploadedDocumentKeys?: string[];
+  /**
+   * Profile ids whose business licence the server already holds.
+   *
+   * `roleProfiles.existingFiles` cannot answer this on a resumed wizard:
+   * `getInfo` does not populate `licenseFiles`, so every profile looks empty
+   * however many licences are on file. Taken from the onboarding requirements,
+   * which is the server's own verdict and what `markOnboardingComplete`
+   * enforces.
+   */
+  uploadedLicenceProfileIds?: string[];
   /**
    * Auto-upload the currently-selected company documents (the Documents step's
    * "Continue" action). Resolves to an error message string on failure so the
@@ -111,7 +115,7 @@ export default function CompanyProfileForm({
   onUploadDocuments?: () => Promise<
     { ok: true } | { ok: false; error: string }
   >;
-  /** Fayda verification state for the owner and the PoA (undefined until loaded). */
+  /** The company's single identity verification (undefined until loaded). */
   identity?: CompanyIdentityState;
   /**
    * Refetch the profile + requirements. Only the in-page identity actions need
@@ -119,6 +123,25 @@ export default function CompanyProfileForm({
    * a freshly booted app, so it has nothing to notify.
    */
   onIdentityChange?: () => void;
+  /**
+   * The company trades as a co-operative: a TIN but no business licence, so the
+   * eTrade lookup is replaced by typed registration details, the per-role
+   * licence upload is not owed, and its own document set applies instead of the
+   * nationality one (resolved by the caller into `documentSettingCode`).
+   */
+  cooperative?: boolean;
+  /**
+   * The company is a foreign investor on an Investment Commission licence. Like
+   * a co-operative, eTrade holds no record of it, so the registration is typed
+   * and the lookup gate does not apply — but it does hold a business licence
+   * per role, so the licence step is untouched.
+   */
+  investorLicence?: boolean;
+  /**
+   * The company operates as a freight forwarder, so the power-of-attorney
+   * answer is forced to "yes" and cannot be changed here.
+   */
+  declarationLocked?: boolean;
 }) {
   // A Fayda claim carries the phone as the national registry holds it, which is
   // often a local number the form's E.164 validation (and the API's
@@ -129,9 +152,32 @@ export default function CompanyProfileForm({
     [rawIdentity],
   );
 
+  // eTrade has nothing to say about this company, whichever of the two reasons
+  // applies — so the registration is typed here and the lookup cannot gate the
+  // step. Everything the two cases do NOT share (the per-role business licence)
+  // keeps reading `cooperative` on its own.
+  const manualRegistration = cooperative || investorLicence;
+
   const [step, setStep] = useState<CompanyStep>(initialStep ?? "company");
   const [saving, setSaving] = useState(false);
-  const [saveError, setSaveError] = useState<string | null>(null);
+  /**
+   * What is holding this step back.
+   *
+   * `kind` only picks the title. Most of these never reach the API at all —
+   * they are the step's own gates (a TIN eTrade hasn't confirmed, an
+   * unanswered declaration, a missing paper) — and heading every one of them
+   * "Couldn't save this step" told the customer a request failed when none was
+   * made, which reads as a bug on our side rather than a field to go fix.
+   */
+  const [saveError, setSaveError] = useState<{
+    kind: "check" | "save";
+    message: string;
+  } | null>(null);
+  /** A step gate or a validation failure: something on screen to correct. */
+  const failCheck = (message: string) =>
+    setSaveError({ kind: "check", message });
+  /** The API refused the save; the message is the server's, shown verbatim. */
+  const failSave = (message: string) => setSaveError({ kind: "save", message });
   // Live eTrade lookup status, reported up by ETradeInfo — drives the Continue
   // gate on the company step.
   const [tinStatus, setTinStatus] = useState<ETradeStatus>("idle");
@@ -163,7 +209,7 @@ export default function CompanyProfileForm({
 
   // Follow a parent-driven resume correction: if initialStep changes (the wizard
   // re-clamps it back once onboarding requirements load — e.g. a required
-  // document is still missing, so it must not skip ahead to Business License),
+  // document is still missing, so it must not skip ahead to the documents step),
   // adopt it, but only while the user hasn't started navigating themselves.
   const lastInitialStep = useRef(initialStep);
   useEffect(() => {
@@ -182,6 +228,9 @@ export default function CompanyProfileForm({
   const documentFiles = controlledFiles ?? internalFiles;
   const setDocumentFiles = onDocumentFilesChange ?? setInternalFiles;
 
+  // One set applies: the company's nationality set, or the co-operative one in
+  // its place — the caller resolves which (the API resolves the same way when
+  // it decides what is outstanding).
   const { data: uploadSetting, isLoading: loadingDocuments } = useQuery(
     api.fileUploadSettings.getByCode.queryOptions({
       input: { code: documentSettingCode },
@@ -189,42 +238,32 @@ export default function CompanyProfileForm({
     }),
   );
 
-  // A freight forwarder signs on other companies' behalf, so its Power of
-  // Attorney (details + DARS delegation paper) is mandatory rather than optional.
-  const requirePoa = (roleProfiles ?? []).some(
-    (p) => p.type === "freight_forwarder",
-  );
-  // Fayda is an Ethiopian national ID: an Ethiopian company verifies its owner
-  // and PoA instead of typing their details, a foreign one keeps the typed
-  // forms (plus a mandatory owner passport number).
-  const verifiedIdentity = identity?.faydaRequired === true;
+  // Which fields the current step renders an input for and therefore requires.
+  // Filled in further down (it depends on values this form owns), and read at
+  // validation time rather than at render time — the resolver below runs on
+  // events, always after the render that assigned it.
+  const requiredKeysRef = useRef<(keyof FormData)[]>([]);
 
-  const {
-    register,
-    control,
-    trigger,
-    watch,
-    setValue,
-    getValues,
-    formState: { errors, dirtyFields },
-  } = useForm<FormData>({
-    resolver: zodResolver(
-      buildOnboardingSchema(identity?.passportRequired === true),
-    ),
+  const form = useForm<FormData>({
+    resolver: (values, context, options) =>
+      zodResolver(buildOnboardingSchema(requiredKeysRef.current))(
+        values,
+        context,
+        options,
+      ),
     // `values` below re-seeds the form whenever the profile is refetched — and
-    // an in-page identity action (ticking "same as owner") refetches it. Without
-    // this, that reset silently throws away whatever the customer was part-way
-    // through typing on the current step.
+    // an in-page identity action (answering the PoA question) refetches it.
+    // Without this, that reset silently throws away whatever the customer was
+    // part-way through typing on the current step.
     resetOptions: { keepDirtyValues: true, keepErrors: true },
     defaultValues: {
       companyName: "",
-      companyEmail: "",
-      companyPhone: "",
       companyAddress: "",
       etradePhone: "",
       tinNumber: "",
       vatNumber: "",
       ownerPassportNumber: "",
+      poaPassportNumber: "",
       licenceNumber: "",
       statusDescription: "",
       dateRegistered: "",
@@ -240,12 +279,11 @@ export default function CompanyProfileForm({
       contactPersonPosition: "",
       contactPersonEmail: "",
       contactPersonPhone: "",
-      generalManagerName: "",
-      generalManagerEmail: "",
-      generalManagerPhone: "",
+      ownerName: "",
+      ownerEmail: "",
+      ownerPhone: "",
       poaName: "",
       poaPhone: "",
-      poaAddress: "",
       poaEmail: "",
       poaLocation: "",
     },
@@ -253,14 +291,33 @@ export default function CompanyProfileForm({
     values: rehydrate ? toFormValues(rehydrate) : undefined,
   });
 
-  // The contact person's email still just seeds from the account and stays editable.
+  // The step components take the whole `form`; the orchestration below drives
+  // validation and persistence, so it only pulls out what it actually calls.
+  const {
+    trigger,
+    watch,
+    setValue,
+    getValues,
+    formState: { dirtyFields },
+  } = form;
+
+  // Retire the alert the moment the customer starts acting on it. It was only
+  // ever cleared on navigation, so a red "fix these fields" banner sat above a
+  // form they had already fixed, right until they pressed Continue again —
+  // which reads as an error the page is refusing to let go of.
   useEffect(() => {
-    if (!user?.email) return;
-    if (!watch("contactPersonEmail")) {
-      setValue("contactPersonEmail", user.email);
-    }
+    const sub = watch(() => setSaveError(null));
+    return () => sub.unsubscribe();
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [user?.email, rehydrate]);
+  }, []);
+
+  // Nothing seeds the contact person's email. It used to be prefilled from the
+  // signed-in account, on the same assumption the owner fields were cleared of:
+  // the person doing the onboarding is routinely not the person the company
+  // wants contacted. Prefilled and editable is still prefilled — it is accepted
+  // as-is far more often than it is corrected, so the account address ends up on
+  // file as the company's contact by default rather than by anyone's decision.
+  // The field is optional, so an empty one costs nothing.
 
   // Keep the (hidden, derived) company address in sync with the editable address
   // fields — so it reflects both the eTrade auto-fill and any later user edits,
@@ -274,22 +331,63 @@ export default function CompanyProfileForm({
     const composed = [houseNo, kebele, woreda, zone, region]
       .filter((part) => part && part.trim())
       .join(", ");
+    // No parts means nothing to compose from — the lookup hasn't landed yet, or
+    // this is the render before rehydration. Writing "" here would replace a
+    // saved address with a blank on the next company-step save.
+    if (!composed) return;
     setValue("companyAddress", composed);
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [region, zone, woreda, kebele, houseNo]);
 
-  // The business owner/manager pulled from eTrade — powers "Use owner as
-  // manager" on the General Manager step. Null until a TIN lookup succeeds.
-  const [etradeOwner, setEtradeOwner] = useState<{
+  // The manager eTrade lists for this licence, as returned by a lookup made in
+  // THIS session. This is the person the owner step is about — "owner" here
+  // means whoever the licence names, and the backoffice checks the stored owner
+  // against exactly this.
+  const [liveEtradeOwner, setLiveEtradeOwner] = useState<{
     name: string;
     phone: string;
   } | null>(null);
+  // The TIN moved off the last verified lookup, so the persisted manager below
+  // describes a licence this company is no longer claiming. Without this, a
+  // reset would re-lock the owner fields against stale data the moment the
+  // memo below fell back to the server's copy.
+  const [etradeCleared, setEtradeCleared] = useState(false);
+
+  /**
+   * The eTrade manager, live lookup or not.
+   *
+   * The lookup result dies with the page, but the fact that the owner came from
+   * eTrade must not — a resumed wizard that has forgotten it renders the
+   * licence's own name and phone as empty, typeable inputs, which is both a
+   * regression of the read-only rule and an invitation to overwrite the record
+   * the backoffice checks against. The API captured the manager at lookup time
+   * for exactly this, so a resume reads it back from the identity state.
+   */
+  const etradeOwner = useMemo(() => {
+    if (liveEtradeOwner) return liveEtradeOwner;
+    if (etradeCleared) return null;
+    const name = identity?.etradeManagerName?.trim() ?? "";
+    // Normalized on the way out of storage, and dropped if it cannot be — the
+    // stored value is eTrade's free text, and a resume must reach the same
+    // conclusion about it as the lookup did.
+    const phone = firstValidPhone(identity?.etradeManagerPhone);
+    return name || phone ? { name, phone } : null;
+  }, [
+    liveEtradeOwner,
+    etradeCleared,
+    identity?.etradeManagerName,
+    identity?.etradeManagerPhone,
+  ]);
+
+  /** A lookup has actually filled the registration fields this session. */
+  const etradeFilledRef = useRef(false);
 
   // `shouldDirty` is what marks the eTrade bundle as "re-verified this session";
   // `stepPayload` sends those keys only when dirty, so an unchanged record is
   // never echoed back to the API (which would make it re-query eTrade).
   const handleETradeDataLoaded = (data: CompanyRegistrationData) => {
     const dirty = { shouldDirty: true } as const;
+    etradeFilledRef.current = true;
     if (data.companyName) {
       setValue("companyName", data.companyName, {
         shouldValidate: true,
@@ -307,32 +405,66 @@ export default function CompanyProfileForm({
     setValue("woreda", data.woreda, dirty);
     setValue("kebele", data.kebele, dirty);
     setValue("houseNo", data.houseNo, dirty);
-    // companyAddress is composed reactively from the address fields below, so
-    // setting region/zone/woreda/kebele/houseNo above is enough — no need to
-    // compose it here. companyPhone is derived below (identity → eTrade →
-    // account), not set directly here.
+    // companyAddress is composed reactively from the address fields above.
     // etradePhone is the raw number eTrade returned for this TIN — kept as its
-    // own field (distinct from companyPhone, which prefers the Fayda-verified
-    // owner's phone) so the backend's "matches eTrade's current record" check
-    // always compares against what eTrade actually said, not the owner's phone.
+    // own field (distinct from the owner's phone) so the backend's "matches
+    // eTrade's current record" check always compares against what eTrade
+    // actually said.
     setValue(
       "etradePhone",
       data.managerPhone || data.regularPhone || data.mobilePhone,
       dirty,
     );
 
-    setEtradeOwner({
+    // The owner's phone is only eTrade's to own if eTrade gave a usable one.
+    // The licence desk's field is free text, so it may hold "09        " — which
+    // normalizes to something non-empty and invalid. Dropping it here leaves the
+    // owner step with an empty, required, editable phone input, which is the
+    // honest state: eTrade has nothing we can use.
+    const owner = {
       name: data.managerName,
-      phone: toEthiopianE164(
+      phone: firstValidPhone(
         data.managerPhone || data.regularPhone || data.mobilePhone,
       ),
-    });
+    };
+    setEtradeCleared(false);
+    setLiveEtradeOwner(owner);
+
+    // What eTrade said, verbatim — this replaces whatever is in the field
+    // rather than only filling a gap. The owner step shows an eTrade-sourced
+    // name and phone read-only, so leaving an older value in place would send
+    // the API something the customer is no longer shown and cannot correct.
+    //
+    // A Fayda verification still outranks the licence: it owns those fields
+    // server-side, so overwriting them here would only produce a value the API
+    // discards on the way in.
+    if (owner.name && !identity?.owner.name?.trim()) {
+      setValue("ownerName", owner.name, { shouldValidate: true, ...dirty });
+    }
+    if (owner.phone && !identity?.owner.phone?.trim()) {
+      setValue("ownerPhone", owner.phone, { shouldValidate: true, ...dirty });
+    }
   };
 
   // TIN changed since the last successful lookup — the registration/address
   // fields it filled in describe the OLD TIN, not this one, so clear them
   // rather than leaving them stale on screen.
+  //
+  // The owner goes too: different licences under one TIN can list different
+  // managers, so a prefill from the previous pick is someone else's name.
+  // Only the prefill is cleared — a Fayda-verified owner is the API's to own.
   const handleETradeReset = () => {
+    // ...unless there was no prefill to clear. A co-operative now runs the same
+    // lookup as everyone else, but it types these fields itself when eTrade
+    // holds nothing — and wiping them because the customer went back to fix a
+    // digit of their TIN would throw away an address they had just typed by
+    // hand, over a lookup that never filled anything in the first place.
+    if (manualRegistration && !etradeFilledRef.current) {
+      setLiveEtradeOwner(null);
+      setEtradeCleared(true);
+      return;
+    }
+    etradeFilledRef.current = false;
     setValue("licenceNumber", "");
     setValue("statusDescription", "");
     setValue("dateRegistered", "");
@@ -345,206 +477,159 @@ export default function CompanyProfileForm({
     setValue("kebele", "");
     setValue("houseNo", "");
     setValue("etradePhone", "");
-    setEtradeOwner(null);
+    if (!identity?.owner.verified) {
+      if (getValues("ownerName") === etradeOwner?.name) setValue("ownerName", "");
+      if (getValues("ownerPhone") === etradeOwner?.phone)
+        setValue("ownerPhone", "");
+    }
+    setLiveEtradeOwner(null);
+    setEtradeCleared(true);
   };
 
-  // companyEmail/companyPhone are derived, not typed — the Fayda-verified owner
-  // is the highest-trust source (that's the whole point of verifying), eTrade's
-  // registered number and the account email/phone are the fallbacks used
-  // before verification happens.
-  //
-  // `firstValid*`, not `??`: these sources are optional AND unreliable. Fayda's
-  // email/phone claims can come back empty, and eTrade's registered phone is
-  // free text that arrives as things like "09        " (→ "+2519"). `??` stops
-  // at the first non-null, so a junk value became a field with no input and a
-  // 400 from the API on a value the customer never typed. Skip anything that
-  // isn't usable and fall through.
-  //
-  // When every source really is unusable the fields become editable below
-  // rather than blocking — the API requires a company email and phone at
-  // submit (REQUIRED_COMPANY_INFO), so leaving no way to supply them is a dead
-  // end.
-  const derivedEmail = firstValidEmail(identity?.owner.email, user.email);
-  const derivedPhone = firstValidPhone(
-    identity?.owner.phone,
-    etradeOwner?.phone,
-    user.phoneNumber,
-  );
-  useEffect(() => {
-    if (derivedEmail) setValue("companyEmail", derivedEmail);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [derivedEmail, rehydrate]);
-
-  useEffect(() => {
-    if (derivedPhone) setValue("companyPhone", derivedPhone);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [derivedPhone, rehydrate]);
-
-  // "Same as …" links. A checked card prefills the target step's fields from the
-  // source step and disables them (kept mirrored while linked); unchecking clears
-  // them and re-enables editing.
-  // Seeded from the server so a resumed draft reopens with the declaration the
-  // company already made, rather than an unticked box over a linked GM.
-  const [gmSameAsOwner, setGmSameAsOwner] = useState(
-    identity?.gmSameAsOwner ?? false,
-  );
-  // `identity` is undefined on the first render (the requirements query is still
-  // in flight), so the initial state above freezes at `false` — adopt the
-  // server's declaration the moment it lands, or a resumed draft shows an
-  // unticked box over a GM that is linked server-side.
-  const identityLoaded = useRef(false);
-  useEffect(() => {
-    if (!identity || identityLoaded.current) return;
-    identityLoaded.current = true;
-    setGmSameAsOwner(identity.gmSameAsOwner);
-  }, [identity]);
-  const [contactSameAsGm, setContactSameAsGm] = useState(false);
-
-  // General Manager source. The company step's email/phone are seeded from
-  // eTrade (and the account email) but stay editable, so the link reads the
-  // CURRENT form values rather than the frozen eTrade snapshot — an edit on the
-  // company step propagates here, the same way "Same as General Manager" tracks
-  // the general manager's live values. eTrade's owner name has no editable
-  // field of its own, so it falls back to the registering user's account name.
-  const companyEmail = watch("companyEmail");
-  const companyPhone = watch("companyPhone");
-  // A Fayda-verified owner outranks eTrade's registered owner — it's the
-  // higher-trust source, and the whole point of proving identity is to stop
-  // trusting typed/looked-up data for this.
-  const gmSourceName = firstPresent(
-    identity?.owner.name,
-    etradeOwner?.name,
-    user.name?.en,
-  );
-
-  const gmSourceEmail = firstValidEmail(
-    identity?.owner.email,
-    companyEmail,
-    user.email,
-  );
-  // Same reason as `derivedPhone`: this value is written into
-  // `generalManagerPhone`, which the API validates with `@IsValidPhone()`, so an
-  // unusable eTrade number here 400s the personnel step instead.
-  const gmSourcePhone = firstValidPhone(
-    identity?.owner.phone,
-    companyPhone,
-    etradeOwner?.phone,
-    user.phoneNumber,
-  );
-
-  useEffect(() => {
-    if (!gmSameAsOwner) return;
-    // A verified owner's identity is copied server-side and read back from
-    // `identity.gm`; mirroring it into form fields here would send typed
-    // values for something the API already owns.
-    if (identity?.owner.verified) return;
-    setValue("generalManagerName", gmSourceName, { shouldValidate: true });
-    setValue("generalManagerEmail", gmSourceEmail, { shouldValidate: true });
-    setValue("generalManagerPhone", gmSourcePhone, {
-      shouldValidate: true,
-    });
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [gmSameAsOwner, gmSourceName, gmSourceEmail, gmSourcePhone]);
-
   /**
-   * "Same as owner" has two meanings depending on what backs the owner.
+   * Answer the power-of-attorney question.
    *
-   * A Fayda-verified owner is a proven identity, so the declaration is made
-   * server-side: the API copies that identity onto the GM and records what it
-   * did. Anything typed here would arrive wearing a verified badge it hadn't
-   * earned, which is exactly what the verification exists to prevent.
-   *
-   * A foreign company's owner is backed by a typed passport instead, so there
-   * is nothing proven to copy — that stays the local field-mirroring it has
-   * always been.
+   * Persisted server-side rather than held in form state: the answer decides
+   * whose identity the API gates on, and answering "no" tears down any
+   * representative already recorded (details, verification and DARS paper
+   * together) — none of which the form could do on its own.
    */
-  const [gmLinkPending, setGmLinkPending] = useState(false);
-  const toggleGmSameAsOwner = async (checked: boolean) => {
-    setGmSameAsOwner(checked);
-    if (!identity?.owner.verified) {
-      if (!checked) {
-        setValue("generalManagerName", "");
-        setValue("generalManagerEmail", "");
-        setValue("generalManagerPhone", "");
-      }
-      return;
-    }
-
-    setGmLinkPending(true);
+  const [declarePending, setDeclarePending] = useState(false);
+  const handleDeclare = async (declared: PoaDeclaration) => {
+    setSaveError(null);
+    setDeclarePending(true);
     try {
-      if (checked) await verifaydaService.setGmSameAsOwner();
-      else await verifaydaService.clearGmIdentity();
+      await verifaydaService.setPoaDeclared(declared);
+      if (declared === "no") {
+        // The paper is deleted server-side with the representative; a copy
+        // still sitting in the picker would be re-uploaded on the next step.
+        setDocumentFiles({ ...documentFiles, [POA_DELEGATION_FILE_KEY]: null });
+        // The representative's details go the same way. Answering "no" nulls
+        // every PoA attribute server-side, but the refetch below cannot undo
+        // what is still in the form: `keepDirtyValues` protects exactly the
+        // values the customer typed, so the next step save would send them
+        // straight back — and the API accepts them without complaint, because
+        // its PoA rules only run when the declaration is "yes". The company
+        // ended up on file with no representative and a full set of their
+        // details.
+        for (const field of [
+          "poaName",
+          "poaEmail",
+          "poaPhone",
+          "poaLocation",
+          "poaPassportNumber",
+        ] as const) {
+          setValue(field, "", { shouldDirty: false, shouldValidate: false });
+        }
+      }
       onIdentityChange?.();
     } catch (err) {
-      setGmSameAsOwner(!checked);
-      setSaveError(
+      failSave(
         (err as { response?: { data?: { message?: string } } })?.response?.data
           ?.message ??
-          (err instanceof Error ? err.message : "Could not update the general manager"),
+        (err instanceof Error
+          ? err.message
+          : "Could not save your answer"),
       );
     } finally {
-      setGmLinkPending(false);
+      setDeclarePending(false);
     }
   };
 
-  // Where the GM's details come from depends on how they were established: a
-  // Fayda verification (or a "same as owner" declaration) owns them outright,
-  // and only a company that may still type them falls back to form state.
-  const gmVerified = identity?.gm.verified ?? false;
-  const gmName = gmVerified
-    ? (identity?.gm.name ?? "")
-    : watch("generalManagerName");
-  const gmEmail = gmVerified
-    ? (identity?.gm.email ?? "")
-    : watch("generalManagerEmail");
-  const gmPhone = gmVerified
-    ? (identity?.gm.phone ?? "")
-    : watch("generalManagerPhone");
-
   /**
-   * Whether the GM has been established at all — by verification, by the
-   * "same as owner" declaration, or (only where Fayda is optional) by typing.
-   * Fayda is an Ethiopian national ID, so a foreign company's GM may hold none.
+   * Who owns each of the owner's fields — and therefore which of them are shown
+   * read-only rather than as inputs. See `resolveOwnerSources`; the rule it
+   * encodes pairs with `requiredKeys` below, which requires exactly the fields
+   * no source owns.
    */
-  const gmTyped = Boolean(
-    watch("generalManagerName")?.trim() &&
-      watch("generalManagerEmail")?.trim() &&
-      watch("generalManagerPhone")?.trim(),
+  const ownerVerified = identity?.owner.verified ?? false;
+  const poaVerified = identity?.poa.verified ?? false;
+  const usableEmail = (value?: string | null) => Boolean(firstValidEmail(value));
+  const usablePhone = (value?: string | null) => Boolean(firstValidPhone(value));
+  const { source: ownerSource, sourced: ownerSourced } = resolveOwnerSources(
+    identity,
+    etradeOwner,
   );
-  const gmEstablished =
-    gmVerified || (identity ? !identity.faydaRequired && gmTyped : gmTyped);
+
+  // Keep the form holding exactly what the read-only rows show. The two are
+  // filled from different places — the rows from the licence, the fields from
+  // the lookup that ran or from the rehydrated profile — and only the fields
+  // are submitted, so a divergence would send the API something the customer
+  // was never shown and had no input to correct. eTrade wins it, which is what
+  // "not editable" has to mean for a value already on file.
+  useEffect(() => {
+    if (ownerSource.name === "eTrade" && getValues("ownerName") !== ownerSourced.name) {
+      setValue("ownerName", ownerSourced.name, { shouldValidate: true });
+    }
+    if (
+      ownerSource.phone === "eTrade" &&
+      getValues("ownerPhone") !== ownerSourced.phone
+    ) {
+      setValue("ownerPhone", ownerSourced.phone, { shouldValidate: true });
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [ownerSource.name, ownerSource.phone, ownerSourced.name, ownerSourced.phone]);
+  // No `address`: Fayda's address claim is `poaAddress`, which the portal never
+  // sends — the step's only address-shaped input writes `poaLocation`, which is
+  // the company's own statement and stays typeable however well Fayda knows
+  // where the person lives.
+  // Same validity test as the owner's: a Fayda claim the schema would reject is
+  // not a claim this step can hide the input behind.
+  const poaLocked = {
+    name: poaVerified && Boolean(identity?.poa.name?.trim()),
+    email: poaVerified && usableEmail(identity?.poa.email),
+    phone: poaVerified && usablePhone(identity?.poa.phone),
+  };
 
   /**
-   * Same rule for the representative: verified, or entered where Fayda is
-   * optional.
+   * How a foreign company chose to prove its subject: Fayda, or a passport.
    *
-   * Matches the API's own rule (`REQUIRED_POA_FIELDS`): a typed representative
-   * counts once they have a name, an email and a phone. The step now renders
-   * inputs for all three, so this is something the customer can actually
-   * satisfy — previously it gated on `poaName`, for which no input existed
-   * anywhere, leaving a foreign freight forwarder permanently stuck.
+   * An either/or rather than a fallback, so nothing is asked until one side is
+   * picked. Seeded from what already happened — a completed verification or a
+   * saved passport number is itself the answer — and only then held locally,
+   * because the choice is a UI fork with nothing to persist: what the API
+   * stores is the proof, not the route taken to it.
    */
-  const poaTyped = Boolean(
-    watch("poaName")?.trim() &&
-      watch("poaEmail")?.trim() &&
-      watch("poaPhone")?.trim(),
+  const [identityMethod, setIdentityMethod] = useState<IdentityMethod | null>(
+    null,
   );
-  const poaEstablished =
-    (identity?.poa.verified ?? false) ||
-    (identity ? !identity.faydaRequired && poaTyped : false);
+  const passportSaved = Boolean(
+    identity?.subject === "poa"
+      ? identity?.poa.passportNumber?.trim()
+      : identity?.owner.passportNumber?.trim(),
+  );
+  const subjectVerified = identity?.subject === "poa" ? poaVerified : ownerVerified;
+  const effectiveMethod: IdentityMethod | null = !identity?.passportAccepted
+    ? "fayda" // An Ethiopian company has no choice to make.
+    : subjectVerified
+      ? "fayda"
+      : (identityMethod ?? (passportSaved ? "passport" : null));
 
+  // The owner's name from whichever source established them — powers the
+  // contact step's "same as owner" card.
+  //
+  // Email and phone are picked by validity, not mere presence. Both are copied
+  // into contact fields the schema requires to be well-formed, and a Fayda
+  // claim or an eTrade record routinely carries something that is neither empty
+  // nor usable ("09        "). Taking it would fail the contact step on a value
+  // the customer never typed and — while the copy is linked — cannot edit.
+  const ownerName = firstPresent(identity?.owner.name, watch("ownerName"));
+  const ownerEmail = firstValidEmail(identity?.owner.email, watch("ownerEmail"));
+  const ownerPhone = firstValidPhone(identity?.owner.phone, watch("ownerPhone"));
+
+  const [contactSameAsOwner, setContactSameAsOwner] = useState(false);
   // While linked, mirror the source values into the (disabled) target fields so
   // the copy stays current even if the user goes back and edits the source.
   useEffect(() => {
-    if (!contactSameAsGm) return;
-    setValue("contactPersonName", gmName ?? "", { shouldValidate: true });
-    setValue("contactPersonEmail", gmEmail ?? "");
-    setValue("contactPersonPhone", gmPhone ?? "", { shouldValidate: true });
+    if (!contactSameAsOwner) return;
+    setValue("contactPersonName", ownerName, { shouldValidate: true });
+    setValue("contactPersonEmail", ownerEmail);
+    setValue("contactPersonPhone", ownerPhone, { shouldValidate: true });
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [contactSameAsGm, gmName, gmEmail, gmPhone]);
+  }, [contactSameAsOwner, ownerName, ownerEmail, ownerPhone]);
 
-  const toggleContactSameAsGm = (checked: boolean) => {
-    setContactSameAsGm(checked);
+  const toggleContactSameAsOwner = (checked: boolean) => {
+    setContactSameAsOwner(checked);
     // Checked → the mirror effect fills the fields; unchecked → reset them.
     if (!checked) {
       setValue("contactPersonName", "");
@@ -554,10 +639,10 @@ export default function CompanyProfileForm({
   };
 
   // The DARS delegation paper ships in the same nationality document set as the
-  // rest (the API guarantees it is there), but belongs on the PoA step next to
-  // the details it evidences — so it's split out here and the Documents step
-  // renders the remainder. Both halves share `documentFiles`, so the existing
-  // bulk upload still carries it.
+  // rest (the API guarantees it is there), but belongs on the representation
+  // step next to the details it evidences — so it's split out here and the
+  // Documents step renders the remainder. Both halves share `documentFiles`, so
+  // the existing bulk upload still carries it.
   const poaDocumentField = uploadSetting?.fields?.find(
     (f) => f.fileKey === POA_DELEGATION_FILE_KEY,
   );
@@ -581,8 +666,6 @@ export default function CompanyProfileForm({
     [uploadSetting, poaDocumentField],
   );
 
-  const hasDocuments = Boolean(documentsSetting?.fields?.length);
-
   // Hard verification for the documents step: required company-level
   // documents and a business license per operational profile must both be
   // present before the user can continue.
@@ -608,12 +691,17 @@ export default function CompanyProfileForm({
     return errs;
   };
 
-  // Every role needs at least one license file (existing or newly selected).
+  // Every role needs at least one license file (existing or newly selected) —
+  // except a co-operative's, which holds no business licence at all. Its own
+  // document set is what stands in, and the API lifts the same requirement.
   const validateLicenses = (): Record<string, string> => {
     const errs: Record<string, string> = {};
+    if (cooperative) return errs;
     for (const p of roleProfiles ?? []) {
       const hasNew = (licenseFiles?.[p.id]?.length ?? 0) > 0;
-      const hasExisting = p.existingFiles.length > 0;
+      const hasExisting =
+        p.existingFiles.length > 0 ||
+        (uploadedLicenceProfileIds ?? []).includes(p.id);
       if (!hasNew && !hasExisting) {
         errs[p.id] = "Business license is required";
       }
@@ -625,6 +713,9 @@ export default function CompanyProfileForm({
     next: Record<string, File | File[] | null>,
   ) => {
     setDocumentFiles(next);
+    // Files live outside the form, so the watch subscription above never sees
+    // them — the "upload the required documents" alert has to be retired here.
+    setSaveError(null);
     setDocumentFieldErrors((prev) => {
       if (Object.keys(prev).length === 0) return prev;
       const updated = { ...prev };
@@ -651,8 +742,7 @@ export default function CompanyProfileForm({
 
   // The registration/license details come straight from the eTrade lookup and
   // are not user-editable — shown as a read-only confirmation once a TIN lookup
-  // (or rehydration) has filled them in. The address fields below are separate:
-  // user-entered and required. We watch the values so the display stays current.
+  // (or rehydration) has filled them in.
   const registration = watch([
     "licenceNumber",
     "statusDescription",
@@ -664,34 +754,26 @@ export default function CompanyProfileForm({
   const hasRegistrationDetails = registration.some((v) => v && v.trim());
   // A previously-saved (rehydrated) TIN counts as verified without a refetch —
   // the registration fields being populated at all is proof it passed before.
-  const tinVerified = tinStatus === "verified" || hasRegistrationDetails;
+  // A co-operative never runs the lookup, so there is nothing to be verified
+  // against; its TIN is validated by the schema like any other typed field.
+  const tinVerified =
+    manualRegistration || tinStatus === "verified" || hasRegistrationDetails;
 
   // Single source of truth for step sequence — navigation, labels and the
   // progress bar all derive from this so adding/removing a step is one edit.
   const stepOrder: CompanyStep[] = [
     "company",
-    "personnel",
+    "owner",
+    "representation",
     "contact",
-    "poa",
     "documents",
   ];
   const currentIdx = stepOrder.indexOf(step);
 
-  // The DARS delegation paper is what proves the representative was actually
-  // delegated, so it's required the moment a PoA exists. The API enforces the
-  // same rule on save, so skipping it here only costs the customer a
-  // round-trip.
-  // A PoA exists exactly when one has been verified — the details are the
-  // verification's output, so there is nothing else that could stand for one.
-  // Until then the upload is hidden: there is no representative for the paper
-  // to authorise, and a freight forwarder is held on the verification gate
-  // below rather than on a file field it cannot yet fill.
-  const poaProvided = (identity?.poa.verified ?? false) || poaTyped;
-  // A freight forwarder owes the paper whether or not its representative could
-  // verify with Fayda — the API demands it at completion either way. Keying
-  // this on the verification alone hid the upload from a foreign forwarder and
-  // then failed them on submit for a file they were never shown.
-  const delegationRequired = poaProvided || requirePoa;
+  // The DARS delegation paper is owed exactly when the company says it has a
+  // representative. The API enforces the same rule on save, so skipping it here
+  // only costs the customer a round-trip.
+  const delegationRequired = identity?.poaDeclared === "yes";
   const delegationPresent =
     (uploadedDocumentKeys ?? []).includes(POA_DELEGATION_FILE_KEY) ||
     (() => {
@@ -699,65 +781,87 @@ export default function CompanyProfileForm({
       return Array.isArray(v) ? v.length > 0 : v != null;
     })();
 
+  /**
+   * Is the company's one identity proven?
+   *
+   * `identity.identityProven` is the server's verdict, but it is a step behind
+   * a passport number the customer has just typed and not yet saved — so the
+   * live form value counts too. Blocking on the stale server value would refuse
+   * to advance past a field the customer has visibly filled in.
+   */
+  const passportField =
+    identity?.subject === "poa" ? "poaPassportNumber" : "ownerPassportNumber";
+  const identityProven =
+    (identity?.identityProven ?? false) ||
+    ((identity?.passportAccepted ?? false) &&
+      Boolean(watch(passportField)?.trim()));
+
+  const requiredKeys: (keyof FormData)[] = [];
+  if (step === "company" && manualRegistration) {
+    // These companies have no eTrade record, so the fields every other company
+    // gets read-only from the licence are typed here — and are therefore
+    // required here. House number stays optional: plenty of addresses have none.
+    requiredKeys.push("companyName", "region", "zone", "woreda", "kebele");
+  } else if (step === "owner") {
+    // All three are required by the API (`REQUIRED_COMPANY_INFO`), and an input
+    // is rendered for each one a Fayda verification does not own.
+    if (!ownerSource.name) requiredKeys.push("ownerName");
+    if (!ownerSource.email) requiredKeys.push("ownerEmail");
+    if (!ownerSource.phone) requiredKeys.push("ownerPhone");
+  } else if (
+    step === "representation" &&
+    identity?.poaDeclared === "yes" &&
+    // The details are only on screen once the person is established — before
+    // that the step is still asking how to prove them, and requiring a name
+    // with no input rendered is the dead Continue button this rule exists to
+    // prevent.
+    (poaVerified || effectiveMethod === "passport")
+  ) {
+    if (!poaLocked.name) requiredKeys.push("poaName");
+    if (!poaLocked.email) requiredKeys.push("poaEmail");
+    if (!poaLocked.phone) requiredKeys.push("poaPhone");
+  }
+  requiredKeysRef.current = requiredKeys;
+
   /**
    * Collect the messages for a set of fields into one sentence.
    *
    * A failed `trigger()` used to return silently, so Continue simply did
-   * nothing — and every field whose input is conditionally rendered (or derived
-   * and never rendered at all) turned into an invisible dead end. Naming the
-   * failures is the whole point: the ones worth reporting are exactly the ones
-   * with no error text on screen to read.
+   * nothing — and every field whose input is conditionally rendered turned into
+   * an invisible dead end. Naming the failures is the whole point: the ones
+   * worth reporting are exactly the ones with no error text on screen to read.
    */
   const describeErrors = (fields: (keyof FormData)[]): string => {
     // Re-parse rather than read `errors`: that's the render-time snapshot, and
     // this runs immediately after an `await trigger()` that has not re-rendered
     // yet, so the closure would still be holding the previous attempt's state.
-    const parsed = buildOnboardingSchema(
-      identity?.passportRequired === true,
-    ).safeParse(getValues());
+    const parsed = buildOnboardingSchema(requiredKeys).safeParse(getValues());
     const wanted = new Set<string>(fields as string[]);
     const messages = parsed.success
       ? []
       : parsed.error.issues
-          .filter((i) => wanted.has(String(i.path[0])))
-          .map((i) => i.message);
+        .filter((i) => wanted.has(String(i.path[0])))
+        .map((i) => i.message);
     return messages.length > 0
       ? `Please fix: ${[...new Set(messages)].join(", ")}.`
       : "Some details on this step are incomplete. Please review the fields above.";
   };
 
-  /**
-   * The fields this step actually validates. `stepFields` covers what the step
-   * always renders; the company step additionally exposes company email/phone
-   * as inputs when nothing could be derived for them, and a field is validated
-   * exactly when the customer can see and fix it.
-   */
-  const fieldsForStep = (s: CompanyStep): (keyof FormData)[] => {
-    if (s !== "company" || !identity) return stepFields[s];
-    return [
-      ...stepFields.company,
-      ...(derivedEmail ? [] : (["companyEmail"] as const)),
-      ...(derivedPhone ? [] : (["companyPhone"] as const)),
-    ];
-  };
-
   /** Validate + persist the current step, returning whether we may advance. */
   const saveCurrentStep = async (): Promise<boolean> => {
     setSaveError(null);
-    const fields = fieldsForStep(step);
+    const fields = stepFields[step];
     const isValid = await trigger(fields);
     if (!isValid) {
-      setSaveError(describeErrors(fields));
+      failCheck(describeErrors(fields));
       return false;
     }
     if (!onSaveStep) return true;
     setSaving(true);
     try {
-      const res = await onSaveStep(
-        stepPayload(step, getValues(), dirtyFields),
-      );
+      const res = await onSaveStep(stepPayload(step, getValues(), dirtyFields));
       if (!res.ok) {
-        setSaveError(res.error);
+        failSave(res.error);
         return false;
       }
       return true;
@@ -780,7 +884,7 @@ export default function CompanyProfileForm({
       ) {
         setDocumentFieldErrors(docErrors);
         setLicenseFieldErrors(licenseErrors);
-        setSaveError("Please upload all required documents before continuing.");
+        failCheck("Please upload all required documents before continuing.");
         return;
       }
 
@@ -789,7 +893,7 @@ export default function CompanyProfileForm({
         try {
           const res = await onUploadDocuments();
           if (!res.ok) {
-            setSaveError(res.error);
+            failSave(res.error);
             return;
           }
         } finally {
@@ -798,92 +902,89 @@ export default function CompanyProfileForm({
       }
 
       setSaveError(null);
-      // Deliberately NOT `handleSubmit`: that re-validated all 34 schema fields
-      // — including every field belonging to a step that isn't on screen — and
-      // on failure did nothing at all, no alert and no navigation, which is the
+      // Deliberately NOT `handleSubmit`: that re-validated every schema field —
+      // including every field belonging to a step that isn't on screen — and on
+      // failure did nothing at all, no alert and no navigation, which is the
       // "Submit for review" button that appears dead. Each step has already
-      // validated and saved its own fields, and the API's `markOnboardingComplete`
-      // is the authority on what is still outstanding; its message reaches the
-      // customer through `submitError`.
+      // validated and saved its own fields, and the API's
+      // `markOnboardingComplete` is the authority on what is still outstanding;
+      // its message reaches the customer through `submitError`.
       onSubmit(buildPayload(getValues(), user));
       return;
     }
     // The TIN must resolve to a real eTrade record before anything else on
     // this step is even worth validating — gates here rather than through zod.
+    // A co-operative and a foreign investor are exempt: eTrade holds no record
+    // for either, so `tinVerified` is true and only the duplicate-TIN check
+    // applies.
     if (step === "company" && tinStatus === "taken") {
-      setSaveError(
+      failCheck(
         "This TIN is already registered to another company account.",
       );
       return;
     }
     if (step === "company" && !tinVerified) {
-      setSaveError(
-        "We need to confirm your TIN with eTrade before continuing.",
+      failCheck(
+        tinStatus === "choose-business"
+          ? "This TIN holds more than one business licence — pick the one you're registering as."
+          : "We need to confirm your TIN with eTrade before continuing.",
       );
       return;
     }
-    // Fayda verification is proved outside the form state, so it gates here
-    // rather than through zod. The passport number is a plain typed field —
-    // buildOnboardingSchema already requires it when passportRequired, so
-    // saveCurrentStep()'s trigger() below catches that; checking the stale
-    // server-side identity.owner.passportNumber here would block a value the
-    // user just typed but hasn't saved yet.
-    if (step === "company" && identity?.faydaRequired && !identity.owner.verified) {
-      setSaveError("Verify the company owner's identity with Fayda before continuing.");
-      return;
-    }
-    // The GM is established through Fayda now, so the step gates on the
-    // identity rather than on typed text — same strength as the old required
-    // fields, different evidence. A foreign company's GM may hold no Fayda ID,
-    // so typed details still satisfy it there.
-    if (step === "personnel" && !gmEstablished) {
-      setSaveError(
-        identity?.faydaRequired
-          ? "Verify the general manager with Fayda, or tick “same as owner” if they are the company's owner."
-          : "Add the general manager's details, or verify them with Fayda.",
+    // The declaration decides whose identity is verified, so it has to be
+    // answered before the verification below can mean anything.
+    if (step === "representation" && !identity?.poaDeclared) {
+      failCheck(
+        "Tell us whether anyone holds power of attorney for this company.",
       );
       return;
     }
-    if (step === "poa" && requirePoa && !poaEstablished) {
-      setSaveError(
-        identity?.faydaRequired
-          ? "Freight forwarders act on other companies' behalf, so the Power of Attorney's identity must be verified with Fayda."
-          : "Freight forwarders act on other companies' behalf, so a Power of Attorney is required.",
+    // The verification itself is proved outside the form state, so it gates
+    // here rather than through zod.
+    if (step === "representation" && !identityProven) {
+      const who =
+        identity?.subject === "poa"
+          ? "your Power of Attorney"
+          : "the company owner";
+      failCheck(
+        identity?.passportAccepted
+          ? `Verify ${who} with Fayda, or enter their passport number.`
+          : `Verify ${who} with Fayda before continuing.`,
       );
       return;
     }
-    // The PoA step also gates on a file, which lives outside the form state.
-    if (step === "poa" && delegationRequired && !delegationPresent) {
+    // The step also gates on a file, which lives outside the form state.
+    if (step === "representation" && delegationRequired && !delegationPresent) {
       setDocumentFieldErrors({
         [POA_DELEGATION_FILE_KEY]: "DARS delegation paper is required",
       });
       // Validate the text fields too, so every problem shows at once.
-      const fieldsOk = await trigger(stepFields.poa);
-      setSaveError(
+      const fieldsOk = await trigger(stepFields.representation);
+      failCheck(
         [
-          requirePoa
-            ? "Freight forwarders must provide Power of Attorney details and the DARS delegation paper."
-            : "Upload the DARS delegation paper for the Power of Attorney you entered, or clear the PoA details to skip.",
-          fieldsOk ? null : describeErrors(stepFields.poa),
+          "Upload the DARS delegation paper for the representative you named.",
+          fieldsOk ? null : describeErrors(stepFields.representation),
         ]
           .filter(Boolean)
           .join(" "),
       );
       return;
     }
-    // The API will not accept the PoA's details until the paper evidencing the
-    // delegation is actually on file, so the selection made on this step has to
-    // be uploaded before the save — not held back until the documents step,
-    // which is unreachable while this save keeps failing.
-    if (step === "poa" && delegationRequired && onUploadDocuments) {
+    // The API will not accept the representative's details until the paper
+    // evidencing the delegation is actually on file, so the selection made on
+    // this step has to be uploaded before the save — not held back until the
+    // documents step, which is unreachable while this save keeps failing.
+    if (step === "representation" && delegationRequired && onUploadDocuments) {
       const pending = documentFiles[POA_DELEGATION_FILE_KEY];
-      const hasPending = Array.isArray(pending) ? pending.length > 0 : pending != null;
+      const hasPending = Array.isArray(pending)
+        ? pending.length > 0
+        : pending != null;
       if (hasPending) {
         setSaving(true);
         try {
           const res = await onUploadDocuments();
           if (!res.ok) {
-            setSaveError(res.error);
+            failSave(res.error);
             return;
           }
         } finally {
@@ -909,361 +1010,74 @@ export default function CompanyProfileForm({
       <form onSubmit={(e) => e.preventDefault()}>
         <Stack gap="md">
           {step === "company" && (
-            <Stack gap="xl">
-              <StepSection
-                index={1}
-                title="VAT number"
-                status={
-                  watch("vatNumber")?.length === 10 && !errors.vatNumber
-                    ? "done"
-                    : "todo"
-                }
-              >
-                <TextInput
-                  aria-label="VAT Number"
-                  placeholder="0012345678"
-                  maxLength={10}
-                  error={errors.vatNumber?.message}
-                  {...register("vatNumber")}
-                />
-              </StepSection>
-
-              <StepSection
-                index={2}
-                title="Owner identity"
-                subtitle={
-                  !identity?.owner.verified && !verifiedIdentity
-                    ? "Provide the company owner's passport number."
-                    : undefined
-                }
-                status={
-                  verifiedIdentity
-                    ? identity?.owner.verified
-                      ? "done"
-                      : identity?.faydaRequired
-                        ? "blocked"
-                        : "todo"
-                    : (watch("ownerPassportNumber")?.trim()?.length ?? 0) > 0
-                      ? "done"
-                      : identity?.passportRequired
-                        ? "blocked"
-                        : "todo"
-                }
-              >
-                {identity && (
-                  <>
-                    <FaydaVerifyPanel
-                      subject="owner"
-                      title="Owner"
-                      state={identity.owner}
-                      required={identity.faydaRequired}
-                    />
-                    {identity.passportRequired && (
-                      <TextInput
-                        label="Owner Passport Number"
-                        placeholder="P1234567"
-                        error={errors.ownerPassportNumber?.message}
-                        {...register("ownerPassportNumber")}
-                      />
-                    )}
-                    {/* Normally derived from the verified owner (falling back
-                        to eTrade and the account), and shown read-only. Fayda's
-                        email and phone claims are optional though, so when
-                        every source comes up empty these become typeable —
-                        the API requires both at submit, and having no input
-                        for them is otherwise an unrecoverable dead end. */}
-                    <SimpleGrid cols={2} spacing="md">
-                      {derivedEmail ? (
-                        <ReadOnlyField
-                          label="Company email"
-                          value={derivedEmail}
-                        />
-                      ) : (
-                        <TextInput
-                          label="Company Email"
-                          type="email"
-                          description="We couldn't find one on your verified identity or account — please enter it."
-                          placeholder="company@example.com"
-                          error={errors.companyEmail?.message}
-                          {...register("companyEmail")}
-                        />
-                      )}
-                      {derivedPhone ? (
-                        <ReadOnlyField
-                          label="Company phone"
-                          value={derivedPhone}
-                        />
-                      ) : (
-                        <ControlledPhoneField
-                          control={control}
-                          name="companyPhone"
-                          label="Company Phone"
-                          required
-                        />
-                      )}
-                    </SimpleGrid>
-                  </>
-                )}
-              </StepSection>
-
-              <StepSection
-                index={3}
-                title="Company TIN"
-                subtitle="We'll pull your registration straight from eTrade — nothing to type by hand once it's found."
-                status={
-                  tinVerified
-                    ? "done"
-                    : tinStatus === "taken"
-                      ? "blocked"
-                      : "todo"
-                }
-              >
-                <ETradeInfo
-                  tin={watch("tinNumber")}
-                  register={register("tinNumber")}
-                  error={errors.tinNumber?.message}
-                  onDataLoaded={handleETradeDataLoaded}
-                  onStatusChange={setTinStatus}
-                  onReset={handleETradeReset}
-                  alreadyVerified={hasRegistrationDetails}
-                />
-                {tinVerified && (
-                  <ETradeCompanyCard
-                    tin={watch("tinNumber")}
-                    register={register}
-                    watch={watch}
-                    errors={errors}
-                    control={control}
-                  />
-                )}
-              </StepSection>
-            </Stack>
+            <CompanyInfoStep
+              form={form}
+              tinStatus={tinStatus}
+              tinVerified={tinVerified}
+              hasRegistrationDetails={hasRegistrationDetails}
+              manualRegistration={manualRegistration}
+              cooperative={cooperative}
+              onETradeDataLoaded={handleETradeDataLoaded}
+              onETradeStatusChange={setTinStatus}
+              onETradeReset={handleETradeReset}
+            />
           )}
 
-          {step === "personnel" && (
-            <>
-              <Text fw={600} size="sm" c="edr-text">
-                General Manager
-              </Text>
-              {/* The GM is very often the owner. Where the owner is
-                  Fayda-verified this reuses that proven identity outright
-                  rather than making the same human verify twice; where the
-                  owner is backed by a typed passport there is nothing proven
-                  to copy, so it stays a local prefill. */}
-              <LinkCheckboxCard
-                checked={gmSameAsOwner}
-                onToggle={toggleGmSameAsOwner}
-                title={
-                  identity?.owner.verified
-                    ? "Same as verified owner"
-                    : "Same as business owner"
-                }
-                description={
-                  identity?.owner.verified
-                    ? "Reuse the Fayda-verified owner's identity for the general manager. Uncheck to verify a different person."
-                    : etradeOwner
-                      ? "Reuse the eTrade-registered owner's name, plus the company email and phone as you entered them. Uncheck to enter different details."
-                      : "Reuse your account's name and the company email and phone as you entered them. Uncheck to enter different details."
-                }
-              />
+          {step === "owner" && (
+            <OwnerStep
+              form={form}
+              identity={identity}
+              etradeOwner={etradeOwner}
+              source={ownerSource}
+              sourced={ownerSourced}
+              cooperative={cooperative}
+              manualRegistration={manualRegistration}
+            />
+          )}
 
-              {/* Verifying a second person is only meaningful when the GM is
-                  someone other than the owner. */}
-              {!gmSameAsOwner && identity && (
-                <FaydaVerifyPanel
-                  subject="gm"
-                  title="General Manager"
-                  state={identity.gm}
-                  required={identity.faydaRequired}
-                  disabled={gmLinkPending}
-                />
-              )}
-
-              {/* Typed details survive only where Fayda cannot be required —
-                  a foreign company's manager may hold no Fayda ID. Once
-                  verified the API owns these fields, so they go away. */}
-              {!gmSameAsOwner && !gmVerified && !identity?.faydaRequired && (
-                <>
-                  <TextInput
-                    label="Name"
-                    placeholder="Abebe Bikila"
-                    error={errors.generalManagerName?.message}
-                    {...register("generalManagerName")}
-                  />
-                  <SimpleGrid cols={2} spacing="md">
-                    <TextInput
-                      label="Email"
-                      type="email"
-                      placeholder="gm@company.com"
-                      error={errors.generalManagerEmail?.message}
-                      {...register("generalManagerEmail")}
-                    />
-                    <ControlledPhoneField
-                      control={control}
-                      name="generalManagerPhone"
-                      label="Phone"
-                      required
-                    />
-                  </SimpleGrid>
-                </>
-              )}
-            </>
+          {step === "representation" && (
+            <RepresentationStep
+              form={form}
+              identity={identity}
+              onDeclare={handleDeclare}
+              declarePending={declarePending}
+              declarationLocked={declarationLocked}
+              locked={poaLocked}
+              method={effectiveMethod}
+              onMethodChange={setIdentityMethod}
+              poaDocumentSetting={poaDocumentSetting}
+              documentFiles={documentFiles}
+              uploadedDocumentKeys={uploadedDocumentKeys}
+              documentFieldErrors={documentFieldErrors}
+              onDocumentFilesChange={handleDocumentFilesChange}
+            />
           )}
 
           {step === "contact" && (
-            <>
-              <Text fw={600} size="sm" c="edr-text">
-                Contact Person
-              </Text>
-              {/* `gmName`, not the raw form field: a Fayda-verified GM never
-                  fills `generalManagerName`, so gating on it hid this card from
-                  every Ethiopian company — the majority case. */}
-              {gmName && (
-                <LinkCheckboxCard
-                  checked={contactSameAsGm}
-                  onToggle={toggleContactSameAsGm}
-                  title="Same as General Manager"
-                  description="Reuse the general manager's name, email and phone. Uncheck to enter different details."
-                />
-              )}
-              <SimpleGrid cols={2} spacing="md">
-                <TextInput
-                  label="Name"
-                  placeholder="Jane Smith"
-                  error={errors.contactPersonName?.message}
-                  {...register("contactPersonName")}
-                />
-                <TextInput
-                  label="Position (Optional)"
-                  placeholder="Operations Lead"
-                  error={errors.contactPersonPosition?.message}
-                  {...register("contactPersonPosition")}
-                />
-              </SimpleGrid>
-              <SimpleGrid cols={2} spacing="md">
-                <TextInput
-                  label="Email (Optional)"
-                  type="email"
-                  placeholder="contact@company.com"
-                  error={errors.contactPersonEmail?.message}
-                  {...register("contactPersonEmail")}
-                />
-                <ControlledPhoneField
-                  control={control}
-                  name="contactPersonPhone"
-                  label="Phone"
-                  required
-                />
-              </SimpleGrid>
-            </>
-          )}
-
-          {step === "poa" && (
-            <>
-              <Text size="sm" c="edr-muted">
-                {requirePoa
-                  ? "As a freight forwarder you act on other companies' behalf, so Power of Attorney details and the DARS delegation paper are required."
-                  : "Power of Attorney details are optional. Fill them in if you have them, or skip to continue. If you do enter a representative, upload the delegation paper authenticated by DARS."}
-              </Text>
-              {/* A representative acts for the company inside Ethiopia
-                  whoever owns it, so the PoA is proven with Fayda regardless of
-                  nationality — their name, email, phone and address all come
-                  from the verification and are never typed here. */}
-              {identity && (
-                <FaydaVerifyPanel
-                  subject="poa"
-                  title="Power of Attorney"
-                  state={identity.poa}
-                  required={requirePoa}
-                />
-              )}
-              {/* A verified representative's details come from the Fayda claim
-                  and are shown on the panel above. Where Fayda cannot be
-                  required — a foreign company whose representative may hold no
-                  Fayda ID — they are typed here instead. They have to be: the
-                  API refuses to save a freight forwarder's PoA without a name,
-                  email and phone (`REQUIRED_POA_FIELDS`), and before this the
-                  step rendered no input for any of them, so the customer was
-                  told to "add the poa name, poa email, poa phone" with nowhere
-                  to add them. */}
-              {!identity?.poa.verified && !identity?.faydaRequired && (
-                <>
-                  <TextInput
-                    label="Representative's Name"
-                    placeholder="Abebe Bikila"
-                    error={errors.poaName?.message}
-                    {...register("poaName")}
-                  />
-                  <SimpleGrid cols={2} spacing="md">
-                    <TextInput
-                      label="Representative's Email"
-                      type="email"
-                      placeholder="poa@company.com"
-                      error={errors.poaEmail?.message}
-                      {...register("poaEmail")}
-                    />
-                    <ControlledPhoneField
-                      control={control}
-                      name="poaPhone"
-                      label="Representative's Phone"
-                    />
-                  </SimpleGrid>
-                  <TextInput
-                    label="PoA Location"
-                    placeholder="City, Country"
-                    error={errors.poaLocation?.message}
-                    {...register("poaLocation")}
-                  />
-                </>
-              )}
-
-              {/* The paper authorises the representative, so it shows once one
-                  exists — or straight away for a freight forwarder, who owes it
-                  either way and must not be failed on submit for a file the
-                  step never offered. */}
-              {delegationRequired && poaDocumentSetting && (
-                <>
-                  <Divider my="sm" />
-                  <SmartFileInput
-                    file={poaDocumentSetting}
-                    value={documentFiles}
-                    uploadedKeys={uploadedDocumentKeys}
-                    errors={documentFieldErrors}
-                    onChange={handleDocumentFilesChange}
-                  />
-                </>
-              )}
-            </>
+            <ContactStep
+              form={form}
+              ownerName={ownerName}
+              contactSameAsOwner={contactSameAsOwner}
+              onToggleContactSameAsOwner={toggleContactSameAsOwner}
+            />
           )}
 
           {step === "documents" && (
-            <>
-              {loadingDocuments ? (
-                <Group justify="center" py="xl">
-                  <Loader size="sm" color="edr-green" />
-                </Group>
-              ) : !documentsSetting ? (
-                <Text size="sm" c="edr-muted" ta="center" py="md">
-                  No document requirements found for your account type.
-                </Text>
-              ) : (
-                <SmartFileInput
-                  file={documentsSetting}
-                  value={documentFiles}
-                  uploadedKeys={uploadedDocumentKeys}
-                  errors={documentFieldErrors}
-                  containerClassName="lg:grid grid-cols-2 items-stretch"
-                  onChange={handleDocumentFilesChange}
-                />
-              )}
-
-              <RoleLicenseStep
-                profiles={roleProfiles ?? []}
-                value={licenseFiles ?? {}}
-                onChange={handleLicenseFilesChange}
-                errors={licenseFieldErrors}
-              />
-            </>
+            <DocumentsStep
+              loadingDocuments={loadingDocuments}
+              documentsSetting={documentsSetting}
+              documentFiles={documentFiles}
+              uploadedDocumentKeys={uploadedDocumentKeys}
+              documentFieldErrors={documentFieldErrors}
+              onDocumentFilesChange={handleDocumentFilesChange}
+              // A co-operative union or farm holds no business licence, so the
+              // per-role upload cards are not shown at all — offering a slot
+              // nothing can fill reads as an unfinishable step.
+              roleProfiles={cooperative ? [] : roleProfiles}
+              licenseFiles={licenseFiles}
+              licenseFieldErrors={licenseFieldErrors}
+              onLicenseFilesChange={handleLicenseFilesChange}
+            />
           )}
 
           {saveError && (
@@ -1271,9 +1085,13 @@ export default function CompanyProfileForm({
               color="red"
               variant="light"
               icon={<AlertCircle size={18} />}
-              title={"Couldn't save this step"}
+              title={
+                saveError.kind === "save"
+                  ? "Couldn't save this step"
+                  : "Please check this step"
+              }
             >
-              {saveError}
+              {saveError.message}
             </Alert>
           )}
 
@@ -1302,7 +1120,12 @@ export default function CompanyProfileForm({
               disabled={
                 isPending ||
                 saving ||
-                (step === "documents" && !hasDocuments && loadingDocuments)
+                declarePending ||
+                // Nothing to validate against until the document set lands, so
+                // pressing Continue now would report every required upload as
+                // satisfied. `hasDocuments` used to be in here too, which let
+                // the button go live mid-load the moment the set resolved.
+                (step === "documents" && loadingDocuments)
               }
               loading={isPending || saving}
               rightSection={
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/DjiboutiAgentForm.tsx b/apps/edr-freight-web/portal/src/pages/accounts/DjiboutiAgentForm.tsx
deleted file mode 100644
index 89570c545..000000000
--- a/apps/edr-freight-web/portal/src/pages/accounts/DjiboutiAgentForm.tsx
+++ /dev/null
@@ -1,328 +0,0 @@
-import { Box, Button, Group, Loader, SimpleGrid, Stack, Text, TextInput, ThemeIcon } from "@mantine/core";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { useQuery } from "@tanstack/react-query";
-import {
-  ArrowLeft,
-  ArrowRight,
-  Building2,
-  CheckCircle2,
-  ChevronLeft,
-  UploadCloud,
-  UserRound,
-} from "lucide-react";
-import { useState } from "react";
-import { useForm } from "react-hook-form";
-import { z } from "zod";
-
-import type { AuthUser } from "@/types/auth";
-import type { CreateCompanyPayload } from "@/services/companies.service";
-import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
-import { SmartFileInput } from "@edr/ui-common";
-import { api } from "@/services/api";
-
-type DjiboutiStep = "company" | "representative" | "documents" | "confirm";
-
-const djiboutiSchema = z.object({
-  companyName: z.string().min(1, "Company name is required"),
-  companyEmail: z.string().email("Invalid email address"),
-  companyPhone: z
-    .string()
-    .min(1, "Company phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-  companyLocation: z.string().min(1, "Location / Country is required"),
-  companyAddress: z.string().min(1, "Address is required"),
-  repName: z.string().min(1, "Representative name is required"),
-  repEmail: z.string().email("Invalid representative email"),
-  repPhone: z
-    .string()
-    .min(1, "Representative phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-});
-
-type FormData = z.infer<typeof djiboutiSchema>;
-
-const stepFields: Record<DjiboutiStep, (keyof FormData)[]> = {
-  company: ["companyName", "companyEmail", "companyPhone", "companyLocation", "companyAddress"],
-  representative: ["repName", "repEmail", "repPhone"],
-  documents: [],
-  confirm: [],
-};
-
-function buildPayload(data: FormData, _user: AuthUser): CreateCompanyPayload {
-  return {
-    companyName: data.companyName,
-    companyEmail: data.companyEmail,
-    companyPhone: data.companyPhone,
-    companyLocation: data.companyLocation,
-    companyAddress: data.companyAddress,
-    tin: "",
-    vatNumber: "",
-    fanNumber: "",
-    attributes: {
-      repName: data.repName,
-      repEmail: data.repEmail,
-      repPhone: data.repPhone,
-    },
-  };
-}
-
-export default function DjiboutiAgentForm({
-  documentSettingCode,
-  documentFiles: controlledFiles,
-  onDocumentFilesChange,
-  user,
-  onSubmit,
-  isPending,
-  onBack,
-}: {
-  documentSettingCode: string;
-  documentFiles?: Record<string, File | File[] | null>;
-  onDocumentFilesChange?: (files: Record<string, File | File[] | null>) => void;
-  user: AuthUser;
-  onSubmit: (data: CreateCompanyPayload) => void;
-  isPending: boolean;
-  onBack: () => void;
-}) {
-  const [step, setStep] = useState<DjiboutiStep>("company");
-  const [internalFiles, setInternalFiles] = useState<Record<string, File | File[] | null>>({});
-  const documentFiles = controlledFiles ?? internalFiles;
-  const setDocumentFiles = onDocumentFilesChange ?? setInternalFiles;
-
-  const { data: uploadSetting, isLoading: loadingDocuments } = useQuery(
-    api.fileUploadSettings.getByCode.queryOptions({ input: { code: documentSettingCode }, refetchOnMount: false }),
-  );
-
-  const { register, control, handleSubmit, trigger, watch, formState: { errors } } = useForm<FormData>({
-    resolver: zodResolver(djiboutiSchema),
-    defaultValues: {
-      companyName: "", companyEmail: "", companyPhone: "",
-      companyLocation: "", companyAddress: "", repName: "", repEmail: "", repPhone: "",
-    },
-  });
-
-  const formValues = watch();
-  const hasDocuments = Boolean(uploadSetting?.fields?.length);
-  const totalSteps = 4;
-
-  const nextStep = async () => {
-    if (step === "representative") { setStep("documents"); return; }
-    if (step === "documents") { setStep("confirm"); return; }
-    if (step === "confirm") { handleSubmit((data) => onSubmit(buildPayload(data, user)))(); return; }
-    const isValid = await trigger(stepFields[step]);
-    if (!isValid) return;
-    setStep("representative");
-  };
-
-  const skipDocuments = () => setStep("confirm");
-
-  const prevStep = () => {
-    if (step === "company") onBack();
-    else if (step === "representative") setStep("company");
-    else if (step === "documents") setStep("representative");
-    else setStep("documents");
-  };
-
-  const STEPS: { key: DjiboutiStep; icon: React.ReactNode }[] = [
-    { key: "company", icon: <Building2 size={18} /> },
-    { key: "representative", icon: <UserRound size={18} /> },
-    { key: "documents", icon: <UploadCloud size={18} /> },
-    { key: "confirm", icon: <CheckCircle2 size={18} /> },
-  ];
-
-  const STEP_LABELS: Record<DjiboutiStep, string> = {
-    company: `Step 1 of ${totalSteps} — Company Information`,
-    representative: `Step 2 of ${totalSteps} — Representative Details`,
-    documents: `Step 3 of ${totalSteps} — Upload Documents (Optional)`,
-    confirm: `Step 4 of ${totalSteps} — Review & Confirm`,
-  };
-
-  const stepOrder: DjiboutiStep[] = ["company", "representative", "documents", "confirm"];
-  const currentIdx = stepOrder.indexOf(step);
-
-  return (
-    <>
-      <Box mb="xl">
-        <Button
-          variant="subtle"
-          c="edr-muted"
-          size="sm"
-          mb="sm"
-          leftSection={<ChevronLeft size={16} />}
-          onClick={prevStep}
-        >
-          Change account type
-        </Button>
-
-        <Group justify="space-between" align="center" className="relative max-w-lg mx-auto px-2">
-          <Box className="absolute top-1/2 left-2 right-2 h-0.5 bg-edr-border -translate-y-1/2 z-0" />
-          {STEPS.map(({ key, icon }, i) => {
-            const done = i < currentIdx;
-            const active = i === currentIdx;
-            return done || active ? (
-              <ThemeIcon key={key} size={40} radius="xl" variant="filled" color="edr-green" className="relative z-10">
-                {done ? <CheckCircle2 size={18} /> : icon}
-              </ThemeIcon>
-            ) : (
-              <Box
-                key={key}
-                w={40}
-                h={40}
-                c="edr-slate"
-                className="relative z-10 flex items-center justify-center rounded-full border-2 border-edr-border bg-edr-card"
-              >
-                {icon}
-              </Box>
-            );
-          })}
-        </Group>
-
-        <Text size="sm" c="edr-muted" ta="center" mt="sm">
-          {STEP_LABELS[step]}
-        </Text>
-      </Box>
-
-      <form onSubmit={(e) => e.preventDefault()}>
-        <Stack gap="md">
-          {step === "company" && (
-            <>
-              <TextInput
-                label="Company Name"
-                placeholder="Djibouti Logistics SARL"
-                error={errors.companyName?.message}
-                {...register("companyName")}
-              />
-              <SimpleGrid cols={2} spacing="md">
-                <TextInput
-                  label="Company Email"
-                  type="email"
-                  placeholder="info@djib-logistics.dj"
-                  error={errors.companyEmail?.message}
-                  {...register("companyEmail")}
-                />
-                <ControlledPhoneField
-                  control={control}
-                  name="companyPhone"
-                  label="Company Phone"
-                  required
-                />
-              </SimpleGrid>
-              <SimpleGrid cols={2} spacing="md">
-                <TextInput
-                  label="Location / Country"
-                  placeholder="Djibouti City, Djibouti"
-                  error={errors.companyLocation?.message}
-                  {...register("companyLocation")}
-                />
-                <TextInput
-                  label="Address"
-                  placeholder="Boulevard de la République"
-                  error={errors.companyAddress?.message}
-                  {...register("companyAddress")}
-                />
-              </SimpleGrid>
-            </>
-          )}
-
-          {step === "representative" && (
-            <>
-              <Text size="sm" c="edr-muted">
-                Provide the company representative details for this account.
-              </Text>
-              <TextInput
-                label="Representative Name"
-                placeholder="Ahmed Hassan"
-                error={errors.repName?.message}
-                {...register("repName")}
-              />
-              <SimpleGrid cols={2} spacing="md">
-                <TextInput
-                  label="Representative Email"
-                  type="email"
-                  placeholder="ahmed@company.dj"
-                  error={errors.repEmail?.message}
-                  {...register("repEmail")}
-                />
-                <ControlledPhoneField
-                  control={control}
-                  name="repPhone"
-                  label="Representative Phone"
-                  required
-                />
-              </SimpleGrid>
-            </>
-          )}
-
-          {step === "documents" && (
-            <>
-              {loadingDocuments ? (
-                <Group justify="center" py="xl">
-                  <Loader size="sm" color="edr-green" />
-                </Group>
-              ) : !uploadSetting ? (
-                <Text size="sm" c="edr-muted" ta="center" py="md">
-                  No document requirements found for your account type.
-                </Text>
-              ) : (
-                <SmartFileInput file={uploadSetting} value={documentFiles} onChange={setDocumentFiles} />
-              )}
-            </>
-          )}
-
-          {step === "confirm" && (
-            <Box p={16} className="rounded-2xl border border-edr-border bg-edr-card">
-              <Text fw={600} c="edr-text">Review your registration</Text>
-              <Text size="sm" c="edr-muted" mt={4} mb="md">
-                Confirm the company details below before saving.
-              </Text>
-              <SimpleGrid cols={2} spacing="sm">
-                <ReviewRow label="Company name" value={formValues.companyName} />
-                <ReviewRow label="Company email" value={formValues.companyEmail} />
-                <ReviewRow label="Company phone" value={formValues.companyPhone} />
-                <ReviewRow label="Location" value={formValues.companyLocation} />
-                <ReviewRow label="Address" value={formValues.companyAddress} />
-                <ReviewRow label="Rep. name" value={formValues.repName} />
-                <ReviewRow label="Rep. email" value={formValues.repEmail} />
-                <ReviewRow label="Rep. phone" value={formValues.repPhone} />
-              </SimpleGrid>
-            </Box>
-          )}
-
-          <Group justify="space-between" pt="xs">
-            <Button variant="default" onClick={prevStep} leftSection={<ArrowLeft size={16} />}>
-              {step === "company" ? "Change Type" : step === "confirm" ? "Back to Documents" : "Back"}
-            </Button>
-            <Group gap="sm">
-              {step === "documents" && (
-                <Button variant="default" onClick={skipDocuments} disabled={isPending}>
-                  Skip for now
-                </Button>
-              )}
-              <Button
-                color="edr-green"
-                onClick={step === "confirm" ? handleSubmit((data) => onSubmit(buildPayload(data, user))) : nextStep}
-                disabled={isPending || (step === "documents" && !hasDocuments && loadingDocuments)}
-                loading={isPending}
-                rightSection={!isPending && step !== "confirm" && step !== "documents" ? <ArrowRight size={16} /> : undefined}
-              >
-                {step === "documents" ? "Continue" : step === "confirm" ? "Submit Registration" : "Next Step"}
-              </Button>
-            </Group>
-          </Group>
-        </Stack>
-      </form>
-    </>
-  );
-}
-
-function ReviewRow({ label, value }: { label: string; value?: string | null }) {
-  return (
-    <Box p={12} className="rounded-xl bg-edr-bg">
-      <Text size="xs" fw={600} c="edr-muted" className="uppercase tracking-wide">
-        {label}
-      </Text>
-      <Text size="sm" fw={500} c={value?.trim() ? "edr-text" : "edr-muted"} mt={4}>
-        {value?.trim() ? value : "Not provided"}
-      </Text>
-    </Box>
-  );
-}
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 7e8e512dd..746d1648c 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/LoginPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/LoginPage.tsx
@@ -1,6 +1,6 @@
 import { type FormEvent, useState } from "react";
 import { Alert, Button, PasswordInput, Stack, TextInput } from "@mantine/core";
-import { AlertCircle } from "lucide-react";
+import { AlertCircle, CheckCircle2 } from "lucide-react";
 import { Link, useLocation, useNavigate } from "react-router-dom";
 
 import useAuth from "@/hooks/useAuth";
@@ -19,6 +19,10 @@ export default function LoginPage() {
   const [error, setError] = useState<string | null>(null);
   const [loading, setLoading] = useState(false);
 
+  const passwordWasReset =
+    (location.state as { passwordReset?: boolean } | null)?.passwordReset ===
+    true;
+
   const handleSubmit = async (event: FormEvent<HTMLFormElement>) => {
     event.preventDefault();
     setError(null);
@@ -56,6 +60,21 @@ export default function LoginPage() {
         </div>
 
         <Stack gap="md">
+          {/*
+            Set by the reset flows on their way here. Without it the account
+            holder lands on a bare sign-in form with no sign the reset worked —
+            and the link is single-use, so there is no way back to check.
+          */}
+          {passwordWasReset ? (
+            <Alert
+              color="green"
+              variant="light"
+              icon={<CheckCircle2 size={18} />}
+            >
+              Your password has been updated. Sign in with your new password.
+            </Alert>
+          ) : null}
+
           <TextInput
             label="Email or Phone"
             placeholder="name@company.com or 09XXXXXXXX"
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/ResetPasswordLinkPage.tsx b/apps/edr-freight-web/portal/src/pages/accounts/ResetPasswordLinkPage.tsx
index 4776287ae..7b3bae7c9 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/ResetPasswordLinkPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/ResetPasswordLinkPage.tsx
@@ -1,6 +1,6 @@
 import { type FormEvent, useEffect, useState } from "react";
 import { Alert, Button, Loader, PasswordInput, Stack } from "@mantine/core";
-import { AlertCircle, KeyRound } from "lucide-react";
+import { AlertCircle, CheckCircle2, KeyRound, LogIn } from "lucide-react";
 import { Link, useNavigate, useSearchParams } from "react-router-dom";
 
 import AuthShell from "@/components/auth/AuthShell";
@@ -33,6 +33,7 @@ export default function ResetPasswordLinkPage() {
   const [confirmPassword, setConfirmPassword] = useState("");
   const [submitting, setSubmitting] = useState(false);
   const [error, setError] = useState<string | null>(null);
+  const [succeeded, setSucceeded] = useState(false);
 
   useEffect(() => {
     if (!userId || !token) {
@@ -82,7 +83,12 @@ export default function ResetPasswordLinkPage() {
         newPassword: password,
         confirmPassword,
       });
-      navigate("/login", { replace: true, state: { passwordReset: true } });
+      // Confirm in place rather than bouncing to /login: the old redirect
+      // passed `passwordReset: true` in route state that no page ever read, so
+      // the account holder landed on a bare sign-in form with no sign the reset
+      // had worked — and the link is single-use, so there is no way back to
+      // check.
+      setSucceeded(true);
     } catch (err) {
       setError(extractApiError(err).message);
     } finally {
@@ -90,6 +96,58 @@ export default function ResetPasswordLinkPage() {
     }
   };
 
+  // Password set — the link is now spent, so this is the last thing the account
+  // holder sees. It replaces the whole form rather than sitting above it.
+  if (succeeded) {
+    return (
+      <AuthShell
+        tagline="Password updated"
+        taglineBody="Your EDR Freight account is ready to use."
+      >
+        <div className="flex w-full flex-col">
+          <div className="mb-1 flex justify-center">
+            <span className="flex h-14 w-14 items-center justify-center rounded-full bg-green-100 text-green-600">
+              <CheckCircle2 size={30} strokeWidth={2.2} />
+            </span>
+          </div>
+
+          <div className="mb-6 mt-4 space-y-2 text-center">
+            <h1 className="text-xl font-bold tracking-tight text-gray-900 sm:text-2xl">
+              You&apos;re all set
+            </h1>
+            <p className="text-sm leading-relaxed text-gray-500">
+              Your password has been updated
+              {account?.maskedIdentifier ? ` for ${account.maskedIdentifier}` : ""}.
+              Sign in with your new password to continue.
+            </p>
+          </div>
+
+          <Stack gap="md">
+            <Button
+              color="edr-green"
+              size="md"
+              fullWidth
+              leftSection={<LogIn size={18} />}
+              onClick={() =>
+                navigate("/login", {
+                  replace: true,
+                  state: { passwordReset: true },
+                })
+              }
+            >
+              Go to sign in
+            </Button>
+
+            <p className="text-center text-xs leading-relaxed text-gray-400">
+              For your security, this reset link has now been used and will not
+              work again.
+            </p>
+          </Stack>
+        </div>
+      </AuthShell>
+    );
+  }
+
   return (
     <AuthShell
       tagline="Set a new password"
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/TransporterForm.tsx b/apps/edr-freight-web/portal/src/pages/accounts/TransporterForm.tsx
index ef6f894fd..1e365ab7d 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/TransporterForm.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/TransporterForm.tsx
@@ -1,4 +1,16 @@
-import { Box, Button, Divider, Group, Loader, Select, SimpleGrid, Stack, Text, TextInput, ThemeIcon } from "@mantine/core";
+import {
+  Box,
+  Button,
+  Divider,
+  Group,
+  Loader,
+  Select,
+  SimpleGrid,
+  Stack,
+  Text,
+  TextInput,
+  ThemeIcon,
+} from "@mantine/core";
 import { zodResolver } from "@hookform/resolvers/zod";
 import { useQuery } from "@tanstack/react-query";
 import {
@@ -18,7 +30,13 @@ import type { CreateCompanyPayload } from "@/services/companies.service";
 import { SmartFileInput } from "@edr/ui-common";
 import { api } from "@/services/api";
 
-const TRUCK_TYPES = ["Casoni", "Truck Trailer", "High Bed", "Low Bed", "Others"] as const;
+const TRUCK_TYPES = [
+  "Casoni",
+  "Truck Trailer",
+  "High Bed",
+  "Low Bed",
+  "Others",
+] as const;
 
 type TransporterStep = "vehicle" | "documents" | "confirm";
 
@@ -36,7 +54,10 @@ const transporterSchema = z
       .regex(/^\d{4}$/, "Enter a valid year (e.g. 2023)"),
   })
   .superRefine((data, ctx) => {
-    if (data.truckType === "Casoni" && (!data.plateNumber2 || data.plateNumber2.trim().length === 0)) {
+    if (
+      data.truckType === "Casoni" &&
+      (!data.plateNumber2 || data.plateNumber2.trim().length === 0)
+    ) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
         path: ["plateNumber2"],
@@ -50,8 +71,6 @@ type FormData = z.infer<typeof transporterSchema>;
 function buildPayload(data: FormData, user: AuthUser): CreateCompanyPayload {
   return {
     companyName: user.name?.en ?? "",
-    companyEmail: user.email,
-    companyPhone: user.phoneNumber,
     companyLocation: "",
     companyAddress: "",
     tin: data.tinNumber,
@@ -85,18 +104,36 @@ export default function TransporterForm({
   onBack: () => void;
 }) {
   const [step, setStep] = useState<TransporterStep>("vehicle");
-  const [internalFiles, setInternalFiles] = useState<Record<string, File | File[] | null>>({});
+  const [internalFiles, setInternalFiles] = useState<
+    Record<string, File | File[] | null>
+  >({});
   const documentFiles = controlledFiles ?? internalFiles;
   const setDocumentFiles = onDocumentFilesChange ?? setInternalFiles;
 
   const { data: uploadSetting, isLoading: loadingDocuments } = useQuery(
-    api.fileUploadSettings.getByCode.queryOptions({ input: { code: documentSettingCode }, refetchOnMount: false }),
+    api.fileUploadSettings.getByCode.queryOptions({
+      input: { code: documentSettingCode },
+      refetchOnMount: false,
+    }),
   );
 
-  const { register, handleSubmit, trigger, watch, control, formState: { errors } } = useForm<FormData>({
+  const {
+    register,
+    handleSubmit,
+    trigger,
+    watch,
+    control,
+    formState: { errors },
+  } = useForm<FormData>({
     resolver: zodResolver(transporterSchema),
     defaultValues: {
-      tinNumber: "", fanNumber: "", truckType: "", plateNumber: "", plateNumber2: "", vehicleModel: "", yearOfManufacturing: "",
+      tinNumber: "",
+      fanNumber: "",
+      truckType: "",
+      plateNumber: "",
+      plateNumber2: "",
+      vehicleModel: "",
+      yearOfManufacturing: "",
     },
   });
 
@@ -107,9 +144,22 @@ export default function TransporterForm({
   const totalSteps = 3;
 
   const nextStep = async () => {
-    if (step === "documents") { setStep("confirm"); return; }
-    if (step === "confirm") { handleSubmit((data) => onSubmit(buildPayload(data, user)))(); return; }
-    const fields: (keyof FormData)[] = ["tinNumber", "fanNumber", "truckType", "plateNumber", "vehicleModel", "yearOfManufacturing"];
+    if (step === "documents") {
+      setStep("confirm");
+      return;
+    }
+    if (step === "confirm") {
+      handleSubmit((data) => onSubmit(buildPayload(data, user)))();
+      return;
+    }
+    const fields: (keyof FormData)[] = [
+      "tinNumber",
+      "fanNumber",
+      "truckType",
+      "plateNumber",
+      "vehicleModel",
+      "yearOfManufacturing",
+    ];
     const isValid = await trigger(fields);
     if (!isValid) return;
     setStep("documents");
@@ -152,13 +202,24 @@ export default function TransporterForm({
           Change account type
         </Button>
 
-        <Group justify="space-between" align="center" className="relative max-w-lg mx-auto px-2">
+        <Group
+          justify="space-between"
+          align="center"
+          className="relative max-w-lg mx-auto px-2"
+        >
           <Box className="absolute top-1/2 left-2 right-2 h-0.5 bg-edr-border -translate-y-1/2 z-0" />
           {STEPS.map(({ key, icon }, i) => {
             const done = i < currentIdx;
             const active = i === currentIdx;
             return done || active ? (
-              <ThemeIcon key={key} size={40} radius="xl" variant="filled" color="edr-green" className="relative z-10">
+              <ThemeIcon
+                key={key}
+                size={40}
+                radius="xl"
+                variant="filled"
+                color="edr-green"
+                className="relative z-10"
+              >
                 {done ? <CheckCircle2 size={18} /> : icon}
               </ThemeIcon>
             ) : (
@@ -203,7 +264,9 @@ export default function TransporterForm({
 
               <Divider color="edr-border" />
 
-              <Text fw={600} size="sm" c="edr-text">Vehicle / Truck Information</Text>
+              <Text fw={600} size="sm" c="edr-text">
+                Vehicle / Truck Information
+              </Text>
 
               <Controller
                 name="truckType"
@@ -276,14 +339,23 @@ export default function TransporterForm({
                   No document requirements found for your account type.
                 </Text>
               ) : (
-                <SmartFileInput file={uploadSetting} value={documentFiles} onChange={setDocumentFiles} />
+                <SmartFileInput
+                  file={uploadSetting}
+                  value={documentFiles}
+                  onChange={setDocumentFiles}
+                />
               )}
             </>
           )}
 
           {step === "confirm" && (
-            <Box p={16} className="rounded-2xl border border-edr-border bg-edr-card">
-              <Text fw={600} c="edr-text">Review your registration</Text>
+            <Box
+              p={16}
+              className="rounded-2xl border border-edr-border bg-edr-card"
+            >
+              <Text fw={600} c="edr-text">
+                Review your registration
+              </Text>
               <Text size="sm" c="edr-muted" mt={4} mb="md">
                 Confirm the details below before saving.
               </Text>
@@ -291,32 +363,73 @@ export default function TransporterForm({
                 <ReviewRow label="TIN Number" value={formValues.tinNumber} />
                 <ReviewRow label="FAN Number" value={formValues.fanNumber} />
                 <ReviewRow label="Truck Type" value={formValues.truckType} />
-                <ReviewRow label="Plate Number" value={formValues.plateNumber} />
-                {formValues.plateNumber2 && <ReviewRow label="Plate (Trailer)" value={formValues.plateNumber2} />}
-                <ReviewRow label="Vehicle Model" value={formValues.vehicleModel} />
-                <ReviewRow label="Year" value={formValues.yearOfManufacturing} />
+                <ReviewRow
+                  label="Plate Number"
+                  value={formValues.plateNumber}
+                />
+                {formValues.plateNumber2 && (
+                  <ReviewRow
+                    label="Plate (Trailer)"
+                    value={formValues.plateNumber2}
+                  />
+                )}
+                <ReviewRow
+                  label="Vehicle Model"
+                  value={formValues.vehicleModel}
+                />
+                <ReviewRow
+                  label="Year"
+                  value={formValues.yearOfManufacturing}
+                />
               </SimpleGrid>
             </Box>
           )}
 
           <Group justify="space-between" pt="xs">
-            <Button variant="default" onClick={prevStep} leftSection={<ArrowLeft size={16} />}>
-              {step === "vehicle" ? "Change Type" : step === "confirm" ? "Back to Documents" : "Back"}
+            <Button
+              variant="default"
+              onClick={prevStep}
+              leftSection={<ArrowLeft size={16} />}
+            >
+              {step === "vehicle"
+                ? "Change Type"
+                : step === "confirm"
+                  ? "Back to Documents"
+                  : "Back"}
             </Button>
             <Group gap="sm">
               {step === "documents" && (
-                <Button variant="default" onClick={skipDocuments} disabled={isPending}>
+                <Button
+                  variant="default"
+                  onClick={skipDocuments}
+                  disabled={isPending}
+                >
                   Skip for now
                 </Button>
               )}
               <Button
                 color="edr-green"
-                onClick={step === "confirm" ? handleSubmit((data) => onSubmit(buildPayload(data, user))) : nextStep}
-                disabled={isPending || (step === "documents" && !hasDocuments && loadingDocuments)}
+                onClick={
+                  step === "confirm"
+                    ? handleSubmit((data) => onSubmit(buildPayload(data, user)))
+                    : nextStep
+                }
+                disabled={
+                  isPending ||
+                  (step === "documents" && !hasDocuments && loadingDocuments)
+                }
                 loading={isPending}
-                rightSection={!isPending && step !== "confirm" && step !== "documents" ? <ArrowRight size={16} /> : undefined}
+                rightSection={
+                  !isPending && step !== "confirm" && step !== "documents" ? (
+                    <ArrowRight size={16} />
+                  ) : undefined
+                }
               >
-                {step === "documents" ? "Continue" : step === "confirm" ? "Submit Registration" : "Next Step"}
+                {step === "documents"
+                  ? "Continue"
+                  : step === "confirm"
+                    ? "Submit Registration"
+                    : "Next Step"}
               </Button>
             </Group>
           </Group>
@@ -329,10 +442,20 @@ export default function TransporterForm({
 function ReviewRow({ label, value }: { label: string; value?: string | null }) {
   return (
     <Box p={12} className="rounded-xl border border-edr-border bg-edr-card">
-      <Text size="xs" fw={600} c="edr-muted" className="uppercase tracking-wide">
+      <Text
+        size="xs"
+        fw={600}
+        c="edr-muted"
+        className="uppercase tracking-wide"
+      >
         {label}
       </Text>
-      <Text size="sm" fw={500} c={value?.trim() ? "edr-text" : "edr-muted"} mt={4}>
+      <Text
+        size="sm"
+        fw={500}
+        c={value?.trim() ? "edr-text" : "edr-muted"}
+        mt={4}
+      >
         {value?.trim() ? value : "Not provided"}
       </Text>
     </Box>
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/ETradeCompanyCard.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/ETradeCompanyCard.tsx
index 2634fed0d..4469009ed 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/ETradeCompanyCard.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/ETradeCompanyCard.tsx
@@ -1,70 +1,27 @@
-import { Badge, Card, Group, Select, SimpleGrid, Text, TextInput } from "@mantine/core";
+import { Badge, Card, Group, SimpleGrid, Text } from "@mantine/core";
 import { CheckCircle2 } from "lucide-react";
-import { Controller } from "react-hook-form";
-import type {
-  Control,
-  FieldErrors,
-  UseFormRegister,
-  UseFormWatch,
-} from "react-hook-form";
-import { ETHIOPIAN_REGIONS } from "@edr/types";
+import type { UseFormWatch } from "react-hook-form";
 
 import type { FormData } from "./schema";
 import { ReadOnlyField } from "./ReadOnlyField";
 
 /**
- * One field of the verified-registration card: locked read-only once eTrade
- * supplied a value, but falls back to an editable input when eTrade left it
- * blank — otherwise a gap in eTrade's own data would leave the field
- * permanently empty and the user stuck (zod requires all of these).
+ * The verified eTrade record, rendered strictly read-only.
  *
- * A value that fails validation unlocks the same way. eTrade (or a row saved
- * before the current rules) can supply something the schema rejects, and a
- * rejected value rendered read-only is a step that can never be completed and
- * never says why.
+ * Nothing here is typeable — not even a field eTrade left blank. These values
+ * are the government's record of the company, so a customer-typed substitute
+ * would be an unverified claim wearing the badge of a verified one. A gap stays
+ * a visible gap ("—"), and the schema no longer requires these fields, so it
+ * cannot block the step either.
  */
-function LockedField({
-  label,
-  name,
-  register,
-  watch,
-  errors,
-}: {
-  label: string;
-  name: keyof FormData;
-  register: UseFormRegister<FormData>;
-  watch: UseFormWatch<FormData>;
-  errors: FieldErrors<FormData>;
-}) {
-  const value = watch(name) as string | undefined;
-  if (value && value.trim() && !errors[name]) {
-    return <ReadOnlyField label={label} value={value} />;
-  }
-  return (
-    <TextInput
-      label={label}
-      description="eTrade didn't provide this — please confirm"
-      error={errors[name]?.message as string | undefined}
-      {...register(name)}
-    />
-  );
-}
-
 export default function ETradeCompanyCard({
   tin,
-  register,
   watch,
-  errors,
-  control,
 }: {
   tin: string;
-  register: UseFormRegister<FormData>;
   watch: UseFormWatch<FormData>;
-  errors: FieldErrors<FormData>;
-  control: Control<FormData>;
 }) {
   const companyName = watch("companyName");
-  const region = watch("region");
 
   return (
     <Card padding="md" radius="md" withBorder>
@@ -88,73 +45,18 @@ export default function ETradeCompanyCard({
       </Group>
 
       <SimpleGrid cols={2} spacing="sm">
-        <LockedField
-          label="Company Name"
-          name="companyName"
-          register={register}
-          watch={watch}
-          errors={errors}
-        />
+        <ReadOnlyField label="Company Name" value={watch("companyName")} />
         <ReadOnlyField label="License Number" value={watch("licenceNumber")} />
         <ReadOnlyField label="Status" value={watch("statusDescription")} />
         <ReadOnlyField label="Date Registered" value={watch("dateRegistered")} />
         <ReadOnlyField label="Renewal Date" value={watch("renewalDate")} />
         <ReadOnlyField label="Renewed From" value={watch("renewedFrom")} />
         <ReadOnlyField label="Renewed To" value={watch("renewedTo")} />
-        {/* Membership of the catalog, not mere presence: eTrade's normalizer
-            returns null for a region it doesn't recognise, and older rows can
-            hold a spelling that isn't in the list. Showing such a value
-            read-only left the customer with a required field they could not
-            correct. */}
-        {(ETHIOPIAN_REGIONS as readonly string[]).includes(region ?? "") ? (
-          <ReadOnlyField label="Region" value={region} />
-        ) : (
-          <Controller
-            name="region"
-            control={control}
-            render={({ field }) => (
-              <Select
-                label="Region"
-                description="eTrade didn't provide this — please confirm"
-                placeholder="Select region"
-                searchable
-                data={ETHIOPIAN_REGIONS.map((r) => ({ value: r, label: r }))}
-                error={errors.region?.message}
-                value={field.value || null}
-                onChange={(v) => field.onChange(v ?? "")}
-                onBlur={field.onBlur}
-              />
-            )}
-          />
-        )}
-        <LockedField
-          label="Zone"
-          name="zone"
-          register={register}
-          watch={watch}
-          errors={errors}
-        />
-        <LockedField
-          label="Woreda"
-          name="woreda"
-          register={register}
-          watch={watch}
-          errors={errors}
-        />
-        <LockedField
-          label="Kebele"
-          name="kebele"
-          register={register}
-          watch={watch}
-          errors={errors}
-        />
-        <LockedField
-          label="House No"
-          name="houseNo"
-          register={register}
-          watch={watch}
-          errors={errors}
-        />
+        <ReadOnlyField label="Region" value={watch("region")} />
+        <ReadOnlyField label="Zone" value={watch("zone")} />
+        <ReadOnlyField label="Woreda" value={watch("woreda")} />
+        <ReadOnlyField label="Kebele" value={watch("kebele")} />
+        <ReadOnlyField label="House No" value={watch("houseNo")} />
       </SimpleGrid>
     </Card>
   );
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/LinkCheckboxCard.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/LinkCheckboxCard.tsx
index da0dd6254..d7721d208 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/LinkCheckboxCard.tsx
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/LinkCheckboxCard.tsx
@@ -10,20 +10,27 @@ export function LinkCheckboxCard({
   onToggle,
   title,
   description,
+  disabled = false,
 }: {
   checked: boolean;
   onToggle: (checked: boolean) => void;
   title: string;
   description: string;
+  /** Greys the card out and refuses the toggle — the link is not available yet. */
+  disabled?: boolean;
 }) {
   return (
     <UnstyledButton
-      onClick={() => onToggle(!checked)}
+      onClick={() => !disabled && onToggle(!checked)}
       role="checkbox"
       aria-checked={checked}
-      className={`w-full rounded-lg border! p-3! text-left transition-colors! ${checked
+      aria-disabled={disabled}
+      className={`w-full rounded-lg border! p-3! text-left transition-colors! ${disabled ? "cursor-not-allowed! opacity-60!" : ""
+        } ${checked
           ? "border-[var(--mantine-color-edr-green-6)]! bg-[var(--mantine-color-edr-green-0)]!"
-          : "border-[var(--mantine-color-gray-3)]! hover:border-[var(--mantine-color-edr-green-4)]! hover:bg-[var(--mantine-color-edr-green-0)]!"
+          : disabled
+            ? "border-[var(--mantine-color-gray-3)]!"
+            : "border-[var(--mantine-color-gray-3)]! hover:border-[var(--mantine-color-edr-green-4)]! hover:bg-[var(--mantine-color-edr-green-0)]!"
         }`}
     >
       <Group gap="sm" wrap="nowrap" align="flex-start">
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/SourcedField.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/SourcedField.tsx
new file mode 100644
index 000000000..2a42c424a
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/SourcedField.tsx
@@ -0,0 +1,61 @@
+import { Badge, Group, Stack, Text } from "@mantine/core";
+import type { ReactNode } from "react";
+
+/** Where a locked value came from, shown as a badge next to it. */
+export type FieldSource = "eTrade" | "Fayda";
+
+const SOURCE_NOTE: Record<FieldSource, string> = {
+  eTrade: "From your eTrade licence",
+  Fayda: "From the Fayda verification",
+};
+
+/**
+ * One person-detail field that an outside source may have taken ownership of.
+ *
+ * `source` — not "does a value exist" — decides which side renders. That
+ * distinction is the whole point: `ownerName` holds a value the moment the
+ * customer types it and the step saves, and keying off presence meant the input
+ * they had just filled in turned into a read-only badge as soon as they
+ * navigated away and back, with no way to correct it. Only a real source owns a
+ * field: a Fayda verification (the API refuses to overwrite those) or the
+ * eTrade licence (the record the backoffice checks the company against).
+ *
+ * It pairs with `requiredKeys` in CompanyProfileForm, which requires exactly
+ * the fields that fall through to `children`: **a field is required if and only
+ * if there is an input on screen to satisfy it.**
+ */
+export default function SourcedField({
+  label,
+  value,
+  source,
+  children,
+}: {
+  label: string;
+  /** The value to display when a source owns this field. */
+  value?: string | null;
+  /** The owning source, or null while the field is still the customer's. */
+  source: FieldSource | null;
+  /** The input rendered whenever the field is still the customer's to fill. */
+  children: ReactNode;
+}) {
+  if (!source || !value?.trim()) return <>{children}</>;
+
+  return (
+    <Stack gap={2}>
+      <Group gap="xs" align="center">
+        <Text size="xs" c="dimmed">
+          {label}
+        </Text>
+        <Badge size="xs" variant="light" color="edr-green">
+          {source}
+        </Badge>
+      </Group>
+      <Text className="wrap-break-word" size="sm" c="edr-text" fw={500}>
+        {value}
+      </Text>
+      <Text size="xs" c="edr-muted">
+        {SOURCE_NOTE[source]}
+      </Text>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/helpers.ts b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/helpers.ts
index a1dd1fa7a..623f75e1a 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/helpers.ts
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/helpers.ts
@@ -4,7 +4,13 @@ import type { ProfileResponse, UpdateProfilePayload } from "@/types/profile";
 import type { CompanyIdentityState } from "@/services/verifayda.service";
 import { isValidPhone, toEthiopianE164 } from "@/components/PhoneField";
 
-import { ETRADE_BUNDLE_FIELDS, type CompanyStep, type FormData } from "./schema";
+import type { FieldSource } from "./SourcedField";
+
+import {
+  ETRADE_BUNDLE_FIELDS,
+  type CompanyStep,
+  type FormData,
+} from "./schema";
 
 /**
  * First value that is actually present.
@@ -13,8 +19,9 @@ import { ETRADE_BUNDLE_FIELDS, type CompanyStep, type FormData } from "./schema"
  * is not a value, but it isn't null either, so `??` would stop there and hand
  * the form a blank it has no input to fix.
  */
-export const firstPresent = (...values: (string | null | undefined)[]): string =>
-  values.find((v) => v && v.trim())?.trim() ?? "";
+export const firstPresent = (
+  ...values: (string | null | undefined)[]
+): string => values.find((v) => v && v.trim())?.trim() ?? "";
 
 /**
  * First candidate that is actually a usable phone number, normalized to E.164.
@@ -64,7 +71,6 @@ export function normalizeIdentityPhones(
     ...identity,
     owner: fix(identity.owner),
     poa: fix(identity.poa),
-    gm: fix(identity.gm),
   };
 }
 
@@ -77,6 +83,73 @@ export const samePhone = (a?: string | null, b?: string | null) => {
   return da.length === 9 && da === phoneDigits(b);
 };
 
+/** The owner details an outside source can take ownership of. */
+export type OwnerField = "name" | "email" | "phone";
+
+export interface OwnerSources {
+  /** Which source owns each field, or null where it is still the customer's. */
+  source: Record<OwnerField, FieldSource | null>;
+  /** What to display for an owned field — normalized as the payload will be. */
+  sourced: Record<OwnerField, string>;
+}
+
+/**
+ * Who owns each of the owner's fields, and with what value.
+ *
+ * Two sources can own a field, and they rank. A Fayda verification owns
+ * whatever its claims filled (the API refuses to overwrite those), and the
+ * eTrade licence owns the manager's name and phone: that record is the thing
+ * the backoffice checks the company against, so it is reported, not proposed.
+ * Neither is typeable. Everything left over is the customer's — an editable
+ * input, required precisely because there is an input for it. Fayda outranks
+ * eTrade on the same person: the stronger claim, and the one the API keeps.
+ *
+ * Two things deliberately do NOT take ownership.
+ *
+ * A value merely being present. It exists the moment the customer types one and
+ * the step saves — so a presence test turned the input they had just filled
+ * into a read-only badge on the way back through the wizard, and dropped the
+ * field out of `requiredKeys` at the same time.
+ *
+ * And a value that isn't usable. Both sources hold contact details as free
+ * text: Fayda's phone is whatever the national registry recorded, eTrade's is
+ * whatever was typed at the licence desk ("09        " is a real answer, and it
+ * normalizes to a non-empty, invalid `+2519`). Locking one of those behind a
+ * read-only row leaves the customer told to fix a field with no input, or the
+ * step saved with a value the API rejects. So a source owns an email or a phone
+ * only if what it supplies holds up as one; otherwise the field falls through
+ * to an input and is required like any other. Names have no format to fail, so
+ * presence is the whole test there.
+ */
+export function resolveOwnerSources(
+  identity: CompanyIdentityState | undefined,
+  etradeOwner: { name: string; phone: string } | null,
+): OwnerSources {
+  const verified = identity?.owner.verified ?? false;
+  const faydaName = verified && Boolean(identity?.owner.name?.trim());
+  const faydaEmail = verified ? firstValidEmail(identity?.owner.email) : "";
+  const faydaPhone = verified ? firstValidPhone(identity?.owner.phone) : "";
+  const etradeName = etradeOwner?.name?.trim() ?? "";
+  const etradePhone = firstValidPhone(etradeOwner?.phone);
+
+  const source: Record<OwnerField, FieldSource | null> = {
+    name: faydaName ? "Fayda" : etradeName ? "eTrade" : null,
+    // eTrade never returns an email for the manager, so this one is Fayda's or
+    // it is the customer's to type.
+    email: faydaEmail ? "Fayda" : null,
+    phone: faydaPhone ? "Fayda" : etradePhone ? "eTrade" : null,
+  };
+
+  return {
+    source,
+    sourced: {
+      name: source.name === "Fayda" ? (identity?.owner.name?.trim() ?? "") : etradeName,
+      email: faydaEmail,
+      phone: source.phone === "Fayda" ? faydaPhone : etradePhone,
+    },
+  };
+}
+
 /** 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;
@@ -86,23 +159,20 @@ export function buildPayload(
   _user: AuthUser,
 ): CreateCompanyPayload {
   return {
-    companyName: data.companyName,
-    companyEmail: data.companyEmail,
-    companyPhone: data.companyPhone,
+    companyName: data.companyName ?? "",
     companyAddress: data.companyAddress,
     tin: data.tinNumber,
     vatNumber: data.vatNumber,
     attributes: {
       ownerPassportNumber: data.ownerPassportNumber || undefined,
+      poaPassportNumber: data.poaPassportNumber || undefined,
       contactPersonName: data.contactPersonName,
       contactPersonPosition: data.contactPersonPosition || undefined,
       contactPersonEmail: data.contactPersonEmail || undefined,
       contactPersonPhone: data.contactPersonPhone,
-      generalManagerName: data.generalManagerName,
-      generalManagerEmail: data.generalManagerEmail,
-      generalManagerPhone: data.generalManagerPhone,
-      // The representative's own details are written by their Fayda
-      // verification, so the city is all the form has to send.
+      ownerName: data.ownerName,
+      ownerEmail: data.ownerEmail,
+      ownerPhone: data.ownerPhone,
       poaLocation: data.poaLocation || undefined,
     },
   };
@@ -125,23 +195,35 @@ export function stepPayload(
     case "company": {
       const etrade: Partial<UpdateProfilePayload> = {};
       for (const key of ETRADE_BUNDLE_FIELDS) {
-        if (dirty[key]) (etrade as Record<string, unknown>)[key] = d[key];
+        // Empty is never sent: a field eTrade left blank has no input to fill
+        // it, and "" fails the API's own validation (region's @IsIn, say),
+        // which would 400 a save over data the customer cannot supply.
+        if (dirty[key] && d[key]) (etrade as Record<string, unknown>)[key] = d[key];
       }
       if (dirty.tinNumber) etrade.tin = d.tinNumber;
       return {
-        companyEmail: d.companyEmail,
-        companyPhone: d.companyPhone,
-        companyAddress: d.companyAddress,
+        // Composed from the address parts, so it is only as complete as they
+        // are. Sending it while they are still empty (the lookup hasn't landed,
+        // or eTrade left them blank) would overwrite a stored address with a
+        // degraded version of itself — an absent key means "untouched".
+        ...(d.companyAddress?.trim()
+          ? { companyAddress: d.companyAddress }
+          : {}),
         vatNumber: d.vatNumber,
-        ownerPassportNumber: d.ownerPassportNumber || undefined,
         ...etrade,
       };
     }
-    case "personnel":
+    case "owner":
+      // `|| undefined`, never "": the DTO's `@IsOptional()` only skips null and
+      // undefined, so an empty string is validated and 400s with
+      // "ownerEmail must be an email". A field the eTrade lookup or the Fayda
+      // claim already filled is legitimately blank in the form — it has no
+      // input — so sending "" would fail a step with nothing on screen to fix.
       return {
-        generalManagerName: d.generalManagerName,
-        generalManagerEmail: d.generalManagerEmail,
-        generalManagerPhone: d.generalManagerPhone,
+        ownerName: d.ownerName || undefined,
+        ownerEmail: d.ownerEmail || undefined,
+        ownerPhone: d.ownerPhone || undefined,
+        ownerPassportNumber: d.ownerPassportNumber || undefined,
       };
     case "contact":
       return {
@@ -150,12 +232,16 @@ export function stepPayload(
         contactPersonEmail: d.contactPersonEmail || undefined,
         contactPersonPhone: d.contactPersonPhone,
       };
-    case "poa":
+    case "representation":
       return {
         poaName: d.poaName || undefined,
         poaEmail: d.poaEmail || undefined,
         poaPhone: d.poaPhone || undefined,
         poaLocation: d.poaLocation || undefined,
+        poaPassportNumber: d.poaPassportNumber || undefined,
+        // The step renders one passport input, for whichever person the
+        // declaration made the identity subject — so it has to save both.
+        ownerPassportNumber: d.ownerPassportNumber || undefined,
       };
     default:
       return {};
@@ -168,13 +254,12 @@ export function toFormValues(p: ProfileResponse): FormData {
   const tin = p.tinNumber && !p.tinNumber.startsWith("D") ? p.tinNumber : "";
   return {
     companyName: p.companyName ?? "",
-    companyEmail: p.companyEmail ?? "",
-    companyPhone: p.companyPhone ?? "",
     companyAddress: p.companyAddress ?? "",
     etradePhone: p.etradePhone ?? "",
     tinNumber: tin,
     vatNumber: p.vatNumber ?? "",
     ownerPassportNumber: p.identity?.owner.passportNumber ?? "",
+    poaPassportNumber: p.identity?.poa.passportNumber ?? "",
     licenceNumber: p.licenceNumber ?? "",
     statusDescription: p.statusDescription ?? "",
     dateRegistered: p.dateRegistered ?? "",
@@ -190,12 +275,11 @@ export function toFormValues(p: ProfileResponse): FormData {
     contactPersonPosition: p.contactPersonPosition ?? "",
     contactPersonEmail: p.contactPersonEmail ?? "",
     contactPersonPhone: p.contactPersonPhone ?? "",
-    generalManagerName: p.generalManagerName ?? "",
-    generalManagerEmail: p.generalManagerEmail ?? "",
-    generalManagerPhone: p.generalManagerPhone ?? "",
+    ownerName: p.ownerName ?? "",
+    ownerEmail: p.ownerEmail ?? "",
+    ownerPhone: p.ownerPhone ?? "",
     poaName: p.poaName ?? "",
     poaPhone: p.poaPhone ?? "",
-    poaAddress: p.poaAddress ?? "",
     poaEmail: p.poaEmail ?? "",
     poaLocation: p.poaLocation ?? "",
   };
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.test.ts b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.test.ts
index a6f9862c8..cd957eec7 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.test.ts
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.test.ts
@@ -1,11 +1,12 @@
 import { describe, expect, it } from "vitest";
 
-import { onboardingSchema, stepFields } from "./schema";
+import { buildOnboardingSchema, onboardingSchema, stepFields } from "./schema";
 import {
   firstPresent,
   firstValidEmail,
   firstValidPhone,
   normalizeIdentityPhones,
+  resolveOwnerSources,
   stepPayload,
 } from "./helpers";
 import type { FormData } from "./schema";
@@ -15,8 +16,6 @@ import type { CompanyIdentityState } from "@/services/verifayda.service";
 const values = (over: Partial<FormData> = {}): FormData =>
   ({
     companyName: "Acme PLC",
-    companyEmail: "acme@example.com",
-    companyPhone: "+251911223344",
     companyAddress: "1, Bole, Bole, Addis Ababa",
     etradePhone: "+251911223344",
     tinNumber: "0012345678",
@@ -37,9 +36,9 @@ const values = (over: Partial<FormData> = {}): FormData =>
     contactPersonPosition: "",
     contactPersonEmail: "",
     contactPersonPhone: "+251911223344",
-    generalManagerName: "",
-    generalManagerEmail: "",
-    generalManagerPhone: "",
+    ownerName: "",
+    ownerEmail: "",
+    ownerPhone: "",
     poaName: "",
     poaPhone: "",
     poaAddress: "",
@@ -56,16 +55,28 @@ const errorFor = (data: FormData, field: keyof FormData) => {
 
 describe("VAT number", () => {
   it("accepts exactly ten digits", () => {
-    expect(errorFor(values({ vatNumber: "0012345678" }), "vatNumber")).toBeUndefined();
+    expect(
+      errorFor(values({ vatNumber: "0012345678" }), "vatNumber"),
+    ).toBeUndefined();
   });
 
-  // `.length(10)` used to pass this, so a ten-letter string reached the API.
-  it("rejects ten non-digits", () => {
-    expect(errorFor(values({ vatNumber: "ABCDEFGHIJ" }), "vatNumber")).toBe(
-      "VAT number must be exactly 10 digits",
-    );
+  it("accepts eleven digits", () => {
+    expect(
+      errorFor(values({ vatNumber: "00123456789" }), "vatNumber"),
+    ).toBeUndefined();
   });
 
+  // No shape rule any more: a foreign tax authority's VAT number carries
+  // letters and dashes, and a co-operative union's registration numbering
+  // follows the trade-licence pattern not at all. Length and alphabet are not
+  // ours to police — only presence is.
+  it.each(["001234567890", "GB123456789", "ET-2024/0091"])(
+    "accepts %s",
+    (vat) => {
+      expect(errorFor(values({ vatNumber: vat }), "vatNumber")).toBeUndefined();
+    },
+  );
+
   it("rejects blank", () => {
     expect(errorFor(values({ vatNumber: "" }), "vatNumber")).toBe(
       "VAT number is required",
@@ -73,11 +84,18 @@ describe("VAT number", () => {
   });
 });
 
-describe("region", () => {
-  it("rejects a spelling outside the catalog", () => {
-    expect(errorFor(values({ region: "Addis Abeba City" }), "region")).toBe(
-      "Region is required",
-    );
+describe("eTrade-sourced fields", () => {
+  // They are rendered read-only — there is no input to correct one in — so the
+  // schema must never reject what eTrade supplied (or failed to supply).
+  it.each([
+    "companyName",
+    "region",
+    "zone",
+    "woreda",
+    "kebele",
+    "houseNo",
+  ] as const)("accepts a blank %s", (field) => {
+    expect(errorFor(values({ [field]: "" }), field)).toBeUndefined();
   });
 });
 
@@ -85,23 +103,135 @@ describe("stepFields", () => {
   // The regression this whole change exists to prevent: a step must not gate on
   // a field it renders no input for, or Continue fails with the error attached
   // to nothing on screen.
-  it("never gates the company step on a derived or read-only field", () => {
-    const unreachable = [
-      "companyEmail",
-      "companyPhone",
-      "companyAddress",
-      "etradePhone",
-      "licenceNumber",
-      "statusDescription",
-      "dateRegistered",
-      "renewedFrom",
-      "renewalDate",
-      "renewedTo",
-    ];
+  //
+  // Listing a field on a step is no longer the gate — `requiredKeys` is. The
+  // registration fields appear on the company step because a co-operative union
+  // or farm types them, and a licensed company gets them read-only from eTrade;
+  // the base schema must accept them blank either way.
+  it("never gates the company step on a field with no input", () => {
+    const derived = ["etradePhone", "licenceNumber", "statusDescription"];
+    expect(stepFields.company.filter((f) => derived.includes(f))).toEqual([]);
+  });
+
+  it("leaves the registration fields optional in the base schema", () => {
+    for (const field of ["companyName", "region", "zone", "woreda", "kebele"] as const) {
+      expect(errorFor(values({ [field]: "" }), field)).toBeUndefined();
+    }
+  });
+
+  it("requires the registration fields once a co-operative types them", () => {
+    const parsed = buildOnboardingSchema([
+      "companyName",
+      "region",
+      "zone",
+      "woreda",
+      "kebele",
+    ]).safeParse(
+      values({ companyName: "", region: "", zone: "", woreda: "", kebele: "" }),
+    );
+    expect(parsed.success).toBe(false);
+    const paths = parsed.success
+      ? []
+      : parsed.error.issues.map((i) => String(i.path[0]));
+    expect(paths).toEqual(
+      expect.arrayContaining([
+        "companyName",
+        "region",
+        "zone",
+        "woreda",
+        "kebele",
+      ]),
+    );
+  });
+});
+
+describe("the identity subject's passport", () => {
+  // The representation step renders ONE passport input, for whoever the
+  // power-of-attorney answer made the identity subject. When the answer is "no
+  // PoA" that is the owner — so the owner's passport number is typed on the
+  // representation step and has to be carried by it. It used to belong to the
+  // owner step alone, which is already behind the customer by then: the number
+  // was typed, dropped, and the final submit failed `assertIdentityVerified`
+  // naming a field they could see was filled in.
+  it("is carried by the step that renders the input", () => {
+    expect(stepFields.representation).toContain("ownerPassportNumber");
+    expect(stepFields.representation).toContain("poaPassportNumber");
+  });
+
+  it("saves the owner's passport from the representation step", () => {
+    const payload = stepPayload(
+      "representation",
+      values({ ownerPassportNumber: "P1234567" }),
+    );
+    expect(payload.ownerPassportNumber).toBe("P1234567");
+  });
+
+  it("still omits it when there is none, rather than sending an empty string", () => {
+    const payload = stepPayload(
+      "representation",
+      values({ ownerPassportNumber: "" }),
+    );
+    expect(payload.ownerPassportNumber).toBeUndefined();
+  });
+});
+
+describe("stepPayload (representation)", () => {
+  // `poaAddress` is a Fayda-owned claim (`IDENTITY_OWNED_FIELDS` server-side).
+  // The portal states `poaLocation` instead and must never send the other.
+  it("sends the company's stated location, never the Fayda address", () => {
+    const payload = stepPayload(
+      "representation",
+      values({ poaLocation: "Dire Dawa, Ethiopia" }),
+    );
+    expect(payload.poaLocation).toBe("Dire Dawa, Ethiopia");
+    expect("poaAddress" in payload).toBe(false);
+  });
+});
+
+describe("buildOnboardingSchema (conditionally required fields)", () => {
+  const issuesFor = (
+    data: FormData,
+    required: (keyof FormData)[],
+  ): (keyof FormData)[] => {
+    const parsed = buildOnboardingSchema(required).safeParse(data);
+    return parsed.success
+      ? []
+      : (parsed.error.issues.map((i) => i.path[0]) as (keyof FormData)[]);
+  };
+
+  // eTrade returns no email and Fayda's email/phone claims are optional: the
+  // step renders an input for what no source supplied, and requires exactly
+  // those. Nothing else — a field with no input on screen must never fail
+  // Continue.
+  it("requires only the keys it is handed", () => {
+    const issues = issuesFor(values(), ["ownerEmail", "ownerPhone"]);
+    expect(issues).toEqual(["ownerEmail", "ownerPhone"]);
+  });
+
+  it("passes once those keys are filled", () => {
     expect(
-      stepFields.company.filter((f) => unreachable.includes(f)),
+      issuesFor(
+        values({
+          ownerEmail: "owner@example.com",
+          ownerPhone: "+251911223344",
+        }),
+        ["ownerEmail", "ownerPhone"],
+      ),
     ).toEqual([]);
   });
+
+  it("leaves the same blank fields alone when nothing is required", () => {
+    expect(issuesFor(values(), [])).toEqual([]);
+  });
+
+  it("names the field in the message, so it reads under its own input", () => {
+    const parsed = buildOnboardingSchema(["poaEmail"]).safeParse(values());
+    expect(parsed.success).toBe(false);
+    if (parsed.success) return;
+    expect(parsed.error.issues[0]?.message).toBe(
+      "Representative's email is required",
+    );
+  });
 });
 
 describe("stepPayload (company)", () => {
@@ -124,6 +254,44 @@ describe("stepPayload (company)", () => {
     // Still only the dirty ones.
     expect(payload.licenceNumber).toBeUndefined();
   });
+
+  // The address is composed from the parts, so it is only ever as complete as
+  // they are. An absent key means "untouched" to the API; sending a blank one
+  // would replace a stored address with nothing.
+  it("omits a blank composed address rather than clearing the stored one", () => {
+    const payload = stepPayload("company", values({ companyAddress: "" }), {});
+    expect("companyAddress" in payload).toBe(false);
+  });
+});
+
+describe("stepPayload (owner)", () => {
+  // A Fayda claim owns whatever it supplied, so the form holds "" for those.
+  // `@IsOptional()` on the DTO skips only null/undefined, so an empty string is
+  // validated and comes back as "ownerEmail must be an email" — on a step that
+  // renders no input for it.
+  it("omits blank owner fields instead of sending empty strings", () => {
+    const payload = stepPayload(
+      "owner",
+      values({ ownerName: "", ownerEmail: "", ownerPhone: "" }),
+    );
+    expect(payload.ownerName).toBeUndefined();
+    expect(payload.ownerEmail).toBeUndefined();
+    expect(payload.ownerPhone).toBeUndefined();
+  });
+
+  it("sends the owner details the customer typed or eTrade prefilled", () => {
+    const payload = stepPayload(
+      "owner",
+      values({
+        ownerName: "Abebe Bikila",
+        ownerEmail: "owner@example.com",
+        ownerPhone: "+251911223344",
+      }),
+    );
+    expect(payload.ownerName).toBe("Abebe Bikila");
+    expect(payload.ownerEmail).toBe("owner@example.com");
+    expect(payload.ownerPhone).toBe("+251911223344");
+  });
 });
 
 describe("firstPresent", () => {
@@ -140,7 +308,9 @@ describe("firstValidPhone", () => {
   // "+2519", which is non-empty — so a presence check took it, put it in a field
   // with no input, and the API rejected the whole step.
   it("skips an eTrade number that cannot make a valid E.164", () => {
-    expect(firstValidPhone("09        ", "+251911223344")).toBe("+251911223344");
+    expect(firstValidPhone("09        ", "+251911223344")).toBe(
+      "+251911223344",
+    );
   });
 
   it("normalizes a local number it can use", () => {
@@ -160,21 +330,141 @@ describe("firstValidEmail", () => {
   });
 });
 
+describe("resolveOwnerSources", () => {
+  const identity = (over: {
+    verified?: boolean;
+    name?: string | null;
+    email?: string | null;
+    phone?: string | null;
+  }): CompanyIdentityState =>
+    ({
+      passportAccepted: false,
+      poaDeclared: "no",
+      subject: "owner",
+      owner: {
+        verified: over.verified ?? true,
+        name: over.name ?? null,
+        email: over.email ?? null,
+        phone: over.phone ?? null,
+        address: null,
+        verifiedAt: null,
+        passportNumber: null,
+      },
+      poa: {
+        verified: false,
+        name: null,
+        email: null,
+        phone: null,
+        address: null,
+        verifiedAt: null,
+        passportNumber: null,
+      },
+      identityProven: false,
+      etradeManagerName: null,
+      etradeManagerPhone: null,
+      ownerMatchesEtrade: null,
+      complete: false,
+    }) as CompanyIdentityState;
+
+  it("locks what each source supplied, Fayda outranking eTrade", () => {
+    const { source, sourced } = resolveOwnerSources(
+      identity({
+        name: "Abebe Bikila",
+        email: "owner@example.com",
+        phone: "+251911223344",
+      }),
+      { name: "A. Bikila", phone: "+251911999888" },
+    );
+    expect(source).toEqual({ name: "Fayda", email: "Fayda", phone: "Fayda" });
+    expect(sourced.phone).toBe("+251911223344");
+  });
+
+  // The point of the whole exercise: a field is read-only only if what the
+  // source gave can actually be submitted. Otherwise the customer is shown a
+  // badge holding a value the API will reject, with no input to fix it.
+  it("falls back to an input when Fayda's phone claim is unusable", () => {
+    const { source, sourced } = resolveOwnerSources(
+      identity({ name: "Abebe Bikila", phone: "09        " }),
+      null,
+    );
+    expect(source.phone).toBeNull();
+    expect(sourced.phone).toBe("");
+  });
+
+  it("falls back to an input when Fayda's email claim is malformed", () => {
+    const { source } = resolveOwnerSources(
+      identity({ name: "Abebe Bikila", email: "not-an-email" }),
+      null,
+    );
+    expect(source.email).toBeNull();
+  });
+
+  it("falls back to an input when eTrade's manager phone is unusable", () => {
+    const { source, sourced } = resolveOwnerSources(undefined, {
+      name: "Abebe Bikila",
+      phone: "09        ",
+    });
+    // The name is still eTrade's — names have no format to fail.
+    expect(source.name).toBe("eTrade");
+    expect(source.phone).toBeNull();
+    expect(sourced.phone).toBe("");
+  });
+
+  it("takes eTrade's phone where Fayda has none, normalized", () => {
+    const { source, sourced } = resolveOwnerSources(
+      identity({ verified: false }),
+      { name: "Abebe Bikila", phone: "0911223344" },
+    );
+    expect(source.phone).toBe("eTrade");
+    expect(sourced.phone).toBe("+251911223344");
+  });
+
+  it("owns nothing when the verification never happened", () => {
+    const { source } = resolveOwnerSources(
+      identity({
+        verified: false,
+        name: "Abebe Bikila",
+        email: "owner@example.com",
+        phone: "+251911223344",
+      }),
+      null,
+    );
+    expect(source).toEqual({ name: null, email: null, phone: null });
+  });
+});
+
 describe("normalizeIdentityPhones", () => {
   it("converts a local Fayda phone claim to E.164", () => {
     const identity = {
-      faydaRequired: true,
-      passportRequired: false,
-      owner: { verified: true, name: "A", phone: "0911223344", email: null, address: null, verifiedAt: null, passportNumber: null },
-      poa: { verified: false, name: null, phone: null, email: null, address: null, verifiedAt: null },
-      gm: { verified: false, name: null, phone: "251911223344", email: null, address: null, verifiedAt: null },
-      gmSameAsOwner: false,
-      complete: false,
+      passportAccepted: false,
+      poaDeclared: "yes",
+      subject: "poa",
+      owner: {
+        verified: false,
+        name: "A",
+        phone: "0911223344",
+        email: null,
+        address: null,
+        verifiedAt: null,
+        passportNumber: null,
+      },
+      poa: {
+        verified: true,
+        name: "B",
+        phone: "251911223344",
+        email: null,
+        address: null,
+        verifiedAt: null,
+        passportNumber: null,
+      },
+      identityProven: true,
+      etradeManagerName: null,
+      ownerMatchesEtrade: null,
+      complete: true,
     } as CompanyIdentityState;
 
     const fixed = normalizeIdentityPhones(identity)!;
     expect(fixed.owner.phone).toBe("+251911223344");
-    expect(fixed.gm.phone).toBe("+251911223344");
-    expect(fixed.poa.phone).toBeNull();
+    expect(fixed.poa.phone).toBe("+251911223344");
   });
 });
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.ts b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.ts
index 3133ddef0..b274761b0 100644
--- a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.ts
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/schema.ts
@@ -1,23 +1,19 @@
 import { z } from "zod";
-import { ETHIOPIAN_REGIONS } from "@edr/types";
+
 
 import { isValidPhone } from "@/components/PhoneField";
 
 export type CompanyStep =
   | "company"
-  | "personnel"
+  | "owner"
+  | "representation"
   | "contact"
-  | "poa"
   | "documents"
   | "additional";
 
 export const onboardingSchema = z.object({
-  companyName: z.string().min(1, "Company name is required"),
-  companyEmail: z.string().email("Invalid email address"),
-  companyPhone: z
-    .string()
-    .min(1, "Company phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
+  // eTrade-sourced, and never typeable — see the address block below.
+  companyName: z.string().optional(),
   // Derived from the eTrade address parts (kebele/woreda/zone/region); no
   // standalone input — the granular fields live in the registration section.
   companyAddress: z.string().optional(),
@@ -26,39 +22,38 @@ export const onboardingSchema = z.object({
   // can diverge without the backend's eTrade-authenticity check misfiring.
   etradePhone: z.string().optional(),
   tinNumber: z.string().regex(/^\d{10}$/, "TIN must be exactly 10 digits"),
-  // `.length(10)` alone accepted "ABCDEFGHIJ" — the check has to be on digits.
-  vatNumber: z
-    .string()
-    .min(1, "VAT number is required")
-    .regex(/^\d{10}$/, "VAT number must be exactly 10 digits"),
-  // The owner's passport number — the foreign-company identity credential
-  // (Fayda is an Ethiopian national ID). Required only for a foreign company;
-  // enforced in buildOnboardingSchema since that depends on `nationality`.
+  // Required, but no shape check. Ethiopian VAT numbers are usually 10 or 11
+  // digits; a foreign company's is whatever its own tax authority issues, and a
+  // co-operative's registration numbering follows neither. A format rule here
+  // only ever rejected valid numbers we had no business judging.
+  vatNumber: z.string().min(1, "VAT number is required"),
+  // Passport numbers — the alternative identity credential for a foreign
+  // company (Fayda is an Ethiopian national ID). Only the one belonging to the
+  // declared identity subject is ever asked for, and only when that person has
+  // not verified with Fayda — so requiredness is decided per render and lives
+  // in `requiredKeys`, not here.
   ownerPassportNumber: z.string().optional(),
+  poaPassportNumber: z.string().optional(),
   licenceNumber: z.string().optional(),
   statusDescription: z.string().optional(),
   dateRegistered: z.string().optional(),
   renewedFrom: z.string().optional(),
   renewalDate: z.string().optional(),
   renewedTo: z.string().optional(),
-  // Address fields are user-entered and required (the registration/license
-  // fields above are read-only confirmations pulled from eTrade).
-  // Region is a closed set; zone/woreda/kebele stay free text until the platform
-  // has an authoritative dataset of Ethiopian zones/woredas/kebeles.
+  // The registered address normally comes from eTrade and nowhere else — the
+  // form renders these read-only, so requiring them would be a Continue button
+  // that fails on a field with no input to fix it. A gap in eTrade's own data
+  // stays a gap rather than becoming a customer-typed claim wearing eTrade's
+  // badge.
   //
-  // Deliberately `.refine` over `z.enum`: the form needs "" as its unselected
-  // sentinel (default value, and legacy rows whose region isn't in the list). A
-  // literal union makes "" untypable, which also splits the resolver's
-  // input/output types and breaks useForm's inference for every other field.
-  region: z
-    .string()
-    .refine((v) => (ETHIOPIAN_REGIONS as readonly string[]).includes(v), {
-      message: "Region is required",
-    }),
-  zone: z.string().min(1, "Zone is required"),
-  woreda: z.string().min(1, "Woreda is required"),
-  kebele: z.string().min(1, "Kebele is required"),
-  houseNo: z.string().min(1, "House number is required"),
+  // A co-operative is the exception: it has no business licence, so there is no
+  // eTrade record at all and these ARE typed. Requiredness follows the same
+  // invariant as everywhere else — it is decided per render, in `requiredKeys`.
+  region: z.string().optional(),
+  zone: z.string().optional(),
+  woreda: z.string().optional(),
+  kebele: z.string().optional(),
+  houseNo: z.string().optional(),
   contactPersonName: z.string().min(1, "Contact person name is required"),
   contactPersonPosition: z.string().optional(),
   contactPersonEmail: z
@@ -70,21 +65,23 @@ export const onboardingSchema = z.object({
     .string()
     .min(1, "Contact person phone is required")
     .refine(isValidPhone, "Enter a valid phone number"),
-  // Optional here, not unrequired: the GM is now established by Fayda — either
-  // verified in their own right or declared the same person as the owner — so
-  // for an Ethiopian company these fields are never typed and would fail a
-  // blanket `min(1)`. Presence is gated per nationality in the step's own
-  // check, where the identity state is available; zod only polices format for
-  // the foreign companies that still type them.
-  generalManagerName: z.string().optional(),
-  generalManagerEmail: z
+  // The owner — whoever the eTrade licence names as the business's manager.
+  //
+  // Optional here, not unrequired: the eTrade lookup fills the name and phone,
+  // and a Fayda verification can fill all three, so on a well-supplied company
+  // none of them is typed and a blanket `min(1)` would fail a step with no
+  // input on screen. What IS required is decided per render — a field is
+  // required exactly when the step renders an input for it (`requiredKeys`).
+  // zod only polices format here.
+  ownerName: z.string().optional(),
+  ownerEmail: z
     .string()
     .optional()
     .refine(
       (v) => !v || z.string().email().safeParse(v).success,
-      "Invalid Manager email",
+      "Invalid owner email",
     ),
-  generalManagerPhone: z
+  ownerPhone: z
     .string()
     .optional()
     .refine((v) => !v || isValidPhone(v), "Enter a valid phone number"),
@@ -93,7 +90,6 @@ export const onboardingSchema = z.object({
     .string()
     .optional()
     .refine((v) => !v || isValidPhone(v), "Enter a valid phone number"),
-  poaAddress: z.string().optional(),
   poaEmail: z
     .string()
     .optional()
@@ -101,6 +97,10 @@ export const onboardingSchema = z.object({
       (v) => !v || z.string().email().safeParse(v).success,
       "Invalid email address",
     ),
+  // Where the representative is based, as the company states it. Deliberately
+  // NOT `poaAddress`: that one is a Fayda-owned claim (`IDENTITY_OWNED_FIELDS`)
+  // the verification writes and the portal must never send — the two used to
+  // sit side by side here, with the Fayda address silently hiding this input.
   poaLocation: z.string().optional(),
 });
 
@@ -109,27 +109,53 @@ export type FormData = z.infer<typeof onboardingSchema>;
 /** fileKey of the delegation letter uploaded on the Power of Attorney step. */
 export const POA_DELEGATION_FILE_KEY = "poa_delegation_letter";
 
+/**
+ * Labels for the fields a Fayda verification may or may not have supplied. Which
+ * of them are mandatory is decided per render (see `requiredKeys` below), so the
+ * message has to be built here rather than attached to the base schema.
+ */
+const CONDITIONAL_LABELS: Partial<Record<keyof FormData, string>> = {
+  // Typed only by a co-operative — every other company gets these from eTrade.
+  companyName: "Company name",
+  region: "Region",
+  zone: "Zone",
+  woreda: "Woreda",
+  kebele: "Kebele",
+  poaName: "Representative's name",
+  poaEmail: "Representative's email",
+  poaPhone: "Representative's phone",
+  poaPassportNumber: "Representative's passport number",
+  ownerName: "Owner's name",
+  ownerEmail: "Owner's email",
+  ownerPhone: "Owner's phone",
+  ownerPassportNumber: "Owner's passport number",
+};
 
 /**
- * The PoA's identifying fields are never typed — they come from the Fayda
- * verification, whatever the company's nationality — so nothing here requires
- * them. A freight forwarder's mandatory PoA is gated on the verification
- * itself, and its delegation letter alongside it, both in CompanyProfileForm
- * (files live outside form state).
+ * The owner's and the representative's identifying fields arrive from three
+ * places — the eTrade lookup, a Fayda verification, or the customer typing them
+ * — and which one supplies what varies per company. eTrade returns no email at
+ * all; Fayda's email and phone claims are optional and routinely come back
+ * empty. So nothing in the base schema requires them, and the steps render an
+ * input for whatever no source supplied.
  *
- * That leaves the owner's passport number as the only conditional field.
+ * `requiredKeys` is that decision, made by CompanyProfileForm from the same
+ * state that drives the rendering: **a field is required iff an input exists
+ * for it**. Passing it in (rather than deriving it here) is what keeps the two
+ * from drifting into a Continue button that fails on a field nobody can see.
  */
 export function buildOnboardingSchema(
-  /** True for a foreign company: the owner's passport number is mandatory. */
-  passportRequired = false,
+  /** Fields the current step renders an input for and must not leave blank. */
+  requiredKeys: readonly (keyof FormData)[] = [],
 ) {
-  if (!passportRequired) return onboardingSchema;
+  if (requiredKeys.length === 0) return onboardingSchema;
   return onboardingSchema.superRefine((d, ctx) => {
-    if (!d.ownerPassportNumber?.trim()) {
+    for (const key of requiredKeys) {
+      if (d[key]?.trim()) continue;
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["ownerPassportNumber"],
-        message: "The owner's passport number is required",
+        code: "custom",
+        path: [key],
+        message: `${CONDITIONAL_LABELS[key] ?? key} is required`,
       });
     }
   });
@@ -171,33 +197,46 @@ export const ETRADE_BUNDLE_FIELDS = [
  * (`REQUIRED_COMPANY_INFO`), and reports it with a message.
  */
 export const stepFields: Record<CompanyStep, (keyof FormData)[]> = {
+  // Only what this step actually renders an input for. The company name and the
+  // registered address are eTrade's, shown read-only — except for a
+  // co-operative, which types them (added per render via `requiredKeys`).
   company: [
-    "companyName",
     "tinNumber",
     "vatNumber",
-    "ownerPassportNumber",
+    "companyName",
     "region",
     "zone",
     "woreda",
     "kebele",
     "houseNo",
   ],
-  personnel: [
-    "generalManagerName",
-    "generalManagerEmail",
-    "generalManagerPhone",
-  ],
+  // `REQUIRED_COMPANY_INFO` demands all three server-side, so the step offers
+  // an input wherever eTrade and Fayda between them left a gap.
+  owner: ["ownerName", "ownerEmail", "ownerPhone", "ownerPassportNumber"],
   contact: [
     "contactPersonName",
     "contactPersonPosition",
     "contactPersonEmail",
     "contactPersonPhone",
   ],
-  // The API requires poaName/poaEmail/poaPhone from a freight forwarder
-  // (`REQUIRED_POA_FIELDS`), so the step has to offer them wherever the
-  // representative isn't proven by Fayda — otherwise the save is rejected
-  // naming fields the form never rendered.
-  poa: ["poaName", "poaEmail", "poaPhone", "poaLocation"],
+  // The API requires poaName/poaEmail/poaPhone once a representative is
+  // declared (`REQUIRED_POA_FIELDS`), so the step has to offer them wherever
+  // Fayda didn't supply them — otherwise the save is rejected naming fields the
+  // form never rendered.
+  // `ownerPassportNumber` belongs here as much as the PoA's: the step renders
+  // whichever passport input the declaration calls for, and when the answer is
+  // "no PoA" that is the owner's. Leaving it out meant the number was typed on
+  // this step, validated by nothing, and dropped by `stepPayload` — so the
+  // final submit failed `assertIdentityVerified` over a field two steps back
+  // that the customer could see was filled in.
+  representation: [
+    "poaName",
+    "poaEmail",
+    "poaPhone",
+    "poaLocation",
+    "poaPassportNumber",
+    "ownerPassportNumber",
+  ],
   documents: [],
   additional: [],
 };
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/CompanyInfoStep.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/CompanyInfoStep.tsx
new file mode 100644
index 000000000..52893ec59
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/CompanyInfoStep.tsx
@@ -0,0 +1,200 @@
+import { Select, SimpleGrid, Stack, Text, TextInput } from "@mantine/core";
+import type { UseFormReturn } from "react-hook-form";
+
+import { ETHIOPIAN_REGIONS, type CompanyRegistrationData } from "@edr/types";
+import ETradeInfo, {
+  type ETradeStatus,
+} from "@/components/onboarding/ETradeInfo";
+
+import type { FormData } from "../schema";
+import ETradeCompanyCard from "../ETradeCompanyCard";
+import StepSection from "../StepSection";
+
+export interface CompanyInfoStepProps {
+  form: UseFormReturn<FormData>;
+  tinStatus: ETradeStatus;
+  tinVerified: boolean;
+  /** Registration fields are already populated (a lookup passed, now or earlier). */
+  hasRegistrationDetails: boolean;
+  /**
+   * eTrade holds no record for this company's TIN, so the registration is typed
+   * here rather than fetched. True for a co-operative union or farm (no
+   * business licence) and for a foreign investor (licensed by the Investment
+   * Commission, not the trade registry).
+   */
+  manualRegistration?: boolean;
+  /** Which of the two it is — wording only; the behaviour is the same. */
+  cooperative?: boolean;
+  onETradeDataLoaded: (data: CompanyRegistrationData) => void;
+  onETradeStatusChange: (status: ETradeStatus) => void;
+  onETradeReset: () => void;
+}
+
+export default function CompanyInfoStep({
+  form,
+  tinStatus,
+  tinVerified,
+  hasRegistrationDetails,
+  manualRegistration = false,
+  cooperative = false,
+  onETradeDataLoaded,
+  onETradeStatusChange,
+  onETradeReset,
+}: CompanyInfoStepProps) {
+  const {
+    register,
+    watch,
+    setValue,
+    formState: { errors },
+  } = form;
+
+  const region = watch("region") ?? "";
+
+  return (
+    <Stack gap="xl">
+      <StepSection
+        index={1}
+        title="VAT number"
+        status={watch("vatNumber")?.trim() && !errors.vatNumber ? "done" : "todo"}
+      >
+        <TextInput
+          aria-label="VAT Number"
+          placeholder="0012345678"
+          error={errors.vatNumber?.message}
+          {...register("vatNumber")}
+        />
+      </StepSection>
+
+      {/* The TIN lookup runs for everyone, co-operative included. A co-op has
+          no trade licence, but plenty of them are on eTrade all the same — and
+          when the record is there it is better data than anything typed, so we
+          ask for it first and fall back to the form below rather than deciding
+          in advance that nothing will be found. What differs for a co-op is
+          only the consequence of finding nothing: expected, not an error. */}
+      <StepSection
+        index={2}
+        title="Company TIN"
+        subtitle={
+          !manualRegistration
+            ? "We'll pull your registration straight from eTrade — nothing to type by hand once it's found."
+            : cooperative
+              ? "We'll check eTrade for your TIN. Co-operatives often aren't listed — if yours isn't, you'll fill the details in below."
+              : "We'll check eTrade for your TIN. An investment licence usually isn't on it — if yours isn't, you'll fill the details in below."
+        }
+        status={
+          tinStatus === "taken"
+            ? "blocked"
+            : manualRegistration
+              ? watch("tinNumber")?.trim() && !errors.tinNumber
+                ? "done"
+                : "todo"
+              : tinVerified
+                ? "done"
+                : "todo"
+        }
+      >
+        <ETradeInfo
+          tin={watch("tinNumber")}
+          register={register("tinNumber")}
+          error={errors.tinNumber?.message}
+          onDataLoaded={onETradeDataLoaded}
+          onStatusChange={onETradeStatusChange}
+          onReset={onETradeReset}
+          alreadyVerified={hasRegistrationDetails}
+          selectedLicenceNumber={watch("licenceNumber")}
+          registrationOptional={manualRegistration}
+        />
+        {!manualRegistration && tinVerified && (
+          <ETradeCompanyCard tin={watch("tinNumber")} watch={watch} />
+        )}
+      </StepSection>
+
+      {/* A company eTrade cannot answer for keeps its typed registration
+          section either way. When the lookup did find something these arrive
+          prefilled — still editable, because here they are the customer's own
+          statement rather than the licence's, and the API takes them as given
+          (`applyEtradeSourcedFields` skips both cases entirely). */}
+      {manualRegistration && (
+        <StepSection
+          index={3}
+          title="Registration details"
+          subtitle={
+            hasRegistrationDetails
+              ? "From eTrade. Correct anything that doesn't look right — these are yours to state."
+              : "Everything we'd normally read off an eTrade licence. We need it from you instead. Our team checks it against the papers you upload."
+          }
+          status={
+            watch("companyName")?.trim() && watch("region")?.trim()
+              ? "done"
+              : "todo"
+          }
+        >
+          <Stack gap="md">
+            <TextInput
+              label="Company Name"
+              placeholder={
+                cooperative
+                  ? "Registered name of the union or farm"
+                  : "Name on your investment licence"
+              }
+              error={errors.companyName?.message}
+              {...register("companyName")}
+            />
+            <Text size="sm" c="edr-muted">
+              Registered address
+            </Text>
+            <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+              <Select
+                label="Region"
+                placeholder="Select region"
+                // eTrade's own spelling may not be one of ours. Carrying it in
+                // as an option keeps the lookup's answer visible instead of
+                // silently blanking the field it just filled.
+                data={
+                  region &&
+                    !(ETHIOPIAN_REGIONS as readonly string[]).includes(region)
+                    ? [...ETHIOPIAN_REGIONS, region]
+                    : [...ETHIOPIAN_REGIONS]
+                }
+                searchable
+                value={region || null}
+                onChange={(v) =>
+                  // shouldDirty, or the pick never reaches the API: `region` is
+                  // an eTrade-bundle key, and `stepPayload` sends those only
+                  // when the customer changed them this session. Without it a
+                  // co-operative or foreign investor typed its address and the
+                  // region alone silently vanished on save.
+                  setValue("region", v ?? "", {
+                    shouldValidate: true,
+                    shouldDirty: true,
+                  })
+                }
+                error={errors.region?.message}
+              />
+              <TextInput
+                label="Zone"
+                error={errors.zone?.message}
+                {...register("zone")}
+              />
+              <TextInput
+                label="Woreda"
+                error={errors.woreda?.message}
+                {...register("woreda")}
+              />
+              <TextInput
+                label="Kebele"
+                error={errors.kebele?.message}
+                {...register("kebele")}
+              />
+              <TextInput
+                label="House No."
+                error={errors.houseNo?.message}
+                {...register("houseNo")}
+              />
+            </SimpleGrid>
+          </Stack>
+        </StepSection>
+      )}
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/ContactStep.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/ContactStep.tsx
new file mode 100644
index 000000000..6c28161b8
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/ContactStep.tsx
@@ -0,0 +1,86 @@
+import { SimpleGrid, Text, TextInput } from "@mantine/core";
+import type { UseFormReturn } from "react-hook-form";
+
+import { ControlledPhoneField } from "@/components/PhoneField";
+
+import type { FormData } from "../schema";
+import { LinkCheckboxCard } from "../LinkCheckboxCard";
+
+export interface ContactStepProps {
+  form: UseFormReturn<FormData>;
+  /**
+   * The owner's name from whichever source established them (eTrade, Fayda or
+   * typed) — the "same as owner" card only makes sense once there is one.
+   */
+  ownerName?: string;
+  contactSameAsOwner: boolean;
+  onToggleContactSameAsOwner: (checked: boolean) => void;
+}
+
+export default function ContactStep({
+  form,
+  ownerName,
+  contactSameAsOwner,
+  onToggleContactSameAsOwner,
+}: ContactStepProps) {
+  const {
+    register,
+    control,
+    formState: { errors },
+  } = form;
+
+  return (
+    <>
+      <Text fw={600} size="sm" c="edr-text">
+        Contact Person
+      </Text>
+      {/* `ownerName`, not the raw form field: the owner's name usually comes
+          from the eTrade lookup or a Fayda claim rather than being typed, so
+          gating on the form value would hide this card from most companies. */}
+      {ownerName && (
+        <LinkCheckboxCard
+          checked={contactSameAsOwner}
+          onToggle={onToggleContactSameAsOwner}
+          title="Same as company owner"
+          description="Reuse the owner's name, email and phone. Uncheck to enter different details."
+        />
+      )}
+      <SimpleGrid cols={2} spacing="md">
+        {/* Disabled while linked, not merely prefilled: the mirror effect
+            rewrites these from the owner whenever the owner changes, so an edit
+            made here would be silently thrown away the next time it fires.
+            Position is the customer's either way — the owner has no equivalent. */}
+        <TextInput
+          label="Name"
+          placeholder="Jane Smith"
+          disabled={contactSameAsOwner}
+          error={errors.contactPersonName?.message}
+          {...register("contactPersonName")}
+        />
+        <TextInput
+          label="Position (Optional)"
+          placeholder="Operations Lead"
+          error={errors.contactPersonPosition?.message}
+          {...register("contactPersonPosition")}
+        />
+      </SimpleGrid>
+      <SimpleGrid cols={2} spacing="md">
+        <TextInput
+          label="Email (Optional)"
+          type="email"
+          placeholder="contact@company.com"
+          disabled={contactSameAsOwner}
+          error={errors.contactPersonEmail?.message}
+          {...register("contactPersonEmail")}
+        />
+        <ControlledPhoneField
+          control={control}
+          name="contactPersonPhone"
+          label="Phone"
+          disabled={contactSameAsOwner}
+          required
+        />
+      </SimpleGrid>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/DocumentsStep.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/DocumentsStep.tsx
new file mode 100644
index 000000000..162e46af8
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/DocumentsStep.tsx
@@ -0,0 +1,64 @@
+import { Group, Loader, Text } from "@mantine/core";
+
+import { SmartFileInput } from "@edr/ui-common";
+import RoleLicenseStep, {
+  type RoleLicenseProfile,
+} from "@/components/onboarding/RoleLicenseStep";
+import type { FileUploadSetting } from "@/types/fileUploadSettings";
+
+export interface DocumentsStepProps {
+  loadingDocuments: boolean;
+  /** Nationality document set, minus the PoA delegation letter (its own step). */
+  documentsSetting?: FileUploadSetting;
+  documentFiles: Record<string, File | File[] | null>;
+  uploadedDocumentKeys?: string[];
+  documentFieldErrors: Record<string, string>;
+  onDocumentFilesChange: (next: Record<string, File | File[] | null>) => void;
+  roleProfiles?: RoleLicenseProfile[];
+  licenseFiles?: Record<string, File[]>;
+  licenseFieldErrors: Record<string, string>;
+  onLicenseFilesChange: (next: Record<string, File[]>) => void;
+}
+
+export default function DocumentsStep({
+  loadingDocuments,
+  documentsSetting,
+  documentFiles,
+  uploadedDocumentKeys,
+  documentFieldErrors,
+  onDocumentFilesChange,
+  roleProfiles,
+  licenseFiles,
+  licenseFieldErrors,
+  onLicenseFilesChange,
+}: DocumentsStepProps) {
+  return (
+    <>
+      {loadingDocuments ? (
+        <Group justify="center" py="xl">
+          <Loader size="sm" color="edr-green" />
+        </Group>
+      ) : !documentsSetting ? (
+        <Text size="sm" c="edr-muted" ta="center" py="md">
+          No document requirements found for your account type.
+        </Text>
+      ) : (
+        <SmartFileInput
+          file={documentsSetting}
+          value={documentFiles}
+          uploadedKeys={uploadedDocumentKeys}
+          errors={documentFieldErrors}
+          containerClassName="lg:grid grid-cols-2 items-stretch"
+          onChange={onDocumentFilesChange}
+        />
+      )}
+
+      <RoleLicenseStep
+        profiles={roleProfiles ?? []}
+        value={licenseFiles ?? {}}
+        onChange={onLicenseFilesChange}
+        errors={licenseFieldErrors}
+      />
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/OwnerStep.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/OwnerStep.tsx
new file mode 100644
index 000000000..805ef8784
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/OwnerStep.tsx
@@ -0,0 +1,156 @@
+import { Alert, SimpleGrid, Stack, Text, TextInput } from "@mantine/core";
+import { AlertTriangle, Info } from "lucide-react";
+import type { UseFormReturn } from "react-hook-form";
+
+import { ControlledPhoneField } from "@/components/PhoneField";
+import type { CompanyIdentityState } from "@/services/verifayda.service";
+
+import type { FormData } from "../schema";
+import SourcedField, { type FieldSource } from "../SourcedField";
+
+/** The owner details this step is responsible for. */
+type OwnerField = "name" | "email" | "phone";
+
+export interface OwnerStepProps {
+  form: UseFormReturn<FormData>;
+  identity?: CompanyIdentityState;
+  /** eTrade's registered manager, once a TIN lookup has succeeded. */
+  etradeOwner: { name: string; phone: string } | null;
+  /**
+   * Which source owns each of the owner's details, or null where none does.
+   *
+   * A sourced field is shown read-only with its provenance; every other one is
+   * an editable input. Neither the eTrade licence nor a Fayda verification is
+   * the customer's to retype — the first is the record the backoffice checks
+   * this company against, the second is the government's. CompanyProfileForm
+   * computes this and requires exactly the unsourced fields, so every input on
+   * screen is one the customer is actually asked to fill and nothing is
+   * required that has none.
+   */
+  source: Record<OwnerField, FieldSource | null>;
+  /** The value to display for a field its source owns. */
+  sourced: Record<OwnerField, string>;
+  /** A co-operative union or farm: no licence, so no eTrade record to match. */
+  cooperative?: boolean;
+  /** No eTrade record at all (co-operative or foreign investment licence). */
+  manualRegistration?: boolean;
+}
+
+/**
+ * Who the company's owner is — meaning whoever the eTrade licence names as the
+ * business's manager. Not necessarily the legal owner, but the person the
+ * record has to match: the backoffice's check is precisely "is this the person
+ * on the licence".
+ *
+ * Nothing here falls back to the signed-in account. The person doing the
+ * onboarding is often not the person on the licence, and stamping their name,
+ * email and phone onto the owner turned three required fields into a guess
+ * wearing the licence's authority.
+ *
+ * A co-operative union or farm has no licence, so there is nobody named on one
+ * — the owner is simply the person who runs it, typed in full and compared
+ * against nothing.
+ */
+export default function OwnerStep({
+  form,
+  identity,
+  etradeOwner,
+  source,
+  sourced,
+  cooperative = false,
+  manualRegistration = false,
+}: OwnerStepProps) {
+  const {
+    register,
+    control,
+    formState: { errors },
+  } = form;
+
+  const ownerVerified = identity?.owner.verified ?? false;
+
+  // A Fayda verification that names someone other than the person on the
+  // licence is the one thing this step exists to catch. Advisory here — the two
+  // sources transliterate Amharic names differently, so the reviewer decides —
+  // but the customer should see it now rather than be rejected later.
+  const mismatch = identity?.ownerMatchesEtrade === false;
+
+  return (
+    <Stack gap="md">
+      <Text size="sm" c="edr-muted">
+        {manualRegistration && !etradeOwner
+          ? cooperative
+            ? "The person who runs the co-operative union or farm. eTrade held no record for your TIN, so we need all of these from you."
+            : "The person your investment licence names. eTrade held no record for your TIN, so we need all of these from you."
+          : "These are the details of the person registered on your eTrade licence. What eTrade and Fayda gave us is shown as they gave it; anything they left blank we need from you."}
+      </Text>
+
+      {/* A company with no eTrade record is not told its licence listed no
+          manager — eTrade never held one. That "nothing came back" case is
+          covered by the line above. */}
+      {!manualRegistration && !etradeOwner && !ownerVerified && (
+        <Alert color="blue" variant="light" icon={<Info size={18} />}>
+          Your eTrade licence didn't list a manager, so there's nothing for us
+          to prefill. Enter the details of the person registered on it.
+        </Alert>
+      )}
+
+      {mismatch && (
+        <Alert
+          color="amber"
+          variant="light"
+          icon={<AlertTriangle size={18} />}
+          title="This doesn't match your eTrade licence"
+        >
+          Your licence lists <strong>{identity?.etradeManagerName}</strong>, but
+          the name here is <strong>{identity?.owner.name}</strong>. You can
+          continue, but our team will check this before approving your account —
+          so make sure it's the person the licence actually names.
+        </Alert>
+      )}
+
+      <SourcedField
+        label="Owner's Name"
+        value={sourced.name}
+        source={source.name}
+      >
+        <TextInput
+          label="Owner's Name"
+          placeholder="Abebe Bikila"
+          error={errors.ownerName?.message}
+          {...register("ownerName")}
+        />
+      </SourcedField>
+
+      <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+        {/* eTrade never returns an email for the manager and Fayda's email
+            claim is optional, so this is the field most companies actually
+            type — it is required either way (`REQUIRED_COMPANY_INFO`). */}
+        <SourcedField
+          label="Owner's Email"
+          value={sourced.email}
+          source={source.email}
+        >
+          <TextInput
+            label="Owner's Email"
+            type="email"
+            placeholder="owner@company.com"
+            error={errors.ownerEmail?.message}
+            {...register("ownerEmail")}
+          />
+        </SourcedField>
+
+        <SourcedField
+          label="Owner's Phone"
+          value={sourced.phone}
+          source={source.phone}
+        >
+          <ControlledPhoneField
+            control={control}
+            name="ownerPhone"
+            label="Owner's Phone"
+          />
+        </SourcedField>
+      </SimpleGrid>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/RepresentationStep.tsx b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/RepresentationStep.tsx
new file mode 100644
index 000000000..24391391a
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/accounts/companyProfileForm/steps/RepresentationStep.tsx
@@ -0,0 +1,363 @@
+import {
+  Button,
+  Card,
+  Divider,
+  Group,
+  Loader,
+  SimpleGrid,
+  Stack,
+  Text,
+  TextInput,
+} from "@mantine/core";
+import { IdCard, ShieldCheck, UserCheck, UserX } from "lucide-react";
+import type { UseFormReturn } from "react-hook-form";
+
+import { SmartFileInput } from "@edr/ui-common";
+import { ControlledPhoneField } from "@/components/PhoneField";
+import FaydaVerifyPanel from "@/components/FaydaVerifyPanel";
+import RoleCard from "@/pages/settings/RoleCard";
+import type { FileUploadSetting } from "@/types/fileUploadSettings";
+import type {
+  CompanyIdentityState,
+  PoaDeclaration,
+} from "@/services/verifayda.service";
+
+import type { FormData } from "../schema";
+
+/** How a foreign company chose to prove the person: Fayda, or a passport. */
+export type IdentityMethod = "fayda" | "passport";
+
+export interface RepresentationStepProps {
+  form: UseFormReturn<FormData>;
+  identity?: CompanyIdentityState;
+  /** Answer the power-of-attorney question (persisted server-side). */
+  onDeclare: (declared: PoaDeclaration) => void;
+  /** A declaration change is in flight. */
+  declarePending: boolean;
+  /**
+   * The answer is not the company's to change — it operates as a freight
+   * forwarder, which the API forces to "yes". No alert says so: the summary
+   * simply offers no way back, which is the same information without the
+   * lecture.
+   */
+  declarationLocked: boolean;
+  /**
+   * Which of the representative's details the Fayda verification owns. Same
+   * contract as OwnerStep's `locked`: a locked field is read-only, every other
+   * one is an input, and the schema requires exactly the unlocked ones.
+   *
+   * There is deliberately no `address` here. Fayda's address claim is stored as
+   * `poaAddress`, which the portal never sends; the input below writes
+   * `poaLocation`, a different field the company states itself. Gating one on
+   * the other hid the only input for `poaLocation` from every verified
+   * representative whose Fayda record happened to carry an address.
+   */
+  locked: { name: boolean; email: boolean; phone: boolean };
+  /**
+   * How a foreign company is proving the subject. Null until it picks — the
+   * either/or is a fork, not a fallback, so nothing below it renders until one
+   * side is chosen. Always "fayda" for an Ethiopian company, which has no
+   * choice to make.
+   */
+  method: IdentityMethod | null;
+  onMethodChange: (method: IdentityMethod) => void;
+  /** Single-field upload setting carrying just the DARS delegation letter. */
+  poaDocumentSetting?: FileUploadSetting;
+  documentFiles: Record<string, File | File[] | null>;
+  uploadedDocumentKeys?: string[];
+  documentFieldErrors: Record<string, string>;
+  onDocumentFilesChange: (next: Record<string, File | File[] | null>) => void;
+}
+
+/**
+ * Who acts for this company — and, as a direct consequence, whose identity gets
+ * verified.
+ *
+ * A company proves itself through exactly one person. This step asks which:
+ * name a Power of Attorney and it is the representative who verifies (plus the
+ * DARS paper evidencing the delegation); say there is none and the owner
+ * verifies here instead. There is no third answer — "the owner represents the
+ * company themselves" IS "no".
+ *
+ * A freight forwarder is never asked. It signs on other companies' behalf, so a
+ * representative and the paper behind them are non-negotiable; the API forces
+ * the answer regardless of what the portal sends.
+ */
+export default function RepresentationStep({
+  form,
+  identity,
+  onDeclare,
+  declarePending,
+  declarationLocked,
+  locked,
+  method,
+  onMethodChange,
+  poaDocumentSetting,
+  documentFiles,
+  uploadedDocumentKeys,
+  documentFieldErrors,
+  onDocumentFilesChange,
+}: RepresentationStepProps) {
+  const {
+    register,
+    control,
+    formState: { errors },
+  } = form;
+
+  if (!identity) {
+    return (
+      <Group justify="center" py="xl">
+        <Loader size="sm" />
+      </Group>
+    );
+  }
+
+  const declared = identity.poaDeclared;
+  const passportAccepted = identity.passportAccepted;
+  const subject = declared === "yes" ? identity.poa : identity.owner;
+  const verified = subject.verified;
+
+  // Nothing below the fork renders until the person is actually established:
+  // a Fayda claim that came back, or the passport path deliberately chosen.
+  // Asking for a name before the verification runs is asking for a value the
+  // verification is about to overwrite.
+  const established = verified || method === "passport";
+
+  const who = declared === "yes" ? "Representative" : "Owner";
+  const passportField =
+    declared === "yes" ? "poaPassportNumber" : "ownerPassportNumber";
+
+  return (
+    <Stack gap="lg">
+      {/* ------------------------------------------------------------------ */}
+      {/* The question. Once answered it collapses to its answer, so the step */}
+      {/* is about the person rather than re-presenting a settled choice.    */}
+      {/* ------------------------------------------------------------------ */}
+      {declared === null ? (
+        <>
+          <Stack gap="xs">
+            <Text fw={600} size="lg" c="edr-text">
+              Does anyone hold power of attorney for this company?
+            </Text>
+            <Text size="sm" c="edr-muted">
+              Your answer decides whose identity we verify — the
+              representative's, or the owner's.
+            </Text>
+          </Stack>
+
+          <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+            <RoleCard
+              label="Yes, we have a representative"
+              description="Someone other than the owner is authorised to act for the company. We'll verify their identity and ask for the DARS delegation paper."
+              icon={<UserCheck size={20} />}
+              selected={false}
+              onClick={declarePending ? undefined : () => onDeclare("yes")}
+            />
+            <RoleCard
+              label="No, the owner acts for us"
+              description="Nobody holds power of attorney. We'll verify the owner instead, and no delegation paper is needed."
+              icon={<UserX size={20} />}
+              selected={false}
+              onClick={declarePending ? undefined : () => onDeclare("no")}
+            />
+          </SimpleGrid>
+        </>
+      ) : (
+        <ChoiceSummary
+          icon={declared === "yes" ? <UserCheck size={18} /> : <UserX size={18} />}
+          label={
+            declared === "yes"
+              ? "A representative holds power of attorney"
+              : "The owner acts for the company"
+          }
+          detail={
+            declared === "yes"
+              ? "We'll verify their identity and ask for the DARS delegation paper."
+              : "Nobody holds power of attorney, so we verify the owner."
+          }
+          onChange={
+            declarePending || declarationLocked
+              ? undefined
+              : () => onDeclare(declared === "yes" ? "no" : "yes")
+          }
+          changeLabel={declared === "yes" ? "We have no representative" : "We have a representative"}
+        />
+      )}
+
+      {declared !== null && (
+        <>
+          <Divider />
+
+          {/* -------------------------------------------------------------- */}
+          {/* How the person is proved. Ethiopian: Fayda, no choice. Foreign: */}
+          {/* Fayda or a passport — one or the other, picked outright.        */}
+          {/* -------------------------------------------------------------- */}
+          {passportAccepted && !verified && method === null ? (
+            <Stack gap="xs">
+              <Text fw={600} c="edr-text">
+                How would you like to prove {who.toLowerCase()}'s identity?
+              </Text>
+              <Text size="sm" c="edr-muted">
+                Either one is enough — you don't need both.
+              </Text>
+              <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md" mt="xs">
+                <RoleCard
+                  label="Verify with Fayda"
+                  description="Their name, phone and address come straight from the national ID — nothing to type."
+                  icon={<ShieldCheck size={20} />}
+                  selected={false}
+                  onClick={() => onMethodChange("fayda")}
+                />
+                <RoleCard
+                  label="Use a passport instead"
+                  description="For someone who holds no Fayda ID. You'll enter their passport number and details yourself."
+                  icon={<IdCard size={20} />}
+                  selected={false}
+                  onClick={() => onMethodChange("passport")}
+                />
+              </SimpleGrid>
+            </Stack>
+          ) : (
+            <>
+              {(method === "fayda" || !passportAccepted || verified) && (
+                <FaydaVerifyPanel
+                  subject={declared === "yes" ? "poa" : "owner"}
+                  title={declared === "yes" ? "Power of Attorney" : "Company owner"}
+                  state={subject}
+                  required={!passportAccepted}
+                />
+              )}
+
+              {passportAccepted && !verified && method === "passport" && (
+                <TextInput
+                  label={`${who}'s Passport Number`}
+                  description="Fayda is an Ethiopian national ID, so a passport number proves this person instead."
+                  placeholder="P1234567"
+                  error={errors[passportField]?.message}
+                  {...register(passportField)}
+                />
+              )}
+
+              {passportAccepted && !verified && method !== null && (
+                <Button
+                  variant="subtle"
+                  size="compact-xs"
+                  style={{ alignSelf: "flex-start" }}
+                  onClick={() =>
+                    onMethodChange(method === "fayda" ? "passport" : "fayda")
+                  }
+                >
+                  {method === "fayda"
+                    ? "Use a passport instead"
+                    : "Verify with Fayda instead"}
+                </Button>
+              )}
+            </>
+          )}
+
+          {/* -------------------------------------------------------------- */}
+          {/* The representative's own details — only once the person exists,  */}
+          {/* and only the parts the verification did not carry. What Fayda    */}
+          {/* supplied is on the card above; echoing it back here as read-only */}
+          {/* rows was the same data twice with nothing to do about either.    */}
+          {/* -------------------------------------------------------------- */}
+          {declared === "yes" && established && (
+            <>
+              {!locked.name && (
+                <TextInput
+                  label="Representative's Name"
+                  placeholder="Abebe Bikila"
+                  error={errors.poaName?.message}
+                  {...register("poaName")}
+                />
+              )}
+
+              {(!locked.email || !locked.phone) && (
+                <SimpleGrid
+                  cols={{ base: 1, sm: !locked.email && !locked.phone ? 2 : 1 }}
+                  spacing="md"
+                >
+                  {!locked.email && (
+                    <TextInput
+                      label="Representative's Email"
+                      type="email"
+                      placeholder="representative@company.com"
+                      error={errors.poaEmail?.message}
+                      {...register("poaEmail")}
+                    />
+                  )}
+
+                  {!locked.phone && (
+                    <ControlledPhoneField
+                      control={control}
+                      name="poaPhone"
+                      label="Representative's Phone"
+                    />
+                  )}
+                </SimpleGrid>
+              )}
+
+              <TextInput
+                label="Representative's Location"
+                placeholder="City, Country"
+                error={errors.poaLocation?.message}
+                {...register("poaLocation")}
+              />
+
+              {poaDocumentSetting && (
+                <>
+                  <Divider my="sm" />
+                  <SmartFileInput
+                    file={poaDocumentSetting}
+                    value={documentFiles}
+                    uploadedKeys={uploadedDocumentKeys}
+                    errors={documentFieldErrors}
+                    onChange={onDocumentFilesChange}
+                  />
+                </>
+              )}
+            </>
+          )}
+        </>
+      )}
+    </Stack>
+  );
+}
+
+/** A settled choice, shown as its answer with a way back to the question. */
+function ChoiceSummary({
+  icon,
+  label,
+  detail,
+  onChange,
+  changeLabel,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  detail: string;
+  onChange?: () => void;
+  changeLabel: string;
+}) {
+  return (
+    <Card padding="md" radius="md" withBorder>
+      <Group justify="space-between" align="flex-start" wrap="nowrap">
+        <Group gap="sm" align="flex-start" wrap="nowrap">
+          <span style={{ display: "flex", marginTop: 2 }}>{icon}</span>
+          <Stack gap={2}>
+            <Text fw={600} size="sm" c="edr-text">
+              {label}
+            </Text>
+            <Text size="xs" c="edr-muted">
+              {detail}
+            </Text>
+          </Stack>
+        </Group>
+        {onChange && (
+          <Button variant="subtle" size="compact-xs" onClick={onChange}>
+            {changeLabel}
+          </Button>
+        )}
+      </Group>
+    </Card>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/billing/InvoiceDetailPage.tsx b/apps/edr-freight-web/portal/src/pages/billing/InvoiceDetailPage.tsx
index 775d9fe41..b42a3cc8e 100644
--- a/apps/edr-freight-web/portal/src/pages/billing/InvoiceDetailPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/billing/InvoiceDetailPage.tsx
@@ -1,8 +1,9 @@
 import { useState } from "react";
-import { useNavigate, useParams } from "react-router-dom";
+import { useLocation, useNavigate, useParams } from "react-router-dom";
 import { useQuery } from "@tanstack/react-query";
 import {
   Alert,
+  Badge,
   Box,
   Button,
   Center,
@@ -21,6 +22,7 @@ import {
   CreditCard,
   Download,
   ExternalLink,
+  Landmark,
   Receipt,
 } from "lucide-react";
 import toast from "react-hot-toast";
@@ -30,6 +32,7 @@ import { invoicesService } from "@/services/invoices.service";
 import { useInvoicePayment } from "@/hooks/useInvoicePayment";
 import { warehouseInvoicesService } from "@/services/warehouse-invoices.service";
 import { PaymentMethodModal } from "@/pages/bookings/BookingDetailPage/components/PaymentMethodModal";
+import { isUsdCurrency } from "@/pages/bookings/payments/offline-payment";
 import { saveBlob } from "@/utils/download";
 import { formatCurrency } from "@/lib/currency";
 import { BORDER, INK, MUTED } from "../contracts/contract-ui";
@@ -56,6 +59,11 @@ function MetaItem({ label, value }: { label: string; value: string }) {
 export default function InvoiceDetailPage() {
   const { id = "" } = useParams();
   const navigate = useNavigate();
+  // Mounted at /billing/:id (customer) and /shipping-line/invoices/:id — the
+  // back target follows whichever list the reader came through.
+  const backHref = useLocation().pathname.startsWith("/shipping-line")
+    ? "/shipping-line/invoices"
+    : "/billing";
   const {
     data: invoice,
     isLoading,
@@ -84,7 +92,7 @@ export default function InvoiceDetailPage() {
           variant="subtle"
           color="gray"
           leftSection={<ArrowLeft size={16} />}
-          onClick={() => navigate("/billing")}
+          onClick={() => navigate(backHref)}
           mb="md"
         >
           Back to invoices
@@ -162,7 +170,7 @@ export default function InvoiceDetailPage() {
           variant="subtle"
           color="gray"
           leftSection={<ArrowLeft size={16} />}
-          onClick={() => navigate("/billing")}
+          onClick={() => navigate(backHref)}
           style={{ alignSelf: "flex-start" }}
           styles={{ root: { fontWeight: 600 } }}
         >
@@ -224,7 +232,7 @@ export default function InvoiceDetailPage() {
                 Receipt
               </Button>
             )}
-            {payable && (
+            {payable && !isUsdCurrency(invoice.currency) && (
               <Button
                 color="edr-green"
                 radius="md"
@@ -239,6 +247,18 @@ export default function InvoiceDetailPage() {
                 Pay {formatCurrency(amountDue, invoice.currency)}
               </Button>
             )}
+            {payable && isUsdCurrency(invoice.currency) && (
+              <Badge
+                size="lg"
+                radius="md"
+                variant="light"
+                color="yellow"
+                leftSection={<Landmark size={12} />}
+                styles={{ label: { textTransform: "none", fontWeight: 700 } }}
+              >
+                Pay by bank transfer — send the slip to Finance
+              </Badge>
+            )}
           </Group>
         </Group>
 
diff --git a/apps/edr-freight-web/portal/src/pages/billing/InvoicesList.tsx b/apps/edr-freight-web/portal/src/pages/billing/InvoicesList.tsx
index e1d45857f..6e9e98a2c 100644
--- a/apps/edr-freight-web/portal/src/pages/billing/InvoicesList.tsx
+++ b/apps/edr-freight-web/portal/src/pages/billing/InvoicesList.tsx
@@ -32,6 +32,7 @@ import { Freight } from "@edr/types";
 
 import { api } from "@/services/api";
 import { formatCurrency } from "@/lib/currency";
+import { isUsdCurrency } from "@/pages/bookings/payments/offline-payment";
 import {
   BORDER,
   GREEN,
@@ -276,7 +277,10 @@ export default function InvoicesList() {
                 {!isLoading &&
                   !isError &&
                   pageRows.map((inv) => {
-                    const payable = isPayable(inv.status);
+                    // USD invoices are paid by bank transfer — the detail page
+                    // shows the instructions, so the row action reads "View".
+                    const payable =
+                      isPayable(inv.status) && !isUsdCurrency(inv.currency);
                     return (
                       <Table.Tr
                         key={inv.id}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/DraftBookingView.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/DraftBookingView.tsx
index 65af9f45d..cc9084d85 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/DraftBookingView.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/DraftBookingView.tsx
@@ -45,6 +45,7 @@ import { StatusHero } from "./components/StatusHero";
 import { StepGhostButton, StepLine } from "./components/Steps";
 import { SupportCard } from "./components/SupportCard";
 import { BodyGrid } from "./components/layout";
+import { formatAmount } from "./utils";
 
 export function DraftBookingView({
   booking,
@@ -439,7 +440,7 @@ export function DraftBookingView({
                   Previous total
                 </Text>
                 <Text size="sm" td="line-through">
-                  {priceChangeModal.previousTotalAmount.toLocaleString()}{" "}
+                  {formatAmount(priceChangeModal.previousTotalAmount)}{" "}
                   {priceChangeModal.currency}
                 </Text>
               </Group>
@@ -447,7 +448,7 @@ export function DraftBookingView({
             <Group justify="space-between">
               <Text fw={700}>New total</Text>
               <Text fw={800} c="edr-green">
-                {priceChangeModal.totalAmount.toLocaleString()}{" "}
+                {formatAmount(priceChangeModal.totalAmount)}{" "}
                 {priceChangeModal.currency}
               </Text>
             </Group>
@@ -459,7 +460,7 @@ export function DraftBookingView({
                       {item.description}
                     </Text>
                     <Text size="sm" fw={600}>
-                      {item.amount.toLocaleString()} {item.currency}
+                      {formatAmount(item.amount)} {item.currency}
                     </Text>
                   </Group>
                 ))}
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 3b7218313..0ecd16ef4 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
@@ -53,6 +53,7 @@ import { WagonsTab } from "./components/WagonsTab";
 import { fmtDate, isNegative, priceTotal } from "./utils";
 import { useScrollToHash } from "@/hooks/useScrollToHash";
 import { useBookingPayment } from "@/pages/bookings/payments/useBookingPayment";
+import { isUsdOfflineBooking } from "@/pages/bookings/payments/offline-payment";
 
 // Pre-payment statuses the customer may self-cancel from this view (free of
 // charge). DRAFT / CHANGES_REQUESTED render their own views and drafts can
@@ -157,7 +158,9 @@ export function ReadonlyBookingView({
   // the customer. Hide the customer's rebook everywhere and tell them GL will
   // handle it. Non-customs bookings stay self-service.
   const isCustoms = Boolean(booking.customsClearingEnabled);
-  const canSelfRebook = !isCustoms;
+  // A PAID booking cancelled through wagon cancellation rebooks via its credit
+  // (WagonCancellationCard), not the fresh-booking rebook link.
+  const canSelfRebook = !isCustoms && booking.paymentStatus !== "PAID";
   const isPendingConsolidation = status === "PENDING_CONSOLIDATION";
   const isClearance = [
     "AWAITING_DOCUMENTS",
@@ -188,7 +191,7 @@ export function ReadonlyBookingView({
               {canApproveDelivery && (
                 <ApproveDeliveryButton bookingId={booking.id} />
               )}
-              {canPay && !showCountdown && (
+              {canPay && !showCountdown && !isUsdOfflineBooking(booking) && (
                 <HeaderButton
                   green
                   icon={<CreditCard size={16} />}
@@ -218,7 +221,9 @@ export function ReadonlyBookingView({
           subtitle={
             status === "REJECTED"
               ? "This booking request has been rejected."
-              : "This booking process has been terminated."
+              : booking.paymentStatus === "PAID"
+                ? "All wagons were cancelled. Your paid freight is held as a credit — rebook it from the Wagon Cancellation card below."
+                : "This booking process has been terminated."
           }
           reason={booking.latestChangeRequestNote}
           onRebook={canSelfRebook ? onRebook : undefined}
@@ -347,6 +352,7 @@ export function ReadonlyBookingView({
           <Tabs.Panel value="wagons">
             <WagonsTab
               bookingId={booking.id}
+              currency={booking.paymentCurrency}
               cancellable={
                 booking.status === "PAID" &&
                 booking.paymentStatus === "PAID" &&
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/BookingPaymentPanel.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/BookingPaymentPanel.tsx
index d921308d0..0f691d6ea 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/BookingPaymentPanel.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/BookingPaymentPanel.tsx
@@ -17,9 +17,19 @@ import type { Freight } from "@edr/types";
 import { invoicesService, type PortalInvoice } from "@/services/invoices.service";
 import { InvoiceStatusBadge, titleCase } from "@/pages/billing/invoice-ui";
 import { paymentStatusLabel } from "@/pages/bookings/booking-display";
+import { isUsdOfflineBooking } from "@/pages/bookings/payments/offline-payment";
+import { PayerAccountNote } from "@/pages/bookings/payments/PayerAccountNote";
+import { payWindowState } from "@/pages/bookings/payments/payment-drain";
+import { PaymentProcessingNotice } from "@/pages/bookings/payments/PaymentProcessingNotice";
 import { saveBlob } from "@/utils/download";
 
-import { fmtDate, priceLineItems, priceTotal, type Pricing } from "../utils";
+import {
+  fmtDate,
+  formatAmount,
+  priceLineItems,
+  priceTotal,
+  type Pricing,
+} from "../utils";
 import { CardTitle, SectionCard } from "./layout";
 
 const Divider = () => <Box my={16} h={1} w="100%" bg="#EEF2F6" />;
@@ -190,12 +200,13 @@ export function BookingPaymentPanel({
 }) {
   const navigate = useNavigate();
   const paid = booking.paymentStatus === "PAID";
+  const offlineUsd = isUsdOfflineBooking(booking);
   const isAdjusted =
     booking.adjustedTotalAmount !== null &&
     booking.adjustedTotalAmount !== undefined;
   const currency = pricing?.currency ?? booking.paymentCurrency;
   const total = isAdjusted
-    ? `${Number(booking.adjustedTotalAmount).toLocaleString()} ${currency}`
+    ? `${formatAmount(booking.adjustedTotalAmount)} ${currency}`
     : priceTotal(pricing);
   const items = priceLineItems(pricing);
 
@@ -208,6 +219,11 @@ export function BookingPaymentPanel({
     (booking.status === "SELECTED_FOR_BATCH" ||
       Boolean(booking.paymentDeadline));
 
+  // Pay deadline passed but the settlement drain tail hasn't: in-flight payments
+  // are still landing, so the pay action gives way to a processing countdown.
+  const payWindow = payWindowState(booking);
+  const draining = payWindow.phase === "draining" && Boolean(payWindow.drainEndsAt);
+
   const { data: invoices = [] } = useQuery({
     queryKey: ["booking-invoices", booking.id],
     queryFn: () => invoicesService.listForSource("booking", booking.id),
@@ -258,9 +274,11 @@ export function BookingPaymentPanel({
           {paid ? <CheckCircle2 size={13} /> : showCountdown ? <Timer size={13} /> : null}
           {paid
             ? "Paid"
-            : showCountdown
-              ? "Pay window open"
-              : paymentStatusLabel(booking.paymentStatus ?? "PENDING")}
+            : draining
+              ? "Payment processing"
+              : showCountdown
+                ? "Pay window open"
+                : paymentStatusLabel(booking.paymentStatus ?? "PENDING")}
         </Group>
       </Group>
 
@@ -268,13 +286,43 @@ export function BookingPaymentPanel({
         <PartialOfferNotice offer={booking.activeBatchOffer} />
       )}
 
-      {showCountdown && booking.paymentDeadline && (
+      {/* USD: no online payment — bank transfer + slip to Finance, who confirm
+          the payment (backoffice flow lands in a later phase). Shown for any
+          unpaid USD booking, with or without an open pay window. */}
+      {!paid && draining && payWindow.drainEndsAt && (
+        <PaymentProcessingNotice drainEndsAt={payWindow.drainEndsAt} />
+      )}
+
+      {!paid && !draining && offlineUsd && (
+        <Box
+          mt={14}
+          p={14}
+          style={{
+            borderRadius: 10,
+            backgroundColor: "#FEF6E6",
+            border: "1px solid #F3E2B8",
+          }}
+        >
+          <Text fz="13px" fw={800} c="#9A5B00">
+            Pay by bank transfer
+          </Text>
+          <Text mt={4} fz="12.5px" c="#7A5A1E" lh={1.55}>
+            Online payment isn&apos;t available for USD bookings. Transfer the
+            total amount to EDR&apos;s bank account before the payment deadline,
+            then send the payment slip to the EDR Finance department — they
+            will confirm your payment.
+          </Text>
+        </Box>
+      )}
+
+      {showCountdown && !draining && booking.paymentDeadline && (
         <Box mt={16}>
           <Countdown
             deadline={booking.paymentDeadline}
-            onPay={onPay}
+            onPay={offlineUsd ? undefined : onPay}
             paying={paying}
           />
+          {!paid && <PayerAccountNote />}
           {showConsolidationNote && (
             <Text mt={12} fz="12px" c="#9AA8B5" lh={1.5}>
               This shipment shares a wagon with a consolidation partner — both
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx
index 3002356f7..f5fa3f934 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx
@@ -66,7 +66,7 @@ export function ClearanceCard({ booking }: { booking: Freight.IBooking }) {
           isBookAction
             ? "Book your shipment — enter the cargo details and pick a shipment day inside an open booking window."
             : "Pick a shipment day and proceed to operation."
-        }`}
+        } You can still add documents to this shipment until it is paid.`}
       </Alert>
     ) : status === "DOCUMENTS_UNDER_REVIEW" ? (
       <Alert color="blue" radius="md" icon={<Clock size={18} />}>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/MileSummaryCard.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/MileSummaryCard.tsx
index bfb57529f..6619dbd06 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/MileSummaryCard.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/MileSummaryCard.tsx
@@ -1,5 +1,6 @@
-import { Box, Group, Stack, Text } from "@mantine/core";
+import { Box, Button, Group, Stack, Text } from "@mantine/core";
 import { useQuery } from "@tanstack/react-query";
+import { useNavigate } from "react-router-dom";
 
 import type { Freight } from "@edr/types";
 
@@ -8,6 +9,7 @@ import type {
   MileLegSummary,
   MileVehicleSummary,
 } from "@/services/bookings.service";
+import { lastMileRequestsService } from "@/services/last-mile-requests.service";
 
 import { CardTitle, SectionCard } from "./layout";
 
@@ -171,12 +173,85 @@ function LegBlock({
   );
 }
 
+/**
+ * Reference row for the stored last-mile contract: signed status, open the
+ * contract page (view / sign), download the PDF.
+ */
+function LastMileContractRow({
+  bookingId,
+  requestId,
+  signedAt,
+  signerDisplayName,
+}: {
+  bookingId: string;
+  requestId: string;
+  signedAt?: string | null;
+  signerDisplayName?: string | null;
+}) {
+  const navigate = useNavigate();
+  const download = async () => {
+    const blob = await lastMileRequestsService.downloadContractDocument(requestId);
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = "last-mile-contract.pdf";
+    a.click();
+    URL.revokeObjectURL(url);
+  };
+
+  return (
+    <Group
+      justify="space-between"
+      align="center"
+      wrap="wrap"
+      pt={8}
+      mt={4}
+      style={{ borderTop: "1px solid #F2F5F8" }}
+    >
+      <Stack gap={2} style={{ minWidth: 0 }}>
+        <Text fz="13px" fw={700} c="#10202F">
+          Last-mile contract
+        </Text>
+        <Text fz="12px" c={signedAt ? "#0A6F4D" : "#B45309"}>
+          {signedAt
+            ? `Signed ${new Date(signedAt).toLocaleDateString()}${
+                signerDisplayName ? ` by ${signerDisplayName}` : ""
+              }`
+            : "Awaiting your signature"}
+        </Text>
+      </Stack>
+      <Group gap={8}>
+        <Button
+          size="xs"
+          variant="light"
+          onClick={() =>
+            navigate(`/bookings/${bookingId}/last-mile-contract?requestId=${requestId}`)
+          }
+        >
+          {signedAt ? "View contract" : "View & sign"}
+        </Button>
+        <Button size="xs" variant="default" onClick={() => void download()}>
+          Download PDF
+        </Button>
+      </Group>
+    </Group>
+  );
+}
+
 export function MileSummaryCard({ booking }: { booking: Freight.IBooking }) {
   const { data } = useQuery({
     queryKey: ["booking-mile-summary", booking.id],
     queryFn: () => bookingsService.mileSummary(booking.id),
   });
 
+  // The stored LM contract lives on the booking's approved last-mile request.
+  const { data: lmRequests } = useQuery({
+    queryKey: ["booking-last-mile-requests", booking.id],
+    queryFn: () => lastMileRequestsService.listForBooking(booking.id),
+    enabled: !!booking.lastMileDeliveryAddress,
+  });
+  const approvedRequest = (lmRequests ?? []).find((r) => r.status === "APPROVED");
+
   const firstLeg = data?.firstMile ?? null;
   const lastLeg = data?.lastMile ?? null;
 
@@ -202,11 +277,21 @@ export function MileSummaryCard({ booking }: { booking: Freight.IBooking }) {
           />
         )}
         {showLast && (
-          <LegBlock
-            title="Last mile"
-            leg={lastLeg}
-            address={booking.lastMileDeliveryAddress}
-          />
+          <Box>
+            <LegBlock
+              title="Last mile"
+              leg={lastLeg}
+              address={booking.lastMileDeliveryAddress}
+            />
+            {approvedRequest && (
+              <LastMileContractRow
+                bookingId={booking.id}
+                requestId={approvedRequest.id}
+                signedAt={approvedRequest.customerSignedAt}
+                signerDisplayName={approvedRequest.signerDisplayName}
+              />
+            )}
+          </Box>
         )}
       </Stack>
     </SectionCard>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/PaymentMethodModal.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/PaymentMethodModal.tsx
index a57dd0a9d..00c6bdd7c 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/PaymentMethodModal.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/PaymentMethodModal.tsx
@@ -13,6 +13,7 @@ import { Check, Landmark, ShieldCheck } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 
 import type { InvoicePaymentFlow } from "@/hooks/useInvoicePayment";
+import { PayerAccountNote } from "@/pages/bookings/payments/PayerAccountNote";
 import type { PaymentMethod } from "@/services/payments.service";
 
 interface ProviderOption {
@@ -25,17 +26,21 @@ interface ProviderOption {
   currencies: string[];
   accent: string;
 }
+ 
 
-// Only Telebirr, Waafi, CAC Bank and CBE bill payment are enabled for now.
+
+// ponytail: ETB pays via CBE bill only for now — restore the Telebirr entry
+// ({ method: "TELEBIRR", currencies: ["ETB"] }) when mobile money returns.
 const PROVIDERS: ProviderOption[] = [
-  {
-    method: "TELEBIRR",
-    label: "telebirr",
-    description: "Ethiopian mobile money · ETB",
-    logo: "/assets/telebirr.jpeg",
-    currencies: ["ETB"],
-    accent: "#0A6F4D",
-  },
+  // {
+  //  {
+  //   method: "TELEBIRR",
+  //   label: "telebirr",
+  //   description: "Ethiopian mobile money · ETB",
+  //   logo: "/assets/telebirr.jpeg",
+  //   currencies: ["ETB"],
+  //   accent: "#0A6F4D",
+  // },
   {
     method: "WAAFI",
     label: "Waafi",
@@ -55,7 +60,7 @@ const PROVIDERS: ProviderOption[] = [
     method: "CBE_BILL",
     label: "CBE bill payment",
     description: "Pay at any CBE branch, app or USSD · ETB",
-    logo: "/assets/edr-logo.png",
+    logo: "/assets/cbe.png",
     currencies: ["ETB"],
     accent: "#5B2D8C",
   },
@@ -69,8 +74,8 @@ const OTP_LENGTH = 4;
 const isBillMethod = (method: PaymentMethod) => method === "CBE_BILL";
 
 /**
- * Pick the provider that settles in the booking's currency. USD → Waafi,
- * ETB → Telebirr. Falls back to the first provider when unknown.
+ * Pick the provider that settles in the booking's currency. USD → Waafi/CAC,
+ * ETB → CBE bill. Falls back to the full list when unknown.
  */
 function providersForCurrency(currency?: string | null): ProviderOption[] {
   const cur = currency?.trim().toUpperCase();
@@ -190,7 +195,7 @@ export function PaymentMethodModal({
   onClose: () => void;
   /** Human-readable total, e.g. "ETB 12,500". */
   amountLabel?: string;
-  /** Booking payment currency — drives which provider is shown (USD → Waafi, ETB → Telebirr). */
+  /** Booking payment currency — drives which provider is shown (USD → Waafi/CAC, ETB → CBE bill). */
   currency?: string | null;
   onConfirm: (method: PaymentMethod, payerAccount?: string) => void;
   processing?: boolean;
@@ -302,6 +307,8 @@ export function PaymentMethodModal({
             </Text>
           )}
 
+          <PayerAccountNote />
+
           <Text mt={14} fz="11.5px" c="#9AA8B5">
             This page updates automatically once CBE confirms your payment.
           </Text>
@@ -445,6 +452,8 @@ export function PaymentMethodModal({
             </Text>
           </Group>
         )}
+
+        <PayerAccountNote />
       </Box>
 
       {/* Provider options */}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonCancellationCard.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonCancellationCard.tsx
index 00b3195a2..d5ab1754a 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonCancellationCard.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonCancellationCard.tsx
@@ -11,7 +11,7 @@ import {
   Textarea,
 } from "@mantine/core";
 import { useMutation, useQuery } from "@tanstack/react-query";
-import { CheckCircle2, Clock, CreditCard, TrainTrack } from "lucide-react";
+import { CheckCircle2, Clock, CreditCard } from "lucide-react";
 import { useMemo, useState } from "react";
 import toast from "react-hot-toast";
 import { Link, useNavigate } from "react-router-dom";
@@ -29,7 +29,7 @@ import { OperationDatePicker } from "@/pages/bookings/clearance";
 import { useFeeInvoicePayment } from "@/pages/bookings/payments/useBookingPayment";
 
 import type { BookingDetail } from "../booking-detail-types";
-import { fmtDate } from "../utils";
+import { fmtDate, formatAmount } from "../utils";
 import { CardTitle, SectionCard } from "./layout";
 import { PaymentMethodModal } from "./PaymentMethodModal";
 
@@ -62,7 +62,7 @@ function StatusPill({ status }: { status: WagonCancellation["status"] }) {
 }
 
 const fmtMoney = (amount: number | string, currency: string) =>
-  `${Number(amount).toLocaleString()} ${currency}`;
+  `${formatAmount(amount)} ${currency}`;
 
 const apiErrorMessage = (error: unknown, fallback: string) => {
   const data = (
@@ -76,7 +76,7 @@ const apiErrorMessage = (error: unknown, fallback: string) => {
 const th = { color: "#9AA8B5", fontSize: 11 } as const;
 
 /**
- * Partial wagon cancellation on a PAID contract booking: request a cut (fee
+ * Wagon cancellation (partial or whole) on a PAID contract booking: request a cut (fee
  * previewed first), pay the cancellation fee, then rebook the freed credit
  * onto another shipment day — plus the booking's cancellation history.
  * Wagons leave the schedule at request time; the fee settles the credit.
@@ -90,10 +90,13 @@ export function WagonCancellationCard({
 }) {
   const navigate = useNavigate();
   const status = booking.status as string;
-  const eligible =
-    status === "PAID" &&
-    (booking.paymentStatus as string) === "PAID" &&
-    !!booking.contractId;
+  const paidContract =
+    (booking.paymentStatus as string) === "PAID" && !!booking.contractId;
+  // New cuts only on a live PAID booking; a booking fully cancelled through
+  // this flow (status CANCELLED) still shows the card so its credit can be
+  // paid for / rebooked.
+  const canRequest = status === "PAID" && paidContract;
+  const eligible = paidContract && (status === "PAID" || status === "CANCELLED");
 
   const isBulk = booking.freightType === "BULK";
   const detail = booking as BookingDetail;
@@ -226,12 +229,13 @@ export function WagonCancellationCard({
   });
 
   if (!eligible) return null;
+  if (!canRequest && !ownRows.length) return null;
 
   return (
     <SectionCard>
       <Group justify="space-between" align="center" mb="sm">
         <CardTitle>Wagon Cancellation</CardTitle>
-        {!openRow && !creditRow && (
+        {/* {canRequest && !openRow && !creditRow && (
           <Button
             variant="default"
             radius="md"
@@ -240,7 +244,7 @@ export function WagonCancellationCard({
           >
             Cancel wagons
           </Button>
-        )}
+        )} */}
       </Group>
 
       {openRow ? (
@@ -305,9 +309,9 @@ export function WagonCancellationCard({
         </Stack>
       ) : (
         <Text fz={13} c="#475569">
-          Need fewer wagons than you paid for? Cancel part of this booking for
-          a per-wagon fee — the freed freight amount becomes a credit you can
-          rebook onto another shipment day.
+          Need fewer wagons than you paid for — or none? Cancel part or all of
+          this booking for a per-wagon fee — the freed freight amount becomes a
+          credit you can rebook onto another shipment day.
         </Text>
       )}
 
@@ -401,16 +405,16 @@ export function WagonCancellationCard({
               {booking.reference}
             </Text>{" "}
             to cancel. A per-wagon fee applies; once it&apos;s paid the wagons
-            are released and the freed amount becomes a rebooking credit. At
-            least one wagon must remain — to cancel everything, cancel the
-            whole booking instead.
+            are released and the freed amount becomes a rebooking credit.
+            Cancelling every wagon cancels the whole booking — the full freight
+            amount becomes your credit.
           </Text>
 
           {isBulk ? (
             <NumberInput
               label="Wagons to cancel"
               min={1}
-              max={wagonsRequired > 1 ? wagonsRequired - 1 : undefined}
+              max={wagonsRequired > 0 ? wagonsRequired : undefined}
               allowDecimal={false}
               value={wagons}
               onChange={(v) => {
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonsTab.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonsTab.tsx
index 89df714d6..bb775555f 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonsTab.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WagonsTab.tsx
@@ -462,10 +462,13 @@ function WagonCard({
  */
 export function WagonsTab({
   bookingId,
+  currency,
   cancellable,
   onCancellationRequested,
 }: {
   bookingId: string;
+  /** Booking payment currency — labels the rebooking credit. */
+  currency?: string;
   /** PAID contract booking — specific wagons may be selected for cancellation. */
   cancellable?: boolean;
   onCancellationRequested?: () => void;
@@ -684,7 +687,7 @@ export function WagonsTab({
             </Box>
             <Button
               color="orange"
-              disabled={selected.size === 0 || selected.size >= wagons.length}
+              disabled={selected.size === 0}
               onClick={openConfirm}
             >
               Cancel selected ({selected.size})
@@ -692,8 +695,8 @@ export function WagonsTab({
           </Group>
           {selected.size >= wagons.length && selected.size > 0 && (
             <Text fz={12} c="#B3362C" mt={6}>
-              You cannot cancel every wagon here — to cancel the whole booking,
-              use the booking cancellation instead.
+              Every wagon is selected — this cancels the whole booking once the
+              fee is paid; the full freight amount becomes your rebooking credit.
             </Text>
           )}
         </SectionCard>
@@ -759,7 +762,7 @@ export function WagonsTab({
                   Rebooking credit kept
                 </Text>
                 <Text fz={14} fw={800} c="#0A6F4D">
-                  {Number(preview.creditAmount).toLocaleString()}
+                  {Number(preview.creditAmount).toLocaleString()} {currency ?? ""}
                 </Text>
               </Group>
             </Box>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WarehousePaymentsSection.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WarehousePaymentsSection.tsx
index d3bbc55e9..a28fc2077 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WarehousePaymentsSection.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/WarehousePaymentsSection.tsx
@@ -10,6 +10,7 @@ import {
   type PortalWarehouseInvoice,
 } from "@/services/warehouse-invoices.service";
 import { saveBlob } from "@/utils/download";
+import { formatAmount } from "../utils";
 
 import { PaymentMethodModal } from "./PaymentMethodModal";
 import { CardTitle, SectionCard } from "./layout";
@@ -20,7 +21,7 @@ const isPayable = (inv: PortalWarehouseInvoice) =>
   PAYABLE_STATUSES.has(inv.status) && Number(inv.balanceAmount ?? 0) > 0;
 
 const money = (amount: number | string | null | undefined, currency: string) =>
-  `${Number(amount ?? 0).toLocaleString()} ${currency}`;
+  `${formatAmount(amount)} ${currency}`;
 
 const STATUS_STYLE: Record<string, { bg: string; fg: string }> = {
   DRAFT: { bg: "#EEF2F6", fg: "#64748B" },
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/utils.ts b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/utils.ts
index 22b347e85..5f9a71702 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/utils.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/utils.ts
@@ -151,15 +151,27 @@ export function bookingSubtitle(b: BookingDetail) {
 
 export type Pricing = Freight.PricingBreakdown | null | undefined;
 
+/**
+ * Money always prints its cents. Bare toLocaleString() defaults to
+ * maximumFractionDigits: 0, which silently hid the cents the customer is
+ * actually charged — CBE bills the exact amount, so the shown figure must match.
+ */
+export function formatAmount(amount: number | string | null | undefined) {
+  return Number(amount ?? 0).toLocaleString(undefined, {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+  });
+}
+
 export function priceLineItems(pricing: Pricing) {
   return (pricing?.lineItems ?? []).map((li) => ({
     label: li.description,
-    value: `${li.amount.toLocaleString()} ${li.currency}`,
+    value: `${formatAmount(li.amount)} ${li.currency}`,
   }));
 }
 
 export function priceTotal(pricing: Pricing) {
   if (!pricing) return "—";
   const total = pricing.lineItems.reduce((s, li) => s + li.amount, 0);
-  return `${total.toLocaleString()} ${pricing.currency}`;
+  return `${formatAmount(total)} ${pricing.currency}`;
 }
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingsListPage.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingsListPage.tsx
index 4a9ef757c..925569be1 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingsListPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingsListPage.tsx
@@ -26,7 +26,7 @@ import {
   LayoutList,
   MoreVertical,
   Package,
-  Plus,
+  
   Search,
   Train,
   Wallet,
@@ -35,6 +35,7 @@ import {
 
 import { ShipmentTrackingModal } from "./tracking/ShipmentTrackingModal";
 import { PayNowButton } from "./payments/PayNowButton";
+import { payWindowState } from "./payments/payment-drain";
 import { BookingActionButton } from "./clearance/BookingActionButton";
 import { bookingHasInlineAction } from "./clearance/bookingNextAction";
 import {
@@ -42,6 +43,7 @@ import {
   bookingIsSignable,
 } from "./contract/ContractSignButton";
 import { ApproveDeliveryButton } from "./delivery/ApproveDeliveryButton";
+import { RebookWagonsButton } from "./RebookWagonsButton";
 import {
   BookingStatusBadge as StatusBadge,
   BookingTypeBadge,
@@ -51,7 +53,10 @@ import {
 } from "./booking-display";
 
 import { api } from "@/services/api";
-import type { BookingListFilter } from "@/services/bookings.service";
+import type {
+  BookingListFilter,
+  WagonCancellation,
+} from "@/services/bookings.service";
 import type { Freight } from "@edr/types";
 import {
   DataTable,
@@ -175,13 +180,25 @@ const STAT_CARDS: Array<{
 
 function PrimaryAction({
   booking,
+  credit,
   onNavigate,
 }: {
   booking: Freight.IBooking;
+  /** CREDIT_AVAILABLE wagon cancellation opened by this booking, if any. */
+  credit?: WagonCancellation;
   onNavigate: (path: string) => void;
 }) {
   const { status, id } = booking;
   const go = () => onNavigate(`/bookings/${id}`);
+  // Cancelled wagons with a paid credit (partial or whole cancel) → rebook.
+  if (credit) {
+    return (
+      <RebookWagonsButton
+        cancellation={credit}
+        currency={booking.paymentCurrency}
+      />
+    );
+  }
   // A general contract is payable as soon as it's FULLY_EXECUTED (signed); a
   // one-time booking only after it's SELECTED_FOR_BATCH.
   const isGeneralContract = booking.bookingType === "GENERAL_CONTRACT";
@@ -211,7 +228,14 @@ function PrimaryAction({
   const payableStatus = isGeneralContract
     ? "FULLY_EXECUTED"
     : "SELECTED_FOR_BATCH";
-  if (status === payableStatus && booking.paymentStatus !== "PAID") {
+  // A fully-closed pay window (deadline + drain both elapsed) falls through to
+  // the default action. The drain itself still routes here — PayNowButton
+  // renders the "payment processing" wait notice instead of a pay action.
+  if (
+    status === payableStatus &&
+    booking.paymentStatus !== "PAID" &&
+    payWindowState(booking).phase !== "closed"
+  ) {
     return <PayNowButton booking={booking} />;
   }
   // Contract ready for the customer's signature → full-page contract viewer.
@@ -350,6 +374,16 @@ export default function BookingsListPage() {
   const [debouncedQuery] = useDebouncedValue(query, 300);
   const [typeFilter, setTypeFilter] = useState<string | null>(null);
   const [freightFilter, setFreightFilter] = useState<string | null>(null);
+  const [serviceFilter, setServiceFilter] = useState<string | null>(null);
+
+  // Service-type options — same reference-data payload the booking form uses.
+  const { data: refData } = useQuery(
+    api.bookings.referenceData.queryOptions({ staleTime: 5 * 60_000 }),
+  );
+  const serviceTypeOptions = useMemo(
+    () => (refData?.service ?? []).map((s) => ({ value: s.id, label: s.name })),
+    [refData],
+  );
   const [sort, setSort] = useState<string>("createdAt:DESC");
   const [createdFrom, setCreatedFrom] = useState<string>("");
   const [createdTo, setCreatedTo] = useState<string>("");
@@ -371,10 +405,11 @@ export default function BookingsListPage() {
   };
 
   const hasExtraFilters =
-    !!typeFilter || !!freightFilter || !!createdFrom || !!createdTo;
+    !!typeFilter || !!freightFilter || !!serviceFilter || !!createdFrom || !!createdTo;
   const clearExtraFilters = () => {
     setTypeFilter(null);
     setFreightFilter(null);
+    setServiceFilter(null);
     setCreatedFrom("");
     setCreatedTo("");
     resetPage();
@@ -386,6 +421,7 @@ export default function BookingsListPage() {
       assignedToSchedule,
       bookingType: typeFilter ?? undefined,
       freightType: freightFilter ?? undefined,
+      serviceTypeId: serviceFilter ?? undefined,
       createdFrom: createdFrom || undefined,
       // include the whole selected end day
       createdTo: createdTo ? `${createdTo}T23:59:59.999Z` : undefined,
@@ -401,6 +437,7 @@ export default function BookingsListPage() {
       assignedToSchedule,
       typeFilter,
       freightFilter,
+      serviceFilter,
       createdFrom,
       createdTo,
       debouncedQuery,
@@ -415,6 +452,22 @@ export default function BookingsListPage() {
     api.bookings.list.queryOptions({ input: filter }),
   );
 
+  // Rebookable credits (fee-paid wagon cancellations) keyed by source booking,
+  // so the row action can offer "Rebook wagons" in place of "View".
+  // ponytail: one page of 100 newest rows; paginate if a customer ever holds more.
+  const { data: myCancellations } = useQuery(
+    api.bookings.listMyWagonCancellations.queryOptions({
+      input: { pageSize: 100 },
+    }),
+  );
+  const creditByBooking = useMemo(() => {
+    const m = new Map<string, WagonCancellation>();
+    for (const r of myCancellations?.items ?? []) {
+      if (r.status === "CREDIT_AVAILABLE" && !m.has(r.bookingId)) m.set(r.bookingId, r);
+    }
+    return m;
+  }, [myCancellations]);
+
   // Per-card lifecycle counts (one cheap query each, total-only).
   const allCount = useStatusCount(undefined);
   const activeCount = useStatusCount(
@@ -646,7 +699,11 @@ export default function BookingsListPage() {
                 Track
               </Button>
             )}
-            <PrimaryAction booking={booking} onNavigate={navigate} />
+            <PrimaryAction
+              booking={booking}
+              credit={creditByBooking.get(booking.id)}
+              onNavigate={navigate}
+            />
             <Menu position="bottom-end" withinPortal shadow="md" radius="md">
               <Menu.Target>
                 <ActionIcon
@@ -698,7 +755,7 @@ export default function BookingsListPage() {
               Track every cargo booking — from draft to delivery.
             </Text>
           </Box>
-          <Button
+          {/* <Button
             component={Link}
             to="/contracts"
             color="edr-green"
@@ -706,7 +763,7 @@ export default function BookingsListPage() {
             leftSection={<Plus size={16} />}
           >
             New booking
-          </Button>
+          </Button> */}
         </Group>
 
         {/* ── Summary stat cards ──────────────────────────────────────── */}
@@ -808,6 +865,20 @@ export default function BookingsListPage() {
                 style={{ width: 150 }}
                 aria-label="Filter by cargo type"
               />
+              <Select
+                placeholder="Any service"
+                data={serviceTypeOptions}
+                value={serviceFilter}
+                onChange={(v) => {
+                  setServiceFilter(v);
+                  resetPage();
+                }}
+                clearable
+                radius="md"
+                comboboxProps={{ withinPortal: true }}
+                style={{ width: 190 }}
+                aria-label="Filter by service type"
+              />
               <Select
                 data={SORT_OPTIONS.map((o) => ({
                   value: o.value,
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/EditBookingPage.tsx b/apps/edr-freight-web/portal/src/pages/bookings/EditBookingPage.tsx
index 269fa2160..26a59b405 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/EditBookingPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/EditBookingPage.tsx
@@ -157,8 +157,8 @@ function mapBookingToFormValues(
     isRefrigerated: booking.isRefrigerated ?? false,
     bulkHazardousQty: String(Number(booking.bulkHazardousQuantity ?? 0)),
     bulkReeferQty: String(Number(booking.bulkReeferQuantity ?? 0)),
-    paymentCurrency:
-      booking.paymentCurrency === "ETB" ? "ETB" : "USD",
+    // ponytail: ETB-only for now — old USD drafts are re-billed in ETB on edit.
+    paymentCurrency: "ETB",
     scheduledDate: booking.scheduledDate
       ? new Date(booking.scheduledDate).toISOString().slice(0, 10)
       : "",
@@ -683,7 +683,11 @@ export default function EditBookingPage() {
             />
           </SimpleGrid>
 
-          <PaymentCurrencyField control={form.control} />
+          {/* USD billing is import-only; export/intercity stay ETB. */}
+          <PaymentCurrencyField
+            control={form.control}
+            allowUsd={operationType === "import"}
+          />
 
           {(selectedService?.includesFirstMile ||
             selectedService?.includesLastMile ||
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/RebookWagonsButton.tsx b/apps/edr-freight-web/portal/src/pages/bookings/RebookWagonsButton.tsx
new file mode 100644
index 000000000..372d24156
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/bookings/RebookWagonsButton.tsx
@@ -0,0 +1,108 @@
+import { useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { Alert, Button, Group, Modal, Stack, Text } from "@mantine/core";
+import { RotateCcw } from "lucide-react";
+import toast from "react-hot-toast";
+
+import { api } from "@/services/api";
+import { bookingsService, type WagonCancellation } from "@/services/bookings.service";
+import { OperationDatePicker } from "./clearance";
+import { formatAmount } from "./BookingDetailPage/utils";
+
+const apiErrorMessage = (error: unknown, fallback: string) => {
+  const data = (error as { response?: { data?: { message?: string | string[] } } })
+    ?.response?.data;
+  if (Array.isArray(data?.message)) return data.message.join(", ");
+  if (data?.message) return data.message;
+  return fallback;
+};
+
+/**
+ * List-row action for a CREDIT_AVAILABLE wagon cancellation: pick a shipment
+ * day, rebook the credit as a new PAID booking, jump to it.
+ */
+export function RebookWagonsButton({
+  cancellation,
+  currency,
+  size = "xs",
+}: {
+  cancellation: WagonCancellation;
+  currency?: string;
+  size?: "xs" | "sm";
+}) {
+  const navigate = useNavigate();
+  const qc = useQueryClient();
+  const [open, setOpen] = useState(false);
+  const [date, setDate] = useState("");
+
+  const rebook = useMutation({
+    mutationFn: () =>
+      bookingsService.rebookWagonCancellation(cancellation.id, { scheduledDate: date }),
+    onSuccess: ({ bookingId }) => {
+      qc.invalidateQueries({ queryKey: api.bookings.list.queryKey() });
+      qc.invalidateQueries({ queryKey: api.bookings.listMyWagonCancellations.queryKey() });
+      toast.success("Wagons rebooked — taking you to the new booking.", { duration: 6000 });
+      setOpen(false);
+      navigate(`/bookings/${bookingId}`);
+    },
+    onError: (e) =>
+      toast.error(apiErrorMessage(e, "Could not rebook the wagons. Please try again.")),
+  });
+
+  return (
+    <>
+      <Button
+        size={size}
+        radius="md"
+        color="edr-green"
+        fw={700}
+        fz={13}
+        leftSection={<RotateCcw size={14} />}
+        onClick={() => setOpen(true)}
+      >
+        Rebook wagons
+      </Button>
+      <Modal
+        opened={open}
+        onClose={() => setOpen(false)}
+        title={
+          <Text fw={800} fz={18} c="#10202F">
+            Rebook cancelled wagons
+          </Text>
+        }
+        centered
+        radius={16}
+      >
+        <Stack gap="md">
+          <Alert color="teal" radius="md">
+            {Number(cancellation.wagonsCancelled)} wagon(s) — credit of{" "}
+            <Text span fw={700}>
+              {formatAmount(cancellation.creditAmount)} {currency ?? ""}
+            </Text>
+            . Pick a shipment day; the new booking is created already paid.
+          </Alert>
+          <OperationDatePicker
+            bookingId={cancellation.bookingId}
+            value={date}
+            onChange={setDate}
+          />
+          <Group justify="flex-end">
+            <Button variant="default" radius="md" onClick={() => setOpen(false)}>
+              Close
+            </Button>
+            <Button
+              color="edr-green"
+              radius="md"
+              disabled={!date}
+              loading={rebook.isPending}
+              onClick={() => rebook.mutate()}
+            >
+              Rebook wagons
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx b/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx
index ee96799b3..fd8739a4a 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx
@@ -95,7 +95,7 @@ export function ClearanceFlow({ booking, flow, footer }: ClearanceFlowProps) {
           {needsCompletion
             ? "Clearance is finalized. Complete your booking now — enter the cargo details and pick a shipment day inside an open booking window."
             : awaitingGlCompletion
-              ? "Customs clearance is complete. Global Logistics is completing your booking (cargo details and shipment day) — you will be notified when payment is due."
+              ? "Customs clearance is complete. Global Logistics is completing your booking (cargo details and shipment day) — you will be notified when payment is due. You can still add documents below until the shipment is paid."
               : clearance.includesCustoms
                 ? "Customs clearance is complete and your cleared documents are available below. You can now proceed to operation."
                 : "Your documents are approved. You can now proceed to operation."}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts b/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts
index 297b0c152..354220e21 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts
@@ -130,13 +130,14 @@ export function getBookingNextAction(
   booking: ActionBooking,
 ): BookingNextAction | null {
   if (booking.status === "CLEARANCE_READY" && isBareInstance(booking)) {
-    // Customs (Path B): GL completes the booking — the customer can only view
-    // the finished clearance in the modal.
+    // Customs (Path B): GL completes the booking, so there is no schedule step
+    // for the customer here — but documents stay open until the shipment is
+    // paid, so the modal is still an action surface, not a read-only view.
     if (booking.customsClearingEnabled) {
       return {
         kind: "SCHEDULE_OPERATION",
-        label: "View clearance",
-        title: "Clearance complete",
+        label: "Documents",
+        title: "Clearance documents",
       };
     }
     // Non-customs (Path A): straight to the booking form — cargo + shipment
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/clearance/useClearanceFlow.ts b/apps/edr-freight-web/portal/src/pages/bookings/clearance/useClearanceFlow.ts
index c50a7c046..17a154d37 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/clearance/useClearanceFlow.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/clearance/useClearanceFlow.ts
@@ -116,8 +116,14 @@ export function useClearanceFlow(booking: Freight.IBooking) {
   // just sees that clearance is done and GL is preparing the booking.
   const awaitingGlCompletion =
     isReady && isBareInstance && Boolean(clearance?.includesCustoms);
+  // Documents stay open until the shipment is paid: a customs shipment keeps
+  // collecting paperwork (amended invoices, revised packing lists) well past
+  // clearance finalization. `documentsOpen` is the server's own predicate, so
+  // the upload control appears exactly when the API would accept a file.
+  // Older API builds omit the field — fall back to the previous rule there.
   const canUpload =
-    status === "AWAITING_DOCUMENTS" || status === "DOCUMENTS_UNDER_REVIEW";
+    clearance?.documentsOpen ??
+    (status === "AWAITING_DOCUMENTS" || status === "DOCUMENTS_UNDER_REVIEW");
   // The very first upload (nothing in review yet). Here every required document
   // must be provided. Once GL has started reviewing (DOCUMENTS_UNDER_REVIEW) the
   // customer is only re-uploading queried/pending docs, so we don't re-gate on
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/LocationPicker.tsx b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/LocationPicker.tsx
index 8832279ad..e38e333fd 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/LocationPicker.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/LocationPicker.tsx
@@ -45,11 +45,16 @@ interface PlacePrediction {
 }
 
 // Maps JavaScript API keys are public client-side keys (lock them down by
-// HTTP-referrer in the Google Cloud console). The env var lets deployments
-// override the default key without a code change.
-const GOOGLE_MAPS_API_KEY =
-  import.meta.env.VITE_GOOGLE_MAPS_API_KEY ||
-  "AIzaSyBg4tN31-fgvH_2Ix_TPo6VSfOA2uA5CCI";
+// HTTP-referrer in the Google Cloud console), so this one env var is the whole
+// configuration. Requires BOTH "Maps JavaScript API" (tiles) and "Places API"
+// (the address search) enabled on the key, or the map draws and the search box
+// silently returns nothing.
+//
+// There is deliberately no fallback key. A hardcoded default used to live here
+// and expired, which degraded a missing env var into a blank map with a search
+// box that spun forever — indistinguishable from a broken picker. Absent config
+// now says so on screen instead.
+const GOOGLE_MAPS_API_KEY = import.meta.env.VITE_GOOGLE_MAPS_API_KEY?.trim();
 
 // Centre of the EDR corridor (Addis Ababa) — a sensible default view.
 const DEFAULT_CENTER = { lat: 9.03, lng: 38.74 };
@@ -191,10 +196,7 @@ async function resolvePrediction(
       },
       (place, status) => {
         const loc = place?.geometry?.location;
-        if (
-          status !== google.maps.places.PlacesServiceStatus.OK ||
-          !loc
-        ) {
+        if (status !== google.maps.places.PlacesServiceStatus.OK || !loc) {
           resolve(null);
           return;
         }
@@ -309,6 +311,7 @@ export function LocationPicker(props: LocationPickerProps) {
     lat: toFiniteNumber(props.value.lat),
     lng: toFiniteNumber(props.value.lng),
   };
+  if (!GOOGLE_MAPS_API_KEY) return <MapUnavailable label={props.label} />;
   return (
     <APIProvider apiKey={GOOGLE_MAPS_API_KEY}>
       {props.variant === "modal" ? (
@@ -320,6 +323,42 @@ export function LocationPicker(props: LocationPickerProps) {
   );
 }
 
+/**
+ * Stands in for the picker when the Maps key is absent. Says which variable is
+ * missing rather than rendering an empty map that reads as a broken feature —
+ * the failure this replaced took a live API request to diagnose.
+ */
+function MapUnavailable({ label }: { label?: string }) {
+  return (
+    <Box>
+      {label && (
+        <Text fz={13} fw={600} c="#10202F" mb={6}>
+          {label}
+        </Text>
+      )}
+      <Box
+        style={{
+          display: "flex",
+          alignItems: "center",
+          gap: 10,
+          borderRadius: 12,
+          padding: "12px 14px",
+          border: "1px solid #F0D2A8",
+          background: "#FFF9F0",
+        }}
+      >
+        <MapPin size={16} color="#B45309" style={{ flexShrink: 0 }} />
+        <Text fz={12.5} c="#8A5A16">
+          Map unavailable — <code>VITE_GOOGLE_MAPS_API_KEY</code> is not set.
+          Add a Google Maps key with the Maps JavaScript API and Places API
+          enabled to this app&apos;s
+          <code> .env</code>, then restart the dev server.
+        </Text>
+      </Box>
+    </Box>
+  );
+}
+
 /** Compact trigger + modal wrapper around the inline picker. */
 function LocationPickerModal({
   value,
@@ -368,7 +407,12 @@ function LocationPickerModal({
         >
           <MapPin size={16} />
         </Box>
-        <Text fz={13.5} c={hasPin ? "#10202F" : "#94A3B8"} lineClamp={1} style={{ flex: 1 }}>
+        <Text
+          fz={13.5}
+          c={hasPin ? "#10202F" : "#94A3B8"}
+          lineClamp={1}
+          style={{ flex: 1 }}
+        >
           {hasPin ? value.address || "Pinned location" : placeholder}
         </Text>
         <Text fz={12.5} fw={600} c="#0A6F4D" style={{ flexShrink: 0 }}>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/payment-currency-field.tsx b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/payment-currency-field.tsx
index d874fb783..fb91b515b 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/payment-currency-field.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/payment-currency-field.tsx
@@ -19,14 +19,25 @@ const CURRENCY_ICONS: Record<
 
 export function PaymentCurrencyField({
   control,
+  allowUsd = false,
 }: {
   control: Control<BookingFormInputValues, any, BookingFormValues>;
+  /**
+   * Offer USD alongside ETB. Import shipments only — export and domestic
+   * traffic is always invoiced in ETB.
+   */
+  allowUsd?: boolean;
 }) {
+  const options = allowUsd
+    ? PAYMENT_CURRENCY_OPTIONS
+    : PAYMENT_CURRENCY_OPTIONS.filter((o) => o.value !== "USD");
   return (
     <Box mt={24}>
       <StepLabel>Payment currency</StepLabel>
       <Text fz={12} c="#6B7C8E" mt={4} mb={12}>
-        Choose the currency for your freight quote and invoices.
+        {allowUsd
+          ? "Choose the currency for your freight quote and invoices. USD is paid by bank transfer, not online."
+          : "Choose the currency for your freight quote and invoices."}
       </Text>
       <Controller
         name="paymentCurrency"
@@ -44,7 +55,7 @@ export function PaymentCurrencyField({
                 border: "1px solid #E6ECF2",
               }}
             >
-              {PAYMENT_CURRENCY_OPTIONS.map((option) => {
+              {options.map((option) => {
                 const Icon = CURRENCY_ICONS[option.value].icon;
                 const selected = field.value === option.value;
                 return (
@@ -97,10 +108,7 @@ export function PaymentCurrencyField({
             </Group>
             {/* Description for the active currency, kept subtle. */}
             <Text fz={11.5} c="#6B7C8E" mt={8}>
-              {
-                PAYMENT_CURRENCY_OPTIONS.find((o) => o.value === field.value)
-                  ?.description
-              }
+              {options.find((o) => o.value === field.value)?.description}
             </Text>
             <OptionFieldError error={fieldState.error} />
           </div>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/schema.ts b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/schema.ts
index c81e5571b..27b669d72 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/schema.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/schema.ts
@@ -81,15 +81,16 @@ export const PAYMENT_CURRENCY_OPTIONS: Array<{
   label: string;
   description: string;
 }> = [
-  {
-    value: "USD",
-    label: "USD",
-    description: "US Dollar — international pricing and invoicing.",
-  },
   {
     value: "ETB",
     label: "ETB",
-    description: "Ethiopian Birr — local pricing and invoicing.",
+    description: "Ethiopian Birr — pay online through the payment gateway.",
+  },
+  // Import shipments only; the field is hidden on export/domestic traffic.
+  {
+    value: "USD",
+    label: "USD",
+    description: "US Dollar — paid by bank transfer, slip sent to Finance.",
   },
 ];
 
@@ -373,7 +374,7 @@ export const initialBookingFormValues: DeepPartial<BookingFormValues> = {
   previousContractRef: "",
 
   serviceTypeId: "",
-  paymentCurrency: "USD",
+  paymentCurrency: "ETB",
   firstMile: {
     enabled: false,
     pickUpAddress: "",
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step-documents.tsx b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step-documents.tsx
index de105bf21..d75092655 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step-documents.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step-documents.tsx
@@ -6,6 +6,7 @@ import { type UseFormReturn } from "react-hook-form";
 
 import useAuth from "@/hooks/useAuth";
 import { api } from "@/services/api";
+import { documentSettingCode } from "@/utils/documentSettingCode";
 import {
   operationToProfileType,
   type BookingDocuments,
@@ -20,13 +21,6 @@ type BookingForm = UseFormReturn<
   BookingFormValues
 >;
 
-/** Onboarding document setting code for the company's nationality. */
-function documentSettingCode(nationality: string | null | undefined): string {
-  return nationality === "foreign"
-    ? "company_onboarding_documents_foreign"
-    : "company_onboarding_documents_ethiopian";
-}
-
 function formatSize(bytes?: number): string {
   if (!bytes) return "";
   if (bytes < 1024) return `${bytes} B`;
@@ -48,14 +42,17 @@ function formatSize(bytes?: number): string {
 export function StepDocuments({ form }: { form: BookingForm }) {
   const auth = useAuth();
 
-  const nationality = auth.company?.company?.nationality as
-    | string
-    | null
-    | undefined;
+  const company = auth.company?.company;
+  const nationality = company?.nationality as string | null | undefined;
 
   const docSettingQuery = useQuery(
     api.fileUploadSettings.getByCode.queryOptions({
-      input: { code: documentSettingCode(nationality) },
+      input: {
+        code: documentSettingCode(
+          nationality,
+          company?.attributes?.cooperative === true,
+        ),
+      },
     }),
   );
 
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step2-service-type.tsx b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step2-service-type.tsx
index 64653abe3..2c51cbb62 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step2-service-type.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step2-service-type.tsx
@@ -40,6 +40,11 @@ export function Step2ServiceType({
     serviceType ?? {};
   const firstMileEnabled = form.watch("firstMile.enabled");
   const lastMileEnabled = form.watch("lastMile.enabled");
+  // The paid-mile service prices the road legs into the booking itself; every
+  // other service defers last-mile billing to after the Djibouti departure
+  // (confirm containers → sign supplementary LM contract → pay advance).
+  const deferredLastMileBilling =
+    serviceType?.code !== "RAIL_CONTAINER_PAID_MILE";
 
   const prevServiceType = useRef(serviceType);
   // Only clear a mile when the current service doesn't include it — this ran
@@ -128,7 +133,11 @@ export function Step2ServiceType({
         )}
       />
 
-      <PaymentCurrencyField control={form.control} />
+      {/* USD billing is import-only; export/intercity stay ETB. */}
+      <PaymentCurrencyField
+        control={form.control}
+        allowUsd={operationType === "import"}
+      />
 
       {showServiceSections && (
         <Stack gap={12} mt={24}>
@@ -205,7 +214,11 @@ export function Step2ServiceType({
                 <ServiceToggle
                   icon={<Truck size={18} />}
                   title="Last Mile — Delivery"
-                  description="Truck delivery from the destination rail yard to the final address (Port to Door)."
+                  description={
+                    deferredLastMileBilling
+                      ? "Truck delivery from the destination rail yard to the final address (Port to Door). Nothing is paid now — last-mile billing starts after your train departs Djibouti."
+                      : "Truck delivery from the destination rail yard to the final address (Port to Door)."
+                  }
                   checked={field.value ?? false}
                   onChange={(value) => {
                     field.onChange(value);
@@ -224,6 +237,15 @@ export function Step2ServiceType({
                 >
                   {lastMileEnabled && (
                     <Box mt="md">
+                      {deferredLastMileBilling && (
+                        <Text size="xs" c="dimmed" mb={10}>
+                          How it works: when your train departs Djibouti, you
+                          will be asked to confirm which containers EDR should
+                          deliver. Once truck availability is approved, you will
+                          sign a short supplementary last-mile contract and pay
+                          the delivery advance — nothing is charged at booking.
+                        </Text>
+                      )}
                       <Controller
                         name="lastMile"
                         control={form.control}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step8-review.tsx b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step8-review.tsx
index b5605f598..57521aaf7 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step8-review.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/new-booking-form/step8-review.tsx
@@ -163,11 +163,20 @@ export function Step8Review({
           .join(", ")
       : "";
 
-  // 20ft containers must pair up (two per wagon) — an odd total blocks submit.
+  // 20ft containers must pair up (two per wagon). Without customs an odd total
+  // still blocks submit — nothing downstream can place the unpaired container.
+  // With customs it is allowed: Global Logistics completes the booking and links
+  // it to another customer's odd booking so the two share the wagon, so an odd
+  // count here is only a notice.
   const { hasOddUnit: hasOdd20ft, ft20Wagons: twentyFtCount } =
     values.cargoType === "container"
       ? calcWagons(values.containers ?? [])
       : { hasOddUnit: false, ft20Wagons: 0 };
+  // Consolidation (pairing an odd 20ft with another customer's odd booking) is
+  // built but switched off for now, so an odd total blocks submit on every path
+  // — customs included.
+  const oddPairsViaCustoms = false;
+  const oddBlocksSubmit = hasOdd20ft;
 
   const isGeneralContract = values.bookingType === "general_contract";
   // Both one-time and general contracts take the bulk amount from the cargo step
@@ -299,7 +308,7 @@ export function Step8Review({
             <DetailRow label="Service" value={serviceType?.name ?? ""} />
             <DetailRow
               label="Payment currency"
-              value={values.paymentCurrency ?? "USD"}
+              value={values.paymentCurrency ?? "ETB"}
             />
             <Button
               type="button"
@@ -543,7 +552,7 @@ export function Step8Review({
             </Paper>
 
             <Paper radius={20} p="lg" withBorder bg="white">
-              {hasOdd20ft ? (
+              {oddBlocksSubmit ? (
                 <Box mb="md">
                   <AlertBox tone="error">
                     <p className="font-semibold">
@@ -558,6 +567,20 @@ export function Step8Review({
                     </p>
                   </AlertBox>
                 </Box>
+              ) : oddPairsViaCustoms ? (
+                <Box mb="md">
+                  <AlertBox tone="info">
+                    <p className="font-semibold">
+                      Odd number of 20ft containers ({twentyFtCount})
+                    </p>
+                    <p className="mt-1 text-xs">
+                      20ft containers travel two per wagon, so one of yours will
+                      share a wagon with another shipment. Global Logistics
+                      arranges the pairing when completing your booking — you are
+                      billed only for your own containers.
+                    </p>
+                  </AlertBox>
+                </Box>
               ) : noWagonForSelectedDay ? (
                 <Box mb="md">
                   <AlertBox tone="error">
@@ -587,7 +610,7 @@ export function Step8Review({
                   leftSection={<Send size={16} />}
                   onClick={onSubmit}
                   loading={submitPending}
-                  disabled={submitPending || hasOdd20ft || noWagonForSelectedDay}
+                  disabled={submitPending || oddBlocksSubmit || noWagonForSelectedDay}
                 >
                   Submit
                 </Button>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/payments/PayNowButton.tsx b/apps/edr-freight-web/portal/src/pages/bookings/payments/PayNowButton.tsx
index 2eb07a0b1..63ca637b5 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/payments/PayNowButton.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/payments/PayNowButton.tsx
@@ -1,11 +1,14 @@
-import { Button, type ButtonProps } from "@mantine/core";
-import { CreditCard } from "lucide-react";
+import { Badge, Button, type ButtonProps } from "@mantine/core";
+import { CreditCard, Landmark } from "lucide-react";
 
 import { Freight } from "@edr/types";
 
 import { ModalSafeWrapper } from "@/components/customer-actions/ModalSafeWrapper";
 import { PaymentMethodModal } from "../BookingDetailPage/components/PaymentMethodModal";
 import { priceTotal } from "../BookingDetailPage/utils";
+import { isUsdOfflineBooking } from "./offline-payment";
+import { payWindowState } from "./payment-drain";
+import { PaymentProcessingNotice } from "./PaymentProcessingNotice";
 import { useBookingPayment } from "./useBookingPayment";
 
 interface PayNowButtonProps {
@@ -28,6 +31,41 @@ export function PayNowButton({
 }: PayNowButtonProps) {
   const pay = useBookingPayment(booking.id);
   const pricing = booking.pricingBreakdown;
+  const payWindow = payWindowState(booking);
+
+  // Pay deadline passed but in-flight payments are still settling: show the
+  // drain countdown instead of any pay action, so nobody pays a second time.
+  // Checked before the USD branch — a bank transfer is just as double-payable.
+  if (payWindow.phase === "draining" && payWindow.drainEndsAt) {
+    return (
+      <PaymentProcessingNotice
+        drainEndsAt={payWindow.drainEndsAt}
+        variant="inline"
+      />
+    );
+  }
+
+  // Window fully over (drain included) — nothing to pay against anymore.
+  if (payWindow.phase === "closed") {
+    return null;
+  }
+
+  // USD is paid by bank transfer and confirmed by Finance — no online payment.
+  if (isUsdOfflineBooking(booking)) {
+    return (
+      <Badge
+        size={size === "xs" ? "md" : "lg"}
+        radius="md"
+        variant="light"
+        color="yellow"
+        fullWidth={fullWidth}
+        leftSection={<Landmark size={12} />}
+        styles={{ label: { textTransform: "none", fontWeight: 700 } }}
+      >
+        Pay by bank transfer
+      </Badge>
+    );
+  }
 
   return (
     <ModalSafeWrapper>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/payments/PayerAccountNote.tsx b/apps/edr-freight-web/portal/src/pages/bookings/payments/PayerAccountNote.tsx
new file mode 100644
index 000000000..73bd4962f
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/bookings/payments/PayerAccountNote.tsx
@@ -0,0 +1,39 @@
+import { Box, Text } from "@mantine/core";
+
+import useAuth from "@/hooks/useAuth";
+
+/**
+ * Red payer-identity warning shown wherever the customer is about to pay:
+ * the transfer must come from a bank account held in the company's registered
+ * name, otherwise Finance will not recognize the payment as paid.
+ */
+export function PayerAccountNote() {
+  const { company } = useAuth();
+  const name = company?.company?.name;
+
+  return (
+    <Box
+      mt={12}
+      p={12}
+      style={{
+        borderRadius: 10,
+        backgroundColor: "#FDEDEB",
+        border: "1px solid #F5C6C0",
+      }}
+    >
+      <Text fz="12.5px" fw={700} c="#C0392B" lh={1.55}>
+        Pay only from a bank account registered under your company name
+        {name ? (
+          <>
+            {" — "}
+            <Text span fw={800} c="#A93226">
+              {name}
+            </Text>
+          </>
+        ) : null}
+        . A payment sent from an account under any other name will not be
+        recognized as paid.
+      </Text>
+    </Box>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/payments/PaymentProcessingNotice.tsx b/apps/edr-freight-web/portal/src/pages/bookings/payments/PaymentProcessingNotice.tsx
new file mode 100644
index 000000000..56b7897ee
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/bookings/payments/PaymentProcessingNotice.tsx
@@ -0,0 +1,84 @@
+import { useEffect, useState } from "react";
+import { Box, Group, Text } from "@mantine/core";
+import { Loader2 } from "lucide-react";
+
+/** mm:ss left until `target`; clamped at zero so it never shows a negative. */
+function secondsLeft(target: number, now: number): string {
+  const total = Math.max(0, Math.ceil((target - now) / 1000));
+  const minutes = Math.floor(total / 60);
+  const seconds = total % 60;
+  return `${minutes}:${String(seconds).padStart(2, "0")}`;
+}
+
+export interface PaymentProcessingNoticeProps {
+  /** ISO end of the drain tail — the countdown target. */
+  drainEndsAt: string;
+  /** Compact single-line form for list rows; full block for the detail page. */
+  variant?: "inline" | "block";
+  /** Called once the drain elapses, so the parent can refetch the new state. */
+  onElapsed?: () => void;
+}
+
+/**
+ * Shown in place of "Pay now" during the settlement drain tail: the pay deadline
+ * has passed but in-flight payments are still landing, so the customer waits
+ * rather than paying again.
+ */
+export function PaymentProcessingNotice({
+  drainEndsAt,
+  variant = "block",
+  onElapsed,
+}: PaymentProcessingNoticeProps) {
+  const targetMs = new Date(drainEndsAt).getTime();
+  const [now, setNow] = useState(() => Date.now());
+
+  useEffect(() => {
+    setNow(Date.now());
+    const interval = setInterval(() => {
+      const next = Date.now();
+      setNow(next);
+      if (next >= targetMs) {
+        clearInterval(interval);
+        onElapsed?.();
+      }
+    }, 1000);
+    return () => clearInterval(interval);
+  }, [targetMs, onElapsed]);
+
+  const remaining = secondsLeft(targetMs, now);
+
+  if (variant === "inline") {
+    return (
+      <Group gap={6} align="center" wrap="nowrap">
+        <Loader2 size={13} color="#B07D14" className="animate-spin" />
+        <Text fz={12} fw={700} c="#B07D14" style={{ whiteSpace: "nowrap" }}>
+          Processing · {remaining}
+        </Text>
+      </Group>
+    );
+  }
+
+  return (
+    <Box
+      mt={14}
+      p={14}
+      style={{
+        borderRadius: 10,
+        backgroundColor: "#FEF6E6",
+        border: "1px solid #F3E2B8",
+      }}
+    >
+      <Group gap={8} align="center" wrap="nowrap">
+        <Loader2 size={15} color="#9A5B00" className="animate-spin" />
+        <Text fz="13px" fw={800} c="#9A5B00">
+          Payment processing — {remaining} left
+        </Text>
+      </Group>
+      <Text mt={4} fz="12.5px" c="#7A5A1E" lh={1.55}>
+        The payment window has closed and we&apos;re confirming the payments that
+        came in. If you already paid, it can take a few minutes to appear —
+        please don&apos;t pay again. This page updates on its own.
+      </Text>
+    </Box>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/payments/offline-payment.ts b/apps/edr-freight-web/portal/src/pages/bookings/payments/offline-payment.ts
new file mode 100644
index 000000000..92c94940d
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/bookings/payments/offline-payment.ts
@@ -0,0 +1,16 @@
+import type { Freight } from "@edr/types";
+
+/**
+ * USD bookings are never paid online: the customer pays by bank transfer and
+ * the Finance department confirms the payment from the slip. Phase 1 is
+ * portal-only — Finance's confirm flow lands in the backoffice later.
+ */
+export function isUsdCurrency(currency?: string | null): boolean {
+  return currency?.toUpperCase() === "USD";
+}
+
+export function isUsdOfflineBooking(booking: Freight.IBooking): boolean {
+  return isUsdCurrency(
+    booking.pricingBreakdown?.currency ?? booking.paymentCurrency,
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/payments/payment-drain.ts b/apps/edr-freight-web/portal/src/pages/bookings/payments/payment-drain.ts
new file mode 100644
index 000000000..61d97864b
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/bookings/payments/payment-drain.ts
@@ -0,0 +1,60 @@
+import { Freight } from "@edr/types";
+
+/**
+ * Where a booking sits relative to its pay window.
+ *
+ * - `open`     — the window is live; the customer can pay.
+ * - `draining` — the deadline passed but the settlement drain tail has not. A
+ *                payment started just before the buzzer may still be settling,
+ *                so we show "processing" and hide every pay action rather than
+ *                invite a second payment for the same booking.
+ * - `closed`   — the drain tail elapsed too; the window is over.
+ * - `none`     — no deadline on the booking (nothing to gate).
+ */
+export type PayWindowPhase = "open" | "draining" | "closed" | "none";
+
+export interface PayWindowState {
+  phase: PayWindowPhase;
+  /** True only while the customer may actually start a payment. */
+  canPay: boolean;
+  /** End of the drain tail — the countdown target while `draining`. */
+  drainEndsAt: string | null;
+}
+
+type PayableBooking = Pick<
+  Freight.IBooking,
+  "paymentDeadline" | "paymentDrainEndsAt"
+>;
+
+/**
+ * Classify a booking's pay window against `now`.
+ *
+ * Falls back to the raw deadline when the server sent no `paymentDrainEndsAt`
+ * (older payload): with no known tail there is no drain to wait out, so the
+ * window goes straight from open to closed.
+ */
+export function payWindowState(
+  booking: PayableBooking | null | undefined,
+  now: number = Date.now(),
+): PayWindowState {
+  const deadline = booking?.paymentDeadline ?? null;
+  if (!deadline) {
+    return { phase: "none", canPay: true, drainEndsAt: null };
+  }
+
+  const deadlineMs = new Date(deadline).getTime();
+  if (!Number.isFinite(deadlineMs)) {
+    return { phase: "none", canPay: true, drainEndsAt: null };
+  }
+  if (now < deadlineMs) {
+    return { phase: "open", canPay: true, drainEndsAt: null };
+  }
+
+  const drainRaw = booking?.paymentDrainEndsAt ?? null;
+  const drainMs = drainRaw ? new Date(drainRaw).getTime() : NaN;
+  if (Number.isFinite(drainMs) && now < drainMs) {
+    return { phase: "draining", canPay: false, drainEndsAt: drainRaw };
+  }
+
+  return { phase: "closed", canPay: false, drainEndsAt: null };
+}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/resubmit/useBookingDocumentSetting.ts b/apps/edr-freight-web/portal/src/pages/bookings/resubmit/useBookingDocumentSetting.ts
index 65774f97f..31d42f6cd 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/resubmit/useBookingDocumentSetting.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/resubmit/useBookingDocumentSetting.ts
@@ -2,15 +2,9 @@ import { useQuery } from "@tanstack/react-query";
 
 import useAuth from "@/hooks/useAuth";
 import { api } from "@/services/api";
+import { documentSettingCode } from "@/utils/documentSettingCode";
 
-/** Onboarding document setting code for the company's nationality. */
-export function documentSettingCode(
-  nationality: string | null | undefined,
-): string {
-  return nationality === "foreign"
-    ? "company_onboarding_documents_foreign"
-    : "company_onboarding_documents_ethiopian";
-}
+export { documentSettingCode };
 
 /**
  * Fetches the FileUploadSetting that describes the documents a booking requires
@@ -22,14 +16,17 @@ export function documentSettingCode(
  */
 export function useBookingDocumentSetting() {
   const auth = useAuth();
-  const nationality = auth.company?.company?.nationality as
-    | string
-    | null
-    | undefined;
+  const company = auth.company?.company;
+  const nationality = company?.nationality as string | null | undefined;
 
   return useQuery(
     api.fileUploadSettings.getByCode.queryOptions({
-      input: { code: documentSettingCode(nationality) },
+      input: {
+        code: documentSettingCode(
+          nationality,
+          company?.attributes?.cooperative === true,
+        ),
+      },
     }),
   );
 }
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/ContractBookingWindowsSection.tsx b/apps/edr-freight-web/portal/src/pages/contracts/ContractBookingWindowsSection.tsx
index c4fa72977..73295cda0 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/ContractBookingWindowsSection.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/ContractBookingWindowsSection.tsx
@@ -211,6 +211,19 @@ function WindowCard({ w }: { w: MyBookingWindow }) {
                 </Text>
               </Fragment>
             ))}
+            {w.trainNumber ? (
+              <Text
+                fz={13}
+                fw={700}
+                style={{
+                  color: INK,
+                  flexShrink: 0,
+                  fontVariantNumeric: "tabular-nums",
+                }}
+              >
+                Train {w.trainNumber}
+              </Text>
+            ) : null}
           </Group>
 
           <Group gap={6} wrap="nowrap" mt={8}>
@@ -221,7 +234,7 @@ function WindowCard({ w }: { w: MyBookingWindow }) {
           </Group>
           {w.departureDate ? (
             <Text fz={12} style={{ color: MUTED }}>
-              Departs {fmtDay(w.departureDate)}
+              Departs {fmtDay(w.departureDate)}, {fmtTime(w.departureDate)}
             </Text>
           ) : null}
         </Box>
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/ContractDetailPage.tsx b/apps/edr-freight-web/portal/src/pages/contracts/ContractDetailPage.tsx
index 6ceb1fb69..ded69afb1 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/ContractDetailPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/ContractDetailPage.tsx
@@ -64,6 +64,7 @@ import {
 } from "@/pages/bookings/booking-display";
 import { InitiateBookingButton } from "@/components/customer-actions/ContractCustomerAction";
 import { formatRateUnit } from "./new-contract-form/unit-rates";
+import { formatAmount } from "./new-shipment-form/total";
 import { bookingDocNoun } from "@/pages/bookings/clearance/bookingNextAction";
 import { getContractBookingAction } from "./contract-booking-action";
 import { closedWindowMessage, hasOpenWindow } from "./booking-window";
@@ -719,7 +720,7 @@ export default function ContractDetailPage() {
                     )}
                   </Box>
                   <Text fz={14} fw={700} style={{ color: GREEN }}>
-                    {(item.unitPrice ?? 0).toLocaleString()} {pricing.currency}{" "}
+                    {formatAmount(item.unitPrice)} {pricing.currency}{" "}
                     <Text span fz={12} fw={600} c="dimmed">
                       / {formatRateUnit(item.unit)}
                     </Text>
@@ -1336,9 +1337,7 @@ export default function ContractDetailPage() {
                                   whiteSpace: "nowrap",
                                 }}
                               >
-                                {amount > 0
-                                  ? `ETB ${amount.toLocaleString()}`
-                                  : "—"}
+                                {amount > 0 ? `ETB ${formatAmount(amount)}` : "—"}
                               </Text>
                             </Table.Td>
                           </Table.Tr>
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/ContractViewPage.tsx b/apps/edr-freight-web/portal/src/pages/contracts/ContractViewPage.tsx
index 8f13e1466..e812c12b6 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/ContractViewPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/ContractViewPage.tsx
@@ -6,15 +6,20 @@ import {
   Box,
   Button,
   Checkbox,
+  CloseButton,
+  Drawer,
+  Flex,
   Group,
   Image,
   Loader,
   Modal,
   Paper,
   PinInput,
+  ScrollArea,
   Stack,
   Text,
   TextInput,
+  ThemeIcon,
 } from "@mantine/core";
 import {
   ArrowLeft,
@@ -24,6 +29,7 @@ import {
   RotateCw,
   ShieldCheck,
 } from "lucide-react";
+import { useMediaQuery } from "@mantine/hooks";
 import toast from "react-hot-toast";
 
 import { ContractSignSuccessModal } from "@/components/contracts/ContractSignSuccessModal";
@@ -44,6 +50,9 @@ export default function ContractViewPage() {
   const navigate = useNavigate();
   const qc = useQueryClient();
   const iframeRef = useRef<HTMLIFrameElement>(null);
+  // Below Mantine's `sm`: the signing surfaces go full-bleed and the consent
+  // bar stacks, so the checkbox and its button stop crowding each other.
+  const isMobile = useMediaQuery("(max-width: 48em)");
 
   const [signOpen, setSignOpen] = useState(false);
   const [otpOpen, setOtpOpen] = useState(false);
@@ -225,9 +234,29 @@ export default function ContractViewPage() {
   return (
     <Box
       p={{ base: "md", md: "xl" }}
-      pb={data.canSignCustomer ? 120 : undefined}
+      style={{
+        // Lock the page to the viewport so the contract iframe is the ONLY
+        // scroll container — page scroll + iframe scroll together made the
+        // sign flow slippery. The negative margin cancels AppShell.Main's
+        // global 112px bottom clearance (see AppLayout) for this page only;
+        // the sign bar below already keeps content clear of the chat FAB.
+        height: "calc(100dvh - var(--app-shell-header-offset, 72px))",
+        marginBottom: -112,
+        display: "flex",
+        flexDirection: "column",
+      }}
     >
-      <Box maw={920} mx="auto">
+      <Box
+        maw={920}
+        mx="auto"
+        w="100%"
+        style={{
+          flex: 1,
+          minHeight: 0,
+          display: "flex",
+          flexDirection: "column",
+        }}
+      >
         <Group justify="space-between" wrap="wrap" gap="sm" mb="md">
           <Button
             variant="subtle"
@@ -270,15 +299,24 @@ export default function ContractViewPage() {
           </Alert>
         )}
 
-        <Paper withBorder radius="lg" p={0} style={{ overflow: "hidden" }}>
+        <Paper
+          withBorder
+          radius="lg"
+          p={0}
+          // minHeight keeps the document usable on short/landscape viewports;
+          // the page then overflows and window-scrolls a little, which beats
+          // an unreadably squashed iframe.
+          style={{ overflow: "hidden", flex: 1, minHeight: 220 }}
+        >
           <iframe
             ref={iframeRef}
             srcDoc={data.html}
             title="Contract document"
             onLoad={handleIframeLoad}
             style={{
+              display: "block",
               width: "100%",
-              minHeight: "80vh",
+              height: "100%",
               border: "none",
               background: "white",
             }}
@@ -286,97 +324,179 @@ export default function ContractViewPage() {
         </Paper>
       </Box>
 
-      {data.canSignCustomer && hasScrolledToBottom && (
+      {data.canSignCustomer && hasScrolledToBottom && !signOpen && !otpOpen && !successOpen && (
         <Paper
           withBorder
           radius="lg"
           p="md"
+          mt="md"
+          w="100%"
+          maw={920}
+          mx="auto"
           style={{
-            position: "fixed",
-            bottom: 0,
-            left: 0,
-            right: 0,
-            zIndex: 100,
-            borderTop: "1px solid var(--mantine-color-gray-3)",
+            // No z-index escalation here: raising this bar above the chat FAB
+            // is what made it fight every overlay on the page. It keeps clear
+            // of the fixed FAB by leaving room for it instead (paddingRight on
+            // wide screens, where the FAB sits beside the bar's right edge).
             background: "var(--mantine-color-body)",
-            paddingBottom: 32,
           }}
+          pr={{ base: "md", sm: 88 }}
         >
-          <Box maw={920} mx="auto">
-            <Stack gap="sm">
-              <Checkbox
-                checked={agreedToTerms}
-                onChange={(e) => setAgreedToTerms(e.currentTarget.checked)}
-                disabled={!hasScrolledToBottom}
-                label={CONSENT_TEXT}
-                description={
-                  hasScrolledToBottom
-                    ? "You may now sign the contract."
-                    : "Read the full contract above before you can agree and sign."
-                }
-              />
-              <Group justify="flex-end">
-                <Button
-                  color="edr-green"
-                  leftSection={<FileSignature size={16} />}
-                  disabled={!canProceedToSign}
-                  onClick={openSign}
-                >
-                  {usingSaved ? "Approve & sign" : "Sign contract"}
-                </Button>
-              </Group>
-            </Stack>
-          </Box>
+          <Flex
+            direction={{ base: "column", sm: "row" }}
+            align={{ base: "stretch", sm: "center" }}
+            justify="space-between"
+            gap="sm"
+          >
+            <Checkbox
+              checked={agreedToTerms}
+              onChange={(e) => setAgreedToTerms(e.currentTarget.checked)}
+              disabled={!hasScrolledToBottom}
+              label={CONSENT_TEXT}
+              description={
+                hasScrolledToBottom
+                  ? "You may now sign the contract."
+                  : "Read the full contract above before you can agree and sign."
+              }
+            />
+            <Button
+              color="edr-green"
+              leftSection={<FileSignature size={16} />}
+              disabled={!canProceedToSign}
+              onClick={openSign}
+              fullWidth={isMobile}
+              style={{ flexShrink: 0 }}
+            >
+              {usingSaved ? "Approve & sign" : "Sign contract"}
+            </Button>
+          </Flex>
         </Paper>
       )}
 
-      <Modal
+      {/* A right-hand drawer, not a centered dialog: the sign step shares the
+          bottom-right corner with the agree-and-sign bar and the support-chat
+          FAB, and a full-height side panel simply never contends with them. */}
+      <Drawer
         opened={signOpen}
         onClose={() => setSignOpen(false)}
-        title={usingSaved ? "Approve signature" : "Sign contract"}
-        centered
-        radius="lg"
+        position={isMobile ? "bottom" : "right"}
+        size={isMobile ? "100%" : "lg"}
+        padding={0}
+        withCloseButton={false}
+        // Clear of the sign bar (301) and the chat FAB's Affix (300).
+        zIndex={400}
+        overlayProps={{ backgroundOpacity: 0.55, blur: 3 }}
+        // Drawer.Body has no intrinsic height, so the inner flex column (pinned
+        // header / scrolling middle / pinned footer) would collapse without this.
+        styles={{
+          content: { display: "flex", flexDirection: "column" },
+          body: { flex: 1, minHeight: 0, display: "flex", flexDirection: "column" },
+        }}
       >
-        <Stack gap="md">
-          <Text size="sm" c="dimmed">
-            {data.reference} — your signature is stored securely on the
-            contract.
-          </Text>
+        <>
+          {/* Header — pinned, so the contract reference stays visible while the
+              signature and stamp sections scroll. */}
+          <Group
+            justify="space-between"
+            wrap="nowrap"
+            p="lg"
+            style={{
+              borderBottom: "1px solid var(--mantine-color-gray-2)",
+              flexShrink: 0,
+            }}
+          >
+            <Group gap="sm" wrap="nowrap">
+              <ThemeIcon size={38} radius="md" variant="light" color="edr-green">
+                <FileSignature size={19} />
+              </ThemeIcon>
+              <Box>
+                <Text fw={600}>
+                  {usingSaved ? "Approve signature" : "Sign contract"}
+                </Text>
+                <Text size="xs" c="dimmed">
+                  {data.reference}
+                </Text>
+              </Box>
+            </Group>
+            <CloseButton size="lg" onClick={() => setSignOpen(false)} />
+          </Group>
+
+          <ScrollArea style={{ flex: 1, minHeight: 0 }}>
+            <Stack gap="lg" p="lg">
           <TextInput
             label="Full name"
+            description="Printed under your signature on the contract."
+            placeholder="Name as it should appear on the contract"
+            withAsterisk
             value={signerName}
             onChange={(e) => setSignerName(e.currentTarget.value)}
           />
-          {usingSaved ? (
-            <Stack gap="xs">
+
+          <Box>
+            <Group justify="space-between" align="center" mb={6} wrap="nowrap">
+              <Text size="sm" fw={500}>
+                Signature{" "}
+                <Text span c="red">
+                  *
+                </Text>
+              </Text>
+              {usingSaved ? (
+                <Button
+                  variant="subtle"
+                  size="compact-xs"
+                  color="edr-green"
+                  leftSection={<RotateCw size={13} />}
+                  onClick={() => {
+                    setDrawNew(true);
+                    setSignatureData(null);
+                  }}
+                >
+                  Draw a new one
+                </Button>
+              ) : savedSignatureImage ? (
+                <Button
+                  variant="subtle"
+                  size="compact-xs"
+                  color="gray"
+                  onClick={() => {
+                    setDrawNew(false);
+                    setSignatureData(null);
+                  }}
+                >
+                  Use saved signature
+                </Button>
+              ) : null}
+            </Group>
+            {usingSaved ? (
               <Paper
                 withBorder
                 radius="md"
-                p="xs"
-                style={{ borderStyle: "dashed" }}
+                p="sm"
+                style={{
+                  borderStyle: "dashed",
+                  background: "var(--mantine-color-gray-0)",
+                }}
               >
                 <Image
                   src={savedSignatureImage ?? undefined}
                   alt="Saved signature"
                   fit="contain"
-                  h={140}
+                  h={120}
                 />
+                <Group gap={6} mt="xs" justify="center" wrap="nowrap">
+                  <ShieldCheck
+                    size={13}
+                    color="var(--mantine-color-edr-green-6)"
+                  />
+                  <Text size="xs" c="dimmed">
+                    Saved signature — stored securely on your profile
+                  </Text>
+                </Group>
               </Paper>
-              <Button
-                variant="subtle"
-                size="compact-xs"
-                color="edr-green"
-                onClick={() => {
-                  setDrawNew(true);
-                  setSignatureData(null);
-                }}
-              >
-                Draw a new signature instead
-              </Button>
-            </Stack>
-          ) : (
-            <ContractSignaturePad onChange={setSignatureData} />
-          )}
+            ) : (
+              <ContractSignaturePad onChange={setSignatureData} />
+            )}
+          </Box>
 
           <StampUpload
             value={stampData}
@@ -384,26 +504,47 @@ export default function ContractViewPage() {
             description="Attach your official company stamp or seal — it is applied to the contract next to your signature."
           />
 
-          <Group justify="flex-end" gap="sm">
-            <Button variant="default" onClick={() => setSignOpen(false)}>
-              Cancel
-            </Button>
-            <Button
-              color="edr-green"
-              loading={sendOtpMutation.isPending}
-              disabled={
-                sendOtpMutation.isPending ||
-                !signerName.trim() ||
-                (!usingSaved && !signatureData) ||
-                !stampData
-              }
-              onClick={confirmSign}
-            >
-              Continue to verification
-            </Button>
-          </Group>
-        </Stack>
-      </Modal>
+            </Stack>
+          </ScrollArea>
+
+          {/* Footer — pinned, so the primary action never scrolls out of reach. */}
+          <Stack
+            gap="sm"
+            p="lg"
+            style={{
+              borderTop: "1px solid var(--mantine-color-gray-2)",
+              background: "var(--mantine-color-body)",
+              flexShrink: 0,
+            }}
+          >
+            <Group gap={6} wrap="nowrap">
+              <ShieldCheck size={14} color="var(--mantine-color-dimmed)" />
+              <Text size="xs" c="dimmed">
+                We send a 6-digit code to your registered contacts next.
+              </Text>
+            </Group>
+            <Group gap="sm" grow>
+              <Button variant="default" onClick={() => setSignOpen(false)}>
+                Cancel
+              </Button>
+              <Button
+                color="edr-green"
+                leftSection={<ShieldCheck size={16} />}
+                loading={sendOtpMutation.isPending}
+                disabled={
+                  sendOtpMutation.isPending ||
+                  !signerName.trim() ||
+                  (!usingSaved && !signatureData) ||
+                  !stampData
+                }
+                onClick={confirmSign}
+              >
+                Continue to verification
+              </Button>
+            </Group>
+          </Stack>
+        </>
+      </Drawer>
 
       <Modal
         opened={otpOpen}
@@ -411,6 +552,10 @@ export default function ContractViewPage() {
         title="Verify it's you"
         centered
         radius="lg"
+        zIndex={400}
+        // Full-bleed on phones — a centered dialog plus the fixed chat FAB left
+        // the code entry and its buttons fighting for the same few pixels.
+        fullScreen={isMobile}
       >
         <Stack gap="md">
           <Group gap="sm" wrap="nowrap">
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 f465ca849..f32890a14 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/ContractsList.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/ContractsList.tsx
@@ -71,6 +71,16 @@ export default function ContractsList() {
   const [disclaimerOpen, setDisclaimerOpen] = useState(false);
   const [freightFilter, setFreightFilter] = useState<string | null>(null);
   const [kindFilter, setKindFilter] = useState<string | null>(null);
+  const [serviceFilter, setServiceFilter] = useState<string | null>(null);
+
+  // Service-type options — same reference-data payload the contract form uses.
+  const { data: refData } = useQuery(
+    api.bookings.referenceData.queryOptions({ staleTime: 5 * 60_000 }),
+  );
+  const serviceTypeOptions = useMemo(
+    () => (refData?.service ?? []).map((s) => ({ value: s.id, label: s.name })),
+    [refData],
+  );
   const [createdFrom, setCreatedFrom] = useState<string>("");
   const [createdTo, setCreatedTo] = useState<string>("");
   const [expanded, setExpanded] = useState<Set<string>>(new Set());
@@ -96,10 +106,11 @@ export default function ContractsList() {
   const resetPage = () =>
     setPagination({ pageIndex: 0, pageSize: pagination.pageSize });
   const hasExtraFilters =
-    !!freightFilter || !!kindFilter || !!createdFrom || !!createdTo;
+    !!freightFilter || !!kindFilter || !!serviceFilter || !!createdFrom || !!createdTo;
   const clearExtraFilters = () => {
     setFreightFilter(null);
     setKindFilter(null);
+    setServiceFilter(null);
     setCreatedFrom("");
     setCreatedTo("");
     resetPage();
@@ -109,6 +120,7 @@ export default function ContractsList() {
     () => ({
       contractKind: kindFilter ?? undefined,
       freightType: freightFilter ?? undefined,
+      serviceTypeId: serviceFilter ?? undefined,
       createdFrom: createdFrom || undefined,
       createdTo: createdTo ? `${createdTo}T23:59:59.999Z` : undefined,
       // Server-side free-text search (contract reference, company name).
@@ -121,6 +133,7 @@ export default function ContractsList() {
     [
       kindFilter,
       freightFilter,
+      serviceFilter,
       createdFrom,
       createdTo,
       debouncedQuery,
@@ -322,6 +335,21 @@ export default function ContractsList() {
               styles={{ input: { height: 42 } }}
               aria-label="Filter by cargo type"
             />
+            <Select
+              placeholder="Any service"
+              data={serviceTypeOptions}
+              value={serviceFilter}
+              onChange={(v) => {
+                setServiceFilter(v);
+                resetPage();
+              }}
+              clearable
+              radius="md"
+              comboboxProps={{ withinPortal: true }}
+              style={{ width: 180 }}
+              styles={{ input: { height: 42 } }}
+              aria-label="Filter by service type"
+            />
             <TextInput
               type="date"
               value={createdFrom}
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentPage.tsx b/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentPage.tsx
index 63070003a..347cdd2bb 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentPage.tsx
@@ -75,7 +75,7 @@ import {
   createShipmentFormSchema,
   initialShipmentFormValues,
 } from "./new-shipment-form/schema";
-import { computeShipmentTotal } from "./new-shipment-form/total";
+import { computeShipmentTotal, formatAmount } from "./new-shipment-form/total";
 import {
   downloadContainerImportTemplate,
   parseContainerExcel,
@@ -281,7 +281,7 @@ function mapBookingToShipmentValues(
     }>;
   };
   const values: Partial<ShipmentFormInputValues> = {
-    paymentCurrency: booking.paymentCurrency === "ETB" ? "ETB" : "USD",
+    paymentCurrency: "ETB",
     withReturn: booking.equipmentReturn === "WITH_RETURN",
     cargoDescription: b.cargoFreeText ?? "",
     ...(b.contractRouteId ? { contractRouteId: b.contractRouteId } : {}),
@@ -390,11 +390,8 @@ function NewShipmentBookingForm({
       // Seed the equipment-return toggle from the contract; the customer can
       // still flip it per shipment.
       withReturn: contract.equipmentReturn === "WITH_RETURN",
-      // The contract quotes USD; the customer bills this shipment in the
-      // currency they pick here. Intercity is always ETB, so it is preset;
-      // everything else starts empty so the customer picks deliberately
-      // instead of silently inheriting USD.
-      paymentCurrency: contract.tradeDirection === "DOMESTIC" ? "ETB" : "",
+      // ponytail: ETB-only for now — preset since there is no other choice.
+      paymentCurrency: "ETB",
     },
     resolver: zodResolver(
       createShipmentFormSchema({
@@ -1017,7 +1014,7 @@ function PriceConfirmModal({
                 ))}
                 <Text fz="xs" c="#9A5B00" mt={2}>
                   {overweightSurchargeAmount > 0
-                    ? `An overweight surcharge of ${overweightSurchargeAmount.toLocaleString()} ${
+                    ? `An overweight surcharge of ${formatAmount(overweightSurchargeAmount)} ${
                         validation?.currency ?? total?.currency ?? ""
                       } applies (included in the total below). You can still submit, or go back and adjust weights.`
                     : "An overweight surcharge applies. You can still submit, or go back and adjust weights."}
@@ -1041,7 +1038,7 @@ function PriceConfirmModal({
                     </Text>
                     <Text fz="xs" c="dimmed">
                       {line.quantity.toLocaleString()} ×{" "}
-                      {line.unitPrice.toLocaleString()} {total.currency} ·{" "}
+                      {formatAmount(line.unitPrice)} {total.currency} ·{" "}
                       {formatRateUnit(line.unit)}
                     </Text>
                   </Box>
@@ -1051,7 +1048,7 @@ function PriceConfirmModal({
                     c="#10202F"
                     style={{ whiteSpace: "nowrap" }}
                   >
-                    {line.amount.toLocaleString()} {total.currency}
+                    {formatAmount(line.amount)} {total.currency}
                   </Text>
                 </Group>
               ))}
@@ -1073,7 +1070,7 @@ function PriceConfirmModal({
                 Total
               </Text>
               <Text fw={800} fz={28} c="#10202F">
-                {total.total.toLocaleString()}{" "}
+                {formatAmount(total.total)}{" "}
                 <Text span fz={16} fw={700} c="edr-muted">
                   {total.currency}
                 </Text>
@@ -1218,6 +1215,9 @@ function ScheduleStep({
   })();
 
   const isIntercity = contract.tradeDirection === "DOMESTIC";
+  // USD billing is offered on import traffic only — export and domestic
+  // shipments are always invoiced in ETB.
+  const isImport = contract.tradeDirection === "IMPORT";
   const { data: availableDays, isLoading } = useQuery({
     ...api.bookings.getAvailableDaysForCargo.queryOptions({
       input:
@@ -1313,13 +1313,15 @@ function ScheduleStep({
           <Box mb="lg">
             <StepLabel>Billing currency *</StepLabel>
             <Text fz={12.5} c="dimmed" mt={4} mb={10}>
-              Your contract is quoted in USD. Pick the currency this shipment is
-              invoiced in — the total is converted for you.
+              {isImport
+                ? "Import shipments may be invoiced in ETB or USD. USD is paid by bank transfer, not online."
+                : "Shipments are invoiced in ETB."}
             </Text>
             <CurrencySelector
               value={field.value || ""}
               onChange={(v) => field.onChange(v)}
               error={fieldState.error?.message}
+              allowUsd={isImport}
             />
           </Box>
         )}
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentRequestPage.tsx b/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentRequestPage.tsx
index f5be74416..b69c83b05 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentRequestPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/NewShipmentRequestPage.tsx
@@ -87,6 +87,8 @@ export default function NewShipmentRequestPage() {
     contract.contractKind === "GENERAL" &&
     (contract.serviceType?.includesCustoms ?? contract.customsClearingEnabled);
   const isIntercity = contract.tradeDirection === "DOMESTIC";
+  // Export shipments are invoiced in ETB only — USD is not offered.
+  const isExport = contract.tradeDirection === "EXPORT";
 
   // Only the container sizes the contract was scoped for (20ft, 40ft, or both).
   const SIZE_ORDER = ["20ft", "40ft"];
@@ -104,9 +106,10 @@ export default function NewShipmentRequestPage() {
     contract.cargoScope?.[0];
   const isPerItem = bulkScope?.cargoType?.unitOfMeasure === "PER_ITEM";
 
-  // 20ft containers ride two per wagon, so an odd total can never be planned —
-  // and GL's create-booking form blocks it too, so an odd request would only
-  // dead-end there. Same even-number rule the booking forms apply.
+  // 20ft containers ride two per wagon, so an odd total leaves one unpaired and
+  // the request cannot be planned. Consolidation (pairing the odd container with
+  // another customer's odd booking) is built but switched off for now, so an odd
+  // request is blocked here rather than dead-ending downstream.
   const ft20Requested = isContainer ? Number(qtyBySize["20ft"]) || 0 : 0;
   const hasOdd20ft = ft20Requested % 2 === 1;
 
@@ -115,7 +118,7 @@ export default function NewShipmentRequestPage() {
     const dto: Freight.CreateBookingRequestDto = {
       contractRouteId: route?.id,
       scheduledDate: hasCustoms ? undefined : scheduledDate || undefined,
-      paymentCurrency: isIntercity ? "ETB" : paymentCurrency,
+      paymentCurrency: isIntercity || isExport ? "ETB" : paymentCurrency,
       notes: notes.trim() || undefined,
     };
 
@@ -246,16 +249,22 @@ export default function NewShipmentRequestPage() {
               <Text size="xs" c="dimmed" mb={8}>
                 {isIntercity
                   ? "Intercity shipments are invoiced in ETB."
-                  : "Your contract is quoted in USD. Global Logistics will book this shipment and invoice you in the currency you pick here."}
+                  : isExport
+                    ? "Export shipments are invoiced in ETB."
+                    : "Your contract is quoted in USD. Global Logistics will book this shipment and invoice you in the currency you pick here."}
               </Text>
               <SegmentedControl
-                value={isIntercity ? "ETB" : paymentCurrency}
+                value={isIntercity || isExport ? "ETB" : paymentCurrency}
                 onChange={(v) => setPaymentCurrency(v as "USD" | "ETB")}
-                disabled={isIntercity}
-                data={[
-                  { label: "USD", value: "USD" },
-                  { label: "ETB", value: "ETB" },
-                ]}
+                disabled={isIntercity || isExport}
+                data={
+                  isExport
+                    ? [{ label: "ETB", value: "ETB" }]
+                    : [
+                        { label: "USD", value: "USD" },
+                        { label: "ETB", value: "ETB" },
+                      ]
+                }
                 color="teal"
                 radius={10}
               />
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/ContractDocsEditor.tsx b/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/ContractDocsEditor.tsx
index 4d966e010..9d045c4e7 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/ContractDocsEditor.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/ContractDocsEditor.tsx
@@ -7,6 +7,7 @@ import type { Freight } from "@edr/types";
 import { useQuery } from "@tanstack/react-query";
 import useAuth from "@/hooks/useAuth";
 import { api } from "@/services/api";
+import { documentSettingCode } from "@/utils/documentSettingCode";
 import type { CompanyDocument } from "@/services/companies.service";
 import { downloadStoredFile } from "@/services/files.service";
 import { labelForDocCode } from "@/pages/bookings/resubmit/resubmitDocs";
@@ -15,13 +16,6 @@ import { BORDER, GREEN, INK } from "../contract-ui";
 type DocumentsValue = Record<string, File | File[] | null>;
 type ContractFile = NonNullable<Freight.IContract["files"]>[number];
 
-/** Onboarding document setting code for the company's nationality. */
-function documentSettingCode(nationality: string | null | undefined): string {
-  return nationality === "foreign"
-    ? "company_onboarding_documents_foreign"
-    : "company_onboarding_documents_ethiopian";
-}
-
 function hasFile(value: File | File[] | null | undefined): boolean {
   if (!value) return false;
   return Array.isArray(value) ? value.length > 0 : true;
@@ -95,13 +89,16 @@ export function ContractDocsEditor({
 }) {
   const auth = useAuth();
 
-  const nationality = auth.company?.company?.nationality as
-    | string
-    | null
-    | undefined;
+  const company = auth.company?.company;
+  const nationality = company?.nationality as string | null | undefined;
   const settingQuery = useQuery(
     api.fileUploadSettings.getByCode.queryOptions({
-      input: { code: documentSettingCode(nationality) },
+      input: {
+        code: documentSettingCode(
+          nationality,
+          company?.attributes?.cooperative === true,
+        ),
+      },
     }),
   );
 
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step-documents.tsx b/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step-documents.tsx
index de4b2bd66..b0b870f72 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step-documents.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step-documents.tsx
@@ -7,6 +7,7 @@ import { type UseFormReturn } from "react-hook-form";
 
 import useAuth from "@/hooks/useAuth";
 import { api } from "@/services/api";
+import { documentSettingCode } from "@/utils/documentSettingCode";
 import {
   type ContractDocuments,
   type ContractFormInputValues,
@@ -21,12 +22,6 @@ type ContractForm = UseFormReturn<
   ContractFormValues
 >;
 
-function documentSettingCode(nationality: string | null | undefined): string {
-  return nationality === "foreign"
-    ? "company_onboarding_documents_foreign"
-    : "company_onboarding_documents_ethiopian";
-}
-
 function formatSize(bytes?: number): string {
   if (!bytes) return "";
   if (bytes < 1024) return `${bytes} B`;
@@ -61,14 +56,17 @@ export function StepDocuments({
   const auth = useAuth();
   const [errors, setErrors] = useState<Record<string, string>>({});
 
-  const nationality = auth.company?.company?.nationality as
-    | string
-    | null
-    | undefined;
+  const company = auth.company?.company;
+  const nationality = company?.nationality as string | null | undefined;
 
   const docSettingQuery = useQuery(
     api.fileUploadSettings.getByCode.queryOptions({
-      input: { code: documentSettingCode(nationality) },
+      input: {
+        code: documentSettingCode(
+          nationality,
+          company?.attributes?.cooperative === true,
+        ),
+      },
     }),
   );
 
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step2-service-type.tsx b/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step2-service-type.tsx
index de227035f..cbd2c8913 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step2-service-type.tsx
+++ b/apps/edr-freight-web/portal/src/pages/contracts/new-contract-form/step2-service-type.tsx
@@ -254,6 +254,11 @@ export function Step2ServiceType({
     (serviceType?.includesLastMile ?? false) && tradeDirection !== "EXPORT";
   const firstMileEnabled = form.watch("firstMile.enabled");
   const lastMileEnabled = form.watch("lastMile.enabled");
+  // The paid-mile service prices the road legs into the booking itself; every
+  // other service defers last-mile billing to after the Djibouti departure
+  // (confirm containers → sign supplementary LM contract → pay advance).
+  const deferredLastMileBilling =
+    serviceType?.code !== "RAIL_CONTAINER_PAID_MILE";
 
   const prevServiceType = useRef(serviceType);
   useEffect(() => {
@@ -471,7 +476,11 @@ export function Step2ServiceType({
                 <ServiceToggle
                   icon={<Truck size={18} />}
                   title="Last Mile — Delivery"
-                  description="Truck delivery from the destination rail yard to the final address (Port to Door)."
+                  description={
+                    deferredLastMileBilling
+                      ? "Truck delivery from the destination rail yard to the final address (Port to Door). Nothing is paid now — last-mile billing starts after your train departs Djibouti."
+                      : "Truck delivery from the destination rail yard to the final address (Port to Door)."
+                  }
                   checked={field.value ?? false}
                   onChange={(value) => {
                     field.onChange(value);
@@ -492,6 +501,15 @@ export function Step2ServiceType({
                 >
                   {lastMileEnabled && (
                     <Stack mt="md" gap={12}>
+                      {deferredLastMileBilling && (
+                        <Text size="xs" c="dimmed">
+                          How it works: when your train departs Djibouti, you
+                          will be asked to confirm which containers EDR should
+                          deliver. Once truck availability is approved, you will
+                          sign a short supplementary last-mile contract and pay
+                          the delivery advance — nothing is charged at booking.
+                        </Text>
+                      )}
                       <Controller
                         name="lastMile"
                         control={form.control}
diff --git a/apps/edr-freight-web/portal/src/pages/contracts/new-shipment-form/total.ts b/apps/edr-freight-web/portal/src/pages/contracts/new-shipment-form/total.ts
index cbe9ae083..7c80ca1d6 100644
--- a/apps/edr-freight-web/portal/src/pages/contracts/new-shipment-form/total.ts
+++ b/apps/edr-freight-web/portal/src/pages/contracts/new-shipment-form/total.ts
@@ -15,6 +15,19 @@ export interface ShipmentTotal {
   total: number;
 }
 
+/**
+ * Money always prints its cents. Bare toLocaleString() defaults to
+ * maximumFractionDigits: 0, which rounded the total away from the line items it
+ * sums (118,171.21 shown as 118,171) — and the customer is billed the exact
+ * amount, so the shown figure must match to the cent.
+ */
+export function formatAmount(amount: number | string | null | undefined) {
+  return Number(amount ?? 0).toLocaleString(undefined, {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+  });
+}
+
 /**
  * Quantity a bulk rate bills, in ITS OWN unit. PER_ITEM cargo carries both
  * figures — the item count prices the booking, the tonnage sizes the wagons —
diff --git a/apps/edr-freight-web/portal/src/pages/customers/on_boarding/DjiboutiFreightForwardingAgent.tsx b/apps/edr-freight-web/portal/src/pages/customers/on_boarding/DjiboutiFreightForwardingAgent.tsx
deleted file mode 100644
index f7955a0c0..000000000
--- a/apps/edr-freight-web/portal/src/pages/customers/on_boarding/DjiboutiFreightForwardingAgent.tsx
+++ /dev/null
@@ -1,512 +0,0 @@
-import { useState } from "react";
-import { useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { z } from "zod";
-
-import {
-  ArrowLeft,
-  ArrowRight,
-  Building2,
-  User,
-  CheckCircle2,
-} from "lucide-react";
-
-import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
-
-import {
-  Button,
-  Field,
-  FieldError,
-  FieldGroup,
-  FieldLabel,
-  Input,
-} from "@edr/ui-common";
-
-type OnboardingStep =
-  | "personal"
-  | "company"
-  | "representative";
-
-const schema = z.object({
-  // PERSONAL
-  firstName: z.string().min(1, "First name is required"),
-
-  lastName: z.string().min(1, "Last name is required"),
-
-  email: z.string().email("Invalid email address"),
-
-  phoneNumber: z
-    .string()
-    .min(1, "Phone number is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-
-  // COMPANY
-  companyName: z
-    .string()
-    .min(1, "Company name is required"),
-
-  companyEmail: z
-    .string()
-    .email("Invalid company email"),
-
-  companyPhone: z
-    .string()
-    .min(1, "Company phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-
-  companyLocation: z
-    .string()
-    .min(1, "Company location is required"),
-
-  companyAddress: z
-    .string()
-    .min(1, "Company address is required"),
-
-  // REPRESENTATIVE
-  representativeName: z
-    .string()
-    .min(1, "Representative name is required"),
-
-  representativeEmail: z
-    .string()
-    .email("Invalid representative email"),
-
-  representativePhone: z
-    .string()
-    .min(1, "Representative phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-});
-
-type FormData = z.infer<typeof schema>;
-
-const stepFields: Record<
-  OnboardingStep,
-  (keyof FormData)[]
-> = {
-  personal: [
-    "firstName",
-    "lastName",
-    "email",
-    "phoneNumber",
-  ],
-
-  company: [
-    "companyName",
-    "companyEmail",
-    "companyPhone",
-    "companyLocation",
-    "companyAddress",
-  ],
-
-  representative: [
-    "representativeName",
-    "representativeEmail",
-    "representativePhone",
-  ],
-};
-
-export default function DjiboutiForwardingAgentForm() {
-  const [step, setStep] =
-    useState<OnboardingStep>("personal");
-
-  const {
-    register,
-    control,
-    handleSubmit,
-    trigger,
-    formState: { errors, isSubmitting },
-  } = useForm<FormData>({
-    resolver: zodResolver(schema),
-
-    defaultValues: {
-      phoneNumber: "",
-      companyPhone: "",
-      representativePhone: "",
-    },
-  });
-
-  const nextStep = async () => {
-    if (step === "representative") {
-      handleSubmit(onSubmit)();
-      return;
-    }
-
-    const isValid = await trigger(
-      stepFields[step]
-    );
-
-    if (!isValid) return;
-
-    if (step === "personal") {
-      setStep("company");
-    } else {
-      setStep("representative");
-    }
-  };
-
-  const prevStep = () => {
-    if (step === "company") {
-      setStep("personal");
-    } else if (
-      step === "representative"
-    ) {
-      setStep("company");
-    }
-  };
-
-  const onSubmit = async (
-    data: FormData
-  ) => {
-    console.log(data);
-  };
-
-  return (
-    <>
-      {/* STEPPER */}
-      <div className="mb-8">
-        <div className="flex items-center justify-between max-w-xl mx-auto relative px-2">
-          <div className="absolute top-1/2 left-0 w-full h-0.5 bg-border -translate-y-1/2 z-0" />
-
-          <StepIcon
-            icon={<User className="size-5" />}
-            active={step === "personal"}
-            completed={
-              step !== "personal"
-            }
-          />
-
-          <StepIcon
-            icon={
-              <Building2 className="size-5" />
-            }
-            active={step === "company"}
-            completed={
-              step === "representative"
-            }
-          />
-
-          <StepIcon
-            icon={<User className="size-5" />}
-            active={
-              step === "representative"
-            }
-            completed={false}
-          />
-        </div>
-
-        <p className="text-center text-sm text-muted-foreground mt-3">
-          {step === "personal" &&
-            "Step 1 of 3 — Personal Information"}
-
-          {step === "company" &&
-            "Step 2 of 3 — Company Information"}
-
-          {step === "representative" &&
-            "Step 3 of 3 — Representative Information"}
-        </p>
-      </div>
-
-      {/* FORM */}
-      <form
-        onSubmit={handleSubmit(onSubmit)}
-        className="flex flex-col gap-4"
-      >
-        <FieldGroup className="gap-4">
-          {/* PERSONAL */}
-          {step === "personal" && (
-            <>
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.firstName
-                  )}
-                >
-                  <FieldLabel>
-                    First Name
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Ahmed"
-                    {...register("firstName")}
-                  />
-
-                  <FieldError
-                    errors={[errors.firstName]}
-                  />
-                </Field>
-
-                <Field
-                  data-invalid={Boolean(
-                    errors.lastName
-                  )}
-                >
-                  <FieldLabel>
-                    Last Name
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Ali"
-                    {...register("lastName")}
-                  />
-
-                  <FieldError
-                    errors={[errors.lastName]}
-                  />
-                </Field>
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.email
-                  )}
-                >
-                  <FieldLabel>Email</FieldLabel>
-
-                  <Input
-                    type="email"
-                    placeholder="agent@company.com"
-                    {...register("email")}
-                  />
-
-                  <FieldError
-                    errors={[errors.email]}
-                  />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="phoneNumber"
-                  label="Phone Number"
-                  required
-                />
-              </div>
-            </>
-          )}
-
-          {/* COMPANY */}
-          {step === "company" && (
-            <>
-              <Field
-                data-invalid={Boolean(
-                  errors.companyName
-                )}
-              >
-                <FieldLabel>
-                  Company Name
-                </FieldLabel>
-
-                <Input
-                  placeholder="Djibouti Freight Co."
-                  {...register("companyName")}
-                />
-
-                <FieldError
-                  errors={[errors.companyName]}
-                />
-              </Field>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.companyEmail
-                  )}
-                >
-                  <FieldLabel>
-                    Company Email
-                  </FieldLabel>
-
-                  <Input
-                    type="email"
-                    placeholder="ops@company.com"
-                    {...register(
-                      "companyEmail"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[errors.companyEmail]}
-                  />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="companyPhone"
-                  label="Company Phone"
-                  required
-                />
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.companyLocation
-                  )}
-                >
-                  <FieldLabel>
-                    Company Location / Country
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Djibouti"
-                    {...register(
-                      "companyLocation"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[
-                      errors.companyLocation,
-                    ]}
-                  />
-                </Field>
-
-                <Field
-                  data-invalid={Boolean(
-                    errors.companyAddress
-                  )}
-                >
-                  <FieldLabel>
-                    Company Address
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Rue de Venise"
-                    {...register(
-                      "companyAddress"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[
-                      errors.companyAddress,
-                    ]}
-                  />
-                </Field>
-              </div>
-            </>
-          )}
-
-          {/* REPRESENTATIVE */}
-          {step ===
-            "representative" && (
-            <>
-              <Field
-                data-invalid={Boolean(
-                  errors.representativeName
-                )}
-              >
-                <FieldLabel>
-                  Company Representative Person
-                  Name
-                </FieldLabel>
-
-                <Input
-                  placeholder="Mohamed Hassan"
-                  {...register(
-                    "representativeName"
-                  )}
-                />
-
-                <FieldError
-                  errors={[
-                    errors.representativeName,
-                  ]}
-                />
-              </Field>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.representativeEmail
-                  )}
-                >
-                  <FieldLabel>
-                    Representative Email
-                  </FieldLabel>
-
-                  <Input
-                    type="email"
-                    placeholder="rep@company.com"
-                    {...register(
-                      "representativeEmail"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[
-                      errors.representativeEmail,
-                    ]}
-                  />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="representativePhone"
-                  label="Representative Phone"
-                  required
-                />
-              </div>
-            </>
-          )}
-        </FieldGroup>
-
-        {/* FOOTER */}
-        <div className="flex items-center justify-between pt-2">
-          <Button
-            type="button"
-            variant="outline"
-            onClick={prevStep}
-            disabled={step === "personal"}
-          >
-            <ArrowLeft />
-            Back
-          </Button>
-
-          <Button
-            type="button"
-            onClick={nextStep}
-            disabled={isSubmitting}
-          >
-            {step === "representative" ? (
-              "Complete Registration"
-            ) : (
-              <>
-                Next Step
-                <ArrowRight />
-              </>
-            )}
-          </Button>
-        </div>
-      </form>
-    </>
-  );
-}
-
-function StepIcon({
-  icon,
-  active,
-  completed,
-}: {
-  icon: React.ReactNode;
-  active: boolean;
-  completed: boolean;
-}) {
-  return (
-    <div
-      className={`relative z-10 flex h-10 w-10 items-center justify-center rounded-full border-2 transition-all ${
-        completed
-          ? "bg-primary border-primary text-primary-foreground"
-          : active
-            ? "bg-background border-primary text-primary shadow-md"
-            : "bg-background border-border text-muted-foreground"
-      }`}
-    >
-      {completed ? (
-        <CheckCircle2 className="size-5" />
-      ) : (
-        icon
-      )}
-    </div>
-  );
-}
\ No newline at end of file
diff --git a/apps/edr-freight-web/portal/src/pages/customers/on_boarding/ImportExportOnBoarding.tsx b/apps/edr-freight-web/portal/src/pages/customers/on_boarding/ImportExportOnBoarding.tsx
deleted file mode 100644
index 33a28f58d..000000000
--- a/apps/edr-freight-web/portal/src/pages/customers/on_boarding/ImportExportOnBoarding.tsx
+++ /dev/null
@@ -1,711 +0,0 @@
-import { useState } from "react";
-import { useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { z } from "zod";
-
-import {
-  ArrowLeft,
-  ArrowRight,
-  Building2,
-  User,
-  FileText,
-  CheckCircle2,
-} from "lucide-react";
-
-import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
-
-import {
-  Button,
-  Field,
-  FieldError,
-  FieldGroup,
-  FieldLabel,
-  Input,
-} from "@edr/ui-common";
-
-type OnboardingStep =
-  | "personal"
-  | "company"
-  | "personnel"
-  | "poa";
-
-const onboardingSchema = z.object({
-  // PERSONAL
-  firstName: z.string().min(1, "First name is required"),
-  lastName: z.string().min(1, "Last name is required"),
-  email: z.string().email("Invalid email address"),
-  phoneNumber: z
-    .string()
-    .min(1, "Phone number is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-
-  // COMPANY
-  companyName: z.string().min(1, "Company name is required"),
-  companyEmail: z.string().email("Invalid email address"),
-  companyPhone: z
-    .string()
-    .min(1, "Company phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-  companyLocation: z.string().min(1, "Location is required"),
-  companyAddress: z.string().min(1, "Address is required"),
-
-  // LEGAL
-  tinNumber: z.string().regex(/^\d{10}$/, {
-    message: "TIN must be exactly 10 digits",
-  }),
-
-  vatNumber: z.string().min(1, "VAT number is required"),
-
-  fanNumber: z.string().regex(/^\d{16}$/, {
-    message: "FAN must be exactly 16 digits",
-  }),
-
-  // CONTACT PERSON
-  contactPersonName: z
-    .string()
-    .min(1, "Contact person name is required"),
-
-  contactPersonPhone: z
-    .string()
-    .min(1, "Contact person phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-
-  // GENERAL MANAGER
-  generalManagerName: z
-    .string()
-    .min(1, "General manager name is required"),
-
-  generalManagerEmail: z
-    .string()
-    .email("Invalid email"),
-
-  generalManagerPhone: z
-    .string()
-    .min(1, "General manager phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
-
-  // OPTIONAL POA
-  poaName: z.string().optional(),
-  poaPhone: z
-    .string()
-    .optional()
-    .refine((v) => !v || isValidPhone(v), "Enter a valid phone number"),
-  poaAddress: z.string().optional(),
-  poaEmail: z.string().optional(),
-  poaLocation: z.string().optional(),
-});
-
-type FormData = z.infer<typeof onboardingSchema>;
-
-const stepFields: Record<
-  OnboardingStep,
-  (keyof FormData)[]
-> = {
-  personal: [
-    "firstName",
-    "lastName",
-    "email",
-    "phoneNumber",
-  ],
-
-  company: [
-    "companyName",
-    "companyEmail",
-    "companyPhone",
-    "companyLocation",
-    "companyAddress",
-    "tinNumber",
-    "vatNumber",
-    "fanNumber",
-  ],
-
-  personnel: [
-    "contactPersonName",
-    "contactPersonPhone",
-    "generalManagerName",
-    "generalManagerEmail",
-    "generalManagerPhone",
-  ],
-
-  poa: [],
-};
-
-export default function ImportExportOnBoarding() {
-  const [step, setStep] =
-    useState<OnboardingStep>("personal");
-
-  const {
-    register,
-    control,
-    handleSubmit,
-    trigger,
-    formState: { errors, isSubmitting },
-  } = useForm<FormData>({
-    resolver: zodResolver(onboardingSchema),
-
-    defaultValues: {
-      phoneNumber: "",
-      companyPhone: "",
-      contactPersonPhone: "",
-      generalManagerPhone: "",
-      poaPhone: "",
-    },
-  });
-
-  const nextStep = async () => {
-    if (step === "poa") {
-      handleSubmit(onSubmit)();
-      return;
-    }
-
-    const isValid = await trigger(stepFields[step]);
-
-    if (!isValid) return;
-
-    if (step === "personal") {
-      setStep("company");
-    } else if (step === "company") {
-      setStep("personnel");
-    } else {
-      setStep("poa");
-    }
-  };
-
-  const prevStep = () => {
-    if (step === "company") {
-      setStep("personal");
-    } else if (step === "personnel") {
-      setStep("company");
-    } else if (step === "poa") {
-      setStep("personnel");
-    }
-  };
-
-  const onSubmit = async (data: FormData) => {
-    console.log(data);
-  };
-
-  return (
-    <>
-      {/* STEP HEADER */}
-      <div className="mb-8">
-        <div className="flex items-center justify-between max-w-2xl mx-auto relative px-2">
-          <div className="absolute top-1/2 left-0 w-full h-0.5 bg-border -translate-y-1/2 z-0" />
-
-          <StepIcon
-            icon={<User className="size-5" />}
-            active={step === "personal"}
-            completed={
-              step !== "personal"
-            }
-          />
-
-          <StepIcon
-            icon={<Building2 className="size-5" />}
-            active={step === "company"}
-            completed={
-              step === "personnel" ||
-              step === "poa"
-            }
-          />
-
-          <StepIcon
-            icon={<User className="size-5" />}
-            active={step === "personnel"}
-            completed={step === "poa"}
-          />
-
-          <StepIcon
-            icon={<FileText className="size-5" />}
-            active={step === "poa"}
-            completed={false}
-          />
-        </div>
-
-        <p className="text-center text-sm text-muted-foreground mt-3">
-          {step === "personal" &&
-            "Step 1 of 4 — Personal Information"}
-
-          {step === "company" &&
-            "Step 2 of 4 — Company Information"}
-
-          {step === "personnel" &&
-            "Step 3 of 4 — Personnel Information"}
-
-          {step === "poa" &&
-            "Step 4 of 4 — Power of Attorney"}
-        </p>
-      </div>
-
-      <form
-        onSubmit={handleSubmit(onSubmit)}
-        className="flex flex-col gap-4"
-      >
-        <FieldGroup className="gap-4">
-          {/* PERSONAL */}
-          {step === "personal" && (
-            <>
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.firstName
-                  )}
-                >
-                  <FieldLabel>
-                    First Name
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="John"
-                    {...register("firstName")}
-                  />
-
-                  <FieldError
-                    errors={[errors.firstName]}
-                  />
-                </Field>
-
-                <Field
-                  data-invalid={Boolean(
-                    errors.lastName
-                  )}
-                >
-                  <FieldLabel>
-                    Last Name
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Doe"
-                    {...register("lastName")}
-                  />
-
-                  <FieldError
-                    errors={[errors.lastName]}
-                  />
-                </Field>
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.email
-                  )}
-                >
-                  <FieldLabel>Email</FieldLabel>
-
-                  <Input
-                    type="email"
-                    placeholder="john@example.com"
-                    {...register("email")}
-                  />
-
-                  <FieldError
-                    errors={[errors.email]}
-                  />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="phoneNumber"
-                  label="Phone Number"
-                  required
-                />
-              </div>
-            </>
-          )}
-
-          {/* COMPANY */}
-          {step === "company" && (
-            <>
-              <Field
-                data-invalid={Boolean(
-                  errors.companyName
-                )}
-              >
-                <FieldLabel>
-                  Company Name
-                </FieldLabel>
-
-                <Input
-                  placeholder="Global Logistics Ltd"
-                  {...register("companyName")}
-                />
-
-                <FieldError
-                  errors={[errors.companyName]}
-                />
-              </Field>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.companyEmail
-                  )}
-                >
-                  <FieldLabel>
-                    Company Email
-                  </FieldLabel>
-
-                  <Input
-                    type="email"
-                    placeholder="ops@company.com"
-                    {...register(
-                      "companyEmail"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[errors.companyEmail]}
-                  />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="companyPhone"
-                  label="Company Phone"
-                  required
-                />
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.companyLocation
-                  )}
-                >
-                  <FieldLabel>
-                    Company Location
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Addis Ababa"
-                    {...register(
-                      "companyLocation"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[
-                      errors.companyLocation,
-                    ]}
-                  />
-                </Field>
-
-                <Field
-                  data-invalid={Boolean(
-                    errors.companyAddress
-                  )}
-                >
-                  <FieldLabel>
-                    Company Address
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Bole, Woreda 03"
-                    {...register(
-                      "companyAddress"
-                    )}
-                  />
-
-                  <FieldError
-                    errors={[
-                      errors.companyAddress,
-                    ]}
-                  />
-                </Field>
-              </div>
-
-              <div className="grid grid-cols-3 gap-4">
-                <Field
-                  data-invalid={Boolean(
-                    errors.tinNumber
-                  )}
-                >
-                  <FieldLabel>
-                    TIN Number
-                  </FieldLabel>
-
-                  <Input
-                    maxLength={10}
-                    placeholder="1234567890"
-                    {...register("tinNumber")}
-                  />
-
-                  <FieldError
-                    errors={[errors.tinNumber]}
-                  />
-                </Field>
-
-                <Field
-                  data-invalid={Boolean(
-                    errors.vatNumber
-                  )}
-                >
-                  <FieldLabel>
-                    VAT Number
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="VAT123456"
-                    {...register("vatNumber")}
-                  />
-
-                  <FieldError
-                    errors={[errors.vatNumber]}
-                  />
-                </Field>
-
-                <Field
-                  data-invalid={Boolean(
-                    errors.fanNumber
-                  )}
-                >
-                  <FieldLabel>
-                    FAN Number
-                  </FieldLabel>
-
-                  <Input
-                    maxLength={16}
-                    placeholder="1234567890123456"
-                    {...register("fanNumber")}
-                  />
-
-                  <FieldError
-                    errors={[errors.fanNumber]}
-                  />
-                </Field>
-              </div>
-            </>
-          )}
-
-          {/* PERSONNEL */}
-          {step === "personnel" && (
-            <>
-              <div>
-                <h3 className="text-sm font-semibold text-foreground mb-3">
-                  Contact Person
-                </h3>
-
-                <div className="grid grid-cols-2 gap-4">
-                  <Field
-                    data-invalid={Boolean(
-                      errors.contactPersonName
-                    )}
-                  >
-                    <FieldLabel>
-                      Contact Person Name
-                    </FieldLabel>
-
-                    <Input
-                      placeholder="Jane Smith"
-                      {...register(
-                        "contactPersonName"
-                      )}
-                    />
-
-                    <FieldError
-                      errors={[
-                        errors.contactPersonName,
-                      ]}
-                    />
-                  </Field>
-
-                  <ControlledPhoneField
-                    control={control}
-                    name="contactPersonPhone"
-                    label="Contact Person Phone"
-                    required
-                  />
-                </div>
-              </div>
-
-              <hr className="border-border" />
-
-              <div>
-                <h3 className="text-sm font-semibold text-foreground mb-3">
-                  General Manager
-                </h3>
-
-                <div className="grid grid-cols-2 gap-4">
-                  <Field
-                    className="col-span-2"
-                    data-invalid={Boolean(
-                      errors.generalManagerName
-                    )}
-                  >
-                    <FieldLabel>
-                      General Manager Name
-                    </FieldLabel>
-
-                    <Input
-                      placeholder="Abebe Bikila"
-                      {...register(
-                        "generalManagerName"
-                      )}
-                    />
-
-                    <FieldError
-                      errors={[
-                        errors.generalManagerName,
-                      ]}
-                    />
-                  </Field>
-
-                  <Field
-                    data-invalid={Boolean(
-                      errors.generalManagerEmail
-                    )}
-                  >
-                    <FieldLabel>
-                      General Manager Email
-                    </FieldLabel>
-
-                    <Input
-                      type="email"
-                      placeholder="gm@company.com"
-                      {...register(
-                        "generalManagerEmail"
-                      )}
-                    />
-
-                    <FieldError
-                      errors={[
-                        errors.generalManagerEmail,
-                      ]}
-                    />
-                  </Field>
-
-                  <ControlledPhoneField
-                    control={control}
-                    name="generalManagerPhone"
-                    label="General Manager Phone"
-                    required
-                  />
-                </div>
-              </div>
-            </>
-          )}
-
-          {/* POA */}
-          {step === "poa" && (
-            <>
-              <p className="text-sm text-muted-foreground">
-                Power of Attorney details are
-                optional.
-              </p>
-
-              <Field>
-                <FieldLabel>PoA Name</FieldLabel>
-
-                <Input
-                  placeholder="Authorized Representative"
-                  {...register("poaName")}
-                />
-              </Field>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field>
-                  <FieldLabel>
-                    PoA Email
-                  </FieldLabel>
-
-                  <Input
-                    type="email"
-                    placeholder="poa@company.com"
-                    {...register("poaEmail")}
-                  />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="poaPhone"
-                  label="PoA Phone"
-                />
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field>
-                  <FieldLabel>
-                    PoA Location
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="City, Country"
-                    {...register("poaLocation")}
-                  />
-                </Field>
-
-                <Field>
-                  <FieldLabel>
-                    PoA Address
-                  </FieldLabel>
-
-                  <Input
-                    placeholder="Full Address"
-                    {...register("poaAddress")}
-                  />
-                </Field>
-              </div>
-            </>
-          )}
-        </FieldGroup>
-
-        {/* FOOTER */}
-        <div className="flex items-center justify-between pt-2">
-          <Button
-            type="button"
-            variant="outline"
-            onClick={prevStep}
-            disabled={step === "personal"}
-          >
-            <ArrowLeft />
-            Back
-          </Button>
-
-          <Button
-            type="button"
-            onClick={nextStep}
-            disabled={isSubmitting}
-          >
-            {step === "poa" ? (
-              "Complete Registration"
-            ) : (
-              <>
-                Next Step
-                <ArrowRight />
-              </>
-            )}
-          </Button>
-        </div>
-      </form>
-    </>
-  );
-}
-
-function StepIcon({
-  icon,
-  active,
-  completed,
-}: {
-  icon: React.ReactNode;
-  active: boolean;
-  completed: boolean;
-}) {
-  return (
-    <div
-      className={`relative z-10 flex h-10 w-10 items-center justify-center rounded-full border-2 transition-all ${
-        completed
-          ? "bg-primary border-primary text-primary-foreground"
-          : active
-            ? "bg-background border-primary text-primary shadow-md"
-            : "bg-background border-border text-muted-foreground"
-      }`}
-    >
-      {completed ? (
-        <CheckCircle2 className="size-5" />
-      ) : (
-        icon
-      )}
-    </div>
-  );
-}
\ No newline at end of file
diff --git a/apps/edr-freight-web/portal/src/pages/customers/on_boarding/TransportrOnBoarding.tsx b/apps/edr-freight-web/portal/src/pages/customers/on_boarding/TransportrOnBoarding.tsx
deleted file mode 100644
index 77b5d4ecd..000000000
--- a/apps/edr-freight-web/portal/src/pages/customers/on_boarding/TransportrOnBoarding.tsx
+++ /dev/null
@@ -1,288 +0,0 @@
-import { useState } from "react";
-import { useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { z } from "zod";
-
-import {
-  ArrowLeft,
-  ArrowRight,
-  User,
-  Truck,
-  CheckCircle2,
-} from "lucide-react";
-
-import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
-
-import {
-  Button,
-  Field,
-  FieldError,
-  FieldGroup,
-  FieldLabel,
-  Input,
-} from "@edr/ui-common";
-
-type Step = "personal" | "transport";
-
-const schema = z.object({
-  // PERSONAL
-  firstName: z.string().min(1),
-  lastName: z.string().min(1),
-  email: z.string().email(),
-  phoneNumber: z
-    .string()
-    .min(1)
-    .refine(isValidPhone, "Enter a valid phone number"),
-
-  // TRANSPORT
-  fanNumber: z.string().min(1),
-  tinNumber: z.string().regex(/^\d{10}$/, "TIN must be exactly 10 digits"),
-
-  truckType: z.enum([
-    "Casoni",
-    "Truck Trailer",
-    "High Bed",
-    "Low Bed",
-    "Others",
-  ]),
-
-  plateNumber: z.string().min(1),
-
-  plateNumber2: z.string().optional(),
-
-  vehicleModel: z.string().min(1),
-  yearOfManufacturing: z.string().min(1),
-});
-
-type FormData = z.infer<typeof schema>;
-
-const stepFields: Record<Step, (keyof FormData)[]> = {
-  personal: [
-    "firstName",
-    "lastName",
-    "email",
-    "phoneNumber",
-  ],
-  transport: [
-    "fanNumber",
-    "tinNumber",
-    "truckType",
-    "plateNumber",
-    "plateNumber2",
-    "vehicleModel",
-    "yearOfManufacturing",
-  ],
-};
-
-export default function TransporterOnboarding() {
-  const [step, setStep] = useState<Step>("personal");
-
-  const {
-    register,
-    control,
-    handleSubmit,
-    trigger,
-    watch,
-    formState: { errors, isSubmitting },
-  } = useForm<FormData>({
-    resolver: zodResolver(schema),
-    defaultValues: {
-      phoneNumber: "",
-    },
-  });
-
-  const truckType = watch("truckType");
-
-  const nextStep = async () => {
-    const valid = await trigger(stepFields[step]);
-    if (!valid) return;
-
-    if (step === "personal") setStep("transport");
-    else handleSubmit(onSubmit)();
-  };
-
-  const prevStep = () => {
-    if (step === "transport") setStep("personal");
-  };
-
-  const onSubmit = (data: FormData) => {
-    console.log("TRANSPORTER:", data);
-  };
-
-  return (
-    <>
-      {/* STEPPER */}
-      <div className="mb-8 lg:col-span-2">
-        <div className="flex items-center justify-between max-w-lg mx-auto relative px-2">
-          <div className="absolute top-1/2 left-0 w-full h-0.5 bg-border -translate-y-1/2 z-0" />
-
-          <StepIcon
-            icon={<User className="size-5" />}
-            active={step === "personal"}
-            completed={step !== "personal"}
-          />
-
-          <StepIcon
-            icon={<Truck className="size-5" />}
-            active={step === "transport"}
-            completed={false}
-          />
-        </div>
-
-        <p className="text-center text-sm text-muted-foreground mt-3">
-          {step === "personal" && "Step 1 of 2 — Personal Information"}
-          {step === "transport" && "Step 2 of 2 — Transport Information"}
-        </p>
-      </div>
-
-      {/* FORM */}
-      <form onSubmit={handleSubmit(onSubmit)} className="flex flex-col gap-4">
-        <FieldGroup className="gap-4">
-
-          {/* PERSONAL */}
-          {step === "personal" && (
-            <>
-              <div className="grid grid-cols-2 gap-4">
-                <Field data-invalid={!!errors.firstName}>
-                  <FieldLabel>First Name</FieldLabel>
-                  <Input {...register("firstName")} />
-                  <FieldError errors={[errors.firstName]} />
-                </Field>
-
-                <Field data-invalid={!!errors.lastName}>
-                  <FieldLabel>Last Name</FieldLabel>
-                  <Input {...register("lastName")} />
-                  <FieldError errors={[errors.lastName]} />
-                </Field>
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field data-invalid={!!errors.email}>
-                  <FieldLabel>Email</FieldLabel>
-                  <Input type="email" {...register("email")} />
-                  <FieldError errors={[errors.email]} />
-                </Field>
-
-                <ControlledPhoneField
-                  control={control}
-                  name="phoneNumber"
-                  label="Phone Number"
-                  required
-                />
-              </div>
-            </>
-          )}
-
-          {/* TRANSPORT */}
-          {step === "transport" && (
-            <>
-              <div className="grid grid-cols-2 gap-4">
-                <Field data-invalid={!!errors.fanNumber}>
-                  <FieldLabel>FAN Number</FieldLabel>
-                  <Input {...register("fanNumber")} />
-                  <FieldError errors={[errors.fanNumber]} />
-                </Field>
-
-                <Field data-invalid={!!errors.tinNumber}>
-                  <FieldLabel>TIN Number</FieldLabel>
-                  <Input maxLength={10} inputMode="numeric" {...register("tinNumber")} />
-                  <FieldError errors={[errors.tinNumber]} />
-                </Field>
-              </div>
-
-              <Field data-invalid={!!errors.truckType}>
-                <FieldLabel>Truck Type</FieldLabel>
-                <select
-                  className="w-full border rounded-md p-2 bg-background"
-                  {...register("truckType")}
-                >
-                  <option value="">Select type</option>
-                  <option value="Casoni">Casoni</option>
-                  <option value="Truck Trailer">Truck Trailer</option>
-                  <option value="High Bed">High Bed</option>
-                  <option value="Low Bed">Low Bed</option>
-                  <option value="Others">Others</option>
-                </select>
-                <FieldError errors={[errors.truckType]} />
-              </Field>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field data-invalid={!!errors.plateNumber}>
-                  <FieldLabel>Plate Number</FieldLabel>
-                  <Input {...register("plateNumber")} />
-                  <FieldError errors={[errors.plateNumber]} />
-                </Field>
-
-                {truckType === "Casoni" && (
-                  <Field data-invalid={!!errors.plateNumber2}>
-                    <FieldLabel>Second Plate Number (Casoni)</FieldLabel>
-                    <Input {...register("plateNumber2")} />
-                    <FieldError errors={[errors.plateNumber2]} />
-                  </Field>
-                )}
-              </div>
-
-              <div className="grid grid-cols-2 gap-4">
-                <Field data-invalid={!!errors.vehicleModel}>
-                  <FieldLabel>Vehicle Model</FieldLabel>
-                  <Input {...register("vehicleModel")} />
-                  <FieldError errors={[errors.vehicleModel]} />
-                </Field>
-
-                <Field data-invalid={!!errors.yearOfManufacturing}>
-                  <FieldLabel>Year of Manufacturing</FieldLabel>
-                  <Input {...register("yearOfManufacturing")} />
-                  <FieldError errors={[errors.yearOfManufacturing]} />
-                </Field>
-              </div>
-            </>
-          )}
-
-        </FieldGroup>
-
-        {/* FOOTER */}
-        <div className="flex items-center justify-between pt-2">
-          <Button type="button" variant="outline" onClick={prevStep} disabled={step === "personal"}>
-            <ArrowLeft />
-            Back
-          </Button>
-
-          <Button type="button" onClick={nextStep} disabled={isSubmitting}>
-            {step === "transport" ? (
-              "Complete Registration"
-            ) : (
-              <>
-                Next Step
-                <ArrowRight />
-              </>
-            )}
-          </Button>
-        </div>
-      </form>
-    </>
-  );
-}
-
-function StepIcon({
-  icon,
-  active,
-  completed,
-}: {
-  icon: React.ReactNode;
-  active: boolean;
-  completed: boolean;
-}) {
-  return (
-    <div
-      className={`relative z-10 flex h-10 w-10 items-center justify-center rounded-full border-2 transition-all ${
-        completed
-          ? "bg-primary border-primary text-primary-foreground"
-          : active
-          ? "bg-background border-primary text-primary shadow-md"
-          : "bg-background border-border text-muted-foreground"
-      }`}
-    >
-      {completed ? <CheckCircle2 className="size-5" /> : icon}
-    </div>
-  );
-}
\ No newline at end of file
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 2115ec083..3eb7fd87e 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/NationalitySelect.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/NationalitySelect.tsx
@@ -9,6 +9,8 @@ interface NationalitySelectProps {
   onChange: (next: CompanyNationality) => void;
   /** Render only the option grid — the wizard supplies its own header/card. */
   embedded?: boolean;
+  /** Hide the foreign option (a co-operative union or farm is always Ethiopian). */
+  excludeForeign?: boolean;
 }
 
 /**
@@ -21,23 +23,30 @@ export default function NationalitySelect({
   value,
   onChange,
   embedded = false,
+  excludeForeign = false,
 }: NationalitySelectProps) {
   const grid = (
-    <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+    <SimpleGrid cols={{ base: 1, sm: excludeForeign ? 1 : 2 }} spacing="md">
       <RoleCard
         label="Ethiopian Company"
-        description="Registered in Ethiopia. You'll provide a TIN certificate, commercial registration and national ID."
+        description={
+          excludeForeign
+            ? "Registered in Ethiopia. You'll provide a TIN certificate, your co-operative registration certificate and national ID."
+            : "Registered in Ethiopia. You'll provide a TIN certificate, commercial registration and national ID."
+        }
         icon={<MapPin size={22} />}
         selected={value === "ethiopian"}
         onClick={() => onChange("ethiopian")}
       />
-      <RoleCard
-        label="Foreign Company"
-        description="Registered abroad. You'll provide a passport and investment license."
-        icon={<Globe2 size={22} />}
-        selected={value === "foreign"}
-        onClick={() => onChange("foreign")}
-      />
+      {!excludeForeign && (
+        <RoleCard
+          label="Foreign Company"
+          description="Registered abroad. You'll provide a passport and investment license."
+          icon={<Globe2 size={22} />}
+          selected={value === "foreign"}
+          onClick={() => onChange("foreign")}
+        />
+      )}
     </SimpleGrid>
   );
 
diff --git a/apps/edr-freight-web/portal/src/pages/settings/OnboardingRoleSelect.tsx b/apps/edr-freight-web/portal/src/pages/settings/OnboardingRoleSelect.tsx
index ca4afb9b9..c6e46a507 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/OnboardingRoleSelect.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/OnboardingRoleSelect.tsx
@@ -9,6 +9,11 @@ interface OnboardingRoleSelectProps {
   onChange: (next: string[]) => void;
   /** Render only the option grid — the wizard supplies its own header/card. */
   embedded?: boolean;
+  /**
+   * Roles this company cannot hold, hidden rather than shown-and-refused. A
+   * co-operative has no business licence, so it cannot freight-forward.
+   */
+  excludeTypes?: readonly string[];
 }
 
 /**
@@ -22,8 +27,12 @@ export default function OnboardingRoleSelect({
   value,
   onChange,
   embedded = false,
+  excludeTypes,
 }: OnboardingRoleSelectProps) {
   const selected = new Set(value);
+  const roles = excludeTypes?.length
+    ? CUSTOMER_ROLES.filter((r) => !excludeTypes.includes(r.type))
+    : CUSTOMER_ROLES;
 
   const toggleRole = (type: string) => {
     const next = new Set(value);
@@ -34,7 +43,7 @@ export default function OnboardingRoleSelect({
 
   const grid = (
     <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
-      {CUSTOMER_ROLES.map((role) => (
+      {roles.map((role) => (
         <RoleCard
           key={role.type}
           label={role.label}
diff --git a/apps/edr-freight-web/portal/src/pages/settings/RegistrationSourceCard.tsx b/apps/edr-freight-web/portal/src/pages/settings/RegistrationSourceCard.tsx
new file mode 100644
index 000000000..a814db2b5
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/settings/RegistrationSourceCard.tsx
@@ -0,0 +1,170 @@
+import { useState } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import {
+  Alert,
+  Button,
+  Card,
+  Group,
+  List,
+  Modal,
+  Stack,
+  Text,
+  Title,
+} from "@mantine/core";
+import { AlertCircle, FileSearch } from "lucide-react";
+
+import { api } from "@/services/api";
+import type { ProfileResponse } from "@/types/profile";
+import { extractApiError } from "@/utils/result";
+
+/**
+ * Leave whichever manual-registration route the company is on — a co-operative
+ * union or farm, or a foreign investment licence — and go back to the ordinary
+ * eTrade one. For a company that has since been registered with the trade
+ * registry, or that ticked the box by mistake.
+ *
+ * It is a re-application, not a settings edit: the API clears the registration
+ * the customer typed (nothing on file was ever checked against a licence) and
+ * puts the company back to pending, so the wizard reopens on the company step
+ * and the TIN goes through eTrade this time. Said plainly here rather than
+ * discovered afterwards.
+ *
+ * Only the way OUT is here. Moving between the three registration sources in
+ * the other direction is the wizard's own step, which this reopens — that is
+ * where the rules about which combinations are legal already live, and a second
+ * picker would have to restate every one of them.
+ */
+export default function RegistrationSourceCard({
+  profile,
+  disabled = false,
+}: {
+  profile: ProfileResponse;
+  /** A change request is under review — switching now would strand it. */
+  disabled?: boolean;
+}) {
+  const queryClient = useQueryClient();
+  const [confirming, setConfirming] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const revert = useMutation({
+    mutationFn: () => api.companies.revertToRegularCompany.call(),
+    onSuccess: async () => {
+      setConfirming(false);
+      // getInfo is what the onboarding gate reads, so refreshing it is what
+      // reopens the wizard.
+      await Promise.all([
+        queryClient.invalidateQueries({
+          queryKey: api.companies.getInfo.queryKey(),
+        }),
+        queryClient.invalidateQueries({
+          queryKey: api.companies.getProfile.queryKey(),
+        }),
+        queryClient.invalidateQueries({
+          queryKey: api.companies.onboardingRequirements.queryKey(),
+        }),
+      ]);
+    },
+    onError: (err) => setError(extractApiError(err).message),
+  });
+
+  // Which of the two routes this is — wording only; leaving costs the same.
+  const cooperative = profile.cooperative;
+  if (!profile.investorLicence && !cooperative) return null;
+
+  return (
+    <>
+      <Card padding="lg" radius="lg" mt="lg">
+        <Group gap="sm" mb="md">
+          <FileSearch size={20} />
+          <Title order={3}>Registration source</Title>
+        </Group>
+        <Stack gap="md">
+          <Text size="sm" c="edr-muted">
+            {cooperative
+              ? "Your company is registered as a co-operative union or farm, so your registration details were entered by hand instead of being read from eTrade. Our team reviews them against the documents you uploaded."
+              : "Your company is registered on a foreign investment licence, so your registration details were entered by hand instead of being read from eTrade. Our team reviews them against the documents you uploaded."}
+          </Text>
+          <Text size="sm" c="edr-muted">
+            If your company now holds an eTrade trade licence, you can switch
+            over and have your registration verified automatically.
+          </Text>
+          <Group justify="flex-end">
+            <Button
+              variant="default"
+              disabled={disabled}
+              onClick={() => {
+                setError(null);
+                setConfirming(true);
+              }}
+            >
+              Switch to eTrade registration
+            </Button>
+          </Group>
+          {disabled && (
+            <Text size="xs" c="edr-muted" ta="right">
+              Not available while your profile changes are under review.
+            </Text>
+          )}
+        </Stack>
+      </Card>
+
+      <Modal
+        opened={confirming}
+        onClose={() => setConfirming(false)}
+        title="Switch to eTrade registration?"
+        centered
+        radius="lg"
+      >
+        <Stack gap="md">
+          <Text size="sm">This re-opens your application:</Text>
+          <List size="sm" spacing="xs">
+            <List.Item>
+              The registration details you typed are cleared — eTrade supplies
+              them once your TIN is found.
+            </List.Item>
+            <List.Item>
+              Your company goes back to pending and is reviewed again.
+            </List.Item>
+            <List.Item>
+              Your documents, owner and contact details stay as they are — but
+              the papers we ask for change with the registration source, so some
+              may be listed as outstanding again.
+            </List.Item>
+            {cooperative && (
+              <List.Item>
+                A business licence becomes due for each of your operational
+                services — a co-operative owes none, an eTrade-registered
+                company does — so any that are already approved go back to
+                awaiting approval until you upload one. Their reference numbers
+                stay the same.
+              </List.Item>
+            )}
+          </List>
+          <Alert color="amber" variant="light" icon={<AlertCircle size={18} />}>
+            If eTrade holds no record for your TIN you won't be able to finish —
+            the wizard reopens on the company step, so go back one step and
+            re-select {cooperative ? "co-operative" : "the investment licence"}{" "}
+            there.
+          </Alert>
+          {error && (
+            <Text size="sm" c="red">
+              {error}
+            </Text>
+          )}
+          <Group justify="flex-end">
+            <Button variant="default" onClick={() => setConfirming(false)}>
+              Cancel
+            </Button>
+            <Button
+              color="edr-green"
+              loading={revert.isPending}
+              onClick={() => revert.mutate()}
+            >
+              Switch and re-apply
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/settings/TabCompanyProfile.tsx b/apps/edr-freight-web/portal/src/pages/settings/TabCompanyProfile.tsx
index 2ff16f445..f8eb58e8f 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/TabCompanyProfile.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/TabCompanyProfile.tsx
@@ -1,82 +1,115 @@
-import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
 import { api } from "@/services/api";
 import type {
-    CompanyProfileInput,
-    CreateCompanyPayload,
+  CompanyProfileInput,
+  CreateCompanyPayload,
 } from "@/services/companies.service";
 import type { AuthUser } from "@/types/auth";
 import type { ProfileResponse } from "@/types/profile";
 import { extractApiError } from "@/utils/result";
 import { zodResolver } from "@hookform/resolvers/zod";
 import {
-    Button,
-    Card,
-    Group,
-    Select,
-    SimpleGrid,
-    Stack,
-    Text,
-    TextInput,
-    Title,
+  Button,
+  Card,
+  Group,
+  Select,
+  SimpleGrid,
+  Stack,
+  Text,
+  TextInput,
+  Title,
 } from "@mantine/core";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { Building2, CheckCircle2, Save, XCircle } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
-import { Controller, useForm } from "react-hook-form";
+import type { FieldErrors, UseFormRegister, UseFormSetValue } from "react-hook-form";
+import { useForm } from "react-hook-form";
 import { z } from "zod";
 import { ETHIOPIAN_REGIONS, type CompanyRegistrationData } from "@edr/types";
 import OnboardingRoleSelect from "./OnboardingRoleSelect";
-import FaydaVerifyPanel from "@/components/FaydaVerifyPanel";
-import ETradeInfo, { type ETradeStatus } from "@/components/onboarding/ETradeInfo";
+import ETradeInfo, {
+  type ETradeStatus,
+} from "@/components/onboarding/ETradeInfo";
 import { ReadOnlyField } from "@/pages/accounts/companyProfileForm/ReadOnlyField";
 import StepSection from "@/pages/accounts/companyProfileForm/StepSection";
-import { ETRADE_BUNDLE_FIELDS as SHARED_ETRADE_FIELDS } from "@/pages/accounts/companyProfileForm/schema";
 import {
-  firstValidEmail,
-  firstValidPhone,
-  normalizeIdentityPhones,
-} from "@/pages/accounts/companyProfileForm/helpers";
+  ETRADE_BUNDLE_FIELDS as SHARED_ETRADE_FIELDS,
+  onboardingSchema,
+} from "@/pages/accounts/companyProfileForm/schema";
 
-export const COMPANY_PROFILE_SCHEMA = z.object({
-  companyName: z.string().min(1, "Company name is required"),
-  companyEmail: z.string().email("Invalid email address"),
-  companyPhone: z
-    .string()
-    .min(1, "Company phone is required")
-    .refine(isValidPhone, "Enter a valid phone number"),
+const BASE_COMPANY_PROFILE_SCHEMA = z.object({
+  // eTrade-sourced and read-only, like the registration block below.
+  companyName: z.string().optional(),
   companyLocation: z.string().min(1, "Location is required"),
   // Derived from the eTrade address parts (region/zone/woreda/kebele/houseNo);
   // no standalone input.
   companyAddress: z.string().optional(),
   tinNumber: z.string().regex(/^\d{10}$/, "TIN must be exactly 10 digits"),
-  // Same rule as onboarding — the two forms write the same column, so they must
-  // not disagree about what is acceptable in it.
-  vatNumber: z
-    .string()
-    .min(1, "VAT number is required")
-    .regex(/^\d{10}$/, "VAT number must be exactly 10 digits"),
+  // Onboarding's own rule, reused rather than restated: the two forms write the
+  // same column, and the copy here had drifted into a 10-or-11-digit check that
+  // onboarding and the API both refuse to make. A foreign company's VAT is
+  // whatever its tax authority issues and a co-operative's follows neither, so
+  // the stricter copy locked those customers out of their own Company tab
+  // entirely — every save on it, not just the VAT.
+  vatNumber: onboardingSchema.shape.vatNumber,
   ownerPassportNumber: z.string().optional(),
-  // Registration/address fields are eTrade-sourced — locked once eTrade
-  // supplies a value, editable only as an escape hatch when it doesn't
-  // (see LockedField below). Not typed by hand in the normal case.
+  // Registration/address fields are eTrade-sourced and never typed by hand —
+  // not even when eTrade leaves one blank, so none of them may be required
+  // here (there is no input on screen to fix one with).
   licenceNumber: z.string().optional(),
   statusDescription: z.string().optional(),
   dateRegistered: z.string().optional(),
   renewedFrom: z.string().optional(),
   renewalDate: z.string().optional(),
   renewedTo: z.string().optional(),
-  region: z
-    .string()
-    .refine((v) => (ETHIOPIAN_REGIONS as readonly string[]).includes(v), {
-      message: "Region is required",
-    }),
-  zone: z.string().min(1, "Zone is required"),
-  woreda: z.string().min(1, "Woreda is required"),
-  kebele: z.string().min(1, "Kebele is required"),
-  houseNo: z.string().min(1, "House number is required"),
+  region: z.string().optional(),
+  zone: z.string().optional(),
+  woreda: z.string().optional(),
+  kebele: z.string().optional(),
+  houseNo: z.string().optional(),
 });
 
-export type CompanyProfileFormData = z.infer<typeof COMPANY_PROFILE_SCHEMA>;
+/**
+ * The registration fields a manual-registration company types by hand.
+ *
+ * eTrade holds no record for a co-operative union or farm, nor for a foreign
+ * investor on an Investment Commission licence, so the block every other
+ * company gets read-only off the licence is typed by these two — and is
+ * therefore required of them, exactly as the onboarding wizard requires it.
+ * House number stays optional: plenty of addresses have none.
+ */
+const TYPED_REGISTRATION_LABELS = {
+  companyName: "Company name",
+  region: "Region",
+  zone: "Zone",
+  woreda: "Woreda",
+  kebele: "Kebele",
+} as const;
+
+/**
+ * `manualRegistration` is the only thing that changes here, and it changes the
+ * same way it does in the wizard: **a field is required iff there is an input
+ * on screen for it.** For an eTrade company these are read-only rows, so
+ * requiring one would be a Save button failing on a field with nothing to fix.
+ */
+export const buildCompanyProfileSchema = (manualRegistration: boolean) =>
+  manualRegistration
+    ? BASE_COMPANY_PROFILE_SCHEMA.superRefine((d, ctx) => {
+        for (const key of Object.keys(
+          TYPED_REGISTRATION_LABELS,
+        ) as (keyof typeof TYPED_REGISTRATION_LABELS)[]) {
+          if (d[key]?.trim()) continue;
+          ctx.addIssue({
+            code: "custom",
+            path: [key],
+            message: `${TYPED_REGISTRATION_LABELS[key]} is required`,
+          });
+        }
+      })
+    : BASE_COMPANY_PROFILE_SCHEMA;
+
+export type CompanyProfileFormData = z.infer<
+  typeof BASE_COMPANY_PROFILE_SCHEMA
+>;
 
 /**
  * `etradePhone` is not on this form, so the shared list is filtered down to the
@@ -97,10 +130,20 @@ export default function TabCompanyProfile({
   profile,
   mode = "edit",
   onCreateSuccess,
-  user,
 }: TabCompanyProfileProps) {
   const queryClient = useQueryClient();
   const isCreate = mode === "create";
+  /**
+   * eTrade has nothing to say about this company — a co-operative holds no
+   * business licence, a foreign investor's is the Investment Commission's — so
+   * its registration was typed during onboarding and has to stay editable here.
+   * Rendering the eTrade card instead left that data invisible and frozen: the
+   * one company that owns its registration details was the one that could not
+   * see them.
+   */
+  const manualRegistration = Boolean(
+    profile?.cooperative || profile?.investorLicence,
+  );
   const [selectedRoles, setSelectedRoles] = useState<string[]>([]);
   const [tinStatus, setTinStatus] = useState<ETradeStatus>("idle");
 
@@ -108,8 +151,6 @@ export default function TabCompanyProfile({
     if (profile) {
       return {
         companyName: profile.companyName,
-        companyEmail: profile.companyEmail ?? "",
-        companyPhone: profile.companyPhone ?? "",
         companyLocation: profile.companyLocation,
         companyAddress: profile.companyAddress ?? "",
         tinNumber: profile.tinNumber,
@@ -130,8 +171,6 @@ export default function TabCompanyProfile({
     }
     return {
       companyName: "",
-      companyEmail: "",
-      companyPhone: "",
       companyLocation: "",
       companyAddress: "",
       tinNumber: "",
@@ -153,50 +192,19 @@ export default function TabCompanyProfile({
 
   const {
     register,
-    control,
     handleSubmit,
     reset,
     watch,
     setValue,
     formState: { errors, isDirty, dirtyFields },
   } = useForm<CompanyProfileFormData>({
-    resolver: zodResolver(COMPANY_PROFILE_SCHEMA),
+    resolver: zodResolver(buildCompanyProfileSchema(manualRegistration)),
     values: defaultValues,
   });
 
   // Fayda stores the phone as the national registry holds it (often a local
   // number), which neither this form's E.164 validation nor the API's
   // `@IsValidPhone()` accepts. Normalize on read — same as the wizard.
-  const identity = useMemo(
-    () => normalizeIdentityPhones(profile?.identity),
-    [profile?.identity],
-  );
-  const verifiedIdentity = identity?.faydaRequired === true;
-
-  // companyEmail/companyPhone are the owner's verified contact details, never
-  // typed — same derivation as the onboarding wizard, just fed from the saved
-  // profile instead of an in-progress form. `firstValid*` rather than `??`:
-  // these claims are optional AND unreliable — eTrade's registered phone is
-  // free text that arrives as things like "09        " — and `??` stops at the
-  // first non-null, so junk became a read-only field the customer could not
-  // fix and a 400 on save. When nothing usable can be derived the fields below
-  // become editable instead of blocking.
-  const derivedEmail = firstValidEmail(identity?.owner.email, user?.email);
-  const derivedPhone = firstValidPhone(
-    identity?.owner.phone,
-    profile?.etradePhone,
-    user?.phoneNumber,
-  );
-
-  useEffect(() => {
-    if (derivedEmail) setValue("companyEmail", derivedEmail);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [derivedEmail]);
-
-  useEffect(() => {
-    if (derivedPhone) setValue("companyPhone", derivedPhone);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [derivedPhone]);
 
   // companyAddress is composed from the (locked) eTrade address parts, not
   // typed directly.
@@ -221,7 +229,9 @@ export default function TabCompanyProfile({
       });
     }
     setValue("licenceNumber", data.licenceNumber, { shouldDirty: true });
-    setValue("statusDescription", data.statusDescription, { shouldDirty: true });
+    setValue("statusDescription", data.statusDescription, {
+      shouldDirty: true,
+    });
     setValue("dateRegistered", data.dateRegistered, { shouldDirty: true });
     setValue("renewedFrom", data.renewedFrom, { shouldDirty: true });
     setValue("renewalDate", data.renewalDate, { shouldDirty: true });
@@ -255,13 +265,13 @@ export default function TabCompanyProfile({
       // authenticity re-check for no reason.
       const etradeBundle: Record<string, string | undefined> = {};
       for (const key of ETRADE_FIELDS) {
-        if (dirtyFields[key]) etradeBundle[key] = data[key];
+        // Never "": eTrade left it blank, no input exists to fill it, and the
+        // API rejects the empty value (region's @IsIn) — see stepPayload.
+        if (dirtyFields[key] && data[key]) etradeBundle[key] = data[key];
       }
       if (dirtyFields.tinNumber) etradeBundle.tin = data.tinNumber;
 
       const base = {
-        companyEmail: data.companyEmail,
-        companyPhone: data.companyPhone,
         companyLocation: data.companyLocation,
         companyAddress: data.companyAddress,
         vatNumber: data.vatNumber ?? "",
@@ -279,7 +289,7 @@ export default function TabCompanyProfile({
           : "customer";
         const payload: CreateCompanyPayload = {
           ...base,
-          companyName: data.companyName,
+          companyName: data.companyName ?? "",
           tin: data.tinNumber,
           companyType,
           companyProfiles: selectedRoles.map((type) => ({
@@ -328,10 +338,6 @@ export default function TabCompanyProfile({
     validationError ??
     (mutation.isError ? extractApiError(mutation.error).message : null);
 
-  const pendingOwnerReview = Boolean(
-    (profile?.pendingChanges as { faydaIdentity?: Record<string, unknown> } | null)
-      ?.faydaIdentity?.ownerFaydaSub,
-  );
 
   // During onboarding the role selection gates the form: nothing else shows
   // until the user picks Importer/Exporter or Freight Forwarder.
@@ -346,210 +352,244 @@ export default function TabCompanyProfile({
         />
       ) : null}
       {showForm && (
-      <Card padding="lg">
-        <Group gap="sm" mb="xs">
-          <Building2 size={20} />
-          <Title order={3}>Company Profile</Title>
-        </Group>
-      <Text c="edr-muted" size="sm" mb="lg">
-        {isCreate
-          ? "Enter your company registration details to get started"
-          : "Your registration and identity come from eTrade and Fayda — re-verify to refresh them."}
-      </Text>
-
-      <form onSubmit={handleSubmit(onSubmit, onInvalid)}>
-        <Stack gap="xl">
-          <StepSection
-            index={1}
-            title="VAT number"
-            status={watch("vatNumber") ? "done" : "todo"}
-          >
-            <TextInput
-              label="VAT Number"
-              placeholder="e.g. 0012345678"
-              maxLength={10}
-              error={errors.vatNumber?.message}
-              {...register("vatNumber")}
-            />
-          </StepSection>
-
-          {identity && (
-            <StepSection
-              index={2}
-              title="Owner identity"
-              subtitle={
-                verifiedIdentity
-                  ? "Re-verify the company owner with Fayda — their name, phone, email and address are refreshed from the verification."
-                  : "The company owner's passport number."
-              }
-              status={
-                verifiedIdentity
-                  ? identity.owner.verified
-                    ? "done"
-                    : identity.faydaRequired
-                      ? "blocked"
-                      : "todo"
-                  : (watch("ownerPassportNumber")?.trim()?.length ?? 0) > 0
-                    ? "done"
-                    : identity.passportRequired
-                      ? "blocked"
-                      : "todo"
-              }
-            >
-              <FaydaVerifyPanel
-                subject="owner"
-                title="Company owner"
-                state={identity.owner}
-                required={identity.faydaRequired}
-                disabled={mutation.isPending}
-                pendingReview={pendingOwnerReview}
-              />
-              {identity.passportRequired && (
-                <TextInput
-                  label="Owner Passport Number"
-                  placeholder="P1234567"
-                  description="The owner's identity credential — Fayda is an Ethiopian national ID, so a foreign company's owner is identified by passport instead."
-                  error={errors.ownerPassportNumber?.message}
-                  {...register("ownerPassportNumber")}
-                />
-              )}
-              {/* Read-only while the verified owner (or eTrade, or the account)
-                  supplies them. Fayda's email/phone claims are optional, so
-                  when nothing can be derived these become typeable — the API
-                  requires both, and showing an empty read-only field is a save
-                  that can never succeed. */}
-              <SimpleGrid cols={2} spacing="md">
-                {derivedEmail ? (
-                  <ReadOnlyField label="Company email" value={derivedEmail} />
-                ) : (
-                  <TextInput
-                    label="Company Email"
-                    type="email"
-                    description="We couldn't find one on your verified identity or account — please enter it."
-                    error={errors.companyEmail?.message}
-                    {...register("companyEmail")}
-                  />
-                )}
-                {derivedPhone ? (
-                  <ReadOnlyField label="Company phone" value={derivedPhone} />
-                ) : (
-                  <ControlledPhoneField
-                    control={control}
-                    name="companyPhone"
-                    label="Company Phone"
-                    required
-                  />
-                )}
-              </SimpleGrid>
-            </StepSection>
-          )}
-
-          <StepSection
-            index={3}
-            title="Company TIN"
-            subtitle="Re-verify with eTrade to refresh your registration record — nothing here is typed by hand."
-            status={
-              tinVerified ? "done" : tinStatus === "taken" ? "blocked" : "todo"
-            }
-          >
-            <ETradeInfo
-              tin={watch("tinNumber")}
-              register={register("tinNumber")}
-              error={errors.tinNumber?.message}
-              onDataLoaded={handleETradeDataLoaded}
-              onStatusChange={setTinStatus}
-              alreadyVerified={hasRegistrationDetails}
-            />
-            {tinVerified && (
-              <EtradeLockedCard
-                tin={watch("tinNumber")}
-                register={register}
-                watch={watch}
-                errors={errors}
-                control={control}
-              />
-            )}
-          </StepSection>
-
-          <TextInput
-            label="Location"
-            placeholder="Addis Ababa, Ethiopia"
-            error={errors.companyLocation?.message}
-            {...register("companyLocation")}
-          />
-        </Stack>
-
-        <Group
-          justify="space-between"
-          mt="xl"
-          pt="md"
-          style={{ borderTop: "1px solid var(--mantine-color-edr-border-0)" }}
-        >
-          <Group gap="xs">
-            {mutation.isSuccess && !isCreate && (
-              <Group gap={6} c="green">
-                <CheckCircle2 size={16} />
-                <Text size="sm" fw={500}>
-                  Saved successfully
-                </Text>
-              </Group>
-            )}
-            {saveErrorMessage && (
-              <Group gap={6} c="red">
-                <XCircle size={16} />
-                <Text size="sm" fw={500}>
-                  {saveErrorMessage}
-                </Text>
-              </Group>
-            )}
+        <Card padding="lg">
+          <Group gap="sm" mb="xs">
+            <Building2 size={20} />
+            <Title order={3}>Company Profile</Title>
           </Group>
-          <Group gap="md">
-            {!isCreate && (
-              <Button
-                type="button"
-                variant="outline"
-                disabled={mutation.isPending || !isDirty}
-                onClick={() => reset()}
+          <Text c="edr-muted" size="sm" mb="lg">
+            {isCreate
+              ? "Enter your company registration details to get started"
+              : "Your registration and identity come from eTrade and Fayda — re-verify to refresh them."}
+          </Text>
+
+          <form onSubmit={handleSubmit(onSubmit, onInvalid)}>
+            <Stack gap="xl">
+              <StepSection
+                index={1}
+                title="VAT number"
+                status={watch("vatNumber") ? "done" : "todo"}
               >
-                Reset
-              </Button>
-            )}
-            <Button
-              type="submit"
-              leftSection={<Save size={16} />}
-              loading={mutation.isPending}
+                <TextInput
+                  label="VAT Number"
+                  placeholder="e.g. 0012345678"
+                  error={errors.vatNumber?.message}
+                  {...register("vatNumber")}
+                />
+              </StepSection>
+
+
+              <StepSection
+                index={2}
+                title="Company TIN"
+                subtitle={
+                  manualRegistration
+                    ? "We'll check eTrade for your TIN. If it holds nothing — the usual case here — the details below stay yours to state."
+                    : "Re-verify with eTrade to refresh your registration record — nothing here is typed by hand."
+                }
+                status={
+                  tinStatus === "taken"
+                    ? "blocked"
+                    : manualRegistration
+                      ? watch("tinNumber")?.trim() && !errors.tinNumber
+                        ? "done"
+                        : "todo"
+                      : tinVerified
+                        ? "done"
+                        : "todo"
+                }
+              >
+                <ETradeInfo
+                  tin={watch("tinNumber")}
+                  register={register("tinNumber")}
+                  error={errors.tinNumber?.message}
+                  onDataLoaded={handleETradeDataLoaded}
+                  onStatusChange={setTinStatus}
+                  alreadyVerified={hasRegistrationDetails}
+                  selectedLicenceNumber={watch("licenceNumber")}
+                  registrationOptional={manualRegistration}
+                />
+                {!manualRegistration && tinVerified && (
+                  <EtradeLockedCard tin={watch("tinNumber")} watch={watch} />
+                )}
+              </StepSection>
+
+              {manualRegistration && (
+                <StepSection
+                  index={3}
+                  title="Registration details"
+                  subtitle="Everything we'd normally read off an eTrade licence. Our team checks what you state here against the documents you upload."
+                  status={
+                    watch("companyName")?.trim() && watch("region")?.trim()
+                      ? "done"
+                      : "todo"
+                  }
+                >
+                  <TypedRegistrationFields
+                    register={register}
+                    watch={watch}
+                    setValue={setValue}
+                    errors={errors}
+                  />
+                </StepSection>
+              )}
+
+              <TextInput
+                label="Location"
+                placeholder="Addis Ababa, Ethiopia"
+                error={errors.companyLocation?.message}
+                {...register("companyLocation")}
+              />
+            </Stack>
+
+            <Group
+              justify="space-between"
+              mt="xl"
+              pt="md"
+              style={{
+                borderTop: "1px solid var(--mantine-color-edr-border-0)",
+              }}
             >
-              {isCreate ? "Continue" : "Save Changes"}
-            </Button>
-          </Group>
-        </Group>
-      </form>
-      </Card>
+              <Group gap="xs">
+                {mutation.isSuccess && !isCreate && (
+                  <Group gap={6} c="green">
+                    <CheckCircle2 size={16} />
+                    <Text size="sm" fw={500}>
+                      Saved successfully
+                    </Text>
+                  </Group>
+                )}
+                {saveErrorMessage && (
+                  <Group gap={6} c="red">
+                    <XCircle size={16} />
+                    <Text size="sm" fw={500}>
+                      {saveErrorMessage}
+                    </Text>
+                  </Group>
+                )}
+              </Group>
+              <Group gap="md">
+                {!isCreate && (
+                  <Button
+                    type="button"
+                    variant="outline"
+                    disabled={mutation.isPending || !isDirty}
+                    onClick={() => reset()}
+                  >
+                    Reset
+                  </Button>
+                )}
+                <Button
+                  type="submit"
+                  leftSection={<Save size={16} />}
+                  loading={mutation.isPending}
+                >
+                  {isCreate ? "Continue" : "Save Changes"}
+                </Button>
+              </Group>
+            </Group>
+          </form>
+        </Card>
       )}
     </Stack>
   );
 }
 
 /**
- * The verified eTrade record, locked read-only — same escape hatch as
- * onboarding's ETradeCompanyCard: a field eTrade left blank falls back to an
- * editable input rather than trapping the customer.
+ * The registration a manual-registration company states for itself.
+ *
+ * Deliberately editable, unlike `EtradeLockedCard` below: nothing here came
+ * from a licence, so there is no verified record to protect — it is the
+ * customer's own claim, checked by a reviewer against the papers they upload.
+ * Same fields, same rules and same region list as the onboarding wizard's
+ * company step, so a co-operative or investor sees one story in both places.
+ */
+function TypedRegistrationFields({
+  register,
+  watch,
+  setValue,
+  errors,
+}: {
+  register: UseFormRegister<CompanyProfileFormData>;
+  watch: ReturnType<typeof useForm<CompanyProfileFormData>>["watch"];
+  setValue: UseFormSetValue<CompanyProfileFormData>;
+  errors: FieldErrors<CompanyProfileFormData>;
+}) {
+  const region = watch("region") ?? "";
+
+  return (
+    <Stack gap="md">
+      <TextInput
+        label="Company Name"
+        placeholder="Registered name of the company"
+        error={errors.companyName?.message}
+        {...register("companyName")}
+      />
+      <Text size="sm" c="edr-muted">
+        Registered address
+      </Text>
+      <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+        <Select
+          label="Region"
+          placeholder="Select region"
+          // A value eTrade (or an earlier save) supplied may not be spelled the
+          // way our list spells it. Carrying it in as an option keeps it visible
+          // rather than silently blanking a field nobody touched.
+          data={
+            region && !(ETHIOPIAN_REGIONS as readonly string[]).includes(region)
+              ? [...ETHIOPIAN_REGIONS, region]
+              : [...ETHIOPIAN_REGIONS]
+          }
+          searchable
+          value={region || null}
+          onChange={(v) =>
+            setValue("region", v ?? "", {
+              shouldValidate: true,
+              shouldDirty: true,
+            })
+          }
+          error={errors.region?.message}
+        />
+        <TextInput
+          label="Zone"
+          error={errors.zone?.message}
+          {...register("zone")}
+        />
+        <TextInput
+          label="Woreda"
+          error={errors.woreda?.message}
+          {...register("woreda")}
+        />
+        <TextInput
+          label="Kebele"
+          error={errors.kebele?.message}
+          {...register("kebele")}
+        />
+        <TextInput
+          label="House No."
+          error={errors.houseNo?.message}
+          {...register("houseNo")}
+        />
+      </SimpleGrid>
+    </Stack>
+  );
+}
+
+/**
+ * The verified eTrade record, rendered strictly read-only — same rule as
+ * onboarding's ETradeCompanyCard: nothing here is typeable, not even a field
+ * eTrade left blank. These are the government's record of the company, so a
+ * customer-typed substitute would be an unverified claim wearing a verified
+ * badge. A gap stays a visible gap ("—").
  */
 function EtradeLockedCard({
   tin,
-  register,
   watch,
-  errors,
-  control,
 }: {
   tin: string;
-  register: ReturnType<typeof useForm<CompanyProfileFormData>>["register"];
   watch: ReturnType<typeof useForm<CompanyProfileFormData>>["watch"];
-  errors: ReturnType<typeof useForm<CompanyProfileFormData>>["formState"]["errors"];
-  control: ReturnType<typeof useForm<CompanyProfileFormData>>["control"];
 }) {
   const companyName = watch("companyName");
-  const region = watch("region");
 
   return (
     <Card padding="md" radius="md" withBorder>
@@ -562,82 +602,22 @@ function EtradeLockedCard({
         </Text>
       </Group>
       <SimpleGrid cols={2} spacing="sm">
-        <LockedField label="Company Name" name="companyName" register={register} watch={watch} errors={errors} />
+        <ReadOnlyField label="Company Name" value={watch("companyName")} />
         <ReadOnlyField label="License Number" value={watch("licenceNumber")} />
         <ReadOnlyField label="Status" value={watch("statusDescription")} />
-        <ReadOnlyField label="Date Registered" value={watch("dateRegistered")} />
+        <ReadOnlyField
+          label="Date Registered"
+          value={watch("dateRegistered")}
+        />
         <ReadOnlyField label="Renewal Date" value={watch("renewalDate")} />
         <ReadOnlyField label="Renewed From" value={watch("renewedFrom")} />
         <ReadOnlyField label="Renewed To" value={watch("renewedTo")} />
-        {/* Membership of the catalog, not mere presence — a stored spelling
-            outside the list is otherwise uncorrectable. */}
-        {(ETHIOPIAN_REGIONS as readonly string[]).includes(region ?? "") ? (
-          <ReadOnlyField label="Region" value={region} />
-        ) : (
-          <RegionSelect control={control} error={errors.region?.message} />
-        )}
-        <LockedField label="Zone" name="zone" register={register} watch={watch} errors={errors} />
-        <LockedField label="Woreda" name="woreda" register={register} watch={watch} errors={errors} />
-        <LockedField label="Kebele" name="kebele" register={register} watch={watch} errors={errors} />
-        <LockedField label="House No" name="houseNo" register={register} watch={watch} errors={errors} />
+        <ReadOnlyField label="Region" value={watch("region")} />
+        <ReadOnlyField label="Zone" value={watch("zone")} />
+        <ReadOnlyField label="Woreda" value={watch("woreda")} />
+        <ReadOnlyField label="Kebele" value={watch("kebele")} />
+        <ReadOnlyField label="House No" value={watch("houseNo")} />
       </SimpleGrid>
     </Card>
   );
 }
-
-function LockedField({
-  label,
-  name,
-  register,
-  watch,
-  errors,
-}: {
-  label: string;
-  name: keyof CompanyProfileFormData;
-  register: ReturnType<typeof useForm<CompanyProfileFormData>>["register"];
-  watch: ReturnType<typeof useForm<CompanyProfileFormData>>["watch"];
-  errors: ReturnType<typeof useForm<CompanyProfileFormData>>["formState"]["errors"];
-}) {
-  const value = watch(name) as string | undefined;
-  // A value that fails validation unlocks too — rendering a rejected value
-  // read-only is a save that can never succeed and never says why.
-  if (value?.trim() && !errors[name]) {
-    return <ReadOnlyField label={label} value={value} />;
-  }
-  return (
-    <TextInput
-      label={label}
-      description="eTrade didn't provide this — please confirm"
-      error={errors[name]?.message as string | undefined}
-      {...register(name)}
-    />
-  );
-}
-
-function RegionSelect({
-  control,
-  error,
-}: {
-  control: ReturnType<typeof useForm<CompanyProfileFormData>>["control"];
-  error?: string;
-}) {
-  return (
-    <Controller
-      name="region"
-      control={control}
-      render={({ field }) => (
-        <Select
-          label="Region"
-          description="eTrade didn't provide this — please confirm"
-          placeholder="Select region"
-          searchable
-          data={ETHIOPIAN_REGIONS.map((r) => ({ value: r, label: r }))}
-          error={error}
-          value={field.value || null}
-          onChange={(v) => field.onChange(v ?? "")}
-          onBlur={field.onBlur}
-        />
-      )}
-    />
-  );
-}
diff --git a/apps/edr-freight-web/portal/src/pages/settings/TabContactPerson.tsx b/apps/edr-freight-web/portal/src/pages/settings/TabContactPerson.tsx
index d78add01b..3ed377c83 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/TabContactPerson.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/TabContactPerson.tsx
@@ -5,20 +5,30 @@ import { zodResolver } from "@hookform/resolvers/zod";
 import { z } from "zod";
 import { CheckCircle2, Save, User, XCircle } from "lucide-react";
 import {
+  Button,
   Card,
   Group,
+  SimpleGrid,
   Stack,
-  Title,
   Text,
   TextInput,
-  Button,
+  Title,
 } from "@mantine/core";
 import { api } from "@/services/api";
 import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
 import type { ProfileResponse } from "@/types/profile";
 
+// The same four fields onboarding collects, with the same requiredness. The
+// position and the email were captured by the wizard and then had no input
+// here at all — stored, invisible, and impossible to correct.
 const schema = z.object({
   contactPersonName: z.string().min(1, "Contact person name is required"),
+  contactPersonPosition: z.string().optional(),
+  contactPersonEmail: z
+    .string()
+    .email("Invalid email address")
+    .optional()
+    .or(z.literal("")),
   contactPersonPhone: z
     .string()
     .min(1, "Contact person phone is required")
@@ -39,6 +49,8 @@ export default function TabContactPerson({ profile, mode = "edit", onContinue }:
   const defaultValues = useMemo((): FormData => {
     return {
       contactPersonName: profile.contactPersonName ?? "",
+      contactPersonPosition: profile.contactPersonPosition ?? "",
+      contactPersonEmail: profile.contactPersonEmail ?? "",
       contactPersonPhone: profile.contactPersonPhone ?? "",
     };
   }, [profile]);
@@ -58,6 +70,11 @@ export default function TabContactPerson({ profile, mode = "edit", onContinue }:
     mutationFn: (data: FormData) =>
       api.companies.updateProfile.call({
         contactPersonName: data.contactPersonName,
+        // `|| undefined`, never "": the DTO's `@IsOptional()` only skips null
+        // and undefined, so an empty string is validated and 400s with
+        // "contactPersonEmail must be an email".
+        contactPersonPosition: data.contactPersonPosition || undefined,
+        contactPersonEmail: data.contactPersonEmail || undefined,
         contactPersonPhone: data.contactPersonPhone,
       }),
     onSuccess: () => {
@@ -80,19 +97,36 @@ export default function TabContactPerson({ profile, mode = "edit", onContinue }:
 
       <form onSubmit={handleSubmit(onSubmit)}>
         <Stack gap="md">
-          <TextInput
-            label="Full Name"
-            placeholder="Jane Smith"
-            error={errors.contactPersonName?.message}
-            {...register("contactPersonName")}
-          />
+          <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+            <TextInput
+              label="Full Name"
+              placeholder="Jane Smith"
+              error={errors.contactPersonName?.message}
+              {...register("contactPersonName")}
+            />
+            <TextInput
+              label="Position (Optional)"
+              placeholder="Operations Lead"
+              error={errors.contactPersonPosition?.message}
+              {...register("contactPersonPosition")}
+            />
+          </SimpleGrid>
 
-          <ControlledPhoneField
-            control={control}
-            name="contactPersonPhone"
-            label="Phone Number"
-            required
-          />
+          <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md">
+            <TextInput
+              label="Email (Optional)"
+              type="email"
+              placeholder="contact@company.com"
+              error={errors.contactPersonEmail?.message}
+              {...register("contactPersonEmail")}
+            />
+            <ControlledPhoneField
+              control={control}
+              name="contactPersonPhone"
+              label="Phone Number"
+              required
+            />
+          </SimpleGrid>
         </Stack>
 
         <Group
diff --git a/apps/edr-freight-web/portal/src/pages/settings/TabDocuments.tsx b/apps/edr-freight-web/portal/src/pages/settings/TabDocuments.tsx
index 72d6738c8..617b92826 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/TabDocuments.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/TabDocuments.tsx
@@ -6,6 +6,7 @@ import {
   type LicenseFileStatus,
 } from "@/services/companies.service";
 import { getMinFiles } from "@/types/fileUploadSettings";
+import { documentSettingCode } from "@/utils/documentSettingCode";
 import type { ProfileResponse } from "@/types/profile";
 import {
   SmartFileInput,
@@ -57,14 +58,8 @@ interface TabDocumentsProps {
   onContinue?: () => void;
 }
 
-function documentSettingCode(nationality: string | null | undefined): string {
-  return nationality === "foreign"
-    ? "company_onboarding_documents_foreign"
-    : "company_onboarding_documents_ethiopian";
-}
-
 /**
- * The DARS delegation paper ships in the same nationality document set, but it is
+ * The DARS delegation paper ships in the same document set, but it is
  * edited on the Power of Attorney tab (where it is staged for review alongside
  * the PoA details), so it is excluded from this tab's uploader.
  */
@@ -83,7 +78,9 @@ export default function TabDocuments({
 
   const docSettingQuery = useQuery(
     api.fileUploadSettings.getByCode.queryOptions({
-      input: { code: documentSettingCode(profile.nationality) },
+      input: {
+        code: documentSettingCode(profile.nationality, profile.cooperative),
+      },
     }),
   );
 
@@ -174,7 +171,11 @@ export default function TabDocuments({
     return errs;
   };
 
-  const licenseProfiles = profile.companyProfiles;
+  // A co-operative union or farm holds no business licence — that is the whole
+  // reason it uploads its own document set instead — so the API lifts the
+  // per-role requirement and these cards are not shown. Offering an upload slot
+  // nothing can ever fill reads as an outstanding task that cannot be finished.
+  const licenseProfiles = profile.cooperative ? [] : profile.companyProfiles;
 
   // Company documents render through SmartFileInput, which is keyed by field and
   // has no per-file review slot. Surfacing the outstanding corrections as one
diff --git a/apps/edr-freight-web/portal/src/pages/settings/TabGeneralManager.tsx b/apps/edr-freight-web/portal/src/pages/settings/TabGeneralManager.tsx
deleted file mode 100644
index 7191d162c..000000000
--- a/apps/edr-freight-web/portal/src/pages/settings/TabGeneralManager.tsx
+++ /dev/null
@@ -1,281 +0,0 @@
-import { useMemo, useState } from "react";
-import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { z } from "zod";
-import { Briefcase, CheckCircle2, Save, XCircle } from "lucide-react";
-import {
-  Alert,
-  Card,
-  Group,
-  Stack,
-  Title,
-  Text,
-  TextInput,
-  Button,
-  Grid,
-} from "@mantine/core";
-import { api } from "@/services/api";
-import { verifaydaService } from "@/services/verifayda.service";
-import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
-import { LinkCheckboxCard } from "@/pages/accounts/companyProfileForm/LinkCheckboxCard";
-import FaydaVerifyPanel from "@/components/FaydaVerifyPanel";
-import type { ProfileResponse } from "@/types/profile";
-
-// Optional, not unrequired: an Ethiopian company's GM is established through
-// Fayda and never types these, so a blanket `min(1)` would fail a form that is
-// correct. Presence is gated below, where the identity state says which route
-// applies; zod only polices format for the companies that still type them.
-const schema = z.object({
-  generalManagerName: z.string().optional(),
-  generalManagerEmail: z
-    .string()
-    .optional()
-    .refine(
-      (v) => !v || z.string().email().safeParse(v).success,
-      "Invalid GM email",
-    ),
-  generalManagerPhone: z
-    .string()
-    .optional()
-    .refine((v) => !v || isValidPhone(v), "Enter a valid phone number"),
-});
-
-type FormData = z.infer<typeof schema>;
-
-interface TabGeneralManagerProps {
-  profile: ProfileResponse;
-  mode?: "edit" | "onboarding";
-  onContinue?: () => void;
-}
-
-/**
- * The general manager's identity comes from Fayda: either verified in their
- * own right, or declared to be the owner — very often the same human, which is
- * what "Same as owner" is for. Typed details survive only for a foreign
- * company, whose manager may hold no Fayda ID at all.
- */
-export default function TabGeneralManager({ profile, mode = "edit", onContinue }: TabGeneralManagerProps) {
-  const queryClient = useQueryClient();
-  const owner = profile.identity?.owner;
-  const identity = profile.identity;
-  const gm = identity?.gm;
-  const faydaRequired = identity?.faydaRequired ?? false;
-  const [gmSameAsOwner, setGmSameAsOwner] = useState(
-    identity?.gmSameAsOwner ?? false,
-  );
-
-  const defaultValues = useMemo((): FormData => {
-    return {
-      generalManagerName: profile.generalManagerName ?? "",
-      generalManagerEmail: profile.generalManagerEmail ?? "",
-      generalManagerPhone: profile.generalManagerPhone ?? "",
-    };
-  }, [profile]);
-
-  const {
-    register,
-    control,
-    handleSubmit,
-    reset,
-    setValue,
-    formState: { errors, isDirty },
-  } = useForm<FormData>({
-    resolver: zodResolver(schema),
-    values: defaultValues,
-  });
-
-  /**
-   * With a Fayda-verified owner the declaration is made server-side — the API
-   * copies the proven identity onto the GM — so nothing is typed here. Without
-   * one (a foreign company, whose owner is backed by a passport) there is
-   * nothing proven to copy and this stays a local prefill.
-   */
-  const [linkPending, setLinkPending] = useState(false);
-  const [linkError, setLinkError] = useState<string | null>(null);
-  const toggleGmSameAsOwner = async (checked: boolean) => {
-    setGmSameAsOwner(checked);
-    setLinkError(null);
-    if (!owner?.verified) {
-      if (checked && owner) {
-        setValue("generalManagerName", owner.name ?? "", { shouldValidate: true });
-        setValue("generalManagerEmail", owner.email ?? "", { shouldValidate: true });
-        setValue("generalManagerPhone", owner.phone ?? "", { shouldValidate: true });
-      }
-      return;
-    }
-
-    setLinkPending(true);
-    try {
-      if (checked) await verifaydaService.setGmSameAsOwner();
-      else await verifaydaService.clearGmIdentity();
-      queryClient.invalidateQueries({
-        queryKey: api.companies.getProfile.queryKey(),
-      });
-    } catch (err) {
-      setGmSameAsOwner(!checked);
-      setLinkError(
-        (err as { response?: { data?: { message?: string } } })?.response?.data
-          ?.message ??
-          (err instanceof Error ? err.message : "Could not update the general manager"),
-      );
-    } finally {
-      setLinkPending(false);
-    }
-  };
-
-  const mutation = useMutation({
-    mutationFn: (data: FormData) =>
-      api.companies.updateProfile.call({
-        generalManagerName: data.generalManagerName,
-        generalManagerEmail: data.generalManagerEmail,
-        generalManagerPhone: data.generalManagerPhone,
-      }),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: api.companies.getProfile.queryKey() });
-      if (mode === "onboarding") onContinue?.();
-    },
-  });
-
-  const onSubmit = (data: FormData) => mutation.mutate(data);
-
-  // Nothing to save when Fayda owns the details: the verification and the
-  // "same as owner" declaration both write server-side, so the form would be
-  // posting empty strings over a proven identity.
-  const typedFieldsInUse = !gmSameAsOwner && !gm?.verified && !faydaRequired;
-
-  return (
-    <Card padding="lg">
-      <Group gap="sm" mb="xs">
-        <Briefcase size={20} />
-        <Title order={3}>General Manager</Title>
-      </Group>
-      <Text c="edr-muted" size="sm" mb="lg">
-        Manage the general manager information
-      </Text>
-
-      <form onSubmit={handleSubmit(onSubmit)}>
-        <Stack gap="md">
-          <LinkCheckboxCard
-            checked={gmSameAsOwner}
-            onToggle={toggleGmSameAsOwner}
-            title={
-              owner?.verified ? "Same as verified owner" : "Same as business owner"
-            }
-            description={
-              owner?.verified
-                ? "Reuse the Fayda-verified owner's identity for the general manager. Uncheck to verify a different person."
-                : "Reuse the owner's name, email and phone. Uncheck to enter different details."
-            }
-          />
-
-          {linkError && (
-            <Alert color="red" variant="light" icon={<XCircle size={18} />}>
-              {linkError}
-            </Alert>
-          )}
-
-          {/* Verifying a second person only means something when the manager
-              is someone other than the owner. */}
-          {!gmSameAsOwner && gm && (
-            <FaydaVerifyPanel
-              subject="gm"
-              title="General Manager"
-              state={gm}
-              required={faydaRequired}
-              disabled={linkPending || mutation.isPending}
-            />
-          )}
-
-          {/* Typed details survive only where Fayda cannot be required — a
-              foreign company's manager may hold no Fayda ID. Once verified the
-              API owns these fields and refuses edits, so they go away. */}
-          {!gmSameAsOwner && !gm?.verified && !faydaRequired && (
-            <>
-              <TextInput
-                label="Full Name"
-                placeholder="Abebe Bikila"
-                error={errors.generalManagerName?.message}
-                {...register("generalManagerName")}
-              />
-
-              <Grid>
-                <Grid.Col span={6}>
-                  <TextInput
-                    label="Email Address"
-                    type="email"
-                    placeholder="gm@company.com"
-                    error={errors.generalManagerEmail?.message}
-                    {...register("generalManagerEmail")}
-                  />
-                </Grid.Col>
-                <Grid.Col span={6}>
-                  <ControlledPhoneField
-                    control={control}
-                    name="generalManagerPhone"
-                    label="Phone Number"
-                    required
-                  />
-                </Grid.Col>
-              </Grid>
-            </>
-          )}
-        </Stack>
-
-        <Group
-          justify="space-between"
-          mt="xl"
-          pt="md"
-          style={{ borderTop: "1px solid var(--mantine-color-edr-border-0)" }}
-        >
-          <Group gap="xs">
-            {mutation.isSuccess && (
-              <Group gap={6} c="green">
-                <CheckCircle2 size={16} />
-                <Text size="sm" fw={500}>Saved successfully</Text>
-              </Group>
-            )}
-            {mutation.isError && (
-              <Group gap={6} c="red">
-                <XCircle size={16} />
-                <Text size="sm" fw={500}>Save failed</Text>
-              </Group>
-            )}
-          </Group>
-          <Group gap="md">
-            {mode === "edit" && typedFieldsInUse && (
-              <Button
-                type="button"
-                variant="outline"
-                disabled={mutation.isPending || !isDirty}
-                onClick={() => reset()}
-              >
-                Reset
-              </Button>
-            )}
-            {/* Saving only means something while the details are typed: under
-                Fayda both routes write server-side, so a submit would post
-                empty strings at an identity the API owns and refuses to
-                overwrite. Onboarding still needs a way forward, so the button
-                becomes a plain Continue rather than disappearing. */}
-            {typedFieldsInUse ? (
-              <Button
-                type="submit"
-                leftSection={<Save size={16} />}
-                loading={mutation.isPending}
-              >
-                {mode === "onboarding" ? "Continue" : "Save Changes"}
-              </Button>
-            ) : (
-              mode === "onboarding" && (
-                <Button type="button" onClick={() => onContinue?.()}>
-                  Continue
-                </Button>
-              )
-            )}
-          </Group>
-        </Group>
-      </form>
-    </Card>
-  );
-}
diff --git a/apps/edr-freight-web/portal/src/pages/settings/TabOwner.tsx b/apps/edr-freight-web/portal/src/pages/settings/TabOwner.tsx
new file mode 100644
index 000000000..a1dca3f0d
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/settings/TabOwner.tsx
@@ -0,0 +1,270 @@
+import { useMemo } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useForm } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { z } from "zod";
+import { AlertTriangle, Briefcase, Save } from "lucide-react";
+import {
+  Alert,
+  Button,
+  Card,
+  Grid,
+  Group,
+  Stack,
+  Text,
+  TextInput,
+  Title,
+} from "@mantine/core";
+
+import { api } from "@/services/api";
+import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
+import FaydaVerifyPanel from "@/components/FaydaVerifyPanel";
+import SourcedField from "@/pages/accounts/companyProfileForm/SourcedField";
+import {
+  firstValidPhone,
+  normalizeIdentityPhones,
+  resolveOwnerSources,
+} from "@/pages/accounts/companyProfileForm/helpers";
+import type { ProfileResponse } from "@/types/profile";
+
+// Optional, not unrequired: whatever a Fayda verification supplied is owned by
+// the API and never typed here, so a blanket `min(1)` would fail a form that is
+// correct. Presence is gated below, where the identity state says which fields
+// are actually on screen; zod only polices format.
+const schema = z.object({
+  ownerName: z.string().optional(),
+  // The alternative credential for a foreign company's owner — asked for only
+  // when they are the identity subject and have not verified with Fayda, so
+  // like the three below it is optional here and gated on what is rendered.
+  ownerPassportNumber: z.string().optional(),
+  ownerEmail: z
+    .string()
+    .optional()
+    .refine(
+      (v) => !v || z.string().email().safeParse(v).success,
+      "Invalid owner email",
+    ),
+  ownerPhone: z
+    .string()
+    .optional()
+    .refine((v) => !v || isValidPhone(v), "Enter a valid phone number"),
+});
+
+type FormData = z.infer<typeof schema>;
+
+interface TabOwnerProps {
+  profile: ProfileResponse;
+  mode?: "edit" | "onboarding";
+  onContinue?: () => void;
+}
+
+/**
+ * The company's owner — meaning whoever the eTrade licence names as the
+ * business's manager. Not necessarily the legal owner, but the person the
+ * record has to match: the backoffice's check is that comparison.
+ *
+ * Their identity is Fayda-verified only when the company has NO Power of
+ * Attorney; when it names a representative it is the representative who
+ * verifies, and the owner's details are simply recorded (from eTrade, or typed
+ * here). Either way all three are required.
+ */
+export default function TabOwner({
+  profile,
+  mode = "edit",
+  onContinue,
+}: TabOwnerProps) {
+  const queryClient = useQueryClient();
+  // Fayda reports a phone as the national registry holds it, routinely a local
+  // number that neither this form nor the API's `@IsValidPhone()` accepts.
+  // Normalize once on read, exactly as the wizard does.
+  const identity = useMemo(
+    () => normalizeIdentityPhones(profile.identity),
+    [profile.identity],
+  );
+  const owner = identity?.owner;
+  // Only the person the declaration points at carries the verification, so the
+  // panel is offered here only when that person is the owner.
+  const ownerIsSubject = identity?.subject === "owner";
+  const ownerVerified = owner?.verified ?? false;
+
+  /**
+   * The manager the eTrade licence names, read back from what the lookup
+   * captured. The wizard shows these read-only for the same reason this tab
+   * must: that record is what the backoffice checks the company against, so it
+   * is reported, not retyped. Leaving it editable here let a customer overwrite
+   * the very value the review compares against.
+   */
+  const etradeOwner = useMemo(() => {
+    const name = identity?.etradeManagerName?.trim() ?? "";
+    // Dropped if it cannot normalize — eTrade's is free text ("09        " is a
+    // real answer), and an unusable number must fall through to an input rather
+    // than lock the field behind a value the API would reject.
+    const phone = firstValidPhone(identity?.etradeManagerPhone);
+    return name || phone ? { name, phone } : null;
+  }, [identity?.etradeManagerName, identity?.etradeManagerPhone]);
+
+  // Who owns each field, and with what value — the wizard's own rule, reused so
+  // the two cannot disagree about which details are the customer's to edit.
+  const { source: ownerSource, sourced: ownerSourced } = resolveOwnerSources(
+    identity,
+    etradeOwner,
+  );
+
+  const {
+    register,
+    control,
+    handleSubmit,
+    formState: { errors },
+  } = useForm<FormData>({
+    resolver: zodResolver(schema),
+    defaultValues: {
+      ownerName: profile.ownerName ?? "",
+      ownerEmail: profile.ownerEmail ?? "",
+      ownerPhone: profile.ownerPhone ?? "",
+      ownerPassportNumber: profile.identity?.owner.passportNumber ?? "",
+    },
+  });
+
+  const mutation = useMutation({
+    mutationFn: (data: FormData) =>
+      api.companies.updateProfile.call({
+        // A field a source owns is submitted as that source has it, not as the
+        // form happens to hold it: the read-only row is what the customer was
+        // shown, and only the fields are sent. `|| undefined`, never "": the
+        // DTO's `@IsOptional()` skips null and undefined, so an empty string is
+        // validated and 400s with "ownerEmail must be an email", and a verified
+        // owner legitimately leaves the fields Fayda supplied blank here.
+        ownerName: (ownerSourced.name || data.ownerName) || undefined,
+        ownerEmail: (ownerSourced.email || data.ownerEmail) || undefined,
+        ownerPhone: (ownerSourced.phone || data.ownerPhone) || undefined,
+        ownerPassportNumber: data.ownerPassportNumber || undefined,
+      }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: api.companies.getProfile.queryKey(),
+      });
+      if (mode === "onboarding") onContinue?.();
+    },
+  });
+
+  // A foreign owner who is the identity subject and has not verified proves
+  // themselves with a passport instead — the same either/or the wizard offers.
+  // Without an input here the only route to it was the onboarding wizard, which
+  // an onboarded company can no longer reach.
+  const passportAskable =
+    (identity?.passportAccepted ?? false) && ownerIsSubject && !ownerVerified;
+
+  // Save is offered when there is at least one input on screen to save. A field
+  // an outside source owns has none, so an owner fully supplied by Fayda and
+  // eTrade has nothing to submit.
+  const savable =
+    !ownerSource.name ||
+    !ownerSource.email ||
+    !ownerSource.phone ||
+    passportAskable;
+
+  return (
+    <Card padding="lg">
+      <Group gap="sm" mb="xs">
+        <Briefcase size={20} />
+        <Title order={3}>Company Owner</Title>
+      </Group>
+      <Text c="edr-muted" size="sm" mb="lg">
+        The person registered on your eTrade licence.
+      </Text>
+
+      <form onSubmit={handleSubmit((data) => mutation.mutate(data))}>
+        <Stack gap="md">
+          {identity?.ownerMatchesEtrade === false && (
+            <Alert
+              color="amber"
+              variant="light"
+              icon={<AlertTriangle size={18} />}
+              title="This doesn't match your eTrade licence"
+            >
+              Your licence lists <strong>{identity.etradeManagerName}</strong>.
+              Our team checks this before approving changes.
+            </Alert>
+          )}
+
+          {ownerIsSubject && owner && (
+            <FaydaVerifyPanel
+              subject="owner"
+              title="Owner identity"
+              state={owner}
+              required={!identity?.passportAccepted}
+              pendingReview={profile.reviewStatus === "pending"}
+            />
+          )}
+
+          <SourcedField
+            label="Name"
+            value={ownerSourced.name}
+            source={ownerSource.name}
+          >
+            <TextInput
+              label="Name"
+              placeholder="Abebe Bikila"
+              error={errors.ownerName?.message}
+              {...register("ownerName")}
+            />
+          </SourcedField>
+
+          <Grid>
+            <Grid.Col span={{ base: 12, sm: 6 }}>
+              <SourcedField
+                label="Email"
+                value={ownerSourced.email}
+                source={ownerSource.email}
+              >
+                <TextInput
+                  label="Email"
+                  type="email"
+                  placeholder="owner@company.com"
+                  error={errors.ownerEmail?.message}
+                  {...register("ownerEmail")}
+                />
+              </SourcedField>
+            </Grid.Col>
+            <Grid.Col span={{ base: 12, sm: 6 }}>
+              <SourcedField
+                label="Phone"
+                value={ownerSourced.phone}
+                source={ownerSource.phone}
+              >
+                <ControlledPhoneField
+                  control={control}
+                  name="ownerPhone"
+                  label="Phone"
+                />
+              </SourcedField>
+            </Grid.Col>
+          </Grid>
+
+          {passportAskable && (
+            <TextInput
+              label="Owner's Passport Number"
+              description="Fayda is an Ethiopian national ID, so a passport number proves this person instead."
+              placeholder="P1234567"
+              error={errors.ownerPassportNumber?.message}
+              {...register("ownerPassportNumber")}
+            />
+          )}
+
+          {savable && (
+            <Group justify="flex-end">
+              <Button
+                type="submit"
+                color="edr-green"
+                loading={mutation.isPending}
+                leftSection={<Save size={16} />}
+              >
+                {mode === "onboarding" ? "Save & continue" : "Save changes"}
+              </Button>
+            </Group>
+          )}
+        </Stack>
+      </form>
+    </Card>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/settings/TabPowerOfAttorney.tsx b/apps/edr-freight-web/portal/src/pages/settings/TabPowerOfAttorney.tsx
index 4c48ea238..47dd7c3c5 100644
--- a/apps/edr-freight-web/portal/src/pages/settings/TabPowerOfAttorney.tsx
+++ b/apps/edr-freight-web/portal/src/pages/settings/TabPowerOfAttorney.tsx
@@ -13,6 +13,7 @@ import {
   Undo2,
   UploadCloud,
   UserCheck,
+  UserX,
   XCircle,
 } from "lucide-react";
 import {
@@ -24,6 +25,7 @@ import {
   Card,
   Group,
   Loader,
+  SimpleGrid,
   Stack,
   Title,
   Text,
@@ -40,17 +42,68 @@ import {
   type LicenseFileStatus,
 } from "@/services/companies.service";
 import FaydaVerifyPanel from "@/components/FaydaVerifyPanel";
+import { ControlledPhoneField, isValidPhone } from "@/components/PhoneField";
+import {
+  firstValidEmail,
+  firstValidPhone,
+  normalizeIdentityPhones,
+} from "@/pages/accounts/companyProfileForm/helpers";
 import { verifaydaService } from "@/services/verifayda.service";
+import RoleCard from "@/pages/settings/RoleCard";
 import type { ProfileResponse } from "@/types/profile";
 
-// The representative's name, email, phone and address all come from their
-// Fayda verification — a PoA is always an Ethiopian holding one — so the city
-// is the only detail this form owns.
-const schema = z.object({
-  poaLocation: z.string().optional(),
-});
+/** The representative's details that a Fayda verification may or may not own. */
+const POA_LABELS = {
+  poaName: "Representative's name",
+  poaEmail: "Representative's email",
+  poaPhone: "Representative's phone",
+} as const;
 
-type FormData = z.infer<typeof schema>;
+type PoaField = keyof typeof POA_LABELS;
+
+/**
+ * The representative's details.
+ *
+ * Optional here, not unrequired. Whatever their Fayda verification supplied is
+ * owned by the API and shown read-only, so a blanket `min(1)` would fail a form
+ * that is correct — but Fayda's email and phone claims are optional and
+ * routinely come back empty, and the API's own `REQUIRED_POA_FIELDS` demands
+ * all three once a representative is declared. So requiredness is decided per
+ * render, exactly as the wizard decides it: **a field is required iff there is
+ * an input on screen for it.** This form used to assume the verification always
+ * supplied everything and rendered no inputs at all, which left a company
+ * reported incomplete with nowhere to fix it.
+ */
+const buildSchema = (required: readonly PoaField[]) =>
+  z
+    .object({
+      poaName: z.string().optional(),
+      poaEmail: z
+        .string()
+        .optional()
+        .refine(
+          (v) => !v || z.string().email().safeParse(v).success,
+          "Invalid email address",
+        ),
+      poaPhone: z
+        .string()
+        .optional()
+        .refine((v) => !v || isValidPhone(v), "Enter a valid phone number"),
+      poaPassportNumber: z.string().optional(),
+      poaLocation: z.string().optional(),
+    })
+    .superRefine((d, ctx) => {
+      for (const key of required) {
+        if (d[key]?.trim()) continue;
+        ctx.addIssue({
+          code: "custom",
+          path: [key],
+          message: `${POA_LABELS[key]} is required`,
+        });
+      }
+    });
+
+type FormData = z.infer<ReturnType<typeof buildSchema>>;
 
 const LETTER_ACCEPT = ".pdf,.png,.jpg,.jpeg";
 
@@ -93,18 +146,63 @@ export default function TabPowerOfAttorney({
   const { view, viewer } = useFileViewer();
   const uploadInputRef = useRef<HTMLInputElement>(null);
 
+  // Fayda holds a phone as the national registry does, often a local number the
+  // form's E.164 validation would reject. Normalize on read, as the wizard does.
+  const identity = useMemo(
+    () => normalizeIdentityPhones(profile.identity),
+    [profile.identity],
+  );
+  const poa = identity?.poa;
+  const poaVerified = poa?.verified ?? false;
+
+  /**
+   * Which details the verification owns. Same test as the wizard's: presence is
+   * not enough for an email or a phone, because Fayda's claims are free text and
+   * one the schema would reject is not a claim an input can be hidden behind.
+   */
+  const locked = {
+    name: poaVerified && Boolean(poa?.name?.trim()),
+    email: poaVerified && Boolean(firstValidEmail(poa?.email)),
+    phone: poaVerified && Boolean(firstValidPhone(poa?.phone)),
+  };
+
+  const declaredYes = (identity?.poaDeclared ?? null) === "yes";
+  const passportAccepted = identity?.passportAccepted ?? false;
+  /**
+   * The person exists to describe. Before a verification lands there is nothing
+   * to attach details to — and asking for a name the verification is about to
+   * overwrite is the trap the wizard avoids by the same rule. A foreign company
+   * whose representative may hold no Fayda ID is the exception: the passport is
+   * the proof, so its details are typed from the start.
+   */
+  const established = declaredYes && (poaVerified || passportAccepted);
+
+  const requiredPoaFields: PoaField[] = [];
+  if (established) {
+    if (!locked.name) requiredPoaFields.push("poaName");
+    if (!locked.email) requiredPoaFields.push("poaEmail");
+    if (!locked.phone) requiredPoaFields.push("poaPhone");
+  }
+
   const defaultValues = useMemo(
-    (): FormData => ({ poaLocation: profile.poaLocation ?? "" }),
+    (): FormData => ({
+      poaName: profile.poaName ?? "",
+      poaEmail: profile.poaEmail ?? "",
+      poaPhone: profile.poaPhone ?? "",
+      poaPassportNumber: profile.identity?.poa.passportNumber ?? "",
+      poaLocation: profile.poaLocation ?? "",
+    }),
     [profile],
   );
 
   const {
     register,
+    control,
     handleSubmit,
     reset,
     formState: { errors, isDirty },
   } = useForm<FormData>({
-    resolver: zodResolver(schema),
+    resolver: zodResolver(buildSchema(requiredPoaFields)),
     values: defaultValues,
   });
 
@@ -130,27 +228,33 @@ export default function TabPowerOfAttorney({
   const requirePoa = profile.companyProfiles.some(
     (p) => p.type === "freight_forwarder",
   );
-  // No company types its representative's details — they come from the Fayda
-  // verification whatever the nationality, since a representative acts for the
-  // company inside Ethiopia either way. A PoA therefore exists exactly when one
-  // has been verified.
-  const identity = profile.identity;
-  const poaProvided = identity?.poa.verified ?? false;
-  // The paper authorises the representative named above, so there is nothing
-  // for it to authorise until one has been verified — the upload is hidden
-  // until then, and requiring it while hidden would block the save on a
-  // control the customer cannot see. A freight forwarder is still held to
-  // having a PoA at all, by the verification gate on the panel and by the API.
-  const letterRequired = poaProvided;
+  // Whether there is a representative at all is the company's own declaration,
+  // held server-side — it decides whose identity the API gates on, so it is
+  // never local state here.
+  const declared = identity?.poaDeclared ?? null;
+  // The paper is owed exactly when the company says it has a representative —
+  // the same single rule `assertPoaDelegationSatisfied` enforces. Keying it on
+  // the verification instead would hide the upload from a foreign company whose
+  // representative proves themselves by passport, then fail the save for a file
+  // that was never offered.
+  const letterRequired = declared === "yes";
   const letterMissing = letterRequired && !hasLetterAfterSave;
 
   const fileDirty = Boolean(pickedFile) || removeIds.length > 0;
 
   const mutation = useMutation({
     mutationFn: async (data: FormData) => {
-      // Every identity field except the city is written by the verification, so
-      // only the paper and the location are ever saved here.
-      const fields = { poaLocation: data.poaLocation || undefined };
+      // Whatever the verification did NOT supply is this form's to save, plus
+      // the paper. A field it owns is legitimately blank here (there is no
+      // input), and `|| undefined` keeps that blank out of the payload — the
+      // DTO's `@IsOptional()` skips null and undefined, never "".
+      const fields = {
+        poaName: data.poaName || undefined,
+        poaEmail: data.poaEmail || undefined,
+        poaPhone: data.poaPhone || undefined,
+        poaPassportNumber: data.poaPassportNumber || undefined,
+        poaLocation: data.poaLocation || undefined,
+      };
       // A fresh upload already stages the removal of every paper on file, so
       // the explicit removals only need applying when no replacement was
       // picked. Saving the details after it means the API sees the new paper.
@@ -182,11 +286,12 @@ export default function TabPowerOfAttorney({
 
   /**
    * A verified representative cannot be removed by blanking the form — their
-   * fields are owned by the verification — so removal is its own action that
-   * clears the identity and the delegation paper together.
+   * fields are owned by the verification — so removal is answering the
+   * declaration "no", which clears the identity, the details and the
+   * delegation paper together. Refused by the API for a freight forwarder.
    */
   const removeMutation = useMutation({
-    mutationFn: () => verifaydaService.removePoa(),
+    mutationFn: () => verifaydaService.setPoaDeclared("no"),
     onSuccess: () => {
       resetAll();
       queryClient.invalidateQueries({
@@ -198,6 +303,40 @@ export default function TabPowerOfAttorney({
     },
   });
 
+  /**
+   * Answer the power-of-attorney question.
+   *
+   * "No" means the owner acts for the company themselves — there is no
+   * delegation, so no DARS paper is owed and it is the OWNER whose identity is
+   * verified. The API tears the representative down when this is answered, and
+   * refuses "no" outright for a freight forwarder.
+   */
+  const [linkPending, setLinkPending] = useState(false);
+  const [linkError, setLinkError] = useState<string | null>(null);
+  const declare = async (next: "yes" | "no") => {
+    setLinkError(null);
+    setLinkPending(true);
+    try {
+      await verifaydaService.setPoaDeclared(next);
+      queryClient.invalidateQueries({
+        queryKey: api.companies.getProfile.queryKey(),
+      });
+      queryClient.invalidateQueries({
+        queryKey: api.companies.poaDelegation.queryKey(),
+      });
+    } catch (err) {
+      setLinkError(
+        (err as { response?: { data?: { message?: string } } })?.response?.data
+          ?.message ??
+        (err instanceof Error
+          ? err.message
+          : "Could not update the Power of Attorney"),
+      );
+    } finally {
+      setLinkPending(false);
+    }
+  };
+
   const onSubmit = (data: FormData) => {
     // The letter lives outside the form state, so it's gated here rather than
     // in the zod resolver.
@@ -246,32 +385,129 @@ export default function TabPowerOfAttorney({
           )}
         </Group>
         <Text c="edr-muted" size="sm" mb="lg">
-          {requirePoa
-            ? "As a freight forwarder you act on other companies' behalf, so a Power of Attorney and its DARS delegation paper are required."
-            : "Power of Attorney details are optional. If you name a representative, upload the DARS delegation paper authorising them."}
+          {/* The "Required for freight forwarder" badge above already says why
+              a forwarder has no choice here; repeating it in prose was a
+              lecture, not information. */}
+          {!requirePoa &&
+            "Tell us whether anyone is authorised to act for the company — your answer decides whose identity we verify. "}
+          {declared === "no"
+            ? "The owner acts for the company, so no delegation paper is needed."
+            : "A representative must be identified, and the DARS delegation paper authorising them uploaded."}
         </Text>
 
+        {/* The owner representing their own company is the ordinary
+            small-business case: a verified owner's identity is reused outright,
+            and either way the declaration waives the DARS paper. Where Fayda is
+            mandatory it needs a verified owner first — there would be nothing
+            proven to copy, and a representative who could never satisfy the
+            gate. */}
+        {/* The declaration itself. "No" is not a lesser answer — it means the
+            owner acts for the company, so it is the OWNER who verifies and no
+            delegation paper is owed. A freight forwarder cannot choose it; the
+            API refuses and the error lands in `linkError`. */}
         {identity && (
+          <SimpleGrid cols={{ base: 1, sm: 2 }} spacing="md" mb="md">
+            <RoleCard
+              label="Yes, we have a representative"
+              description="Someone other than the owner is authorised to act for the company. Their identity is verified and the DARS delegation paper is required."
+              icon={<UserCheck size={20} />}
+              selected={declared === "yes"}
+              onClick={
+                linkPending || declared === "yes"
+                  ? undefined
+                  : () => void declare("yes")
+              }
+            />
+            <RoleCard
+              label="No, the owner acts for us"
+              description="Nobody holds power of attorney. The owner's identity is verified instead, and no delegation paper is needed."
+              icon={<UserX size={20} />}
+              selected={declared === "no"}
+              onClick={
+                linkPending || declared === "no"
+                  ? undefined
+                  : () => void declare("no")
+              }
+            />
+          </SimpleGrid>
+        )}
+
+        {linkError && (
+          <Alert color="red" variant="light" icon={<XCircle size={18} />} mt="md">
+            {linkError}
+          </Alert>
+        )}
+
+        {/* Verifying a second person only means something when the
+            representative is someone other than the owner. */}
+        {identity && declared === "yes" && (
           <FaydaVerifyPanel
             subject="poa"
             title="Power of Attorney"
             state={identity.poa}
-            required={requirePoa}
-            disabled={mutation.isPending}
+            required={!identity.passportAccepted}
+            disabled={mutation.isPending || linkPending}
           />
         )}
 
         <form onSubmit={handleSubmit(onSubmit)}>
           <Stack gap="md">
-            {/* Name, email, phone and address all come from the Fayda
-                verification and are shown on the panel above. Only a company
-                whose representative may hold no Fayda ID still types a
-                location. */}
-            {!poaProvided && !(identity?.faydaRequired ?? false) && (
-              <Grid>
-                <Grid.Col span={6}>
+            {/* Whatever the verification supplied is on the panel above; only
+                what it left blank is asked for here. A foreign representative
+                who holds no Fayda ID proves themselves by passport instead —
+                the same either/or the onboarding wizard offers, which an
+                onboarded company can no longer reach. */}
+            {established && passportAccepted && !poaVerified && (
+              <TextInput
+                label="Representative's Passport Number"
+                description="Fayda is an Ethiopian national ID, so a passport number proves this person instead."
+                placeholder="P1234567"
+                error={errors.poaPassportNumber?.message}
+                {...register("poaPassportNumber")}
+              />
+            )}
+
+            {established && !locked.name && (
+              <TextInput
+                label="Representative's Name"
+                placeholder="Abebe Bikila"
+                error={errors.poaName?.message}
+                {...register("poaName")}
+              />
+            )}
+
+            {established && (!locked.email || !locked.phone) && (
+              <SimpleGrid
+                cols={{ base: 1, sm: !locked.email && !locked.phone ? 2 : 1 }}
+                spacing="md"
+              >
+                {!locked.email && (
                   <TextInput
-                    label="PoA Location"
+                    label="Representative's Email"
+                    type="email"
+                    placeholder="representative@company.com"
+                    error={errors.poaEmail?.message}
+                    {...register("poaEmail")}
+                  />
+                )}
+                {!locked.phone && (
+                  <ControlledPhoneField
+                    control={control}
+                    name="poaPhone"
+                    label="Representative's Phone"
+                  />
+                )}
+              </SimpleGrid>
+            )}
+
+            {/* The company's own statement of where the representative is
+                based — never Fayda's `poaAddress`, which the portal does not
+                send — so it stays typeable however well Fayda knows them. */}
+            {established && (
+              <Grid>
+                <Grid.Col span={{ base: 12, sm: 6 }}>
+                  <TextInput
+                    label="Representative's Location"
                     placeholder="City, Country"
                     error={errors.poaLocation?.message}
                     {...register("poaLocation")}
@@ -284,7 +520,7 @@ export default function TabPowerOfAttorney({
           {/* ------------------------ Delegation letter ------------------------ */}
           {/* The paper authorises the representative the verification named,
               so it only has meaning once one exists. */}
-          {poaProvided && (
+          {declared === "yes" && (
           <Stack gap="sm" mt="xl">
             <Group justify="space-between" align="center">
               <Group gap="sm">
@@ -326,7 +562,7 @@ export default function TabPowerOfAttorney({
               >
                 {requirePoa
                   ? "Upload the DARS delegation paper before saving — it is required for freight forwarders."
-                  : "Upload the DARS delegation paper for the representative you named, or clear the PoA details."}
+                  : "Upload the DARS delegation paper for the representative you named, or answer \u201cthe owner acts for us\u201d instead."}
               </Alert>
             )}
 
@@ -459,8 +695,12 @@ export default function TabPowerOfAttorney({
               )}
             </Group>
             <Group gap="md">
+              {/* Answering "the owner acts for us" is the same teardown, so
+                  this is only a shortcut — and it is refused to a forwarder,
+                  which cannot be without a representative. */}
               {mode === "edit" &&
                 identity?.poa.verified &&
+                declared === "yes" &&
                 !requirePoa && (
                   <Button
                     type="button"
diff --git a/apps/edr-freight-web/portal/src/pages/settings/companyProfileSchema.test.ts b/apps/edr-freight-web/portal/src/pages/settings/companyProfileSchema.test.ts
new file mode 100644
index 000000000..1875aee1b
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/settings/companyProfileSchema.test.ts
@@ -0,0 +1,70 @@
+import { describe, expect, it } from "vitest";
+
+import { buildCompanyProfileSchema } from "./TabCompanyProfile";
+
+/**
+ * The two rules this schema exists to keep in step with onboarding: what counts
+ * as a VAT number, and who has to type their registration.
+ */
+const base = {
+  companyName: "Acme plc",
+  companyLocation: "Addis Ababa",
+  companyAddress: "",
+  tinNumber: "0012345678",
+  vatNumber: "0012345678",
+  region: "Addis Ababa",
+  zone: "Bole",
+  woreda: "03",
+  kebele: "07",
+  houseNo: "",
+};
+
+describe("buildCompanyProfileSchema", () => {
+  it("accepts a VAT number no Ethiopian format rule would allow", () => {
+    // The whole point of reusing onboarding's rule: a foreign company's VAT is
+    // its own tax authority's, and the stricter copy locked it out of the tab.
+    const parsed = buildCompanyProfileSchema(false).safeParse({
+      ...base,
+      vatNumber: "GB123456789",
+    });
+    expect(parsed.success).toBe(true);
+  });
+
+  it("still requires a VAT number", () => {
+    const parsed = buildCompanyProfileSchema(false).safeParse({
+      ...base,
+      vatNumber: "",
+    });
+    expect(parsed.success).toBe(false);
+  });
+
+  it("does not require the registration block off an eTrade company", () => {
+    // It is read-only for them, so requiring it would fail a save on a field
+    // with no input to fix it.
+    const parsed = buildCompanyProfileSchema(false).safeParse({
+      ...base,
+      companyName: "",
+      region: "",
+      zone: "",
+      woreda: "",
+      kebele: "",
+    });
+    expect(parsed.success).toBe(true);
+  });
+
+  it("requires it of a company that types it by hand", () => {
+    const parsed = buildCompanyProfileSchema(true).safeParse({
+      ...base,
+      region: "",
+    });
+    expect(parsed.success).toBe(false);
+    expect(parsed.error?.issues.map((i) => i.path[0])).toContain("region");
+  });
+
+  it("leaves the house number optional either way", () => {
+    expect(
+      buildCompanyProfileSchema(true).safeParse({ ...base, houseNo: "" })
+        .success,
+    ).toBe(true);
+  });
+});
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineBookingDetailPage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineBookingDetailPage.tsx
new file mode 100644
index 000000000..9b5d2ac00
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineBookingDetailPage.tsx
@@ -0,0 +1,893 @@
+import {
+  Alert,
+  Badge,
+  Button,
+  Center,
+  Group,
+  Loader,
+  Modal,
+  Stack,
+  Table,
+  Tabs,
+  Text,
+  Textarea,
+} from "@mantine/core";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  AlertCircle,
+  ArrowLeft,
+  Ban,
+  CheckCircle2,
+  ClipboardList,
+  Clock,
+  Container,
+  FileText,
+  Flame,
+  Package,
+  PackageCheck,
+  Snowflake,
+  Train,
+  Upload,
+  Wallet,
+} from "lucide-react";
+import { useState } from "react";
+import { useNavigate, useParams } from "react-router-dom";
+
+import { BookingStatusBadge as StatusBadge } from "@/pages/bookings/booking-display";
+import {
+  BodyGrid,
+  CardTitle,
+  PageShell,
+  SectionCard,
+} from "@/pages/bookings/BookingDetailPage/components/layout";
+import type { ShippingLineBooking } from "@/services/shipping-line-bookings.service";
+import { shippingLineBookingsService } from "@/services/shipping-line-bookings.service";
+
+import {
+  bookingDocState,
+  hasDocuments,
+  needsUpload,
+  DOC_STATE_ACTION_LABEL,
+  DOC_STATE_COLOR,
+  DOC_STATE_LABEL,
+} from "./booking-doc-state";
+import ShippingLineDocumentsModal from "./ShippingLineDocumentsModal";
+
+/**
+ * Statuses a booking can be cancelled from — everything before it is priced.
+ * Mirrors SHIPPING_LINE_CANCELLABLE_STATUSES on the API.
+ */
+const CANCELLABLE_STATUSES = new Set([
+  "AWAITING_DOCUMENTS",
+  "DOCUMENTS_UNDER_REVIEW",
+  "CLEARANCE_READY",
+  "CHANGES_REQUESTED",
+]);
+
+/**
+ * Shipping-line booking detail.
+ *
+ * Shaped like the customer booking detail page — same shell, same two-column
+ * body — but split into Documents / Booking details tabs, since a bare
+ * shipping-line booking has little else to show until it is completed.
+ */
+export default function ShippingLineBookingDetailPage() {
+  const { id = "" } = useParams();
+  const navigate = useNavigate();
+  const queryClient = useQueryClient();
+  const [docsOpen, setDocsOpen] = useState(false);
+  const [cancelOpen, setCancelOpen] = useState(false);
+  const [cancelReason, setCancelReason] = useState("");
+
+  const bookingQuery = useQuery({
+    queryKey: ["shipping-line-bookings", id],
+    queryFn: () => shippingLineBookingsService.getById(id),
+    enabled: Boolean(id),
+  });
+
+  // Trains dedicated to this shipping line — matched to the booking below by
+  // lane (+ shipment day when one is set) so the detail shows which departure
+  // will carry it.
+  const trainsQuery = useQuery({
+    queryKey: ["shipping-line-my-trains"],
+    queryFn: shippingLineBookingsService.myTrains,
+  });
+
+  // Operations view: the assigned/requested train and the wagons the batch
+  // engine allocated — feeds the Wagons & Train tab.
+  const operationsQuery = useQuery({
+    queryKey: ["shipping-line-bookings", id, "operations"],
+    queryFn: () => shippingLineBookingsService.operations(id),
+    enabled: Boolean(id),
+  });
+
+  const cancelMutation = useMutation({
+    mutationFn: () => shippingLineBookingsService.cancel(id, cancelReason),
+    onSuccess: () => {
+      setCancelOpen(false);
+      setCancelReason("");
+      void queryClient.invalidateQueries({
+        queryKey: ["shipping-line-bookings"],
+      });
+    },
+  });
+
+  if (bookingQuery.isLoading) {
+    return (
+      <PageShell>
+        <Center py={80}>
+          <Loader size="sm" />
+        </Center>
+      </PageShell>
+    );
+  }
+
+  if (bookingQuery.isError || !bookingQuery.data) {
+    return (
+      <PageShell>
+        <Alert color="red">This booking could not be loaded.</Alert>
+      </PageShell>
+    );
+  }
+
+  const booking: ShippingLineBooking = bookingQuery.data;
+
+  // A train matches when it runs the booking's lane; with a shipment day set,
+  // it must also depart that calendar day.
+  const sameDay = (a: string | Date, b: string | Date) =>
+    new Date(a).toDateString() === new Date(b).toDateString();
+  const matchedTrains = (trainsQuery.data ?? []).filter(
+    (train) =>
+      train.originYardId === booking.originYard?.id &&
+      train.destinationYardId === booking.destinationYard?.id &&
+      (!booking.scheduledDate ||
+        sameDay(train.scheduledDepartureDate, booking.scheduledDate)),
+  );
+
+  const status = booking.status as string;
+  const docState = bookingDocState(booking);
+  const showDocs = hasDocuments(docState);
+  const wantsUpload = needsUpload(docState);
+  const actionNeeded = docState === "ACTION_NEEDED";
+
+  const containers = booking.bookingContainers ?? [];
+  // Booking flag OR any line count — per-line opt-ins must light the badge
+  // even when the booking-level flag lags.
+  const isHazardous =
+    Boolean(booking.isHazardous) ||
+    containers.some((c) => Number(c.hazardousQuantity ?? 0) > 0);
+  const isReefer = containers.some((c) => Number(c.reeferQuantity ?? 0) > 0);
+  const breakdown = booking.pricingBreakdown ?? null;
+  const operations = operationsQuery.data ?? null;
+
+  // Mirrors the server's rule: cancellable only before the booking is priced.
+  // Kept in sync deliberately — a button the API would reject is worse than no
+  // button at all.
+  const canCancel =
+    CANCELLABLE_STATUSES.has(status) && !(Number(booking.totalAmount ?? 0) > 0);
+
+  // Approved documents (or an operations return) unlock the completion step —
+  // cargo + shipment day, the customer's post-clearance move. Mirrors the
+  // statuses completeMine accepts on the API.
+  const canComplete =
+    status === "CLEARANCE_READY" || status === "OPERATION_CHANGES_REQUESTED";
+
+  return (
+    <PageShell>
+      <Button
+        variant="subtle"
+        color="gray"
+        size="compact-sm"
+        w="fit-content"
+        leftSection={<ArrowLeft size={15} />}
+        onClick={() => navigate("/shipping-line/bookings")}
+      >
+        Back to bookings
+      </Button>
+
+      <Group justify="space-between" align="flex-start" wrap="wrap" gap="md">
+        <Stack gap={8} miw={0}>
+          <Text fz="26px" fw={800} c="#10202F">
+            {booking.reference}
+          </Text>
+          <Group gap={8}>
+            <StatusBadge status={status} />
+            {showDocs && (
+              <Badge
+                size="sm"
+                variant="light"
+                radius="sm"
+                color={DOC_STATE_COLOR[docState]}
+                leftSection={
+                  actionNeeded ? <AlertCircle size={12} /> : undefined
+                }
+              >
+                {DOC_STATE_LABEL[docState]}
+              </Badge>
+            )}
+            {isHazardous && (
+              <Badge
+                size="sm"
+                variant="filled"
+                radius="sm"
+                color="red"
+                leftSection={<Flame size={11} />}
+              >
+                Hazardous
+              </Badge>
+            )}
+            {isReefer && (
+              <Badge
+                size="sm"
+                variant="filled"
+                radius="sm"
+                color="blue"
+                leftSection={<Snowflake size={11} />}
+              >
+                Refrigerated
+              </Badge>
+            )}
+          </Group>
+        </Stack>
+
+        <Group gap="sm">
+          {canCancel && (
+            <Button
+              variant="light"
+              color="red"
+              radius="md"
+              leftSection={<Ban size={16} />}
+              onClick={() => setCancelOpen(true)}
+            >
+              Cancel booking
+            </Button>
+          )}
+          {showDocs && (
+            <Button
+              color={actionNeeded ? "red" : "edr-green"}
+              variant={wantsUpload ? "filled" : "light"}
+              radius="md"
+              leftSection={
+                wantsUpload ? <Upload size={16} /> : <FileText size={16} />
+              }
+              onClick={() => setDocsOpen(true)}
+            >
+              {DOC_STATE_ACTION_LABEL[docState]}
+            </Button>
+          )}
+          {canComplete && (
+            <Button
+              color="edr-green"
+              radius="md"
+              leftSection={<PackageCheck size={16} />}
+              onClick={() =>
+                navigate(`/shipping-line/bookings/${booking.id}/complete`)
+              }
+            >
+              {status === "OPERATION_CHANGES_REQUESTED"
+                ? "Resubmit booking"
+                : "Book"}
+            </Button>
+          )}
+        </Group>
+      </Group>
+
+      {/* Operations' return note belongs at the top of the page — the line
+          must see what to fix without hunting through the tabs. */}
+      {status === "OPERATION_CHANGES_REQUESTED" && (
+        <Alert
+          color="orange"
+          radius="md"
+          icon={<AlertCircle size={18} />}
+          title="Operations requested changes"
+        >
+          {booking.operationChangeNote?.trim() ||
+            "Operations returned your booking request for changes. Resubmit it with an updated shipment day or cargo."}
+        </Alert>
+      )}
+
+      <Tabs defaultValue="documents" keepMounted={false}>
+        <Tabs.List>
+          <Tabs.Tab
+            value="documents"
+            leftSection={<FileText size={15} />}
+            // The one place a query surfaces without opening the tab.
+            rightSection={
+              actionNeeded ? (
+                <Badge size="xs" circle variant="filled" color="red">
+                  !
+                </Badge>
+              ) : undefined
+            }
+          >
+            Documents
+          </Tabs.Tab>
+          <Tabs.Tab value="details" leftSection={<Package size={15} />}>
+            Booking details
+          </Tabs.Tab>
+          <Tabs.Tab value="cargo" leftSection={<Container size={15} />}>
+            Cargo
+          </Tabs.Tab>
+          <Tabs.Tab value="price" leftSection={<Wallet size={15} />}>
+            Price
+          </Tabs.Tab>
+          <Tabs.Tab value="operations" leftSection={<Train size={15} />}>
+            Wagons & Train
+          </Tabs.Tab>
+        </Tabs.List>
+
+        <Tabs.Panel value="documents" pt="lg">
+          <SectionCard>
+            <CardTitle>Documents</CardTitle>
+
+            <Stack gap="md" mt="sm">
+              {docState === "ACTION_NEEDED" ? (
+                <Alert color="red" radius="md" icon={<AlertCircle size={18} />}>
+                  Operations returned one or more documents with a query. Open
+                  the documents, read the note on each flagged item and upload a
+                  corrected file — the booking cannot move on until you do.
+                </Alert>
+              ) : docState === "AWAITING" ? (
+                <Alert
+                  color="yellow"
+                  radius="md"
+                  icon={<ClipboardList size={18} />}
+                >
+                  This booking is waiting on your documents. Upload them for
+                  Operations to review — the booking can be completed once they
+                  are approved.
+                </Alert>
+              ) : docState === "IN_REVIEW" ? (
+                <Alert color="blue" radius="md" icon={<Clock size={18} />}>
+                  Your documents are with Operations for review. You can still
+                  open them, and replace any that come back with a query.
+                </Alert>
+              ) : status === "OPERATION_REQUEST_PENDING" ? (
+                <Alert color="blue" radius="md" icon={<Clock size={18} />}>
+                  Your booking is complete and with Operations for review. The
+                  charge has been recorded on your credit account.
+                </Alert>
+              ) : status === "OPERATION_CHANGES_REQUESTED" ? (
+                <Alert color="orange" radius="md" icon={<AlertCircle size={18} />}>
+                  {booking.operationChangeNote?.trim() ||
+                    "Operations returned your booking request for changes. Resubmit it with an updated shipment day or cargo."}
+                </Alert>
+              ) : (
+                <Alert
+                  color="teal"
+                  radius="md"
+                  icon={<CheckCircle2 size={18} />}
+                >
+                  Your documents are approved.
+                  {status === "CLEARANCE_READY" &&
+                    " Complete the booking with your cargo and shipment day to proceed."}
+                </Alert>
+              )}
+
+              <Group gap="sm">
+                <Button
+                  color={actionNeeded ? "red" : "edr-green"}
+                  variant={wantsUpload ? "filled" : "light"}
+                  radius="md"
+                  w="fit-content"
+                  leftSection={
+                    wantsUpload ? <Upload size={16} /> : <FileText size={16} />
+                  }
+                  onClick={() => setDocsOpen(true)}
+                >
+                  {DOC_STATE_ACTION_LABEL[docState]}
+                </Button>
+                {canComplete && (
+                  <Button
+                    color="edr-green"
+                    radius="md"
+                    leftSection={<PackageCheck size={16} />}
+                    onClick={() =>
+                navigate(`/shipping-line/bookings/${booking.id}/complete`)
+              }
+                  >
+                    {status === "OPERATION_CHANGES_REQUESTED"
+                      ? "Resubmit booking"
+                      : "Book"}
+                  </Button>
+                )}
+              </Group>
+            </Stack>
+          </SectionCard>
+        </Tabs.Panel>
+
+        <Tabs.Panel value="details" pt="lg">
+          <BodyGrid
+            left={
+              <SectionCard>
+                <CardTitle>Shipment</CardTitle>
+                <Stack gap="xs" mt="sm">
+                  {/* Set at initiate time from the chosen route, so it is
+                      known before Operations reviews the documents. */}
+                  <DetailRow
+                    label="Route"
+                    value={
+                      booking.originYard || booking.destinationYard
+                        ? `${
+                            booking.originYard?.label ??
+                            booking.originYard?.code ??
+                            "—"
+                          } → ${
+                            booking.destinationYard?.label ??
+                            booking.destinationYard?.code ??
+                            "—"
+                          }`
+                        : "—"
+                    }
+                  />
+                  <DetailRow
+                    label="Freight type"
+                    value={booking.freightType ?? "—"}
+                  />
+                  <DetailRow
+                    label="Trade direction"
+                    value={booking.tradeDirection ?? "—"}
+                  />
+                  <DetailRow
+                    label="Shipment day"
+                    value={
+                      booking.scheduledDate
+                        ? new Date(booking.scheduledDate).toLocaleDateString()
+                        : "Not scheduled yet"
+                    }
+                  />
+                  <DetailRow
+                    label="Train"
+                    value={
+                      matchedTrains.length
+                        ? matchedTrains
+                            .map(
+                              (t) =>
+                                `${t.trainNumber ?? t.reference ?? "Train"} — departs ${new Date(
+                                  t.scheduledDepartureDate,
+                                ).toLocaleString(undefined, {
+                                  month: "short",
+                                  day: "numeric",
+                                  hour: "2-digit",
+                                  minute: "2-digit",
+                                })}`,
+                            )
+                            .join(" · ")
+                        : "No train assigned for this lane and day yet"
+                    }
+                  />
+                </Stack>
+              </SectionCard>
+            }
+            right={
+              <SectionCard>
+                <CardTitle>Booking</CardTitle>
+                <Stack gap="xs" mt="sm">
+                  <DetailRow label="Reference" value={booking.reference} />
+                  <DetailRow label="Status" value={status} />
+                  <DetailRow
+                    label="Created"
+                    value={
+                      booking.createdAt
+                        ? new Date(booking.createdAt).toLocaleDateString()
+                        : "—"
+                    }
+                  />
+                  {/* Set at completion — the charge sits on the line's credit
+                      account (pay-later), so no pay button follows it. */}
+                  {Number(booking.totalAmount ?? 0) > 0 && (
+                    <DetailRow
+                      label="Amount (on credit)"
+                      value={`${Number(booking.totalAmount).toLocaleString()} ${
+                        booking.paymentCurrency ?? ""
+                      }`.trim()}
+                    />
+                  )}
+                  <DetailRow
+                    label="Billing currency"
+                    value={booking.paymentCurrency ?? "ETB"}
+                  />
+                  {booking.cargoFreeText && (
+                    <DetailRow
+                      label="Cargo description"
+                      value={booking.cargoFreeText}
+                    />
+                  )}
+                </Stack>
+              </SectionCard>
+            }
+          />
+        </Tabs.Panel>
+
+        <Tabs.Panel value="cargo" pt="lg">
+          <SectionCard>
+            <CardTitle>Cargo</CardTitle>
+            {containers.length === 0 &&
+            !(Number(booking.cargoTotalWeightVgm ?? 0) > 0) ? (
+              <Text fz={13} c="edr-muted" mt="sm">
+                No cargo entered yet — it is added when you complete the
+                booking after your documents are approved.
+              </Text>
+            ) : booking.freightType === "BULK" ? (
+              <Stack gap="xs" mt="sm">
+                <DetailRow
+                  label="Cargo type"
+                  value={booking.cargoType?.cargoTypeName ?? "—"}
+                />
+                <DetailRow
+                  label="Total weight"
+                  value={`${Number(
+                    booking.bulkTotalWeightTons ??
+                      booking.cargoTotalWeightVgm ??
+                      0,
+                  ).toLocaleString()} tons`}
+                />
+                {booking.cargoFreeText && (
+                  <DetailRow
+                    label="Description"
+                    value={booking.cargoFreeText}
+                  />
+                )}
+              </Stack>
+            ) : (
+              <Stack gap="md" mt="sm">
+                <Table verticalSpacing="sm" horizontalSpacing="md">
+                  <Table.Thead>
+                    <Table.Tr>
+                      <Table.Th>Container type</Table.Th>
+                      <Table.Th ta="right">Qty</Table.Th>
+                      <Table.Th ta="right">VGM / unit</Table.Th>
+                      <Table.Th ta="right">Hazardous</Table.Th>
+                      <Table.Th ta="right">Reefer</Table.Th>
+                    </Table.Tr>
+                  </Table.Thead>
+                  <Table.Tbody>
+                    {containers.map((line) => (
+                      <Table.Tr key={line.id}>
+                        <Table.Td>
+                          <Text fw={600} fz={13}>
+                            {line.containerType?.label ??
+                              line.containerType?.code ??
+                              line.containerSize ??
+                              "—"}
+                          </Text>
+                        </Table.Td>
+                        <Table.Td ta="right">{line.quantity}</Table.Td>
+                        <Table.Td ta="right">
+                          {Number(line.vgmPerUnitTons ?? 0)} t
+                        </Table.Td>
+                        <Table.Td ta="right">
+                          {Number(line.hazardousQuantity ?? 0) > 0 ? (
+                            <Text fw={700} c="red" fz={13}>
+                              {line.hazardousQuantity}
+                            </Text>
+                          ) : (
+                            "—"
+                          )}
+                        </Table.Td>
+                        <Table.Td ta="right">
+                          {Number(line.reeferQuantity ?? 0) > 0 ? (
+                            <Text fw={700} c="blue" fz={13}>
+                              {line.reeferQuantity}
+                            </Text>
+                          ) : (
+                            "—"
+                          )}
+                        </Table.Td>
+                      </Table.Tr>
+                    ))}
+                  </Table.Tbody>
+                </Table>
+
+                {/* Per-container manifest, when the numbers were entered. */}
+                {containers.some((l) => (l.units?.length ?? 0) > 0) && (
+                  <>
+                    <CardTitle>Containers</CardTitle>
+                    <Table verticalSpacing="xs" horizontalSpacing="md">
+                      <Table.Thead>
+                        <Table.Tr>
+                          <Table.Th>Container no.</Table.Th>
+                          <Table.Th>Seal</Table.Th>
+                          <Table.Th ta="right">VGM</Table.Th>
+                          <Table.Th>Handling</Table.Th>
+                        </Table.Tr>
+                      </Table.Thead>
+                      <Table.Tbody>
+                        {containers.flatMap((line) =>
+                          (line.units ?? []).map((unit) => (
+                            <Table.Tr key={unit.id}>
+                              <Table.Td>
+                                <Text fw={600} fz={13}>
+                                  {unit.containerNumber ?? "—"}
+                                </Text>
+                              </Table.Td>
+                              <Table.Td>{unit.sealNumber ?? "—"}</Table.Td>
+                              <Table.Td ta="right">
+                                {Number(unit.vgmTons ?? 0)} t
+                              </Table.Td>
+                              <Table.Td>
+                                <Group gap={4}>
+                                  {unit.isHazardous && (
+                                    <Badge size="xs" color="red" variant="filled">
+                                      Hazardous
+                                    </Badge>
+                                  )}
+                                  {unit.isReefer && (
+                                    <Badge size="xs" color="blue" variant="filled">
+                                      Reefer
+                                    </Badge>
+                                  )}
+                                  {!unit.isHazardous && !unit.isReefer && "—"}
+                                </Group>
+                              </Table.Td>
+                            </Table.Tr>
+                          )),
+                        )}
+                      </Table.Tbody>
+                    </Table>
+                  </>
+                )}
+              </Stack>
+            )}
+          </SectionCard>
+        </Tabs.Panel>
+
+        <Tabs.Panel value="price" pt="lg">
+          <SectionCard>
+            <CardTitle>Price</CardTitle>
+            {!breakdown?.lineItems?.length ? (
+              <Text fz={13} c="edr-muted" mt="sm">
+                No price yet — the booking is priced when you complete it.
+              </Text>
+            ) : (
+              <Stack gap="md" mt="sm">
+                <Table verticalSpacing="xs" horizontalSpacing="md">
+                  <Table.Thead>
+                    <Table.Tr>
+                      <Table.Th>Charge</Table.Th>
+                      <Table.Th ta="right">Qty</Table.Th>
+                      <Table.Th ta="right">Amount</Table.Th>
+                    </Table.Tr>
+                  </Table.Thead>
+                  <Table.Tbody>
+                    {breakdown.lineItems.map((item, i) => (
+                      <Table.Tr key={i}>
+                        <Table.Td>
+                          <Text fz={13}>{item.description}</Text>
+                        </Table.Td>
+                        <Table.Td ta="right">
+                          <Text fz={13} c="edr-muted">
+                            {item.quantity ?? 1}
+                          </Text>
+                        </Table.Td>
+                        <Table.Td ta="right">
+                          <Text fz={13} fw={600}>
+                            {Number(item.amount).toLocaleString()}{" "}
+                            {item.currency}
+                          </Text>
+                        </Table.Td>
+                      </Table.Tr>
+                    ))}
+                  </Table.Tbody>
+                </Table>
+                <Group
+                  justify="space-between"
+                  p="sm"
+                  style={{
+                    borderRadius: 10,
+                    background: "var(--mantine-color-teal-0)",
+                  }}
+                >
+                  <Text fw={700}>Total (on credit)</Text>
+                  <Text fw={800} fz={18}>
+                    {Number(breakdown.totalAmount).toLocaleString()}{" "}
+                    {breakdown.currency}
+                  </Text>
+                </Group>
+                <Text fz={12} c="edr-muted">
+                  Charged to your credit account — EDR bills accumulated
+                  charges periodically. Quoted{" "}
+                  {new Date(breakdown.generatedAt).toLocaleString()}.
+                </Text>
+              </Stack>
+            )}
+          </SectionCard>
+        </Tabs.Panel>
+
+        <Tabs.Panel value="operations" pt="lg">
+          <Stack gap="lg">
+            <SectionCard>
+              <CardTitle>Train</CardTitle>
+              {operationsQuery.isLoading ? (
+                <Center py="lg">
+                  <Loader size="sm" />
+                </Center>
+              ) : !operations?.train ? (
+                <Text fz={13} c="edr-muted" mt="sm">
+                  No train yet — Operations assigns one after your booking is
+                  reviewed and batched.
+                </Text>
+              ) : (
+                <Stack gap="xs" mt="sm">
+                  <Group gap={8}>
+                    <Badge
+                      size="sm"
+                      radius="sm"
+                      variant={operations.train.assigned ? "filled" : "light"}
+                      color={operations.train.assigned ? "teal" : "yellow"}
+                    >
+                      {operations.train.assigned ? "Assigned" : "Requested"}
+                    </Badge>
+                    <StatusBadge status={operations.train.status} />
+                  </Group>
+                  <DetailRow
+                    label="Train"
+                    value={
+                      operations.train.trainNumber ??
+                      operations.train.reference ??
+                      "—"
+                    }
+                  />
+                  <DetailRow
+                    label="Route"
+                    value={`${operations.train.originLabel} → ${operations.train.destinationLabel}`}
+                  />
+                  <DetailRow
+                    label="Departure"
+                    value={new Date(
+                      operations.train.scheduledDepartureDate,
+                    ).toLocaleString()}
+                  />
+                  {operations.train.scheduledArrivalDate && (
+                    <DetailRow
+                      label="Arrival"
+                      value={new Date(
+                        operations.train.scheduledArrivalDate,
+                      ).toLocaleString()}
+                    />
+                  )}
+                </Stack>
+              )}
+            </SectionCard>
+
+            <SectionCard>
+              <CardTitle>Wagons</CardTitle>
+              {operationsQuery.isLoading ? (
+                <Center py="lg">
+                  <Loader size="sm" />
+                </Center>
+              ) : !operations?.wagons?.length ? (
+                <Text fz={13} c="edr-muted" mt="sm">
+                  No wagons allocated yet — allocation happens once Operations
+                  accepts your booking and builds the train.
+                </Text>
+              ) : (
+                <Table
+                  verticalSpacing="sm"
+                  horizontalSpacing="md"
+                  mt="sm"
+                  highlightOnHover
+                >
+                  <Table.Thead>
+                    <Table.Tr>
+                      <Table.Th>#</Table.Th>
+                      <Table.Th>Wagon</Table.Th>
+                      <Table.Th>Type</Table.Th>
+                      <Table.Th ta="right">Loaded / capacity</Table.Th>
+                      <Table.Th>Containers</Table.Th>
+                      <Table.Th>Status</Table.Th>
+                    </Table.Tr>
+                  </Table.Thead>
+                  <Table.Tbody>
+                    {operations.wagons.map((wagon) => (
+                      <Table.Tr key={wagon.id}>
+                        <Table.Td>{wagon.sequenceNo ?? "—"}</Table.Td>
+                        <Table.Td>
+                          <Text fw={600} fz={13}>
+                            {wagon.wagonNumber ?? "To be assigned"}
+                          </Text>
+                        </Table.Td>
+                        <Table.Td>{wagon.wagonType ?? "—"}</Table.Td>
+                        <Table.Td ta="right">
+                          {Number(wagon.allocatedWeightTons).toLocaleString()}{" "}
+                          / {Number(wagon.capacityTons).toLocaleString()} t
+                        </Table.Td>
+                        <Table.Td>
+                          {wagon.containerNumbers.length
+                            ? wagon.containerNumbers.join(", ")
+                            : "—"}
+                        </Table.Td>
+                        <Table.Td>
+                          <Badge size="sm" radius="sm" variant="light">
+                            {wagon.status}
+                          </Badge>
+                        </Table.Td>
+                      </Table.Tr>
+                    ))}
+                  </Table.Tbody>
+                </Table>
+              )}
+            </SectionCard>
+          </Stack>
+        </Tabs.Panel>
+      </Tabs>
+
+      <ShippingLineDocumentsModal
+        booking={docsOpen ? booking : null}
+        onClose={() => setDocsOpen(false)}
+      />
+
+      {/* Cancelling is irreversible, so it asks first rather than firing on the
+          button press. The reason is optional but recorded. */}
+      <Modal
+        opened={cancelOpen}
+        onClose={() => setCancelOpen(false)}
+        centered
+        radius="md"
+        title={
+          <Text fw={700} fz={16}>
+            Cancel this booking?
+          </Text>
+        }
+        overlayProps={{ blur: 2, backgroundOpacity: 0.55 }}
+      >
+        <Stack gap="md">
+          <Alert color="red" variant="light" icon={<AlertCircle size={18} />}>
+            Booking <strong>{booking.reference}</strong> will be cancelled. This
+            cannot be undone — you would need to initiate a new booking.
+          </Alert>
+
+          <Textarea
+            label="Reason (optional)"
+            placeholder="Why are you cancelling this booking?"
+            autosize
+            minRows={2}
+            maxRows={4}
+            maxLength={500}
+            value={cancelReason}
+            onChange={(e) => setCancelReason(e.currentTarget.value)}
+          />
+
+          {cancelMutation.isError && (
+            <Alert color="red" icon={<AlertCircle size={16} />}>
+              {(cancelMutation.error as Error)?.message ??
+                "Could not cancel the booking."}
+            </Alert>
+          )}
+
+          <Group justify="flex-end" gap="sm">
+            <Button
+              variant="default"
+              radius="md"
+              onClick={() => setCancelOpen(false)}
+            >
+              Keep booking
+            </Button>
+            <Button
+              color="red"
+              radius="md"
+              leftSection={<Ban size={16} />}
+              loading={cancelMutation.isPending}
+              onClick={() => cancelMutation.mutate()}
+            >
+              Cancel booking
+            </Button>
+          </Group>
+        </Stack>
+      </Modal>
+    </PageShell>
+  );
+}
+
+function DetailRow({ label, value }: { label: string; value: string }) {
+  return (
+    <Group justify="space-between" align="flex-start" gap="md" wrap="nowrap">
+      <Text fz={13} c="edr-muted">
+        {label}
+      </Text>
+      <Text fz={13} fw={600} ta="right">
+        {value}
+      </Text>
+    </Group>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineBookingsPage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineBookingsPage.tsx
new file mode 100644
index 000000000..1284058bc
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineBookingsPage.tsx
@@ -0,0 +1,364 @@
+import {
+  ActionIcon,
+  Badge,
+  Box,
+  Button,
+  Card,
+  Group,
+  Menu,
+  Stack,
+  Text,
+  Title,
+} from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import {
+  DataTable,
+  DataTableFooter,
+  type ColumnDef,
+  usePagination,
+} from "@edr/ui-common";
+import {
+  AlertCircle,
+  FileText,
+  MoreVertical,
+  Package,
+  PackageCheck,
+  Plus,
+  Upload,
+} from "lucide-react";
+import { useMemo, useState } from "react";
+import { useNavigate } from "react-router-dom";
+
+import { BookingStatusBadge as StatusBadge } from "@/pages/bookings/booking-display";
+import type { ShippingLineBooking } from "@/services/shipping-line-bookings.service";
+import { shippingLineBookingsService } from "@/services/shipping-line-bookings.service";
+
+import {
+  bookingDocState,
+  hasDocuments,
+  needsUpload,
+  DOC_STATE_ACTION_LABEL,
+  DOC_STATE_COLOR,
+  DOC_STATE_LABEL,
+} from "./booking-doc-state";
+import ShippingLineDocumentsModal from "./ShippingLineDocumentsModal";
+import ShippingLineInitiateModal from "./ShippingLineInitiateModal";
+
+/** Statuses where the booking is approved and waiting to be booked. */
+const BOOKABLE_STATUSES = new Set([
+  "CLEARANCE_READY",
+  "OPERATION_CHANGES_REQUESTED",
+]);
+
+function ColHeader({ label }: { label: string }) {
+  return (
+    <Text fz={12} fw={700} c="edr-muted" tt="uppercase" lts="0.04em">
+      {label}
+    </Text>
+  );
+}
+
+/**
+ * Shipping-line bookings list.
+ *
+ * Mirrors the customer bookings list (same DataTable, status badge, row-click
+ * to detail and per-row action menu) so the two portals read the same. What
+ * differs is the flow behind it: contracts do not apply to shipping lines, so
+ * "Initiate booking" creates a bare booking directly rather than routing
+ * through a contract.
+ */
+export default function ShippingLineBookingsPage() {
+  const navigate = useNavigate();
+  const { pagination, setPagination } = usePagination();
+  const [docsBooking, setDocsBooking] = useState<ShippingLineBooking | null>(
+    null,
+  );
+
+  const bookingsQuery = useQuery({
+    queryKey: ["shipping-line-bookings"],
+    queryFn: shippingLineBookingsService.list,
+  });
+
+  const [initiateOpen, setInitiateOpen] = useState(false);
+
+  const rows = useMemo(() => bookingsQuery.data ?? [], [bookingsQuery.data]);
+
+  const status = bookingsQuery.isLoading
+    ? "loading"
+    : bookingsQuery.isError
+      ? "error"
+      : "success";
+  const showEmpty = status === "success" && rows.length === 0;
+
+  const columns: ColumnDef<ShippingLineBooking>[] = [
+    {
+      id: "reference",
+      header: () => <ColHeader label="Booking" />,
+      cell: ({ row }) => (
+        <Text fw={700} fz={14}>
+          {row.original.reference}
+        </Text>
+      ),
+    },
+    {
+      id: "route",
+      header: () => <ColHeader label="Route" />,
+      cell: ({ row }) => {
+        const b = row.original;
+        const origin = b.originYard?.label ?? b.originYard?.code;
+        const dest = b.destinationYard?.label ?? b.destinationYard?.code;
+        return (
+          <Text fz={13} c={origin && dest ? undefined : "edr-muted"}>
+            {origin && dest ? `${origin} → ${dest}` : "—"}
+          </Text>
+        );
+      },
+    },
+    {
+      id: "scheduledDate",
+      header: () => <ColHeader label="Shipment date" />,
+      cell: ({ row }) => (
+        <Text fz={13} c={row.original.scheduledDate ? undefined : "edr-muted"}>
+          {row.original.scheduledDate
+            ? new Date(row.original.scheduledDate).toLocaleDateString()
+            : "—"}
+        </Text>
+      ),
+    },
+    {
+      id: "status",
+      header: () => <ColHeader label="Status" />,
+      cell: ({ row }) => <StatusBadge status={row.original.status} />,
+    },
+    {
+      id: "documents",
+      header: () => <ColHeader label="Documents" />,
+      cell: ({ row }) => {
+        const state = bookingDocState(row.original);
+        if (state === "NONE") return null;
+        return (
+          <Badge
+            size="sm"
+            variant="light"
+            radius="sm"
+            color={DOC_STATE_COLOR[state]}
+            leftSection={
+              state === "ACTION_NEEDED" ? <AlertCircle size={12} /> : undefined
+            }
+          >
+            {DOC_STATE_LABEL[state]}
+          </Badge>
+        );
+      },
+    },
+    {
+      id: "created",
+      header: () => <ColHeader label="Created" />,
+      cell: ({ row }) => (
+        <Text fz={13} c="edr-muted">
+          {row.original.createdAt
+            ? new Date(row.original.createdAt).toLocaleDateString()
+            : "—"}
+        </Text>
+      ),
+    },
+    {
+      id: "actions",
+      size: 200,
+      header: () => null,
+      cell: ({ row }) => {
+        const booking = row.original;
+        const state = bookingDocState(booking);
+        const showDocs = hasDocuments(state);
+        const wantsUpload = needsUpload(state);
+        const bookable = BOOKABLE_STATUSES.has(booking.status as string);
+
+        return (
+          <Group
+            gap={6}
+            justify="flex-end"
+            wrap="nowrap"
+            onClick={(e) => e.stopPropagation()}
+          >
+            {/* Approved documents make booking the primary move — the docs
+                button steps back into the menu so one action owns the row. */}
+            {bookable && (
+              <Button
+                size="xs"
+                radius="md"
+                color="edr-green"
+                fw={700}
+                fz={13}
+                leftSection={<PackageCheck size={14} />}
+                onClick={() =>
+                  navigate(`/shipping-line/bookings/${booking.id}/complete`)
+                }
+              >
+                {booking.status === "OPERATION_CHANGES_REQUESTED"
+                  ? "Resubmit"
+                  : "Book"}
+              </Button>
+            )}
+            {showDocs && !bookable && (
+              <Button
+                size="xs"
+                radius="md"
+                variant="light"
+                // A queried document is the one case that needs to pull the
+                // eye — it is the only state where the shipping line is
+                // blocking its own booking.
+                color={state === "ACTION_NEEDED" ? "red" : "edr-green"}
+                fw={700}
+                fz={13}
+                leftSection={
+                  wantsUpload ? <Upload size={14} /> : <FileText size={14} />
+                }
+                onClick={() => setDocsBooking(booking)}
+              >
+                {DOC_STATE_ACTION_LABEL[state]}
+              </Button>
+            )}
+            <Menu position="bottom-end" withinPortal shadow="md" radius="md">
+              <Menu.Target>
+                <ActionIcon
+                  variant="transparent"
+                  size={30}
+                  radius="md"
+                  aria-label="More options"
+                >
+                  <MoreVertical size={16} color="#9AA8B5" />
+                </ActionIcon>
+              </Menu.Target>
+              <Menu.Dropdown>
+                <Menu.Item
+                  onClick={() =>
+                    navigate(`/shipping-line/bookings/${booking.id}`)
+                  }
+                >
+                  View details
+                </Menu.Item>
+                {showDocs && (
+                  <Menu.Item
+                    leftSection={
+                      wantsUpload ? (
+                        <Upload size={15} />
+                      ) : (
+                        <FileText size={15} />
+                      )
+                    }
+                    onClick={() => setDocsBooking(booking)}
+                  >
+                    {DOC_STATE_ACTION_LABEL[state]}
+                  </Menu.Item>
+                )}
+                {bookable && (
+                  <Menu.Item
+                    leftSection={<PackageCheck size={15} />}
+                    onClick={() =>
+                      navigate(`/shipping-line/bookings/${booking.id}/complete`)
+                    }
+                  >
+                    {booking.status === "OPERATION_CHANGES_REQUESTED"
+                      ? "Resubmit booking"
+                      : "Book"}
+                  </Menu.Item>
+                )}
+              </Menu.Dropdown>
+            </Menu>
+          </Group>
+        );
+      },
+    },
+  ];
+
+  return (
+    <Box style={{ padding: "28px 32px 32px" }}>
+      <Stack gap="lg">
+        <Group justify="space-between" align="flex-end" wrap="wrap" gap="md">
+          <Box>
+            <Title
+              order={1}
+              fw={800}
+              fz={26}
+              style={{ letterSpacing: "-0.01em" }}
+            >
+              Bookings
+            </Title>
+            <Text size="sm" c="edr-muted" mt={4}>
+              Request a booking directly — no contract required.
+            </Text>
+          </Box>
+          <Button
+            color="edr-green"
+            radius="md"
+            leftSection={<Plus size={16} />}
+            onClick={() => setInitiateOpen(true)}
+          >
+            Initiate booking
+          </Button>
+        </Group>
+
+        <Card radius={16} p={0} withBorder style={{ borderColor: "#E6ECF2" }}>
+          {showEmpty ? (
+            <Stack align="center" gap="xs" py={64}>
+              <Package size={28} className="text-slate-300" />
+              <Text c="edr-muted" size="sm">
+                No bookings yet — initiate one to get started.
+              </Text>
+              <Button
+                size="sm"
+                mt="md"
+                variant="light"
+                color="edr-green"
+                onClick={() => setInitiateOpen(true)}
+              >
+                Initiate booking
+              </Button>
+            </Stack>
+          ) : (
+            <DataTable
+              columns={columns}
+              data={rows}
+              status={status}
+              onRowClick={(row) =>
+                navigate(
+                  `/shipping-line/bookings/${(row as ShippingLineBooking).id}`,
+                )
+              }
+              pagination={{
+                pageIndex: pagination.pageIndex,
+                pageSize: pagination.pageSize,
+                pageCount: Math.max(
+                  1,
+                  Math.ceil(rows.length / pagination.pageSize),
+                ),
+                totalCount: rows.length,
+              }}
+              tableOptions={{
+                state: { pagination },
+                onPaginationChange: setPagination,
+              }}
+              containerClassName="border-0 shadow-none rounded-none"
+              footer={DataTableFooter}
+            />
+          )}
+        </Card>
+      </Stack>
+
+      <ShippingLineInitiateModal
+        opened={initiateOpen}
+        onClose={() => setInitiateOpen(false)}
+        onCreated={(booking) => {
+          setInitiateOpen(false);
+          // Straight into the new booking — documents are the next thing owed.
+          navigate(`/shipping-line/bookings/${booking.id}`);
+        }}
+      />
+
+      <ShippingLineDocumentsModal
+        booking={docsBooking}
+        onClose={() => setDocsBooking(null)}
+      />
+    </Box>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineCompletePage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineCompletePage.tsx
new file mode 100644
index 000000000..809c8e5c1
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineCompletePage.tsx
@@ -0,0 +1,1658 @@
+import {
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+  type KeyboardEvent,
+  type ReactNode,
+} from "react";
+import { useForm, Controller } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useNavigate, useParams } from "react-router-dom";
+import {
+  ActionIcon,
+  Alert,
+  Badge,
+  Box,
+  Button,
+  Center,
+  Divider,
+  FileButton,
+  Group,
+  List,
+  Loader,
+  Modal,
+  Paper,
+  Select,
+  Stack,
+  Switch,
+  Text,
+  TextInput,
+  Textarea,
+  ThemeIcon,
+  Title,
+} from "@mantine/core";
+import {
+  AlertCircle,
+  AlertTriangle,
+  CalendarDays,
+  CheckCircle2,
+  ChevronLeft,
+  FileDown,
+  FileUp,
+  Flame,
+  MapPin,
+  Package,
+  PackageCheck,
+  Receipt,
+  Snowflake,
+  Train,
+  X,
+} from "lucide-react";
+
+import { OperationDatePicker } from "@edr/ui-common";
+import {
+  StepCard,
+  StepHeader,
+  StepLabel,
+  fieldStyles,
+} from "../contracts/new-contract-form/shared";
+import { formatRateUnit } from "../contracts/new-contract-form/unit-rates";
+import {
+  ShipmentFormInputValues,
+  ShipmentFormValues,
+  createShipmentFormSchema,
+  initialShipmentFormValues,
+} from "../contracts/new-shipment-form/schema";
+import {
+  downloadContainerImportTemplate,
+  parseContainerExcel,
+} from "../contracts/new-shipment-form/container-excel";
+import { formatAmount } from "../contracts/new-shipment-form/total";
+import {
+  shippingLineBookingsService,
+  type CompleteBookingContainerLine,
+  type CompleteShippingLineBookingPayload,
+  type ShippingLineBooking,
+  type ShippingLinePriceQuote,
+} from "@/services/shipping-line-bookings.service";
+import { extractApiError } from "@/utils/result";
+
+type ShipmentForm = ReturnType<
+  typeof useForm<ShipmentFormInputValues, any, ShipmentFormValues>
+>;
+
+const SIZES = ["20ft", "40ft"] as const;
+
+/**
+ * Every quantity on this form is a non-negative magnitude. A native number
+ * input's `min` only constrains its stepper, so swallow the minus key before it
+ * can put a negative into the field at all.
+ */
+const blockNegative = (event: KeyboardEvent<HTMLInputElement>) => {
+  if (event.key === "-") event.preventDefault();
+};
+
+const COMPLETABLE_STATUSES = new Set([
+  "CLEARANCE_READY",
+  "OPERATION_CHANGES_REQUESTED",
+]);
+
+/**
+ * Shipping-line booking completion page — a faithful duplicate of the customer
+ * shipment-booking page (contracts/NewShipmentPage): the same Excel
+ * import/template flow, the same per-container rows with hazardous/refrigerated
+ * switches, the same day-picker calendar. Only the plumbing differs: no
+ * contract — cargo posts to the shipping-line completion endpoint, days come
+ * from the line's dedicated trains (or the shared pool when it has none), and
+ * the price lands on the credit ledger instead of an invoice, so there is no
+ * price-confirmation step.
+ */
+export default function ShippingLineCompletePage() {
+  const { id = "" } = useParams();
+  const navigate = useNavigate();
+
+  const bookingQuery = useQuery({
+    queryKey: ["shipping-line-bookings", id],
+    queryFn: () => shippingLineBookingsService.getById(id),
+    enabled: Boolean(id),
+  });
+
+  if (bookingQuery.isLoading) {
+    return (
+      <Center mih={400} p="xl">
+        <Loader color="edr-green" />
+      </Center>
+    );
+  }
+
+  const booking = bookingQuery.data;
+  if (!booking) {
+    return (
+      <Box p="xl">
+        <Paper withBorder radius="lg" p="xl">
+          <Text fw={700} mb="xs">
+            Booking not found
+          </Text>
+          <Button
+            variant="default"
+            onClick={() => navigate("/shipping-line/bookings")}
+          >
+            Back to bookings
+          </Button>
+        </Paper>
+      </Box>
+    );
+  }
+
+  if (!COMPLETABLE_STATUSES.has(booking.status as string)) {
+    return (
+      <Box p="xl">
+        <Alert color="blue" icon={<AlertCircle size={18} />} radius="md">
+          <Text fw={700} mb="xs">
+            This booking cannot be completed yet
+          </Text>
+          <Text size="sm" mb="md">
+            Your documents must be approved by Operations before the cargo and
+            shipment day can be entered.
+          </Text>
+          <Button
+            color="edr-green"
+            radius="md"
+            onClick={() => navigate(`/shipping-line/bookings/${booking.id}`)}
+          >
+            Back to booking
+          </Button>
+        </Alert>
+      </Box>
+    );
+  }
+
+  return <CompleteBookingForm booking={booking} />;
+}
+
+function CompleteBookingForm({ booking }: { booking: ShippingLineBooking }) {
+  const navigate = useNavigate();
+  const queryClient = useQueryClient();
+  const isContainer = (booking.freightType ?? "CONTAINER") === "CONTAINER";
+  const isResubmit = booking.status === "OPERATION_CHANGES_REQUESTED";
+
+  // Bulk cargo type lives outside the shared schema (customers get it from
+  // their contract) — validated at submit time instead.
+  const [cargoTypeId, setCargoTypeId] = useState<string | null>(null);
+
+  const form = useForm<ShipmentFormInputValues, any, ShipmentFormValues>({
+    defaultValues: {
+      ...initialShipmentFormValues,
+      // Shipping lines are always invoiced in ETB — no currency choice.
+      paymentCurrency: "ETB",
+    },
+    resolver: zodResolver(
+      createShipmentFormSchema({
+        isContainer,
+        // Both handling services are always offered — there is no contract
+        // scope to restrict them; charges apply only to ticked containers.
+        isHazardous: true,
+        isReefer: true,
+        withReturnService: false,
+        unitOfMeasure: "PER_TON",
+        requiresDate: true,
+        requiresTrain: false,
+      }),
+    ),
+    mode: "onChange",
+  });
+
+  const referenceQuery = useQuery({
+    queryKey: ["shipping-line-reference-data"],
+    queryFn: shippingLineBookingsService.referenceData,
+  });
+
+  // 20ft containers ride two per wagon — an odd total can never be planned.
+  const watchedContainers = form.watch("containers");
+  const ft20Total = isContainer
+    ? (watchedContainers ?? [])
+        .filter((l) => l.containerSize === "20ft")
+        .reduce((sum, l) => sum + Number(l.quantity || 0), 0)
+    : 0;
+  const hasOdd20ft = ft20Total % 2 === 1;
+
+  // Two-step submit, same shape as the customer shipment form: the confirm
+  // modal opens at once with the payload pending, the server prices it (and
+  // runs the 20ft pairing check) while the modal shows a loader, the shipping
+  // line confirms the figure, and only then does the booking submit.
+  const [pendingPayload, setPendingPayload] =
+    useState<CompleteShippingLineBookingPayload | null>(null);
+
+  const previewMutation = useMutation({
+    mutationFn: (payload: CompleteShippingLineBookingPayload) =>
+      shippingLineBookingsService.pricePreview(booking.id, payload),
+    // A pricing failure (no rate configured) closes the confirm dialog — the
+    // error modal takes over with the server's message.
+    onError: () => setPendingPayload(null),
+  });
+  const quote = previewMutation.data ?? null;
+
+  const submitMutation = useMutation({
+    mutationFn: (payload: CompleteShippingLineBookingPayload) =>
+      shippingLineBookingsService.complete(booking.id, payload),
+    onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: ["shipping-line-bookings"],
+      });
+      navigate(`/shipping-line/bookings/${booking.id}`);
+    },
+    // A submit failure (day filled up, window closed meanwhile) must not leave
+    // a stale confirm dialog on screen — the error modal takes over.
+    onError: () => {
+      previewMutation.reset();
+      setPendingPayload(null);
+    },
+  });
+
+  const closeConfirm = () => {
+    if (submitMutation.isPending) return;
+    previewMutation.reset();
+    setPendingPayload(null);
+  };
+
+  /**
+   * Map a container size to the configured container type: reefer type when
+   * any container on the line is refrigerated, standard type otherwise —
+   * mirroring the server's own size→type resolution for customers.
+   */
+  function buildPayload(
+    values: ShipmentFormValues,
+  ): CompleteShippingLineBookingPayload | { error: string } {
+    const base = {
+      scheduledDate: values.scheduledDate,
+      // Which of the line's trains the booking rides — required by the server
+      // when more than one departs on the chosen day.
+      ...(values.trainScheduleId
+        ? { trainScheduleId: values.trainScheduleId }
+        : {}),
+      ...(values.paymentCurrency
+        ? { paymentCurrency: values.paymentCurrency }
+        : {}),
+      ...(values.cargoDescription?.trim()
+        ? { cargoFreeText: values.cargoDescription.trim() }
+        : {}),
+    };
+    if (!isContainer) {
+      if (!cargoTypeId) return { error: "Select the cargo type." };
+      return {
+        ...base,
+        cargoTypeId,
+        cargoWeightTons: Number(values.cargoWeightTons),
+        bulkHazardousQuantity: Number(values.bulkHazardousQuantity || 0),
+        bulkReeferQuantity: Number(values.bulkReeferQuantity || 0),
+      };
+    }
+    const containers: CompleteBookingContainerLine[] = [];
+    for (const l of values.containers.filter(
+      (l) => Number(l.quantity) >= 1,
+    )) {
+      const totalVgm = l.units.reduce((s, u) => s + Number(u.vgmTons || 0), 0);
+      containers.push({
+        // The size string alone — the server maps it to the configured
+        // container type, so a slow/failed catalog fetch can never block
+        // the submit with a phantom "type not configured" error.
+        containerSize: l.containerSize,
+        quantity: Number(l.quantity),
+        hazardousQuantity: l.units.filter((u) => u.isHazardous).length,
+        reeferQuantity: l.units.filter((u) => u.isReefer).length,
+        vgmPerUnitTons: l.units.length ? totalVgm / l.units.length : 0,
+        units: l.units.map((u) => ({
+          containerNumber: u.containerNumber.trim().toUpperCase(),
+          sealNumber: u.sealNumber || undefined,
+          vgmTons: Number(u.vgmTons),
+          isHazardous: Boolean(u.isHazardous),
+          isReefer: Boolean(u.isReefer),
+        })),
+      });
+    }
+    return { ...base, containers };
+  }
+
+  const [payloadError, setPayloadError] = useState<string | null>(null);
+  const handleSubmit = form.handleSubmit((values) => {
+    if (hasOdd20ft) return;
+    const payload = buildPayload(values);
+    if ("error" in payload) {
+      setPayloadError(payload.error);
+      return;
+    }
+    setPayloadError(null);
+    // Open the confirm dialog now and price into it; the booking submits only
+    // after the shipping line confirms the figure.
+    setPendingPayload(payload);
+    previewMutation.reset();
+    previewMutation.mutate(payload);
+  });
+
+  const handleConfirm = () => {
+    if (!pendingPayload || !quote) return;
+    // Guard: never let unresolved 20ft pairing errors submit — the server
+    // rejects them anyway; the disabled button just says so first.
+    if (quote.pairingErrors.length > 0) return;
+    submitMutation.mutate(pendingPayload);
+  };
+
+  const showValidationSummary =
+    form.formState.isSubmitted && !form.formState.isValid;
+
+  return (
+    <Box
+      style={{
+        padding: "28px 0 0",
+        minHeight: "calc(100dvh - var(--app-shell-header-height, 56px))",
+        display: "flex",
+        flexDirection: "column",
+      }}
+    >
+      <Group
+        justify="space-between"
+        px="24px"
+        align="flex-end"
+        wrap="wrap"
+        gap="md"
+        mb="lg"
+      >
+        <Box>
+          <Title order={1} fw={800} fz={26} style={{ letterSpacing: "-0.01em" }}>
+            {isResubmit ? "Change Your Booking" : "Complete Your Booking"}
+          </Title>
+          <Text size="sm" c="edr-muted" mt={4}>
+            {isResubmit
+              ? `Update the details below and pick a new shipment day, then resubmit booking ${booking.reference}.`
+              : `Your documents are approved — enter the cargo details and shipment day for booking ${booking.reference}. The charge goes on your credit account.`}
+          </Text>
+        </Box>
+        <Button
+          variant="default"
+          radius="md"
+          leftSection={<ChevronLeft size={16} />}
+          onClick={() => navigate(`/shipping-line/bookings/${booking.id}`)}
+        >
+          Back to booking
+        </Button>
+      </Group>
+
+      <form
+        className="flex flex-col"
+        style={{ flex: 1 }}
+        onSubmit={(e) => e.preventDefault()}
+      >
+        {/* Errors surface in a modal, not an inline alert: the submit button
+            sits at the bottom of a long form, so a banner at the top scrolls
+            out of sight exactly when the user needs it. */}
+        <Modal
+          opened={Boolean(
+            submitMutation.isError || previewMutation.isError || payloadError,
+          )}
+          onClose={() => {
+            setPayloadError(null);
+            submitMutation.reset();
+            previewMutation.reset();
+          }}
+          centered
+          radius="md"
+          size="lg"
+          title={
+            <Group gap={8}>
+              <AlertCircle size={18} color="var(--mantine-color-red-6)" />
+              <Text fw={700} fz={16}>
+                Booking could not be completed
+              </Text>
+            </Group>
+          }
+          overlayProps={{ blur: 2, backgroundOpacity: 0.55 }}
+        >
+          <Stack gap="md">
+            {(() => {
+              // The server's message, never axios's generic "Request failed
+              // with status code 400" — extractApiError digs it out of the
+              // response body.
+              const message =
+                payloadError ??
+                extractApiError(submitMutation.error ?? previewMutation.error)
+                  .message;
+              // Missing-rate blocks are an EDR setup gap, not a mistake the
+              // shipping line made — lead with plain words and where to go,
+              // then the specifics of what is not priced.
+              const isPricingGap = message.includes("rate is configured");
+              // The server joins multiple pricing blocks with "; " — a list
+              // reads far better than one wall of text.
+              const parts = message
+                .split("; ")
+                .map((p) => p.trim())
+                .filter(Boolean);
+              return (
+                <>
+                  {isPricingGap && (
+                    <Text size="sm" fw={600}>
+                      This booking cannot be completed yet — the price for
+                      your shipment has not been set up. Please contact EDR
+                      support to configure it, or change the options below:
+                    </Text>
+                  )}
+                  {parts.length > 1 ? (
+                    <List spacing="sm" size="sm" c="red.8">
+                      {parts.map((part, i) => (
+                        <List.Item key={i}>{part}</List.Item>
+                      ))}
+                    </List>
+                  ) : (
+                    <Text size="sm" c="red.8">
+                      {message}
+                    </Text>
+                  )}
+                </>
+              );
+            })()}
+            <Group justify="flex-end">
+              <Button
+                variant="default"
+                radius="md"
+                onClick={() => {
+                  setPayloadError(null);
+                  submitMutation.reset();
+                  previewMutation.reset();
+                }}
+              >
+                Close
+              </Button>
+            </Group>
+          </Stack>
+        </Modal>
+
+        <PriceConfirmModal
+          opened={Boolean(pendingPayload)}
+          quote={quote}
+          quoteLoading={previewMutation.isPending}
+          loading={submitMutation.isPending}
+          onConfirm={handleConfirm}
+          onReject={closeConfirm}
+        />
+
+        <Box flex={1} p="24px">
+          <Stack gap="lg" className="mx-auto max-w-4xl">
+            <RouteCard booking={booking} />
+            {isContainer ? (
+              <ContainerCargoStep form={form} />
+            ) : (
+              <BulkCargoStep
+                form={form}
+                cargoTypeId={cargoTypeId}
+                onCargoTypeChange={setCargoTypeId}
+                cargoTypes={referenceQuery.data?.cargoTypes ?? []}
+              />
+            )}
+            <ScheduleStep
+              form={form}
+              booking={booking}
+              cargoTypeId={isContainer ? null : cargoTypeId}
+            />
+          </Stack>
+        </Box>
+
+        <Box
+          style={{
+            position: "sticky",
+            bottom: 0,
+            zIndex: 20,
+            borderTop: "1px solid var(--mantine-color-edr-border-0)",
+            backgroundColor: "rgba(255,255,255,0.94)",
+            backdropFilter: "blur(14px)",
+            padding: "16px 24px",
+            marginTop: "auto",
+          }}
+        >
+          <Box className="mx-auto max-w-4xl">
+            {showValidationSummary ? (
+              <Alert
+                color="red"
+                variant="light"
+                radius="md"
+                icon={<AlertCircle size={16} />}
+                mb="sm"
+              >
+                Fix the highlighted fields before completing the booking.
+              </Alert>
+            ) : null}
+            <Group justify="flex-end">
+              <Button
+                type="button"
+                color="edr-green"
+                radius="md"
+                leftSection={<PackageCheck size={16} />}
+                onClick={handleSubmit}
+                loading={previewMutation.isPending || submitMutation.isPending}
+                disabled={hasOdd20ft}
+              >
+                {isResubmit ? "Resubmit booking" : "Complete booking"}
+              </Button>
+            </Group>
+          </Box>
+        </Box>
+      </form>
+    </Box>
+  );
+}
+
+/**
+ * Price confirmation — the customer shipment form's modal, one-to-one: opens
+ * the moment the form submits, shows a loader while the server prices and
+ * checks 20ft pairing, then the authoritative breakdown. Pairing violations
+ * hard-block confirm (the server rejects them on /complete too); overweight
+ * containers only warn — the surcharge is already inside the total.
+ */
+function PriceConfirmModal({
+  opened,
+  quote,
+  quoteLoading,
+  loading,
+  onConfirm,
+  onReject,
+}: {
+  opened: boolean;
+  quote: ShippingLinePriceQuote | null;
+  quoteLoading: boolean;
+  loading: boolean;
+  onConfirm: () => void;
+  onReject: () => void;
+}) {
+  const pairingErrors = quote?.pairingErrors ?? [];
+  const hasPairingBlock = pairingErrors.length > 0;
+  const overweightLines = quote?.overweightLines ?? [];
+  const overweightSurchargeAmount =
+    quote?.lineItems.find((li) => li.code === "OVERWEIGHT_PER_TON")?.amount ??
+    0;
+
+  // Confirm waits for the authoritative price and a clean pairing check.
+  const confirmDisabled =
+    loading || quoteLoading || hasPairingBlock || !quote;
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={onReject}
+      closeOnClickOutside={!loading}
+      closeOnEscape={!loading}
+      withCloseButton={!loading}
+      centered
+      radius="lg"
+      size="lg"
+      title={
+        <Group gap={10}>
+          <ThemeIcon variant="light" color="edr-green" radius="md" size={34}>
+            <Receipt size={18} />
+          </ThemeIcon>
+          <Box>
+            <Text fw={800} fz={16} c="#10202F">
+              Confirm shipment price
+            </Text>
+            <Text fz="xs" c="dimmed">
+              Review the total before booking this shipment.
+            </Text>
+          </Box>
+        </Group>
+      }
+    >
+      <Stack gap="md">
+        {quoteLoading && (
+          <Group gap={8} c="dimmed">
+            <Loader size="xs" color="edr-green" />
+            <Text fz="sm" c="dimmed">
+              Computing the final price breakdown and checking container
+              weights…
+            </Text>
+          </Group>
+        )}
+
+        {hasPairingBlock && (
+          <Alert
+            color="red"
+            variant="light"
+            radius="md"
+            icon={<AlertCircle size={16} />}
+            title="Cannot complete booking — 20ft wagon pairing"
+          >
+            <Stack gap={6}>
+              {pairingErrors.map((msg, i) => (
+                <Text key={i} fz="sm" c="red.8">
+                  {msg}
+                </Text>
+              ))}
+              <Text fz="xs" c="red.7" mt={2}>
+                Adjust the 20ft container weights or quantities so pairs differ
+                by no more than 10 tons.
+              </Text>
+            </Stack>
+          </Alert>
+        )}
+
+        {overweightLines.length > 0 && (
+          <Alert
+            color="yellow"
+            variant="light"
+            radius="md"
+            icon={<AlertTriangle size={16} />}
+            title="Overweight containers"
+          >
+            <Stack gap={6}>
+              {overweightLines.map((line, i) => (
+                <Text key={i} fz="sm" c="#9A5B00">
+                  {line.containerTypeCode}: {line.totalVgmTons}t exceeds limit{" "}
+                  {line.maxAllowedTons}t (+{line.excessTons}t overweight)
+                </Text>
+              ))}
+              <Text fz="xs" c="#9A5B00" mt={2}>
+                {overweightSurchargeAmount > 0
+                  ? `An overweight surcharge of ${formatAmount(overweightSurchargeAmount)} ${
+                      quote?.currency ?? ""
+                    } applies (included in the total below). You can still submit, or go back and adjust weights.`
+                  : "An overweight surcharge applies. You can still submit, or go back and adjust weights."}
+              </Text>
+            </Stack>
+          </Alert>
+        )}
+
+        {quote && quote.warnings.length > 0 && (
+          <Alert
+            color="yellow"
+            variant="light"
+            radius="md"
+            icon={<AlertTriangle size={16} />}
+          >
+            {quote.warnings.join(" ")}
+          </Alert>
+        )}
+
+        {quote && (
+          <Paper
+            withBorder
+            radius={16}
+            p="lg"
+            style={{ borderColor: "#E6ECF2" }}
+          >
+            <Stack gap={10}>
+              {quote.lineItems.map((line, i) => (
+                <Group key={i} justify="space-between" wrap="nowrap" gap="sm">
+                  <Box style={{ minWidth: 0 }}>
+                    <Text fz="sm" c="#10202F" fw={500}>
+                      {line.description}
+                    </Text>
+                    <Text fz="xs" c="dimmed">
+                      {(line.quantity ?? 1).toLocaleString()} ×{" "}
+                      {formatAmount(line.unitAmount ?? line.amount)}{" "}
+                      {quote.currency}
+                      {line.unit
+                        ? ` · ${formatRateUnit(line.unit.toLowerCase())}`
+                        : ""}
+                    </Text>
+                  </Box>
+                  <Text
+                    fz="sm"
+                    fw={600}
+                    c="#10202F"
+                    style={{ whiteSpace: "nowrap" }}
+                  >
+                    {formatAmount(line.amount)} {quote.currency}
+                  </Text>
+                </Group>
+              ))}
+              {quote.lineItems.length === 0 && (
+                <Text fz="sm" c="dimmed">
+                  No priced lines — check the cargo details.
+                </Text>
+              )}
+            </Stack>
+            <Divider my="md" />
+            <Group justify="space-between" align="flex-end">
+              <Text
+                fz="xs"
+                fw={700}
+                tt="uppercase"
+                c="edr-green"
+                style={{ letterSpacing: "0.06em" }}
+              >
+                Total
+              </Text>
+              <Text fw={800} fz={28} c="#10202F">
+                {formatAmount(quote.totalAmount)}{" "}
+                <Text span fz={16} fw={700} c="edr-muted">
+                  {quote.currency}
+                </Text>
+              </Text>
+            </Group>
+            <Text fz="xs" c="dimmed" mt="sm">
+              The amount is charged to your credit account — no payment is due
+              now. EDR bills your accumulated charges periodically.
+            </Text>
+          </Paper>
+        )}
+
+        <Group justify="space-between" mt="xs">
+          <Button
+            variant="default"
+            radius="md"
+            leftSection={<X size={16} />}
+            onClick={onReject}
+            disabled={loading}
+          >
+            Reject &amp; edit
+          </Button>
+          <Button
+            color="edr-green"
+            radius="md"
+            leftSection={<CheckCircle2 size={16} />}
+            onClick={onConfirm}
+            loading={loading}
+            disabled={confirmDisabled}
+          >
+            Confirm &amp; book
+          </Button>
+        </Group>
+      </Stack>
+    </Modal>
+  );
+}
+
+/** The booking's lane — fixed at initiate time from the chosen route. */
+function RouteCard({ booking }: { booking: ShippingLineBooking }) {
+  return (
+    <StepCard>
+      <StepHeader
+        icon={<MapPin size={22} />}
+        title="Route"
+        description="This booking ships on the lane picked when it was initiated."
+      />
+      <Paper withBorder radius="md" p="md" style={{ borderColor: "#E6ECF2" }}>
+        <Text fz={14} fw={600} c="#10202F">
+          {booking.originYard?.label ?? booking.originYard?.code ?? "—"} →{" "}
+          {booking.destinationYard?.label ??
+            booking.destinationYard?.code ??
+            "—"}
+        </Text>
+        <Text fz={12} c="dimmed" mt={2}>
+          {booking.tradeDirection ?? "IMPORT"}
+        </Text>
+      </Paper>
+    </StepCard>
+  );
+}
+
+/** A departure's calendar day in East Africa Time — matches the server's eatDay. */
+function eatDayOf(date: string | Date): string {
+  return new Date(date).toLocaleDateString("en-CA", {
+    timeZone: "Africa/Addis_Ababa",
+  });
+}
+
+function ScheduleStep({
+  form,
+  booking,
+  cargoTypeId,
+}: {
+  form: ShipmentForm;
+  booking: ShippingLineBooking;
+  /** Bulk cargo pick (container bookings pass null) — refines availability. */
+  cargoTypeId: string | null;
+}) {
+  // Days come from the line's dedicated trains (open until each train's
+  // close offset), or the shared pool when the lane has none.
+  const daysQuery = useQuery({
+    queryKey: ["shipping-line-bookings", booking.id, "available-days"],
+    queryFn: () => shippingLineBookingsService.availableDays(booking.id),
+  });
+
+  // Cargo context makes the per-train availability figures real: the wagon
+  // types offered are the ones THIS cargo can ride. Recomputed per render on
+  // purpose — react-hook-form mutates the watched array in place.
+  const isContainer = (booking.freightType ?? "CONTAINER") === "CONTAINER";
+  const containerLines = form.watch("containers") ?? [];
+  const cargo = (() => {
+    if (isContainer) {
+      const sizes = containerLines
+        .filter((l) => Number(l.quantity || 0) >= 1)
+        .map((l) => l.containerSize);
+      const ft20 = containerLines
+        .filter((l) => l.containerSize === "20ft")
+        .reduce((s, l) => s + Number(l.quantity || 0), 0);
+      const ft40 = containerLines
+        .filter((l) => l.containerSize === "40ft")
+        .reduce((s, l) => s + Number(l.quantity || 0), 0);
+      const wagons = Math.ceil(ft20 / 2) + ft40;
+      return {
+        containerSizes: sizes.length ? sizes : undefined,
+        wagons: wagons > 0 ? wagons : undefined,
+      };
+    }
+    return cargoTypeId ? { cargoTypeId } : {};
+  })();
+
+  // The line's OWN departures on this lane, each with per-wagon-type free
+  // space — the pick is "which train", not an abstract calendar day.
+  // Customers never see these trains; the endpoint is shipping-line only.
+  const trainsQuery = useQuery({
+    queryKey: [
+      "shipping-line-bookings",
+      booking.id,
+      "trains",
+      cargo.containerSizes?.join(",") ?? "",
+      (cargo as { cargoTypeId?: string }).cargoTypeId ?? "",
+      (cargo as { wagons?: number }).wagons ?? 0,
+    ],
+    queryFn: () =>
+      shippingLineBookingsService.trainsForDay(booking.id, undefined, cargo),
+  });
+  const options = trainsQuery.data ?? [];
+
+  const openDays = new Set(daysQuery.data?.days ?? []);
+  const selectedTrainId = form.watch("trainScheduleId");
+
+  return (
+    <StepCard>
+      <StepHeader
+        icon={<CalendarDays size={22} />}
+        title="Schedule"
+        description={
+          options.length
+            ? "Pick the train your shipment rides — these departures are dedicated to your company. A booking rides one train."
+            : "Pick the binding shipment day. Only days with a train departure on your route can be selected."
+        }
+      />
+      {/* No currency choice: shipping-line charges always land on the ETB
+          credit ledger — the form defaults paymentCurrency to ETB and the
+          server enforces it. */}
+      <Controller
+        name="scheduledDate"
+        control={form.control}
+        render={({ field, fieldState }) => (
+          <Box>
+            <StepLabel>
+              {options.length ? "Your train *" : "Shipment day *"}
+            </StepLabel>
+            <Box mt={10} w="100%">
+              {trainsQuery.isLoading ? (
+                <Group gap={8} c="dimmed" py="sm">
+                  <Loader size="xs" color="edr-green" />
+                  <Text fz="sm" c="dimmed">
+                    Checking wagon availability on your trains…
+                  </Text>
+                </Group>
+              ) : options.length ? (
+                <Stack gap="sm">
+                  {options.map((option) => {
+                    const day = eatDayOf(option.departure);
+                    const selected = selectedTrainId === option.scheduleId;
+                    // Closed when its own cut-off passed OR the day fell out
+                    // of the bookable set.
+                    const closed = !option.isOpen || !openDays.has(day);
+                    const showFit = (option.neededWagons ?? 0) > 0;
+                    return (
+                      <Paper
+                        key={option.scheduleId}
+                        withBorder
+                        radius="md"
+                        p="md"
+                        onClick={() => {
+                          if (closed) return;
+                          field.onChange(day);
+                          form.setValue("trainScheduleId", option.scheduleId, {
+                            shouldValidate: true,
+                          });
+                        }}
+                        style={{
+                          cursor: closed ? "not-allowed" : "pointer",
+                          opacity: closed ? 0.55 : 1,
+                          borderColor: selected
+                            ? "var(--mantine-color-teal-6)"
+                            : undefined,
+                          borderWidth: selected ? 2 : 1,
+                          background: selected
+                            ? "var(--mantine-color-teal-0)"
+                            : undefined,
+                        }}
+                      >
+                        <Group justify="space-between" wrap="wrap" gap="sm">
+                          <Group gap="sm" align="flex-start">
+                            <Train
+                              size={20}
+                              color={
+                                selected
+                                  ? "var(--mantine-color-teal-7)"
+                                  : "var(--mantine-color-gray-6)"
+                              }
+                            />
+                            <Box>
+                              <Group gap={8}>
+                                <Text fw={700} fz={14}>
+                                  {option.trainNumber ??
+                                    option.trainName ??
+                                    "Train"}
+                                </Text>
+                                {option.trainName && option.trainNumber ? (
+                                  <Text fz={12} c="dimmed">
+                                    {option.trainName}
+                                  </Text>
+                                ) : null}
+                                {closed && (
+                                  <Badge
+                                    size="xs"
+                                    radius="sm"
+                                    color="red"
+                                    variant="light"
+                                  >
+                                    Booking closed
+                                  </Badge>
+                                )}
+                                {!closed && showFit && (
+                                  <Badge
+                                    size="xs"
+                                    radius="sm"
+                                    color={option.fits ? "teal" : "orange"}
+                                    variant="light"
+                                  >
+                                    {option.fits
+                                      ? "Fits your cargo"
+                                      : "Not enough space"}
+                                  </Badge>
+                                )}
+                              </Group>
+                              {/* Free wagons by TYPE — what this train can
+                                  still take for the entered cargo. */}
+                              <Group gap={6} mt={6} wrap="wrap">
+                                {option.byWagonType.length ? (
+                                  option.byWagonType.map((t) => (
+                                    <Badge
+                                      key={t.wagonTypeId ?? "any"}
+                                      size="sm"
+                                      radius="sm"
+                                      variant="outline"
+                                      color={
+                                        t.freeWagons > 0 ? "teal" : "gray"
+                                      }
+                                    >
+                                      {t.code ?? t.name ?? "Wagons"} ·{" "}
+                                      {t.freeWagons} free
+                                    </Badge>
+                                  ))
+                                ) : (
+                                  <Text fz={12} c="dimmed">
+                                    Enter your cargo to see wagon availability
+                                    by type.
+                                  </Text>
+                                )}
+                              </Group>
+                            </Box>
+                          </Group>
+                          <Box ta="right">
+                            <Text fz={13} fw={600}>
+                              Departs{" "}
+                              {new Date(option.departure).toLocaleString(
+                                undefined,
+                                {
+                                  weekday: "short",
+                                  month: "short",
+                                  day: "numeric",
+                                  hour: "2-digit",
+                                  minute: "2-digit",
+                                },
+                              )}
+                            </Text>
+                            {option.bookingClosesAt && (
+                              <Text fz={12} c="dimmed">
+                                Book before{" "}
+                                {new Date(
+                                  option.bookingClosesAt,
+                                ).toLocaleString(undefined, {
+                                  month: "short",
+                                  day: "numeric",
+                                  hour: "2-digit",
+                                  minute: "2-digit",
+                                })}
+                              </Text>
+                            )}
+                          </Box>
+                        </Group>
+                      </Paper>
+                    );
+                  })}
+                </Stack>
+              ) : (
+                <OperationDatePicker
+                  fullWidth
+                  availableDays={daysQuery.data?.days ?? []}
+                  isLoading={daysQuery.isLoading}
+                  emptyMessage="No departures are currently open on this route. Please check back or contact Operations."
+                  value={field.value ?? ""}
+                  onChange={(d) => field.onChange(d)}
+                />
+              )}
+            </Box>
+            {fieldState.error?.message && (
+              <Text fz="xs" c="red" mt={6}>
+                {fieldState.error.message}
+              </Text>
+            )}
+          </Box>
+        )}
+      />
+    </StepCard>
+  );
+}
+
+function ContainerCargoStep({ form }: { form: ShipmentForm }) {
+  // Seed one shipment line per size exactly once.
+  const seededRef = useRef(false);
+  useEffect(() => {
+    if (seededRef.current) return;
+    seededRef.current = true;
+    const existing = form.getValues("containers") ?? [];
+    if (existing.length > 0) return;
+    form.setValue(
+      "containers",
+      SIZES.map((size) => ({
+        containerSize: size,
+        quantity: "0",
+        hazardousQuantity: "0",
+        reeferQuantity: "0",
+        returnQuantity: "0",
+        units: [],
+      })),
+      { shouldValidate: false },
+    );
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  const lines = form.watch("containers") ?? [];
+
+  // Excel import: one row per container. All-or-nothing — a file with any bad
+  // row is rejected with row-numbered errors so nothing is silently dropped.
+  const [importErrors, setImportErrors] = useState<string[]>([]);
+  const [importSummary, setImportSummary] = useState<string | null>(null);
+  const importResetRef = useRef<(() => void) | null>(null);
+  const excelOpts = {
+    allowedSizes: [...SIZES],
+    includeHazardous: true,
+    includeReefer: true,
+    includeReturn: false,
+  };
+
+  const handleImportFile = async (file: File | null) => {
+    // Reset the hidden input so re-picking the same (fixed) file re-fires.
+    importResetRef.current?.();
+    if (!file) return;
+    const { rows, errors } = await parseContainerExcel(file, excelOpts);
+    if (errors.length > 0) {
+      setImportSummary(null);
+      setImportErrors(errors);
+      return;
+    }
+    // Replace only the lines for sizes present in the file; a size the file
+    // omits keeps whatever was already entered for it.
+    const current = form.getValues("containers") ?? [];
+    const next = SIZES.map((size) => {
+      const imported = rows.filter((r) => r.containerSize === size);
+      if (imported.length === 0) {
+        return (
+          current.find((l) => l.containerSize === size) ?? {
+            containerSize: size,
+            quantity: "0",
+            hazardousQuantity: "0",
+            reeferQuantity: "0",
+            returnQuantity: "0",
+            units: [],
+          }
+        );
+      }
+      return {
+        containerSize: size,
+        quantity: String(imported.length),
+        hazardousQuantity: String(imported.filter((r) => r.hazardous).length),
+        reeferQuantity: String(imported.filter((r) => r.reefer).length),
+        returnQuantity: "0",
+        // The spreadsheet already marks handling per row — carry it onto the
+        // container it belongs to rather than collapsing it to a line count.
+        units: imported.map((r) => ({
+          containerNumber: r.containerNumber,
+          sealNumber: r.sealNumber,
+          vgmTons: r.vgmTons,
+          isHazardous: Boolean(r.hazardous),
+          isReefer: Boolean(r.reefer),
+          isReturn: false,
+        })),
+      };
+    });
+    form.setValue("containers", next, {
+      shouldValidate: true,
+      shouldDirty: true,
+    });
+    setImportErrors([]);
+    setImportSummary(`Imported ${rows.length} container(s) from ${file.name}.`);
+  };
+
+  return (
+    <StepCard>
+      <StepHeader
+        icon={<Package size={22} />}
+        title="Cargo Details"
+        description="Enter the quantity and per-container details for each size."
+      />
+      <Stack gap={18}>
+        <Paper withBorder radius="md" p="md" style={{ borderColor: "#E6ECF2" }}>
+          <Group justify="space-between" wrap="wrap" gap="sm">
+            <Box>
+              <Text fz={13} fw={600} c="#10202F">
+                Import containers from Excel
+              </Text>
+              <Text fz={12} c="dimmed">
+                One row per container. Importing fills the lines below for the
+                sizes in your file.
+              </Text>
+            </Box>
+            <Group gap="sm">
+              <Button
+                variant="default"
+                size="xs"
+                radius="md"
+                leftSection={<FileDown size={14} />}
+                onClick={() => downloadContainerImportTemplate(excelOpts)}
+              >
+                Download template
+              </Button>
+              <FileButton
+                resetRef={importResetRef}
+                accept=".xlsx,.xls"
+                onChange={handleImportFile}
+              >
+                {(props) => (
+                  <Button
+                    {...props}
+                    size="xs"
+                    radius="md"
+                    color="edr-green"
+                    leftSection={<FileUp size={14} />}
+                  >
+                    Import Excel
+                  </Button>
+                )}
+              </FileButton>
+            </Group>
+          </Group>
+          {importErrors.length > 0 && (
+            <Alert
+              color="red"
+              variant="light"
+              radius="md"
+              icon={<AlertCircle size={16} />}
+              title="Import failed — fix the file and try again"
+              mt="sm"
+            >
+              <Stack gap={4}>
+                {importErrors.slice(0, 8).map((msg, i) => (
+                  <Text key={i} fz="xs">
+                    {msg}
+                  </Text>
+                ))}
+                {importErrors.length > 8 && (
+                  <Text fz="xs" c="dimmed">
+                    …and {importErrors.length - 8} more.
+                  </Text>
+                )}
+              </Stack>
+            </Alert>
+          )}
+          {importSummary && (
+            <Alert
+              color="edr-green"
+              variant="light"
+              radius="md"
+              icon={<CheckCircle2 size={16} />}
+              mt="sm"
+            >
+              <Text fz="xs">{importSummary}</Text>
+            </Alert>
+          )}
+        </Paper>
+        <Controller
+          name="cargoDescription"
+          control={form.control}
+          render={({ field, fieldState }) => (
+            <Textarea
+              label="Cargo description *"
+              description="What do the containers carry on this shipment?"
+              placeholder="e.g. Electronics, garments, machinery spare parts…"
+              value={field.value ?? ""}
+              onChange={(e) => field.onChange(e.currentTarget.value)}
+              onBlur={field.onBlur}
+              error={fieldState.error?.message}
+              radius={10}
+              autosize
+              minRows={2}
+              maxRows={4}
+              styles={fieldStyles}
+            />
+          )}
+        />
+        {lines.map((line, index) => (
+          <ContainerLineEditor
+            key={line.containerSize}
+            form={form}
+            index={index}
+            size={line.containerSize}
+          />
+        ))}
+        {(() => {
+          const ft20 = lines
+            .filter((l) => l.containerSize === "20ft")
+            .reduce((sum, l) => sum + Number(l.quantity || 0), 0);
+          if (ft20 % 2 !== 1) return null;
+          return (
+            <Alert
+              color="red"
+              variant="light"
+              radius="md"
+              icon={<AlertCircle size={16} />}
+              title={`Odd number of 20ft containers (${ft20})`}
+            >
+              <Text fz={13}>
+                20ft containers travel two per wagon, so they must be booked in
+                even numbers. Please add one more 20ft container or remove one
+                (e.g. book {ft20 + 1} or {ft20 - 1} instead of {ft20}) — the
+                booking cannot be submitted with an unpaired 20ft container.
+              </Text>
+            </Alert>
+          );
+        })()}
+      </Stack>
+    </StepCard>
+  );
+}
+
+function BulkCargoStep({
+  form,
+  cargoTypeId,
+  onCargoTypeChange,
+  cargoTypes,
+}: {
+  form: ShipmentForm;
+  cargoTypeId: string | null;
+  onCargoTypeChange: (v: string | null) => void;
+  cargoTypes: {
+    id: string;
+    name: string;
+    parentGroupId: string | null;
+  }[];
+}) {
+  // Grouping headers are rows other rows point at via parentGroupId — only
+  // leaves are bookable cargo.
+  const options = useMemo(() => {
+    const parents = new Set(
+      cargoTypes
+        .map((c) => c.parentGroupId)
+        .filter((id): id is string => Boolean(id)),
+    );
+    return cargoTypes
+      .filter((c) => !parents.has(c.id))
+      .map((c) => ({ value: c.id, label: c.name }));
+  }, [cargoTypes]);
+
+  return (
+    <StepCard>
+      <StepHeader
+        icon={<Package size={22} />}
+        title="Cargo Details"
+        description="Enter the amount you are shipping for this booking."
+      />
+      <Stack gap={14}>
+        <Select
+          label="Cargo type *"
+          placeholder="Select cargo..."
+          searchable
+          data={options}
+          value={cargoTypeId}
+          onChange={onCargoTypeChange}
+          radius={10}
+          styles={fieldStyles}
+          comboboxProps={{ withinPortal: true }}
+        />
+        <Controller
+          name="cargoWeightTons"
+          control={form.control}
+          render={({ field, fieldState }) => (
+            <TextInput
+              {...field}
+              type="number"
+              onKeyDown={blockNegative}
+              label="Total weight (tons) *"
+              placeholder="e.g. 1200"
+              min={0}
+              step={0.01}
+              error={fieldState.error?.message}
+              radius={10}
+              styles={fieldStyles}
+            />
+          )}
+        />
+        <Controller
+          name="bulkHazardousQuantity"
+          control={form.control}
+          render={({ field, fieldState }) => (
+            <TextInput
+              {...field}
+              type="number"
+              onKeyDown={blockNegative}
+              label="Hazardous quantity"
+              min={0}
+              step={1}
+              error={fieldState.error?.message}
+              radius={10}
+              styles={fieldStyles}
+            />
+          )}
+        />
+        <Controller
+          name="bulkReeferQuantity"
+          control={form.control}
+          render={({ field, fieldState }) => (
+            <TextInput
+              {...field}
+              type="number"
+              onKeyDown={blockNegative}
+              label="Refrigerated quantity"
+              min={0}
+              step={1}
+              error={fieldState.error?.message}
+              radius={10}
+              styles={fieldStyles}
+            />
+          )}
+        />
+        <Controller
+          name="cargoDescription"
+          control={form.control}
+          render={({ field }) => (
+            <Textarea
+              label="Cargo description (optional)"
+              placeholder="What the shipment carries"
+              value={field.value ?? ""}
+              onChange={(e) => field.onChange(e.currentTarget.value)}
+              radius={10}
+              autosize
+              minRows={1}
+              maxRows={3}
+              styles={fieldStyles}
+            />
+          )}
+        />
+      </Stack>
+    </StepCard>
+  );
+}
+
+function ContainerLineEditor({
+  form,
+  index,
+  size,
+}: {
+  form: ShipmentForm;
+  index: number;
+  size: "20ft" | "40ft";
+}) {
+  const line = form.watch(`containers.${index}`);
+  const quantity = Number(line?.quantity || 0);
+  const units = line?.units ?? [];
+
+  // Keep the units array length in sync with the entered quantity.
+  const syncUnits = (qty: number) => {
+    const current = form.getValues(`containers.${index}.units`) ?? [];
+    const next = [...current];
+    while (next.length < qty)
+      next.push({
+        containerNumber: "",
+        sealNumber: "",
+        vgmTons: "",
+        isHazardous: false,
+        isReefer: false,
+        isReturn: false,
+      });
+    next.length = Math.max(0, qty);
+    form.setValue(`containers.${index}.units`, next, { shouldValidate: false });
+    syncHandlingCounts(next);
+  };
+
+  // Drop one container row and shrink quantity to match — the inverse of
+  // syncUnits growing the array when quantity goes up.
+  const removeUnit = (unitIdx: number) => {
+    const current = form.getValues(`containers.${index}.units`) ?? [];
+    const next = current.filter((_, j) => j !== unitIdx);
+    form.setValue(`containers.${index}.units`, next, { shouldValidate: false });
+    form.setValue(`containers.${index}.quantity`, String(next.length), {
+      shouldValidate: true,
+    });
+    syncHandlingCounts(next);
+  };
+
+  /**
+   * Line totals are a roll-up of the per-container switches — the count is
+   * however many containers ticked each service. Kept in form state so the
+   * submitted payload stays in step with the switches.
+   */
+  const syncHandlingCounts = (
+    units: Array<{ isHazardous?: boolean; isReefer?: boolean }>,
+  ) => {
+    const set = (
+      key: "hazardousQuantity" | "reeferQuantity",
+      count: number,
+    ) =>
+      form.setValue(`containers.${index}.${key}`, String(count), {
+        shouldDirty: true,
+        shouldValidate: true,
+      });
+    set("hazardousQuantity", units.filter((u) => u.isHazardous).length);
+    set("reeferQuantity", units.filter((u) => u.isReefer).length);
+  };
+
+  /** Flip one container's handling switch, then re-roll the line totals. */
+  const toggleUnitHandling = (
+    unitIndex: number,
+    key: "isHazardous" | "isReefer",
+    on: boolean,
+  ) => {
+    form.setValue(`containers.${index}.units.${unitIndex}.${key}`, on, {
+      shouldDirty: true,
+    });
+    syncHandlingCounts(form.getValues(`containers.${index}.units`) ?? []);
+  };
+
+  const handlingColumns: Array<{
+    key: "isHazardous" | "isReefer";
+    label: string;
+    icon: ReactNode;
+    color: string;
+  }> = [
+    {
+      key: "isHazardous",
+      label: "Hazardous",
+      icon: <Flame size={14} />,
+      color: "#C0392B",
+    },
+    {
+      key: "isReefer",
+      label: "Refrigerated",
+      icon: <Snowflake size={14} />,
+      color: "#2E5B96",
+    },
+  ];
+
+  return (
+    <Box
+      className="rounded-xl"
+      style={{ border: "1px solid #E6ECF2", padding: 16 }}
+    >
+      <Text fz={14} fw={700} c="#10202F" mb={10}>
+        {size} containers
+      </Text>
+      <Box maw={220} mb={14}>
+        <Controller
+          name={`containers.${index}.quantity`}
+          control={form.control}
+          render={({ field, fieldState }) => (
+            <TextInput
+              {...field}
+              type="number"
+              onKeyDown={blockNegative}
+              label="Quantity *"
+              min={0}
+              error={fieldState.error?.message}
+              radius={10}
+              styles={fieldStyles}
+              onChange={(e) => {
+                field.onChange(e.currentTarget.value);
+              }}
+              onBlur={(e) => {
+                field.onBlur();
+                syncUnits(Number(e.currentTarget.value || 0));
+              }}
+            />
+          )}
+        />
+      </Box>
+
+      <StepLabel>Per-container details</StepLabel>
+      {quantity > 0 ? (
+        <Text fz={11} c="#5B6B7B" mt={4}>
+          Tick the services each individual container needs — charges apply only
+          to the containers you tick.
+        </Text>
+      ) : null}
+      <Stack gap={10} mt={8}>
+        {/* Header row — input labels + handling-service labels, one aligned
+            grid shared by every unit row below. */}
+        {Math.max(quantity, units.length) > 0 && (
+          <Group gap={10} wrap="nowrap" align="flex-end">
+            <Text fz={12} fw={600} c="#10202F" style={{ flex: 1 }}>
+              Container number *
+            </Text>
+            <Text fz={12} fw={600} c="#10202F" style={{ flex: 1 }}>
+              Seal number
+            </Text>
+            <Text fz={12} fw={600} c="#10202F" style={{ flex: 1 }}>
+              VGM (tons) *
+            </Text>
+            {handlingColumns.map((col) => (
+              <Group
+                key={col.key}
+                gap={4}
+                wrap="nowrap"
+                justify="center"
+                style={{ width: 96, flexShrink: 0 }}
+              >
+                <span style={{ color: col.color, display: "flex" }}>
+                  {col.icon}
+                </span>
+                <Text fz={12} fw={600} c="#10202F">
+                  {col.label}
+                </Text>
+              </Group>
+            ))}
+          </Group>
+        )}
+        {Array.from({ length: Math.max(quantity, units.length) }).map(
+          (_, u) => (
+            <Group key={u} gap={10} wrap="nowrap" align="flex-start">
+              <Controller
+                name={`containers.${index}.units.${u}.containerNumber`}
+                control={form.control}
+                render={({ field, fieldState }) => (
+                  <TextInput
+                    {...field}
+                    onChange={(e) =>
+                      field.onChange(e.currentTarget.value.toUpperCase())
+                    }
+                    placeholder="e.g. MSCU1234567"
+                    error={fieldState.error?.message}
+                    radius={10}
+                    styles={fieldStyles}
+                    style={{ flex: 1 }}
+                  />
+                )}
+              />
+              <Controller
+                name={`containers.${index}.units.${u}.sealNumber`}
+                control={form.control}
+                render={({ field }) => (
+                  <TextInput
+                    {...field}
+                    placeholder="Optional"
+                    radius={10}
+                    styles={fieldStyles}
+                    style={{ flex: 1 }}
+                  />
+                )}
+              />
+              <Controller
+                name={`containers.${index}.units.${u}.vgmTons`}
+                control={form.control}
+                render={({ field, fieldState }) => (
+                  <TextInput
+                    {...field}
+                    type="number"
+                    onKeyDown={blockNegative}
+                    placeholder="e.g. 24.5"
+                    min={0}
+                    step={0.01}
+                    error={fieldState.error?.message}
+                    radius={10}
+                    styles={fieldStyles}
+                    style={{ flex: 1 }}
+                  />
+                )}
+              />
+              {handlingColumns.map((col) => (
+                <Controller
+                  key={col.key}
+                  name={`containers.${index}.units.${u}.${col.key}`}
+                  control={form.control}
+                  render={({ field }) => (
+                    <Box
+                      style={{
+                        width: 96,
+                        flexShrink: 0,
+                        height: 42,
+                        display: "flex",
+                        alignItems: "center",
+                        justifyContent: "center",
+                      }}
+                    >
+                      <Switch
+                        checked={Boolean(field.value)}
+                        aria-label={`${col.label} — container ${u + 1}`}
+                        onChange={(e) =>
+                          toggleUnitHandling(u, col.key, e.currentTarget.checked)
+                        }
+                        size="sm"
+                      />
+                    </Box>
+                  )}
+                />
+              ))}
+              <ActionIcon
+                variant="subtle"
+                color="red"
+                aria-label={`Remove container ${u + 1}`}
+                onClick={() => removeUnit(u)}
+              >
+                <X size={16} />
+              </ActionIcon>
+            </Group>
+          ),
+        )}
+      </Stack>
+    </Box>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineDocumentsModal.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineDocumentsModal.tsx
new file mode 100644
index 000000000..53b98c497
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineDocumentsModal.tsx
@@ -0,0 +1,248 @@
+import {
+  Alert,
+  Box,
+  Button,
+  Center,
+  Group,
+  Loader,
+  Modal,
+  Stack,
+  Text,
+} from "@mantine/core";
+import type { ShippingLineBooking } from "@/services/shipping-line-bookings.service";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { AlertCircle, CheckCircle2, Clock, Upload } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+
+import { ClearanceDocumentUploadCard } from "@/components/contracts/ClearanceDocumentUploadCard";
+import { useFileViewer } from "@/hooks/useFileViewer";
+import { shippingLineBookingsService } from "@/services/shipping-line-bookings.service";
+
+/**
+ * Document upload for a shipping-line booking.
+ *
+ * Deliberately the same surface as the customer clearance modal
+ * (`BookingActionModal`): the grid is built from the booking's clearance view,
+ * so every field shows its uploaded file, its review badge and the reviewer's
+ * note, and can be replaced in place — an approved document is locked, exactly
+ * as it is for customers.
+ */
+export default function ShippingLineDocumentsModal({
+  booking,
+  onClose,
+}: {
+  booking: ShippingLineBooking | null;
+  onClose: () => void;
+}) {
+  const queryClient = useQueryClient();
+  const { view, viewer } = useFileViewer();
+  // Files picked but not yet submitted, keyed by document field.
+  const [pending, setPending] = useState<Record<string, File>>({});
+
+  // Each booking gets a fresh sheet — otherwise files staged for one booking
+  // would still be attached when the modal reopens on another.
+  useEffect(() => {
+    setPending({});
+  }, [booking?.id]);
+
+  const clearanceQuery = useQuery({
+    queryKey: ["shipping-line-clearance", booking?.id],
+    queryFn: () => shippingLineBookingsService.getClearance(booking!.id),
+    enabled: booking !== null,
+  });
+
+  const uploadMutation = useMutation({
+    mutationFn: () =>
+      shippingLineBookingsService.uploadDocuments(booking!.id, pending),
+    onSuccess: () => {
+      setPending({});
+      void queryClient.invalidateQueries({
+        queryKey: ["shipping-line-bookings"],
+      });
+      void queryClient.invalidateQueries({
+        queryKey: ["shipping-line-clearance", booking?.id],
+      });
+      onClose();
+    },
+  });
+
+  const clearance = clearanceQuery.data;
+  const status = clearance?.status ?? booking?.status ?? "";
+
+  // The fields this booking asks for. `uploadedBy: "gl"` rows are staff output
+  // documents, which the uploader never fills in.
+  const docs = useMemo(
+    () => (clearance?.documents ?? []).filter((d) => d.uploadedBy !== "gl"),
+    [clearance],
+  );
+
+  // Uploads are accepted while the booking is awaiting documents or already in
+  // review (fixing a queried one) — matching the server's own status gate.
+  const canUpload =
+    status === "AWAITING_DOCUMENTS" || status === "DOCUMENTS_UNDER_REVIEW";
+  const isInitialUpload = status === "AWAITING_DOCUMENTS";
+
+  // Documents a reviewer sent back. These are what the shipping line has to
+  // act on, and the reason the modal leads with a red banner rather than the
+  // neutral "in review" one.
+  const queriedDocs = docs.filter((d) => d.reviewStatus === "QUERIED");
+
+  const missingRequired = docs.filter(
+    (d) => d.required && !d.file && !pending[d.fileKey],
+  );
+  const hasStaged = Object.keys(pending).length > 0;
+
+  // First submission must cover every required field; later rounds only need
+  // the specific documents being corrected.
+  const canSubmit = isInitialUpload
+    ? hasStaged && missingRequired.length === 0
+    : hasStaged;
+
+  const stage = (fileKey: string, file: File | null) =>
+    setPending((p) => {
+      if (file) return { ...p, [fileKey]: file };
+      const next = { ...p };
+      delete next[fileKey];
+      return next;
+    });
+
+  return (
+    <>
+      <Modal
+        opened={booking !== null}
+        onClose={onClose}
+        centered
+        size="xl"
+        radius="md"
+        title={
+          <Box>
+            <Text fw={700} fz={16}>
+              Booking documents
+            </Text>
+            <Text fz={12} c="dimmed" ff="monospace">
+              {booking?.reference}
+            </Text>
+          </Box>
+        }
+        overlayProps={{ blur: 2, backgroundOpacity: 0.55 }}
+        styles={{ body: { paddingTop: 8 } }}
+      >
+        {clearanceQuery.isLoading ? (
+          <Center py="xl">
+            <Loader size="sm" />
+          </Center>
+        ) : docs.length === 0 ? (
+          <Text fz="13px" c="dimmed" py="md">
+            No document requirements are configured yet. Staff set these up in
+            the backoffice under Settings → File settings.
+          </Text>
+        ) : (
+          <Stack gap={0}>
+            {queriedDocs.length > 0 ? (
+              <Alert
+                color="red"
+                radius="md"
+                icon={<AlertCircle size={18} />}
+                mb="md"
+              >
+                {queriedDocs.length === 1
+                  ? `"${queriedDocs[0].label}" was returned with a query. `
+                  : `${queriedDocs.length} documents were returned with a query. `}
+                Read the note on each flagged document below and upload a
+                corrected file.
+              </Alert>
+            ) : status === "DOCUMENTS_UNDER_REVIEW" ? (
+              <Alert
+                color="blue"
+                radius="md"
+                icon={<Clock size={18} />}
+                mb="md"
+              >
+                Our team is reviewing your documents. Only re-upload the
+                documents flagged with a query below — approved documents stay
+                as they are.
+              </Alert>
+            ) : status === "CLEARANCE_READY" ? (
+              <Alert
+                color="teal"
+                radius="md"
+                icon={<CheckCircle2 size={18} />}
+                mb="md"
+              >
+                Your documents are approved.
+              </Alert>
+            ) : (
+              <Alert
+                color="yellow"
+                radius="md"
+                icon={<AlertCircle size={18} />}
+                mb="md"
+              >
+                Upload every required document (marked *) below to start the
+                review.
+              </Alert>
+            )}
+
+            {isInitialUpload && missingRequired.length > 0 && (
+              <Alert color="yellow" variant="light" radius="md" mb="md" p="xs">
+                <Text fz="12px" c="#9A5B00">
+                  Still required:{" "}
+                  {missingRequired.map((d) => d.label).join(", ")}
+                </Text>
+              </Alert>
+            )}
+
+            <Stack gap="md">
+              {docs.map((doc) => (
+                <ClearanceDocumentUploadCard
+                  key={doc.fileKey}
+                  label={doc.label}
+                  required={doc.required}
+                  reviewStatus={doc.reviewStatus ?? undefined}
+                  note={doc.note}
+                  uploadedFile={doc.file}
+                  stagedFile={pending[doc.fileKey] ?? null}
+                  canUpload={canUpload}
+                  // An approved document is final — same rule as the customer
+                  // flow, so it renders read-only with just a preview.
+                  onStageFile={
+                    canUpload && doc.reviewStatus !== "APPROVED"
+                      ? (file) => stage(doc.fileKey, file)
+                      : undefined
+                  }
+                  onPreview={view}
+                />
+              ))}
+            </Stack>
+
+            {uploadMutation.isError && (
+              <Alert color="red" mt="md" icon={<AlertCircle size={16} />}>
+                {(uploadMutation.error as Error)?.message ??
+                  "Could not upload the documents."}
+              </Alert>
+            )}
+
+            <Group justify="flex-end" mt="xl" gap="sm">
+              <Button variant="default" radius="md" onClick={onClose}>
+                Close
+              </Button>
+              {canUpload && (
+                <Button
+                  color="edr-green"
+                  radius="md"
+                  leftSection={<Upload size={16} />}
+                  onClick={() => uploadMutation.mutate()}
+                  loading={uploadMutation.isPending}
+                  disabled={!canSubmit}
+                >
+                  Submit documents
+                </Button>
+              )}
+            </Group>
+          </Stack>
+        )}
+      </Modal>
+      {viewer}
+    </>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineHelpPage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineHelpPage.tsx
new file mode 100644
index 000000000..84b605345
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineHelpPage.tsx
@@ -0,0 +1,18 @@
+import { LifeBuoy } from "lucide-react";
+import ShippingLinePlaceholder from "./ShippingLinePlaceholder";
+
+/**
+ * Shipping-line help & support. Separate from the customer `/help` page, which
+ * is public (the auth screens link to it) and carries its own doc chrome; this
+ * one lives inside the shipping-line app layout and will hold guidance written
+ * for shipping lines.
+ */
+export default function ShippingLineHelpPage() {
+  return (
+    <ShippingLinePlaceholder
+      title="Help & Support"
+      description="Guides and support for shipping lines."
+      icon={<LifeBuoy size={28} className="text-slate-300" />}
+    />
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineHomePage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineHomePage.tsx
new file mode 100644
index 000000000..4dc00ef39
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineHomePage.tsx
@@ -0,0 +1,795 @@
+import {
+  Badge,
+  Box,
+  Button,
+  Grid,
+  Group,
+  Skeleton,
+  Stack,
+  Text,
+} from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import {
+  AlertTriangle,
+  ArrowRight,
+  CalendarClock,
+  Clock3,
+  FileText,
+  FileUp,
+  LifeBuoy,
+  MapPin,
+  Package,
+  PackageCheck,
+  PackagePlus,
+  Receipt,
+  RefreshCw,
+  TrainFront,
+  Upload,
+} from "lucide-react";
+import { useMemo, useState } from "react";
+import { useNavigate } from "react-router-dom";
+
+import useAuth from "@/hooks/useAuth";
+import { BookingStatusBadge as StatusBadge } from "@/pages/bookings/booking-display";
+import { Card, StatKpi } from "@/pages/MyPortalPage/components";
+import { cv } from "@/pages/MyPortalPage/constants";
+import {
+  shippingLineBookingsService,
+  type ShippingLineBooking,
+  type ShippingLineTrain,
+} from "@/services/shipping-line-bookings.service";
+
+import ShippingLineInitiateModal from "./ShippingLineInitiateModal";
+
+/* ── Pending-action derivation ─────────────────────────────────────────────
+ * One row per booking that is waiting on the LINE (never on EDR). Priority:
+ * a queried/returned document set outranks everything — it blocks the rest. */
+
+type ActionKind = "fix" | "resubmit" | "book" | "upload";
+
+interface PendingAction {
+  kind: ActionKind;
+  booking: ShippingLineBooking;
+  urgent: boolean;
+  description: string;
+}
+
+const ACTION_META: Record<
+  ActionKind,
+  { icon: typeof FileUp; color: string; button: string }
+> = {
+  fix: { icon: FileUp, color: "red", button: "Fix documents" },
+  resubmit: { icon: RefreshCw, color: "orange", button: "Resubmit" },
+  book: { icon: PackagePlus, color: "violet", button: "Book" },
+  upload: { icon: Upload, color: "blue", button: "Upload documents" },
+};
+
+function deriveActions(bookings: ShippingLineBooking[]): PendingAction[] {
+  const actions: PendingAction[] = [];
+  for (const b of bookings) {
+    const status = b.status as string;
+    if (status === "CANCELLED") continue;
+    if (b.hasQueriedDocuments || status === "CHANGES_REQUESTED") {
+      actions.push({
+        kind: "fix",
+        booking: b,
+        urgent: true,
+        description: "A reviewer queried your documents — fix and re-upload.",
+      });
+    } else if (status === "OPERATION_CHANGES_REQUESTED") {
+      actions.push({
+        kind: "resubmit",
+        booking: b,
+        urgent: true,
+        description:
+          "Operations returned your request — update it and resubmit.",
+      });
+    } else if (status === "CLEARANCE_READY") {
+      actions.push({
+        kind: "book",
+        booking: b,
+        urgent: false,
+        description:
+          "Documents approved — enter the cargo and shipment day to book.",
+      });
+    } else if (status === "AWAITING_DOCUMENTS") {
+      actions.push({
+        kind: "upload",
+        booking: b,
+        urgent: false,
+        description: "Upload your documents to start the review.",
+      });
+    }
+  }
+  return actions.sort((a, b) => Number(b.urgent) - Number(a.urgent));
+}
+
+const laneLabel = (b: ShippingLineBooking) =>
+  `${b.originYard?.label ?? b.originYard?.code ?? "—"} → ${
+    b.destinationYard?.label ?? b.destinationYard?.code ?? "—"
+  }`;
+
+const timeGreeting = () => {
+  const h = new Date().getHours();
+  if (h < 12) return "Good morning";
+  if (h < 18) return "Good afternoon";
+  return "Good evening";
+};
+
+/** Whole days from now to `date`, floored at 0 (today). */
+const daysUntil = (date: string) =>
+  Math.max(
+    0,
+    Math.ceil((new Date(date).getTime() - Date.now()) / 86_400_000),
+  );
+
+/* ── Page ──────────────────────────────────────────────────────────────── */
+
+/**
+ * Shipping-line home. Mirrors the customer dashboard's anatomy — greeting +
+ * primary CTA, KPI band, "needs your attention" queue — but its centrepiece is
+ * the departure board: the line's next dedicated train, which no customer ever
+ * sees, so this page is where it must feel real.
+ */
+export default function ShippingLineHomePage() {
+  const navigate = useNavigate();
+  const { shippingLine } = useAuth();
+  // The hook's union type collapses on direct property access; the account is
+  // positively a shipping line on these routes, so the cast is safe.
+  const lineName =
+    (shippingLine as { name?: string } | null)?.name ?? "Shipping line";
+  const [initiateOpen, setInitiateOpen] = useState(false);
+
+  const bookingsQuery = useQuery({
+    queryKey: ["shipping-line-bookings"],
+    queryFn: shippingLineBookingsService.list,
+  });
+  const trainsQuery = useQuery({
+    queryKey: ["shipping-line-my-trains"],
+    queryFn: shippingLineBookingsService.myTrains,
+  });
+
+  const bookings = useMemo(
+    () => bookingsQuery.data ?? [],
+    [bookingsQuery.data],
+  );
+  const trains = trainsQuery.data ?? [];
+  const actions = useMemo(() => deriveActions(bookings), [bookings]);
+
+  const activeBookings = bookings.filter(
+    (b) => (b.status as string) !== "CANCELLED",
+  );
+  const inReview = bookings.filter(
+    (b) =>
+      !b.hasQueriedDocuments &&
+      ["DOCUMENTS_UNDER_REVIEW", "OPERATION_REQUEST_PENDING"].includes(
+        b.status as string,
+      ),
+  );
+
+  const upcoming = trains.filter(
+    (t) => new Date(t.scheduledDepartureDate).getTime() > Date.now() - 3_600_000,
+  );
+  const nextTrain = upcoming[0] ?? null;
+  const laterTrains = nextTrain ? upcoming.slice(1) : upcoming;
+
+  // Trains this line has BOOKED: allocated ones by trainScheduleId, plus —
+  // before allocation lands — any live booking on the same lane + shipment
+  // day. The hero shows EVERY booked departure of the next booked day, not
+  // just the first train.
+  const isSameDay = (a: string | Date, b: string | Date) =>
+    new Date(a).toDateString() === new Date(b).toDateString();
+  const bookedUpcoming = upcoming.filter((t) =>
+    activeBookings.some(
+      (b) =>
+        b.trainScheduleId === t.id ||
+        (b.scheduledDate &&
+          isSameDay(b.scheduledDate, t.scheduledDepartureDate) &&
+          b.originYard?.id === t.originYardId &&
+          b.destinationYard?.id === t.destinationYardId),
+    ),
+  );
+  const nextBookedDay = bookedUpcoming[0]
+    ? new Date(bookedUpcoming[0].scheduledDepartureDate).toDateString()
+    : null;
+  const nextDayDepartures = nextBookedDay
+    ? bookedUpcoming.filter((t) =>
+        isSameDay(t.scheduledDepartureDate, nextBookedDay),
+      )
+    : [];
+  // Booked departures take the hero; with none, fall back to the line's next
+  // dedicated train so the board never goes blank while trains exist.
+  const heroTrains = nextDayDepartures.length
+    ? nextDayDepartures
+    : nextTrain
+      ? [nextTrain]
+      : [];
+  const heroIsBooked = nextDayDepartures.length > 0;
+  const heroFirst = heroTrains[0] ?? null;
+
+  const goToAction = (a: PendingAction) =>
+    navigate(
+      a.kind === "book" || a.kind === "resubmit"
+        ? `/shipping-line/bookings/${a.booking.id}/complete`
+        : `/shipping-line/bookings/${a.booking.id}`,
+    );
+
+  return (
+    <Stack gap="lg" p={{ base: 16, sm: 24, lg: 32 }}>
+      {/* Greeting + the one primary action, same shape as the customer home. */}
+      <Group justify="space-between" align="center" gap="md">
+        <Box>
+          <Text size="sm" c="edr-muted">
+            {timeGreeting()}
+          </Text>
+          <Text fz={26} fw={800} c="edr-text" className="tracking-tight" mt={2}>
+            {lineName} ⚓
+          </Text>
+        </Box>
+        <Box
+          component="button"
+          onClick={() => setInitiateOpen(true)}
+          className="w-full cursor-pointer border-none bg-transparent p-0 text-left md:w-auto"
+        >
+          <Group
+            gap={14}
+            align="center"
+            wrap="nowrap"
+            bg="edr-green"
+            px={18}
+            py={14}
+            className="w-full md:w-60! rounded-2xl shadow-[0_6px_10px_-12px_rgba(14,163,83,0.8)]"
+          >
+            <PackagePlus size={22} color="#fff" />
+            <Box className="min-w-0 flex-1">
+              <Text fz={14} fw={700} c="white" lh={1.3}>
+                Initiate a booking
+              </Text>
+            </Box>
+            <Box className="flex h-[32px] w-[32px] shrink-0 items-center justify-center rounded-full bg-white">
+              <ArrowRight size={18} color={cv("edr-green.7")} />
+            </Box>
+          </Group>
+        </Box>
+      </Group>
+
+      {/* KPI band — one card, four figures that answer "where do I stand". */}
+      <Card>
+        <Box className="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-4 lg:gap-4">
+          <StatKpi
+            icon={Package}
+            label="Active bookings"
+            value={String(activeBookings.length)}
+            delta=""
+            accent="green"
+            loading={bookingsQuery.isPending}
+          />
+          <StatKpi
+            icon={AlertTriangle}
+            label="Waiting on you"
+            value={String(actions.length)}
+            delta={actions.length > 0 ? "action needed" : "all clear"}
+            accent="amber"
+            deltaTone={actions.length > 0 ? "amber" : "muted"}
+            divider
+            loading={bookingsQuery.isPending}
+          />
+          <StatKpi
+            icon={Clock3}
+            label="In review with EDR"
+            value={String(inReview.length)}
+            delta=""
+            accent="blue"
+            divider
+            loading={bookingsQuery.isPending}
+          />
+          <StatKpi
+            icon={TrainFront}
+            label="Upcoming trains"
+            value={String(upcoming.length)}
+            delta=""
+            accent="slate"
+            divider
+            loading={trainsQuery.isPending}
+          />
+        </Box>
+      </Card>
+
+      {/* Bookings waiting on the line — urgent first, one click to the fix. */}
+      {actions.length > 0 && (
+        <Card padding={0}>
+          <Group justify="space-between" align="center" px={24} pt={20} pb={12}>
+            <Group gap={8}>
+              <AlertTriangle size={18} className="text-amber-500" />
+              <Text fw={700} fz={16} c="edr-text">
+                Needs your attention
+              </Text>
+            </Group>
+            <Badge color="orange" variant="light" radius="sm">
+              {actions.length}
+            </Badge>
+          </Group>
+          <Stack gap={0}>
+            {actions.map((a, i) => {
+              const meta = ACTION_META[a.kind];
+              const Icon = meta.icon;
+              return (
+                <Group
+                  key={a.booking.id}
+                  justify="space-between"
+                  wrap="nowrap"
+                  px={24}
+                  py={14}
+                  style={{
+                    borderTop:
+                      i === 0 ? "none" : "1px solid var(--mantine-color-gray-2)",
+                    cursor: "pointer",
+                  }}
+                  onClick={() => goToAction(a)}
+                  className="hover:bg-edr-soft"
+                >
+                  <Group gap={12} wrap="nowrap" style={{ minWidth: 0 }}>
+                    <Box
+                      style={{
+                        width: 36,
+                        height: 36,
+                        flexShrink: 0,
+                        borderRadius: 10,
+                        display: "flex",
+                        alignItems: "center",
+                        justifyContent: "center",
+                        background: `var(--mantine-color-${meta.color}-light)`,
+                        color: `var(--mantine-color-${meta.color}-filled)`,
+                      }}
+                    >
+                      <Icon size={18} />
+                    </Box>
+                    <Box style={{ minWidth: 0 }}>
+                      <Group gap={8} wrap="nowrap">
+                        <Text fw={600} fz={14} c="edr-text" truncate>
+                          {a.booking.reference}
+                        </Text>
+                        {a.urgent && (
+                          <Badge
+                            size="xs"
+                            color="red"
+                            variant="light"
+                            radius="sm"
+                          >
+                            Action required
+                          </Badge>
+                        )}
+                      </Group>
+                      <Text fz={12.5} c="dimmed" truncate>
+                        {laneLabel(a.booking)} · {a.description}
+                      </Text>
+                    </Box>
+                  </Group>
+                  <Button
+                    size="compact-sm"
+                    variant={a.urgent ? "filled" : "light"}
+                    color={meta.color}
+                    radius="md"
+                  >
+                    {meta.button}
+                  </Button>
+                </Group>
+              );
+            })}
+          </Stack>
+        </Card>
+      )}
+
+      {/* The departure board — every departure the line has BOOKED on its
+          next booked day (falling back to the next dedicated train when
+          nothing is booked yet). These trains are invisible to customers, so
+          this is the one place they surface; give them real presence. */}
+      {heroFirst && (
+        <Box
+          className="rounded-[20px]"
+          p={{ base: 20, sm: 28 }}
+          style={{
+            background: `linear-gradient(120deg, ${cv("edr-green.9")} 0%, ${cv(
+              "edr-green.7",
+            )} 60%, ${cv("edr-green.6")} 100%)`,
+            color: "#fff",
+          }}
+        >
+          <Group justify="space-between" align="flex-end" wrap="wrap" gap="lg">
+            <Box>
+              <Group gap={8} mb={6}>
+                <TrainFront size={16} color="rgba(255,255,255,0.85)" />
+                <Text
+                  fz={11}
+                  fw={700}
+                  tt="uppercase"
+                  style={{ letterSpacing: "0.12em", color: "rgba(255,255,255,0.85)" }}
+                >
+                  {heroIsBooked
+                    ? heroTrains.length > 1
+                      ? "Your booked departures"
+                      : "Your next departure"
+                    : "Your next departure"}
+                </Text>
+                {heroIsBooked && (
+                  <Badge
+                    size="sm"
+                    radius="sm"
+                    variant="white"
+                    color="edr-green"
+                    fw={700}
+                  >
+                    {heroTrains.length > 1
+                      ? `${heroTrains.length} trains`
+                      : "Booked"}
+                  </Badge>
+                )}
+              </Group>
+              <Text fz={{ base: 28, sm: 34 }} fw={800} lh={1.1} c="white">
+                {new Date(heroFirst.scheduledDepartureDate).toLocaleDateString(
+                  undefined,
+                  { weekday: "long", month: "long", day: "numeric" },
+                )}
+              </Text>
+            </Box>
+            <Stack gap={10} align="flex-end">
+              <Group
+                gap={8}
+                px={14}
+                py={8}
+                className="rounded-full"
+                style={{ background: "rgba(255,255,255,0.16)" }}
+              >
+                <CalendarClock size={15} color="#fff" />
+                <Text fz={13} fw={700} c="white">
+                  {daysUntil(heroFirst.scheduledDepartureDate) === 0
+                    ? "Departs today"
+                    : daysUntil(heroFirst.scheduledDepartureDate) === 1
+                      ? "Departs tomorrow"
+                      : `Departs in ${daysUntil(
+                          heroFirst.scheduledDepartureDate,
+                        )} days`}
+                </Text>
+              </Group>
+              {!heroIsBooked && (
+                <Text fz={11.5} style={{ color: "rgba(255,255,255,0.75)" }}>
+                  Departs{" "}
+                  {new Date(
+                    heroFirst.scheduledDepartureDate,
+                  ).toLocaleTimeString(undefined, {
+                    hour: "2-digit",
+                    minute: "2-digit",
+                  })}{" "}
+                  · bookable until the cut-off before departure
+                </Text>
+              )}
+            </Stack>
+          </Group>
+
+          {/* Every departure of that day — one row per train. */}
+          <Stack gap={8} mt={16}>
+            {heroTrains.map((t) => (
+              <Group
+                key={t.id}
+                justify="space-between"
+                wrap="wrap"
+                gap="sm"
+                px={14}
+                py={10}
+                className="rounded-xl"
+                style={{ background: "rgba(255,255,255,0.12)" }}
+              >
+                <Group gap={10} wrap="nowrap">
+                  <MapPin size={15} color="rgba(255,255,255,0.85)" />
+                  <Text fz={14} fw={600} style={{ color: "rgba(255,255,255,0.95)" }}>
+                    {t.originLabel} → {t.destinationLabel}
+                    {t.trainNumber
+                      ? ` · Train ${t.trainNumber}`
+                      : t.reference
+                        ? ` · ${t.reference}`
+                        : ""}
+                  </Text>
+                </Group>
+                <Group gap={10}>
+                  <Text fz={13} fw={700} c="white">
+                    {new Date(t.scheduledDepartureDate).toLocaleTimeString(
+                      undefined,
+                      { hour: "2-digit", minute: "2-digit" },
+                    )}
+                  </Text>
+                  <Badge
+                    size="sm"
+                    radius="sm"
+                    variant="white"
+                    color="edr-green"
+                    fw={700}
+                  >
+                    {t.status}
+                  </Badge>
+                </Group>
+              </Group>
+            ))}
+          </Stack>
+        </Box>
+      )}
+
+      {/* Trains + recent bookings, side by side. */}
+      <Grid align="stretch">
+        <Grid.Col span={{ base: 12, lg: 5 }}>
+          <Card padding={0} className="h-full">
+            <Group justify="space-between" px={24} pt={20} pb={12}>
+              <Group gap={8}>
+                <TrainFront size={17} color={cv("edr-green.7")} />
+                <Text fw={700} fz={16} c="edr-text">
+                  Your trains
+                </Text>
+              </Group>
+              <Badge variant="light" color="gray" radius="sm">
+                {upcoming.length}
+              </Badge>
+            </Group>
+            {trainsQuery.isPending ? (
+              <Stack gap={10} px={24} pb={20}>
+                <Skeleton height={54} radius="md" />
+                <Skeleton height={54} radius="md" />
+              </Stack>
+            ) : upcoming.length === 0 ? (
+              <TrainsEmpty />
+            ) : (
+              <Stack gap={0} pb={8}>
+                {(nextTrain ? [nextTrain, ...laterTrains] : laterTrains).map(
+                  (t, i) => (
+                    <TrainRow key={t.id} train={t} first={i === 0} />
+                  ),
+                )}
+              </Stack>
+            )}
+          </Card>
+        </Grid.Col>
+
+        <Grid.Col span={{ base: 12, lg: 7 }}>
+          <Card padding={0} className="h-full">
+            <Group justify="space-between" px={24} pt={20} pb={12}>
+              <Group gap={8}>
+                <FileText size={17} color={cv("edr-blue")} />
+                <Text fw={700} fz={16} c="edr-text">
+                  Recent bookings
+                </Text>
+              </Group>
+              <Button
+                variant="subtle"
+                color="gray"
+                size="compact-sm"
+                rightSection={<ArrowRight size={14} />}
+                onClick={() => navigate("/shipping-line/bookings")}
+              >
+                View all
+              </Button>
+            </Group>
+            {bookingsQuery.isPending ? (
+              <Stack gap={10} px={24} pb={20}>
+                <Skeleton height={54} radius="md" />
+                <Skeleton height={54} radius="md" />
+                <Skeleton height={54} radius="md" />
+              </Stack>
+            ) : bookings.length === 0 ? (
+              <BookingsEmpty onInitiate={() => setInitiateOpen(true)} />
+            ) : (
+              <Stack gap={0} pb={8}>
+                {bookings.slice(0, 6).map((b, i) => (
+                  <Group
+                    key={b.id}
+                    justify="space-between"
+                    wrap="nowrap"
+                    px={24}
+                    py={12}
+                    style={{
+                      borderTop:
+                        i === 0
+                          ? "none"
+                          : "1px solid var(--mantine-color-gray-2)",
+                      cursor: "pointer",
+                    }}
+                    className="hover:bg-edr-soft"
+                    onClick={() => navigate(`/shipping-line/bookings/${b.id}`)}
+                  >
+                    <Box style={{ minWidth: 0 }}>
+                      <Text fw={600} fz={14} c="edr-text" truncate>
+                        {b.reference}
+                      </Text>
+                      <Text fz={12.5} c="dimmed" truncate>
+                        {laneLabel(b)}
+                        {b.scheduledDate
+                          ? ` · ships ${new Date(
+                              b.scheduledDate,
+                            ).toLocaleDateString()}`
+                          : ""}
+                      </Text>
+                    </Box>
+                    <StatusBadge status={b.status as string} />
+                  </Group>
+                ))}
+              </Stack>
+            )}
+          </Card>
+        </Grid.Col>
+      </Grid>
+
+      {/* Quick links — the rest of the portal, one hop away. */}
+      <Box className="grid grid-cols-1 gap-4 sm:grid-cols-3">
+        <QuickLink
+          icon={PackageCheck}
+          title="My bookings"
+          hint="Track every booking and its documents"
+          onClick={() => navigate("/shipping-line/bookings")}
+        />
+        <QuickLink
+          icon={Receipt}
+          title="Invoices"
+          hint="Charges on your credit account"
+          onClick={() => navigate("/shipping-line/invoices")}
+        />
+        <QuickLink
+          icon={LifeBuoy}
+          title="Help & support"
+          hint="Guides and contact channels"
+          onClick={() => navigate("/shipping-line/help")}
+        />
+      </Box>
+
+      <ShippingLineInitiateModal
+        opened={initiateOpen}
+        onClose={() => setInitiateOpen(false)}
+        onCreated={(booking) => {
+          setInitiateOpen(false);
+          navigate(`/shipping-line/bookings/${booking.id}`);
+        }}
+      />
+    </Stack>
+  );
+}
+
+/* ── Small pieces ──────────────────────────────────────────────────────── */
+
+function TrainRow({
+  train,
+  first,
+}: {
+  train: ShippingLineTrain;
+  first: boolean;
+}) {
+  const departure = new Date(train.scheduledDepartureDate);
+  return (
+    <Group
+      justify="space-between"
+      wrap="nowrap"
+      px={24}
+      py={12}
+      style={{
+        borderTop: first ? "none" : "1px solid var(--mantine-color-gray-2)",
+      }}
+    >
+      <Group gap={12} wrap="nowrap" style={{ minWidth: 0 }}>
+        <Box
+          style={{
+            width: 36,
+            height: 36,
+            flexShrink: 0,
+            borderRadius: 10,
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            background: cv("edr-soft"),
+            color: cv("edr-green.7"),
+          }}
+        >
+          <TrainFront size={18} />
+        </Box>
+        <Box style={{ minWidth: 0 }}>
+          <Text fw={600} fz={14} c="edr-text" truncate>
+            {train.trainNumber ?? train.reference ?? "Train"}
+          </Text>
+          <Text fz={12.5} c="dimmed" truncate>
+            {train.originLabel} → {train.destinationLabel}
+          </Text>
+        </Box>
+      </Group>
+      <Box style={{ textAlign: "right", flexShrink: 0 }}>
+        <Text fz={13} fw={600} c="edr-text">
+          {departure.toLocaleDateString(undefined, {
+            month: "short",
+            day: "numeric",
+          })}
+        </Text>
+        <Text fz={11.5} c="dimmed">
+          {departure.toLocaleTimeString(undefined, {
+            hour: "2-digit",
+            minute: "2-digit",
+          })}
+        </Text>
+      </Box>
+    </Group>
+  );
+}
+
+function TrainsEmpty() {
+  return (
+    <Stack align="center" gap={6} py={36} px={24}>
+      <TrainFront size={26} color={cv("edr-slate")} />
+      <Text fz={13.5} c="dimmed" ta="center">
+        No trains assigned to you yet — Operations dedicates departures to your
+        line and they appear here.
+      </Text>
+    </Stack>
+  );
+}
+
+function BookingsEmpty({ onInitiate }: { onInitiate: () => void }) {
+  return (
+    <Stack align="center" gap={10} py={32} px={24}>
+      <Package size={26} color={cv("edr-slate")} />
+      <Text fz={13.5} c="dimmed" ta="center">
+        No bookings yet. Initiate one — you upload documents next, and book the
+        cargo once they are approved.
+      </Text>
+      <Button
+        color="edr-green"
+        radius="md"
+        size="compact-md"
+        leftSection={<PackagePlus size={15} />}
+        onClick={onInitiate}
+      >
+        Initiate a booking
+      </Button>
+    </Stack>
+  );
+}
+
+function QuickLink({
+  icon: Icon,
+  title,
+  hint,
+  onClick,
+}: {
+  icon: typeof Receipt;
+  title: string;
+  hint: string;
+  onClick: () => void;
+}) {
+  return (
+    <Box
+      component="button"
+      onClick={onClick}
+      className="cursor-pointer rounded-[16px] border border-edr-border bg-edr-card p-4 text-left transition-colors hover:bg-edr-soft"
+    >
+      <Group gap={12} wrap="nowrap">
+        <Box
+          style={{
+            width: 38,
+            height: 38,
+            flexShrink: 0,
+            borderRadius: 11,
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            background: cv("edr-soft"),
+            color: cv("edr-green.7"),
+          }}
+        >
+          <Icon size={18} />
+        </Box>
+        <Box style={{ minWidth: 0 }}>
+          <Group gap={6} wrap="nowrap">
+            <Text fw={700} fz={14} c="edr-text">
+              {title}
+            </Text>
+            <ArrowRight size={14} color={cv("edr-muted")} />
+          </Group>
+          <Text fz={12} c="dimmed" truncate>
+            {hint}
+          </Text>
+        </Box>
+      </Group>
+    </Box>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineInitiateModal.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineInitiateModal.tsx
new file mode 100644
index 000000000..0313aa399
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineInitiateModal.tsx
@@ -0,0 +1,285 @@
+import {
+  Alert,
+  Box,
+  Button,
+  Center,
+  Group,
+  Loader,
+  Modal,
+  Select,
+  Stack,
+  Text,
+} from "@mantine/core";
+import { DatePickerInput } from "@mantine/dates";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { AlertCircle, CalendarDays, MapPin, Plus } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+
+import {
+  shippingLineBookingsService,
+  type ShippingLineBooking,
+} from "@/services/shipping-line-bookings.service";
+
+const FREIGHT_TYPES = [
+  { value: "CONTAINER", label: "Container" },
+  { value: "BULK", label: "Bulk" },
+];
+
+/**
+ * Initiate a shipping-line booking.
+ *
+ * Origin and destination are picked separately (matching the customer form),
+ * but both lists are drawn from real routes, so the pair always resolves to a
+ * lane EDR runs. The request still sends that route's id, letting the server
+ * derive origin, destination and direction from one authoritative row.
+ *
+ * Only inbound (Djibouti to Ethiopia) lanes are offered — the API filters them
+ * and rejects anything else, so this is a fixed rule, not a UI convenience.
+ */
+export default function ShippingLineInitiateModal({
+  opened,
+  onClose,
+  onCreated,
+}: {
+  opened: boolean;
+  onClose: () => void;
+  onCreated: (booking: ShippingLineBooking) => void;
+}) {
+  const queryClient = useQueryClient();
+  const [originYardId, setOriginYardId] = useState<string | null>(null);
+  const [destinationYardId, setDestinationYardId] = useState<string | null>(
+    null,
+  );
+  const [serviceTypeId, setServiceTypeId] = useState<string | null>(null);
+  const [freightType, setFreightType] = useState<string>("CONTAINER");
+  const [scheduledDate, setScheduledDate] = useState<string | null>(null);
+
+  // Fresh sheet each time it opens.
+  useEffect(() => {
+    if (opened) {
+      setOriginYardId(null);
+      setDestinationYardId(null);
+      setServiceTypeId(null);
+      setFreightType("CONTAINER");
+      setScheduledDate(null);
+    }
+  }, [opened]);
+
+  const referenceQuery = useQuery({
+    queryKey: ["shipping-line-reference-data"],
+    queryFn: shippingLineBookingsService.referenceData,
+    enabled: opened,
+  });
+
+  const initiateMutation = useMutation({
+    mutationFn: () =>
+      shippingLineBookingsService.initiate({
+        routeId: selectedRoute!.id,
+        serviceTypeId: serviceTypeId ?? undefined,
+        freightType,
+        scheduledDate: scheduledDate ?? undefined,
+      }),
+    onSuccess: (booking) => {
+      void queryClient.invalidateQueries({
+        queryKey: ["shipping-line-bookings"],
+      });
+      onCreated(booking);
+    },
+  });
+
+  const routes = useMemo(
+    () => referenceQuery.data?.routes ?? [],
+    [referenceQuery.data],
+  );
+  const serviceTypes = referenceQuery.data?.serviceTypes ?? [];
+
+  // Origin and destination are picked separately (as in the customer form), but
+  // the pair still has to be a route EDR actually runs — so each list is drawn
+  // from the routes, and the destination list narrows to what the chosen origin
+  // can reach. That keeps the familiar two-field shape without letting someone
+  // assemble a lane that does not exist.
+  const originOptions = useMemo(() => {
+    const seen = new Map<string, string>();
+    for (const route of routes) {
+      if (!seen.has(route.originYardId)) {
+        seen.set(route.originYardId, route.originLabel);
+      }
+    }
+    return [...seen].map(([value, label]) => ({ value, label }));
+  }, [routes]);
+
+  const destinationOptions = useMemo(() => {
+    const seen = new Map<string, string>();
+    for (const route of routes) {
+      if (originYardId && route.originYardId !== originYardId) continue;
+      if (!seen.has(route.destinationYardId)) {
+        seen.set(route.destinationYardId, route.destinationLabel);
+      }
+    }
+    return [...seen].map(([value, label]) => ({ value, label }));
+  }, [routes, originYardId]);
+
+  // The lane the two picks resolve to. Still sent as a routeId so the server
+  // keeps deriving origin/destination/direction from one authoritative row.
+  const selectedRoute = routes.find(
+    (r) =>
+      r.originYardId === originYardId &&
+      r.destinationYardId === destinationYardId,
+  );
+
+  // Changing the origin can invalidate an already-picked destination.
+  useEffect(() => {
+    if (
+      destinationYardId &&
+      !destinationOptions.some((o) => o.value === destinationYardId)
+    ) {
+      setDestinationYardId(null);
+    }
+  }, [destinationOptions, destinationYardId]);
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      centered
+      size="md"
+      radius="md"
+      title={
+        <Box>
+          <Text fw={700} fz={16}>
+            Initiate booking
+          </Text>
+          <Text fz={12} c="dimmed">
+            Pick the lane — you will upload documents next.
+          </Text>
+        </Box>
+      }
+      overlayProps={{ blur: 2, backgroundOpacity: 0.55 }}
+    >
+      {referenceQuery.isLoading ? (
+        <Center py="xl">
+          <Loader size="sm" />
+        </Center>
+      ) : routes.length === 0 ? (
+        <Text fz="13px" c="dimmed" py="md">
+          No inbound routes are available for booking right now. Please contact
+          Operations.
+        </Text>
+      ) : (
+        <Stack gap="md">
+          <Group grow align="flex-start" gap="sm">
+            <Select
+              label="Origin yard (Djibouti)"
+              placeholder="Select origin..."
+              withAsterisk
+              searchable
+              data={originOptions}
+              value={originYardId}
+              onChange={setOriginYardId}
+              comboboxProps={{ withinPortal: true }}
+            />
+            <Select
+              label="Destination yard (Ethiopia)"
+              placeholder="Select destination..."
+              withAsterisk
+              searchable
+              disabled={!originYardId}
+              data={destinationOptions}
+              value={destinationYardId}
+              onChange={setDestinationYardId}
+              comboboxProps={{ withinPortal: true }}
+            />
+          </Group>
+
+          {/* Shipping lines only move inbound cargo, so the direction is fixed
+              rather than derived per pick — stated up front so the single
+              option in each list does not read as missing data. */}
+          <Alert
+            color="blue"
+            variant="light"
+            radius="md"
+            p="xs"
+            icon={<MapPin size={15} />}
+          >
+            <Text fz={12}>
+              Inbound only — cargo moves from Djibouti to Ethiopia (
+              <Text span fw={700}>
+                IMPORT
+              </Text>
+              ).
+            </Text>
+          </Alert>
+
+          <Select
+            label="Freight type"
+            data={FREIGHT_TYPES}
+            value={freightType}
+            onChange={(v) => setFreightType(v ?? "CONTAINER")}
+            comboboxProps={{ withinPortal: true }}
+          />
+
+          {/* Picked up front, unlike the customer flow — a shipping line has no
+              later operation-request step to choose its shipment day at. */}
+          <DatePickerInput
+            label="Scheduled date"
+            placeholder="Pick the shipment day"
+            withAsterisk
+            minDate={new Date().toISOString().slice(0, 10)}
+            leftSection={<CalendarDays size={16} />}
+            value={scheduledDate}
+            onChange={(v) => setScheduledDate(v ?? null)}
+            radius="md"
+            popoverProps={{ withinPortal: true }}
+          />
+
+          {/* Only services that do NOT bundle customs are offered — the API
+              filters them and rejects the rest. If none are configured the
+              field says so rather than vanishing, which would read as a
+              missing form rather than a data gap. */}
+          {serviceTypes.length > 0 ? (
+            <Select
+              label="Service"
+              placeholder="Select a service"
+              clearable
+              data={serviceTypes.map((s) => ({ value: s.id, label: s.name }))}
+              value={serviceTypeId}
+              onChange={setServiceTypeId}
+              comboboxProps={{ withinPortal: true }}
+            />
+          ) : (
+            <Select
+              label="Service"
+              placeholder="No non-customs service configured"
+              disabled
+              data={[]}
+              value={null}
+            />
+          )}
+
+          {initiateMutation.isError && (
+            <Alert color="red" icon={<AlertCircle size={16} />}>
+              {(initiateMutation.error as Error)?.message ??
+                "Could not initiate the booking."}
+            </Alert>
+          )}
+
+          <Group justify="flex-end" mt="sm" gap="sm">
+            <Button variant="default" radius="md" onClick={onClose}>
+              Cancel
+            </Button>
+            <Button
+              color="edr-green"
+              radius="md"
+              leftSection={<Plus size={16} />}
+              loading={initiateMutation.isPending}
+              disabled={!selectedRoute || !scheduledDate}
+              onClick={() => initiateMutation.mutate()}
+            >
+              Initiate booking
+            </Button>
+          </Group>
+        </Stack>
+      )}
+    </Modal>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineInvoicesPage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineInvoicesPage.tsx
new file mode 100644
index 000000000..fd63a288d
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineInvoicesPage.tsx
@@ -0,0 +1,231 @@
+import {
+  Alert,
+  Box,
+  Button,
+  Card,
+  Center,
+  Group,
+  Loader,
+  SimpleGrid,
+  Stack,
+  Table,
+  Text,
+  Title,
+} from "@mantine/core";
+import { useQuery } from "@tanstack/react-query";
+import { Freight } from "@edr/types";
+import { ChevronRight, Info, Receipt } from "lucide-react";
+import { useMemo } from "react";
+import { useNavigate } from "react-router-dom";
+
+import { formatCurrency } from "@/lib/currency";
+import { api } from "@/services/api";
+import { BORDER, INK, MUTED } from "../contracts/contract-ui";
+import { fmtDate, InvoiceStatusBadge, isPayable } from "../billing/invoice-ui";
+
+function StatBox({ label, value }: { label: string; value: string }) {
+  return (
+    <Card withBorder radius="md" padding="md">
+      <Text
+        fz={11}
+        fw={700}
+        c={MUTED}
+        style={{ textTransform: "uppercase", letterSpacing: "0.05em" }}
+      >
+        {label}
+      </Text>
+      <Text fz={22} fw={800} mt={4} style={{ color: INK }}>
+        {value}
+      </Text>
+    </Card>
+  );
+}
+
+/**
+ * The shipping line's credit invoices — Finance bills batches of the line's
+ * booking charges, and each invoice is payable at any CBE channel whenever the
+ * line chooses; there is no payment window. Detail (which bookings, each
+ * charge, the total) lives one click deeper on the shared invoice detail page.
+ */
+export default function ShippingLineInvoicesPage() {
+  const navigate = useNavigate();
+  const {
+    data: allInvoices,
+    isLoading,
+    isError,
+    refetch,
+  } = useQuery(api.invoices.listMy.queryOptions());
+
+  // Only the credit invoices: a shipping line's bookings are charged through
+  // the credit ledger, so other sources (e.g. a booking's internal draft
+  // invoice) would only double-state the same debt here.
+  const invoices = useMemo(
+    () =>
+      (allInvoices ?? []).filter(
+        (inv) => inv.source === Freight.InvoiceSource.ShippingLineCredit,
+      ),
+    [allInvoices],
+  );
+
+  const openInvoices = invoices.filter((inv) => isPayable(inv.status));
+  const outstanding = openInvoices.reduce(
+    (sum, inv) => sum + Number(inv.balanceAmount ?? inv.totalAmount),
+    0,
+  );
+  const currency = invoices[0]?.currency ?? "ETB";
+
+  return (
+    <Stack gap="lg" p={{ base: 16, sm: 24, lg: 32 }}>
+      <Stack gap={4}>
+        <Title order={2}>Invoices</Title>
+        <Text c="dimmed" size="sm">
+          Your billed freight charges. Pay any open invoice at a CBE branch,
+          the CBE app or USSD using its bill reference — there is no payment
+          deadline window.
+        </Text>
+      </Stack>
+
+      <SimpleGrid cols={{ base: 1, sm: 3 }}>
+        <StatBox
+          label="Outstanding balance"
+          value={formatCurrency(outstanding, currency)}
+        />
+        <StatBox label="Open invoices" value={String(openInvoices.length)} />
+        <StatBox
+          label="Paid invoices"
+          value={String(
+            invoices.filter(
+              (inv) => inv.status === Freight.InvoiceStatus.Paid,
+            ).length,
+          )}
+        />
+      </SimpleGrid>
+
+      {isLoading ? (
+        <Center py={64}>
+          <Loader color="edr-green" />
+        </Center>
+      ) : isError ? (
+        <Alert color="red" title="Could not load invoices">
+          <Group gap="sm">
+            <Text size="sm">Something went wrong.</Text>
+            <Button size="compact-sm" variant="light" onClick={() => refetch()}>
+              Retry
+            </Button>
+          </Group>
+        </Alert>
+      ) : invoices.length === 0 ? (
+        <Card withBorder radius="md" py={64}>
+          <Stack align="center" gap="xs">
+            <Receipt size={28} className="text-slate-300" />
+            <Text c="dimmed" size="sm">
+              No invoices yet. Finance bills your accumulated booking charges
+              in batches — invoices will appear here once issued.
+            </Text>
+          </Stack>
+        </Card>
+      ) : (
+        <Card withBorder radius="md" p={0} style={{ overflow: "hidden" }}>
+          <Box style={{ overflowX: "auto" }}>
+            <Table
+              highlightOnHover
+              verticalSpacing={12}
+              horizontalSpacing={20}
+              styles={{
+                th: {
+                  fontSize: 11,
+                  fontWeight: 700,
+                  letterSpacing: "0.05em",
+                  textTransform: "uppercase",
+                  color: MUTED,
+                  background: "#F8FAFC",
+                  borderBottom: `1px solid ${BORDER}`,
+                  whiteSpace: "nowrap",
+                },
+                td: { borderBottom: `1px solid ${BORDER}` },
+              }}
+            >
+              <Table.Thead>
+                <Table.Tr>
+                  <Table.Th>Invoice</Table.Th>
+                  <Table.Th>Issued</Table.Th>
+                  <Table.Th>Due</Table.Th>
+                  <Table.Th ta="right">Amount</Table.Th>
+                  <Table.Th ta="right">Balance</Table.Th>
+                  <Table.Th>Status</Table.Th>
+                  <Table.Th />
+                </Table.Tr>
+              </Table.Thead>
+              <Table.Tbody>
+                {invoices.map((inv) => (
+                  <Table.Tr
+                    key={inv.id}
+                    style={{ cursor: "pointer" }}
+                    onClick={() =>
+                      navigate(`/shipping-line/invoices/${inv.id}`)
+                    }
+                  >
+                    <Table.Td>
+                      <Text fz={14} fw={700} ff="monospace" style={{ color: INK }}>
+                        {inv.invoiceNumber}
+                      </Text>
+                    </Table.Td>
+                    <Table.Td>
+                      <Text fz={13}>{fmtDate(inv.issuedAt)}</Text>
+                    </Table.Td>
+                    <Table.Td>
+                      <Text fz={13}>{fmtDate(inv.dueAt)}</Text>
+                    </Table.Td>
+                    <Table.Td ta="right">
+                      <Text fz={13} fw={600}>
+                        {formatCurrency(Number(inv.totalAmount), inv.currency)}
+                      </Text>
+                    </Table.Td>
+                    <Table.Td ta="right">
+                      <Text fz={13} fw={600}>
+                        {formatCurrency(
+                          Number(inv.balanceAmount ?? inv.totalAmount),
+                          inv.currency,
+                        )}
+                      </Text>
+                    </Table.Td>
+                    <Table.Td>
+                      <InvoiceStatusBadge status={inv.status} />
+                    </Table.Td>
+                    <Table.Td ta="right">
+                      <Button
+                        size="compact-sm"
+                        variant={isPayable(inv.status) ? "filled" : "light"}
+                        color="edr-green"
+                        rightSection={<ChevronRight size={14} />}
+                        onClick={(e) => {
+                          e.stopPropagation();
+                          navigate(`/shipping-line/invoices/${inv.id}`);
+                        }}
+                      >
+                        {isPayable(inv.status) ? "View & pay" : "View"}
+                      </Button>
+                    </Table.Td>
+                  </Table.Tr>
+                ))}
+              </Table.Tbody>
+            </Table>
+          </Box>
+        </Card>
+      )}
+
+      <Alert
+        icon={<Info size={16} />}
+        color="blue"
+        variant="light"
+        p="sm"
+      >
+        <Text size="sm">
+          Open an invoice and choose <b>Pay</b> → <b>CBE</b> to get its bill
+          reference. Pay against that reference at any CBE branch, in the CBE
+          app or via USSD; the invoice settles automatically once CBE confirms.
+        </Text>
+      </Alert>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLinePlaceholder.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLinePlaceholder.tsx
new file mode 100644
index 000000000..20d647474
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLinePlaceholder.tsx
@@ -0,0 +1,40 @@
+import { Card, Stack, Text, Title } from "@mantine/core";
+import type { ReactNode } from "react";
+
+export interface ShippingLinePlaceholderProps {
+  title: string;
+  description: string;
+  icon?: ReactNode;
+}
+
+/**
+ * Shell for the shipping-line pages while they are still being built out.
+ * Each page owns its own file so it can be filled in independently; this only
+ * supplies the shared empty-state chrome and is meant to be deleted from a page
+ * once that page has real content.
+ */
+export default function ShippingLinePlaceholder({
+  title,
+  description,
+  icon,
+}: ShippingLinePlaceholderProps) {
+  return (
+    <Stack gap="lg" p={{ base: 16, sm: 24, lg: 32 }}>
+      <Stack gap={4}>
+        <Title order={2}>{title}</Title>
+        <Text c="dimmed" size="sm">
+          {description}
+        </Text>
+      </Stack>
+
+      <Card withBorder radius="md" py={64}>
+        <Stack align="center" gap="xs">
+          {icon}
+          <Text c="dimmed" size="sm">
+            Nothing here yet — this page is still being built.
+          </Text>
+        </Stack>
+      </Card>
+    </Stack>
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineSettingsPage.tsx b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineSettingsPage.tsx
new file mode 100644
index 000000000..9e2081e58
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/ShippingLineSettingsPage.tsx
@@ -0,0 +1,17 @@
+import { Settings } from "lucide-react";
+import ShippingLinePlaceholder from "./ShippingLinePlaceholder";
+
+/**
+ * Shipping-line settings. Separate from the customer `SettingsPage`, which is
+ * built around company profiles, business licenses and contact-person review —
+ * none of which a shipping line has.
+ */
+export default function ShippingLineSettingsPage() {
+  return (
+    <ShippingLinePlaceholder
+      title="Settings"
+      description="Manage your account and preferences."
+      icon={<Settings size={28} className="text-slate-300" />}
+    />
+  );
+}
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/booking-doc-state.ts b/apps/edr-freight-web/portal/src/pages/shipping-line/booking-doc-state.ts
new file mode 100644
index 000000000..341f1486a
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/booking-doc-state.ts
@@ -0,0 +1,85 @@
+import type { ShippingLineBooking } from "@/services/shipping-line-bookings.service";
+
+/**
+ * What the shipping line has to do about a booking's documents.
+ *
+ * Derived from the booking status AND the per-document review results, because
+ * the two disagree in the case that matters most: when a reviewer queries a
+ * document, that document's review status becomes QUERIED but the BOOKING stays
+ * on DOCUMENTS_UNDER_REVIEW. Keying the UI off status alone would keep showing
+ * "In review" while the shipping line is actually being asked to fix something.
+ */
+export type BookingDocState =
+  /** Nothing uploaded yet — the first submission is owed. */
+  | "AWAITING"
+  /** A reviewer sent something back; the shipping line must re-upload. */
+  | "ACTION_NEEDED"
+  /** Submitted and with Operations. */
+  | "IN_REVIEW"
+  /** Everything approved. */
+  | "APPROVED"
+  /** Documents do not apply at this status. */
+  | "NONE";
+
+export function bookingDocState(
+  booking: Pick<ShippingLineBooking, "status" | "hasQueriedDocuments">,
+): BookingDocState {
+  const status = booking.status as string;
+
+  // Checked before the status switch: a queried document outranks the booking's
+  // own DOCUMENTS_UNDER_REVIEW, which is exactly the case status alone misses.
+  if (booking.hasQueriedDocuments) return "ACTION_NEEDED";
+
+  switch (status) {
+    case "AWAITING_DOCUMENTS":
+      return "AWAITING";
+    case "CHANGES_REQUESTED":
+      return "ACTION_NEEDED";
+    case "DOCUMENTS_UNDER_REVIEW":
+      return "IN_REVIEW";
+    case "CLEARANCE_READY":
+      return "APPROVED";
+    default:
+      return "NONE";
+  }
+}
+
+/** Whether the document grid is worth opening at this state. */
+export function hasDocuments(state: BookingDocState): boolean {
+  return state !== "NONE";
+}
+
+/** Whether the shipping line owes an upload — drives the primary action label. */
+export function needsUpload(state: BookingDocState): boolean {
+  return state === "AWAITING" || state === "ACTION_NEEDED";
+}
+
+export const DOC_STATE_LABEL: Record<BookingDocState, string> = {
+  AWAITING: "Documents needed",
+  ACTION_NEEDED: "Action needed",
+  IN_REVIEW: "In review",
+  APPROVED: "Approved",
+  NONE: "",
+};
+
+/** Mantine colour for the state's badge/alert. */
+export const DOC_STATE_COLOR: Record<BookingDocState, string> = {
+  AWAITING: "yellow",
+  ACTION_NEEDED: "red",
+  IN_REVIEW: "blue",
+  APPROVED: "teal",
+  NONE: "gray",
+};
+
+/**
+ * Label for the button that opens the document grid. A queried document asks
+ * for a replacement, so it reads as an instruction rather than "View" — the
+ * shipping line must swap the file, not just look at it.
+ */
+export const DOC_STATE_ACTION_LABEL: Record<BookingDocState, string> = {
+  AWAITING: "Upload documents",
+  ACTION_NEEDED: "Change document",
+  IN_REVIEW: "View documents",
+  APPROVED: "View documents",
+  NONE: "View documents",
+};
diff --git a/apps/edr-freight-web/portal/src/pages/shipping-line/index.ts b/apps/edr-freight-web/portal/src/pages/shipping-line/index.ts
new file mode 100644
index 000000000..67557dd25
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/shipping-line/index.ts
@@ -0,0 +1,7 @@
+export { default as ShippingLineHomePage } from "./ShippingLineHomePage";
+export { default as ShippingLineBookingsPage } from "./ShippingLineBookingsPage";
+export { default as ShippingLineBookingDetailPage } from "./ShippingLineBookingDetailPage";
+export { default as ShippingLineCompletePage } from "./ShippingLineCompletePage";
+export { default as ShippingLineInvoicesPage } from "./ShippingLineInvoicesPage";
+export { default as ShippingLineSettingsPage } from "./ShippingLineSettingsPage";
+export { default as ShippingLineHelpPage } from "./ShippingLineHelpPage";
diff --git a/apps/edr-freight-web/portal/src/pages/support/DocShell.tsx b/apps/edr-freight-web/portal/src/pages/support/DocShell.tsx
index 080189b3b..b4646e0cc 100644
--- a/apps/edr-freight-web/portal/src/pages/support/DocShell.tsx
+++ b/apps/edr-freight-web/portal/src/pages/support/DocShell.tsx
@@ -1,8 +1,9 @@
+import type { PortalDocSection } from "@edr/types";
 import { ArrowLeft, Train } from "lucide-react";
 import type { ReactNode } from "react";
 import { Link } from "react-router-dom";
 
-import type { Section } from "./content";
+import { Markdown } from "./Markdown";
 
 /** Public pages reachable from every doc page's header and footer. */
 const DOC_LINKS = [
@@ -19,6 +20,8 @@ interface DocShellProps {
   meta?: string;
   /** Path of the current page, so it is not linked to itself. */
   current: string;
+  /** Contents column, mirroring the page list editors see in the backoffice. */
+  sidebar?: ReactNode;
   children: ReactNode;
 }
 
@@ -32,12 +35,13 @@ export function DocShell({
   subtitle,
   meta,
   current,
+  sidebar,
   children,
 }: DocShellProps) {
   return (
     <div className="min-h-screen bg-background text-foreground">
       <header className="sticky top-0 z-50 border-b border-border bg-background/80 backdrop-blur-xl">
-        <div className="mx-auto flex max-w-4xl items-center justify-between gap-4 px-6 py-4">
+        <div className="mx-auto flex max-w-6xl items-center justify-between gap-4 px-6 py-4">
           <Link to="/" className="flex items-center gap-3">
             <div className="flex size-10 items-center justify-center rounded-2xl bg-primary text-primary-foreground">
               <Train className="size-5" />
@@ -55,7 +59,7 @@ export function DocShell({
         </div>
       </header>
 
-      <main className="mx-auto max-w-4xl px-6 py-12">
+      <main className="mx-auto max-w-6xl px-6 py-12">
         <h1 className="text-4xl font-black tracking-tight">{title}</h1>
         <p className="mt-4 text-lg leading-8 text-muted-foreground">
           {subtitle}
@@ -64,11 +68,18 @@ export function DocShell({
           <p className="mt-2 text-sm text-muted-foreground">{meta}</p>
         )}
 
-        <div className="mt-10">{children}</div>
+        {sidebar ? (
+          <div className="mt-10 flex flex-col gap-8 lg:flex-row lg:gap-10">
+            {sidebar}
+            <div className="min-w-0 flex-1">{children}</div>
+          </div>
+        ) : (
+          <div className="mt-10">{children}</div>
+        )}
       </main>
 
       <footer className="border-t border-border py-8">
-        <div className="mx-auto flex max-w-4xl flex-col items-center justify-between gap-4 px-6 text-sm text-muted-foreground md:flex-row">
+        <div className="mx-auto flex max-w-6xl flex-col items-center justify-between gap-4 px-6 text-sm text-muted-foreground md:flex-row">
           <span>© 2026 EDR Freight. All rights reserved.</span>
           <nav className="flex flex-wrap items-center justify-center gap-x-6 gap-y-2">
             {DOC_LINKS.filter((l) => l.to !== current).map((link) => (
@@ -87,32 +98,24 @@ export function DocShell({
   );
 }
 
-/** Renders a legal document's numbered sections. */
-export function DocSections({ sections }: { sections: Section[] }) {
+/**
+ * Renders a legal document's numbered sections. Bodies are markdown, so the
+ * paragraph and bullet arrays this used to walk are one string now — keyed by
+ * `id` rather than by heading, which admin-authored text can duplicate.
+ */
+export function DocSections({ sections }: { sections: PortalDocSection[] }) {
   return (
     <div className="space-y-10">
-      {sections.map((section) => (
-        <section key={section.heading}>
+      {/* Guarded: this is API-supplied, and these routes are public. */}
+      {(sections ?? []).map((section) => (
+        // `id` doubles as the anchor the contents list and #deep-links target;
+        // `scroll-mt` keeps the heading clear of the sticky header.
+        <section key={section.id} id={section.id} className="scroll-mt-24">
           <h2 className="text-xl font-bold tracking-tight">
             {section.heading}
           </h2>
 
-          {section.body?.map((paragraph) => (
-            <p
-              key={paragraph}
-              className="mt-4 leading-7 text-muted-foreground"
-            >
-              {paragraph}
-            </p>
-          ))}
-
-          {section.bullets && (
-            <ul className="mt-4 list-disc space-y-2 pl-5 leading-7 text-muted-foreground">
-              {section.bullets.map((bullet) => (
-                <li key={bullet}>{bullet}</li>
-              ))}
-            </ul>
-          )}
+          <Markdown>{section.body}</Markdown>
         </section>
       ))}
     </div>
diff --git a/apps/edr-freight-web/portal/src/pages/support/DocSidebar.tsx b/apps/edr-freight-web/portal/src/pages/support/DocSidebar.tsx
new file mode 100644
index 000000000..eec27c28b
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/support/DocSidebar.tsx
@@ -0,0 +1,117 @@
+import { useEffect, useState } from "react";
+
+export interface DocNavItem {
+  id: string;
+  label: string;
+}
+
+/**
+ * Highlights whichever section is currently on screen, so a long policy tells
+ * the reader where they are. Watches the top band of the viewport, which is
+ * what makes the highlight change as a heading scrolls past rather than only
+ * when a whole section fits.
+ */
+export function useActiveSection(ids: string[]): string | null {
+  const [active, setActive] = useState<string | null>(ids[0] ?? null);
+
+  useEffect(() => {
+    if (ids.length === 0) return;
+
+    const observer = new IntersectionObserver(
+      (entries) => {
+        const visible = entries
+          .filter((entry) => entry.isIntersecting)
+          .sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top);
+        if (visible[0]) setActive(visible[0].target.id);
+      },
+      // Top ~quarter of the viewport, below the sticky header.
+      { rootMargin: "-80px 0px -70% 0px", threshold: 0 },
+    );
+
+    for (const id of ids) {
+      const element = document.getElementById(id);
+      if (element) observer.observe(element);
+    }
+    return () => observer.disconnect();
+  }, [ids.join("|")]); // eslint-disable-line react-hooks/exhaustive-deps
+
+  return active;
+}
+
+interface DocSidebarProps {
+  items: DocNavItem[];
+  activeId: string | null;
+  /**
+   * Paged mode (the help page): selecting swaps the visible section. Omit for
+   * table-of-contents mode, where entries are anchors into one long document.
+   */
+  onSelect?: (id: string) => void;
+  heading?: string;
+}
+
+/**
+ * The document's contents, mirroring the page list an editor sees in the
+ * backoffice. Sticky on wide screens; above the content on narrow ones, where
+ * a fixed column would eat the reading width.
+ */
+export function DocSidebar({
+  items,
+  activeId,
+  onSelect,
+  heading = "Contents",
+}: DocSidebarProps) {
+  if (items.length === 0) return null;
+
+  return (
+    <nav
+      aria-label={heading}
+      // Divider: a right edge once the columns sit side by side, a bottom edge
+      // while they are stacked — so the contents always reads as its own
+      // column rather than as text that happens to be to the left.
+      className="border-b border-border pb-6 lg:sticky lg:top-24 lg:w-64 lg:shrink-0 lg:self-start lg:border-b-0 lg:border-r lg:pb-0 lg:pr-6"
+    >
+      <p className="px-3 text-xs font-bold uppercase tracking-wider text-foreground/60">
+        {heading}
+      </p>
+
+      <ul className="mt-3 max-h-[60vh] space-y-1 overflow-y-auto lg:max-h-[calc(100vh-10rem)]">
+        {items.map((item) => {
+          const active = item.id === activeId;
+          // Inactive entries were `muted-foreground`, which is the same tone as
+          // body copy and left the list looking disabled. These are navigation,
+          // so they sit closer to full foreground and darken on hover.
+          const className = `block w-full rounded-xl px-3 py-2 text-left text-sm transition ${
+            active
+              ? "bg-accent font-semibold text-foreground"
+              : "text-foreground/75 hover:bg-accent/60 hover:text-foreground"
+          }`;
+
+          return (
+            <li key={item.id}>
+              {onSelect ? (
+                <button
+                  type="button"
+                  onClick={() => onSelect(item.id)}
+                  aria-current={active ? "page" : undefined}
+                  className={className}
+                >
+                  {item.label}
+                </button>
+              ) : (
+                <a
+                  href={`#${item.id}`}
+                  aria-current={active ? "true" : undefined}
+                  className={className}
+                >
+                  {item.label}
+                </a>
+              )}
+            </li>
+          );
+        })}
+      </ul>
+    </nav>
+  );
+}
+
+export default DocSidebar;
diff --git a/apps/edr-freight-web/portal/src/pages/support/FaqPage.tsx b/apps/edr-freight-web/portal/src/pages/support/FaqPage.tsx
index 9704c8cf8..2edf69c9e 100644
--- a/apps/edr-freight-web/portal/src/pages/support/FaqPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/support/FaqPage.tsx
@@ -1,27 +1,45 @@
 import { ChevronDown } from "lucide-react";
 import { Link } from "react-router-dom";
 
+import { usePortalContent } from "@/hooks/usePortalContent";
+
 import { DocShell } from "./DocShell";
-import { FAQ_GROUPS, SUPPORT_CONTACT } from "./content";
+import { DocSidebar, useActiveSection } from "./DocSidebar";
+import { Markdown } from "./Markdown";
 
 export default function FaqPage() {
+  // Never undefined — see TermsPage.
+  const { data } = usePortalContent();
+  const faq = data!.faq;
+  const groups = faq.groups ?? [];
+
+  // Contents lists the groups; individual questions stay as the disclosure
+  // rows below, which is already the fastest way to scan them.
+  const activeId = useActiveSection(groups.map((group) => group.id));
+
   return (
     <DocShell
       current="/faq"
-      title="Frequently Asked Questions"
-      subtitle="Answers to the questions customers ask most about registering, booking cargo and settling invoices on EDR Freight."
+      title={faq.title}
+      subtitle={faq.subtitle}
+      sidebar={
+        <DocSidebar
+          items={groups.map((group) => ({ id: group.id, label: group.title }))}
+          activeId={activeId}
+        />
+      }
     >
       <div className="space-y-10">
-        {FAQ_GROUPS.map((group) => (
-          <section key={group.title}>
+        {groups.map((group) => (
+          <section key={group.id} id={group.id} className="scroll-mt-24">
             <h2 className="text-xl font-bold tracking-tight">{group.title}</h2>
 
             <div className="mt-4 space-y-3">
-              {group.items.map((item) => (
+              {(group.items ?? []).map((item) => (
                 // Native disclosure: keyboard- and screen-reader-accessible
                 // without any state of our own.
                 <details
-                  key={item.question}
+                  key={item.id}
                   className="group rounded-2xl border border-border bg-card px-5 py-4 transition hover:border-primary/40"
                 >
                   <summary className="flex cursor-pointer list-none items-center justify-between gap-4 font-semibold">
@@ -29,9 +47,7 @@ export default function FaqPage() {
                     <ChevronDown className="size-5 shrink-0 text-muted-foreground transition-transform group-open:rotate-180" />
                   </summary>
 
-                  <p className="mt-3 leading-7 text-muted-foreground">
-                    {item.answer}
-                  </p>
+                  <Markdown>{item.answer}</Markdown>
                 </details>
               ))}
             </div>
@@ -39,21 +55,20 @@ export default function FaqPage() {
         ))}
       </div>
 
-      <div className="mt-12 rounded-[32px] border border-border bg-card p-8">
-        <h2 className="text-xl font-bold tracking-tight">
-          Still need a hand?
-        </h2>
-        <p className="mt-2 leading-7 text-muted-foreground">
-          Our team is on {SUPPORT_CONTACT.email} and {SUPPORT_CONTACT.phone}, or
-          you can start a chat from the support button inside the portal.
-        </p>
-        <Link
-          to="/help"
-          className="mt-6 inline-flex rounded-2xl bg-primary px-6 py-3 font-semibold text-primary-foreground transition hover:opacity-90"
-        >
-          Go to Help &amp; Support
-        </Link>
-      </div>
+      {faq.footer && (
+        <div className="mt-12 rounded-[32px] border border-border bg-card p-8">
+          <h2 className="text-xl font-bold tracking-tight">
+            {faq.footer.heading}
+          </h2>
+          <Markdown>{faq.footer.body}</Markdown>
+          <Link
+            to={faq.footer.ctaTo}
+            className="mt-6 inline-flex rounded-2xl bg-primary px-6 py-3 font-semibold text-primary-foreground transition hover:opacity-90"
+          >
+            {faq.footer.ctaLabel}
+          </Link>
+        </div>
+      )}
     </DocShell>
   );
 }
diff --git a/apps/edr-freight-web/portal/src/pages/support/HelpPage.tsx b/apps/edr-freight-web/portal/src/pages/support/HelpPage.tsx
index b310dfa2c..f55b9145f 100644
--- a/apps/edr-freight-web/portal/src/pages/support/HelpPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/support/HelpPage.tsx
@@ -1,208 +1,75 @@
-import {
-  Clock3,
-  FileText,
-  HelpCircle,
-  Mail,
-  MapPin,
-  MessageSquare,
-  Package,
-  Phone,
-  Receipt,
-  ShieldCheck,
-} from "lucide-react";
-import { Link } from "react-router-dom";
+import { useEffect, useState } from "react";
+import { useLocation, useNavigate } from "react-router-dom";
+
+import { usePortalContent } from "@/hooks/usePortalContent";
 
 import { DocShell } from "./DocShell";
-import { SUPPORT_CONTACT } from "./content";
-
-const channels = [
-  {
-    icon: Mail,
-    title: "Email",
-    value: SUPPORT_CONTACT.email,
-    href: `mailto:${SUPPORT_CONTACT.email}`,
-    note: "Best for document issues and anything needing an attachment.",
-  },
-  {
-    icon: Phone,
-    title: "Phone",
-    value: SUPPORT_CONTACT.phone,
-    href: `tel:${SUPPORT_CONTACT.phone.replace(/\s/g, "")}`,
-    note: "Best for urgent problems with cargo already in transit.",
-  },
-  {
-    icon: MapPin,
-    title: "Head office",
-    value: SUPPORT_CONTACT.office,
-    note: "Walk-in support during working hours.",
-  },
-  {
-    icon: Clock3,
-    title: "Support hours",
-    value: SUPPORT_CONTACT.hours,
-    note: "Outside these hours, email us and we reply the next working day.",
-  },
-];
-
-const topics = [
-  {
-    icon: ShieldCheck,
-    title: "Account & onboarding",
-    body: "Registering your company, uploading your trade licence and TIN, and getting an operational profile approved.",
-  },
-  {
-    icon: FileText,
-    title: "Contracts",
-    body: "Requesting a freight contract, reviewing its terms and signing it with your saved signature and stamp.",
-  },
-  {
-    icon: Package,
-    title: "Bookings & tracking",
-    body: "Raising a booking against a contract, adding last-mile transport and following the consignment along the corridor.",
-  },
-  {
-    icon: Receipt,
-    title: "Invoices & payments",
-    body: "Finding invoices, paying through the bank channels and confirming a payment that has not yet settled.",
-  },
-];
+import { DocSidebar } from "./DocSidebar";
+import { Markdown } from "./Markdown";
 
+/**
+ * Help is browsed a page at a time, mirroring how it is written: the sidebar is
+ * the list of pages, and picking one swaps the panel. Unlike the legal
+ * documents nobody reads help end to end — they arrive with one question — so
+ * showing a single answer beats a wall of every topic at once.
+ */
 export default function HelpPage() {
+  // Never undefined — see TermsPage.
+  const { data } = usePortalContent();
+  const help = data!.help;
+  const sections = help.sections ?? [];
+
+  const navigate = useNavigate();
+  const { hash } = useLocation();
+
+  // The open page lives in the URL, so a link to a specific topic works and
+  // Back steps between topics.
+  const fromHash = hash ? decodeURIComponent(hash.slice(1)) : "";
+  const [selectedId, setSelectedId] = useState(
+    () => fromHash || sections[0]?.id || "",
+  );
+
+  useEffect(() => {
+    const valid = sections.some((section) => section.id === selectedId);
+    if (!valid) setSelectedId(fromHash || sections[0]?.id || "");
+  }, [sections, selectedId, fromHash]);
+
+  useEffect(() => {
+    if (fromHash && fromHash !== selectedId) setSelectedId(fromHash);
+  }, [fromHash]); // eslint-disable-line react-hooks/exhaustive-deps
+
+  const selected =
+    sections.find((section) => section.id === selectedId) ?? sections[0];
+
   return (
     <DocShell
       current="/help"
-      title="Help & Support"
-      subtitle="Get answers fast — watch the walkthrough, browse the common topics, check the FAQ, or reach our team directly."
+      title={help.title}
+      subtitle={help.subtitle}
+      sidebar={
+        <DocSidebar
+          heading="Topics"
+          items={sections.map((section) => ({
+            id: section.id,
+            label: section.heading,
+          }))}
+          activeId={selected?.id ?? null}
+          onSelect={(id) => {
+            setSelectedId(id);
+            navigate(`#${id}`);
+            window.scrollTo({ top: 0, behavior: "smooth" });
+          }}
+        />
+      }
     >
-      <section className="mb-12">
-        <h2 className="text-xl font-bold tracking-tight">
-          Portal walkthrough
-        </h2>
-        <p className="mt-2 leading-7 text-muted-foreground">
-          A guided tour of the portal — registering your company, raising a
-          booking against a contract, and settling an invoice.
-        </p>
-
-        {/* preload="metadata" so the 28 MB file is not pulled on every visit;
-            the browser fetches it only once playback starts. */}
-        <video
-          controls
-          preload="metadata"
-          className="mt-6 w-full rounded-[32px] border border-border bg-black"
-        >
-          <source src="/assets/edr-portal-guide.webm" type="video/webm" />
-          Your browser cannot play this video. Download it at{" "}
-          <a href="/assets/edr-portal-guide.webm">
-            /assets/edr-portal-guide.webm
-          </a>
-          .
-        </video>
-      </section>
-
-      {/* Live chat is the fastest route, so lead with it. */}
-      <div className="rounded-[32px] border border-border bg-card p-8">
-        <div className="flex items-start gap-4">
-          <div className="rounded-2xl bg-accent p-3 text-primary">
-            <MessageSquare className="size-5" />
-          </div>
-
-          <div>
-            <h2 className="text-xl font-bold tracking-tight">
-              Chat with our team
-            </h2>
-            <p className="mt-2 leading-7 text-muted-foreground">
-              Signed-in customers can open a support conversation from the
-              headset button at the bottom right of every portal page. You can
-              send screenshots and documents in the chat, and replies appear
-              there and as a notification.
-            </p>
-            <Link
-              to="/portal"
-              className="mt-6 inline-flex rounded-2xl bg-primary px-6 py-3 font-semibold text-primary-foreground transition hover:opacity-90"
-            >
-              Open the portal
-            </Link>
-          </div>
-        </div>
-      </div>
-
-      <section className="mt-12">
-        <h2 className="text-xl font-bold tracking-tight">Contact us</h2>
-
-        <div className="mt-4 grid gap-4 sm:grid-cols-2">
-          {channels.map((channel) => (
-            <div
-              key={channel.title}
-              className="flex items-start gap-4 rounded-2xl border border-border bg-background p-5"
-            >
-              <div className="rounded-2xl bg-accent p-3 text-primary">
-                <channel.icon className="size-5" />
-              </div>
-
-              <div>
-                <p className="font-semibold">{channel.title}</p>
-                {channel.href ? (
-                  <a
-                    href={channel.href}
-                    className="text-muted-foreground transition-colors hover:text-primary"
-                  >
-                    {channel.value}
-                  </a>
-                ) : (
-                  <p className="text-muted-foreground">{channel.value}</p>
-                )}
-                <p className="mt-1 text-sm text-muted-foreground">
-                  {channel.note}
-                </p>
-              </div>
-            </div>
-          ))}
-        </div>
-      </section>
-
-      <section className="mt-12">
-        <h2 className="text-xl font-bold tracking-tight">Common topics</h2>
-
-        <div className="mt-4 grid gap-4 sm:grid-cols-2">
-          {topics.map((topic) => (
-            <Link
-              key={topic.title}
-              to="/faq"
-              className="rounded-2xl border border-border bg-background p-5 transition hover:border-primary/40"
-            >
-              <div className="inline-flex rounded-2xl bg-accent p-3 text-primary">
-                <topic.icon className="size-5" />
-              </div>
-              <p className="mt-4 font-semibold">{topic.title}</p>
-              <p className="mt-1 leading-7 text-muted-foreground">
-                {topic.body}
-              </p>
-            </Link>
-          ))}
-        </div>
-      </section>
-
-      <section className="mt-12 rounded-[32px] border border-border bg-card p-8">
-        <div className="flex items-start gap-4">
-          <div className="rounded-2xl bg-accent p-3 text-primary">
-            <HelpCircle className="size-5" />
-          </div>
-
-          <div>
-            <h2 className="text-xl font-bold tracking-tight">
-              What to include when you contact us
-            </h2>
-            <ul className="mt-3 list-disc space-y-2 pl-5 leading-7 text-muted-foreground">
-              <li>Your company name and the email you sign in with.</li>
-              <li>
-                The reference of the contract, booking or invoice involved.
-              </li>
-              <li>What you expected to happen and what happened instead.</li>
-              <li>A screenshot of any error message the portal showed.</li>
-            </ul>
-          </div>
-        </div>
-      </section>
+      {selected && (
+        <section>
+          <h2 className="text-2xl font-bold tracking-tight">
+            {selected.heading}
+          </h2>
+          <Markdown>{selected.body}</Markdown>
+        </section>
+      )}
     </DocShell>
   );
 }
diff --git a/apps/edr-freight-web/portal/src/pages/support/Markdown.tsx b/apps/edr-freight-web/portal/src/pages/support/Markdown.tsx
new file mode 100644
index 000000000..646187f6c
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/support/Markdown.tsx
@@ -0,0 +1,115 @@
+import { isPortalVideoSrc } from "@edr/types";
+import ReactMarkdown from "react-markdown";
+
+import { safeMediaSrc } from "./portal-content";
+
+/**
+ * Renders admin-authored markdown from the support-content API.
+ *
+ * Deliberately plain `react-markdown`: it builds React elements directly, so
+ * unlike a markdown→HTML-string library it needs no `dangerouslySetInnerHTML`
+ * and no sanitizer, and the portal keeps its zero HTML-injection surface.
+ *
+ * Two things must stay absent for that to hold:
+ *   - `rehype-raw`, which would start rendering raw HTML embedded in the copy;
+ *   - a custom `urlTransform`, which would override the built-in stripping of
+ *     `javascript:` and `data:` hrefs. That transform is now the *only* thing
+ *     vetting embedded media URLs, since they are authored inside the markdown
+ *     rather than validated field-by-field on the API.
+ *
+ * `remark-gfm` is also left out: tables and strikethrough are not used in the
+ * legal or FAQ copy, and CommonMark already covers lists, emphasis and links.
+ *
+ * The component map reproduces the Tailwind classes the pages used when this
+ * copy was hardcoded, so switching to markdown changed nothing visually.
+ */
+export function Markdown({ children }: { children: string }) {
+  return (
+    <ReactMarkdown
+      components={{
+        p: ({ children: content }) => (
+          <p className="mt-4 leading-7 text-muted-foreground">{content}</p>
+        ),
+        ul: ({ children: content }) => (
+          <ul className="mt-4 list-disc space-y-2 pl-5 leading-7 text-muted-foreground">
+            {content}
+          </ul>
+        ),
+        ol: ({ children: content }) => (
+          <ol className="mt-4 list-decimal space-y-2 pl-5 leading-7 text-muted-foreground">
+            {content}
+          </ol>
+        ),
+        li: ({ children: content }) => <li>{content}</li>,
+        a: ({ href, children: content }) => (
+          <a
+            href={href}
+            className="font-semibold text-foreground transition-colors hover:text-primary"
+          >
+            {content}
+          </a>
+        ),
+        strong: ({ children: content }) => (
+          <strong className="font-semibold text-foreground">{content}</strong>
+        ),
+        em: ({ children: content }) => <em className="italic">{content}</em>,
+        h3: ({ children: content }) => (
+          <h3 className="mt-6 font-bold tracking-tight">{content}</h3>
+        ),
+        /**
+         * Images *and* videos: both are written with markdown's image syntax,
+         * and the element is chosen from the file extension. `src` here has
+         * already been through react-markdown's url transform; `safeMediaSrc`
+         * narrows it further to same-origin paths and https.
+         */
+        img: ({ src, alt }) => {
+          const resolved =
+            typeof src === "string" ? safeMediaSrc(src) : null;
+          if (!resolved) return null;
+
+          // Spans, not <figure>/<figcaption>: markdown wraps an image in a
+          // paragraph, and a <figure> inside a <p> is invalid HTML that the
+          // browser silently re-parents, which drops sibling content.
+          const caption = alt ? (
+            <span className="mt-2 block text-sm text-muted-foreground">
+              {alt}
+            </span>
+          ) : null;
+
+          if (isPortalVideoSrc(resolved)) {
+            return (
+              <span className="mt-6 block">
+                {/* preload="metadata" so a large file is not pulled on every
+                    visit; the browser fetches it once playback starts. */}
+                <video
+                  controls
+                  preload="metadata"
+                  className="w-full rounded-[32px] border border-border bg-black"
+                >
+                  <source src={resolved} />
+                </video>
+                {caption}
+              </span>
+            );
+          }
+
+          return (
+            <span className="mt-6 block">
+              <img
+                src={resolved}
+                alt={alt ?? ""}
+                loading="lazy"
+                className="w-full rounded-[32px] border border-border"
+              />
+              {caption}
+            </span>
+          );
+        },
+      }}
+    >
+      {children}
+    </ReactMarkdown>
+  );
+}
+
+export default Markdown;
diff --git a/apps/edr-freight-web/portal/src/pages/support/PrivacyPolicyPage.tsx b/apps/edr-freight-web/portal/src/pages/support/PrivacyPolicyPage.tsx
index 76c2441ae..a924d6514 100644
--- a/apps/edr-freight-web/portal/src/pages/support/PrivacyPolicyPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/support/PrivacyPolicyPage.tsx
@@ -1,15 +1,33 @@
+import { usePortalContent } from "@/hooks/usePortalContent";
+
 import { DocSections, DocShell } from "./DocShell";
-import { LEGAL_LAST_UPDATED, PRIVACY_SECTIONS } from "./content";
+import { DocSidebar, useActiveSection } from "./DocSidebar";
 
 export default function PrivacyPolicyPage() {
+  // Never undefined — see TermsPage.
+  const { data } = usePortalContent();
+  const privacy = data!.privacy;
+  const sections = privacy.sections ?? [];
+
+  const activeId = useActiveSection(sections.map((section) => section.id));
+
   return (
     <DocShell
       current="/privacy"
-      title="Privacy Policy"
-      subtitle="How EDR Freight collects, uses, shares and protects the information you provide when you use the platform."
-      meta={`Last updated ${LEGAL_LAST_UPDATED}`}
+      title={privacy.title}
+      subtitle={privacy.subtitle}
+      meta={`Last updated ${privacy.lastUpdated}`}
+      sidebar={
+        <DocSidebar
+          items={sections.map((section) => ({
+            id: section.id,
+            label: section.heading,
+          }))}
+          activeId={activeId}
+        />
+      }
     >
-      <DocSections sections={PRIVACY_SECTIONS} />
+      <DocSections sections={sections} />
     </DocShell>
   );
 }
diff --git a/apps/edr-freight-web/portal/src/pages/support/TermsPage.tsx b/apps/edr-freight-web/portal/src/pages/support/TermsPage.tsx
index b095acae0..671882ff1 100644
--- a/apps/edr-freight-web/portal/src/pages/support/TermsPage.tsx
+++ b/apps/edr-freight-web/portal/src/pages/support/TermsPage.tsx
@@ -1,15 +1,36 @@
+import { usePortalContent } from "@/hooks/usePortalContent";
+
 import { DocSections, DocShell } from "./DocShell";
-import { LEGAL_LAST_UPDATED, TERMS_SECTIONS } from "./content";
+import { DocSidebar, useActiveSection } from "./DocSidebar";
 
 export default function TermsPage() {
+  // Never undefined — the hook seeds it with the shipped copy, so this public
+  // page renders instantly and survives the API being unreachable.
+  const { data } = usePortalContent();
+  const terms = data!.terms;
+  const sections = terms.sections ?? [];
+
+  // A contents list, not a pager: the whole document stays on one page so it
+  // can be searched, printed and deep-linked to a clause.
+  const activeId = useActiveSection(sections.map((section) => section.id));
+
   return (
     <DocShell
       current="/terms"
-      title="Terms of Service"
-      subtitle="The terms on which EDR provides the EDR Freight platform and the freight services you request through it."
-      meta={`Last updated ${LEGAL_LAST_UPDATED}`}
+      title={terms.title}
+      subtitle={terms.subtitle}
+      meta={`Last updated ${terms.lastUpdated}`}
+      sidebar={
+        <DocSidebar
+          items={sections.map((section) => ({
+            id: section.id,
+            label: section.heading,
+          }))}
+          activeId={activeId}
+        />
+      }
     >
-      <DocSections sections={TERMS_SECTIONS} />
+      <DocSections sections={sections} />
     </DocShell>
   );
 }
diff --git a/apps/edr-freight-web/portal/src/pages/support/content.ts b/apps/edr-freight-web/portal/src/pages/support/content.ts
deleted file mode 100644
index d7b8e2d2c..000000000
--- a/apps/edr-freight-web/portal/src/pages/support/content.ts
+++ /dev/null
@@ -1,358 +0,0 @@
-/**
- * Copy for the public help/FAQ/legal pages. Kept as data so the pages stay
- * thin — the shell in `DocShell.tsx` renders any `Section[]` the same way.
- *
- * The privacy and terms text is the platform's working draft; legal counsel
- * signs off on the final wording, and `LEGAL_LAST_UPDATED` is bumped with it.
- */
-
-export const SUPPORT_CONTACT = {
-  email: "support@edrfreight.com",
-  phone: "+251 11 000 0000",
-  office: "Addis Ababa, Ethiopia",
-  hours: "Monday – Saturday, 8:30 AM – 5:30 PM (EAT)",
-};
-
-export const LEGAL_LAST_UPDATED = "6 August 2026";
-
-export interface Section {
-  heading: string;
-  /** Paragraphs, rendered in order. */
-  body?: string[];
-  /** Optional bullet list, rendered after the paragraphs. */
-  bullets?: string[];
-}
-
-export interface FaqItem {
-  question: string;
-  answer: string;
-}
-
-export interface FaqGroup {
-  title: string;
-  items: FaqItem[];
-}
-
-export const FAQ_GROUPS: FaqGroup[] = [
-  {
-    title: "Getting started",
-    items: [
-      {
-        question: "How do I open an account on EDR Freight?",
-        answer:
-          "Sign up with your work email and verify the one-time code we send you. After you set a password, the onboarding wizard collects your company details, trade licence, TIN certificate and the operational services you need (importer, exporter, freight forwarder or transporter). Submit the wizard and our team reviews the application.",
-      },
-      {
-        question: "How long does account approval take?",
-        answer:
-          "Most complete applications are reviewed within two working days. You will see the status on your dashboard, and we email you when a profile is approved or when a document needs to be re-uploaded.",
-      },
-      {
-        question: "My profile was rejected. What now?",
-        answer:
-          "The rejection notice states the reason. Open Settings, correct the details or replace the document that was flagged, and re-apply — you do not need to create a new account.",
-      },
-      {
-        question: "Can one company hold several operational services?",
-        answer:
-          "Yes. A company can hold importer, exporter, freight forwarder and transporter profiles at the same time. Each is approved separately, and the header lets you switch between the ones you hold.",
-      },
-    ],
-  },
-  {
-    title: "Contracts and bookings",
-    items: [
-      {
-        question: "What is the difference between a contract and a booking?",
-        answer:
-          "A contract is the commercial agreement covering a cargo movement — route, commodity, volume and rates. A booking is a single shipment executed under that contract. You create the contract once, then raise bookings against it for each consignment.",
-      },
-      {
-        question: "How do I create a booking?",
-        answer:
-          "Open the contract from the Contracts list and choose New Booking. Provide the consignment details, containers or tonnage, and the last-mile requirement if you need one. Bookings can also be started from the Bookings page, which routes you through contract selection first.",
-      },
-      {
-        question: "Why do I have to sign a contract before shipping?",
-        answer:
-          "The contract document is the binding agreement for the movement. You must scroll to the end, accept the terms, and sign it with your saved signature and stamp before EDR schedules any wagon against it.",
-      },
-      {
-        question: "Where do I set up my signature and stamp?",
-        answer:
-          "Under Signature & Stamp in the portal. It is saved once and reused for every contract you sign, so you do not have to upload it per document.",
-      },
-      {
-        question: "Can I change a booking after submitting it?",
-        answer:
-          "You can edit a booking while it is still pending review. Once EDR has confirmed it and allocated capacity, changes go through our operations team — contact support with the booking reference.",
-      },
-      {
-        question: "How do I track a consignment?",
-        answer:
-          "Open the booking and use the tracking panel, which shows the current milestone, the wagon or container assigned, and the timestamps recorded at each corridor point.",
-      },
-    ],
-  },
-  {
-    title: "Invoices and payments",
-    items: [
-      {
-        question: "Where do I find my invoices?",
-        answer:
-          "The Invoices page lists every invoice raised against your company, with its status, due date and outstanding balance. Open any invoice to see its line items and download a PDF copy.",
-      },
-      {
-        question: "Which payment methods are supported?",
-        answer:
-          "Payments are made through the integrated bank channels shown at checkout. After you complete the payment on the bank's page you are returned to the portal, and the invoice status updates once the bank confirms the transaction.",
-      },
-      {
-        question: "My payment was deducted but the invoice still shows unpaid.",
-        answer:
-          "Bank confirmations can lag by a few minutes. Use the Check Payment Status page linked from your receipt; if it still has not settled after an hour, email support with the invoice number and the bank reference and we will reconcile it.",
-      },
-      {
-        question: "Why is my invoice amount rounded?",
-        answer:
-          "Some bank channels only accept whole-birr amounts, so invoices routed through them are rounded up to the nearest birr. The rounding is shown on the invoice detail page.",
-      },
-    ],
-  },
-  {
-    title: "Account and security",
-    items: [
-      {
-        question: "How do I reset my password?",
-        answer:
-          "Use Forgot Password on the sign-in page. We email you a reset link that is valid for a limited time. If a member of our staff issued the link, it works the same way even if you are already signed in.",
-      },
-      {
-        question: "Can I add colleagues to my company account?",
-        answer:
-          "Yes. Company administrators can invite additional users from Settings. Each user signs in with their own credentials, and actions are recorded against the individual who performed them.",
-      },
-      {
-        question: "How do I update company details after approval?",
-        answer:
-          "Edit them in Settings. Changes to regulated fields — trade licence, TIN, legal name — are re-verified by our team before they take effect.",
-      },
-    ],
-  },
-];
-
-export const PRIVACY_SECTIONS: Section[] = [
-  {
-    heading: "1. Introduction",
-    body: [
-      "The Ethio-Djibouti Standard Gauge Rail Share Company (\"EDR\", \"we\", \"us\") operates the EDR Freight platform, which lets customers register their business, agree freight contracts, raise bookings, track consignments and settle invoices online.",
-      "This policy explains what personal and business information we collect through the platform, why we collect it, how long we keep it and what rights you have over it. It applies to the EDR Freight customer portal and the services reached through it.",
-    ],
-  },
-  {
-    heading: "2. Information we collect",
-    body: [
-      "We collect information you give us, information generated by your use of the platform, and information we receive from the regulators and financial institutions we work with.",
-    ],
-    bullets: [
-      "Account details — name, work email address, phone number and the credentials used to sign in.",
-      "Company and compliance records — legal name, trade licence, TIN certificate, VAT registration, ownership and manager details, and the operational services you apply for.",
-      "Identity verification data — where you verify through a national identity service, the verification result and the attributes that service returns to us.",
-      "Operational data — contracts, bookings, consignment and cargo details, container and wagon assignments, tracking events and delivery confirmations.",
-      "Financial data — invoices, payment references, transaction status and settlement confirmations received from banks. We do not store your card numbers or online banking credentials.",
-      "Support data — the messages and files you send us through the in-app support chat or by email.",
-      "Technical data — IP address, device and browser information, and event logs generated when you use the platform.",
-    ],
-  },
-  {
-    heading: "3. How we use your information",
-    bullets: [
-      "To create and administer your account and verify that your company is entitled to the services it applies for.",
-      "To perform the freight contracts and bookings you place, including allocating capacity and coordinating rail and last-mile movements.",
-      "To issue invoices, process payments and keep the accounting records the law requires us to keep.",
-      "To provide customer support and respond to the questions and complaints you raise.",
-      "To keep the platform secure, detect misuse and investigate incidents.",
-      "To meet our legal, tax, customs and regulatory obligations in Ethiopia and Djibouti.",
-      "To improve the platform — measuring which features are used and where users encounter errors, using aggregated and pseudonymised data wherever that is sufficient.",
-    ],
-  },
-  {
-    heading: "4. Legal basis for processing",
-    body: [
-      "We process your information because it is necessary to perform the contract between you and EDR, because we have a legal obligation to do so (customs, tax and transport regulation), or because we have a legitimate interest in operating and securing the platform. Where we rely on your consent — for example, optional marketing messages — you can withdraw it at any time.",
-    ],
-  },
-  {
-    heading: "5. Sharing your information",
-    body: [
-      "We do not sell your information. We share it only where it is necessary to deliver the service or where the law requires it.",
-    ],
-    bullets: [
-      "Government and regulatory bodies — customs, revenue and transport authorities in Ethiopia and Djibouti, to the extent required for the movement of your cargo.",
-      "Ports, terminals and last-mile transporters involved in executing your bookings.",
-      "Banks and payment providers, to initiate and reconcile the payments you make.",
-      "Technology suppliers who host and maintain the platform on our behalf, under contracts that restrict them to processing data on our instructions.",
-      "Courts, law enforcement and other authorities where we are legally compelled to disclose.",
-    ],
-  },
-  {
-    heading: "6. International transfers",
-    body: [
-      "Cross-border freight inherently involves parties in more than one country, so consignment and clearance information is shared with counterparties and authorities in Djibouti as well as Ethiopia. Where we transfer information outside Ethiopia, we do so only as far as the movement requires or the law permits, and we require recipients to protect it to a comparable standard.",
-    ],
-  },
-  {
-    heading: "7. Data retention",
-    body: [
-      "We keep account and company records for as long as your account is active. Contract, booking, customs and financial records are kept for the period required by Ethiopian commercial, tax and customs law after the relevant transaction, because we are obliged to be able to produce them. Support conversations and technical logs are kept for a shorter period, sufficient to resolve disputes and investigate security incidents.",
-    ],
-  },
-  {
-    heading: "8. Security",
-    body: [
-      "Access to the platform requires authentication, and staff access to customer records is limited to what each role needs. Data is transmitted over encrypted connections and stored on systems protected by access controls and logging. No system is perfectly secure, so please keep your credentials confidential and tell us immediately if you believe your account has been compromised.",
-    ],
-  },
-  {
-    heading: "9. Your rights",
-    body: [
-      "Subject to Ethiopian law, you may ask us to give you a copy of the personal information we hold about you, correct it if it is inaccurate, restrict or object to certain processing, or delete it where we are not required to keep it. Requests are handled through the contact details below; we may need to verify your identity before acting.",
-    ],
-  },
-  {
-    heading: "10. Cookies and similar technologies",
-    body: [
-      "The platform uses cookies and browser storage to keep you signed in, remember your interface preferences and measure how the product is used so we can fix problems. Essential cookies cannot be turned off without breaking sign-in. You can clear or block the rest through your browser settings.",
-    ],
-  },
-  {
-    heading: "11. Children",
-    body: [
-      "The platform is a business service and is not directed at children. We do not knowingly collect information from anyone under 18.",
-    ],
-  },
-  {
-    heading: "12. Changes to this policy",
-    body: [
-      "We may update this policy as the platform and the law change. Material changes are announced in the portal before they take effect, and the date at the top of this page always reflects the current version.",
-    ],
-  },
-  {
-    heading: "13. Contact us",
-    body: [
-      `Questions about this policy or about how we handle your information can be sent to ${SUPPORT_CONTACT.email}, called in on ${SUPPORT_CONTACT.phone}, or addressed to our head office in ${SUPPORT_CONTACT.office}.`,
-    ],
-  },
-];
-
-export const TERMS_SECTIONS: Section[] = [
-  {
-    heading: "1. These terms",
-    body: [
-      "These terms govern your use of the EDR Freight platform operated by the Ethio-Djibouti Standard Gauge Rail Share Company (\"EDR\"). By creating an account or using the platform, the company you represent agrees to them.",
-      "The platform is the channel through which you register, request and manage freight services. The commercial terms of each movement — routes, rates, volumes and payment terms — are set out in the freight contract you sign in the platform. Where a signed contract and these terms conflict, the signed contract governs that movement.",
-    ],
-  },
-  {
-    heading: "2. Eligibility and accounts",
-    bullets: [
-      "The platform is for registered businesses. You confirm that you are authorised to act for the company you register and to bind it to these terms.",
-      "The information and documents you submit — trade licence, TIN, VAT registration, ownership details — must be accurate, current and genuine.",
-      "Accounts and operational profiles are activated only after EDR has reviewed and approved them, and approval may be refused or withdrawn.",
-      "You are responsible for keeping credentials confidential and for everything done under your account. Tell us at once if you suspect unauthorised use.",
-    ],
-  },
-  {
-    heading: "3. Contracts and bookings",
-    bullets: [
-      "A freight contract takes effect when it is signed in the platform by you and countersigned by EDR.",
-      "A booking is a request for a specific movement under a contract. It becomes binding when EDR confirms it and allocates capacity — submission alone does not reserve a wagon or container.",
-      "You are responsible for the accuracy of consignment data: commodity description, weight, dimensions, container numbers, hazardous classification and consignee details.",
-      "Capacity is finite. EDR may decline, defer or reschedule a booking where capacity, safety, operating conditions or regulatory direction require it.",
-    ],
-  },
-  {
-    heading: "4. Cargo, documents and compliance",
-    bullets: [
-      "You must obtain and provide every permit, customs declaration and clearance document the movement requires, and you warrant that the cargo may lawfully be carried.",
-      "Prohibited and restricted goods may not be tendered without EDR's prior written agreement and any licence the law requires.",
-      "Cargo must be packed, secured and, where applicable, labelled to the standard the mode of carriage requires. EDR may inspect, refuse or offload cargo that is misdeclared or unsafe.",
-      "You are liable for fines, demurrage, storage charges and losses arising from misdeclared cargo, missing documents or delays attributable to you.",
-    ],
-  },
-  {
-    heading: "5. Rates, invoicing and payment",
-    bullets: [
-      "Charges are calculated from the rates in your contract, the tariffs published in the platform, and any accessorial services actually rendered.",
-      "Invoices are issued in the platform and are payable by the due date shown on them, through the payment channels the platform offers.",
-      "Payment is confirmed when the funds are confirmed by the bank, not when payment is initiated.",
-      "Overdue amounts may attract interest and may result in suspension of new bookings or of the account until the balance is cleared.",
-      "Taxes and statutory duties are your responsibility unless the contract expressly says otherwise.",
-    ],
-  },
-  {
-    heading: "6. Delivery, delay and liability",
-    body: [
-      "Transit times shown in the platform are estimates based on planned schedules. They are not guarantees, and EDR is not liable for indirect or consequential loss, loss of profit or loss of market arising from delay.",
-      "EDR's liability for loss of or damage to cargo is limited to the extent set out in the applicable freight contract and in the transport law governing the carriage. Claims must be notified in writing within the period the contract specifies; late claims may be rejected.",
-      "Neither party is liable for failure to perform caused by events beyond its reasonable control, including natural disasters, industrial action, civil unrest, infrastructure failure, or acts of government and regulatory authorities.",
-    ],
-  },
-  {
-    heading: "7. Acceptable use of the platform",
-    bullets: [
-      "Use the platform only for its intended purpose and in accordance with applicable law.",
-      "Do not attempt to gain unauthorised access, probe or disrupt the service, or interfere with other customers' data.",
-      "Do not scrape, resell or redistribute platform content, rates or data without written permission.",
-      "Do not upload malware or content that infringes the rights of others.",
-    ],
-  },
-  {
-    heading: "8. Electronic signatures and records",
-    body: [
-      "You agree that contracts signed in the platform using your stored signature and stamp are validly executed, that the records the platform keeps of those signatures are admissible evidence of them, and that they carry the same effect as signatures on paper.",
-    ],
-  },
-  {
-    heading: "9. Availability and changes to the service",
-    body: [
-      "We aim to keep the platform available, but it may be interrupted for maintenance, upgrades or reasons outside our control. We may add, change or withdraw features. Where a change materially affects how you use the platform, we will give reasonable notice in the portal.",
-    ],
-  },
-  {
-    heading: "10. Suspension and termination",
-    body: [
-      "We may suspend or terminate access where these terms are breached, where documents prove to be false, where amounts remain unpaid, or where the law or a regulator requires it. You may stop using the platform at any time. Termination does not affect obligations already incurred — cargo in transit, invoices outstanding, or records we are required to retain.",
-    ],
-  },
-  {
-    heading: "11. Intellectual property",
-    body: [
-      "The platform, its software, design and content belong to EDR or its licensors. You are granted a non-exclusive, non-transferable right to use it for your own freight operations. Your commercial and consignment data remains yours; you grant us the right to process it as needed to deliver the service and as described in the Privacy Policy.",
-    ],
-  },
-  {
-    heading: "12. Confidentiality and data protection",
-    body: [
-      "Each party will keep the other's non-public commercial information confidential and use it only for the purposes of the services. Our handling of personal information is described in the Privacy Policy, which forms part of these terms.",
-    ],
-  },
-  {
-    heading: "13. Governing law and disputes",
-    body: [
-      "These terms are governed by the laws of the Federal Democratic Republic of Ethiopia. The parties will first attempt to resolve any dispute amicably; failing that, the dispute is subject to the jurisdiction of the competent courts of Ethiopia, without prejudice to any arbitration clause agreed in a specific freight contract.",
-    ],
-  },
-  {
-    heading: "14. Changes to these terms",
-    body: [
-      "We may update these terms as the service and the law change. Updates are published here and announced in the portal. Continuing to use the platform after an update takes effect means you accept the revised terms.",
-    ],
-  },
-  {
-    heading: "15. Contact",
-    body: [
-      `For questions about these terms, write to ${SUPPORT_CONTACT.email} or call ${SUPPORT_CONTACT.phone}.`,
-    ],
-  },
-];
diff --git a/apps/edr-freight-web/portal/src/pages/support/portal-content.test.ts b/apps/edr-freight-web/portal/src/pages/support/portal-content.test.ts
new file mode 100644
index 000000000..07b2c09b6
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/support/portal-content.test.ts
@@ -0,0 +1,89 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  applyPortalVars,
+  FALLBACK_PORTAL_CONTENT,
+  safeMediaSrc,
+  withSupportVars,
+} from "./portal-content";
+
+const contact = {
+  email: "support@edrfreight.com",
+  phone: "+251 11 000 0000",
+  office: "Addis Ababa, Ethiopia",
+  hours: "Monday – Saturday, 8:30 AM – 5:30 PM (EAT)",
+};
+
+describe("applyPortalVars", () => {
+  it("substitutes every known token", () => {
+    expect(
+      applyPortalVars(
+        "Mail {{supportEmail}}, call {{supportPhone}}, visit {{supportOffice}}, open {{supportHours}}.",
+        contact,
+      ),
+    ).toBe(
+      "Mail support@edrfreight.com, call +251 11 000 0000, visit Addis Ababa, Ethiopia, open Monday – Saturday, 8:30 AM – 5:30 PM (EAT).",
+    );
+  });
+
+  it("strips spacing for the tel: variant", () => {
+    expect(applyPortalVars("tel:{{supportPhoneTel}}", contact)).toBe(
+      "tel:+251110000000",
+    );
+  });
+
+  it("leaves an unknown token verbatim so the typo is visible", () => {
+    expect(applyPortalVars("Mail {{supportEmial}}.", contact)).toBe(
+      "Mail {{supportEmial}}.",
+    );
+  });
+
+  it("does not let $& in a contact value corrupt the output", () => {
+    // Guards the replace-callback choice: with a replacement *string*, `$&`
+    // would expand to the matched token and the address would come out wrong.
+    expect(
+      applyPortalVars("Write to {{supportOffice}}.", {
+        ...contact,
+        office: "Bole $& Road",
+      }),
+    ).toBe("Write to Bole $& Road.");
+  });
+});
+
+describe("withSupportVars", () => {
+  it("resolves placeholders buried in the shipped legal copy", () => {
+    const resolved = withSupportVars(FALLBACK_PORTAL_CONTENT);
+    const contactSection = resolved.privacy.sections.at(-1)!;
+
+    expect(contactSection.body).toContain(contact.email);
+    expect(contactSection.body).not.toContain("{{");
+  });
+
+  it("leaves the contact block itself alone — it is the substitution source", () => {
+    expect(withSupportVars(FALLBACK_PORTAL_CONTENT).contact).toEqual(
+      FALLBACK_PORTAL_CONTENT.contact,
+    );
+  });
+});
+
+describe("safeMediaSrc", () => {
+  it("keeps same-origin paths and http(s) sources", () => {
+    expect(safeMediaSrc("/assets/guide.webm")).toBe("/assets/guide.webm");
+    expect(safeMediaSrc("https://minio.internal/support-content/a.png?sig=x")).toBe(
+      "https://minio.internal/support-content/a.png?sig=x",
+    );
+    // Signed object-store URLs are plain http in dev — rejecting them hid
+    // every upload.
+    expect(safeMediaSrc("http://localhost:9000/fhc/support-content/a.mp4")).toBe(
+      "http://localhost:9000/fhc/support-content/a.mp4",
+    );
+  });
+
+  it("drops javascript: and protocol-relative sources", () => {
+    expect(safeMediaSrc("javascript:alert(1)")).toBeNull();
+    expect(safeMediaSrc("//evil.example.com/g.webm")).toBeNull();
+    // A bare object key means the API failed to sign it — render nothing
+    // rather than a broken relative URL.
+    expect(safeMediaSrc("support-content/a.png")).toBeNull();
+  });
+});
diff --git a/apps/edr-freight-web/portal/src/pages/support/portal-content.ts b/apps/edr-freight-web/portal/src/pages/support/portal-content.ts
new file mode 100644
index 000000000..66c5910f8
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/pages/support/portal-content.ts
@@ -0,0 +1,106 @@
+import {
+  SUPPORT_CONTENT_DEFAULTS,
+  type PortalContentBundle,
+  type PortalContentVar,
+  type PortalSupportContact,
+} from "@edr/types";
+
+/**
+ * Copy for the public help/FAQ/legal pages now lives in the database and is
+ * edited from the backoffice. This module holds what is left in the app: the
+ * shipped copy as a fallback, and the two pure helpers the pages need.
+ *
+ * The fallback matters because these four routes are public and linked from
+ * the sign-up screen — they are often the first thing an anonymous visitor
+ * sees. Rendering the shipped text while the request is in flight (or if the
+ * API is down) beats showing them a spinner or an error card, and it is why
+ * none of the four pages carry loading or error branches.
+ */
+export const FALLBACK_PORTAL_CONTENT: PortalContentBundle = {
+  contact: SUPPORT_CONTENT_DEFAULTS.CONTACT,
+  help: SUPPORT_CONTENT_DEFAULTS.HELP,
+  faq: SUPPORT_CONTENT_DEFAULTS.FAQ,
+  privacy: SUPPORT_CONTENT_DEFAULTS.PRIVACY,
+  terms: SUPPORT_CONTENT_DEFAULTS.TERMS,
+};
+
+const VAR_PATTERN =
+  /\{\{(supportEmail|supportPhone|supportPhoneTel|supportOffice|supportHours)\}\}/g;
+
+function resolveVar(name: PortalContentVar, contact: PortalSupportContact) {
+  switch (name) {
+    case "supportEmail":
+      return contact.email;
+    case "supportPhone":
+      return contact.phone;
+    case "supportPhoneTel":
+      // tel: hrefs must not carry the display spacing.
+      return contact.phone.replace(/\s/g, "");
+    case "supportOffice":
+      return contact.office;
+    case "supportHours":
+      return contact.hours;
+  }
+}
+
+/**
+ * Substitutes `{{supportEmail}}`-style placeholders against the editable
+ * contact block. The support address used to be interpolated into the privacy
+ * and terms prose at build time, which meant editing it would have left those
+ * paragraphs quoting a stale one.
+ *
+ * Uses a replacement *callback* on purpose: with a replacement string, a `$&`
+ * or `$1` inside an admin-typed office address would be treated as a
+ * backreference and corrupt the output.
+ *
+ * Unknown tokens are left verbatim — the pattern only matches the four known
+ * names — so a typo shows up as `{{supportEmial}}` rather than a blank.
+ */
+export function applyPortalVars(
+  text: string,
+  contact: PortalSupportContact,
+): string {
+  return text.replace(VAR_PATTERN, (_match, name: PortalContentVar) =>
+    resolveVar(name, contact),
+  );
+}
+
+/**
+ * Applies {@link applyPortalVars} to every string in the bundle except the
+ * contact block itself, which is the substitution source. Walking the whole
+ * object means a placeholder works in any field, including ones added later.
+ */
+export function withSupportVars(
+  bundle: PortalContentBundle,
+): PortalContentBundle {
+  const { contact, ...rest } = bundle;
+
+  const walk = (value: unknown): unknown => {
+    if (typeof value === "string") return applyPortalVars(value, contact);
+    if (Array.isArray(value)) return value.map(walk);
+    if (value && typeof value === "object") {
+      return Object.fromEntries(
+        Object.entries(value).map(([key, inner]) => [key, walk(inner)]),
+      );
+    }
+    return value;
+  };
+
+  return { contact, ...(walk(rest) as Omit<PortalContentBundle, "contact">) };
+}
+
+/**
+ * Accepts a same-origin path or an http(s) URL for an attached image or video,
+ * returning null for anything else so the caller renders nothing.
+ *
+ * The point is to exclude `javascript:` and `data:`, not to require TLS: the
+ * signed MinIO URLs the API hands back are plain http wherever the object
+ * store is (dev, and any deployment terminating TLS elsewhere), and rejecting
+ * those made every uploaded picture and video vanish from the page.
+ *
+ * `(?!\/)` still rejects protocol-relative `//host/...`, which would otherwise
+ * pass as a path.
+ */
+export function safeMediaSrc(src: string): string | null {
+  return /^(https?:\/\/|\/(?!\/))/.test(src) ? src : null;
+}
diff --git a/apps/edr-freight-web/portal/src/services/api.ts b/apps/edr-freight-web/portal/src/services/api.ts
index 0d0035b87..2f633a06b 100644
--- a/apps/edr-freight-web/portal/src/services/api.ts
+++ b/apps/edr-freight-web/portal/src/services/api.ts
@@ -56,6 +56,7 @@ import {
   UpdateDropdownSettingDto,
 } from "@/types/dropdownSettings";
 import type {
+  AccountInfoResponse,
   ChangeRequestResponse,
   CompanyDocument,
   CompanyInfoResponse,
@@ -188,7 +189,7 @@ export const api = {
   },
 
   companies: {
-    getInfo: endpoint<void, CompanyInfoResponse | null>(
+    getInfo: endpoint<void, AccountInfoResponse | null>(
       "companies",
       "getInfo",
       companiesService.getInfo,
@@ -238,10 +239,20 @@ export const api = {
         companyType: string;
         roles: ProfileTypeValue[];
         nationality?: CompanyNationality;
+        /** No business licence: registration typed, no eTrade lookup, no forwarding. */
+        cooperative?: boolean;
+        /** Foreign investment licence: registration typed, no eTrade lookup. */
+        investorLicence?: boolean;
       },
       CompanyInfoResponse
     >("companies", "startOnboarding", companiesService.startOnboarding),
 
+    revertToRegularCompany: endpoint<void, CompanyInfoResponse>(
+      "companies",
+      "revertToRegularCompany",
+      companiesService.revertToRegularCompany,
+    ),
+
     setOnboardingStep: endpoint<{ step: string }, void>(
       "companies",
       "setOnboardingStep",
diff --git a/apps/edr-freight-web/portal/src/services/bookings.service.ts b/apps/edr-freight-web/portal/src/services/bookings.service.ts
index cad07b0c6..840251729 100644
--- a/apps/edr-freight-web/portal/src/services/bookings.service.ts
+++ b/apps/edr-freight-web/portal/src/services/bookings.service.ts
@@ -77,6 +77,8 @@ export interface MyBookingWindow {
   scheduleId: string;
   /** Train schedule reference (e.g. TS-2026-000123), shown on the window card. */
   reference: string | null;
+  /** Operational run number (e.g. 8001 import / 8002 export), when staff set one. */
+  trainNumber: string | null;
   /**
    * The customer's active contract on this lane, when they hold one — enables
    * "Book now" to target it. Null for lanes they have no contract on.
@@ -180,6 +182,8 @@ export interface BookingListFilter {
   bookingType?: string;
   /** CONTAINER or BULK. */
   freightType?: string;
+  /** Service type (rule-engine service_types.id). */
+  serviceTypeId?: string;
   /** IMPORT / EXPORT / DOMESTIC. */
   tradeDirection?: string;
   /** Narrow to a single operational profile (importer/exporter/freight_forwarder). */
diff --git a/apps/edr-freight-web/portal/src/services/companies.service.ts b/apps/edr-freight-web/portal/src/services/companies.service.ts
index 5fba278dd..4a6c3139e 100644
--- a/apps/edr-freight-web/portal/src/services/companies.service.ts
+++ b/apps/edr-freight-web/portal/src/services/companies.service.ts
@@ -89,7 +89,18 @@ export interface CompanyProfileResponse {
   updatedAt: string;
 }
 
+/**
+ * Which kind of account is signed in.
+ *
+ * Read this instead of inferring from a missing `company`: a failed or
+ * in-flight company fetch also leaves `company` empty, and treating that as
+ * "shipping line" would skip onboarding for customers whenever the request
+ * failed. Absent (older responses) means `customer`.
+ */
+export type AccountKind = "customer" | "shipping_line";
+
 export interface CompanyInfoResponse {
+  accountKind?: AccountKind;
   profile: ExternalProfileResponse;
   company: CompanyResponse;
   /**
@@ -104,6 +115,30 @@ export interface CompanyInfoResponse {
   } | null;
 }
 
+/**
+ * A signed-in shipping line. It has no company, no external profile and no
+ * onboarding — the carrier record itself is the account.
+ */
+export interface ShippingLineInfoResponse {
+  accountKind: "shipping_line";
+  id: string;
+  name: string;
+  email: string;
+  phoneNumber: string | null;
+  scacCode: string | null;
+  status: string;
+  company: null;
+  profile: null;
+  review: null;
+}
+
+/** `GET /companies/getInfo` serves both portal audiences. */
+export type AccountInfoResponse = CompanyInfoResponse | ShippingLineInfoResponse;
+
+export const isShippingLineAccount = (
+  info: AccountInfoResponse | null | undefined,
+): info is ShippingLineInfoResponse => info?.accountKind === "shipping_line";
+
 /** A staged profile-edit review request (portal view). */
 export interface ChangeRequestResponse {
   id: string;
@@ -158,10 +193,18 @@ export interface OnboardingLicenseProfile {
   uploaded: boolean;
 }
 
-/** Power of Attorney state — mandatory for freight forwarders, optional otherwise. */
+/** Power of Attorney state, driven by the company's own declaration. */
 export interface OnboardingPoaState {
-  required: boolean;
-  provided: boolean;
+  /**
+   * True for a freight forwarder: it signs on other companies' behalf, so a
+   * representative is non-negotiable and the question is shown answered rather
+   * than asked.
+   */
+  locked: boolean;
+  /** The company's answer. Null until it answers — itself an outstanding item. */
+  declared: "yes" | "no" | null;
+  /** True when the DARS delegation paper is owed — i.e. `declared === "yes"`. */
+  delegationLetterRequired: boolean;
   delegationLetterUploaded: boolean;
   /** True when a reviewer sent the DARS delegation paper back for correction. */
   delegationLetterFlagged: boolean;
@@ -175,8 +218,13 @@ export interface OnboardingPoaState {
  * outstanding, so the client never hardcodes required fields or document sets.
  */
 export interface OnboardingRequirements {
+  /** The set the docs came from: the nationality one, or the co-operative one. */
   documentSettingCode: string;
   nationality: string;
+  /** No business licence: registration typed by hand, no eTrade lookup. */
+  cooperative: boolean;
+  /** Foreign investment licence: registration typed by hand, no eTrade record. */
+  investorLicence: boolean;
   companyInfo: {
     complete: boolean;
     missingFields: { key: string; label: string }[];
@@ -184,7 +232,7 @@ export interface OnboardingRequirements {
   documents: OnboardingDocumentField[];
   licenseProfiles: OnboardingLicenseProfile[];
   poa: OnboardingPoaState;
-  /** Fayda verification state; `required` is false for a foreign company. */
+  /** The company's single identity verification, and whose it is. */
   identity: CompanyIdentityState;
   progress: { completed: number; total: number };
   isComplete: boolean;
@@ -194,11 +242,11 @@ export interface OnboardingRequirements {
 
 export interface CompanyProfileInput {
   type:
-    | "importer"
-    | "exporter"
-    | "freight_forwarder"
-    | "dj_freight_forwarder"
-    | "transporter";
+  | "importer"
+  | "exporter"
+  | "freight_forwarder"
+  | "dj_freight_forwarder"
+  | "transporter";
   businessLicense?: string;
 }
 
@@ -206,8 +254,6 @@ export interface CreateCompanyPayload {
   companyType?: string;
   nationality?: CompanyNationality;
   companyName: string;
-  companyEmail?: string;
-  companyPhone?: string;
   companyLocation?: string;
   companyAddress?: string;
   tin?: string;
@@ -240,9 +286,9 @@ export interface DashboardSummary {
 }
 
 export const companiesService = {
-  getInfo: async (): Promise<CompanyInfoResponse | null> => {
+  getInfo: async (): Promise<AccountInfoResponse | null> => {
     try {
-      const response = await client.get<ApiResponse<CompanyInfoResponse>>(
+      const response = await client.get<ApiResponse<AccountInfoResponse>>(
         URL_CONSTANTS.COMPANIES_API.GET_INFO,
       );
       return unwrap(response.data);
@@ -318,6 +364,8 @@ export const companiesService = {
     companyType: string;
     roles: ProfileTypeValue[];
     nationality?: CompanyNationality;
+    cooperative?: boolean;
+    investorLicence?: boolean;
   }): Promise<CompanyInfoResponse> => {
     const response = await client.post<ApiResponse<CompanyInfoResponse>>(
       URL_CONSTANTS.COMPANIES_API.ONBOARDING_START,
@@ -326,6 +374,18 @@ export const companiesService = {
     return unwrap(response.data);
   },
 
+  /**
+   * Give up the foreign investment-licence route and go back through eTrade.
+   * The API clears the typed registration and reopens onboarding at the company
+   * step, so the caller must refresh the company info afterwards.
+   */
+  revertToRegularCompany: async (): Promise<CompanyInfoResponse> => {
+    const response = await client.post<ApiResponse<CompanyInfoResponse>>(
+      URL_CONSTANTS.COMPANIES_API.ONBOARDING_REVERT_TO_ETRADE,
+    );
+    return unwrap(response.data);
+  },
+
   setOnboardingStep: async (payload: { step: string }): Promise<void> => {
     await client.patch(URL_CONSTANTS.COMPANIES_API.ONBOARDING_STEP, payload);
   },
@@ -460,9 +520,9 @@ export const companiesService = {
 
   /** The current company's open profile change request (pending/rejected), or null. */
   getChangeRequest: async (): Promise<ChangeRequestResponse | null> => {
-    const response = await client.get<ApiResponse<ChangeRequestResponse | null>>(
-      URL_CONSTANTS.COMPANIES_API.PROFILE_CHANGE_REQUEST,
-    );
+    const response = await client.get<
+      ApiResponse<ChangeRequestResponse | null>
+    >(URL_CONSTANTS.COMPANIES_API.PROFILE_CHANGE_REQUEST);
     return unwrap(response.data);
   },
 
@@ -477,7 +537,10 @@ export const companiesService = {
   },
 
   /** Fetch company registration data from eTrade by TIN. */
-  fetchETradeInfo: async (payload: { tin: string }): Promise<any> => {
+  fetchETradeInfo: async (payload: {
+    tin: string;
+    licenceNumber?: string;
+  }): Promise<any> => {
     const response = await client.post<ApiResponse<any>>(
       URL_CONSTANTS.COMPANIES_API.FETCH_ETRADE_INFO,
       payload,
diff --git a/apps/edr-freight-web/portal/src/services/contracts.service.ts b/apps/edr-freight-web/portal/src/services/contracts.service.ts
index 3842296ef..4e9cb79de 100644
--- a/apps/edr-freight-web/portal/src/services/contracts.service.ts
+++ b/apps/edr-freight-web/portal/src/services/contracts.service.ts
@@ -88,6 +88,8 @@ export interface ContractListFilter {
   contractKind?: string;
   /** CONTAINER or BULK. */
   freightType?: string;
+  /** Service type (rule-engine service_types.id). */
+  serviceTypeId?: string;
   /** IMPORT / EXPORT / DOMESTIC. */
   tradeDirection?: string;
   companyProfileId?: string;
diff --git a/apps/edr-freight-web/portal/src/services/last-mile-requests.service.ts b/apps/edr-freight-web/portal/src/services/last-mile-requests.service.ts
index 5069eafe3..08133ba08 100644
--- a/apps/edr-freight-web/portal/src/services/last-mile-requests.service.ts
+++ b/apps/edr-freight-web/portal/src/services/last-mile-requests.service.ts
@@ -12,6 +12,7 @@ export interface LastMileRequest {
   requestedContainerNumbers?: string[] | null;
   requestedDeliveryDate?: string | null;
   customerSignedAt?: string | null;
+  signerDisplayName?: string | null;
   rejectionReason?: string | null;
   createdAt: string;
   updatedAt: string;
@@ -46,6 +47,12 @@ export const lastMileRequestsService = {
     return data.data ?? data;
   },
 
+  /** The booking's requests, newest first — links the stored LM contract. */
+  listForBooking: async (bookingId: string): Promise<LastMileRequest[]> => {
+    const { data } = await client.get(L.BY_BOOKING(bookingId));
+    return data.data ?? data;
+  },
+
   /** Confirm which containers go via EDR last-mile and the requested delivery date. */
   submit: async (
     id: string,
diff --git a/apps/edr-freight-web/portal/src/services/shipping-line-bookings.service.ts b/apps/edr-freight-web/portal/src/services/shipping-line-bookings.service.ts
new file mode 100644
index 000000000..74797e6dc
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/services/shipping-line-bookings.service.ts
@@ -0,0 +1,366 @@
+import type { Freight } from "@edr/types";
+
+import { client } from "@/utils/api";
+
+const BASE = "/api/shipping-line-bookings";
+
+/**
+ * The `code` of the file-upload setting whose fields a shipping line fills in
+ * after initiating a booking. Configured in the backoffice file-settings editor
+ * (Other tab) and seeded by `file-upload-settings.seeder.ts`.
+ */
+export const SHIPPING_LINE_BOOKING_DOCUMENTS_CODE =
+  "shipping_line_booking_documents";
+
+/** One physical container persisted on a booking line. */
+export interface ShippingLineBookingContainerUnit {
+  id: string;
+  containerNumber?: string | null;
+  sealNumber?: string | null;
+  vgmTons?: number;
+  isHazardous?: boolean;
+  isReefer?: boolean;
+}
+
+/** One persisted container line of a completed booking. */
+export interface ShippingLineBookingContainer {
+  id: string;
+  containerSize?: string | null;
+  quantity: number;
+  vgmPerUnitTons?: number;
+  totalVgmTons?: number;
+  hazardousQuantity?: number;
+  reeferQuantity?: number;
+  wagonsRequired?: number;
+  containerType?: {
+    id: string;
+    label?: string | null;
+    code?: string | null;
+    sizeFt?: number | null;
+  } | null;
+  units?: ShippingLineBookingContainerUnit[];
+}
+
+/**
+ * A shipping-line booking as the portal sees it.
+ *
+ * `hasQueriedDocuments` is computed server-side: a reviewer querying a document
+ * leaves the booking on DOCUMENTS_UNDER_REVIEW, so the booking status alone
+ * cannot tell the UI that the shipping line has something to fix. The cargo
+ * fields are loaded by the detail endpoint for the detail page's cargo tab.
+ */
+export type ShippingLineBooking = Freight.IBooking & {
+  hasQueriedDocuments?: boolean;
+  /** Operations' note when the request was returned for changes (detail only). */
+  operationChangeNote?: string | null;
+  bookingContainers?: ShippingLineBookingContainer[];
+  cargoType?: { id: string; cargoTypeName?: string | null } | null;
+  cargoFreeText?: string | null;
+  isHazardous?: boolean;
+  cargoTotalWeightVgm?: number;
+  bulkTotalWeightTons?: number | null;
+};
+
+/** The authoritative quote returned by the price-preview endpoint. */
+export interface ShippingLinePriceQuote {
+  totalAmount: number;
+  currency: string;
+  lineItems: Freight.PricingBreakdownLineItem[];
+  warnings: string[];
+  /** Containers over their type's weight limit — a surcharge, not a block. */
+  overweightLines: {
+    containerTypeCode: string;
+    totalVgmTons: number;
+    maxAllowedTons: number;
+    excessTons: number;
+  }[];
+  /** 20ft wagon-pairing violations (pair weight diff over the cap) — hard block. */
+  pairingErrors: string[];
+}
+
+/** One wagon the batch engine allocated to the booking. */
+export interface ShippingLineBookingWagon {
+  id: string;
+  status: string;
+  loadType?: string | null;
+  allocatedWeightTons: number;
+  sequenceNo: number | null;
+  wagonNumber: string | null;
+  wagonType: string | null;
+  capacityTons: number;
+  containerNumbers: string[];
+}
+
+/** Operations view: the train the booking rides + its allocated wagons. */
+export interface ShippingLineBookingOperations {
+  train: {
+    id: string;
+    reference?: string | null;
+    trainNumber?: string | null;
+    status: string;
+    direction?: string | null;
+    scheduledDepartureDate: string;
+    scheduledArrivalDate?: string | null;
+    originLabel: string;
+    destinationLabel: string;
+    /** true once operations assigned it; false while it is only requested. */
+    assigned: boolean;
+  } | null;
+  wagons: ShippingLineBookingWagon[];
+}
+
+/** A bookable lane. Its direction is frozen server-side from the yards. */
+export interface ShippingLineRouteOption {
+  id: string;
+  label: string;
+  direction: string;
+  originYardId: string;
+  originLabel: string;
+  destinationYardId: string;
+  destinationLabel: string;
+}
+
+export interface ShippingLineReferenceData {
+  routes: ShippingLineRouteOption[];
+  serviceTypes: { id: string; name: string }[];
+  /** For the completion form — what ships in a CONTAINER booking. */
+  containerTypes: {
+    id: string;
+    label: string;
+    sizeFt: number | null;
+    isReefer: boolean;
+  }[];
+  /**
+   * For the completion form — what ships in a BULK booking. Rows with a
+   * `parentGroupId` are leaf types; rows without may be grouping headers.
+   */
+  cargoTypes: {
+    id: string;
+    name: string;
+    parentGroupId: string | null;
+    unitOfMeasure: string | null;
+  }[];
+}
+
+/**
+ * A train departure dedicated to the signed-in shipping line. Hidden from
+ * customers server-side; `/my-trains` is the only portal read that returns it.
+ */
+export interface ShippingLineTrain {
+  id: string;
+  reference: string | null;
+  trainNumber: string | null;
+  status: string;
+  direction: string | null;
+  scheduledDepartureDate: string;
+  scheduledArrivalDate: string | null;
+  originYardId: string;
+  originLabel: string;
+  destinationYardId: string;
+  destinationLabel: string;
+}
+
+/**
+ * The route is the only lane input: it yields origin, destination and trade
+ * direction together, so they cannot contradict each other.
+ */
+export interface InitiateShippingLineBookingPayload {
+  routeId: string;
+  serviceTypeId?: string;
+  freightType?: string;
+  /** Intended shipment day (YYYY-MM-DD), picked up front by the shipping line. */
+  scheduledDate?: string;
+}
+
+/** One container line of a CONTAINER completion. */
+/** One physical container — number, seal, VGM and its handling switches. */
+export interface CompleteBookingContainerUnit {
+  containerNumber: string;
+  sealNumber?: string;
+  vgmTons: number;
+  isHazardous?: boolean;
+  isReefer?: boolean;
+}
+
+export interface CompleteBookingContainerLine {
+  /** Either the type id or a size string ("20ft" | "40ft") — the server resolves size→type. */
+  containerTypeId?: string;
+  containerSize?: string;
+  quantity: number;
+  vgmPerUnitTons?: number;
+  hazardousQuantity?: number;
+  reeferQuantity?: number;
+  /** Per-container rows — when sent, the server derives counts/VGM from them. */
+  units?: CompleteBookingContainerUnit[];
+}
+
+/**
+ * Completion payload — the cargo and the binding shipment day, the two things
+ * `initiate` leaves empty. CONTAINER bookings send `containers`; BULK ones
+ * send `cargoTypeId` + `cargoWeightTons`.
+ */
+export interface CompleteShippingLineBookingPayload {
+  scheduledDate: string;
+  /**
+   * Which dedicated train the booking rides. Required when more than one of
+   * the line's trains departs on the chosen day; implicit with one departure.
+   */
+  trainScheduleId?: string;
+  paymentCurrency?: string;
+  containers?: CompleteBookingContainerLine[];
+  cargoTypeId?: string;
+  cargoWeightTons?: number;
+  bulkHazardousQuantity?: number;
+  bulkReeferQuantity?: number;
+  cargoFreeText?: string;
+}
+
+/**
+ * Shipping-line bookings. Separate from `bookings.service.ts` (customers) — the
+ * endpoints differ, and shipping lines book without a contract.
+ */
+export const shippingLineBookingsService = {
+  /** Create a bare booking; it starts at AWAITING_DOCUMENTS. */
+  initiate: async (
+    payload: InitiateShippingLineBookingPayload,
+  ): Promise<ShippingLineBooking> => {
+    const { data } = await client.post(`${BASE}/initiate`, payload);
+    return data.data ?? data;
+  },
+
+  /** Bookable routes + service types for the initiate form. */
+  referenceData: async (): Promise<ShippingLineReferenceData> => {
+    const { data } = await client.get(`${BASE}/reference-data`);
+    return data.data ?? data;
+  },
+
+  list: async (): Promise<ShippingLineBooking[]> => {
+    const { data } = await client.get(`${BASE}/my`);
+    return data.data ?? data;
+  },
+
+  /** Train departures dedicated to the signed-in shipping line, soonest first. */
+  myTrains: async (): Promise<ShippingLineTrain[]> => {
+    const { data } = await client.get(`${BASE}/my-trains`);
+    return data.data ?? data;
+  },
+
+  getById: async (id: string): Promise<ShippingLineBooking> => {
+    const { data } = await client.get(`${BASE}/${id}`);
+    return data.data ?? data;
+  },
+
+  /**
+   * Days with an open departure that can carry this booking — for the
+   * completion form's shipment-day picker.
+   */
+  availableDays: async (id: string): Promise<{ days: string[] }> => {
+    const { data } = await client.get(`${BASE}/${id}/available-days`);
+    return data.data ?? data;
+  },
+
+  /**
+   * The line's dedicated trains for a shipment day, each with per-wagon-type
+   * free space — the completion form's train picker. Cargo context refines
+   * the availability figures.
+   */
+  trainsForDay: async (
+    id: string,
+    date?: string,
+    cargo?: { containerSizes?: string[]; cargoTypeId?: string; wagons?: number },
+  ): Promise<Freight.ExportTrainOption[]> => {
+    const { data } = await client.get(`${BASE}/${id}/trains`, {
+      params: {
+        ...(date ? { date } : {}),
+        ...(cargo?.containerSizes?.length
+          ? { sizes: cargo.containerSizes.join(",") }
+          : {}),
+        ...(cargo?.cargoTypeId ? { cargoTypeId: cargo.cargoTypeId } : {}),
+        ...(cargo?.wagons ? { wagons: cargo.wagons } : {}),
+      },
+    });
+    return data.data ?? data;
+  },
+
+  /**
+   * Authoritative price quote for the completion payload — the same compute
+   * /complete runs. Server saves the breakdown + rate snapshots on the
+   * booking (refreshed on every re-preview); nothing else is persisted.
+   */
+  pricePreview: async (
+    id: string,
+    payload: CompleteShippingLineBookingPayload,
+  ): Promise<ShippingLinePriceQuote> => {
+    const { data } = await client.post(`${BASE}/${id}/price-preview`, payload);
+    return data.data ?? data;
+  },
+
+  /** The train the booking rides + the wagons allocated to it. */
+  operations: async (id: string): Promise<ShippingLineBookingOperations> => {
+    const { data } = await client.get(`${BASE}/${id}/operations`);
+    return data.data ?? data;
+  },
+
+  /**
+   * Complete an approved (CLEARANCE_READY) booking: cargo + shipment day.
+   * The server prices it off the line's negotiated rates, records the charge
+   * on the credit ledger (pay-later — no invoice is issued here) and moves the
+   * booking to OPERATION_REQUEST_PENDING for Operations to review.
+   */
+  complete: async (
+    id: string,
+    payload: CompleteShippingLineBookingPayload,
+  ): Promise<ShippingLineBooking> => {
+    const { data } = await client.post(`${BASE}/${id}/complete`, payload);
+    return data.data ?? data;
+  },
+
+  /**
+   * Cancel one of the signed-in shipping line's own bookings. Only accepted
+   * before the booking is priced — the server enforces the same rule.
+   */
+  cancel: async (id: string, reason?: string): Promise<ShippingLineBooking> => {
+    const { data } = await client.post(`${BASE}/${id}/cancel`, { reason });
+    return data.data ?? data;
+  },
+
+  /**
+   * The document grid for a booking: every configured field with its uploaded
+   * file, review status and reviewer note. Same shared endpoint the customer
+   * clearance flow reads — it resolves the field set from the booking, which
+   * now maps shipping-line bookings to their own file-upload setting.
+   */
+  getClearance: async (id: string): Promise<Freight.ClearanceView> => {
+    const { data } = await client.get(`/api/bookings/${id}/clearance`);
+    return data.data ?? data;
+  },
+
+  /**
+   * Upload the booking's documents.
+   *
+   * Posts to the shared CLEARANCE documents endpoint, not `/documents`: the
+   * latter only accepts DRAFT bookings, and these start at AWAITING_DOCUMENTS.
+   * This is the same endpoint the customer clearance flow uses — it files each
+   * document for review and moves the booking to DOCUMENTS_UNDER_REVIEW.
+   */
+  uploadDocuments: async (
+    id: string,
+    files: Record<string, File | File[] | null>,
+  ): Promise<ShippingLineBooking> => {
+    const formData = new FormData();
+    for (const [key, fileOrFiles] of Object.entries(files)) {
+      if (!fileOrFiles) continue;
+      if (Array.isArray(fileOrFiles)) {
+        for (const f of fileOrFiles) formData.append(key, f);
+      } else {
+        formData.append(key, fileOrFiles);
+      }
+    }
+    const { data } = await client.post(
+      `/api/bookings/${id}/clearance/documents`,
+      formData,
+      { headers: { "Content-Type": "multipart/form-data" } },
+    );
+    return data.data ?? data;
+  },
+};
diff --git a/apps/edr-freight-web/portal/src/services/verifayda.service.ts b/apps/edr-freight-web/portal/src/services/verifayda.service.ts
index 38b225918..79dc14f40 100644
--- a/apps/edr-freight-web/portal/src/services/verifayda.service.ts
+++ b/apps/edr-freight-web/portal/src/services/verifayda.service.ts
@@ -3,14 +3,21 @@ import { unwrap } from "@/utils/endpoint";
 import type { ApiResponse } from "@/types/apiResponse";
 
 /**
- * Which of the company's people a verification is for. The owner is who the
- * company is proven through; the PoA and GM are personnel it names. The GM is
- * very often the owner — "same as owner" reuses that verification rather than
- * making the same human prove themselves twice.
+ * Which of the company's two people a verification is for.
+ *
+ * The **owner** is whoever the eTrade licence names as the business's manager
+ * — not necessarily the legal owner, but the person the record has to match.
+ * The **PoA** is who the company delegates to act for it.
+ *
+ * Exactly one of them is verified, chosen by the company's own answer to "does
+ * anyone hold power of attorney for you?" — see `poaDeclared`.
  */
-export type IdentitySubject = "owner" | "poa" | "gm";
+export type IdentitySubject = "owner" | "poa";
 
-/** One person's Fayda verification state, as the API reports it. */
+/** Whether the company named a representative. Null until it answers. */
+export type PoaDeclaration = "yes" | "no";
+
+/** One person's identity state, as the API reports it. */
 export interface IdentityVerificationState {
   verified: boolean;
   name: string | null;
@@ -18,36 +25,49 @@ export interface IdentityVerificationState {
   email: string | null;
   address: string | null;
   verifiedAt: string | null;
-}
-
-export interface OwnerIdentityState extends IdentityVerificationState {
   /**
-   * Typed passport number — the foreign-company identity credential.
-   * Independent of Fayda: never written by a verification, and still required
-   * even if the owner also verifies.
+   * Typed passport number — the ALTERNATIVE to Fayda for a foreign company,
+   * never written by a verification. Only asked of whichever person carries
+   * the company's identity, and only when `passportAccepted`.
    */
   passportNumber: string | null;
 }
 
 export interface CompanyIdentityState {
   /**
-   * True when Fayda verification is mandatory — Ethiopian companies only.
-   * Doubles as "may this person be typed instead": Fayda is an Ethiopian
-   * national ID, so a foreign company's GM and PoA are offered the
-   * verification but fall back to typed details when they hold none.
+   * True for a foreign company: a typed passport number proves the identity
+   * just as a Fayda verification does. Fayda is an Ethiopian national ID, so an
+   * Ethiopian company has no alternative to it.
    */
-  faydaRequired: boolean;
-  /** True when the owner's passport number is mandatory — foreign companies only. */
-  passportRequired: boolean;
-  owner: OwnerIdentityState;
-  poa: IdentityVerificationState;
+  passportAccepted: boolean;
   /**
-   * General manager. `verified` covers both routes: the GM verifying in their
-   * own right, and the company declaring the GM is the owner (in which case
-   * `gmSameAsOwner` is set and the owner's Fayda sub backs it).
+   * The company's answer to the power-of-attorney question. Null until it
+   * answers — which is itself outstanding, since the answer decides who
+   * verifies. Always "yes" for a freight forwarder, which cannot operate
+   * without a representative and is never asked.
    */
-  gm: IdentityVerificationState;
-  gmSameAsOwner: boolean;
+  poaDeclared: PoaDeclaration | null;
+  /** Whose verification the company is gated on. Null while undeclared. */
+  subject: IdentitySubject | null;
+  owner: IdentityVerificationState;
+  poa: IdentityVerificationState;
+  /** True once `subject` is proven — Fayda-verified, or passport where accepted. */
+  identityProven: boolean;
+  /** The manager named on the eTrade licence, captured at lookup. */
+  etradeManagerName: string | null;
+  /**
+   * That manager's phone (E.164), from the same lookup. Together with the name
+   * this is what survives a refresh: the live lookup result does not, so
+   * without these two a resumed wizard cannot tell an eTrade-sourced owner from
+   * a typed one, and offers the licence's own data back as editable inputs.
+   */
+  etradeManagerPhone: string | null;
+  /**
+   * Does the owner the company put forward match the eTrade licence? This is
+   * the backoffice's check. Null when there is nothing to compare. Advisory:
+   * eTrade's and Fayda's transliterations rarely agree exactly.
+   */
+  ownerMatchesEtrade: boolean | null;
   complete: boolean;
 }
 
@@ -120,37 +140,19 @@ export const verifaydaService = {
   },
 
   /**
-   * Declare the General Manager is the company's owner, reusing the owner's
-   * verified identity rather than making the same human verify twice. The copy
-   * happens server-side from the stored owner identity — the portal never
-   * supplies the values — and is refused until the owner is verified.
+   * Answer whether anyone holds power of attorney for this company — the
+   * question that decides whose identity is verified.
+   *
+   * Answering "no" tears the representative down server-side: their details,
+   * their verification, their passport number and the DARS delegation paper.
+   * Refused for a freight forwarder, which cannot operate without one.
    */
-  setGmSameAsOwner: async (): Promise<CompanyIdentityState> => {
-    const response = await client.post<ApiResponse<CompanyIdentityState>>(
-      "/api/companies/identity/gm/same-as-owner",
-    );
-    return unwrap(response.data);
-  },
-
-  /**
-   * Clear the GM's identity — the "same as owner" declaration or a verification
-   * of their own — leaving them open to be re-established either way.
-   */
-  clearGmIdentity: async (): Promise<CompanyIdentityState> => {
-    const response = await client.delete<ApiResponse<CompanyIdentityState>>(
-      "/api/companies/identity/gm",
-    );
-    return unwrap(response.data);
-  },
-
-  /**
-   * Drop the Power of Attorney — verified identity, details and delegation
-   * paper together. A verified person's fields are locked, so blanking the form
-   * is no longer a way to remove them. Refused for a freight forwarder.
-   */
-  removePoa: async (): Promise<CompanyIdentityState> => {
-    const response = await client.delete<ApiResponse<CompanyIdentityState>>(
-      "/api/companies/identity/fayda/poa",
+  setPoaDeclared: async (
+    declared: PoaDeclaration,
+  ): Promise<CompanyIdentityState> => {
+    const response = await client.patch<ApiResponse<CompanyIdentityState>>(
+      "/api/companies/identity/poa-declared",
+      { declared },
     );
     return unwrap(response.data);
   },
diff --git a/apps/edr-freight-web/portal/src/types/profile.ts b/apps/edr-freight-web/portal/src/types/profile.ts
index 8f126ea1a..fc297110a 100644
--- a/apps/edr-freight-web/portal/src/types/profile.ts
+++ b/apps/edr-freight-web/portal/src/types/profile.ts
@@ -6,9 +6,11 @@ export interface ProfileResponse {
   companyName: string;
   companyType: string;
   nationality: string | null;
+  /** No business licence: the registration is typed, not fetched from eTrade. */
+  cooperative: boolean;
+  /** Foreign investor on an investment licence: same typed registration, no eTrade record. */
+  investorLicence: boolean;
   companyProfiles: CompanyProfileResponse[];
-  companyEmail: string | null;
-  companyPhone: string | null;
   companyLocation: string;
   companyAddress: string | null;
   tinNumber: string;
@@ -32,19 +34,15 @@ export interface ProfileResponse {
   contactPersonPhone: string | null;
   /** Phone that passed SMS OTP verification (resumes the verify step's state). */
   contactVerifiedPhone: string | null;
-  generalManagerName: string | null;
-  generalManagerEmail: string | null;
-  generalManagerPhone: string | null;
+  /** The owner — whoever the eTrade licence names as the business's manager. */
+  ownerName: string | null;
+  ownerEmail: string | null;
+  ownerPhone: string | null;
   /**
-   * Fayda verification state for the owner, the PoA and the general manager.
-   * `identity.faydaRequired` / `identity.passportRequired` is the
-   * Ethiopian/foreign switch: an Ethiopian company verifies all three with
-   * Fayda, while a foreign one proves its owner with a typed passport number
-   * and may type its GM and PoA, whose holders may have no Fayda ID.
-   *
-   * The `generalManager*` fields above are the same person's details written
-   * flat — a verification keeps them in step, since the booking, contract and
-   * train-scheduling notifiers mail `generalManagerEmail` directly.
+   * The company's single identity verification. `identity.subject` says whose
+   * it is (the PoA when one is declared, otherwise the owner);
+   * `identity.passportAccepted` is the Ethiopian/foreign switch — a foreign
+   * company may prove the same person with a typed passport number instead.
    */
   identity: CompanyIdentityState;
   poaName: string | null;
@@ -68,8 +66,6 @@ export interface ProfileResponse {
 export interface UpdateProfilePayload {
   nationality?: "ethiopian" | "foreign";
   companyName?: string;
-  companyEmail?: string;
-  companyPhone?: string;
   companyLocation?: string;
   companyAddress?: string;
   tin?: string;
@@ -92,14 +88,18 @@ export interface UpdateProfilePayload {
   contactPersonEmail?: string;
   contactPersonPhone?: string;
   contactVerifiedPhone?: string;
-  generalManagerName?: string;
-  generalManagerEmail?: string;
-  generalManagerPhone?: string;
+  ownerName?: string;
+  ownerEmail?: string;
+  ownerPhone?: string;
   poaName?: string;
   poaPhone?: string;
   poaEmail?: string;
   poaLocation?: string;
   poaAddress?: string;
-  /** The owner's passport number — the foreign-company identity credential. */
+  /**
+   * Passport numbers — the ALTERNATIVE to Fayda for a foreign company. Only the
+   * one belonging to the declared identity subject is ever collected.
+   */
   ownerPassportNumber?: string;
+  poaPassportNumber?: string;
 }
diff --git a/apps/edr-freight-web/portal/src/utils/dev-bypass.ts b/apps/edr-freight-web/portal/src/utils/dev-bypass.ts
new file mode 100644
index 000000000..69eb23242
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/utils/dev-bypass.ts
@@ -0,0 +1,4 @@
+/** True when VITE_ENV is "dev" or "staging" — mirrors the API's ENV gate. */
+export function isBypassEnv(): boolean {
+  return ["dev", "staging"].includes(import.meta.env.VITE_ENV ?? "");
+}
diff --git a/apps/edr-freight-web/portal/src/utils/documentSettingCode.test.ts b/apps/edr-freight-web/portal/src/utils/documentSettingCode.test.ts
new file mode 100644
index 000000000..6063f1b87
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/utils/documentSettingCode.test.ts
@@ -0,0 +1,28 @@
+import { describe, expect, it } from "vitest";
+
+import { documentSettingCode } from "./documentSettingCode";
+
+describe("documentSettingCode", () => {
+  it("resolves the nationality set", () => {
+    expect(documentSettingCode("ethiopian")).toBe(
+      "company_onboarding_documents_ethiopian",
+    );
+    expect(documentSettingCode("foreign")).toBe(
+      "company_onboarding_documents_foreign",
+    );
+    expect(documentSettingCode(null)).toBe(
+      "company_onboarding_documents_ethiopian",
+    );
+  });
+
+  it("replaces the nationality set for a co-operative", () => {
+    expect(documentSettingCode("ethiopian", true)).toBe(
+      "company_onboarding_documents_cooperative",
+    );
+    // A co-op is never foreign, but a stale flag must not fall back to the
+    // foreign set — the co-op answer wins.
+    expect(documentSettingCode("foreign", true)).toBe(
+      "company_onboarding_documents_cooperative",
+    );
+  });
+});
diff --git a/apps/edr-freight-web/portal/src/utils/documentSettingCode.ts b/apps/edr-freight-web/portal/src/utils/documentSettingCode.ts
new file mode 100644
index 000000000..e27407c27
--- /dev/null
+++ b/apps/edr-freight-web/portal/src/utils/documentSettingCode.ts
@@ -0,0 +1,18 @@
+/**
+ * The company document set a company resolves to — one of three, never a
+ * combination: a co-operative union or farm uploads its own papers INSTEAD of
+ * its nationality's (it holds no business licence), and is always Ethiopian.
+ *
+ * Mirrors `CompaniesService.documentSettingCodeFor` on the API; prefer the
+ * server-resolved `documentSettingCode` from onboarding requirements where one
+ * is available, and use this where only the company is at hand.
+ */
+export function documentSettingCode(
+  nationality: string | null | undefined,
+  cooperative?: boolean | null,
+): string {
+  if (cooperative) return "company_onboarding_documents_cooperative";
+  return nationality === "foreign"
+    ? "company_onboarding_documents_foreign"
+    : "company_onboarding_documents_ethiopian";
+}
diff --git a/apps/edr-freight-web/portal/src/vite-env.d.ts b/apps/edr-freight-web/portal/src/vite-env.d.ts
index a4955ecee..6a93b9e75 100644
--- a/apps/edr-freight-web/portal/src/vite-env.d.ts
+++ b/apps/edr-freight-web/portal/src/vite-env.d.ts
@@ -23,6 +23,8 @@ interface ImportMetaEnv {
   readonly VITE_POSTHOG_KEY?: string;
   /** Self-hosted PostHog instance URL. */
   readonly VITE_POSTHOG_HOST?: string;
+  /** "dev" | "staging" — enables the OTP/payment/Fayda bypass. Unset in prod. */
+  readonly VITE_ENV?: string;
 }
 
 interface ImportMeta {
diff --git a/apps/edr-passenger-api/.env.example b/apps/edr-passenger-api/.env.example
index cf00cfe51..970aca30d 100644
--- a/apps/edr-passenger-api/.env.example
+++ b/apps/edr-passenger-api/.env.example
@@ -87,12 +87,8 @@ CBE_SECRET_KEY=
 CBE_NOTIFY_URL=
 CBE_RETURN_URL=
 
-# eBirr
-EBIRR_BASE_URL=
-EBIRR_MERCHANT_CODE=
-EBIRR_SECRET_KEY=
-EBIRR_NOTIFY_URL=
-EBIRR_RETURN_URL=
+# eBirr — credentials live in edr-payment-api only; the passenger API never calls providers
+# directly. eBirr has no redirect, so there is no EBIRR_RETURN_URL. See docs/ebirr/INTEGRATION.md.
 
 # Card Gateway (Stripe-like)
 CARD_BASE_URL=
@@ -140,7 +136,6 @@ WAAFI_SUCCESS_REDIRECT=
 WAAFI_FAIL_REDIRECT=
 DMONEY_RETURN_URL=
 CBE_RETURN_URL=
-EBIRR_RETURN_URL=
 CARD_RETURN_URL=
 
 # Session Configuration
diff --git a/apps/edr-passenger-api/package.json b/apps/edr-passenger-api/package.json
index b3571871c..230a44529 100644
--- a/apps/edr-passenger-api/package.json
+++ b/apps/edr-passenger-api/package.json
@@ -46,7 +46,7 @@
     "@prisma/client": "^6.19.3",
     "@sendgrid/mail": "^8.1.0",
     "@tria-plc/api-common": "file:../../local-packages/tria-plc-api-common-1.6.0.tgz",
-    "@tria-plc/iamapi-common": "file:../../local-packages/tria-plc-iamapi-common-1.0.0.tgz",
+    "@tria-plc/iamapi-common": "file:../../local-packages/tria-plc-iamapi-common-1.1.0.tgz",
     "@types/bcrypt": "^6.0.0",
     "amqp-connection-manager": "^5.0.0",
     "amqplib": "^2.0.1",
diff --git a/apps/edr-passenger-api/prisma/fix-payment-method-currency.ts b/apps/edr-passenger-api/prisma/fix-payment-method-currency.ts
new file mode 100644
index 000000000..8273cb1c2
--- /dev/null
+++ b/apps/edr-passenger-api/prisma/fix-payment-method-currency.ts
@@ -0,0 +1,49 @@
+/**
+ * One-off data fix: corrects PaymentMethod.currency for methods whose settlement currency
+ * was never set at seed time and silently defaulted to the schema's ETB default.
+ *
+ * payments.service.ts's chargeCurrency resolution reads this column directly (see the
+ * comment above `chargeCurrency` in `initiatePayment`): WAAFI settles in DJF, CARD in USD.
+ * With WAAFI stuck on the ETB default, live Waafi payments were charged in ETB instead of
+ * being converted to DJF — not just a mislabeled report. This script only touches the
+ * PaymentMethod config row; it does NOT rewrite any existing PaymentIntent/Booking records,
+ * since correcting historical transaction currency is a financial decision, not a data-fix
+ * this script should make unilaterally.
+ *
+ * Safe to re-run. Only updates rows that already exist; does not create new ones.
+ *
+ * Usage: node --env-file=.env -r ts-node/register prisma/fix-payment-method-currency.ts
+ */
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+const CORRECTIONS: { type: string; currency: string }[] = [
+  { type: 'WAAFI', currency: 'DJF' },
+  { type: 'CARD', currency: 'USD' },
+];
+
+async function main() {
+  for (const { type, currency } of CORRECTIONS) {
+    const existing = await prisma.paymentMethod.findUnique({ where: { type: type as any } });
+    if (!existing) {
+      console.log(`  ⚠️  No PaymentMethod row for ${type} — skipping (nothing to correct).`);
+      continue;
+    }
+    if (existing.currency === currency) {
+      console.log(`  ℹ️  ${type} already set to ${currency} — no change.`);
+      continue;
+    }
+    await prisma.paymentMethod.update({ where: { type: type as any }, data: { currency } });
+    console.log(`  ✅ ${type}: ${existing.currency} → ${currency}`);
+  }
+}
+
+main()
+  .catch((e) => {
+    console.error('❌ fix-payment-method-currency failed:', e);
+    process.exitCode = 1;
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });
diff --git a/apps/edr-passenger-api/prisma/migrations/20260818000001_add_audit_log_actor_identity/migration.sql b/apps/edr-passenger-api/prisma/migrations/20260818000001_add_audit_log_actor_identity/migration.sql
new file mode 100644
index 000000000..0b19a49b8
--- /dev/null
+++ b/apps/edr-passenger-api/prisma/migrations/20260818000001_add_audit_log_actor_identity/migration.sql
@@ -0,0 +1,17 @@
+-- The audit trail has to answer "who did this" without a cross-schema join: Prisma only knows
+-- the `passenger` schema, and an IAM user that is later deleted would take the answer with it.
+-- So the actor's name and phone are denormalized onto the row at write time, the same way
+-- SeatBlock.blockedByName was added for the blocked-seat report.
+--
+-- Purely additive: both columns are nullable and the index is new, so rows written before this
+-- migration keep working and simply report as System / Unknown in the backoffice.
+
+-- AlterTable
+ALTER TABLE "passenger"."AuditLog"
+  ADD COLUMN IF NOT EXISTS "userName"  TEXT,
+  ADD COLUMN IF NOT EXISTS "userPhone" TEXT;
+
+-- CreateIndex: the default Audit Logs listing sorts createdAt DESC with no other filter, which
+-- neither existing composite index serves. Broadening audit coverage materially increases the
+-- row count behind that sort.
+CREATE INDEX IF NOT EXISTS "AuditLog_createdAt_idx" ON "passenger"."AuditLog"("createdAt");
diff --git a/apps/edr-passenger-api/prisma/schema.prisma b/apps/edr-passenger-api/prisma/schema.prisma
index 7bca3116d..26f93bd43 100644
--- a/apps/edr-passenger-api/prisma/schema.prisma
+++ b/apps/edr-passenger-api/prisma/schema.prisma
@@ -1325,6 +1325,11 @@ model ExcessBaggageCharge {
 model AuditLog {
   id          String   @id @default(uuid())
   iamUserId   String?
+  /// Actor's display name, denormalized at write time so a reader needs no cross-schema
+  /// lookup into iam.users and the trail survives the IAM user being deleted.
+  userName    String?
+  /// Actor's contact number, denormalized for the same reason.
+  userPhone   String?
   action      String
   entityType  String
   entityId    String?
@@ -1335,6 +1340,7 @@ model AuditLog {
   createdAt   DateTime @default(now())
   @@index([iamUserId, createdAt])
   @@index([entityType, entityId])
+  @@index([createdAt])
   @@schema("passenger")
 }
 
diff --git a/apps/edr-passenger-api/src/app.module.ts b/apps/edr-passenger-api/src/app.module.ts
index 014e4f5c6..bd8372b29 100644
--- a/apps/edr-passenger-api/src/app.module.ts
+++ b/apps/edr-passenger-api/src/app.module.ts
@@ -23,7 +23,6 @@ import dbConfig from "./config/database.config";
 import iamDatabaseConfig from "./config/iam-database.config";
 import telebirrConfig from "./config/telebirr.config";
 import cbeConfig from "./config/cbe.config";
-import ebirrConfig from "./config/ebirr.config";
 import cardConfig from "./config/card.config";
 import waafiConfig from "./config/waafi.config";
 import faydaConfig from "./config/fayda.config";
@@ -75,7 +74,6 @@ import { EOtpType } from "@tria-plc/iamapi-common";
         iamDatabaseConfig,
         telebirrConfig,
         cbeConfig,
-        ebirrConfig,
         cardConfig,
         waafiConfig,
         faydaConfig,
diff --git a/apps/edr-passenger-api/src/common/acting-user.ts b/apps/edr-passenger-api/src/common/acting-user.ts
index 630e307a8..8229096d9 100644
--- a/apps/edr-passenger-api/src/common/acting-user.ts
+++ b/apps/edr-passenger-api/src/common/acting-user.ts
@@ -21,6 +21,7 @@ export interface ActingUserClaims {
   name?: ActingUserName | string | null;
   username?: string;
   email?: string;
+  phoneNumber?: string;
 }
 
 /** The minimal Express request shape needed to reach the authenticated user. */
@@ -34,6 +35,8 @@ export interface ActingUser {
   id: string;
   /** Human-readable name, denormalized alongside the id. */
   name: string;
+  /** Contact number, denormalized alongside the id. Absent on tokens that omit it. */
+  phone?: string;
 }
 
 /**
@@ -48,7 +51,11 @@ export function resolveActingUser(req: RequestWithActingUser): ActingUser | null
   const id = claims?.id ?? claims?.sub;
   if (!id) return null;
 
-  return { id, name: resolveActingUserName(claims) };
+  return {
+    id,
+    name: resolveActingUserName(claims),
+    phone: claims?.phoneNumber?.trim() || undefined,
+  };
 }
 
 function resolveActingUserName(claims: ActingUserClaims | undefined): string {
diff --git a/apps/edr-passenger-api/src/common/audit-snapshot.ts b/apps/edr-passenger-api/src/common/audit-snapshot.ts
new file mode 100644
index 000000000..602a723f5
--- /dev/null
+++ b/apps/edr-passenger-api/src/common/audit-snapshot.ts
@@ -0,0 +1,124 @@
+/**
+ * Building the `oldData` / `newData` payloads on an audit row.
+ *
+ * Audit rows are retained for a year and readable by anyone with `audit:view`, so they must
+ * carry enough to explain a change and nothing more. Dumping a whole Prisma row is the easy
+ * mistake: it drags along payment tokens, contact details and identity documents that the
+ * reader never needed. `snapshot()` inverts the default — you list what to keep.
+ */
+
+/**
+ * Words that must never reach an audit row, whatever the caller asked for.
+ *
+ * Matched against the key's own words rather than as raw substrings — a substring test would
+ * redact `shipping` for containing "pin" and miss nothing in exchange.
+ */
+const DENIED_WORDS = new Set([
+  'password',
+  'passcode',
+  'secret',
+  'token',
+  'otp',
+  'pin',
+  'authorization',
+  'auth',
+  'apikey',
+  'passport',
+  'nationalid',
+  'fayda',
+  'ssn',
+]);
+
+/** Value written in place of a denied field, so the reader knows something was withheld. */
+const REDACTED = '[redacted]';
+
+/**
+ * Splits `paymentToken`, `payment_token` and `PAYMENT_TOKEN` alike into ['payment', 'token'],
+ * then reports whether any word is denied.
+ */
+function isDeniedKey(key: string): boolean {
+  const words = key
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .split(/[^A-Za-z0-9]+/)
+    .map((w) => w.toLowerCase())
+    .filter(Boolean);
+
+  // `nationalId` splits into ['national','id'], so check the joined form too.
+  return words.some((w) => DENIED_WORDS.has(w)) || DENIED_WORDS.has(words.join(''));
+}
+
+/**
+ * Picks `keys` off `entity`, dropping anything absent and redacting anything sensitive.
+ *
+ * Returns `undefined` for a null/undefined entity so a missing "before" state simply omits
+ * `oldData` rather than storing `{}`.
+ */
+export function snapshot<T extends object>(
+  entity: T | null | undefined,
+  keys: readonly (keyof T & string)[],
+): Record<string, unknown> | undefined {
+  if (!entity) return undefined;
+
+  const out: Record<string, unknown> = {};
+  for (const key of keys) {
+    const value = (entity as Record<string, unknown>)[key];
+    if (value === undefined) continue;
+    out[key] = isDeniedKey(key) ? REDACTED : normalize(value);
+  }
+  return out;
+}
+
+/**
+ * Same guarantees as {@link snapshot} for a payload assembled by hand rather than picked off an
+ * entity — the sweeps and gate branches build their context inline.
+ */
+export function auditPayload(
+  data: Record<string, unknown> | null | undefined,
+): Record<string, unknown> | undefined {
+  if (!data) return undefined;
+
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (value === undefined) continue;
+    out[key] = isDeniedKey(key) ? REDACTED : normalize(value);
+  }
+  return out;
+}
+
+/**
+ * Prisma hands back `Date` and `Decimal` objects. `JSON.stringify` would render a Decimal as
+ * `{}`, so flatten both to something a reader can compare across two snapshots.
+ */
+function normalize(value: unknown): unknown {
+  if (value instanceof Date) return value.toISOString();
+  if (value && typeof value === 'object' && typeof (value as any).toFixed === 'function') {
+    return (value as any).toString();
+  }
+  return value;
+}
+
+/**
+ * Reduces a before/after pair to only the fields that actually moved.
+ *
+ * Used where the "before" row is wide but the edit is narrow (a schedule status flip, a fare
+ * price change) so the audit row shows the change rather than burying it.
+ */
+export function changedFields(
+  before: Record<string, unknown> | undefined,
+  after: Record<string, unknown> | undefined,
+): { oldData?: Record<string, unknown>; newData?: Record<string, unknown> } {
+  if (!before || !after) return { oldData: before, newData: after };
+
+  const oldData: Record<string, unknown> = {};
+  const newData: Record<string, unknown> = {};
+  for (const key of new Set([...Object.keys(before), ...Object.keys(after)])) {
+    if (JSON.stringify(before[key]) === JSON.stringify(after[key])) continue;
+    oldData[key] = before[key];
+    newData[key] = after[key];
+  }
+
+  return {
+    oldData: Object.keys(oldData).length ? oldData : undefined,
+    newData: Object.keys(newData).length ? newData : undefined,
+  };
+}
diff --git a/apps/edr-passenger-api/src/common/audit.actions.ts b/apps/edr-passenger-api/src/common/audit.actions.ts
new file mode 100644
index 000000000..f9ee389db
--- /dev/null
+++ b/apps/edr-passenger-api/src/common/audit.actions.ts
@@ -0,0 +1,91 @@
+/**
+ * The closed vocabulary for audit rows.
+ *
+ * `AuditLog.action` and `AuditLog.entityType` are plain `String` columns, so nothing at the
+ * database level stops a caller inventing `created` or `schedule_updated`. These two maps are
+ * the convention: uppercase, semantic, and imported rather than typed inline. The pre-existing
+ * rows use `CREATE`/`UPDATE`/`DELETE`/`VERIFY`, so those keep their meaning and the rest extend
+ * them — no historical row changes shape.
+ */
+
+export const AUDIT_ACTIONS = {
+  // ── CRUD ───────────────────────────────────────────────────────────────────
+  CREATE: 'CREATE',
+  UPDATE: 'UPDATE',
+  DELETE: 'DELETE',
+  /** Undo of a soft delete (train restore, seat undo-remove, ticket restore). */
+  RESTORE: 'RESTORE',
+
+  // ── Explicit state transitions ─────────────────────────────────────────────
+  /** A status column moved. Prefer this over UPDATE when status is the point of the change. */
+  STATUS_CHANGE: 'STATUS_CHANGE',
+  CANCEL: 'CANCEL',
+
+  // ── Seats & coaches ────────────────────────────────────────────────────────
+  BLOCK: 'BLOCK',
+  UNBLOCK: 'UNBLOCK',
+  ASSIGN: 'ASSIGN',
+  UNASSIGN: 'UNASSIGN',
+
+  // ── Charges & money ────────────────────────────────────────────────────────
+  WAIVE: 'WAIVE',
+  PAY: 'PAY',
+  REFUND: 'REFUND',
+  /** Re-sending a payment link — no state change, but it re-exposes a payment token. */
+  RESEND: 'RESEND',
+
+  // ── Gate ───────────────────────────────────────────────────────────────────
+  BOARD: 'BOARD',
+  BOARD_DENIED: 'BOARD_DENIED',
+  /**
+   * Retained for backward-compatible filtering of gate rows written before BOARD existed.
+   * New code uses BOARD / BOARD_DENIED.
+   */
+  VERIFY: 'VERIFY',
+
+  // ── Bulk / sweeps ──────────────────────────────────────────────────────────
+  BULK_CREATE: 'BULK_CREATE',
+  BULK_UPDATE: 'BULK_UPDATE',
+  SYNC: 'SYNC',
+  IMPORT: 'IMPORT',
+} as const;
+
+export type AuditAction = (typeof AUDIT_ACTIONS)[keyof typeof AUDIT_ACTIONS];
+
+/**
+ * Entity names as they appear in `AuditLog.entityType`. These mirror the Prisma model names so
+ * a reader can go from an audit row straight to the table, and they back the backoffice
+ * Audit Logs filter dropdown.
+ */
+export const AUDIT_ENTITIES = {
+  // Master data
+  Station: 'Station',
+  Train: 'Train',
+  Coach: 'Coach',
+  CoachType: 'CoachType',
+  Seat: 'Seat',
+  SeatClass: 'SeatClass',
+  Route: 'Route',
+  RouteStop: 'RouteStop',
+  RouteCoachTemplate: 'RouteCoachTemplate',
+  Schedule: 'Schedule',
+  ScheduleFare: 'ScheduleFare',
+  CoachAssignment: 'CoachAssignment',
+
+  // Finance / tariff
+  FareRule: 'FareRule',
+  RouteFareRule: 'RouteFareRule',
+  SegmentFareRule: 'SegmentFareRule',
+  Currency: 'Currency',
+  Payment: 'Payment',
+  PaymentMethod: 'PaymentMethod',
+  SupplementaryCharge: 'SupplementaryCharge',
+  ExcessBaggageCharge: 'ExcessBaggageCharge',
+  BaggageAllowance: 'BaggageAllowance',
+
+  // Operations
+  Ticket: 'Ticket',
+  Booking: 'Booking',
+} as const;
+
+export type AuditEntity = (typeof AUDIT_ENTITIES)[keyof typeof AUDIT_ENTITIES];
diff --git a/apps/edr-passenger-api/src/common/audit.service.spec.ts b/apps/edr-passenger-api/src/common/audit.service.spec.ts
new file mode 100644
index 000000000..52e54df68
--- /dev/null
+++ b/apps/edr-passenger-api/src/common/audit.service.spec.ts
@@ -0,0 +1,224 @@
+import { AuditService } from './audit.service';
+import { snapshot, auditPayload, changedFields } from './audit-snapshot';
+
+/**
+ * The audit primitive is the reason ~47 of the 57 existing call sites wrote a NULL actor: it
+ * held the request (for IP/user-agent) but never read `request.user`. These pin the fix — the
+ * actor is resolved from the guarded session, callers cannot be trusted to pass it, and a
+ * logging failure never propagates into the business operation it describes.
+ */
+describe('AuditService', () => {
+  const REQUEST = {
+    user: {
+      id: 'iam-user-1',
+      name: { en: 'Abebe Kebede', am: 'አበበ ከበደ' },
+      username: 'abebe.k',
+      email: 'abebe@edr.et',
+      phoneNumber: '+251911223344',
+    },
+    headers: {
+      'x-forwarded-for': '10.1.2.3, 172.16.0.1',
+      'user-agent': 'Mozilla/5.0 (Backoffice)',
+    },
+    socket: { remoteAddress: '127.0.0.1' },
+  };
+
+  const build = (request?: any) => {
+    const create = jest.fn().mockResolvedValue({});
+    const prisma = { auditLog: { create, count: jest.fn(), findMany: jest.fn(), findUnique: jest.fn() } };
+    return { service: new AuditService(prisma as any, request), create, prisma };
+  };
+
+  const written = (create: jest.Mock) => create.mock.calls[0][0].data;
+
+  describe('actor resolution', () => {
+    it('takes the actor from the authenticated request when the caller omits one', async () => {
+      const { service, create } = build(REQUEST);
+      await service.log({ action: 'CREATE', entityType: 'Station', entityId: 'st-1' });
+
+      expect(written(create)).toMatchObject({
+        iamUserId: 'iam-user-1',
+        userName: 'Abebe Kebede',
+        userPhone: '+251911223344',
+      });
+    });
+
+    it('ignores nothing the request says — a body cannot smuggle in a different actor', async () => {
+      const { service, create } = build({
+        ...REQUEST,
+        // A request body field never reaches AuditService; only `request.user` does.
+        body: { validatorId: 'someone-else', waivedBy: 'not-me' },
+      });
+      await service.log({ action: 'BOARD', entityType: 'Ticket', entityId: 't-1' });
+
+      expect(written(create).iamUserId).toBe('iam-user-1');
+    });
+
+    it('lets a system path pass its own actor explicitly', async () => {
+      const { service, create } = build(REQUEST);
+      await service.log({
+        action: 'STATUS_CHANGE',
+        entityType: 'Schedule',
+        entityId: 'sc-1',
+        userId: 'SYSTEM',
+        userName: 'Reconciliation cron',
+      });
+
+      expect(written(create)).toMatchObject({ iamUserId: 'SYSTEM', userName: 'Reconciliation cron' });
+    });
+
+    it('records a null actor outside an HTTP request rather than inventing one', async () => {
+      const { service, create } = build(undefined);
+      await service.log({ action: 'PAY', entityType: 'ExcessBaggageCharge', entityId: 'c-1' });
+
+      expect(written(create)).toMatchObject({ iamUserId: null, userName: null, userPhone: null });
+    });
+
+    it('falls back through the name shapes IAM actually returns', async () => {
+      const { service, create } = build({ user: { sub: 'legacy-id', username: 'gate.agent' }, headers: {} });
+      await service.log({ action: 'BOARD', entityType: 'Ticket', entityId: 't-2' });
+
+      expect(written(create)).toMatchObject({ iamUserId: 'legacy-id', userName: 'gate.agent' });
+    });
+  });
+
+  describe('request metadata', () => {
+    it('captures the client IP and user-agent', async () => {
+      const { service, create } = build(REQUEST);
+      await service.log({ action: 'UPDATE', entityType: 'Train', entityId: 'tr-1' });
+
+      expect(written(create)).toMatchObject({
+        ipAddress: '10.1.2.3',
+        userAgent: 'Mozilla/5.0 (Backoffice)',
+      });
+    });
+
+    it('still writes the row when the request carries no headers', async () => {
+      // Queue consumers resolve this service with a bare stub; reading through `headers`
+      // unguarded used to throw and silently drop the whole row.
+      const { service, create } = build({ user: { id: 'iam-user-1' }, ip: '10.9.9.9' });
+      await service.log({ action: 'PAY', entityType: 'SupplementaryCharge', entityId: 'sc-1' });
+
+      expect(create).toHaveBeenCalledTimes(1);
+      expect(written(create)).toMatchObject({ ipAddress: '10.9.9.9', userAgent: '' });
+    });
+
+    it('leaves IP and user-agent blank with no request at all', async () => {
+      const { service, create } = build(undefined);
+      await service.log({ action: 'DELETE', entityType: 'Seat', entityId: 's-1' });
+
+      expect(written(create)).toMatchObject({ ipAddress: '', userAgent: '' });
+    });
+  });
+
+  describe('failure containment', () => {
+    it('swallows a write failure instead of breaking the operation it describes', async () => {
+      const create = jest.fn().mockRejectedValue(new Error('db down'));
+      const service = new AuditService({ auditLog: { create } } as any, REQUEST);
+
+      await expect(
+        service.log({ action: 'CREATE', entityType: 'Station', entityId: 'st-1' }),
+      ).resolves.toBeUndefined();
+    });
+  });
+
+  describe('getLogs', () => {
+    const withRows = () => {
+      const findMany = jest.fn().mockResolvedValue([]);
+      const count = jest.fn().mockResolvedValue(0);
+      const prisma = { auditLog: { findMany, count, create: jest.fn() } };
+      return { service: new AuditService(prisma as any, REQUEST), findMany, count };
+    };
+
+    it('caps the page size so a caller cannot ask for the whole table', async () => {
+      const { service, findMany } = withRows();
+      await service.getLogs({ limit: 5000 });
+      expect(findMany.mock.calls[0][0].take).toBe(200);
+    });
+
+    it('defaults to the newest 50 rows', async () => {
+      const { service, findMany } = withRows();
+      await service.getLogs();
+      expect(findMany.mock.calls[0][0]).toMatchObject({
+        take: 50,
+        skip: 0,
+        orderBy: { createdAt: 'desc' },
+      });
+    });
+
+    it('filters by exact actor and a date range', async () => {
+      const { service, findMany } = withRows();
+      await service.getLogs({ iamUserId: 'iam-user-1', from: '2026-08-01', to: '2026-08-18' });
+
+      const where = findMany.mock.calls[0][0].where;
+      expect(where.iamUserId).toBe('iam-user-1');
+      expect(where.createdAt.gte).toEqual(new Date('2026-08-01'));
+      expect(where.createdAt.lte).toEqual(new Date('2026-08-18'));
+    });
+
+    it('ignores an unparseable date instead of returning nothing', async () => {
+      const { service, findMany } = withRows();
+      await service.getLogs({ from: 'not-a-date' });
+      expect(findMany.mock.calls[0][0].where.createdAt).toBeUndefined();
+    });
+
+    it('searches the denormalized actor name and phone, not just ids', async () => {
+      const { service, findMany } = withRows();
+      await service.getLogs({ search: 'abebe' });
+
+      const fields = findMany.mock.calls[0][0].where.OR.map((c: any) => Object.keys(c)[0]);
+      expect(fields).toEqual(
+        expect.arrayContaining(['entityId', 'iamUserId', 'userName', 'userPhone']),
+      );
+    });
+  });
+});
+
+describe('audit snapshot helpers', () => {
+  it('keeps only the listed fields', () => {
+    const entity = { id: 'x', name: 'Dire Dawa', code: 'DD', internalNote: 'do not log' };
+    expect(snapshot(entity, ['name', 'code'])).toEqual({ name: 'Dire Dawa', code: 'DD' });
+  });
+
+  it('drops absent fields rather than writing undefined', () => {
+    expect(snapshot({ name: 'X', code: undefined } as any, ['name', 'code'])).toEqual({ name: 'X' });
+  });
+
+  it('returns undefined for a missing entity so oldData is simply omitted', () => {
+    expect(snapshot(null, ['name'] as any)).toBeUndefined();
+  });
+
+  it('redacts credentials even when a caller asks for them', () => {
+    const charge = { paymentToken: 'tok-live-1', amountMinor: 1000 } as any;
+    expect(snapshot(charge, ['paymentToken', 'amountMinor'])).toEqual({
+      paymentToken: '[redacted]',
+      amountMinor: 1000,
+    });
+  });
+
+  it('redacts on word boundaries, not raw substrings', () => {
+    // "shipping" contains the letters of "pin"; it is not a credential.
+    const row = { shippingNote: 'leave at gate', otp: '4530', national_id: 'ETH-1' } as any;
+    expect(auditPayload(row)).toEqual({
+      shippingNote: 'leave at gate',
+      otp: '[redacted]',
+      national_id: '[redacted]',
+    });
+  });
+
+  it('flattens dates so two snapshots can be compared', () => {
+    const at = new Date('2026-08-18T06:00:00.000Z');
+    expect(snapshot({ departureAt: at } as any, ['departureAt'])).toEqual({
+      departureAt: '2026-08-18T06:00:00.000Z',
+    });
+  });
+
+  it('reduces a before/after pair to the fields that actually moved', () => {
+    const before = { status: 'SCHEDULED', departureTime: '08:00' };
+    const after = { status: 'CANCELLED', departureTime: '08:00' };
+    expect(changedFields(before, after)).toEqual({
+      oldData: { status: 'SCHEDULED' },
+      newData: { status: 'CANCELLED' },
+    });
+  });
+});
diff --git a/apps/edr-passenger-api/src/common/audit.service.ts b/apps/edr-passenger-api/src/common/audit.service.ts
index cff5403da..496c13655 100644
--- a/apps/edr-passenger-api/src/common/audit.service.ts
+++ b/apps/edr-passenger-api/src/common/audit.service.ts
@@ -1,6 +1,38 @@
 import { Injectable, Inject, Logger, Optional } from '@nestjs/common';
 import { REQUEST } from '@nestjs/core';
 import { PrismaService } from './prisma.service';
+import { AuditAction } from './audit.actions';
+import { resolveActingUser } from './acting-user';
+
+export interface AuditLogInput {
+  /**
+   * Overrides the actor. Leave it out on any request-scoped path — `log()` resolves the
+   * authenticated IAM user from the request, which is the only source a caller cannot forge.
+   */
+  userId?: string;
+  userName?: string;
+  userPhone?: string;
+  /** See `AUDIT_ACTIONS`. Widened to `string` so the 57 pre-existing call sites still compile. */
+  action: AuditAction | string;
+  entityType: string;
+  entityId?: string;
+  oldData?: any;
+  newData?: any;
+}
+
+export interface AuditLogFilters {
+  search?: string;
+  action?: string;
+  entityType?: string;
+  /** Exact IAM user id — "everything this staff member did". */
+  iamUserId?: string;
+  /** Inclusive lower bound on `createdAt`. */
+  from?: Date | string;
+  /** Inclusive upper bound on `createdAt`. */
+  to?: Date | string;
+  limit?: number;
+  offset?: number;
+}
 
 @Injectable()
 export class AuditService {
@@ -10,21 +42,21 @@ export class AuditService {
     @Optional() @Inject(REQUEST) private request?: any,
   ) {}
 
-  async log(input: {
-    userId?: string;
-    action: 'CREATE' | 'UPDATE' | 'DELETE' | 'LOGIN' | 'LOGOUT' | 'VERIFY' | string;
-    entityType: string;
-    entityId?: string;
-    oldData?: any;
-    newData?: any;
-  }) {
+  async log(input: AuditLogInput) {
     try {
+      // The actor is read off the guarded request rather than trusted from the caller, so a
+      // request body can never decide whose name lands in the trail. Callers may still pass
+      // `userId` explicitly for system paths (crons, queue consumers) that have no request.
+      const actor = this.request ? resolveActingUser(this.request) : null;
+
       const ipAddress = this.getIpAddress();
       const userAgent = this.getUserAgent();
 
       await this.prisma.auditLog.create({
         data: {
-          iamUserId: input.userId,
+          iamUserId: input.userId ?? actor?.id ?? null,
+          userName: input.userName ?? actor?.name ?? null,
+          userPhone: input.userPhone ?? actor?.phone ?? null,
           action: input.action,
           entityType: input.entityType,
           entityId: input.entityId,
@@ -41,11 +73,14 @@ export class AuditService {
   }
 
   private getIpAddress(): string {
-    if (!this.request) return '';
-    
+    // `headers` is absent on non-HTTP contexts (queue consumers resolve this service with a
+    // bare request stub); reading through it unguarded used to throw and silently drop the row.
+    const headers = this.request?.headers;
+    if (!headers) return this.request?.ip || '';
+
     return (
-      this.request.headers['x-forwarded-for']?.split(',')[0].trim() ||
-      this.request.headers['x-real-ip'] ||
+      headers['x-forwarded-for']?.split(',')[0].trim() ||
+      headers['x-real-ip'] ||
       this.request.connection?.remoteAddress ||
       this.request.socket?.remoteAddress ||
       this.request.ip ||
@@ -57,13 +92,15 @@ export class AuditService {
     return this.request?.headers?.['user-agent'] || '';
   }
 
-  async getLogs(filters: any = {}) {
+  async getLogs(filters: AuditLogFilters = {}) {
     const where: any = {};
 
     if (filters.search) {
       where.OR = [
         { entityId: { contains: filters.search, mode: 'insensitive' } },
         { iamUserId: { contains: filters.search, mode: 'insensitive' } },
+        { userName: { contains: filters.search, mode: 'insensitive' } },
+        { userPhone: { contains: filters.search, mode: 'insensitive' } },
       ];
     }
 
@@ -75,6 +112,15 @@ export class AuditService {
       where.entityType = filters.entityType;
     }
 
+    if (filters.iamUserId) {
+      where.iamUserId = filters.iamUserId;
+    }
+
+    const createdAt = this.dateRange(filters.from, filters.to);
+    if (createdAt) {
+      where.createdAt = createdAt;
+    }
+
     const limit = Math.min(filters.limit ?? 50, 200);
     const offset = filters.offset ?? 0;
 
@@ -94,4 +140,23 @@ export class AuditService {
   async getLog(id: string) {
     return this.prisma.auditLog.findUnique({ where: { id } });
   }
+
+  /** Builds a Prisma date filter, ignoring bounds that don't parse. */
+  private dateRange(from?: Date | string, to?: Date | string) {
+    const range: { gte?: Date; lte?: Date } = {};
+
+    const lower = this.toDate(from);
+    if (lower) range.gte = lower;
+
+    const upper = this.toDate(to);
+    if (upper) range.lte = upper;
+
+    return Object.keys(range).length ? range : undefined;
+  }
+
+  private toDate(value?: Date | string): Date | undefined {
+    if (!value) return undefined;
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+  }
 }
diff --git a/apps/edr-passenger-api/src/common/passenger-permission.util.spec.ts b/apps/edr-passenger-api/src/common/passenger-permission.util.spec.ts
new file mode 100644
index 000000000..7d15fba00
--- /dev/null
+++ b/apps/edr-passenger-api/src/common/passenger-permission.util.spec.ts
@@ -0,0 +1,280 @@
+import { ForbiddenException } from '@nestjs/common';
+import {
+  assertPassengerPermission,
+  collectPermissionKeys,
+  hasPassengerPermission,
+  hasPassengerPermissionStrict,
+  isOrganizationAdmin,
+  isSuperAdmin,
+} from './passenger-permission.util';
+
+const TICKETS_MANAGE = 'edr_passenger_app:tickets:manage';
+const TICKETS_VIEW = 'edr_passenger_app:tickets:view';
+const BOOKINGS_VIEW = 'edr_passenger_app:bookings:view';
+const FLEET_MANAGE = 'edr_passenger_app:fleet:manage';
+
+/** IAM shape: position types nest the key one level deeper, under `.permission`. */
+const positionType = (keys: string[]) => ({
+  positionTypePermissions: keys.map((key) => ({ permission: { key } })),
+});
+
+/** Mirrors the ticket-officer position IAM returns: own grant + two position types. */
+const ticketOfficerPosition = () => ({
+  id: 'pos-ticket-officer',
+  permissions: [{ key: BOOKINGS_VIEW }],
+  positionType: positionType([TICKETS_VIEW, TICKETS_MANAGE]),
+  positionTypes: [
+    positionType(['can:view:expectation']),
+    positionType([TICKETS_VIEW, TICKETS_MANAGE]),
+  ],
+});
+
+const hrPosition = () => ({
+  id: 'pos-hr',
+  permissions: [{ key: 'hr_app:employees:view' }],
+  positionType: positionType(['hr_app:leave:approve']),
+  positionTypes: [positionType(['hr_app:leave:approve'])],
+});
+
+/** `/v1/auth/me` — `employee` is an array of employees, each with `positions[]`. */
+const meShape = (positions: any[]) => ({
+  roles: [],
+  permissions: [],
+  employee: [{ id: 'emp-1', positions }],
+});
+
+/**
+ * `request.user` — `JwtGuard.parseToken` spreads the employee, then overwrites
+ * `position` with the one it selected and adds `delegatedPositions[]`. The full
+ * `positions[]` survives the spread.
+ */
+const requestShape = (positions: any[], selectedIndex = 0) => ({
+  roles: [],
+  permissions: [],
+  employee: {
+    id: 'emp-1',
+    positions,
+    position: positions[selectedIndex],
+    delegatedPositions: positions.filter((p: any) => p.isDelegate),
+  },
+});
+
+describe('collectPermissionKeys', () => {
+  it('returns nothing for a missing user', () => {
+    expect(collectPermissionKeys(null)).toEqual([]);
+    expect(collectPermissionKeys(undefined)).toEqual([]);
+    expect(collectPermissionKeys({})).toEqual([]);
+  });
+
+  it('collects role permissions when there is no employee record', () => {
+    expect(collectPermissionKeys({ permissions: [{ key: TICKETS_VIEW }] })).toEqual([TICKETS_VIEW]);
+    expect(collectPermissionKeys({ permissions: [{ key: TICKETS_VIEW }], employee: null })).toEqual([
+      TICKETS_VIEW,
+    ]);
+  });
+
+  describe('backward compatibility — positions with no position types', () => {
+    it('still reads a position own permissions[] in the /v1/auth/me shape', () => {
+      const user = meShape([{ id: 'p1', permissions: [{ key: BOOKINGS_VIEW }] }]);
+      expect(collectPermissionKeys(user)).toEqual([BOOKINGS_VIEW]);
+    });
+
+    it('still reads a position own permissions[] in the request.user shape', () => {
+      const user = requestShape([{ id: 'p1', permissions: [{ key: BOOKINGS_VIEW }] }]);
+      expect(collectPermissionKeys(user)).toEqual([BOOKINGS_VIEW]);
+    });
+
+    it('merges role permissions with position permissions', () => {
+      const user = {
+        permissions: [{ key: 'role:key' }],
+        employee: [{ positions: [{ permissions: [{ key: BOOKINGS_VIEW }] }] }],
+      };
+      expect(collectPermissionKeys(user).sort()).toEqual([BOOKINGS_VIEW, 'role:key'].sort());
+    });
+  });
+
+  describe('position types', () => {
+    it('collects from the legacy singular positionType', () => {
+      const user = meShape([{ permissions: [], positionType: positionType([TICKETS_MANAGE]) }]);
+      expect(collectPermissionKeys(user)).toEqual([TICKETS_MANAGE]);
+    });
+
+    it('collects from the new positionTypes[] array', () => {
+      const user = meShape([{ permissions: [], positionTypes: [positionType([TICKETS_MANAGE])] }]);
+      expect(collectPermissionKeys(user)).toEqual([TICKETS_MANAGE]);
+    });
+
+    it('collects from every entry of positionTypes[], not just the first', () => {
+      const user = meShape([
+        {
+          permissions: [],
+          positionTypes: [positionType(['a']), positionType(['b']), positionType(['c'])],
+        },
+      ]);
+      expect(collectPermissionKeys(user).sort()).toEqual(['a', 'b', 'c']);
+    });
+
+    it('unions permissions[], positionType and positionTypes[] without duplicates', () => {
+      // ticket-officer appears as BOTH the singular positionType and inside positionTypes[]
+      const keys = collectPermissionKeys(meShape([ticketOfficerPosition()]));
+      expect(keys.sort()).toEqual(
+        [BOOKINGS_VIEW, TICKETS_VIEW, TICKETS_MANAGE, 'can:view:expectation'].sort(),
+      );
+      expect(keys).toHaveLength(new Set(keys).size);
+    });
+
+    it('works identically in the request.user shape', () => {
+      expect(collectPermissionKeys(requestShape([ticketOfficerPosition()])).sort()).toEqual(
+        collectPermissionKeys(meShape([ticketOfficerPosition()])).sort(),
+      );
+    });
+  });
+
+  describe('all positions count, not only the selected one', () => {
+    it('grants a permission held by a position that is not positions[0]', () => {
+      // parseToken selected positions[0] (HR) because no x-current-position-id was sent
+      const user = requestShape([hrPosition(), ticketOfficerPosition()], 0);
+      expect(collectPermissionKeys(user)).toContain(TICKETS_MANAGE);
+    });
+
+    it('matches what the backoffice computes from the same payload', () => {
+      const positions = [hrPosition(), ticketOfficerPosition()];
+      expect(collectPermissionKeys(requestShape(positions, 0)).sort()).toEqual(
+        collectPermissionKeys(meShape(positions)).sort(),
+      );
+    });
+
+    it('spans multiple employee records', () => {
+      const user = {
+        employee: [{ positions: [hrPosition()] }, { positions: [ticketOfficerPosition()] }],
+      };
+      expect(collectPermissionKeys(user)).toContain(TICKETS_MANAGE);
+      expect(collectPermissionKeys(user)).toContain('hr_app:leave:approve');
+    });
+
+    it('includes delegated positions', () => {
+      const delegated = { ...ticketOfficerPosition(), isDelegate: true };
+      const user = {
+        employee: { positions: undefined, position: hrPosition(), delegatedPositions: [delegated] },
+      };
+      expect(collectPermissionKeys(user)).toContain(TICKETS_MANAGE);
+    });
+
+    it('does not invent permissions nobody was granted', () => {
+      const user = requestShape([hrPosition(), ticketOfficerPosition()]);
+      expect(collectPermissionKeys(user)).not.toContain(FLEET_MANAGE);
+    });
+  });
+
+  describe('malformed payloads', () => {
+    it('survives nulls, missing keys and non-array fields', () => {
+      const user: any = {
+        permissions: [{}, { key: 'kept' }],
+        employee: {
+          // parseToken passes `positions` through untouched when it is not an array
+          positions: { id: 'not-an-array' },
+          position: {
+            permissions: null,
+            positionType: null,
+            positionTypes: [null, { positionTypePermissions: null }, positionType([TICKETS_VIEW])],
+          },
+          delegatedPositions: null,
+        },
+      };
+      expect(collectPermissionKeys(user).sort()).toEqual(['kept', TICKETS_VIEW].sort());
+    });
+
+    it('ignores positionTypePermissions entries with no permission object', () => {
+      const user: any = {
+        employee: [
+          {
+            positions: [
+              {
+                positionTypes: [
+                  {
+                    positionTypePermissions: [
+                      {},
+                      { permission: null },
+                      { permission: { key: 'ok' } },
+                    ],
+                  },
+                ],
+              },
+            ],
+          },
+        ],
+      };
+      expect(collectPermissionKeys(user)).toEqual(['ok']);
+    });
+  });
+});
+
+describe('role helpers', () => {
+  it('detects super admin and org admin', () => {
+    expect(isSuperAdmin({ roles: [{ key: 'super_admin' }] })).toBe(true);
+    expect(isOrganizationAdmin({ roles: [{ key: 'organization_admin' }] })).toBe(true);
+    expect(isSuperAdmin({ roles: [{ key: 'ticket_officer' }] })).toBe(false);
+    expect(isOrganizationAdmin({})).toBe(false);
+  });
+});
+
+describe('hasPassengerPermission', () => {
+  it('is true for a permission granted only through a position type', () => {
+    expect(hasPassengerPermission(requestShape([ticketOfficerPosition()]), TICKETS_MANAGE)).toBe(
+      true,
+    );
+  });
+
+  it('is true when the granting position is not the selected one', () => {
+    const user = requestShape([hrPosition(), ticketOfficerPosition()], 0);
+    expect(hasPassengerPermission(user, TICKETS_MANAGE)).toBe(true);
+  });
+
+  it('is false for a permission nobody granted', () => {
+    expect(hasPassengerPermission(requestShape([ticketOfficerPosition()]), FLEET_MANAGE)).toBe(
+      false,
+    );
+  });
+
+  it('is false without a user', () => {
+    expect(hasPassengerPermission(null, TICKETS_MANAGE)).toBe(false);
+  });
+
+  it('lets super admins and org admins bypass', () => {
+    expect(hasPassengerPermission({ roles: [{ key: 'super_admin' }] }, FLEET_MANAGE)).toBe(true);
+    expect(hasPassengerPermission({ roles: [{ key: 'organization_admin' }] }, FLEET_MANAGE)).toBe(
+      true,
+    );
+  });
+});
+
+describe('hasPassengerPermissionStrict', () => {
+  it('does not let super admins bypass', () => {
+    expect(hasPassengerPermissionStrict({ roles: [{ key: 'super_admin' }] }, FLEET_MANAGE)).toBe(
+      false,
+    );
+  });
+
+  it('honours a position-type grant', () => {
+    expect(hasPassengerPermissionStrict(requestShape([ticketOfficerPosition()]), TICKETS_MANAGE)).toBe(
+      true,
+    );
+  });
+});
+
+describe('assertPassengerPermission', () => {
+  it('passes silently when granted through a position type', () => {
+    expect(() =>
+      assertPassengerPermission(requestShape([ticketOfficerPosition()]), TICKETS_MANAGE),
+    ).not.toThrow();
+  });
+
+  it('throws ForbiddenException naming the missing key', () => {
+    expect(() => assertPassengerPermission(requestShape([hrPosition()]), TICKETS_MANAGE)).toThrow(
+      ForbiddenException,
+    );
+    expect(() => assertPassengerPermission(requestShape([hrPosition()]), TICKETS_MANAGE)).toThrow(
+      TICKETS_MANAGE,
+    );
+  });
+});
diff --git a/apps/edr-passenger-api/src/common/passenger-permission.util.ts b/apps/edr-passenger-api/src/common/passenger-permission.util.ts
index d915ef86e..cc94b0e0c 100644
--- a/apps/edr-passenger-api/src/common/passenger-permission.util.ts
+++ b/apps/edr-passenger-api/src/common/passenger-permission.util.ts
@@ -4,13 +4,34 @@ const SUPER_ADMIN_ROLE = 'super_admin';
 const ORGANIZATION_ADMIN_ROLE = 'organization_admin';
 
 type PermissionLike = { key?: string };
+
+/**
+ * A position type carries its own grants. IAM ships them as
+ * `positionTypePermissions[].permission.key` — note the extra `permission`
+ * wrapper, unlike the flat `permissions[]` on a position.
+ */
+type PositionTypeLike = {
+  positionTypePermissions?: ({ permission?: PermissionLike | null } | null)[] | null;
+};
+
+type PositionLike = {
+  permissions?: PermissionLike[];
+  /** Legacy single position type. */
+  positionType?: PositionTypeLike | null;
+  /** Newer array — a position can now carry several position types. */
+  positionTypes?: (PositionTypeLike | null)[] | null;
+};
+
+type EmployeeLike = {
+  position?: PositionLike;
+  positions?: PositionLike[];
+  delegatedPositions?: PositionLike[];
+};
+
 type MeLikeUser = {
   roles?: { key?: string }[];
   permissions?: PermissionLike[];
-  employee?:
-    | { position?: { permissions?: PermissionLike[] }; delegatedPositions?: { permissions?: PermissionLike[] }[] }
-    | { positions?: { permissions?: PermissionLike[] }[] }[]
-    | null;
+  employee?: EmployeeLike | EmployeeLike[] | null;
 };
 
 export function isSuperAdmin(user: MeLikeUser | null | undefined): boolean {
@@ -21,6 +42,42 @@ export function isOrganizationAdmin(user: MeLikeUser | null | undefined): boolea
   return user?.roles?.some((r) => r.key === ORGANIZATION_ADMIN_ROLE) ?? false;
 }
 
+/**
+ * Add every permission key a single position grants.
+ *
+ * A position's own `permissions[]` used to be the whole story. IAM now also
+ * hangs grants off *position types* — the legacy singular `positionType` plus
+ * the newer `positionTypes[]` array — so we union all three rather than trust
+ * IAM to have merged them back into `permissions[]`.
+ */
+function addPositionPermissionKeys(
+  position: PositionLike | null | undefined,
+  keys: Set<string>,
+): void {
+  if (!position) return;
+
+  for (const p of position.permissions ?? []) {
+    if (p?.key) keys.add(p.key);
+  }
+
+  const positionTypes: (PositionTypeLike | null | undefined)[] = [
+    position.positionType,
+    ...(position.positionTypes ?? []),
+  ];
+
+  for (const positionType of positionTypes) {
+    for (const ptp of positionType?.positionTypePermissions ?? []) {
+      const key = ptp?.permission?.key;
+      if (key) keys.add(key);
+    }
+  }
+}
+
+/** `parseToken` passes `positions` through untouched, so it is not always an array. */
+function asArray<T>(value: T[] | null | undefined): T[] {
+  return Array.isArray(value) ? value : [];
+}
+
 export function collectPermissionKeys(user: MeLikeUser | null | undefined): string[] {
   if (!user) return [];
 
@@ -33,23 +90,25 @@ export function collectPermissionKeys(user: MeLikeUser | null | undefined): stri
   const employee = user.employee;
   if (!employee) return [...keys];
 
-  if (Array.isArray(employee)) {
-    for (const emp of employee) {
-      for (const pos of emp.positions ?? []) {
-        for (const p of pos.permissions ?? []) {
-          if (p.key) keys.add(p.key);
-        }
-      }
-    }
-    return [...keys];
-  }
+  // `/v1/auth/me` hands back `employee` as an array of employees, each with
+  // `positions[]`. `JwtGuard.parseToken` collapses it to a single employee with
+  // the active `position` plus `delegatedPositions[]` — but it spreads the
+  // employee, so the full `positions[]` survives on `request.user` too. Both
+  // shapes reach here.
+  const employees = Array.isArray(employee) ? employee : [employee];
 
-  for (const p of employee.position?.permissions ?? []) {
-    if (p.key) keys.add(p.key);
-  }
-  for (const delegated of employee.delegatedPositions ?? []) {
-    for (const p of delegated.permissions ?? []) {
-      if (p.key) keys.add(p.key);
+  for (const emp of employees) {
+    // Every position the person holds counts, not just the one
+    // `parseToken` selected. Without a `x-current-position-id` header it picks
+    // `positions[0]`, so a second-listed passenger position would 403 here while
+    // the backoffice — which unions all positions at login — renders the action
+    // as available. Union them here so the two agree.
+    addPositionPermissionKeys(emp.position, keys);
+    for (const pos of asArray(emp.positions)) {
+      addPositionPermissionKeys(pos, keys);
+    }
+    for (const delegated of asArray(emp.delegatedPositions)) {
+      addPositionPermissionKeys(delegated, keys);
     }
   }
 
diff --git a/apps/edr-passenger-api/src/common/utils/booking-sms.utils.spec.ts b/apps/edr-passenger-api/src/common/utils/booking-sms.utils.spec.ts
new file mode 100644
index 000000000..93fa94b50
--- /dev/null
+++ b/apps/edr-passenger-api/src/common/utils/booking-sms.utils.spec.ts
@@ -0,0 +1,153 @@
+import { buildSeatSummary } from './booking-sms.utils';
+
+const seat = (passengerName: string, seatNumber: string, leg = 1, coachType = 'VIP Bed') => ({
+  passengerName,
+  leg,
+  seat: { seatNumber, coach: { number: 'VIP-0001 (DJ)', coachType: { name: coachType } } },
+});
+
+describe('buildSeatSummary', () => {
+  it('greets a solo traveller by name and omits the name from the seat line', () => {
+    const { passengerName, trainSeatLines } = buildSeatSummary([seat('Yanet', '9')], 'ONE_WAY');
+
+    expect(passengerName).toBe('Yanet');
+    expect(trainSeatLines).toBe('VIP-0001 (DJ) VIP Bed, seat no. 9');
+    expect(trainSeatLines).not.toContain('Train/Seat');
+    expect(trainSeatLines).not.toContain('Yanet');
+  });
+
+  it('greets a group collectively and names each seat', () => {
+    const { passengerName, trainSeatLines } = buildSeatSummary(
+      [seat('Yanet', '4'), seat('Abebe', '6'), seat('Sara', '9'), seat('Helen', '10')],
+      'ONE_WAY',
+    );
+
+    expect(passengerName).toBe('Passengers');
+    expect(trainSeatLines).toBe(
+      [
+        'Yanet, VIP-0001 (DJ) VIP Bed, seat no. 4',
+        'Abebe, VIP-0001 (DJ) VIP Bed, seat no. 6',
+        'Sara, VIP-0001 (DJ) VIP Bed, seat no. 9',
+        'Helen, VIP-0001 (DJ) VIP Bed, seat no. 10',
+      ].join('\n'),
+    );
+  });
+
+  // The reported bug: the seats query had no orderBy, so Postgres heap order put the LAST
+  // passenger first and the SMS greeted them while texting the first passenger's phone.
+  it('is immune to seat rows arriving in an arbitrary order', () => {
+    const rows = [seat('Yanet', '9'), seat('Helen', '10'), seat('Abebe', '6'), seat('Sara', '4')];
+
+    const { passengerName, trainSeatLines } = buildSeatSummary(rows, 'ONE_WAY');
+
+    expect(passengerName).toBe('Passengers');
+    // Every line pairs the right person with their own seat, regardless of input order.
+    expect(trainSeatLines).toBe(
+      [
+        'Sara, VIP-0001 (DJ) VIP Bed, seat no. 4',
+        'Abebe, VIP-0001 (DJ) VIP Bed, seat no. 6',
+        'Yanet, VIP-0001 (DJ) VIP Bed, seat no. 9',
+        'Helen, VIP-0001 (DJ) VIP Bed, seat no. 10',
+      ].join('\n'),
+    );
+  });
+
+  it('sorts seat numbers numerically, not lexicographically', () => {
+    const { trainSeatLines } = buildSeatSummary(
+      [seat('A', '9'), seat('B', '10'), seat('C', '6'), seat('D', '4')],
+      'ONE_WAY',
+    );
+
+    expect(trainSeatLines.match(/seat no\. \d+/g)).toEqual([
+      'seat no. 4',
+      'seat no. 6',
+      'seat no. 9',
+      'seat no. 10',
+    ]);
+  });
+
+  it('labels round-trip legs as Outbound/Return, listing each passenger once per leg', () => {
+    const { passengerName, trainSeatLines } = buildSeatSummary(
+      [seat('Yanet', '9', 1), seat('Abebe', '10', 1), seat('Yanet', '3', 2), seat('Abebe', '4', 2)],
+      'ROUND_TRIP',
+    );
+
+    expect(passengerName).toBe('Passengers');
+    expect(trainSeatLines).toBe(
+      [
+        'Outbound:',
+        'Yanet, VIP-0001 (DJ) VIP Bed, seat no. 9',
+        'Abebe, VIP-0001 (DJ) VIP Bed, seat no. 10',
+        'Return:',
+        'Yanet, VIP-0001 (DJ) VIP Bed, seat no. 3',
+        'Abebe, VIP-0001 (DJ) VIP Bed, seat no. 4',
+      ].join('\n'),
+    );
+  });
+
+  // TRANSIT leg 2 is a connecting segment of the same outbound journey — never a return.
+  it('labels transit legs as Leg 1/Leg 2, never Return', () => {
+    const { trainSeatLines } = buildSeatSummary(
+      [seat('Yanet', '9', 1), seat('Abebe', '10', 1), seat('Yanet', '3', 2), seat('Abebe', '4', 2)],
+      'TRANSIT',
+    );
+
+    expect(trainSeatLines).toContain('Leg 1:');
+    expect(trainSeatLines).toContain('Leg 2:');
+    expect(trainSeatLines).not.toContain('Return');
+    expect(trainSeatLines).not.toContain('Outbound');
+  });
+
+  it('labels all four round-trip-transit legs', () => {
+    const { trainSeatLines } = buildSeatSummary(
+      [1, 2, 3, 4].map((leg) => seat('Yanet', String(leg), leg)),
+      'ROUND_TRIP_TRANSIT',
+    );
+
+    expect(trainSeatLines).toBe(
+      [
+        'Outbound leg 1:',
+        'VIP-0001 (DJ) VIP Bed, seat no. 1',
+        'Outbound leg 2:',
+        'VIP-0001 (DJ) VIP Bed, seat no. 2',
+        'Return leg 1:',
+        'VIP-0001 (DJ) VIP Bed, seat no. 3',
+        'Return leg 2:',
+        'VIP-0001 (DJ) VIP Bed, seat no. 4',
+      ].join('\n'),
+    );
+  });
+
+  it('greets a solo round-trip traveller by name (same person on both legs)', () => {
+    const { passengerName } = buildSeatSummary(
+      [seat('Yanet', '9', 1), seat('Yanet', '3', 2)],
+      'ROUND_TRIP',
+    );
+
+    expect(passengerName).toBe('Yanet');
+  });
+
+  it('trims a trailing space on the coach type instead of emitting "Bed , seat"', () => {
+    const { trainSeatLines } = buildSeatSummary([seat('Yanet', '9', 1, 'VIP Bed ')], 'ONE_WAY');
+
+    expect(trainSeatLines).toBe('VIP-0001 (DJ) VIP Bed, seat no. 9');
+  });
+
+  it('falls back safely on empty or malformed input', () => {
+    expect(buildSeatSummary([], 'ONE_WAY')).toEqual({ passengerName: 'Passenger', trainSeatLines: '' });
+
+    const { passengerName, trainSeatLines } = buildSeatSummary([{ leg: 1 }], 'ONE_WAY');
+    expect(passengerName).toBe('Passenger');
+    expect(trainSeatLines).toBe('-, seat no. -');
+  });
+
+  it('falls back to a generic leg heading for an unknown booking type', () => {
+    const { trainSeatLines } = buildSeatSummary(
+      [seat('Yanet', '9', 1), seat('Yanet', '3', 2)],
+      'SOMETHING_NEW',
+    );
+
+    expect(trainSeatLines).toContain('Leg 1:');
+    expect(trainSeatLines).toContain('Leg 2:');
+  });
+});
diff --git a/apps/edr-passenger-api/src/common/utils/booking-sms.utils.ts b/apps/edr-passenger-api/src/common/utils/booking-sms.utils.ts
new file mode 100644
index 000000000..18b1db9ac
--- /dev/null
+++ b/apps/edr-passenger-api/src/common/utils/booking-sms.utils.ts
@@ -0,0 +1,115 @@
+/**
+ * Builds the two passenger-facing values the `booking.created` SMS/email template needs:
+ * the `{{passengerName}}` salutation and the `{{trainSeatLines}}` block.
+ *
+ * Why this is a shared pure helper rather than inline logic: the salutation used to be
+ * `seats[0]?.passengerName`, and the query loading those seats had no `orderBy`. Postgres
+ * returns heap order for an unordered SELECT, and an UPDATE relocates a row to the end of
+ * the heap — so a group booking regularly greeted the LAST passenger while texting the
+ * first one's phone. Deriving both values from the whole seat set, sorted deterministically,
+ * removes the dependency on row order entirely, and keeps the formatting unit-testable
+ * without a Nest testing module.
+ *
+ * Group bookings send ONE SMS to Booking.contactPhone by design — BookingSeat has no
+ * phone/email column, so there is no per-passenger recipient. Hence 2+ passengers are
+ * greeted collectively and each seat line names its own occupant.
+ */
+
+export interface SeatSummary {
+  /** Salutation: the traveller's name when solo, otherwise 'Passengers'. */
+  passengerName: string;
+  /** One line per booked seat, newline-joined, with a heading per leg on multi-leg bookings. */
+  trainSeatLines: string;
+}
+
+/**
+ * Seat numbers are stored as strings of digits (Seat.seatNumber), so they must be compared
+ * numerically — a plain string compare orders '10' before '9'. Non-numeric labels sort last,
+ * then alphabetically among themselves.
+ */
+function compareSeatNumber(a: string, b: string): number {
+  const na = Number.parseInt(a, 10);
+  const nb = Number.parseInt(b, 10);
+  const aNum = Number.isNaN(na);
+  const bNum = Number.isNaN(nb);
+  if (aNum && bNum) return a.localeCompare(b);
+  if (aNum) return 1;
+  if (bNum) return -1;
+  return na - nb || a.localeCompare(b);
+}
+
+const str = (v: unknown): string => (typeof v === 'string' ? v.trim() : v == null ? '' : String(v).trim());
+
+const ROUND_TRIP_TRANSIT_LEGS: Record<number, string> = {
+  1: 'Outbound leg 1',
+  2: 'Outbound leg 2',
+  3: 'Return leg 1',
+  4: 'Return leg 2',
+};
+
+/**
+ * Leg numbering means different things per booking type — see the enum documented on
+ * TicketsController.validate. TRANSIT's leg 2 is a connecting segment of the SAME outbound
+ * journey, so it must never be labelled 'Return'.
+ */
+function legLabel(bookingType: string | undefined, leg: number): string {
+  switch (bookingType) {
+    case 'ROUND_TRIP':
+      return leg === 1 ? 'Outbound' : leg === 2 ? 'Return' : `Leg ${leg}`;
+    case 'TRANSIT':
+      return `Leg ${leg}`;
+    case 'ROUND_TRIP_TRANSIT':
+      return ROUND_TRIP_TRANSIT_LEGS[leg] ?? `Leg ${leg}`;
+    default:
+      // Unknown or newly added booking type — degrade to a generic heading rather than guessing.
+      return `Leg ${leg}`;
+  }
+}
+
+export function buildSeatSummary(seats: any[], bookingType?: string): SeatSummary {
+  const rows = [...(seats ?? [])].sort(
+    (a, b) =>
+      (a?.leg ?? 1) - (b?.leg ?? 1) ||
+      str(a?.seat?.coach?.number).localeCompare(str(b?.seat?.coach?.number)) ||
+      compareSeatNumber(str(a?.seat?.seatNumber), str(b?.seat?.seatNumber)),
+  );
+
+  // Distinct travellers. A round-trip/transit booking has one row per passenger PER LEG, so
+  // the same name legitimately repeats — count people, not rows.
+  const names: string[] = [];
+  for (const row of rows) {
+    const name = str(row?.passengerName);
+    if (name && !names.includes(name)) names.push(name);
+  }
+  const isGroup = names.length > 1;
+
+  const line = (row: any): string => {
+    const coach = str(row?.seat?.coach?.number) || '-';
+    const coachType = str(row?.seat?.coach?.coachType?.name);
+    const seatNo = str(row?.seat?.seatNumber) || '-';
+    // Trim each part before joining: the coach-type name carries a trailing space in some
+    // records, which a `.replace(/ +/g, ' ')` collapse cannot remove (it shrinks runs of
+    // spaces but leaves a single one), and it surfaced as 'VIP Bed , seat no. 9'.
+    const where = [coach, coachType].filter(Boolean).join(' ');
+    const who = isGroup ? `${str(row?.passengerName) || 'Passenger'}, ` : '';
+    return `${who}${where}, seat no. ${seatNo}`;
+  };
+
+  const legs = [...new Set(rows.map((row) => row?.leg ?? 1))];
+  const trainSeatLines =
+    legs.length > 1
+      ? legs
+          .map((leg) =>
+            [
+              `${legLabel(bookingType, leg)}:`,
+              ...rows.filter((row) => (row?.leg ?? 1) === leg).map(line),
+            ].join('\n'),
+          )
+          .join('\n')
+      : rows.map(line).join('\n');
+
+  return {
+    passengerName: isGroup ? 'Passengers' : (names[0] || 'Passenger'),
+    trainSeatLines,
+  };
+}
diff --git a/apps/edr-passenger-api/src/common/utils/payment-deadline.utils.ts b/apps/edr-passenger-api/src/common/utils/payment-deadline.utils.ts
index e125bb0bf..8c391aef1 100644
--- a/apps/edr-passenger-api/src/common/utils/payment-deadline.utils.ts
+++ b/apps/edr-passenger-api/src/common/utils/payment-deadline.utils.ts
@@ -13,11 +13,17 @@ export const MAX_PAYMENT_HOURS = 2;
 export const CUTOFF_MINUTES = 30;
 
 /**
- * payment_deadline = MIN(booking_time + MAX_PAYMENT_HOURS, segment_departure - checkinMinutes)
- *
- * checkinMinutes defaults to CUTOFF_MINUTES but callers should pass the route-level
- * checkinMinutesBefore so that each route's own window is respected.
+ * How long a passenger is given to finish one provider payment session, once opened.
+ * 5 minutes of actual paying (redirect → PIN/OTP → provider callback) + 1 minute of slack.
  */
+export const PAYMENT_SESSION_MINUTES = 6;
+
+
+export const MIN_PAYMENT_WINDOW_MINUTES = 7;
+
+export const PAYMENT_SETTLE_MARGIN_SECONDS = 60;
+
+
 export function computePaymentDeadline(
   createdAt: Date,
   departureAt: Date,
@@ -27,3 +33,19 @@ export function computePaymentDeadline(
   const cutoffDeadline = new Date(departureAt.getTime() - checkinMinutes * 60 * 1000);
   return maxDeadline < cutoffDeadline ? maxDeadline : cutoffDeadline;
 }
+
+
+export function canOpenPaymentSession(
+  paymentDeadline: Date,
+  now: Date = new Date(),
+): boolean {
+  return paymentDeadline.getTime() - now.getTime() >= MIN_PAYMENT_WINDOW_MINUTES * 60 * 1000;
+}
+
+export function computePaymentSessionExpiry(
+  paymentDeadline: Date,
+  now: Date = new Date(),
+): Date {
+  const sessionEnd = new Date(now.getTime() + PAYMENT_SESSION_MINUTES * 60 * 1000);
+  return sessionEnd < paymentDeadline ? sessionEnd : paymentDeadline;
+}
diff --git a/apps/edr-passenger-api/src/config/ebirr.config.ts b/apps/edr-passenger-api/src/config/ebirr.config.ts
deleted file mode 100644
index 0a00bca2a..000000000
--- a/apps/edr-passenger-api/src/config/ebirr.config.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-import { registerAs } from '@nestjs/config';
-
-export default registerAs('ebirr', () => ({
-  baseUrl: process.env.EBIRR_BASE_URL || '',
-  merchantCode: process.env.EBIRR_MERCHANT_CODE || '',
-  secretKey: process.env.EBIRR_SECRET_KEY || '',
-  notifyUrl: process.env.EBIRR_NOTIFY_URL || '',
-  returnUrl: process.env.EBIRR_RETURN_URL || '',
-}));
diff --git a/apps/edr-passenger-api/src/modules/audit/audit.controller.ts b/apps/edr-passenger-api/src/modules/audit/audit.controller.ts
index 3a1e94760..a56e5cf86 100644
--- a/apps/edr-passenger-api/src/modules/audit/audit.controller.ts
+++ b/apps/edr-passenger-api/src/modules/audit/audit.controller.ts
@@ -1,8 +1,9 @@
-import { Controller, Get, Param, Query } from '@nestjs/common';
+import { Controller, Get, Param, ParseIntPipe, Query } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery } from '@nestjs/swagger';
 import { AuditService } from '../../common/audit.service';
 import { PassengerStaff } from '../../common/passenger-guards';
 import { PASSENGER_PERMS } from '../../seed/passenger-permissions.registry';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
 
 @ApiTags('Audit')
 @Controller('audit')
@@ -16,24 +17,52 @@ export class AuditController {
     summary: 'Get audit logs',
     description: 'Retrieve system audit logs with optional filtering',
   })
-  @ApiQuery({ name: 'search', required: false, description: 'Search by user email or entity ID' })
-  @ApiQuery({ name: 'action', required: false, description: 'Filter by action (CREATE, UPDATE, DELETE, etc.)' })
-  @ApiQuery({ name: 'entityType', required: false, description: 'Filter by entity type (Booking, Station, etc.)' })
+  @ApiQuery({ name: 'search', required: false, description: 'Match entity ID, actor ID, actor name, or actor phone' })
+  @ApiQuery({ name: 'action', required: false, description: 'Filter by action (CREATE, UPDATE, DELETE, BOARD, WAIVE, ...)' })
+  @ApiQuery({ name: 'entityType', required: false, description: 'Filter by entity type (Booking, Station, Ticket, ...)' })
+  @ApiQuery({ name: 'iamUserId', required: false, description: 'Exact IAM user id — everything one staff member did' })
+  @ApiQuery({ name: 'from', required: false, description: 'Earliest createdAt (ISO 8601), inclusive' })
+  @ApiQuery({ name: 'to', required: false, description: 'Latest createdAt (ISO 8601), inclusive' })
+  @ApiQuery({ name: 'limit', required: false, type: Number, description: 'Page size (default 50, max 200)' })
+  @ApiQuery({ name: 'offset', required: false, type: Number, description: 'Rows to skip (default 0)' })
   async getLogs(
     @Query('search') search?: string,
     @Query('action') action?: string,
     @Query('entityType') entityType?: string,
+    @Query('iamUserId') iamUserId?: string,
+    @Query('from') from?: string,
+    @Query('to') to?: string,
+    // The service has always implemented paging; the controller simply never forwarded it, which
+    // pinned the backoffice page and its CSV export to the 50 newest rows.
+    @Query('limit', new ParseIntPipe({ optional: true })) limit?: number,
+    @Query('offset', new ParseIntPipe({ optional: true })) offset?: number,
   ) {
-    const filters = {
+    const result = await this.auditService.getLogs({
       search: search || undefined,
       action: action || undefined,
       entityType: entityType || undefined,
-    };
-
-    const result = await this.auditService.getLogs(filters);
+      iamUserId: iamUserId || undefined,
+      from: from || undefined,
+      to: to || undefined,
+      limit,
+      offset,
+    });
     return { items: result.data, total: result.total, limit: result.limit, offset: result.offset };
   }
 
+  /**
+   * The vocabularies the writers use, so the backoffice filters stay in step with what the API
+   * actually records instead of drifting behind a hand-maintained list.
+   */
+  @Get('vocabulary')
+  @ApiOperation({ summary: 'Audit action and entity-type vocabularies' })
+  getVocabulary() {
+    return {
+      actions: Object.values(AUDIT_ACTIONS),
+      entityTypes: Object.values(AUDIT_ENTITIES),
+    };
+  }
+
   @Get('logs/:id')
   @ApiOperation({ summary: 'Get audit log by ID' })
   async getLog(@Param('id') id: string) {
diff --git a/apps/edr-passenger-api/src/modules/bookings/booking-identity.util.spec.ts b/apps/edr-passenger-api/src/modules/bookings/booking-identity.util.spec.ts
new file mode 100644
index 000000000..f1acb6cd2
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/bookings/booking-identity.util.spec.ts
@@ -0,0 +1,130 @@
+import { BadRequestException } from '@nestjs/common';
+import { IdDocumentType } from '@prisma/client';
+import {
+  assertIdentitiesNotAlreadyBooked,
+  resolveIdentityRef,
+} from './booking-identity.util';
+import { PrismaService } from '../../common/prisma.service';
+
+// ── Fixtures ─────────────────────────────────────────────────────────────────
+
+const SCHEDULE = 'schedule-1';
+const RETURN_SCHEDULE = 'schedule-2';
+
+const makePrisma = (clash: any = null) =>
+  ({ bookingSeat: { findFirst: jest.fn().mockResolvedValue(clash) } }) as unknown as PrismaService;
+
+const traveller = (passengerName: string, identityRef: string | null) => ({
+  passengerName,
+  identityRef,
+});
+
+// ── resolveIdentityRef ───────────────────────────────────────────────────────
+
+describe('resolveIdentityRef', () => {
+  it('uses the Fayda sub for national-ID travellers', () => {
+    expect(
+      resolveIdentityRef({
+        idDocumentType: IdDocumentType.NATIONAL_ID,
+        faydaSub: 'psut-abc',
+        passportNumber: 'P1234567',
+      }),
+    ).toBe('psut-abc');
+  });
+
+  it('uses the passport number for passport travellers, normalised to upper case', () => {
+    expect(
+      resolveIdentityRef({
+        idDocumentType: IdDocumentType.PASSPORT,
+        faydaSub: 'psut-abc',
+        passportNumber: ' p1234567 ',
+      }),
+    ).toBe('P1234567');
+  });
+
+  it('returns null when there is nothing to key on — children and Fayda-disabled bookings', () => {
+    expect(resolveIdentityRef({ idDocumentType: IdDocumentType.NATIONAL_ID })).toBeNull();
+    expect(
+      resolveIdentityRef({ idDocumentType: IdDocumentType.NATIONAL_ID, faydaSub: '   ' }),
+    ).toBeNull();
+    expect(resolveIdentityRef({ idDocumentType: IdDocumentType.PASSPORT })).toBeNull();
+  });
+});
+
+// ── assertIdentitiesNotAlreadyBooked ─────────────────────────────────────────
+
+describe('assertIdentitiesNotAlreadyBooked', () => {
+  it('rejects the same identity used twice inside one payload', async () => {
+    const prisma = makePrisma();
+    await expect(
+      assertIdentitiesNotAlreadyBooked(
+        prisma,
+        [traveller('Abebe Kebede', 'psut-abc'), traveller('Sara Ali', 'psut-abc')],
+        [SCHEDULE],
+      ),
+    ).rejects.toThrow(BadRequestException);
+    // Rejected before touching the database.
+    expect(prisma.bookingSeat.findFirst).not.toHaveBeenCalled();
+  });
+
+  it('ignores passengers with no identity — two children never collide with each other', async () => {
+    const prisma = makePrisma();
+    await expect(
+      assertIdentitiesNotAlreadyBooked(
+        prisma,
+        [traveller('Child One', null), traveller('Child Two', null)],
+        [SCHEDULE],
+      ),
+    ).resolves.toBeUndefined();
+    expect(prisma.bookingSeat.findFirst).not.toHaveBeenCalled();
+  });
+
+  it('queries every leg of the booking, de-duplicated, for active bookings only', async () => {
+    const prisma = makePrisma();
+    await assertIdentitiesNotAlreadyBooked(
+      prisma,
+      [traveller('Abebe Kebede', 'psut-abc')],
+      [SCHEDULE, RETURN_SCHEDULE, SCHEDULE, null, undefined],
+    );
+
+    const { where } = (prisma.bookingSeat.findFirst as jest.Mock).mock.calls[0][0];
+    expect(where.scheduleId).toEqual({ in: [SCHEDULE, RETURN_SCHEDULE] });
+    expect(where.idDocumentNumber).toEqual({ in: ['psut-abc'] });
+    expect(where.booking.status.in).toEqual(['DRAFT', 'PENDING_PAYMENT', 'CONFIRMED', 'BOARDED']);
+  });
+
+  it('rejects an identity that already holds a ticket on the departure', async () => {
+    const prisma = makePrisma({
+      idDocumentNumber: 'psut-abc',
+      passengerName: 'Abebe K.',
+      booking: { bookingRef: 'ABCDEF', status: 'CONFIRMED' },
+    });
+
+    await expect(
+      assertIdentitiesNotAlreadyBooked(prisma, [traveller('Abebe Kebede', 'psut-abc')], [SCHEDULE]),
+    ).rejects.toThrow(/Abebe Kebede already has a ticket on this train \(booking ABCDEF\)/);
+  });
+
+  it('points an unpaid clash at the booking the traveller still has to settle', async () => {
+    const prisma = makePrisma({
+      idDocumentNumber: 'psut-abc',
+      passengerName: 'Abebe K.',
+      booking: { bookingRef: 'ABCDEF', status: 'PENDING_PAYMENT' },
+    });
+
+    await expect(
+      assertIdentitiesNotAlreadyBooked(prisma, [traveller('Abebe Kebede', 'psut-abc')], [SCHEDULE]),
+    ).rejects.toThrow(/already has an unpaid booking \(ABCDEF\)/);
+  });
+
+  it('allows the booking when nothing active matches — a cancelled ticket frees the identity', async () => {
+    const prisma = makePrisma(null);
+    await expect(
+      assertIdentitiesNotAlreadyBooked(
+        prisma,
+        [traveller('Abebe Kebede', 'psut-abc'), traveller('Sara Ali', 'P7654321')],
+        [SCHEDULE],
+      ),
+    ).resolves.toBeUndefined();
+  });
+});
diff --git a/apps/edr-passenger-api/src/modules/bookings/booking-identity.util.ts b/apps/edr-passenger-api/src/modules/bookings/booking-identity.util.ts
new file mode 100644
index 000000000..cd5385765
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/bookings/booking-identity.util.ts
@@ -0,0 +1,96 @@
+import { BadRequestException } from '@nestjs/common';
+import { BookingStatus, IdDocumentType } from '@prisma/client';
+import { PrismaService } from '../../common/prisma.service';
+
+/**
+ * Booking states that still hold a traveller's place on a departure. CANCELLED, REFUNDED and
+ * NO_SHOW are deliberately excluded: cancelling a ticket must immediately free the identity so
+ * the same person can book that train again. PENDING_PAYMENT counts — otherwise the whole check
+ * is bypassable by simply never finishing the first payment.
+ */
+const ACTIVE_BOOKING_STATUSES: BookingStatus[] = [
+  BookingStatus.DRAFT,
+  BookingStatus.PENDING_PAYMENT,
+  BookingStatus.CONFIRMED,
+  BookingStatus.BOARDED,
+];
+
+/**
+ * The single value that identifies a human across bookings: the Fayda subject identifier (PSUT)
+ * for Ethiopians, the passport number for everyone else. It is written to
+ * `BookingSeat.idDocumentNumber` — an existing column, so no migration — and compared there.
+ *
+ * Returns null when there is nothing to key on: children under 5 have no Fayda, and neither does
+ * a booking made while the Fayda integration is switched off. Those passengers are simply not
+ * deduplicated rather than being blocked.
+ *
+ * Both inputs come from the client, so this stops honest misuse of the booking form, not a
+ * hand-crafted POST. Binding the sub to the server-side verification session is the follow-up
+ * that would make it tamper-proof.
+ */
+export function resolveIdentityRef(passenger: {
+  idDocumentType?: IdDocumentType | null;
+  faydaSub?: string | null;
+  passportNumber?: string | null;
+}): string | null {
+  if (passenger.idDocumentType === IdDocumentType.PASSPORT) {
+    // Hand-typed, so normalise case — "p1234567" and "P1234567" are the same document.
+    const passport = passenger.passportNumber?.trim().toUpperCase();
+    return passport || null;
+  }
+  const sub = passenger.faydaSub?.trim();
+  return sub || null;
+}
+
+/**
+ * Rejects a booking when one identity would occupy more than one seat on the same departure —
+ * either twice within this payload, or once here and once on an existing active booking.
+ *
+ * Keyed on `BookingSeat.scheduleId`, which is per leg, so round-trip outbound/return and transit
+ * leg-1/leg-2 are naturally treated as separate departures and never collide with each other.
+ */
+export async function assertIdentitiesNotAlreadyBooked(
+  prisma: PrismaService,
+  passengers: Array<{ passengerName: string; identityRef: string | null }>,
+  scheduleIds: Array<string | null | undefined>,
+): Promise<void> {
+  const nameByIdentity = new Map<string, string>();
+  for (const passenger of passengers) {
+    if (!passenger.identityRef) continue;
+    const alreadyUsedBy = nameByIdentity.get(passenger.identityRef);
+    if (alreadyUsedBy !== undefined) {
+      throw new BadRequestException(
+        `${passenger.passengerName} and ${alreadyUsedBy} were verified with the same identity. ` +
+          `Each traveller must be verified with their own Fayda or passport.`,
+      );
+    }
+    nameByIdentity.set(passenger.identityRef, passenger.passengerName);
+  }
+
+  const identityRefs = [...nameByIdentity.keys()];
+  const targetScheduleIds = [...new Set(scheduleIds.filter((id): id is string => !!id))];
+  if (!identityRefs.length || !targetScheduleIds.length) return;
+
+  const clash = await prisma.bookingSeat.findFirst({
+    where: {
+      scheduleId: { in: targetScheduleIds },
+      idDocumentNumber: { in: identityRefs },
+      booking: { status: { in: ACTIVE_BOOKING_STATUSES } },
+    },
+    select: {
+      idDocumentNumber: true,
+      passengerName: true,
+      booking: { select: { bookingRef: true, status: true } },
+    },
+  });
+  if (!clash) return;
+
+  const traveller = nameByIdentity.get(clash.idDocumentNumber!) ?? clash.passengerName;
+  throw new BadRequestException(
+    clash.booking.status === BookingStatus.PENDING_PAYMENT
+      ? `${traveller} already has an unpaid booking (${clash.booking.bookingRef}) on this train. ` +
+          `Complete or cancel that booking before making a new one.`
+      : `${traveller} already has a ticket on this train (booking ${clash.booking.bookingRef}). ` +
+          `Each traveller may hold only one ticket per departure.`,
+  );
+}
diff --git a/apps/edr-passenger-api/src/modules/bookings/bookings.dto.ts b/apps/edr-passenger-api/src/modules/bookings/bookings.dto.ts
index 42d4af0d9..454339516 100644
--- a/apps/edr-passenger-api/src/modules/bookings/bookings.dto.ts
+++ b/apps/edr-passenger-api/src/modules/bookings/bookings.dto.ts
@@ -18,6 +18,7 @@ export class PassengerInputDto {
   dateOfBirth: Date;
   @ApiProperty({ example: 'NATIONAL_ID', enum: IdDocumentType, description: 'NATIONAL_ID for Ethiopians (Verifayda verified), PASSPORT for others' }) @IsEnum(IdDocumentType) idDocumentType: IdDocumentType;
   @ApiPropertyOptional({ example: 'ET123456789', description: 'Ethiopian national ID - verified via Verifayda 2.0 (NOT stored in database)' }) @IsOptional() @IsString() idDocumentNumber?: string;
+  @ApiPropertyOptional({ example: '8267a1f4-...', description: 'Fayda subject identifier (PSUT) from POST /fayda/verification/complete. Stored on the booking seat and compared across bookings so one Fayda identity cannot hold two seats on the same departure.' }) @IsOptional() @IsString() faydaSub?: string;
   @ApiPropertyOptional({ example: 'P1234567', description: 'Passport number for non-Ethiopian passengers (no verification)' }) @IsOptional() @IsString() passportNumber?: string;
   @ApiPropertyOptional({ example: 'Djibouti', description: 'Passport issuing country for non-Ethiopians' }) @IsOptional() @IsString() passportCountry?: string;
   @ApiPropertyOptional({ example: 'Ethiopian', description: 'Ethiopian (Verifayda + Telebirr/CBE/eBirr), Djiboutian (Passport + Waafi), Other (Passport + Card)' }) @IsOptional() @IsString() nationality?: string;
@@ -67,11 +68,19 @@ export class RoundTripPassengerDto {
     description: 'Ethiopian national ID - verified via Verifayda 2.0 (NOT stored in database)' 
   }) 
   @IsOptional() @IsString() idDocumentNumber?: string;
-  
-  @ApiPropertyOptional({ 
-    example: 'P1234567', 
-    description: 'Passport number for non-Ethiopian passengers (no verification)' 
-  }) 
+
+  @ApiPropertyOptional({
+    example: '8267a1f4-...',
+    description:
+      'Fayda subject identifier (PSUT) from POST /fayda/verification/complete. Stored on the booking seat ' +
+      'and compared across bookings so one Fayda identity cannot hold two seats on the same departure.'
+  })
+  @IsOptional() @IsString() faydaSub?: string;
+
+  @ApiPropertyOptional({
+    example: 'P1234567',
+    description: 'Passport number for non-Ethiopian passengers (no verification)'
+  })
   @IsOptional() @IsString() passportNumber?: string;
   
   @ApiPropertyOptional({ 
diff --git a/apps/edr-passenger-api/src/modules/bookings/bookings.service.ts b/apps/edr-passenger-api/src/modules/bookings/bookings.service.ts
index 7f0a6eee5..fc958be70 100644
--- a/apps/edr-passenger-api/src/modules/bookings/bookings.service.ts
+++ b/apps/edr-passenger-api/src/modules/bookings/bookings.service.ts
@@ -6,6 +6,7 @@ import { SeatsService } from '../seats/seats.service';
 import { TicketsService } from '../tickets/tickets.service';
 import { EventEmitter2 } from '@nestjs/event-emitter';
 import { CreateBookingDto, ModifyBookingDto } from './bookings.dto';
+import { assertIdentitiesNotAlreadyBooked, resolveIdentityRef } from './booking-identity.util';
 import { Cron, CronExpression } from '@nestjs/schedule';
 import { VerifaydaService } from '../verifayda/verifayda.service';
 import { CurrencyService } from '../currency/currency.service';
@@ -13,6 +14,7 @@ import { FareEngineService } from '../fare-engine/fare-engine.service';
 import { PaymentsService } from '../payments/payments.service';
 import { MAX_PAYMENT_HOURS } from '../../common/utils/payment-deadline.utils';
 import { Currency, PassengerCategory, IdDocumentType } from '@prisma/client';
+import { JourneyDirection } from '../seats/seats.dto';
 import { resolveCurrencyFromNationality } from '../fare-engine/fare-engine.dto';
 import { DeleteOperationException } from '../../common/exceptions/delete-operation.exception';
 import { AuditService } from '../../common/audit.service';
@@ -856,11 +858,24 @@ export class BookingsService {
     const destStop = schedule.stopTimes.find(s => s.stationId === dto.destinationStationId);
     if (!originStop || !destStop) throw new NotFoundException('Origin or destination not found');
 
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.scheduleId,
+      seatIds: requestedSeatIds,
+      originStationId: dto.originStationId,
+      destinationStationId: dto.destinationStationId,
+      journeyDirection: JourneyDirection.ONE_WAY,
+    });
+
     const [passengersData, iamContact] = await Promise.all([
       this.processPassengers(dto.passengers as any[]),
       this.resolveIamContact(dto.passengerId),
     ]);
     const { adultCount, childCount } = this.countPassengers(passengersData);
+
+    // One traveller, one seat per departure — checked before any fare/hold work so a rejected
+    // booking leaves nothing behind.
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [dto.scheduleId]);
+
     const fareCalculation = dto.packageId && dto.priceTierId
       ? await this.calculatePackageFare(dto.priceTierId, adultCount, childCount)
       : await this.calculateFare(dto.scheduleId, dto.seatClassId, originStop, destStop, passengersData[0]?.nationality, adultCount, childCount, dto.promoCode, dto.loyaltyRedemptionPoints);
@@ -988,6 +1003,7 @@ export class BookingsService {
             dateOfBirth: p.dateOfBirth,
             passengerCategory: p.category,
             idDocumentType: p.idDocumentType,
+            idDocumentNumber: p.identityRef,
             passportNumber: p.passportNumber,
             passportCountry: p.passportCountry,
             verifaydaVerified: p.verifaydaVerified,
@@ -1052,12 +1068,32 @@ export class BookingsService {
       throw new NotFoundException('Origin or destination stops not found');
     }
 
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.scheduleId,
+      seatIds: holdObSeatIds,
+      originStationId: dto.originStationId,
+      destinationStationId: dto.destinationStationId,
+      journeyDirection: JourneyDirection.OUTBOUND,
+    });
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.returnScheduleId,
+      seatIds: holdRetSeatIds,
+      originStationId: dto.returnOriginStationId,
+      destinationStationId: dto.returnDestinationStationId,
+      journeyDirection: JourneyDirection.RETURN,
+    });
+
     const [passengersData, iamContact] = await Promise.all([
       this.processRoundTripPassengers(dto.passengers as any[]),
       this.resolveIamContact(dto.passengerId),
     ]);
     const { adultCount, childCount } = this.countPassengers(passengersData);
 
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [
+      dto.scheduleId,
+      dto.returnScheduleId,
+    ]);
+
     // Package bookings use fixed tier price split equally across both legs
     let outboundFare: Awaited<ReturnType<typeof this.calculateFare>>;
     let returnFare:   Awaited<ReturnType<typeof this.calculateFare>>;
@@ -1196,6 +1232,7 @@ export class BookingsService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1211,6 +1248,7 @@ export class BookingsService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1295,12 +1333,32 @@ export class BookingsService {
     if (!leg1OriginStop || !leg1DestStop) throw new NotFoundException('Leg-1 origin or transit station not found on schedule');
     if (!leg2OriginStop || !leg2DestStop) throw new NotFoundException('Transit or leg-2 destination station not found on leg-2 schedule');
 
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.scheduleId,
+      seatIds: leg1SeatIds,
+      originStationId: dto.originStationId,
+      destinationStationId: dto.transitStationId,
+      journeyDirection: JourneyDirection.ONE_WAY,
+    });
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.leg2ScheduleId,
+      seatIds: leg2SeatIds,
+      originStationId: dto.transitStationId,
+      destinationStationId: dto.leg2DestinationStationId,
+      journeyDirection: JourneyDirection.ONE_WAY,
+    });
+
     const [passengersData, iamContact] = await Promise.all([
       this.processPassengers(dto.passengers as any[]),
       this.resolveIamContact(dto.passengerId),
     ]);
     const { adultCount, childCount } = this.countPassengers(passengersData);
 
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [
+      dto.scheduleId,
+      dto.leg2ScheduleId,
+    ]);
+
     const leg2SeatClassId = dto.leg2SeatClassId ?? dto.seatClassId;
     const [leg1Fare, leg2Fare] = await Promise.all([
       this.calculateFare(dto.scheduleId, dto.seatClassId, leg1OriginStop, leg1DestStop, passengersData[0]?.nationality, adultCount, childCount),
@@ -1386,6 +1444,7 @@ export class BookingsService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1401,6 +1460,7 @@ export class BookingsService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1490,11 +1550,48 @@ export class BookingsService {
     if (!retL1Origin || !retL1Dest) throw new NotFoundException('Return leg-1: origin or transit station not found');
     if (!retL2Origin || !retL2Dest) throw new NotFoundException('Return leg-2: transit or destination not found');
 
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.scheduleId,
+      seatIds: (dto.passengers as any[]).map(p => p.seatId),
+      originStationId: dto.originStationId,
+      destinationStationId: dto.transitStationId,
+      journeyDirection: JourneyDirection.OUTBOUND,
+    });
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.leg2ScheduleId,
+      seatIds: (dto.passengers as any[]).map(p => p.leg2SeatId ?? p.seatId),
+      originStationId: dto.transitStationId,
+      destinationStationId: dto.leg2DestinationStationId,
+      journeyDirection: JourneyDirection.OUTBOUND,
+    });
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.returnScheduleId,
+      seatIds: (dto.passengers as any[]).map(p => p.returnSeatId),
+      originStationId: dto.returnOriginStationId,
+      destinationStationId: dto.returnTransitStationId,
+      journeyDirection: JourneyDirection.RETURN,
+    });
+    await this.seatsService.assertNoRouteSeatConflict({
+      scheduleId: dto.returnLeg2ScheduleId,
+      seatIds: (dto.passengers as any[]).map(p => p.returnLeg2SeatId ?? p.returnSeatId),
+      originStationId: dto.returnTransitStationId,
+      destinationStationId: dto.returnLeg2DestinationStationId,
+      journeyDirection: JourneyDirection.RETURN,
+    });
+
     const [passengersData, iamContact] = await Promise.all([
       this.processRoundTripPassengers(dto.passengers as any[]),
       this.resolveIamContact(dto.passengerId),
     ]);
     const { adultCount, childCount } = this.countPassengers(passengersData);
+
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [
+      dto.scheduleId,
+      dto.leg2ScheduleId,
+      dto.returnScheduleId,
+      dto.returnLeg2ScheduleId,
+    ]);
+
     const nat = passengersData[0]?.nationality;
 
     const obL2SeatClassId  = dto.leg2SeatClassId        ?? dto.seatClassId;
@@ -1558,6 +1655,7 @@ export class BookingsService {
       dateOfBirth: p.dateOfBirth,
       passengerCategory: p.category,
       idDocumentType: p.idDocumentType,
+      idDocumentNumber: p.identityRef,
       passportNumber: p.passportNumber,
       passportCountry: p.passportCountry,
       verifaydaVerified: p.verifaydaVerified,
@@ -1659,7 +1757,7 @@ export class BookingsService {
         nationality = nationality || (passenger.passportCountry === 'Djibouti' ? 'Djiboutian' : 'Other');
       }
 
-      processedPassengers.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality });
+      processedPassengers.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality, identityRef: resolveIdentityRef(passenger) });
     }
     return processedPassengers;
   }
@@ -1696,6 +1794,7 @@ export class BookingsService {
         verifaydaVerified,
         verifaydaData,
         nationality,
+        identityRef: resolveIdentityRef(passenger),
         // Normalise: PassengerInputDto uses seatId/returnSeatId; RoundTripPassengerDto uses
         // outboundSeatId/returnSeatId. Accept either form so both DTOs work.
         outboundSeatId:    passenger.outboundSeatId    ?? passenger.seatId,
diff --git a/apps/edr-passenger-api/src/modules/bookings/guest-booking.dto.ts b/apps/edr-passenger-api/src/modules/bookings/guest-booking.dto.ts
index ac60b8480..7065b6183 100644
--- a/apps/edr-passenger-api/src/modules/bookings/guest-booking.dto.ts
+++ b/apps/edr-passenger-api/src/modules/bookings/guest-booking.dto.ts
@@ -25,10 +25,19 @@ export class GuestPassengerDto {
   @ApiProperty({ example: 'NATIONAL_ID', enum: IdDocumentType, description: 'NATIONAL_ID for Ethiopians (Verifayda verified), PASSPORT for others' }) 
   @IsEnum(IdDocumentType) idDocumentType: IdDocumentType;
 
-  @ApiPropertyOptional({ example: 'ET123456789', description: 'Ethiopian national ID - verified via Verifayda 2.0 (NOT stored)' }) 
+  @ApiPropertyOptional({ example: 'ET123456789', description: 'Ethiopian national ID - verified via Verifayda 2.0 (NOT stored)' })
   @IsOptional() @IsString() idDocumentNumber?: string;
 
-  @ApiPropertyOptional({ example: 'P1234567', description: 'Passport number for non-Ethiopians' }) 
+  @ApiPropertyOptional({
+    example: '8267a1f4-...',
+    description:
+      'Fayda subject identifier (PSUT) returned by POST /fayda/verification/complete for this traveller. ' +
+      'Stored on the booking seat and compared across bookings so one Fayda identity cannot hold two ' +
+      'seats on the same departure. Omit for children under 5 and non-Ethiopians (the passport number is used instead).',
+  })
+  @IsOptional() @IsString() faydaSub?: string;
+
+  @ApiPropertyOptional({ example: 'P1234567', description: 'Passport number for non-Ethiopians' })
   @IsOptional() @IsString() passportNumber?: string;
 
   @ApiPropertyOptional({ example: 'Djibouti', description: 'Passport issuing country' }) 
diff --git a/apps/edr-passenger-api/src/modules/bookings/guest-booking.service.ts b/apps/edr-passenger-api/src/modules/bookings/guest-booking.service.ts
index c8061184f..5484aa658 100644
--- a/apps/edr-passenger-api/src/modules/bookings/guest-booking.service.ts
+++ b/apps/edr-passenger-api/src/modules/bookings/guest-booking.service.ts
@@ -12,7 +12,9 @@ import { EventEmitter2 } from '@nestjs/event-emitter';
 import { PaymentsService } from '../payments/payments.service';
 import { SmsClientService } from '../notifications/sms-client.service';
 import { CreateGuestBookingDto, SavedPassengerProfileDto, IssueReservationBookingDto, ReservationBookingKind } from './guest-booking.dto';
+import { assertIdentitiesNotAlreadyBooked, resolveIdentityRef } from './booking-identity.util';
 import { Currency, PassengerCategory, IdDocumentType, PaymentMethodType, PaymentIntentStatus } from '@prisma/client';
+import { JourneyDirection } from '../seats/seats.dto';
 import { resolveCheckinCutoff } from '../../common/utils/checkin-cutoff.utils';
 import { computePaymentDeadline } from '../../common/utils/payment-deadline.utils';
 import { randomUUID } from 'crypto';
@@ -225,9 +227,14 @@ export class GuestBookingService {
         verifaydaVerified,
         verifaydaData,
         nationality,
+        identityRef: resolveIdentityRef(passenger),
       });
     }
 
+    // One traveller, one seat per departure — checked before any fare/hold work so a rejected
+    // booking leaves nothing behind.
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [dto.scheduleId]);
+
     // Calculate fare — package bookings use the fixed tier price, bypassing the fare engine
     const isPackageOneway = !!dto.packageId && !!dto.priceTierId;
     let baseFareMinor: number;
@@ -392,6 +399,7 @@ export class GuestBookingService {
             dateOfBirth: p.dateOfBirth,
             passengerCategory: p.category,
             idDocumentType: p.idDocumentType,
+            idDocumentNumber: p.identityRef,
             passportNumber: p.passportNumber,
             passportCountry: p.passportCountry,
             verifaydaVerified: p.verifaydaVerified,
@@ -772,9 +780,14 @@ export class GuestBookingService {
         nationality = nationality || 'Other';
       }
 
-      passengersData.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality });
+      passengersData.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality, identityRef: resolveIdentityRef(passenger) });
     }
 
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [
+      dto.scheduleId,
+      dto.returnScheduleId,
+    ]);
+
     // Calculate fares for both legs — package bookings use the fixed tier price split across legs
     const returnSeatClassId = dto.returnSeatClassId || dto.seatClassId;
     const isPackageRoundTrip = !!dto.packageId && !!dto.priceTierId;
@@ -935,6 +948,7 @@ export class GuestBookingService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -950,6 +964,7 @@ export class GuestBookingService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1072,9 +1087,14 @@ export class GuestBookingService {
       } else {
         nationality = nationality || 'Other';
       }
-      passengersData.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality });
+      passengersData.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality, identityRef: resolveIdentityRef(passenger) });
     }
 
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [
+      dto.scheduleId,
+      dto.leg2ScheduleId,
+    ]);
+
     const leg2SeatClassId = dto.leg2SeatClassId || dto.seatClassId;
     const primaryNationality = passengersData[0]?.nationality;
     const paidChildrenCount = Math.max(0, childCount - 1);
@@ -1145,6 +1165,7 @@ export class GuestBookingService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1160,6 +1181,7 @@ export class GuestBookingService {
               dateOfBirth: p.dateOfBirth,
               passengerCategory: p.category,
               idDocumentType: p.idDocumentType,
+              idDocumentNumber: p.identityRef,
               passportNumber: p.passportNumber,
               passportCountry: p.passportCountry,
               verifaydaVerified: p.verifaydaVerified,
@@ -1282,9 +1304,16 @@ export class GuestBookingService {
       } else {
         nationality = nationality || 'Other';
       }
-      passengersData.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality });
+      passengersData.push({ ...passenger, passengerName, dateOfBirth, category, verifaydaVerified, verifaydaData, nationality, identityRef: resolveIdentityRef(passenger) });
     }
 
+    await assertIdentitiesNotAlreadyBooked(this.prisma, passengersData, [
+      dto.scheduleId,
+      dto.leg2ScheduleId,
+      dto.returnScheduleId,
+      dto.returnLeg2ScheduleId,
+    ]);
+
     const nat = passengersData[0]?.nationality;
     const paidChildren = Math.max(0, childCount - 1);
     const obL2ClassId = dto.leg2SeatClassId ?? dto.seatClassId;
@@ -1325,6 +1354,7 @@ export class GuestBookingService {
       dateOfBirth: p.dateOfBirth,
       passengerCategory: p.category,
       idDocumentType: p.idDocumentType,
+      idDocumentNumber: p.identityRef,
       passportNumber: p.passportNumber,
       passportCountry: p.passportCountry,
       verifaydaVerified: p.verifaydaVerified,
diff --git a/apps/edr-passenger-api/src/modules/currencies/currencies.service.ts b/apps/edr-passenger-api/src/modules/currencies/currencies.service.ts
index 648deb77c..6d1112175 100644
--- a/apps/edr-passenger-api/src/modules/currencies/currencies.service.ts
+++ b/apps/edr-passenger-api/src/modules/currencies/currencies.service.ts
@@ -3,6 +3,7 @@ import { PrismaService } from '../../common/prisma.service';
 import { CurrencyService } from '../currency/currency.service';
 import { CreateCurrencyDto, UpdateCurrencyDto } from './currencies.dto';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
 
 @Injectable()
 export class CurrenciesService {
@@ -59,7 +60,17 @@ export class CurrenciesService {
       },
     });
 
-    await this.auditService.log({ action: 'CREATE', entityType: 'Currency', entityId: rate.id, newData: { code, exchangeRate } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Currency,
+      entityId: rate.id,
+      newData: {
+        fromCurrency: rate.fromCurrency,
+        toCurrency: rate.toCurrency,
+        rate: Number(rate.rate),
+        source: rate.source,
+      },
+    });
     return {
       id: rate.id,
       code: rate.toCurrency,
@@ -95,7 +106,22 @@ export class CurrenciesService {
       'MANUAL',
     );
 
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Currency', entityId: updated.id, newData: { exchangeRate: Number(updated.rate) } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Currency,
+      entityId: updated.id,
+      oldData: {
+        fromCurrency: existing.fromCurrency,
+        toCurrency: existing.toCurrency,
+        rate: Number(existing.rate),
+      },
+      newData: {
+        fromCurrency: updated.fromCurrency,
+        toCurrency: updated.toCurrency,
+        rate: Number(updated.rate),
+        source: updated.source,
+      },
+    });
     return {
       id: updated.id,
       code: updated.toCurrency,
@@ -112,6 +138,8 @@ export class CurrenciesService {
   async syncExchangeRates() {
     // Placeholder: in production this would fetch from an external FX API.
     // For now, return the current rates as-is.
+    // Deliberately unaudited: this writes nothing today. Instrument it in the same commit that
+    // gives it a real external fetch, otherwise the trail claims a change that never happened.
     const currencies = await this.getAllCurrencies();
     return { synced: true, rates: currencies };
   }
@@ -129,7 +157,16 @@ export class CurrenciesService {
     await this.prisma.currencyExchangeRate.deleteMany({
       where: { fromCurrency: existing.fromCurrency, toCurrency: existing.toCurrency },
     });
-    await this.auditService.log({ action: 'DELETE', entityType: 'Currency', entityId: id, oldData: { toCurrency: existing.toCurrency } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Currency,
+      entityId: id,
+      oldData: {
+        fromCurrency: existing.fromCurrency,
+        toCurrency: existing.toCurrency,
+        rate: Number(existing.rate),
+      },
+    });
     return { message: 'Currency deleted successfully' };
   }
 
diff --git a/apps/edr-passenger-api/src/modules/dashboard/dashboard.controller.ts b/apps/edr-passenger-api/src/modules/dashboard/dashboard.controller.ts
index eb7bd33b6..6f74ab412 100644
--- a/apps/edr-passenger-api/src/modules/dashboard/dashboard.controller.ts
+++ b/apps/edr-passenger-api/src/modules/dashboard/dashboard.controller.ts
@@ -1,4 +1,4 @@
-import { Controller, Get, Param, SetMetadata, UseGuards } from '@nestjs/common';
+import { Controller, Get, Param, Query, SetMetadata, UseGuards } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
 import { DashboardService } from './dashboard.service';
 import { JwtGuard } from '../../common/jwt.guard';
@@ -16,6 +16,27 @@ export class DashboardController {
   @ApiOperation({ summary: 'Backoffice summary: totals and revenue by currency' })
   getBackofficeStats() { return this.service.getBackofficeStats(); }
 
+  // Two segments, so the single-segment `@Get(':passengerId')` below cannot swallow it
+  // however the routes are ordered. Staff-guarded like backoffice-stats, not JwtGuard.
+  @Get('analytics/bookings')
+  @PassengerStaff([PASSENGER_PERMS.dashboard.view, PASSENGER_PERMS.admin])
+  @ApiBearerAuth('IAM-auth')
+  @ApiOperation({
+    summary: 'Booking analytics for the dashboard charts',
+    description:
+      'Revenue trend, daily confirmed bookings, booking status distribution and payment-method split over the ' +
+      'last `days` days (default 30), bucketed by booking creation date.\n\n' +
+      'Revenue and the daily count cover CONFIRMED and BOARDED bookings; the status and payment-method ' +
+      'breakdowns cover every booking in range — the same asymmetry the /reports/overall page applies, kept so ' +
+      'the two agree.\n\n' +
+      'Revenue is returned per currency and unconverted; the caller applies its own exchange rates. These ' +
+      'figures answer "what was booked" and will not match the Revenue Breakdown card, which requires a ' +
+      'SUCCEEDED payment intent and answers "what was collected".',
+  })
+  getBookingAnalytics(@Query('days') days?: string) {
+    return this.service.getBookingAnalytics(days ? Number(days) : undefined);
+  }
+
   @Get(':passengerId')
   @UseGuards(JwtGuard)
   @ApiBearerAuth('JWT-auth')
diff --git a/apps/edr-passenger-api/src/modules/dashboard/dashboard.service.ts b/apps/edr-passenger-api/src/modules/dashboard/dashboard.service.ts
index f7e015e11..79891a023 100644
--- a/apps/edr-passenger-api/src/modules/dashboard/dashboard.service.ts
+++ b/apps/edr-passenger-api/src/modules/dashboard/dashboard.service.ts
@@ -3,6 +3,11 @@ import { InjectDataSource } from '@nestjs/typeorm';
 import { DataSource } from 'typeorm';
 import { PrismaService } from '../../common/prisma.service';
 
+// ── Booking analytics (backoffice dashboard charts) ──────────────────────────
+const MS_PER_DAY_ANALYTICS = 24 * 60 * 60 * 1000;
+const ANALYTICS_DEFAULT_DAYS = 30;
+const ANALYTICS_MAX_DAYS = 365;
+
 @Injectable()
 export class DashboardService {
   constructor(
@@ -63,6 +68,109 @@ export class DashboardService {
     };
   }
 
+  /**
+   * Booking analytics for the backoffice dashboard charts — revenue trend, daily
+   * confirmed bookings, status distribution and payment-method split.
+   *
+   * Ported from the client-side computation on `/reports/overall`, which pulled up to
+   * 5000 bookings into the browser and grouped them there. The dashboard is the landing
+   * page and refetches on an interval, so the grouping happens here instead.
+   *
+   * Two asymmetries are inherited from that report on purpose, so the dashboard and the
+   * report show the same figures:
+   *   - Revenue and the daily count use CONFIRMED and BOARDED only; the status and
+   *     payment-method breakdowns use every booking in range.
+   *   - Everything buckets on `createdAt` — when the booking was made, not when the
+   *     train departs.
+   *
+   * Revenue here will NOT equal the dashboard's Revenue Breakdown card, which
+   * additionally requires a SUCCEEDED PaymentIntent and prefers the display amounts
+   * (see getBackofficeStats). Different question, deliberately not reconciled: this is
+   * "what was booked", that is "what was collected".
+   */
+  async getBookingAnalytics(daysRaw?: number) {
+    const days = Math.min(
+      Math.max(Math.trunc(daysRaw || ANALYTICS_DEFAULT_DAYS), 1),
+      ANALYTICS_MAX_DAYS,
+    );
+    const to = new Date();
+    const from = new Date(to.getTime() - days * MS_PER_DAY_ANALYTICS);
+
+    const bookings = await this.prisma.booking.findMany({
+      where: { createdAt: { gte: from, lte: to } },
+      select: {
+        createdAt: true,
+        status: true,
+        totalMinor: true,
+        currency: true,
+        paymentIntent: { select: { method: true } },
+      },
+    });
+
+    const isConfirmed = (status: string) => status === 'CONFIRMED' || status === 'BOARDED';
+
+    // Day buckets keyed on the UTC calendar date, so the axis and the bars derive from
+    // one value and cannot disagree.
+    const byDayMap = new Map<
+      string,
+      { date: string; bookings: number; revenueByCurrency: Map<string, number> }
+    >();
+    const statusCounts = new Map<string, number>();
+    const methodCounts = new Map<string, number>();
+
+    for (const booking of bookings) {
+      // Status and payment method count every booking in range.
+      const status = booking.status ?? 'UNKNOWN';
+      statusCounts.set(status, (statusCounts.get(status) ?? 0) + 1);
+
+      const method = booking.paymentIntent?.method ?? 'UNKNOWN';
+      methodCounts.set(method, (methodCounts.get(method) ?? 0) + 1);
+
+      // Revenue and the daily count are confirmed travel only.
+      if (!isConfirmed(booking.status)) continue;
+
+      const date = booking.createdAt.toISOString().slice(0, 10);
+      const bucket =
+        byDayMap.get(date) ?? { date, bookings: 0, revenueByCurrency: new Map<string, number>() };
+      bucket.bookings += 1;
+
+      const currency = booking.currency ?? 'ETB';
+      bucket.revenueByCurrency.set(
+        currency,
+        (bucket.revenueByCurrency.get(currency) ?? 0) + (booking.totalMinor ?? 0),
+      );
+      byDayMap.set(date, bucket);
+    }
+
+    const byDay = [...byDayMap.values()]
+      .sort((a, b) => a.date.localeCompare(b.date))
+      .map((bucket) => ({
+        date: bucket.date,
+        bookings: bucket.bookings,
+        revenueByCurrency: [...bucket.revenueByCurrency.entries()].map(
+          ([currency, totalMinor]) => ({ currency, totalMinor }),
+        ),
+      }));
+
+    const rank = <T extends { count: number }>(rows: T[]) =>
+      rows.sort((a, b) => b.count - a.count);
+
+    return {
+      window: { from, to, days },
+      totals: {
+        bookings: bookings.length,
+        confirmedBookings: bookings.filter((b) => isConfirmed(b.status)).length,
+      },
+      byDay,
+      statusDistribution: rank(
+        [...statusCounts.entries()].map(([status, count]) => ({ status, count })),
+      ),
+      paymentMethods: rank(
+        [...methodCounts.entries()].map(([method, count]) => ({ method, count })),
+      ),
+    };
+  }
+
   async getHomeDashboard(passengerId: string) {
     const now = new Date();
     const [passenger, upcomingBooking, wallet, promos, weatherAlerts, stationSignals, savedRoutes] = await Promise.all([
diff --git a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage-audit.spec.ts b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage-audit.spec.ts
new file mode 100644
index 000000000..58bc5ffed
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage-audit.spec.ts
@@ -0,0 +1,229 @@
+import { ExcessBaggageService } from './excess-baggage.service';
+
+/**
+ * Excess baggage settles through two paths — the in-app one (`markPaid`, reached from
+ * `initiatePayment`/`confirmOtp`) and the payment webhook. The in-app path used to write no
+ * audit row at all, so whether a settlement was recorded depended on which route reached it
+ * first. Both now claim the transition conditionally, so it lands exactly once either way.
+ */
+describe('ExcessBaggageService — audit', () => {
+  const CHARGE_ID = 'ebc-1';
+  const BOOKING_ID = 'booking-1';
+
+  let prisma: Record<string, any>;
+  let audit: { log: jest.Mock };
+  let service: ExcessBaggageService;
+
+  const build = (charge: Record<string, any> = {}) => {
+    const row = {
+      id: CHARGE_ID,
+      bookingId: BOOKING_ID,
+      agentId: 'iam-agent-1',
+      excessWeightKg: 8,
+      feePerKgMinor: 5000,
+      totalMinor: 40000,
+      currency: 'ETB',
+      status: 'PENDING',
+      paymentToken: 'tok-live-secret',
+      contactPhone: '+251911223344',
+      contactEmail: 'passenger@example.com',
+      expiresAt: new Date(Date.now() + 30 * 60 * 1000),
+      booking: { bookingRef: 'EDR-0001', passengerId: 'p-1' },
+      ...charge,
+    };
+
+    prisma = {
+      excessBaggageCharge: {
+        findUnique: jest.fn().mockResolvedValue(row),
+        // Default: this caller wins the race and flips the row.
+        updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+        update: jest.fn().mockResolvedValue({ ...row, status: 'WAIVED' }),
+        delete: jest.fn().mockResolvedValue(row),
+        create: jest.fn().mockResolvedValue(row),
+      },
+      baggageAllowance: {
+        findFirst: jest.fn().mockResolvedValue(null),
+        findUnique: jest.fn().mockResolvedValue(null),
+        create: jest.fn(),
+        update: jest.fn(),
+        deleteMany: jest.fn().mockResolvedValue({ count: 1 }),
+      },
+    };
+    audit = { log: jest.fn().mockResolvedValue(undefined) };
+
+    // Constructor order: prisma, audit, currency, paymentClient, notifications, sms, email.
+    service = new ExcessBaggageService(
+      prisma as any,
+      audit as any,
+      {} as any,
+      {} as any,
+      {} as any,
+      { sendSms: jest.fn() } as any,
+      { sendEmail: jest.fn() } as any,
+    );
+    return row;
+  };
+
+  const rows = () => audit.log.mock.calls.map((c) => c[0]);
+  const byAction = (action: string) => rows().filter((r) => r.action === action);
+
+  describe('markPaid', () => {
+    it('writes one PAY row when it actually flips the charge', async () => {
+      build();
+      await service.markPaid(CHARGE_ID, 'TXN-77');
+
+      expect(byAction('PAY')).toHaveLength(1);
+      expect(byAction('PAY')[0]).toMatchObject({
+        entityType: 'ExcessBaggageCharge',
+        entityId: CHARGE_ID,
+        oldData: { status: 'PENDING' },
+      });
+      expect(byAction('PAY')[0].newData).toMatchObject({
+        status: 'PAID',
+        bookingId: BOOKING_ID,
+        totalMinor: 40000,
+        providerTxnId: 'TXN-77',
+      });
+    });
+
+    it('writes nothing when the webhook already claimed the transition', async () => {
+      build();
+      // count: 0 means another caller flipped the row first and already logged it.
+      prisma.excessBaggageCharge.updateMany.mockResolvedValue({ count: 0 });
+      await service.markPaid(CHARGE_ID, 'TXN-77');
+
+      expect(byAction('PAY')).toHaveLength(0);
+    });
+
+    it('is a no-op on a charge already read as PAID', async () => {
+      build({ status: 'PAID' });
+      await service.markPaid(CHARGE_ID);
+
+      expect(audit.log).not.toHaveBeenCalled();
+      expect(prisma.excessBaggageCharge.updateMany).not.toHaveBeenCalled();
+    });
+
+    it('never puts the payment token on the row', async () => {
+      build();
+      await service.markPaid(CHARGE_ID, 'TXN-77');
+      expect(JSON.stringify(rows())).not.toContain('tok-live-secret');
+    });
+  });
+
+  describe('waiveCharge', () => {
+    it('records WAIVE with the status it moved from', async () => {
+      build();
+      await service.waiveCharge(CHARGE_ID, { waivedBy: 'Supervisor Bob', waivedReason: 'goodwill' });
+
+      expect(byAction('WAIVE')).toHaveLength(1);
+      expect(byAction('WAIVE')[0]).toMatchObject({
+        entityType: 'ExcessBaggageCharge',
+        entityId: CHARGE_ID,
+        oldData: { status: 'PENDING' },
+      });
+    });
+
+    it('does not let the request body become the audit actor', async () => {
+      build();
+      await service.waiveCharge(CHARGE_ID, { waivedBy: 'somebody-else', waivedReason: 'x' });
+
+      // `waivedBy` is descriptive context only; the actor comes from the session inside
+      // AuditService, so no call site sets `userId`.
+      const row = byAction('WAIVE')[0];
+      expect(row.userId).toBeUndefined();
+      expect(row.newData.waivedBy).toBe('somebody-else');
+    });
+
+    it('records nothing when the waiver is refused', async () => {
+      build({ status: 'PAID' });
+      await expect(
+        service.waiveCharge(CHARGE_ID, { waivedBy: 'Bob' }),
+      ).rejects.toThrow();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('deleteCharge', () => {
+    it('records the hard delete of a money record', async () => {
+      build();
+      await service.deleteCharge(CHARGE_ID);
+
+      expect(byAction('DELETE')).toHaveLength(1);
+      expect(byAction('DELETE')[0].oldData).toMatchObject({
+        bookingId: BOOKING_ID,
+        totalMinor: 40000,
+        status: 'PENDING',
+      });
+    });
+  });
+
+  describe('baggage allowances (Tariff Rates)', () => {
+    it('records a CREATE when no allowance existed', async () => {
+      build();
+      prisma.baggageAllowance.create.mockResolvedValue({
+        id: 'ba-1',
+        seatClassId: 'sc-1',
+        maxWeightKg: 20,
+        maxPiecesCount: 2,
+        excessFeePerKg: 5000,
+      });
+
+      await service.upsertAllowance({ seatClassId: 'sc-1', maxWeightKg: 20, excessFeePerKg: 5000 });
+
+      expect(byAction('CREATE')).toHaveLength(1);
+      expect(byAction('CREATE')[0]).toMatchObject({ entityType: 'BaggageAllowance', entityId: 'ba-1' });
+    });
+
+    it('records an UPDATE with the previous fee when one already existed', async () => {
+      build();
+      prisma.baggageAllowance.findFirst.mockResolvedValue({
+        id: 'ba-1',
+        seatClassId: 'sc-1',
+        maxWeightKg: 20,
+        maxPiecesCount: 2,
+        excessFeePerKg: 5000,
+      });
+      prisma.baggageAllowance.update.mockResolvedValue({
+        id: 'ba-1',
+        seatClassId: 'sc-1',
+        maxWeightKg: 25,
+        maxPiecesCount: 2,
+        excessFeePerKg: 7500,
+      });
+
+      await service.upsertAllowance({ seatClassId: 'sc-1', maxWeightKg: 25, excessFeePerKg: 7500 });
+
+      const row = byAction('UPDATE')[0];
+      expect(row).toMatchObject({ entityType: 'BaggageAllowance', entityId: 'ba-1' });
+      expect(row.oldData).toMatchObject({ excessFeePerKg: 5000 });
+      expect(row.newData).toMatchObject({ excessFeePerKg: 7500 });
+    });
+
+    it('records the deletion of an allowance', async () => {
+      build();
+      prisma.baggageAllowance.findUnique.mockResolvedValue({
+        id: 'ba-1',
+        seatClassId: 'sc-1',
+        maxWeightKg: 20,
+        maxPiecesCount: 2,
+        excessFeePerKg: 5000,
+      });
+
+      await service.deleteAllowance('ba-1');
+
+      expect(byAction('DELETE')).toHaveLength(1);
+      expect(byAction('DELETE')[0].oldData).toMatchObject({ excessFeePerKg: 5000 });
+    });
+  });
+
+  describe('reads', () => {
+    it('writes nothing when listing allowances', async () => {
+      build();
+      prisma.baggageAllowance.findMany = jest.fn().mockResolvedValue([]);
+      prisma.seatClass = { findMany: jest.fn().mockResolvedValue([]) };
+
+      await service.getAllowances();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+});
diff --git a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage-currency.spec.ts b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage-currency.spec.ts
new file mode 100644
index 000000000..1dbbdc86a
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage-currency.spec.ts
@@ -0,0 +1,455 @@
+import { BadRequestException } from '@nestjs/common';
+import { PaymentMethodType } from '@prisma/client';
+import { ExcessBaggageService } from './excess-baggage.service';
+import { CurrencyService } from '../currency/currency.service';
+
+/**
+ * An excess baggage charge is always booked in ETB, but each payment method settles in its own
+ * currency and the payment microservice forwards whatever it is given straight to the gateway.
+ * These cover the ETB→settlement conversion that has to happen here — and that the quote shown to
+ * the payer is computed from the same code path as the amount actually charged.
+ */
+describe('ExcessBaggageService — charge currency', () => {
+  const CHARGE_ID = 'charge-1';
+  const TOKEN = 'tok-1';
+
+  // 350.00 ETB owed for 7kg at 50.00 ETB/kg.
+  const charge = {
+    id: CHARGE_ID,
+    totalMinor: 35_000,
+    currency: 'ETB',
+    status: 'PENDING',
+    expiresAt: new Date(Date.now() + 10 * 60 * 1000),
+    booking: { bookingRef: 'BAG-001', scheduleId: 'sched-1' },
+  };
+
+  let prisma: Record<string, any>;
+  let paymentClient: {
+    initiate: jest.Mock;
+    getIntentByReference: jest.Mock;
+    confirmOtp: jest.Mock;
+  };
+  let service: ExcessBaggageService;
+
+  const build = (rate?: { rate: number }) => {
+    prisma = {
+      excessBaggageCharge: {
+        findUnique: jest.fn().mockResolvedValue(charge),
+        update: jest.fn().mockResolvedValue({ ...charge, status: 'PAID' }),
+        updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+      },
+      paymentMethod: { findUnique: jest.fn() },
+      currencyExchangeRate: {
+        findFirst: jest.fn().mockResolvedValue(rate ?? null),
+      },
+    };
+    paymentClient = {
+      initiate: jest.fn().mockResolvedValue({
+        status: 'REQUIRES_ACTION',
+        clientAction: { type: 'REDIRECT', url: 'https://gateway.test/pay' },
+        merchantOrderId: 'MO-1',
+      }),
+      getIntentByReference: jest.fn(),
+      confirmOtp: jest.fn(),
+    };
+    service = new ExcessBaggageService(
+      prisma as any,
+      { log: jest.fn() } as any, // auditService
+      new CurrencyService(prisma as any),
+      paymentClient as any,
+      {} as any, // notifications
+      {} as any, // smsClient
+      {} as any, // emailClient
+    );
+  };
+
+  const withMethod = (type: string, currency: string) =>
+    prisma.paymentMethod.findUnique.mockResolvedValue({ type, currency });
+
+  it('charges an Ethiopian wallet in ETB, unconverted', async () => {
+    build();
+    withMethod(PaymentMethodType.TELEBIRR, 'ETB');
+
+    const quote = await service.quoteAmount(TOKEN, PaymentMethodType.TELEBIRR);
+
+    expect(quote).toMatchObject({ currency: 'ETB', amount: 350 });
+    expect(prisma.currencyExchangeRate.findFirst).not.toHaveBeenCalled();
+  });
+
+  it('converts to DJF for Waafi and rounds to whole francs', async () => {
+    build({ rate: 3.2 }); // 1 ETB = 3.2 DJF
+    withMethod(PaymentMethodType.WAAFI, 'DJF');
+
+    const quote = await service.quoteAmount(TOKEN, PaymentMethodType.WAAFI);
+
+    // 350.00 ETB × 3.2 = 1120 DJF — DJF has no minor unit.
+    expect(quote).toMatchObject({ currency: 'DJF', amount: 1120 });
+    expect(Number.isInteger(quote.amount)).toBe(true);
+  });
+
+  it('sends the provider the converted amount and its own currency, not the stored ETB total', async () => {
+    build({ rate: 3.2 });
+    withMethod(PaymentMethodType.WAAFI, 'DJF');
+
+    await service.initiatePayment(TOKEN, {
+      method: PaymentMethodType.WAAFI,
+      platform: 'web',
+    } as any);
+
+    expect(paymentClient.initiate).toHaveBeenCalledWith(
+      expect.objectContaining({
+        referenceType: 'EXCESS_BAGGAGE',
+        referenceId: CHARGE_ID,
+        amountMinor: 1120,
+        currency: 'DJF',
+        provider: PaymentMethodType.WAAFI,
+      }),
+    );
+  });
+
+  it('quotes and charges the same figure for the same method', async () => {
+    build({ rate: 0.0175 }); // 1 ETB = 0.0175 USD
+    withMethod(PaymentMethodType.CARD, 'USD');
+
+    const quote = await service.quoteAmount(TOKEN, PaymentMethodType.CARD);
+    await service.initiatePayment(TOKEN, {
+      method: PaymentMethodType.CARD,
+      platform: 'web',
+    } as any);
+
+    const sent = paymentClient.initiate.mock.calls[0][0];
+    expect(quote.amount).toBe(sent.amountMinor);
+    expect(quote.currency).toBe(sent.currency);
+    expect(sent.amountMinor).toBe(6.13); // 350 × 0.0175 = 6.125 → 6.13 USD
+  });
+
+  it('forces ETB for CBE_BILL, which settles ETB only', async () => {
+    build({ rate: 3.2 });
+    withMethod(PaymentMethodType.CBE_BILL, 'DJF'); // misconfigured row must not win
+
+    const quote = await service.quoteAmount(TOKEN, PaymentMethodType.CBE_BILL);
+
+    expect(quote).toMatchObject({ currency: 'ETB', amount: 350 });
+  });
+
+  it('refuses WALLET, which has no excess-baggage path', async () => {
+    build();
+
+    await expect(
+      service.quoteAmount(TOKEN, PaymentMethodType.WALLET),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    await expect(
+      service.initiatePayment(TOKEN, {
+        method: PaymentMethodType.WALLET,
+      } as any),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    expect(paymentClient.initiate).not.toHaveBeenCalled();
+  });
+
+  it('fails closed when no exchange rate is configured — never charges at parity', async () => {
+    build(); // no rate rows at all
+    withMethod(PaymentMethodType.WAAFI, 'DJF');
+
+    await expect(
+      service.initiatePayment(TOKEN, {
+        method: PaymentMethodType.WAAFI,
+      } as any),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    expect(paymentClient.initiate).not.toHaveBeenCalled();
+  });
+});
+
+/**
+ * CAC Bank is an OTP debit: the bank SMSes a one-time password to a mobile number it must be given
+ * at initiate, and the payment only settles once that password is submitted back.
+ */
+describe('ExcessBaggageService — CAC Bank OTP debit', () => {
+  const CHARGE_ID = 'charge-1';
+  const TOKEN = 'tok-1';
+
+  const charge = {
+    id: CHARGE_ID,
+    totalMinor: 25_000,
+    currency: 'ETB',
+    status: 'PENDING',
+    expiresAt: new Date(Date.now() + 10 * 60 * 1000),
+    booking: { bookingRef: 'BAG-001', scheduleId: 'sched-1' },
+  };
+
+  let prisma: Record<string, any>;
+  let paymentClient: {
+    initiate: jest.Mock;
+    getIntentByReference: jest.Mock;
+    confirmOtp: jest.Mock;
+  };
+  let service: ExcessBaggageService;
+
+  beforeEach(() => {
+    prisma = {
+      excessBaggageCharge: {
+        findUnique: jest.fn().mockResolvedValue(charge),
+        update: jest.fn().mockResolvedValue({ ...charge, status: 'PAID' }),
+        updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+      },
+      paymentMethod: {
+        findUnique: jest
+          .fn()
+          .mockResolvedValue({ type: 'CAC_BANK', currency: 'DJF' }),
+      },
+      currencyExchangeRate: {
+        findFirst: jest.fn().mockResolvedValue({ rate: 3.25 }),
+      },
+    };
+    paymentClient = {
+      initiate: jest.fn().mockResolvedValue({
+        intentId: 'intent-1',
+        status: 'REQUIRES_ACTION',
+        clientAction: {
+          type: 'COLLECT_OTP',
+          message: 'Enter the OTP sent to 77****56',
+        },
+        merchantOrderId: 'MO-1',
+      }),
+      getIntentByReference: jest
+        .fn()
+        .mockResolvedValue({ intentId: 'intent-1', status: 'REQUIRES_ACTION' }),
+      confirmOtp: jest.fn().mockResolvedValue({
+        intentId: 'intent-1',
+        status: 'SUCCEEDED',
+        providerTxnId: 'CAC-TXN-9',
+      }),
+    };
+    service = new ExcessBaggageService(
+      prisma as any,
+      { log: jest.fn() } as any,
+      new CurrencyService(prisma as any),
+      paymentClient as any,
+      {} as any,
+      {} as any,
+      {} as any,
+    );
+  });
+
+  it('rejects initiate without a payer mobile — the bank has nowhere to send the OTP', async () => {
+    await expect(
+      service.initiatePayment(TOKEN, {
+        method: PaymentMethodType.CAC_BANK,
+        platform: 'web',
+      } as any),
+    ).rejects.toBeInstanceOf(BadRequestException);
+    expect(paymentClient.initiate).not.toHaveBeenCalled();
+  });
+
+  it('forwards the payer mobile and returns the OTP client action', async () => {
+    const result = await service.initiatePayment(TOKEN, {
+      method: PaymentMethodType.CAC_BANK,
+      platform: 'web',
+      payerAccount: ' 77123456 ',
+    } as any);
+
+    expect(paymentClient.initiate).toHaveBeenCalledWith(
+      expect.objectContaining({
+        payerAccount: '77123456', // trimmed
+        currency: 'DJF',
+        amountMinor: 813, // 250.00 ETB × 3.25, whole francs
+      }),
+    );
+    expect(result.clientAction).toMatchObject({ type: 'COLLECT_OTP' });
+  });
+
+  it('submits the OTP against the charge’s active intent and marks it paid', async () => {
+    const result = await service.confirmOtp(TOKEN, '4530');
+
+    expect(paymentClient.getIntentByReference).toHaveBeenCalledWith(
+      'EXCESS_BAGGAGE',
+      CHARGE_ID,
+    );
+    expect(paymentClient.confirmOtp).toHaveBeenCalledWith('intent-1', '4530');
+    expect(prisma.excessBaggageCharge.updateMany).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: expect.objectContaining({ id: CHARGE_ID }),
+        data: expect.objectContaining({ status: 'PAID' }),
+      }),
+    );
+    expect(result).toMatchObject({ status: 'SUCCEEDED', alreadyPaid: false });
+  });
+
+  it('leaves the charge unpaid when the OTP does not settle', async () => {
+    paymentClient.confirmOtp.mockResolvedValue({
+      intentId: 'intent-1',
+      status: 'REQUIRES_ACTION',
+    });
+
+    const result = await service.confirmOtp(TOKEN, '0000');
+
+    expect(prisma.excessBaggageCharge.update).not.toHaveBeenCalled();
+    expect(prisma.excessBaggageCharge.updateMany).not.toHaveBeenCalled();
+    expect(result).toMatchObject({ status: 'REQUIRES_ACTION' });
+  });
+
+  it('confirms an OTP even after the link TTL lapsed — the debit is already in flight', async () => {
+    prisma.excessBaggageCharge.findUnique.mockResolvedValue({
+      ...charge,
+      expiresAt: new Date(Date.now() - 60_000),
+    });
+
+    await expect(service.confirmOtp(TOKEN, '4530')).resolves.toMatchObject({
+      status: 'SUCCEEDED',
+    });
+  });
+
+  it('is idempotent once the charge is already paid', async () => {
+    prisma.excessBaggageCharge.findUnique.mockResolvedValue({
+      ...charge,
+      status: 'PAID',
+    });
+
+    const result = await service.confirmOtp(TOKEN, '4530');
+
+    expect(result).toMatchObject({ alreadyPaid: true });
+    expect(paymentClient.confirmOtp).not.toHaveBeenCalled();
+  });
+});
+
+/**
+ * CBE bill payment is inbound-only: no provider session is opened, a bill reference is minted and
+ * the payer settles it at a branch/app hours later. The expiry handed to the payment service is
+ * therefore the charge's own deadline, never the 30-minute link TTL — a short one would have the
+ * reconciliation sweep kill the intent within the hour (CBE plan §6.4).
+ */
+describe('ExcessBaggageService — CBE bill', () => {
+  const CHARGE_ID = 'charge-1';
+  const TOKEN = 'tok-1';
+  const THIRTY_MIN = 30 * 60 * 1000;
+
+  let prisma: Record<string, any>;
+  let paymentClient: { initiate: jest.Mock };
+  let service: ExcessBaggageService;
+  let charge: any;
+
+  beforeEach(() => {
+    charge = {
+      id: CHARGE_ID,
+      bookingId: 'booking-1',
+      totalMinor: 25_000,
+      currency: 'ETB',
+      status: 'PENDING',
+      // A freshly created charge: the short browser-session TTL.
+      expiresAt: new Date(Date.now() + THIRTY_MIN),
+      booking: { bookingRef: 'BAG-001' },
+    };
+    prisma = {
+      excessBaggageCharge: {
+        findUnique: jest.fn().mockResolvedValue(charge),
+        update: jest.fn().mockResolvedValue(charge),
+        updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+      },
+      booking: {
+        findUnique: jest.fn().mockResolvedValue({
+          seats: [{ leg: 1, passengerName: 'Abebe Kebede' }],
+          passenger: { user: { fullName: 'Account Holder' } },
+        }),
+      },
+      paymentMethod: {
+        findUnique: jest
+          .fn()
+          .mockResolvedValue({ type: 'CBE_BILL', currency: 'ETB' }),
+      },
+      currencyExchangeRate: { findFirst: jest.fn().mockResolvedValue(null) },
+    };
+    paymentClient = {
+      initiate: jest.fn().mockResolvedValue({
+        intentId: 'intent-1',
+        status: 'REQUIRES_ACTION',
+        clientAction: {
+          type: 'SHOW_BILL_REFERENCE',
+          billReference: '900123456',
+        },
+        merchantOrderId: 'MO-1',
+      }),
+    };
+    service = new ExcessBaggageService(
+      prisma as any,
+      { log: jest.fn() } as any,
+      new CurrencyService(prisma as any),
+      paymentClient as any,
+      {} as any,
+      {} as any,
+      {} as any,
+    );
+  });
+
+  const initiate = () =>
+    service.initiatePayment(TOKEN, {
+      method: PaymentMethodType.CBE_BILL,
+      platform: 'web',
+    } as any);
+
+  it('extends the charge deadline past the 30-minute link TTL', async () => {
+    await initiate();
+
+    expect(prisma.excessBaggageCharge.update).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: { id: CHARGE_ID },
+        data: expect.objectContaining({ expiresAt: expect.any(Date) }),
+      }),
+    );
+    const written =
+      prisma.excessBaggageCharge.update.mock.calls[0][0].data.expiresAt;
+    // Comfortably beyond the session TTL — a payer has to reach a branch.
+    expect(written.getTime()).toBeGreaterThan(Date.now() + 2 * THIRTY_MIN);
+  });
+
+  it('hands the payment service that deadline as the intent expiry, in ETB', async () => {
+    await initiate();
+
+    const sent = paymentClient.initiate.mock.calls[0][0];
+    expect(sent.currency).toBe('ETB');
+    expect(sent.amountMinor).toBe(250);
+    expect(new Date(sent.expiresAt).getTime()).toBeGreaterThan(
+      Date.now() + 2 * THIRTY_MIN,
+    );
+  });
+
+  it('sends the lead passenger as Full_Name, which CBE requires', async () => {
+    await initiate();
+
+    expect(paymentClient.initiate.mock.calls[0][0].payerName).toBe(
+      'Abebe Kebede',
+    );
+  });
+
+  it('never shortens a deadline the payer already has', async () => {
+    const farFuture = new Date(Date.now() + 90 * 60 * 60 * 1000);
+    charge.expiresAt = farFuture;
+
+    await initiate();
+
+    expect(prisma.excessBaggageCharge.update).not.toHaveBeenCalled();
+    expect(paymentClient.initiate.mock.calls[0][0].expiresAt).toBe(
+      farFuture.toISOString(),
+    );
+  });
+
+  it('returns the bill reference to the caller', async () => {
+    const result = await initiate();
+    expect(result.clientAction).toMatchObject({
+      type: 'SHOW_BILL_REFERENCE',
+      billReference: '900123456',
+    });
+  });
+
+  it('reports a paid charge through getStatus without the payability gate', async () => {
+    prisma.excessBaggageCharge.findUnique.mockResolvedValue({
+      ...charge,
+      status: 'PAID',
+      paidAt: new Date(),
+    });
+
+    // getByToken would throw "already paid" here; the poll must simply report it.
+    await expect(service.getStatus(TOKEN)).resolves.toMatchObject({
+      status: 'PAID',
+      paid: 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 40a44f36b..0255c8a2b 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,11 +1,12 @@
 import { Body, Controller, Delete, Get, Param, Patch, Post, Query, Request, UseGuards, SetMetadata } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery } from '@nestjs/swagger';
 import { IsInt, IsOptional, IsPositive, IsString } from 'class-validator';
 import { ExcessBaggageService } from './excess-baggage.service';
 import {
   LogExcessBaggageDto,
   WaiveChargeDto,
   InitiateExcessPaymentDto,
+  ConfirmExcessOtpDto,
 } from './excess-baggage.dto';
 import { JwtGuard as IamJwtGuard } from '@tria-plc/api-common/modules/auth/services/jwt.guard';
 import { PassengerAdmin } from '../../common/passenger-guards';
@@ -28,7 +29,7 @@ export class ExcessBaggageAgentController {
   @Post()
   @ApiOperation({ summary: 'Log excess baggage charge and optionally collect cash' })
   logCharge(@Request() req: any, @Body() dto: LogExcessBaggageDto) {
-    dto.agentId = req.user?.id ?? req.user?.sub ?? dto.agentId;
+    dto.agentId = req.user?.id ?? req.user?.sub ?? '';
     return this.service.logCharge(dto);
   }
 
@@ -118,6 +119,37 @@ export class ExcessBaggagePublicController {
     return this.service.getByToken(token);
   }
 
+  @Get('pay/:token/amount')
+  @ApiOperation({
+    summary: 'Quote the charge in a payment method’s settlement currency',
+    description:
+      'Returns what the given method would debit, converted from the charge’s stored ETB total ' +
+      'to that method’s settlement currency (WAAFI/DMONEY settle in DJF, CARD in USD, Ethiopian ' +
+      'wallets in ETB) at the latest exchange rate. The pay page quotes this before the payer ' +
+      'commits; initiating a payment recomputes it identically.',
+  })
+  @ApiQuery({
+    name: 'method',
+    required: true,
+    example: 'WAAFI',
+    description: 'Payment method type the payer has selected',
+  })
+  quoteAmount(@Param('token') token: string, @Query('method') method: string) {
+    return this.service.quoteAmount(token, method);
+  }
+
+  @Get('pay/:token/status')
+  @ApiOperation({
+    summary: 'Poll the charge’s settlement status (public)',
+    description:
+      'Reports the charge’s current status without the payability gate on GET /pay/:token, so a ' +
+      'page can watch for settlement. Used while a CBE bill is outstanding and after a redirect ' +
+      'payment returns — both settle server-side, out of band from the browser.',
+  })
+  getStatus(@Param('token') token: string) {
+    return this.service.getStatus(token);
+  }
+
   @Post('pay/:token/initiate')
   @ApiOperation({ summary: 'Passenger initiates payment for excess baggage charge' })
   initiatePayment(
@@ -126,4 +158,18 @@ export class ExcessBaggagePublicController {
   ) {
     return this.service.initiatePayment(token, dto);
   }
+
+  @Post('pay/:token/confirm')
+  @ApiOperation({
+    summary: 'Confirm an OTP-debit excess baggage payment (CAC Bank)',
+    description:
+      'Submits the one-time password the payer received by SMS. A wrong or expired OTP returns ' +
+      '400 and the payment stays open for retry.',
+  })
+  confirmOtp(
+    @Param('token') token: string,
+    @Body() dto: ConfirmExcessOtpDto,
+  ) {
+    return this.service.confirmOtp(token, dto.otp);
+  }
 }
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 df0abd8be..4b06e906e 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
@@ -20,7 +20,34 @@ export class WaiveChargeDto {
 }
 
 export class InitiateExcessPaymentDto {
-  @ApiProperty({ enum: ['TELEBIRR', 'CBE_BIRR', 'EBIRR', 'WAAFI', 'DMONEY', 'CARD'] })
+  @ApiProperty({
+    enum: [
+      'TELEBIRR',
+      'CBE_BIRR',
+      'EBIRR',
+      'WAAFI',
+      'DMONEY',
+      'CARD',
+      'CAC_BANK',
+      'CBE_BILL',
+    ],
+  })
   @IsString() method: string;
   @ApiPropertyOptional({ enum: ['web', 'mobile'] }) @IsOptional() platform?: string;
+  @ApiPropertyOptional({
+    description:
+      'Payer account / mobile number. Required for the push-debit methods: CAC_BANK (the bank ' +
+      'SMSes a one-time password to this number) and EBIRR (the wallet pushes a USSD PIN prompt ' +
+      'to it). Normalised server-side by the payment service.',
+    example: '77123456',
+  })
+  @IsOptional() @IsString() payerAccount?: string;
+}
+
+export class ConfirmExcessOtpDto {
+  @ApiProperty({
+    description: 'One-time password the payer received by SMS (CAC Bank).',
+    example: '4530',
+  })
+  @IsString() otp: string;
 }
diff --git a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.module.ts b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.module.ts
index e734d4fb4..e9c648ca8 100644
--- a/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.module.ts
+++ b/apps/edr-passenger-api/src/modules/excess-baggage/excess-baggage.module.ts
@@ -6,11 +6,18 @@ import {
   ExcessBaggagePublicController,
 } from './excess-baggage.controller';
 import { PaymentsModule } from '../payments/payments.module';
+import { CurrencyModule } from '../currency/currency.module';
 import { NotificationsModule } from '../notifications/notifications.module';
 import { AuditModule } from '../../common/audit.module';
 
 @Module({
-  imports: [HttpModule, PaymentsModule, NotificationsModule, AuditModule],
+  imports: [
+    HttpModule,
+    PaymentsModule,
+    CurrencyModule,
+    NotificationsModule,
+    AuditModule,
+  ],
   controllers: [ExcessBaggageAgentController, ExcessBaggagePublicController],
   providers: [ExcessBaggageService],
   exports: [ExcessBaggageService],
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 32fc06c13..7ccc0af06 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
@@ -6,6 +6,16 @@ import {
 } from '@nestjs/common';
 import { PrismaService } from '../../common/prisma.service';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { snapshot } from '../../common/audit-snapshot';
+
+const ALLOWANCE_AUDIT_FIELDS = [
+  'seatClassId',
+  'maxWeightKg',
+  'maxPiecesCount',
+  'excessFeePerKg',
+] as const;
+import { CurrencyService } from '../currency/currency.service';
 import { PaymentClientService } from '../payments/payment-client.service';
 import { NotificationsService } from '../notifications/notifications.service';
 import { SmsClientService } from '../notifications/sms-client.service';
@@ -25,6 +35,41 @@ import { PaymentMethodType, PaymentIntentStatus } from '@prisma/client';
 
 const CHARGE_TTL_MS = 30 * 60 * 1000; // 30 minutes
 
+/**
+ * WALLET is an internal balance debit handled entirely inside this app (PaymentsService
+ * .initiateWalletPayment) — it is not a provider and the payment microservice rejects it as one.
+ * Excess baggage has no wallet path, so it is refused up front with a message a payer can act on
+ * rather than a 502 from the gateway layer.
+ */
+const UNSUPPORTED_METHODS = new Set<string>([PaymentMethodType.WALLET]);
+
+/**
+ * Push-debit methods charge an account we must be told up front — CAC Bank SMSes a one-time
+ * password to it, eBirr pushes a USSD PIN prompt to it. Neither opens a hosted page that could
+ * collect the number later, so initiate is rejected without it (mirrors PaymentsService).
+ */
+const METHODS_REQUIRING_PAYER_ACCOUNT = new Set<string>([
+  PaymentMethodType.CAC_BANK,
+  PaymentMethodType.EBIRR,
+]);
+
+/**
+ * How long an excess baggage charge stays payable once a CBE bill has been issued for it.
+ *
+ * The 30-minute link TTL is a browser-session window: it assumes the payer is sitting in front of
+ * the page. A CBE bill is the opposite — the payer walks to a branch, or opens CBE Birr later, and
+ * the bill reference may already be written on a slip of paper. Handing the payment service a
+ * 30-minute `expiresAt` would also make the reconciliation sweep expire the intent and emit
+ * payment.failed within the hour (CBE_IMPLEMENTATION_PLAN.md §6.4 calls this the single most
+ * important detail of the integration).
+ *
+ * So issuing a bill EXTENDS the charge's own deadline to this window. `charge.expiresAt` stays the
+ * single source of truth for both the pay link and the bill.
+ */
+const CBE_BILL_WINDOW_HOURS = Number(
+  process.env.EXCESS_BAGGAGE_CBE_BILL_HOURS ?? 24,
+);
+
 @Injectable()
 export class ExcessBaggageService {
   private readonly logger = new Logger(ExcessBaggageService.name);
@@ -32,6 +77,7 @@ export class ExcessBaggageService {
   constructor(
     private prisma: PrismaService,
     private auditService: AuditService,
+    private currencyService: CurrencyService,
     private paymentClient: PaymentClientService,
     private notifications: NotificationsService,
     private smsClient: SmsClientService,
@@ -94,7 +140,24 @@ export class ExcessBaggageService {
       await this.sendPaymentLink(charge, booking, contactPhone, contactEmail);
     }
 
-    await this.auditService.log({ action: 'CREATE', entityType: 'ExcessBaggageCharge', entityId: charge.id, newData: { bookingId: booking.id, excessWeightKg: dto.excessWeightKg, totalMinor, status } });
+    // The charge row carries contactPhone/contactEmail for the payment link; those stay out of
+    // the audit payload, which needs only the money and who raised it.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.ExcessBaggageCharge,
+      entityId: charge.id,
+      newData: {
+        bookingId: booking.id,
+        bookingRef: booking.bookingRef,
+        excessWeightKg: dto.excessWeightKg,
+        feePerKgMinor,
+        totalMinor,
+        currency: charge.currency,
+        status,
+        agentId: charge.agentId || null,
+        collectCash: dto.collectCash ?? false,
+      },
+    });
     return charge;
   }
 
@@ -165,21 +228,103 @@ export class ExcessBaggageService {
     return charge;
   }
 
+  /**
+   * What the payer is actually charged when paying this charge with `method`.
+   *
+   * The charge itself is always booked in ETB (`ExcessBaggageCharge.currency` defaults to ETB and
+   * nothing overrides it), but the selected method settles in its own currency — WAAFI/DMONEY in
+   * DJF, CARD in USD, the Ethiopian wallets in ETB — recorded on the PaymentMethod row. The payment
+   * microservice is currency-agnostic and hands whatever it is given straight to the gateway
+   * verbatim, so the ETB→settlement conversion has to happen here or the provider is asked to debit
+   * an ETB number labelled as its own currency.
+   *
+   * Both the quote shown to the payer and the amount sent to the provider come through this one
+   * method, so the price on the button and the price debited cannot drift apart.
+   */
+  private async resolveChargeAmount(
+    charge: { totalMinor: number; currency: string },
+    method: string,
+  ): Promise<{ amount: number; currency: string }> {
+    if (UNSUPPORTED_METHODS.has(method)) {
+      throw new BadRequestException(
+        `${method} is not available for excess baggage payments`,
+      );
+    }
+
+    const paymentMethod = await this.prisma.paymentMethod.findUnique({
+      where: { type: method as PaymentMethodType },
+    });
+    // CBE settles ETB only (docs/cbe/CBE_IMPLEMENTATION_PLAN.md D8) — never converted. Every other
+    // method charges in its configured settlement currency, falling back to the charge's own.
+    const chargeCurrency =
+      method === PaymentMethodType.CBE_BILL
+        ? 'ETB'
+        : (paymentMethod?.currency ?? charge.currency).toUpperCase();
+
+    // Applies the target currency's own precision — DJF rounds to whole francs, ETB/USD to cents.
+    const amount = await this.currencyService.convertMinorToChargeMajor(
+      charge.totalMinor,
+      charge.currency,
+      chargeCurrency,
+    );
+    return { amount, currency: chargeCurrency };
+  }
+
+  /**
+   * Price quote for the pay page: what `method` would debit, in that method's settlement currency.
+   * The payer sees this before committing, and `initiatePayment` recomputes it the same way.
+   */
+  async quoteAmount(token: string, method: string) {
+    const charge = await this.getByToken(token);
+    const { amount, currency } = await this.resolveChargeAmount(charge, method);
+    return { chargeId: charge.id, method, currency, amount };
+  }
+
   async initiatePayment(token: string, dto: InitiateExcessPaymentDto) {
     const charge = await this.getByToken(token);
 
+    if (
+      METHODS_REQUIRING_PAYER_ACCOUNT.has(dto.method) &&
+      !dto.payerAccount?.trim()
+    ) {
+      throw new BadRequestException(
+        `payerAccount (mobile number) is required for ${dto.method}`,
+      );
+    }
+
     const portalUrl = process.env.PORTAL_URL ?? 'http://localhost:5174';
     const returnUrl = `${portalUrl}/excess-baggage/pay/${token}/result`;
 
+    const { amount, currency } = await this.resolveChargeAmount(
+      charge,
+      dto.method,
+    );
+
+    // CBE_BILL is inbound-only: no provider session is opened, the bill simply sits in CBE's
+    // system until someone pays it. It therefore needs a real deadline and a payer name (Full_Name
+    // is mandatory in CBE's envelope) rather than the redirect flow's session semantics.
+    let payerName: string | undefined;
+    let expiresAt: string | undefined;
+    if (dto.method === PaymentMethodType.CBE_BILL) {
+      const deadline = await this.extendForCbeBill(charge);
+      expiresAt = deadline.toISOString();
+      payerName = (await this.resolvePayerName(charge.bookingId)) ?? undefined;
+    }
+
     const snapshot = await this.paymentClient.initiate({
       service: PaymentServiceEnum.PASSENGER,
       referenceType: 'EXCESS_BAGGAGE' as PaymentReferenceType,
       referenceId: charge.id,
       orderRef: `EXB-${charge.id.substring(0, 8).toUpperCase()}`,
-      amountMinor: charge.totalMinor / 100,
-      currency: charge.currency,
+      // `amountMinor` is the contract's name but its value is MAJOR units — the provider layer
+      // charges it verbatim at the currency's own precision (see PaymentIntentSnapshot).
+      amountMinor: amount,
+      currency,
       provider: dto.method as unknown as ProviderMethod,
       platform: dto.platform as any,
+      payerAccount: dto.payerAccount?.trim() || undefined,
+      payerName,
+      expiresAt,
       returnUrl,
       failureUrl: returnUrl,
     });
@@ -196,14 +341,150 @@ export class ExcessBaggageService {
     };
   }
 
+  /**
+   * Pushes the charge's deadline out to the CBE bill window and returns it. Only ever extends —
+   * a charge that already has longer left (a re-issued bill, an agent's resend) keeps it, so
+   * re-initiating a bill can never shorten a window the payer was already given.
+   */
+  private async extendForCbeBill(charge: {
+    id: string;
+    expiresAt: Date;
+  }): Promise<Date> {
+    const target = new Date(Date.now() + CBE_BILL_WINDOW_HOURS * 60 * 60 * 1000);
+    if (charge.expiresAt >= target) return charge.expiresAt;
+
+    await this.prisma.excessBaggageCharge.update({
+      where: { id: charge.id },
+      data: { expiresAt: target },
+    });
+    this.logger.log(
+      `charge ${charge.id}: expiry extended to ${target.toISOString()} for CBE bill`,
+    );
+    return target;
+  }
+
+  /**
+   * Full_Name for CBE's confirmation screen — mandatory in its envelope. The passenger the
+   * baggage belongs to: lead traveller on the booking, falling back to the account holder.
+   */
+  private async resolvePayerName(bookingId: string): Promise<string | null> {
+    const booking = await this.prisma.booking.findUnique({
+      where: { id: bookingId },
+      include: { seats: true, passenger: { include: { user: true } } },
+    });
+    if (!booking) return null;
+    return (
+      booking.seats?.find((s: any) => s.leg === 1)?.passengerName ??
+      booking.seats?.[0]?.passengerName ??
+      booking.passenger?.user?.fullName ??
+      null
+    );
+  }
+
+  /**
+   * Bare status for the pay/result pages to poll. Unlike getByToken this does NOT reject a paid,
+   * expired or waived charge — the whole point is to report those states. A CBE bill can settle
+   * long after the payer closed the tab, and the redirect methods only converge when the
+   * settlement event lands, so the page needs something it can watch.
+   */
+  async getStatus(token: string) {
+    const charge = await this.prisma.excessBaggageCharge.findUnique({
+      where: { paymentToken: token },
+      select: {
+        id: true,
+        status: true,
+        paidAt: true,
+        totalMinor: true,
+        currency: true,
+        expiresAt: true,
+      },
+    });
+    if (!charge) throw new NotFoundException('Payment link not found');
+    return {
+      chargeId: charge.id,
+      status: charge.status,
+      paid: charge.status === 'PAID' || charge.status === 'CASH_COLLECTED',
+      paidAt: charge.paidAt,
+      totalMinor: charge.totalMinor,
+      currency: charge.currency,
+      expiresAt: charge.expiresAt,
+    };
+  }
+
+  /**
+   * Submit the one-time password for a COLLECT_OTP provider (CAC Bank). The bank SMSed it to the
+   * payerAccount given at initiate; this forwards it to the payment service and marks the charge
+   * paid when the debit settles. A wrong or expired OTP bubbles up as a 400 and the intent stays
+   * open, so the payer can simply re-enter it.
+   *
+   * Deliberately reads the charge directly rather than through getByToken: the bank is already
+   * holding a debit against this payer, and refusing to submit their OTP because the 30-minute
+   * link TTL lapsed while they were reading the SMS would strand a payment that is mid-flight.
+   */
+  async confirmOtp(token: string, otp: string) {
+    const charge = await this.prisma.excessBaggageCharge.findUnique({
+      where: { paymentToken: token },
+    });
+    if (!charge) throw new NotFoundException('Payment link not found');
+    if (charge.status === 'PAID' || charge.status === 'CASH_COLLECTED') {
+      return { chargeId: charge.id, status: 'SUCCEEDED', alreadyPaid: true };
+    }
+
+    const snapshot = await this.paymentClient.getIntentByReference(
+      'EXCESS_BAGGAGE' as PaymentReferenceType,
+      charge.id,
+    );
+    if (!snapshot) {
+      throw new NotFoundException('No active payment to confirm for this charge');
+    }
+
+    const confirmed = await this.paymentClient.confirmOtp(
+      snapshot.intentId,
+      otp,
+    );
+    if (confirmed.status === ProviderPaymentStatus.SUCCEEDED) {
+      await this.markPaid(charge.id, confirmed.providerTxnId);
+    }
+
+    return {
+      chargeId: charge.id,
+      status: confirmed.status,
+      alreadyPaid: false,
+    };
+  }
+
   async markPaid(chargeId: string, providerTxnId?: string) {
     const charge = await this.prisma.excessBaggageCharge.findUnique({ where: { id: chargeId } });
     if (!charge) throw new NotFoundException('Charge not found');
     if (charge.status === 'PAID') return charge;
-    return this.prisma.excessBaggageCharge.update({
-      where: { id: chargeId },
+
+    // Conditional claim: PaymentsService.handleExcessBaggageChargeEvent drives the same
+    // transition from the webhook. Whichever caller actually flips the row writes the audit
+    // event, so the settlement is recorded exactly once regardless of which path won.
+    const { count } = await this.prisma.excessBaggageCharge.updateMany({
+      where: { id: chargeId, status: { notIn: ['PAID', 'CASH_COLLECTED'] } },
       data: { status: 'PAID', paidAt: new Date() },
     });
+
+    const updated = await this.prisma.excessBaggageCharge.findUnique({ where: { id: chargeId } });
+
+    if (count === 1) {
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.PAY,
+        entityType: AUDIT_ENTITIES.ExcessBaggageCharge,
+        entityId: chargeId,
+        oldData: { status: charge.status },
+        newData: {
+          status: 'PAID',
+          bookingId: charge.bookingId,
+          totalMinor: charge.totalMinor,
+          currency: charge.currency,
+          providerTxnId: providerTxnId ?? null,
+        },
+      });
+    }
+
+    return updated!;
   }
 
   async waiveCharge(id: string, dto: WaiveChargeDto) {
@@ -216,7 +497,22 @@ export class ExcessBaggageService {
       where: { id },
       data: { status: 'WAIVED', waivedBy: dto.waivedBy, waivedReason: dto.waivedReason },
     });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'ExcessBaggageCharge', entityId: id, newData: { status: 'WAIVED', waivedBy: dto.waivedBy, waivedReason: dto.waivedReason } });
+    // `dto.waivedBy` is a client-supplied label kept for the business column; the audit actor
+    // is resolved from the session by AuditService, so the two cannot disagree about who acted.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.WAIVE,
+      entityType: AUDIT_ENTITIES.ExcessBaggageCharge,
+      entityId: id,
+      oldData: { status: charge.status },
+      newData: {
+        status: 'WAIVED',
+        bookingId: charge.bookingId,
+        totalMinor: charge.totalMinor,
+        currency: charge.currency,
+        waivedBy: dto.waivedBy,
+        waivedReason: dto.waivedReason,
+      },
+    });
     return waived;
   }
 
@@ -235,6 +531,16 @@ export class ExcessBaggageService {
       data: { expiresAt: new Date(Date.now() + CHARGE_TTL_MS) },
     });
     await this.sendPaymentLink(updatedCharge, charge.booking, charge.contactPhone, charge.contactEmail);
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.RESEND,
+      entityType: AUDIT_ENTITIES.ExcessBaggageCharge,
+      entityId: id,
+      oldData: { expiresAt: charge.expiresAt?.toISOString() },
+      newData: {
+        bookingRef: charge.booking.bookingRef,
+        expiresAt: updatedCharge.expiresAt?.toISOString(),
+      },
+    });
     return { sent: true };
   }
 
@@ -293,30 +599,79 @@ export class ExcessBaggageService {
   async upsertAllowance(dto: { seatClassId: string; maxWeightKg?: number; maxPiecesCount?: number; excessFeePerKg: number }) {
     const existing = await this.prisma.baggageAllowance.findFirst({ where: { seatClassId: dto.seatClassId } });
     if (existing) {
-      return this.prisma.baggageAllowance.update({
+      const updated = await this.prisma.baggageAllowance.update({
         where: { id: existing.id },
         data: { maxWeightKg: dto.maxWeightKg ?? 0, maxPiecesCount: dto.maxPiecesCount ?? 0, excessFeePerKg: dto.excessFeePerKg },
       });
+      // An upsert, so report the edit rather than always claiming a create — this is a tariff
+      // change and the previous fee is the whole point of the row.
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.UPDATE,
+        entityType: AUDIT_ENTITIES.BaggageAllowance,
+        entityId: existing.id,
+        oldData: snapshot(existing, ALLOWANCE_AUDIT_FIELDS),
+        newData: snapshot(updated, ALLOWANCE_AUDIT_FIELDS),
+      });
+      return updated;
     }
-    return this.prisma.baggageAllowance.create({
+    const created = await this.prisma.baggageAllowance.create({
       data: { seatClassId: dto.seatClassId, maxWeightKg: dto.maxWeightKg ?? 0, maxPiecesCount: dto.maxPiecesCount ?? 0, excessFeePerKg: dto.excessFeePerKg },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.BaggageAllowance,
+      entityId: created.id,
+      newData: snapshot(created, ALLOWANCE_AUDIT_FIELDS),
+    });
+    return created;
   }
 
   async updateAllowance(id: string, dto: Partial<{ maxWeightKg: number; maxPiecesCount: number; excessFeePerKg: number }>) {
-    return this.prisma.baggageAllowance.update({ where: { id }, data: dto });
+    const existing = await this.prisma.baggageAllowance.findUnique({ where: { id } });
+    if (!existing) throw new NotFoundException('Baggage allowance not found');
+    const updated = await this.prisma.baggageAllowance.update({ where: { id }, data: dto });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.BaggageAllowance,
+      entityId: id,
+      oldData: snapshot(existing, ALLOWANCE_AUDIT_FIELDS),
+      newData: snapshot(updated, ALLOWANCE_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   async deleteAllowance(id: string) {
+    const existing = await this.prisma.baggageAllowance.findUnique({ where: { id } });
     await this.prisma.baggageAllowance.deleteMany({ where: { id } });
+    if (existing) {
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.DELETE,
+        entityType: AUDIT_ENTITIES.BaggageAllowance,
+        entityId: id,
+        oldData: snapshot(existing, ALLOWANCE_AUDIT_FIELDS),
+      });
+    }
     return { deleted: true };
   }
 
   async deleteCharge(id: string) {
     const charge = await this.prisma.excessBaggageCharge.findUnique({ where: { id } });
     if (!charge) throw new NotFoundException('Charge not found');
-    
+
     await this.prisma.excessBaggageCharge.delete({ where: { id } });
+    // Hard delete of a money record — previously silent.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.ExcessBaggageCharge,
+      entityId: id,
+      oldData: {
+        bookingId: charge.bookingId,
+        excessWeightKg: charge.excessWeightKg,
+        totalMinor: charge.totalMinor,
+        currency: charge.currency,
+        status: charge.status,
+      },
+    });
     return { deleted: true };
   }
 }
diff --git a/apps/edr-passenger-api/src/modules/fare-engine/fare-engine.service.ts b/apps/edr-passenger-api/src/modules/fare-engine/fare-engine.service.ts
index 69b0266ed..348e9d6be 100644
--- a/apps/edr-passenger-api/src/modules/fare-engine/fare-engine.service.ts
+++ b/apps/edr-passenger-api/src/modules/fare-engine/fare-engine.service.ts
@@ -88,20 +88,48 @@ export class FareEngineService {
       where: {
         routeId: route.id,
         seatClassId: dto.seatClassId,
-        originStopSequence: originStop.sequence,
-        destinationStopSequence: destStop.sequence,
+        AND: [
+          {
+            OR: [
+              {
+                originStopSequence: originStop.sequence,
+                destinationStopSequence: destStop.sequence,
+              },
+              {
+                originStopSequence: destStop.sequence,
+                destinationStopSequence: originStop.sequence,
+              },
+            ],
+          },
+          {
+            OR: [{ validUntil: null }, { validUntil: { gte: now } }],
+          },
+        ],
         validFrom: { lte: now },
-        OR: [{ validUntil: null }, { validUntil: { gte: now } }],
         nationality: dto.nationality ?? null,
       },
     }) ?? await this.prisma.segmentFareRule.findFirst({
       where: {
         routeId: route.id,
         seatClassId: dto.seatClassId,
-        originStopSequence: originStop.sequence,
-        destinationStopSequence: destStop.sequence,
+        AND: [
+          {
+            OR: [
+              {
+                originStopSequence: originStop.sequence,
+                destinationStopSequence: destStop.sequence,
+              },
+              {
+                originStopSequence: destStop.sequence,
+                destinationStopSequence: originStop.sequence,
+              },
+            ],
+          },
+          {
+            OR: [{ validUntil: null }, { validUntil: { gte: now } }],
+          },
+        ],
         validFrom: { lte: now },
-        OR: [{ validUntil: null }, { validUntil: { gte: now } }],
         nationality: null,
       },
     });
diff --git a/apps/edr-passenger-api/src/modules/fleet/fleet.service.ts b/apps/edr-passenger-api/src/modules/fleet/fleet.service.ts
index a4c1d8ccf..103cbbc4b 100644
--- a/apps/edr-passenger-api/src/modules/fleet/fleet.service.ts
+++ b/apps/edr-passenger-api/src/modules/fleet/fleet.service.ts
@@ -4,6 +4,37 @@ import { CreateTrainDto, CreateCoachDto, UpdateCoachDto, AssignCoachDto, ListCoa
 import { SeatKind } from '@prisma/client';
 import { DeleteOperationException } from '../../common/exceptions/delete-operation.exception';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { snapshot } from '../../common/audit-snapshot';
+
+/** Fields carried into audit rows, per entity. Deliberately narrow — see audit-snapshot.ts. */
+const COACH_TYPE_AUDIT_FIELDS = ['code', 'name', 'type'] as const;
+const SEAT_CLASS_AUDIT_FIELDS = [
+  'coachTypeId',
+  'name',
+  'description',
+  'baseFareMinor',
+  'premiumMinor',
+  'insuranceFeeMinor',
+  'isActive',
+] as const;
+const TRAIN_AUDIT_FIELDS = [
+  'number',
+  'name',
+  'operatorId',
+  'operatorName',
+  'description',
+  'isActive',
+] as const;
+const COACH_AUDIT_FIELDS = [
+  'number',
+  'coachTypeId',
+  'arrangement',
+  'capacity',
+  'status',
+  'sequence',
+] as const;
+const COACH_ASSIGNMENT_AUDIT_FIELDS = ['scheduleId', 'coachId', 'positionNumber', 'isOperational'] as const;
 
 // Parses '2+2' → [2, 2], '2+2+2' → [2, 2, 2]
 function parseArrangement(arrangement: string): number[] {
@@ -151,7 +182,7 @@ export class FleetService {
   constructor(private prisma: PrismaService, private auditService: AuditService) {}
 
   async createCoachType(dto: CreateCoachTypeDto) {
-    return this.prisma.coachType.create({
+    const coachType = await this.prisma.coachType.create({
       data: {
         code: dto.code,
         name: dto.name,
@@ -162,6 +193,13 @@ export class FleetService {
         coaches: true,
       },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.CoachType,
+      entityId: coachType.id,
+      newData: snapshot(coachType, COACH_TYPE_AUDIT_FIELDS),
+    });
+    return coachType;
   }
 
   async getCoachTypes() {
@@ -183,7 +221,7 @@ export class FleetService {
     if (dto.name !== undefined) data.name = dto.name;
     if (dto.type !== undefined) data.type = dto.type;
     
-    return this.prisma.coachType.update({
+    const updated = await this.prisma.coachType.update({
       where: { id },
       data,
       include: {
@@ -191,6 +229,14 @@ export class FleetService {
         coaches: true,
       },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.CoachType,
+      entityId: id,
+      oldData: snapshot(coachType, COACH_TYPE_AUDIT_FIELDS),
+      newData: snapshot(updated, COACH_TYPE_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   async deleteCoachType(id: string) {
@@ -224,11 +270,18 @@ export class FleetService {
       throw new DeleteOperationException('Coach Type', coachType.name, constraints);
     }
     
-    return this.prisma.coachType.delete({ where: { id } });
+    const deleted = await this.prisma.coachType.delete({ where: { id } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.CoachType,
+      entityId: id,
+      oldData: snapshot(coachType, COACH_TYPE_AUDIT_FIELDS),
+    });
+    return deleted;
   }
 
   async createClass(dto: CreateClassDto) {
-    return this.prisma.seatClass.create({
+    const seatClass = await this.prisma.seatClass.create({
       data: {
         coachTypeId: dto.coachTypeId,
         name: dto.name,
@@ -239,6 +292,13 @@ export class FleetService {
         ...(dto.isActive !== undefined && { isActive: dto.isActive }),
       },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.SeatClass,
+      entityId: seatClass.id,
+      newData: snapshot(seatClass, SEAT_CLASS_AUDIT_FIELDS),
+    });
+    return seatClass;
   }
 
   async getClasses(coachTypeId?: string) {
@@ -267,11 +327,19 @@ export class FleetService {
       updateData.isActive = dto.isActive;
     }
     
-    return this.prisma.seatClass.update({
+    const updated = await this.prisma.seatClass.update({
       where: { id },
       data: updateData,
       include: { coachType: true },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.SeatClass,
+      entityId: id,
+      oldData: snapshot(seatClass, SEAT_CLASS_AUDIT_FIELDS),
+      newData: snapshot(updated, SEAT_CLASS_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   async deleteClass(id: string, cascade = false) {
@@ -308,7 +376,15 @@ export class FleetService {
       await this.prisma.segmentFareRule.deleteMany({ where: { seatClassId: id } });
     }
     
-    return this.prisma.seatClass.delete({ where: { id } });
+    const deleted = await this.prisma.seatClass.delete({ where: { id } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.SeatClass,
+      entityId: id,
+      oldData: snapshot(seatClass, SEAT_CLASS_AUDIT_FIELDS),
+      newData: { cascade },
+    });
+    return deleted;
   }
 
   createSeatClass(dto: CreateClassDto) {
@@ -345,7 +421,12 @@ export class FleetService {
         isActive: dto.isActive ?? true,
       },
     });
-    await this.auditService.log({ action: 'CREATE', entityType: 'Train', entityId: train.id, newData: { number: train.number, name: train.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Train,
+      entityId: train.id,
+      newData: snapshot(train, TRAIN_AUDIT_FIELDS),
+    });
     return train;
   }
 
@@ -363,7 +444,13 @@ export class FleetService {
         ...(dto.isActive !== undefined && { isActive: dto.isActive }),
       },
     });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Train', entityId: id, newData: { number: dto.number, name: dto.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Train,
+      entityId: id,
+      oldData: snapshot(train, TRAIN_AUDIT_FIELDS),
+      newData: snapshot(updated, TRAIN_AUDIT_FIELDS),
+    });
     return updated;
   }
 
@@ -442,14 +529,28 @@ export class FleetService {
     }
     
     const deleted = await this.prisma.train.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'Train', entityId: id, oldData: { number: train.number, name: train.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Train,
+      entityId: id,
+      oldData: snapshot(train, TRAIN_AUDIT_FIELDS),
+      newData: { cascade },
+    });
     return deleted;
   }
 
   async restoreTrain(id: string) {
     const train = await this.prisma.train.findUnique({ where: { id } });
     if (!train) throw new NotFoundException('Train not found');
-    return this.prisma.train.update({ where: { id }, data: { isActive: true } });
+    const restored = await this.prisma.train.update({ where: { id }, data: { isActive: true } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.RESTORE,
+      entityType: AUDIT_ENTITIES.Train,
+      entityId: id,
+      oldData: { isActive: train.isActive },
+      newData: { isActive: true },
+    });
+    return restored;
   }
 
   async getCoach(id: string) {
@@ -526,7 +627,12 @@ export class FleetService {
       await this.prisma.seat.createMany({ data: seats });
     }
 
-    await this.auditService.log({ action: 'CREATE', entityType: 'Coach', entityId: coach.id, newData: { number: coach.number, capacity: coach.capacity } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Coach,
+      entityId: coach.id,
+      newData: snapshot(coach, COACH_AUDIT_FIELDS),
+    });
     return coach;
   }
 
@@ -545,7 +651,13 @@ export class FleetService {
       },
       include: { coachType: true },
     });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Coach', entityId: id, newData: { number: dto.number, status: dto.status } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Coach,
+      entityId: id,
+      oldData: snapshot(coach, COACH_AUDIT_FIELDS),
+      newData: snapshot(updated, COACH_AUDIT_FIELDS),
+    });
     return updated;
   }
 
@@ -622,7 +734,13 @@ export class FleetService {
     await this.prisma.seat.deleteMany({ where: { coachId: id } });
     
     const deleted = await this.prisma.coach.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'Coach', entityId: id, oldData: { number: coach.number } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Coach,
+      entityId: id,
+      oldData: snapshot(coach, COACH_AUDIT_FIELDS),
+      newData: { cascade },
+    });
     return deleted;
   }
 
@@ -634,13 +752,30 @@ export class FleetService {
     if (!schedule) throw new NotFoundException('Schedule not found');
     if (!coach) throw new NotFoundException('Coach not found');
     if (coach.status !== 'ACTIVE') throw new BadRequestException('Coach is not active');
-    return this.prisma.coachAssignment.create({ data: dto });
+    const assignment = await this.prisma.coachAssignment.create({ data: dto });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.ASSIGN,
+      entityType: AUDIT_ENTITIES.CoachAssignment,
+      entityId: assignment.id,
+      newData: {
+        ...snapshot(assignment, COACH_ASSIGNMENT_AUDIT_FIELDS),
+        coachNumber: coach.number,
+      },
+    });
+    return assignment;
   }
 
   async removeAssignment(id: string) {
     const assignment = await this.prisma.coachAssignment.findUnique({ where: { id } });
     if (!assignment) throw new NotFoundException('Assignment not found');
-    return this.prisma.coachAssignment.delete({ where: { id } });
+    const deleted = await this.prisma.coachAssignment.delete({ where: { id } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UNASSIGN,
+      entityType: AUDIT_ENTITIES.CoachAssignment,
+      entityId: id,
+      oldData: snapshot(assignment, COACH_ASSIGNMENT_AUDIT_FIELDS),
+    });
+    return deleted;
   }
 
   async generateSeatMapPreview(dto: GenerateSeatMapDto) {
diff --git a/apps/edr-passenger-api/src/modules/notifications/notifications.service.ts b/apps/edr-passenger-api/src/modules/notifications/notifications.service.ts
index 9ef922bb3..3b7e7be2f 100644
--- a/apps/edr-passenger-api/src/modules/notifications/notifications.service.ts
+++ b/apps/edr-passenger-api/src/modules/notifications/notifications.service.ts
@@ -8,6 +8,7 @@ import { EmailClientService } from './email-client.service';
 import { SmsClientService } from './sms-client.service';
 import { CreateTemplateDto, UpdateTemplateDto } from './notifications.dto';
 import { resolveBookingSegment } from '../../common/utils/segment-resolver.utils';
+import { buildSeatSummary } from '../../common/utils/booking-sms.utils';
 
 export type NotificationChannelType = 'EMAIL' | 'SMS' | 'PUSH' | 'IN_APP';
 
@@ -305,7 +306,7 @@ export class NotificationsService {
       where: { id: bookingId },
       include: {
         schedule: { include: { originStation: true, destinationStation: true, train: true, stopTimes: { include: { station: true } } } },
-        seats: { include: { seat: { include: { coach: { include: { coachType: true } } } } } },
+        seats: { include: { seat: { include: { coach: { include: { coachType: true } } } } }, orderBy: { leg: 'asc' } },
       },
     });
 
@@ -367,30 +368,19 @@ export class NotificationsService {
   }
 
   /**
-   * Builds the interpolation context for the `booking.created` template. `trainSeatLines` is a
-   * pre-joined block of one "Train/Seat: …" line per booked seat (multi-passenger bookings get
-   * several lines).
+   * Builds the interpolation context for the `booking.created` template. `passengerName` and
+   * `trainSeatLines` both come from buildSeatSummary — a solo booking is greeted by name with
+   * bare "coach, seat no." lines, while a group is greeted as "Passengers" and each line names
+   * its own occupant (one SMS goes to Booking.contactPhone for the whole party).
    */
   private buildBookingCreatedContext(booking: any, ref: string): Record<string, unknown> {
     const s = booking?.schedule ?? {};
-    const trainName = s.train?.name ?? s.train?.number ?? '';
     const fmtDate = (d: any) =>
       d ? new Date(d).toLocaleDateString('en-US', { month: 'short', day: '2-digit', year: 'numeric' }) : 'TBD';
     const fmtTime = (d: any) =>
       d ? new Date(d).toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: true }) : 'TBD';
 
-    const seats = booking?.seats ?? [];
-    const trainSeatLines = seats
-      .map((bs: any) => {
-        const coach = bs.seat?.coach?.number ?? '-';
-        const cls = bs.seat?.coach?.coachType?.name ?? '';
-        const seatNo = bs.seat?.seatNumber ?? '-';
-        return `Train/Seat: Train ${trainName}, ${coach} ${cls}, seat no. ${seatNo}`.replace(/ +/g, ' ').trim();
-      })
-      .join('\n');
-
-    // Lead passenger (leg-1 seat). Booking has no contactName; the traveller name lives on the seat.
-    const passengerName = seats[0]?.passengerName ?? 'Passenger';
+    const { passengerName, trainSeatLines } = buildSeatSummary(booking?.seats ?? [], booking?.bookingType);
     const payLink = `${process.env.PORTAL_URL ?? 'http://localhost:5174'}/booking/detail?ref=${ref}`;
     const segment = resolveBookingSegment(s, booking?.originStationId, booking?.destinationStationId);
 
diff --git a/apps/edr-passenger-api/src/modules/payments/internal-payments.controller.ts b/apps/edr-passenger-api/src/modules/payments/internal-payments.controller.ts
index df5949bde..1b82389fb 100644
--- a/apps/edr-passenger-api/src/modules/payments/internal-payments.controller.ts
+++ b/apps/edr-passenger-api/src/modules/payments/internal-payments.controller.ts
@@ -8,6 +8,7 @@ import {
   UseGuards,
 } from "@nestjs/common";
 import { ApiOperation, ApiTags } from "@nestjs/swagger";
+import { PaymentReferenceType } from "@edr/types";
 import { ServiceAuthGuard } from "../../common/guards/service-auth.guard";
 import {
   PaymentEventDto,
@@ -51,6 +52,17 @@ export class InternalPaymentsController {
   async billQuery(
     @Body() request: BillQueryRequestDto,
   ): Promise<BillQueryResponseDto> {
+    // Routed on referenceType: the passenger app issues CBE bills for bookings AND for excess
+    // baggage charges, and they live in different tables. Treating every referenceId as a
+    // bookingId would report a perfectly payable baggage bill as NOT_FOUND to the teller.
+    if (request.referenceType === PaymentReferenceType.EXCESS_BAGGAGE) {
+      return this.paymentsService.billQueryExcessBaggage(request.referenceId);
+    }
+    if (request.referenceType === PaymentReferenceType.SUPPLEMENTARY_CHARGE) {
+      return this.paymentsService.billQuerySupplementaryCharge(
+        request.referenceId,
+      );
+    }
     return this.paymentsService.billQuery(request.referenceId);
   }
 }
diff --git a/apps/edr-passenger-api/src/modules/payments/payment-client.service.ts b/apps/edr-passenger-api/src/modules/payments/payment-client.service.ts
index e723dc8ce..bf6c86fea 100644
--- a/apps/edr-passenger-api/src/modules/payments/payment-client.service.ts
+++ b/apps/edr-passenger-api/src/modules/payments/payment-client.service.ts
@@ -22,6 +22,13 @@ export interface PaymentDiagnostic {
   provider: ProviderStatus | null;
 }
 
+/**
+ * Why a settlement check came back `unverifiable` (mirrors the payment service's
+ * ReconcileUnverifiableReason). `IN_FLIGHT` means money is actually moving and must be waited out;
+ * `PROVIDER_ERROR` can be a permanently unreachable gateway, which a sweep may eventually give up on.
+ */
+export type SettlementUnverifiableReason = "IN_FLIGHT" | "PROVIDER_ERROR";
+
 /** Settlement check from POST /payments/reconcile (verify-before-cancel). */
 export interface SettlementResult {
   /** At least one intent for the order is paid (incl. a late capture just registered). */
@@ -31,6 +38,8 @@ export interface SettlementResult {
   /** Settlement could not be confirmed — a provider query errored, a payment is in flight, OR the
    *  payment service was unreachable. The caller MUST NOT cancel the order. */
   unverifiable: boolean;
+  /** Set whenever `unverifiable` — which of the two causes applies. */
+  reason?: SettlementUnverifiableReason;
 }
 
 /**
@@ -117,7 +126,9 @@ export class PaymentClientService {
       this.logger.warn(
         `reconcile ${referenceType}/${referenceId} failed: ${message}; treating as unverifiable (will not cancel)`,
       );
-      return { paid: false, unverifiable: true };
+      // The payment service itself is unreachable — indistinguishable from a dead gateway, and
+      // like one it may never recover, so it is a PROVIDER_ERROR (give-up-able), not IN_FLIGHT.
+      return { paid: false, unverifiable: true, reason: "PROVIDER_ERROR" };
     }
   }
 
@@ -173,9 +184,6 @@ export class PaymentClientService {
     body?: unknown,
   ): Promise<T> {
     const url = `${this.baseUrl}${path}`;
-    this.logger.log("=====================================================================");
-    this.logger.log(`URL ${url}`);
-    this.logger.log("=====================================================================");
     try {
       const response = await firstValueFrom(
         this.http.request<T>({
diff --git a/apps/edr-passenger-api/src/modules/payments/payments.controller.ts b/apps/edr-passenger-api/src/modules/payments/payments.controller.ts
index 7da37df33..847ccf2c7 100644
--- a/apps/edr-passenger-api/src/modules/payments/payments.controller.ts
+++ b/apps/edr-passenger-api/src/modules/payments/payments.controller.ts
@@ -9,6 +9,7 @@ import {
   Patch,
   Post,
   Query,
+  Req,
   Res,
   SetMetadata,
   UseGuards,
@@ -38,6 +39,7 @@ import {
 } from "./payments.dto";
 import { PassengerStaff } from "../../common/passenger-guards";
 import { PASSENGER_PERMS } from "../../seed/passenger-permissions.registry";
+import { resolveActingUser } from "../../common/acting-user";
 import { resolveAllowedOrigin } from "../../common/utils/redirect-origin.util";
 import { SupplementaryChargesService } from "./supplementary-charges.service";
 import { IsString, IsInt, IsOptional, Min, IsEnum, IsIn } from "class-validator";
@@ -56,7 +58,19 @@ class WaiveSupplementaryChargeDto {
 
 class PaySupplementaryChargeDto {
   @ApiProperty({ enum: PaymentMethodTypeEnum, example: 'TELEBIRR' }) @IsEnum(PaymentMethodTypeEnum) method: PaymentMethodTypeEnum;
-  @ApiPropertyOptional({ enum: ['web', 'mobile'], default: 'web' }) @IsOptional() @IsIn(['web', 'mobile']) platform?: 'web' | 'mobile';
+  @ApiPropertyOptional({ enum: ['web', 'mobile', 'inapp'], default: 'web' }) @IsOptional() @IsIn(['web', 'mobile', 'inapp']) platform?: PaymentPlatformDto;
+  @ApiPropertyOptional({
+    description:
+      'Payer account / mobile number. Required for the push-debit methods: CAC_BANK (the bank ' +
+      'SMSes a one-time password to it) and EBIRR (the wallet pushes a USSD PIN prompt to it).',
+    example: '77123456',
+  })
+  @IsOptional() @IsString() payerAccount?: string;
+}
+
+class ConfirmSupplementaryOtpDto {
+  @ApiProperty({ description: 'One-time password the payer received by SMS (CAC Bank).', example: '4530' })
+  @IsString() otp: string;
 }
 
 @ApiTags("Payment")
@@ -85,14 +99,20 @@ export class PaymentsController {
   @ApiBearerAuth("IAM-auth")
   @ApiOperation({ summary: "Get all payments with filters (staff/admin only)" })
   @ApiQuery({ name: "search", required: false })
-  @ApiQuery({ name: "status", required: false })
+  @ApiQuery({ name: "status", required: false, description: "PaymentIntentStatus value, e.g. SUCCEEDED" })
   @ApiQuery({ name: "method", required: false })
+  @ApiQuery({
+    name: "bookingStatus",
+    required: false,
+    description: "Comma-separated Booking.status values, e.g. CONFIRMED,BOARDED — restricts to payments backing bookings in those states.",
+  })
   @ApiQuery({ name: "page", required: false })
   @ApiQuery({ name: "pageSize", required: false })
   async getAll(
     @Query("search") search?: string,
     @Query("status") status?: string,
     @Query("method") method?: string,
+    @Query("bookingStatus") bookingStatus?: string,
     @Query("page") page?: string,
     @Query("pageSize") pageSize?: string,
   ) {
@@ -100,6 +120,7 @@ export class PaymentsController {
       search,
       status,
       method,
+      bookingStatus,
       page: page ? parseInt(page) : 1,
       pageSize: pageSize ? parseInt(pageSize) : 10,
     });
@@ -211,17 +232,14 @@ export class PaymentsController {
   }
 
   @Post(":bookingId/force-confirm")
-  @PassengerStaff([
-    PASSENGER_PERMS.payments.manage,
-    PASSENGER_PERMS.payments.manageMethods,
-    PASSENGER_PERMS.admin,
-  ])
+  @PassengerStaff([PASSENGER_PERMS.tickets.generate, PASSENGER_PERMS.admin])
   @ApiBearerAuth("IAM-auth")
   @ApiOperation({
-    summary: "Force-confirm payment & generate ticket (back-office only)",
+    summary: "Force-confirm payment & generate ticket (ticket-generate permission)",
     description:
       "Marks the payment as SUCCEEDED, confirms the booking, and generates the ticket. " +
-      "Use when a vendor payment completed but the webhook was never delivered. Idempotent.",
+      "Use when a vendor payment completed but the webhook was never delivered. Idempotent. " +
+      "Requires `edr_passenger_app:tickets:generate` (admins bypass).",
   })
   forceConfirm(
     @Param("bookingId") bookingId: string,
@@ -307,7 +325,14 @@ export class PaymentsController {
   })
   @ApiQuery({ name: "bookingId", required: true })
   @ApiQuery({ name: "method", enum: PaymentMethodTypeEnum, required: true })
-  @ApiQuery({ name: "platform", enum: ["web", "mobile"], required: false })
+  @ApiQuery({
+    name: "platform",
+    enum: ["web", "mobile"],
+    required: false,
+    description:
+      "Browser-only endpoint — `inapp` is not offered here. A mini-app payer has no browser " +
+      "to redirect and must go through POST /payments/initiate for the bridge payload.",
+  })
   @ApiProduces("text/html")
   async checkout(
     @Query("bookingId") bookingId: string,
@@ -370,13 +395,13 @@ export class PaymentsController {
   @PassengerStaff([PASSENGER_PERMS.payments.manage, PASSENGER_PERMS.admin])
   @ApiBearerAuth('IAM-auth')
   @ApiOperation({ summary: 'Raise a supplementary charge for an underpayment (staff only)' })
-  createSupplementaryCharge(
-    @Body() dto: CreateSupplementaryChargeDto,
-    @Headers('x-iam-user-id') iamUserId?: string,
-  ) {
+  createSupplementaryCharge(@Body() dto: CreateSupplementaryChargeDto, @Req() req: any) {
+    // Actor comes from the guarded session, not the client-settable `x-iam-user-id` header it
+    // used to read (which defaulted to the literal string 'staff').
+    const actor = resolveActingUser(req);
     return this.supplementaryService.create({
       ...dto,
-      createdBy: iamUserId ?? 'staff',
+      createdBy: actor?.id ?? 'staff',
     });
   }
 
@@ -409,6 +434,52 @@ export class PaymentsController {
     return this.supplementaryService.getByToken(token);
   }
 
+  @Get('supplementary/by-token/:token/amount')
+  @SetMetadata('isPublic', true)
+  @ApiOperation({
+    summary: 'Quote a supplementary charge in a payment method’s settlement currency (public)',
+    description:
+      'Returns what the given method would debit, converted from the charge’s stored ETB amount ' +
+      'to that method’s settlement currency (WAAFI/DMONEY settle in DJF, CARD in USD, Ethiopian ' +
+      'wallets in ETB). The self-pay page quotes this before the payer commits; paying recomputes ' +
+      'it identically.',
+  })
+  @ApiQuery({ name: 'method', required: true, example: 'WAAFI' })
+  quoteSupplementaryAmount(
+    @Param('token') token: string,
+    @Query('method') method: string,
+  ) {
+    return this.supplementaryService.quoteAmount(token, method);
+  }
+
+  @Get('supplementary/by-token/:token/status')
+  @SetMetadata('isPublic', true)
+  @ApiOperation({
+    summary: 'Poll a supplementary charge’s settlement status (public)',
+    description:
+      'Reports the charge’s current status without the payability gate on the by-token lookup, ' +
+      'so a page can watch for settlement that happens out of band (a CBE bill paid at a branch, ' +
+      'or a redirect payment confirmed by webhook).',
+  })
+  getSupplementaryStatus(@Param('token') token: string) {
+    return this.supplementaryService.getStatus(token);
+  }
+
+  @Post('supplementary/by-token/:token/confirm')
+  @SetMetadata('isPublic', true)
+  @ApiOperation({
+    summary: 'Confirm an OTP-debit balance payment (CAC Bank, public — self-pay)',
+    description:
+      'Submits the one-time password the payer received by SMS. A wrong or expired OTP returns ' +
+      '400 and the payment stays open for retry.',
+  })
+  confirmSupplementaryOtp(
+    @Param('token') token: string,
+    @Body() dto: ConfirmSupplementaryOtpDto,
+  ) {
+    return this.supplementaryService.confirmOtp(token, dto.otp);
+  }
+
   @Post('supplementary/by-token/:token/pay')
   @SetMetadata('isPublic', true)
   @ApiOperation({ summary: 'Initiate payment for a supplementary charge (public — self-pay)' })
@@ -426,6 +497,7 @@ export class PaymentsController {
       dto.method,
       dto.platform,
       resolveAllowedOrigin(origin, referer, frontendBaseUrl),
+      dto.payerAccount,
     );
   }
 
@@ -447,9 +519,10 @@ export class PaymentsController {
   waiveSupplementaryCharge(
     @Param('id') id: string,
     @Body() dto: WaiveSupplementaryChargeDto,
-    @Headers('x-iam-user-id') iamUserId?: string,
+    @Req() req: any,
   ) {
-    return this.supplementaryService.waive(id, dto.notes ?? '', iamUserId ?? 'staff');
+    const actor = resolveActingUser(req);
+    return this.supplementaryService.waive(id, dto.notes ?? '', actor?.id ?? 'staff');
   }
 
   @Post('supplementary/:id/resend')
diff --git a/apps/edr-passenger-api/src/modules/payments/payments.dto.ts b/apps/edr-passenger-api/src/modules/payments/payments.dto.ts
index dc389e5a1..924792d4f 100644
--- a/apps/edr-passenger-api/src/modules/payments/payments.dto.ts
+++ b/apps/edr-passenger-api/src/modules/payments/payments.dto.ts
@@ -21,14 +21,15 @@ export enum PaymentMethodTypeEnum {
   CBE_BIRR = "CBE_BIRR", // Ethiopia
   EBIRR = "EBIRR", // Ethiopia
   WAAFI = "WAAFI",
-  DMONEY= "DMONEY",// Djibouti
+  DMONEY = "DMONEY", // Djibouti
   CAC_BANK = "CAC_BANK", // Djibouti (OTP debit)
   CARD = "CARD", // International
   WALLET = "WALLET", // Internal
   CBE_BILL = "CBE_BILL", // Ethiopia (pay at any CBE channel by bill number)
 }
 
-export type PaymentPlatformDto = "web" | "mobile";
+/** Mirrors `PaymentPlatform` in @edr/types — see there for what each surface means. */
+export type PaymentPlatformDto = "web" | "mobile" | "inapp";
 
 export class InitiatePaymentDto {
   @ApiProperty({ example: "booking-uuid" }) @IsString() bookingId: string;
@@ -45,18 +46,21 @@ export class InitiatePaymentDto {
   @IsString()
   paymentMethodId?: string;
   @ApiPropertyOptional({
-    enum: ["web", "mobile"],
+    enum: ["web", "mobile", "inapp"],
     default: "web",
-    description: "Payment platform (web or mobile)",
+    description:
+      "Payer surface. `inapp` = the portal is running inside a SuperApp mini-app WebView " +
+      "(Telebirr), which cannot follow redirect flows and gets a bridge payload instead.",
   })
   @IsOptional()
-  @IsIn(["web", "mobile"])
+  @IsIn(["web", "mobile", "inapp"])
   platform?: PaymentPlatformDto;
   @ApiPropertyOptional({
     description:
-      "Payer account / mobile number. Required for OTP-debit methods (CAC_BANK) — " +
-      "the bank sends the OTP to this number.",
-    example: "77112233",
+      "Payer account / mobile number. Required for push-debit methods: CAC_BANK (the bank " +
+      "sends an OTP to this number) and EBIRR (the wallet pushes a USSD PIN prompt to it). " +
+      "Ethiopian numbers are accepted as +251…, 251…, 09… or 9… and normalised server-side.",
+    example: "+251923582676",
   })
   @IsOptional()
   @IsString()
@@ -117,9 +121,22 @@ export class SupportedPaymentMethodDto {
 
 export class ClientActionDto {
   @ApiProperty({
-    enum: ["REDIRECT", "LAUNCH_APP", "COLLECT_OTP", "SHOW_BILL_REFERENCE"],
+    enum: [
+      "REDIRECT",
+      "LAUNCH_APP",
+      "INVOKE_BRIDGE",
+      "COLLECT_OTP",
+      "AWAIT_PUSH",
+      "SHOW_BILL_REFERENCE",
+    ],
   })
-  type: "REDIRECT" | "LAUNCH_APP" | "COLLECT_OTP" | "SHOW_BILL_REFERENCE";
+  type:
+    | "REDIRECT"
+    | "LAUNCH_APP"
+    | "INVOKE_BRIDGE"
+    | "COLLECT_OTP"
+    | "AWAIT_PUSH"
+    | "SHOW_BILL_REFERENCE";
   @ApiPropertyOptional({ description: "Set when type=REDIRECT (web flow)" })
   url?: string;
   @ApiPropertyOptional({
@@ -134,10 +151,34 @@ export class ClientActionDto {
     description: "Set when type=LAUNCH_APP (mobile flow)",
   })
   shortCode?: string;
-  @ApiPropertyOptional({ description: "Set when type=COLLECT_OTP (e.g. CAC Bank)" })
+  @ApiPropertyOptional({
+    description:
+      "Set when type=INVOKE_BRIDGE (telebirr mini app) — which SuperApp host bridge to call",
+    enum: ["TELEBIRR"],
+  })
+  bridge?: "TELEBIRR";
+  @ApiPropertyOptional({
+    description:
+      "Set when type=INVOKE_BRIDGE (telebirr mini app). Signed query string handed verbatim " +
+      "to the host bridge (js_fun_start_pay). NOT a URL — never navigate to it.",
+  })
+  rawRequest?: string;
+  @ApiPropertyOptional({
+    description: "Set when type=COLLECT_OTP (e.g. CAC Bank)",
+  })
   providerOrderId?: string;
-  @ApiPropertyOptional({ description: "Set when type=COLLECT_OTP" })
+  @ApiPropertyOptional({
+    description:
+      "Set when type=COLLECT_OTP or type=AWAIT_PUSH — text to show the payer",
+  })
   message?: string;
+  @ApiPropertyOptional({
+    description:
+      "Set when type=AWAIT_PUSH (eBirr). Masked wallet number the PIN prompt was pushed to, " +
+      "so the payer can confirm it is their handset. Nothing to navigate to — poll the intent.",
+    example: "2519****2676",
+  })
+  payerAccountMasked?: string;
   @ApiPropertyOptional({
     description: "Set when type=SHOW_BILL_REFERENCE (CBE bill payment)",
   })
@@ -154,6 +195,13 @@ export class InitiateResponseDto {
   @ApiPropertyOptional({ type: ClientActionDto })
   clientAction?: ClientActionDto;
   @ApiPropertyOptional() merchantOrderId?: string;
+  /** Set when initiate already settled terminally (eBirr debits synchronously — no webhook). */
+  @ApiPropertyOptional() failureCode?: string;
+  @ApiPropertyOptional() failureMessage?: string;
+  /** When this payment session stops being offered — PAYMENT_SESSION_MINUTES from initiation, capped at paymentDeadline. Drives the client-side countdown. */
+  @ApiPropertyOptional() sessionExpiresAt?: string;
+  /** The booking's payment deadline: after it, the booking is auto-cancelled. */
+  @ApiPropertyOptional() paymentDeadline?: string;
 }
 
 export class IntentStatusDto {
@@ -175,18 +223,43 @@ export class IntentStatusDto {
 }
 
 export class BookingAmountResponseDto {
-  @ApiProperty({ example: 'booking-uuid' }) booking_id: string;
-  @ApiProperty({ example: 'DJF', description: 'Currency of the returned amount' }) currency: string;
-  @ApiProperty({ example: 162.5, description: 'Booking total converted to the requested currency (major units)' }) amount: number;
+  @ApiProperty({ example: "booking-uuid" }) booking_id: string;
+  @ApiProperty({
+    example: "DJF",
+    description: "Currency of the returned amount",
+  })
+  currency: string;
+  @ApiProperty({
+    example: 162.5,
+    description:
+      "Booking total converted to the requested currency (major units)",
+  })
+  amount: number;
 }
 
 export class ForceConfirmDto {
-  @ApiPropertyOptional({ description: 'External payment reference / transaction ID from the vendor', example: 'TXN-123456' })
-  @IsOptional() @IsString() paymentReference?: string;
+  @ApiPropertyOptional({
+    description: "External payment reference / transaction ID from the vendor",
+    example: "TXN-123456",
+  })
+  @IsOptional()
+  @IsString()
+  paymentReference?: string;
 
-  @ApiPropertyOptional({ enum: PaymentMethodTypeEnum, description: 'Payment method used externally', example: 'TELEBIRR' })
-  @IsOptional() @IsEnum(PaymentMethodTypeEnum) paymentMethod?: PaymentMethodTypeEnum;
+  @ApiPropertyOptional({
+    enum: PaymentMethodTypeEnum,
+    description: "Payment method used externally",
+    example: "TELEBIRR",
+  })
+  @IsOptional()
+  @IsEnum(PaymentMethodTypeEnum)
+  paymentMethod?: PaymentMethodTypeEnum;
 
-  @ApiPropertyOptional({ description: 'Internal notes about why this was force-confirmed', example: 'Vendor confirmed via phone' })
-  @IsOptional() @IsString() notes?: string;
+  @ApiPropertyOptional({
+    description: "Internal notes about why this was force-confirmed",
+    example: "Vendor confirmed via phone",
+  })
+  @IsOptional()
+  @IsString()
+  notes?: string;
 }
diff --git a/apps/edr-passenger-api/src/modules/payments/payments.service.spec.ts b/apps/edr-passenger-api/src/modules/payments/payments.service.spec.ts
index 8c4edf083..6c8f4b58d 100644
--- a/apps/edr-passenger-api/src/modules/payments/payments.service.spec.ts
+++ b/apps/edr-passenger-api/src/modules/payments/payments.service.spec.ts
@@ -16,6 +16,11 @@ import {
   ProviderMethod,
   ProviderPaymentStatus,
 } from "@edr/types";
+import {
+  MAX_PAYMENT_HOURS,
+  MIN_PAYMENT_WINDOW_MINUTES,
+  PAYMENT_SESSION_MINUTES,
+} from "../../common/utils/payment-deadline.utils";
 
 describe("PaymentsService", () => {
   let service: PaymentsService;
@@ -35,11 +40,24 @@ describe("PaymentsService", () => {
       findUniqueOrThrow: jest.fn(),
       upsert: jest.fn(),
       update: jest.fn(),
+      updateMany: jest.fn(),
       create: jest.fn(),
     },
     paymentMethod: {
       findUnique: jest.fn(),
     },
+    excessBaggageCharge: {
+      findUnique: jest.fn(),
+      update: jest.fn(),
+      // The charge handlers claim the PAID transition with a conditional updateMany so the
+      // in-app path and this webhook cannot both write an audit row for one settlement.
+      updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+    },
+    supplementaryCharge: {
+      findUnique: jest.fn(),
+      update: jest.fn(),
+      updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+    },
     currencyExchangeRate: {
       findFirst: jest.fn(),
     },
@@ -76,6 +94,7 @@ describe("PaymentsService", () => {
   const mockPaymentClient = {
     initiate: jest.fn(),
     getIntentByReference: jest.fn(),
+    reconcileByReference: jest.fn(),
   };
 
   // Mirrors the real ETB→major conversion: minor units → major price (TELEBIRR settles in ETB).
@@ -163,6 +182,69 @@ describe("PaymentsService", () => {
       ).rejects.toThrow(BadRequestException);
     });
 
+    /**
+     * A booking whose payment deadline lands exactly `minutesLeft` from now: the deadline is
+     * MIN(createdAt + MAX_PAYMENT_HOURS, departure - checkin), so back-date createdAt and keep
+     * departure far away. Derived from MAX_PAYMENT_HOURS so the test survives changes to it.
+     */
+    const bookingWithDeadlineIn = (minutesLeft: number) => ({
+      ...mockBooking,
+      createdAt: new Date(
+        Date.now() - (MAX_PAYMENT_HOURS * 60 - minutesLeft) * 60 * 1000,
+      ),
+      originStationId: null,
+      schedule: {
+        departureAt: new Date(Date.now() + 10 * 60 * 60 * 1000),
+        stopTimes: [],
+        route: null,
+      },
+    });
+
+    it("should refuse to open a provider session that cannot finish before auto-cancel", async () => {
+      // 2 minutes left — the real incident: the session was opened, the provider captured the
+      // money, and the auto-cancel cron had already cancelled the booking by then.
+      mockPrisma.booking.findUnique.mockResolvedValue(bookingWithDeadlineIn(2));
+
+      await expect(
+        service.initiatePayment({
+          bookingId: "booking-1",
+          method: "TELEBIRR" as any,
+        }),
+      ).rejects.toThrow(BadRequestException);
+
+      // Nothing may reach the provider — no session, no capture, no orphan payment.
+      expect(mockPaymentClient.initiate).not.toHaveBeenCalled();
+    });
+
+    it("should open a session and report its expiry when the window is wide enough", async () => {
+      const minutesLeft = MIN_PAYMENT_WINDOW_MINUTES + 3;
+      mockPrisma.booking.findUnique.mockResolvedValue(
+        bookingWithDeadlineIn(minutesLeft),
+      );
+      mockPaymentClient.initiate.mockResolvedValue(
+        requiresActionSnapshot(ProviderMethod.TELEBIRR),
+      );
+      mockPrisma.paymentIntent.upsert.mockResolvedValue({
+        id: "intent-1",
+        status: PaymentIntentStatus.REQUIRES_ACTION,
+        merchantOrderId: "PSG-MERCH-123",
+      });
+
+      const result = await service.initiatePayment({
+        bookingId: "booking-1",
+        method: "TELEBIRR" as any,
+      });
+
+      expect(mockPaymentClient.initiate).toHaveBeenCalled();
+      // Session ends PAYMENT_SESSION_MINUTES from now — before the deadline, not at it.
+      const sessionMs =
+        new Date(result.sessionExpiresAt!).getTime() - Date.now();
+      expect(sessionMs).toBeLessThanOrEqual(PAYMENT_SESSION_MINUTES * 60 * 1000);
+      expect(new Date(result.sessionExpiresAt!).getTime()).toBeLessThan(
+        new Date(result.paymentDeadline!).getTime(),
+      );
+    });
+
     it("should initiate a provider payment through the payment microservice", async () => {
       mockPrisma.booking.findUnique.mockResolvedValue(mockBooking);
       mockPaymentClient.initiate.mockResolvedValue(
@@ -174,6 +256,14 @@ describe("PaymentsService", () => {
         merchantOrderId: "PSG-MERCH-123",
         clientAction: { type: "REDIRECT", url: "https://provider.example/pay" },
       });
+      // syncIntentProjection applies the status in a separate guarded write (never demoting a
+      // SUCCEEDED row), then reads the projection back — so this is what it returns.
+      mockPrisma.paymentIntent.findUniqueOrThrow.mockResolvedValue({
+        id: "intent-1",
+        status: PaymentIntentStatus.REQUIRES_ACTION,
+        merchantOrderId: "PSG-MERCH-123",
+        clientAction: { type: "REDIRECT", url: "https://provider.example/pay" },
+      });
 
       const result = await service.initiatePayment({
         bookingId: "booking-1",
@@ -411,6 +501,14 @@ describe("PaymentsService", () => {
         merchantOrderId: "PSG-MERCH-123",
         clientAction: { type: "REDIRECT", url: "https://provider.example/pay" },
       });
+      // See above: the projection is read back after the guarded status write.
+      mockPrisma.paymentIntent.findUniqueOrThrow.mockResolvedValue({
+        id: "intent-1",
+        bookingId: "booking-1",
+        status: PaymentIntentStatus.REQUIRES_ACTION,
+        merchantOrderId: "PSG-MERCH-123",
+        clientAction: { type: "REDIRECT", url: "https://provider.example/pay" },
+      });
 
       const result = await service.getIntentByBookingId("booking-1");
 
@@ -431,4 +529,313 @@ describe("PaymentsService", () => {
       );
     });
   });
+
+  // Regression: a booking confirmed between a sweep's candidate query and its turn in the loop
+  // used to have its SUCCEEDED projection demoted to PROCESSING by the re-sync, with nothing
+  // able to restore it (finalizePaymentSuccess only writes SUCCEEDED while the booking is still
+  // PENDING_PAYMENT). A later stale payment.failed from an abandoned sibling attempt could then
+  // push that same row to FAILED, because markPaymentFailed only shields SUCCEEDED/CANCELLED.
+  describe("confirmed-booking projection integrity", () => {
+    it("does not re-sync or cancel a booking confirmed since the caller's snapshot", async () => {
+      mockPrisma.booking.findUnique.mockResolvedValue({ status: "CONFIRMED" });
+
+      const result = await service.reconcileAndConfirmIfPaid("booking-1");
+
+      expect(result).toEqual({ paid: true, verified: true });
+      // Neither the payment service nor the projection is touched.
+      expect(mockPaymentClient.reconcileByReference).not.toHaveBeenCalled();
+      expect(mockPrisma.paymentIntent.upsert).not.toHaveBeenCalled();
+    });
+
+    it("writes the mirrored status only where the row is not already SUCCEEDED", async () => {
+      mockPrisma.paymentIntent.findUnique.mockResolvedValue(null);
+      mockPaymentClient.getIntentByReference.mockResolvedValue(
+        requiresActionSnapshot(ProviderMethod.TELEBIRR),
+      );
+      mockPrisma.paymentIntent.findUniqueOrThrow.mockResolvedValue({
+        id: "intent-1",
+        bookingId: "booking-1",
+        status: PaymentIntentStatus.REQUIRES_ACTION,
+      });
+
+      await service.getIntentByBookingId("booking-1");
+
+      // The upsert must never carry a status on its update path...
+      const upsertArg = mockPrisma.paymentIntent.upsert.mock.calls[0][0];
+      expect(upsertArg.update).not.toHaveProperty("status");
+      // ...the status arrives through a write guarded on the row not being SUCCEEDED, which is
+      // what makes demoting the confirming payment structurally impossible.
+      expect(mockPrisma.paymentIntent.updateMany).toHaveBeenCalledWith(
+        expect.objectContaining({
+          where: expect.objectContaining({
+            status: { not: PaymentIntentStatus.SUCCEEDED },
+          }),
+        }),
+      );
+    });
+  });
+
+  /**
+   * Excess baggage settles through the same outbox → RabbitMQ path as bookings. Before this
+   * existed the consumer dropped every EXCESS_BAGGAGE event as "foreign-reference", so a charge
+   * the payer had genuinely paid stayed PENDING until its TTL flipped it to EXPIRED.
+   */
+  describe("handlePaymentEvent — excess baggage", () => {
+    const CHARGE_ID = "charge-1";
+
+    const succeededEvent = (overrides: Record<string, any> = {}) =>
+      ({
+        eventId: "evt-1",
+        eventType: "payment.succeeded",
+        service: PaymentServiceEnum.PASSENGER,
+        referenceType: PaymentReferenceType.EXCESS_BAGGAGE,
+        referenceId: CHARGE_ID,
+        amountMinor: 500,
+        currency: "ETB",
+        providerTxnId: "TXN-9",
+        ...overrides,
+      }) as any;
+
+    it("marks a pending charge PAID", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        id: CHARGE_ID,
+        status: "PENDING",
+      });
+
+      const result = await service.handlePaymentEvent(succeededEvent());
+
+      expect(mockPrisma.excessBaggageCharge.updateMany).toHaveBeenCalledWith(
+        expect.objectContaining({
+          where: expect.objectContaining({ id: CHARGE_ID }),
+          data: expect.objectContaining({ status: "PAID" }),
+        }),
+      );
+      expect(result).toEqual({ processed: true });
+    });
+
+    it("marks an EXPIRED charge PAID — the TTL governs starting a payment, not receiving one", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        id: CHARGE_ID,
+        status: "EXPIRED",
+      });
+
+      await service.handlePaymentEvent(succeededEvent());
+
+      expect(mockPrisma.excessBaggageCharge.updateMany).toHaveBeenCalledWith(
+        expect.objectContaining({
+          data: expect.objectContaining({ status: "PAID" }),
+        }),
+      );
+    });
+
+    it("does not re-pay an already PAID charge", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        id: CHARGE_ID,
+        status: "PAID",
+      });
+
+      const result = await service.handlePaymentEvent(succeededEvent());
+
+      expect(mockPrisma.excessBaggageCharge.updateMany).not.toHaveBeenCalled();
+      expect(result).toEqual({ processed: true, alreadyFinalized: true });
+    });
+
+    it("accepts a foreign-currency settlement without a short-pay comparison", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        id: CHARGE_ID,
+        status: "PENDING",
+      });
+
+      // 500.00 ETB charge settled as 1625 DJF — numerically unlike the stored total.
+      await service.handlePaymentEvent(
+        succeededEvent({ amountMinor: 1625, currency: "DJF" }),
+      );
+
+      expect(mockPrisma.excessBaggageCharge.updateMany).toHaveBeenCalledWith(
+        expect.objectContaining({
+          data: expect.objectContaining({ status: "PAID" }),
+        }),
+      );
+    });
+
+    it("acks a failure event without touching the charge", async () => {
+      const result = await service.handlePaymentEvent(
+        succeededEvent({ eventType: "payment.failed" }),
+      );
+
+      expect(mockPrisma.excessBaggageCharge.update).not.toHaveBeenCalled();
+      expect(result).toEqual({ processed: true });
+    });
+
+    it("acks an event for a charge that no longer exists", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue(null);
+
+      const result = await service.handlePaymentEvent(succeededEvent());
+
+      expect(result).toEqual({
+        processed: false,
+        reason: "charge-not-found",
+      });
+    });
+  });
+
+  /**
+   * The live hop CBE makes while a teller is on the line, for a baggage bill. This is the
+   * double-payment guard: anything other than stillPayable=true makes CBE refuse the debit.
+   */
+  describe("billQueryExcessBaggage", () => {
+    const payable = {
+      id: "charge-1",
+      excessWeightKg: 7,
+      totalMinor: 25_000,
+      status: "PENDING",
+      expiresAt: new Date(Date.now() + 60 * 60 * 1000),
+      booking: {
+        bookingRef: "BAG-001",
+        seats: [{ leg: 1, passengerName: "Abebe Kebede" }],
+        passenger: { user: { fullName: "Account Holder" } },
+      },
+    };
+
+    it("reports a pending charge as payable, in ETB, with the passenger name", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue(payable);
+
+      const result = await service.billQueryExcessBaggage("charge-1");
+
+      expect(result).toMatchObject({
+        stillPayable: true,
+        currency: "ETB",
+        currentAmountMinor: 250,
+        payerName: "Abebe Kebede",
+      });
+      expect(result.paymentReason).toContain("BAG-001");
+    });
+
+    it("refuses a charge already paid at the counter in cash", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        ...payable,
+        status: "CASH_COLLECTED",
+      });
+
+      await expect(
+        service.billQueryExcessBaggage("charge-1"),
+      ).resolves.toMatchObject({
+        stillPayable: false,
+        reason: "ALREADY_PAID",
+      });
+    });
+
+    it("refuses a waived charge", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        ...payable,
+        status: "WAIVED",
+      });
+
+      await expect(
+        service.billQueryExcessBaggage("charge-1"),
+      ).resolves.toMatchObject({ stillPayable: false, reason: "CANCELLED" });
+    });
+
+    it("refuses a charge whose deadline has passed", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        ...payable,
+        expiresAt: new Date(Date.now() - 1000),
+      });
+
+      await expect(
+        service.billQueryExcessBaggage("charge-1"),
+      ).resolves.toMatchObject({ stillPayable: false, reason: "EXPIRED" });
+    });
+
+    it("refuses within the settle margin, so a debit cannot land after expiry", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue({
+        ...payable,
+        expiresAt: new Date(Date.now() + 5_000), // inside the 60s margin
+      });
+
+      await expect(
+        service.billQueryExcessBaggage("charge-1"),
+      ).resolves.toMatchObject({ stillPayable: false, reason: "EXPIRED" });
+    });
+
+    it("reports NOT_FOUND for a bill whose charge is gone", async () => {
+      mockPrisma.excessBaggageCharge.findUnique.mockResolvedValue(null);
+
+      await expect(
+        service.billQueryExcessBaggage("charge-1"),
+      ).resolves.toEqual({ stillPayable: false, reason: "NOT_FOUND" });
+    });
+  });
+  /**
+   * The live hop CBE makes while a teller is on the line, for a balance bill. Same
+   * double-payment guard as bookings and baggage: anything other than stillPayable=true makes
+   * CBE refuse the debit.
+   */
+  describe("billQuerySupplementaryCharge", () => {
+    const payable = {
+      id: "sc-1",
+      amountMinor: 100_000,
+      status: "PENDING",
+      expiresAt: new Date(Date.now() + 60 * 60 * 1000),
+      booking: {
+        bookingRef: "BAL-001",
+        seats: [{ leg: 1, passengerName: "Abebe Kebede" }],
+        passenger: { user: { fullName: "Account Holder" } },
+      },
+    };
+
+    it("reports a pending charge as payable, in ETB, with the passenger name", async () => {
+      mockPrisma.supplementaryCharge.findUnique.mockResolvedValue(payable);
+      const result = await service.billQuerySupplementaryCharge("sc-1");
+      expect(result).toMatchObject({
+        stillPayable: true,
+        currency: "ETB",
+        currentAmountMinor: 1000,
+        payerName: "Abebe Kebede",
+      });
+      expect(result.paymentReason).toContain("BAL-001");
+    });
+
+    it("refuses an already paid charge", async () => {
+      mockPrisma.supplementaryCharge.findUnique.mockResolvedValue({ ...payable, status: "PAID" });
+      await expect(service.billQuerySupplementaryCharge("sc-1")).resolves.toMatchObject({
+        stillPayable: false,
+        reason: "ALREADY_PAID",
+      });
+    });
+
+    it("refuses a waived charge", async () => {
+      mockPrisma.supplementaryCharge.findUnique.mockResolvedValue({ ...payable, status: "WAIVED" });
+      await expect(service.billQuerySupplementaryCharge("sc-1")).resolves.toMatchObject({
+        stillPayable: false,
+        reason: "CANCELLED",
+      });
+    });
+
+    it("refuses within the settle margin so a debit cannot land after expiry", async () => {
+      mockPrisma.supplementaryCharge.findUnique.mockResolvedValue({
+        ...payable,
+        expiresAt: new Date(Date.now() + 5_000),
+      });
+      await expect(service.billQuerySupplementaryCharge("sc-1")).resolves.toMatchObject({
+        stillPayable: false,
+        reason: "EXPIRED",
+      });
+    });
+
+    it("treats a null expiry as an open-ended debt, still payable", async () => {
+      mockPrisma.supplementaryCharge.findUnique.mockResolvedValue({ ...payable, expiresAt: null });
+      await expect(service.billQuerySupplementaryCharge("sc-1")).resolves.toMatchObject({
+        stillPayable: true,
+      });
+    });
+
+    it("reports NOT_FOUND for a bill whose charge is gone", async () => {
+      mockPrisma.supplementaryCharge.findUnique.mockResolvedValue(null);
+      await expect(service.billQuerySupplementaryCharge("sc-1")).resolves.toEqual({
+        stillPayable: false,
+        reason: "NOT_FOUND",
+      });
+    });
+  });
 });
diff --git a/apps/edr-passenger-api/src/modules/payments/payments.service.ts b/apps/edr-passenger-api/src/modules/payments/payments.service.ts
index 14e48dce5..7192c7fc7 100644
--- a/apps/edr-passenger-api/src/modules/payments/payments.service.ts
+++ b/apps/edr-passenger-api/src/modules/payments/payments.service.ts
@@ -29,13 +29,31 @@ import {
   MarkPaidResponseDto,
   BillQueryResponseDto,
 } from "./internal-payments.dto";
-import { computePaymentDeadline } from "../../common/utils/payment-deadline.utils";
+import {
+  computePaymentDeadline,
+  computePaymentSessionExpiry,
+  canOpenPaymentSession,
+  MIN_PAYMENT_WINDOW_MINUTES,
+  PAYMENT_SETTLE_MARGIN_SECONDS,
+} from "../../common/utils/payment-deadline.utils";
 import {
   PaymentClientService,
   PaymentDiagnostic,
+  SettlementUnverifiableReason,
 } from "./payment-client.service";
 import { CurrencyService } from "../currency/currency.service";
 import { AuditService } from "../../common/audit.service";
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from "../../common/audit.actions";
+
+const PAYMENT_METHOD_AUDIT_FIELDS = [
+  "type",
+  "displayName",
+  "region",
+  "currency",
+  "providerId",
+  "enabled",
+  "sortOrder",
+] as const;
 import { rebaseUrlOrigin } from "../../common/utils/redirect-origin.util";
 import {
   PaymentService as PaymentServiceEnum,
@@ -80,9 +98,23 @@ export class PaymentsService {
   ) {}
 
   async deletePayment(id: string) {
-    const intent = await this.prisma.paymentIntent.findUnique({ where: { id } });
-    if (!intent) throw new NotFoundException('Payment intent not found');
+    const intent = await this.prisma.paymentIntent.findUnique({
+      where: { id },
+    });
+    if (!intent) throw new NotFoundException("Payment intent not found");
     await this.prisma.paymentIntent.delete({ where: { id } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Payment,
+      entityId: id,
+      oldData: {
+        bookingId: intent.bookingId,
+        status: intent.status,
+        amountMinor: intent.amountMinor,
+        currency: intent.currency,
+        method: intent.method,
+      },
+    });
     return { deleted: true, id };
   }
 
@@ -90,10 +122,13 @@ export class PaymentsService {
     search?: string;
     status?: string;
     method?: string;
+    /** Comma-separated Booking.status values, e.g. "CONFIRMED,BOARDED" — lets a caller ask
+     * for exactly the payments that back confirmed revenue, not every payment attempt. */
+    bookingStatus?: string;
     page?: number;
     pageSize?: number;
   }) {
-    const { search, status, method, page = 1, pageSize = 10 } = filters;
+    const { search, status, method, bookingStatus, page = 1, pageSize = 10 } = filters;
     const skip = (page - 1) * pageSize;
 
     const where: any = {};
@@ -109,6 +144,12 @@ export class PaymentsService {
     if (method) {
       where.method = method;
     }
+    if (bookingStatus) {
+      const statuses = bookingStatus.split(",").map((s) => s.trim()).filter(Boolean);
+      if (statuses.length > 0) {
+        where.booking = { status: { in: statuses } };
+      }
+    }
 
     const [items, total] = await Promise.all([
       this.prisma.paymentIntent.findMany({
@@ -124,6 +165,7 @@ export class PaymentsService {
               childCount: true,
               totalMinor: true,
               currency: true,
+              status: true,
               priceTier: { select: { priceMinor: true } },
             },
           },
@@ -141,20 +183,30 @@ export class PaymentsService {
         // For package round-trip bookings the stored amountMinor may be the single-leg
         // amount. Recompute from the tier price when applicable.
         let amountMinor = item.amountMinor;
-        if (b?.packageId && b?.bookingType === 'ROUND_TRIP' && b?.priceTier?.priceMinor) {
+        if (
+          b?.packageId &&
+          b?.bookingType === "ROUND_TRIP" &&
+          b?.priceTier?.priceMinor
+        ) {
           const adultFare = b.priceTier.priceMinor * 2;
           const childFare = Math.round(adultFare * 0.1);
-          const correctMinor = (b.adultCount || 1) * adultFare + (b.childCount || 0) * childFare;
+          const correctMinor =
+            (b.adultCount || 1) * adultFare + (b.childCount || 0) * childFare;
           // Convert to the charge currency ratio: stored amountMinor is in charge currency
           // (may be DJF/USD), but correctMinor is in ETB minor. Only override when the
           // currency is ETB (most common case); for foreign currencies keep stored value.
-          if (item.currency === 'ETB') amountMinor = correctMinor;
+          if (item.currency === "ETB") amountMinor = correctMinor;
         }
         return {
           id: item.id,
           reference: item.id.substring(0, 8),
           bookingId: item.bookingId,
-          booking: { bookingRef: b?.bookingRef, totalMinor: b?.totalMinor, currency: b?.currency },
+          booking: {
+            bookingRef: b?.bookingRef,
+            totalMinor: b?.totalMinor,
+            currency: b?.currency,
+            status: b?.status,
+          },
           amountMinor,
           currency: item.currency,
           method: item.method,
@@ -181,7 +233,11 @@ export class PaymentsService {
     priceTierId?: string | null;
     displayTotalMinor?: number | null;
   }): Promise<number> {
-    if (!booking.packageId || !booking.priceTierId || booking.bookingType !== 'ROUND_TRIP') {
+    if (
+      !booking.packageId ||
+      !booking.priceTierId ||
+      booking.bookingType !== "ROUND_TRIP"
+    ) {
       return booking.totalMinor;
     }
     // New bookings store displayTotalMinor from the frontend's reviewedTotalMinor; their
@@ -190,17 +246,30 @@ export class PaymentsService {
       return booking.totalMinor;
     }
     // Legacy path: old bookings may have stored a single-leg totalMinor — recompute from tier.
-    const tier = await this.prisma.packagePriceTier.findUnique({ where: { id: booking.priceTierId } });
+    const tier = await this.prisma.packagePriceTier.findUnique({
+      where: { id: booking.priceTierId },
+    });
     if (!tier) return booking.totalMinor;
-    const seats = await this.prisma.bookingSeat.findMany({ where: { bookingId: booking.id, leg: 1 }, select: { passengerCategory: true } });
-    const adultCount = seats.filter(s => s.passengerCategory === 'ADULT').length || 1;
-    const childCount = seats.filter(s => s.passengerCategory === 'CHILD').length;
+    const seats = await this.prisma.bookingSeat.findMany({
+      where: { bookingId: booking.id, leg: 1 },
+      select: { passengerCategory: true },
+    });
+    const adultCount =
+      seats.filter((s) => s.passengerCategory === "ADULT").length || 1;
+    const childCount = seats.filter(
+      (s) => s.passengerCategory === "CHILD",
+    ).length;
     // tier.priceMinor may be in a non-ETB currency — convert to ETB so the result is
     // always in the same units as totalMinor (which is always the ETB canonical).
     const rawFare = tier.priceMinor * 2;
-    const adultFareMinor = tier.currency && (tier.currency as string) !== 'ETB'
-      ? await this.currencyService.convertAmount(rawFare, tier.currency as any, 'ETB' as any)
-      : rawFare;
+    const adultFareMinor =
+      tier.currency && (tier.currency as string) !== "ETB"
+        ? await this.currencyService.convertAmount(
+            rawFare,
+            tier.currency as any,
+            "ETB" as any,
+          )
+        : rawFare;
     const childFareMinor = Math.round(adultFareMinor * 0.1);
     return adultCount * adultFareMinor + childCount * childFareMinor;
   }
@@ -227,6 +296,14 @@ export class PaymentsService {
       );
     }
 
+    // eBirr is a direct wallet debit — the PIN prompt is pushed to this number over USSD. There
+    // is no hosted page that could collect it later, so it must be supplied up front.
+    if (method === PaymentMethodType.EBIRR && !dto.payerAccount?.trim()) {
+      throw new BadRequestException(
+        "payerAccount (mobile wallet number) is required for eBirr",
+      );
+    }
+
     // CBE settles ETB only (docs/cbe/CBE_IMPLEMENTATION_PLAN.md D8). payerAccount is NOT
     // required — CBE identifies the payer at its own channel.
     if (
@@ -260,6 +337,29 @@ export class PaymentsService {
       return this.initiateWalletPayment(booking);
     }
 
+    // Refuse to open a provider session that cannot finish before auto-cancel. Everything below
+    // this point hands the passenger off to an external provider (redirect/HPP/OTP), which takes
+    // minutes; TasksService cancels the booking the first cron tick after its payment deadline.
+    // Opening a session with less than MIN_PAYMENT_WINDOW_MINUTES left produces the worst possible
+    // outcome — the provider captures the money and the booking is already CANCELLED when the
+    // capture lands. WALLET is exempt (returned above): it is an instant internal balance debit.
+    const paymentDeadline = await this.computeBookingPaymentDeadline(
+      booking.id,
+    );
+    const sessionExpiresAt = paymentDeadline
+      ? computePaymentSessionExpiry(paymentDeadline)
+      : undefined;
+    if (paymentDeadline && !canOpenPaymentSession(paymentDeadline)) {
+      const remainingMs = paymentDeadline.getTime() - Date.now();
+      throw new BadRequestException(
+        remainingMs <= 0
+          ? "The payment window for this booking has expired. Please make a new booking."
+          : `Too little time is left to start a payment (${Math.ceil(remainingMs / 60000)} minute(s) ` +
+              `until this booking expires; at least ${MIN_PAYMENT_WINDOW_MINUTES} are required). ` +
+              `Please make a new booking.`,
+      );
+    }
+
     // Free method changes: no reuse/blocking. Every initiate opens a fresh provider session; the
     // single passenger projection row (upserted by bookingId below) tracks the latest session.
     // Confirm-once is enforced when a payment succeeds (finalizePaymentSuccess), not here.
@@ -280,8 +380,12 @@ export class PaymentsService {
         ? "ETB"
         : (paymentMethod?.currency ?? booking.currency).toUpperCase();
 
-    const bookingDisplayCurrency = ((booking as any).displayCurrency ?? 'ETB').toUpperCase();
-    const bookingDisplayTotalMinor = (booking as any).displayTotalMinor as number | null;
+    const bookingDisplayCurrency = (
+      (booking as any).displayCurrency ?? "ETB"
+    ).toUpperCase();
+    const bookingDisplayTotalMinor = (booking as any).displayTotalMinor as
+      | number
+      | null;
 
     let chargeAmount: number;
     if (method === PaymentMethodType.CBE_BILL) {
@@ -292,18 +396,24 @@ export class PaymentsService {
       );
     } else if (
       chargeCurrency === bookingDisplayCurrency &&
-      chargeCurrency !== 'ETB' &&
+      chargeCurrency !== "ETB" &&
       bookingDisplayTotalMinor != null
     ) {
       // Display currency matches charge currency — use the pre-converted amount directly.
-      chargeAmount = this.currencyService.displayMinorToChargeMajor(bookingDisplayTotalMinor, chargeCurrency);
-    } else if (chargeCurrency === 'ETB') {
-      chargeAmount = this.currencyService.displayMinorToChargeMajor(booking.totalMinor, 'ETB');
+      chargeAmount = this.currencyService.displayMinorToChargeMajor(
+        bookingDisplayTotalMinor,
+        chargeCurrency,
+      );
+    } else if (chargeCurrency === "ETB") {
+      chargeAmount = this.currencyService.displayMinorToChargeMajor(
+        booking.totalMinor,
+        "ETB",
+      );
     } else {
       // Booking is in ETB — convert to the provider's settlement currency.
       chargeAmount = await this.currencyService.convertMinorToChargeMajor(
         booking.totalMinor,
-          booking.currency,
+        booking.currency,
         chargeCurrency,
       );
     }
@@ -317,9 +427,7 @@ export class PaymentsService {
       payerName =
         booking.seats.find((s) => s.leg === 1)?.passengerName ??
         booking.seats[0]?.passengerName;
-      expiresAt = (
-        await this.computeBookingPaymentDeadline(booking.id)
-      )?.toISOString();
+      expiresAt = paymentDeadline?.toISOString();
     }
 
     const snapshot = await this.paymentClient.initiate({
@@ -350,7 +458,11 @@ export class PaymentsService {
         where: { id: intent.id },
       });
     }
-    return this.formatIntentResponse(intent);
+    return {
+      ...this.formatIntentResponse(intent),
+      sessionExpiresAt: sessionExpiresAt?.toISOString(),
+      paymentDeadline: paymentDeadline?.toISOString(),
+    };
   }
 
   /**
@@ -369,10 +481,15 @@ export class PaymentsService {
       bookingId,
     );
     if (!snapshot) {
-      throw new NotFoundException("No active payment to confirm for this booking");
+      throw new NotFoundException(
+        "No active payment to confirm for this booking",
+      );
     }
 
-    const confirmed = await this.paymentClient.confirmOtp(snapshot.intentId, otp);
+    const confirmed = await this.paymentClient.confirmOtp(
+      snapshot.intentId,
+      otp,
+    );
     let intent = await this.syncIntentProjection(bookingId, confirmed);
 
     if (confirmed.status === ProviderPaymentStatus.SUCCEEDED) {
@@ -436,13 +553,153 @@ export class PaymentsService {
     if (booking.status !== "PENDING_PAYMENT") {
       return { ...base, stillPayable: false, reason: "NOT_PAYABLE" };
     }
+    // A CBE debit confirmed now lands in seconds, so this doesn't need the full
+    // MIN_PAYMENT_WINDOW_MINUTES that opening a session does — but it must not be confirmed so
+    // close to the deadline that the auto-cancel cron cancels the booking before the capture is
+    // registered. Refusing here is what keeps CBE from debiting a passenger for a dead booking.
     const deadline = await this.computeBookingPaymentDeadline(booking.id);
-    if (deadline && deadline.getTime() < Date.now()) {
+    if (
+      deadline &&
+      deadline.getTime() - PAYMENT_SETTLE_MARGIN_SECONDS * 1000 < Date.now()
+    ) {
       return { ...base, stillPayable: false, reason: "EXPIRED" };
     }
     return { ...base, stillPayable: true, reason: null };
   }
 
+  /**
+   * Bill-query for an excess baggage charge — the same live "still payable?" hop as bookings,
+   * against `ExcessBaggageCharge` instead. This is the double-payment guard for baggage bills:
+   * once the charge is paid, waived or lapsed, CBE is told to refuse the debit.
+   *
+   * The charge's own `expiresAt` is the deadline (extended to the CBE bill window when the bill
+   * was issued), so there is no separate schedule-derived deadline to compute as there is for a
+   * booking.
+   */
+  async billQueryExcessBaggage(
+    chargeId: string,
+  ): Promise<BillQueryResponseDto> {
+    const charge = await this.prisma.excessBaggageCharge.findUnique({
+      where: { id: chargeId },
+      include: {
+        booking: {
+          include: { seats: true, passenger: { include: { user: true } } },
+        },
+      },
+    });
+    // A bill reference we issued whose charge has since been deleted — a data problem, not a
+    // customer-facing cancellation.
+    if (!charge) return { stillPayable: false, reason: "NOT_FOUND" };
+
+    const base = {
+      payerName:
+        charge.booking?.seats?.find((s) => s.leg === 1)?.passengerName ??
+        charge.booking?.seats?.[0]?.passengerName ??
+        charge.booking?.passenger?.user?.fullName ??
+        null,
+      // The charge is always booked in ETB and CBE settles ETB only, so no conversion applies.
+      currentAmountMinor: this.currencyService.displayMinorToChargeMajor(
+        charge.totalMinor,
+        "ETB",
+      ),
+      currency: "ETB",
+      // Rendered beside the amount on CBE's confirmation screen. The weight and booking ref are
+      // both on the agent's slip, so the payer can match the two before confirming.
+      paymentReason: `Excess baggage ${charge.excessWeightKg}kg — booking ${
+        charge.booking?.bookingRef ?? ""
+      }`.trim(),
+    };
+
+    // Paid first: a charge settled by any method (including cash at the counter) must be reported
+    // as already paid, never as merely "not payable".
+    if (charge.status === "PAID" || charge.status === "CASH_COLLECTED") {
+      return { ...base, stillPayable: false, reason: "ALREADY_PAID" };
+    }
+    // A supervisor wrote the charge off; from the payer's side the debt is gone.
+    if (charge.status === "WAIVED") {
+      return { ...base, stillPayable: false, reason: "CANCELLED" };
+    }
+    // Confirmed CBE debits land in seconds, but must not be accepted so close to the deadline
+    // that the sweep expires the intent before the capture is registered.
+    if (
+      charge.status === "EXPIRED" ||
+      charge.expiresAt.getTime() - PAYMENT_SETTLE_MARGIN_SECONDS * 1000 <
+        Date.now()
+    ) {
+      return { ...base, stillPayable: false, reason: "EXPIRED" };
+    }
+    if (charge.status !== "PENDING") {
+      return { ...base, stillPayable: false, reason: "NOT_PAYABLE" };
+    }
+    return { ...base, stillPayable: true, reason: null };
+  }
+
+  /**
+   * Bill-query for a supplementary charge — the same live "still payable?" hop as bookings,
+   * against `SupplementaryCharge`. This is the double-payment guard for balance bills: once the
+   * charge is paid, waived or lapsed, CBE is told to refuse the debit.
+   *
+   * The charge's own 72-hour `expiresAt` is the deadline. It is nullable — a charge raised with
+   * no expiry is an open-ended debt and stays payable indefinitely, which is the intended reading
+   * of a null here rather than an immediate refusal.
+   */
+  async billQuerySupplementaryCharge(
+    chargeId: string,
+  ): Promise<BillQueryResponseDto> {
+    const charge = await this.prisma.supplementaryCharge.findUnique({
+      where: { id: chargeId },
+      include: {
+        booking: {
+          include: { seats: true, passenger: { include: { user: true } } },
+        },
+      },
+    });
+    // A bill reference we issued whose charge has since been deleted — a data problem, not a
+    // customer-facing cancellation.
+    if (!charge) return { stillPayable: false, reason: "NOT_FOUND" };
+
+    const base = {
+      payerName:
+        charge.booking?.seats?.find((s) => s.leg === 1)?.passengerName ??
+        charge.booking?.seats?.[0]?.passengerName ??
+        charge.booking?.passenger?.user?.fullName ??
+        null,
+      // The charge is raised in ETB and CBE settles ETB only, so no conversion applies.
+      currentAmountMinor: this.currencyService.displayMinorToChargeMajor(
+        charge.amountMinor,
+        "ETB",
+      ),
+      currency: "ETB",
+      // Rendered beside the amount on CBE's confirmation screen. The booking ref is on the
+      // passenger's ticket, so they can match the two before confirming.
+      paymentReason: `Outstanding balance — booking ${
+        charge.booking?.bookingRef ?? ""
+      }`.trim(),
+    };
+
+    if (charge.status === "PAID") {
+      return { ...base, stillPayable: false, reason: "ALREADY_PAID" };
+    }
+    // Staff wrote the balance off; from the payer's side the debt is gone.
+    if (charge.status === "WAIVED") {
+      return { ...base, stillPayable: false, reason: "CANCELLED" };
+    }
+    // Confirmed CBE debits land in seconds, but must not be accepted so close to the deadline
+    // that the sweep expires the intent before the capture is registered.
+    if (
+      charge.status === "EXPIRED" ||
+      (charge.expiresAt &&
+        charge.expiresAt.getTime() - PAYMENT_SETTLE_MARGIN_SECONDS * 1000 <
+          Date.now())
+    ) {
+      return { ...base, stillPayable: false, reason: "EXPIRED" };
+    }
+    if (charge.status !== "PENDING") {
+      return { ...base, stillPayable: false, reason: "NOT_PAYABLE" };
+    }
+    return { ...base, stillPayable: true, reason: null };
+  }
+
   /**
    * The booking's payment deadline, resolved exactly like the auto-cancel job: the booking's
    * origin-segment time and that stop's own check-in window, falling back to the route default.
@@ -517,9 +774,8 @@ export class PaymentsService {
       [PaymentMethodType.CBE_BIRR]: {
         returnUrl: process.env.CBE_RETURN_URL,
       },
-      [PaymentMethodType.EBIRR]: {
-        returnUrl: process.env.EBIRR_RETURN_URL,
-      },
+      // No EBIRR entry: the payer never leaves the page — eBirr pushes a PIN prompt to their
+      // handset — so there is no browser bounce-back to configure.
       [PaymentMethodType.CARD]: {
         returnUrl: process.env.CARD_RETURN_URL,
       },
@@ -580,12 +836,13 @@ export class PaymentsService {
     bookingId: string,
     snapshot: PaymentIntentSnapshot,
   ) {
+    // Writing SUCCEEDED is finalizePaymentSuccess's job alone — it is the only place that can
+    // enforce confirm-once atomically — so a SUCCEEDED snapshot syncs as PROCESSING here.
     const status =
       snapshot.status === ProviderPaymentStatus.SUCCEEDED
         ? PaymentIntentStatus.PROCESSING
         : (snapshot.status as unknown as PaymentIntentStatus);
     const data = {
-      status,
       method: snapshot.provider as unknown as PaymentMethodType,
       merchantOrderId: snapshot.merchantOrderId,
       clientAction: snapshot.clientAction
@@ -596,10 +853,11 @@ export class PaymentsService {
       failureCode: snapshot.failureCode ?? null,
       failureMessage: snapshot.failureMessage ?? null,
       rawInitiation: (snapshot as any).providerResponse
-        ? ((snapshot as any).providerResponse as unknown as Prisma.InputJsonValue)
+        ? ((snapshot as any)
+            .providerResponse as unknown as Prisma.InputJsonValue)
         : Prisma.DbNull,
     };
-    return this.prisma.paymentIntent.upsert({
+    await this.prisma.paymentIntent.upsert({
       where: { bookingId },
       // amountMinor/currency are refreshed on update too: a cross-currency method switch
       // (e.g. Waafi/USD → Telebirr/ETB) re-initiates over the same row, and the projection
@@ -613,9 +871,17 @@ export class PaymentsService {
         bookingId,
         amountMinor: snapshot.amountMinor,
         currency: snapshot.currency,
+        status,
         ...data,
       },
     });
+
+    await this.prisma.paymentIntent.updateMany({
+      where: { bookingId, status: { not: PaymentIntentStatus.SUCCEEDED } },
+      data: { status },
+    });
+
+    return this.prisma.paymentIntent.findUniqueOrThrow({ where: { bookingId } });
   }
 
   private async initiateWalletPayment(
@@ -694,6 +960,11 @@ export class PaymentsService {
       status: intent.status,
       clientAction,
       merchantOrderId: intent.merchantOrderId ?? undefined,
+      // eBirr settles inside initiate (its purchase response is the settlement), so a FAILED
+      // verdict arrives here rather than through a later status poll. Without these the portal
+      // can only show a generic "please try again" instead of the actual cause.
+      failureCode: intent.failureCode ?? undefined,
+      failureMessage: intent.failureMessage ?? undefined,
     };
   }
 
@@ -747,7 +1018,6 @@ export class PaymentsService {
       where: { bookingId },
     });
 
-
     if (local?.status === PaymentIntentStatus.SUCCEEDED) {
       const booking = await this.prisma.booking.findUnique({
         where: { id: bookingId },
@@ -839,11 +1109,27 @@ export class PaymentsService {
         data: { status: "CANCELLED" },
       });
     }
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Payment', entityId: intent.id, newData: { status: 'REFUNDED', bookingId: dto.bookingId } });
+    // The intent is moved to CANCELLED, not "REFUNDED" — recording the latter made the audit
+    // row contradict the row it describes.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.REFUND,
+      entityType: AUDIT_ENTITIES.Payment,
+      entityId: intent.id,
+      oldData: { status: intent.status, bookingStatus: booking?.status },
+      newData: {
+        status: "CANCELLED",
+        bookingId: dto.bookingId,
+        bookingRef: booking?.bookingRef,
+        bookingStatus: booking ? "CANCELLED" : undefined,
+        amountMinor: intent.amountMinor,
+        currency: intent.currency,
+        reason: dto.reason,
+      },
+    });
     return { refunded: true, bookingRef: booking?.bookingRef };
   }
 
-  addPaymentMethod(dto: AddPaymentMethodDto) {
+  async addPaymentMethod(dto: AddPaymentMethodDto) {
     const data = {
       type: dto.type as unknown as PaymentMethodType,
       displayName: dto.displayName,
@@ -853,29 +1139,68 @@ export class PaymentsService {
       enabled: dto.enabled ?? true,
       sortOrder: dto.sortOrder ?? 0,
     };
-    return this.prisma.paymentMethod.upsert({
+
+    // This is an upsert keyed on `type`, so "add" silently overwrites an existing method. The
+    // audit row reports which of the two actually happened rather than always claiming a create.
+    const existing = await this.prisma.paymentMethod.findUnique({
+      where: { type: data.type },
+    });
+
+    const method = await this.prisma.paymentMethod.upsert({
       where: { type: data.type },
       update: data,
       create: data,
     });
+
+    await this.auditService.log({
+      action: existing ? AUDIT_ACTIONS.UPDATE : AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.PaymentMethod,
+      entityId: method.id,
+      oldData: existing ? this.paymentMethodSnapshot(existing) : undefined,
+      newData: this.paymentMethodSnapshot(method),
+    });
+
+    return method;
+  }
+
+  private paymentMethodSnapshot(method: Record<string, unknown>) {
+    return Object.fromEntries(
+      PAYMENT_METHOD_AUDIT_FIELDS.filter((k) => method[k] !== undefined).map((k) => [
+        k,
+        method[k],
+      ]),
+    );
   }
 
   async updatePaymentMethod(id: string, dto: Partial<AddPaymentMethodDto>) {
-    const existing = await this.prisma.paymentMethod.findUnique({ where: { id } });
-    if (!existing) throw new NotFoundException('Payment method not found');
-    
+    const existing = await this.prisma.paymentMethod.findUnique({
+      where: { id },
+    });
+    if (!existing) throw new NotFoundException("Payment method not found");
+
     const updateData: any = {};
     if (dto.displayName !== undefined) updateData.displayName = dto.displayName;
-    if (dto.region !== undefined) updateData.region = dto.region as unknown as PaymentRegion;
+    if (dto.region !== undefined)
+      updateData.region = dto.region as unknown as PaymentRegion;
     if (dto.currency !== undefined) updateData.currency = dto.currency;
     if (dto.providerId !== undefined) updateData.providerId = dto.providerId;
     if (dto.enabled !== undefined) updateData.enabled = dto.enabled;
     if (dto.sortOrder !== undefined) updateData.sortOrder = dto.sortOrder;
-    
-    return this.prisma.paymentMethod.update({
+
+    const updated = await this.prisma.paymentMethod.update({
       where: { id },
       data: updateData,
     });
+
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.PaymentMethod,
+      entityId: id,
+      oldData: this.paymentMethodSnapshot(existing),
+      newData: this.paymentMethodSnapshot(updated),
+    });
+
+    return updated;
   }
 
   getSupportedPaymentMethods(region?: PaymentRegionEnum) {
@@ -913,24 +1238,31 @@ export class PaymentsService {
         displayTotalMinor: true,
       },
     });
-    if (!booking) throw new NotFoundException('Booking not found');
+    if (!booking) throw new NotFoundException("Booking not found");
 
     const correctTotalMinor = await this.resolveBookingTotal(booking as any);
     const requestedCurrency = currency.toUpperCase();
 
     // Source of truth: displayTotalMinor in displayCurrency when available,
     // otherwise totalMinor in ETB (bookings with no display currency override).
-    const sourceCurrency = (booking.displayCurrency ?? 'ETB').toUpperCase();
+    const sourceCurrency = (booking.displayCurrency ?? "ETB").toUpperCase();
     const sourceMinor = booking.displayTotalMinor ?? correctTotalMinor;
 
     // Same currency — return directly, no conversion needed.
     if (requestedCurrency === sourceCurrency) {
-      return { booking_id: bookingId, currency: requestedCurrency, amount: sourceMinor / 100 };
+      return {
+        booking_id: bookingId,
+        currency: requestedCurrency,
+        amount: sourceMinor / 100,
+      };
     }
 
     const exchangeRate = await this.prisma.currencyExchangeRate.findFirst({
-      where: { fromCurrency: sourceCurrency as any, toCurrency: requestedCurrency as any },
-      orderBy: { effectiveDate: 'desc' },
+      where: {
+        fromCurrency: sourceCurrency as any,
+        toCurrency: requestedCurrency as any,
+      },
+      orderBy: { effectiveDate: "desc" },
     });
 
     let rate: number;
@@ -939,18 +1271,28 @@ export class PaymentsService {
     } else {
       // Try inverse rate
       const inverseRate = await this.prisma.currencyExchangeRate.findFirst({
-        where: { fromCurrency: requestedCurrency as any, toCurrency: sourceCurrency as any },
-        orderBy: { effectiveDate: 'desc' },
+        where: {
+          fromCurrency: requestedCurrency as any,
+          toCurrency: sourceCurrency as any,
+        },
+        orderBy: { effectiveDate: "desc" },
       });
       if (inverseRate) {
         rate = 1 / Number(inverseRate.rate);
       } else {
         // Bridge via ETB (e.g. DJF→USD = (DJF→ETB) × (ETB→USD))
-        rate = await this.currencyService.getRateOrThrow(sourceCurrency as any, requestedCurrency as any);
+        rate = await this.currencyService.getRateOrThrow(
+          sourceCurrency as any,
+          requestedCurrency as any,
+        );
       }
     }
     const converted = (sourceMinor / 100) * rate;
-    return { booking_id: bookingId, currency: requestedCurrency, amount: converted };
+    return {
+      booking_id: bookingId,
+      currency: requestedCurrency,
+      amount: converted,
+    };
   }
 
   /**
@@ -989,20 +1331,36 @@ export class PaymentsService {
    * - not paid   → verified unpaid; a cancellation caller may proceed.
    * - unverifiable (provider query errored, in-flight, or payment service unreachable) → a
    *                cancellation caller must NOT cancel this cycle; defer and retry later.
+   *
+   * When unverifiable, `reason` says WHY, and the two are not interchangeable: `IN_FLIGHT` is a
+   * payment actually moving (defer forever — this is the case the guard exists for), while
+   * `PROVIDER_ERROR` may be a gateway that never comes back, which a sweep is allowed to give up
+   * on after a grace window rather than retry once a minute in perpetuity.
    */
-  async reconcileAndConfirmIfPaid(
-    bookingId: string,
-  ): Promise<{ paid: boolean; verified: boolean }> {
+  async reconcileAndConfirmIfPaid(bookingId: string): Promise<{
+    paid: boolean;
+    verified: boolean;
+    reason?: SettlementUnverifiableReason;
+  }> {
+    const current = await this.prisma.booking.findUnique({
+      where: { id: bookingId },
+      select: { status: true },
+    });
+    if (current?.status === "CONFIRMED") {
+      return { paid: true, verified: true };
+    }
+
     const settlement = await this.paymentClient.reconcileByReference(
       PaymentReferenceType.BOOKING,
       bookingId,
     );
 
     if (settlement.unverifiable) {
+      const reason = settlement.reason ?? "PROVIDER_ERROR";
       this.logger.warn(
-        `reconcile-before-cancel: settlement UNVERIFIABLE for booking ${bookingId} — not cancelling`,
+        `reconcile-before-cancel: settlement UNVERIFIABLE (${reason}) for booking ${bookingId} — not cancelling`,
       );
-      return { paid: false, verified: false };
+      return { paid: false, verified: false, reason };
     }
 
     if (settlement.paid) {
@@ -1064,7 +1422,9 @@ export class PaymentsService {
         select: { status: true },
       });
       if (idempotencyBooking?.status === "CONFIRMED") {
-        const ticketCount = await this.prisma.ticket.count({ where: { bookingId: intent.bookingId } });
+        const ticketCount = await this.prisma.ticket.count({
+          where: { bookingId: intent.bookingId },
+        });
         if (ticketCount === 0) {
           try {
             await this.ticketsService.generate(intent.bookingId);
@@ -1074,7 +1434,9 @@ export class PaymentsService {
               `Ticket generation failed on idempotency retry for booking ${intent.bookingId}: ${msg}. Attempting smart seat reassignment.`,
             );
             try {
-              await this.ticketsService.smartAssignAndGenerate(intent.bookingId);
+              await this.ticketsService.smartAssignAndGenerate(
+                intent.bookingId,
+              );
             } catch (retryErr) {
               this.logger.error(
                 `Error generating ticket on idempotency retry for booking ${intent.bookingId}: ${retryErr instanceof Error ? retryErr.message : String(retryErr)}`,
@@ -1125,12 +1487,31 @@ export class PaymentsService {
     });
 
     if (confirmed === 0) {
-      // Booking already confirmed by another payment (or not payable and not forced). This capture
-      // is registered on the payment-api ledger; do not confirm, ticket, or touch this row.
-      this.logger.error(
-        `Capture on non-payable booking ${booking.id} (status=${booking.status}), intent ${intent.id} ` +
-          `txn=${input.providerTxnId ?? intent.providerTxnId ?? "n/a"} — registered in payment-api; not confirming`,
-      );
+      const recordsConfirmingCapture =
+        booking.status === "CONFIRMED" && intent.paidAt != null;
+      if (recordsConfirmingCapture) {
+        const { count } = await this.prisma.paymentIntent.updateMany({
+          where: { id: intent.id, status: { not: PaymentIntentStatus.SUCCEEDED } },
+          data: { status: PaymentIntentStatus.SUCCEEDED },
+        });
+        if (count > 0) {
+          this.logger.warn(
+            `Restored demoted payment projection for booking ${booking.id} ` +
+              `(intent ${intent.id}): ${intent.status} → SUCCEEDED`,
+          );
+        }
+      }
+
+      const duplicateCapture =
+        input.providerTxnId != null &&
+        intent.providerTxnId != null &&
+        input.providerTxnId !== intent.providerTxnId;
+      if (duplicateCapture || !recordsConfirmingCapture) {
+        this.logger.error(
+          `Capture on non-payable booking ${booking.id} (status=${booking.status}), intent ${intent.id} ` +
+            `txn=${input.providerTxnId ?? intent.providerTxnId ?? "n/a"} — registered in payment-api; not confirming`,
+        );
+      }
       return { alreadyFinalized: true };
     }
 
@@ -1170,7 +1551,9 @@ export class PaymentsService {
           );
         }
       } else {
-        this.logger.error(`Error generating ticket for booking ${booking.id}: ${msg}`);
+        this.logger.error(
+          `Error generating ticket for booking ${booking.id}: ${msg}`,
+        );
       }
     }
 
@@ -1190,22 +1573,132 @@ export class PaymentsService {
     return { alreadyFinalized: false };
   }
 
-  private async handleSupplementaryChargeEvent(event: PaymentEventDto): Promise<MarkPaidResponseDto> {
-    if (event.eventType === 'payment.failed') {
-      this.logger.warn(`supplementary charge ${event.referenceId} payment failed`);
+  private async handleSupplementaryChargeEvent(
+    event: PaymentEventDto,
+  ): Promise<MarkPaidResponseDto> {
+    if (event.eventType === "payment.failed") {
+      this.logger.warn(
+        `supplementary charge ${event.referenceId} payment failed`,
+      );
       return { processed: true };
     }
-    const charge = await this.prisma.supplementaryCharge.findUnique({ where: { id: event.referenceId } });
-    if (!charge) {
-      this.logger.error(`mark-paid: no supplementary charge for reference ${event.referenceId}`);
-      return { processed: false, reason: 'charge-not-found' };
-    }
-    if (charge.status === 'PAID') return { processed: true, alreadyFinalized: true };
-    await this.prisma.supplementaryCharge.update({
-      where: { id: charge.id },
-      data: { status: 'PAID', paidAt: new Date(), providerTxnId: event.providerTxnId ?? null },
+    const charge = await this.prisma.supplementaryCharge.findUnique({
+      where: { id: event.referenceId },
     });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'SupplementaryCharge', entityId: charge.id, newData: { status: 'PAID', providerTxnId: event.providerTxnId } });
+    if (!charge) {
+      this.logger.error(
+        `mark-paid: no supplementary charge for reference ${event.referenceId}`,
+      );
+      return { processed: false, reason: "charge-not-found" };
+    }
+    if (charge.status === "PAID")
+      return { processed: true, alreadyFinalized: true };
+    // Conditional claim, not a plain update: SupplementaryChargesService.markPaid can be
+    // driving the same transition from the in-app path. Whichever caller flips the row writes
+    // the audit event; the loser writes nothing, so the trail holds exactly one PAID row.
+    const { count } = await this.prisma.supplementaryCharge.updateMany({
+      where: { id: charge.id, status: { not: "PAID" } },
+      data: {
+        status: "PAID",
+        paidAt: new Date(),
+        providerTxnId: event.providerTxnId ?? null,
+      },
+    });
+
+    if (count === 1) {
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.PAY,
+        entityType: AUDIT_ENTITIES.SupplementaryCharge,
+        entityId: charge.id,
+        oldData: { status: charge.status },
+        newData: {
+          status: "PAID",
+          bookingId: charge.bookingId,
+          providerTxnId: event.providerTxnId,
+          settledAmount: event.amountMinor,
+          settledCurrency: event.currency,
+        },
+      });
+    }
+    return { processed: true, alreadyFinalized: count === 0 };
+  }
+
+  /**
+   * Settlement for an excess baggage charge paid through the passenger portal link.
+   *
+   * Deliberately has NO short-payment amount guard, unlike the booking path: the charge is stored
+   * in ETB while `event.amountMinor` arrives in the provider's settlement currency (DJF for
+   * Waafi/D-Money/CAC, USD for card), so comparing the two directly would reject every legitimate
+   * cross-currency payment. The amount actually charged was computed server-side at initiate.
+   *
+   * An EXPIRED charge is still marked PAID. The link TTL only governs whether a NEW payment may be
+   * started; once a provider has captured the money the charge is paid, and leaving it EXPIRED
+   * would hide a real settlement from the agent who has to reconcile it.
+   */
+  private async handleExcessBaggageChargeEvent(
+    event: PaymentEventDto,
+  ): Promise<MarkPaidResponseDto> {
+    if (event.eventType === "payment.failed") {
+      this.logger.warn(
+        `excess baggage charge ${event.referenceId} payment failed`,
+      );
+      return { processed: true };
+    }
+
+    const charge = await this.prisma.excessBaggageCharge.findUnique({
+      where: { id: event.referenceId },
+    });
+    if (!charge) {
+      // Ack — a missing charge will not appear on redelivery; needs investigation.
+      this.logger.error(
+        `mark-paid: no excess baggage charge for reference ${event.referenceId}`,
+      );
+      return { processed: false, reason: "charge-not-found" };
+    }
+    if (charge.status === "PAID" || charge.status === "CASH_COLLECTED") {
+      return { processed: true, alreadyFinalized: true };
+    }
+    // Money arrived against a charge nobody expected to be paid — record it as PAID (that is the
+    // truth) but say so loudly: a waived charge that settles anyway needs a refund decision.
+    if (charge.status !== "PENDING") {
+      this.logger.warn(
+        `mark-paid: excess baggage charge ${charge.id} settled while ${charge.status} ` +
+          `(${event.amountMinor} ${event.currency}) — marking PAID; needs review`,
+      );
+    }
+
+    // Conditional claim for the same reason as the supplementary handler above:
+    // ExcessBaggageService.markPaid drives this transition from the in-app path.
+    const { count } = await this.prisma.excessBaggageCharge.updateMany({
+      where: { id: charge.id, status: { notIn: ["PAID", "CASH_COLLECTED"] } },
+      data: {
+        status: "PAID",
+        // The provider's own capture time, not when this event happened to be processed — a
+        // replayed or dead-lettered event must not backdate the money to the wrong minute.
+        paidAt: event.paidAt ? new Date(event.paidAt) : new Date(),
+      },
+    });
+
+    if (count === 0) {
+      return { processed: true, alreadyFinalized: true };
+    }
+
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.PAY,
+      entityType: AUDIT_ENTITIES.ExcessBaggageCharge,
+      entityId: charge.id,
+      oldData: { status: charge.status },
+      newData: {
+        status: "PAID",
+        bookingId: charge.bookingId,
+        providerTxnId: event.providerTxnId,
+        settledAmount: event.amountMinor,
+        settledCurrency: event.currency,
+      },
+    });
+    this.logger.log(
+      `excess baggage charge ${charge.id} marked PAID (${event.amountMinor} ${event.currency}, txn ${event.providerTxnId ?? "n/a"})`,
+    );
     return { processed: true };
   }
 
@@ -1223,6 +1716,10 @@ export class PaymentsService {
       return this.handleSupplementaryChargeEvent(event);
     }
 
+    if (event.referenceType === PaymentReferenceType.EXCESS_BAGGAGE) {
+      return this.handleExcessBaggageChargeEvent(event);
+    }
+
     if (event.referenceType !== PaymentReferenceType.BOOKING) {
       this.logger.warn(
         `mark-paid: ignoring unknown referenceType ${event.referenceType}`,
@@ -1267,7 +1764,8 @@ export class PaymentsService {
     // normalize before comparing; a short payment must NOT confirm the booking. Amount-only —
     // the display↔charge currency divergence is tracked separately under the USD/DJF
     // findings. The 1% tolerance absorbs rounding.
-    const expectedMajor = (booking.displayTotalMinor ?? booking.totalMinor) / 100;
+    const expectedMajor =
+      (booking.displayTotalMinor ?? booking.totalMinor) / 100;
     const shortPayTolerance = Math.max(0.01, expectedMajor * 0.01);
     if (event.amountMinor < expectedMajor - shortPayTolerance) {
       this.logger.error(
@@ -1361,15 +1859,25 @@ export class PaymentsService {
     return { processed: true, alreadyFinalized };
   }
 
-  async forceConfirmPayment(bookingId: string, dto: ForceConfirmDto = {}): Promise<{ alreadyFinalized: boolean }> {
-    const booking = await this.prisma.booking.findUnique({ where: { id: bookingId } });
-    if (!booking) throw new NotFoundException('Booking not found');
+  async forceConfirmPayment(
+    bookingId: string,
+    dto: ForceConfirmDto = {},
+  ): Promise<{ alreadyFinalized: boolean }> {
+    const booking = await this.prisma.booking.findUnique({
+      where: { id: bookingId },
+    });
+    if (!booking) throw new NotFoundException("Booking not found");
 
     const resolvedMethod = dto.paymentMethod
       ? (dto.paymentMethod as unknown as PaymentMethodType)
       : PaymentMethodType.TELEBIRR;
 
-    let intent = await this.prisma.paymentIntent.findUnique({ where: { bookingId } });
+    let intent = await this.prisma.paymentIntent.findUnique({
+      where: { bookingId },
+    });
+    // Captured before the block below rewrites it, so the audit row can show what the override
+    // moved the payment away from.
+    const previousStatus = intent?.status ?? null;
     if (!intent) {
       intent = await this.prisma.paymentIntent.create({
         data: {
@@ -1389,7 +1897,10 @@ export class PaymentsService {
       if (dto.paymentReference) updateData.providerTxnId = dto.paymentReference;
       if (dto.paymentMethod) updateData.method = resolvedMethod;
       if (dto.notes) updateData.failureMessage = dto.notes;
-      if (intent.status === PaymentIntentStatus.CANCELLED || intent.status === PaymentIntentStatus.FAILED) {
+      if (
+        intent.status === PaymentIntentStatus.CANCELLED ||
+        intent.status === PaymentIntentStatus.FAILED
+      ) {
         updateData.status = PaymentIntentStatus.PROCESSING;
       }
       if (Object.keys(updateData).length) {
@@ -1405,7 +1916,23 @@ export class PaymentsService {
       providerTxnId: dto.paymentReference ?? intent.providerTxnId ?? undefined,
       force: true,
     }).then(async (result) => {
-      await this.auditService.log({ action: 'UPDATE', entityType: 'Payment', entityId: intent.id, newData: { status: 'FORCE_CONFIRMED', bookingId, paymentMethod: dto.paymentMethod, paymentReference: dto.paymentReference } });
+      // finalizePaymentSuccess reports `alreadyFinalized` when the booking was already
+      // confirmed — logging a forced confirmation there would record an override that changed
+      // nothing.
+      if (!result?.alreadyFinalized) {
+        await this.auditService.log({
+          action: AUDIT_ACTIONS.STATUS_CHANGE,
+          entityType: AUDIT_ENTITIES.Payment,
+          entityId: intent.id,
+          oldData: { status: previousStatus },
+          newData: {
+            status: "FORCE_CONFIRMED",
+            bookingId,
+            paymentMethod: dto.paymentMethod,
+            paymentReference: dto.paymentReference,
+          },
+        });
+      }
       return result;
     });
   }
@@ -1476,78 +2003,106 @@ export class PaymentsService {
 
     // Build per-leg definitions: { scheduleId, originStationId, destinationStationId, seatIds[] }
     // BookingSeat.leg:  1=outbound/leg-1, 2=return/leg-2, 3=return leg-1 (transit), 4=return leg-2
-    type LegDef = { scheduleId: string; originStationId: string; destinationStationId: string; seatIds: string[] };
+    type LegDef = {
+      scheduleId: string;
+      originStationId: string;
+      destinationStationId: string;
+      seatIds: string[];
+    };
     const legDefs: LegDef[] = [];
 
     const seatsForLeg = (legNum: number) =>
-      booking.seats.filter((s: any) => s.leg === legNum).map((s: any) => s.seatId);
+      booking.seats
+        .filter((s: any) => s.leg === legNum)
+        .map((s: any) => s.seatId);
 
-    if (booking.bookingType === 'ONE_WAY') {
+    if (booking.bookingType === "ONE_WAY") {
       legDefs.push({
-        scheduleId:          booking.scheduleId,
-        originStationId:     b.originStationId,
+        scheduleId: booking.scheduleId,
+        originStationId: b.originStationId,
         destinationStationId: b.destinationStationId,
-        seatIds:             booking.seats.map((s: any) => s.seatId),
+        seatIds: booking.seats.map((s: any) => s.seatId),
       });
-    } else if (booking.bookingType === 'ROUND_TRIP') {
+    } else if (booking.bookingType === "ROUND_TRIP") {
       legDefs.push({
-        scheduleId:          booking.scheduleId,
-        originStationId:     b.originStationId,
+        scheduleId: booking.scheduleId,
+        originStationId: b.originStationId,
         destinationStationId: b.destinationStationId,
-        seatIds:             seatsForLeg(1),
+        seatIds: seatsForLeg(1),
       });
-      if (b.returnScheduleId && b.returnOriginStationId && b.returnDestinationStationId) {
+      if (
+        b.returnScheduleId &&
+        b.returnOriginStationId &&
+        b.returnDestinationStationId
+      ) {
         legDefs.push({
-          scheduleId:          b.returnScheduleId,
-          originStationId:     b.returnOriginStationId,
+          scheduleId: b.returnScheduleId,
+          originStationId: b.returnOriginStationId,
           destinationStationId: b.returnDestinationStationId,
-          seatIds:             seatsForLeg(2),
+          seatIds: seatsForLeg(2),
         });
       }
-    } else if (booking.bookingType === 'TRANSIT') {
+    } else if (booking.bookingType === "TRANSIT") {
       legDefs.push({
-        scheduleId:          booking.scheduleId,
-        originStationId:     b.originStationId,
+        scheduleId: booking.scheduleId,
+        originStationId: b.originStationId,
         destinationStationId: b.leg2OriginStationId, // transit station
-        seatIds:             seatsForLeg(1),
+        seatIds: seatsForLeg(1),
       });
-      if (b.leg2ScheduleId && b.leg2OriginStationId && b.leg2DestinationStationId) {
+      if (
+        b.leg2ScheduleId &&
+        b.leg2OriginStationId &&
+        b.leg2DestinationStationId
+      ) {
         legDefs.push({
-          scheduleId:          b.leg2ScheduleId,
-          originStationId:     b.leg2OriginStationId,
+          scheduleId: b.leg2ScheduleId,
+          originStationId: b.leg2OriginStationId,
           destinationStationId: b.leg2DestinationStationId,
-          seatIds:             seatsForLeg(2),
+          seatIds: seatsForLeg(2),
         });
       }
-    } else if (booking.bookingType === 'ROUND_TRIP_TRANSIT') {
+    } else if (booking.bookingType === "ROUND_TRIP_TRANSIT") {
       legDefs.push({
-        scheduleId:          booking.scheduleId,
-        originStationId:     b.originStationId,
+        scheduleId: booking.scheduleId,
+        originStationId: b.originStationId,
         destinationStationId: b.leg2OriginStationId,
-        seatIds:             seatsForLeg(1),
+        seatIds: seatsForLeg(1),
       });
-      if (b.leg2ScheduleId && b.leg2OriginStationId && b.leg2DestinationStationId) {
+      if (
+        b.leg2ScheduleId &&
+        b.leg2OriginStationId &&
+        b.leg2DestinationStationId
+      ) {
         legDefs.push({
-          scheduleId:          b.leg2ScheduleId,
-          originStationId:     b.leg2OriginStationId,
+          scheduleId: b.leg2ScheduleId,
+          originStationId: b.leg2OriginStationId,
           destinationStationId: b.leg2DestinationStationId,
-          seatIds:             seatsForLeg(2),
+          seatIds: seatsForLeg(2),
         });
       }
-      if (b.returnScheduleId && b.returnOriginStationId && b.returnDestinationStationId) {
+      if (
+        b.returnScheduleId &&
+        b.returnOriginStationId &&
+        b.returnDestinationStationId
+      ) {
         legDefs.push({
-          scheduleId:          b.returnScheduleId,
-          originStationId:     b.returnOriginStationId,
-          destinationStationId: b.returnLeg2OriginStationId ?? b.returnDestinationStationId,
-          seatIds:             seatsForLeg(3),
+          scheduleId: b.returnScheduleId,
+          originStationId: b.returnOriginStationId,
+          destinationStationId:
+            b.returnLeg2OriginStationId ?? b.returnDestinationStationId,
+          seatIds: seatsForLeg(3),
         });
       }
-      if (b.returnLeg2ScheduleId && b.returnLeg2OriginStationId && b.returnLeg2DestStationId) {
+      if (
+        b.returnLeg2ScheduleId &&
+        b.returnLeg2OriginStationId &&
+        b.returnLeg2DestStationId
+      ) {
         legDefs.push({
-          scheduleId:          b.returnLeg2ScheduleId,
-          originStationId:     b.returnLeg2OriginStationId,
+          scheduleId: b.returnLeg2ScheduleId,
+          originStationId: b.returnLeg2OriginStationId,
           destinationStationId: b.returnLeg2DestStationId,
-          seatIds:             seatsForLeg(4),
+          seatIds: seatsForLeg(4),
         });
       }
     }
@@ -1557,10 +2112,10 @@ export class PaymentsService {
     const journey = await this.prisma.journey.create({
       data: {
         passengerId: booking.passengerId,
-        bookingId:   booking.id,
-        status:      'CONFIRMED',
-        totalMinor:  booking.totalMinor,
-        currency:    booking.currency,
+        bookingId: booking.id,
+        status: "CONFIRMED",
+        totalMinor: booking.totalMinor,
+        currency: booking.currency,
       } as any,
     });
 
@@ -1572,23 +2127,27 @@ export class PaymentsService {
 
       const stopTimes = await this.prisma.tripStopTime.findMany({
         where: { scheduleId: leg.scheduleId },
-        orderBy: { sequence: 'asc' },
+        orderBy: { sequence: "asc" },
         select: { stationId: true, sequence: true },
       });
 
-      const originIdx = stopTimes.findIndex(st => st.stationId === leg.originStationId);
-      const destIdx   = stopTimes.findIndex(st => st.stationId === leg.destinationStationId);
+      const originIdx = stopTimes.findIndex(
+        (st) => st.stationId === leg.originStationId,
+      );
+      const destIdx = stopTimes.findIndex(
+        (st) => st.stationId === leg.destinationStationId,
+      );
       if (originIdx < 0 || destIdx < 0 || originIdx >= destIdx) continue;
 
       for (const seatId of leg.seatIds) {
         for (let i = originIdx; i < destIdx; i++) {
           journeySegments.push({
-            journeyId:          journey.id,
-            scheduleId:         leg.scheduleId,
-            segmentOrder:       segmentOrder++,
+            journeyId: journey.id,
+            scheduleId: leg.scheduleId,
+            segmentOrder: segmentOrder++,
             seatId,
             departureStationId: stopTimes[i].stationId,
-            arrivalStationId:   stopTimes[i + 1].stationId,
+            arrivalStationId: stopTimes[i + 1].stationId,
           });
         }
       }
diff --git a/apps/edr-passenger-api/src/modules/payments/supplementary-charges-audit.spec.ts b/apps/edr-passenger-api/src/modules/payments/supplementary-charges-audit.spec.ts
new file mode 100644
index 000000000..28188f70f
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/payments/supplementary-charges-audit.spec.ts
@@ -0,0 +1,195 @@
+import { SupplementaryChargesService } from './supplementary-charges.service';
+
+/**
+ * Supplementary charges are raised by staff against a confirmed booking, so "who raised this,
+ * against which booking, and who later waived it" has to survive in AuditLog.
+ *
+ * The actor used to come from an `x-iam-user-id` request header defaulting to the literal
+ * string 'staff' — a client-settable value in the column meant to identify a person.
+ */
+describe('SupplementaryChargesService — audit', () => {
+  const CHARGE_ID = 'sc-1';
+  const BOOKING_ID = 'booking-1';
+  const BOOKING_REF = 'EDR-0001';
+
+  let prisma: Record<string, any>;
+  let audit: { log: jest.Mock };
+  let service: SupplementaryChargesService;
+
+  const build = (charge: Record<string, any> = {}) => {
+    const row = {
+      id: CHARGE_ID,
+      bookingId: BOOKING_ID,
+      reason: 'UNDERPAYMENT',
+      amountMinor: 25000,
+      currency: 'ETB',
+      status: 'PENDING',
+      paymentToken: 'tok-live-secret',
+      notes: null,
+      createdBy: 'iam-staff-1',
+      expiresAt: new Date(Date.now() + 72 * 60 * 60 * 1000),
+      booking: { bookingRef: BOOKING_REF, contactPhone: '+251911223344', contactEmail: 'p@example.com' },
+      ...charge,
+    };
+
+    prisma = {
+      supplementaryCharge: {
+        findUnique: jest.fn().mockResolvedValue(row),
+        create: jest.fn().mockResolvedValue(row),
+        update: jest.fn().mockResolvedValue({ ...row, status: 'WAIVED' }),
+        updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+      },
+      booking: {
+        findUnique: jest.fn().mockResolvedValue({
+          id: BOOKING_ID,
+          bookingRef: BOOKING_REF,
+          status: 'CONFIRMED',
+          contactPhone: '+251911223344',
+          contactEmail: 'p@example.com',
+          passenger: { user: { phone: null, email: null } },
+        }),
+      },
+    };
+    audit = { log: jest.fn().mockResolvedValue(undefined) };
+
+    // Constructor order: prisma, audit, sms, email, paymentClient, currency.
+    service = new SupplementaryChargesService(
+      prisma as any,
+      audit as any,
+      { sendSms: jest.fn() } as any,
+      { sendEmail: jest.fn() } as any,
+      {} as any,
+      {} as any,
+    );
+    return row;
+  };
+
+  const rows = () => audit.log.mock.calls.map((c) => c[0]);
+  const byAction = (action: string) => rows().filter((r) => r.action === action);
+
+  describe('create', () => {
+    it('records one CREATE naming the booking the charge belongs to', async () => {
+      build();
+      await service.create({
+        bookingRef: BOOKING_REF,
+        amountMinor: 25000,
+        reason: 'UNDERPAYMENT',
+        createdBy: 'iam-staff-1',
+      });
+
+      expect(byAction('CREATE')).toHaveLength(1);
+      expect(byAction('CREATE')[0]).toMatchObject({
+        entityType: 'SupplementaryCharge',
+        entityId: CHARGE_ID,
+      });
+      expect(byAction('CREATE')[0].newData).toMatchObject({
+        bookingId: BOOKING_ID,
+        bookingRef: BOOKING_REF,
+        amountMinor: 25000,
+        reason: 'UNDERPAYMENT',
+        createdBy: 'iam-staff-1',
+      });
+    });
+
+    it('never writes the payment token into the row', async () => {
+      build();
+      await service.create({
+        bookingRef: BOOKING_REF,
+        amountMinor: 25000,
+        reason: 'UNDERPAYMENT',
+        createdBy: 'iam-staff-1',
+      });
+      expect(JSON.stringify(rows())).not.toContain('tok-live-secret');
+    });
+
+    it('records nothing when the booking is not chargeable', async () => {
+      build();
+      prisma.booking.findUnique.mockResolvedValue({
+        id: BOOKING_ID,
+        bookingRef: BOOKING_REF,
+        status: 'PENDING_PAYMENT',
+      });
+
+      await expect(
+        service.create({
+          bookingRef: BOOKING_REF,
+          amountMinor: 25000,
+          reason: 'UNDERPAYMENT',
+          createdBy: 'iam-staff-1',
+        }),
+      ).rejects.toThrow();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('waive', () => {
+    it('records WAIVE rather than a generic UPDATE', async () => {
+      build();
+      await service.waive(CHARGE_ID, 'goodwill', 'iam-staff-1');
+
+      expect(byAction('WAIVE')).toHaveLength(1);
+      expect(byAction('UPDATE')).toHaveLength(0);
+      expect(byAction('WAIVE')[0]).toMatchObject({
+        entityType: 'SupplementaryCharge',
+        entityId: CHARGE_ID,
+        oldData: { status: 'PENDING' },
+      });
+      expect(byAction('WAIVE')[0].newData).toMatchObject({ status: 'WAIVED', waivedBy: 'iam-staff-1' });
+    });
+
+    it('records nothing when waiving a paid charge is refused', async () => {
+      build({ status: 'PAID' });
+      await expect(service.waive(CHARGE_ID, 'x', 'iam-staff-1')).rejects.toThrow();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('markPaid', () => {
+    it('records PAY once when it claims the transition', async () => {
+      build();
+      await service.markPaid(CHARGE_ID, 'TXN-9');
+
+      expect(byAction('PAY')).toHaveLength(1);
+      expect(byAction('PAY')[0]).toMatchObject({
+        entityType: 'SupplementaryCharge',
+        entityId: CHARGE_ID,
+        oldData: { status: 'PENDING' },
+      });
+    });
+
+    it('stays silent when the webhook already claimed it', async () => {
+      build();
+      prisma.supplementaryCharge.updateMany.mockResolvedValue({ count: 0 });
+      await service.markPaid(CHARGE_ID, 'TXN-9');
+
+      expect(byAction('PAY')).toHaveLength(0);
+    });
+
+    it('is a no-op on a charge already read as PAID', async () => {
+      build({ status: 'PAID' });
+      await service.markPaid(CHARGE_ID);
+
+      expect(audit.log).not.toHaveBeenCalled();
+      expect(prisma.supplementaryCharge.updateMany).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('actor', () => {
+    it('never sets userId at the call site — AuditService reads the session', async () => {
+      build();
+      await service.waive(CHARGE_ID, 'goodwill', 'client-supplied');
+      expect(rows().every((r) => r.userId === undefined)).toBe(true);
+    });
+  });
+
+  describe('reads', () => {
+    it('writes nothing when listing charges', async () => {
+      build();
+      prisma.supplementaryCharge.findMany = jest.fn().mockResolvedValue([]);
+      prisma.supplementaryCharge.count = jest.fn().mockResolvedValue(0);
+
+      await service.getAll({});
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+});
diff --git a/apps/edr-passenger-api/src/modules/payments/supplementary-charges.service.ts b/apps/edr-passenger-api/src/modules/payments/supplementary-charges.service.ts
index f8c316d87..714b02170 100644
--- a/apps/edr-passenger-api/src/modules/payments/supplementary-charges.service.ts
+++ b/apps/edr-passenger-api/src/modules/payments/supplementary-charges.service.ts
@@ -1,13 +1,39 @@
 import { Injectable, NotFoundException, BadRequestException, Logger } from '@nestjs/common';
 import { PrismaService } from '../../common/prisma.service';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
 import { SmsClientService } from '../notifications/sms-client.service';
 import { EmailClientService } from '../notifications/email-client.service';
 import { PaymentClientService } from './payment-client.service';
-import { PaymentReferenceType, PaymentService as PaymentServiceEnum, ProviderMethod } from '@edr/types';
+import { CurrencyService } from '../currency/currency.service';
+import {
+  PaymentReferenceType,
+  PaymentService as PaymentServiceEnum,
+  ProviderMethod,
+  ProviderPaymentStatus,
+} from '@edr/types';
+import { PaymentPlatformDto } from './payments.dto';
+import { PaymentMethodType } from '@prisma/client';
 
 const CHARGE_TTL_MS = 72 * 60 * 60 * 1000; // 72 hours
 
+/**
+ * WALLET is an internal balance debit handled inside this app, not a provider — the payment
+ * microservice rejects it as one. Supplementary charges have no wallet path, so it is refused up
+ * front with a message the payer can act on rather than a 502 from the gateway layer.
+ */
+const UNSUPPORTED_METHODS = new Set<string>([PaymentMethodType.WALLET]);
+
+/**
+ * Push-debit methods charge an account we must be told up front — CAC Bank SMSes a one-time
+ * password to it, eBirr pushes a USSD PIN prompt to it. Neither opens a hosted page that could
+ * collect the number later (mirrors PaymentsService and ExcessBaggageService).
+ */
+const METHODS_REQUIRING_PAYER_ACCOUNT = new Set<string>([
+  PaymentMethodType.CAC_BANK,
+  PaymentMethodType.EBIRR,
+]);
+
 @Injectable()
 export class SupplementaryChargesService {
   private readonly logger = new Logger(SupplementaryChargesService.name);
@@ -18,6 +44,7 @@ export class SupplementaryChargesService {
     private smsClient: SmsClientService,
     private emailClient: EmailClientService,
     private paymentClient: PaymentClientService,
+    private currencyService: CurrencyService,
   ) {}
 
   async create(dto: {
@@ -54,10 +81,20 @@ export class SupplementaryChargesService {
     await this.sendLink(charge, booking.bookingRef, phone, email);
 
     await this.auditService.log({
-      action: 'CREATE',
-      entityType: 'SupplementaryCharge',
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.SupplementaryCharge,
       entityId: charge.id,
-      newData: { bookingRef: dto.bookingRef, amountMinor: dto.amountMinor, reason: dto.reason },
+      newData: {
+        bookingId: booking.id,
+        bookingRef: dto.bookingRef,
+        amountMinor: dto.amountMinor,
+        currency: charge.currency,
+        reason: dto.reason,
+        notes: dto.notes,
+        createdBy: dto.createdBy,
+        status: charge.status,
+        expiresAt: charge.expiresAt?.toISOString(),
+      },
     });
     return charge;
   }
@@ -108,22 +145,191 @@ export class SupplementaryChargesService {
     const charge = await this.prisma.supplementaryCharge.findUnique({ where: { id } });
     if (!charge) throw new NotFoundException('Charge not found');
     if (charge.status === 'PAID') return charge;
-    const updated = await this.prisma.supplementaryCharge.update({
-      where: { id },
+
+    // Conditional update rather than a plain update: this transition is also reachable from the
+    // payment webhook, and claiming it atomically means exactly one of the two racing callers
+    // writes the audit row.
+    const { count } = await this.prisma.supplementaryCharge.updateMany({
+      where: { id, status: { not: 'PAID' } },
       data: { status: 'PAID', paidAt: new Date(), providerTxnId: providerTxnId ?? null },
     });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'SupplementaryCharge', entityId: id, newData: { status: 'PAID' } });
-    return updated;
+
+    const updated = await this.prisma.supplementaryCharge.findUnique({ where: { id } });
+
+    if (count === 1) {
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.PAY,
+        entityType: AUDIT_ENTITIES.SupplementaryCharge,
+        entityId: id,
+        oldData: { status: charge.status },
+        newData: {
+          status: 'PAID',
+          bookingId: charge.bookingId,
+          amountMinor: charge.amountMinor,
+          currency: charge.currency,
+          providerTxnId: providerTxnId ?? null,
+        },
+      });
+    }
+
+    return updated!;
+  }
+
+  /**
+   * What the payer is actually charged when settling this charge with `method`.
+   *
+   * The charge is raised in ETB, but the selected method settles in its own currency — WAAFI and
+   * D-Money in DJF, CARD in USD, the Ethiopian wallets in ETB — recorded on the PaymentMethod row.
+   * The payment microservice is currency-agnostic and hands whatever it is given straight to the
+   * gateway, so the ETB->settlement conversion has to happen here or the provider is asked to
+   * debit an ETB number labelled as its own currency.
+   *
+   * Both the quote shown to the payer and the amount sent to the provider come through this one
+   * method, so the price on the button and the price debited cannot drift apart.
+   */
+  private async resolveChargeAmount(
+    charge: { amountMinor: number; currency: string },
+    method: string,
+  ): Promise<{ amount: number; currency: string }> {
+    if (UNSUPPORTED_METHODS.has(method)) {
+      throw new BadRequestException(
+        `${method} is not available for balance payments`,
+      );
+    }
+
+    const paymentMethod = await this.prisma.paymentMethod.findUnique({
+      where: { type: method as PaymentMethodType },
+    });
+    // CBE settles ETB only (docs/cbe/CBE_IMPLEMENTATION_PLAN.md D8) — never converted.
+    const chargeCurrency =
+      method === PaymentMethodType.CBE_BILL
+        ? 'ETB'
+        : (paymentMethod?.currency ?? charge.currency).toUpperCase();
+
+    // Applies the target currency's own precision — DJF rounds to whole francs, ETB/USD to cents.
+    const amount = await this.currencyService.convertMinorToChargeMajor(
+      charge.amountMinor,
+      charge.currency,
+      chargeCurrency,
+    );
+    return { amount, currency: chargeCurrency };
+  }
+
+  /**
+   * Price quote for the pay page: what `method` would debit, in that method's settlement
+   * currency. The payer sees this before committing, and pay() recomputes it the same way.
+   */
+  async quoteAmount(token: string, method: string) {
+    const charge = await this.getByToken(token);
+    const { amount, currency } = await this.resolveChargeAmount(charge, method);
+    return { chargeId: charge.id, method, currency, amount };
+  }
+
+  /**
+   * Bare status for the pay/result pages to poll. Unlike getByToken this does NOT reject a paid,
+   * expired or waived charge — reporting those states is the entire point. A CBE bill can settle
+   * long after the payer closed the tab, and redirect methods only converge when the settlement
+   * event lands, so the page needs something it can watch.
+   */
+  async getStatus(token: string) {
+    const charge = await this.prisma.supplementaryCharge.findUnique({
+      where: { paymentToken: token },
+      select: {
+        id: true,
+        status: true,
+        paidAt: true,
+        amountMinor: true,
+        currency: true,
+        expiresAt: true,
+      },
+    });
+    if (!charge) throw new NotFoundException('Payment link not found');
+    return {
+      chargeId: charge.id,
+      status: charge.status,
+      paid: charge.status === 'PAID',
+      paidAt: charge.paidAt,
+      amountMinor: charge.amountMinor,
+      currency: charge.currency,
+      expiresAt: charge.expiresAt,
+    };
+  }
+
+  /**
+   * Full_Name for CBE's confirmation screen — mandatory in its envelope. The traveller the balance
+   * is owed against: lead passenger on the booking, falling back to the account holder.
+   */
+  private async resolvePayerName(bookingId: string): Promise<string | null> {
+    const booking = await this.prisma.booking.findUnique({
+      where: { id: bookingId },
+      include: { seats: true, passenger: { include: { user: true } } },
+    });
+    if (!booking) return null;
+    return (
+      booking.seats?.find((s: any) => s.leg === 1)?.passengerName ??
+      booking.seats?.[0]?.passengerName ??
+      booking.passenger?.user?.fullName ??
+      null
+    );
+  }
+
+  /**
+   * Submit the one-time password for a COLLECT_OTP provider (CAC Bank). The bank SMSed it to the
+   * payerAccount given at pay(); this forwards it to the payment service and marks the charge paid
+   * when the debit settles. A wrong or expired OTP bubbles up as a 400 and the intent stays open,
+   * so the payer can simply re-enter it.
+   *
+   * Deliberately reads the charge directly rather than through getByToken: the bank is already
+   * holding a debit against this payer, and refusing to submit their OTP because the link TTL
+   * lapsed while they read the SMS would strand a payment that is mid-flight.
+   */
+  async confirmOtp(token: string, otp: string) {
+    const charge = await this.prisma.supplementaryCharge.findUnique({
+      where: { paymentToken: token },
+    });
+    if (!charge) throw new NotFoundException('Payment link not found');
+    if (charge.status === 'PAID') {
+      return { chargeId: charge.id, status: 'SUCCEEDED', alreadyPaid: true };
+    }
+
+    const snapshot = await this.paymentClient.getIntentByReference(
+      PaymentReferenceType.SUPPLEMENTARY_CHARGE,
+      charge.id,
+    );
+    if (!snapshot) {
+      throw new NotFoundException('No active payment to confirm for this charge');
+    }
+
+    const confirmed = await this.paymentClient.confirmOtp(
+      snapshot.intentId,
+      otp,
+    );
+    if (confirmed.status === ProviderPaymentStatus.SUCCEEDED) {
+      await this.markPaid(charge.id, confirmed.providerTxnId);
+    }
+
+    return {
+      chargeId: charge.id,
+      status: confirmed.status,
+      alreadyPaid: false,
+    };
   }
 
   async pay(
     token: string,
     method: string,
-    platform?: 'web' | 'mobile',
+    platform?: PaymentPlatformDto,
     requestOrigin?: string | null,
+    payerAccount?: string,
   ) {
     const charge = await this.getByToken(token); // validates status/expiry
 
+    if (METHODS_REQUIRING_PAYER_ACCOUNT.has(method) && !payerAccount?.trim()) {
+      throw new BadRequestException(
+        `payerAccount (mobile number) is required for ${method}`,
+      );
+    }
+
     const paymentMethod = method as ProviderMethod;
     // Self-pay links are opened on whichever portal domain the recipient used
     // (bookingedr.et vs passenger.edrsc.com), so the return pages must live on
@@ -134,15 +340,38 @@ export class SupplementaryChargesService {
     const returnUrl = `${portalUrl}/pay-balance/${token}/success`;
     const failureUrl = `${portalUrl}/pay-balance/${token}/failed`;
 
+    const { amount, currency } = await this.resolveChargeAmount(charge, method);
+
+    // CBE_BILL is inbound-only: no provider session is opened, the bill simply sits in CBE's
+    // system until someone pays it. It needs a real deadline and a payer name (Full_Name is
+    // mandatory in CBE's envelope) rather than the redirect flow's session semantics.
+    //
+    // Unlike an excess baggage charge (30-minute link TTL), this charge already carries a 72-hour
+    // deadline of its own, which is a sane bill lifetime — so it is passed straight through with
+    // no extension. That deadline is what stops the reconciliation sweep from expiring the intent
+    // early (CBE_IMPLEMENTATION_PLAN.md §6.4). A charge with no expiry at all yields no intent
+    // expiry either, which is correct: an open-ended debt backs an open-ended bill.
+    let payerName: string | undefined;
+    let expiresAt: string | undefined;
+    if (method === PaymentMethodType.CBE_BILL) {
+      expiresAt = charge.expiresAt?.toISOString();
+      payerName = (await this.resolvePayerName(charge.bookingId)) ?? undefined;
+    }
+
     const snapshot = await this.paymentClient.initiate({
       service: PaymentServiceEnum.PASSENGER,
       referenceType: PaymentReferenceType.SUPPLEMENTARY_CHARGE,
       referenceId: charge.id,
       orderRef: `SC-${charge.id.substring(0, 8)}`,
-      amountMinor: charge.amountMinor / 100,
-      currency: charge.currency,
+      // `amountMinor` is the contract's name but its value is MAJOR units — the provider layer
+      // charges it verbatim at the currency's own precision (see PaymentIntentSnapshot).
+      amountMinor: amount,
+      currency,
       provider: paymentMethod,
       platform,
+      payerAccount: payerAccount?.trim() || undefined,
+      payerName,
+      expiresAt,
       returnUrl,
       failureUrl,
     });
@@ -158,7 +387,20 @@ export class SupplementaryChargesService {
       where: { id },
       data: { status: 'WAIVED', notes },
     });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'SupplementaryCharge', entityId: id, newData: { status: 'WAIVED', waivedBy, notes } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.WAIVE,
+      entityType: AUDIT_ENTITIES.SupplementaryCharge,
+      entityId: id,
+      oldData: { status: charge.status },
+      newData: {
+        status: 'WAIVED',
+        bookingId: charge.bookingId,
+        amountMinor: charge.amountMinor,
+        currency: charge.currency,
+        waivedBy,
+        notes,
+      },
+    });
     return updated;
   }
 
@@ -174,6 +416,19 @@ export class SupplementaryChargesService {
       data: { expiresAt: new Date(Date.now() + CHARGE_TTL_MS) },
     });
     await this.sendLink(updated, charge.booking.bookingRef, charge.booking.contactPhone, charge.booking.contactEmail);
+    // Re-exposes a live payment token and extends its deadline, so it is a state change worth
+    // attributing even though the charge's status is unchanged. Contact details stay out of the
+    // row — only the fact that a link was re-sent.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.RESEND,
+      entityType: AUDIT_ENTITIES.SupplementaryCharge,
+      entityId: id,
+      oldData: { expiresAt: charge.expiresAt?.toISOString() },
+      newData: {
+        bookingRef: charge.booking.bookingRef,
+        expiresAt: updated.expiresAt?.toISOString(),
+      },
+    });
     return { sent: true };
   }
 
diff --git a/apps/edr-passenger-api/src/modules/payments/supplementary-charges.spec.ts b/apps/edr-passenger-api/src/modules/payments/supplementary-charges.spec.ts
new file mode 100644
index 000000000..043ec919c
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/payments/supplementary-charges.spec.ts
@@ -0,0 +1,249 @@
+import { BadRequestException } from '@nestjs/common';
+import { PaymentMethodType } from '@prisma/client';
+import { SupplementaryChargesService } from './supplementary-charges.service';
+import { CurrencyService } from '../currency/currency.service';
+
+/**
+ * A supplementary charge is raised in ETB, but each payment method settles in its own currency and
+ * the payment microservice forwards whatever it is given straight to the gateway. These cover the
+ * ETB->settlement conversion, plus the two methods that could not complete at all before: CAC Bank
+ * (OTP debit) and CBE (inbound bill).
+ */
+describe('SupplementaryChargesService — payment methods', () => {
+  const CHARGE_ID = 'sc-1';
+  const TOKEN = 'tok-1';
+
+  let prisma: Record<string, any>;
+  let paymentClient: Record<string, jest.Mock>;
+  let service: SupplementaryChargesService;
+  let charge: any;
+
+  const build = (rate?: { rate: number }) => {
+    charge = {
+      id: CHARGE_ID,
+      bookingId: 'booking-1',
+      amountMinor: 100_000,
+      currency: 'ETB',
+      status: 'PENDING',
+      expiresAt: new Date(Date.now() + 72 * 60 * 60 * 1000),
+      booking: { bookingRef: 'BAL-001' },
+    };
+    prisma = {
+      supplementaryCharge: {
+        findUnique: jest.fn().mockResolvedValue(charge),
+        update: jest.fn().mockResolvedValue({ ...charge, status: 'PAID' }),
+        // markPaid claims the PAID transition conditionally so it cannot double-log with the
+        // webhook path; count: 1 means this caller won.
+        updateMany: jest.fn().mockResolvedValue({ count: 1 }),
+      },
+      booking: {
+        findUnique: jest.fn().mockResolvedValue({
+          seats: [{ leg: 1, passengerName: 'Abebe Kebede' }],
+          passenger: { user: { fullName: 'Account Holder' } },
+        }),
+      },
+      paymentMethod: { findUnique: jest.fn() },
+      currencyExchangeRate: {
+        findFirst: jest.fn().mockResolvedValue(rate ?? null),
+      },
+    };
+    paymentClient = {
+      initiate: jest.fn().mockResolvedValue({
+        intentId: 'intent-1',
+        status: 'REQUIRES_ACTION',
+        clientAction: { type: 'REDIRECT', url: 'https://gw.test/pay' },
+      }),
+      getIntentByReference: jest
+        .fn()
+        .mockResolvedValue({ intentId: 'intent-1', status: 'REQUIRES_ACTION' }),
+      confirmOtp: jest.fn().mockResolvedValue({
+        intentId: 'intent-1',
+        status: 'SUCCEEDED',
+        providerTxnId: 'CAC-77',
+      }),
+    };
+    service = new SupplementaryChargesService(
+      prisma as any,
+      { log: jest.fn() } as any,
+      {} as any,
+      {} as any,
+      paymentClient as any,
+      new CurrencyService(prisma as any),
+    );
+  };
+
+  const withMethod = (type: string, currency: string) =>
+    prisma.paymentMethod.findUnique.mockResolvedValue({ type, currency });
+
+  describe('currency', () => {
+    it('charges an Ethiopian wallet in ETB, unconverted', async () => {
+      build();
+      withMethod(PaymentMethodType.TELEBIRR, 'ETB');
+      const quote = await service.quoteAmount(TOKEN, PaymentMethodType.TELEBIRR);
+      expect(quote).toMatchObject({ currency: 'ETB', amount: 1000 });
+      expect(prisma.currencyExchangeRate.findFirst).not.toHaveBeenCalled();
+    });
+
+    it('converts to DJF and rounds to whole francs', async () => {
+      build({ rate: 3.25 });
+      withMethod(PaymentMethodType.DMONEY, 'DJF');
+      const quote = await service.quoteAmount(TOKEN, PaymentMethodType.DMONEY);
+      expect(quote).toMatchObject({ currency: 'DJF', amount: 3250 });
+      expect(Number.isInteger(quote.amount)).toBe(true);
+    });
+
+    it('sends the provider the converted amount, not the stored ETB total', async () => {
+      build({ rate: 0.018 });
+      withMethod(PaymentMethodType.CARD, 'USD');
+      await service.pay(TOKEN, PaymentMethodType.CARD, 'web' as any, null);
+      expect(paymentClient.initiate).toHaveBeenCalledWith(
+        expect.objectContaining({
+          referenceType: 'SUPPLEMENTARY_CHARGE',
+          amountMinor: 18,
+          currency: 'USD',
+        }),
+      );
+    });
+
+    it('quotes and charges the same figure', async () => {
+      build({ rate: 3.25 });
+      withMethod(PaymentMethodType.WAAFI, 'DJF');
+      const quote = await service.quoteAmount(TOKEN, PaymentMethodType.WAAFI);
+      await service.pay(TOKEN, PaymentMethodType.WAAFI, 'web' as any, null);
+      const sent = paymentClient.initiate.mock.calls[0][0];
+      expect(quote.amount).toBe(sent.amountMinor);
+      expect(quote.currency).toBe(sent.currency);
+    });
+
+    it('refuses WALLET, which has no supplementary-charge path', async () => {
+      build();
+      await expect(
+        service.quoteAmount(TOKEN, PaymentMethodType.WALLET),
+      ).rejects.toBeInstanceOf(BadRequestException);
+      expect(paymentClient.initiate).not.toHaveBeenCalled();
+    });
+
+    it('fails closed when no exchange rate is configured', async () => {
+      build();
+      withMethod(PaymentMethodType.WAAFI, 'DJF');
+      await expect(
+        service.pay(TOKEN, PaymentMethodType.WAAFI, 'web' as any, null),
+      ).rejects.toBeInstanceOf(BadRequestException);
+      expect(paymentClient.initiate).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('CAC Bank OTP debit', () => {
+    beforeEach(() => {
+      build({ rate: 3.25 });
+      withMethod(PaymentMethodType.CAC_BANK, 'DJF');
+    });
+
+    it('rejects pay() without a payer mobile', async () => {
+      await expect(
+        service.pay(TOKEN, PaymentMethodType.CAC_BANK, 'web' as any, null),
+      ).rejects.toBeInstanceOf(BadRequestException);
+      expect(paymentClient.initiate).not.toHaveBeenCalled();
+    });
+
+    it('forwards the trimmed payer mobile', async () => {
+      await service.pay(
+        TOKEN,
+        PaymentMethodType.CAC_BANK,
+        'web' as any,
+        null,
+        ' 77123456 ',
+      );
+      expect(paymentClient.initiate).toHaveBeenCalledWith(
+        expect.objectContaining({ payerAccount: '77123456', currency: 'DJF' }),
+      );
+    });
+
+    it('submits the OTP against the active intent and marks the charge paid', async () => {
+      const result = await service.confirmOtp(TOKEN, '4530');
+      expect(paymentClient.getIntentByReference).toHaveBeenCalledWith(
+        'SUPPLEMENTARY_CHARGE',
+        CHARGE_ID,
+      );
+      expect(paymentClient.confirmOtp).toHaveBeenCalledWith('intent-1', '4530');
+      expect(prisma.supplementaryCharge.updateMany).toHaveBeenCalledWith(
+        expect.objectContaining({
+          data: expect.objectContaining({
+            status: 'PAID',
+            providerTxnId: 'CAC-77',
+          }),
+        }),
+      );
+      expect(result).toMatchObject({ status: 'SUCCEEDED', alreadyPaid: false });
+    });
+
+    it('leaves the charge unpaid when the OTP does not settle', async () => {
+      paymentClient.confirmOtp.mockResolvedValue({
+        intentId: 'intent-1',
+        status: 'REQUIRES_ACTION',
+      });
+      await service.confirmOtp(TOKEN, '0000');
+      expect(prisma.supplementaryCharge.update).not.toHaveBeenCalled();
+      expect(prisma.supplementaryCharge.updateMany).not.toHaveBeenCalled();
+    });
+
+    it('is idempotent once already paid', async () => {
+      prisma.supplementaryCharge.findUnique.mockResolvedValue({
+        ...charge,
+        status: 'PAID',
+      });
+      await expect(service.confirmOtp(TOKEN, '4530')).resolves.toMatchObject({
+        alreadyPaid: true,
+      });
+      expect(paymentClient.confirmOtp).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('CBE bill', () => {
+    beforeEach(() => {
+      build({ rate: 3.25 });
+      withMethod(PaymentMethodType.CBE_BILL, 'DJF'); // misconfigured row must not win
+    });
+
+    it('forces ETB regardless of the PaymentMethod row', async () => {
+      const quote = await service.quoteAmount(TOKEN, PaymentMethodType.CBE_BILL);
+      expect(quote).toMatchObject({ currency: 'ETB', amount: 1000 });
+    });
+
+    it('passes the charge own 72h deadline as the intent expiry', async () => {
+      await service.pay(TOKEN, PaymentMethodType.CBE_BILL, 'web' as any, null);
+      const sent = paymentClient.initiate.mock.calls[0][0];
+      expect(sent.currency).toBe('ETB');
+      expect(sent.expiresAt).toBe(charge.expiresAt.toISOString());
+      // Comfortably longer than a browser-session TTL, so the sweep cannot kill the bill early.
+      expect(new Date(sent.expiresAt).getTime()).toBeGreaterThan(
+        Date.now() + 24 * 60 * 60 * 1000,
+      );
+    });
+
+    it('sends the lead passenger as Full_Name, which CBE requires', async () => {
+      await service.pay(TOKEN, PaymentMethodType.CBE_BILL, 'web' as any, null);
+      expect(paymentClient.initiate.mock.calls[0][0].payerName).toBe(
+        'Abebe Kebede',
+      );
+    });
+
+    it('leaves the intent expiry unset for an open-ended charge', async () => {
+      charge.expiresAt = null;
+      await service.pay(TOKEN, PaymentMethodType.CBE_BILL, 'web' as any, null);
+      expect(paymentClient.initiate.mock.calls[0][0].expiresAt).toBeUndefined();
+    });
+
+    it('reports a paid charge through getStatus without the payability gate', async () => {
+      prisma.supplementaryCharge.findUnique.mockResolvedValue({
+        ...charge,
+        status: 'PAID',
+        paidAt: new Date(),
+      });
+      await expect(service.getStatus(TOKEN)).resolves.toMatchObject({
+        status: 'PAID',
+        paid: true,
+      });
+    });
+  });
+});
diff --git a/apps/edr-passenger-api/src/modules/reports/reports.controller.ts b/apps/edr-passenger-api/src/modules/reports/reports.controller.ts
index 1eea923fd..6cf12a9f6 100644
--- a/apps/edr-passenger-api/src/modules/reports/reports.controller.ts
+++ b/apps/edr-passenger-api/src/modules/reports/reports.controller.ts
@@ -8,7 +8,7 @@ import {
   ApiProduces,
 } from "@nestjs/swagger";
 import { ReportsService } from "./reports.service";
-import { BlockedSeatsRevenueLossQueryDto, GenerateReportDto } from "./reports.dto";
+import { BlockedSeatsRevenueLossQueryDto, FinanceSummaryQueryDto, GenerateReportDto } from "./reports.dto";
 import { PassengerStaff } from "../../common/passenger-guards";
 import { PASSENGER_PERMS } from "../../seed/passenger-permissions.registry";
 
@@ -37,6 +37,24 @@ export class ReportsController {
     return this.service.getPassengerList(scheduleId);
   }
 
+  // Two segments, so `@Get(":reportId")` below cannot shadow it whatever the order.
+  @Get("passengers/overview")
+  @ApiOperation({
+    summary: "Fleet-wide passenger mix across a departure window",
+    description:
+      "Landing view for the passengers report, shown before a schedule is picked. Returns passenger volume per " +
+      "departure day, nationality split, passenger-category mix and the busiest origin→destination pairs across " +
+      "the window, plus one row per schedule.\n\n" +
+      "The window is forward-looking — the next `days` days. If nothing is departing in that window, it falls " +
+      "back to the most recent `days` of departures on record and says so via `window.direction`.\n\n" +
+      "Counts CONFIRMED and BOARDED seats only, matching `GET /reports/passengers`. Carries no occupancy figure " +
+      "by design: this report and the seat status report measure capacity differently, so a shared occupancy " +
+      "number would contradict one of them.",
+  })
+  getPassengerOverview(@Query('days') days?: string) {
+    return this.service.getPassengerOverview(days ? Number(days) : undefined);
+  }
+
   @Get("passengers")
   @ApiOperation({ summary: "Passengers report for a specific schedule" })
   getOccupancyReport(@Query("scheduleId") scheduleId: string) {
@@ -60,6 +78,23 @@ export class ReportsController {
     return this.service.getSeatStatusReport(scheduleId);
   }
 
+  // Two segments, so `@Get(":reportId")` below cannot shadow it whatever the order.
+  @Get("seat-status/overview")
+  @ApiOperation({
+    summary: "Fleet-wide seat status across a departure window",
+    description:
+      "Landing view for the seat status report, shown before a schedule is picked. Returns the same four " +
+      "counters as the per-schedule report (paid, unpaid, expired holds, blocked) rolled up over a window of " +
+      "departures, plus per-day buckets and one row per schedule.\n\n" +
+      "The window is forward-looking — the next `days` days. If nothing is departing in that window, it falls " +
+      "back to the most recent `days` of departures on record and says so via `window.direction`.\n\n" +
+      "Counts apply the same rules as `GET /reports/seat-status`, so a schedule's row here equals what the " +
+      "drill-down shows after selecting it.",
+  })
+  getSeatStatusOverview(@Query('days') days?: string) {
+    return this.service.getSeatStatusOverview(days ? Number(days) : undefined);
+  }
+
   @Get("boarding")
   @ApiOperation({ summary: "Boarding report for a schedule — boarded vs not-boarded passengers" })
   getBoardingReport(@Query('scheduleId') scheduleId: string) {
@@ -83,6 +118,39 @@ export class ReportsController {
     return this.service.getPaymentDiscrepancyBySchedule(scheduleId, { search, seatClass, sort });
   }
 
+  // ── Finance Summary ──────────────────────────────────────────────────────
+
+  @Get("finance")
+  @ApiOperation({
+    summary: "Finance summary — revenue by period, origin/destination segment, payment method, and currency",
+    description:
+      "Revenue collected in the window (PaymentIntent.paidAt), grouped by day/week/month, origin → " +
+      "destination station pair, payment method, and currency. Amounts are never converted to ETB — a " +
+      "Waafi payment is reported in whatever currency Waafi actually charged, and with no method filter " +
+      "every currency present is listed separately rather than summed. Filter by originStationId and/or " +
+      "destinationStationId independently to query any station-pair segment (A→B, A→D, B→C), not just a " +
+      "whole predefined route. Only counts CONFIRMED/BOARDED bookings with a SUCCEEDED payment — the same " +
+      "revenue definition as the dashboard and /payments confirmed-revenue filter. Returns per-bucket rows " +
+      "plus roll-ups by period, segment, and method for charting.",
+  })
+  getFinanceSummary(@Query() query: FinanceSummaryQueryDto) {
+    return this.service.getFinanceSummary(query);
+  }
+
+  @Get("finance/export")
+  @ApiOperation({ summary: "Finance summary as CSV — one row per period + route + payment method" })
+  @ApiProduces("text/csv")
+  @ApiOkResponse({ description: "CSV export", schema: { type: "string" } })
+  async exportFinanceSummary(@Query() query: FinanceSummaryQueryDto, @Res() res: Response): Promise<void> {
+    const csv = await this.service.exportFinanceSummaryCsv(query);
+    res.setHeader("Content-Type", "text/csv; charset=utf-8");
+    res.setHeader(
+      "Content-Disposition",
+      `attachment; filename="finance-summary-${new Date().toISOString().split("T")[0]}.csv"`,
+    );
+    res.send(csv);
+  }
+
   // ── Blocked Seat Revenue Loss ──────────────────────────────────────────────
 
   @Get("blocked-seats-revenue-loss")
diff --git a/apps/edr-passenger-api/src/modules/reports/reports.dto.ts b/apps/edr-passenger-api/src/modules/reports/reports.dto.ts
index 8b8049807..6c6b304d4 100644
--- a/apps/edr-passenger-api/src/modules/reports/reports.dto.ts
+++ b/apps/edr-passenger-api/src/modules/reports/reports.dto.ts
@@ -1,6 +1,7 @@
 import { IsString, IsDateString, IsOptional, IsEnum, IsInt, Min, Max } from 'class-validator';
 import { Type } from 'class-transformer';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { PaymentMethodType } from '@prisma/client';
 import { SeatBlockReasonCategory } from '../seats/seats.dto';
 
 export enum ReportType {
@@ -103,3 +104,31 @@ export class BlockedSeatsRevenueLossQueryDto {
   })
   @IsOptional() @IsEnum(BlockedSeatsLossSortBy) sortBy?: BlockedSeatsLossSortBy;
 }
+
+// ── Finance Summary ──────────────────────────────────────────────────────────
+
+export enum FinanceGranularity {
+  DAILY = 'daily',
+  WEEKLY = 'weekly',
+  MONTHLY = 'monthly',
+}
+
+export class FinanceSummaryQueryDto {
+  @ApiProperty({ example: '2026-07-01', description: 'Start of the window, inclusive, matched on PaymentIntent.paidAt.' })
+  @IsDateString() dateFrom: string;
+
+  @ApiProperty({ example: '2026-07-31', description: 'End of the window, inclusive, matched on PaymentIntent.paidAt.' })
+  @IsDateString() dateTo: string;
+
+  @ApiPropertyOptional({ enum: FinanceGranularity, default: FinanceGranularity.DAILY })
+  @IsOptional() @IsEnum(FinanceGranularity) granularity?: FinanceGranularity;
+
+  @ApiPropertyOptional({ description: 'Restrict to bookings departing from this station.' })
+  @IsOptional() @IsString() originStationId?: string;
+
+  @ApiPropertyOptional({ description: 'Restrict to bookings arriving at this station.' })
+  @IsOptional() @IsString() destinationStationId?: string;
+
+  @ApiPropertyOptional({ enum: PaymentMethodType, description: 'Restrict to payments made with this method.' })
+  @IsOptional() @IsEnum(PaymentMethodType) method?: PaymentMethodType;
+}
diff --git a/apps/edr-passenger-api/src/modules/reports/reports.service.ts b/apps/edr-passenger-api/src/modules/reports/reports.service.ts
index e899fdb4b..d727014ee 100644
--- a/apps/edr-passenger-api/src/modules/reports/reports.service.ts
+++ b/apps/edr-passenger-api/src/modules/reports/reports.service.ts
@@ -1,6 +1,7 @@
 import { Injectable, Logger } from "@nestjs/common";
 import { InjectDataSource } from "@nestjs/typeorm";
 import { DataSource } from "typeorm";
+import { BookingStatus } from "@prisma/client";
 import {
   BlockedSeatRevenueLossReport,
   UNCATEGORIZED_REASON_CATEGORY,
@@ -10,6 +11,8 @@ import { FareEngineService } from "../fare-engine/fare-engine.service";
 import {
   BlockedSeatsLossSortBy,
   BlockedSeatsRevenueLossQueryDto,
+  FinanceGranularity,
+  FinanceSummaryQueryDto,
   GenerateReportDto,
   ReportType,
 } from "./reports.dto";
@@ -35,6 +38,48 @@ const FARE_QUOTE_CONCURRENCY = 4;
 /** CSV export is not paginated, but still needs an upper bound. */
 const CSV_EXPORT_MAX_SCHEDULES = 5000;
 
+// ── Fleet seat-status overview (landing view of the seat status report) ──────
+const MS_PER_DAY_OVERVIEW = 24 * 60 * 60 * 1000;
+const OVERVIEW_DEFAULT_DAYS = 7;
+const OVERVIEW_MAX_DAYS = 31;
+/** Upper bound on schedules charted at once. Signalled back as `window.truncated`. */
+const OVERVIEW_MAX_SCHEDULES = 60;
+/** The booking statuses that put a seat on a schedule — same set as the drill-down. */
+const OVERVIEW_ACTIVE_BOOKING_STATUSES: BookingStatus[] = [
+  'CONFIRMED',
+  'BOARDED',
+  'PENDING_PAYMENT',
+];
+
+/** The passengers report counts people, so a seat awaiting payment does not qualify. */
+const PASSENGER_ACTIVE_BOOKING_STATUSES: BookingStatus[] = ['CONFIRMED', 'BOARDED'];
+/** Route pairs are long-tailed; only the busiest are legible in a chart. */
+const TOP_ROUTES_LIMIT = 8;
+
+const EMPTY_OVERVIEW_TOTALS = {
+  scheduleCount: 0,
+  sellableSeats: 0,
+  paidCount: 0,
+  unpaidCount: 0,
+  expiredHoldCount: 0,
+  blockedCount: 0,
+  availableCount: 0,
+  loadFactorPercent: 0,
+};
+
+function emptyDayBucket(date: string) {
+  return {
+    date,
+    scheduleCount: 0,
+    sellableSeats: 0,
+    paid: 0,
+    unpaid: 0,
+    expiredHolds: 0,
+    blocked: 0,
+    available: 0,
+  };
+}
+
 const EMPTY_LOSS_INPUT: LossCalculatorInput = {
   schedules: [],
   seatsById: new Map(),
@@ -84,6 +129,42 @@ function toCsvCell(value: string | number): string {
   return `"${String(value).replace(/"/g, '""')}"`;
 }
 
+/**
+ * Buckets a paid-at timestamp into the requested reporting period, keyed so buckets sort
+ * chronologically as plain strings. Weekly buckets are labelled by their Monday (UTC).
+ */
+function periodKeyFor(date: Date, granularity: FinanceGranularity): string {
+  if (granularity === FinanceGranularity.MONTHLY) {
+    return date.toISOString().slice(0, 7);
+  }
+  if (granularity === FinanceGranularity.WEEKLY) {
+    const d = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+    const isoDay = d.getUTCDay() || 7; // Monday=1 .. Sunday=7
+    d.setUTCDate(d.getUTCDate() - (isoDay - 1));
+    return d.toISOString().split("T")[0];
+  }
+  return date.toISOString().split("T")[0];
+}
+
+export interface FinanceBucket {
+  period: string;
+  originStationId: string;
+  destinationStationId: string;
+  segmentLabel: string;
+  method: string;
+  currency: string;
+  bookingCount: number;
+  revenueMinor: number;
+}
+
+export interface FinanceRollupRow {
+  key: string;
+  label: string;
+  currency: string;
+  revenueMinor: number;
+  bookingCount: number;
+}
+
 @Injectable()
 export class ReportsService {
   private readonly logger = new Logger(ReportsService.name);
@@ -728,6 +809,603 @@ export class ReportsService {
     };
   }
 
+  /**
+   * Fleet-wide seat status across a departure window — the landing view for the seat
+   * status report, shown before a schedule is picked.
+   *
+   * Deliberately a separate method from {@link getSeatStatusReport}: that one answers
+   * "this schedule, row by row" and its response shape is consumed by the drill-down UI.
+   * This one answers "the whole window, counts only". They share no code path, but they
+   * *do* share predicates — every filter below is the same rule the drill-down applies
+   * (the three-branch seat `OR`, the dining-coach exclusion, the counted-block
+   * resolution), so a schedule's row here always equals what you see after clicking it.
+   * Change one and the other must change with it.
+   */
+  async getSeatStatusOverview(daysRaw?: number) {
+    const days = Math.min(
+      Math.max(Math.trunc(daysRaw || OVERVIEW_DEFAULT_DAYS), 1),
+      OVERVIEW_MAX_DAYS,
+    );
+    const now = new Date();
+
+    // Forward-looking by default. But a database whose schedules are all in the past
+    // would render an empty chart, which reads as a broken page rather than an honest
+    // "nothing departing" — so fall back to the most recent window that has departures.
+    let from = now;
+    let to = new Date(now.getTime() + days * MS_PER_DAY_OVERVIEW);
+    let direction: 'UPCOMING' | 'RECENT' = 'UPCOMING';
+
+    const upcomingCount = await this.prisma.trainSchedule.count({
+      where: { departureAt: { gte: from, lte: to }, status: { not: 'CANCELLED' } },
+    });
+
+    if (upcomingCount === 0) {
+      const latest = await this.prisma.trainSchedule.findFirst({
+        where: { departureAt: { lt: now }, status: { not: 'CANCELLED' } },
+        orderBy: { departureAt: 'desc' },
+        select: { departureAt: true },
+      });
+      if (latest) {
+        direction = 'RECENT';
+        to = latest.departureAt;
+        from = new Date(to.getTime() - days * MS_PER_DAY_OVERVIEW);
+      }
+    }
+
+    const schedules = await this.prisma.trainSchedule.findMany({
+      where: { departureAt: { gte: from, lte: to }, status: { not: 'CANCELLED' } },
+      select: {
+        id: true,
+        departureAt: true,
+        isPackageOnly: true,
+        train: { select: { number: true } },
+        originStation: { select: { name: true } },
+        destinationStation: { select: { name: true } },
+      },
+      orderBy: { departureAt: 'asc' },
+      take: OVERVIEW_MAX_SCHEDULES,
+    });
+
+    if (schedules.length === 0) {
+      return {
+        window: { from, to, days, direction, truncated: false },
+        totals: EMPTY_OVERVIEW_TOTALS,
+        byDay: [],
+        schedules: [],
+      };
+    }
+
+    const scheduleIds = schedules.map((s) => s.id);
+    const since24h = new Date(now.getTime() - MS_PER_DAY_OVERVIEW);
+
+    const [assignments, bookingSeats, holds, blockRows] = await Promise.all([
+      this.prisma.coachAssignment.findMany({
+        where: { scheduleId: { in: scheduleIds } },
+        select: {
+          scheduleId: true,
+          coachId: true,
+          coach: {
+            select: {
+              coachType: { select: { name: true, type: true } },
+              seats: { select: { seatNumber: true } },
+            },
+          },
+        },
+      }),
+      // Same three-branch OR as the drill-down (`getSeatStatusReport`): a seat reaches a
+      // schedule by its own `scheduleId`, by being leg 2 of a return booking, or — on
+      // older rows with no `scheduleId` — by its booking's outbound schedule. A plain
+      // `groupBy scheduleId` would silently drop the last two.
+      this.prisma.bookingSeat.findMany({
+        where: {
+          OR: [
+            {
+              scheduleId: { in: scheduleIds },
+              booking: { status: { in: OVERVIEW_ACTIVE_BOOKING_STATUSES } },
+            },
+            {
+              leg: 2,
+              booking: {
+                returnScheduleId: { in: scheduleIds },
+                status: { in: OVERVIEW_ACTIVE_BOOKING_STATUSES },
+              },
+            },
+            {
+              scheduleId: null,
+              leg: 1,
+              booking: {
+                scheduleId: { in: scheduleIds },
+                status: { in: OVERVIEW_ACTIVE_BOOKING_STATUSES },
+              },
+            },
+          ],
+        },
+        select: {
+          scheduleId: true,
+          leg: true,
+          booking: {
+            select: { status: true, scheduleId: true, returnScheduleId: true },
+          },
+          seat: {
+            select: {
+              coach: { select: { coachType: { select: { name: true, type: true } } } },
+            },
+          },
+        },
+      }),
+      this.prisma.seatHold.findMany({
+        where: {
+          scheduleId: { in: scheduleIds },
+          expiresAt: { lt: now, gte: since24h },
+        },
+        select: { scheduleId: true },
+      }),
+      this.prisma.seatBlock.findMany({
+        where: {
+          OR: [{ scheduleId: { in: scheduleIds } }, { scheduleId: null }],
+          NOT: [
+            { reason: { startsWith: 'MAINTENANCE:' } },
+            { reason: { startsWith: TICKETING_BLOCK_REASON_PREFIX } },
+          ],
+        },
+        select: {
+          scheduleId: true,
+          blockedAt: true,
+          unblockAt: true,
+          seat: {
+            select: {
+              id: true,
+              coachId: true,
+              seatNumber: true,
+              coach: { select: { coachType: { select: { name: true, type: true } } } },
+            },
+          },
+        },
+        orderBy: { blockedAt: 'desc' },
+      }),
+    ]);
+
+    // ── Sellable seats and assigned coaches, per schedule ───────────────────────
+    // Sellable = every seat on every assigned coach, minus dining coaches and
+    // placeholder rows — the same denominator the revenue-loss report uses.
+    const sellableBySchedule = new Map<string, number>();
+    const coachIdsBySchedule = new Map<string, Set<string>>();
+    for (const assignment of assignments) {
+      const coachIds =
+        coachIdsBySchedule.get(assignment.scheduleId) ?? new Set<string>();
+      coachIds.add(assignment.coachId);
+      coachIdsBySchedule.set(assignment.scheduleId, coachIds);
+
+      const coachType = assignment.coach?.coachType;
+      if (
+        isDiningCoach({
+          coachTypeType: coachType?.type ?? null,
+          coachTypeName: coachType?.name ?? null,
+        })
+      ) {
+        continue;
+      }
+      const sellable = (assignment.coach?.seats ?? []).filter(
+        (seat) => !isPlaceholderSeat(seat),
+      ).length;
+      sellableBySchedule.set(
+        assignment.scheduleId,
+        (sellableBySchedule.get(assignment.scheduleId) ?? 0) + sellable,
+      );
+    }
+
+    // ── Paid / unpaid, per schedule ────────────────────────────────────────────
+    const scheduleIdSet = new Set(scheduleIds);
+    const paidBySchedule = new Map<string, number>();
+    const unpaidBySchedule = new Map<string, number>();
+    for (const bs of bookingSeats) {
+      // Dining seats only — the drill-down does not drop placeholder rows from the
+      // passenger seat list, so neither does this.
+      const coachType = bs.seat?.coach?.coachType;
+      if (
+        isDiningCoach({
+          coachTypeType: coachType?.type ?? null,
+          coachTypeName: coachType?.name ?? null,
+        })
+      ) {
+        continue;
+      }
+
+      // Mirrors the OR branches, in the same order: an explicit `scheduleId` inside the
+      // window wins, then the return leg, then the booking's outbound schedule.
+      const scheduleId =
+        bs.scheduleId && scheduleIdSet.has(bs.scheduleId)
+          ? bs.scheduleId
+          : bs.leg === 2
+            ? bs.booking.returnScheduleId
+            : bs.booking.scheduleId;
+      if (!scheduleId || !scheduleIdSet.has(scheduleId)) continue;
+
+      const target =
+        bs.booking.status === 'PENDING_PAYMENT' ? unpaidBySchedule : paidBySchedule;
+      target.set(scheduleId, (target.get(scheduleId) ?? 0) + 1);
+    }
+
+    // ── Expired holds, per schedule ────────────────────────────────────────────
+    const holdsBySchedule = new Map<string, number>();
+    for (const hold of holds) {
+      holdsBySchedule.set(
+        hold.scheduleId,
+        (holdsBySchedule.get(hold.scheduleId) ?? 0) + 1,
+      );
+    }
+
+    // ── Blocked seats, per schedule ────────────────────────────────────────────
+    // One counted block per seat, resolved exactly as the drill-down resolves it: a
+    // schedule-scoped block beats a global one, and rows arrive newest-first so the
+    // first of a kind seen for a seat is already the most recent.
+    const blockedBySchedule = new Map<string, number>();
+    for (const schedule of schedules) {
+      const assignedCoachIds = coachIdsBySchedule.get(schedule.id) ?? new Set<string>();
+      const countedSeatIds = new Map<string, string | null>();
+
+      for (const block of blockRows) {
+        const seat = block.seat;
+        if (!seat || isPlaceholderSeat(seat)) continue;
+
+        const coachType = seat.coach?.coachType;
+        if (
+          isDiningCoach({
+            coachTypeType: coachType?.type ?? null,
+            coachTypeName: coachType?.name ?? null,
+          })
+        ) {
+          continue;
+        }
+
+        if (block.scheduleId !== null) {
+          if (block.scheduleId !== schedule.id) continue;
+        } else {
+          if (!assignedCoachIds.has(seat.coachId)) continue;
+          if (!isGlobalBlockInEffectAt(block, schedule.departureAt)) continue;
+        }
+
+        const existing = countedSeatIds.get(seat.id);
+        if (existing === undefined || (existing === null && block.scheduleId !== null)) {
+          countedSeatIds.set(seat.id, block.scheduleId);
+        }
+      }
+
+      if (countedSeatIds.size > 0) {
+        blockedBySchedule.set(schedule.id, countedSeatIds.size);
+      }
+    }
+
+    // ── Assemble ───────────────────────────────────────────────────────────────
+    const scheduleRows = schedules.map((s) => {
+      const sellableSeats = sellableBySchedule.get(s.id) ?? 0;
+      const paid = paidBySchedule.get(s.id) ?? 0;
+      const unpaid = unpaidBySchedule.get(s.id) ?? 0;
+      const expiredHolds = holdsBySchedule.get(s.id) ?? 0;
+      const blocked = blockedBySchedule.get(s.id) ?? 0;
+      // Floored at zero: a seat can be both sold and blocked, so the parts can
+      // over-subtract. Never render a negative slice.
+      const available = Math.max(0, sellableSeats - paid - unpaid - blocked);
+
+      return {
+        scheduleId: s.id,
+        trainNumber: s.train.number,
+        originStation: s.originStation.name,
+        destinationStation: s.destinationStation.name,
+        departureAt: s.departureAt,
+        isPackage: s.isPackageOnly,
+        sellableSeats,
+        paid,
+        unpaid,
+        expiredHolds,
+        blocked,
+        available,
+        loadFactorPercent:
+          sellableSeats > 0 ? +((paid / sellableSeats) * 100).toFixed(1) : 0,
+      };
+    });
+
+    // Day buckets keyed on the UTC calendar date of departure, so the chart's axis and
+    // its bars are derived from one value and cannot disagree with each other.
+    const byDayMap = new Map<string, ReturnType<typeof emptyDayBucket>>();
+    for (const row of scheduleRows) {
+      const date = row.departureAt.toISOString().slice(0, 10);
+      const bucket = byDayMap.get(date) ?? emptyDayBucket(date);
+      bucket.scheduleCount += 1;
+      bucket.sellableSeats += row.sellableSeats;
+      bucket.paid += row.paid;
+      bucket.unpaid += row.unpaid;
+      bucket.expiredHolds += row.expiredHolds;
+      bucket.blocked += row.blocked;
+      bucket.available += row.available;
+      byDayMap.set(date, bucket);
+    }
+    const byDay = [...byDayMap.values()].sort((a, b) => a.date.localeCompare(b.date));
+
+    const sum = (pick: (r: (typeof scheduleRows)[number]) => number) =>
+      scheduleRows.reduce((total, row) => total + pick(row), 0);
+
+    const totalSellable = sum((r) => r.sellableSeats);
+    const totalPaid = sum((r) => r.paid);
+
+    return {
+      window: {
+        from,
+        to,
+        days,
+        direction,
+        truncated: schedules.length === OVERVIEW_MAX_SCHEDULES,
+      },
+      totals: {
+        scheduleCount: scheduleRows.length,
+        sellableSeats: totalSellable,
+        paidCount: totalPaid,
+        unpaidCount: sum((r) => r.unpaid),
+        expiredHoldCount: sum((r) => r.expiredHolds),
+        blockedCount: sum((r) => r.blocked),
+        availableCount: sum((r) => r.available),
+        loadFactorPercent:
+          totalSellable > 0 ? +((totalPaid / totalSellable) * 100).toFixed(1) : 0,
+      },
+      byDay,
+      schedules: scheduleRows,
+    };
+  }
+
+  /**
+   * Fleet-wide passenger mix across a departure window — the landing view for the
+   * passengers report, shown before a schedule is picked.
+   *
+   * Answers "who travelled", not "how full were the trains". Occupancy is deliberately
+   * absent: this report and the seat status report count capacity differently (this one
+   * includes dining and placeholder seats in `totalSeats`, the other does not), so an
+   * occupancy figure here would either contradict the table below it or the seats page.
+   * That pre-existing difference is left alone rather than silently reconciled.
+   *
+   * Counts CONFIRMED and BOARDED only, matching {@link getOccupancyBySchedule} — a seat
+   * awaiting payment has no passenger on it yet.
+   */
+  async getPassengerOverview(daysRaw?: number) {
+    const days = Math.min(
+      Math.max(Math.trunc(daysRaw || OVERVIEW_DEFAULT_DAYS), 1),
+      OVERVIEW_MAX_DAYS,
+    );
+    const now = new Date();
+
+    // Window resolution is intentionally a copy of the one in getSeatStatusOverview
+    // rather than a shared helper: the two reports are free to diverge on what window
+    // makes sense for them, and a shared helper would couple them for ~20 lines.
+    let from = now;
+    let to = new Date(now.getTime() + days * MS_PER_DAY_OVERVIEW);
+    let direction: 'UPCOMING' | 'RECENT' = 'UPCOMING';
+
+    const upcomingCount = await this.prisma.trainSchedule.count({
+      where: { departureAt: { gte: from, lte: to }, status: { not: 'CANCELLED' } },
+    });
+
+    if (upcomingCount === 0) {
+      const latest = await this.prisma.trainSchedule.findFirst({
+        where: { departureAt: { lt: now }, status: { not: 'CANCELLED' } },
+        orderBy: { departureAt: 'desc' },
+        select: { departureAt: true },
+      });
+      if (latest) {
+        direction = 'RECENT';
+        to = latest.departureAt;
+        from = new Date(to.getTime() - days * MS_PER_DAY_OVERVIEW);
+      }
+    }
+
+    const schedules = await this.prisma.trainSchedule.findMany({
+      where: { departureAt: { gte: from, lte: to }, status: { not: 'CANCELLED' } },
+      select: {
+        id: true,
+        departureAt: true,
+        isPackageOnly: true,
+        originStationId: true,
+        destinationStationId: true,
+        train: { select: { number: true } },
+        originStation: { select: { name: true } },
+        destinationStation: { select: { name: true } },
+      },
+      orderBy: { departureAt: 'asc' },
+      take: OVERVIEW_MAX_SCHEDULES,
+    });
+
+    if (schedules.length === 0) {
+      return {
+        window: { from, to, days, direction, truncated: false },
+        totals: { scheduleCount: 0, totalPassengers: 0, groupPassengers: 0 },
+        byDay: [],
+        byNationality: [],
+        byCategory: [],
+        topRoutes: [],
+        schedules: [],
+      };
+    }
+
+    const scheduleIds = schedules.map((s) => s.id);
+
+    // Same three-branch OR as the per-schedule report: own scheduleId, return leg, or a
+    // legacy null-scheduleId row reached through the booking's outbound schedule.
+    const bookingSeats = await this.prisma.bookingSeat.findMany({
+      where: {
+        OR: [
+          {
+            scheduleId: { in: scheduleIds },
+            booking: { status: { in: PASSENGER_ACTIVE_BOOKING_STATUSES } },
+          },
+          {
+            leg: 2,
+            booking: {
+              returnScheduleId: { in: scheduleIds },
+              status: { in: PASSENGER_ACTIVE_BOOKING_STATUSES },
+            },
+          },
+          {
+            scheduleId: null,
+            leg: 1,
+            booking: {
+              scheduleId: { in: scheduleIds },
+              status: { in: PASSENGER_ACTIVE_BOOKING_STATUSES },
+            },
+          },
+        ],
+      },
+      select: {
+        scheduleId: true,
+        leg: true,
+        bookingId: true,
+        passengerCategory: true,
+        passportCountry: true,
+        idDocumentType: true,
+        booking: {
+          select: {
+            scheduleId: true,
+            returnScheduleId: true,
+            originStationId: true,
+            destinationStationId: true,
+          },
+        },
+      },
+    });
+
+    // Station names for the route pairs. Bookings that never recorded a station fall back
+    // to the schedule's own endpoints, the same fallback getOccupancyBySchedule applies.
+    const stationIds = [
+      ...new Set(
+        [
+          ...bookingSeats.flatMap((bs) => [
+            bs.booking.originStationId,
+            bs.booking.destinationStationId,
+          ]),
+          ...schedules.flatMap((s) => [s.originStationId, s.destinationStationId]),
+        ].filter((id): id is string => Boolean(id)),
+      ),
+    ];
+    const stations = stationIds.length
+      ? await this.prisma.station.findMany({
+          where: { id: { in: stationIds } },
+          select: { id: true, name: true },
+        })
+      : [];
+    const stationName = new Map(stations.map((s) => [s.id, s.name]));
+
+    const scheduleById = new Map(schedules.map((s) => [s.id, s]));
+    const scheduleIdSet = new Set(scheduleIds);
+
+    const passengersBySchedule = new Map<string, number>();
+    const nationalityCounts = new Map<string, number>();
+    const categoryCounts = new Map<string, number>();
+    const routeCounts = new Map<string, { origin: string; destination: string; passengers: number }>();
+    // A booking contributing more than one seat to the window is a group booking.
+    const seatsPerBooking = new Map<string, number>();
+
+    for (const bs of bookingSeats) {
+      const scheduleId =
+        bs.scheduleId && scheduleIdSet.has(bs.scheduleId)
+          ? bs.scheduleId
+          : bs.leg === 2
+            ? bs.booking.returnScheduleId
+            : bs.booking.scheduleId;
+      if (!scheduleId || !scheduleIdSet.has(scheduleId)) continue;
+
+      const schedule = scheduleById.get(scheduleId);
+      passengersBySchedule.set(
+        scheduleId,
+        (passengersBySchedule.get(scheduleId) ?? 0) + 1,
+      );
+      seatsPerBooking.set(bs.bookingId, (seatsPerBooking.get(bs.bookingId) ?? 0) + 1);
+
+      // Same derivation as getPassengerList, so the chart and the drill-down list agree
+      // on what a passenger's nationality is.
+      const nationality = bs.passportCountry
+        ? bs.passportCountry === 'Djibouti'
+          ? 'Djiboutian'
+          : bs.passportCountry
+        : bs.idDocumentType === 'NATIONAL_ID'
+          ? 'Ethiopian'
+          : 'Unknown';
+      nationalityCounts.set(nationality, (nationalityCounts.get(nationality) ?? 0) + 1);
+
+      const category = bs.passengerCategory ?? 'ADULT';
+      categoryCounts.set(category, (categoryCounts.get(category) ?? 0) + 1);
+
+      const originId = bs.booking.originStationId ?? schedule?.originStationId ?? null;
+      const destinationId =
+        bs.booking.destinationStationId ?? schedule?.destinationStationId ?? null;
+      if (originId && destinationId) {
+        const key = `${originId}|${destinationId}`;
+        const existing = routeCounts.get(key);
+        if (existing) {
+          existing.passengers += 1;
+        } else {
+          routeCounts.set(key, {
+            origin: stationName.get(originId) ?? originId,
+            destination: stationName.get(destinationId) ?? destinationId,
+            passengers: 1,
+          });
+        }
+      }
+    }
+
+    const groupPassengers = [...seatsPerBooking.values()]
+      .filter((count) => count > 1)
+      .reduce((sum, count) => sum + count, 0);
+
+    const scheduleRows = schedules.map((s) => ({
+      scheduleId: s.id,
+      trainNumber: s.train.number,
+      originStation: s.originStation.name,
+      destinationStation: s.destinationStation.name,
+      departureAt: s.departureAt,
+      isPackage: s.isPackageOnly,
+      passengers: passengersBySchedule.get(s.id) ?? 0,
+    }));
+
+    const byDayMap = new Map<string, { date: string; scheduleCount: number; passengers: number }>();
+    for (const row of scheduleRows) {
+      const date = row.departureAt.toISOString().slice(0, 10);
+      const bucket = byDayMap.get(date) ?? { date, scheduleCount: 0, passengers: 0 };
+      bucket.scheduleCount += 1;
+      bucket.passengers += row.passengers;
+      byDayMap.set(date, bucket);
+    }
+
+    const rank = <T extends { passengers: number }>(rows: T[]) =>
+      rows.sort((a, b) => b.passengers - a.passengers);
+
+    return {
+      window: {
+        from,
+        to,
+        days,
+        direction,
+        truncated: schedules.length === OVERVIEW_MAX_SCHEDULES,
+      },
+      totals: {
+        scheduleCount: scheduleRows.length,
+        totalPassengers: scheduleRows.reduce((sum, r) => sum + r.passengers, 0),
+        groupPassengers,
+      },
+      byDay: [...byDayMap.values()].sort((a, b) => a.date.localeCompare(b.date)),
+      byNationality: rank(
+        [...nationalityCounts.entries()].map(([nationality, passengers]) => ({
+          nationality,
+          passengers,
+        })),
+      ),
+      byCategory: rank(
+        [...categoryCounts.entries()].map(([category, passengers]) => ({
+          category,
+          passengers,
+        })),
+      ),
+      topRoutes: rank([...routeCounts.values()]).slice(0, TOP_ROUTES_LIMIT),
+      schedules: scheduleRows,
+    };
+  }
+
   async getPaymentDiscrepancyReport(params: {
     from?: string;
     to?: string;
@@ -1051,6 +1729,170 @@ export class ReportsService {
     return { totalActualEtbMinor, totalPaidEtbMinor, byMethod, rows };
   }
 
+  // ── Finance Summary ────────────────────────────────────────────────────────
+
+  /**
+   * Revenue collected in the window, grouped by reporting period (day/week/month), origin →
+   * destination station pair, payment method, and currency — the shape finance reconciles
+   * against provider settlement statements.
+   *
+   * Amounts are never converted to ETB. A Waafi payment settles in whatever currency Waafi
+   * actually charged (DJF/USD), not an exchange-rate estimate of its ETB equivalent — so
+   * filtering to one method shows exactly what that method collected, in its own currency,
+   * and leaving every method selected lists each currency's total separately rather than
+   * summing unlike currencies into one converted figure.
+   *
+   * The "actual" amount/currency is `displayTotalMinor`/`displayCurrency` when set, falling
+   * back to `totalMinor`/`currency` — the same resolution `getPaymentDiscrepancyReport` and
+   * `getPaymentsReport` use, because `Booking.currency` is often just the internal ETB
+   * charge basis (many booking-creation paths hardcode it to ETB); the currency the
+   * passenger was actually shown and charged in lives in the display fields.
+   *
+   * Grouped by the booking's own origin/destination, not the parent Route — a route like
+   * "Sebeta - Dire Dawa" has intermediate stops, and a passenger may have booked any
+   * sub-segment of it (e.g. Lebu → Adama). Filtering by station lets finance ask about any
+   * A→B pair, not just whole routes.
+   *
+   * Bucketed on `PaymentIntent.paidAt` (cash actually received), not `Booking.createdAt`,
+   * so a booking made in one period but paid in another lands in the period it was paid.
+   *
+   * Same revenue definition as `getBackofficeStats` and the `/payments` "confirmed revenue"
+   * filter: `Booking.status` must still be CONFIRMED/BOARDED (a booking that was paid and
+   * later cancelled is not revenue) and `PaymentIntent.status` must be SUCCEEDED, not just
+   * carry a stale `paidAt` from before a cancellation.
+   */
+  async getFinanceSummary(query: FinanceSummaryQueryDto) {
+    const dateFrom = new Date(query.dateFrom + "T00:00:00.000Z");
+    const dateTo = new Date(query.dateTo + "T23:59:59.999Z");
+    const granularity = query.granularity ?? FinanceGranularity.DAILY;
+
+    const bookings = await this.prisma.booking.findMany({
+      where: {
+        // Same revenue definition as the dashboard's backoffice-stats and the /payments
+        // "confirmed revenue" filter: the booking must still be CONFIRMED/BOARDED (a booking
+        // that was paid and later cancelled is not revenue) and the payment itself must have
+        // actually succeeded, not just carry a stale paidAt.
+        status: { in: ["CONFIRMED", "BOARDED"] },
+        paymentIntent: {
+          status: "SUCCEEDED",
+          paidAt: { gte: dateFrom, lte: dateTo },
+          ...(query.method ? { method: query.method } : {}),
+        },
+        ...(query.originStationId ? { originStationId: query.originStationId } : {}),
+        ...(query.destinationStationId ? { destinationStationId: query.destinationStationId } : {}),
+      },
+      select: {
+        totalMinor: true,
+        currency: true,
+        displayTotalMinor: true,
+        displayCurrency: true,
+        originStationId: true,
+        destinationStationId: true,
+        schedule: { select: { originStationId: true, destinationStationId: true } },
+        paymentIntent: { select: { paidAt: true, method: true } },
+      },
+    });
+
+    // Booking.originStationId/destinationStationId are set on every create path (guest and
+    // authenticated booking both pass them from the DTO); the schedule's own endpoints are
+    // only a fallback for the rare legacy row that predates those columns.
+    const stationIds = new Set<string>();
+    for (const b of bookings) {
+      const origin = b.originStationId ?? b.schedule.originStationId;
+      const destination = b.destinationStationId ?? b.schedule.destinationStationId;
+      if (origin) stationIds.add(origin);
+      if (destination) stationIds.add(destination);
+    }
+    const stations = stationIds.size > 0
+      ? await this.prisma.station.findMany({ where: { id: { in: [...stationIds] } }, select: { id: true, name: true } })
+      : [];
+    const stationName = new Map(stations.map((s) => [s.id, s.name]));
+
+    const buckets = new Map<string, FinanceBucket>();
+    const bucketFor = (
+      period: string,
+      originStationId: string,
+      destinationStationId: string,
+      segmentLabel: string,
+      method: string,
+      currency: string,
+    ): FinanceBucket => {
+      const key = `${period}|${originStationId}|${destinationStationId}|${method}|${currency}`;
+      let bucket = buckets.get(key);
+      if (!bucket) {
+        bucket = { period, originStationId, destinationStationId, segmentLabel, method, currency, bookingCount: 0, revenueMinor: 0 };
+        buckets.set(key, bucket);
+      }
+      return bucket;
+    };
+
+    for (const b of bookings) {
+      const pi = b.paymentIntent!;
+      const period = periodKeyFor(pi.paidAt!, granularity);
+      const originStationId = b.originStationId ?? b.schedule.originStationId ?? "UNKNOWN";
+      const destinationStationId = b.destinationStationId ?? b.schedule.destinationStationId ?? "UNKNOWN";
+      const segmentLabel = `${stationName.get(originStationId) ?? "Unknown"} → ${stationName.get(destinationStationId) ?? "Unknown"}`;
+      const currency = (b.displayCurrency as string | null) ?? b.currency;
+      const amountMinor = b.displayTotalMinor ?? b.totalMinor;
+      const bucket = bucketFor(period, originStationId, destinationStationId, segmentLabel, pi.method, currency);
+      bucket.bookingCount += 1;
+      bucket.revenueMinor += amountMinor;
+    }
+
+    const rows = [...buckets.values()].sort((a, b) =>
+      a.period === b.period
+        ? a.segmentLabel.localeCompare(b.segmentLabel) || a.method.localeCompare(b.method) || a.currency.localeCompare(b.currency)
+        : a.period.localeCompare(b.period),
+    );
+
+    const rollUp = (keyOf: (r: FinanceBucket) => string, labelOf: (r: FinanceBucket) => string): FinanceRollupRow[] => {
+      const map = new Map<string, FinanceRollupRow>();
+      for (const r of rows) {
+        const key = keyOf(r);
+        let entry = map.get(key);
+        if (!entry) {
+          entry = { key, label: labelOf(r), currency: r.currency, revenueMinor: 0, bookingCount: 0 };
+          map.set(key, entry);
+        }
+        entry.revenueMinor += r.revenueMinor;
+        entry.bookingCount += r.bookingCount;
+      }
+      return [...map.values()].sort((a, b) => b.revenueMinor - a.revenueMinor);
+    };
+
+    // Currency is folded into every rollup key so amounts in different currencies are never
+    // summed together — see class-level note on why this endpoint doesn't convert to ETB.
+    const totals = rollUp((r) => r.currency, (r) => r.currency);
+
+    return {
+      granularity,
+      dateFrom: query.dateFrom,
+      dateTo: query.dateTo,
+      totals,
+      byPeriod: rollUp((r) => `${r.period}|${r.currency}`, (r) => r.period),
+      bySegment: rollUp((r) => `${r.originStationId}|${r.destinationStationId}|${r.currency}`, (r) => r.segmentLabel),
+      byMethod: rollUp((r) => `${r.method}|${r.currency}`, (r) => r.method),
+      rows,
+    };
+  }
+
+  /** CSV of the finance summary, one row per period + origin/destination segment + payment method + currency. */
+  async exportFinanceSummaryCsv(query: FinanceSummaryQueryDto): Promise<string> {
+    const report = await this.getFinanceSummary(query);
+
+    const headers = ["Period", "Origin → Destination", "Payment Method", "Currency", "Bookings", "Revenue"];
+    const rows = report.rows.map((r) => [
+      r.period,
+      r.segmentLabel,
+      r.method,
+      r.currency,
+      r.bookingCount,
+      (r.revenueMinor / 100).toFixed(2),
+    ]);
+
+    return [headers, ...rows].map((row) => row.map(toCsvCell).join(",")).join("\n");
+  }
+
   async getPaymentDiscrepancyBySchedule(scheduleId: string, params: {
     search?: string;
     seatClass?: string;
diff --git a/apps/edr-passenger-api/src/modules/schedules/routes.service.ts b/apps/edr-passenger-api/src/modules/schedules/routes.service.ts
index 56ff8ddfe..8d72da2a2 100644
--- a/apps/edr-passenger-api/src/modules/schedules/routes.service.ts
+++ b/apps/edr-passenger-api/src/modules/schedules/routes.service.ts
@@ -3,6 +3,26 @@ import { PrismaService } from '../../common/prisma.service';
 import { CreateRouteDto, AddRouteStopDto, UpdateRouteDto, SetRouteCoachTemplateDto } from './routes.dto';
 import { DeleteOperationException } from '../../common/exceptions/delete-operation.exception';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { snapshot } from '../../common/audit-snapshot';
+
+const ROUTE_AUDIT_FIELDS = [
+  'code',
+  'name',
+  'description',
+  'active',
+  'effectiveFrom',
+  'effectiveUntil',
+  'checkinMinutesBefore',
+] as const;
+const ROUTE_STOP_AUDIT_FIELDS = [
+  'routeId',
+  'stationId',
+  'sequence',
+  'distanceKm',
+  'checkinMinutesBefore',
+  'travelMinutesToStop',
+] as const;
 import { parseEthiopianTime } from '../../common/utils/timezone.utils';
 import { computePlannedStopTimes } from '../../common/utils/schedule-times.utils';
 
@@ -75,7 +95,12 @@ export class RoutesService {
       },
       include: { stops: { include: { route: false }, orderBy: { sequence: 'asc' } } },
     });
-    await this.auditService.log({ action: 'CREATE', entityType: 'Route', entityId: route.id, newData: { code: route.code, name: route.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Route,
+      entityId: route.id,
+      newData: snapshot(route, ROUTE_AUDIT_FIELDS),
+    });
     return route;
   }
 
@@ -165,11 +190,23 @@ export class RoutesService {
       }
     }
 
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Route', entityId: id, newData: { name: dto.name, active: dto.active } });
-    return this.prisma.route.findUnique({
+    const updated = await this.prisma.route.findUnique({
       where: { id },
       include: { stops: { orderBy: { sequence: 'asc' } } },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Route,
+      entityId: id,
+      oldData: snapshot(route, ROUTE_AUDIT_FIELDS),
+      newData: {
+        ...snapshot(updated, ROUTE_AUDIT_FIELDS),
+        // Stop edits arrive as a full replacement, so record the resulting shape rather than
+        // every row — the RouteStop rows themselves are audited on the dedicated endpoints.
+        ...(dto.stops && dto.stops.length >= 2 ? { stopsReplaced: dto.stops.length } : {}),
+      },
+    });
+    return updated;
   }
 
   async deleteRoute(id: string, cascade = false) {
@@ -254,7 +291,13 @@ export class RoutesService {
     }
 
     await this.prisma.route.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'Route', entityId: id, oldData: { code: route.code, name: route.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Route,
+      entityId: id,
+      oldData: snapshot(route, ROUTE_AUDIT_FIELDS),
+      newData: { cascade },
+    });
     return { deleted: true, id };
   }
 
@@ -276,7 +319,7 @@ export class RoutesService {
     const otherStops = await this.prisma.routeStop.findMany({ where: { routeId } });
     this.validateStopDistances([...otherStops, { sequence: dto.sequence, stationId: dto.stationId, distanceKm: dto.distanceKm }]);
 
-    return this.prisma.routeStop.create({
+    const stop = await this.prisma.routeStop.create({
       data: {
         routeId,
         stationId: dto.stationId,
@@ -286,6 +329,13 @@ export class RoutesService {
         travelMinutesToStop: dto.travelMinutesToStop ?? null,
       },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.RouteStop,
+      entityId: stop.id,
+      newData: { ...snapshot(stop, ROUTE_STOP_AUDIT_FIELDS), stationName: station.name },
+    });
+    return stop;
   }
 
   async removeStop(routeId: string, sequence: number) {
@@ -298,6 +348,12 @@ export class RoutesService {
     if (total <= 2) throw new BadRequestException('A route must retain at least 2 stops');
 
     await this.prisma.routeStop.delete({ where: { routeId_sequence: { routeId, sequence } } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.RouteStop,
+      entityId: stop.id,
+      oldData: snapshot(stop, ROUTE_STOP_AUDIT_FIELDS),
+    });
     return { deleted: true, sequence };
   }
 
@@ -351,18 +407,48 @@ export class RoutesService {
     const positions = dto.coaches.map(c => c.positionNumber);
     if (new Set(positions).size !== positions.length) throw new BadRequestException('Duplicate positionNumber values');
 
+    const previous = await this.prisma.routeCoachTemplate.findMany({
+      where: { routeId },
+      orderBy: { positionNumber: 'asc' },
+      select: { coachId: true, positionNumber: true },
+    });
+
     await this.prisma.routeCoachTemplate.deleteMany({ where: { routeId } });
     await this.prisma.routeCoachTemplate.createMany({
       data: dto.coaches.map(c => ({ routeId, coachId: c.coachId, positionNumber: c.positionNumber })),
     });
 
+    // The template is replaced wholesale, so the audit row carries both compositions rather
+    // than one row per coach — a reader wants "what does this route run now vs. before".
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.ASSIGN,
+      entityType: AUDIT_ENTITIES.RouteCoachTemplate,
+      entityId: routeId,
+      oldData: { routeCode: route.code, coaches: previous },
+      newData: {
+        routeCode: route.code,
+        coaches: dto.coaches.map(c => ({ coachId: c.coachId, positionNumber: c.positionNumber })),
+      },
+    });
+
     return this.getRouteCoachTemplate(routeId);
   }
 
   async removeRouteCoachTemplate(routeId: string) {
     const route = await this.prisma.route.findUnique({ where: { id: routeId } });
     if (!route) throw new NotFoundException('Route not found');
+    const previous = await this.prisma.routeCoachTemplate.findMany({
+      where: { routeId },
+      orderBy: { positionNumber: 'asc' },
+      select: { coachId: true, positionNumber: true },
+    });
     await this.prisma.routeCoachTemplate.deleteMany({ where: { routeId } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UNASSIGN,
+      entityType: AUDIT_ENTITIES.RouteCoachTemplate,
+      entityId: routeId,
+      oldData: { routeCode: route.code, coaches: previous },
+    });
     return { deleted: true, routeId };
   }
 
diff --git a/apps/edr-passenger-api/src/modules/schedules/schedules-audit.spec.ts b/apps/edr-passenger-api/src/modules/schedules/schedules-audit.spec.ts
new file mode 100644
index 000000000..0bd129dbc
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/schedules/schedules-audit.spec.ts
@@ -0,0 +1,199 @@
+import { SchedulesService } from './schedules.service';
+
+/**
+ * Master-data coverage, using schedules as the representative entity.
+ *
+ * `updateScheduleStatus` was a one-line Prisma update with no audit call at all, so "who
+ * cancelled this schedule" had no answer. Fare-rule edits were similar: the previous price was
+ * read and then discarded, leaving an UPDATE row that didn't say what changed.
+ */
+describe('SchedulesService — audit', () => {
+  const SCHEDULE_ID = 'sched-1';
+
+  let prisma: Record<string, any>;
+  let audit: { log: jest.Mock };
+  let service: SchedulesService;
+
+  const scheduleRow = (over: Record<string, any> = {}) => ({
+    id: SCHEDULE_ID,
+    trainId: 'train-1',
+    routeId: 'route-1',
+    originStationId: 'station-a',
+    destinationStationId: 'station-b',
+    departureAt: new Date('2026-09-01T06:00:00.000Z'),
+    arrivalAt: new Date('2026-09-01T18:00:00.000Z'),
+    durationMinutes: 720,
+    stopsCount: 3,
+    status: 'SCHEDULED',
+    ...over,
+  });
+
+  const build = (over: Record<string, any> = {}) => {
+    const schedule = scheduleRow(over);
+    prisma = {
+      trainSchedule: {
+        findUnique: jest.fn().mockResolvedValue(schedule),
+        update: jest.fn(async ({ data }: any) => ({ ...schedule, ...data })),
+      },
+      fareRule: {
+        findUnique: jest.fn(),
+        create: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn().mockResolvedValue({}),
+      },
+      routeFareRule: {
+        findUnique: jest.fn(),
+        update: jest.fn(),
+        delete: jest.fn().mockResolvedValue({}),
+      },
+      segmentFareRule: { findUnique: jest.fn(), update: jest.fn(), delete: jest.fn() },
+    };
+    audit = { log: jest.fn().mockResolvedValue(undefined) };
+
+    service = new SchedulesService(
+      prisma as any,
+      {} as any, // routesService
+      {} as any, // fareEngine
+      audit as any,
+      { updateLiveStatus: jest.fn() } as any, // liveService
+    );
+    return schedule;
+  };
+
+  const rows = () => audit.log.mock.calls.map((c) => c[0]);
+
+  describe('updateScheduleStatus', () => {
+    it('records one STATUS_CHANGE with the status it moved from and to', async () => {
+      build();
+      await service.updateScheduleStatus(SCHEDULE_ID, { status: 'BOARDING' } as any);
+
+      expect(rows()).toHaveLength(1);
+      expect(rows()[0]).toMatchObject({
+        action: 'STATUS_CHANGE',
+        entityType: 'Schedule',
+        entityId: SCHEDULE_ID,
+        oldData: { status: 'SCHEDULED' },
+      });
+      expect(rows()[0].newData.status).toBe('BOARDING');
+    });
+
+    it('uses CANCEL for a cancellation so it is not lost among ordinary updates', async () => {
+      build();
+      await service.updateScheduleStatus(SCHEDULE_ID, { status: 'CANCELLED' } as any);
+
+      expect(rows()[0]).toMatchObject({
+        action: 'CANCEL',
+        entityType: 'Schedule',
+        entityId: SCHEDULE_ID,
+        oldData: { status: 'SCHEDULED' },
+      });
+    });
+
+    it('records nothing when the schedule does not exist', async () => {
+      build();
+      prisma.trainSchedule.findUnique.mockResolvedValue(null);
+
+      await expect(
+        service.updateScheduleStatus(SCHEDULE_ID, { status: 'CANCELLED' } as any),
+      ).rejects.toThrow();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+
+    it('records nothing when the write itself fails', async () => {
+      build();
+      prisma.trainSchedule.update.mockRejectedValue(new Error('db down'));
+
+      await expect(
+        service.updateScheduleStatus(SCHEDULE_ID, { status: 'CANCELLED' } as any),
+      ).rejects.toThrow();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+
+    it('leaves the actor to AuditService', async () => {
+      build();
+      await service.updateScheduleStatus(SCHEDULE_ID, { status: 'DELAYED' } as any);
+      expect(rows()[0].userId).toBeUndefined();
+    });
+  });
+
+  describe('fare rules', () => {
+    it('records the previous price on an update, not just the new one', async () => {
+      build();
+      const before = {
+        id: 'fr-1',
+        tripId: SCHEDULE_ID,
+        seatClassId: 'sc-1',
+        baseFareMinor: 50000,
+        currency: 'ETB',
+        nationality: null,
+        validFrom: new Date('2026-01-01'),
+        validUntil: null,
+      };
+      prisma.fareRule.findUnique.mockResolvedValue(before);
+      prisma.fareRule.update.mockResolvedValue({ ...before, baseFareMinor: 65000 });
+
+      await service.updateFareRule('fr-1', { baseFareMinor: 65000 } as any);
+
+      const row = rows()[0];
+      expect(row).toMatchObject({ action: 'UPDATE', entityType: 'FareRule', entityId: 'fr-1' });
+      expect(row.oldData).toMatchObject({ baseFareMinor: 50000 });
+      expect(row.newData).toMatchObject({ baseFareMinor: 65000 });
+    });
+
+    it('records what a deleted fare rule was worth', async () => {
+      build();
+      prisma.fareRule.findUnique.mockResolvedValue({
+        id: 'fr-1',
+        tripId: SCHEDULE_ID,
+        seatClassId: 'sc-1',
+        baseFareMinor: 50000,
+        currency: 'ETB',
+      });
+
+      await service.deleteFareRule('fr-1');
+
+      expect(rows()[0]).toMatchObject({ action: 'DELETE', entityType: 'FareRule', entityId: 'fr-1' });
+      expect(rows()[0].oldData).toMatchObject({ baseFareMinor: 50000 });
+    });
+
+    it('records a route fare-rule price change that previously left no trail', async () => {
+      build();
+      const before = {
+        id: 'rfr-1',
+        routeId: 'route-1',
+        seatClassId: 'sc-1',
+        passengerCategory: 'ADULT',
+        baseFareMinor: 40000,
+        surchargeMinor: 0,
+        validFrom: new Date('2026-01-01'),
+        validUntil: null,
+      };
+      prisma.routeFareRule.findUnique.mockResolvedValue(before);
+      prisma.routeFareRule.update.mockResolvedValue({ ...before, baseFareMinor: 45000 });
+
+      await service.updateRouteFareRule('rfr-1', { baseFareMinor: 45000 });
+
+      expect(rows()[0]).toMatchObject({ action: 'UPDATE', entityType: 'RouteFareRule' });
+      expect(rows()[0].oldData).toMatchObject({ baseFareMinor: 40000 });
+      expect(rows()[0].newData).toMatchObject({ baseFareMinor: 45000 });
+    });
+  });
+
+  describe('reads', () => {
+    it('writes nothing when listing schedules', async () => {
+      build();
+      prisma.trainSchedule.findMany = jest.fn().mockResolvedValue([]);
+
+      await service.listSchedules({} as any);
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+
+    it('writes nothing when listing fare rules', async () => {
+      build();
+      prisma.fareRule.findMany = jest.fn().mockResolvedValue([]);
+
+      await service.getFareRules(SCHEDULE_ID);
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+});
diff --git a/apps/edr-passenger-api/src/modules/schedules/schedules.service.ts b/apps/edr-passenger-api/src/modules/schedules/schedules.service.ts
index 7680d8f9c..ab795598b 100644
--- a/apps/edr-passenger-api/src/modules/schedules/schedules.service.ts
+++ b/apps/edr-passenger-api/src/modules/schedules/schedules.service.ts
@@ -6,9 +6,59 @@ import { CreateScheduleDto, UpdateScheduleDto, CreateFareRuleDto, UpdateSchedule
 import { DeleteOperationException } from '../../common/exceptions/delete-operation.exception';
 import { parseEthiopianTime, startOfDayEAT, startOfNextDayEAT } from '../../common/utils/timezone.utils';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { snapshot } from '../../common/audit-snapshot';
 import { LiveService } from '../live/live.service';
 import { computePlannedStopTimes } from '../../common/utils/schedule-times.utils';
 
+const SCHEDULE_AUDIT_FIELDS = [
+  'trainId',
+  'routeId',
+  'originStationId',
+  'destinationStationId',
+  'departureAt',
+  'arrivalAt',
+  'durationMinutes',
+  'stopsCount',
+  'status',
+] as const;
+const FARE_RULE_AUDIT_FIELDS = [
+  'tripId',
+  'seatClassId',
+  'baseFareMinor',
+  'currency',
+  'nationality',
+  'validFrom',
+  'validUntil',
+] as const;
+const SEGMENT_FARE_AUDIT_FIELDS = [
+  'routeId',
+  'seatClassId',
+  'originStopSequence',
+  'destinationStopSequence',
+  'baseFareMinor',
+  'currency',
+  'validFrom',
+  'validUntil',
+] as const;
+const ROUTE_FARE_AUDIT_FIELDS = [
+  'routeId',
+  'seatClassId',
+  'passengerCategory',
+  'baseFareMinor',
+  'surchargeMinor',
+  'validFrom',
+  'validUntil',
+] as const;
+const STOP_TIME_AUDIT_FIELDS = [
+  'scheduleId',
+  'stationId',
+  'sequence',
+  'plannedArrivalAt',
+  'plannedDepartureAt',
+  'status',
+] as const;
+
 @Injectable()
 export class SchedulesService {
   private readonly logger = new Logger(SchedulesService.name);
@@ -102,6 +152,24 @@ export class SchedulesService {
       currentDate = new Date(currentDate.getTime() + dto.repeatEveryDays * 24 * 60 * 60 * 1000);
     }
 
+    // One row for the whole sweep, not one per schedule — the operator performed a single
+    // action and the created ids are the interesting part.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.BULK_CREATE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: dto.routeId,
+      newData: {
+        routeId: dto.routeId,
+        trainId: dto.trainId,
+        startDateTime: dto.startDateTime,
+        forNextDays: dto.forNextDays,
+        repeatEveryDays: dto.repeatEveryDays,
+        schedulesCreated: scheduleCount,
+        scheduleIds,
+        errorCount: errors.length,
+      },
+    });
+
     return { schedulesCreated: scheduleCount, errors, scheduleIds };
   }
 
@@ -234,7 +302,12 @@ export class SchedulesService {
     }
 
     const result = await this.getSchedule(schedule.id);
-    await this.auditService.log({ action: 'CREATE', entityType: 'Schedule', entityId: schedule.id, newData: { trainId: dto.trainId, routeId: dto.routeId, departureAt: dep } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: schedule.id,
+      newData: snapshot(schedule, SCHEDULE_AUDIT_FIELDS),
+    });
     return result;
   }
 
@@ -352,12 +425,37 @@ export class SchedulesService {
     await this.routesService.applyRouteToSchedule(dto.routeId, id, plannedTimesMap);
 
     const result = await this.getSchedule(id);
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Schedule', entityId: id, newData: { trainId: dto.trainId, departureAt: dep } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: id,
+      oldData: snapshot(schedule, SCHEDULE_AUDIT_FIELDS),
+      newData: snapshot(result as any, SCHEDULE_AUDIT_FIELDS),
+    });
     return result;
   }
 
   async updateScheduleStatus(id: string, dto: UpdateScheduleStatusDto) {
-    return this.prisma.trainSchedule.update({ where: { id }, data: { status: dto.status } });
+    const schedule = await this.prisma.trainSchedule.findUnique({ where: { id } });
+    if (!schedule) throw new NotFoundException('Schedule not found');
+
+    const updated = await this.prisma.trainSchedule.update({
+      where: { id },
+      data: { status: dto.status },
+    });
+
+    // CANCELLED is the one transition an operator is asked to justify after the fact, so it
+    // gets its own verb; everything else is a plain status move.
+    await this.auditService.log({
+      action:
+        dto.status === 'CANCELLED' ? AUDIT_ACTIONS.CANCEL : AUDIT_ACTIONS.STATUS_CHANGE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: id,
+      oldData: { status: schedule.status },
+      newData: { status: updated.status, departureAt: updated.departureAt.toISOString() },
+    });
+
+    return updated;
   }
 
   async deleteSchedule(id: string, cascade = false) {
@@ -438,7 +536,13 @@ export class SchedulesService {
       await this.prisma.travelPackage.deleteMany({ where: { id: { in: packageIds } } });
     }
     await this.prisma.trainSchedule.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'Schedule', entityId: id });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: id,
+      oldData: snapshot(schedule, SCHEDULE_AUDIT_FIELDS),
+      newData: { cascade, bookingsAffected: (schedule as any)._count?.bookings ?? 0 },
+    });
     return { deleted: true, id };
   }
 
@@ -456,7 +560,7 @@ export class SchedulesService {
     });
     if (!stop) throw new NotFoundException(`Stop at sequence ${sequence} not found on schedule`);
 
-    return this.prisma.tripStopTime.update({
+    const updated = await this.prisma.tripStopTime.update({
       where: { scheduleId_sequence: { scheduleId, sequence } },
       data: {
         plannedArrivalAt: dto.plannedArrivalAt ? parseEthiopianTime(dto.plannedArrivalAt) : undefined,
@@ -465,6 +569,14 @@ export class SchedulesService {
       },
       include: { station: true },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: scheduleId,
+      oldData: snapshot(stop, STOP_TIME_AUDIT_FIELDS),
+      newData: snapshot(updated, STOP_TIME_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   /**
@@ -522,10 +634,19 @@ export class SchedulesService {
     await this.liveService.updateLiveStatus(scheduleId, { delayMinutes: accumulatedDelayMinutes });
 
     await this.auditService.log({
-      action: 'UPDATE',
-      entityType: 'Schedule',
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Schedule,
       entityId: scheduleId,
-      newData: { delayMinutes: dto.delayMinutes, fromSequence: dto.fromSequence, accumulatedDelayMinutes },
+      oldData: {
+        delayMinutes: currentLive?.delayMinutes ?? 0,
+        departureAt: schedule.departureAt.toISOString(),
+      },
+      newData: {
+        delayMinutes: dto.delayMinutes,
+        fromSequence: dto.fromSequence,
+        accumulatedDelayMinutes,
+        stopsShifted: stopsToShift.length,
+      },
     });
 
     return this.getSchedule(scheduleId);
@@ -547,7 +668,12 @@ export class SchedulesService {
     const validFrom = dto.validFrom ? parseEthiopianTime(dto.validFrom) : now;
     const validUntil = dto.validUntil ? parseEthiopianTime(dto.validUntil) : null;
 
-    return this.prisma.$transaction(async (tx) => {
+    const superseded = await this.prisma.fareRule.findFirst({
+      where: { tripId: scheduleId, seatClassId, validUntil: null },
+      orderBy: { validFrom: 'desc' },
+    });
+
+    const created = await this.prisma.$transaction(async (tx) => {
       await tx.fareRule.updateMany({
         where: { tripId: scheduleId, seatClassId, validUntil: null },
         data: { validUntil: now },
@@ -557,11 +683,27 @@ export class SchedulesService {
         include: { seatClass: true },
       });
     });
+
+    // A schedule fare is versioned rather than edited, so the audit row pairs the rule that was
+    // closed off with the one that replaced it — otherwise the price change is invisible.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.ScheduleFare,
+      entityId: created.id,
+      oldData: snapshot(superseded, FARE_RULE_AUDIT_FIELDS),
+      newData: {
+        ...snapshot(created, FARE_RULE_AUDIT_FIELDS),
+        scheduleId,
+        seatClassName: seatClass.name,
+      },
+    });
+
+    return created;
   }
 
-  createFareRule(dto: CreateFareRuleDto) {
+  async createFareRule(dto: CreateFareRuleDto) {
     const { validFrom, validUntil, scheduleId, nationality, passengerCategory, ...rest } = dto;
-    const result = this.prisma.fareRule.create({
+    const rule = await this.prisma.fareRule.create({
       data: {
         ...rest,
         tripId: scheduleId,
@@ -571,8 +713,15 @@ export class SchedulesService {
       },
       include: { seatClass: true },
     });
-    result.then(r => this.auditService.log({ action: 'CREATE', entityType: 'FareRule', entityId: r.id, newData: { seatClassId: r.seatClassId, baseFareMinor: r.baseFareMinor } }));
-    return result;
+    // Awaited, not a floating .then(): an unhandled rejection there could outlive the response,
+    // and the row could land after the caller had already moved on.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.FareRule,
+      entityId: rule.id,
+      newData: snapshot(rule, FARE_RULE_AUDIT_FIELDS),
+    });
+    return rule;
   }
 
   async updateFareRule(id: string, dto: Partial<CreateFareRuleDto>) {
@@ -580,7 +729,7 @@ export class SchedulesService {
     if (!existing) throw new NotFoundException('Fare rule not found');
 
     const { validFrom, validUntil, scheduleId, nationality, passengerCategory, ...rest } = dto;
-    return this.prisma.fareRule.update({
+    const updated = await this.prisma.fareRule.update({
       where: { id },
       data: {
         ...rest,
@@ -591,19 +740,32 @@ export class SchedulesService {
       },
       include: { seatClass: true },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.FareRule,
+      entityId: id,
+      oldData: snapshot(existing, FARE_RULE_AUDIT_FIELDS),
+      newData: snapshot(updated, FARE_RULE_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   async deleteFareRule(id: string) {
     const existing = await this.prisma.fareRule.findUnique({ where: { id } });
     if (!existing) throw new NotFoundException('Fare rule not found');
     await this.prisma.fareRule.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'FareRule', entityId: id });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.FareRule,
+      entityId: id,
+      oldData: snapshot(existing, FARE_RULE_AUDIT_FIELDS),
+    });
     return { deleted: true, id };
   }
 
-  createSegmentFareRule(dto: any) {
+  async createSegmentFareRule(dto: any) {
     const { validFrom, validUntil, passengerCategory, ...rest } = dto;
-    return this.prisma.segmentFareRule.create({
+    const rule = await this.prisma.segmentFareRule.create({
       data: {
         ...rest,
         validFrom: parseEthiopianTime(validFrom),
@@ -611,6 +773,13 @@ export class SchedulesService {
       },
       include: { seatClass: true, route: true },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.SegmentFareRule,
+      entityId: rule.id,
+      newData: snapshot(rule, SEGMENT_FARE_AUDIT_FIELDS),
+    });
+    return rule;
   }
 
   getSegmentFares(routeId: string) {
@@ -621,13 +790,25 @@ export class SchedulesService {
     });
   }
 
-  deleteSegmentFareRule(id: string) {
-    return this.prisma.segmentFareRule.delete({ where: { id } });
+  async deleteSegmentFareRule(id: string) {
+    const existing = await this.prisma.segmentFareRule.findUnique({ where: { id } });
+    if (!existing) throw new NotFoundException('Segment fare rule not found');
+    const deleted = await this.prisma.segmentFareRule.delete({ where: { id } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.SegmentFareRule,
+      entityId: id,
+      oldData: snapshot(existing, SEGMENT_FARE_AUDIT_FIELDS),
+    });
+    return deleted;
   }
 
-  updateSegmentFareRule(id: string, dto: any) {
+  async updateSegmentFareRule(id: string, dto: any) {
+    const existing = await this.prisma.segmentFareRule.findUnique({ where: { id } });
+    if (!existing) throw new NotFoundException('Segment fare rule not found');
+
     const { validFrom, validUntil, passengerCategory, ...rest } = dto;
-    return this.prisma.segmentFareRule.update({
+    const updated = await this.prisma.segmentFareRule.update({
       where: { id },
       data: {
         ...rest,
@@ -636,6 +817,14 @@ export class SchedulesService {
       },
       include: { seatClass: true, route: true },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.SegmentFareRule,
+      entityId: id,
+      oldData: snapshot(existing, SEGMENT_FARE_AUDIT_FIELDS),
+      newData: snapshot(updated, SEGMENT_FARE_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   async getFareRules(scheduleId?: string) {
@@ -700,6 +889,15 @@ export class SchedulesService {
       }
     }
 
+    // One row for the sweep: the operator pressed sync once, and every fare it rewrote is
+    // reconstructable from the FareRule versions it created.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.SYNC,
+      entityType: AUDIT_ENTITIES.ScheduleFare,
+      entityId: scheduleId,
+      newData: { scheduleId, synced, errorCount: errors.length },
+    });
+
     return { synced, errors };
   }
 
@@ -718,6 +916,16 @@ export class SchedulesService {
     );
     const plannedTimesMap = Object.fromEntries(plannedTimes.map(t => [t.sequence, t]));
     await this.routesService.applyRouteToSchedule(schedule.routeId, scheduleId, plannedTimesMap);
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.BULK_UPDATE,
+      entityType: AUDIT_ENTITIES.Schedule,
+      entityId: scheduleId,
+      newData: {
+        recalculatedStopTimes: true,
+        routeId: schedule.routeId,
+        stopCount: plannedTimes.length,
+      },
+    });
     return { recalculated: true, scheduleId, stopCount: plannedTimes.length };
   }
 
@@ -731,6 +939,12 @@ export class SchedulesService {
     const inactiveCoach = existingCoaches.find(c => c.status !== 'ACTIVE');
     if (inactiveCoach) throw new BadRequestException(`Coach ${inactiveCoach.number} is not active`);
 
+    const previous = await this.prisma.coachAssignment.findMany({
+      where: { scheduleId },
+      orderBy: { positionNumber: 'asc' },
+      select: { coachId: true, positionNumber: true },
+    });
+
     await this.prisma.coachAssignment.deleteMany({ where: { scheduleId } });
 
     const data = coaches.map((c) => ({
@@ -741,6 +955,20 @@ export class SchedulesService {
     }));
 
     await this.prisma.coachAssignment.createMany({ data });
+
+    // Assignment is a wholesale replacement, so both compositions go on one row rather than a
+    // delete row per coach followed by a create row per coach.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.ASSIGN,
+      entityType: AUDIT_ENTITIES.CoachAssignment,
+      entityId: scheduleId,
+      oldData: { scheduleId, coaches: previous },
+      newData: {
+        scheduleId,
+        coaches: coaches.map((c) => ({ coachId: c.coachId, positionNumber: c.positionNumber })),
+      },
+    });
+
     return { message: 'Coaches assigned successfully', count: coaches.length };
   }
 
@@ -795,19 +1023,55 @@ export class SchedulesService {
 
     if (dto.coaches !== undefined) {
       if (dto.coaches.length > 0) {
+        // Logs its own ASSIGN row; this method only audits the schedule's own fields, so the
+        // two rows describe two facts rather than double-reporting one.
         await this.assignCoaches(id, dto.coaches);
       } else {
+        const cleared = await this.prisma.coachAssignment.findMany({
+          where: { scheduleId: id },
+          select: { coachId: true, positionNumber: true },
+        });
         await this.prisma.coachAssignment.deleteMany({ where: { scheduleId: id } });
+        await this.auditService.log({
+          action: AUDIT_ACTIONS.UNASSIGN,
+          entityType: AUDIT_ENTITIES.CoachAssignment,
+          entityId: id,
+          oldData: { scheduleId: id, coaches: cleared },
+          newData: { scheduleId: id, coaches: [] },
+        });
       }
     }
 
-    return this.getSchedule(id);
+    const result = await this.getSchedule(id);
+
+    if (Object.keys(updateData).length > 0) {
+      const statusChanged = dto.status !== undefined && dto.status !== schedule.status;
+      await this.auditService.log({
+        action: statusChanged
+          ? dto.status === 'CANCELLED'
+            ? AUDIT_ACTIONS.CANCEL
+            : AUDIT_ACTIONS.STATUS_CHANGE
+          : AUDIT_ACTIONS.UPDATE,
+        entityType: AUDIT_ENTITIES.Schedule,
+        entityId: id,
+        oldData: snapshot(schedule, SCHEDULE_AUDIT_FIELDS),
+        newData: snapshot(result as any, SCHEDULE_AUDIT_FIELDS),
+      });
+    }
+
+    return result;
   }
 
   async removeCoachAssignment(scheduleId: string, coachId: string) {
     const assignment = await this.prisma.coachAssignment.findFirst({ where: { scheduleId, coachId } });
     if (!assignment) throw new NotFoundException('Coach assignment not found');
     await this.prisma.coachAssignment.delete({ where: { id: assignment.id } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UNASSIGN,
+      entityType: AUDIT_ENTITIES.CoachAssignment,
+      entityId: assignment.id,
+      oldData: { scheduleId, coachId, positionNumber: assignment.positionNumber },
+    });
     return { message: 'Coach assignment removed' };
   }
 
@@ -846,14 +1110,23 @@ export class SchedulesService {
       },
       include: { seatClass: true, route: true },
     });
-    await this.auditService.log({ action: 'CREATE', entityType: 'RouteFareRule', entityId: rule.id, newData: { routeId: dto.routeId, seatClassId: dto.seatClassId, baseFareMinor: dto.baseFareMinor } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.RouteFareRule,
+      entityId: rule.id,
+      newData: {
+        ...snapshot(rule, ROUTE_FARE_AUDIT_FIELDS),
+        routeCode: route.code,
+        seatClassName: seatClass.name,
+      },
+    });
     return rule;
   }
 
   async updateRouteFareRule(id: string, dto: { baseFareMinor?: number; surchargeMinor?: number; validFrom?: string; validUntil?: string }) {
     const rule = await this.prisma.routeFareRule.findUnique({ where: { id } });
     if (!rule) throw new NotFoundException('Route fare rule not found');
-    return this.prisma.routeFareRule.update({
+    const updated = await this.prisma.routeFareRule.update({
       where: { id },
       data: {
         ...(dto.baseFareMinor !== undefined && { baseFareMinor: dto.baseFareMinor }),
@@ -863,13 +1136,26 @@ export class SchedulesService {
       },
       include: { seatClass: true, route: true },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.RouteFareRule,
+      entityId: id,
+      oldData: snapshot(rule, ROUTE_FARE_AUDIT_FIELDS),
+      newData: snapshot(updated, ROUTE_FARE_AUDIT_FIELDS),
+    });
+    return updated;
   }
 
   async deleteRouteFareRule(id: string) {
     const rule = await this.prisma.routeFareRule.findUnique({ where: { id } });
     if (!rule) throw new NotFoundException('Route fare rule not found');
     await this.prisma.routeFareRule.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'RouteFareRule', entityId: id });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.RouteFareRule,
+      entityId: id,
+      oldData: snapshot(rule, ROUTE_FARE_AUDIT_FIELDS),
+    });
     return { deleted: true, id };
   }
 }
diff --git a/apps/edr-passenger-api/src/modules/seat-classes/seat-classes.service.ts b/apps/edr-passenger-api/src/modules/seat-classes/seat-classes.service.ts
index f33ecac64..9f103600f 100644
--- a/apps/edr-passenger-api/src/modules/seat-classes/seat-classes.service.ts
+++ b/apps/edr-passenger-api/src/modules/seat-classes/seat-classes.service.ts
@@ -2,6 +2,22 @@ import { Injectable, NotFoundException, ConflictException } from '@nestjs/common
 import { PrismaService } from '../../common/prisma.service';
 import { DeleteOperationException } from '../../common/exceptions/delete-operation.exception';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { snapshot } from '../../common/audit-snapshot';
+
+/**
+ * Seat classes carry the per-km tariff rate, so `baseFareMinor` is the field an auditor is
+ * actually chasing — logging only the name made a price change indistinguishable from a rename.
+ */
+const SEAT_CLASS_AUDIT_FIELDS = [
+  'coachTypeId',
+  'name',
+  'description',
+  'baseFareMinor',
+  'premiumMinor',
+  'insuranceFeeMinor',
+  'isActive',
+] as const;
 
 @Injectable()
 export class SeatClassesService {
@@ -30,7 +46,13 @@ export class SeatClassesService {
       ...(basePrice !== undefined && { baseFareMinor: basePrice }),
     };
     const updated = await this.prisma.seatClass.update({ where: { id }, data });
-    await this.auditService.log({ action: 'UPDATE', entityType: 'SeatClass', entityId: id, newData: { name: updated.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.SeatClass,
+      entityId: id,
+      oldData: snapshot(sc, SEAT_CLASS_AUDIT_FIELDS),
+      newData: snapshot(updated, SEAT_CLASS_AUDIT_FIELDS),
+    });
     return updated;
   }
 
@@ -42,7 +64,12 @@ export class SeatClassesService {
         ...(basePrice !== undefined && { baseFareMinor: basePrice }),
       };
       const sc = await this.prisma.seatClass.create({ data });
-      await this.auditService.log({ action: 'CREATE', entityType: 'SeatClass', entityId: sc.id, newData: { name: sc.name } });
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.CREATE,
+        entityType: AUDIT_ENTITIES.SeatClass,
+        entityId: sc.id,
+        newData: snapshot(sc, SEAT_CLASS_AUDIT_FIELDS),
+      });
       return sc;
     } catch (e: any) {
       if (e.code === 'P2002') throw new ConflictException(`Seat class "${dto.name}" already exists`);
@@ -76,7 +103,13 @@ export class SeatClassesService {
     }
 
     const deleted = await this.prisma.seatClass.delete({ where: { id } });
-    await this.auditService.log({ action: 'DELETE', entityType: 'SeatClass', entityId: id, oldData: { name: sc.name } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.SeatClass,
+      entityId: id,
+      oldData: snapshot(sc, SEAT_CLASS_AUDIT_FIELDS),
+      newData: { cascade, fareRulesDeleted: cascade ? totalFareRules : 0 },
+    });
     return deleted;
   }
 }
diff --git a/apps/edr-passenger-api/src/modules/seats/seats.service.spec.ts b/apps/edr-passenger-api/src/modules/seats/seats.service.spec.ts
index 2c4215dc8..e80966d6a 100644
--- a/apps/edr-passenger-api/src/modules/seats/seats.service.spec.ts
+++ b/apps/edr-passenger-api/src/modules/seats/seats.service.spec.ts
@@ -2,16 +2,47 @@ import { Test, TestingModule } from '@nestjs/testing';
 import { SeatsService } from './seats.service';
 import { PrismaService } from '../../common/prisma.service';
 import { ConflictException } from '@nestjs/common';
+import { SegmentsService } from '../segments/segments.service';
+import { SystemConfigService } from '../system-config/system-config.service';
+import { AuditService } from '../../common/audit.service';
+import { SmsClientService } from '../notifications/sms-client.service';
+import { JourneyDirection } from './seats.dto';
 
 describe('SeatsService - Auto Assign', () => {
   let service: SeatsService;
   let prisma: PrismaService;
+  let segmentsService: SegmentsService;
 
   const mockPrisma = {
     seat: {
       findMany: jest.fn(),
       updateMany: jest.fn(),
     },
+    tripStopTime: {
+      findMany: jest.fn(),
+    },
+    trainSchedule: {
+      findUnique: jest.fn(),
+    },
+    seatBlock: {
+      findMany: jest.fn(),
+    },
+  };
+
+  const mockSegmentsService = {
+    getSeatAvailabilityMap: jest.fn(),
+  };
+
+  const mockSystemConfigService = {
+    getNumber: jest.fn().mockResolvedValue(30),
+  };
+
+  const mockAuditService = {
+    log: jest.fn(),
+  };
+
+  const mockSmsClientService = {
+    send: jest.fn(),
   };
 
   beforeEach(async () => {
@@ -19,12 +50,67 @@ describe('SeatsService - Auto Assign', () => {
       providers: [
         SeatsService,
         { provide: PrismaService, useValue: mockPrisma },
+        { provide: SegmentsService, useValue: mockSegmentsService },
+        { provide: SystemConfigService, useValue: mockSystemConfigService },
+        { provide: AuditService, useValue: mockAuditService },
+        { provide: SmsClientService, useValue: mockSmsClientService },
       ],
     }).compile();
 
     service = module.get<SeatsService>(SeatsService);
     prisma = module.get<PrismaService>(PrismaService);
+    segmentsService = module.get<SegmentsService>(SegmentsService);
     jest.clearAllMocks();
+
+    mockPrisma.trainSchedule.findUnique.mockResolvedValue({
+      originStationId: 'origin-station',
+      destinationStationId: 'destination-station',
+    });
+    mockPrisma.tripStopTime.findMany.mockResolvedValue([
+      { stationId: 'origin-station', sequence: 0 },
+      { stationId: 'destination-station', sequence: 1 },
+    ]);
+    mockPrisma.seatBlock.findMany.mockResolvedValue([]);
+    mockSegmentsService.getSeatAvailabilityMap.mockResolvedValue(new Map());
+  });
+
+  describe('assertNoRouteSeatConflict', () => {
+    it('rejects overlapping origin-destination seat reuse on the same schedule', async () => {
+      mockPrisma.tripStopTime.findMany.mockResolvedValue([
+        { stationId: 'seb', sequence: 1 },
+        { stationId: 'ada', sequence: 2 },
+        { stationId: 'dd', sequence: 3 },
+      ]);
+      mockSegmentsService.getSeatAvailabilityMap.mockResolvedValue(new Map([['seat-1', 'BOOKED']]));
+      mockPrisma.seat.findMany.mockResolvedValue([
+        { id: 'seat-1', seatNumber: '12', coach: { number: 'C1' } },
+      ]);
+
+      await expect(service.assertNoRouteSeatConflict({
+        scheduleId: 'sched-1',
+        seatIds: ['seat-1'],
+        originStationId: 'seb',
+        destinationStationId: 'dd',
+        journeyDirection: JourneyDirection.ONE_WAY,
+      })).rejects.toThrow(ConflictException);
+    });
+
+    it('allows the same seat number to be reused on non-overlapping legs', async () => {
+      mockPrisma.tripStopTime.findMany.mockResolvedValue([
+        { stationId: 'seb', sequence: 1 },
+        { stationId: 'ada', sequence: 2 },
+        { stationId: 'dd', sequence: 3 },
+      ]);
+      mockSegmentsService.getSeatAvailabilityMap.mockResolvedValue(new Map());
+
+      await expect(service.assertNoRouteSeatConflict({
+        scheduleId: 'sched-1',
+        seatIds: ['seat-1'],
+        originStationId: 'seb',
+        destinationStationId: 'ada',
+        journeyDirection: JourneyDirection.ONE_WAY,
+      })).resolves.toBeUndefined();
+    });
   });
 
   describe('autoAssignSeats', () => {
diff --git a/apps/edr-passenger-api/src/modules/seats/seats.service.ts b/apps/edr-passenger-api/src/modules/seats/seats.service.ts
index 383f7d96c..00aff331b 100644
--- a/apps/edr-passenger-api/src/modules/seats/seats.service.ts
+++ b/apps/edr-passenger-api/src/modules/seats/seats.service.ts
@@ -6,6 +6,7 @@ import { Cron, CronExpression } from '@nestjs/schedule';
 import { SegmentsService } from '../segments/segments.service';
 import { SystemConfigService, CONFIG_KEYS } from '../system-config/system-config.service';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
 import { SmsClientService } from '../notifications/sms-client.service';
 import { computePaymentDeadline } from '../../common/utils/payment-deadline.utils';
 import { checkDirectionConflict } from '../../common/utils/journey-direction.utils';
@@ -209,6 +210,57 @@ export class SeatsService {
   // (availabilityByClass) use — so the seatmap and search results can never disagree
   // about seat availability again. Previously this method carried its own
   // separately-written copy of the same hold/JourneySegment-overlap logic.
+  async assertNoRouteSeatConflict(args: {
+    scheduleId: string;
+    seatIds: string[];
+    originStationId?: string;
+    destinationStationId?: string;
+    journeyDirection?: JourneyDirection;
+  }): Promise<void> {
+    const { scheduleId, seatIds, originStationId, destinationStationId, journeyDirection = JourneyDirection.ONE_WAY } = args;
+    if (!seatIds.length) return;
+
+    const stopTimes = await this.prisma.tripStopTime.findMany({
+      where: { scheduleId },
+      select: { stationId: true, sequence: true },
+    });
+
+    let reqFrom = -Infinity;
+    let reqTo = Infinity;
+    if (originStationId && destinationStationId) {
+      const seqOf = (stationId: string) => stopTimes.find(s => s.stationId === stationId)?.sequence;
+      const resolvedFrom = seqOf(originStationId);
+      const resolvedTo = seqOf(destinationStationId);
+      if (resolvedFrom !== undefined && resolvedTo !== undefined) {
+        reqFrom = resolvedFrom;
+        reqTo = resolvedTo;
+      }
+    }
+
+    const availability = await this.segmentsService.getSeatAvailabilityMap(
+      scheduleId,
+      seatIds,
+      stopTimes,
+      reqFrom,
+      reqTo,
+      journeyDirection,
+    );
+
+    if (availability.size === 0) return;
+
+    const seats = await this.prisma.seat.findMany({
+      where: { id: { in: seatIds } },
+      select: { id: true, seatNumber: true },
+    });
+    const byId = new Map(seats.map(seat => [seat.id, seat.seatNumber]));
+    const conflicts = seatIds.filter(id => availability.has(id));
+
+    if (conflicts.length > 0) {
+      const labels = conflicts.map(id => byId.get(id) ?? id).join(', ');
+      throw new ConflictException(`Seat(s) ${labels} are already assigned for this route on this schedule`);
+    }
+  }
+
   async resolveEffectiveStatuses(
     scheduleId: string,
     seatIds: string[],
@@ -424,6 +476,14 @@ export class SeatsService {
         throw new BadRequestException('Origin must come before destination');
 
       const currentDirection = dto.journeyDirection || JourneyDirection.ONE_WAY;
+      await this.assertNoRouteSeatConflict({
+        scheduleId: dto.scheduleId,
+        seatIds,
+        originStationId: dto.originStationId,
+        destinationStationId: dto.destinationStationId,
+        journeyDirection: currentDirection,
+      });
+
       const activeHolds = await tx.seatHold.findMany({
         where: { scheduleId: dto.scheduleId, expiresAt: { gt: new Date() } },
         select: { seatIds: true, createdBy: true },
@@ -899,6 +959,13 @@ export class SeatsService {
       }
     }
 
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.IMPORT,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: scheduleId,
+      newData: { scheduleId, rows: lines.length, imported, errorCount: errors.length },
+    });
+
     return { imported, errors: errors.slice(0, 10) };
   }
 
@@ -932,10 +999,11 @@ export class SeatsService {
       });
     }
     await this.auditService.log({
-      action: 'UPDATE',
-      entityType: 'Seat',
+      action: AUDIT_ACTIONS.BLOCK,
+      entityType: AUDIT_ENTITIES.Seat,
       entityId: seatId,
-      newData: { status: 'BLOCKED', reason, reasonCategory, scheduleId, blockedBy },
+      oldData: { status: seat.status, seatNumber: seat.seatNumber, coachId: seat.coachId },
+      newData: { status: 'BLOCKED', reason, reasonCategory, scheduleId, blockedBy, blockedByName },
     });
     return { blocked: true, seatId, reason, reasonCategory, scheduleId, blockedBy, blockedByName };
   }
@@ -950,7 +1018,13 @@ export class SeatsService {
       await this.prisma.seat.update({ where: { id: seatId }, data: { status: 'AVAILABLE' } });
       await this.prisma.seatBlock.deleteMany({ where: { seatId, scheduleId: null } });
     }
-    await this.auditService.log({ action: 'UPDATE', entityType: 'Seat', entityId: seatId, newData: { status: 'AVAILABLE', scheduleId } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.UNBLOCK,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: seatId,
+      oldData: { status: seat.status, seatNumber: seat.seatNumber, coachId: seat.coachId },
+      newData: { status: 'AVAILABLE', scheduleId },
+    });
     return { unblocked: true, seatId, scheduleId };
   }
 
@@ -968,6 +1042,13 @@ export class SeatsService {
         blockedByName: actor?.name ?? 'System',
       },
     });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.STATUS_CHANGE,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: seatId,
+      oldData: { status: seat.status, seatNumber: seat.seatNumber, coachId: seat.coachId },
+      newData: { status: 'UNDER_MAINTENANCE', reason, blockedBy: actor?.id ?? 'SYSTEM' },
+    });
     return { maintenance: true, seatId, reason };
   }
 
@@ -976,6 +1057,13 @@ export class SeatsService {
     if (!seat) throw new NotFoundException('Seat not found');
     await this.prisma.seat.update({ where: { id: seatId }, data: { status: 'AVAILABLE' as any } });
     await this.prisma.seatBlock.deleteMany({ where: { seatId } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.STATUS_CHANGE,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: seatId,
+      oldData: { status: seat.status, seatNumber: seat.seatNumber, coachId: seat.coachId },
+      newData: { status: 'AVAILABLE' },
+    });
     return { maintenance: false, seatId };
   }
 
@@ -991,7 +1079,12 @@ export class SeatsService {
     });
 
     await this.renumberCoachSeats(seat.coachId);
-    await this.auditService.log({ action: 'DELETE', entityType: 'Seat', entityId: seatId, oldData: { seatNumber: seat.seatNumber, coachId: seat.coachId } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: seatId,
+      oldData: { seatNumber: seat.seatNumber, coachId: seat.coachId, status: seat.status },
+    });
     return { removed: true, seatId, originalSeatNumber: seat.seatNumber };
   }
 
@@ -1007,6 +1100,13 @@ export class SeatsService {
     await this.renumberCoachSeats(seat.coachId);
 
     const restored = await this.prisma.seat.findUnique({ where: { id: seatId } });
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.RESTORE,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: seatId,
+      oldData: { seatNumber: seat.seatNumber, coachId: seat.coachId },
+      newData: { seatNumber: restored?.seatNumber, coachId: seat.coachId },
+    });
     return { restored: true, seatId, seatNumber: restored?.seatNumber };
   }
 
@@ -1582,6 +1682,24 @@ export class SeatsService {
       });
     }
 
+    // `results` carries contactPhone for the SMS step — the audit row keeps only the seat move
+    // itself, so a passenger's number never lands in a log retained for a year.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.BULK_UPDATE,
+      entityType: AUDIT_ENTITIES.Seat,
+      entityId: coachIds[0],
+      newData: {
+        coachIds,
+        resolved: results.length,
+        unresolved: unresolved.length,
+        moves: results.map((r) => ({
+          bookingRef: r.bookingRef,
+          oldSeatNumber: r.oldSeatNumber,
+          newSeatNumber: r.newSeatNumber,
+        })),
+      },
+    });
+
     return {
       resolved:          results.length,
       unresolved:        unresolved.length,
diff --git a/apps/edr-passenger-api/src/modules/stations/stations.service.ts b/apps/edr-passenger-api/src/modules/stations/stations.service.ts
index ff40a30ab..4d6d87273 100644
--- a/apps/edr-passenger-api/src/modules/stations/stations.service.ts
+++ b/apps/edr-passenger-api/src/modules/stations/stations.service.ts
@@ -1,10 +1,23 @@
-import { Injectable, NotFoundException, Inject, Optional, BadRequestException } from '@nestjs/common';
-import { REQUEST } from '@nestjs/core';
+import { Injectable, NotFoundException, BadRequestException } from '@nestjs/common';
 import { PrismaService } from '../../common/prisma.service';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { snapshot } from '../../common/audit-snapshot';
 import { CreateStationDto } from './stations.dto';
 import { DeleteOperationException } from '../../common/exceptions/delete-operation.exception';
 
+/** The station fields worth carrying into an audit row — identity, placement, and status. */
+const STATION_AUDIT_FIELDS = [
+  'code',
+  'name',
+  'city',
+  'countryCode',
+  'lat',
+  'lng',
+  'sequence',
+  'isOperational',
+] as const;
+
 interface StationFilters {
   search?: string;
   country?: string;
@@ -16,7 +29,6 @@ export class StationsService {
   constructor(
     private prisma: PrismaService,
     private auditService: AuditService,
-    @Optional() @Inject(REQUEST) private request?: any,
   ) {}
   
   findAll(filters: StationFilters = {}) {
@@ -61,11 +73,10 @@ export class StationsService {
     });
     
     await this.auditService.log({
-      userId: this.request?.user?.id,
-      action: 'CREATE',
-      entityType: 'Station',
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Station,
       entityId: station.id,
-      newData: station,
+      newData: snapshot(station, STATION_AUDIT_FIELDS),
     });
 
     return station;
@@ -85,12 +96,11 @@ export class StationsService {
     });
 
     await this.auditService.log({
-      userId: this.request?.user?.id,
-      action: 'UPDATE',
-      entityType: 'Station',
+      action: AUDIT_ACTIONS.UPDATE,
+      entityType: AUDIT_ENTITIES.Station,
       entityId: id,
-      oldData: oldStation,
-      newData: updatedStation,
+      oldData: snapshot(oldStation, STATION_AUDIT_FIELDS),
+      newData: snapshot(updatedStation, STATION_AUDIT_FIELDS),
     });
 
     return updatedStation;
@@ -139,11 +149,11 @@ export class StationsService {
     const deleted = await this.prisma.station.delete({ where: { id } });
 
     await this.auditService.log({
-      userId: this.request?.user?.id,
-      action: 'DELETE',
-      entityType: 'Station',
+      action: AUDIT_ACTIONS.DELETE,
+      entityType: AUDIT_ENTITIES.Station,
       entityId: id,
-      oldData: station,
+      oldData: snapshot(station, STATION_AUDIT_FIELDS),
+      newData: { cascade },
     });
 
     return deleted;
diff --git a/apps/edr-passenger-api/src/modules/tasks/tasks.service.ts b/apps/edr-passenger-api/src/modules/tasks/tasks.service.ts
index 284eb61c0..fe4207a50 100644
--- a/apps/edr-passenger-api/src/modules/tasks/tasks.service.ts
+++ b/apps/edr-passenger-api/src/modules/tasks/tasks.service.ts
@@ -14,6 +14,15 @@ const AUDIT_LOG_RETENTION_DAYS = 365;
 const WEBHOOK_EVENT_RETENTION_DAYS = 90;
 const GATE_LOG_RETENTION_DAYS = 180;
 
+// How long past its payment deadline a booking may sit undecided because the GATEWAY cannot be
+// reached (PROVIDER_ERROR) before the sweep stops deferring and cancels anyway. Without a bound,
+// a permanently unreachable provider pins a booking as PENDING_PAYMENT forever — its seats stay
+// held and the sweep re-queries it once a minute, indefinitely. NEVER applied to an IN_FLIGHT
+// settlement: money that is actually moving is waited out no matter how long it takes.
+// Raise this in production — a 10-minute gateway outage should not mass-cancel bookings that may
+// well be paid (a late payment then lands on a CANCELLED booking and needs a manual refund).
+const RECONCILE_GRACE_MINUTES = Number(process.env.RECONCILE_GRACE_MINUTES) || 5;
+
 function fmtTime(d: Date): string {
   return d.toLocaleTimeString('en-GB', {
     hour: '2-digit',
@@ -325,15 +334,38 @@ export class TasksService {
         // Deadline passed — but NEVER cancel a booking that is actually paid. The payment.succeeded
         // event may have been lost (RabbitMQ down) or arrived late, leaving a paid booking stuck
         // PENDING_PAYMENT. Ask the payment service over HTTP; it confirms the booking synchronously
-        // if paid. Only proceed to cancel when settlement is VERIFIED unpaid.
+        // if paid. Cancel only on a VERIFIED-unpaid settlement — or, past the grace window below,
+        // on a settlement the gateway simply refuses to answer for.
         const settlement = await paymentsService.reconcileAndConfirmIfPaid(booking.id);
-        if (settlement.paid || !settlement.verified) {
-          this.logger.log(
-            `Skip auto-cancel ${booking.bookingRef}: ${settlement.paid ? 'PAID → confirmed' : 'unverifiable → deferred'}`,
-          );
+        if (settlement.paid) {
+          this.logger.log(`Skip auto-cancel ${booking.bookingRef}: PAID → confirmed`);
           continue;
         }
 
+        // Unverifiable: defer — but not forever. IN_FLIGHT is real money moving, so it is waited
+        // out indefinitely. A PROVIDER_ERROR (dead gateway, payment service down) is bounded by
+        // RECONCILE_GRACE_MINUTES past the deadline; beyond that the booking is cancelled on an
+        // UNVERIFIED settlement, which is recorded explicitly below so finance can chase it.
+        let unverifiedGiveUp = false;
+        if (!settlement.verified) {
+          const graceExpiresAt = new Date(
+            paymentDeadline.getTime() + RECONCILE_GRACE_MINUTES * 60 * 1000,
+          );
+          if (settlement.reason === 'IN_FLIGHT' || now < graceExpiresAt) {
+            this.logger.log(
+              `Skip auto-cancel ${booking.bookingRef}: unverifiable (${settlement.reason ?? 'PROVIDER_ERROR'}) → deferred`,
+            );
+            continue;
+          }
+          unverifiedGiveUp = true;
+          this.logger.error(
+            `Auto-cancelling ${booking.bookingRef} on an UNVERIFIED settlement — the gateway has ` +
+              `been unreachable for ${RECONCILE_GRACE_MINUTES}+ min past the deadline. If this ` +
+              `booking was in fact paid, the payment will land on a CANCELLED booking and needs a ` +
+              `manual refund.`,
+          );
+        }
+
         // 1a. Release held seats (Journey rows are the occupancy source of truth once paid)
         await this.prisma.journey.deleteMany({ where: { bookingId: booking.id } as any });
 
@@ -349,15 +381,21 @@ export class TasksService {
           });
         }
 
-        // 2. Audit record (no refund — payment was never completed)
+        // 2. Audit record (no refund — payment was verified never completed, or, on an unverified
+        //    give-up, flagged for review because we could not establish that)
         await this.prisma.bookingCancellation.create({
           data: {
             bookingId:    booking.id,
             cancelledBy:  'SYSTEM',
-            reason:       'Payment not completed before deadline',
+            reason:       unverifiedGiveUp
+              ? `Payment not completed before deadline; settlement UNVERIFIED — gateway unreachable ` +
+                `for ${RECONCILE_GRACE_MINUTES}+ min past the deadline. Confirm no payment was taken.`
+              : 'Payment not completed before deadline',
             refundAmount: 0,
             refundMethod: booking.paymentIntent?.method ?? 'NONE',
-            refundStatus: 'NOT_APPLICABLE',
+            // An unverified give-up may yet turn out to have been paid, so it is neither
+            // NOT_APPLICABLE nor a refund actually owed — flag it for a human instead.
+            refundStatus: unverifiedGiveUp ? 'REVIEW_REQUIRED' : 'NOT_APPLICABLE',
           },
         }).catch(() => null);
 
@@ -380,7 +418,10 @@ export class TasksService {
           await this.sms.sendSms({ to: booking.contactPhone, message }).catch(() => null);
         }
 
-        this.logger.log(`Auto-cancelled: ${booking.bookingRef} (deadline was ${fmtTime(paymentDeadline)})`);
+        this.logger.log(
+          `Auto-cancelled: ${booking.bookingRef} (deadline was ${fmtTime(paymentDeadline)})` +
+            (unverifiedGiveUp ? ' — UNVERIFIED settlement, review required' : ''),
+        );
         cancelledCount++;
       } catch (err) {
         this.logger.error(
diff --git a/apps/edr-passenger-api/src/modules/tickets/boarding-audit.spec.ts b/apps/edr-passenger-api/src/modules/tickets/boarding-audit.spec.ts
new file mode 100644
index 000000000..e70b8d3ca
--- /dev/null
+++ b/apps/edr-passenger-api/src/modules/tickets/boarding-audit.spec.ts
@@ -0,0 +1,231 @@
+import { TicketsService } from './tickets.service';
+
+/**
+ * "USER X boarded TICKET Y" has to be answerable from AuditLog alone.
+ *
+ * Before this, boarding wrote `action: 'VERIFY'` with no actor and no previous status, and the
+ * only name on the row was `validatorId` — a request-body field, so whoever scanned could put
+ * anyone's id in the trail. These pin: one row per boarding (not one per layer), the actor
+ * coming from the session, and the ticket's before/after status both being recorded.
+ */
+describe('TicketsService — boarding audit', () => {
+  const ACTOR = { id: 'iam-staff-1', name: 'Abebe Kebede', phone: '+251911223344' };
+  const TICKET_ID = 'ticket-1';
+  const BOOKING_ID = 'booking-1';
+  const BOOKING_REF = 'EDR-0001';
+
+  let prisma: Record<string, any>;
+  let audit: { log: jest.Mock };
+  let service: TicketsService;
+
+  const build = (
+    opts: {
+      bookingType?: string;
+      ticket?: Record<string, any>;
+      booking?: Record<string, any>;
+      approvedLegs?: string[];
+    } = {},
+  ) => {
+    const ticket = {
+      id: TICKET_ID,
+      bookingId: BOOKING_ID,
+      bookingRef: BOOKING_REF,
+      seatId: 'seat-9',
+      leg: 1,
+      status: 'ACTIVE',
+      validatedAt: null,
+      boardedAt: null,
+      ...opts.ticket,
+    };
+    // Departure an hour out, so scanAndBoard's boarding window is open.
+    const departureAt = new Date(Date.now() + 60 * 60 * 1000);
+    const booking = {
+      id: BOOKING_ID,
+      bookingRef: BOOKING_REF,
+      bookingType: opts.bookingType ?? 'ONE_WAY',
+      status: 'CONFIRMED',
+      originStationId: 'station-a',
+      destinationStationId: 'station-b',
+      outboundBoardedAt: null,
+      returnBoardedAt: null,
+      tickets: [ticket],
+      seats: [],
+      schedule: {
+        id: 'sched-1',
+        departureAt,
+        arrivalAt: new Date(departureAt.getTime() + 6 * 60 * 60 * 1000),
+        originStationId: 'station-a',
+        destinationStationId: 'station-b',
+        originStation: { id: 'station-a', name: 'Furi Labu' },
+        destinationStation: { id: 'station-b', name: 'Dire Dawa' },
+        train: { id: 'train-1', number: 'T1' },
+        stopTimes: [],
+      },
+      returnSchedule: null,
+      ...opts.booking,
+    };
+
+    prisma = {
+      ticket: {
+        findUnique: jest.fn().mockResolvedValue(ticket),
+        findFirst: jest.fn().mockResolvedValue(ticket),
+        update: jest.fn().mockResolvedValue(ticket),
+      },
+      booking: {
+        findUnique: jest.fn().mockResolvedValue(booking),
+        update: jest.fn().mockResolvedValue(booking),
+      },
+      gateValidationLog: {
+        create: jest.fn().mockResolvedValue({}),
+        findMany: jest
+          .fn()
+          .mockResolvedValue((opts.approvedLegs ?? []).map((leg) => ({ leg, status: 'APPROVED' }))),
+      },
+    };
+    audit = { log: jest.fn().mockResolvedValue(undefined) };
+
+    // Constructor order: prisma, notifications, systemConfig, auditService, dataSource.
+    service = new TicketsService(
+      prisma as any,
+      { sendSms: jest.fn(), sendEmail: jest.fn() } as any,
+      { get: jest.fn().mockResolvedValue(null), getNumber: jest.fn().mockResolvedValue(4) } as any,
+      audit as any,
+      {} as any,
+    );
+    return { ticket, booking };
+  };
+
+  const rows = () => audit.log.mock.calls.map((c) => c[0]);
+  const boardRows = () => rows().filter((r) => r.action === 'BOARD');
+
+  describe('a successful one-way boarding', () => {
+    it('writes exactly one BOARD row', async () => {
+      build();
+      await service.validate(BOOKING_REF, 'GATE-1', 'MOBILE-GATE', undefined, ACTOR);
+      expect(boardRows()).toHaveLength(1);
+    });
+
+    it('identifies the ticket and the booking it belongs to', async () => {
+      build();
+      await service.validate(BOOKING_REF, 'GATE-1', 'MOBILE-GATE', undefined, ACTOR);
+
+      expect(boardRows()[0]).toMatchObject({
+        action: 'BOARD',
+        entityType: 'Ticket',
+        entityId: TICKET_ID,
+      });
+      expect(boardRows()[0].newData).toMatchObject({
+        bookingRef: BOOKING_REF,
+        bookingId: BOOKING_ID,
+        seatId: 'seat-9',
+      });
+    });
+
+    it('records the status the ticket moved from and to', async () => {
+      build();
+      await service.validate(BOOKING_REF, 'GATE-1', undefined, undefined, ACTOR);
+
+      const row = boardRows()[0];
+      expect(row.oldData).toMatchObject({ status: 'ACTIVE', validatedAt: null });
+      expect(row.newData.status).toBe('USED');
+      expect(row.newData.boardedAt).toEqual(expect.any(String));
+    });
+
+    it('leaves the actor to AuditService rather than passing a client-supplied id', async () => {
+      build();
+      await service.validate(BOOKING_REF, 'anyone-can-type-this', undefined, undefined, ACTOR);
+
+      // `userId` is never set at the call site — AuditService reads the guarded session, so the
+      // body value below can only ever appear as descriptive context.
+      expect(boardRows()[0].userId).toBeUndefined();
+      expect(boardRows()[0].newData.validatorId).toBe('anyone-can-type-this');
+    });
+
+    it('names the authenticated user on the gate log when no validatorId is sent', async () => {
+      build();
+      await service.validate(BOOKING_REF, '', undefined, undefined, ACTOR);
+
+      // Previously fell straight through to the anonymous 'BACKOFFICE' literal.
+      expect(prisma.gateValidationLog.create.mock.calls[0][0].data.validatorId).toBe(ACTOR.id);
+    });
+  });
+
+  describe('scanAndBoard', () => {
+    it('produces one row, not one per layer', async () => {
+      build();
+      // scanAndBoard delegates to validate(); logging in both would double every boarding.
+      await service.scanAndBoard(BOOKING_REF, 'GATE-1', 'MOBILE-GATE', ACTOR);
+      expect(boardRows()).toHaveLength(1);
+    });
+  });
+
+  describe('a refused boarding', () => {
+    it('records BOARD_DENIED with the reason on a round-trip leg already used', async () => {
+      build({ bookingType: 'ROUND_TRIP', booking: { outboundBoardedAt: new Date() } });
+
+      await expect(
+        service.validate(BOOKING_REF, 'GATE-1', undefined, 'OUTBOUND', ACTOR),
+      ).rejects.toThrow();
+
+      const denied = rows().filter((r) => r.action === 'BOARD_DENIED');
+      expect(denied).toHaveLength(1);
+      expect(denied[0]).toMatchObject({ entityType: 'Ticket', entityId: TICKET_ID });
+      expect(denied[0].newData).toMatchObject({
+        result: 'REJECTED',
+        reason: 'OUTBOUND_ALREADY_USED',
+        bookingRef: BOOKING_REF,
+      });
+    });
+
+    it('writes no BOARD row when the boarding was refused', async () => {
+      build({ bookingType: 'TRANSIT', approvedLegs: ['LEG1'] });
+
+      await expect(
+        service.validate(BOOKING_REF, 'GATE-1', undefined, 'LEG1', ACTOR),
+      ).rejects.toThrow();
+
+      expect(boardRows()).toHaveLength(0);
+    });
+  });
+
+  describe('reads', () => {
+    it('writes nothing when simply fetching a ticket', async () => {
+      build();
+      await service.getByRef(BOOKING_REF).catch(() => undefined);
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('failed operations', () => {
+    it('records nothing when the booking does not exist', async () => {
+      build();
+      prisma.booking.findUnique.mockResolvedValue(null);
+
+      await expect(
+        service.validate(BOOKING_REF, 'GATE-1', undefined, undefined, ACTOR),
+      ).rejects.toThrow();
+      expect(audit.log).not.toHaveBeenCalled();
+    });
+
+    it('records nothing when the ticket write itself fails', async () => {
+      build();
+      prisma.ticket.update.mockRejectedValue(new Error('db down'));
+
+      await expect(
+        service.validate(BOOKING_REF, 'GATE-1', undefined, undefined, ACTOR),
+      ).rejects.toThrow();
+      expect(boardRows()).toHaveLength(0);
+    });
+  });
+
+  describe('sensitive data', () => {
+    it('keeps the QR payload and passenger name off the row', async () => {
+      build({ ticket: { qrPayload: 'QR-SECRET', passengerName: 'Abebe Kebede' } });
+      await service.validate(BOOKING_REF, 'GATE-1', undefined, undefined, ACTOR);
+
+      const serialized = JSON.stringify(boardRows()[0]);
+      expect(serialized).not.toContain('QR-SECRET');
+      expect(serialized).not.toContain('Abebe Kebede');
+    });
+  });
+});
diff --git a/apps/edr-passenger-api/src/modules/tickets/tickets.controller.ts b/apps/edr-passenger-api/src/modules/tickets/tickets.controller.ts
index 3467706de..a835a3e67 100644
--- a/apps/edr-passenger-api/src/modules/tickets/tickets.controller.ts
+++ b/apps/edr-passenger-api/src/modules/tickets/tickets.controller.ts
@@ -1,8 +1,9 @@
-import { Body, Controller, Get, Param, Post, Query, UseGuards, Delete, Patch, SetMetadata } from '@nestjs/common';
+import { Body, Controller, Get, Param, Post, Query, Req, UseGuards, Delete, Patch, SetMetadata } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth, ApiBody, ApiQuery } from '@nestjs/swagger';
 import { TicketsService } from './tickets.service';
 import { PassengerStaff, PassengerAdmin } from '../../common/passenger-guards';
 import { PASSENGER_PERMS } from '../../seed/passenger-permissions.registry';
+import { resolveActingUser } from '../../common/acting-user';
 
 @ApiTags('Tickets')
 @Controller('tickets')
@@ -135,10 +136,13 @@ export class TicketsController {
   })
   scanAndBoard(
     @Param('qrCodeOrRef') qrCodeOrRef: string,
+    @Req() req: any,
     @Body('validatorId') validatorId: string,
     @Body('gateId') gateId?: string,
   ) {
-    return this.service.scanAndBoard(qrCodeOrRef, validatorId, gateId);
+    // `validatorId` still labels the gate/agent on the gate log; who is accountable for the
+    // boarding comes from the JWT, which the body cannot influence.
+    return this.service.scanAndBoard(qrCodeOrRef, validatorId, gateId, resolveActingUser(req));
   }
 
   @Post(':bookingRef/validate')
@@ -165,11 +169,12 @@ export class TicketsController {
   })
   validate(
     @Param('bookingRef') ref: string,
+    @Req() req: any,
     @Body('validatorId') validatorId: string,
     @Body('gateId') gateId?: string,
     @Body('leg') leg?: string,
   ) {
-    return this.service.validate(ref, validatorId, gateId, leg);
+    return this.service.validate(ref, validatorId, gateId, leg, resolveActingUser(req));
   }
   
   @Get(':ticketId/validation-logs')
@@ -216,8 +221,8 @@ export class TicketsController {
       },
     },
   })
-  validateOfflineBatch(@Body() body: { validations: any[] }) {
-    return this.service.validateOfflineBatch(body.validations);
+  validateOfflineBatch(@Body() body: { validations: any[] }, @Req() req: any) {
+    return this.service.validateOfflineBatch(body.validations, resolveActingUser(req));
   }
 
   @Delete(':id')
diff --git a/apps/edr-passenger-api/src/modules/tickets/tickets.service.ts b/apps/edr-passenger-api/src/modules/tickets/tickets.service.ts
index 6a45eeb69..ae2d0e034 100644
--- a/apps/edr-passenger-api/src/modules/tickets/tickets.service.ts
+++ b/apps/edr-passenger-api/src/modules/tickets/tickets.service.ts
@@ -5,6 +5,8 @@ import { PrismaService } from '../../common/prisma.service';
 import { NotificationsService } from '../notifications/notifications.service';
 import { SystemConfigService, CONFIG_KEYS } from '../system-config/system-config.service';
 import { AuditService } from '../../common/audit.service';
+import { AUDIT_ACTIONS, AUDIT_ENTITIES } from '../../common/audit.actions';
+import { ActingUser } from '../../common/acting-user';
 import { resolveBookingSegment } from '../../common/utils/segment-resolver.utils';
 import * as QRCode from 'qrcode';
 
@@ -289,12 +291,16 @@ export class TicketsService {
       reassigned.push({ seatNumber: bs.seat.seatNumber, newSeatNumber: candidate.seatNumber });
     }
 
-    await this.auditService.log({
-      action: 'UPDATE',
-      entityType: 'Booking',
-      entityId: bookingId,
-      newData: { smartReassigned: true, changes: reassigned },
-    });
+    // Only when a seat actually moved: this runs on every reassignment sweep, including from
+    // generateMissing()'s batch loop, and an empty `changes` row says nothing happened.
+    if (reassigned.length > 0) {
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.UPDATE,
+        entityType: AUDIT_ENTITIES.Booking,
+        entityId: bookingId,
+        newData: { smartReassigned: true, changes: reassigned },
+      });
+    }
 
     return this.generate(bookingId);
   }
@@ -506,7 +512,15 @@ export class TicketsService {
       }).catch(() => null);
     }
 
-    await this.auditService.log({ action: 'CREATE', entityType: 'Ticket', entityId: booking.id, newData: { bookingRef: booking.bookingRef, totalTickets: tickets.length } });
+    // NOTE: entityId is the booking's id, not a ticket id — pre-existing and left as-is so
+    // historical rows stay queryable the same way. Ticket generation is outside this change's
+    // scope; see the audit-trail report.
+    await this.auditService.log({
+      action: AUDIT_ACTIONS.CREATE,
+      entityType: AUDIT_ENTITIES.Ticket,
+      entityId: booking.id,
+      newData: { bookingRef: booking.bookingRef, totalTickets: tickets.length },
+    });
     return { tickets, totalTickets: tickets.length };
   }
 
@@ -587,7 +601,12 @@ export class TicketsService {
     };
   }
 
-  async scanAndBoard(qrCodeOrRef: string, validatorId: string, gateId?: string) {
+  async scanAndBoard(
+    qrCodeOrRef: string,
+    validatorId: string,
+    gateId?: string,
+    actor?: ActingUser | null,
+  ) {
     try {
       // Extract booking reference from QR code if it's JSON
       let bookingRef = qrCodeOrRef;
@@ -662,7 +681,7 @@ export class TicketsService {
       }
 
       // Use existing validation logic to handle round trips properly
-      const result = await this.validate(bookingRef, validatorId, gateId);
+      const result = await this.validate(bookingRef, validatorId, gateId, undefined, actor);
       if ((result as any).alreadyValidated) {
         return {
           success: false,
@@ -745,7 +764,21 @@ export class TicketsService {
     }
   }
 
-  async validate(ticketIdOrRef: string, validatorId: string, gateId?: string, leg?: string) {
+  /**
+   * Boards a ticket at the gate.
+   *
+   * `validatorId` is the gate/agent label the client sends and keeps its existing meaning on
+   * `Ticket.validatorId` and `GateValidationLog`. `actor` is the authenticated staff member from
+   * the request — it is what the audit trail attributes the boarding to, so a caller cannot board
+   * a passenger under someone else's name by editing the request body.
+   */
+  async validate(
+    ticketIdOrRef: string,
+    validatorId: string,
+    gateId?: string,
+    leg?: string,
+    actor?: ActingUser | null,
+  ) {
     // Accept either a ticket UUID or a bookingRef
     let bookingRef = ticketIdOrRef;
     const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(ticketIdOrRef);
@@ -754,7 +787,9 @@ export class TicketsService {
       if (!ticket) throw new NotFoundException('Ticket not found');
       bookingRef = ticket.bookingRef;
     }
-    const resolvedValidatorId = validatorId || 'BACKOFFICE';
+    // Falls back to the authenticated user before the anonymous 'BACKOFFICE' literal, so an
+    // omitted validatorId still names a real person on the gate log.
+    const resolvedValidatorId = validatorId || actor?.id || 'BACKOFFICE';
     const booking = await this.prisma.booking.findUnique({ where: { bookingRef } });
     if (!booking) throw new NotFoundException('Booking not found');
     const ticket = await this.prisma.ticket.findFirst({ where: { bookingId: booking.id } });
@@ -763,6 +798,14 @@ export class TicketsService {
     const type = booking.bookingType;
     const now = new Date();
 
+    // Snapshotted before any branch mutates the rows, so every audit row below can report the
+    // status the ticket actually moved away from.
+    const previousTicketStatus = ticket.status;
+    const previousValidatedAt = ticket.validatedAt?.toISOString() ?? null;
+    const previousOutboundBoardedAt =
+      (booking as any).outboundBoardedAt?.toISOString() ?? null;
+    const previousReturnBoardedAt = (booking as any).returnBoardedAt?.toISOString() ?? null;
+
     const markTicketUsed = async () => {
       if (ticket.status !== 'USED') {
         await this.prisma.ticket.update({ where: { id: ticket.id }, data: { status: 'USED' } });
@@ -782,7 +825,24 @@ export class TicketsService {
       });
       await this.prisma.gateValidationLog.create({ data: { ticketId: ticket.id, validatorId: resolvedValidatorId, gateId, status: 'APPROVED' } });
       this.fireBoardingPassNotification(booking, ticket, null);
-      await this.auditService.log({ action: 'VERIFY', entityType: 'Ticket', entityId: ticket.id, newData: { bookingRef, validatorId: resolvedValidatorId, leg: 'ONE_WAY' } });
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.BOARD,
+        entityType: AUDIT_ENTITIES.Ticket,
+        entityId: ticket.id,
+        oldData: { status: ticket.status, validatedAt: null, boardedAt: null },
+        newData: {
+          status: 'USED',
+          validatedAt: now.toISOString(),
+          boardedAt: now.toISOString(),
+          leg: 'ONE_WAY',
+          bookingRef,
+          bookingId: booking.id,
+          seatId: ticket.seatId,
+          ticketLeg: ticket.leg,
+          gateId,
+          validatorId: resolvedValidatorId,
+        },
+      });
       return { validated: true, ticketId: ticket.id, validatedAt: now };
     }
 
@@ -797,6 +857,23 @@ export class TicketsService {
       if (alreadyValidated) {
         await this.prisma.gateValidationLog.create({ data: { ticketId: ticket.id, validatorId: resolvedValidatorId, gateId, leg: resolvedLeg, status: 'REJECTED', reason: `${resolvedLeg}_ALREADY_USED` } as any });
         await markTicketUsed();
+        // A refused boarding is exactly the attempt an investigator wants attributed; the gate
+        // log records it but carries no IAM actor, IP, or user-agent.
+        await this.auditService.log({
+          action: AUDIT_ACTIONS.BOARD_DENIED,
+          entityType: AUDIT_ENTITIES.Ticket,
+          entityId: ticket.id,
+          oldData: { status: ticket.status, validatedAt: ticket.validatedAt?.toISOString() ?? null },
+          newData: {
+            result: 'REJECTED',
+            reason: `${resolvedLeg}_ALREADY_USED`,
+            leg: resolvedLeg,
+            bookingRef,
+            bookingId: booking.id,
+            gateId,
+            validatorId: resolvedValidatorId,
+          },
+        });
         throw new BadRequestException(`${resolvedLeg} already validated`);
       }
       const validatedAt = ticket.validatedAt ?? now;
@@ -810,7 +887,24 @@ export class TicketsService {
       }
       await this.prisma.gateValidationLog.create({ data: { ticketId: ticket.id, validatorId: resolvedValidatorId, gateId, leg: resolvedLeg, status: 'APPROVED' } as any });
       this.fireBoardingPassNotification(booking, ticket, resolvedLeg);
-      await this.auditService.log({ action: 'VERIFY', entityType: 'Ticket', entityId: ticket.id, newData: { bookingRef, validatorId: resolvedValidatorId, leg: resolvedLeg } });
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.BOARD,
+        entityType: AUDIT_ENTITIES.Ticket,
+        entityId: ticket.id,
+        oldData: { status: previousTicketStatus, validatedAt: previousValidatedAt },
+        newData: {
+          status: 'USED',
+          validatedAt: validatedAt.toISOString(),
+          boardedAt: now.toISOString(),
+          leg: resolvedLeg,
+          bookingRef,
+          bookingId: booking.id,
+          seatId: ticket.seatId,
+          ticketLeg: ticket.leg,
+          gateId,
+          validatorId: resolvedValidatorId,
+        },
+      });
       return { validated: true, ticketId: ticket.id, leg: resolvedLeg, validatedAt };
     }
 
@@ -826,6 +920,21 @@ export class TicketsService {
         if ((booking as any).outboundBoardedAt) {
           await this.prisma.gateValidationLog.create({ data: { ticketId: ticket.id, validatorId: resolvedValidatorId, gateId, leg: resolvedLeg, status: 'REJECTED', reason: 'OUTBOUND_ALREADY_USED' } as any });
           await markTicketUsed();
+          await this.auditService.log({
+            action: AUDIT_ACTIONS.BOARD_DENIED,
+            entityType: AUDIT_ENTITIES.Ticket,
+            entityId: ticket.id,
+            oldData: { status: previousTicketStatus, validatedAt: previousValidatedAt },
+            newData: {
+              result: 'REJECTED',
+              reason: 'OUTBOUND_ALREADY_USED',
+              leg: resolvedLeg,
+              bookingRef,
+              bookingId: booking.id,
+              gateId,
+              validatorId: resolvedValidatorId,
+            },
+          });
           throw new BadRequestException('Outbound leg already validated');
         }
         bookingData.outboundBoardedAt = now;
@@ -833,6 +942,21 @@ export class TicketsService {
         if ((booking as any).returnBoardedAt) {
           await this.prisma.gateValidationLog.create({ data: { ticketId: ticket.id, validatorId: resolvedValidatorId, gateId, leg: resolvedLeg, status: 'REJECTED', reason: 'RETURN_ALREADY_USED' } as any });
           await markTicketUsed();
+          await this.auditService.log({
+            action: AUDIT_ACTIONS.BOARD_DENIED,
+            entityType: AUDIT_ENTITIES.Ticket,
+            entityId: ticket.id,
+            oldData: { status: previousTicketStatus, validatedAt: previousValidatedAt },
+            newData: {
+              result: 'REJECTED',
+              reason: 'RETURN_ALREADY_USED',
+              leg: resolvedLeg,
+              bookingRef,
+              bookingId: booking.id,
+              gateId,
+              validatorId: resolvedValidatorId,
+            },
+          });
           throw new BadRequestException('Return leg already validated');
         }
         bookingData.returnBoardedAt = now;
@@ -852,7 +976,29 @@ export class TicketsService {
       }
       await this.prisma.gateValidationLog.create({ data: { ticketId: ticket.id, validatorId: resolvedValidatorId, gateId, leg: resolvedLeg, status: 'APPROVED' } as any });
       this.fireBoardingPassNotification(booking, ticket, resolvedLeg);
-      await this.auditService.log({ action: 'VERIFY', entityType: 'Ticket', entityId: ticket.id, newData: { bookingRef, validatorId: resolvedValidatorId, leg: resolvedLeg } });
+      await this.auditService.log({
+        action: AUDIT_ACTIONS.BOARD,
+        entityType: AUDIT_ENTITIES.Ticket,
+        entityId: ticket.id,
+        oldData: {
+          status: previousTicketStatus,
+          validatedAt: previousValidatedAt,
+          outboundBoardedAt: previousOutboundBoardedAt,
+          returnBoardedAt: previousReturnBoardedAt,
+        },
+        newData: {
+          status: 'USED',
+          validatedAt: validatedAt.toISOString(),
+          boardedAt: now.toISOString(),
+          leg: resolvedLeg,
+          bookingRef,
+          bookingId: booking.id,
+          seatId: ticket.seatId,
+          ticketLeg: ticket.leg,
+          gateId,
+          validatorId: resolvedValidatorId,
+        },
+      });
       return { validated: true, ticketId: ticket.id, leg: resolvedLeg, validatedAt };
     }
 
@@ -894,7 +1040,7 @@ export class TicketsService {
     }));
   }
 
-  async validateOfflineBatch(validations: OfflineValidation[]) {
+  async validateOfflineBatch(validations: OfflineValidation[], actor?: ActingUser | null) {
     const results = [];
     
     for (const validation of validations) {
@@ -903,7 +1049,8 @@ export class TicketsService {
           validation.bookingRef,
           validation.validatorId,
           validation.gateId,
-          validation.leg
+          validation.leg,
+          actor,
         );
         results.push({ 
           bookingRef: validation.bookingRef, 
diff --git a/apps/edr-passenger-api/src/modules/verifayda/verifayda.dto.ts b/apps/edr-passenger-api/src/modules/verifayda/verifayda.dto.ts
index 26108a452..901118389 100644
--- a/apps/edr-passenger-api/src/modules/verifayda/verifayda.dto.ts
+++ b/apps/edr-passenger-api/src/modules/verifayda/verifayda.dto.ts
@@ -57,6 +57,14 @@ export class CompleteVerificationResultDto {
     agentId?: string;
   };
 
+  @ApiPropertyOptional({
+    description:
+      'eSignet subject identifier for the verified individual (VERIFY flow). A PSUT — ' +
+      'pairwise and stable per client_id, never the FIN. The booking flow compares it across ' +
+      'passengers so one Fayda identity cannot verify more than one passenger on a booking.',
+  })
+  faydaSub?: string;
+
   @ApiPropertyOptional({ description: 'Verified full name from Fayda (VERIFY flow).' })
   fullName?: string;
 
diff --git a/apps/edr-passenger-api/src/modules/verifayda/verifayda.service.ts b/apps/edr-passenger-api/src/modules/verifayda/verifayda.service.ts
index df6cfc21d..42376d4a1 100644
--- a/apps/edr-passenger-api/src/modules/verifayda/verifayda.service.ts
+++ b/apps/edr-passenger-api/src/modules/verifayda/verifayda.service.ts
@@ -70,11 +70,19 @@ export interface FaydaUserSummary {
 /**
  * Result of completing a verification. `verified` is always true on success.
  * LOGIN additionally returns a JWT + user; VERIFY returns the verified identity
- * attributes (name, email, phone, dob, gender) for the caller to consume.
+ * attributes (name, email, phone, dob, gender, faydaSub) for the caller to consume.
  */
 export interface CompleteVerificationResult {
   purpose: VerifaydaPurpose;
   verified: boolean;
+  /**
+   * eSignet subject identifier for the verified individual. This is a PSUT —
+   * pairwise and stable per `client_id`, never the FIN — so it is safe to hand
+   * to the browser, and it is the same value `/passengers/me` already returns.
+   * The booking flow uses it to stop one Fayda identity from verifying more
+   * than one passenger on the same booking.
+   */
+  faydaSub?: string;
   token?: string;
   refreshToken?: string;
   requiresPassword?: boolean;
@@ -280,6 +288,7 @@ export class VerifaydaService {
         result = {
           purpose: 'VERIFY',
           verified: true,
+          faydaSub: normalized.sub,
           fullName: normalized.fullName,
           email: normalized.email,
           phoneNumber: normalized.phoneNumber,
@@ -357,6 +366,13 @@ export class VerifaydaService {
       code_challenge_method: 'S256',
       acr_values: this.faydaConfig.acrValues,
       claims_locales: this.faydaConfig.claimsLocales,
+      // Force a fresh authentication instead of silently reusing the eSignet
+      // SSO session. A booking can carry several passengers, each of whom must
+      // verify with their OWN Fayda; without this, the second and third
+      // "Verify with Fayda" clicks round-trip in a couple of seconds and hand
+      // back the first passenger's identity, which the booking flow then has to
+      // reject with no way for the user to authenticate as the right person.
+      prompt: 'login',
     });
 
     // Every claim is marked essential so eSignet shows them locked/pre-checked
diff --git a/apps/edr-passenger-api/test/money-integrity.e2e-spec.ts b/apps/edr-passenger-api/test/money-integrity.e2e-spec.ts
index dace45843..91b0a4f2f 100644
--- a/apps/edr-passenger-api/test/money-integrity.e2e-spec.ts
+++ b/apps/edr-passenger-api/test/money-integrity.e2e-spec.ts
@@ -130,11 +130,12 @@ describe("Money integrity (Tier-2 direct instantiation)", () => {
 
     const service = new ExcessBaggageService(
       prisma as any,
-      asyncStub(),
-      asyncStub(),
-      asyncStub(),
-      asyncStub(),
-      asyncStub(),
+      asyncStub(), // auditService
+      asyncStub(), // currencyService
+      asyncStub(), // paymentClient
+      asyncStub(), // notifications
+      asyncStub(), // smsClient
+      asyncStub(), // emailClient
     );
 
     const charge: any = await service.logCharge({
@@ -174,6 +175,7 @@ describe("Money integrity (Tier-2 direct instantiation)", () => {
     const service = new ExcessBaggageService(
       prisma as any,
       asyncStub(), // auditService
+      asyncStub(), // currencyService
       asyncStub(), // paymentClient
       asyncStub(), // notifications
       asyncStub(), // smsClient
diff --git a/apps/edr-passenger-web/backoffice/package.json b/apps/edr-passenger-web/backoffice/package.json
index 9d4327a42..737baeda1 100644
--- a/apps/edr-passenger-web/backoffice/package.json
+++ b/apps/edr-passenger-web/backoffice/package.json
@@ -16,6 +16,8 @@
     "axios": "^1.7.7",
     "clsx": "^2.1.1",
     "date-fns": "^3.0.0",
+    "exceljs": "^4.4.0",
+    "html-to-image": "^1.11.11",
     "lucide-react": "^0.446.0",
     "next": "^14.2.0",
     "react": "^18.3.1",
diff --git a/apps/edr-passenger-web/backoffice/src/app/audit/page.tsx b/apps/edr-passenger-web/backoffice/src/app/audit/page.tsx
index fa4b58966..0cc0bbe5e 100644
--- a/apps/edr-passenger-web/backoffice/src/app/audit/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/audit/page.tsx
@@ -1,58 +1,110 @@
 'use client';
 
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
 import { useQuery } from '@tanstack/react-query';
-import { Eye, Download } from 'lucide-react';
+import { Eye, Download, ChevronLeft, ChevronRight } from 'lucide-react';
 import DataTable from '@/components/ui/DataTable';
 import Badge from '@/components/ui/Badge';
 import { auditApi } from '@/lib/api';
 import { formatDateTime } from '@/lib/utils';
 import Modal from '@/components/ui/Modal';
 import ActionButton from '@/components/ui/ActionButton';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
+import type { AuditLog } from '@/types/edr';
 
-export default function AuditLogsPage() {
-  const [filters, setFilters] = useState({ search: '', action: '', entityType: '' });
+const PAGE_SIZE = 50;
+
+/** Fallbacks used until GET /audit/vocabulary answers, and if it ever fails. */
+const FALLBACK_ACTIONS = ['CREATE', 'UPDATE', 'DELETE', 'STATUS_CHANGE', 'CANCEL', 'BOARD'];
+const FALLBACK_ENTITY_TYPES = ['Station', 'Train', 'Coach', 'Seat', 'Route', 'Schedule', 'Ticket'];
+
+/** Actions that read as destructive/irreversible, for colouring only. */
+const DESTRUCTIVE_ACTIONS = new Set(['DELETE', 'CANCEL', 'BOARD_DENIED']);
+const CREATIVE_ACTIONS = new Set(['CREATE', 'BULK_CREATE', 'RESTORE', 'BOARD', 'PAY']);
+
+function actionVariant(action: string) {
+  if (CREATIVE_ACTIONS.has(action)) return 'success';
+  if (DESTRUCTIVE_ACTIONS.has(action)) return 'danger';
+  if (action === 'LOGIN' || action === 'LOGOUT') return 'info';
+  return 'primary';
+}
+
+function AuditLogsPageContent() {
+  const [filters, setFilters] = useState({
+    search: '',
+    action: '',
+    entityType: '',
+    from: '',
+    to: '',
+  });
+  const [page, setPage] = useState(0);
   const [selectedLog, setSelectedLog] = useState<any>(null);
   const [showDetailsModal, setShowDetailsModal] = useState(false);
+  const [exporting, setExporting] = useState(false);
+
+  // Any filter change invalidates the current offset.
+  useEffect(() => setPage(0), [filters]);
+
+  const query = { ...filters, limit: PAGE_SIZE, offset: page * PAGE_SIZE };
 
   const { data, isLoading } = useQuery({
-    queryKey: ['audit-logs', filters],
-    queryFn: () => auditApi.getLogs(filters),
-    refetchInterval: 30000, // Refetch every 30 seconds
+    queryKey: ['audit-logs', query],
+    queryFn: () => auditApi.getLogs(query),
+    refetchInterval: 30000,
   });
 
-  const getActionBadgeColor = (action: string) => {
-    switch (action) {
-      case 'CREATE':
-        return 'success';
-      case 'UPDATE':
-        return 'primary';
-      case 'DELETE':
-        return 'danger';
-      case 'LOGIN':
-        return 'info';
-      case 'LOGOUT':
-        return 'secondary';
-      default:
-        return 'secondary';
+  const { data: vocabulary } = useQuery({
+    queryKey: ['audit-vocabulary'],
+    queryFn: () => auditApi.getVocabulary(),
+    staleTime: Infinity,
+  });
+
+  // Per-action tallies come from the API's own `total` under the same filters, not from the
+  // rows on screen — counting the current page made "Total Logs" cap out at the page size.
+  // limit: 1 keeps these to a COUNT plus a single row.
+  const creates = useQuery({
+    queryKey: ['audit-count', 'CREATE', filters],
+    queryFn: () => auditApi.getLogs({ ...filters, action: 'CREATE', limit: 1, offset: 0 }),
+    refetchInterval: 60000,
+  });
+  const updates = useQuery({
+    queryKey: ['audit-count', 'UPDATE', filters],
+    queryFn: () => auditApi.getLogs({ ...filters, action: 'UPDATE', limit: 1, offset: 0 }),
+    refetchInterval: 60000,
+  });
+  const deletes = useQuery({
+    queryKey: ['audit-count', 'DELETE', filters],
+    queryFn: () => auditApi.getLogs({ ...filters, action: 'DELETE', limit: 1, offset: 0 }),
+    refetchInterval: 60000,
+  });
+
+  const logs: AuditLog[] = Array.isArray(data?.items) ? data.items : [];
+  const total: number = typeof data?.total === 'number' ? data.total : logs.length;
+  const pageCount = Math.max(1, Math.ceil(total / PAGE_SIZE));
+
+  const actionOptions: string[] = vocabulary?.actions ?? FALLBACK_ACTIONS;
+  const entityTypeOptions: string[] = vocabulary?.entityTypes ?? FALLBACK_ENTITY_TYPES;
+
+  const formatJsonData = (value: any) => {
+    if (!value) return 'N/A';
+    try {
+      return JSON.stringify(value, null, 2);
+    } catch {
+      return String(value);
     }
   };
 
-  const formatJsonData = (data: any) => {
-    if (!data) return 'N/A';
-    try {
-      return JSON.stringify(data, null, 2);
-    } catch {
-      return String(data);
-    }
-  };
+  /** Who acted, falling back through the identity the API actually returns. */
+  const actorName = (log: AuditLog) => log.userName || 'System';
+  const actorDetail = (log: AuditLog) => log.userPhone || log.iamUserId || 'N/A';
 
   const columns = [
     {
       key: 'createdAt',
       label: 'Timestamp',
       sortable: true,
-      render: (log: any) => (
+      render: (log: AuditLog) => (
         <div className="text-sm">
           <div className="font-medium">{formatDateTime(log.createdAt)}</div>
           <div className="text-xs text-muted-foreground">{new Date(log.createdAt).toLocaleTimeString()}</div>
@@ -63,17 +115,13 @@ export default function AuditLogsPage() {
       key: 'action',
       label: 'Action',
       sortable: true,
-      render: (log: any) => (
-        <Badge className={getActionBadgeColor(log.action)}>
-          {log.action}
-        </Badge>
-      ),
+      render: (log: AuditLog) => <Badge className={actionVariant(log.action)}>{log.action}</Badge>,
     },
     {
       key: 'entityType',
       label: 'Entity Type',
       sortable: true,
-      render: (log: any) => (
+      render: (log: AuditLog) => (
         <span className="px-2 py-1 bg-gray-100 dark:bg-gray-700 rounded text-xs font-medium">
           {log.entityType}
         </span>
@@ -82,29 +130,27 @@ export default function AuditLogsPage() {
     {
       key: 'entityId',
       label: 'Entity ID',
-      render: (log: any) => (
+      render: (log: AuditLog) => (
         <span className="font-mono text-xs text-muted-foreground">
-          {log.entityId ? log.entityId.substring(0, 12) : 'System'}
+          {log.entityId ? log.entityId.substring(0, 12) : '—'}
         </span>
       ),
     },
     {
       key: 'user',
       label: 'User',
-      render: (log: any) => (
+      render: (log: AuditLog) => (
         <div>
-          <div className="font-medium text-sm">{log.user?.fullName || 'System'}</div>
-          <div className="text-xs text-muted-foreground">{log.user?.email || log.userId || 'N/A'}</div>
+          <div className="font-medium text-sm">{actorName(log)}</div>
+          <div className="text-xs text-muted-foreground font-mono">{actorDetail(log)}</div>
         </div>
       ),
     },
     {
       key: 'ipAddress',
       label: 'IP Address',
-      render: (log: any) => (
-        <span className="text-xs text-muted-foreground font-mono">
-          {log.ipAddress || 'N/A'}
-        </span>
+      render: (log: AuditLog) => (
+        <span className="text-xs text-muted-foreground font-mono">{log.ipAddress || 'N/A'}</span>
       ),
     },
   ];
@@ -112,7 +158,7 @@ export default function AuditLogsPage() {
   const actions = [
     {
       label: 'View Details',
-      onClick: (log: any) => {
+      onClick: (log: AuditLog) => {
         setSelectedLog(log);
         setShowDetailsModal(true);
       },
@@ -121,12 +167,60 @@ export default function AuditLogsPage() {
     },
   ];
 
-  const logs: any[] = Array.isArray(data?.items) ? data.items : [];
-  const stats = {
-    total: logs.length,
-    creates: logs.filter((l: any) => l.action === 'CREATE').length,
-    updates: logs.filter((l: any) => l.action === 'UPDATE').length,
-    deletes: logs.filter((l: any) => l.action === 'DELETE').length,
+  /**
+   * Exports every row matching the current filters, not just the page on screen — pulled in
+   * API-sized batches so a year of logs doesn't arrive as one request.
+   */
+  const exportCsv = async () => {
+    setExporting(true);
+    try {
+      const batch = 200;
+      const rows: AuditLog[] = [];
+      for (let offset = 0; offset < total; offset += batch) {
+        const chunk = await auditApi.getLogs({ ...filters, limit: batch, offset });
+        const items: AuditLog[] = Array.isArray(chunk?.items) ? chunk.items : [];
+        if (!items.length) break;
+        rows.push(...items);
+      }
+      if (!rows.length) return;
+
+      const headers = [
+        'Timestamp',
+        'Action',
+        'Entity Type',
+        'Entity ID',
+        'User Name',
+        'User Phone',
+        'User ID',
+        'IP Address',
+        'Old Data',
+        'New Data',
+      ];
+      const body = rows.map((l) => [
+        formatDateTime(l.createdAt),
+        l.action,
+        l.entityType,
+        l.entityId || '',
+        l.userName || '',
+        l.userPhone || '',
+        l.iamUserId || '',
+        l.ipAddress || '',
+        l.oldData ? JSON.stringify(l.oldData) : '',
+        l.newData ? JSON.stringify(l.newData) : '',
+      ]);
+      const csv = [headers, ...body]
+        .map((r) => r.map((v) => `"${String(v).replace(/"/g, '""')}"`).join(','))
+        .join('\n');
+      const blob = new Blob([csv], { type: 'text/csv' });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = `audit-logs-${new Date().toISOString().split('T')[0]}.csv`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } finally {
+      setExporting(false);
+    }
   };
 
   return (
@@ -136,63 +230,39 @@ export default function AuditLogsPage() {
           <h1 className="text-3xl font-bold text-foreground">Audit Logs</h1>
           <p className="text-muted-foreground mt-1">Track all system activities and changes</p>
         </div>
-        <ActionButton
-          icon={Download}
-          variant="secondary"
-          onClick={() => {
-            const items: any[] = Array.isArray(data?.items) ? data!.items : [];
-            if (!items.length) return;
-            const headers = ['Timestamp', 'Action', 'Entity Type', 'Entity ID', 'User ID', 'IP Address'];
-            const rows = items.map((l: any) => [
-              formatDateTime(l.createdAt),
-              l.action,
-              l.entityType,
-              l.entityId || '',
-              l.iamUserId || l.userId || '',
-              l.ipAddress || '',
-            ]);
-            const csv = [headers, ...rows].map(r => r.map((v: string) => `"${String(v).replace(/"/g, '""')}"`).join(',')).join('\n');
-            const blob = new Blob([csv], { type: 'text/csv' });
-            const url = URL.createObjectURL(blob);
-            const a = document.createElement('a');
-            a.href = url;
-            a.download = `audit-logs-${new Date().toISOString().split('T')[0]}.csv`;
-            a.click();
-            URL.revokeObjectURL(url);
-          }}
-        >
-          Export CSV
+        <ActionButton icon={Download} variant="secondary" onClick={exportCsv} disabled={exporting || !total}>
+          {exporting ? 'Exporting…' : 'Export CSV'}
         </ActionButton>
       </div>
 
-      {/* Stats Cards */}
+      {/* Stats — counts come from the API under the active filters, not the visible page */}
       <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
         <div className="card">
           <div className="text-muted-foreground text-sm font-medium">Total Logs</div>
-          <div className="text-2xl font-bold mt-2">{stats.total}</div>
+          <div className="text-2xl font-bold mt-2">{total}</div>
         </div>
         <div className="card">
           <div className="text-green-600 text-sm font-medium">Created</div>
-          <div className="text-2xl font-bold mt-2">{stats.creates}</div>
+          <div className="text-2xl font-bold mt-2">{creates.data?.total ?? '—'}</div>
         </div>
         <div className="card">
           <div className="text-blue-600 text-sm font-medium">Updated</div>
-          <div className="text-2xl font-bold mt-2">{stats.updates}</div>
+          <div className="text-2xl font-bold mt-2">{updates.data?.total ?? '—'}</div>
         </div>
         <div className="card">
           <div className="text-red-600 text-sm font-medium">Deleted</div>
-          <div className="text-2xl font-bold mt-2">{stats.deletes}</div>
+          <div className="text-2xl font-bold mt-2">{deletes.data?.total ?? '—'}</div>
         </div>
       </div>
 
       {/* Filters */}
       <div className="card">
-        <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
-          <div>
-            <label className="label">Search (User/Entity ID)</label>
+        <div className="grid grid-cols-1 md:grid-cols-3 lg:grid-cols-6 gap-4">
+          <div className="lg:col-span-2">
+            <label className="label">Search (User / Entity ID)</label>
             <input
               type="text"
-              placeholder="Search logs..."
+              placeholder="Name, phone, user ID, entity ID…"
               className="input"
               value={filters.search}
               onChange={(e) => setFilters({ ...filters, search: e.target.value })}
@@ -206,11 +276,11 @@ export default function AuditLogsPage() {
               onChange={(e) => setFilters({ ...filters, action: e.target.value })}
             >
               <option value="">All Actions</option>
-              <option value="CREATE">Create</option>
-              <option value="UPDATE">Update</option>
-              <option value="DELETE">Delete</option>
-              <option value="LOGIN">Login</option>
-              <option value="LOGOUT">Logout</option>
+              {actionOptions.map((a) => (
+                <option key={a} value={a}>
+                  {a}
+                </option>
+              ))}
             </select>
           </div>
           <div>
@@ -221,55 +291,42 @@ export default function AuditLogsPage() {
               onChange={(e) => setFilters({ ...filters, entityType: e.target.value })}
             >
               <option value="">All Types</option>
-              <optgroup label="Master Data">
-                <option value="Station">Station</option>
-                <option value="Route">Route</option>
-                <option value="RouteStop">Route Stop</option>
-                <option value="Train">Train</option>
-                <option value="TrainSchedule">Train Schedule</option>
-                <option value="Coach">Coach</option>
-                <option value="CoachType">Coach Type</option>
-                <option value="SeatClass">Seat Class</option>
-                <option value="FareRule">Fare Rule</option>
-                <option value="RouteFareRule">Route Fare Rule</option>
-                <option value="SegmentFareRule">Segment Fare Rule</option>
-                <option value="BaggageAllowance">Baggage Allowance</option>
-              </optgroup>
-              <optgroup label="Operations">
-                <option value="Booking">Booking</option>
-                <option value="Payment">Payment</option>
-                <option value="Ticket">Ticket</option>
-                <option value="Seat">Seat</option>
-                <option value="SeatBlock">Seat Block</option>
-              </optgroup>
-              <optgroup label="Users & Access">
-                <option value="User">User</option>
-                <option value="Agent">Agent</option>
-                <option value="Passenger">Passenger</option>
-              </optgroup>
-              <optgroup label="System & Features">
-                <option value="Notification">Notification</option>
-                <option value="Promotion">Promotion</option>
-                <option value="Loyalty">Loyalty</option>
-                <option value="Wallet">Wallet</option>
-                <option value="FraudAlert">Fraud Alert</option>
-                <option value="FraudRule">Fraud Rule</option>
-              </optgroup>
+              {entityTypeOptions.map((t) => (
+                <option key={t} value={t}>
+                  {t}
+                </option>
+              ))}
             </select>
           </div>
-          <div className="flex items-end">
-            <ActionButton
-              variant="secondary"
-              onClick={() => setFilters({ search: '', action: '', entityType: '' })}
-              className="w-full"
-            >
-              Clear Filters
-            </ActionButton>
+          <div>
+            <label className="label">From</label>
+            <input
+              type="date"
+              className="input"
+              value={filters.from}
+              onChange={(e) => setFilters({ ...filters, from: e.target.value })}
+            />
           </div>
+          <div>
+            <label className="label">To</label>
+            <input
+              type="date"
+              className="input"
+              value={filters.to}
+              onChange={(e) => setFilters({ ...filters, to: e.target.value })}
+            />
+          </div>
+        </div>
+        <div className="mt-4 flex justify-end">
+          <ActionButton
+            variant="secondary"
+            onClick={() => setFilters({ search: '', action: '', entityType: '', from: '', to: '' })}
+          >
+            Clear Filters
+          </ActionButton>
         </div>
       </div>
 
-      {/* Data Table */}
       <DataTable
         data={logs}
         columns={columns}
@@ -278,136 +335,205 @@ export default function AuditLogsPage() {
         emptyMessage="No audit logs found"
       />
 
+      {/* Pagination */}
+      <div className="flex items-center justify-between">
+        <p className="text-sm text-muted-foreground">
+          {total === 0
+            ? 'No results'
+            : `Showing ${page * PAGE_SIZE + 1}–${Math.min((page + 1) * PAGE_SIZE, total)} of ${total}`}
+        </p>
+        <div className="flex items-center gap-2">
+          <ActionButton
+            variant="secondary"
+            icon={ChevronLeft}
+            disabled={page === 0}
+            onClick={() => setPage((p) => Math.max(0, p - 1))}
+          >
+            Previous
+          </ActionButton>
+          <span className="text-sm text-muted-foreground px-2">
+            Page {page + 1} of {pageCount}
+          </span>
+          <ActionButton
+            variant="secondary"
+            icon={ChevronRight}
+            disabled={page + 1 >= pageCount}
+            onClick={() => setPage((p) => p + 1)}
+          >
+            Next
+          </ActionButton>
+        </div>
+      </div>
+
       {/* Details Modal */}
       <Modal
         isOpen={showDetailsModal}
-        onClose={() => { setShowDetailsModal(false); setSelectedLog(null); }}
+        onClose={() => {
+          setShowDetailsModal(false);
+          setSelectedLog(null);
+        }}
         title="Audit Log Details"
         size="xl"
       >
-        {selectedLog && (() => {
-          const l = selectedLog;
-          const actionColor: Record<string, string> = {
-            CREATE: 'from-emerald-600 to-emerald-700',
-            UPDATE: 'from-blue-600 to-blue-700',
-            DELETE: 'from-red-600 to-red-700',
-            LOGIN:  'from-violet-600 to-violet-700',
-            LOGOUT: 'from-gray-600 to-gray-700',
-          };
-          const gradient = actionColor[l.action] || 'from-gray-600 to-gray-700';
+        {selectedLog &&
+          (() => {
+            const l: AuditLog = selectedLog;
+            const gradient = CREATIVE_ACTIONS.has(l.action)
+              ? 'from-emerald-600 to-emerald-700'
+              : DESTRUCTIVE_ACTIONS.has(l.action)
+                ? 'from-red-600 to-red-700'
+                : 'from-blue-600 to-blue-700';
 
-          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>
-              <p className={`text-sm font-semibold text-foreground${mono ? ' font-mono' : ''}${truncate ? ' truncate' : ''}`} title={value}>{value || '—'}</p>
-            </div>
-          );
-
-          const SectionHeader = ({ title }: { title: string }) => (
-            <h3 className="text-xs font-bold uppercase tracking-widest text-muted-foreground mb-3 flex items-center gap-2">
-              <span className="w-4 h-px bg-muted-foreground/40 inline-block" />{title}
-            </h3>
-          );
-
-          return (
-            <div>
-              <div className={`-mx-6 -mt-4 mb-6 px-6 py-5 bg-gradient-to-r ${gradient} rounded-t-lg`}>
-                <div className="flex items-start justify-between gap-4">
-                  <div>
-                    <p className="text-white/70 text-xs font-semibold uppercase tracking-widest mb-1">Action</p>
-                    <p className="text-white text-2xl font-bold">{l.action}</p>
-                  </div>
-                  <div className="text-right shrink-0">
-                    <span className="inline-block bg-white/20 text-white text-xs font-mono px-3 py-1 rounded-full">{l.entityType}</span>
-                    <p className="text-white/70 text-xs mt-2">{formatDateTime(l.createdAt)}</p>
-                  </div>
-                </div>
-                <div className="mt-4 grid grid-cols-2 gap-3">
-                  <div className="bg-white/10 rounded-lg px-3 py-2">
-                    <p className="text-white/70 text-xs">User</p>
-                    <p className="text-white text-sm font-bold truncate">{l.user?.fullName || 'System'}</p>
-                  </div>
-                  <div className="bg-white/10 rounded-lg px-3 py-2">
-                    <p className="text-white/70 text-xs">IP Address</p>
-                    <p className="text-white text-sm font-mono font-bold">{l.ipAddress || 'N/A'}</p>
-                  </div>
-                </div>
+            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>
+                <p
+                  className={`text-sm font-semibold text-foreground${mono ? ' font-mono' : ''}${truncate ? ' truncate' : ''}`}
+                  title={value}
+                >
+                  {value || '—'}
+                </p>
               </div>
+            );
 
-              <div className="space-y-6">
-                <section>
-                  <SectionHeader title="Event Details" />
-                  <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
-                    <Field label="Action" value={l.action} />
-                    <Field label="Entity Type" value={l.entityType} mono />
-                    <Field label="Entity ID" value={l.entityId || 'System'} mono truncate />
-                    <Field label="Timestamp" value={formatDateTime(l.createdAt)} />
+            const SectionHeader = ({ title }: { title: string }) => (
+              <h3 className="text-xs font-bold uppercase tracking-widest text-muted-foreground mb-3 flex items-center gap-2">
+                <span className="w-4 h-px bg-muted-foreground/40 inline-block" />
+                {title}
+              </h3>
+            );
+
+            return (
+              <div>
+                <div className={`-mx-6 -mt-4 mb-6 px-6 py-5 bg-gradient-to-r ${gradient} rounded-t-lg`}>
+                  <div className="flex items-start justify-between gap-4">
+                    <div>
+                      <p className="text-white/70 text-xs font-semibold uppercase tracking-widest mb-1">Action</p>
+                      <p className="text-white text-2xl font-bold">{l.action}</p>
+                    </div>
+                    <div className="text-right shrink-0">
+                      <span className="inline-block bg-white/20 text-white text-xs font-mono px-3 py-1 rounded-full">
+                        {l.entityType}
+                      </span>
+                      <p className="text-white/70 text-xs mt-2">{formatDateTime(l.createdAt)}</p>
+                    </div>
                   </div>
-                </section>
+                  <div className="mt-4 grid grid-cols-2 gap-3">
+                    <div className="bg-white/10 rounded-lg px-3 py-2">
+                      <p className="text-white/70 text-xs">User</p>
+                      <p className="text-white text-sm font-bold truncate">{actorName(l)}</p>
+                    </div>
+                    <div className="bg-white/10 rounded-lg px-3 py-2">
+                      <p className="text-white/70 text-xs">IP Address</p>
+                      <p className="text-white text-sm font-mono font-bold">{l.ipAddress || 'N/A'}</p>
+                    </div>
+                  </div>
+                </div>
+
+                <div className="space-y-6">
+                  <section>
+                    <SectionHeader title="Event Details" />
+                    <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
+                      <Field label="Action" value={l.action} />
+                      <Field label="Entity Type" value={l.entityType} mono />
+                      <Field label="Entity ID" value={l.entityId} mono truncate />
+                      <Field label="Timestamp" value={formatDateTime(l.createdAt)} />
+                    </div>
+                  </section>
 
-                {l.user && (
                   <section>
                     <SectionHeader title="User Information" />
                     <div className="grid grid-cols-2 md:grid-cols-3 gap-3">
-                      <Field label="Full Name" value={l.user.fullName} />
-                      <Field label="Email" value={l.user.email} truncate />
-                      <Field label="User ID" value={l.userId} mono truncate />
+                      <Field label="Name" value={l.userName} />
+                      <Field label="Phone" value={l.userPhone} mono />
+                      <Field label="IAM User ID" value={l.iamUserId} mono truncate />
                     </div>
                   </section>
-                )}
 
-                {(l.ipAddress || l.userAgent) && (
-                  <section>
-                    <SectionHeader title="Network Information" />
-                    <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
-                      <Field label="IP Address" value={l.ipAddress} mono />
-                      <div className="bg-muted/40 rounded-lg p-3">
-                        <p className="text-xs text-muted-foreground mb-1">User Agent</p>
-                        <p className="text-xs font-mono text-foreground break-all leading-relaxed">{l.userAgent || '—'}</p>
+                  {(l.ipAddress || l.userAgent) && (
+                    <section>
+                      <SectionHeader title="Network Information" />
+                      <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
+                        <Field label="IP Address" value={l.ipAddress} mono />
+                        <div className="bg-muted/40 rounded-lg p-3">
+                          <p className="text-xs text-muted-foreground mb-1">User Agent</p>
+                          <p className="text-xs font-mono text-foreground break-all leading-relaxed">
+                            {l.userAgent || '—'}
+                          </p>
+                        </div>
                       </div>
-                    </div>
-                  </section>
-                )}
+                    </section>
+                  )}
+
+                  {(l.oldData || l.newData) && (
+                    <section>
+                      <SectionHeader title="Data Changes" />
+                      <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
+                        {l.oldData && (
+                          <div>
+                            <p className="text-xs font-bold text-red-600 dark:text-red-400 mb-2 uppercase tracking-wide">
+                              ← Before
+                            </p>
+                            <pre className="text-xs p-3 bg-red-50 dark:bg-red-950/20 rounded-lg border border-red-200 dark:border-red-900 overflow-auto max-h-52 text-muted-foreground leading-relaxed">
+                              {formatJsonData(l.oldData)}
+                            </pre>
+                          </div>
+                        )}
+                        {l.newData && (
+                          <div>
+                            <p className="text-xs font-bold text-emerald-600 dark:text-emerald-400 mb-2 uppercase tracking-wide">
+                              → After
+                            </p>
+                            <pre className="text-xs p-3 bg-emerald-50 dark:bg-emerald-950/20 rounded-lg border border-emerald-200 dark:border-emerald-900 overflow-auto max-h-52 text-muted-foreground leading-relaxed">
+                              {formatJsonData(l.newData)}
+                            </pre>
+                          </div>
+                        )}
+                      </div>
+                    </section>
+                  )}
 
-                {(l.oldData || l.newData) && (
                   <section>
-                    <SectionHeader title="Data Changes" />
-                    <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
-                      {l.oldData && (
-                        <div>
-                          <p className="text-xs font-bold text-red-600 dark:text-red-400 mb-2 uppercase tracking-wide">← Before</p>
-                          <pre className="text-xs p-3 bg-red-50 dark:bg-red-950/20 rounded-lg border border-red-200 dark:border-red-900 overflow-auto max-h-52 text-muted-foreground leading-relaxed">
-                            {formatJsonData(l.oldData)}
-                          </pre>
-                        </div>
-                      )}
-                      {l.newData && (
-                        <div>
-                          <p className="text-xs font-bold text-emerald-600 dark:text-emerald-400 mb-2 uppercase tracking-wide">→ After</p>
-                          <pre className="text-xs p-3 bg-emerald-50 dark:bg-emerald-950/20 rounded-lg border border-emerald-200 dark:border-emerald-900 overflow-auto max-h-52 text-muted-foreground leading-relaxed">
-                            {formatJsonData(l.newData)}
-                          </pre>
-                        </div>
-                      )}
+                    <SectionHeader title="System" />
+                    <div className="grid grid-cols-1 gap-3">
+                      <Field label="Log ID" value={l.id} mono truncate />
                     </div>
                   </section>
-                )}
+                </div>
 
-                <section>
-                  <SectionHeader title="System" />
-                  <div className="grid grid-cols-1 gap-3">
-                    <Field label="Log ID" value={l.id} mono truncate />
-                  </div>
-                </section>
+                <div className="flex justify-end gap-2 pt-6 mt-2 border-t border-muted">
+                  <ActionButton
+                    variant="secondary"
+                    onClick={() => {
+                      setShowDetailsModal(false);
+                      setSelectedLog(null);
+                    }}
+                  >
+                    Close
+                  </ActionButton>
+                </div>
               </div>
-
-              <div className="flex justify-end gap-2 pt-6 mt-2 border-t border-muted">
-                <ActionButton variant="secondary" onClick={() => { setShowDetailsModal(false); setSelectedLog(null); }}>Close</ActionButton>
-              </div>
-            </div>
-          );
-        })()}
+            );
+          })()}
       </Modal>
     </div>
   );
 }
+
+export default function AuditLogsPage() {
+  return (
+    <PermissionGuard permission={PERMS.audit.view}>
+      <AuditLogsPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/bookings/page.tsx b/apps/edr-passenger-web/backoffice/src/app/bookings/page.tsx
index a1909d6e8..fffe3722c 100644
--- a/apps/edr-passenger-web/backoffice/src/app/bookings/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/bookings/page.tsx
@@ -31,6 +31,9 @@ const SectionHeader = ({ title }: { title: string }) => (
 
 function BookingsPageContent() {
   const canManage = usePermission(PERMS.bookings.manage);
+  // Mirrors the API guard on POST /payments/:bookingId/force-confirm —
+  // tickets:generate, with the usual super-admin / org-admin bypass.
+  const canGenerateTicket = usePermission(PERMS.tickets.generate);
   const [filters, setFilters] = useState<BookingFilters>({ page: 1, pageSize: 20, search: '', status: '' });
   const [extraFilters, setExtraFilters] = useState({ bookingType: '', dateFrom: '', dateTo: '', paymentStatus: '', providerTxnId: '' });
   const [showExtraFilters, setShowExtraFilters] = useState(false);
@@ -298,7 +301,7 @@ function BookingsPageContent() {
 
   const actions = [
     { label: 'View Details', onClick: (b: any) => setSelectedBooking(b), variant: 'secondary' as const, icon: Eye },
-    { label: 'Generate Ticket', onClick: (b: any) => { setGenerateTicketForm({ paymentReference: '', paymentMethod: '', notes: '' }); setGenerateTicketTouched({ paymentReference: false, paymentMethod: false }); setGenerateTicketBooking(b); }, variant: 'secondary' as const, icon: Ticket, show: (b: any) => !(b.status === 'CONFIRMED' && b.paymentIntent?.status === 'SUCCEEDED') },
+    { label: 'Generate Ticket', onClick: (b: any) => { setGenerateTicketForm({ paymentReference: '', paymentMethod: '', notes: '' }); setGenerateTicketTouched({ paymentReference: false, paymentMethod: false }); setGenerateTicketBooking(b); }, variant: 'secondary' as const, icon: Ticket, show: (b: any) => canGenerateTicket && !(b.status === 'CONFIRMED' && b.paymentIntent?.status === 'SUCCEEDED') },
     { label: 'Delete', onClick: (b: any) => { setDeleteError(null); setDeleteCascade(false); setDeleteCascadeChecked(false); setBookingToDelete(b); setDeleteConfirmOpen(true); }, variant: 'danger' as const, icon: Trash2 },
   ];
 
diff --git a/apps/edr-passenger-web/backoffice/src/app/classes/page.tsx b/apps/edr-passenger-web/backoffice/src/app/classes/page.tsx
index af2cab29b..ed6f71acb 100644
--- a/apps/edr-passenger-web/backoffice/src/app/classes/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/classes/page.tsx
@@ -10,8 +10,10 @@ import Modal from '@/components/ui/Modal';
 import ConfirmDialog from '@/components/ui/ConfirmDialog';
 import { seatClassesApi, apiClient } from '@/lib/api';
 import { formatCurrency } from '@/lib/utils';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
 
-export default function ClassesPage() {
+function ClassesPageContent() {
   const [filters, setFilters] = useState({ search: '' });
   const [showModal, setShowModal] = useState(false);
   const [editingClass, setEditingClass] = useState<any>(null);
@@ -352,3 +354,11 @@ export default function ClassesPage() {
     </div>
   );
 }
+
+export default function ClassesPage() {
+  return (
+    <PermissionGuard permission={PERMS.classes.view}>
+      <ClassesPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/coaches/page.tsx b/apps/edr-passenger-web/backoffice/src/app/coaches/page.tsx
index acb0deefa..408ebb352 100644
--- a/apps/edr-passenger-web/backoffice/src/app/coaches/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/coaches/page.tsx
@@ -10,6 +10,8 @@ import ConfirmDialog from '@/components/ui/ConfirmDialog';
 import { fleetApi, apiClient } from '@/lib/api';
 import Pagination from '@/components/ui/Pagination';
 import { usePagination } from '@/lib/use-pagination';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
 
 type Tab = 'types' | 'coaches' | 'utilization';
 
@@ -142,7 +144,7 @@ const renderBedVisualization = (coach: any) => {
   );
 };
 
-export default function CoachesPage() {
+function CoachesPageContent() {
   const [activeTab, setActiveTab] = useState<Tab>('coaches');
   const [search, setSearch] = useState('');
   const [showModal, setShowModal] = useState(false);
@@ -929,3 +931,11 @@ export default function CoachesPage() {
     </div>
   );
 }
+
+export default function CoachesPage() {
+  return (
+    <PermissionGuard permission={PERMS.coaches.view}>
+      <CoachesPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/dashboard/page.tsx b/apps/edr-passenger-web/backoffice/src/app/dashboard/page.tsx
index 7eede0089..8bd064c59 100644
--- a/apps/edr-passenger-web/backoffice/src/app/dashboard/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/dashboard/page.tsx
@@ -12,6 +12,7 @@ import {
   ScanLine,
 } from "lucide-react";
 import { dashboardApi } from "@/lib/api/dashboard";
+import DashboardBookingCharts from "@/components/dashboard/DashboardBookingCharts";
 import { apiClient } from "@/lib/api-client";
 import { formatCurrency } from "@/lib/utils";
 import { PieChart, Pie, Cell, Tooltip, ResponsiveContainer } from "recharts";
@@ -312,7 +313,7 @@ function DashboardPageContent() {
                 </div>
               </div>
               <Link
-                href="/payments"
+                href="/payments?status=SUCCEEDED&bookingStatus=CONFIRMED,BOARDED"
                 className="flex items-center gap-1 text-xs text-primary hover:underline mt-auto pt-1"
               >
                 View payments <ArrowRight className="h-3 w-3" />
@@ -322,6 +323,9 @@ function DashboardPageContent() {
         </div>
       </div>
 
+      {/* Booking charts — self-contained; degrades to a single line if its endpoint fails. */}
+      <DashboardBookingCharts />
+
       {/* Revenue breakdown */}
       <div className="card">
         <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground mb-4">
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 4f0098792..899e8cd11 100644
--- a/apps/edr-passenger-web/backoffice/src/app/login/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/login/page.tsx
@@ -20,13 +20,15 @@ const features = [
 ];
 
 export default function LoginPage() {
-  const [email, setEmail]         = useState('');
+  // Accepts an email address, phone number, or username — sent to the IAM in
+  // the `email` field either way (the backend contract does not change).
+  const [identifier, setIdentifier] = useState('');
   const [password, setPassword]   = useState('');
   const [loading, setLoading]     = useState(false);
   const [error, setError]         = useState('');
   const [showPassword, setShowPassword] = useState(false);
   const [isMounted, setIsMounted] = useState(false);
-  const [emailFocused, setEmailFocused]       = useState(false);
+  const [identifierFocused, setIdentifierFocused] = useState(false);
   const [passwordFocused, setPasswordFocused] = useState(false);
 
   const [view, setView]                       = useState<'login' | 'forgot'>('login');
@@ -47,7 +49,7 @@ export default function LoginPage() {
     setLoading(true);
     setError('');
     try {
-      await login(email, password);
+      await login(identifier.trim(), password);
       router.push('/dashboard');
     } catch (err: any) {
       const msg = err.message || err.response?.data?.message || '';
@@ -152,26 +154,29 @@ export default function LoginPage() {
 
             <form onSubmit={handleSubmit} className="space-y-4 animate-fade-up" style={{ animationDelay: '80ms' }}>
 
-              {/* Email field */}
+              {/* Identifier field — email, phone number, or username */}
               <div>
                 <label className="block text-xs font-semibold text-gray-600 dark:text-gray-400 uppercase tracking-wider mb-2">
-                  Email address
+                  Email, phone or username
                 </label>
                 <div className={`relative rounded-xl transition-all duration-200 ${
-                  emailFocused
+                  identifierFocused
                     ? 'ring-2 ring-[rgb(20,113,76)] ring-offset-0'
                     : 'ring-1 ring-gray-200 dark:ring-gray-800'
                 }`}>
                   <input
-                    type="email"
-                    value={email}
-                    onChange={(e) => { setEmail(e.target.value); setError(''); }}
-                    onFocus={() => setEmailFocused(true)}
-                    onBlur={() => setEmailFocused(false)}
+                    type="text"
+                    value={identifier}
+                    onChange={(e) => { setIdentifier(e.target.value); setError(''); }}
+                    onFocus={() => setIdentifierFocused(true)}
+                    onBlur={() => setIdentifierFocused(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, +251… or username"
                     required
-                    autoComplete="email"
+                    autoCapitalize="none"
+                    autoCorrect="off"
+                    spellCheck={false}
+                    autoComplete="username"
                   />
                 </div>
               </div>
@@ -209,7 +214,7 @@ export default function LoginPage() {
                 <div className="flex justify-end mt-2">
                   <button
                     type="button"
-                    onClick={() => { setView('forgot'); setForgotIdentifier(email); setError(''); }}
+                    onClick={() => { setView('forgot'); setForgotIdentifier(identifier); setError(''); }}
                     className="text-xs font-medium text-[rgb(20,113,76)] hover:underline"
                   >
                     Forgot password?
@@ -220,9 +225,9 @@ export default function LoginPage() {
               {/* Submit */}
               <button
                 type="submit"
-                disabled={loading || !email || !password}
+                disabled={loading || !identifier.trim() || !password}
                 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: loading || !email || !password
+                style={{ background: loading || !identifier.trim() || !password
                   ? '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/app/payments/page.tsx b/apps/edr-passenger-web/backoffice/src/app/payments/page.tsx
index 9cbfdd4e3..0bef617c1 100644
--- a/apps/edr-passenger-web/backoffice/src/app/payments/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/payments/page.tsx
@@ -1,8 +1,9 @@
 'use client';
 
-import { useState } from 'react';
+import { Suspense, useEffect, useState } from 'react';
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
-import { Download, Eye, Trash2, AlertCircle, Send, CheckCircle, XCircle, RotateCcw } from 'lucide-react';
+import { useRouter, useSearchParams } from 'next/navigation';
+import { Download, Eye, Trash2, AlertCircle, Send, CheckCircle, XCircle, RotateCcw, X } from 'lucide-react';
 import DataTable from '@/components/ui/DataTable';
 import Badge from '@/components/ui/Badge';
 import ActionButton from '@/components/ui/ActionButton';
@@ -22,6 +23,18 @@ import {
 
 type PageTab = 'payments' | 'supplementary';
 
+// PaymentIntentStatus values, as actually defined on the backend — the dropdown used to
+// offer PENDING/COMPLETED/FAILED, none of which are real values, so selecting them just
+// returned nothing.
+const PAYMENT_STATUS_OPTIONS = [
+  { value: 'SUCCEEDED', label: 'Succeeded' },
+  { value: 'PROCESSING', label: 'Processing' },
+  { value: 'REQUIRES_ACTION', label: 'Requires Action' },
+  { value: 'FAILED', label: 'Failed' },
+  { value: 'CANCELLED', label: 'Cancelled' },
+  { value: 'REFUNDED', label: 'Refunded' },
+];
+
 const STATUS_COLORS: Record<string, string> = {
   PENDING: 'warning',
   PAID: 'success',
@@ -42,9 +55,29 @@ const SectionHeader = ({ title }: { title: string }) => (
   </h3>
 );
 
-export default function PaymentsPage() {
+function PaymentsPageContent() {
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  // A link can pre-filter this page — the dashboard's Revenue card links here with
+  // status=SUCCEEDED&bookingStatus=CONFIRMED,BOARDED so "view payments" shows exactly the
+  // payments that make up that revenue figure, not every payment attempt.
   const [pageTab, setPageTab] = useState<PageTab>('payments');
-  const [filters, setFilters] = useState({ search: '', status: '', method: '' });
+  const [filters, setFilters] = useState({
+    search: '',
+    status: searchParams.get('status') ?? '',
+    method: '',
+    bookingStatus: searchParams.get('bookingStatus') ?? '',
+  });
+
+  // useState's initializer only runs on first mount — if this page was already mounted from
+  // an earlier visit (e.g. the sidebar link), Next's client-side navigation to a new
+  // ?status=...&bookingStatus=... URL does NOT remount the component, so the filters above
+  // would silently keep whatever was set before. Re-sync whenever the URL itself changes.
+  useEffect(() => {
+    const status = searchParams.get('status') ?? '';
+    const bookingStatus = searchParams.get('bookingStatus') ?? '';
+    setFilters((f) => (f.status === status && f.bookingStatus === bookingStatus ? f : { ...f, status, bookingStatus }));
+  }, [searchParams]);
   const [selectedPayment, setSelectedPayment] = useState<any>(null);
   const [deleteConfirmOpen, setDeleteConfirmOpen] = useState(false);
   const [paymentToDelete, setPaymentToDelete] = useState<any>(null);
@@ -108,6 +141,7 @@ export default function PaymentsPage() {
       search: filters.search || undefined,
       status: filters.status || undefined,
       method: filters.method || undefined,
+      bookingStatus: filters.bookingStatus || undefined,
     }),
   });
 
@@ -168,7 +202,8 @@ export default function PaymentsPage() {
     { key: 'booking', label: 'Booking', render: (payment: any) => payment.booking?.bookingRef || 'N/A' },
     { key: 'amount', label: 'Amount', render: (payment: any) => formatCurrency(payment.booking?.totalMinor ?? payment.amountMinor, 'ETB') },
     { key: 'method', label: 'Method', render: (payment: any) => <Badge>{payment.method}</Badge> },
-    { key: 'status', label: 'Status', render: (payment: any) => <Badge variant="status" status={payment.status}>{payment.status}</Badge> },
+    { key: 'status', label: 'Payment Status', render: (payment: any) => <Badge variant="status" status={payment.status}>{payment.status}</Badge> },
+    { key: 'bookingStatus', label: 'Booking Status', render: (payment: any) => payment.booking?.status ? <Badge variant="status" status={payment.booking.status}>{payment.booking.status}</Badge> : '—' },
     { key: 'createdAt', label: 'Created', render: (payment: any) => formatDateTime(payment.createdAt) },
   ];
 
@@ -286,18 +321,33 @@ export default function PaymentsPage() {
         {successMessage && (
           <div className="mb-4 rounded-lg bg-green-50 dark:bg-green-900/20 p-4 text-sm text-green-800 dark:text-green-200">✓ {successMessage}</div>
         )}
+        {filters.bookingStatus && (
+          <div className="mb-4 flex items-center justify-between rounded-lg bg-emerald-50 dark:bg-emerald-900/20 p-3 text-sm text-emerald-800 dark:text-emerald-200">
+            <span>
+              Showing payments backing <strong>{filters.bookingStatus.split(',').join(' / ')}</strong> bookings only —
+              the same confirmed revenue the dashboard total is built from.
+            </span>
+            <button
+              type="button"
+              onClick={() => { setFilters({ ...filters, status: '', bookingStatus: '' }); router.replace('/payments'); }}
+              className="flex items-center gap-1 font-medium hover:underline shrink-0 ml-3"
+            >
+              <X className="w-3.5 h-3.5" /> Clear
+            </button>
+          </div>
+        )}
         <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
           <div>
             <label className="label">Search</label>
             <input type="text" placeholder="Search..." className="input" value={filters.search} onChange={(e) => setFilters({ ...filters, search: e.target.value })} />
           </div>
           <div>
-            <label className="label">Status</label>
+            <label className="label">Payment Status</label>
             <select className="input" value={filters.status} onChange={(e) => setFilters({ ...filters, status: e.target.value })}>
               <option value="">All Status</option>
-              <option value="PENDING">Pending</option>
-              <option value="COMPLETED">Completed</option>
-              <option value="FAILED">Failed</option>
+              {PAYMENT_STATUS_OPTIONS.map((opt) => (
+                <option key={opt.value} value={opt.value}>{opt.label}</option>
+              ))}
             </select>
           </div>
           <div>
@@ -478,3 +528,11 @@ export default function PaymentsPage() {
     </div>
   );
 }
+
+export default function PaymentsPage() {
+  return (
+    <Suspense fallback={null}>
+      <PaymentsPageContent />
+    </Suspense>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/reports/finance/layout.tsx b/apps/edr-passenger-web/backoffice/src/app/reports/finance/layout.tsx
new file mode 100644
index 000000000..790272de1
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/app/reports/finance/layout.tsx
@@ -0,0 +1,3 @@
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return <>{children}</>;
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/reports/finance/page.tsx b/apps/edr-passenger-web/backoffice/src/app/reports/finance/page.tsx
new file mode 100644
index 000000000..b83e96ca7
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/app/reports/finance/page.tsx
@@ -0,0 +1,560 @@
+'use client';
+
+import { useMemo, useRef, useState } from 'react';
+import { useQuery } from '@tanstack/react-query';
+import { Banknote, BookOpen, FileSpreadsheet } from 'lucide-react';
+import {
+  Bar, BarChart, CartesianGrid, Line, LineChart,
+  ResponsiveContainer, Tooltip as RechartsTooltip, XAxis, YAxis,
+} from 'recharts';
+import { toPng } from 'html-to-image';
+import { apiClient } from '@/lib/api-client';
+import { financeApi, type FinanceGranularity, type FinanceSummaryFilters } from '@/lib/api/finance';
+import { buildFinanceWorkbook, type ChartImage } from '@/lib/export/finance-workbook';
+import ActionButton from '@/components/ui/ActionButton';
+import Pagination from '@/components/ui/Pagination';
+import Skeleton from '@/components/ui/Skeleton';
+import { usePagination } from '@/lib/use-pagination';
+import { formatCurrency } from '@/lib/utils';
+import { categoricalColor, getChartPalette } from '@/lib/chart-palette';
+import { useTheme } from '@/lib/theme-store';
+
+interface StationOption {
+  id: string;
+  name: string;
+  code: string;
+}
+
+// Fixed order so a method keeps its colour/slot when the method filter narrows the set.
+const PAYMENT_METHOD_ORDER = ['TELEBIRR', 'CBE_BIRR', 'EBIRR', 'WAAFI', 'CARD', 'WALLET', 'DMONEY', 'CAC_BANK', 'CBE_BILL'] as const;
+const PAYMENT_METHOD_LABELS: Record<string, string> = {
+  TELEBIRR: 'Telebirr',
+  CBE_BIRR: 'CBE Birr',
+  EBIRR: 'eBirr',
+  WAAFI: 'Waafi',
+  CARD: 'Card',
+  WALLET: 'Wallet',
+  DMONEY: 'DMoney',
+  CAC_BANK: 'CAC Bank',
+  CBE_BILL: 'CBE Bill',
+};
+function methodLabel(method: string): string {
+  return PAYMENT_METHOD_LABELS[method] ?? method;
+}
+
+function periodLabel(period: string, granularity: FinanceGranularity): string {
+  if (granularity === 'monthly') {
+    return new Date(`${period}-01T00:00:00`).toLocaleDateString('en-US', { month: 'short', year: 'numeric' });
+  }
+  return new Date(`${period}T00:00:00`).toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+}
+
+const TABLE_PAGE_SIZE = 25;
+
+/** Mirrors the loaded layout's shape (KPI tiles, two charts, method breakdown, detail table) so nothing jumps when data arrives. */
+function FinanceReportSkeleton() {
+  return (
+    <div className="space-y-6">
+      <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4">
+        {Array.from({ length: 3 }).map((_, i) => (
+          <div key={i} className="card flex flex-col gap-3">
+            <div className="flex items-center justify-between">
+              <Skeleton className="h-3 w-24" />
+              <Skeleton className="h-7 w-7 rounded-lg" />
+            </div>
+            <Skeleton className="h-7 w-32" />
+          </div>
+        ))}
+      </div>
+
+      <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
+        {Array.from({ length: 2 }).map((_, i) => (
+          <div key={i} className="card">
+            <Skeleton className="h-4 w-40 mb-4" />
+            <Skeleton className="h-[280px] w-full" />
+          </div>
+        ))}
+      </div>
+
+      <div className="card">
+        <Skeleton className="h-4 w-56 mb-2" />
+        <Skeleton className="h-3 w-32 mb-4" />
+        <Skeleton className="h-7 w-full mb-4" />
+        <div className="space-y-2">
+          {Array.from({ length: 4 }).map((_, i) => (
+            <Skeleton key={i} className="h-5 w-full" />
+          ))}
+        </div>
+      </div>
+
+      <div className="card p-0">
+        <div className="px-4 pt-4 pb-3">
+          <Skeleton className="h-4 w-52" />
+        </div>
+        <div className="px-4 pb-4 space-y-2">
+          {Array.from({ length: 8 }).map((_, i) => (
+            <Skeleton key={i} className="h-8 w-full" />
+          ))}
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export default function FinanceReportPage() {
+  const isDark = useTheme((s) => s.isDark);
+  const palette = getChartPalette(isDark);
+
+  const [dateRangePreset, setDateRangePreset] = useState('90');
+  const [customFrom, setCustomFrom] = useState('');
+  const [customTo, setCustomTo] = useState('');
+  const [granularity, setGranularity] = useState<FinanceGranularity>('daily');
+  const [originStationId, setOriginStationId] = useState('');
+  const [destinationStationId, setDestinationStationId] = useState('');
+  const [method, setMethod] = useState('');
+  const [exporting, setExporting] = useState(false);
+
+  // Chart cards are captured for the Excel export. There's one Trend/Segment/Method set per
+  // currency (see currencySections below), so refs are keyed by `${currency}-${chart}`.
+  const chartRefs = useRef<Record<string, HTMLDivElement | null>>({});
+  const setChartRef = (key: string) => (el: HTMLDivElement | null) => {
+    chartRefs.current[key] = el;
+  };
+
+  const { dateFrom, dateTo } = useMemo(() => {
+    const end = new Date();
+    end.setHours(23, 59, 59, 999);
+
+    if (dateRangePreset === 'custom') {
+      if (customFrom && customTo) {
+        return customFrom <= customTo
+          ? { dateFrom: customFrom, dateTo: customTo }
+          : { dateFrom: customTo, dateTo: customFrom };
+      }
+      const fallbackStart = new Date(end);
+      fallbackStart.setDate(end.getDate() - 90);
+      return {
+        dateFrom: fallbackStart.toISOString().split('T')[0],
+        dateTo: end.toISOString().split('T')[0],
+      };
+    }
+
+    const start = new Date(end);
+    start.setDate(end.getDate() - Number(dateRangePreset));
+    return {
+      dateFrom: start.toISOString().split('T')[0],
+      dateTo: end.toISOString().split('T')[0],
+    };
+  }, [dateRangePreset, customFrom, customTo]);
+
+  const filters: FinanceSummaryFilters = useMemo(
+    () => ({
+      dateFrom,
+      dateTo,
+      granularity,
+      originStationId: originStationId || undefined,
+      destinationStationId: destinationStationId || undefined,
+      method: method || undefined,
+    }),
+    [dateFrom, dateTo, granularity, originStationId, destinationStationId, method],
+  );
+
+  const { data: stations = [] } = useQuery<StationOption[]>({
+    queryKey: ['stations'],
+    queryFn: () => apiClient.get<StationOption[]>('/stations'),
+  });
+
+  const { data, isLoading, isFetching, isError } = useQuery({
+    queryKey: ['reports-finance', filters],
+    placeholderData: (previous) => previous,
+    queryFn: () => financeApi.getSummary(filters),
+  });
+
+  const rows = data?.rows ?? [];
+  const pg = usePagination(rows, TABLE_PAGE_SIZE);
+
+  const resetFilters = () => {
+    setDateRangePreset('90');
+    setCustomFrom('');
+    setCustomTo('');
+    setGranularity('daily');
+    setOriginStationId('');
+    setDestinationStationId('');
+    setMethod('');
+  };
+
+  /** Captures a chart card as a PNG data URL, sized to the card's actual on-screen pixels. */
+  const captureCard = async (node: HTMLDivElement | null): Promise<ChartImage | undefined> => {
+    if (!node) return undefined;
+    const rect = node.getBoundingClientRect();
+    const dataUrl = await toPng(node, { pixelRatio: 2, cacheBust: true, backgroundColor: palette.surface });
+    return { dataUrl, width: Math.round(rect.width), height: Math.round(rect.height) };
+  };
+
+  const doExport = async () => {
+    if (!data) return;
+    setExporting(true);
+    try {
+      const imagesByCurrency: Record<string, { trend?: ChartImage; segment?: ChartImage; method?: ChartImage }> = {};
+      await Promise.all(
+        currencySections.map(async (section) => {
+          const [trend, segment, methodImg] = await Promise.all([
+            captureCard(chartRefs.current[`${section.currency}-trend`]),
+            captureCard(chartRefs.current[`${section.currency}-segment`]),
+            captureCard(chartRefs.current[`${section.currency}-method`]),
+          ]);
+          imagesByCurrency[section.currency] = { trend, segment, method: methodImg };
+        }),
+      );
+
+      const stationLabel = (id: string) => stations.find((s) => s.id === id)?.name ?? 'Any';
+
+      const blob = await buildFinanceWorkbook({
+        report: data,
+        filters: {
+          dateFrom,
+          dateTo,
+          granularity,
+          originLabel: originStationId ? stationLabel(originStationId) : 'Any',
+          destinationLabel: destinationStationId ? stationLabel(destinationStationId) : 'Any',
+          methodLabel: method ? methodLabel(method) : 'All',
+        },
+        methodLabel,
+        periodLabel,
+        imagesByCurrency,
+      });
+
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = `finance-summary-${dateFrom}-to-${dateTo}.xlsx`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } finally {
+      setExporting(false);
+    }
+  };
+
+  const totals = useMemo(
+    () => (data?.totals ?? []).slice().sort((a, b) => b.revenueMinor - a.revenueMinor),
+    [data],
+  );
+  const totalBookings = totals.reduce((sum, t) => sum + t.bookingCount, 0);
+  const hasData = totalBookings > 0;
+
+  // Money is never comparable across currencies, so rather than scoping every chart to
+  // whichever currency happens to be biggest overall (which would silently drop a
+  // currency-specific method like Waafi/DJF from the payment-method breakdown whenever ETB
+  // dominates the total), each currency present gets its own full Trend/Segment/Method set.
+  const currencySections = useMemo(() => {
+    if (!data) return [];
+    return totals.map((t) => {
+      const trendData = data.byPeriod
+        .filter((p) => p.currency === t.currency)
+        .slice()
+        .sort((a, b) => a.key.localeCompare(b.key))
+        .map((p) => ({ label: periodLabel(p.label, data.granularity), revenue: p.revenueMinor / 100 }));
+
+      const segmentData = data.bySegment
+        .filter((r) => r.currency === t.currency)
+        .slice()
+        .sort((a, b) => b.revenueMinor - a.revenueMinor)
+        .map((r) => ({ label: r.label, revenue: r.revenueMinor }));
+
+      const methodRows = data.byMethod.filter((r) => r.currency === t.currency);
+      const methodTotal = methodRows.reduce((sum, r) => sum + r.revenueMinor, 0);
+      const methodBreakdown = methodRows
+        .slice()
+        .sort((a, b) => PAYMENT_METHOD_ORDER.indexOf(a.label as any) - PAYMENT_METHOD_ORDER.indexOf(b.label as any))
+        .map((r) => ({
+          ...r,
+          color: categoricalColor(palette, PAYMENT_METHOD_ORDER.indexOf(r.label as any)),
+          sharePercent: methodTotal > 0 ? (r.revenueMinor / methodTotal) * 100 : 0,
+        }));
+
+      return {
+        currency: t.currency,
+        revenueMinor: t.revenueMinor,
+        bookingCount: t.bookingCount,
+        trendData,
+        segmentData,
+        methodBreakdown,
+      };
+    });
+  }, [data, totals, palette]);
+
+  return (
+    <div className="space-y-6">
+      <div className="flex items-start justify-between gap-4 flex-wrap">
+        <div>
+          <h1 className="text-3xl font-bold text-foreground">Finance Summary</h1>
+          <p className="text-muted-foreground mt-1">
+            Revenue collected by period, origin/destination, and payment method — for daily, weekly, or monthly finance reporting.
+          </p>
+        </div>
+        <ActionButton icon={FileSpreadsheet} variant="secondary" onClick={doExport} loading={exporting} disabled={!hasData}>
+          Export
+        </ActionButton>
+      </div>
+
+      {/* Filters */}
+      <div className="card">
+        <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-6">
+          <div>
+            <label className="label">Date Range</label>
+            <select className="input" value={dateRangePreset} onChange={(e) => setDateRangePreset(e.target.value)}>
+              <option value="7">Last 7 Days</option>
+              <option value="30">Last 30 Days</option>
+              <option value="90">Last 90 Days</option>
+              <option value="custom">Custom Range</option>
+            </select>
+          </div>
+          {dateRangePreset === 'custom' && (
+            <>
+              <div>
+                <label className="label">Start Date</label>
+                <input type="date" className="input" value={customFrom} onChange={(e) => setCustomFrom(e.target.value)} />
+              </div>
+              <div>
+                <label className="label">End Date</label>
+                <input type="date" className="input" value={customTo} onChange={(e) => setCustomTo(e.target.value)} />
+              </div>
+            </>
+          )}
+          <div>
+            <label className="label">Granularity</label>
+            <select className="input" value={granularity} onChange={(e) => setGranularity(e.target.value as FinanceGranularity)}>
+              <option value="daily">Daily</option>
+              <option value="weekly">Weekly</option>
+              <option value="monthly">Monthly</option>
+            </select>
+          </div>
+          <div>
+            <label className="label">Origin</label>
+            <select className="input" value={originStationId} onChange={(e) => setOriginStationId(e.target.value)}>
+              <option value="">Any origin</option>
+              {stations.map((s) => (
+                <option key={s.id} value={s.id}>{s.name}</option>
+              ))}
+            </select>
+          </div>
+          <div>
+            <label className="label">Destination</label>
+            <select className="input" value={destinationStationId} onChange={(e) => setDestinationStationId(e.target.value)}>
+              <option value="">Any destination</option>
+              {stations.map((s) => (
+                <option key={s.id} value={s.id}>{s.name}</option>
+              ))}
+            </select>
+          </div>
+          <div>
+            <label className="label">Payment Method</label>
+            <select className="input" value={method} onChange={(e) => setMethod(e.target.value)}>
+              <option value="">All methods</option>
+              {PAYMENT_METHOD_ORDER.map((m) => (
+                <option key={m} value={m}>{methodLabel(m)}</option>
+              ))}
+            </select>
+          </div>
+        </div>
+        <div className="mt-4 flex items-center justify-between">
+          <button type="button" onClick={resetFilters} className="text-xs text-primary hover:underline">
+            Reset filters
+          </button>
+          {isFetching && <span className="text-xs text-muted-foreground">Refreshing…</span>}
+        </div>
+        {isError && <p className="text-xs text-red-500 mt-3">Failed to load the finance summary. Check the filters and try again.</p>}
+      </div>
+
+      {isLoading && !data ? (
+        <FinanceReportSkeleton />
+      ) : !hasData ? (
+        <div className="card py-16 text-center text-muted-foreground">
+          <Banknote className="h-10 w-10 mx-auto mb-3 opacity-30" />
+          <p>No paid bookings in this window.</p>
+          <p className="text-xs mt-1">Widen the date range, or clear the origin/destination/method filters.</p>
+        </div>
+      ) : (
+        <div className={isFetching ? 'opacity-60 transition-opacity space-y-6' : 'space-y-6'}>
+          {/* Revenue by currency — never summed across currencies, so a Waafi/DJF total and an
+              ETB total each get their own row instead of one converted figure. */}
+          <div className="grid grid-cols-1 lg:grid-cols-3 gap-4">
+            <div className="card lg:col-span-2 flex flex-col gap-2">
+              <div className="flex items-center justify-between mb-1">
+                <p className="text-xs font-semibold uppercase tracking-wider text-muted-foreground">Revenue by Currency</p>
+                <div className="rounded-lg bg-emerald-100 dark:bg-emerald-900/30 p-1.5">
+                  <Banknote className="h-4 w-4 text-emerald-600 dark:text-emerald-400" />
+                </div>
+              </div>
+              {totals.map((t) => (
+                <div key={t.currency} className="flex items-center justify-between rounded-md bg-muted/20 px-3 py-2">
+                  <span className="text-sm font-medium">{t.currency}</span>
+                  <span className="text-right">
+                    <span className="text-sm font-semibold tabular-nums">{formatCurrency(t.revenueMinor, t.currency)}</span>
+                    <span className="ml-2 text-xs text-muted-foreground tabular-nums">{t.bookingCount.toLocaleString()} bookings</span>
+                  </span>
+                </div>
+              ))}
+            </div>
+            <div className="card flex flex-col gap-1">
+              <div className="flex items-center justify-between">
+                <p className="text-xs font-semibold uppercase tracking-wider text-muted-foreground">Bookings</p>
+                <div className="rounded-lg bg-blue-100 dark:bg-blue-900/30 p-1.5">
+                  <BookOpen className="h-4 w-4 text-blue-600 dark:text-blue-400" />
+                </div>
+              </div>
+              <p className="text-2xl font-bold tabular-nums mt-1">{totalBookings.toLocaleString()}</p>
+              <p className="text-xs text-muted-foreground mt-auto pt-2 border-t border-border">
+                Across {totals.length} currenc{totals.length === 1 ? 'y' : 'ies'}
+              </p>
+            </div>
+          </div>
+
+          {/* One full Trend + Segment + Method set per currency — never scoped to a single
+              "dominant" currency, so a currency-specific method like Waafi/DJF always shows
+              its own numbers instead of being dropped in favor of whichever currency is
+              biggest overall. */}
+          {currencySections.map((section) => (
+            <div key={section.currency} className="space-y-6">
+              <div className="flex items-center gap-3">
+                <h2 className="text-lg font-semibold text-foreground">{section.currency}</h2>
+                <span className="text-xs text-muted-foreground">
+                  {formatCurrency(section.revenueMinor, section.currency)} · {section.bookingCount.toLocaleString()} bookings
+                </span>
+              </div>
+
+              <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
+                <div className="card" ref={setChartRef(`${section.currency}-trend`)}>
+                  <h3 className="text-base font-semibold mb-4">
+                    Revenue Trend <span className="text-xs font-normal text-muted-foreground">({section.currency}, {granularity})</span>
+                  </h3>
+                  {section.trendData.length > 0 ? (
+                    <ResponsiveContainer width="100%" height={260}>
+                      <LineChart data={section.trendData}>
+                        <CartesianGrid strokeDasharray="3 3" stroke={palette.grid} />
+                        <XAxis dataKey="label" tick={{ fontSize: 11, fill: palette.textMuted }} />
+                        <YAxis tick={{ fontSize: 11, fill: palette.textMuted }} />
+                        <RechartsTooltip formatter={(value: number) => `${section.currency} ${Math.round(value).toLocaleString()}`} />
+                        <Line type="monotone" dataKey="revenue" name="Revenue" stroke={palette.sequential} dot={{ r: 3 }} strokeWidth={2} />
+                      </LineChart>
+                    </ResponsiveContainer>
+                  ) : (
+                    <div className="h-[260px] flex items-center justify-center text-muted-foreground text-sm">No data for selected range</div>
+                  )}
+                </div>
+
+                <div className="card" ref={setChartRef(`${section.currency}-segment`)}>
+                  <h3 className="text-base font-semibold mb-4">
+                    Revenue by Segment <span className="text-xs font-normal text-muted-foreground">({section.currency})</span>
+                  </h3>
+                  {section.segmentData.length > 0 ? (
+                    <ResponsiveContainer width="100%" height={260}>
+                      <BarChart data={section.segmentData}>
+                        <CartesianGrid strokeDasharray="3 3" stroke={palette.grid} />
+                        <XAxis dataKey="label" tick={{ fontSize: 11, fill: palette.textMuted }} />
+                        <YAxis tick={{ fontSize: 11, fill: palette.textMuted }} />
+                        <RechartsTooltip formatter={(value: number) => `${section.currency} ${Math.round(value).toLocaleString()}`} />
+                        <Bar dataKey="revenue" fill={palette.sequential} radius={[3, 3, 0, 0]} />
+                      </BarChart>
+                    </ResponsiveContainer>
+                  ) : (
+                    <div className="h-[260px] flex items-center justify-center text-muted-foreground text-sm">No data for selected range</div>
+                  )}
+                </div>
+              </div>
+
+              {/* Payment method breakdown — part-to-whole stacked bar + legend table */}
+              <div className="card" ref={setChartRef(`${section.currency}-method`)}>
+                <h3 className="text-base font-semibold text-foreground">
+                  Revenue by Payment Method <span className="text-xs font-normal text-muted-foreground">({section.currency})</span>
+                </h3>
+                <p className="text-xs text-muted-foreground mt-1 mb-4">Share of {section.currency} revenue by method</p>
+                <div
+                  className="flex w-full h-7 rounded-md overflow-hidden"
+                  role="img"
+                  aria-label={`${section.currency} revenue by payment method: ${section.methodBreakdown
+                    .map((m) => `${methodLabel(m.label)} ${m.sharePercent.toFixed(0)}%`)
+                    .join(', ')}`}
+                >
+                  {section.methodBreakdown.map((m, i) => (
+                    <div
+                      key={m.key}
+                      className="h-full"
+                      style={{ width: `${m.sharePercent}%`, background: m.color, marginRight: i < section.methodBreakdown.length - 1 ? 2 : 0 }}
+                      title={`${methodLabel(m.label)} — ${formatCurrency(m.revenueMinor, m.currency)}`}
+                    />
+                  ))}
+                </div>
+                <table className="w-full text-sm mt-4">
+                  <thead>
+                    <tr className="text-xs uppercase tracking-wider text-muted-foreground">
+                      <th className="text-left font-medium py-2">Method</th>
+                      <th className="text-right font-medium py-2">Bookings</th>
+                      <th className="text-right font-medium py-2">Share</th>
+                      <th className="text-right font-medium py-2">Revenue</th>
+                    </tr>
+                  </thead>
+                  <tbody className="divide-y divide-border">
+                    {section.methodBreakdown.map((m) => (
+                      <tr key={m.key}>
+                        <td className="py-2">
+                          <span className="flex items-center gap-2">
+                            <span className="h-2.5 w-2.5 rounded-sm shrink-0" style={{ background: m.color }} aria-hidden="true" />
+                            <span className="text-foreground">{methodLabel(m.label)}</span>
+                          </span>
+                        </td>
+                        <td className="py-2 text-right tabular-nums text-muted-foreground">{m.bookingCount.toLocaleString()}</td>
+                        <td className="py-2 text-right tabular-nums text-muted-foreground">{m.sharePercent.toFixed(1)}%</td>
+                        <td className="py-2 text-right tabular-nums text-foreground font-medium">{formatCurrency(m.revenueMinor, m.currency)}</td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            </div>
+          ))}
+
+          {/* Detail table */}
+          <div className="card p-0">
+            <div className="px-4 pt-4 pb-3">
+              <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground">
+                Period × Segment × Method detail
+              </h3>
+            </div>
+            <div className="overflow-x-auto">
+              <table className="w-full text-sm">
+                <thead className="bg-gray-50 dark:bg-gray-800">
+                  <tr>
+                    {['Period', 'Segment', 'Method', 'Currency', 'Bookings', 'Revenue'].map((h) => (
+                      <th key={h} className="px-4 py-3 text-left text-xs font-medium uppercase tracking-wider text-gray-500 dark:text-gray-400 whitespace-nowrap">
+                        {h}
+                      </th>
+                    ))}
+                  </tr>
+                </thead>
+                <tbody className="bg-white dark:bg-gray-900 divide-y divide-gray-200 dark:divide-gray-700">
+                  {pg.paged.map((r, i) => (
+                    <tr key={`${r.period}-${r.originStationId}-${r.destinationStationId}-${r.method}-${i}`} className="hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors">
+                      <td className="px-4 py-3 whitespace-nowrap text-foreground">{periodLabel(r.period, granularity)}</td>
+                      <td className="px-4 py-3 whitespace-nowrap text-muted-foreground">{r.segmentLabel}</td>
+                      <td className="px-4 py-3 whitespace-nowrap text-muted-foreground">{methodLabel(r.method)}</td>
+                      <td className="px-4 py-3 whitespace-nowrap text-muted-foreground">{r.currency}</td>
+                      <td className="px-4 py-3 tabular-nums whitespace-nowrap">{r.bookingCount.toLocaleString()}</td>
+                      <td className="px-4 py-3 tabular-nums whitespace-nowrap font-medium">{formatCurrency(r.revenueMinor, r.currency)}</td>
+                    </tr>
+                  ))}
+                  {pg.paged.length === 0 && (
+                    <tr>
+                      <td colSpan={6} className="py-8 text-center text-sm text-muted-foreground">No rows on this page</td>
+                    </tr>
+                  )}
+                </tbody>
+              </table>
+            </div>
+            <Pagination currentPage={pg.page} totalPages={pg.totalPages} onPageChange={pg.setPage} />
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/reports/overall/page.tsx b/apps/edr-passenger-web/backoffice/src/app/reports/overall/page.tsx
index e715fbd71..9e88bdd5f 100644
--- a/apps/edr-passenger-web/backoffice/src/app/reports/overall/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/reports/overall/page.tsx
@@ -8,7 +8,6 @@ import {
   Tooltip, Legend, ResponsiveContainer, PieChart, Pie, Cell,
 } from 'recharts';
 import { bookingsApi } from '@/lib/api';
-import { dashboardApi } from '@/lib/api/dashboard';
 import { apiClient } from '@/lib/api-client';
 import { formatCurrency } from '@/lib/utils';
 import ActionButton from '@/components/ui/ActionButton';
@@ -24,19 +23,34 @@ export default function ReportsPage() {
   const [dateRange, setDateRange] = useState('30');
   const [startDate, setStartDate] = useState('');
   const [endDate, setEndDate] = useState('');
+  const [routeOrigin, setRouteOrigin] = useState('');
+  const [routeDestination, setRouteDestination] = useState('');
   const [exportModalOpen, setExportModalOpen] = useState(false);
   const [exportFormat, setExportFormat] = useState<'csv' | 'excel' | 'pdf'>('csv');
 
   const getDateRange = () => {
     const end = new Date();
     end.setHours(23, 59, 59, 999);
-    const start = new Date();
+
+    if (dateRange === 'custom') {
+      if (startDate && endDate) {
+        return startDate <= endDate
+          ? { startDate, endDate }
+          : { startDate: endDate, endDate: startDate };
+      }
+      const fallbackStart = new Date(end);
+      fallbackStart.setDate(end.getDate() - 30);
+      return {
+        startDate: fallbackStart.toISOString().split('T')[0],
+        endDate: end.toISOString().split('T')[0],
+      };
+    }
+
+    const start = new Date(end);
     switch (dateRange) {
       case '7': start.setDate(end.getDate() - 7); break;
       case '30': start.setDate(end.getDate() - 30); break;
       case '90': start.setDate(end.getDate() - 90); break;
-      default:
-        if (startDate && endDate) return { startDate, endDate };
     }
     return {
       startDate: start.toISOString().split('T')[0],
@@ -47,12 +61,6 @@ export default function ReportsPage() {
   const dates = getDateRange();
 
   // Confirmed-ticket revenue — same source as dashboard
-  const { data: stats, isLoading: statsLoading } = useQuery({
-    queryKey: ['backoffice-stats'],
-    queryFn: dashboardApi.getBackofficeStats,
-    staleTime: 60000,
-  });
-
   const { data: exchangeRates = [] } = useQuery<any[]>({
     queryKey: ['currencies'],
     queryFn: () => apiClient.get('/currencies'),
@@ -65,25 +73,25 @@ export default function ReportsPage() {
     return r ? 1 / r.rate : null;
   };
 
+  const getBookingTicketCount = (booking: any): number => {
+    if (Array.isArray(booking.tickets)) return booking.tickets.length;
+    if (typeof booking.ticketCount === 'number') return booking.ticketCount;
+    return 0;
+  };
+
   const calcGrand = (rows: { currency: string; totalMinor: number }[]) =>
     rows.reduce((sum, { currency, totalMinor }) => {
       const rate = toEtbRate(currency);
       return rate !== null ? sum + Math.round(totalMinor * rate) : sum;
     }, 0);
 
-  const normalRows = stats?.revenueByCurrency ?? [];
-  const packageRows = stats?.packageRevenueByCurrency ?? [];
-  const normalGrand = calcGrand(normalRows);
-  const packageGrand = calcGrand(packageRows);
-  const overallGrand = normalGrand + packageGrand;
-
   // Bookings for charts / status distribution
   const { data: bookingsData, isLoading: bookingsLoading } = useQuery({
-    queryKey: ['all-bookings'],
-    queryFn: () => bookingsApi.getAll({ pageSize: 1000 }),
+    queryKey: ['all-bookings', dates.startDate, dates.endDate],
+    queryFn: () => bookingsApi.getAll({ pageSize: 5000, dateFrom: dates.startDate, dateTo: dates.endDate }),
   });
 
-  const isLoading = statsLoading || bookingsLoading;
+  const isLoading = bookingsLoading;
 
   const allBookings: any[] = Array.isArray(bookingsData?.items) ? bookingsData.items : [];
 
@@ -92,7 +100,29 @@ export default function ReportsPage() {
     return d >= dates.startDate && d <= dates.endDate;
   });
 
-  const confirmedBookings = bookings.filter((b: any) => b.status !== 'CANCELLED' && b.status !== 'REFUNDED');
+  const confirmedBookings = bookings.filter((b: any) => b.status === 'CONFIRMED' || b.status === 'BOARDED');
+
+  const totalRevenueMinor = confirmedBookings.reduce((sum, b: any) => {
+    const rate = toEtbRate(b.currency);
+    return rate !== null ? sum + Math.round((b.totalMinor || 0) * rate) : sum;
+  }, 0);
+
+  const totalBookingsCount = confirmedBookings.length;
+  const totalTicketsCount = confirmedBookings.reduce((sum, b: any) => sum + getBookingTicketCount(b), 0);
+
+  const totalRegularTicketsCount = confirmedBookings
+    .filter((b: any) => {
+      const bookingType = String(b.bookingType || '').toUpperCase();
+      return bookingType !== 'PACKAGE' && !b.packageId;
+    })
+    .reduce((sum: number, b: any) => sum + getBookingTicketCount(b), 0);
+
+  const totalPackageTicketsCount = confirmedBookings
+    .filter((b: any) => {
+      const bookingType = String(b.bookingType || '').toUpperCase();
+      return bookingType === 'PACKAGE' || Boolean(b.packageId);
+    })
+    .reduce((sum: number, b: any) => sum + getBookingTicketCount(b), 0);
 
   const byDate = confirmedBookings.reduce((acc: Record<string, any>, b: any) => {
     const date = new Date(b.createdAt).toISOString().split('T')[0];
@@ -110,7 +140,78 @@ export default function ReportsPage() {
       bookings: d.count || 0,
     }));
 
-  const avgDailyRevenue = chartData.length > 0 ? Math.round(overallGrand / 100 / chartData.length) : 0;
+  const avgDailyRevenueMinor = chartData.length > 0 ? Math.round(totalRevenueMinor / chartData.length) : 0;
+
+  const totalRegularBookingsCount = confirmedBookings.filter((b: any) => {
+    const bookingType = String(b.bookingType || '').toUpperCase();
+    return bookingType !== 'PACKAGE' && !b.packageId;
+  }).length;
+
+  const totalPackageBookingsCount = confirmedBookings.filter((b: any) => {
+    const bookingType = String(b.bookingType || '').toUpperCase();
+    return bookingType === 'PACKAGE' || Boolean(b.packageId);
+  }).length;
+
+  const normalRows = confirmedBookings
+    .filter((b: any) => {
+      const bookingType = String(b.bookingType || '').toUpperCase();
+      return bookingType !== 'PACKAGE' && !b.packageId;
+    })
+    .reduce((acc: Record<string, number>, b: any) => {
+      const currency = b.currency || 'ETB';
+      acc[currency] = (acc[currency] || 0) + (b.totalMinor || 0);
+      return acc;
+    }, {} as Record<string, number>);
+
+  const packageRows = confirmedBookings
+    .filter((b: any) => {
+      const bookingType = String(b.bookingType || '').toUpperCase();
+      return bookingType === 'PACKAGE' || Boolean(b.packageId);
+    })
+    .reduce((acc: Record<string, number>, b: any) => {
+      const currency = b.currency || 'ETB';
+      acc[currency] = (acc[currency] || 0) + (b.totalMinor || 0);
+      return acc;
+    }, {} as Record<string, number>);
+
+  const normalRowData = Object.entries(normalRows).map(([currency, totalMinor]) => ({ currency, totalMinor }));
+  const packageRowData = Object.entries(packageRows).map(([currency, totalMinor]) => ({ currency, totalMinor }));
+  const normalGrand = calcGrand(normalRowData);
+  const packageGrand = calcGrand(packageRowData);
+  const overallGrand = normalGrand + packageGrand;
+
+  const filteredRouteBookings = confirmedBookings.filter((b: any) => {
+    const origin = b.schedule?.originStation?.name || b.originStationName || b.origin || 'Unknown';
+    const destination = b.schedule?.destinationStation?.name || b.destinationStationName || b.destination || 'Unknown';
+    if (routeOrigin && origin !== routeOrigin) return false;
+    if (routeDestination && destination !== routeDestination) return false;
+    return true;
+  });
+
+  const routeOriginOptions = [
+    ...new Set(confirmedBookings.map((b: any) => b.schedule?.originStation?.name || b.originStationName || b.origin || 'Unknown').filter(Boolean)),
+  ].sort() as string[];
+  const routeDestinationOptions = [
+    ...new Set(confirmedBookings.map((b: any) => b.schedule?.destinationStation?.name || b.destinationStationName || b.destination || 'Unknown').filter(Boolean)),
+  ].sort() as string[];
+
+  const routeRevenueData = Object.entries(
+    filteredRouteBookings.reduce((acc: Record<string, { totalEtbMinor: number; bookings: number }>, b: any) => {
+      const origin = b.schedule?.originStation?.name || b.originStationName || b.origin || 'Unknown';
+      const destination = b.schedule?.destinationStation?.name || b.destinationStationName || b.destination || 'Unknown';
+      const route = `${origin} → ${destination}`;
+      const rate = toEtbRate(b.currency);
+      const etbMinor = rate !== null ? Math.round((b.totalMinor || 0) * rate) : 0;
+      if (!acc[route]) acc[route] = { totalEtbMinor: 0, bookings: 0 };
+      acc[route].totalEtbMinor += etbMinor;
+      acc[route].bookings += 1;
+      return acc;
+    }, {}),
+  ).map(([route, value]) => ({
+    route,
+    totalEtbMinor: value.totalEtbMinor,
+    bookings: value.bookings,
+  })).sort((a, b) => b.totalEtbMinor - a.totalEtbMinor);
 
   const REPORT_COLS = ['Date', 'Revenue (ETB)', 'Confirmed Bookings'];
 
@@ -129,8 +230,8 @@ export default function ReportsPage() {
         `th,td{border:1px solid #ccc;padding:4px 8px}th{background:#10b981;color:#fff}</style></head><body>` +
         `<h2>Revenue Report — ${esc(dates.startDate)} to ${esc(dates.endDate)}</h2>` +
         `<p>Total Revenue: ${esc(formatCurrency(overallGrand, 'ETB'))} | ` +
-        `Bookings: ${esc(String(stats?.totalBookings ?? 0))} | ` +
-        `Tickets: ${esc(String(stats?.totalTickets ?? 0))}</p>` +
+        `Bookings: ${esc(String(totalBookingsCount))} | ` +
+        `Tickets: ${esc(String(totalTicketsCount))}</p>` +
         `<table><thead><tr>${thead}</tr></thead><tbody>${tbody}</tbody></table></body></html>`
       );
       w.document.close(); w.print();
@@ -148,6 +249,20 @@ export default function ReportsPage() {
     setExportModalOpen(false);
   };
 
+  const doExportRouteRevenue = () => {
+    if (!routeRevenueData.length) { alert('No route revenue to export'); return; }
+    const rows = routeRevenueData.map((row) => [row.route, String(row.bookings), formatCurrency(row.totalEtbMinor, 'ETB')]);
+    const headers = ['Route', 'Bookings', 'Revenue (ETB)'];
+    const csv = [headers.map((h) => `"${h}"`).join(','), ...rows.map((r) => r.map((v) => `"${v}"`).join(','))].join('\n');
+    const blob = new Blob([csv], { type: 'text/csv' });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = `route-revenue-${dates.startDate}-${dates.endDate}.csv`;
+    a.click();
+    URL.revokeObjectURL(url);
+  };
+
   const renderCurrencyRow = ({ currency, totalMinor }: { currency: string; totalMinor: number }) => {
     const rate = toEtbRate(currency);
     const etbMinor = rate !== null ? Math.round(totalMinor * rate) : null;
@@ -218,16 +333,16 @@ export default function ReportsPage() {
             </div>
           </div>
           <p className="text-2xl font-bold text-emerald-600 dark:text-emerald-400 tabular-nums mt-1">
-            {statsLoading ? '—' : formatCurrency(overallGrand, 'ETB')}
+            {isLoading ? '—' : formatCurrency(totalRevenueMinor, 'ETB')}
           </p>
           <div className="flex flex-col gap-1 border-t border-border pt-2 mt-1">
             <div className="flex justify-between text-xs">
               <span className="text-muted-foreground">Regular</span>
-              <span className="font-semibold tabular-nums">{statsLoading ? '—' : formatCurrency(normalGrand, 'ETB')}</span>
+              <span className="font-semibold tabular-nums">{isLoading ? '—' : formatCurrency(normalGrand, 'ETB')}</span>
             </div>
             <div className="flex justify-between text-xs">
               <span className="text-muted-foreground">Package</span>
-              <span className="font-semibold tabular-nums">{statsLoading ? '—' : formatCurrency(packageGrand, 'ETB')}</span>
+              <span className="font-semibold tabular-nums">{isLoading ? '—' : formatCurrency(packageGrand, 'ETB')}</span>
             </div>
           </div>
         </div>
@@ -241,16 +356,16 @@ export default function ReportsPage() {
             </div>
           </div>
           <p className="text-2xl font-bold tabular-nums mt-1">
-            {statsLoading ? '—' : (stats?.totalBookings ?? 0).toLocaleString()}
+            {isLoading ? '—' : totalBookingsCount.toLocaleString()}
           </p>
           <div className="flex flex-col gap-1 border-t border-border pt-2 mt-1">
             <div className="flex justify-between text-xs">
               <span className="text-muted-foreground">Regular</span>
-              <span className="font-semibold tabular-nums">{statsLoading ? '—' : (stats?.totalNormalBookings ?? 0).toLocaleString()}</span>
+              <span className="font-semibold tabular-nums">{isLoading ? '—' : totalRegularBookingsCount.toLocaleString()}</span>
             </div>
             <div className="flex justify-between text-xs">
               <span className="text-muted-foreground">Package</span>
-              <span className="font-semibold tabular-nums">{statsLoading ? '—' : (stats?.totalPackageBookings ?? 0).toLocaleString()}</span>
+              <span className="font-semibold tabular-nums">{isLoading ? '—' : totalPackageBookingsCount.toLocaleString()}</span>
             </div>
           </div>
         </div>
@@ -264,16 +379,16 @@ export default function ReportsPage() {
             </div>
           </div>
           <p className="text-2xl font-bold tabular-nums mt-1">
-            {statsLoading ? '—' : (stats?.totalTickets ?? 0).toLocaleString()}
+            {isLoading ? '—' : totalTicketsCount.toLocaleString()}
           </p>
           <div className="flex flex-col gap-1 border-t border-border pt-2 mt-1">
             <div className="flex justify-between text-xs">
               <span className="text-muted-foreground">Regular</span>
-              <span className="font-semibold tabular-nums">{statsLoading ? '—' : (stats?.totalNormalTickets ?? 0).toLocaleString()}</span>
+              <span className="font-semibold tabular-nums">{isLoading ? '—' : totalRegularBookingsCount.toLocaleString()}</span>
             </div>
             <div className="flex justify-between text-xs">
               <span className="text-muted-foreground">Package</span>
-              <span className="font-semibold tabular-nums">{statsLoading ? '—' : (stats?.totalPackageTickets ?? 0).toLocaleString()}</span>
+              <span className="font-semibold tabular-nums">{isLoading ? '—' : totalPackageBookingsCount.toLocaleString()}</span>
             </div>
           </div>
         </div>
@@ -287,7 +402,7 @@ export default function ReportsPage() {
             </div>
           </div>
           <p className="text-2xl font-bold tabular-nums mt-1">
-            {isLoading ? '—' : formatCurrency(avgDailyRevenue * 100, 'ETB')}
+            {isLoading ? '—' : formatCurrency(avgDailyRevenueMinor, 'ETB')}
           </p>
           <p className="text-xs text-muted-foreground mt-auto pt-2 border-t border-border">
             Over {chartData.length} active day{chartData.length !== 1 ? 's' : ''} in range
@@ -300,9 +415,9 @@ export default function ReportsPage() {
         <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground mb-4">
           Revenue Breakdown — Confirmed Tickets
         </h2>
-        {statsLoading ? (
+        {isLoading ? (
           <p className="text-sm text-muted-foreground">Loading…</p>
-        ) : !normalRows.length && !packageRows.length ? (
+        ) : !normalRowData.length && !packageRowData.length ? (
           <p className="text-sm text-muted-foreground">No revenue data yet.</p>
         ) : (
           <div className="grid grid-cols-1 sm:grid-cols-2 gap-6">
@@ -311,12 +426,12 @@ export default function ReportsPage() {
               <div className="flex items-center justify-between mb-1">
                 <span className="text-xs font-semibold uppercase tracking-wider text-muted-foreground">Regular</span>
                 <span className="text-xs text-muted-foreground tabular-nums">
-                  {(stats?.totalNormalBookings ?? 0).toLocaleString()} bookings · {(stats?.totalNormalTickets ?? 0).toLocaleString()} tickets
+                  {totalRegularBookingsCount.toLocaleString()} bookings · {totalRegularTicketsCount.toLocaleString()} tickets
                 </span>
               </div>
-              {normalRows.length === 0
+              {normalRowData.length === 0
                 ? <p className="text-xs text-muted-foreground py-1">No revenue yet</p>
-                : normalRows.map(renderCurrencyRow)}
+                : normalRowData.map(renderCurrencyRow)}
               {normalRows.length > 0 && (
                 <div className="flex items-center justify-between rounded-md bg-muted/40 px-3 py-2 mt-1">
                   <span className="text-xs font-semibold text-muted-foreground">Subtotal</span>
@@ -330,13 +445,13 @@ export default function ReportsPage() {
               <div className="flex items-center justify-between mb-1">
                 <span className="text-xs font-semibold uppercase tracking-wider text-muted-foreground">Package</span>
                 <span className="text-xs text-muted-foreground tabular-nums">
-                  {(stats?.totalPackageBookings ?? 0).toLocaleString()} bookings · {(stats?.totalPackageTickets ?? 0).toLocaleString()} tickets
+                  {totalPackageBookingsCount.toLocaleString()} bookings · {totalPackageTicketsCount.toLocaleString()} tickets
                 </span>
               </div>
-              {packageRows.length === 0
+              {packageRowData.length === 0
                 ? <p className="text-xs text-muted-foreground py-1">No revenue yet</p>
-                : packageRows.map(renderCurrencyRow)}
-              {packageRows.length > 0 && (
+                : packageRowData.map(renderCurrencyRow)}
+              {packageRowData.length > 0 && (
                 <div className="flex items-center justify-between rounded-md bg-muted/40 px-3 py-2 mt-1">
                   <span className="text-xs font-semibold text-muted-foreground">Subtotal</span>
                   <span className="text-sm font-bold tabular-nums">{formatCurrency(packageGrand, 'ETB')}</span>
@@ -345,7 +460,7 @@ export default function ReportsPage() {
             </div>
           </div>
         )}
-        {!statsLoading && (normalRows.length > 0 || packageRows.length > 0) && (
+        {(normalRowData.length > 0 || packageRowData.length > 0) && (
           <div className="flex items-center justify-between rounded-lg border border-border bg-muted/30 px-4 py-3 mt-4">
             <span className="text-sm font-semibold text-muted-foreground">Grand Total (ETB equivalent)</span>
             <span className="text-lg font-bold text-emerald-600 dark:text-emerald-400 tabular-nums">
@@ -355,6 +470,85 @@ export default function ReportsPage() {
         )}
       </div>
 
+      {/* Route Revenue Breakdown */}
+      <div className="card">
+        <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-2 mb-4">
+          <div>
+            <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground">
+              Revenue by Route
+            </h2>
+            <p className="text-xs text-muted-foreground">
+              Confirmed booking revenue for the selected date range, grouped by route.
+            </p>
+          </div>
+          <div className="flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
+            <span>{routeRevenueData.length} route{routeRevenueData.length !== 1 ? 's' : ''}</span>
+            <button
+              type="button"
+              className="text-primary underline"
+              onClick={() => {
+                setRouteOrigin('');
+                setRouteDestination('');
+              }}
+            >
+              Clear filters
+            </button>
+          </div>
+        </div>
+
+        <div className="grid grid-cols-1 md:grid-cols-3 gap-3 mb-4">
+          <div>
+            <label className="label">Origin</label>
+            <select
+              className="input"
+              value={routeOrigin}
+              onChange={(e) => setRouteOrigin(e.target.value)}
+              disabled={isLoading}
+            >
+              <option value="">All origins</option>
+              {routeOriginOptions.map((origin) => (
+                <option key={origin} value={origin}>{origin}</option>
+              ))}
+            </select>
+          </div>
+          <div>
+            <label className="label">Destination</label>
+            <select
+              className="input"
+              value={routeDestination}
+              onChange={(e) => setRouteDestination(e.target.value)}
+              disabled={isLoading}
+            >
+              <option value="">All destinations</option>
+              {routeDestinationOptions.map((destination) => (
+                <option key={destination} value={destination}>{destination}</option>
+              ))}
+            </select>
+          </div>
+          <div className="flex items-end justify-end">
+            <ActionButton variant="secondary" onClick={doExportRouteRevenue} disabled={isLoading || routeRevenueData.length === 0}>
+              Export route revenue
+            </ActionButton>
+          </div>
+        </div>
+
+        {routeRevenueData.length === 0 ? (
+          <p className="text-sm text-muted-foreground">No route revenue data available for this range.</p>
+        ) : (
+          <div className="space-y-3">
+            {routeRevenueData.slice(0, 10).map((route) => (
+              <div key={route.route} className="grid grid-cols-1 md:grid-cols-[1.4fr_0.8fr_0.8fr] gap-3 items-center rounded-md bg-muted/20 p-3">
+                <div className="text-sm font-medium break-words">{route.route}</div>
+                <div className="text-sm text-muted-foreground">{route.bookings.toLocaleString()} booking{route.bookings !== 1 ? 's' : ''}</div>
+                <div className="text-right text-sm font-semibold tabular-nums">
+                  {formatCurrency(route.totalEtbMinor, 'ETB')}
+                </div>
+              </div>
+            ))}
+          </div>
+        )}
+      </div>
+
       {/* Charts */}
       <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
         {/* Revenue Trend */}
@@ -472,17 +666,17 @@ export default function ReportsPage() {
         <h3 className="text-base font-semibold mb-4">Summary</h3>
         <div className="grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-6 gap-3">
           {[
-            { label: 'Active Days', value: chartData.length, fromStats: false },
-            { label: 'Confirmed', value: bookings.filter((b: any) => b.status === 'CONFIRMED').length, fromStats: false },
-            { label: 'Boarded', value: bookings.filter((b: any) => b.status === 'BOARDED').length, fromStats: false },
-            { label: 'Cancelled', value: bookings.filter((b: any) => b.status === 'CANCELLED').length, fromStats: false },
-            { label: 'Regular Bookings', value: stats?.totalNormalBookings ?? 0, fromStats: true },
-            { label: 'Package Bookings', value: stats?.totalPackageBookings ?? 0, fromStats: true },
-          ].map(({ label, value, fromStats }) => (
+            { label: 'Active Days', value: chartData.length },
+            { label: 'Confirmed', value: bookings.filter((b: any) => b.status === 'CONFIRMED').length },
+            { label: 'Boarded', value: bookings.filter((b: any) => b.status === 'BOARDED').length },
+            { label: 'Cancelled', value: bookings.filter((b: any) => b.status === 'CANCELLED').length },
+            { label: 'Regular Bookings', value: totalRegularBookingsCount },
+            { label: 'Package Bookings', value: totalPackageBookingsCount },
+          ].map(({ label, value }) => (
             <div key={label} className="border border-border rounded-lg p-3 text-center">
               <p className="text-xs text-muted-foreground">{label}</p>
               <p className="text-xl font-bold mt-1 tabular-nums">
-                {fromStats && statsLoading ? '—' : value.toLocaleString()}
+                {value.toLocaleString()}
               </p>
             </div>
           ))}
diff --git a/apps/edr-passenger-web/backoffice/src/app/reports/passengers/page.tsx b/apps/edr-passenger-web/backoffice/src/app/reports/passengers/page.tsx
index 35b6d6cc7..0ed48c17b 100644
--- a/apps/edr-passenger-web/backoffice/src/app/reports/passengers/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/reports/passengers/page.tsx
@@ -4,6 +4,7 @@ import { useState } from "react";
 import { useQuery } from "@tanstack/react-query";
 import { Users, Armchair, BarChart3, Train, Download } from "lucide-react";
 import { apiClient } from "@/lib/api-client";
+import FleetPassengerOverview from "@/components/reports/FleetPassengerOverview";
 import { formatDateTime } from "@/lib/utils";
 import ActionButton from "@/components/ui/ActionButton";
 import Pagination from "@/components/ui/Pagination";
@@ -74,6 +75,7 @@ export default function PassengersReportPage() {
   const [tab, setTab] = useState<Tab>("occupancy");
   const [listSearch, setListSearch] = useState("");
   const [filterOrigin, setFilterOrigin] = useState("");
+  const [filterDestination, setFilterDestination] = useState("");
   const [filterSeatClass, setFilterSeatClass] = useState("");
   const [filterCoachNumber, setFilterCoachNumber] = useState("");
 
@@ -110,17 +112,23 @@ export default function PassengersReportPage() {
   const originOptions = [
     ...new Set(passengerList.map((p) => p.origin).filter(Boolean)),
   ].sort() as string[];
+  const destinationOptions = [
+    ...new Set(passengerList.map((p) => p.destination).filter(Boolean)),
+  ].sort() as string[];
 
   const filteredList = passengerList
     .filter((p) => {
       if (filterCoachNumber && p.coachNumber !== filterCoachNumber) return false;
       if (filterOrigin && p.origin !== filterOrigin) return false;
+      if (filterDestination && p.destination !== filterDestination) return false;
       if (filterSeatClass && p.seatClassName !== filterSeatClass) return false;
       if (listSearch.trim()) {
         const q = listSearch.toLowerCase();
         return (
           p.passengerName.toLowerCase().includes(q) ||
           p.bookingRef.toLowerCase().includes(q) ||
+          (p.origin ?? '').toLowerCase().includes(q) ||
+          (p.destination ?? '').toLowerCase().includes(q) ||
           (p.idDocumentNumber ?? "").toLowerCase().includes(q) ||
           (p.passportNumber ?? "").toLowerCase().includes(q)
         );
@@ -207,6 +215,7 @@ export default function PassengersReportPage() {
                 setListSearch("");
                 setFilterCoachNumber("");
                 setFilterOrigin("");
+                setFilterDestination("");
                 setFilterSeatClass("");
               }}
               disabled={loadingSchedules}
@@ -499,6 +508,18 @@ export default function PassengersReportPage() {
                     </option>
                   ))}
                 </select>
+                <select
+                  className="input w-36"
+                  value={filterDestination}
+                  onChange={(e) => { setFilterDestination(e.target.value); resetListPage(); }}
+                >
+                  <option value="">All destinations</option>
+                  {destinationOptions.map((d) => (
+                    <option key={d} value={d}>
+                      {d}
+                    </option>
+                  ))}
+                </select>
                 {passengerList.length > 0 && (
                   <ActionButton
                     icon={Download}
@@ -565,12 +586,9 @@ export default function PassengersReportPage() {
         </div>
       )}
 
-      {!scheduleId && (
-        <div className="card py-16 text-center text-muted-foreground">
-          <Armchair className="h-10 w-10 mx-auto mb-3 opacity-30" />
-          <p>Select a schedule above to load the occupancy report</p>
-        </div>
-      )}
+      {/* Landing state only. Unmounts the moment a schedule is selected, leaving the
+          per-schedule report above untouched. */}
+      {!scheduleId && <FleetPassengerOverview onSelectSchedule={setScheduleId} />}
     </div>
   );
 }
diff --git a/apps/edr-passenger-web/backoffice/src/app/reports/seats/page.tsx b/apps/edr-passenger-web/backoffice/src/app/reports/seats/page.tsx
index 2f5611f80..ef36ef741 100644
--- a/apps/edr-passenger-web/backoffice/src/app/reports/seats/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/reports/seats/page.tsx
@@ -2,8 +2,9 @@
 
 import { useState } from "react";
 import { useQuery } from "@tanstack/react-query";
-import { CheckCircle, Clock, AlertCircle, Ban, Armchair, Download } from "lucide-react";
+import { CheckCircle, Clock, AlertCircle, Ban, Download } from "lucide-react";
 import { apiClient } from "@/lib/api-client";
+import FleetSeatOverview from "@/components/reports/FleetSeatOverview";
 import Badge from "@/components/ui/Badge";
 import ActionButton from "@/components/ui/ActionButton";
 import { formatDateTime, formatCurrency } from "@/lib/utils";
@@ -165,12 +166,9 @@ export default function SeatStatusReportPage() {
         {isError && <p className="text-xs text-red-500 mt-2">Failed to load report.</p>}
       </div>
 
-      {!scheduleId && (
-        <div className="card py-16 text-center text-muted-foreground">
-          <Armchair className="h-10 w-10 mx-auto mb-3 opacity-30" />
-          <p>Select a schedule above to load the seat status report</p>
-        </div>
-      )}
+      {/* Landing state only. Unmounts the moment a schedule is selected, leaving the
+          per-schedule report below untouched. */}
+      {!scheduleId && <FleetSeatOverview onSelectSchedule={setScheduleId} />}
 
       {data && (
         <>
diff --git a/apps/edr-passenger-web/backoffice/src/app/routes/page.tsx b/apps/edr-passenger-web/backoffice/src/app/routes/page.tsx
index 251d034b1..a44d78546 100644
--- a/apps/edr-passenger-web/backoffice/src/app/routes/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/routes/page.tsx
@@ -11,6 +11,8 @@ import ConfirmDialog from '@/components/ui/ConfirmDialog';
 import { routesApi } from '@/lib/api/routes';
 import { stationsApi, fleetApi, routeCoachTemplatesApi } from '@/lib/api';
 import { eatLocalToISO, isoToEATLocal } from '@/lib/timezone';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
 
 interface RouteStop {
   stationId: string;
@@ -166,7 +168,7 @@ function RouteCoachesTab({ routes }: { routes: any[] }) {
   );
 }
 
-export default function RoutesPage() {
+function RoutesPageContent() {
   const [activeTab, setActiveTab] = useState<Tab>('routes');
   const [showModal, setShowModal] = useState(false);
   const [editingRoute, setEditingRoute] = useState<any>(null);
@@ -922,3 +924,11 @@ export default function RoutesPage() {
     </div>
   );
 }
+
+export default function RoutesPage() {
+  return (
+    <PermissionGuard permission={PERMS.routes.view}>
+      <RoutesPageContent />
+    </PermissionGuard>
+  );
+}
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 35d0290ea..7738f4b71 100644
--- a/apps/edr-passenger-web/backoffice/src/app/schedules/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/schedules/page.tsx
@@ -14,6 +14,8 @@ import { usePagination } from '@/lib/use-pagination';
 import { formatDateTime } from '@/lib/utils';
 import { eatLocalToISO, isoToEATLocal } from '@/lib/timezone';
 import DateTimePicker from '@/components/ui/DateTimePicker';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
 
 interface Schedule {
   id: string;
@@ -52,7 +54,7 @@ interface Coach {
   coachType?: { name: string };
 }
 
-export default function SchedulesPage() {
+function SchedulesPageContent() {
   const [showModal, setShowModal] = useState(false);
   const [showAddModal, setShowAddModal] = useState(false);
   const [showEditModal, setShowEditModal] = useState(false);
@@ -1248,3 +1250,11 @@ export default function SchedulesPage() {
     </div>
   );
 }
+
+export default function SchedulesPage() {
+  return (
+    <PermissionGuard permission={PERMS.schedules.view}>
+      <SchedulesPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/seats/page.tsx b/apps/edr-passenger-web/backoffice/src/app/seats/page.tsx
index c2d3ef2db..86d61eff0 100644
--- a/apps/edr-passenger-web/backoffice/src/app/seats/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/seats/page.tsx
@@ -6,6 +6,7 @@ import { seatsApi, schedulesApi, fleetApi, routeCoachTemplatesApi, bookingsApi }
 import { routesApi } from '@/lib/api/routes';
 import { usePermissionStrict } from '@/lib/use-permission';
 import { PERMS } from '@/lib/permissions';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
 import Modal from '@/components/ui/Modal';
 import ActionButton from '@/components/ui/ActionButton'
 import { Armchair, Lock, Unlock, Bed, X, RotateCcw, ChevronDown, Train, Wrench, Ticket as TicketIcon } from 'lucide-react';
@@ -15,7 +16,7 @@ import {
   SeatBlockReasonCategory,
 } from '@edr/types';
 
-export default function SeatsPage() {
+function SeatsPageContent() {
   const [activeTab, setActiveTab] = useState<'route' | 'schedule'>('route');
   const [selectedSchedule, setSelectedSchedule] = useState('');
   const [selectedRoute, setSelectedRoute] = useState('');
@@ -1491,3 +1492,11 @@ function SeatIcon({
     </div>
   );
 }
+
+export default function SeatsPage() {
+  return (
+    <PermissionGuard permission={PERMS.seats.view}>
+      <SeatsPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/stations/page.tsx b/apps/edr-passenger-web/backoffice/src/app/stations/page.tsx
index 032a978a4..420bc3434 100644
--- a/apps/edr-passenger-web/backoffice/src/app/stations/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/stations/page.tsx
@@ -11,8 +11,10 @@ import ConfirmDialog from '@/components/ui/ConfirmDialog';
 import { stationsApi } from '@/lib/api';
 import Pagination from '@/components/ui/Pagination';
 import { usePagination } from '@/lib/use-pagination';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
 
-export default function StationsPage() {
+function StationsPageContent() {
   const [filters, setFilters] = useState({ search: '', country: '', operational: '' });
   const [showModal, setShowModal] = useState(false);
   const [editingStation, setEditingStation] = useState<any>(null);
@@ -379,3 +381,11 @@ export default function StationsPage() {
     </div>
   );
 }
+
+export default function StationsPage() {
+  return (
+    <PermissionGuard permission={PERMS.stations.view}>
+      <StationsPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/app/trains/page.tsx b/apps/edr-passenger-web/backoffice/src/app/trains/page.tsx
index 527aebdc7..e1be87ff3 100644
--- a/apps/edr-passenger-web/backoffice/src/app/trains/page.tsx
+++ b/apps/edr-passenger-web/backoffice/src/app/trains/page.tsx
@@ -13,8 +13,10 @@ import Pagination from '@/components/ui/Pagination';
 import { usePagination } from '@/lib/use-pagination';
 import { Train as TrainType } from '@/types';
 import { formatDate } from '@/lib/utils';
+import { PermissionGuard } from '@/components/layout/PermissionGuard';
+import { PERMS } from '@/lib/permissions';
 
-export default function TrainsPage() {
+function TrainsPageContent() {
   const [showModal, setShowModal] = useState(false);
   const [editingTrain, setEditingTrain] = useState<TrainType | null>(null);
   const [search, setSearch] = useState('');
@@ -366,3 +368,11 @@ export default function TrainsPage() {
     </div>
   );
 }
+
+export default function TrainsPage() {
+  return (
+    <PermissionGuard permission={PERMS.trains.view}>
+      <TrainsPageContent />
+    </PermissionGuard>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/components/dashboard/DashboardBookingCharts.tsx b/apps/edr-passenger-web/backoffice/src/components/dashboard/DashboardBookingCharts.tsx
new file mode 100644
index 000000000..d9c1803f6
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/components/dashboard/DashboardBookingCharts.tsx
@@ -0,0 +1,403 @@
+"use client";
+
+/**
+ * Booking charts for the backoffice dashboard — revenue trend, daily confirmed
+ * bookings, status distribution and payment-method split over the last 30 days.
+ *
+ * Ported from `/reports/overall`, which computes the same four panels in the browser
+ * from a 5000-row booking fetch. Here the grouping is done by
+ * `GET /dashboard/analytics/bookings` so the landing page stays light.
+ *
+ * Revenue on this panel answers "what was booked" — CONFIRMED and BOARDED bookings by
+ * creation date. The Revenue Breakdown card below answers "what was collected" (it also
+ * requires a SUCCEEDED payment intent). The two will not match, which is why each says
+ * what it measures in its own heading.
+ */
+
+import { useMemo } from "react";
+import { useQuery } from "@tanstack/react-query";
+import {
+  Bar,
+  BarChart,
+  CartesianGrid,
+  Cell,
+  LabelList,
+  Line,
+  LineChart,
+  Pie,
+  PieChart,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis,
+} from "recharts";
+import { apiClient } from "@/lib/api-client";
+import { categoricalColor, getChartPalette } from "@/lib/chart-palette";
+import { useTheme } from "@/lib/theme-store";
+import { formatCurrency } from "@/lib/utils";
+
+interface BookingAnalytics {
+  window: { from: string; to: string; days: number };
+  totals: { bookings: number; confirmedBookings: number };
+  byDay: {
+    date: string;
+    bookings: number;
+    revenueByCurrency: { currency: string; totalMinor: number }[];
+  }[];
+  statusDistribution: { status: string; count: number }[];
+  paymentMethods: { method: string; count: number }[];
+}
+
+/**
+ * Fixed colour domain for booking status. Keyed by position in the enum rather than by
+ * rank in the data, so a day with no cancellations does not repaint the other slices.
+ */
+const STATUS_ORDER = [
+  "CONFIRMED",
+  "BOARDED",
+  "PENDING_PAYMENT",
+  "CANCELLED",
+  "REFUNDED",
+  "NO_SHOW",
+] as const;
+
+const STATUS_LABELS: Record<string, string> = {
+  CONFIRMED: "Confirmed",
+  BOARDED: "Boarded",
+  PENDING_PAYMENT: "Pending payment",
+  CANCELLED: "Cancelled",
+  REFUNDED: "Refunded",
+  NO_SHOW: "No show",
+  DRAFT: "Draft",
+  UNKNOWN: "Unknown",
+};
+
+const MAX_METHOD_BARS = 6;
+
+/** `YYYY-MM-DD` → `5 Mar`, parsed by parts so no timezone can shift the label. */
+function formatDayLabel(date: string): string {
+  const [, month, day] = date.split("-");
+  const monthName = [
+    "Jan", "Feb", "Mar", "Apr", "May", "Jun",
+    "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
+  ][Number(month) - 1];
+  return `${Number(day)} ${monthName}`;
+}
+
+function prettyMethod(method: string): string {
+  return method
+    .toLowerCase()
+    .replace(/_/g, " ")
+    .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+
+export default function DashboardBookingCharts() {
+  const isDark = useTheme((s) => s.isDark);
+  const palette = getChartPalette(isDark);
+
+  // Same query key the dashboard page already uses, so this shares its cache rather
+  // than issuing a second request for the rates.
+  const { data: exchangeRates = [] } = useQuery<any[]>({
+    queryKey: ["currencies"],
+    queryFn: () => apiClient.get("/currencies"),
+    select: (d: any) => (Array.isArray(d) ? d : (d?.data ?? d?.items ?? [])),
+  });
+
+  const { data, isLoading, isError } = useQuery<BookingAnalytics>({
+    queryKey: ["dashboard-booking-analytics"],
+    queryFn: () => apiClient.get("/dashboard/analytics/bookings"),
+    staleTime: 60_000,
+  });
+
+  // Matches the conversion the dashboard page applies to its revenue cards.
+  const toEtbRate = (currency: string): number | null => {
+    if (currency === "ETB") return 1;
+    const r = exchangeRates.find(
+      (x: any) => x.fromCurrency === "ETB" && x.toCurrency === currency,
+    );
+    return r ? 1 / r.rate : null;
+  };
+
+  const dayRows = useMemo(
+    () =>
+      (data?.byDay ?? []).map((d) => ({
+        label: formatDayLabel(d.date),
+        bookings: d.bookings,
+        // A currency with no rate on file is left out rather than counted at 1:1.
+        revenueMinor: d.revenueByCurrency.reduce((sum, r) => {
+          const rate = toEtbRate(r.currency);
+          return rate !== null ? sum + Math.round(r.totalMinor * rate) : sum;
+        }, 0),
+      })),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [data, exchangeRates],
+  );
+
+  const statusRows = useMemo(
+    () =>
+      (data?.statusDistribution ?? [])
+        .filter((s) => s.count > 0)
+        .map((s) => ({
+          name: STATUS_LABELS[s.status] ?? s.status,
+          value: s.count,
+          color: categoricalColor(
+            palette,
+            STATUS_ORDER.indexOf(s.status as (typeof STATUS_ORDER)[number]) >= 0
+              ? STATUS_ORDER.indexOf(s.status as (typeof STATUS_ORDER)[number])
+              : STATUS_ORDER.length,
+          ),
+        })),
+    [data, palette],
+  );
+
+  const methodRows = useMemo(
+    () =>
+      (data?.paymentMethods ?? []).slice(0, MAX_METHOD_BARS).map((m) => ({
+        label: prettyMethod(m.method),
+        count: m.count,
+      })),
+    [data],
+  );
+
+  const tooltipStyle = {
+    background: palette.tooltipBg,
+    border: `1px solid ${palette.tooltipBorder}`,
+    borderRadius: 8,
+    fontSize: 12,
+  };
+
+  if (isLoading) {
+    return (
+      <div className="card py-12 text-center text-muted-foreground">
+        <p className="text-sm">Loading booking analytics…</p>
+      </div>
+    );
+  }
+
+  // The dashboard's other cards stand on their own, so a failure here degrades to a
+  // single quiet line rather than taking the page down.
+  if (isError || !data) {
+    return (
+      <div className="card py-8 text-center">
+        <p className="text-sm text-muted-foreground">
+          Booking analytics are unavailable right now.
+        </p>
+      </div>
+    );
+  }
+
+  const hasDays = dayRows.length > 0;
+  const rangeLabel = `Last ${data.window.days} days`;
+
+  const emptyPanel = (
+    <div className="h-[260px] flex items-center justify-center text-muted-foreground text-sm">
+      No bookings in this range
+    </div>
+  );
+
+  return (
+    <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
+      {/* Revenue Trend */}
+      <div className="card">
+        <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground">
+          Revenue Trend
+        </h2>
+        <p className="text-xs text-muted-foreground mt-1 mb-4">
+          {rangeLabel} · value of confirmed bookings on the day they were made, in ETB.
+          Not the same as collected revenue below.
+        </p>
+        {hasDays ? (
+          <ResponsiveContainer width="100%" height={260}>
+            <LineChart data={dayRows} margin={{ top: 4, right: 8, bottom: 4, left: 0 }}>
+              <CartesianGrid stroke={palette.grid} vertical={false} />
+              <XAxis
+                dataKey="label"
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+              />
+              <YAxis
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+                tickFormatter={(v: number) => Math.round(v / 100).toLocaleString()}
+              />
+              <Tooltip
+                contentStyle={tooltipStyle}
+                labelStyle={{ color: palette.textMuted }}
+                formatter={(value: number) => [formatCurrency(value, "ETB"), "Revenue"]}
+              />
+              <Line
+                type="monotone"
+                dataKey="revenueMinor"
+                name="Revenue"
+                stroke={palette.sequential}
+                strokeWidth={2}
+                dot={{ r: 3 }}
+                activeDot={{ r: 5 }}
+              />
+            </LineChart>
+          </ResponsiveContainer>
+        ) : (
+          emptyPanel
+        )}
+      </div>
+
+      {/* Daily Confirmed Bookings */}
+      <div className="card">
+        <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground">
+          Daily Confirmed Bookings
+        </h2>
+        <p className="text-xs text-muted-foreground mt-1 mb-4">
+          {rangeLabel} · how many bookings were confirmed each day.
+        </p>
+        {hasDays ? (
+          <ResponsiveContainer width="100%" height={260}>
+            <BarChart data={dayRows} margin={{ top: 4, right: 8, bottom: 4, left: 0 }}>
+              <CartesianGrid stroke={palette.grid} vertical={false} />
+              <XAxis
+                dataKey="label"
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+              />
+              <YAxis
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+                allowDecimals={false}
+              />
+              <Tooltip
+                cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+                contentStyle={tooltipStyle}
+                labelStyle={{ color: palette.textMuted }}
+              />
+              <Bar
+                dataKey="bookings"
+                name="Bookings"
+                fill={palette.sequential}
+                radius={[3, 3, 0, 0]}
+              />
+            </BarChart>
+          </ResponsiveContainer>
+        ) : (
+          emptyPanel
+        )}
+      </div>
+
+      {/* Booking Status Distribution */}
+      <div className="card">
+        <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground">
+          Booking Status Distribution
+        </h2>
+        <p className="text-xs text-muted-foreground mt-1 mb-4">
+          {rangeLabel} · every booking made in the range, by current status.
+        </p>
+        {statusRows.length > 0 ? (
+          <>
+            {/* Legend with text labels and counts — the palette's light-mode contrast is
+                validated only with that relief in place. */}
+            <div className="flex items-center gap-x-4 gap-y-2 flex-wrap mb-3">
+              {statusRows.map((s) => (
+                <div key={s.name} className="flex items-center gap-1.5">
+                  <span
+                    className="h-2.5 w-2.5 rounded-sm"
+                    style={{ backgroundColor: s.color }}
+                    aria-hidden
+                  />
+                  <span className="text-xs text-muted-foreground">
+                    {s.name} · {s.value}
+                  </span>
+                </div>
+              ))}
+            </div>
+            <ResponsiveContainer width="100%" height={220}>
+              <PieChart>
+                <Pie
+                  data={statusRows}
+                  dataKey="value"
+                  nameKey="name"
+                  cx="50%"
+                  cy="50%"
+                  innerRadius={45}
+                  outerRadius={85}
+                  paddingAngle={2}
+                  stroke={palette.surface}
+                  strokeWidth={2}
+                >
+                  {statusRows.map((s) => (
+                    <Cell key={s.name} fill={s.color} />
+                  ))}
+                </Pie>
+                <Tooltip contentStyle={tooltipStyle} />
+              </PieChart>
+            </ResponsiveContainer>
+          </>
+        ) : (
+          emptyPanel
+        )}
+      </div>
+
+      {/* Payment Methods */}
+      <div className="card">
+        <h2 className="text-sm font-semibold uppercase tracking-widest text-muted-foreground">
+          Payment Methods
+        </h2>
+        <p className="text-xs text-muted-foreground mt-1 mb-4">
+          {rangeLabel} · which method each booking used. &ldquo;Unknown&rdquo; means no
+          payment was started.
+        </p>
+        {methodRows.length > 0 ? (
+          <ResponsiveContainer width="100%" height={38 * methodRows.length + 32}>
+            <BarChart
+              data={methodRows}
+              layout="vertical"
+              margin={{ top: 0, right: 44, bottom: 0, left: 8 }}
+            >
+              <CartesianGrid stroke={palette.grid} horizontal={false} />
+              <XAxis
+                type="number"
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+                allowDecimals={false}
+              />
+              <YAxis
+                type="category"
+                dataKey="label"
+                width={120}
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+              />
+              <Tooltip
+                cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+                contentStyle={tooltipStyle}
+                labelStyle={{ color: palette.textMuted }}
+              />
+              <Bar
+                dataKey="count"
+                name="Bookings"
+                fill={palette.sequential}
+                radius={[0, 3, 3, 0]}
+              >
+                <LabelList
+                  dataKey="count"
+                  position="right"
+                  fill={palette.textMuted}
+                  fontSize={11}
+                />
+              </Bar>
+            </BarChart>
+          </ResponsiveContainer>
+        ) : (
+          emptyPanel
+        )}
+      </div>
+    </div>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/components/layout/Sidebar.tsx b/apps/edr-passenger-web/backoffice/src/components/layout/Sidebar.tsx
index 616488917..de8619577 100644
--- a/apps/edr-passenger-web/backoffice/src/components/layout/Sidebar.tsx
+++ b/apps/edr-passenger-web/backoffice/src/components/layout/Sidebar.tsx
@@ -81,13 +81,13 @@ const navigationSections: { title: string; items: NavItem[] }[] = [
   {
     title: 'Master Data',
     items: [
-      { name: 'Stations',   href: '/stations',   icon: MapPin },
-      { name: 'Trains',     href: '/trains',     icon: Train },
-      { name: 'Coaches',    href: '/coaches',    icon: Grid3x3 },
-      { name: 'Seats',      href: '/seats',      icon: Armchair },
-      { name: 'Classes',    href: '/classes',    icon: Settings },
-      { name: 'Routes',     href: '/routes',     icon: Route },
-      { name: 'Schedules',  href: '/schedules',  icon: Calendar },
+      { name: 'Stations',   href: '/stations',   icon: MapPin,   permission: PERMS.stations.view },
+      { name: 'Trains',     href: '/trains',     icon: Train,    permission: PERMS.trains.view },
+      { name: 'Coaches',    href: '/coaches',    icon: Grid3x3,  permission: PERMS.coaches.view },
+      { name: 'Seats',      href: '/seats',      icon: Armchair, permission: PERMS.seats.view },
+      { name: 'Classes',    href: '/classes',    icon: Settings, permission: PERMS.classes.view },
+      { name: 'Routes',     href: '/routes',     icon: Route,    permission: PERMS.routes.view },
+      { name: 'Schedules',  href: '/schedules',  icon: Calendar, permission: PERMS.schedules.view },
     ]
   },
   {
@@ -123,6 +123,7 @@ const navigationSections: { title: string; items: NavItem[] }[] = [
     title: 'Analytics & Reports',
     items: [
       { name: 'Overall',              href: '/reports/overall',                icon: BarChart3,      permission: PERMS.reports.view },
+      { name: 'Finance',             href: '/reports/finance',                icon: DollarSign,     permission: PERMS.reports.view },
       { name: 'Seats',               href: '/reports/seats',                  icon: Armchair,       permission: PERMS.reports.view },
       { name: 'Blocked Seats',       href: '/reports/blocked-seats',          icon: Ban,            permission: PERMS.reports.view },
       { name: 'Passengers',          href: '/reports/passengers',             icon: Users,          permission: PERMS.reports.view },
diff --git a/apps/edr-passenger-web/backoffice/src/components/reports/FleetPassengerOverview.tsx b/apps/edr-passenger-web/backoffice/src/components/reports/FleetPassengerOverview.tsx
new file mode 100644
index 000000000..c59121005
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/components/reports/FleetPassengerOverview.tsx
@@ -0,0 +1,499 @@
+"use client";
+
+/**
+ * Fleet passenger overview — the landing state of the Passengers Report, shown only
+ * while no schedule is selected. Once a schedule is picked this component unmounts and
+ * the per-schedule occupancy/list tabs take over unchanged.
+ *
+ * Carries no occupancy figure by design. This report and the seat status report measure
+ * capacity differently (this one counts dining and placeholder seats toward `totalSeats`,
+ * the other does not), so an occupancy number here would contradict one of them. This
+ * view answers "who travelled" and leaves "how full" to the seat status report.
+ */
+
+import { useMemo } from "react";
+import { useQuery } from "@tanstack/react-query";
+import {
+  Bar,
+  BarChart,
+  CartesianGrid,
+  LabelList,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis,
+} from "recharts";
+import { CalendarClock, Users } from "lucide-react";
+import { apiClient } from "@/lib/api-client";
+import { categoricalColor, getChartPalette } from "@/lib/chart-palette";
+import { useTheme } from "@/lib/theme-store";
+
+interface OverviewScheduleRow {
+  scheduleId: string;
+  trainNumber: string;
+  originStation: string;
+  destinationStation: string;
+  departureAt: string;
+  isPackage: boolean;
+  passengers: number;
+}
+
+interface PassengerOverview {
+  window: {
+    from: string;
+    to: string;
+    days: number;
+    direction: "UPCOMING" | "RECENT";
+    truncated: boolean;
+  };
+  totals: {
+    scheduleCount: number;
+    totalPassengers: number;
+    groupPassengers: number;
+  };
+  byDay: { date: string; scheduleCount: number; passengers: number }[];
+  byNationality: { nationality: string; passengers: number }[];
+  byCategory: { category: string; passengers: number }[];
+  topRoutes: { origin: string; destination: string; passengers: number }[];
+  schedules: OverviewScheduleRow[];
+}
+
+/**
+ * Fixed colour domain for passenger category. Keyed by position in this list rather than
+ * by rank in the data, so a day with no children does not repaint the adult segment.
+ */
+const CATEGORY_ORDER = ["ADULT", "CHILD"] as const;
+const CATEGORY_LABELS: Record<string, string> = { ADULT: "Adult", CHILD: "Child" };
+
+const MAX_NATIONALITY_BARS = 8;
+
+/** `YYYY-MM-DD` → `05 Mar`, parsed by parts so no timezone can shift the label. */
+function formatDayLabel(date: string): string {
+  const [, month, day] = date.split("-");
+  const monthName = [
+    "Jan", "Feb", "Mar", "Apr", "May", "Jun",
+    "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
+  ][Number(month) - 1];
+  return `${day} ${monthName}`;
+}
+
+function formatWindow(from: string, to: string): string {
+  const opts: Intl.DateTimeFormatOptions = { day: "2-digit", month: "short" };
+  return `${new Date(from).toLocaleDateString("en-GB", opts)} – ${new Date(
+    to,
+  ).toLocaleDateString("en-GB", opts)}`;
+}
+
+export interface FleetPassengerOverviewProps {
+  /** Selecting a schedule from a chart or row hands control to the drill-down. */
+  onSelectSchedule: (scheduleId: string) => void;
+}
+
+export default function FleetPassengerOverview({
+  onSelectSchedule,
+}: FleetPassengerOverviewProps) {
+  const isDark = useTheme((s) => s.isDark);
+  const palette = getChartPalette(isDark);
+
+  const { data, isLoading, isError } = useQuery<PassengerOverview>({
+    queryKey: ["passenger-overview"],
+    queryFn: () => apiClient.get("/reports/passengers/overview"),
+  });
+
+  const dayRows = useMemo(
+    () => (data?.byDay ?? []).map((d) => ({ ...d, label: formatDayLabel(d.date) })),
+    [data],
+  );
+
+  const nationalityRows = useMemo(
+    () => (data?.byNationality ?? []).slice(0, MAX_NATIONALITY_BARS),
+    [data],
+  );
+
+  const routeRows = useMemo(
+    () =>
+      (data?.topRoutes ?? []).map((r) => ({
+        ...r,
+        label: `${r.origin} → ${r.destination}`,
+      })),
+    [data],
+  );
+
+  // One row, one bar, stacked by category — a two-value composition reads better as a
+  // single bar than as a chart with two lonely columns.
+  const categoryRow = useMemo(() => {
+    const row: Record<string, number | string> = { name: "mix" };
+    for (const c of data?.byCategory ?? []) row[c.category] = c.passengers;
+    return [row];
+  }, [data]);
+
+  const categoriesPresent = useMemo(() => {
+    const seen = new Set((data?.byCategory ?? []).map((c) => c.category));
+    const known = CATEGORY_ORDER.filter((c) => seen.has(c));
+    const unknown = [...seen].filter(
+      (c) => !CATEGORY_ORDER.includes(c as (typeof CATEGORY_ORDER)[number]),
+    );
+    return [...known, ...unknown];
+  }, [data]);
+
+  const categoryColor = (category: string) => {
+    const index = CATEGORY_ORDER.indexOf(category as (typeof CATEGORY_ORDER)[number]);
+    return categoricalColor(palette, index >= 0 ? index : CATEGORY_ORDER.length);
+  };
+
+  const tooltipStyle = {
+    background: palette.tooltipBg,
+    border: `1px solid ${palette.tooltipBorder}`,
+    borderRadius: 8,
+    fontSize: 12,
+  };
+
+  if (isLoading) {
+    return (
+      <div className="card py-16 text-center text-muted-foreground">
+        <p className="text-sm">Loading fleet passenger overview…</p>
+      </div>
+    );
+  }
+
+  if (isError) {
+    return (
+      <div className="card py-12 text-center">
+        <p className="text-sm text-red-500">Failed to load the fleet passenger overview.</p>
+        <p className="text-xs text-muted-foreground mt-1">
+          Select a schedule above to load its report directly.
+        </p>
+      </div>
+    );
+  }
+
+  if (!data || data.totals.scheduleCount === 0) {
+    return (
+      <div className="card py-16 text-center text-muted-foreground">
+        <Users className="h-10 w-10 mx-auto mb-3 opacity-30" />
+        <p>No departures on record to summarise</p>
+        <p className="text-xs mt-1">
+          Select a schedule above to load its passengers report
+        </p>
+      </div>
+    );
+  }
+
+  const { window: win, totals } = data;
+  const groupShare =
+    totals.totalPassengers > 0
+      ? Math.round((totals.groupPassengers / totals.totalPassengers) * 100)
+      : 0;
+
+  return (
+    <div className="space-y-6">
+      {/* Window banner — the view is fleet-wide until a schedule is chosen, and the
+          window may be historic, so both facts are stated rather than implied. */}
+      <div className="card">
+        <div className="flex items-start justify-between gap-4 flex-wrap">
+          <div className="flex items-start gap-3">
+            <CalendarClock className="h-5 w-5 text-muted-foreground mt-0.5 shrink-0" />
+            <div>
+              <p className="text-sm font-medium text-foreground">
+                All schedules · {formatWindow(win.from, win.to)}
+              </p>
+              <p className="text-xs text-muted-foreground mt-0.5">
+                {win.direction === "UPCOMING"
+                  ? `Next ${win.days} days — ${totals.scheduleCount} departure${totals.scheduleCount === 1 ? "" : "s"}`
+                  : `No upcoming departures — showing the most recent ${win.days} days (${totals.scheduleCount} departure${totals.scheduleCount === 1 ? "" : "s"})`}
+                {win.truncated && " · truncated to the first 60 departures"}
+              </p>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      {/* Window totals */}
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+        <div className="card">
+          <p className="text-muted-foreground text-sm font-medium">Passengers</p>
+          <p className="text-2xl font-bold mt-1 tabular-nums text-foreground">
+            {totals.totalPassengers}
+          </p>
+          <p className="text-xs text-muted-foreground mt-1">Confirmed and boarded</p>
+        </div>
+        <div className="card">
+          <p className="text-muted-foreground text-sm font-medium">Departures</p>
+          <p className="text-2xl font-bold mt-1 tabular-nums text-foreground">
+            {totals.scheduleCount}
+          </p>
+          <p className="text-xs text-muted-foreground mt-1">In this window</p>
+        </div>
+        <div className="card">
+          <p className="text-muted-foreground text-sm font-medium">Travelling in groups</p>
+          <p className="text-2xl font-bold mt-1 tabular-nums text-foreground">
+            {totals.groupPassengers}
+          </p>
+          <p className="text-xs text-muted-foreground mt-1">
+            {groupShare}% of passengers, on multi-seat bookings
+          </p>
+        </div>
+      </div>
+
+      {/* 1 — Passengers per departure day */}
+      <div className="card">
+        <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-1">
+          Passengers by departure day
+        </h3>
+        <p className="text-xs text-muted-foreground mb-4">
+          How many people travelled each day across every train in the window.
+        </p>
+        <ResponsiveContainer width="100%" height={240}>
+          <BarChart data={dayRows} margin={{ top: 4, right: 8, bottom: 4, left: 0 }}>
+            <CartesianGrid stroke={palette.grid} vertical={false} />
+            <XAxis
+              dataKey="label"
+              tick={{ fill: palette.textMuted, fontSize: 12 }}
+              stroke={palette.axis}
+              tickLine={false}
+            />
+            <YAxis
+              tick={{ fill: palette.textMuted, fontSize: 12 }}
+              stroke={palette.axis}
+              tickLine={false}
+              axisLine={false}
+              allowDecimals={false}
+            />
+            <Tooltip
+              cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+              contentStyle={tooltipStyle}
+              labelStyle={{ color: palette.textMuted }}
+            />
+            <Bar
+              dataKey="passengers"
+              name="Passengers"
+              fill={palette.sequential}
+              radius={[3, 3, 0, 0]}
+            />
+          </BarChart>
+        </ResponsiveContainer>
+      </div>
+
+      <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
+        {/* 2 — Nationality split */}
+        <div className="card">
+          <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-1">
+            Passengers by nationality
+          </h3>
+          <p className="text-xs text-muted-foreground mb-4">
+            Taken from passport country, or Ethiopian where a national ID was used.
+            &ldquo;Unknown&rdquo; means neither was recorded.
+          </p>
+          <ResponsiveContainer width="100%" height={38 * nationalityRows.length + 32}>
+            <BarChart
+              data={nationalityRows}
+              layout="vertical"
+              margin={{ top: 0, right: 44, bottom: 0, left: 8 }}
+            >
+              <CartesianGrid stroke={palette.grid} horizontal={false} />
+              <XAxis
+                type="number"
+                tick={{ fill: palette.textMuted, fontSize: 12 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+                allowDecimals={false}
+              />
+              <YAxis
+                type="category"
+                dataKey="nationality"
+                width={110}
+                tick={{ fill: palette.textMuted, fontSize: 12 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+              />
+              <Tooltip
+                cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+                contentStyle={tooltipStyle}
+                labelStyle={{ color: palette.textMuted }}
+              />
+              <Bar
+                dataKey="passengers"
+                name="Passengers"
+                fill={palette.sequential}
+                radius={[0, 3, 3, 0]}
+              >
+                {/* Values printed on the bars — the palette's light-mode contrast is
+                    validated only with numeric relief in place. */}
+                <LabelList
+                  dataKey="passengers"
+                  position="right"
+                  fill={palette.textMuted}
+                  fontSize={11}
+                />
+              </Bar>
+            </BarChart>
+          </ResponsiveContainer>
+        </div>
+
+        {/* 4 — Busiest origin → destination pairs */}
+        <div className="card">
+          <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-1">
+            Busiest routes
+          </h3>
+          <p className="text-xs text-muted-foreground mb-4">
+            Where people actually travelled from and to — not the train&apos;s own
+            endpoints, but each booking&apos;s.
+          </p>
+          <ResponsiveContainer width="100%" height={38 * routeRows.length + 32}>
+            <BarChart
+              data={routeRows}
+              layout="vertical"
+              margin={{ top: 0, right: 44, bottom: 0, left: 8 }}
+            >
+              <CartesianGrid stroke={palette.grid} horizontal={false} />
+              <XAxis
+                type="number"
+                tick={{ fill: palette.textMuted, fontSize: 12 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+                allowDecimals={false}
+              />
+              <YAxis
+                type="category"
+                dataKey="label"
+                width={170}
+                tick={{ fill: palette.textMuted, fontSize: 11 }}
+                stroke={palette.axis}
+                tickLine={false}
+                axisLine={false}
+              />
+              <Tooltip
+                cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+                contentStyle={tooltipStyle}
+                labelStyle={{ color: palette.textMuted }}
+              />
+              <Bar
+                dataKey="passengers"
+                name="Passengers"
+                fill={palette.sequential}
+                radius={[0, 3, 3, 0]}
+              >
+                <LabelList
+                  dataKey="passengers"
+                  position="right"
+                  fill={palette.textMuted}
+                  fontSize={11}
+                />
+              </Bar>
+            </BarChart>
+          </ResponsiveContainer>
+        </div>
+      </div>
+
+      {/* 3 — Passenger category mix */}
+      <div className="card">
+        <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-1">
+          Adult and child mix
+        </h3>
+        <p className="text-xs text-muted-foreground mb-4">
+          The whole bar is every passenger in the window, split by fare category.
+        </p>
+
+        <div className="flex items-center gap-4 flex-wrap mb-3">
+          {categoriesPresent.map((category) => {
+            const count =
+              data.byCategory.find((c) => c.category === category)?.passengers ?? 0;
+            return (
+              <div key={category} className="flex items-center gap-1.5">
+                <span
+                  className="h-2.5 w-2.5 rounded-sm"
+                  style={{ backgroundColor: categoryColor(category) }}
+                  aria-hidden
+                />
+                <span className="text-xs text-muted-foreground">
+                  {CATEGORY_LABELS[category] ?? category} · {count}
+                </span>
+              </div>
+            );
+          })}
+        </div>
+
+        <ResponsiveContainer width="100%" height={64}>
+          <BarChart
+            data={categoryRow}
+            layout="vertical"
+            margin={{ top: 0, right: 0, bottom: 0, left: 0 }}
+          >
+            <XAxis type="number" hide />
+            <YAxis type="category" dataKey="name" hide />
+            <Tooltip contentStyle={tooltipStyle} labelStyle={{ display: "none" }} />
+            {categoriesPresent.map((category) => (
+              <Bar
+                key={category}
+                dataKey={category}
+                name={CATEGORY_LABELS[category] ?? category}
+                stackId="mix"
+                fill={categoryColor(category)}
+              />
+            ))}
+          </BarChart>
+        </ResponsiveContainer>
+      </div>
+
+      {/* The same numbers as exact figures, and the picker */}
+      <div className="card p-0">
+        <div className="px-4 pt-4 pb-3">
+          <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground">
+            Schedules in window
+          </h3>
+          <p className="text-xs text-muted-foreground mt-1">
+            The exact numbers behind the charts, one row per departure. Click a row to
+            open that train&apos;s full passengers report.
+          </p>
+        </div>
+        <div className="overflow-x-auto">
+          <table className="w-full text-sm">
+            <thead className="bg-gray-50 dark:bg-gray-800">
+              <tr>
+                {["Departure", "Train", "Route", "Passengers"].map((h) => (
+                  <th
+                    key={h}
+                    className="px-4 py-3 text-left text-xs font-medium uppercase tracking-wider text-gray-500 dark:text-gray-400 whitespace-nowrap"
+                  >
+                    {h}
+                  </th>
+                ))}
+              </tr>
+            </thead>
+            <tbody className="bg-white dark:bg-gray-900 divide-y divide-gray-200 dark:divide-gray-700">
+              {data.schedules.map((s) => (
+                <tr
+                  key={s.scheduleId}
+                  onClick={() => onSelectSchedule(s.scheduleId)}
+                  className="hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors cursor-pointer"
+                >
+                  <td className="px-4 py-3 whitespace-nowrap text-xs text-muted-foreground">
+                    {new Date(s.departureAt).toLocaleString("en-GB", {
+                      dateStyle: "medium",
+                      timeStyle: "short",
+                    })}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap font-medium">
+                    {s.trainNumber}
+                    {s.isPackage && (
+                      <span className="text-muted-foreground text-xs"> (package)</span>
+                    )}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap text-xs">
+                    {s.originStation} → {s.destinationStation}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">
+                    {s.passengers}
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/components/reports/FleetSeatOverview.tsx b/apps/edr-passenger-web/backoffice/src/components/reports/FleetSeatOverview.tsx
new file mode 100644
index 000000000..2febaa00b
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/components/reports/FleetSeatOverview.tsx
@@ -0,0 +1,469 @@
+"use client";
+
+/**
+ * Fleet seat overview — the landing state of the Seat Status Report, shown only while
+ * no schedule is selected. Once a schedule is picked this component unmounts and the
+ * per-schedule drill-down takes over unchanged.
+ *
+ * Its numbers come from `/reports/seat-status/overview`, which applies the same counting
+ * rules as `/reports/seat-status`, so a schedule's row here equals what the drill-down
+ * shows after clicking it.
+ */
+
+import { useMemo } from "react";
+import { useQuery } from "@tanstack/react-query";
+import {
+  Bar,
+  BarChart,
+  CartesianGrid,
+  Cell,
+  ResponsiveContainer,
+  Tooltip,
+  XAxis,
+  YAxis,
+} from "recharts";
+import { Armchair, CalendarClock, TrendingUp } from "lucide-react";
+import { apiClient } from "@/lib/api-client";
+import { categoricalColor, getChartPalette } from "@/lib/chart-palette";
+import { useTheme } from "@/lib/theme-store";
+
+interface OverviewScheduleRow {
+  scheduleId: string;
+  trainNumber: string;
+  originStation: string;
+  destinationStation: string;
+  departureAt: string;
+  isPackage: boolean;
+  sellableSeats: number;
+  paid: number;
+  unpaid: number;
+  expiredHolds: number;
+  blocked: number;
+  available: number;
+  loadFactorPercent: number;
+}
+
+interface OverviewDayBucket {
+  date: string;
+  scheduleCount: number;
+  sellableSeats: number;
+  paid: number;
+  unpaid: number;
+  expiredHolds: number;
+  blocked: number;
+  available: number;
+}
+
+interface SeatStatusOverview {
+  window: {
+    from: string;
+    to: string;
+    days: number;
+    direction: "UPCOMING" | "RECENT";
+    truncated: boolean;
+  };
+  totals: {
+    scheduleCount: number;
+    sellableSeats: number;
+    paidCount: number;
+    unpaidCount: number;
+    expiredHoldCount: number;
+    blockedCount: number;
+    availableCount: number;
+    loadFactorPercent: number;
+  };
+  byDay: OverviewDayBucket[];
+  schedules: OverviewScheduleRow[];
+}
+
+/**
+ * Fixed domain order for the inventory series, matching the left-to-right order of the
+ * drill-down's summary cards. Colour is keyed by position here and never by rank in the
+ * data, so a quiet day does not repaint the series.
+ *
+ * Expired holds are deliberately absent: a hold that has expired no longer occupies a
+ * seat, so stacking it against sellable capacity would double-count. It is reported as a
+ * standalone counter instead.
+ */
+const INVENTORY_SERIES = [
+  { key: "paid", label: "Paid", slot: 0 },
+  { key: "unpaid", label: "Unpaid", slot: 1 },
+  { key: "blocked", label: "Blocked", slot: 3 },
+  { key: "available", label: "Available", slot: -1 },
+] as const;
+
+const MAX_SCHEDULE_BARS = 12;
+
+/** `YYYY-MM-DD` → `05 Mar`, parsed by parts so no timezone can shift the label. */
+function formatDayLabel(date: string): string {
+  const [, month, day] = date.split("-");
+  const monthName = [
+    "Jan", "Feb", "Mar", "Apr", "May", "Jun",
+    "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
+  ][Number(month) - 1];
+  return `${day} ${monthName}`;
+}
+
+function formatWindow(from: string, to: string): string {
+  const opts: Intl.DateTimeFormatOptions = { day: "2-digit", month: "short" };
+  return `${new Date(from).toLocaleDateString("en-GB", opts)} – ${new Date(
+    to,
+  ).toLocaleDateString("en-GB", opts)}`;
+}
+
+export interface FleetSeatOverviewProps {
+  /** Selecting a schedule from a chart hands control to the drill-down. */
+  onSelectSchedule: (scheduleId: string) => void;
+}
+
+export default function FleetSeatOverview({ onSelectSchedule }: FleetSeatOverviewProps) {
+  const isDark = useTheme((s) => s.isDark);
+  const palette = getChartPalette(isDark);
+
+  const { data, isLoading, isError } = useQuery<SeatStatusOverview>({
+    queryKey: ["seat-status-overview"],
+    queryFn: () => apiClient.get("/reports/seat-status/overview"),
+  });
+
+  const seriesColor = (slot: number) =>
+    slot < 0 ? palette.grid : categoricalColor(palette, slot);
+
+  const dayRows = useMemo(
+    () => (data?.byDay ?? []).map((d) => ({ ...d, label: formatDayLabel(d.date) })),
+    [data],
+  );
+
+  // Busiest departures first — a 12-bar chart of the whole window would be unreadable,
+  // and the ones carrying the most seats are the ones worth looking at.
+  const scheduleRows = useMemo(
+    () =>
+      (data?.schedules ?? [])
+        .slice()
+        .sort((a, b) => b.sellableSeats - a.sellableSeats)
+        .slice(0, MAX_SCHEDULE_BARS)
+        .map((s) => ({
+          ...s,
+          label: `${s.trainNumber} · ${new Date(s.departureAt).toLocaleDateString("en-GB", {
+            day: "2-digit",
+            month: "short",
+          })}`,
+        })),
+    [data],
+  );
+
+  if (isLoading) {
+    return (
+      <div className="card py-16 text-center text-muted-foreground">
+        <p className="text-sm">Loading fleet seat overview…</p>
+      </div>
+    );
+  }
+
+  if (isError) {
+    return (
+      <div className="card py-12 text-center">
+        <p className="text-sm text-red-500">Failed to load the fleet seat overview.</p>
+        <p className="text-xs text-muted-foreground mt-1">
+          Select a schedule above to load its report directly.
+        </p>
+      </div>
+    );
+  }
+
+  if (!data || data.totals.scheduleCount === 0) {
+    return (
+      <div className="card py-16 text-center text-muted-foreground">
+        <Armchair className="h-10 w-10 mx-auto mb-3 opacity-30" />
+        <p>No departures on record to summarise</p>
+        <p className="text-xs mt-1">Select a schedule above to load its seat status report</p>
+      </div>
+    );
+  }
+
+  const { window: win, totals } = data;
+
+  return (
+    <div className="space-y-6">
+      {/* Window banner — the report is fleet-wide until a schedule is chosen, and the
+          window may be historic, so both facts are stated rather than implied. */}
+      <div className="card">
+        <div className="flex items-start justify-between gap-4 flex-wrap">
+          <div className="flex items-start gap-3">
+            <CalendarClock className="h-5 w-5 text-muted-foreground mt-0.5 shrink-0" />
+            <div>
+              <p className="text-sm font-medium text-foreground">
+                All schedules · {formatWindow(win.from, win.to)}
+              </p>
+              <p className="text-xs text-muted-foreground mt-0.5">
+                {win.direction === "UPCOMING"
+                  ? `Next ${win.days} days — ${totals.scheduleCount} departure${totals.scheduleCount === 1 ? "" : "s"}`
+                  : `No upcoming departures — showing the most recent ${win.days} days (${totals.scheduleCount} departure${totals.scheduleCount === 1 ? "" : "s"})`}
+                {win.truncated && " · truncated to the first 60 departures"}
+              </p>
+            </div>
+          </div>
+          <div className="flex items-center gap-2 text-sm">
+            <TrendingUp className="h-4 w-4 text-muted-foreground" />
+            <span className="text-muted-foreground">Load factor</span>
+            <span className="font-semibold tabular-nums text-foreground">
+              {totals.loadFactorPercent}%
+            </span>
+          </div>
+        </div>
+      </div>
+
+      {/* Window totals. Distinct wording from the per-schedule summary cards so the two
+          are never mistaken for each other. */}
+      <div className="grid grid-cols-2 md:grid-cols-5 gap-4">
+        {[
+          { label: "Paid", value: totals.paidCount, hint: "Payment confirmed", slot: 0 },
+          { label: "Unpaid", value: totals.unpaidCount, hint: "Awaiting payment", slot: 1 },
+          { label: "Blocked", value: totals.blockedCount, hint: "Withheld from sale", slot: 3 },
+          { label: "Available", value: totals.availableCount, hint: "Still sellable", slot: -1 },
+          {
+            label: "Expired Holds",
+            value: totals.expiredHoldCount,
+            hint: "Last 24h, seats released",
+            slot: -2,
+          },
+        ].map((tile) => (
+          <div key={tile.label} className="card">
+            <div className="flex items-start gap-2">
+              {tile.slot !== -2 && (
+                <span
+                  className="h-2.5 w-2.5 rounded-full mt-1.5 shrink-0"
+                  style={{ backgroundColor: seriesColor(tile.slot) }}
+                  aria-hidden
+                />
+              )}
+              <div>
+                <p className="text-muted-foreground text-sm font-medium">{tile.label}</p>
+                <p className="text-2xl font-bold mt-1 tabular-nums text-foreground">
+                  {tile.value}
+                </p>
+                <p className="text-xs text-muted-foreground mt-1">{tile.hint}</p>
+              </div>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {/* Seat mix per departure day */}
+      <div className="card">
+        <div className="flex items-baseline justify-between gap-4 flex-wrap mb-1">
+          <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground">
+            Seat mix by departure day
+          </h3>
+          <span className="text-xs text-muted-foreground">
+            {totals.sellableSeats} sellable seats in window
+          </span>
+        </div>
+        <p className="text-xs text-muted-foreground mb-4">
+          Every seat running on each day, split by what happened to it — paid, waiting on
+          payment, blocked, or still on sale. The whole bar is that day&apos;s capacity.
+        </p>
+
+        {/* Legend carries visible text labels — the palette's light-mode contrast is
+            validated only with that relief in place. */}
+        <div className="flex items-center gap-4 flex-wrap mb-3">
+          {INVENTORY_SERIES.map((s) => (
+            <div key={s.key} className="flex items-center gap-1.5">
+              <span
+                className="h-2.5 w-2.5 rounded-sm"
+                style={{ backgroundColor: seriesColor(s.slot) }}
+                aria-hidden
+              />
+              <span className="text-xs text-muted-foreground">{s.label}</span>
+            </div>
+          ))}
+        </div>
+
+        <ResponsiveContainer width="100%" height={260}>
+          <BarChart data={dayRows} margin={{ top: 4, right: 8, bottom: 4, left: 0 }}>
+            <CartesianGrid stroke={palette.grid} vertical={false} />
+            <XAxis
+              dataKey="label"
+              tick={{ fill: palette.textMuted, fontSize: 12 }}
+              stroke={palette.axis}
+              tickLine={false}
+            />
+            <YAxis
+              tick={{ fill: palette.textMuted, fontSize: 12 }}
+              stroke={palette.axis}
+              tickLine={false}
+              axisLine={false}
+              allowDecimals={false}
+            />
+            <Tooltip
+              cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+              contentStyle={{
+                background: palette.tooltipBg,
+                border: `1px solid ${palette.tooltipBorder}`,
+                borderRadius: 8,
+                fontSize: 12,
+              }}
+              labelStyle={{ color: palette.textMuted }}
+            />
+            {INVENTORY_SERIES.map((s) => (
+              <Bar
+                key={s.key}
+                dataKey={s.key}
+                name={s.label}
+                stackId="seats"
+                fill={seriesColor(s.slot)}
+                radius={s.key === "available" ? [3, 3, 0, 0] : undefined}
+              />
+            ))}
+          </BarChart>
+        </ResponsiveContainer>
+      </div>
+
+      {/* Load factor per schedule — doubles as the picker */}
+      <div className="card">
+        <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground mb-1">
+          Load factor by departure
+        </h3>
+        <p className="text-xs text-muted-foreground mb-4">
+          How full each train is — paid seats as a share of the seats it can sell, so 100%
+          means sold out. Showing the {scheduleRows.length} busiest departure
+          {scheduleRows.length === 1 ? "" : "s"}; click a bar to open that train&apos;s
+          report.
+        </p>
+
+        <ResponsiveContainer width="100%" height={44 * scheduleRows.length + 32}>
+          <BarChart
+            data={scheduleRows}
+            layout="vertical"
+            margin={{ top: 0, right: 40, bottom: 0, left: 8 }}
+          >
+            <CartesianGrid stroke={palette.grid} horizontal={false} />
+            <XAxis
+              type="number"
+              domain={[0, 100]}
+              unit="%"
+              tick={{ fill: palette.textMuted, fontSize: 12 }}
+              stroke={palette.axis}
+              tickLine={false}
+              axisLine={false}
+            />
+            <YAxis
+              type="category"
+              dataKey="label"
+              width={130}
+              tick={{ fill: palette.textMuted, fontSize: 12 }}
+              stroke={palette.axis}
+              tickLine={false}
+              axisLine={false}
+            />
+            <Tooltip
+              cursor={{ fill: palette.grid, fillOpacity: 0.35 }}
+              contentStyle={{
+                background: palette.tooltipBg,
+                border: `1px solid ${palette.tooltipBorder}`,
+                borderRadius: 8,
+                fontSize: 12,
+              }}
+              labelStyle={{ color: palette.textMuted }}
+              formatter={(value: number, _name, entry: any) => [
+                `${value}% · ${entry?.payload?.paid ?? 0} of ${entry?.payload?.sellableSeats ?? 0} seats`,
+                "Load factor",
+              ]}
+            />
+            <Bar
+              dataKey="loadFactorPercent"
+              name="Load factor"
+              fill={palette.sequential}
+              radius={[0, 3, 3, 0]}
+              cursor="pointer"
+              onClick={(entry: any) => {
+                const id = entry?.payload?.scheduleId ?? entry?.scheduleId;
+                if (id) onSelectSchedule(id);
+              }}
+            >
+              {scheduleRows.map((row) => (
+                <Cell key={row.scheduleId} fill={palette.sequential} />
+              ))}
+            </Bar>
+          </BarChart>
+        </ResponsiveContainer>
+      </div>
+
+      {/* The same numbers as a table — required relief for the palette's light-mode
+          contrast, and the only place the per-schedule detail is readable exactly. */}
+      <div className="card p-0">
+        <div className="px-4 pt-4 pb-3">
+          <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground">
+            Schedules in window
+          </h3>
+          <p className="text-xs text-muted-foreground mt-1">
+            The exact numbers behind the charts, one row per departure. Click a row to
+            open that train&apos;s full seat status report.
+          </p>
+        </div>
+        <div className="overflow-x-auto">
+          <table className="w-full text-sm">
+            <thead className="bg-gray-50 dark:bg-gray-800">
+              <tr>
+                {[
+                  "Departure",
+                  "Train",
+                  "Route",
+                  "Sellable",
+                  "Paid",
+                  "Unpaid",
+                  "Blocked",
+                  "Available",
+                  "Load",
+                ].map((h) => (
+                  <th
+                    key={h}
+                    className="px-4 py-3 text-left text-xs font-medium uppercase tracking-wider text-gray-500 dark:text-gray-400 whitespace-nowrap"
+                  >
+                    {h}
+                  </th>
+                ))}
+              </tr>
+            </thead>
+            <tbody className="bg-white dark:bg-gray-900 divide-y divide-gray-200 dark:divide-gray-700">
+              {data.schedules.map((s) => (
+                <tr
+                  key={s.scheduleId}
+                  onClick={() => onSelectSchedule(s.scheduleId)}
+                  className="hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors cursor-pointer"
+                >
+                  <td className="px-4 py-3 whitespace-nowrap text-xs text-muted-foreground">
+                    {new Date(s.departureAt).toLocaleString("en-GB", {
+                      dateStyle: "medium",
+                      timeStyle: "short",
+                    })}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap font-medium">
+                    {s.trainNumber}
+                    {s.isPackage && (
+                      <span className="text-muted-foreground text-xs"> (package)</span>
+                    )}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap text-xs">
+                    {s.originStation} → {s.destinationStation}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">
+                    {s.sellableSeats}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">{s.paid}</td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">{s.unpaid}</td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">{s.blocked}</td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">
+                    {s.available}
+                  </td>
+                  <td className="px-4 py-3 whitespace-nowrap tabular-nums">
+                    {s.loadFactorPercent}%
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/apps/edr-passenger-web/backoffice/src/components/ui/Skeleton.tsx b/apps/edr-passenger-web/backoffice/src/components/ui/Skeleton.tsx
new file mode 100644
index 000000000..e6f24fb02
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/components/ui/Skeleton.tsx
@@ -0,0 +1,10 @@
+import { cn } from '@/lib/utils';
+
+interface SkeletonProps {
+  className?: string;
+}
+
+/** A shimmering placeholder block. Give it the size/shape of the content it stands in for. */
+export default function Skeleton({ className }: SkeletonProps) {
+  return <div className={cn('skeleton', className)} aria-hidden="true" />;
+}
diff --git a/apps/edr-passenger-web/backoffice/src/lib/api/finance.ts b/apps/edr-passenger-web/backoffice/src/lib/api/finance.ts
new file mode 100644
index 000000000..fa0bc943d
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/lib/api/finance.ts
@@ -0,0 +1,63 @@
+import { apiClient } from '@/lib/api-client';
+
+export type FinanceGranularity = 'daily' | 'weekly' | 'monthly';
+
+export interface FinanceSummaryFilters {
+  dateFrom: string;
+  dateTo: string;
+  granularity?: FinanceGranularity;
+  originStationId?: string;
+  destinationStationId?: string;
+  method?: string;
+}
+
+export interface FinanceBucketRow {
+  period: string;
+  originStationId: string;
+  destinationStationId: string;
+  segmentLabel: string;
+  method: string;
+  currency: string;
+  bookingCount: number;
+  revenueMinor: number;
+}
+
+/** One roll-up entry. Amounts are never mixed across currencies — `currency` names which one this row is in. */
+export interface FinanceRollupRow {
+  key: string;
+  label: string;
+  currency: string;
+  revenueMinor: number;
+  bookingCount: number;
+}
+
+export interface FinanceSummaryReport {
+  granularity: FinanceGranularity;
+  dateFrom: string;
+  dateTo: string;
+  /** Grand totals, one entry per currency present — never summed across currencies. */
+  totals: FinanceRollupRow[];
+  byPeriod: FinanceRollupRow[];
+  bySegment: FinanceRollupRow[];
+  byMethod: FinanceRollupRow[];
+  rows: FinanceBucketRow[];
+}
+
+/** Drops blanks so the API applies its own defaults (granularity=daily, no station/method filter). */
+function toParams(filters: FinanceSummaryFilters): Record<string, string> {
+  const params: Record<string, string> = { dateFrom: filters.dateFrom, dateTo: filters.dateTo };
+  if (filters.granularity) params.granularity = filters.granularity;
+  if (filters.originStationId) params.originStationId = filters.originStationId;
+  if (filters.destinationStationId) params.destinationStationId = filters.destinationStationId;
+  if (filters.method) params.method = filters.method;
+  return params;
+}
+
+export const financeApi = {
+  getSummary: (filters: FinanceSummaryFilters) =>
+    apiClient.get<FinanceSummaryReport>('/reports/finance', { params: toParams(filters) }),
+
+  /** CSV export. `getRaw` because the endpoint streams a bare CSV body, not the `{success,data}` envelope. */
+  exportCsv: (filters: FinanceSummaryFilters) =>
+    apiClient.getRaw<string>('/reports/finance/export', { params: toParams(filters) }),
+};
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 f528f9dff..7350928b3 100644
--- a/apps/edr-passenger-web/backoffice/src/lib/api/index.ts
+++ b/apps/edr-passenger-web/backoffice/src/lib/api/index.ts
@@ -380,7 +380,11 @@ export const verifaydaApi = {
 // Audit API
 export const auditApi = {
   getLogs: async (params?: any) => {
-    const query = new URLSearchParams(params as Record<string, string>).toString();
+    // Drop empty filters so a blank search box doesn't send `search=` and match nothing.
+    const entries = Object.entries(params ?? {}).filter(
+      ([, v]) => v !== undefined && v !== null && v !== '',
+    );
+    const query = new URLSearchParams(entries as [string, string][]).toString();
     const response = await apiClient.get<any>(`/audit/logs${query ? `?${query}` : ''}`);
     if (response?.data) {
       return Array.isArray(response.data) ? { items: response.data } : response;
@@ -388,6 +392,7 @@ export const auditApi = {
     return Array.isArray(response) ? { items: response } : response;
   },
   getLog: (id: string) => apiClient.get<any>(`/audit/logs/${id}`),
+  getVocabulary: () => apiClient.get<any>('/audit/vocabulary'),
 };
 
 // Live Tracking API
diff --git a/apps/edr-passenger-web/backoffice/src/lib/auth-store.ts b/apps/edr-passenger-web/backoffice/src/lib/auth-store.ts
index 05e47039d..8a4766f82 100644
--- a/apps/edr-passenger-web/backoffice/src/lib/auth-store.ts
+++ b/apps/edr-passenger-web/backoffice/src/lib/auth-store.ts
@@ -6,6 +6,33 @@ import axios from 'axios';
 
 const API_URL = process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000';
 
+/**
+ * Every permission key a single IAM position grants.
+ *
+ * A position's own `permissions[]` used to be the whole story. IAM now also
+ * hangs grants off *position types* — the legacy singular `positionType` plus
+ * the newer `positionTypes[]` array, whose entries expose
+ * `positionTypePermissions[].permission.key` (note the extra `permission`
+ * wrapper). Union all three rather than trust IAM to have merged them back into
+ * `permissions[]`. Mirrors collectPermissionKeys() on the API.
+ */
+export function positionPermissionKeys(pos: any): string[] {
+  const keys: string[] = (pos?.permissions ?? [])
+    .map((p: any) => p?.key)
+    .filter(Boolean)
+    .map(String);
+
+  const positionTypes: any[] = [pos?.positionType, ...(pos?.positionTypes ?? [])];
+  for (const pt of positionTypes) {
+    for (const ptp of pt?.positionTypePermissions ?? []) {
+      const key = ptp?.permission?.key;
+      if (key) keys.push(String(key));
+    }
+  }
+
+  return keys;
+}
+
 function mapIamRole(roles: { key?: string }[]): 'ADMIN' | 'AGENT' | 'SUPERVISOR' {
   const keys = roles.map((r) => r.key ?? '');
   if (keys.some((k) => k.includes('admin') || k === 'super_admin' || k === 'organization_admin')) return 'ADMIN';
@@ -18,7 +45,8 @@ interface AuthState {
   token: string | null;
   refreshToken: string | null;
   isAuthenticated: boolean;
-  login: (email: string, password: string) => Promise<void>;
+  /** `identifier` may be an email, phone number or username — always sent as `email`. */
+  login: (identifier: string, password: string) => Promise<void>;
   logout: () => void;
   setUser: (user: AdminUser, token: string) => void;
   initialize: () => void;
@@ -52,9 +80,10 @@ export const useAuthStore = create<AuthState>((set, get) => ({
     }
   },
 
-  login: async (email: string, password: string) => {
-    // Step 1: IAM login — returns token + refreshToken only
-    const loginRes = await axios.post(`${API_URL}/v1/auth/login`, { email, password });
+  login: async (identifier: string, password: string) => {
+    // Step 1: IAM login — returns token + refreshToken only.
+    // The IAM accepts an email, phone number or username in the `email` field.
+    const loginRes = await axios.post(`${API_URL}/v1/auth/login`, { email: identifier, password });
     const loginData = loginRes.data?.data ?? loginRes.data;
     const { token, refreshToken } = loginData;
     if (!token) throw new Error('No token received from server');
@@ -68,12 +97,11 @@ export const useAuthStore = create<AuthState>((set, get) => ({
 
     // Role permissions — flat array in data.permissions
     const rolePerms = (iamUser.permissions ?? []).map((p: any) => String(p.key));
-    // Position permissions — employee[] is an array here; positions[].permissions[] merged by IAM
+    // Position permissions — employee[] is an array here; each position contributes
+    // its own permissions[] plus everything its position type(s) grant.
     const employeeArr: any[] = Array.isArray(iamUser.employee) ? iamUser.employee : [];
     const positionPerms = employeeArr.flatMap((emp: any) =>
-      (emp.positions ?? []).flatMap((pos: any) =>
-        (pos.permissions ?? []).map((p: any) => String(p.key))
-      )
+      (emp.positions ?? []).flatMap((pos: any) => positionPermissionKeys(pos))
     );
     const permissions = Array.from(new Set([...rolePerms, ...positionPerms]));
 
diff --git a/apps/edr-passenger-web/backoffice/src/lib/export/finance-workbook.ts b/apps/edr-passenger-web/backoffice/src/lib/export/finance-workbook.ts
new file mode 100644
index 000000000..066d6b355
--- /dev/null
+++ b/apps/edr-passenger-web/backoffice/src/lib/export/finance-workbook.ts
@@ -0,0 +1,284 @@
+import ExcelJS from 'exceljs';
+import type { FinanceGranularity, FinanceSummaryReport } from '@/lib/api/finance';
+
+// Brand palette — rgb(20,113,76), the same green used by ActionButton's primary variant,
+// so the exported file reads as the same product as the on-screen report.
+const BRAND = 'FF14714C';
+const BRAND_DARK = 'FF0E5A3D';
+const BRAND_TINT = 'FFEAF5EF';
+const INK = 'FF1F2937';
+const MUTED = 'FF6B7280';
+const ROW_ALT = 'FFF7F8F7';
+const BORDER = 'FFE2E5E1';
+const WHITE = 'FFFFFFFF';
+
+const THIN_BORDER: Partial<ExcelJS.Borders> = {
+  top: { style: 'thin', color: { argb: BORDER } },
+  left: { style: 'thin', color: { argb: BORDER } },
+  bottom: { style: 'thin', color: { argb: BORDER } },
+  right: { style: 'thin', color: { argb: BORDER } },
+};
+
+/** Amounts are never converted between currencies, so every number format names its own currency. */
+function currencyFmt(currency: string): string {
+  return `"${currency}" #,##0.00`;
+}
+
+export interface ChartImage {
+  dataUrl: string;
+  width: number;
+  height: number;
+}
+
+export interface FinanceWorkbookInput {
+  report: FinanceSummaryReport;
+  filters: { dateFrom: string; dateTo: string; granularity: FinanceGranularity; originLabel: string; destinationLabel: string; methodLabel: string };
+  methodLabel: (method: string) => string;
+  periodLabel: (period: string, granularity: FinanceGranularity) => string;
+  /** One Trend/Segment/Method image set per currency present — mirrors the on-screen per-currency sections. */
+  imagesByCurrency: Record<string, { trend?: ChartImage; segment?: ChartImage; method?: ChartImage }>;
+}
+
+function styleHeaderCell(cell: ExcelJS.Cell) {
+  cell.font = { bold: true, color: { argb: WHITE }, size: 11 };
+  cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: BRAND } };
+  cell.alignment = { vertical: 'middle', horizontal: 'left' };
+  cell.border = THIN_BORDER;
+}
+
+function addTableHeader(ws: ExcelJS.Worksheet, rowIndex: number, headers: string[], alignRight: Set<number> = new Set()) {
+  const row = ws.getRow(rowIndex);
+  headers.forEach((h, i) => {
+    const cell = row.getCell(i + 1);
+    cell.value = h;
+    styleHeaderCell(cell);
+    if (alignRight.has(i)) cell.alignment = { vertical: 'middle', horizontal: 'right' };
+  });
+  row.height = 20;
+  row.commit();
+}
+
+function bandRow(ws: ExcelJS.Worksheet, rowIndex: number, colCount: number, isAlt: boolean) {
+  const row = ws.getRow(rowIndex);
+  for (let c = 1; c <= colCount; c++) {
+    const cell = row.getCell(c);
+    cell.border = THIN_BORDER;
+    if (isAlt) cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: ROW_ALT } };
+  }
+}
+
+function titleBanner(ws: ExcelJS.Worksheet, title: string, subtitle: string, colSpan: number) {
+  ws.mergeCells(1, 1, 1, colSpan);
+  const titleCell = ws.getCell(1, 1);
+  titleCell.value = title;
+  titleCell.font = { bold: true, size: 18, color: { argb: WHITE } };
+  titleCell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: BRAND } };
+  titleCell.alignment = { vertical: 'middle', horizontal: 'left', indent: 1 };
+  ws.getRow(1).height = 34;
+  for (let c = 1; c <= colSpan; c++) ws.getCell(1, c).fill = titleCell.fill;
+
+  ws.mergeCells(2, 1, 2, colSpan);
+  const subCell = ws.getCell(2, 1);
+  subCell.value = subtitle;
+  subCell.font = { italic: true, size: 10, color: { argb: MUTED } };
+  subCell.alignment = { vertical: 'middle', horizontal: 'left', indent: 1 };
+  ws.getRow(2).height = 18;
+}
+
+function kpiCard(ws: ExcelJS.Worksheet, startRow: number, startCol: number, span: number, label: string, value: string, accent: string) {
+  ws.mergeCells(startRow, startCol, startRow, startCol + span - 1);
+  ws.mergeCells(startRow + 1, startCol, startRow + 1, startCol + span - 1);
+
+  const labelCell = ws.getCell(startRow, startCol);
+  labelCell.value = label.toUpperCase();
+  labelCell.font = { bold: true, size: 9, color: { argb: MUTED } };
+  labelCell.alignment = { vertical: 'middle', horizontal: 'left', indent: 1 };
+
+  const valueCell = ws.getCell(startRow + 1, startCol);
+  valueCell.value = value;
+  valueCell.font = { bold: true, size: 16, color: { argb: accent } };
+  valueCell.alignment = { vertical: 'middle', horizontal: 'left', indent: 1 };
+
+  for (let r = startRow; r <= startRow + 1; r++) {
+    for (let c = startCol; c < startCol + span; c++) {
+      const cell = ws.getCell(r, c);
+      cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: BRAND_TINT } };
+      cell.border = {
+        top: r === startRow ? { style: 'thin', color: { argb: BORDER } } : undefined,
+        bottom: r === startRow + 1 ? { style: 'thin', color: { argb: BORDER } } : undefined,
+        left: c === startCol ? { style: 'thin', color: { argb: BORDER } } : undefined,
+        right: c === startCol + span - 1 ? { style: 'thin', color: { argb: BORDER } } : undefined,
+      };
+    }
+  }
+  ws.getRow(startRow).height = 16;
+  ws.getRow(startRow + 1).height = 26;
+}
+
+/** Lays out KPI cards three to a row (each spanning 2 of 6 columns). Returns the next free row. */
+function kpiRow(ws: ExcelJS.Worksheet, startRow: number, cards: { label: string; value: string; accent: string }[]): number {
+  const perRow = 3;
+  let row = startRow;
+  for (let i = 0; i < cards.length; i += perRow) {
+    const rowCards = cards.slice(i, i + perRow);
+    rowCards.forEach((c, idx) => kpiCard(ws, row, 1 + idx * 2, 2, c.label, c.value, c.accent));
+    row += 3;
+  }
+  return row;
+}
+
+function addImage(wb: ExcelJS.Workbook, ws: ExcelJS.Worksheet, image: ChartImage | undefined, anchorRow: number, heading: string) {
+  const headingCell = ws.getCell(anchorRow, 1);
+  headingCell.value = heading;
+  headingCell.font = { bold: true, size: 12, color: { argb: INK } };
+  ws.getRow(anchorRow).height = 20;
+
+  if (!image) {
+    const emptyCell = ws.getCell(anchorRow + 1, 1);
+    emptyCell.value = 'No chart available for the current filters.';
+    emptyCell.font = { italic: true, size: 10, color: { argb: MUTED } };
+    return anchorRow + 3;
+  }
+
+  const maxWidth = 640;
+  const scale = image.width > maxWidth ? maxWidth / image.width : 1;
+  const width = Math.round(image.width * scale);
+  const height = Math.round(image.height * scale);
+
+  const imageId = wb.addImage({ base64: image.dataUrl, extension: 'png' });
+  ws.addImage(imageId, {
+    tl: { col: 0.15, row: anchorRow + 0.15 },
+    ext: { width, height },
+  });
+
+  // Advance past the image height (≈20px per row) plus a spacer row.
+  const rowsUsed = Math.ceil(height / 20) + 2;
+  return anchorRow + rowsUsed;
+}
+
+export async function buildFinanceWorkbook(input: FinanceWorkbookInput): Promise<Blob> {
+  const { report, filters, imagesByCurrency } = input;
+  const methodLabel = input.methodLabel;
+  const periodLabel = input.periodLabel;
+
+  const totals = [...report.totals].sort((a, b) => b.revenueMinor - a.revenueMinor);
+  const totalBookings = totals.reduce((sum, t) => sum + t.bookingCount, 0);
+
+  const wb = new ExcelJS.Workbook();
+  wb.creator = 'EDR Passenger Backoffice';
+  wb.created = new Date();
+
+  // ── Summary sheet ─────────────────────────────────────────────────────────
+  const summary = wb.addWorksheet('Summary', { views: [{ showGridLines: false }] });
+  summary.columns = [{ width: 16 }, { width: 16 }, { width: 16 }, { width: 16 }, { width: 16 }, { width: 16 }];
+
+  titleBanner(
+    summary,
+    'EDR Passenger — Finance Summary',
+    `${filters.dateFrom} to ${filters.dateTo} · ${filters.granularity} · Origin: ${filters.originLabel} · Destination: ${filters.destinationLabel} · Method: ${filters.methodLabel} · Generated ${new Date().toLocaleString('en-US')}`,
+    6,
+  );
+
+  // Amounts are never converted between currencies — each currency present gets its own
+  // card, exactly like the on-screen "Revenue by Currency" breakdown.
+  const revenueCards = totals.map((t) => ({
+    label: `Revenue (${t.currency})`,
+    value: `${t.currency} ${(t.revenueMinor / 100).toLocaleString('en-US', { minimumFractionDigits: 2 })}`,
+    accent: BRAND_DARK,
+  }));
+  const cursorAfterKpis = kpiRow(summary, 4, [
+    { label: 'Bookings', value: totalBookings.toLocaleString('en-US'), accent: INK },
+    ...revenueCards,
+  ]);
+
+  // One Trend/Segment/Method chart set per currency, largest currency first — mirrors the
+  // on-screen layout so no currency's payment-method breakdown gets dropped from the file.
+  let cursor = cursorAfterKpis + 1;
+  for (const t of totals) {
+    const images = imagesByCurrency[t.currency] ?? {};
+    cursor = addImage(wb, summary, images.trend, cursor, `Revenue Trend (${t.currency})`) + 1;
+    cursor = addImage(wb, summary, images.segment, cursor, `Revenue by Segment (${t.currency})`) + 1;
+    cursor = addImage(wb, summary, images.method, cursor, `Revenue by Payment Method (${t.currency})`) + 1;
+  }
+
+  // ── By Period sheet ──────────────────────────────────────────────────────
+  const byPeriod = wb.addWorksheet('By Period', { views: [{ state: 'frozen', ySplit: 1 }] });
+  byPeriod.columns = [{ width: 18 }, { width: 12 }, { width: 14 }, { width: 20 }];
+  addTableHeader(byPeriod, 1, ['Period', 'Currency', 'Bookings', 'Revenue'], new Set([1, 2]));
+  const periodRows = [...report.byPeriod].sort((a, b) => a.key.localeCompare(b.key));
+  periodRows.forEach((p, i) => {
+    const r = byPeriod.getRow(i + 2);
+    r.getCell(1).value = periodLabel(p.label, report.granularity);
+    r.getCell(2).value = p.currency;
+    r.getCell(3).value = p.bookingCount;
+    r.getCell(3).alignment = { horizontal: 'right' };
+    r.getCell(4).value = p.revenueMinor / 100;
+    r.getCell(4).numFmt = currencyFmt(p.currency);
+    r.getCell(4).alignment = { horizontal: 'right' };
+    bandRow(byPeriod, i + 2, 4, i % 2 === 1);
+  });
+  byPeriod.autoFilter = { from: { row: 1, column: 1 }, to: { row: 1, column: 4 } };
+
+  // ── By Segment sheet ─────────────────────────────────────────────────────
+  const bySegment = wb.addWorksheet('By Segment', { views: [{ state: 'frozen', ySplit: 1 }] });
+  bySegment.columns = [{ width: 34 }, { width: 12 }, { width: 14 }, { width: 20 }];
+  addTableHeader(bySegment, 1, ['Origin → Destination', 'Currency', 'Bookings', 'Revenue'], new Set([1, 2]));
+  report.bySegment.forEach((s, i) => {
+    const r = bySegment.getRow(i + 2);
+    r.getCell(1).value = s.label;
+    r.getCell(2).value = s.currency;
+    r.getCell(3).value = s.bookingCount;
+    r.getCell(3).alignment = { horizontal: 'right' };
+    r.getCell(4).value = s.revenueMinor / 100;
+    r.getCell(4).numFmt = currencyFmt(s.currency);
+    r.getCell(4).alignment = { horizontal: 'right' };
+    bandRow(bySegment, i + 2, 4, i % 2 === 1);
+  });
+  bySegment.autoFilter = { from: { row: 1, column: 1 }, to: { row: 1, column: 4 } };
+
+  // ── By Method sheet ──────────────────────────────────────────────────────
+  // Share is computed against the grand total for that same currency (`totals`), never
+  // against a sum spanning multiple currencies.
+  const byMethod = wb.addWorksheet('By Method', { views: [{ state: 'frozen', ySplit: 1 }] });
+  byMethod.columns = [{ width: 20 }, { width: 12 }, { width: 14 }, { width: 20 }, { width: 12 }];
+  addTableHeader(byMethod, 1, ['Payment Method', 'Currency', 'Bookings', 'Revenue', 'Share'], new Set([1, 2, 3]));
+  const totalByCurrency = new Map(totals.map((t) => [t.currency, t.revenueMinor]));
+  report.byMethod.forEach((m, i) => {
+    const r = byMethod.getRow(i + 2);
+    const currencyTotal = totalByCurrency.get(m.currency) ?? 0;
+    r.getCell(1).value = methodLabel(m.label);
+    r.getCell(2).value = m.currency;
+    r.getCell(3).value = m.bookingCount;
+    r.getCell(3).alignment = { horizontal: 'right' };
+    r.getCell(4).value = m.revenueMinor / 100;
+    r.getCell(4).numFmt = currencyFmt(m.currency);
+    r.getCell(4).alignment = { horizontal: 'right' };
+    r.getCell(5).value = currencyTotal > 0 ? m.revenueMinor / currencyTotal : 0;
+    r.getCell(5).numFmt = '0.0%';
+    r.getCell(5).alignment = { horizontal: 'right' };
+    bandRow(byMethod, i + 2, 5, i % 2 === 1);
+  });
+  byMethod.autoFilter = { from: { row: 1, column: 1 }, to: { row: 1, column: 5 } };
+
+  // ── Detail sheet — every row, unpaginated ───────────────────────────────
+  const detail = wb.addWorksheet('Detail', { views: [{ state: 'frozen', ySplit: 1 }] });
+  detail.columns = [{ width: 18 }, { width: 34 }, { width: 18 }, { width: 12 }, { width: 14 }, { width: 20 }];
+  addTableHeader(detail, 1, ['Period', 'Origin → Destination', 'Payment Method', 'Currency', 'Bookings', 'Revenue'], new Set([2, 3]));
+  report.rows.forEach((row, i) => {
+    const r = detail.getRow(i + 2);
+    r.getCell(1).value = periodLabel(row.period, report.granularity);
+    r.getCell(2).value = row.segmentLabel;
+    r.getCell(3).value = methodLabel(row.method);
+    r.getCell(4).value = row.currency;
+    r.getCell(5).value = row.bookingCount;
+    r.getCell(5).alignment = { horizontal: 'right' };
+    r.getCell(6).value = row.revenueMinor / 100;
+    r.getCell(6).numFmt = currencyFmt(row.currency);
+    r.getCell(6).alignment = { horizontal: 'right' };
+    bandRow(detail, i + 2, 6, i % 2 === 1);
+  });
+  detail.autoFilter = { from: { row: 1, column: 1 }, to: { row: 1, column: 6 } };
+
+  const buffer = await wb.xlsx.writeBuffer();
+  return new Blob([buffer], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' });
+}
diff --git a/apps/edr-passenger-web/backoffice/src/styles/globals.css b/apps/edr-passenger-web/backoffice/src/styles/globals.css
index e14e614af..4fd8c86dc 100644
--- a/apps/edr-passenger-web/backoffice/src/styles/globals.css
+++ b/apps/edr-passenger-web/backoffice/src/styles/globals.css
@@ -68,6 +68,24 @@
   .animate-fade-up {
     animation: fade-up 0.25s cubic-bezier(0.22, 1, 0.36, 1) both;
   }
+
+  @keyframes shimmer {
+    from { background-position: -300px 0; }
+    to   { background-position: 300px 0; }
+  }
+  .skeleton {
+    border-radius: 0.5rem;
+    background-color: hsl(var(--muted));
+    background-image: linear-gradient(
+      90deg,
+      hsl(var(--muted)) 0%,
+      hsl(var(--muted-foreground) / 0.18) 50%,
+      hsl(var(--muted)) 100%
+    );
+    background-size: 600px 100%;
+    background-repeat: no-repeat;
+    animation: shimmer 1.5s ease-in-out infinite;
+  }
 }
 
 @layer components {
diff --git a/apps/edr-passenger-web/backoffice/src/types/edr.ts b/apps/edr-passenger-web/backoffice/src/types/edr.ts
index 1b5ca7a1e..fa864eb71 100644
--- a/apps/edr-passenger-web/backoffice/src/types/edr.ts
+++ b/apps/edr-passenger-web/backoffice/src/types/edr.ts
@@ -301,7 +301,11 @@ export interface FraudRule {
 // Audit Types
 export interface AuditLog {
   id: string;
-  userId?: string;
+  /** IAM id of the staff member who performed the action. The API field is `iamUserId`. */
+  iamUserId?: string;
+  /** Actor's name and phone, denormalized by the API at write time. */
+  userName?: string;
+  userPhone?: string;
   action: string;
   entityType: string;
   entityId?: string;
diff --git a/apps/edr-passenger-web/portal/postcss.config.js b/apps/edr-passenger-web/portal/postcss.config.js
index f2ba591ff..2aa7205d4 100644
--- a/apps/edr-passenger-web/portal/postcss.config.js
+++ b/apps/edr-passenger-web/portal/postcss.config.js
@@ -1,7 +1,3 @@
-import { createRequire } from "module";
-
-const require = createRequire(import.meta.url);
-
 export default {
   plugins: {
     tailwindcss: {},
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 60cd350a2..ee681ab7e 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
@@ -3,6 +3,7 @@
 import { useForm, useFieldArray } from 'react-hook-form';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { z } from 'zod';
+import { useQuery } from '@tanstack/react-query';
 import { useRouter } from 'next/navigation';
 import { useBookingStore } from '@/lib/booking-store';
 import { useAuthStore } from '@/lib/auth-store';
@@ -614,35 +615,9 @@ const passengerSchema = z.object({
   if (data.gender !== 'Male' && data.gender !== 'Female') {
     ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Gender is required', path: ['gender'] });
   }
-  const isNonEthiopian = data.nationality !== 'ETHIOPIAN' && data.nationality !== 'Ethiopian';
-  if (isNonEthiopian) {
-    const passportNum = data.passportNumber?.trim() ?? '';
-    if (!passportNum) {
-      ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport number is required', path: ['passportNumber'] });
-    } else if (/[^A-Za-z0-9]/.test(passportNum)) {
-      ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport number must not contain special characters', path: ['passportNumber'] });
-    } else if (passportNum.length < 6 || passportNum.length > 12) {
-      ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport number must be between 6 and 12 characters', path: ['passportNumber'] });
-    }
-    if (!data.passportCountry || data.passportCountry.trim().length === 0) {
-      ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Issuing country is required', path: ['passportCountry'] });
-    }
-    if (data.passportIssueDate) {
-      const issue = new Date(data.passportIssueDate);
-      if (!isNaN(issue.getTime()) && issue > new Date()) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport issue date cannot be in the future', path: ['passportIssueDate'] });
-      }
-    }
-    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'] });
-      }
-    }
-  }
 });
 
-function createFormSchema(adultCount: number) {
+function createFormSchema(adultCount: number, isOriginOutsideEthiopia: boolean) {
   return z.object({
     passengers: z.array(passengerSchema),
     createAccount: z.boolean(),
@@ -660,6 +635,9 @@ function createFormSchema(adultCount: number) {
             ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Invalid email format', path: ['passengers', i, 'email'] });
           }
         }
+        // Phone format stays scoped to the passenger's actual nationality regardless of the
+        // passport-flow override below — an Ethiopian is still validated against Ethiopian
+        // number ranges even when their origin station forces the foreigner document flow.
         const phoneError = validatePhone(p.phone, p.nationality);
         if (phoneError) {
           ctx.addIssue({ code: z.ZodIssueCode.custom, message: phoneError, path: ['passengers', i, 'phone'] });
@@ -667,11 +645,44 @@ function createFormSchema(adultCount: number) {
       }
 
       const age = calculateAge(p.dateOfBirth);
-      if (age === null) return;
-      if (isAdult && age <= 5) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Adult passengers must be older than 5 years', path: ['passengers', i, 'dateOfBirth'] });
-      } else if (!isAdult && age > 5) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Child passengers must be 5 years old or younger', path: ['passengers', i, 'dateOfBirth'] });
+      if (age !== null) {
+        if (isAdult && age <= 5) {
+          ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Adult passengers must be older than 5 years', path: ['passengers', i, 'dateOfBirth'] });
+        } else if (!isAdult && age > 5) {
+          ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Child passengers must be 5 years old or younger', path: ['passengers', i, 'dateOfBirth'] });
+        }
+      }
+
+      // Fayda's SMS-based OTP only reaches Ethiopian phone numbers inside Ethiopia, so a
+      // passenger boarding from a station outside Ethiopia can't complete it even when their
+      // nationality is Ethiopian — they (like any genuinely non-Ethiopian national) fall back
+      // to the same passport document requirements as a foreigner. Nationality and phone
+      // validation are unaffected by this — only the identity-document requirement changes.
+      const isNonEthiopianNationality = p.nationality !== 'ETHIOPIAN' && p.nationality !== 'Ethiopian';
+      if (isNonEthiopianNationality || isOriginOutsideEthiopia) {
+        const passportNum = p.passportNumber?.trim() ?? '';
+        if (!passportNum) {
+          ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport number is required', path: ['passengers', i, 'passportNumber'] });
+        } else if (/[^A-Za-z0-9]/.test(passportNum)) {
+          ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport number must not contain special characters', path: ['passengers', i, 'passportNumber'] });
+        } else if (passportNum.length < 6 || passportNum.length > 12) {
+          ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport number must be between 6 and 12 characters', path: ['passengers', i, 'passportNumber'] });
+        }
+        if (!p.passportCountry || p.passportCountry.trim().length === 0) {
+          ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Issuing country is required', path: ['passengers', i, 'passportCountry'] });
+        }
+        if (p.passportIssueDate) {
+          const issue = new Date(p.passportIssueDate);
+          if (!isNaN(issue.getTime()) && issue > new Date()) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport issue date cannot be in the future', path: ['passengers', i, 'passportIssueDate'] });
+          }
+        }
+        if (p.passportExpiryDate) {
+          const expiry = new Date(p.passportExpiryDate);
+          if (!isNaN(expiry.getTime()) && expiry <= new Date()) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: 'Passport expiry date must be in the future', path: ['passengers', i, 'passportExpiryDate'] });
+          }
+        }
       }
     });
   });
@@ -684,6 +695,16 @@ function PassengersForm() {
   const { searchCriteria, passengers: storedPassengers, setPassengers, setCreateAccount, packageId } = useBookingStore();
   const { user, isAuthenticated, updateUser } = useAuthStore();
   const isInitialized = useAuthStore((s) => s.isInitialized);
+  // Fayda's SMS-based OTP is Ethiopia-only — a passenger boarding from a station outside
+  // Ethiopia can't receive it, so they need the passport flow below even if their nationality
+  // is Ethiopian. Looked up by ID rather than trusting a `country`/`countryCode` field carried
+  // on searchCriteria, since the origin station isn't otherwise threaded through this store.
+  const { data: originStation, isLoading: isOriginStationLoading } = useQuery({
+    queryKey: ['station', searchCriteria?.originStationId],
+    queryFn: () => apiClient.get<{ id: string; countryCode?: string }>(`/stations/${searchCriteria!.originStationId}`),
+    enabled: !!searchCriteria?.originStationId,
+  });
+  const isOriginOutsideEthiopia = !!originStation?.countryCode && originStation.countryCode !== 'ET';
   const [faydaEnabled, setFaydaEnabled] = useState(true);
   // "Skip for now" (bypasses Fayda verification) is only offered on local dev and the
   // staging/test domain — never on an unrecognized host, which would include production.
@@ -715,7 +736,7 @@ function PassengersForm() {
   const adultCount = searchCriteria?.adultCount || 1;
 
   const { register, control, handleSubmit, setValue, watch, formState: { errors } } = useForm<FormData>({
-    resolver: zodResolver(createFormSchema(adultCount) as any),
+    resolver: zodResolver(createFormSchema(adultCount, isOriginOutsideEthiopia) as any),
     mode: 'onChange',
     defaultValues: {
       passengers: Array.from({ length: totalPassengers }, (_, i) => {
@@ -740,6 +761,10 @@ function PassengersForm() {
             passportExpiryDate: stored.passportExpiryDate || '',
             passportIssuingAuthority: stored.passportIssuingAuthority || '',
             faydaVerified: stored.faydaVerified || false,
+            // Restore the identity that verified this passenger, so returning here from a
+            // later step (e.g. Back from /booking/seats) doesn't silently reopen the slot to
+            // an already-used Fayda.
+            faydaSub: stored.faydaSub || undefined,
             formExpanded: true,
           };
         }
@@ -852,13 +877,22 @@ function PassengersForm() {
         if (d?.verified) {
           const faydaSub: string | undefined = d.sub || d.faydaSub || d.fin;
 
-          // A single Fayda identity can't be reused across two different passengers.
-          const usedByOther = faydaSub && passengers.some(
-            (p, i) => i !== targetIndex && (p as any).faydaSub === faydaSub,
-          );
+          // A single Fayda identity can't be reused across two different passengers. Read the
+          // live form rather than the `passengers` captured when this effect was created — the
+          // snapshot restore repopulates the array as the form initializes.
+          const currentPassengers = watch('passengers') || [];
+          const conflictIndex = faydaSub
+            ? currentPassengers.findIndex(
+                (p, i) => i !== targetIndex && (p as any)?.faydaSub === faydaSub,
+              )
+            : -1;
 
-          if (usedByOther) {
-            setFaydaErrors((prev) => ({ ...prev, [targetIndex]: 'This Fayda identity is already linked to another passenger on this booking.' }));
+          if (conflictIndex >= 0) {
+            const conflictName = currentPassengers[conflictIndex]?.name?.trim();
+            setFaydaErrors((prev) => ({
+              ...prev,
+              [targetIndex]: `This Fayda ID has already been used to verify Passenger ${conflictIndex + 1}${conflictName ? ` (${conflictName})` : ''}. Each traveller must verify with their own Fayda.`,
+            }));
             setVerificationStatus((prev) => ({ ...prev, [targetIndex]: 'error' }));
           } else {
             // Convert "1980/12/01" → "1980-12-01"
@@ -931,6 +965,10 @@ function PassengersForm() {
         setFormInitialized(true);
         return;
       }
+      // Whether the Fayda gate applies below depends on the origin station's country — wait for
+      // that lookup to settle instead of gating on a stale "inside Ethiopia" default, which
+      // would flash the wrong screen for an Ethiopian departing from outside Ethiopia.
+      if (isOriginStationLoading) return;
 
       try {
         // Fetch passenger profile from backend. This may be null (e.g. no Passenger row linked
@@ -953,8 +991,9 @@ function PassengersForm() {
         // A logged-in but NOT Fayda-verified Ethiopian must pass the Fayda gate exactly like a
         // guest. Prefilling their identity and expanding the form would let them submit the
         // booking without ever verifying — only a verified passenger may pass. When Fayda is
-        // globally disabled there is no gate, so the restriction doesn't apply.
-        const mustVerifyFayda = isEthiopian && !isVerified && faydaEnabled;
+        // globally disabled, or the origin station is outside Ethiopia (SMS OTP won't reach
+        // them), there is no gate, so the restriction doesn't apply.
+        const mustVerifyFayda = isEthiopian && !isVerified && faydaEnabled && !isOriginOutsideEthiopia;
 
         // Nationality + contact aren't identity-verifying, so they're safe to prefill either way.
         setValue('passengers.0.nationality', nationality);
@@ -963,6 +1002,13 @@ function PassengersForm() {
         const emailVal = pick(passengerData.email, user.email);
         if (emailVal) setValue('passengers.0.email', emailVal);
 
+        // A logged-in, already-verified user occupies slot 0 without going through a fresh
+        // Fayda round trip, so the callback never records their sub on the form. Seed it from
+        // the account here, otherwise the duplicate-identity check has nothing to compare
+        // against and the account holder can re-use their own Fayda on passenger 2.
+        const accountFaydaSub = pick(passengerData.faydaSub, (user as any).faydaSub);
+        if (accountFaydaSub) setValue('passengers.0.faydaSub', accountFaydaSub);
+
         if (mustVerifyFayda) {
           // Force the Fayda gate: leave name/DOB/gender empty and keep the form collapsed so the
           // "Verify with Fayda" screen is shown instead of an editable, pre-filled form.
@@ -996,7 +1042,7 @@ function PassengersForm() {
     };
 
     populateForm();
-  }, [isInitialized, isAuthenticated, user, searchCriteria, setValue]);
+  }, [isInitialized, isAuthenticated, user, searchCriteria, setValue, isOriginStationLoading, isOriginOutsideEthiopia]);
 
   const openFaydaVerification = async (index: number) => {
     if (typeof window === 'undefined') return;
@@ -1047,7 +1093,7 @@ function PassengersForm() {
       const isEthiopian = p?.nationality === 'ETHIOPIAN';
       const isChildPassenger = i >= adultCount;
       const isLoggedInAndVerified = i === 0 && isAuthenticated && user?.faydaVerified;
-      return isEthiopian && faydaEnabled && !p?.formExpanded && !isLoggedInAndVerified && !isChildPassenger;
+      return isEthiopian && faydaEnabled && !isOriginOutsideEthiopia && !p?.formExpanded && !isLoggedInAndVerified && !isChildPassenger;
     });
     setSubmitError(
       needsFaydaVerification
@@ -1077,6 +1123,13 @@ function PassengersForm() {
         gender: p.gender,
         nationality: p.nationality,
         nationalId: p.nationalId,
+        // Carry the verified Fayda identity into the booking store so the duplicate-identity
+        // check still has it if the user comes back to this page from /booking/seats. Without
+        // it the restore path below rebuilds each passenger without a sub, and one Fayda could
+        // then re-verify every passenger. Stripped server-side by the global ValidationPipe
+        // (whitelist: true), so sending it to /passengers/save-details is a no-op there.
+        faydaVerified: p.faydaVerified,
+        faydaSub: p.faydaSub,
         passportNumber: p.passportNumber,
         passportCountry: p.passportCountry,
         passportIssueDate: p.passportIssueDate,
@@ -1145,14 +1198,18 @@ function PassengersForm() {
           <form onSubmit={handleSubmit(onSubmit, onInvalid)} className="space-y-6">
             {fields.map((field, index) => {
               const isEthiopian = passengers[index]?.nationality === 'ETHIOPIAN';
+              // Fayda only applies to an Ethiopian national whose origin station is inside
+              // Ethiopia — outside it, the SMS OTP never arrives, so they go through the same
+              // passport flow as a foreigner (nationality/phone stay Ethiopian regardless).
+              const eligibleForFayda = isEthiopian && !isOriginOutsideEthiopia;
               const isFormExpanded = passengers[index]?.formExpanded;
               const status = verificationStatus[index];
               const isPrimaryPassenger = index === 0;
               const isChildPassenger = index >= adultCount;
               const isLoggedInAndVerified = isPrimaryPassenger && isAuthenticated && user?.faydaVerified;
               const isLoggedInNotVerified = isPrimaryPassenger && isAuthenticated && !user?.faydaVerified;
-              const showVerifyButton = isEthiopian && faydaEnabled && !isFormExpanded && !isLoggedInAndVerified && !isChildPassenger;
-              const showManualEntryLink = isEthiopian && !faydaEnabled && !isFormExpanded && !isChildPassenger;
+              const showVerifyButton = eligibleForFayda && faydaEnabled && !isFormExpanded && !isLoggedInAndVerified && !isChildPassenger;
+              const showManualEntryLink = eligibleForFayda && !faydaEnabled && !isFormExpanded && !isChildPassenger;
               const isVerifyingThis = verifyingIndex === index;
               const isVerifyingOther = verifyingIndex !== null && verifyingIndex !== index;
               const faydaError = faydaErrors[index];
@@ -1249,7 +1306,7 @@ function PassengersForm() {
                     </div>
                   ) : (
                     <div className="space-y-4">
-                      {isEthiopian ? (
+                      {eligibleForFayda ? (
                         <>
                           {status === 'success' && (
                             <div className="p-3 bg-green-50 dark:bg-green-900/30 border border-green-200 dark:border-green-800 rounded-lg mb-4">
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 685ba5ee2..6264428cf 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
@@ -6,7 +6,12 @@ import { usePaymentStore } from "@/lib/payment-store";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { apiClient } from "@/lib/api-client";
 import { resolvePaymentRedirectUrl } from "@/lib/payment-redirect";
-import { useState, useEffect } from "react";
+import {
+  isTelebirrMiniApp,
+  onTelebirrPayResult,
+  startTelebirrPay,
+} from "@/lib/telebirr-bridge";
+import { useState, useEffect, useCallback, useMemo } from "react";
 import { PaymentMethod } from "@/types";
 import { format } from "date-fns";
 import { formatTime, getTimePeriod, toZonedDate } from '@/utils/format';
@@ -24,6 +29,13 @@ import {
   Check,
 } from "lucide-react";
 
+/**
+ * Poll budget for the eBirr push flow. The payer has to notice a USSD prompt and type a PIN, so
+ * this is far longer than the redirect flows' 15 attempts: 80 * 1.5s ≈ 2 min, matching the
+ * server's EBIRR_PUSH_TTL_MS.
+ */
+const PUSH_POLL_ATTEMPTS = 80;
+
 const getIconForMethod = (methodId: string) => {
   if (methodId.includes('CARD')) return CreditCard;
   if (methodId.includes('WALLET')) return Wallet;
@@ -55,6 +67,24 @@ export default function PaymentPage() {
   } | null>(null);
   const [billCopied, setBillCopied] = useState(false);
 
+  // eBirr push debit: the wallet has prompted the payer on their own handset for a PIN. There is
+  // nothing to navigate to — we show this and poll until the intent settles.
+  const [pushAction, setPushAction] = useState<{
+    message: string;
+    payerAccountMasked?: string;
+  } | null>(null);
+
+  // Telebirr mini app: the SuperApp payment sheet is open (or just closed) and we're
+  // polling our own status endpoint for the webhook-backed outcome.
+  const [verifyingPayment, setVerifyingPayment] = useState(false);
+
+  // Resolved once on mount — SSR has no `window`, so this must not be read during render
+  // of the first (server) pass.
+  const [inMiniApp, setInMiniApp] = useState(false);
+  useEffect(() => {
+    setInMiniApp(isTelebirrMiniApp());
+  }, []);
+
   const isRoundTrip = searchCriteria?.tripType === 'ROUND_TRIP';
 
   // Use the same display currency as the review page — stored on the schedule at search time.
@@ -72,8 +102,26 @@ export default function PaymentPage() {
     },
   });
 
+  // Inside the telebirr SuperApp only telebirr can complete: every other method is a
+  // redirect/HPP flow, and the mini-app WebView cannot follow the scheme handoffs those
+  // gateways use. Offering them would strand the payer on a dead page.
+  // Memoised: this feeds an effect's dep array, and a fresh array identity every render
+  // would re-run that effect on every render.
+  const availableMethods = useMemo(
+    () => paymentMethods.filter((m) => m.enabled && (!inMiniApp || m.type === 'TELEBIRR')),
+    [paymentMethods, inMiniApp],
+  );
+
   const selectedPaymentMethod = paymentMethods.find(m => m.type === selectedMethod) || null;
 
+  // A method chosen before the container was known (or carried over in state) may no longer
+  // be offerable — drop it rather than letting Pay fire against a hidden method.
+  useEffect(() => {
+    if (selectedMethod && !availableMethods.some((m) => m.type === selectedMethod)) {
+      setSelectedMethod(null);
+    }
+  }, [selectedMethod, availableMethods]);
+
   // Derive charge currency directly from the selected method — no separate state that can lag.
   const amountCurrency = (selectedPaymentMethod?.currency || 'ETB').toUpperCase();
 
@@ -128,6 +176,73 @@ export default function PaymentPage() {
     }
   }, [selectedMethod, dataReady, bookingAmountData, reviewedTotal, displayCurrency, setCurrency, setPaidAmount]);
 
+  /**
+   * Poll our own status endpoint until the payment reaches a terminal state.
+   *
+   * Used by the telebirr mini-app flow, where nothing navigates and therefore no return page
+   * ever runs. The bridge callback only tells us the sheet closed; the authoritative outcome
+   * is the webhook-backed status the API reports here.
+   */
+  const pollPaymentStatus = useCallback(
+    async (attemptsLeft: number): Promise<void> => {
+      if (!bookingId) return;
+      try {
+        const res: any = await apiClient.get(`/payments/status/${bookingId}`);
+        if (res?.status === 'SUCCEEDED') {
+          setVerifyingPayment(false);
+          setPushAction(null);
+          updateStatus("SUCCEEDED");
+          router.push("/booking/confirmation");
+          return;
+        }
+        if (res?.status === 'FAILED' || res?.status === 'CANCELLED') {
+          setVerifyingPayment(false);
+          setPushAction(null);
+          setIsProcessing(false);
+          updateStatus("FAILED");
+          setPaymentError(res?.failureMessage || "Payment was not completed. Please try again.");
+          return;
+        }
+      } catch {
+        // Transient read failure — keep polling; the attempt budget bounds it.
+      }
+
+      if (attemptsLeft <= 0) {
+        // Don't call it failed: the gateway may have taken the money and the confirmation is
+        // simply still in flight. Stop spinning, tell the truth, and let the payer re-check.
+        setVerifyingPayment(false);
+        setPushAction(null);
+        setIsProcessing(false);
+        setPaymentError(
+          "We haven't received confirmation yet. If you completed the payment, your booking " +
+          "will be confirmed shortly — check My Bookings in a moment before paying again.",
+        );
+        return;
+      }
+      setTimeout(() => void pollPaymentStatus(attemptsLeft - 1), 1500);
+    },
+    [bookingId, router, updateStatus],
+  );
+
+  /**
+   * Telebirr mini app reports the sheet outcome on a global callback rather than a redirect.
+   * Registered on mount — the SuperApp can call back the moment the sheet closes, so it must
+   * already be installed before the bridge is invoked.
+   */
+  useEffect(() => {
+    return onTelebirrPayResult((succeeded) => {
+      if (!succeeded) {
+        setVerifyingPayment(false);
+        setIsProcessing(false);
+        updateStatus("FAILED");
+        setPaymentError("Payment was cancelled or declined. Please try again.");
+        return;
+      }
+      setVerifyingPayment(true);
+      void pollPaymentStatus(15);
+    });
+  }, [pollPaymentStatus, updateStatus]);
+
   const paymentMutation = useMutation({
     mutationFn: async (data: any) => {
       return await apiClient.post("/payments/initiate", {
@@ -135,11 +250,30 @@ export default function PaymentPage() {
         method: data.method,
         paymentMethodId: data.paymentMethodId,
         payerAccount: data.payerAccount,
-        platform: 'web',
+        platform: isTelebirrMiniApp() ? 'inapp' : 'web',
       });
     },
-    onSuccess: async (data: any) => {
+    onSuccess: (data: any) => {
       setPaymentError(null);
+      setPaymentIntent(data.paymentIntentId || data.intentId);
+
+      // A terminal verdict always wins over any clientAction, so this is checked FIRST.
+      // eBirr settles inside initiate — its debit response is the settlement, there is no
+      // webhook — so it can come back SUCCEEDED/FAILED while the intent still carries the
+      // AWAIT_PUSH action it was created with. Reading clientAction first would show "check
+      // your phone" for a payment that is already decided, and poll until it timed out.
+      if (data?.status === 'SUCCEEDED') {
+        updateStatus("SUCCEEDED");
+        router.push("/booking/confirmation");
+        return;
+      }
+
+      if (data?.status === 'FAILED' || data?.status === 'CANCELLED') {
+        setIsProcessing(false);
+        updateStatus("FAILED");
+        setPaymentError(data?.failureMessage || "Payment was not completed. Please try again.");
+        return;
+      }
 
       // CAC Bank: no redirect — the bank SMS'd an OTP. Collect it in-app and confirm.
       if (data?.clientAction?.type === 'COLLECT_OTP') {
@@ -163,6 +297,38 @@ export default function PaymentPage() {
         return;
       }
 
+      // Telebirr mini app: hand the signed rawRequest to the SuperApp bridge. Nothing
+      // navigates — telebirr draws its payment sheet over the WebView and reports back on
+      // the global callback registered above, which starts the status polling.
+      if (data?.clientAction?.type === 'INVOKE_BRIDGE') {
+        setPaymentIntent(data.intentId);
+        updateStatus("REQUIRES_ACTION");
+        if (!startTelebirrPay(data.clientAction.rawRequest)) {
+          setIsProcessing(false);
+          updateStatus("FAILED");
+          setPaymentError(
+            "Couldn't open the telebirr payment sheet. Please reopen this page from the " +
+            "telebirr app and try again.",
+          );
+        }
+        return;
+      }
+
+      // eBirr fallback only. The debit is normally settled inside initiate and caught by the
+      // terminal check above; reaching here means the payer outlasted EBIRR_PURCHASE_TIMEOUT_MS
+      // while the PIN prompt was still on their handset. The money may since have moved, so poll
+      // rather than guess.
+      if (data?.clientAction?.type === 'AWAIT_PUSH') {
+        setPaymentIntent(data.intentId);
+        updateStatus("REQUIRES_ACTION");
+        setPushAction(data.clientAction);
+        setVerifyingPayment(true);
+        // Much longer budget than the redirect flows: the payer has to read a USSD prompt and
+        // type a PIN. PUSH_POLL_ATTEMPTS * 1.5s ≈ 2 min, matching EBIRR_PUSH_TTL_MS.
+        void pollPaymentStatus(PUSH_POLL_ATTEMPTS);
+        return;
+      }
+
       if ((selectedMethod === 'TELEBIRR' || selectedMethod === 'WAAFI' || selectedMethod === 'DMONEY') && data?.clientAction?.type === 'REDIRECT') {
         setPaymentIntent(data.intentId);
         updateStatus("REQUIRES_ACTION");
@@ -170,11 +336,13 @@ export default function PaymentPage() {
         return;
       }
 
-      setPaymentIntent(data.paymentIntentId || data.intentId);
+      // Not terminal, and no clientAction we know how to drive. Never assume success: this
+      // fallthrough used to sleep 2s and route to /booking/confirmation, which showed the payer
+      // a confirmed booking for a payment that had not happened. Poll for the truth, and if it
+      // never settles say so rather than inventing an outcome.
       updateStatus("PROCESSING");
-      await new Promise((resolve) => setTimeout(resolve, 2000));
-      updateStatus("SUCCEEDED");
-      router.push("/booking/confirmation");
+      setVerifyingPayment(true);
+      void pollPaymentStatus(15);
     },
     onError: (error: any) => {
       updateStatus("FAILED");
@@ -237,7 +405,12 @@ export default function PaymentPage() {
     }
   };
 
-  // Fire the actual initiate. `mobile` is only used for CAC (OTP debit).
+  // Methods that debit an account we must know up front: CAC Bank SMSes an OTP to it, eBirr
+  // pushes a USSD PIN prompt to it. Neither has a hosted page that could collect it later.
+  const requiresPayerMobile = (method: string | null): boolean =>
+    method === 'CAC_BANK' || method === 'EBIRR';
+
+  // Fire the actual initiate. `mobile` is only used by the push-debit methods above.
   const startPayment = (mobile?: string) => {
     if (!selectedMethod || !bookingId || !selectedPaymentMethod) return;
     setIsProcessing(true);
@@ -248,7 +421,7 @@ export default function PaymentPage() {
       paymentMethodId: selectedPaymentMethod.id,
       currency: displayCurrency,
       amountMinor: totalAmount,
-      payerAccount: selectedMethod === 'CAC_BANK' ? mobile?.trim() : undefined,
+      payerAccount: requiresPayerMobile(selectedMethod) ? mobile?.trim() : undefined,
     });
   };
 
@@ -263,9 +436,14 @@ export default function PaymentPage() {
     }
     setPaymentError(null);
 
-    // CAC Bank needs the payer's mobile for the OTP — collect it in a modal before initiating.
-    if (selectedMethod === 'CAC_BANK') {
+    if (requiresPayerMobile(selectedMethod)) {
       setPhoneError(null);
+      // Prefill with the contact phone we already hold, but leave it editable — the wallet
+      // paying is often not the number the booking was made under.
+      if (!payerMobile.trim()) {
+        const contactPhone = passengers?.find((p) => p.phone)?.phone;
+        if (contactPhone) setPayerMobile(contactPhone);
+      }
       setPhoneModalOpen(true);
       return;
     }
@@ -505,7 +683,29 @@ export default function PaymentPage() {
           {isProcessing && (
             <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50">
               <div className="bg-white dark:bg-gray-800 rounded-xl p-8 max-w-sm w-full mx-4 text-center shadow-2xl">
-                {paymentMutation.isSuccess ? (
+                {pushAction ? (
+                  <>
+                    <Smartphone className="w-14 h-14 text-primary mx-auto mb-4" />
+                    <h3 className="text-lg font-bold mb-1 text-gray-900 dark:text-gray-100">Check your phone</h3>
+                    <p className="text-sm text-gray-500 dark:text-gray-400">
+                      {pushAction.message}
+                    </p>
+                    {pushAction.payerAccountMasked && (
+                      <p className="text-xs text-gray-400 dark:text-gray-500 mt-2">
+                        Sent to {pushAction.payerAccountMasked}
+                      </p>
+                    )}
+                    <Loader2 className="w-6 h-6 text-primary animate-spin mx-auto mt-4" />
+                  </>
+                ) : verifyingPayment ? (
+                  <>
+                    <Loader2 className="w-14 h-14 text-primary animate-spin mx-auto mb-4" />
+                    <h3 className="text-lg font-bold mb-1 text-gray-900 dark:text-gray-100">Confirming payment</h3>
+                    <p className="text-sm text-gray-500 dark:text-gray-400">
+                      Checking with your payment provider — this only takes a moment.
+                    </p>
+                  </>
+                ) : paymentMutation.isSuccess ? (
                   <>
                     <CheckCircle className="w-14 h-14 text-green-500 mx-auto mb-4" />
                     <h3 className="text-lg font-bold mb-4 text-gray-900 dark:text-gray-100">Loading...</h3>
@@ -522,7 +722,7 @@ export default function PaymentPage() {
             </div>
           )}
 
-          {/* CAC Bank — collect payer mobile before initiating */}
+          {/* Push-debit methods (CAC Bank, eBirr) — collect payer mobile before initiating */}
           {phoneModalOpen && (
             <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
               <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-sm w-full shadow-2xl">
@@ -531,7 +731,9 @@ export default function PaymentPage() {
                   <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Your mobile number</h3>
                 </div>
                 <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">
-                  CAC Bank will send a one-time password to this number to authorize the payment.
+                  {selectedMethod === 'EBIRR'
+                    ? "eBirr will prompt this number for your PIN to authorize the payment. Make sure it's the phone you have with you."
+                    : "CAC Bank will send a one-time password to this number to authorize the payment."}
                 </p>
                 <input
                   type="tel"
@@ -540,7 +742,7 @@ export default function PaymentPage() {
                   value={payerMobile}
                   onChange={(e) => { setPayerMobile(e.target.value); setPhoneError(null); }}
                   onKeyDown={(e) => { if (e.key === 'Enter') submitPhone(); }}
-                  placeholder="77 XX XX XX"
+                  placeholder={selectedMethod === 'EBIRR' ? "09XX XXX XXX" : "77 XX XX XX"}
                   className="w-full px-3 py-3 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:border-primary focus:ring-1 focus:ring-primary outline-none"
                 />
                 {phoneError && (
@@ -688,13 +890,13 @@ export default function PaymentPage() {
                   <div className="bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-lg p-4">
                     <p className="text-red-800 dark:text-red-200 text-sm">Failed to load payment methods. Please refresh.</p>
                   </div>
-                ) : paymentMethods.length === 0 ? (
+                ) : availableMethods.length === 0 ? (
                   <div className="bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg p-4">
                     <p className="text-yellow-800 dark:text-yellow-200 text-sm">No payment methods available at the moment.</p>
                   </div>
                 ) : (
                   <div className="space-y-3">
-                    {paymentMethods.filter(m => m.enabled).map((method) => {
+                    {availableMethods.map((method) => {
                       const Icon = getIconForMethod(method.type);
                       const isSelected = selectedMethod === method.type;
                       return (
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 4b9148001..4d4b954df 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
@@ -363,6 +363,9 @@ const adultPassengerCount = searchCriteria?.adultCount ?? passengers.filter(p =>
               dateOfBirth: p.dateOfBirth,
               idDocumentType: isEthiopian ? 'NATIONAL_ID' : 'PASSPORT',
               idDocumentNumber: isEthiopian ? (p.nationalId || '') : '',
+              // Verified Fayda identity for this traveller. The backend stores it on the booking seat and
+              // refuses a second seat for the same identity on the same departure.
+              ...(p.faydaSub ? { faydaSub: p.faydaSub } : {}),
               passportNumber: !isEthiopian ? (p.passportNumber || '') : '',
               passportCountry: !isEthiopian ? (p.passportCountry || '') : '',
               nationality: p.nationality,
@@ -417,6 +420,9 @@ const adultPassengerCount = searchCriteria?.adultCount ?? passengers.filter(p =>
               dateOfBirth: p.dateOfBirth,
               idDocumentType: isEthiopian ? 'NATIONAL_ID' : 'PASSPORT',
               idDocumentNumber: isEthiopian ? (p.nationalId || '') : '',
+              // Verified Fayda identity for this traveller. The backend stores it on the booking seat and
+              // refuses a second seat for the same identity on the same departure.
+              ...(p.faydaSub ? { faydaSub: p.faydaSub } : {}),
               passportNumber: !isEthiopian ? (p.passportNumber || '') : '',
               passportCountry: !isEthiopian ? (p.passportCountry || '') : '',
               nationality: p.nationality,
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 69d3859cf..bb4e2cf12 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
@@ -612,8 +612,15 @@ export default function SearchPage() {
     queryKey: ["stations"],
     // Bounded so a stalled request surfaces the "Unable to load stations"
     // error below instead of leaving the widget stuck loading indefinitely.
-    queryFn: async () =>
-      (await apiClient.get("/stations", { timeout: 8000 })) as Station[],
+    queryFn: async () => {
+      const res = await apiClient.get<Station[]>("/stations", {
+        timeout: 8000,
+      });
+      // apiClient unwraps `{ success, data }` envelopes, but guard against an
+      // unexpected non-array payload so downstream .find()/.filter() calls
+      // (here and in every StationSelector this list is passed to) never throw.
+      return Array.isArray(res) ? res : [];
+    },
   });
 
   const {
diff --git a/apps/edr-passenger-web/portal/src/app/excess-baggage/pay/[token]/page.tsx b/apps/edr-passenger-web/portal/src/app/excess-baggage/pay/[token]/page.tsx
index 209651756..73976fcda 100644
--- a/apps/edr-passenger-web/portal/src/app/excess-baggage/pay/[token]/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/excess-baggage/pay/[token]/page.tsx
@@ -1,14 +1,17 @@
 "use client";
 
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { useParams, useRouter } from "next/navigation";
 import { useQuery, useMutation } from "@tanstack/react-query";
 import { apiClient } from "@/lib/api-client";
 import { PaymentMethod } from "@/types";
 import {
   AlertCircle,
+  Check,
   CheckCircle,
+  Copy,
   CreditCard,
+  KeyRound,
   Landmark,
   Loader2,
   Smartphone,
@@ -22,6 +25,28 @@ const getIconForMethod = (methodId: string) => {
   return Smartphone;
 };
 
+// WALLET is an internal balance debit with no excess-baggage path — the API refuses it, so it is
+// never offered here.
+const UNSUPPORTED_METHODS = ["WALLET"];
+
+// Push-debit methods charge an account we must know before initiating: CAC Bank SMSes a one-time
+// password to it, eBirr pushes a USSD PIN prompt to it. Neither opens a hosted page that could
+// collect the number afterwards, so it is asked for up front.
+const requiresPayerMobile = (method: string | null) =>
+  method === "CAC_BANK" || method === "EBIRR";
+
+// DJF has no minor unit; ETB and USD are quoted to cents. Matches the API's charge-side rounding,
+// so the quote renders exactly the figure the provider will debit.
+const formatAmount = (amount: number, currency: string) =>
+  amount.toFixed(currency.toUpperCase() === "DJF" ? 0 : 2);
+
+interface AmountQuote {
+  chargeId: string;
+  method: string;
+  currency: string;
+  amount: number;
+}
+
 export default function ExcessBaggagePayPage() {
   const { token } = useParams<{ token: string }>();
   const router = useRouter();
@@ -29,6 +54,26 @@ export default function ExcessBaggagePayPage() {
   const [isProcessing, setIsProcessing] = useState(false);
   const [paymentError, setPaymentError] = useState<string | null>(null);
 
+  // Push-debit (CAC Bank / eBirr): collect the payer's mobile before initiating, then — for CAC —
+  // the OTP the bank SMSes to it.
+  const [phoneModalOpen, setPhoneModalOpen] = useState(false);
+  const [payerMobile, setPayerMobile] = useState("");
+  const [phoneError, setPhoneError] = useState<string | null>(null);
+  const [otpModalOpen, setOtpModalOpen] = useState(false);
+  const [otpCode, setOtpCode] = useState("");
+  const [otpMessage, setOtpMessage] = useState<string | null>(null);
+  const [otpError, setOtpError] = useState<string | null>(null);
+  const [pushMessage, setPushMessage] = useState<string | null>(null);
+
+  // CBE bill: no redirect and no OTP — the payer walks away with a bill number and pays it at a
+  // branch/app later, so the page shows the number and watches for settlement.
+  const [billAction, setBillAction] = useState<{
+    billReference: string;
+    instructions?: string;
+    expiresAt?: string;
+  } | null>(null);
+  const [billCopied, setBillCopied] = useState(false);
+
   const { data: charge, isLoading: loadingCharge, error: chargeError } = useQuery({
     queryKey: ["excessBaggageCharge", token],
     queryFn: () => apiClient.get<any>(`/excess-baggage/pay/${token}`),
@@ -45,24 +90,104 @@ export default function ExcessBaggagePayPage() {
     enabled: !!charge,
   });
 
-  const amountDisplay = useMemo(() => {
-    const amountMinor = Number(charge?.totalMinor ?? charge?.amountMinor ?? 0);
-    return (amountMinor / 100).toFixed(2);
-  }, [charge]);
+  const availableMethods = useMemo(
+    () =>
+      paymentMethods.filter(
+        (m) => m.enabled && !UNSUPPORTED_METHODS.includes(m.type),
+      ),
+    [paymentMethods],
+  );
 
-  const currency = charge?.currency ?? charge?.booking?.currency ?? "ETB";
+  // The charge is always booked in ETB; this is what it costs before a method is chosen.
+  const chargeCurrency = charge?.currency ?? charge?.booking?.currency ?? "ETB";
+  const chargeAmount = useMemo(
+    () => Number(charge?.totalMinor ?? charge?.amountMinor ?? 0) / 100,
+    [charge],
+  );
+
+  // Each method settles in its own currency (WAAFI/DMONEY in DJF, CARD in USD, Ethiopian wallets
+  // in ETB), so the price has to be re-quoted server-side whenever the selection changes — the
+  // stored ETB total is not what a Djiboutian wallet would debit.
+  const {
+    data: quote,
+    isFetching: fetchingQuote,
+    error: quoteError,
+  } = useQuery<AmountQuote>({
+    queryKey: ["excessBaggageAmount", token, selectedMethod],
+    queryFn: () =>
+      apiClient.get<AmountQuote>(
+        `/excess-baggage/pay/${token}/amount?method=${selectedMethod}`,
+      ),
+    enabled: !!token && !!selectedMethod,
+    retry: false,
+    staleTime: 30_000,
+  });
+
+  // A quote is only usable once it belongs to the method currently selected — otherwise it is a
+  // leftover from the previous selection and would price the payment in the wrong currency.
+  const quoteReady = !fetchingQuote && quote?.method === selectedMethod;
+
+  const displayCurrency = selectedMethod
+    ? (quote?.currency ?? "")
+    : chargeCurrency;
+  const displayAmount = selectedMethod ? quote?.amount : chargeAmount;
+  const amountLabel =
+    quoteReady && displayAmount != null
+      ? `${displayCurrency} ${formatAmount(displayAmount, displayCurrency)}`
+      : !selectedMethod && displayAmount != null
+        ? `${chargeCurrency} ${formatAmount(displayAmount, chargeCurrency)}`
+        : null;
+
+  // Never let Pay fire against a price the payer has not been shown.
+  const awaitingQuote = !!selectedMethod && !quoteReady;
 
   const payMutation = useMutation({
-    mutationFn: (method: string) =>
+    mutationFn: (vars: { method: string; payerAccount?: string }) =>
       apiClient.post<any>(`/excess-baggage/pay/${token}/initiate`, {
-        method,
+        method: vars.method,
         platform: "web",
+        ...(vars.payerAccount ? { payerAccount: vars.payerAccount } : {}),
       }),
     onSuccess: (data: any) => {
-      if (data?.clientAction?.type === "REDIRECT") {
-        window.location.href = data.clientAction.url;
+      const action = data?.clientAction;
+
+      if (action?.type === "REDIRECT") {
+        window.location.href = action.url;
         return;
       }
+
+      // CAC Bank: no redirect — the bank SMS'd an OTP. Collect it here and confirm.
+      if (action?.type === "COLLECT_OTP") {
+        setOtpMessage(action.message ?? "Enter the OTP sent to your phone");
+        setOtpCode("");
+        setOtpError(null);
+        setOtpModalOpen(true);
+        setIsProcessing(false);
+        return;
+      }
+
+      // CBE: the bill now exists in CBE's system. Nothing to navigate to — show the number.
+      if (action?.type === "SHOW_BILL_REFERENCE") {
+        setBillAction({
+          billReference: action.billReference,
+          instructions: action.instructions,
+          expiresAt: action.expiresAt,
+        });
+        setBillCopied(false);
+        setIsProcessing(false);
+        return;
+      }
+
+      // eBirr: the PIN prompt was pushed to the payer's handset; there is nothing to navigate to.
+      if (action?.type === "AWAIT_PUSH") {
+        setPushMessage(
+          action.message ??
+            `Approve the payment on your phone${action.payerAccountMasked ? ` (${action.payerAccountMasked})` : ""}.`,
+        );
+        setIsProcessing(false);
+        return;
+      }
+
       router.push(`/excess-baggage/pay/${token}/result`);
     },
     onError: (err: any) => {
@@ -71,11 +196,92 @@ export default function ExcessBaggagePayPage() {
     },
   });
 
-  const handlePay = () => {
+  // CAC Bank OTP confirmation. A 200 means the debit settled; a 400 is a wrong/expired OTP —
+  // keep the modal open so the payer can re-enter it (the intent stays open).
+  const otpMutation = useMutation({
+    mutationFn: (otp: string) =>
+      apiClient.post<any>(`/excess-baggage/pay/${token}/confirm`, { otp }),
+    onSuccess: () => {
+      setOtpModalOpen(false);
+      router.push(`/excess-baggage/pay/${token}/result`);
+    },
+    onError: (err: any) => {
+      setOtpError(
+        err?.response?.data?.message ??
+          err?.message ??
+          "Invalid or expired OTP. Please try again.",
+      );
+    },
+  });
+
+  const startPayment = (mobile?: string) => {
     if (!selectedMethod) return;
     setIsProcessing(true);
     setPaymentError(null);
-    payMutation.mutate(selectedMethod);
+    payMutation.mutate({
+      method: selectedMethod,
+      payerAccount: requiresPayerMobile(selectedMethod)
+        ? mobile?.trim()
+        : undefined,
+    });
+  };
+
+  const handlePay = () => {
+    if (!selectedMethod || awaitingQuote) return;
+    setPaymentError(null);
+
+    if (requiresPayerMobile(selectedMethod)) {
+      // Prefill with the number the charge was raised against, but leave it editable — the
+      // handset paying is often not the one the booking was made under.
+      if (!payerMobile.trim() && charge?.contactPhone) {
+        setPayerMobile(charge.contactPhone);
+      }
+      setPhoneError(null);
+      setPhoneModalOpen(true);
+      return;
+    }
+
+    startPayment();
+  };
+
+  const submitPhone = () => {
+    if (!payerMobile.trim()) {
+      setPhoneError("Please enter your mobile number");
+      return;
+    }
+    setPhoneModalOpen(false);
+    startPayment(payerMobile);
+  };
+
+  // While a bill or a pushed PIN prompt is outstanding, watch the charge. Settlement happens
+  // server-side — a CBE teller, or the provider's webhook — so the browser has no other signal.
+  // Success is only ever claimed from this, never from a client-side guess.
+  const watching = !!billAction || !!pushMessage;
+  const { data: liveStatus } = useQuery<{ status: string; paid: boolean }>({
+    queryKey: ["excessBaggageStatus", token],
+    queryFn: () =>
+      apiClient.get<{ status: string; paid: boolean }>(
+        `/excess-baggage/pay/${token}/status`,
+      ),
+    enabled: !!token && watching,
+    refetchInterval: 5_000,
+  });
+
+  useEffect(() => {
+    if (watching && liveStatus?.paid) {
+      router.push(`/excess-baggage/pay/${token}/result`);
+    }
+  }, [watching, liveStatus?.paid, router, token]);
+
+  const copyBillReference = async () => {
+    if (!billAction) return;
+    try {
+      await navigator.clipboard.writeText(billAction.billReference);
+      setBillCopied(true);
+      setTimeout(() => setBillCopied(false), 2000);
+    } catch {
+      /* clipboard unavailable — the number is still shown on screen */
+    }
   };
 
   if (loadingCharge) {
@@ -112,10 +318,25 @@ export default function ExcessBaggagePayPage() {
         <div className="card space-y-3">
           <div className="flex justify-between items-center">
             <span className="text-sm text-gray-500 dark:text-gray-400">Amount due</span>
-            <span className="text-2xl font-bold text-primary">
-              {currency} {amountDisplay}
-            </span>
+            {amountLabel ? (
+              <span className="text-2xl font-bold text-primary">{amountLabel}</span>
+            ) : quoteError ? (
+              <span className="text-2xl font-bold text-gray-400">—</span>
+            ) : (
+              <Loader2 className="w-6 h-6 text-primary animate-spin" />
+            )}
           </div>
+          {selectedMethod && quoteReady && displayCurrency !== chargeCurrency && (
+            <p className="text-xs text-gray-500 dark:text-gray-400 text-right">
+              Converted from {chargeCurrency} {formatAmount(chargeAmount, chargeCurrency)} at today&apos;s rate
+            </p>
+          )}
+          {quoteError && (
+            <p className="text-xs text-red-600 dark:text-red-400 text-right">
+              {(quoteError as any)?.response?.data?.message ??
+                "This payment method is unavailable right now. Please choose another."}
+            </p>
+          )}
           <div className="border-t border-gray-100 dark:border-gray-800 pt-3 flex justify-between items-center">
             <span className="text-sm text-gray-500 dark:text-gray-400">Weight</span>
             <span className="text-sm font-medium text-gray-900 dark:text-gray-100">{charge.excessWeightKg ?? "—"} kg</span>
@@ -131,7 +352,7 @@ export default function ExcessBaggagePayPage() {
             </div>
           ) : (
             <div className="space-y-2">
-              {paymentMethods.filter((m) => m.enabled).map((method) => {
+              {availableMethods.map((method) => {
                 const Icon = getIconForMethod(method.type);
                 const isSelected = selectedMethod === method.type;
                 return (
@@ -166,17 +387,181 @@ export default function ExcessBaggagePayPage() {
 
         <button
           onClick={handlePay}
-          disabled={!selectedMethod || isProcessing}
+          disabled={!selectedMethod || isProcessing || awaitingQuote}
           className="btn-primary w-full py-3 font-semibold disabled:opacity-50 disabled:cursor-not-allowed"
         >
           {isProcessing ? (
             <span className="flex items-center justify-center gap-2">
               <Loader2 className="w-4 h-4 animate-spin" /> Processing...
             </span>
+          ) : quoteError ? (
+            "Choose another payment method"
+          ) : awaitingQuote ? (
+            <span className="flex items-center justify-center gap-2">
+              <Loader2 className="w-4 h-4 animate-spin" /> Calculating amount...
+            </span>
           ) : (
-            `Pay ${currency} ${amountDisplay}`
+            `Pay ${amountLabel ?? ""}`.trim()
           )}
         </button>
+
+        {/* CBE bill — show the number; confirmation only ever comes from the status poll */}
+        {billAction && (
+          <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-md w-full shadow-2xl">
+              <div className="flex items-center gap-2 mb-1">
+                <Landmark className="w-5 h-5 text-primary" />
+                <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Pay at CBE</h3>
+              </div>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">
+                {billAction.instructions ??
+                  "Pay this bill at any CBE branch, the CBE Birr app, mobile banking or USSD."}
+              </p>
+              <div className="flex items-center justify-between gap-2 bg-gray-50 dark:bg-gray-900/40 border border-gray-200 dark:border-gray-700 rounded-lg px-4 py-3">
+                <span className="font-mono text-2xl font-bold tracking-widest text-gray-900 dark:text-gray-100 select-all">
+                  {billAction.billReference}
+                </span>
+                <button
+                  onClick={copyBillReference}
+                  className="btn-secondary px-3 py-2 flex items-center gap-1 text-sm"
+                  title="Copy bill number"
+                >
+                  {billCopied ? <Check className="w-4 h-4 text-green-600" /> : <Copy className="w-4 h-4" />}
+                  {billCopied ? "Copied" : "Copy"}
+                </button>
+              </div>
+              <div className="text-sm text-gray-600 dark:text-gray-300 mt-3 space-y-1">
+                <p>
+                  Amount: <span className="font-semibold">ETB {formatAmount(chargeAmount, "ETB")}</span>
+                </p>
+                {billAction.expiresAt && (
+                  <p>
+                    Pay before:{" "}
+                    <span className="font-semibold">
+                      {new Date(billAction.expiresAt).toLocaleString()}
+                    </span>
+                  </p>
+                )}
+              </div>
+              <div className="flex items-center gap-2 mt-4 text-xs text-gray-500 dark:text-gray-400">
+                <Loader2 className="w-4 h-4 animate-spin flex-shrink-0" />
+                Waiting for payment confirmation — this page updates automatically once CBE
+                confirms your payment.
+              </div>
+              <button
+                onClick={() => setBillAction(null)}
+                className="btn-secondary w-full py-2.5 mt-4"
+              >
+                Close
+              </button>
+            </div>
+          </div>
+        )}
+
+        {/* eBirr: the PIN prompt is on the payer's handset — nothing to navigate to. */}
+        {pushMessage && (
+          <div className="card flex items-start gap-3">
+            <Smartphone className="w-5 h-5 text-primary flex-shrink-0 mt-0.5" />
+            <div className="space-y-1">
+              <p className="font-semibold text-gray-900 dark:text-gray-100">Check your phone</p>
+              <p className="text-sm text-gray-500 dark:text-gray-400">{pushMessage}</p>
+            </div>
+          </div>
+        )}
+
+        {/* Push-debit methods (CAC Bank, eBirr) — collect payer mobile before initiating */}
+        {phoneModalOpen && (
+          <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-sm w-full shadow-2xl">
+              <div className="flex items-center gap-2 mb-1">
+                <Smartphone className="w-5 h-5 text-primary" />
+                <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Your mobile number</h3>
+              </div>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">
+                {selectedMethod === "EBIRR"
+                  ? "eBirr will prompt this number for your PIN to authorize the payment. Make sure it's the phone you have with you."
+                  : "CAC Bank will send a one-time password to this number to authorize the payment."}
+              </p>
+              <input
+                type="tel"
+                inputMode="numeric"
+                autoFocus
+                value={payerMobile}
+                onChange={(e) => { setPayerMobile(e.target.value); setPhoneError(null); }}
+                onKeyDown={(e) => { if (e.key === "Enter") submitPhone(); }}
+                placeholder={selectedMethod === "EBIRR" ? "09XX XXX XXX" : "77 XX XX XX"}
+                className="w-full px-3 py-3 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:border-primary focus:ring-1 focus:ring-primary outline-none"
+              />
+              {phoneError && (
+                <p className="text-red-600 dark:text-red-400 text-xs mt-2">⚠️ {phoneError}</p>
+              )}
+              <div className="flex gap-2 mt-4">
+                <button
+                  onClick={() => setPhoneModalOpen(false)}
+                  className="btn-secondary flex-1 py-2.5"
+                >
+                  Cancel
+                </button>
+                <button
+                  onClick={submitPhone}
+                  disabled={!payerMobile.trim()}
+                  className="btn-primary flex-1 py-2.5 disabled:opacity-50 disabled:cursor-not-allowed"
+                >
+                  Continue
+                </button>
+              </div>
+            </div>
+          </div>
+        )}
+
+        {/* CAC Bank OTP entry */}
+        {otpModalOpen && (
+          <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-sm w-full shadow-2xl">
+              <div className="flex items-center gap-2 mb-1">
+                <KeyRound className="w-5 h-5 text-primary" />
+                <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Enter OTP</h3>
+              </div>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">{otpMessage}</p>
+              <input
+                type="text"
+                inputMode="numeric"
+                autoFocus
+                value={otpCode}
+                onChange={(e) => { setOtpCode(e.target.value.replace(/\D/g, "")); setOtpError(null); }}
+                onKeyDown={(e) => { if (e.key === "Enter" && otpCode.trim() && !otpMutation.isPending) otpMutation.mutate(otpCode.trim()); }}
+                placeholder="Enter code"
+                maxLength={10}
+                className="w-full text-center tracking-[0.4em] text-lg font-semibold px-3 py-3 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:border-primary focus:ring-1 focus:ring-primary outline-none"
+              />
+              {otpError && (
+                <p className="text-red-600 dark:text-red-400 text-xs mt-2">⚠️ {otpError}</p>
+              )}
+              <div className="flex gap-2 mt-4">
+                <button
+                  onClick={() => setOtpModalOpen(false)}
+                  disabled={otpMutation.isPending}
+                  className="btn-secondary flex-1 py-2.5"
+                >
+                  Cancel
+                </button>
+                <button
+                  onClick={() => otpCode.trim() && otpMutation.mutate(otpCode.trim())}
+                  disabled={otpMutation.isPending || !otpCode.trim()}
+                  className="btn-primary flex-1 py-2.5 disabled:opacity-50 disabled:cursor-not-allowed"
+                >
+                  {otpMutation.isPending ? (
+                    <span className="flex items-center justify-center gap-2">
+                      <Loader2 className="w-4 h-4 animate-spin" /> Verifying...
+                    </span>
+                  ) : (
+                    "Confirm payment"
+                  )}
+                </button>
+              </div>
+            </div>
+          </div>
+        )}
       </div>
     </div>
   );
diff --git a/apps/edr-passenger-web/portal/src/app/layout.tsx b/apps/edr-passenger-web/portal/src/app/layout.tsx
index 7337c18d6..57aad945b 100644
--- a/apps/edr-passenger-web/portal/src/app/layout.tsx
+++ b/apps/edr-passenger-web/portal/src/app/layout.tsx
@@ -62,6 +62,9 @@ export const metadata: Metadata = {
     shortcut: '/edr-logo.png',
     apple: '/edr-logo.png',
   },
+  other: {
+    google: 'notranslate',
+  },
 };
 
 // viewportFit: 'cover' lets fixed bottom bars (e.g. the payment page's Pay
@@ -117,7 +120,7 @@ export default function RootLayout({
   };
 
   return (
-    <html lang="en" dir="ltr" suppressHydrationWarning>
+    <html lang="en" dir="ltr" translate="no" className="notranslate" suppressHydrationWarning>
       <head>
         <JsonLd data={organizationSchema} />
         <JsonLd data={websiteSchema} />
diff --git a/apps/edr-passenger-web/portal/src/app/pay-balance/[token]/page.tsx b/apps/edr-passenger-web/portal/src/app/pay-balance/[token]/page.tsx
index fb2135cd3..da45893e5 100644
--- a/apps/edr-passenger-web/portal/src/app/pay-balance/[token]/page.tsx
+++ b/apps/edr-passenger-web/portal/src/app/pay-balance/[token]/page.tsx
@@ -1,6 +1,6 @@
 "use client";
 
-import { useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { useParams, useRouter } from "next/navigation";
 import { useQuery, useMutation } from "@tanstack/react-query";
 import { apiClient } from "@/lib/api-client";
@@ -8,7 +8,10 @@ import { resolvePaymentRedirectUrl } from "@/lib/payment-redirect";
 import { PaymentMethod } from "@/types";
 import {
   Loader2,
+  Check,
+  Copy,
   CreditCard,
+  KeyRound,
   Smartphone,
   Wallet,
   Landmark,
@@ -23,6 +26,28 @@ const getIconForMethod = (methodId: string) => {
   return Smartphone;
 };
 
+// WALLET is an internal balance debit with no supplementary-charge path — the API refuses it, so
+// it is never offered here.
+const UNSUPPORTED_METHODS = ["WALLET"];
+
+// Push-debit methods charge an account we must know before initiating: CAC Bank SMSes a one-time
+// password to it, eBirr pushes a USSD PIN prompt to it. Neither opens a hosted page that could
+// collect the number afterwards, so it is asked for up front.
+const requiresPayerMobile = (method: string | null) =>
+  method === "CAC_BANK" || method === "EBIRR";
+
+// DJF has no minor unit; ETB and USD are quoted to cents. Matches the API's charge-side rounding,
+// so the quote renders exactly the figure the provider will debit.
+const formatAmount = (amount: number, currency: string) =>
+  amount.toFixed(currency.toUpperCase() === "DJF" ? 0 : 2);
+
+interface AmountQuote {
+  chargeId: string;
+  method: string;
+  currency: string;
+  amount: number;
+}
+
 export default function PayBalancePage() {
   const { token } = useParams<{ token: string }>();
   const router = useRouter();
@@ -30,6 +55,26 @@ export default function PayBalancePage() {
   const [isProcessing, setIsProcessing] = useState(false);
   const [paymentError, setPaymentError] = useState<string | null>(null);
 
+  // Push-debit (CAC Bank / eBirr): collect the payer's mobile before initiating, then — for CAC —
+  // the OTP the bank SMSes to it.
+  const [phoneModalOpen, setPhoneModalOpen] = useState(false);
+  const [payerMobile, setPayerMobile] = useState("");
+  const [phoneError, setPhoneError] = useState<string | null>(null);
+  const [otpModalOpen, setOtpModalOpen] = useState(false);
+  const [otpCode, setOtpCode] = useState("");
+  const [otpMessage, setOtpMessage] = useState<string | null>(null);
+  const [otpError, setOtpError] = useState<string | null>(null);
+  const [pushMessage, setPushMessage] = useState<string | null>(null);
+
+  // CBE bill: no redirect and no OTP — the payer walks away with a bill number and pays it at a
+  // branch/app later, so the page shows the number and watches for settlement.
+  const [billAction, setBillAction] = useState<{
+    billReference: string;
+    instructions?: string;
+    expiresAt?: string;
+  } | null>(null);
+  const [billCopied, setBillCopied] = useState(false);
+
   const { data: charge, isLoading: loadingCharge, error: chargeError } = useQuery({
     queryKey: ["supplementary-charge", token],
     queryFn: () => apiClient.get<any>(`/payments/supplementary/by-token/${token}`),
@@ -45,18 +90,102 @@ export default function PayBalancePage() {
     enabled: !!charge,
   });
 
+  const availableMethods = useMemo(
+    () =>
+      paymentMethods.filter(
+        (m) => m.enabled && !UNSUPPORTED_METHODS.includes(m.type),
+      ),
+    [paymentMethods],
+  );
+
+  // The charge is raised in ETB; this is what it costs before a method is chosen.
+  const chargeCurrency = charge?.currency ?? "ETB";
+  const chargeAmount = useMemo(
+    () => Number(charge?.amountMinor ?? 0) / 100,
+    [charge],
+  );
+
+  // Each method settles in its own currency (WAAFI/DMONEY in DJF, CARD in USD, Ethiopian wallets
+  // in ETB), so the price has to be re-quoted server-side whenever the selection changes — the
+  // stored ETB amount is not what a Djiboutian wallet would debit.
+  const {
+    data: quote,
+    isFetching: fetchingQuote,
+    error: quoteError,
+  } = useQuery<AmountQuote>({
+    queryKey: ["supplementaryAmount", token, selectedMethod],
+    queryFn: () =>
+      apiClient.get<AmountQuote>(
+        `/payments/supplementary/by-token/${token}/amount?method=${selectedMethod}`,
+      ),
+    enabled: !!token && !!selectedMethod,
+    retry: false,
+    staleTime: 30_000,
+  });
+
+  // A quote is only usable once it belongs to the method currently selected — otherwise it is a
+  // leftover from the previous selection and would price the payment in the wrong currency.
+  const quoteReady = !fetchingQuote && quote?.method === selectedMethod;
+  const displayCurrency = selectedMethod ? (quote?.currency ?? "") : chargeCurrency;
+  const displayAmount = selectedMethod ? quote?.amount : chargeAmount;
+  const amountLabel =
+    quoteReady && displayAmount != null
+      ? `${displayCurrency} ${formatAmount(displayAmount, displayCurrency)}`
+      : !selectedMethod && displayAmount != null
+        ? `${chargeCurrency} ${formatAmount(displayAmount, chargeCurrency)}`
+        : null;
+
+  // Never let Pay fire against a price the payer has not been shown.
+  const awaitingQuote = !!selectedMethod && !quoteReady;
+
   const payMutation = useMutation({
-    mutationFn: (method: string) =>
+    mutationFn: (vars: { method: string; payerAccount?: string }) =>
       apiClient.post<any>(`/payments/supplementary/by-token/${token}/pay`, {
-        method,
+        method: vars.method,
         platform: "web",
+        ...(vars.payerAccount ? { payerAccount: vars.payerAccount } : {}),
       }),
     onSuccess: (data: any) => {
-      if (data?.clientAction?.type === "REDIRECT") {
-        window.location.href = resolvePaymentRedirectUrl(data.clientAction.url);
+      const action = data?.clientAction;
+
+      if (action?.type === "REDIRECT") {
+        window.location.href = resolvePaymentRedirectUrl(action.url);
         return;
       }
-      // Immediate success (e.g. wallet)
+
+      // CAC Bank: no redirect — the bank SMS'd an OTP. Collect it here and confirm.
+      if (action?.type === "COLLECT_OTP") {
+        setOtpMessage(action.message ?? "Enter the OTP sent to your phone");
+        setOtpCode("");
+        setOtpError(null);
+        setOtpModalOpen(true);
+        setIsProcessing(false);
+        return;
+      }
+
+      // CBE: the bill now exists in CBE's system. Nothing to navigate to — show the number.
+      if (action?.type === "SHOW_BILL_REFERENCE") {
+        setBillAction({
+          billReference: action.billReference,
+          instructions: action.instructions,
+          expiresAt: action.expiresAt,
+        });
+        setBillCopied(false);
+        setIsProcessing(false);
+        return;
+      }
+
+      // eBirr: the PIN prompt was pushed to the payer's handset; there is nothing to navigate to.
+      if (action?.type === "AWAIT_PUSH") {
+        setPushMessage(
+          action.message ??
+            `Approve the payment on your phone${action.payerAccountMasked ? ` (${action.payerAccountMasked})` : ""}.`,
+        );
+        setIsProcessing(false);
+        return;
+      }
+
+      // Immediate success
       router.push(`/pay-balance/${token}/success`);
     },
     onError: (err: any) => {
@@ -67,11 +196,90 @@ export default function PayBalancePage() {
     },
   });
 
-  const handlePay = () => {
+  // CAC Bank OTP confirmation. A 200 means the debit settled; a 400 is a wrong/expired OTP —
+  // keep the modal open so the payer can re-enter it (the intent stays open).
+  const otpMutation = useMutation({
+    mutationFn: (otp: string) =>
+      apiClient.post<any>(`/payments/supplementary/by-token/${token}/confirm`, { otp }),
+    onSuccess: () => {
+      setOtpModalOpen(false);
+      router.push(`/pay-balance/${token}/success`);
+    },
+    onError: (err: any) => {
+      setOtpError(
+        err?.response?.data?.message ??
+          err?.message ??
+          "Invalid or expired OTP. Please try again.",
+      );
+    },
+  });
+
+  const startPayment = (mobile?: string) => {
     if (!selectedMethod) return;
     setIsProcessing(true);
     setPaymentError(null);
-    payMutation.mutate(selectedMethod);
+    payMutation.mutate({
+      method: selectedMethod,
+      payerAccount: requiresPayerMobile(selectedMethod) ? mobile?.trim() : undefined,
+    });
+  };
+
+  const handlePay = () => {
+    if (!selectedMethod || awaitingQuote) return;
+    setPaymentError(null);
+
+    if (requiresPayerMobile(selectedMethod)) {
+      // Prefill with the number the charge was raised against, but leave it editable — the
+      // handset paying is often not the one the booking was made under.
+      if (!payerMobile.trim() && charge?.booking?.contactPhone) {
+        setPayerMobile(charge.booking.contactPhone);
+      }
+      setPhoneError(null);
+      setPhoneModalOpen(true);
+      return;
+    }
+
+    startPayment();
+  };
+
+  const submitPhone = () => {
+    if (!payerMobile.trim()) {
+      setPhoneError("Please enter your mobile number");
+      return;
+    }
+    setPhoneModalOpen(false);
+    startPayment(payerMobile);
+  };
+
+  // While a bill or a pushed PIN prompt is outstanding, watch the charge. Settlement happens
+  // server-side — a CBE teller, or the provider's webhook — so the browser has no other signal.
+  // Success is only ever claimed from this, never from a client-side guess.
+  const watching = !!billAction || !!pushMessage;
+  const { data: liveStatus } = useQuery<{ status: string; paid: boolean }>({
+    queryKey: ["supplementaryStatus", token],
+    queryFn: () =>
+      apiClient.get<{ status: string; paid: boolean }>(
+        `/payments/supplementary/by-token/${token}/status`,
+      ),
+    enabled: !!token && watching,
+    refetchInterval: 5_000,
+  });
+
+  useEffect(() => {
+    if (watching && liveStatus?.paid) {
+      router.push(`/pay-balance/${token}/success`);
+    }
+  }, [watching, liveStatus?.paid, router, token]);
+
+  const copyBillReference = async () => {
+    if (!billAction) return;
+    try {
+      await navigator.clipboard.writeText(billAction.billReference);
+      setBillCopied(true);
+      setTimeout(() => setBillCopied(false), 2000);
+    } catch {
+      /* clipboard unavailable — the number is still shown on screen */
+    }
   };
 
   if (loadingCharge) {
@@ -95,8 +303,6 @@ export default function PayBalancePage() {
     );
   }
 
-  const amountDisplay = (charge.amountMinor / 100).toFixed(2);
-  const currency = charge.currency ?? "ETB";
   return (
     <div className="min-h-screen bg-gray-50 dark:bg-gray-950 flex items-start justify-center px-4 py-10">
       <div className="w-full max-w-md space-y-4">
@@ -122,8 +328,25 @@ export default function PayBalancePage() {
           )}
           <div className="border-t border-gray-100 dark:border-gray-800 pt-3 flex justify-between items-center">
             <span className="font-bold text-gray-900 dark:text-gray-100">Amount due</span>
-            <span className="text-2xl font-bold text-primary">{currency} {amountDisplay}</span>
+            {amountLabel ? (
+              <span className="text-2xl font-bold text-primary">{amountLabel}</span>
+            ) : quoteError ? (
+              <span className="text-2xl font-bold text-gray-400">—</span>
+            ) : (
+              <Loader2 className="w-6 h-6 text-primary animate-spin" />
+            )}
           </div>
+          {selectedMethod && quoteReady && displayCurrency !== chargeCurrency && (
+            <p className="text-xs text-gray-500 dark:text-gray-400 text-right">
+              Converted from {chargeCurrency} {formatAmount(chargeAmount, chargeCurrency)} at today&apos;s rate
+            </p>
+          )}
+          {quoteError && (
+            <p className="text-xs text-red-600 dark:text-red-400 text-right">
+              {(quoteError as any)?.response?.data?.message ??
+                "This payment method is unavailable right now. Please choose another."}
+            </p>
+          )}
         </div>
 
         {/* Payment methods */}
@@ -136,7 +359,7 @@ export default function PayBalancePage() {
             </div>
           ) : (
             <div className="space-y-2">
-              {paymentMethods.filter((m) => m.enabled).map((method) => {
+              {availableMethods.map((method) => {
                 const Icon = getIconForMethod(method.type);
                 const isSelected = selectedMethod === method.type;
                 return (
@@ -173,19 +396,180 @@ export default function PayBalancePage() {
 
         <button
           onClick={handlePay}
-          disabled={!selectedMethod || isProcessing}
+          disabled={!selectedMethod || isProcessing || awaitingQuote}
           className="btn-primary w-full py-3 font-semibold disabled:opacity-50 disabled:cursor-not-allowed"
         >
           {isProcessing ? (
             <span className="flex items-center justify-center gap-2">
               <Loader2 className="w-4 h-4 animate-spin" /> Processing...
             </span>
+          ) : quoteError ? (
+            "Choose another payment method"
+          ) : awaitingQuote ? (
+            <span className="flex items-center justify-center gap-2">
+              <Loader2 className="w-4 h-4 animate-spin" /> Calculating amount...
+            </span>
           ) : (
-            `Pay ${currency} ${amountDisplay}`
+            `Pay ${amountLabel ?? ""}`.trim()
           )}
         </button>
 
         <p className="text-xs text-gray-400 dark:text-gray-500 text-center">🔒 Secure & encrypted payment</p>
+
+        {/* CBE bill — show the number; confirmation only ever comes from the status poll */}
+        {billAction && (
+          <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-md w-full shadow-2xl">
+              <div className="flex items-center gap-2 mb-1">
+                <Landmark className="w-5 h-5 text-primary" />
+                <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Pay at CBE</h3>
+              </div>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">
+                {billAction.instructions ??
+                  "Pay this bill at any CBE branch, the CBE Birr app, mobile banking or USSD."}
+              </p>
+              <div className="flex items-center justify-between gap-2 bg-gray-50 dark:bg-gray-900/40 border border-gray-200 dark:border-gray-700 rounded-lg px-4 py-3">
+                <span className="font-mono text-2xl font-bold tracking-widest text-gray-900 dark:text-gray-100 select-all">
+                  {billAction.billReference}
+                </span>
+                <button
+                  onClick={copyBillReference}
+                  className="btn-secondary px-3 py-2 flex items-center gap-1 text-sm"
+                  title="Copy bill number"
+                >
+                  {billCopied ? <Check className="w-4 h-4 text-green-600" /> : <Copy className="w-4 h-4" />}
+                  {billCopied ? "Copied" : "Copy"}
+                </button>
+              </div>
+              <div className="text-sm text-gray-600 dark:text-gray-300 mt-3 space-y-1">
+                <p>
+                  Amount: <span className="font-semibold">ETB {formatAmount(chargeAmount, "ETB")}</span>
+                </p>
+                {billAction.expiresAt && (
+                  <p>
+                    Pay before:{" "}
+                    <span className="font-semibold">
+                      {new Date(billAction.expiresAt).toLocaleString()}
+                    </span>
+                  </p>
+                )}
+              </div>
+              <div className="flex items-center gap-2 mt-4 text-xs text-gray-500 dark:text-gray-400">
+                <Loader2 className="w-4 h-4 animate-spin flex-shrink-0" />
+                Waiting for payment confirmation — this page updates automatically once CBE
+                confirms your payment.
+              </div>
+              <button
+                onClick={() => setBillAction(null)}
+                className="btn-secondary w-full py-2.5 mt-4"
+              >
+                Close
+              </button>
+            </div>
+          </div>
+        )}
+
+        {/* eBirr: the PIN prompt is on the payer's handset — nothing to navigate to. */}
+        {pushMessage && (
+          <div className="card flex items-start gap-3">
+            <Smartphone className="w-5 h-5 text-primary flex-shrink-0 mt-0.5" />
+            <div className="space-y-1">
+              <p className="font-semibold text-gray-900 dark:text-gray-100">Check your phone</p>
+              <p className="text-sm text-gray-500 dark:text-gray-400">{pushMessage}</p>
+            </div>
+          </div>
+        )}
+
+        {/* Push-debit methods (CAC Bank, eBirr) — collect payer mobile before initiating */}
+        {phoneModalOpen && (
+          <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-sm w-full shadow-2xl">
+              <div className="flex items-center gap-2 mb-1">
+                <Smartphone className="w-5 h-5 text-primary" />
+                <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Your mobile number</h3>
+              </div>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">
+                {selectedMethod === "EBIRR"
+                  ? "eBirr will prompt this number for your PIN to authorize the payment. Make sure it's the phone you have with you."
+                  : "CAC Bank will send a one-time password to this number to authorize the payment."}
+              </p>
+              <input
+                type="tel"
+                inputMode="numeric"
+                autoFocus
+                value={payerMobile}
+                onChange={(e) => { setPayerMobile(e.target.value); setPhoneError(null); }}
+                onKeyDown={(e) => { if (e.key === "Enter") submitPhone(); }}
+                placeholder={selectedMethod === "EBIRR" ? "09XX XXX XXX" : "77 XX XX XX"}
+                className="w-full px-3 py-3 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:border-primary focus:ring-1 focus:ring-primary outline-none"
+              />
+              {phoneError && (
+                <p className="text-red-600 dark:text-red-400 text-xs mt-2">⚠️ {phoneError}</p>
+              )}
+              <div className="flex gap-2 mt-4">
+                <button onClick={() => setPhoneModalOpen(false)} className="btn-secondary flex-1 py-2.5">
+                  Cancel
+                </button>
+                <button
+                  onClick={submitPhone}
+                  disabled={!payerMobile.trim()}
+                  className="btn-primary flex-1 py-2.5 disabled:opacity-50 disabled:cursor-not-allowed"
+                >
+                  Continue
+                </button>
+              </div>
+            </div>
+          </div>
+        )}
+
+        {/* CAC Bank OTP entry */}
+        {otpModalOpen && (
+          <div className="fixed inset-0 bg-black/60 flex items-center justify-center z-50 px-4">
+            <div className="bg-white dark:bg-gray-800 rounded-xl p-6 max-w-sm w-full shadow-2xl">
+              <div className="flex items-center gap-2 mb-1">
+                <KeyRound className="w-5 h-5 text-primary" />
+                <h3 className="text-lg font-bold text-gray-900 dark:text-gray-100">Enter OTP</h3>
+              </div>
+              <p className="text-sm text-gray-500 dark:text-gray-400 mb-4">{otpMessage}</p>
+              <input
+                type="text"
+                inputMode="numeric"
+                autoFocus
+                value={otpCode}
+                onChange={(e) => { setOtpCode(e.target.value.replace(/\D/g, "")); setOtpError(null); }}
+                onKeyDown={(e) => { if (e.key === "Enter" && otpCode.trim() && !otpMutation.isPending) otpMutation.mutate(otpCode.trim()); }}
+                placeholder="Enter code"
+                maxLength={10}
+                className="w-full text-center tracking-[0.4em] text-lg font-semibold px-3 py-3 rounded-lg border border-gray-300 dark:border-gray-600 bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:border-primary focus:ring-1 focus:ring-primary outline-none"
+              />
+              {otpError && (
+                <p className="text-red-600 dark:text-red-400 text-xs mt-2">⚠️ {otpError}</p>
+              )}
+              <div className="flex gap-2 mt-4">
+                <button
+                  onClick={() => setOtpModalOpen(false)}
+                  disabled={otpMutation.isPending}
+                  className="btn-secondary flex-1 py-2.5"
+                >
+                  Cancel
+                </button>
+                <button
+                  onClick={() => otpCode.trim() && otpMutation.mutate(otpCode.trim())}
+                  disabled={otpMutation.isPending || !otpCode.trim()}
+                  className="btn-primary flex-1 py-2.5 disabled:opacity-50 disabled:cursor-not-allowed"
+                >
+                  {otpMutation.isPending ? (
+                    <span className="flex items-center justify-center gap-2">
+                      <Loader2 className="w-4 h-4 animate-spin" /> Verifying...
+                    </span>
+                  ) : (
+                    "Confirm payment"
+                  )}
+                </button>
+              </div>
+            </div>
+          </div>
+        )}
       </div>
     </div>
   );
diff --git a/apps/edr-passenger-web/portal/src/components/PackagesSection.tsx b/apps/edr-passenger-web/portal/src/components/PackagesSection.tsx
index 2fdd50518..408dd3f56 100644
--- a/apps/edr-passenger-web/portal/src/components/PackagesSection.tsx
+++ b/apps/edr-passenger-web/portal/src/components/PackagesSection.tsx
@@ -209,7 +209,7 @@ function FeaturedCard({ pkg }: { pkg: HolidayPackage }) {
 
               {/* Name */}
               <h3 className="text-xl md:text-2xl font-extrabold text-gray-900 dark:text-white leading-tight mb-1.5">
-                {pkg.name.trim()}
+                {pkg.name?.trim()}
               </h3>
 
               {/* Route */}
@@ -217,11 +217,11 @@ function FeaturedCard({ pkg }: { pkg: HolidayPackage }) {
                 <div className="flex items-center gap-1.5 text-sm text-gray-500 dark:text-gray-400 mb-5">
                   <Train className="w-3.5 h-3.5 text-primary flex-shrink-0" />
                   <span className="font-medium text-gray-700 dark:text-gray-300">
-                    {origin.name.trim()}
+                    {origin.name?.trim()}
                   </span>
                   <ArrowRight className="w-3 h-3 flex-shrink-0" />
                   <span className="font-medium text-gray-700 dark:text-gray-300">
-                    {dest.name.trim()}
+                    {dest.name?.trim()}
                   </span>
                   {pkg.busTransferIncluded && (
                     <>
@@ -353,16 +353,16 @@ function PackageCard({ pkg }: { pkg: HolidayPackage }) {
         {/* Content */}
         <div className="flex flex-col flex-1 p-4">
           <h3 className="font-bold text-gray-900 dark:text-white text-sm leading-snug mb-2.5 line-clamp-2">
-            {pkg.name.trim()}
+            {pkg.name?.trim()}
           </h3>
 
           {/* Route */}
           {origin && dest && (
             <div className="flex items-center gap-1 text-xs text-gray-500 dark:text-gray-400 mb-2">
               <MapPin className="w-3 h-3 text-primary flex-shrink-0" />
-              <span className="truncate">{origin.name.trim()}</span>
+              <span className="truncate">{origin.name?.trim()}</span>
               <ArrowRight className="w-3 h-3 flex-shrink-0 text-gray-300" />
-              <span className="truncate">{dest.name.trim()}</span>
+              <span className="truncate">{dest.name?.trim()}</span>
             </div>
           )}
 
diff --git a/apps/edr-passenger-web/portal/src/lib/generate-voucher.ts b/apps/edr-passenger-web/portal/src/lib/generate-voucher.ts
index abbf6eedf..de306da8f 100644
--- a/apps/edr-passenger-web/portal/src/lib/generate-voucher.ts
+++ b/apps/edr-passenger-web/portal/src/lib/generate-voucher.ts
@@ -455,8 +455,11 @@ interface VoucherData {
   // /bookings/:ref returns one row per passenger PER LEG for round trips (leg 1 =
   // outbound, leg 2 = return), each with that leg's own seat — see bookings.service.ts's
   // getByRef(). dateOfBirth is included purely to disambiguate same-name passengers when
-  // grouping leg rows back into one passenger below.
-  passengers: Array<{ fullName: string; dateOfBirth?: string; category: string; leg?: number; seat?: { number: string; coach: string; seatClass: string } }>;
+  // grouping leg rows back into one passenger below. fareMinor is that specific row's own
+  // fare (ETB minor units) — e.g. a free child's row is 0 even though other passengers on
+  // the same booking paid full fare — mirrored from the same field the booking detail
+  // page's "Fare breakdown" section already reads (booking/detail/page.tsx).
+  passengers: Array<{ fullName: string; dateOfBirth?: string; category: string; leg?: number; fareMinor?: number; seat?: { number: string; coach: string; seatClass: string } }>;
   schedule: VoucherSchedule;
   returnSchedule?: VoucherSchedule | null;
   totalMinor: number;
@@ -475,32 +478,46 @@ interface VoucherData {
 }
 
 export const generateVoucherPDF = async (booking: VoucherData): Promise<void> => {
-  // The amount shown is always a single raw field straight from the API — the settled
-  // payment amount when available, otherwise the booking total — never a derived value
-  // (previously this fell back to Math.round(totalMinor / passengers.length), which
-  // doesn't correspond to any real field and could disagree with what was actually
-  // charged). Same value on every passenger's voucher; no /100, no per-passenger split.
+  // Currency always comes straight from the booking/payment data, never hardcoded — the
+  // settled payment currency when a payment has settled, otherwise the booking's own
+  // display currency (falling back to the internal ETB currency field).
   const settledAmountMinor = booking.payment?.amountMinor;
   const settledCurrency = booking.payment?.currency;
   const useSettledAmount = settledAmountMinor != null && !!settledCurrency;
   // Prefer displayCurrency (passenger's home currency) over the internal ETB currency field.
   const voucherCurrency = useSettledAmount ? settledCurrency! : (booking.displayCurrency || booking.currency || 'ETB');
-  // Use displayTotalMinor when available so the voucher shows the passenger's currency amount.
-  const voucherFareMinor = useSettledAmount ? settledAmountMinor! : (booking.displayTotalMinor ?? booking.totalMinor);
+  // Basis total for the currency this voucher displays — the settled payment amount when
+  // available, otherwise the display-currency total (falling back to the raw ETB total).
+  const voucherBasisTotal = useSettledAmount ? settledAmountMinor! : (booking.displayTotalMinor ?? booking.totalMinor);
+  // Ratio that converts a passenger's own ETB fareMinor into the same currency/amount basis
+  // as voucherBasisTotal above — e.g. if the settled payment is 60% of the ETB total (a
+  // currency conversion), each passenger's own ETB fare is scaled by that same 60% ratio.
+  // This is NOT an equal split: two passengers with different fares still get different
+  // scaled amounts, in exact proportion to what each of them actually paid. Falls back to no
+  // scaling (ratio 1) only when the totals are missing or already equal, mirroring the same
+  // fallback the booking detail page's "Fare breakdown" section uses for this identical ratio.
+  const etbTotalMinor = booking.totalMinor;
+  const fareScaleFactor =
+    !etbTotalMinor || !voucherBasisTotal || etbTotalMinor === voucherBasisTotal
+      ? 1
+      : voucherBasisTotal / etbTotalMinor;
 
   const isRoundTrip = booking.bookingType === 'ROUND_TRIP' && !!booking.returnSchedule;
 
   // Group leg rows back into one entry per real passenger — without this, a round trip
   // produced two half-passenger vouchers (one per leg, each showing only its own leg's
-  // seat) instead of one voucher per passenger covering both legs.
+  // seat) instead of one voucher per passenger covering both legs. Each leg row's own
+  // fareMinor is summed here too, so a round trip's voucher reflects both legs' fares
+  // and a one-way voucher reflects just its single row's fare.
   type SeatInfo = VoucherData['passengers'][number]['seat'];
   const grouped = new Map<
     string,
-    { fullName: string; category: string; outboundSeat?: SeatInfo; returnSeat?: SeatInfo }
+    { fullName: string; category: string; fareMinor: number; outboundSeat?: SeatInfo; returnSeat?: SeatInfo }
   >();
   booking.passengers.forEach((p) => {
     const key = `${p.fullName}|${p.dateOfBirth}|${p.category}`;
-    const entry = grouped.get(key) || { fullName: p.fullName, category: p.category, outboundSeat: undefined, returnSeat: undefined };
+    const entry = grouped.get(key) || { fullName: p.fullName, category: p.category, fareMinor: 0, outboundSeat: undefined, returnSeat: undefined };
+    entry.fareMinor += p.fareMinor ?? 0;
     if (p.leg === 2) entry.returnSeat = p.seat;
     else entry.outboundSeat = p.seat;
     grouped.set(key, entry);
@@ -522,6 +539,10 @@ export const generateVoucherPDF = async (booking: VoucherData): Promise<void> =>
     // if it doesn't match what's actually on file.
     const ticketNumber = matchedTicket?.barcodePayload || 'Not yet issued';
 
+    // This passenger's own fare, scaled onto the same currency/amount basis as the rest of
+    // the voucher — not the booking's overall total, and not an equal share of it.
+    const passengerFareMinor = Math.round(p.fareMinor * fareScaleFactor);
+
     await generatePassengerVoucherPDF({
       bookingRef:           booking.bookingRef,
       ticketNumber,
@@ -536,7 +557,7 @@ export const generateVoucherPDF = async (booking: VoucherData): Promise<void> =>
       outboundCoachNumber:  isRoundTrip ? p.outboundSeat?.coach : undefined,
       inboundSeatNumber:    isRoundTrip ? p.returnSeat?.number : undefined,
       inboundCoachNumber:   isRoundTrip ? p.returnSeat?.coach : undefined,
-      fareMinor:            voucherFareMinor,
+      fareMinor:            passengerFareMinor,
       currency:             voucherCurrency,
       fareIsMajorUnits:     useSettledAmount,
       createdAt:            booking.createdAt,
diff --git a/apps/edr-passenger-web/portal/src/lib/telebirr-bridge.ts b/apps/edr-passenger-web/portal/src/lib/telebirr-bridge.ts
new file mode 100644
index 000000000..fd2a9ccea
--- /dev/null
+++ b/apps/edr-passenger-web/portal/src/lib/telebirr-bridge.ts
@@ -0,0 +1,106 @@
+/**
+ * Telebirr SuperApp mini-app bridge.
+ *
+ * When the portal runs inside the telebirr SuperApp, the ordinary web checkout is unusable:
+ * the H5 paygate page hands off to the native wallet with a custom scheme
+ * (`kcbconsumer://h5checkout?...`) that the SuperApp's WebView cannot resolve, so the payer
+ * only ever sees `net::ERR_UNKNOWN_URL_SCHEME`.
+ *
+ * The in-app flow never navigates. The API returns a signed `rawRequest` string
+ * (clientAction.type === "INVOKE_BRIDGE") which is handed to the host's JS bridge; telebirr
+ * renders its own payment sheet over the WebView and reports the outcome on a global callback.
+ *
+ * See docs/telebirr-miniapp/inapp-payment-plan.md.
+ */
+
+/** Name of the global the SuperApp calls back into. Must be a property of `window`. */
+export const TELEBIRR_PAY_CALLBACK = "handleEdrPaymentCallback";
+
+type ConsumerApp = { evaluate: (payload: string) => void };
+
+declare global {
+  interface Window {
+    /** Injected by the telebirr SuperApp WebView. Absent everywhere else. */
+    consumerapp?: ConsumerApp;
+    [TELEBIRR_PAY_CALLBACK]?: (response: unknown) => void;
+  }
+}
+
+/**
+ * True only when the telebirr host bridge is actually present.
+ *
+ * Deliberately does NOT sniff the user agent. A UA match without `window.consumerapp` would
+ * make us request `platform: "inapp"` and get back a bare rawRequest we have no way to use —
+ * there is no navigating our way out of that, because by then the server has already committed
+ * to the bridge payload. Gating on the bridge object keeps the decision and the capability in
+ * sync: if we can't call it, we don't ask for it.
+ */
+export function isTelebirrMiniApp(): boolean {
+  return typeof window !== "undefined" && typeof window.consumerapp?.evaluate === "function";
+}
+
+/**
+ * Hand a signed rawRequest to the SuperApp to open its payment sheet.
+ *
+ * Register the callback (see `onTelebirrPayResult`) BEFORE calling this — the host may invoke
+ * it as soon as the sheet closes. Returns false when the bridge is missing or throws, so the
+ * caller can surface an error instead of leaving the payer on a dead spinner.
+ */
+export function startTelebirrPay(rawRequest: string): boolean {
+  if (!isTelebirrMiniApp()) return false;
+  try {
+    window.consumerapp!.evaluate(
+      JSON.stringify({
+        functionName: "js_fun_start_pay",
+        params: {
+          rawRequest,
+          functionCallBackName: TELEBIRR_PAY_CALLBACK,
+        },
+      }),
+    );
+    return true;
+  } catch (err) {
+    console.error("[telebirr] bridge evaluate failed:", err);
+    return false;
+  }
+}
+
+/**
+ * Install the global result callback; returns a disposer for effect cleanup.
+ *
+ * The result is a TRIGGER TO VERIFY, never proof of payment — the payer can close the sheet,
+ * the host can report success before settlement lands, and the payload shape is not a contract.
+ * Confirmation always comes from polling our own payment status (webhook-backed).
+ */
+export function onTelebirrPayResult(handler: (succeeded: boolean) => void): () => void {
+  if (typeof window === "undefined") return () => {};
+  window[TELEBIRR_PAY_CALLBACK] = (response: unknown) => {
+    handler(isSuccessResponse(response));
+  };
+  return () => {
+    delete window[TELEBIRR_PAY_CALLBACK];
+  };
+}
+
+/**
+ * Telebirr reports `code: 0` (number or string) for success. The payload arrives as either a
+ * JSON string or an object depending on host version, and an unparseable payload is treated as
+ * success on purpose: polling is what decides the outcome, and a false "failed" would strand a
+ * payer who actually paid.
+ */
+function isSuccessResponse(response: unknown): boolean {
+  let parsed: unknown = response;
+  if (typeof response === "string") {
+    try {
+      parsed = JSON.parse(response);
+    } catch {
+      return true;
+    }
+  }
+  if (parsed && typeof parsed === "object" && "code" in parsed) {
+    const code = (parsed as { code: unknown }).code;
+    if (code === undefined || code === null) return true;
+    return code === 0 || code === "0";
+  }
+  return true;
+}
diff --git a/apps/edr-payment-api/src/config/ebirr.config.ts b/apps/edr-payment-api/src/config/ebirr.config.ts
index 4c5dd68e6..7d96d591a 100644
--- a/apps/edr-payment-api/src/config/ebirr.config.ts
+++ b/apps/edr-payment-api/src/config/ebirr.config.ts
@@ -1,9 +1,26 @@
 import { registerAs } from "@nestjs/config";
 
+/**
+ * EbirrPay — direct mobile-wallet debit (docs/ebirr/INTEGRATION.md).
+ *
+ * Auth is plain credentials in the request body (§4): there is no signing key, and — because the
+ * flow has no hosted page and no callback — no notify URL and no return URL either.
+ */
 export default registerAs("ebirr", () => ({
-  baseUrl: process.env.EBIRR_BASE_URL || "",
-  merchantCode: process.env.EBIRR_MERCHANT_CODE || "",
-  secretKey: process.env.EBIRR_SECRET_KEY || "",
-  notifyUrl: process.env.EBIRR_NOTIFY_URL || "",
-  returnUrl: process.env.EBIRR_RETURN_URL || "",
+  baseUrl: process.env.EBIRR_BASE_URL ?? "",
+  merchantUid: process.env.EBIRR_MERCHANT_UID ?? "",
+  apiKey: process.env.EBIRR_API_KEY ?? "",
+  apiUserId: process.env.EBIRR_API_USER_ID ?? "",
+  paymentMethod: process.env.EBIRR_PAYMENT_METHOD ?? "MWALLET_ACCOUNT",
+  channelName: process.env.EBIRR_CHANNEL_NAME ?? "WEB",
+  /**
+   * How long API_PURCHASE waits for the payer to read the USSD prompt and type their PIN. It is
+   * awaited on the request path, so it must stay under every timeout in front of it — the
+   * passenger API's PAYMENT_API_HTTP_TIMEOUT_MS (60s) and nginx's 60s default proxy_read_timeout.
+   * Raising it past those turns a slow payer into a dropped connection instead of a fallback.
+   */
+  purchaseTimeoutMs: Number(process.env.EBIRR_PURCHASE_TIMEOUT_MS ?? 45_000),
+  /** How long the intent stays payable before the reconciliation sweep expires it. */
+  pushTtlMs: Number(process.env.EBIRR_PUSH_TTL_MS ?? 180_000),
+  insecureTls: process.env.EBIRR_INSECURE_TLS === "true",
 }));
diff --git a/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-payment.mapper.ts b/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-payment.mapper.ts
index 8e6259930..5b479a8cc 100644
--- a/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-payment.mapper.ts
+++ b/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-payment.mapper.ts
@@ -10,7 +10,7 @@ export function mapPaymentSuccess(
     End_To_End_Txn_Id: request.End_To_End_Txn_Id,
     Cbe_Txn_Ref: request.Cbe_Txn_Ref,
     Destination_Txn_Ref: destinationTxnRef,
-    Status: "SUCCESS",
+    Status: "Success",
     Response_Code: "0",
     Response_Description: "Success",
     Additional_Fields: [],
diff --git a/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-query.mapper.ts b/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-query.mapper.ts
index d2153b6a5..ac96c3ce1 100644
--- a/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-query.mapper.ts
+++ b/apps/edr-payment-api/src/modules/cbe-bill/mappers/cbe-query.mapper.ts
@@ -21,7 +21,7 @@ export function mapQuerySuccess(
     Credit_Acct_Number: "",
     Transaction_Type: "",
     Timestamp: new Date().toISOString(),
-    Status: "SUCCESS",
+    Status: "Success",
     Response_Code: "0",
     Response_Description: "Success",
     Additional_Fields: [],
diff --git a/apps/edr-payment-api/src/modules/intents/dto/initiate-payment.dto.ts b/apps/edr-payment-api/src/modules/intents/dto/initiate-payment.dto.ts
index 6d602b28a..fa7587b2e 100644
--- a/apps/edr-payment-api/src/modules/intents/dto/initiate-payment.dto.ts
+++ b/apps/edr-payment-api/src/modules/intents/dto/initiate-payment.dto.ts
@@ -62,9 +62,14 @@ export class InitiatePaymentRequestDto implements InitiatePaymentRequest {
   @IsEnum(ProviderMethod)
   provider!: ProviderMethod;
 
-  @ApiPropertyOptional({ enum: ["web", "mobile"] })
+  @ApiPropertyOptional({
+    enum: ["web", "mobile", "inapp"],
+    description:
+      "Payer surface. `inapp` = running inside a SuperApp mini-app WebView (Telebirr), " +
+      "which cannot follow redirect/HPP flows and gets a bridge payload instead.",
+  })
   @IsOptional()
-  @IsIn(["web", "mobile"])
+  @IsIn(["web", "mobile", "inapp"])
   platform?: PaymentPlatform;
 
   @ApiPropertyOptional({
diff --git a/apps/edr-payment-api/src/modules/intents/intents.service.cbe-bill.spec.ts b/apps/edr-payment-api/src/modules/intents/intents.service.cbe-bill.spec.ts
index acbfef4ee..e80f3f640 100644
--- a/apps/edr-payment-api/src/modules/intents/intents.service.cbe-bill.spec.ts
+++ b/apps/edr-payment-api/src/modules/intents/intents.service.cbe-bill.spec.ts
@@ -7,7 +7,7 @@ import {
   ProviderMethod,
   ProviderPaymentStatus,
 } from "@edr/types";
-import { CacBankProvider } from "@edr/payment-providers";
+import { CacBankProvider, EBirrProvider } from "@edr/payment-providers";
 import { IntentsService } from "./intents.service";
 import { IntentsRepository } from "./intents.repository";
 import { BillReferenceService } from "./bill-reference.service";
@@ -61,6 +61,7 @@ describe("IntentsService CBE_BILL", () => {
       {} as DataSource,
       providers as never,
       {} as CacBankProvider,
+      {} as EBirrProvider,
       billReferenceService as unknown as BillReferenceService,
     );
   });
@@ -154,4 +155,130 @@ describe("IntentsService CBE_BILL", () => {
     expect(snapshot.status).toBe(ProviderPaymentStatus.REQUIRES_ACTION);
     expect(applySpy).not.toHaveBeenCalled();
   });
+
+  /**
+   * Regression: reconcileReference used to route every non-FAILED intent through
+   * queryProviderStatus, which THROWS "Unknown provider" for CBE_BILL (no map entry — D5). The
+   * throw was counted as a provider error, so the check returned `unverifiable` forever and the
+   * owning app could never auto-cancel the booking: seats stayed held and the sweep re-queried
+   * the same booking once a minute for days. With no outbound query to make, the stored status
+   * IS the answer.
+   */
+  describe("reconcileReference (reconcile-before-cancel)", () => {
+    const cbeIntent = (status: ProviderPaymentStatus) =>
+      ({
+        id: "intent-1",
+        service: PaymentService.PASSENGER,
+        referenceType: PaymentReferenceType.BOOKING,
+        referenceId: "booking-1",
+        merchantOrderId: "PSG-x",
+        provider: ProviderMethod.CBE_BILL,
+        status,
+        amountMinor: 1500,
+        currency: "ETB",
+        billReference: "000100000015",
+      }) as unknown as PaymentIntent;
+
+    it("reports an unpaid CBE_BILL intent as VERIFIED not paid, not unverifiable", async () => {
+      repository.findAllByReference.mockResolvedValue([
+        cbeIntent(ProviderPaymentStatus.REQUIRES_ACTION),
+      ] as never);
+
+      const result = await service.reconcileReference(
+        PaymentService.PASSENGER,
+        PaymentReferenceType.BOOKING,
+        "booking-1",
+      );
+
+      expect(result).toEqual({ paid: false, unverifiable: false });
+      expect(result.reason).toBeUndefined();
+    });
+
+    it("still reports a retired-but-settled CBE_BILL intent as paid", async () => {
+      // The inbound /cbe/payment already flipped it; step 2 of the resolution catches it.
+      repository.findAllByReference.mockResolvedValue([
+        cbeIntent(ProviderPaymentStatus.SUCCEEDED),
+      ] as never);
+
+      const result = await service.reconcileReference(
+        PaymentService.PASSENGER,
+        PaymentReferenceType.BOOKING,
+        "booking-1",
+      );
+
+      expect(result.paid).toBe(true);
+      expect(result.unverifiable).toBe(false);
+    });
+
+    it("does not let an unqueryable sibling mask a real provider error", async () => {
+      const telebirr = {
+        ...cbeIntent(ProviderPaymentStatus.REQUIRES_ACTION),
+        id: "intent-2",
+        provider: ProviderMethod.TELEBIRR,
+      } as unknown as PaymentIntent;
+      providers.set(ProviderMethod.TELEBIRR, {
+        method: ProviderMethod.TELEBIRR,
+        queryStatus: jest.fn().mockRejectedValue(new Error("ETIMEDOUT")),
+      });
+      repository.findAllByReference.mockResolvedValue([
+        cbeIntent(ProviderPaymentStatus.REQUIRES_ACTION),
+        telebirr,
+      ] as never);
+
+      const result = await service.reconcileReference(
+        PaymentService.PASSENGER,
+        PaymentReferenceType.BOOKING,
+        "booking-1",
+      );
+
+      expect(result).toEqual({
+        paid: false,
+        unverifiable: true,
+        reason: "PROVIDER_ERROR",
+      });
+      providers.delete(ProviderMethod.TELEBIRR);
+    });
+
+    it("reports IN_FLIGHT ahead of PROVIDER_ERROR so a caller never gives up on moving money", async () => {
+      const processing = {
+        ...cbeIntent(ProviderPaymentStatus.REQUIRES_ACTION),
+        id: "intent-2",
+        provider: ProviderMethod.TELEBIRR,
+      } as unknown as PaymentIntent;
+      const failing = {
+        ...cbeIntent(ProviderPaymentStatus.REQUIRES_ACTION),
+        id: "intent-3",
+        provider: ProviderMethod.WAAFI,
+      } as unknown as PaymentIntent;
+      providers.set(ProviderMethod.TELEBIRR, {
+        method: ProviderMethod.TELEBIRR,
+        queryStatus: jest
+          .fn()
+          .mockResolvedValue({ status: ProviderPaymentStatus.PROCESSING }),
+      });
+      providers.set(ProviderMethod.WAAFI, {
+        method: ProviderMethod.WAAFI,
+        queryStatus: jest.fn().mockRejectedValue(new Error("ETIMEDOUT")),
+      });
+      repository.findAllByReference.mockResolvedValue([
+        processing,
+        failing,
+      ] as never);
+      repository.findById.mockResolvedValue(processing);
+      jest
+        .spyOn(service, "applyProviderResult")
+        .mockResolvedValue({ alreadyTerminal: false });
+
+      const result = await service.reconcileReference(
+        PaymentService.PASSENGER,
+        PaymentReferenceType.BOOKING,
+        "booking-1",
+      );
+
+      expect(result.unverifiable).toBe(true);
+      expect(result.reason).toBe("IN_FLIGHT");
+      providers.delete(ProviderMethod.TELEBIRR);
+      providers.delete(ProviderMethod.WAAFI);
+    });
+  });
 });
diff --git a/apps/edr-payment-api/src/modules/intents/intents.service.ts b/apps/edr-payment-api/src/modules/intents/intents.service.ts
index 0f5b41f4e..53d4e70bd 100644
--- a/apps/edr-payment-api/src/modules/intents/intents.service.ts
+++ b/apps/edr-payment-api/src/modules/intents/intents.service.ts
@@ -6,7 +6,11 @@ import {
   NotFoundException,
 } from "@nestjs/common";
 import { DataSource } from "typeorm";
-import { createMerchantOrderId, CacBankProvider } from "@edr/payment-providers";
+import {
+  createMerchantOrderId,
+  CacBankProvider,
+  EBirrProvider,
+} from "@edr/payment-providers";
 import {
   ConfirmPaymentRequest,
   InitiatePaymentRequest,
@@ -45,6 +49,14 @@ export interface ProviderResultInput {
   rawResponse?: Record<string, unknown>;
 }
 
+/**
+ * Why a settlement check came back `unverifiable`. The two causes are NOT interchangeable:
+ * `IN_FLIGHT` is money actually moving and must be waited out indefinitely, while
+ * `PROVIDER_ERROR` can be a permanently unreachable gateway — a caller may eventually give up on
+ * that one rather than defer forever (see TasksService's reconcile grace window).
+ */
+export type ReconcileUnverifiableReason = "IN_FLIGHT" | "PROVIDER_ERROR";
+
 /** Result of {@link IntentsService.reconcileReference} — a settlement check for a domain order. */
 export interface ReconcileReferenceResult {
   /** True when at least one intent for the order is settled (SUCCEEDED, incl. a just-registered late capture). */
@@ -52,10 +64,12 @@ export interface ReconcileReferenceResult {
   /** Snapshot of the paying intent when `paid`. */
   intent?: PaymentIntentSnapshot;
   /**
-   * True when we could NOT confirm "not paid": at least one candidate intent's provider status
-   * query errored, so its settlement is unknown. Callers must treat this as "do not cancel".
+   * True when we could NOT confirm "not paid": a candidate intent's provider status query errored,
+   * or a payment is still in flight. Callers must treat this as "do not cancel".
    */
   unverifiable: boolean;
+  /** Set whenever `unverifiable` — which of the two causes applies. */
+  reason?: ReconcileUnverifiableReason;
 }
 
 @Injectable()
@@ -70,6 +84,9 @@ export class IntentsService {
     @Inject(PAYMENT_PROVIDER_MAP)
     private readonly providers: PaymentProviderMap,
     private readonly cacBankProvider: CacBankProvider,
+    // eBirr's debit is awaited on the request path (see settleEBirrPurchase), so we need the
+    // concrete class for its non-interface `purchase()` — same pattern as CacBankProvider.
+    private readonly eBirrProvider: EBirrProvider,
     private readonly billReferenceService: BillReferenceService,
   ) {}
 
@@ -78,7 +95,6 @@ export class IntentsService {
   async initiate(
     request: InitiatePaymentRequest,
   ): Promise<PaymentIntentSnapshot> {
-
     if (request.idempotencyKey) {
       const byKey = await this.intentsRepository.findByIdempotencyKey(
         request.service,
@@ -105,17 +121,20 @@ export class IntentsService {
       );
     }
 
+    // Push-debit providers charge an account we must be told up front — there is no hosted page
+    // that could collect it later.
     if (
-      request.provider === ProviderMethod.CAC_BANK &&
+      (request.provider === ProviderMethod.CAC_BANK ||
+        request.provider === ProviderMethod.EBIRR) &&
       !request.payerAccount?.trim()
     ) {
       throw new BadRequestException(
-        "payerAccount (customer mobile number) is required for CAC_BANK",
+        `payerAccount (customer mobile number) is required for ${request.provider}`,
       );
     }
 
     const merchantOrderId = createMerchantOrderId();
-    const result = await provider.initiate({
+    const providerInput = {
       merchantOrderId,
       orderRef: request.orderRef ?? request.referenceId,
       amountMinor: request.amountMinor,
@@ -125,7 +144,8 @@ export class IntentsService {
       returnUrl: request.returnUrl,
       redirectUrl: request.returnUrl,
       failureUrl: request.failureUrl,
-    });
+    };
+    const result = await provider.initiate(providerInput);
 
     const intent = await this.intentsRepository.create({
       service: request.service,
@@ -145,9 +165,47 @@ export class IntentsService {
     this.logger.log(
       `intent ${intent.id} created: ${request.service}/${request.referenceType}/${request.referenceId} via ${request.provider} (${merchantOrderId})`,
     );
+
+    if (request.provider === ProviderMethod.EBIRR) {
+      return this.settleEBirrPurchase(intent.id, providerInput);
+    }
+
     return this.toSnapshot(intent);
   }
 
+  /**
+   * Issue the eBirr debit and hand back the settled intent.
+   *
+   * eBirr has no webhook: API_PURCHASE's response IS the settlement notification. So it is awaited
+   * here, on the request path, and the caller gets a terminal snapshot — the portal shows success
+   * or the real failure straight from the initiate response, with nothing to poll.
+   *
+   * The wait is bounded by EBIRR_PURCHASE_TIMEOUT_MS (45s), which must stay under the passenger
+   * API's 60s PAYMENT_API_HTTP_TIMEOUT_MS. A payer slower than that comes back PROCESSING and the
+   * intent keeps its AWAIT_PUSH client action, so the existing poll and the reconciliation sweep
+   * settle it as before. That fallback is rare but must not be removed: an unanswered purchase may
+   * still have moved money (vendor doc §10).
+   *
+   * purchase() does not throw — transport failures are already mapped to FAILED (never dispatched)
+   * or PROCESSING (sent, unanswered). The catch is for anything unforeseen: leaving the intent
+   * REQUIRES_ACTION also lands on the poll/sweep fallback, which is the safe direction.
+   */
+  private async settleEBirrPurchase(
+    intentId: string,
+    providerInput: Parameters<EBirrProvider["purchase"]>[0],
+  ): Promise<PaymentIntentSnapshot> {
+    try {
+      const status = await this.eBirrProvider.purchase(providerInput);
+      await this.applyProviderResult(intentId, status);
+    } catch (err) {
+      this.logger.error(
+        `eBirr purchase for intent ${intentId} (${providerInput.merchantOrderId}) could not be ` +
+          `settled: ${err instanceof Error ? err.message : err} — leaving it to the sweep`,
+      );
+    }
+    return this.snapshotOf(intentId);
+  }
+
   /**
    * CBE Unified Bill Payment (docs/cbe/CBE_IMPLEMENTATION_PLAN.md). Intent-first: the bill
    * reference is created here, before CBE ever sees the bill; settlement arrives later through
@@ -438,19 +496,44 @@ export class IntentsService {
     const candidates = intents.filter(
       (i) => i.status !== ProviderPaymentStatus.FAILED,
     );
+
+    // Inbound-only methods (CBE_BILL) have deliberately no PAYMENT_PROVIDER_MAP entry — plan D5,
+    // docs/cbe/CBE_IMPLEMENTATION_PLAN.md. There is NO outbound query to make, so their stored
+    // status is the best truth available and step 2 above already checked it. Counting them as
+    // provider errors made every CBE_BILL order permanently `unverifiable` and therefore
+    // impossible to auto-cancel — the caller deferred forever, once a minute, indefinitely.
+    const queryable = candidates.filter((i) => this.providers.has(i.provider));
+    const unqueryable = candidates.length - queryable.length;
+    if (unqueryable > 0) {
+      this.logger.log(
+        `reconcile: ${unqueryable}/${candidates.length} intent(s) for ${referenceType}/${referenceId} ` +
+          `have no outbound status query (inbound-only provider) — trusting the stored status`,
+      );
+    }
+
+    // Queried in parallel: a booking that accumulated several dead sessions used to serialise one
+    // 10s provider timeout per intent, so a single stuck order could hold the caller's sweep for
+    // 30s+. Results are still APPLIED in order, and we still stop at the first settled intent.
+    const probes = await Promise.all(
+      queryable.map(async (intent) => {
+        try {
+          return { intent, status: await this.queryProviderStatus(intent) };
+        } catch (err) {
+          this.logger.warn(
+            `reconcile: queryStatus failed for intent ${intent.id} (${intent.merchantOrderId}): ${
+              err instanceof Error ? err.message : String(err)
+            }`,
+          );
+          return { intent, status: null };
+        }
+      }),
+    );
+
     let providerErrors = 0;
     let inFlight = false;
-    for (const intent of candidates) {
-      let status: ProviderStatus;
-      try {
-        status = await this.queryProviderStatus(intent);
-      } catch (err) {
+    for (const { intent, status } of probes) {
+      if (!status) {
         providerErrors++;
-        this.logger.warn(
-          `reconcile: queryStatus failed for intent ${intent.id} (${intent.merchantOrderId}): ${
-            err instanceof Error ? err.message : String(err)
-          }`,
-        );
         continue;
       }
 
@@ -480,7 +563,15 @@ export class IntentsService {
       }
     }
 
-    return { paid: false, unverifiable: providerErrors > 0 || inFlight };
+    // IN_FLIGHT outranks PROVIDER_ERROR: a caller that gives up after N minutes of gateway errors
+    // must NEVER apply that give-up to an order whose payment is actually moving.
+    if (inFlight) {
+      return { paid: false, unverifiable: true, reason: "IN_FLIGHT" };
+    }
+    if (providerErrors > 0) {
+      return { paid: false, unverifiable: true, reason: "PROVIDER_ERROR" };
+    }
+    return { paid: false, unverifiable: false };
   }
 
   /** Best-effort live provider status for a merchant order id; never throws (returns null). */
diff --git a/apps/edr-payment-api/src/modules/providers/ebirr-purchase.spec.ts b/apps/edr-payment-api/src/modules/providers/ebirr-purchase.spec.ts
new file mode 100644
index 000000000..e82e4dad5
--- /dev/null
+++ b/apps/edr-payment-api/src/modules/providers/ebirr-purchase.spec.ts
@@ -0,0 +1,374 @@
+import { of, throwError } from "rxjs";
+import { AxiosError } from "axios";
+import {
+  EBirrProvider,
+  normalizeEthiopianMsisdn,
+  ProviderPaymentStatus,
+} from "@edr/payment-providers";
+
+/**
+ * eBirr is a direct wallet debit over the ASM envelope (docs/ebirr/INTEGRATION.md), not the
+ * Alipay-style redirect gateway the pre-rewrite provider was written against. These pin the
+ * things that were wrong before and the things that are easy to "fix" back by mistake:
+ *
+ *  - the wire shape must match the request verified by hand against testpayments.ebirr.com,
+ *    including `payerInfo.accountNo` (NOT the doc's `subscriptionId`) and no signature field;
+ *  - the amount reaches eBirr unscaled — the old code divided by 100 and would have charged
+ *    1/100th of every booking (same class of bug as cac-bank-amount.spec.ts);
+ *  - `initiate()` must not touch the network: the blocking debit is `purchase()`;
+ *  - a timeout must NOT be reported as FAILED — the money may have moved (vendor doc §10).
+ */
+describe("EBirrProvider", () => {
+  const config = {
+    get: (key: string) =>
+      ({
+        "ebirr.baseUrl": "https://testpayments.ebirr.com",
+        "ebirr.merchantUid": "M1000003",
+        "ebirr.apiKey": "API-1234560",
+        "ebirr.apiUserId": "10000008",
+        "ebirr.paymentMethod": "MWALLET_ACCOUNT",
+        "ebirr.channelName": "WEB",
+        "ebirr.purchaseTimeoutMs": 45_000,
+        "ebirr.pushTtlMs": 180_000,
+      })[key],
+  };
+
+  const input = {
+    merchantOrderId: "EDR-ORDER-1",
+    orderRef: "EDR-20240001",
+    amountMinor: 1500.5,
+    currency: "ETB",
+    payerAccount: "+251923582676",
+  };
+
+  function build(response?: unknown) {
+    const post = jest.fn().mockReturnValue(of({ data: response, status: 200 }));
+    const provider = new EBirrProvider(config as never, { post } as never);
+    return { provider, post };
+  }
+
+  /**
+   * Captured verbatim from the live sandbox (08/08/2026) across four scenarios. Note that the
+   * three failure envelopes are NOT 2001 yet still carry the authoritative `params.state` — the
+   * reason the provider reads `state` regardless of `responseCode`.
+   */
+  const approved = {
+    schemaVersion: "1.0",
+    timestamp: "2026-08-08T06:40:42Z",
+    responseId: "REQ-001-20260506114500",
+    responseCode: "2001",
+    errorCode: "0",
+    responseMsg: "RCS_SUCCESS",
+    params: {
+      referenceId: "holyffuot",
+      transactionId: "619",
+      orderId: "521",
+      issuerTransactionId: "10000991513",
+      txAmount: "1.00",
+      state: "APPROVED",
+    },
+  };
+
+  const declined = {
+    schemaVersion: "1.0",
+    timestamp: "2026-08-08T06:41:58Z",
+    responseId: "REQ-001-20260506114500",
+    responseCode: "5206",
+    errorCode: "E10205",
+    responseMsg: "Payment Failed (Invalid Credentials)",
+    params: {
+      referenceId: "hoflyffuot",
+      transactionId: "621",
+      orderId: "522",
+      txAmount: "1.00",
+      state: "DECLINED",
+      description: "Invalid Credentials",
+    },
+  };
+
+  /** The payer aborted the USSD prompt, or let it lapse — eBirr reports both identically. */
+  const userAborted = {
+    schemaVersion: "1.0",
+    timestamp: "2026-08-08T06:42:51Z",
+    responseId: "REQ-001-20260506114500",
+    responseCode: "5001",
+    errorCode: "4004",
+    responseMsg: "User Aborted",
+    params: {
+      referenceId: "hoflyffuofft",
+      transactionId: "622",
+      orderId: "523",
+      txAmount: "1.00",
+      state: "TIMEOUT",
+      description: "User Aborted",
+    },
+  };
+
+  describe("initiate", () => {
+    it("issues no HTTP call and returns AWAIT_PUSH", async () => {
+      const { provider, post } = build();
+
+      const result = await provider.initiate(input);
+
+      expect(post).not.toHaveBeenCalled();
+      expect(result.clientAction).toEqual({
+        type: "AWAIT_PUSH",
+        message: expect.stringContaining("PIN"),
+        payerAccountMasked: "2519****2676",
+      });
+      expect(result.providerOrderId).toBe("EDR-ORDER-1");
+    });
+
+    it("rejects a missing payer account rather than charging nobody", async () => {
+      const { provider } = build();
+      await expect(
+        provider.initiate({ ...input, payerAccount: undefined }),
+      ).rejects.toThrow(/payerAccount/);
+    });
+
+    it("never leaks the api key or the full MSISDN into the audit payload", async () => {
+      const { provider } = build();
+      const result = await provider.initiate(input);
+      const serialized = JSON.stringify(result.rawInitiation);
+      expect(serialized).not.toContain("API-1234560");
+      expect(serialized).not.toContain("251923582676");
+    });
+  });
+
+  describe("purchase", () => {
+    it("sends the ASM envelope verified against the live sandbox", async () => {
+      const { provider, post } = build(approved);
+
+      await provider.purchase(input);
+
+      const [url, body] = post.mock.calls[0];
+      expect(url).toBe("https://testpayments.ebirr.com/asm");
+      expect(body).toMatchObject({
+        schemaVersion: "1.0",
+        channelName: "WEB",
+        serviceName: "API_PURCHASE",
+        serviceParams: {
+          merchantUid: "M1000003",
+          apiKey: "API-1234560",
+          apiUserId: "10000008",
+          paymentMethod: "MWALLET_ACCOUNT",
+          // `accountNo`, not the vendor doc's `subscriptionId`
+          payerInfo: { accountNo: "251923582676" },
+          transactionInfo: {
+            referenceId: "EDR-ORDER-1",
+            invoiceId: "EDR-20240001",
+            currency: "ETB",
+          },
+        },
+      });
+      // eBirr wants `YYYY-MM-DD HH:mm:ss`, not the epoch seconds Waafi's /asm takes.
+      expect(body.timestamp).toMatch(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/);
+      expect(body.requestId).toHaveLength(36);
+      // Nothing is signed — there is no shared secret in this integration.
+      expect(JSON.stringify(body)).not.toContain("sign");
+    });
+
+    it("sends the amount unscaled — 1500.50 ETB, not 15.005", async () => {
+      const { provider, post } = build(approved);
+
+      await provider.purchase(input);
+
+      expect(post.mock.calls[0][1].serviceParams.transactionInfo.amount).toBe(
+        1500.5,
+      );
+    });
+
+    it("maps an APPROVED verdict to SUCCEEDED with the provider txn id", async () => {
+      const { provider } = build(approved);
+
+      const result = await provider.purchase(input);
+
+      expect(result.status).toBe(ProviderPaymentStatus.SUCCEEDED);
+      expect(result.providerTxnId).toBe("619");
+      expect(result.failureCode).toBeUndefined();
+    });
+
+    it("maps the live DECLINED response to FAILED with the specific cause", async () => {
+      const { provider } = build(declined);
+
+      const result = await provider.purchase(input);
+
+      expect(result.status).toBe(ProviderPaymentStatus.FAILED);
+      expect(result.failureCode).toBe("E10205");
+      // The specific cause, not the generic "Payment Failed (…)" wrapper.
+      expect(result.failureMessage).toBe("Invalid Credentials");
+      // eBirr issues a transaction id for failed attempts too — keep it for reconciliation.
+      expect(result.providerTxnId).toBe("621");
+    });
+
+    it("maps the live User-Aborted/TIMEOUT response to FAILED", async () => {
+      const { provider } = build(userAborted);
+
+      const result = await provider.purchase(input);
+
+      expect(result.status).toBe(ProviderPaymentStatus.FAILED);
+      expect(result.failureCode).toBe("4004");
+      expect(result.failureMessage).toBe("User Aborted");
+      expect(result.providerTxnId).toBe("622");
+    });
+
+    it("never promotes a rejected envelope to SUCCEEDED, even if state says APPROVED", async () => {
+      const { provider } = build({
+        ...declined,
+        params: { state: "APPROVED" },
+      });
+
+      const result = await provider.purchase(input);
+
+      expect(result.status).toBe(ProviderPaymentStatus.FAILED);
+    });
+
+    it("falls back to the envelope when a rejection carries no params at all", async () => {
+      const { provider } = build({
+        schemaVersion: "1.0",
+        responseCode: "5001",
+        errorCode: "E10206",
+        responseMsg: "Failed to process request",
+      });
+
+      const result = await provider.purchase(input);
+
+      expect(result.status).toBe(ProviderPaymentStatus.FAILED);
+      expect(result.failureCode).toBe("E10206");
+    });
+
+    it("maps a timeout to PROCESSING, never FAILED — the money may have moved", async () => {
+      const post = jest
+        .fn()
+        .mockReturnValue(
+          throwError(() => new AxiosError("timeout of 45000ms exceeded")),
+        );
+      const provider = new EBirrProvider(config as never, { post } as never);
+
+      const result = await provider.purchase(input);
+
+      expect(result.status).toBe(ProviderPaymentStatus.PROCESSING);
+    });
+
+    /**
+     * The dispatch/no-dispatch split. A request that never left the process cannot have moved
+     * money and leaves NO transaction for API_GETTRANINFO to find — reporting it as PROCESSING
+     * stranded the payer on "check your phone" for a push that was never sent, until expiry.
+     * A request that did go out stays PROCESSING no matter how it broke (vendor doc §10).
+     */
+    function purchaseWithTransportError(
+      message: string,
+      code?: string,
+    ): Promise<{ status: ProviderPaymentStatus; failureMessage?: string }> {
+      const err = new AxiosError(message);
+      if (code) err.code = code;
+      const post = jest.fn().mockReturnValue(throwError(() => err));
+      return new EBirrProvider(
+        config as never,
+        {
+          post,
+        } as never,
+      ).purchase(input);
+    }
+
+    it.each([
+      // Node's TCP connect timeout — the SYN was never answered (blocked port / no whitelist).
+      ["connect ETIMEDOUT 197.156.83.125:443", "ETIMEDOUT"],
+      ["connect ECONNREFUSED 10.0.0.1:443", "ECONNREFUSED"],
+      ["getaddrinfo ENOTFOUND testpayments.ebirr.com", "ENOTFOUND"],
+      ["Invalid URL", "ERR_INVALID_URL"],
+      ["certificate has expired", "CERT_HAS_EXPIRED"],
+    ])("fails fast on %s — it never reached eBirr", async (message, code) => {
+      const result = await purchaseWithTransportError(message, code);
+
+      expect(result.status).toBe(ProviderPaymentStatus.FAILED);
+      // A cause the payer can act on, not the generic "please try again".
+      expect(result.failureMessage).toMatch(/could not reach ebirr/i);
+    });
+
+    it.each([
+      // Axios's own read timeout reported with the ETIMEDOUT code (clarifyTimeoutError) — the
+      // request WAS sent, so this must not be confused with a connect timeout.
+      ["timeout of 45000ms exceeded", "ETIMEDOUT"],
+      // Fired after the body went out; the debit may well have been processed.
+      ["socket hang up", "ECONNRESET"],
+      ["aborted", "ECONNABORTED"],
+      ["something nobody anticipated", undefined],
+    ])(
+      "keeps %s as PROCESSING — it may have been dispatched",
+      async (message, code) => {
+        const result = await purchaseWithTransportError(message, code);
+
+        expect(result.status).toBe(ProviderPaymentStatus.PROCESSING);
+      },
+    );
+  });
+
+  describe("queryStatus", () => {
+    it("looks the transaction up by referenceId via API_GETTRANINFO", async () => {
+      const { provider, post } = build({
+        schemaVersion: "1.0",
+        responseCode: "2001",
+        errorCode: "0",
+        responseMsg: "RCS_SUCCESS",
+        params: { status: "Approved", transactionId: "126895" },
+      });
+
+      const result = await provider.queryStatus("EDR-ORDER-1");
+
+      expect(post.mock.calls[0][1]).toMatchObject({
+        serviceName: "API_GETTRANINFO",
+        serviceParams: { referenceId: "EDR-ORDER-1" },
+      });
+      expect(result.status).toBe(ProviderPaymentStatus.SUCCEEDED);
+      expect(result.providerTxnId).toBe("126895");
+    });
+
+    it("treats an unknown transaction as REQUIRES_ACTION, not PROCESSING", async () => {
+      const { provider } = build({
+        schemaVersion: "1.0",
+        responseCode: "5001",
+        errorCode: "E10206",
+        responseMsg: "Failed to get transaction info",
+      });
+
+      const result = await provider.queryStatus("EDR-ORDER-1");
+
+      // The payer simply hasn't answered the prompt yet. Persisting a PROCESSING guess would
+      // let the sweep strand them on a push they never touched.
+      expect(result.status).toBe(ProviderPaymentStatus.REQUIRES_ACTION);
+    });
+
+    it("honours a terminal state on a rejected envelope instead of hanging the payer", async () => {
+      // The purchase endpoint returns rejected envelopes that still carry a verdict
+      // (5206/DECLINED, 5001/TIMEOUT). If the query endpoint does the same, reading only the
+      // envelope would report REQUIRES_ACTION and leave the payer waiting until expiry.
+      const { provider } = build(userAborted);
+
+      const result = await provider.queryStatus("EDR-ORDER-1");
+
+      expect(result.status).toBe(ProviderPaymentStatus.FAILED);
+      expect(result.failureMessage).toBe("User Aborted");
+    });
+  });
+
+  describe("normalizeEthiopianMsisdn", () => {
+    it.each([
+      ["+251923582676", "251923582676"],
+      ["251923582676", "251923582676"],
+      ["0923582676", "251923582676"],
+      ["923582676", "251923582676"],
+      ["+251 92 358 2676", "251923582676"],
+      ["0712345678", "251712345678"],
+    ])("normalises %s to %s", (raw, expected) => {
+      expect(normalizeEthiopianMsisdn(raw)).toBe(expected);
+    });
+
+    it.each(["", "not-a-number", "0812345678", "09123", "0912345678901"])(
+      "rejects %s rather than prompting a stranger's handset",
+      (raw) => {
+        expect(() => normalizeEthiopianMsisdn(raw)).toThrow();
+      },
+    );
+  });
+});
diff --git a/apps/edr-payment-api/src/modules/webhooks/handlers/ebirr-webhook.service.ts b/apps/edr-payment-api/src/modules/webhooks/handlers/ebirr-webhook.service.ts
deleted file mode 100644
index 3f8b923cd..000000000
--- a/apps/edr-payment-api/src/modules/webhooks/handlers/ebirr-webhook.service.ts
+++ /dev/null
@@ -1,33 +0,0 @@
-import { Injectable } from "@nestjs/common";
-import { EBirrProvider, EBirrWebhookPayload } from "@edr/payment-providers";
-import { WebhookProcessorService } from "../webhook-processor.service";
-
-@Injectable()
-export class EBirrWebhookService {
-  constructor(
-    private readonly provider: EBirrProvider,
-    private readonly processor: WebhookProcessorService,
-  ) {}
-
-  async handle(payload: EBirrWebhookPayload): Promise<void> {
-    const signatureValid = this.provider.verifyWebhookSignature(
-      payload as unknown as Record<string, unknown>,
-    );
-    const mapped = this.provider.mapWebhookStatus(payload.tradeStatus);
-
-    await this.processor.process({
-      provider: this.provider.method,
-      externalEventId: `${payload.orderNo}_${payload.tradeStatus}_${payload.timestamp}`,
-      merchantOrderId: payload.orderNo,
-      providerTxnId: payload.tradeNo,
-      signatureValid,
-      rawStatus: payload.tradeStatus,
-      payload: payload as unknown as Record<string, unknown>,
-      result: {
-        status: mapped,
-        providerTxnId: payload.tradeNo,
-        failureCode: payload.tradeStatus,
-      },
-    });
-  }
-}
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 6c923e8b4..e4b200ad6 100644
--- a/apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts
+++ b/apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts
@@ -14,14 +14,12 @@ import {
   CardWebhookPayload,
   CbeBirrWebhookPayload,
   DMoneyWebhookPayload,
-  EBirrWebhookPayload,
   TelebirrWebhookPayload,
   WaafiWebhookHeaders,
   WaafiWebhookPayload,
 } from "@edr/payment-providers";
 import { TelebirrWebhookService } from "./handlers/telebirr-webhook.service";
 import { CbeBirrWebhookService } from "./handlers/cbe-birr-webhook.service";
-import { EBirrWebhookService } from "./handlers/ebirr-webhook.service";
 import { CardWebhookService } from "./handlers/card-webhook.service";
 import { WaafiWebhookService } from "./handlers/waafi-webhook.service";
 import { DMoneyWebhookService } from "./handlers/dmoney-webhook.service";
@@ -40,7 +38,6 @@ export class WebhooksController {
   constructor(
     private readonly telebirr: TelebirrWebhookService,
     private readonly cbeBirr: CbeBirrWebhookService,
-    private readonly eBirr: EBirrWebhookService,
     private readonly card: CardWebhookService,
     private readonly waafi: WaafiWebhookService,
     private readonly dMoney: DMoneyWebhookService,
@@ -89,17 +86,9 @@ export class WebhooksController {
     return { success: true };
   }
 
-  @Post("ebirr")
-  @HttpCode(HttpStatus.OK)
-  @ApiOperation({ summary: "eBirr payment notification callback (Ethiopia)" })
-  async receiveEBirr(@Body() payload: EBirrWebhookPayload) {
-    try {
-      await this.eBirr.handle(payload);
-    } catch (err) {
-      this.logger.error(`eBirr webhook handler threw: ${this.message(err)}`);
-    }
-    return { code: "0000", message: "success" };
-  }
+  // No eBirr route by design: EbirrPay's API-payment flow has no callback. The API_PURCHASE
+  // response is the settlement notification, and API_GETTRANINFO is the authority for a missing
+  // or ambiguous one — see docs/ebirr/INTEGRATION.md.
 
   @Post("card")
   @HttpCode(HttpStatus.OK)
diff --git a/apps/edr-payment-api/src/modules/webhooks/webhooks.module.ts b/apps/edr-payment-api/src/modules/webhooks/webhooks.module.ts
index 86b94032b..78d2f8717 100644
--- a/apps/edr-payment-api/src/modules/webhooks/webhooks.module.ts
+++ b/apps/edr-payment-api/src/modules/webhooks/webhooks.module.ts
@@ -8,7 +8,6 @@ import { WebhookProcessorService } from "./webhook-processor.service";
 import { WebhooksController } from "./webhooks.controller";
 import { TelebirrWebhookService } from "./handlers/telebirr-webhook.service";
 import { CbeBirrWebhookService } from "./handlers/cbe-birr-webhook.service";
-import { EBirrWebhookService } from "./handlers/ebirr-webhook.service";
 import { CardWebhookService } from "./handlers/card-webhook.service";
 import { WaafiWebhookService } from "./handlers/waafi-webhook.service";
 import { DMoneyWebhookService } from "./handlers/dmoney-webhook.service";
@@ -25,7 +24,6 @@ import { DMoneyWebhookService } from "./handlers/dmoney-webhook.service";
     WebhookProcessorService,
     TelebirrWebhookService,
     CbeBirrWebhookService,
-    EBirrWebhookService,
     CardWebhookService,
     WaafiWebhookService,
     DMoneyWebhookService,
diff --git a/docker-compose.yaml b/docker-compose.yaml
index e40d8b49e..3250e4f45 100644
--- a/docker-compose.yaml
+++ b/docker-compose.yaml
@@ -3,7 +3,6 @@
 # Copy apps/*/env.example to .env and set real values before `docker compose up`.
 #
 # Build:  DOCKER_BUILDKIT=1 docker compose build
-# Run:    docker compose up -d
 
 services:
   freight-api:
@@ -50,6 +49,7 @@ services:
       args:
         TURBO_FILTER: "@edr/freight-portal"
         APP_PATH: apps/edr-freight-web/portal
+        VITE_ENV: ${VITE_ENV:-}
         VITE_API_URL: ${VITE_API_URL:-}
         VITE_BASE_API_URL: ${VITE_BASE_API_URL:-}
         VITE_USER_MANAGEMENT_BASE: ${VITE_USER_MANAGEMENT_BASE:-}
@@ -117,3 +117,35 @@ services:
     env_file:
       - apps/edr-payment-api/.env
     restart: always
+
+  # Internal employee chat (freight backoffice). No federation, no public
+  # registration — see infrastructure/matrix/synapse/homeserver.yaml.tmpl.
+  synapse:
+    build:
+      context: infrastructure/matrix/synapse
+    ports:
+      - "${SYNAPSE_PORT:-8008}:8008"
+    env_file:
+      - infrastructure/matrix/synapse/.env
+    volumes:
+      - matrix-data:/data
+    # Local dev: Postgres runs in the separate docker-compose.db.dev.yml
+    # project (different docker network) and is only reachable from here via
+    # the host's published port — see MATRIX_DB_HOST in synapse/.env.example.
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    restart: always
+
+  element-web:
+    build:
+      context: infrastructure/matrix/element
+    ports:
+      - "${ELEMENT_WEB_PORT:-8080}:80"
+    # config.json is rendered at container start, not baked — one image serves
+    # dev, staging and prod. See infrastructure/matrix/element/.env.example.
+    env_file:
+      - infrastructure/matrix/element/.env
+    restart: always
+
+volumes:
+  matrix-data:
diff --git a/docs/MAP.md b/docs/MAP.md
new file mode 100644
index 000000000..d6aa76322
--- /dev/null
+++ b/docs/MAP.md
@@ -0,0 +1,96 @@
+# Repo map — start here
+
+Routing table for "where does X live". Read this before a repo-wide grep. Paths are from
+the repo root. The rules and traps are in [`../CLAUDE.md`](../CLAUDE.md); this file only
+answers *where*.
+
+## Pick your stack first
+
+| If you are working on…            | Code lives in                     | Stack                |
+| --------------------------------- | --------------------------------- | -------------------- |
+| Freight API / business logic      | `apps/edr-freight-api/src`        | NestJS + TypeORM     |
+| Freight customer UI               | `apps/edr-freight-web/portal`     | React + Vite + Mantine v9 |
+| Freight staff UI                  | `apps/edr-freight-web/backoffice` | React + Vite + Mantine v9 |
+| Passenger API                     | `apps/edr-passenger-api`          | NestJS + **Prisma**  |
+| Passenger UI                      | `apps/edr-passenger-web/*`        | **Next.js**          |
+| Payments (intents, webhooks)      | `apps/edr-payment-api`            | NestJS + TypeORM     |
+| Gateway integrations              | `packages/payment-providers`      | —                    |
+| A shared type or enum             | `packages/types/src`              | rebuild after editing |
+| A shared React component          | `packages/ui-common/src`          | —                    |
+| A Nest decorator/filter/base class| `packages/api-common/src`         | —                    |
+
+## Freight API entry points
+
+| File | What it is |
+| --- | --- |
+| `src/main.ts` | Boot, port (`PORT`, falls back to 3001), global pipes |
+| `src/app.module.ts` | Every module is registered here — the index of the API |
+| `src/config/database.config.ts` | Connection, pooler `search_path` handling, `iamEntities` list |
+| `src/data-source.ts` | Standalone DataSource used by migrations only (no `autoLoadEntities`) |
+| `src/migrations/` | TypeORM migrations (39 files; check for timestamp clashes) |
+| `src/seed/freight-permissions.registry.ts` | Every freight permission; declare before use |
+| `src/scripts/` | One-off and `seed:*` scripts — several write real rows |
+
+## Freight modules by domain
+
+All under `apps/edr-freight-api/src/modules/`.
+
+| Domain | Modules |
+| --- | --- |
+| **Booking & commercial** | `bookings` `contracts` `contract-templates` `consignments` `cargoes` `companies` `user-trade-access` `transit-agents` `shipping-lines` |
+| **Warehouse & yard** | `warehouses` `facilities` `container-management` |
+| **Rail operations** | `trains` `train-schedules` `train-scheduling` `train-sets` `wagons` `wagon-types` `locomotives` `routes` `scheduling` `scheduling-reschedule` `interchange-documents` |
+| **Road / first & last mile** | `first-mile` `last-mile` `last-mile-requests` `drivers` `vehicles` `truck-types` `fleet-history` `fuel` `maintenance` `gps-tracking` `tracking` |
+| **Money** | `billing` `payment` `exchange-settings` |
+| **Identity & access** | `auth` `otp` `verifayda` `audit` |
+| **Documents & files** | `files` `file-upload-settings` `signatures` `stamp-settings` `logo-settings` `minio` |
+| **Comms** | `notifications` `notification-inbox` `support-chat` `support-content` |
+| **Ops & admin** | `backoffice` `overview` `reports` `dropdown-settings` `rule-engine` `compliance` `procurement` `incidents` `import-operations` `eims` `ai` `health` |
+
+Each module follows `module → controller → service → repository`, with `entities/` and
+`dto/` alongside.
+
+## Freight web
+
+Pages live in `src/pages/`, roughly mirroring the API domains.
+
+- **portal** (customer): `bookings` `contracts` `consignments` `billing` `payments`
+  `tracking` `accounts` `customers` `shipping-line` `support` `settings`, plus
+  `MyPortalPage/`, `MySignaturePage.tsx`, `EDRFreightLandingPage.tsx`.
+- **backoffice** (staff): `bookings` `contracts` `contract_templates` `consignments`
+  `customers` `billing` `invoices` `documents` `fleet` `dashboard` `admin` `configuration`
+  `auth` `ai`, plus many single-file pages (`AuditLogsPage.tsx`, `ActivityLogPage.tsx`,
+  `BulkUploadPage.tsx`, `ContentManagementPage.tsx`, …).
+
+Shared components and theme come from `@edr/ui-common` — check there before writing one.
+
+## Tests
+
+| Suite | Location | Run with |
+| --- | --- | --- |
+| Unit / spec | beside the code, `*.spec.ts` | `pnpm --filter @edr/freight-api test` |
+| Freight e2e (Cypress, containerized) | `e2e/freight` | `pnpm e2e:freight:ci` |
+| Passenger e2e | `e2e/` + `e2e/run.sh` | `pnpm test:e2e:passenger` |
+| UI e2e (Playwright) | `e2e-ui/` | `pnpm test:e2e:ui` |
+| Integration | `integration/` | `pnpm it:up`, `pnpm it:test` |
+
+The freight e2e stack has no host Xvfb — use `ci` (containerized), not `run`/`open`.
+Its compose project name is fixed (`edr-freight-e2e`), so only one can run on this
+machine at a time.
+
+## Documents
+
+| Doc | Covers | Trust |
+| --- | --- | --- |
+| `../CLAUDE.md` | The contract: rules, traps, definition of done | Current — fix in the same PR if wrong |
+| `docs/TESTING.md` | Test strategy | — |
+| `docs/e2e-test-matrix.md`, `docs/ui-e2e-test-matrix.md` | Coverage matrices | — |
+| `docs/ISSUES.md`, `docs/SOLUTIONS.md` | Running log of problems and fixes | Historical |
+| `docs/uploads.md` | File upload handling | — |
+| `docs/qa/edr-freight-qa-test-plan.md` | QA test plan | — |
+| `../DEPLOYMENT.md` | Deploy process | — |
+| `../ITMLS_DB_Design.md`, `../orgstructure.md` | Design notes | Historical |
+| `../E2E_TEST_REPORT.md`, `../checkpoint.md` | Point-in-time snapshots | **Stale by design — dated artifacts, not references** |
+
+Root-level `*.sql` and `*.dump` files are ad-hoc data snapshots, not part of the schema.
+Migrations are the only source of truth for schema.
diff --git a/docs/uploads.md b/docs/uploads.md
new file mode 100644
index 000000000..a41763d89
--- /dev/null
+++ b/docs/uploads.md
@@ -0,0 +1,86 @@
+# Upload size limits
+
+A document upload passes through four independent ceilings. The **smallest one
+wins**, so raising a limit in application code changes nothing while a lower
+limit sits in front of it.
+
+| # | Layer | Limit | Where it lives |
+| - | ----- | ----- | -------------- |
+| 1 | Reverse proxy (`client_max_body_size`) | **50m** | nginx config on the API host — **not in this repo** for deployed environments |
+| 2 | Express JSON/urlencoded body | `JSON_BODY_LIMIT` = 80mb | `apps/edr-freight-api/src/main.ts` |
+| 3 | Multer multipart (`fileSize`) | `DOCUMENT_UPLOAD_MAX_BYTES` = 50MB | `apps/edr-freight-api/src/common/document-upload.options.ts` |
+| 4 | Per-field portal gate (`max_size_mb`) | 50 | `freight.file_upload_fields`, seeded by `file-upload-settings.seeder.ts` |
+
+Layer 4 is the only one the customer sees before uploading — `SmartFileInput`
+blocks the file client-side with "File size exceeds the limit of NMB". Layers
+1–3 produce a failed request after the fact.
+
+## The nginx layer is the one that bites
+
+nginx defaults `client_max_body_size` to **1m** and answers anything larger with
+its own HTML error page:
+
+```
+HTTP/1.1 413 Request Entity Too Large
+Server: nginx
+Content-Type: text/html
+```
+
+Two tells that a 413 came from the proxy rather than the API:
+
+- the body is nginx's HTML page, not the API's JSON envelope, and
+- `curl -w '%{size_upload}'` reports **0** — nginx rejects on the `Content-Length`
+  header, so the body is never transmitted.
+
+This is also why the failure looks like a CORS error in the browser: nginx's
+error response carries no `Access-Control-Allow-Origin` header.
+
+### Applying it
+
+Add to the `server` (or `location`) block fronting the API and reload:
+
+```nginx
+server {
+    server_name edrfreightapi-staging.edrsc.com;
+
+    client_max_body_size 50m;
+
+    location / {
+        proxy_pass http://freight-api:3001;
+        # Large uploads stream for a while; the default 60s read timeout can
+        # cut off a slow client mid-body.
+        proxy_read_timeout 300s;
+        proxy_request_buffering off;
+    }
+}
+```
+
+```bash
+nginx -t && nginx -s reload   # -t first: a bad config that reloads takes the site down
+```
+
+On Kubernetes ingress-nginx this is an annotation on the Ingress instead:
+
+```yaml
+nginx.ingress.kubernetes.io/proxy-body-size: 50m
+```
+
+Note that `client_max_body_size 0` disables the check entirely — do not use it.
+An unbounded body is a denial-of-service vector, and layer 3 buffers uploads in
+memory.
+
+## Verifying end to end
+
+512KB should pass the proxy and reach the API; 50MB should too. A `401` here is
+a *success* for this purpose — it means the request got past nginx to the API's
+auth layer.
+
+```bash
+head -c 52428800 /dev/urandom > big.bin
+curl -s -o /dev/null -w 'HTTP %{http_code}  uploaded %{size_upload}\n' \
+  -X POST "https://edrfreightapi-staging.edrsc.com/api/companies/<id>/documents" \
+  -F "test=@big.bin"
+```
+
+- `413` with `uploaded 0` → the proxy is still capped; layer 1 was not applied.
+- `401`/`200` with the full byte count → the body made it through.
diff --git a/dump-edr_prod-202608092016.sql b/dump-edr_prod-202608092016.sql
new file mode 100644
index 000000000..19454d882
Binary files /dev/null and b/dump-edr_prod-202608092016.sql differ
diff --git a/dump-smart_office_prod-202608092053.sql b/dump-smart_office_prod-202608092053.sql
new file mode 100644
index 000000000..7409b63d0
Binary files /dev/null and b/dump-smart_office_prod-202608092053.sql differ
diff --git a/e2e/freight/cypress/e2e/flows/onboarding-utils.ts b/e2e/freight/cypress/e2e/flows/onboarding-utils.ts
new file mode 100644
index 000000000..93d193ac7
--- /dev/null
+++ b/e2e/freight/cypress/e2e/flows/onboarding-utils.ts
@@ -0,0 +1,385 @@
+/**
+ * Shared machinery for the onboarding journeys (portal → backoffice).
+ *
+ * The wizard's five form steps are `company → owner → representation →
+ * contact → documents`, preceded by the nationality/role phase. Three routes
+ * run through them:
+ *
+ *   ordinary   eTrade answers for the TIN; the registration is read-only.
+ *   investor   a foreign company on an Investment Commission licence — eTrade
+ *              holds nothing, the registration is typed, the per-role business
+ *              licence is still owed.
+ *   co-op      a union or farm — eTrade holds nothing, the registration is
+ *              typed, and no business licence exists to ask for.
+ *
+ * The eTrade mock picks its answer from the TIN's leading digit (see
+ * etrade-mock/server.js), so a spec chooses "verified" or "nothing on file" by
+ * choosing its number — `etradeTin()` / `noLicenceTin()` / `unknownTin()`.
+ */
+
+/**
+ * Every manual-route journey deliberately looks up a TIN eTrade holds nothing
+ * for, and the API answers 400. The portal handles that outcome on screen (the
+ * "nothing on file" alert is the whole point) but leaves the rejected request
+ * unhandled at the promise level, and Cypress fails a test on any unhandled
+ * rejection from the app. Ignored here rather than per spec: it is the expected
+ * response to a request these journeys make on purpose, in every one of them.
+ *
+ * Narrow on purpose — only the 400. A 500, or anything else the app throws,
+ * still fails the test.
+ */
+Cypress.on("uncaught:exception", (err) => {
+  if (/Request failed with status code 400/.test(err.message)) return false;
+  return true;
+});
+
+const apiUrl = () => Cypress.env("apiUrl") as string;
+
+export const portalUrl = () => Cypress.env("portalUrl") as string;
+
+/* ------------------------------------------------------------------ */
+/* Field helpers                                                       */
+/* ------------------------------------------------------------------ */
+
+/**
+ * Fill a labelled Mantine input (label[for] → input id).
+ *
+ * The input is resolved fresh for every action rather than captured once.
+ * Each wizard step persists and re-seeds asynchronously, and when a field
+ * remounts Mantine mints a NEW generated id — so a subject captured a command
+ * earlier can already be stale. Going label → for → element each time always
+ * addresses what is on the page now.
+ */
+export function fill(label: string | RegExp, value: string) {
+  const input = () =>
+    cy
+      .contains("label", label)
+      .invoke("attr", "for")
+      .then((id) => cy.get(`[id="${id}"]`));
+
+  input().clear({ force: true });
+  input().type(value, { force: true });
+}
+
+/**
+ * Fill an input that has no <label> — the company step renders TIN and VAT
+ * inside StepSection cards (the heading is the card's title, not a label), and
+ * both share the "0012345678" placeholder, so they are addressable only by
+ * aria-label.
+ */
+export function fillAria(ariaSelector: string, value: string) {
+  const selector = `.mantine-Modal-content ${ariaSelector}`;
+  cy.get(selector).clear({ force: true });
+  cy.get(selector).type(value, { force: true });
+}
+
+/** The wizard's phone inputs (react-phone-number-input, type=tel). */
+export function fillPhone(index: number, national: string) {
+  const selector = '.mantine-Modal-content input[type="tel"]';
+  cy.get(selector).eq(index).clear({ force: true });
+  cy.get(selector).eq(index).type(national, { force: true });
+}
+
+/** The wizard's own Continue / Submit button (never the page's). */
+export function wizardClick(label: string | RegExp) {
+  cy.get(".mantine-Modal-content").contains("button", label).click();
+}
+
+/* ------------------------------------------------------------------ */
+/* Identities                                                          */
+/* ------------------------------------------------------------------ */
+
+/** A TIN eTrade answers for: registration + one business licence. */
+export const etradeTin = (stamp: number) => `1${String(stamp).slice(-9)}`;
+/** A TIN eTrade knows, but which holds no trade licence (co-op / investor). */
+export const noLicenceTin = (stamp: number) => `9${String(stamp).slice(-9)}`;
+/** A TIN eTrade has never heard of at all. */
+export const unknownTin = (stamp: number) => `8${String(stamp).slice(-9)}`;
+/** VAT is 10–11 digits and must not collide with the TIN. */
+export const vatNumber = (stamp: number) => `2${String(stamp + 7).slice(-9)}`;
+
+export const SIGNUP_PASSWORD = "Password@e2e1";
+
+export interface Signup {
+  email: string;
+  /** Ethiopian mobile, national format (9 + 8 digits). */
+  phoneNational: string;
+}
+
+/** A unique signup identity for this run, namespaced per journey. */
+export function signupIdentity(prefix: string, stamp: number): Signup {
+  return {
+    email: `e2e.${prefix}.${stamp}@example.com`,
+    phoneNational: `9${String(stamp).slice(-8)}`,
+  };
+}
+
+/* ------------------------------------------------------------------ */
+/* Journey steps                                                       */
+/* ------------------------------------------------------------------ */
+
+/**
+ * /signup → OTP (read from the DB; delivery is off in e2e) → signed in on
+ * /portal with the onboarding wizard already open on the nationality step.
+ */
+export function signupCustomer(who: Signup, firstName = "Onboard") {
+  cy.visit(`${portalUrl()}/signup`);
+
+  fill(/^First name/, firstName);
+  fill(/^Last name/, "Tester");
+  fill(/^Email/, who.email);
+  cy.get('input[type="tel"]').first().type(who.phoneNational, { force: true });
+  fill(/^Password/, SIGNUP_PASSWORD);
+  fill(/^Confirm password/, SIGNUP_PASSWORD);
+  cy.contains("button", "Continue").click();
+
+  cy.contains("Verify", { timeout: 15000 }).should("be.visible");
+  cy.getOtp(who.email).then((otp) => cy.typeOtp(otp));
+  cy.contains("button", "Verify & create account").click();
+
+  cy.location("pathname", { timeout: 20000 }).should("eq", "/portal");
+  cy.contains("Where is your company registered?", { timeout: 15000 }).should(
+    "be.visible",
+  );
+}
+
+/**
+ * Fill the "Registration details" block the manual routes type by hand. Region
+ * is a Mantine Select; the rest are plain inputs.
+ */
+export function typeRegistration(companyName: string) {
+  fill(/^Company Name/, companyName);
+  cy.mantineSelect("Region", "Addis Ababa");
+  fill(/^Zone/, "Zone 1");
+  fill(/^Woreda/, "Woreda 1");
+  fill(/^Kebele/, "Kebele 1");
+}
+
+/**
+ * Attach a PDF to the next empty dropzone on the documents step.
+ *
+ * Not positional: SmartFileInput swaps its dropzone for the file row once
+ * something is attached, so the input disappears from the DOM and every later
+ * index shifts under you. "The first one still asking for a file" is the only
+ * stable address, and it walks the step in render order — company documents
+ * first, then one card per operational profile.
+ */
+export function attachNextFile() {
+  cy.get('.mantine-Modal-content input[type="file"]')
+    .first()
+    .selectFile("cypress/fixtures/docs/license.pdf", { force: true });
+}
+
+/**
+ * Drive the whole investor wizard, signup included, and submit it.
+ *
+ * Shared because two specs need the same customer sitting on the far side of
+ * onboarding: the one that is about the journey, and the one that is about
+ * what happens afterwards. Driving the real UI rather than posting the
+ * equivalent API calls keeps the second spec honest — it starts from a company
+ * the product itself produced.
+ *
+ * `beforeSubmit` runs on the documents step, with everything attached and the
+ * submit button still unpressed: the one place a caller can assert about a
+ * state that does not survive submission.
+ */
+export function completeInvestorOnboarding(
+  who: Signup,
+  stamp: number,
+  opts: { companyName?: string; beforeSubmit?: () => void } = {},
+) {
+  const companyName = opts.companyName ?? `E2E Investor Holdings ${stamp}`;
+
+  signupCustomer(who, "Investor");
+
+  cy.contains("button", "Foreign Company").click();
+  cy.contains("We operate on a foreign investment licence").click();
+  cy.contains("button", "Importer").click();
+  wizardClick("Continue");
+
+  cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
+    "be.visible",
+  );
+  fillAria('[aria-label^="TIN Number"]', noLicenceTin(stamp));
+  cy.contains("Nothing on file at eTrade for this TIN", {
+    timeout: 20000,
+  }).should("be.visible");
+  typeRegistration(companyName);
+  fillAria('[aria-label="VAT Number"]', vatNumber(stamp));
+  wizardClick("Continue");
+
+  // No licence, so no eTrade manager: every owner field is typed, and the
+  // "your licence listed no manager" hint has no business appearing.
+  cy.contains("Company Owner", { timeout: 20000 }).should("be.visible");
+  cy.contains("Your eTrade licence didn't list a manager").should("not.exist");
+  fill(/^Owner's Name/, "Investor Owner");
+  fill(/^Owner's Email/, `owner.${stamp}@example.com`);
+  fillPhone(0, "911234570");
+  wizardClick("Continue");
+
+  cy.contains("Does anyone hold power of attorney for this company?", {
+    timeout: 20000,
+  }).should("be.visible");
+  cy.contains("button", "No, the owner acts for us").click();
+  // Identity is not proven yet, so the step must hold. Asserted as "we did not
+  // advance" rather than on the alert text: answering the declaration refetches
+  // the profile, which re-seeds the form, and the form's watch subscription
+  // clears the alert on any value change — so the message is real but lives for
+  // a few milliseconds.
+  wizardClick("Continue");
+  cy.contains("Who Acts For You").should("be.visible");
+  cy.contains("Contact Person").should("not.exist");
+  // The alternative a foreign company gets and an Ethiopian one does not.
+  cy.contains("Use a passport instead").click();
+  fill(/Passport Number/, `P${String(stamp).slice(-7)}`);
+  wizardClick("Continue");
+
+  cy.contains("Contact Person", { timeout: 20000 }).should("be.visible");
+  fill(/^Name$/, "Investor Contact");
+  fillPhone(0, "911234571");
+  wizardClick("Continue");
+
+  cy.contains("Upload Importer Business license file(s)", {
+    timeout: 20000,
+  }).should("be.visible");
+  attachNextFile();
+  attachNextFile();
+  opts.beforeSubmit?.();
+  wizardClick("Submit for review");
+  cy.contains("You're all set", { timeout: 30000 }).should("be.visible");
+}
+
+/* ------------------------------------------------------------------ */
+/* Database + API                                                      */
+/* ------------------------------------------------------------------ */
+
+export interface CompanyRow {
+  id: string;
+  name: string;
+  status: string;
+  nationality: string | null;
+  attributes: Record<string, unknown> | null;
+  licence_number: string | null;
+  region: string | null;
+  etrade_phone: string | null;
+  onboarding_step: string | null;
+  onboarding_completed: boolean;
+  email: string;
+}
+
+const COMPANY_SQL = `
+  SELECT c.id, c.name, c.status, c.nationality, c.attributes,
+         c.licence_number, c.region, c.etrade_phone,
+         ep.onboarding_step, ep.onboarding_completed, u.email
+    FROM freight.companies c
+    JOIN freight.external_profiles ep ON ep.company_id = c.id
+    JOIN iam.users u ON u.id = ep.user_id`;
+
+/** The company behind one signup email. */
+export function companyByEmail(email: string) {
+  return cy
+    .task<{ rows: CompanyRow[] }>("db:query", {
+      sql: `${COMPANY_SQL} WHERE u.email = $1`,
+      params: [email],
+    })
+    .then(({ rows }) => {
+      expect(rows, `company for ${email}`).to.have.length(1);
+      return cy.wrap(rows[0], { log: false });
+    });
+}
+
+/**
+ * The most recent journey of one kind, resolved from the DB rather than from
+ * module state: Cypress re-evaluates the spec bundle on every cross-origin
+ * visit, so anything held in a module variable is gone by the backoffice test.
+ */
+export function latestJourney(emailPrefix: string) {
+  // Scoped to THIS cypress run. `run:stamp` is minted by the node plugin, which
+  // outlives the bundle re-evaluation a cross-origin visit causes — unlike
+  // anything held in module state. Without the cutoff a journey that failed
+  // mid-way would silently hand the backoffice tests a previous run's company
+  // and pass on it.
+  return cy.task<string>("run:stamp", null, { log: false }).then((runStamp) =>
+    cy
+      .task<{ rows: CompanyRow[] }>("db:query", {
+        sql: `${COMPANY_SQL}
+               WHERE u.email LIKE $1
+                 AND c.created_at >= to_timestamp($2::bigint / 1000.0)
+               ORDER BY c.created_at DESC LIMIT 1`,
+        params: [`e2e.${emailPrefix}.%`, runStamp],
+      })
+      .then(({ rows }) => {
+        expect(rows, `journey for e2e.${emailPrefix}.* in this run`).to.have.length(
+          1,
+        );
+        return cy.wrap(rows[0], { log: false });
+      }),
+  );
+}
+
+/** A portal access token for a customer account. */
+export function portalToken(email: string, password = SIGNUP_PASSWORD) {
+  return cy.apiLogin(email, password, "portal").then((body) => body.token);
+}
+
+/** cy.request against the freight API with a bearer token. */
+export function apiRequest(
+  token: string,
+  method: "GET" | "POST" | "PATCH",
+  path: string,
+  body?: Record<string, unknown>,
+  failOnStatusCode = true,
+) {
+  return cy.request({
+    method,
+    url: `${apiUrl()}${path}`,
+    headers: { Authorization: `Bearer ${token}` },
+    body,
+    failOnStatusCode,
+  });
+}
+
+/* ------------------------------------------------------------------ */
+/* Backoffice                                                          */
+/* ------------------------------------------------------------------ */
+
+/** Open a customer's detail page from the backoffice list, by company name. */
+export function openCustomer(companyName: string) {
+  cy.visit("/dashboard/customers");
+  cy.get('input[placeholder*="Search by company"]').type(companyName);
+  cy.contains(companyName, { timeout: 15000 }).click();
+}
+
+/**
+ * Approve the pending role profile on the open customer page. Once active the
+ * row's action flips to "Suspend", which is what proves the write landed.
+ */
+export function approveFirstProfile() {
+  cy.contains("button", "Approve", { timeout: 15000 }).click();
+  cy.contains("button", "Suspend", { timeout: 15000 }).should("be.visible");
+}
+
+/** Assert the role profile went active and the company with it. */
+export function expectProfileActive(companyName: string, type = "importer") {
+  return cy
+    .task<{
+      rows: Array<{
+        status: string;
+        reference: string | null;
+        company_status: string;
+      }>;
+    }>("db:query", {
+      sql: `SELECT p.status, p.reference, c.status AS company_status
+              FROM freight.company_profiles p
+              JOIN freight.companies c ON c.id = p.company_id
+             WHERE c.name = $1 AND p.type = $2`,
+      params: [companyName, type],
+    })
+    .then(({ rows }) => {
+      expect(rows, `${type} profile`).to.have.length(1);
+      expect(rows[0].status).to.eq("active");
+      expect(rows[0].reference, "minted reference").to.be.a("string").and.not.be
+        .empty;
+      expect(rows[0].company_status).to.eq("active");
+    });
+}
diff --git a/e2e/freight/cypress/e2e/flows/onboarding.cy.ts b/e2e/freight/cypress/e2e/flows/onboarding.cy.ts
deleted file mode 100644
index 437c0e92e..000000000
--- a/e2e/freight/cypress/e2e/flows/onboarding.cy.ts
+++ /dev/null
@@ -1,276 +0,0 @@
-/**
- * Full customer onboarding journey, both apps:
- *
- *   1. portal    — /signup form → OTP (read from DB, delivery is off in e2e)
- *                  → account created → onboarding wizard (nationality/role →
- *                  company → personnel → contact → PoA → documents incl. the
- *                  per-role business license) → "Submit for review"
- *   2. backoffice — staff (chief, holds edr_freight_app:admin) approves the
- *                  importer profile on /dashboard/customers/:id
- *   3. portal    — the new customer is active: contract wizard reachable
- *
- * Tests are sequential steps of ONE journey (fresh unique user per run), so
- * retries are disabled — a mid-journey retry would replay a non-idempotent
- * step against already-advanced state.
- *
- * NOTE: switching origin between tests (portal 5373 ↔ backoffice 5383)
- * reloads the spec bundle and resets module state — later tests resolve the
- * journey's user/company from the DB instead of module variables.
- */
-
-import { completeFaydaVerification } from "./import-utils";
-
-const stamp = Date.now();
-const email = `e2e.onboard.${stamp}@example.com`;
-// Ethiopian mobile: 9 + 8 digits, unique per run.
-const phoneNational = `9${String(stamp).slice(-8)}`;
-const signupPassword = "Password@e2e1";
-const tin = String(stamp).slice(-10).padStart(10, "1");
-const vat = String(stamp + 1).slice(-10).padStart(10, "2");
-
-const portal = () => Cypress.env("portalUrl") as string;
-
-/** The journey's company/user = the latest e2e.onboard.* signup in the DB. */
-function latestOnboardJourney() {
-  return cy.task<{ rows: Array<{ name: string; email: string }> }>("db:query", {
-    sql: `SELECT c.name, u.email
-          FROM freight.companies c
-          JOIN freight.external_profiles ep ON ep.company_id = c.id
-          JOIN iam.users u ON u.id = ep.user_id
-          WHERE u.email LIKE 'e2e.onboard.%'
-          ORDER BY c.created_at DESC LIMIT 1`,
-  });
-}
-
-/**
- * Fill a labelled Mantine input (label[for] → input id).
- *
- * The input is resolved fresh for every action rather than captured once.
- * Each wizard step persists and re-seeds asynchronously, and when a field
- * remounts Mantine mints a NEW generated id — so both a subject and an id
- * captured a command earlier can be stale by the time the next command runs.
- * Going label → for → element each time always addresses what's on the page
- * now.
- */
-function fill(label: string | RegExp, value: string) {
-  const input = () =>
-    cy
-      .contains("label", label)
-      .invoke("attr", "for")
-      .then((id) => cy.get(`[id="${id}"]`));
-
-  input().clear({ force: true });
-  input().type(value, { force: true });
-}
-
-/**
- * Fill an input that has no <label> — the wizard's company step renders its
- * fields inside StepSection cards (the heading is the card's title, not a
- * label), so they're reachable only by aria-label. Both TIN and VAT share the
- * "0012345678" placeholder, which is why this matches on aria-label instead.
- */
-function fillAria(ariaSelector: string, value: string) {
-  const selector = `.mantine-Modal-content ${ariaSelector}`;
-  cy.get(selector).clear({ force: true });
-  cy.get(selector).type(value, { force: true });
-}
-
-/** The wizard's phone inputs (react-phone-number-input, type=tel). */
-function fillPhone(index: number, national: string) {
-  const selector = '.mantine-Modal-content input[type="tel"]';
-  cy.get(selector).eq(index).clear({ force: true });
-  cy.get(selector).eq(index).type(national, { force: true });
-}
-
-describe("customer onboarding journey", { retries: 0 }, () => {
-  it("signs up with OTP and completes the onboarding wizard", () => {
-    cy.visit(`${portal()}/signup`);
-
-    fill(/^First name/, "Onboard");
-    fill(/^Last name/, "Tester");
-    fill(/^Email/, email);
-    cy.get('input[type="tel"]').first().type(phoneNational, { force: true });
-    fill(/^Password/, signupPassword);
-    fill(/^Confirm password/, signupPassword);
-    cy.contains("button", "Continue").click();
-
-    // OTP stage — the code is generated + stored even though delivery is off.
-    cy.contains("Verify", { timeout: 15000 }).should("be.visible");
-    cy.getOtp(email).then((otp) => cy.typeOtp(otp));
-    cy.contains("button", "Verify & create account").click();
-
-    // Signed in → /portal → wizard auto-opens on the nationality/role step.
-    cy.location("pathname", { timeout: 20000 }).should("eq", "/portal");
-    cy.contains("Where is your company registered?", { timeout: 15000 }).should(
-      "be.visible",
-    );
-    cy.contains("button", "Ethiopian Company").click();
-    cy.contains("button", "Importer").click();
-    cy.get(".mantine-Modal-content").contains("button", "Continue").click();
-
-    // Ethiopian companies gate the "Owner identity" step on Fayda
-    // verification — a real eSignet redirect + SMS OTP flow that can't run in
-    // e2e. Complete it via the API against fayda-mock-e2e (the profile this
-    // attaches to was just created by the nationality/role step above).
-    // The wizard already fetched `identity` once when this step mounted, and
-    // completing verification out-of-band skips the redirect that would
-    // normally remount everything — so reload to force a fresh fetch. Wizard
-    // progress resumes server-side, so this doesn't lose the nationality/role
-    // step just completed.
-    completeFaydaVerification("owner");
-    cy.reload();
-    cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
-      "be.visible",
-    );
-
-    // The owner's identity is the verification's output, never typed: the
-    // panel must show it verified and render the name/phone/email that came
-    // back from fayda-mock-e2e. Asserting the mock's own values is the only
-    // way to prove the payload travelled Fayda → API → UI rather than the
-    // panel simply flipping a "verified" flag.
-    cy.get(".mantine-Modal-content").within(() => {
-      cy.contains("Fayda verified").should("be.visible");
-      cy.contains("Abebe Bekele").should("be.visible");
-      cy.contains("+251911223344").should("be.visible");
-      cy.contains("abebe.bekele@example.com").should("be.visible");
-    });
-
-    // The verified sub is what locks the owner's fields server-side, so check
-    // it actually landed on the company rather than trusting the panel alone.
-    cy.task<{ rows: Array<{ owner_fayda_sub: string | null }> }>("db:query", {
-      sql: `SELECT c.attributes->>'ownerFaydaSub' AS owner_fayda_sub
-            FROM freight.companies c
-            JOIN freight.external_profiles ep ON ep.company_id = c.id
-            JOIN iam.users u ON u.id = ep.user_id
-            WHERE u.email = $1`,
-      params: [email],
-    }).then(({ rows }) => {
-      expect(rows, "company row").to.have.length(1);
-      expect(rows[0].owner_fayda_sub, "owner Fayda sub").to.eq(
-        "e2e-fayda-sub-0001",
-      );
-    });
-
-    // Company step. TIN auto-triggers the eTrade lookup once it's a full 10
-    // digits (mocked in e2e — see docker-compose.e2e.yaml's etrade-mock-e2e).
-    // A successful lookup locks Company Name/Region/Zone/Woreda/Kebele/House
-    // No as read-only (ETradeCompanyCard) — nothing left to type there, and
-    // Company Email/Phone/Location were dropped from this step entirely (the
-    // Fayda-verified owner supplies contact details now). By label, not
-    // placeholder: the VAT Number field on this same step shares the TIN
-    // field's "0012345678" placeholder, so a placeholder selector matches 2.
-    fillAria('[aria-label^="TIN Number"]', tin);
-    cy.contains("Verified with eTrade", { timeout: 15000 }).should(
-      "be.visible",
-    );
-    // handleETradeDataLoaded sets several fields in sequence (name, region,
-    // zone, woreda, kebele, houseNo) — each a render, still settling right
-    // after the badge appears. Typing into VAT immediately raced one of
-    // those and detached mid-type; let it finish before touching the form.
-    cy.wait(500);
-    fillAria('[aria-label="VAT Number"]', vat);
-    cy.get(".mantine-Modal-content").contains("button", "Continue").click();
-
-    // Personnel (general manager).
-    fill(/^Name/, "General Manager");
-    fill(/^Email/, `gm.${stamp}@example.com`);
-    fillPhone(0, "911234568");
-    cy.get(".mantine-Modal-content").contains("button", "Continue").click();
-
-    // Contact person.
-    fill(/^Name/, "Contact Person");
-    fillPhone(0, "911234569");
-    cy.get(".mantine-Modal-content").contains("button", "Continue").click();
-
-    // PoA — optional for an importer, and left unverified here. The DARS
-    // delegation paper authorises the representative the verification names,
-    // so with no verified PoA there is nothing for it to authorise: the
-    // upload must not be offered, and the step must not block on it. Asserted
-    // as "no file input on this step" rather than by label, so a reworded
-    // document setting doesn't turn a real regression into a passing test.
-    cy.get(".mantine-Modal-content")
-      .contains("Power of Attorney")
-      .should("be.visible");
-    cy.get('.mantine-Modal-content input[type="file"]').should("not.exist");
-    cy.get(".mantine-Modal-content").contains("button", "Continue").click();
-
-    // Documents: no company docs are configured in e2e, but every role needs
-    // a business license.
-    cy.contains("Business license", { timeout: 15000 }).should("be.visible");
-    cy.get('.mantine-Modal-content input[type="file"]')
-      .first()
-      .selectFile("cypress/fixtures/docs/license.pdf", { force: true });
-    cy.get(".mantine-Modal-content")
-      .contains("button", "Submit for review")
-      .click();
-
-    cy.contains("You're all set", { timeout: 30000 }).should("be.visible");
-
-    // DB cross-check: submitted, awaiting approval.
-    cy.task<{ rows: Array<{ status: string; onboarding_completed: boolean }> }>(
-      "db:query",
-      {
-        sql: `SELECT c.status, ep.onboarding_completed
-              FROM freight.companies c
-              JOIN freight.external_profiles ep ON ep.company_id = c.id
-              JOIN iam.users u ON u.id = ep.user_id
-              WHERE u.email = $1`,
-        params: [email],
-      },
-    ).then(({ rows }) => {
-      expect(rows, "company row").to.have.length(1);
-      expect(rows[0].status).to.eq("pending");
-      expect(rows[0].onboarding_completed).to.eq(true);
-    });
-  });
-
-  it("backoffice staff approves the submitted importer profile", () => {
-    cy.loginBackoffice("chief@edr.local");
-    cy.visit("/dashboard/customers");
-
-    latestOnboardJourney().then(({ rows }) => {
-      expect(rows, "onboarded company").to.have.length(1);
-      const company = rows[0].name;
-
-      cy.get('input[placeholder*="Search by company"]').type(company);
-      cy.contains(company, { timeout: 15000 }).click();
-
-      // Role profiles table → approve the pending importer profile. Once
-      // active, the row's action flips to "Suspend".
-      cy.contains("button", "Approve", { timeout: 15000 }).click();
-      cy.contains("button", "Suspend", { timeout: 15000 }).should("be.visible");
-
-      cy.task<{ rows: Array<{ status: string; reference: string | null; company_status: string }> }>(
-        "db:query",
-        {
-          sql: `SELECT p.status, p.reference, c.status AS company_status
-                FROM freight.company_profiles p
-                JOIN freight.companies c ON c.id = p.company_id
-                WHERE c.name = $1 AND p.type = 'importer'`,
-          params: [company],
-        },
-      ).then(({ rows: profiles }) => {
-        expect(profiles, "importer profile").to.have.length(1);
-        expect(profiles[0].status).to.eq("active");
-        expect(profiles[0].reference, "minted reference").to.be.a("string").and
-          .not.be.empty;
-        expect(profiles[0].company_status).to.eq("active");
-      });
-    });
-  });
-
-  it("the approved customer can reach the contract wizard", () => {
-    latestOnboardJourney().then(({ rows }) => {
-      cy.loginPortal(rows[0].email, signupPassword);
-    });
-    cy.visitPortal("/contracts/new");
-
-    // No "Awaiting Approval" gate — the wizard's first step renders.
-    cy.contains("label", "Operation Type", { timeout: 15000 }).should(
-      "be.visible",
-    );
-    cy.contains("Awaiting Approval").should("not.exist");
-  });
-});
-
-export {};
diff --git a/e2e/freight/cypress/e2e/flows/onboarding_cooperative.cy.ts b/e2e/freight/cypress/e2e/flows/onboarding_cooperative.cy.ts
new file mode 100644
index 000000000..d94c12b58
--- /dev/null
+++ b/e2e/freight/cypress/e2e/flows/onboarding_cooperative.cy.ts
@@ -0,0 +1,161 @@
+/**
+ * A co-operative union or farm: a TIN, but no business licence at all.
+ *
+ * It reaches the same typed-registration route as a foreign investor and the
+ * same backoffice flag, and differs from it in three ways the wizard has to
+ * enforce rather than merely explain — it is always Ethiopian, it cannot hold
+ * the freight-forwarder role, and it owes no per-role business licence. Its own
+ * document set stands in for the trade licence.
+ *
+ * One journey across both apps; retries off (see onboarding_ethiopian.cy.ts).
+ */
+
+import { completeFaydaVerification } from "./import-utils";
+import {
+  apiRequest,
+  attachNextFile,
+  companyByEmail,
+  fill,
+  fillAria,
+  fillPhone,
+  latestJourney,
+  noLicenceTin,
+  openCustomer,
+  portalToken,
+  signupCustomer,
+  signupIdentity,
+  typeRegistration,
+  vatNumber,
+  wizardClick,
+} from "./onboarding-utils";
+
+const stamp = Date.now();
+const who = signupIdentity("coop", stamp);
+
+describe("onboarding — co-operative union or farm", { retries: 0 }, () => {
+  it("types its registration, owes no business licence, and submits", () => {
+    signupCustomer(who, "Cooperative");
+
+    // Before the box: both nationalities and all three roles are on offer.
+    cy.contains("button", "Foreign Company").should("be.visible");
+    cy.contains("button", "Freight Forwarder").should("be.visible");
+
+    cy.contains("We're a co-operative union or farm").click();
+
+    // A co-op is registered in Ethiopia by the co-operative promotion agency,
+    // holds no licence, and cannot forward freight — so none of those choices
+    // are offered rather than refused later by the API.
+    cy.contains("button", "Foreign Company").should("not.exist");
+    cy.contains("button", "Freight Forwarder").should("not.exist");
+    cy.contains("We operate on a foreign investment licence").should("not.exist");
+
+    cy.contains("button", "Importer").click();
+    wizardClick("Continue");
+
+    // ── Company step ────────────────────────────────────────────────────
+    cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    fillAria('[aria-label^="TIN Number"]', noLicenceTin(stamp));
+    cy.contains("Nothing on file at eTrade for this TIN", {
+      timeout: 20000,
+    }).should("be.visible");
+
+    typeRegistration(`E2E Farmers Union ${stamp}`);
+    fillAria('[aria-label="VAT Number"]', vatNumber(stamp));
+    wizardClick("Continue");
+
+    // ── Owner step ──────────────────────────────────────────────────────
+    cy.contains("Company Owner", { timeout: 20000 }).should("be.visible");
+    fill(/^Owner's Name/, "Union Chairperson");
+    fill(/^Owner's Email/, `chair.${stamp}@example.com`);
+    fillPhone(0, "911234572");
+    wizardClick("Continue");
+
+    // ── Representation step ─────────────────────────────────────────────
+    cy.contains("Does anyone hold power of attorney for this company?", {
+      timeout: 20000,
+    }).should("be.visible");
+    cy.contains("button", "No, the owner acts for us").click();
+
+    // Ethiopian, so Fayda is the only route — the passport alternative belongs
+    // to foreign companies.
+    cy.contains("Use a passport instead").should("not.exist");
+    completeFaydaVerification("owner");
+    cy.reload();
+    cy.get(".mantine-Modal-content", { timeout: 30000 }).within(() => {
+      cy.contains("Fayda verified").should("be.visible");
+    });
+    wizardClick("Continue");
+
+    // ── Contact step ────────────────────────────────────────────────────
+    cy.contains("Contact Person", { timeout: 20000 }).should("be.visible");
+    fill(/^Name$/, "Union Contact");
+    fillPhone(0, "911234573");
+    wizardClick("Continue");
+
+    // ── Documents step ──────────────────────────────────────────────────
+    // The co-operative set replaces the nationality one, and the per-role
+    // licence cards are not rendered at all — offering a slot nothing can fill
+    // reads as an unfinishable step.
+    cy.contains("Upload Documents", { timeout: 20000 }).should("be.visible");
+    cy.contains("Upload Importer Business license file(s)").should("not.exist");
+    cy.get('.mantine-Modal-content input[type="file"]').should(
+      "have.length",
+      1,
+    );
+
+    portalToken(who.email).then((token) =>
+      apiRequest(token, "GET", "/api/companies/onboarding/requirements").then(
+        (res) => {
+          expect(res.body.data.documentSettingCode).to.eq(
+            "company_onboarding_documents_cooperative",
+          );
+          expect(res.body.data.cooperative).to.eq(true);
+          expect(res.body.data.investorLicence).to.eq(false);
+          // The requirement is lifted, not merely hidden on screen.
+          const outstanding: string[] = res.body.data.outstanding;
+          expect(
+            outstanding.filter((o) => /business license/i.test(o)),
+            "no licence is owed",
+          ).to.have.length(0);
+        },
+      ),
+    );
+
+    attachNextFile();
+    wizardClick("Submit for review");
+    cy.contains("You're all set", { timeout: 30000 }).should("be.visible");
+
+    companyByEmail(who.email).then((company) => {
+      expect(company.status).to.eq("pending");
+      expect(company.onboarding_completed).to.eq(true);
+      expect(company.nationality).to.eq("ethiopian");
+      expect((company.attributes ?? {})["cooperative"]).to.eq(true);
+      expect((company.attributes ?? {})["investorLicence"]).to.be.undefined;
+      expect(company.licence_number, "no eTrade licence").to.be.null;
+    });
+  });
+
+  it("the backoffice flags it as a co-operative", () => {
+    cy.loginBackoffice("chief@edr.local");
+
+    latestJourney("coop").then((company) => {
+      openCustomer(company.name);
+
+      cy.contains("Manual entry · co-operative").should("be.visible");
+      cy.contains("Registration entered by hand — not verified against eTrade")
+        .should("be.visible");
+      cy.contains(
+        "Check them against the Co-operative Registration Certificate",
+      ).should("be.visible");
+      cy.contains("Co-operative union / farm (no trade licence)").should(
+        "be.visible",
+      );
+      // The two manual routes must not be confused with one another.
+      cy.contains("Manual entry · investment licence").should("not.exist");
+    });
+  });
+});
+
+export {};
diff --git a/e2e/freight/cypress/e2e/flows/onboarding_ethiopian.cy.ts b/e2e/freight/cypress/e2e/flows/onboarding_ethiopian.cy.ts
new file mode 100644
index 000000000..e6f08cc95
--- /dev/null
+++ b/e2e/freight/cypress/e2e/flows/onboarding_ethiopian.cy.ts
@@ -0,0 +1,180 @@
+/**
+ * The ordinary onboarding journey, both apps — the baseline every other
+ * onboarding spec is a deviation from:
+ *
+ *   1. portal      signup + OTP → nationality/role → company (eTrade lookup) →
+ *                  owner → representation (Fayda) → contact → documents →
+ *                  "Submit for review"
+ *   2. backoffice  staff approve the importer profile; the customer carries NO
+ *                  manual-entry flag, because eTrade answered for its TIN
+ *   3. portal      the approved customer reaches the contract wizard
+ *
+ * Sequential steps of ONE journey, so retries are off — a mid-journey retry
+ * would replay a non-idempotent step against already-advanced state. Switching
+ * origin between tests (portal ↔ backoffice) re-evaluates the spec bundle and
+ * wipes module state, so the later tests resolve the journey from the DB.
+ */
+
+import { completeFaydaVerification } from "./import-utils";
+import {
+  attachNextFile,
+  companyByEmail,
+  etradeTin,
+  expectProfileActive,
+  fill,
+  fillAria,
+  fillPhone,
+  latestJourney,
+  noLicenceTin,
+  openCustomer,
+  approveFirstProfile,
+  signupCustomer,
+  signupIdentity,
+  vatNumber,
+  wizardClick,
+  SIGNUP_PASSWORD,
+} from "./onboarding-utils";
+
+const stamp = Date.now();
+const who = signupIdentity("ethiopian", stamp);
+
+describe("onboarding — Ethiopian company, eTrade verified", { retries: 0 }, () => {
+  it("completes the wizard and submits for review", () => {
+    signupCustomer(who, "Ethiopian");
+
+    cy.contains("button", "Ethiopian Company").click();
+    // An Ethiopian company is never offered the investment licence — that is a
+    // foreign company's document, and the API refuses the pair.
+    cy.contains("We operate on a foreign investment licence").should("not.exist");
+    cy.contains("button", "Importer").click();
+    wizardClick("Continue");
+
+    // ── Company step ────────────────────────────────────────────────────
+    cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
+      "be.visible",
+    );
+
+    // A TIN eTrade knows but which holds no trade licence is a dead end for an
+    // ordinary company: the alert is red, and Continue must refuse rather than
+    // carry unverified registration data forward.
+    fillAria('[aria-label^="TIN Number"]', noLicenceTin(stamp));
+    cy.contains("No matching business record", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    wizardClick("Continue");
+    cy.contains("We need to confirm your TIN with eTrade before continuing.").should(
+      "be.visible",
+    );
+
+    // The real one. A successful lookup fills and locks company name, region,
+    // zone, woreda, kebele and house number (ETradeCompanyCard).
+    fillAria('[aria-label^="TIN Number"]', etradeTin(stamp));
+    cy.contains("Verified with eTrade", { timeout: 20000 }).should("be.visible");
+    // handleETradeDataLoaded sets a dozen fields in sequence — each a render.
+    // Typing into VAT immediately races one of those and detaches mid-type.
+    cy.wait(500);
+    fillAria('[aria-label="VAT Number"]', vatNumber(stamp));
+    wizardClick("Continue");
+
+    // ── Owner step ──────────────────────────────────────────────────────
+    // Name and phone came from the licence and are read-only; eTrade carries
+    // no email, so that one is asked for.
+    cy.contains("Company Owner", { timeout: 20000 }).should("be.visible");
+    fill(/^Owner's Email/, `owner.${stamp}@example.com`);
+    wizardClick("Continue");
+
+    // ── Representation step ─────────────────────────────────────────────
+    cy.contains("Does anyone hold power of attorney for this company?", {
+      timeout: 20000,
+    }).should("be.visible");
+    cy.contains("button", "No, the owner acts for us").click();
+
+    // An Ethiopian company has no passport alternative — Fayda or nothing.
+    cy.contains("Use a passport instead").should("not.exist");
+    // A real eSignet redirect + SMS OTP can't run in e2e, so complete it
+    // against fayda-mock-e2e via the API. The step already fetched `identity`
+    // when it mounted, and completing out-of-band skips the redirect that
+    // would remount everything — reload to force a fresh fetch. Wizard
+    // progress is server-side, so nothing already answered is lost.
+    completeFaydaVerification("owner");
+    cy.reload();
+
+    cy.get(".mantine-Modal-content", { timeout: 30000 }).within(() => {
+      cy.contains("Fayda verified").should("be.visible");
+      // The mock's own payload — proof it travelled Fayda → API → UI rather
+      // than a flag simply flipping.
+      cy.contains("Abebe Bekele").should("be.visible");
+    });
+
+    // The verified sub is what locks the owner's fields server-side.
+    companyByEmail(who.email).then((company) => {
+      expect(
+        (company.attributes ?? {})["ownerFaydaSub"],
+        "owner Fayda sub",
+      ).to.eq("e2e-fayda-sub-0001");
+    });
+    wizardClick("Continue");
+
+    // ── Contact step ────────────────────────────────────────────────────
+    cy.contains("Contact Person", { timeout: 20000 }).should("be.visible");
+    fill(/^Name$/, "Contact Person");
+    fillPhone(0, "911234569");
+    wizardClick("Continue");
+
+    // ── Documents step ──────────────────────────────────────────────────
+    // One company document is seeded per set on a fresh e2e database
+    // (FileUploadSettingsSeeder gives a new set exactly its first field), and
+    // every operational profile owes a business licence.
+    cy.contains("Upload Importer Business license file(s)", {
+      timeout: 20000,
+    }).should("be.visible");
+    attachNextFile();
+    attachNextFile();
+    wizardClick("Submit for review");
+
+    cy.contains("You're all set", { timeout: 30000 }).should("be.visible");
+
+    companyByEmail(who.email).then((company) => {
+      expect(company.status).to.eq("pending");
+      expect(company.onboarding_completed).to.eq(true);
+      expect(company.nationality).to.eq("ethiopian");
+      // eTrade answered, so neither manual-entry flag is set and the licence
+      // it returned is on file.
+      const attributes = company.attributes ?? {};
+      expect(attributes["investorLicence"]).to.be.undefined;
+      expect(attributes["cooperative"]).to.be.undefined;
+      expect(company.licence_number, "eTrade licence").to.eq("LIC-E2E-0001");
+    });
+  });
+
+  it("backoffice approves it, with no manual-entry flag anywhere", () => {
+    cy.loginBackoffice("chief@edr.local");
+
+    latestJourney("ethiopian").then((company) => {
+      openCustomer(company.name);
+
+      // The badge and banner belong to companies whose registration was typed.
+      // This one's came from eTrade, so neither may appear.
+      cy.contains("Manual entry").should("not.exist");
+      cy.contains("Registration entered by hand").should("not.exist");
+      cy.contains("eTrade trade licence").should("be.visible");
+
+      approveFirstProfile();
+      expectProfileActive(company.name);
+    });
+  });
+
+  it("the approved customer reaches the contract wizard", () => {
+    latestJourney("ethiopian").then((company) => {
+      cy.loginPortal(company.email, SIGNUP_PASSWORD);
+    });
+    cy.visitPortal("/contracts/new");
+
+    cy.contains("label", "Operation Type", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    cy.contains("Awaiting Approval").should("not.exist");
+  });
+});
+
+export {};
diff --git a/e2e/freight/cypress/e2e/flows/onboarding_guards.cy.ts b/e2e/freight/cypress/e2e/flows/onboarding_guards.cy.ts
new file mode 100644
index 000000000..a4f1ab365
--- /dev/null
+++ b/e2e/freight/cypress/e2e/flows/onboarding_guards.cy.ts
@@ -0,0 +1,171 @@
+/**
+ * The states onboarding must refuse, and the one it must undo.
+ *
+ * Two halves. The API guards are cheap `cy.request` checks against the seeded
+ * demo customer — combinations the portal never offers, which is exactly why
+ * they have to be refused server-side rather than merely hidden. The second
+ * half is the expensive one and the reason this spec exists at all: going back
+ * in the wizard and un-ticking the investment licence has to cost what the
+ * settings switch costs, or a company finishes onboarding on registration data
+ * nobody verified, with no flag left to say so.
+ */
+
+import {
+  apiRequest,
+  companyByEmail,
+  fillAria,
+  portalToken,
+  signupCustomer,
+  signupIdentity,
+  typeRegistration,
+  noLicenceTin,
+  vatNumber,
+  wizardClick,
+} from "./onboarding-utils";
+
+const stamp = Date.now();
+const who = signupIdentity("toggle", stamp);
+
+/** The seeded demo customer: an ordinary company that came through eTrade. */
+const DEMO_CUSTOMER = "user@gmail.com";
+const demoPassword = () => Cypress.env("demoPassword") as string;
+
+describe("onboarding — refused combinations", { retries: 0 }, () => {
+  it("refuses an investment licence for an Ethiopian company", () => {
+    portalToken(DEMO_CUSTOMER, demoPassword()).then((token) =>
+      apiRequest(
+        token,
+        "POST",
+        "/api/companies/onboarding/start",
+        {
+          companyType: "customer",
+          roles: ["importer"],
+          nationality: "ethiopian",
+          investorLicence: true,
+        },
+        false,
+      ).then((res) => {
+        expect(res.status).to.eq(400);
+        expect(JSON.stringify(res.body)).to.contain(
+          "Only a foreign company can onboard on an investment licence",
+        );
+      }),
+    );
+  });
+
+  it("refuses a co-operative that also claims an investment licence", () => {
+    // Ethiopian on purpose: a co-op sent as foreign is refused by the older
+    // co-operative guard, which would pass this test without the new one ever
+    // running. Ethiopian gets past that guard and lands on this one.
+    portalToken(DEMO_CUSTOMER, demoPassword()).then((token) =>
+      apiRequest(
+        token,
+        "POST",
+        "/api/companies/onboarding/start",
+        {
+          companyType: "customer",
+          roles: ["importer"],
+          nationality: "ethiopian",
+          cooperative: true,
+          investorLicence: true,
+        },
+        false,
+      ).then((res) => {
+        expect(res.status).to.eq(400);
+        expect(JSON.stringify(res.body)).to.contain(
+          "it cannot also onboard on a foreign investment licence",
+        );
+      }),
+    );
+  });
+
+  it("refuses to switch a company that never took the route", () => {
+    portalToken(DEMO_CUSTOMER, demoPassword()).then((token) =>
+      apiRequest(
+        token,
+        "POST",
+        "/api/companies/onboarding/revert-to-etrade",
+        undefined,
+        false,
+      ).then((res) => {
+        expect(res.status).to.eq(400);
+        expect(JSON.stringify(res.body)).to.contain(
+          "already registered through eTrade",
+        );
+      }),
+    );
+  });
+});
+
+describe("onboarding — un-ticking the box mid-wizard", { retries: 0 }, () => {
+  it("clears the typed registration and reopens on the company step", () => {
+    signupCustomer(who, "Toggle");
+
+    cy.contains("button", "Foreign Company").click();
+    cy.contains("We operate on a foreign investment licence").click();
+    cy.contains("button", "Importer").click();
+    wizardClick("Continue");
+
+    cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
+      "be.visible",
+    );
+
+    // A TIN eTrade knows but which holds no trade licence — the manual route's
+    // own shape. (A TIN eTrade has never heard of surfaces as an outage rather
+    // than as "nothing on file": the API wraps its 404 as "Failed to fetch",
+    // which ETradeInfo reads as unreachable. Different message, different
+    // test.)
+    fillAria('[aria-label^="TIN Number"]', noLicenceTin(stamp));
+    cy.contains("Nothing on file at eTrade for this TIN", {
+      timeout: 20000,
+    }).should("be.visible");
+    typeRegistration(`E2E Toggle Trading ${stamp}`);
+    fillAria('[aria-label="VAT Number"]', vatNumber(stamp));
+    wizardClick("Continue");
+
+    // The typed registration is now on file.
+    cy.contains("Company Owner", { timeout: 20000 }).should("be.visible");
+    companyByEmail(who.email).then((company) => {
+      expect(company.region, "typed address saved").to.eq("Addis Ababa");
+      expect((company.attributes ?? {})["investorLicence"]).to.eq(true);
+    });
+
+    // Back to the company step, then back again to the nationality phase.
+    wizardClick("Back");
+    cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    wizardClick("Back");
+    // `exist`, not `visible`: the heading scrolls under the modal's sticky
+    // header, and where the dialog happens to be scrolled says nothing about
+    // whether we are back on the nationality phase. The checkbox below is the
+    // thing this test actually needs to reach.
+    cy.contains("Where is your company registered?", { timeout: 20000 }).should(
+      "exist",
+    );
+
+    // Change of mind: this company is an ordinary foreign company after all.
+    cy.contains("We operate on a foreign investment licence").click();
+    wizardClick("Continue");
+
+    // Whatever was typed under the flag is gone, and the resume target is the
+    // company step — not the furthest step reached, which would skip the
+    // eTrade lookup the customer has just opted back into.
+    companyByEmail(who.email).then((company) => {
+      expect((company.attributes ?? {})["investorLicence"]).to.eq(false);
+      expect(company.region, "typed address cleared").to.be.null;
+      expect(company.licence_number).to.be.null;
+      expect(company.etrade_phone).to.be.null;
+      expect(company.onboarding_step).to.eq("company");
+    });
+
+    cy.contains("Confirm your VAT number", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    // No typed-registration block any more: eTrade owns these fields again.
+    cy.contains("Nothing on file at eTrade for this TIN").should("not.exist");
+    cy.contains("Registration details").should("not.exist");
+  });
+});
+
+export {};
diff --git a/e2e/freight/cypress/e2e/flows/onboarding_investor.cy.ts b/e2e/freight/cypress/e2e/flows/onboarding_investor.cy.ts
new file mode 100644
index 000000000..50ae4ce36
--- /dev/null
+++ b/e2e/freight/cypress/e2e/flows/onboarding_investor.cy.ts
@@ -0,0 +1,123 @@
+/**
+ * A foreign company onboarding on an Ethiopian Investment Commission licence.
+ *
+ * The Commission licenses it, not the trade registry, so eTrade holds no
+ * record for its TIN: the registration is typed, the company is flagged
+ * `investorLicence`, and the backoffice is told in as many words that nothing
+ * on the screen was verified against a licence. What does NOT change is the
+ * business licence per operational profile — an investor holds one, unlike a
+ * co-operative — so the documents step still asks for it.
+ *
+ * The wizard itself is driven by `completeInvestorOnboarding`, which carries
+ * the step-by-step assertions (the blue "nothing on file" alert, the absent
+ * eTrade manager, the refusal to continue on an unproven identity) because
+ * they hold for every investor run. What lives here is what is specific to
+ * this journey: the document requirements, the persisted flag, and the
+ * backoffice's treatment of it.
+ *
+ * One journey across both apps; retries off (see onboarding_ethiopian.cy.ts).
+ */
+
+import {
+  apiRequest,
+  approveFirstProfile,
+  companyByEmail,
+  completeInvestorOnboarding,
+  expectProfileActive,
+  latestJourney,
+  portalToken,
+  signupIdentity,
+  SIGNUP_PASSWORD,
+} from "./onboarding-utils";
+
+const stamp = Date.now();
+const who = signupIdentity("investor", stamp);
+
+describe("onboarding — foreign investor, no eTrade record", { retries: 0 }, () => {
+  it("types its registration and submits for review", () => {
+    completeInvestorOnboarding(who, stamp, {
+      // On the documents step, everything attached, nothing submitted yet.
+      beforeSubmit: () => {
+        portalToken(who.email).then((token) =>
+          apiRequest(
+            token,
+            "GET",
+            "/api/companies/onboarding/requirements",
+          ).then((res) => {
+            // The foreign set applies unchanged — it already asks for the
+            // investment licence itself, so no third set exists for this case.
+            expect(res.body.data.documentSettingCode).to.eq(
+              "company_onboarding_documents_foreign",
+            );
+            expect(res.body.data.investorLicence, "investorLicence flag").to.eq(
+              true,
+            );
+            expect(res.body.data.cooperative).to.eq(false);
+            // The one thing this route does NOT share with a co-operative.
+            expect(
+              res.body.data.licenseProfiles,
+              "per-role licence still tracked",
+            ).to.have.length(1);
+          }),
+        );
+      },
+    });
+
+    companyByEmail(who.email).then((company) => {
+      expect(company.status).to.eq("pending");
+      expect(company.onboarding_completed).to.eq(true);
+      expect(company.nationality).to.eq("foreign");
+      expect((company.attributes ?? {})["investorLicence"]).to.eq(true);
+      expect(company.name).to.contain("E2E Investor Holdings");
+      // Typed, not fetched: the address is what the customer entered, and no
+      // licence number exists at all.
+      expect(company.region).to.eq("Addis Ababa");
+      expect(company.licence_number, "no eTrade licence").to.be.null;
+    });
+  });
+
+  it("the backoffice flags the typed registration, then approves", () => {
+    cy.loginBackoffice("chief@edr.local");
+
+    latestJourney("investor").then((company) => {
+      cy.visit("/dashboard/customers");
+      cy.get('input[placeholder*="Search by company"]').type(company.name);
+      cy.contains(company.name, { timeout: 20000 }).should("be.visible");
+
+      // The list is where a reviewer first meets this customer, so the flag
+      // has to be there and not only on the detail page.
+      cy.contains("Manual entry · investment licence").should("be.visible");
+      cy.contains(company.name).click();
+
+      cy.contains("Manual entry · investment licence").should("be.visible");
+      cy.contains(
+        "Registration entered by hand — not verified against eTrade",
+      ).should("be.visible");
+      cy.contains("Check them against the Investment Licence").should(
+        "be.visible",
+      );
+      cy.contains(
+        "Foreign investment licence — typed by the customer, not from eTrade",
+      ).should("be.visible");
+      cy.contains("Manual entry · co-operative").should("not.exist");
+
+      // Flagging is advisory: approval itself is not blocked.
+      approveFirstProfile();
+      expectProfileActive(company.name);
+    });
+  });
+
+  it("the approved investor reaches the contract wizard", () => {
+    latestJourney("investor").then((company) => {
+      cy.loginPortal(company.email, SIGNUP_PASSWORD);
+    });
+    cy.visitPortal("/contracts/new");
+
+    cy.contains("label", "Operation Type", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    cy.contains("Awaiting Approval").should("not.exist");
+  });
+});
+
+export {};
diff --git a/e2e/freight/cypress/e2e/flows/onboarding_switch_back.cy.ts b/e2e/freight/cypress/e2e/flows/onboarding_switch_back.cy.ts
new file mode 100644
index 000000000..e6c903e89
--- /dev/null
+++ b/e2e/freight/cypress/e2e/flows/onboarding_switch_back.cy.ts
@@ -0,0 +1,169 @@
+/**
+ * Giving the investment-licence route back.
+ *
+ * A company that ticked the box by mistake, or that has since been registered
+ * with the trade registry, switches from Settings → Company. It is a
+ * re-application rather than a settings edit, and this spec is about proving
+ * that literally: the typed registration is cleared (nothing on file was ever
+ * checked against a licence), the company returns to pending, onboarding
+ * reopens on the company step — and only after a real eTrade lookup does the
+ * backoffice stop flagging it.
+ *
+ * Each test is one leg of a single journey, in order, retries off. The
+ * portal ↔ backoffice hops re-evaluate the spec bundle, so every leg resolves
+ * the company from the database rather than from module state.
+ */
+
+import {
+  approveFirstProfile,
+  companyByEmail,
+  completeInvestorOnboarding,
+  etradeTin,
+  expectProfileActive,
+  fillAria,
+  latestJourney,
+  openCustomer,
+  signupIdentity,
+  wizardClick,
+  SIGNUP_PASSWORD,
+} from "./onboarding-utils";
+
+const stamp = Date.now();
+const who = signupIdentity("switchback", stamp);
+
+describe("onboarding — switching back to eTrade registration", { retries: 0 }, () => {
+  it("onboards on an investment licence", () => {
+    completeInvestorOnboarding(who, stamp, {
+      companyName: `E2E Switchback Trading ${stamp}`,
+    });
+
+    companyByEmail(who.email).then((company) => {
+      expect((company.attributes ?? {})["investorLicence"]).to.eq(true);
+      expect(company.region, "typed address").to.eq("Addis Ababa");
+    });
+  });
+
+  it("is approved by the backoffice", () => {
+    cy.loginBackoffice("chief@edr.local");
+    latestJourney("switchback").then((company) => {
+      openCustomer(company.name);
+      cy.contains("Manual entry · investment licence").should("be.visible");
+      approveFirstProfile();
+      expectProfileActive(company.name);
+    });
+  });
+
+  it("switches back from settings, which clears the typed registration", () => {
+    latestJourney("switchback").then((company) => {
+      cy.loginPortal(company.email, SIGNUP_PASSWORD);
+    });
+    cy.visitPortal("/settings");
+
+    cy.contains("Registration source", { timeout: 20000 }).should("be.visible");
+    cy.contains("button", "Switch to eTrade registration").click();
+
+    // The confirmation has to state the cost outright — this is the screen
+    // that decides whether the customer knows they are re-applying.
+    cy.contains("Switch to eTrade registration?").should("be.visible");
+    cy.contains("The registration details you typed are cleared").should(
+      "be.visible",
+    );
+    cy.contains("Your company goes back to pending").should("be.visible");
+    cy.contains("button", "Switch and re-apply").click();
+
+    cy.contains("Registration source", { timeout: 20000 }).should("not.exist");
+
+    latestJourney("switchback").then((company) => {
+      expect((company.attributes ?? {})["investorLicence"]).to.be.undefined;
+      expect(company.status).to.eq("pending");
+      expect(company.onboarding_completed).to.eq(false);
+      // The wizard treats a populated registration as a lookup that already
+      // passed, so leaving any of it behind would walk the customer straight
+      // past the eTrade step this switch exists to reach.
+      expect(company.region, "typed address cleared").to.be.null;
+      expect(company.licence_number).to.be.null;
+      expect(company.etrade_phone).to.be.null;
+      expect(company.onboarding_step, "resume target").to.eq("company");
+    });
+  });
+
+  it("re-runs onboarding through eTrade and resubmits", () => {
+    latestJourney("switchback").then((company) => {
+      cy.loginPortal(company.email, SIGNUP_PASSWORD);
+    });
+    cy.visitPortal("/portal");
+
+    // Reopened on the company step — not on the furthest step reached before.
+    cy.contains("Confirm your VAT number", { timeout: 30000 }).should(
+      "be.visible",
+    );
+    // The typed registration section is gone: this is an ordinary company now.
+    cy.contains("Nothing on file at eTrade for this TIN").should("not.exist");
+
+    // Wait for the profile to rehydrate before typing. The company still holds
+    // the TIN it typed under the flag (the switch clears the registration, not
+    // the tax number), and RHF re-seeds the field when the refetch lands — so a
+    // TIN typed into an empty-looking field is silently replaced by the stored
+    // one, and the lookup then runs against the wrong number.
+    cy.get('.mantine-Modal-content [aria-label="VAT Number"]')
+      .should("not.have.value", "");
+    fillAria('[aria-label^="TIN Number"]', etradeTin(stamp));
+    cy.get('.mantine-Modal-content [aria-label^="TIN Number"]').should(
+      "have.value",
+      etradeTin(stamp),
+    );
+    cy.contains("Verified with eTrade", { timeout: 20000 }).should("be.visible");
+    cy.wait(500);
+    wizardClick("Continue");
+
+    // Owner, representation and contact are already satisfied server-side —
+    // the switch keeps everything except the registration — so each step only
+    // needs advancing.
+    cy.contains("Company Owner", { timeout: 20000 }).should("be.visible");
+    wizardClick("Continue");
+    cy.contains("The owner acts for the company", { timeout: 20000 }).should(
+      "be.visible",
+    );
+    wizardClick("Continue");
+    cy.contains("Contact Person", { timeout: 20000 }).should("be.visible");
+    wizardClick("Continue");
+
+    // Documents and the licence were uploaded before the switch and survive
+    // it, so the step is already satisfied.
+    cy.contains("Upload Importer Business license file(s)", {
+      timeout: 20000,
+    }).should("be.visible");
+    wizardClick("Submit for review");
+    cy.contains("You're all set", { timeout: 30000 }).should("be.visible");
+
+    latestJourney("switchback").then((company) => {
+      expect(company.onboarding_completed).to.eq(true);
+      expect((company.attributes ?? {})["investorLicence"]).to.be.undefined;
+      // eTrade answered this time, and its licence is on file.
+      expect(company.licence_number).to.eq("LIC-E2E-0001");
+    });
+  });
+
+  it("the backoffice no longer flags it", () => {
+    cy.loginBackoffice("chief@edr.local");
+    latestJourney("switchback").then((company) => {
+      openCustomer(company.name);
+
+      cy.contains("eTrade trade licence").should("be.visible");
+      cy.contains("Manual entry").should("not.exist");
+      cy.contains("Registration entered by hand").should("not.exist");
+    });
+  });
+
+  it("offers nothing to switch to a customer who came through eTrade", () => {
+    // The seeded demo customer onboarded the ordinary way, so the card must
+    // not be on its settings page at all.
+    cy.loginPortal();
+    cy.visitPortal("/settings");
+
+    cy.contains("Operational Services", { timeout: 20000 }).should("be.visible");
+    cy.contains("Registration source").should("not.exist");
+  });
+});
+
+export {};
diff --git a/e2e/freight/etrade-mock/server.js b/e2e/freight/etrade-mock/server.js
index 95f43ded2..f146637a7 100644
--- a/e2e/freight/etrade-mock/server.js
+++ b/e2e/freight/etrade-mock/server.js
@@ -9,10 +9,30 @@
 // TLS_CERT_PATH/TLS_KEY_PATH before starting this — nothing shaped like a
 // key/cert is committed here.
 //
-// Every TIN resolves to the same canned company — these specs don't care
-// about per-TIN business logic, only that the lookup succeeds so the rest
-// of the company-info form (name, address, manager) auto-fills instead of
-// staying gated behind a "No matching business record" alert.
+// A TIN resolves to the same canned company whatever its digits, EXCEPT for
+// the two failure shapes the onboarding specs need — chosen by the TIN's
+// leading digit so a spec picks its outcome by picking its number, with no
+// per-spec stubbing and no state in this process:
+//
+//   1xxxxxxxxx (default)  registration + one business licence  → "Verified with eTrade"
+//   9xxxxxxxxx            registration, but `Businesses: []`   → the API's resolveCompanyData
+//                                                                returns businessInfo: null,
+//                                                                so /fetch-etrade-info 400s
+//                                                                with "couldn't find a
+//                                                                business license for this
+//                                                                TIN". This is the real
+//                                                                co-operative / foreign-
+//                                                                investor case: the TIN is
+//                                                                registered, the trade
+//                                                                licence is not.
+//   8xxxxxxxxx            404 on the registration lookup       → getCompanyInfoByTin throws,
+//                                                                same 400 to the portal by a
+//                                                                different route (eTrade knows
+//                                                                nothing about this TIN at all).
+//
+// Both failures reach the portal as a 400, which ETradeInfo renders as its
+// `notFound` branch: a red dead end for an ordinary company, and the blue
+// "that's expected" alert for one that types its registration.
 const https = require("node:https");
 const fs = require("node:fs");
 
@@ -25,6 +45,11 @@ const options = {
   ),
 };
 
+/** No trade licence on file for this TIN (a co-operative, a foreign investor). */
+const TIN_WITHOUT_LICENCE = "9";
+/** eTrade holds no registration whatsoever for this TIN. */
+const TIN_UNKNOWN = "8";
+
 function companyInfo(tin) {
   return {
     Tin: tin,
@@ -101,8 +126,21 @@ const server = https.createServer(options, (req, res) => {
     /^\/api\/Registration\/GetRegistrationInfoByTin\/([^/]+)\/en$/,
   );
   if (req.method === "GET" && regMatch) {
+    const tin = regMatch[1];
+
+    if (tin.startsWith(TIN_UNKNOWN)) {
+      res.writeHead(404).end();
+      return;
+    }
+
+    const info = companyInfo(tin);
+    // Registered, but holding no trade licence. The API reads `Businesses`
+    // rather than the HTTP status to decide this, so an empty array is the
+    // honest shape — not an error.
+    if (tin.startsWith(TIN_WITHOUT_LICENCE)) info.Businesses = [];
+
     res.writeHead(200, { "content-type": "application/json" });
-    res.end(JSON.stringify(companyInfo(regMatch[1])));
+    res.end(JSON.stringify(info));
     return;
   }
 
diff --git a/final_migration/edr_dev-freight-portable.sql b/final_migration/edr_dev-freight-portable.sql
new file mode 100644
index 000000000..f78184570
--- /dev/null
+++ b/final_migration/edr_dev-freight-portable.sql
@@ -0,0 +1,12736 @@
+--
+-- PostgreSQL database dump
+--
+
+
+-- Dumped from database version 16.14 (Ubuntu 16.14-0ubuntu0.24.04.1)
+-- Dumped by pg_dump version 17.10
+
+SET statement_timeout = 0;
+SET lock_timeout = 0;
+SET idle_in_transaction_session_timeout = 0;
+SET client_encoding = 'UTF8';
+SET standard_conforming_strings = on;
+SELECT pg_catalog.set_config('search_path', '', false);
+SET check_function_bodies = false;
+SET xmloption = content;
+SET client_min_messages = warning;
+SET row_security = off;
+
+ALTER TABLE IF EXISTS ONLY freight.yard_locations DROP CONSTRAINT IF EXISTS yard_locations_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.yard_facilities DROP CONSTRAINT IF EXISTS yard_facilities_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.yard_distances DROP CONSTRAINT IF EXISTS yard_distances_to_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.yard_distances DROP CONSTRAINT IF EXISTS yard_distances_from_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_zones DROP CONSTRAINT IF EXISTS warehouse_zones_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_yards DROP CONSTRAINT IF EXISTS warehouse_yards_warehouse_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_yard_cargo_types DROP CONSTRAINT IF EXISTS warehouse_yard_cargo_types_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_yard_cargo_types DROP CONSTRAINT IF EXISTS warehouse_yard_cargo_types_cargo_type_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_loadings DROP CONSTRAINT IF EXISTS warehouse_loadings_warehouse_inventory_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inventory DROP CONSTRAINT IF EXISTS warehouse_inventory_zone_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inventory DROP CONSTRAINT IF EXISTS warehouse_inventory_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inventory DROP CONSTRAINT IF EXISTS warehouse_inventory_warehouse_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inventory_movement DROP CONSTRAINT IF EXISTS warehouse_inventory_movement_inventory_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_status_logs DROP CONSTRAINT IF EXISTS wagon_status_logs_wagon_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS wagon_movements_wagon_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS wagon_movements_train_schedule_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS wagon_movements_to_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS wagon_movements_from_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS wagon_movements_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS train_set_wagons_board_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS train_set_wagons_alight_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.train_checkpoint_events DROP CONSTRAINT IF EXISTS train_checkpoint_events_train_schedule_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.support_document_versions DROP CONSTRAINT IF EXISTS support_document_versions_document_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.routes DROP CONSTRAINT IF EXISTS routes_origin_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.routes DROP CONSTRAINT IF EXISTS routes_destination_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.route_milestones DROP CONSTRAINT IF EXISTS route_milestones_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.route_milestones DROP CONSTRAINT IF EXISTS route_milestones_route_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.rate_change_requests DROP CONSTRAINT IF EXISTS rate_change_requests_rate_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.priority_rule_change_requests DROP CONSTRAINT IF EXISTS priority_rule_change_requests_priority_config_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.maintenance_intervals DROP CONSTRAINT IF EXISTS maintenance_intervals_vehicle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.last_mile_vehicle_containers DROP CONSTRAINT IF EXISTS last_mile_vehicle_containers_assignment_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.last_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS last_mile_vehicle_assignments_vehicle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.last_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS last_mile_vehicle_assignments_last_mile_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.gps_devices DROP CONSTRAINT IF EXISTS gps_devices_vehicle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_transfer_requests DROP CONSTRAINT IF EXISTS fk_wtr_wagon_type;
+ALTER TABLE IF EXISTS ONLY freight.wagon_transfer_requests DROP CONSTRAINT IF EXISTS fk_wtr_to_yard;
+ALTER TABLE IF EXISTS ONLY freight.wagon_transfer_requests DROP CONSTRAINT IF EXISTS fk_wtr_from_yard;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS fk_wm_transfer_request;
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS fk_wagons_train_set_wagon;
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS fk_wagons_current_train_schedule;
+ALTER TABLE IF EXISTS ONLY freight.wagon_booking_allocations DROP CONSTRAINT IF EXISTS fk_wagon_booking_allocations_wagon;
+ALTER TABLE IF EXISTS ONLY freight.wagon_booking_allocations DROP CONSTRAINT IF EXISTS fk_wagon_booking_allocations_booking;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_container_items DROP CONSTRAINT IF EXISTS fk_waci_container_type;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_container_items DROP CONSTRAINT IF EXISTS fk_waci_container;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_container_items DROP CONSTRAINT IF EXISTS fk_waci_booking_container;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_container_items DROP CONSTRAINT IF EXISTS fk_waci_allocation;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_bulk_loads DROP CONSTRAINT IF EXISTS fk_wabl_cargo_type;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_bulk_loads DROP CONSTRAINT IF EXISTS fk_wabl_booking;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_bulk_loads DROP CONSTRAINT IF EXISTS fk_wabl_allocation;
+ALTER TABLE IF EXISTS ONLY freight.vehicles DROP CONSTRAINT IF EXISTS fk_vehicles_truck_type;
+ALTER TABLE IF EXISTS ONLY freight.train_sets DROP CONSTRAINT IF EXISTS fk_train_sets_locomotive;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS fk_train_set_wagons_wagon_type;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS fk_train_set_wagons_train_set;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS fk_train_set_wagons_physical_wagon;
+ALTER TABLE IF EXISTS ONLY freight.train_schedules DROP CONSTRAINT IF EXISTS fk_train_schedules_train_set;
+ALTER TABLE IF EXISTS ONLY freight.train_schedules DROP CONSTRAINT IF EXISTS fk_train_schedules_route;
+ALTER TABLE IF EXISTS ONLY freight.train_schedules DROP CONSTRAINT IF EXISTS fk_train_schedules_origin;
+ALTER TABLE IF EXISTS ONLY freight.train_schedules DROP CONSTRAINT IF EXISTS fk_train_schedules_destination;
+ALTER TABLE IF EXISTS ONLY freight.train_schedule_bookings DROP CONSTRAINT IF EXISTS fk_train_schedule_bookings_schedule;
+ALTER TABLE IF EXISTS ONLY freight.train_schedule_bookings DROP CONSTRAINT IF EXISTS fk_train_schedule_bookings_booking;
+ALTER TABLE IF EXISTS ONLY freight.payment_refunds DROP CONSTRAINT IF EXISTS fk_payment_refunds_payment;
+ALTER TABLE IF EXISTS ONLY freight.maintenance_costs DROP CONSTRAINT IF EXISTS fk_maintenance_schedule;
+ALTER TABLE IF EXISTS ONLY freight.invoices DROP CONSTRAINT IF EXISTS fk_invoices_payment;
+ALTER TABLE IF EXISTS ONLY freight.invoices DROP CONSTRAINT IF EXISTS fk_invoices_company_profile;
+ALTER TABLE IF EXISTS ONLY freight.invoices DROP CONSTRAINT IF EXISTS fk_invoices_company;
+ALTER TABLE IF EXISTS ONLY freight.invoice_lines DROP CONSTRAINT IF EXISTS fk_invoice_lines_invoice;
+ALTER TABLE IF EXISTS ONLY freight.fuel_purchases DROP CONSTRAINT IF EXISTS fk_fuel_purchases_vehicle;
+ALTER TABLE IF EXISTS ONLY freight.fuel_consumption DROP CONSTRAINT IF EXISTS fk_fuel_consumption_vehicle;
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS fk_containers_wagon_allocation;
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS fk_containers_booking_container;
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS fk_containers_booking;
+ALTER TABLE IF EXISTS ONLY freight.cargoes DROP CONSTRAINT IF EXISTS fk_cargoes_wagon_allocation;
+ALTER TABLE IF EXISTS ONLY freight.cargoes DROP CONSTRAINT IF EXISTS fk_cargoes_booking;
+ALTER TABLE IF EXISTS ONLY freight.first_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS first_mile_vehicle_assignments_vehicle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.first_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS first_mile_vehicle_assignments_first_mile_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.facility_handling_events DROP CONSTRAINT IF EXISTS facility_handling_events_yard_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.facility_handling_events DROP CONSTRAINT IF EXISTS facility_handling_events_train_schedule_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.facility_handling_events DROP CONSTRAINT IF EXISTS facility_handling_events_inventory_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.facility_handling_events DROP CONSTRAINT IF EXISTS facility_handling_events_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.customer_truck_containers DROP CONSTRAINT IF EXISTS customer_truck_containers_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.customer_truck_containers DROP CONSTRAINT IF EXISTS customer_truck_containers_assignment_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.customer_truck_assignments DROP CONSTRAINT IF EXISTS customer_truck_assignments_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contracts DROP CONSTRAINT IF EXISTS contracts_renewal_of_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_templates DROP CONSTRAINT IF EXISTS contract_templates_cargo_type_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_signatures DROP CONSTRAINT IF EXISTS contract_signatures_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_routes DROP CONSTRAINT IF EXISTS contract_routes_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_review_notes DROP CONSTRAINT IF EXISTS contract_review_notes_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_rate_snapshots DROP CONSTRAINT IF EXISTS contract_rate_snapshots_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_document_revisions DROP CONSTRAINT IF EXISTS contract_document_revisions_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_document_review DROP CONSTRAINT IF EXISTS contract_document_review_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_document_review DROP CONSTRAINT IF EXISTS contract_document_review_clearance_cycle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_clearance_cycles DROP CONSTRAINT IF EXISTS contract_clearance_cycles_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_cargo_scope DROP CONSTRAINT IF EXISTS contract_cargo_scope_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_approval_steps DROP CONSTRAINT IF EXISTS contract_approval_steps_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.compliance_records DROP CONSTRAINT IF EXISTS compliance_records_vehicle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.clearance_milestones DROP CONSTRAINT IF EXISTS clearance_milestones_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.clearance_milestones DROP CONSTRAINT IF EXISTS clearance_milestones_clearance_cycle_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.clearance_milestones DROP CONSTRAINT IF EXISTS clearance_milestones_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.clearance_incidents DROP CONSTRAINT IF EXISTS clearance_incidents_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS bookings_contract_route_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS bookings_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_wagon_cancellations DROP CONSTRAINT IF EXISTS booking_wagon_cancellations_rebooked_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_wagon_cancellations DROP CONSTRAINT IF EXISTS booking_wagon_cancellations_fee_rate_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_wagon_cancellations DROP CONSTRAINT IF EXISTS booking_wagon_cancellations_fee_invoice_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_wagon_cancellations DROP CONSTRAINT IF EXISTS booking_wagon_cancellations_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_review_note DROP CONSTRAINT IF EXISTS booking_review_note_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_handovers DROP CONSTRAINT IF EXISTS booking_handovers_truck_assignment_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_handovers DROP CONSTRAINT IF EXISTS booking_handovers_edr_assignment_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_handovers DROP CONSTRAINT IF EXISTS booking_handovers_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_document_review DROP CONSTRAINT IF EXISTS booking_document_review_contract_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_contract_signatures DROP CONSTRAINT IF EXISTS booking_contract_signatures_signature_file_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_contract_signatures DROP CONSTRAINT IF EXISTS booking_contract_signatures_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_container_units DROP CONSTRAINT IF EXISTS booking_container_units_booking_container_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_batch_offers DROP CONSTRAINT IF EXISTS booking_batch_offers_train_schedule_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_batch_offers DROP CONSTRAINT IF EXISTS booking_batch_offers_booking_id_fkey;
+ALTER TABLE IF EXISTS ONLY freight.work_orders DROP CONSTRAINT IF EXISTS "FK_work_orders_vehicle_id";
+ALTER TABLE IF EXISTS ONLY freight.weight_limit_rules DROP CONSTRAINT IF EXISTS "FK_weight_limit_rules_container_type";
+ALTER TABLE IF EXISTS ONLY freight.warranties DROP CONSTRAINT IF EXISTS "FK_warranties_vehicle_id";
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS "FK_wagons_wagon_type_id";
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS "FK_wagons_train_id";
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS "FK_wagons_current_location_yard_id";
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS "FK_wagon_current_yard";
+ALTER TABLE IF EXISTS ONLY freight.trains DROP CONSTRAINT IF EXISTS "FK_trains_current_yard";
+ALTER TABLE IF EXISTS ONLY freight.train_sets DROP CONSTRAINT IF EXISTS "FK_train_sets_train";
+ALTER TABLE IF EXISTS ONLY freight.train_set_locomotives DROP CONSTRAINT IF EXISTS "FK_train_set_locomotives_train_set";
+ALTER TABLE IF EXISTS ONLY freight.train_set_locomotives DROP CONSTRAINT IF EXISTS "FK_train_set_locomotives_locomotive";
+ALTER TABLE IF EXISTS ONLY freight.train_locomotives DROP CONSTRAINT IF EXISTS "FK_train_locomotives_train";
+ALTER TABLE IF EXISTS ONLY freight.train_locomotives DROP CONSTRAINT IF EXISTS "FK_train_locomotives_locomotive";
+ALTER TABLE IF EXISTS ONLY freight.rates DROP CONSTRAINT IF EXISTS "FK_rates_origin_yard_id";
+ALTER TABLE IF EXISTS ONLY freight.rates DROP CONSTRAINT IF EXISTS "FK_rates_destination_yard_id";
+ALTER TABLE IF EXISTS ONLY freight.rates DROP CONSTRAINT IF EXISTS "FK_rates_cargo_type_id";
+ALTER TABLE IF EXISTS ONLY freight.locomotives DROP CONSTRAINT IF EXISTS "FK_locomotive_current_yard";
+ALTER TABLE IF EXISTS ONLY freight.file_upload_fields DROP CONSTRAINT IF EXISTS "FK_file_upload_fields_setting";
+ALTER TABLE IF EXISTS ONLY freight.dropdown_options DROP CONSTRAINT IF EXISTS "FK_dropdown_options_setting";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_requests DROP CONSTRAINT IF EXISTS "FK_d8e15175ed6471429295e2cd788";
+ALTER TABLE IF EXISTS ONLY freight.container_type_wagon_types DROP CONSTRAINT IF EXISTS "FK_ctwt_wagon_type";
+ALTER TABLE IF EXISTS ONLY freight.container_type_wagon_types DROP CONSTRAINT IF EXISTS "FK_ctwt_container_type";
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS "FK_containers_wagon_id";
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS "FK_containers_container_type_id";
+ALTER TABLE IF EXISTS ONLY freight.cargo_type_wagon_types DROP CONSTRAINT IF EXISTS "FK_cgwt_wagon_type";
+ALTER TABLE IF EXISTS ONLY freight.cargo_type_wagon_types DROP CONSTRAINT IF EXISTS "FK_cgwt_cargo_type";
+ALTER TABLE IF EXISTS ONLY freight.cargoes DROP CONSTRAINT IF EXISTS "FK_cargoes_container_id";
+ALTER TABLE IF EXISTS ONLY freight.cargoes DROP CONSTRAINT IF EXISTS "FK_cargoes_cargo_type_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_cabe80a0c7b9e0144854a4f353d";
+ALTER TABLE IF EXISTS ONLY freight.interchange_document_items DROP CONSTRAINT IF EXISTS "FK_c9fba2c4a1631542a37ad5089d7";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_requests DROP CONSTRAINT IF EXISTS "FK_c845afc4aeaf8f73e38a5b5483d";
+ALTER TABLE IF EXISTS ONLY freight.booking_document_review DROP CONSTRAINT IF EXISTS "FK_c669c986810af3b82cf033a8d79";
+ALTER TABLE IF EXISTS ONLY freight.last_mile DROP CONSTRAINT IF EXISTS "FK_c2d9331fda382ae3e92e6bf913a";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_train_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_shipping_line_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_service_type_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_customer_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_consolidation_partner_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_company_profile_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_company_id";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_bookings_cargo_type_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_rate_snapshot DROP CONSTRAINT IF EXISTS "FK_booking_rate_snapshot_rate_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_rate_snapshot DROP CONSTRAINT IF EXISTS "FK_booking_rate_snapshot_booking_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_container DROP CONSTRAINT IF EXISTS "FK_booking_container_weight_limit_rule_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_container DROP CONSTRAINT IF EXISTS "FK_booking_container_container_type_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_cargo_modifier DROP CONSTRAINT IF EXISTS "FK_booking_cargo_modifier_rate_snapshot_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_cargo_modifier DROP CONSTRAINT IF EXISTS "FK_booking_cargo_modifier_rate_id";
+ALTER TABLE IF EXISTS ONLY freight.booking_cargo_modifier DROP CONSTRAINT IF EXISTS "FK_booking_cargo_modifier_booking_id";
+ALTER TABLE IF EXISTS ONLY freight.ff_clients DROP CONSTRAINT IF EXISTS "FK_af4d6bac2844d39095b2056e978";
+ALTER TABLE IF EXISTS ONLY freight.first_mile DROP CONSTRAINT IF EXISTS "FK_a2ae03360a02c61fdc2e8361ea8";
+ALTER TABLE IF EXISTS ONLY freight.first_mile DROP CONSTRAINT IF EXISTS "FK_a19b54ac3d426df8cc0e313be06";
+ALTER TABLE IF EXISTS ONLY freight.cargo_types DROP CONSTRAINT IF EXISTS "FK_CARGO_TYPES_PARENT_GROUP";
+ALTER TABLE IF EXISTS ONLY freight.booking_requests DROP CONSTRAINT IF EXISTS "FK_9e49de0ed55d84d3f97627040cd";
+ALTER TABLE IF EXISTS ONLY freight.booking_container_allocations DROP CONSTRAINT IF EXISTS "FK_99c89fe4e4c3e3670fdc25ea9a9";
+ALTER TABLE IF EXISTS ONLY freight.booking_container DROP CONSTRAINT IF EXISTS "FK_91946ca51ff65658f487eae1162";
+ALTER TABLE IF EXISTS ONLY freight.first_mile_container_allocations DROP CONSTRAINT IF EXISTS "FK_8bba293eb2fd548433d28d97103";
+ALTER TABLE IF EXISTS ONLY freight.company_revisions DROP CONSTRAINT IF EXISTS "FK_8a17ca32f9e4624e1c55c51f7c7";
+ALTER TABLE IF EXISTS ONLY freight.interchange_document_items DROP CONSTRAINT IF EXISTS "FK_864508e9249279bd3e12dafdd21";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_container_allocations DROP CONSTRAINT IF EXISTS "FK_825ceccffec68ac49c85bd75de0";
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS "FK_6fa72e9c8fdfa587cffd9383470";
+ALTER TABLE IF EXISTS ONLY freight.import_djibouti_operations DROP CONSTRAINT IF EXISTS "FK_6c3e3046300b152a13505bf8ffd";
+ALTER TABLE IF EXISTS ONLY freight.booking_requests DROP CONSTRAINT IF EXISTS "FK_590f6298c3c3ae09d982f96fb9d";
+ALTER TABLE IF EXISTS ONLY freight.booking_container_allocations DROP CONSTRAINT IF EXISTS "FK_4fa907f6cc2cfe181385dcd57c5";
+ALTER TABLE IF EXISTS ONLY freight.warehouses DROP CONSTRAINT IF EXISTS "FK_374ce3a1439d02d5ff97e479921";
+ALTER TABLE IF EXISTS ONLY freight.company_change_request DROP CONSTRAINT IF EXISTS "FK_366962cebba507dd8b0146f7f47";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_requests DROP CONSTRAINT IF EXISTS "FK_32653c7b15225addbafdaa297c1";
+ALTER TABLE IF EXISTS ONLY freight.first_mile_container_allocations DROP CONSTRAINT IF EXISTS "FK_31dfdcea6bf62ec98f2e5428996";
+ALTER TABLE IF EXISTS ONLY freight.company_profiles DROP CONSTRAINT IF EXISTS "FK_30228dd283a0f14486346e1db96";
+ALTER TABLE IF EXISTS ONLY freight.external_profiles DROP CONSTRAINT IF EXISTS "FK_26d2a16e263ab4fe0a4c8e91954";
+ALTER TABLE IF EXISTS ONLY freight.last_mile DROP CONSTRAINT IF EXISTS "FK_173a865c0889b8c5564993c70ff";
+ALTER TABLE IF EXISTS ONLY freight.ff_clients DROP CONSTRAINT IF EXISTS "FK_1101fbe8e745d91b6bd0747b582";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_container_allocations DROP CONSTRAINT IF EXISTS "FK_0bc28c4087bb0c6e435677a6fcb";
+DROP INDEX IF EXISTS freight.ux_vehicles_vin;
+DROP INDEX IF EXISTS freight.ux_truck_types_code;
+DROP INDEX IF EXISTS freight.ux_train_schedules_reference;
+DROP INDEX IF EXISTS freight.ux_invoices_eims_irn;
+DROP INDEX IF EXISTS freight.uq_yard_distances_pair;
+DROP INDEX IF EXISTS freight.uq_support_documents_slug;
+DROP INDEX IF EXISTS freight.uq_support_doc_version;
+DROP INDEX IF EXISTS freight.uq_rcr_one_pending_per_rate;
+DROP INDEX IF EXISTS freight.uq_open_wagon_cancellation_per_booking;
+DROP INDEX IF EXISTS freight.uq_one_active_booking_per_one_time_contract;
+DROP INDEX IF EXISTS freight.uq_interchange_active_schedule_direction;
+DROP INDEX IF EXISTS freight.uq_contract_templates_code;
+DROP INDEX IF EXISTS freight.uq_contract_templates_cargo_customs;
+DROP INDEX IF EXISTS freight.uq_clearance_milestone_cycle;
+DROP INDEX IF EXISTS freight.uq_clearance_milestone_booking;
+DROP INDEX IF EXISTS freight.uq_booking_document_review_doc;
+DROP INDEX IF EXISTS freight.ix_truck_types_is_active;
+DROP INDEX IF EXISTS freight.ix_transit_agents_is_active;
+DROP INDEX IF EXISTS freight.idx_yard_distances_to_yard;
+DROP INDEX IF EXISTS freight.idx_yard_distances_from_yard;
+DROP INDEX IF EXISTS freight.idx_wtr_status_from_yard;
+DROP INDEX IF EXISTS freight.idx_wm_transfer_request;
+DROP INDEX IF EXISTS freight.idx_wm_moved_by;
+DROP INDEX IF EXISTS freight.idx_wir_status;
+DROP INDEX IF EXISTS freight.idx_wir_inventory;
+DROP INDEX IF EXISTS freight.idx_wir_booking;
+DROP INDEX IF EXISTS freight.idx_wfr_type;
+DROP INDEX IF EXISTS freight.idx_wfr_active;
+DROP INDEX IF EXISTS freight.idx_warehouses_type;
+DROP INDEX IF EXISTS freight.idx_warehouses_status;
+DROP INDEX IF EXISTS freight.idx_warehouses_station_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_zones_yard_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_zones_type;
+DROP INDEX IF EXISTS freight.idx_warehouse_zones_status;
+DROP INDEX IF EXISTS freight.idx_warehouse_yards_warehouse_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_yards_type;
+DROP INDEX IF EXISTS freight.idx_warehouse_yards_status;
+DROP INDEX IF EXISTS freight.idx_warehouse_loadings_wagon_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_loadings_train_schedule;
+DROP INDEX IF EXISTS freight.idx_warehouse_loadings_inventory_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_loadings_booking_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_zone_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_yard_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_warehouse_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_status;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_movement_inventory_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_inspection_status;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_grn_number;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_goods_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_container_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_cargo_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_inventory_booking_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_activity_log_warehouse_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_activity_log_inventory_id;
+DROP INDEX IF EXISTS freight.idx_warehouse_activity_log_activity_type;
+DROP INDEX IF EXISTS freight.idx_war_priority;
+DROP INDEX IF EXISTS freight.idx_war_active;
+DROP INDEX IF EXISTS freight.idx_wagons_train_set_wagon_id;
+DROP INDEX IF EXISTS freight.idx_wagons_current_train_schedule_id;
+DROP INDEX IF EXISTS freight.idx_wagon_status_logs_wagon;
+DROP INDEX IF EXISTS freight.idx_wagon_booking_allocations_booking;
+DROP INDEX IF EXISTS freight.idx_waci_allocation;
+DROP INDEX IF EXISTS freight.idx_wabl_booking;
+DROP INDEX IF EXISTS freight.idx_vehicles_vehicle_type;
+DROP INDEX IF EXISTS freight.idx_vehicles_status;
+DROP INDEX IF EXISTS freight.idx_vehicles_registration_number;
+DROP INDEX IF EXISTS freight.idx_vehicles_plate_number;
+DROP INDEX IF EXISTS freight.idx_vehicles_manufacturer;
+DROP INDEX IF EXISTS freight.idx_user_trade_access_user_id;
+DROP INDEX IF EXISTS freight.idx_train_sets_status;
+DROP INDEX IF EXISTS freight.idx_train_set_wagons_physical_wagon;
+DROP INDEX IF EXISTS freight.idx_train_schedules_window_phase;
+DROP INDEX IF EXISTS freight.idx_train_schedules_train_number;
+DROP INDEX IF EXISTS freight.idx_train_schedules_route_id;
+DROP INDEX IF EXISTS freight.idx_train_schedules_departure_status;
+DROP INDEX IF EXISTS freight.idx_train_schedules_booking_window_status;
+DROP INDEX IF EXISTS freight.idx_train_checkpoint_events_schedule;
+DROP INDEX IF EXISTS freight.idx_support_doc_versions_document;
+DROP INDEX IF EXISTS freight.idx_scheduling_events_train_schedule_id;
+DROP INDEX IF EXISTS freight.idx_routes_origin_yard_id;
+DROP INDEX IF EXISTS freight.idx_routes_destination_yard_id;
+DROP INDEX IF EXISTS freight.idx_route_milestones_yard_id;
+DROP INDEX IF EXISTS freight.idx_route_milestones_route_id;
+DROP INDEX IF EXISTS freight.idx_rcr_status;
+DROP INDEX IF EXISTS freight.idx_priority_configs_type_active;
+DROP INDEX IF EXISTS freight.idx_priority_configs_currency_type;
+DROP INDEX IF EXISTS freight.idx_prcr_status;
+DROP INDEX IF EXISTS freight.idx_payment_webhook_events_merchant_order_id;
+DROP INDEX IF EXISTS freight.idx_maintenance_schedules_vehicle_date;
+DROP INDEX IF EXISTS freight.idx_maintenance_costs_vehicle_date;
+DROP INDEX IF EXISTS freight.idx_locomotives_status;
+DROP INDEX IF EXISTS freight.idx_invoices_status;
+DROP INDEX IF EXISTS freight.idx_invoices_source;
+DROP INDEX IF EXISTS freight.idx_invoices_company_profile;
+DROP INDEX IF EXISTS freight.idx_invoices_company;
+DROP INDEX IF EXISTS freight.idx_invoice_lines_invoice;
+DROP INDEX IF EXISTS freight.idx_interchange_items_document;
+DROP INDEX IF EXISTS freight.idx_interchange_items_booking;
+DROP INDEX IF EXISTS freight.idx_interchange_documents_status;
+DROP INDEX IF EXISTS freight.idx_interchange_documents_schedule;
+DROP INDEX IF EXISTS freight.idx_interchange_documents_direction;
+DROP INDEX IF EXISTS freight.idx_import_djibouti_operations_schedule;
+DROP INDEX IF EXISTS freight.idx_import_customs_risk;
+DROP INDEX IF EXISTS freight.idx_import_customs_booking;
+DROP INDEX IF EXISTS freight.idx_fuel_purchases_vehicle;
+DROP INDEX IF EXISTS freight.idx_fuel_purchases_date;
+DROP INDEX IF EXISTS freight.idx_fuel_consumption_vehicle_month;
+DROP INDEX IF EXISTS freight.idx_files_resource_lookup;
+DROP INDEX IF EXISTS freight.idx_facilities_status;
+DROP INDEX IF EXISTS freight.idx_facilities_code;
+DROP INDEX IF EXISTS freight.idx_empty_returns_status;
+DROP INDEX IF EXISTS freight.idx_empty_returns_container;
+DROP INDEX IF EXISTS freight.idx_empty_returns_booking;
+DROP INDEX IF EXISTS freight.idx_drivers_status;
+DROP INDEX IF EXISTS freight.idx_drivers_phone_number;
+DROP INDEX IF EXISTS freight.idx_drivers_license_number;
+DROP INDEX IF EXISTS freight.idx_drivers_email;
+DROP INDEX IF EXISTS freight.idx_djibouti_incidents_type;
+DROP INDEX IF EXISTS freight.idx_djibouti_incidents_container;
+DROP INDEX IF EXISTS freight.idx_djibouti_incidents_booking;
+DROP INDEX IF EXISTS freight.idx_contracts_valid_until;
+DROP INDEX IF EXISTS freight.idx_contracts_status;
+DROP INDEX IF EXISTS freight.idx_contracts_kind;
+DROP INDEX IF EXISTS freight.idx_contracts_company;
+DROP INDEX IF EXISTS freight.idx_contract_signatures_contract;
+DROP INDEX IF EXISTS freight.idx_contract_routes_contract;
+DROP INDEX IF EXISTS freight.idx_contract_review_notes_contract;
+DROP INDEX IF EXISTS freight.idx_contract_rate_snapshots_contract;
+DROP INDEX IF EXISTS freight.idx_contract_document_revisions_contract;
+DROP INDEX IF EXISTS freight.idx_contract_doc_review_status;
+DROP INDEX IF EXISTS freight.idx_contract_doc_review_contract;
+DROP INDEX IF EXISTS freight.idx_contract_clearance_cycles_contract;
+DROP INDEX IF EXISTS freight.idx_contract_cargo_scope_contract;
+DROP INDEX IF EXISTS freight.idx_contract_approval_steps_contract;
+DROP INDEX IF EXISTS freight.idx_compliance_records_vehicle_id;
+DROP INDEX IF EXISTS freight.idx_compliance_records_type;
+DROP INDEX IF EXISTS freight.idx_compliance_records_expiry_date;
+DROP INDEX IF EXISTS freight.idx_company_revisions_company;
+DROP INDEX IF EXISTS freight.idx_company_change_request_status;
+DROP INDEX IF EXISTS freight.idx_company_change_request_company;
+DROP INDEX IF EXISTS freight.idx_clearance_milestones_region;
+DROP INDEX IF EXISTS freight.idx_clearance_milestones_contract;
+DROP INDEX IF EXISTS freight.idx_clearance_milestones_booking;
+DROP INDEX IF EXISTS freight.idx_clearance_incidents_booking;
+DROP INDEX IF EXISTS freight.idx_bwc_status;
+DROP INDEX IF EXISTS freight.idx_bwc_booking;
+DROP INDEX IF EXISTS freight.idx_bookings_train_schedule_id;
+DROP INDEX IF EXISTS freight.idx_bookings_scheduling_status;
+DROP INDEX IF EXISTS freight.idx_bookings_route_day;
+DROP INDEX IF EXISTS freight.idx_bookings_is_government;
+DROP INDEX IF EXISTS freight.idx_bookings_contract;
+DROP INDEX IF EXISTS freight.idx_bookings_company_profile_id;
+DROP INDEX IF EXISTS freight.idx_bookings_company_id;
+DROP INDEX IF EXISTS freight.idx_bookings_booking_type;
+DROP INDEX IF EXISTS freight.idx_booking_review_note_booking_id;
+DROP INDEX IF EXISTS freight.idx_booking_requests_status;
+DROP INDEX IF EXISTS freight.idx_booking_requests_contract_status;
+DROP INDEX IF EXISTS freight.idx_booking_requests_contract;
+DROP INDEX IF EXISTS freight.idx_booking_document_review_status;
+DROP INDEX IF EXISTS freight.idx_booking_document_review_booking;
+DROP INDEX IF EXISTS freight.idx_booking_contract_signatures_booking_id;
+DROP INDEX IF EXISTS freight.idx_booking_batch_offers_status;
+DROP INDEX IF EXISTS freight.idx_booking_batch_offers_schedule;
+DROP INDEX IF EXISTS freight.idx_booking_batch_offers_booking;
+DROP INDEX IF EXISTS freight.idx_asset_disposals_vehicle_date;
+DROP INDEX IF EXISTS freight.idx_asset_acquisitions_vehicle_date;
+DROP INDEX IF EXISTS freight."UQ_yards_label_active";
+DROP INDEX IF EXISTS freight."UQ_yards_code_active";
+DROP INDEX IF EXISTS freight."UQ_yards_code";
+DROP INDEX IF EXISTS freight."UQ_yard_facility_yard";
+DROP INDEX IF EXISTS freight."UQ_weight_limit_rules_pattern";
+DROP INDEX IF EXISTS freight."UQ_wagons_wagon_number_active";
+DROP INDEX IF EXISTS freight."UQ_trains_train_number";
+DROP INDEX IF EXISTS freight."UQ_trains_import_train_number";
+DROP INDEX IF EXISTS freight."UQ_trains_export_train_number";
+DROP INDEX IF EXISTS freight."UQ_train_set_locomotives_set_loco";
+DROP INDEX IF EXISTS freight."UQ_train_locomotives_train_loco";
+DROP INDEX IF EXISTS freight."UQ_shipping_lines_code";
+DROP INDEX IF EXISTS freight."UQ_rates_pattern";
+DROP INDEX IF EXISTS freight."UQ_priority_rules_code";
+DROP INDEX IF EXISTS freight."UQ_maintenance_intervals_vehicle_type_item";
+DROP INDEX IF EXISTS freight."UQ_locomotives_name_active";
+DROP INDEX IF EXISTS freight."UQ_last_mile_vehicle_container";
+DROP INDEX IF EXISTS freight."UQ_file_upload_settings_code";
+DROP INDEX IF EXISTS freight."UQ_file_upload_fields_setting_file_key";
+DROP INDEX IF EXISTS freight."UQ_dropdown_settings_code";
+DROP INDEX IF EXISTS freight."UQ_dropdown_options_setting_value";
+DROP INDEX IF EXISTS freight."UQ_customer_truck_containers_booking_number";
+DROP INDEX IF EXISTS freight."UQ_booking_handovers_booking_truck";
+DROP INDEX IF EXISTS freight."UQ_booking_handovers_booking_edr_truck";
+DROP INDEX IF EXISTS freight."UQ_DRIVERS_PHONE_ACTIVE";
+DROP INDEX IF EXISTS freight."UQ_DRIVERS_LICENSE_ACTIVE";
+DROP INDEX IF EXISTS freight."UQ_DRIVERS_FAYDA_SUB_ACTIVE";
+DROP INDEX IF EXISTS freight."UQ_DRIVERS_EMAIL_ACTIVE";
+DROP INDEX IF EXISTS freight."IDX_work_orders_vehicle_id_status";
+DROP INDEX IF EXISTS freight."IDX_weight_limit_rules_container_type_id";
+DROP INDEX IF EXISTS freight."IDX_warranties_vehicle_id_expiry_date";
+DROP INDEX IF EXISTS freight."IDX_wagons_train_id";
+DROP INDEX IF EXISTS freight."IDX_wagons_current_location_yard_id";
+DROP INDEX IF EXISTS freight."IDX_wagon_movements_wagon_occurred";
+DROP INDEX IF EXISTS freight."IDX_wagon_movements_schedule";
+DROP INDEX IF EXISTS freight."IDX_wagon_current_yard_id";
+DROP INDEX IF EXISTS freight."IDX_trains_current_yard_id";
+DROP INDEX IF EXISTS freight."IDX_train_sets_train_id";
+DROP INDEX IF EXISTS freight."IDX_swal_train_schedule_id";
+DROP INDEX IF EXISTS freight."IDX_swal_train_id";
+DROP INDEX IF EXISTS freight."IDX_service_types_code";
+DROP INDEX IF EXISTS freight."IDX_routes_status";
+DROP INDEX IF EXISTS freight."IDX_rates_trigger";
+DROP INDEX IF EXISTS freight."IDX_rates_origin_yard_id";
+DROP INDEX IF EXISTS freight."IDX_rates_destination_yard_id";
+DROP INDEX IF EXISTS freight."IDX_priority_rules_is_active";
+DROP INDEX IF EXISTS freight."IDX_parts_category";
+DROP INDEX IF EXISTS freight."IDX_maintenance_intervals_vehicle_type";
+DROP INDEX IF EXISTS freight."IDX_locomotive_current_yard_id";
+DROP INDEX IF EXISTS freight."IDX_last_mile_vehicle_id";
+DROP INDEX IF EXISTS freight."IDX_last_mile_vehicle_containers_assignment";
+DROP INDEX IF EXISTS freight."IDX_last_mile_status";
+DROP INDEX IF EXISTS freight."IDX_last_mile_requests_status";
+DROP INDEX IF EXISTS freight."IDX_last_mile_requests_booking_schedule";
+DROP INDEX IF EXISTS freight."IDX_last_mile_container_allocations_vehicle_id";
+DROP INDEX IF EXISTS freight."IDX_last_mile_container_allocations_last_mile_id";
+DROP INDEX IF EXISTS freight."IDX_last_mile_booking_id";
+DROP INDEX IF EXISTS freight."IDX_freight_files_resource_code";
+DROP INDEX IF EXISTS freight."IDX_freight_files_resource";
+DROP INDEX IF EXISTS freight."IDX_freight_customers_email";
+DROP INDEX IF EXISTS freight."IDX_first_mile_vehicle_id";
+DROP INDEX IF EXISTS freight."IDX_first_mile_status";
+DROP INDEX IF EXISTS freight."IDX_first_mile_container_allocations_vehicle_id";
+DROP INDEX IF EXISTS freight."IDX_first_mile_container_allocations_first_mile_id";
+DROP INDEX IF EXISTS freight."IDX_first_mile_booking_id";
+DROP INDEX IF EXISTS freight."IDX_files_version_history";
+DROP INDEX IF EXISTS freight."IDX_files_open_change_request";
+DROP INDEX IF EXISTS freight."IDX_facility_handling_events_yard";
+DROP INDEX IF EXISTS freight."IDX_facility_handling_events_grn";
+DROP INDEX IF EXISTS freight."IDX_facility_handling_events_booking";
+DROP INDEX IF EXISTS freight."IDX_e669a91069a3aa982b2c99c256";
+DROP INDEX IF EXISTS freight."IDX_dc808839c3d64c763cc7f6ff68";
+DROP INDEX IF EXISTS freight."IDX_customer_truck_departed";
+DROP INDEX IF EXISTS freight."IDX_customer_truck_containers_assignment";
+DROP INDEX IF EXISTS freight."IDX_customer_truck_assignments_booking";
+DROP INDEX IF EXISTS freight."IDX_containers_wagon_id";
+DROP INDEX IF EXISTS freight."IDX_container_types_size_code";
+DROP INDEX IF EXISTS freight."IDX_container_types_is_active";
+DROP INDEX IF EXISTS freight."IDX_companies_kind";
+DROP INDEX IF EXISTS freight."IDX_cargoes_container_id";
+DROP INDEX IF EXISTS freight."IDX_cargo_types_code";
+DROP INDEX IF EXISTS freight."IDX_booking_handovers_booking";
+DROP INDEX IF EXISTS freight."IDX_booking_container_units_grn";
+DROP INDEX IF EXISTS freight."IDX_booking_container_allocations_vehicle_id";
+DROP INDEX IF EXISTS freight."IDX_booking_container_allocations_booking_id";
+DROP INDEX IF EXISTS freight."IDX_booking_cargo_modifier_rate_id";
+DROP INDEX IF EXISTS freight."IDX_b658cd8f6876645a05c0366a56";
+DROP INDEX IF EXISTS freight."IDX_af4d6bac2844d39095b2056e97";
+DROP INDEX IF EXISTS freight."IDX_SUPPORT_MSG_CONV_CREATED";
+DROP INDEX IF EXISTS freight."IDX_SUPPORT_CONV_LASTMSG";
+DROP INDEX IF EXISTS freight."IDX_SUPPORT_CONV_COMPANY";
+DROP INDEX IF EXISTS freight."IDX_SERVICE_TYPES_IS_ACTIVE";
+DROP INDEX IF EXISTS freight."IDX_SERVICE_TYPES_DISPLAY_ORDER";
+DROP INDEX IF EXISTS freight."IDX_NOTIFICATIONS_RECIPIENT_UNREAD";
+DROP INDEX IF EXISTS freight."IDX_NOTIFICATIONS_RECIPIENT_CREATED";
+DROP INDEX IF EXISTS freight."IDX_LM_VEHICLE_ASSIGNMENTS_VEHICLE";
+DROP INDEX IF EXISTS freight."IDX_INCIDENTS_VEHICLE";
+DROP INDEX IF EXISTS freight."IDX_INCIDENTS_DRIVER";
+DROP INDEX IF EXISTS freight."IDX_GPS_POSITIONS_VEHICLE_TIME";
+DROP INDEX IF EXISTS freight."IDX_GPS_POSITIONS_DEVICE_TIME";
+DROP INDEX IF EXISTS freight."IDX_GPS_DEVICES_VEHICLE";
+DROP INDEX IF EXISTS freight."IDX_FM_VEHICLE_ASSIGNMENTS_VEHICLE";
+DROP INDEX IF EXISTS freight."IDX_FLEET_EVENTS_VEHICLE";
+DROP INDEX IF EXISTS freight."IDX_FLEET_EVENTS_DRIVER";
+DROP INDEX IF EXISTS freight."IDX_FILES_RESOURCE_LOOKUP";
+DROP INDEX IF EXISTS freight."IDX_FAYDA_SESSIONS_IAM_USER_ID";
+DROP INDEX IF EXISTS freight."IDX_FAYDA_SESSIONS_EXPIRES_AT";
+DROP INDEX IF EXISTS freight."IDX_CARGO_TYPES_PARENT_GROUP_ID";
+DROP INDEX IF EXISTS freight."IDX_CARGO_TYPES_IS_ACTIVE";
+DROP INDEX IF EXISTS freight."IDX_CARGO_TYPES_DISPLAY_ORDER";
+DROP INDEX IF EXISTS freight."IDX_30228dd283a0f14486346e1db9";
+DROP INDEX IF EXISTS freight."IDX_26d2a16e263ab4fe0a4c8e9195";
+DROP INDEX IF EXISTS freight."IDX_1e57cd6c6afae8f303847f159d";
+DROP INDEX IF EXISTS freight."IDX_1b3738f728d42fc9aca8d4ac19";
+DROP INDEX IF EXISTS freight."IDX_1101fbe8e745d91b6bd0747b58";
+ALTER TABLE IF EXISTS ONLY freight.yard_locations DROP CONSTRAINT IF EXISTS yard_locations_yard_id_key;
+ALTER TABLE IF EXISTS ONLY freight.yard_locations DROP CONSTRAINT IF EXISTS yard_locations_pkey;
+ALTER TABLE IF EXISTS ONLY freight.yard_facilities DROP CONSTRAINT IF EXISTS yard_facilities_pkey;
+ALTER TABLE IF EXISTS ONLY freight.yard_distances DROP CONSTRAINT IF EXISTS yard_distances_pkey;
+ALTER TABLE IF EXISTS ONLY freight.work_orders DROP CONSTRAINT IF EXISTS work_orders_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warranties DROP CONSTRAINT IF EXISTS warranties_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouses DROP CONSTRAINT IF EXISTS warehouses_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouses DROP CONSTRAINT IF EXISTS warehouses_code_key;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_zones DROP CONSTRAINT IF EXISTS warehouse_zones_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_yards DROP CONSTRAINT IF EXISTS warehouse_yards_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_yard_cargo_types DROP CONSTRAINT IF EXISTS warehouse_yard_cargo_types_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_loadings DROP CONSTRAINT IF EXISTS warehouse_loadings_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inventory DROP CONSTRAINT IF EXISTS warehouse_inventory_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inventory_movement DROP CONSTRAINT IF EXISTS warehouse_inventory_movement_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_activity_log DROP CONSTRAINT IF EXISTS warehouse_activity_log_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_accrual_acks DROP CONSTRAINT IF EXISTS warehouse_accrual_acks_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_accrual_acks DROP CONSTRAINT IF EXISTS warehouse_accrual_acks_inventory_id_key;
+ALTER TABLE IF EXISTS ONLY freight.wagons DROP CONSTRAINT IF EXISTS wagons_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_types DROP CONSTRAINT IF EXISTS wagon_types_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_types DROP CONSTRAINT IF EXISTS wagon_types_code_key;
+ALTER TABLE IF EXISTS ONLY freight.wagon_status_logs DROP CONSTRAINT IF EXISTS wagon_status_logs_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_movements DROP CONSTRAINT IF EXISTS wagon_movements_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_booking_allocations DROP CONSTRAINT IF EXISTS wagon_booking_allocations_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_container_items DROP CONSTRAINT IF EXISTS wagon_allocation_container_items_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_bulk_loads DROP CONSTRAINT IF EXISTS wagon_allocation_bulk_loads_wagon_booking_allocation_id_key;
+ALTER TABLE IF EXISTS ONLY freight.wagon_allocation_bulk_loads DROP CONSTRAINT IF EXISTS wagon_allocation_bulk_loads_pkey;
+ALTER TABLE IF EXISTS ONLY freight.vendors DROP CONSTRAINT IF EXISTS vendors_pkey;
+ALTER TABLE IF EXISTS ONLY freight.vehicles DROP CONSTRAINT IF EXISTS vehicles_registration_number_key;
+ALTER TABLE IF EXISTS ONLY freight.vehicles DROP CONSTRAINT IF EXISTS vehicles_plate_number_key;
+ALTER TABLE IF EXISTS ONLY freight.vehicles DROP CONSTRAINT IF EXISTS vehicles_pkey;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_zones DROP CONSTRAINT IF EXISTS uq_warehouse_zones_code;
+ALTER TABLE IF EXISTS ONLY freight.warehouse_yards DROP CONSTRAINT IF EXISTS uq_warehouse_yards_code;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS uq_train_set_wagons_sequence;
+ALTER TABLE IF EXISTS ONLY freight.train_schedule_bookings DROP CONSTRAINT IF EXISTS uq_train_schedule_booking;
+ALTER TABLE IF EXISTS ONLY freight.saved_signatures DROP CONSTRAINT IF EXISTS uq_saved_signatures_user_id;
+ALTER TABLE IF EXISTS ONLY freight.route_milestones DROP CONSTRAINT IF EXISTS uq_route_milestones_route_sequence;
+ALTER TABLE IF EXISTS ONLY freight.payments DROP CONSTRAINT IF EXISTS uq_payments_transaction_id;
+ALTER TABLE IF EXISTS ONLY freight.payments DROP CONSTRAINT IF EXISTS uq_payments_merchant_order_id;
+ALTER TABLE IF EXISTS ONLY freight.payment_webhook_events DROP CONSTRAINT IF EXISTS uq_payment_webhook_events_provider_event;
+ALTER TABLE IF EXISTS ONLY freight.otp_verifications DROP CONSTRAINT IF EXISTS uq_otp_verifications_phone;
+ALTER TABLE IF EXISTS ONLY freight.invoices DROP CONSTRAINT IF EXISTS uq_invoices_invoice_number;
+ALTER TABLE IF EXISTS ONLY freight.fuel_consumption DROP CONSTRAINT IF EXISTS uq_fuel_consumption_vehicle_month;
+ALTER TABLE IF EXISTS ONLY freight.contract_routes DROP CONSTRAINT IF EXISTS uq_contract_route;
+ALTER TABLE IF EXISTS ONLY freight.contract_document_review DROP CONSTRAINT IF EXISTS uq_contract_document_review_doc;
+ALTER TABLE IF EXISTS ONLY freight.contract_cargo_scope DROP CONSTRAINT IF EXISTS uq_contract_container_size;
+ALTER TABLE IF EXISTS ONLY freight.contract_clearance_cycles DROP CONSTRAINT IF EXISTS uq_contract_clearance_cycle;
+ALTER TABLE IF EXISTS ONLY freight.consignments DROP CONSTRAINT IF EXISTS uq_consignments_tracking_number;
+ALTER TABLE IF EXISTS ONLY freight.booking_contract_signatures DROP CONSTRAINT IF EXISTS uq_booking_contract_signatures_role;
+ALTER TABLE IF EXISTS ONLY freight.booking_container_units DROP CONSTRAINT IF EXISTS uq_booking_container_unit_number;
+ALTER TABLE IF EXISTS ONLY freight.truck_types DROP CONSTRAINT IF EXISTS truck_types_pkey;
+ALTER TABLE IF EXISTS ONLY freight.transit_agents DROP CONSTRAINT IF EXISTS transit_agents_pkey;
+ALTER TABLE IF EXISTS ONLY freight.trains DROP CONSTRAINT IF EXISTS trains_pkey;
+ALTER TABLE IF EXISTS ONLY freight.trains DROP CONSTRAINT IF EXISTS trains_code_key;
+ALTER TABLE IF EXISTS ONLY freight.train_sets DROP CONSTRAINT IF EXISTS train_sets_pkey;
+ALTER TABLE IF EXISTS ONLY freight.train_set_wagons DROP CONSTRAINT IF EXISTS train_set_wagons_pkey;
+ALTER TABLE IF EXISTS ONLY freight.train_scheduling_global_rules DROP CONSTRAINT IF EXISTS train_scheduling_global_rules_pkey;
+ALTER TABLE IF EXISTS ONLY freight.train_schedules DROP CONSTRAINT IF EXISTS train_schedules_train_set_id_key;
+ALTER TABLE IF EXISTS ONLY freight.train_schedules DROP CONSTRAINT IF EXISTS train_schedules_pkey;
+ALTER TABLE IF EXISTS ONLY freight.train_schedule_bookings DROP CONSTRAINT IF EXISTS train_schedule_bookings_pkey;
+ALTER TABLE IF EXISTS ONLY freight.train_schedule_bookings DROP CONSTRAINT IF EXISTS train_schedule_bookings_booking_id_key;
+ALTER TABLE IF EXISTS ONLY freight.train_checkpoint_events DROP CONSTRAINT IF EXISTS train_checkpoint_events_pkey;
+ALTER TABLE IF EXISTS ONLY freight.support_messages DROP CONSTRAINT IF EXISTS support_messages_pkey;
+ALTER TABLE IF EXISTS ONLY freight.support_documents DROP CONSTRAINT IF EXISTS support_documents_pkey;
+ALTER TABLE IF EXISTS ONLY freight.support_document_versions DROP CONSTRAINT IF EXISTS support_document_versions_pkey;
+ALTER TABLE IF EXISTS ONLY freight.support_conversations DROP CONSTRAINT IF EXISTS support_conversations_pkey;
+ALTER TABLE IF EXISTS ONLY freight.scheduling_events DROP CONSTRAINT IF EXISTS scheduling_events_pkey;
+ALTER TABLE IF EXISTS ONLY freight.saved_signatures DROP CONSTRAINT IF EXISTS saved_signatures_pkey;
+ALTER TABLE IF EXISTS ONLY freight.routes DROP CONSTRAINT IF EXISTS routes_pkey;
+ALTER TABLE IF EXISTS ONLY freight.route_milestones DROP CONSTRAINT IF EXISTS route_milestones_pkey;
+ALTER TABLE IF EXISTS ONLY freight.rate_change_requests DROP CONSTRAINT IF EXISTS rate_change_requests_pkey;
+ALTER TABLE IF EXISTS ONLY freight.priority_rule_change_requests DROP CONSTRAINT IF EXISTS priority_rule_change_requests_pkey;
+ALTER TABLE IF EXISTS ONLY freight.priority_configs DROP CONSTRAINT IF EXISTS priority_configs_pkey;
+ALTER TABLE IF EXISTS ONLY freight.wagon_transfer_requests DROP CONSTRAINT IF EXISTS pk_wagon_transfer_requests;
+ALTER TABLE IF EXISTS ONLY freight.tracking_events DROP CONSTRAINT IF EXISTS pk_tracking_events;
+ALTER TABLE IF EXISTS ONLY freight.payments DROP CONSTRAINT IF EXISTS pk_payments;
+ALTER TABLE IF EXISTS ONLY freight.payment_webhook_events DROP CONSTRAINT IF EXISTS pk_payment_webhook_events;
+ALTER TABLE IF EXISTS ONLY freight.payment_refunds DROP CONSTRAINT IF EXISTS pk_payment_refunds;
+ALTER TABLE IF EXISTS ONLY freight.otp_verifications DROP CONSTRAINT IF EXISTS pk_otp_verifications;
+ALTER TABLE IF EXISTS ONLY freight.invoices DROP CONSTRAINT IF EXISTS pk_invoices;
+ALTER TABLE IF EXISTS ONLY freight.invoice_lines DROP CONSTRAINT IF EXISTS pk_invoice_lines;
+ALTER TABLE IF EXISTS ONLY freight.fuel_purchases DROP CONSTRAINT IF EXISTS pk_fuel_purchases;
+ALTER TABLE IF EXISTS ONLY freight.fuel_consumption DROP CONSTRAINT IF EXISTS pk_fuel_consumption;
+ALTER TABLE IF EXISTS ONLY freight.consignments DROP CONSTRAINT IF EXISTS pk_consignments;
+ALTER TABLE IF EXISTS ONLY freight.parts DROP CONSTRAINT IF EXISTS parts_pkey;
+ALTER TABLE IF EXISTS ONLY freight.otp_verifications DROP CONSTRAINT IF EXISTS otp_verifications_email_key;
+ALTER TABLE IF EXISTS ONLY freight.notifications DROP CONSTRAINT IF EXISTS notifications_pkey;
+ALTER TABLE IF EXISTS ONLY freight.migrations DROP CONSTRAINT IF EXISTS migrations_pkey;
+ALTER TABLE IF EXISTS ONLY freight.maintenance_schedules DROP CONSTRAINT IF EXISTS maintenance_schedules_pkey;
+ALTER TABLE IF EXISTS ONLY freight.maintenance_intervals DROP CONSTRAINT IF EXISTS maintenance_intervals_pkey;
+ALTER TABLE IF EXISTS ONLY freight.maintenance_costs DROP CONSTRAINT IF EXISTS maintenance_costs_pkey;
+ALTER TABLE IF EXISTS ONLY freight.locomotives DROP CONSTRAINT IF EXISTS locomotives_pkey;
+ALTER TABLE IF EXISTS ONLY freight.locomotives DROP CONSTRAINT IF EXISTS locomotives_code_key;
+ALTER TABLE IF EXISTS ONLY freight.last_mile_vehicle_containers DROP CONSTRAINT IF EXISTS last_mile_vehicle_containers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.last_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS last_mile_vehicle_assignments_pkey;
+ALTER TABLE IF EXISTS ONLY freight.incidents DROP CONSTRAINT IF EXISTS incidents_pkey;
+ALTER TABLE IF EXISTS ONLY freight.gps_positions DROP CONSTRAINT IF EXISTS gps_positions_pkey;
+ALTER TABLE IF EXISTS ONLY freight.gps_devices DROP CONSTRAINT IF EXISTS gps_devices_pkey;
+ALTER TABLE IF EXISTS ONLY freight.gps_devices DROP CONSTRAINT IF EXISTS gps_devices_imei_key;
+ALTER TABLE IF EXISTS ONLY freight.fleet_events DROP CONSTRAINT IF EXISTS fleet_events_pkey;
+ALTER TABLE IF EXISTS ONLY freight.first_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS first_mile_vehicle_assignments_pkey;
+ALTER TABLE IF EXISTS ONLY freight.files DROP CONSTRAINT IF EXISTS files_pkey;
+ALTER TABLE IF EXISTS ONLY freight.file_upload_settings DROP CONSTRAINT IF EXISTS file_upload_settings_pkey;
+ALTER TABLE IF EXISTS ONLY freight.file_upload_fields DROP CONSTRAINT IF EXISTS file_upload_fields_pkey;
+ALTER TABLE IF EXISTS ONLY freight.fayda_verification_sessions DROP CONSTRAINT IF EXISTS fayda_verification_sessions_state_key;
+ALTER TABLE IF EXISTS ONLY freight.fayda_verification_sessions DROP CONSTRAINT IF EXISTS fayda_verification_sessions_pkey;
+ALTER TABLE IF EXISTS ONLY freight.facility_handling_events DROP CONSTRAINT IF EXISTS facility_handling_events_pkey;
+ALTER TABLE IF EXISTS ONLY freight.eims_system_state DROP CONSTRAINT IF EXISTS eims_system_state_system_number_key;
+ALTER TABLE IF EXISTS ONLY freight.eims_system_state DROP CONSTRAINT IF EXISTS eims_system_state_pkey;
+ALTER TABLE IF EXISTS ONLY freight.drivers DROP CONSTRAINT IF EXISTS drivers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.customers DROP CONSTRAINT IF EXISTS customers_tin_number_key;
+ALTER TABLE IF EXISTS ONLY freight.customers DROP CONSTRAINT IF EXISTS customers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.customers DROP CONSTRAINT IF EXISTS customers_fan_number_key;
+ALTER TABLE IF EXISTS ONLY freight.customers DROP CONSTRAINT IF EXISTS customers_email_key;
+ALTER TABLE IF EXISTS ONLY freight.customer_truck_containers DROP CONSTRAINT IF EXISTS customer_truck_containers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.customer_truck_assignments DROP CONSTRAINT IF EXISTS customer_truck_assignments_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contracts DROP CONSTRAINT IF EXISTS contracts_reference_key;
+ALTER TABLE IF EXISTS ONLY freight.contracts DROP CONSTRAINT IF EXISTS contracts_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_templates DROP CONSTRAINT IF EXISTS contract_templates_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_signatures DROP CONSTRAINT IF EXISTS contract_signatures_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_routes DROP CONSTRAINT IF EXISTS contract_routes_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_review_notes DROP CONSTRAINT IF EXISTS contract_review_notes_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_rate_snapshots DROP CONSTRAINT IF EXISTS contract_rate_snapshots_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_document_revisions DROP CONSTRAINT IF EXISTS contract_document_revisions_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_document_review DROP CONSTRAINT IF EXISTS contract_document_review_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_clearance_cycles DROP CONSTRAINT IF EXISTS contract_clearance_cycles_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_cargo_scope DROP CONSTRAINT IF EXISTS contract_cargo_scope_pkey;
+ALTER TABLE IF EXISTS ONLY freight.contract_approval_steps DROP CONSTRAINT IF EXISTS contract_approval_steps_pkey;
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS containers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.containers DROP CONSTRAINT IF EXISTS containers_container_number_key;
+ALTER TABLE IF EXISTS ONLY freight.compliance_records DROP CONSTRAINT IF EXISTS compliance_records_pkey;
+ALTER TABLE IF EXISTS ONLY freight.clearance_milestones DROP CONSTRAINT IF EXISTS clearance_milestones_pkey;
+ALTER TABLE IF EXISTS ONLY freight.clearance_incidents DROP CONSTRAINT IF EXISTS clearance_incidents_pkey;
+ALTER TABLE IF EXISTS ONLY freight.cargoes DROP CONSTRAINT IF EXISTS cargoes_pkey;
+ALTER TABLE IF EXISTS ONLY freight.cargoes DROP CONSTRAINT IF EXISTS cargoes_cargo_reference_key;
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS bookings_reference_key;
+ALTER TABLE IF EXISTS ONLY freight.bookings DROP CONSTRAINT IF EXISTS bookings_pkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_wagon_cancellations DROP CONSTRAINT IF EXISTS booking_wagon_cancellations_pkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_review_note DROP CONSTRAINT IF EXISTS booking_review_note_pkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_handovers DROP CONSTRAINT IF EXISTS booking_handovers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_contract_signatures DROP CONSTRAINT IF EXISTS booking_contract_signatures_pkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_container_units DROP CONSTRAINT IF EXISTS booking_container_units_pkey;
+ALTER TABLE IF EXISTS ONLY freight.booking_batch_offers DROP CONSTRAINT IF EXISTS booking_batch_offers_pkey;
+ALTER TABLE IF EXISTS ONLY freight.asset_disposals DROP CONSTRAINT IF EXISTS asset_disposals_pkey;
+ALTER TABLE IF EXISTS ONLY freight.asset_acquisitions DROP CONSTRAINT IF EXISTS asset_acquisitions_pkey;
+ALTER TABLE IF EXISTS ONLY freight.user_trade_access DROP CONSTRAINT IF EXISTS "UQ_e54889f850f4db112a77b9e8431";
+ALTER TABLE IF EXISTS ONLY freight.facilities DROP CONSTRAINT IF EXISTS "UQ_bf808b325b190fb9049254ba55e";
+ALTER TABLE IF EXISTS ONLY freight.interchange_documents DROP CONSTRAINT IF EXISTS "UQ_b44369ad5b13e0d897487fc4284";
+ALTER TABLE IF EXISTS ONLY freight.approval_rules DROP CONSTRAINT IF EXISTS "UQ_approval_rules_chain_step";
+ALTER TABLE IF EXISTS ONLY freight.import_customs_finalizations DROP CONSTRAINT IF EXISTS "UQ_ad87af234cc0068a05fa7bd2335";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS "UQ_LAST_MILE_VEHICLE";
+ALTER TABLE IF EXISTS ONLY freight.first_mile_vehicle_assignments DROP CONSTRAINT IF EXISTS "UQ_FIRST_MILE_VEHICLE";
+ALTER TABLE IF EXISTS ONLY freight.import_djibouti_operations DROP CONSTRAINT IF EXISTS "UQ_6c3e3046300b152a13505bf8ffd";
+ALTER TABLE IF EXISTS ONLY freight.company_profiles DROP CONSTRAINT IF EXISTS "UQ_539ff8f8225951adb2ef76b0313";
+ALTER TABLE IF EXISTS ONLY freight.ff_clients DROP CONSTRAINT IF EXISTS "UQ_4107fef2abf7128f890ef276244";
+ALTER TABLE IF EXISTS ONLY freight.companies DROP CONSTRAINT IF EXISTS "UQ_1b3738f728d42fc9aca8d4ac19b";
+ALTER TABLE IF EXISTS ONLY freight.train_set_locomotives DROP CONSTRAINT IF EXISTS "PK_train_set_locomotives";
+ALTER TABLE IF EXISTS ONLY freight.train_locomotives DROP CONSTRAINT IF EXISTS "PK_train_locomotives";
+ALTER TABLE IF EXISTS ONLY freight.schedule_wagon_adjustment_logs DROP CONSTRAINT IF EXISTS "PK_schedule_wagon_adjustment_logs";
+ALTER TABLE IF EXISTS ONLY freight.booking_container_allocations DROP CONSTRAINT IF EXISTS "PK_fb0dee3634a65d2ebd734ff46e3";
+ALTER TABLE IF EXISTS ONLY freight.empty_container_returns DROP CONSTRAINT IF EXISTS "PK_f82bda09e0ff411811193579948";
+ALTER TABLE IF EXISTS ONLY freight.import_customs_finalizations DROP CONSTRAINT IF EXISTS "PK_f67c60e65b732153fc050dd166c";
+ALTER TABLE IF EXISTS ONLY freight.external_profiles DROP CONSTRAINT IF EXISTS "PK_f01bade59a434fa68039620ccb9";
+ALTER TABLE IF EXISTS ONLY freight.ff_clients DROP CONSTRAINT IF EXISTS "PK_eb91bf3ee74a361acee369dbda2";
+ALTER TABLE IF EXISTS ONLY freight.dropdown_settings DROP CONSTRAINT IF EXISTS "PK_dropdown_settings";
+ALTER TABLE IF EXISTS ONLY freight.dropdown_options DROP CONSTRAINT IF EXISTS "PK_dropdown_options";
+ALTER TABLE IF EXISTS ONLY freight.cargo_types DROP CONSTRAINT IF EXISTS "PK_db1aa5f07b0c5ea996eaea03394";
+ALTER TABLE IF EXISTS ONLY freight.booking_cargo_modifier DROP CONSTRAINT IF EXISTS "PK_d949ef8f1b862135ad7e4afdbf1";
+ALTER TABLE IF EXISTS ONLY freight.weight_limit_rules DROP CONSTRAINT IF EXISTS "PK_d82c70fa7e878ca301e2aaff709";
+ALTER TABLE IF EXISTS ONLY freight.companies DROP CONSTRAINT IF EXISTS "PK_d4bc3e82a314fa9e29f652c2c22";
+ALTER TABLE IF EXISTS ONLY freight.warehouse_fee_rules DROP CONSTRAINT IF EXISTS "PK_d24f444e0cb6841c1b19342e134";
+ALTER TABLE IF EXISTS ONLY freight.container_type_wagon_types DROP CONSTRAINT IF EXISTS "PK_container_type_wagon_types";
+ALTER TABLE IF EXISTS ONLY freight.djibouti_import_incidents DROP CONSTRAINT IF EXISTS "PK_cf3871f27f8bd0db9176f09bf95";
+ALTER TABLE IF EXISTS ONLY freight.cargo_type_wagon_types DROP CONSTRAINT IF EXISTS "PK_cargo_type_wagon_types";
+ALTER TABLE IF EXISTS ONLY freight.company_revisions DROP CONSTRAINT IF EXISTS "PK_c8ed8b5e0e0d93edffd43c8c024";
+ALTER TABLE IF EXISTS ONLY freight.booking_container DROP CONSTRAINT IF EXISTS "PK_c1805410bccc51530297b2960ef";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_requests DROP CONSTRAINT IF EXISTS "PK_be0bf389a4b0f01b05e5eded98b";
+ALTER TABLE IF EXISTS ONLY freight.last_mile_container_allocations DROP CONSTRAINT IF EXISTS "PK_9d5180799a6dd494156ec980dfb";
+ALTER TABLE IF EXISTS ONLY freight.interchange_documents DROP CONSTRAINT IF EXISTS "PK_95e5a5484c57ecc6f4a2927ddb4";
+ALTER TABLE IF EXISTS ONLY freight.priority_rules DROP CONSTRAINT IF EXISTS "PK_95c73e8a6e80f29d81edf66dbe2";
+ALTER TABLE IF EXISTS ONLY freight.user_trade_access DROP CONSTRAINT IF EXISTS "PK_94e21d7bfb20e57940e3255df87";
+ALTER TABLE IF EXISTS ONLY freight.booking_rate_snapshot DROP CONSTRAINT IF EXISTS "PK_8ca5cf692c4c3e95d91a7343117";
+ALTER TABLE IF EXISTS ONLY freight.last_mile DROP CONSTRAINT IF EXISTS "PK_8be9fbd78fd39e78b6d30ab119b";
+ALTER TABLE IF EXISTS ONLY freight.first_mile_container_allocations DROP CONSTRAINT IF EXISTS "PK_8be4b0df481f8a1555a4fb9d05d";
+ALTER TABLE IF EXISTS ONLY freight.first_mile DROP CONSTRAINT IF EXISTS "PK_72bc92607db5356f03c2aaeb6ec";
+ALTER TABLE IF EXISTS ONLY freight.booking_requests DROP CONSTRAINT IF EXISTS "PK_62c29ee249979fe0bcdcde33dae";
+ALTER TABLE IF EXISTS ONLY freight.warehouse_inspection_reports DROP CONSTRAINT IF EXISTS "PK_625df1e3a62e5aa4c3f14e7172e";
+ALTER TABLE IF EXISTS ONLY freight.container_types DROP CONSTRAINT IF EXISTS "PK_50e6b62fcd07ba58bdb6415d47c";
+ALTER TABLE IF EXISTS ONLY freight.exchange_settings DROP CONSTRAINT IF EXISTS "PK_48f5730ce6881caf75f279d0a5d";
+ALTER TABLE IF EXISTS ONLY freight.booking_document_review DROP CONSTRAINT IF EXISTS "PK_3d7705ea54a01cb4d6db5b743cd";
+ALTER TABLE IF EXISTS ONLY freight.yards DROP CONSTRAINT IF EXISTS "PK_3aa7dacb4c4fb065b1e2f8dfb5a";
+ALTER TABLE IF EXISTS ONLY freight.import_djibouti_operations DROP CONSTRAINT IF EXISTS "PK_3456f58d03f6719b38c70018ab6";
+ALTER TABLE IF EXISTS ONLY freight.shipping_lines DROP CONSTRAINT IF EXISTS "PK_336306f24563d798ec54eedca0c";
+ALTER TABLE IF EXISTS ONLY freight.warehouse_allocation_rules DROP CONSTRAINT IF EXISTS "PK_2e7632f009769d4da579c14f151";
+ALTER TABLE IF EXISTS ONLY freight.facilities DROP CONSTRAINT IF EXISTS "PK_2e6c685b2e1195e6d6394a22bc7";
+ALTER TABLE IF EXISTS ONLY freight.rates DROP CONSTRAINT IF EXISTS "PK_2c804ed4019b80ce48eedba5cec";
+ALTER TABLE IF EXISTS ONLY freight.train_composition_removal_logs DROP CONSTRAINT IF EXISTS "PK_29f7cdb5e0ae32ef1b96155fc9a";
+ALTER TABLE IF EXISTS ONLY freight.service_types DROP CONSTRAINT IF EXISTS "PK_1dc93417a097cdee3491f39d7cc";
+ALTER TABLE IF EXISTS ONLY freight.company_profiles DROP CONSTRAINT IF EXISTS "PK_1980200b310bd1e2ac86aa1ae4a";
+ALTER TABLE IF EXISTS ONLY freight.interchange_document_items DROP CONSTRAINT IF EXISTS "PK_163803862ca83ef98678e39a43b";
+ALTER TABLE IF EXISTS ONLY freight.company_change_request DROP CONSTRAINT IF EXISTS "PK_0a57bba5aaf77b376e7fee5fcf8";
+ALTER TABLE IF EXISTS ONLY freight.approval_rules DROP CONSTRAINT IF EXISTS "PK_048d2ffdf7169337b4cc237d772";
+ALTER TABLE IF EXISTS freight.migrations ALTER COLUMN id DROP DEFAULT;
+DROP TABLE IF EXISTS freight.yards;
+DROP TABLE IF EXISTS freight.yard_locations;
+DROP TABLE IF EXISTS freight.yard_facilities;
+DROP TABLE IF EXISTS freight.yard_distances;
+DROP TABLE IF EXISTS freight.work_orders;
+DROP TABLE IF EXISTS freight.weight_limit_rules;
+DROP TABLE IF EXISTS freight.warranties;
+DROP TABLE IF EXISTS freight.warehouses;
+DROP TABLE IF EXISTS freight.warehouse_zones;
+DROP TABLE IF EXISTS freight.warehouse_yards;
+DROP TABLE IF EXISTS freight.warehouse_yard_cargo_types;
+DROP TABLE IF EXISTS freight.warehouse_loadings;
+DROP TABLE IF EXISTS freight.warehouse_inventory_movement;
+DROP TABLE IF EXISTS freight.warehouse_inventory;
+DROP TABLE IF EXISTS freight.warehouse_inspection_reports;
+DROP TABLE IF EXISTS freight.warehouse_fee_rules;
+DROP TABLE IF EXISTS freight.warehouse_allocation_rules;
+DROP TABLE IF EXISTS freight.warehouse_activity_log;
+DROP TABLE IF EXISTS freight.warehouse_accrual_acks;
+DROP TABLE IF EXISTS freight.wagons;
+DROP TABLE IF EXISTS freight.wagon_types;
+DROP TABLE IF EXISTS freight.wagon_transfer_requests;
+DROP TABLE IF EXISTS freight.wagon_status_logs;
+DROP TABLE IF EXISTS freight.wagon_movements;
+DROP TABLE IF EXISTS freight.wagon_booking_allocations;
+DROP TABLE IF EXISTS freight.wagon_allocation_container_items;
+DROP TABLE IF EXISTS freight.wagon_allocation_bulk_loads;
+DROP TABLE IF EXISTS freight.vendors;
+DROP TABLE IF EXISTS freight.vehicles;
+DROP TABLE IF EXISTS freight.user_trade_access;
+DROP TABLE IF EXISTS freight.truck_types;
+DROP TABLE IF EXISTS freight.transit_agents;
+DROP TABLE IF EXISTS freight.trains;
+DROP TABLE IF EXISTS freight.train_sets;
+DROP TABLE IF EXISTS freight.train_set_wagons;
+DROP TABLE IF EXISTS freight.train_set_locomotives;
+DROP TABLE IF EXISTS freight.train_scheduling_global_rules;
+DROP TABLE IF EXISTS freight.train_schedules;
+DROP TABLE IF EXISTS freight.train_schedule_bookings;
+DROP TABLE IF EXISTS freight.train_locomotives;
+DROP TABLE IF EXISTS freight.train_composition_removal_logs;
+DROP TABLE IF EXISTS freight.train_checkpoint_events;
+DROP TABLE IF EXISTS freight.tracking_events;
+DROP TABLE IF EXISTS freight.support_messages;
+DROP TABLE IF EXISTS freight.support_documents;
+DROP TABLE IF EXISTS freight.support_document_versions;
+DROP TABLE IF EXISTS freight.support_conversations;
+DROP TABLE IF EXISTS freight.shipping_lines;
+DROP TABLE IF EXISTS freight.service_types;
+DROP SEQUENCE IF EXISTS freight.seq_company_profile_tr;
+DROP SEQUENCE IF EXISTS freight.seq_company_profile_im;
+DROP SEQUENCE IF EXISTS freight.seq_company_profile_fwj;
+DROP SEQUENCE IF EXISTS freight.seq_company_profile_ffe;
+DROP SEQUENCE IF EXISTS freight.seq_company_profile_ex;
+DROP TABLE IF EXISTS freight.scheduling_events;
+DROP TABLE IF EXISTS freight.schedule_wagon_adjustment_logs;
+DROP TABLE IF EXISTS freight.saved_signatures;
+DROP TABLE IF EXISTS freight.routes;
+DROP TABLE IF EXISTS freight.route_milestones;
+DROP TABLE IF EXISTS freight.rates;
+DROP TABLE IF EXISTS freight.rate_change_requests;
+DROP TABLE IF EXISTS freight.priority_rules;
+DROP TABLE IF EXISTS freight.priority_rule_change_requests;
+DROP TABLE IF EXISTS freight.priority_configs;
+DROP TABLE IF EXISTS freight.payments;
+DROP TABLE IF EXISTS freight.payment_webhook_events;
+DROP TABLE IF EXISTS freight.payment_refunds;
+DROP TABLE IF EXISTS freight.parts;
+DROP TABLE IF EXISTS freight.otp_verifications;
+DROP TABLE IF EXISTS freight.notifications;
+DROP SEQUENCE IF EXISTS freight.migrations_id_seq;
+DROP TABLE IF EXISTS freight.migrations;
+DROP TABLE IF EXISTS freight.maintenance_schedules;
+DROP TABLE IF EXISTS freight.maintenance_intervals;
+DROP TABLE IF EXISTS freight.maintenance_costs;
+DROP TABLE IF EXISTS freight.locomotives;
+DROP TABLE IF EXISTS freight.last_mile_vehicle_containers;
+DROP TABLE IF EXISTS freight.last_mile_vehicle_assignments;
+DROP TABLE IF EXISTS freight.last_mile_requests;
+DROP TABLE IF EXISTS freight.last_mile_container_allocations;
+DROP TABLE IF EXISTS freight.last_mile;
+DROP TABLE IF EXISTS freight.invoices;
+DROP TABLE IF EXISTS freight.invoice_lines;
+DROP TABLE IF EXISTS freight.interchange_documents;
+DROP TABLE IF EXISTS freight.interchange_document_items;
+DROP TABLE IF EXISTS freight.incidents;
+DROP TABLE IF EXISTS freight.import_djibouti_operations;
+DROP TABLE IF EXISTS freight.import_customs_finalizations;
+DROP TABLE IF EXISTS freight.gps_positions;
+DROP TABLE IF EXISTS freight.gps_devices;
+DROP TABLE IF EXISTS freight.fuel_purchases;
+DROP TABLE IF EXISTS freight.fuel_consumption;
+DROP TABLE IF EXISTS freight.fleet_events;
+DROP TABLE IF EXISTS freight.first_mile_vehicle_assignments;
+DROP TABLE IF EXISTS freight.first_mile_container_allocations;
+DROP TABLE IF EXISTS freight.first_mile;
+DROP TABLE IF EXISTS freight.files;
+DROP TABLE IF EXISTS freight.file_upload_settings;
+DROP TABLE IF EXISTS freight.file_upload_fields;
+DROP TABLE IF EXISTS freight.ff_clients;
+DROP TABLE IF EXISTS freight.fayda_verification_sessions;
+DROP TABLE IF EXISTS freight.facility_handling_events;
+DROP TABLE IF EXISTS freight.facilities;
+DROP TABLE IF EXISTS freight.external_profiles;
+DROP TABLE IF EXISTS freight.exchange_settings;
+DROP TABLE IF EXISTS freight.empty_container_returns;
+DROP TABLE IF EXISTS freight.eims_system_state;
+DROP TABLE IF EXISTS freight.dropdown_settings;
+DROP TABLE IF EXISTS freight.dropdown_options;
+DROP TABLE IF EXISTS freight.drivers;
+DROP TABLE IF EXISTS freight.djibouti_import_incidents;
+DROP TABLE IF EXISTS freight.customers;
+DROP TABLE IF EXISTS freight.customer_truck_containers;
+DROP TABLE IF EXISTS freight.customer_truck_assignments;
+DROP TABLE IF EXISTS freight.contracts;
+DROP TABLE IF EXISTS freight.contract_templates;
+DROP TABLE IF EXISTS freight.contract_signatures;
+DROP TABLE IF EXISTS freight.contract_routes;
+DROP TABLE IF EXISTS freight.contract_review_notes;
+DROP TABLE IF EXISTS freight.contract_rate_snapshots;
+DROP TABLE IF EXISTS freight.contract_document_revisions;
+DROP TABLE IF EXISTS freight.contract_document_review;
+DROP TABLE IF EXISTS freight.contract_clearance_cycles;
+DROP TABLE IF EXISTS freight.contract_cargo_scope;
+DROP TABLE IF EXISTS freight.contract_approval_steps;
+DROP TABLE IF EXISTS freight.containers;
+DROP TABLE IF EXISTS freight.container_types;
+DROP TABLE IF EXISTS freight.container_type_wagon_types;
+DROP TABLE IF EXISTS freight.consignments;
+DROP TABLE IF EXISTS freight.compliance_records;
+DROP TABLE IF EXISTS freight.company_revisions;
+DROP TABLE IF EXISTS freight.company_profiles;
+DROP TABLE IF EXISTS freight.company_change_request;
+DROP TABLE IF EXISTS freight.companies;
+DROP TABLE IF EXISTS freight.clearance_milestones;
+DROP TABLE IF EXISTS freight.clearance_incidents;
+DROP TABLE IF EXISTS freight.cargoes;
+DROP TABLE IF EXISTS freight.cargo_types;
+DROP TABLE IF EXISTS freight.cargo_type_wagon_types;
+DROP TABLE IF EXISTS freight.bookings;
+DROP TABLE IF EXISTS freight.booking_wagon_cancellations;
+DROP TABLE IF EXISTS freight.booking_review_note;
+DROP TABLE IF EXISTS freight.booking_requests;
+DROP TABLE IF EXISTS freight.booking_rate_snapshot;
+DROP TABLE IF EXISTS freight.booking_handovers;
+DROP TABLE IF EXISTS freight.booking_document_review;
+DROP TABLE IF EXISTS freight.booking_contract_signatures;
+DROP TABLE IF EXISTS freight.booking_container_units;
+DROP TABLE IF EXISTS freight.booking_container_allocations;
+DROP TABLE IF EXISTS freight.booking_container;
+DROP TABLE IF EXISTS freight.booking_cargo_modifier;
+DROP TABLE IF EXISTS freight.booking_batch_offers;
+DROP TABLE IF EXISTS freight.asset_disposals;
+DROP TABLE IF EXISTS freight.asset_acquisitions;
+DROP TABLE IF EXISTS freight.approval_rules;
+DROP TYPE IF EXISTS freight.weight_limit_rules_trade_direction_enum;
+DROP TYPE IF EXISTS freight.weight_limit_rules_exceeded_action_enum;
+DROP TYPE IF EXISTS freight.vehicles_status_enum;
+DROP TYPE IF EXISTS freight.train_status;
+DROP TYPE IF EXISTS freight.tracking_events_status_enum;
+DROP TYPE IF EXISTS freight.surcharges_calculation_method_enum;
+DROP TYPE IF EXISTS freight.priority_rules_priority_type_enum;
+DROP TYPE IF EXISTS freight.payments_status_enum;
+DROP TYPE IF EXISTS freight.payments_method_enum;
+DROP TYPE IF EXISTS freight.payments_currency_enum;
+DROP TYPE IF EXISTS freight.payment_webhook_method_enum;
+DROP TYPE IF EXISTS freight.invoices_status_enum;
+DROP TYPE IF EXISTS freight.consignments_status_enum;
+DROP TYPE IF EXISTS freight.consignments_cargo_type_enum;
+DROP SCHEMA IF EXISTS freight;
+--
+-- Name: freight; Type: SCHEMA; Schema: -; Owner: -
+--
+
+CREATE SCHEMA freight;
+
+
+--
+-- Name: consignments_cargo_type_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.consignments_cargo_type_enum AS ENUM (
+    'CONTAINER',
+    'BULK_LIQUID',
+    'BULK_DRY',
+    'GENERAL',
+    'REFRIGERATED',
+    'HAZARDOUS'
+);
+
+
+--
+-- Name: consignments_status_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.consignments_status_enum AS ENUM (
+    'PENDING',
+    'LOADED',
+    'IN_TRANSIT',
+    'AT_DESTINATION',
+    'DELIVERED',
+    'RETURNED'
+);
+
+
+--
+-- Name: invoices_status_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.invoices_status_enum AS ENUM (
+    'DRAFT',
+    'ISSUED',
+    'PENDING',
+    'PAYMENT_PROCESSING',
+    'PARTIALLY_PAID',
+    'PAID',
+    'OVERDUE',
+    'CANCELLED',
+    'REFUNDED',
+    'EXPIRED'
+);
+
+
+--
+-- Name: payment_webhook_method_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.payment_webhook_method_enum AS ENUM (
+    'telebirr',
+    'cbe-birr',
+    'ebirr'
+);
+
+
+--
+-- Name: payments_currency_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.payments_currency_enum AS ENUM (
+    'ETB',
+    'USD'
+);
+
+
+--
+-- Name: payments_method_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.payments_method_enum AS ENUM (
+    'telebirr',
+    'cbe-birr',
+    'ebirr',
+    'waafi',
+    'card',
+    'dmoney',
+    'cac-bank',
+    'cbe-bill'
+);
+
+
+--
+-- Name: payments_status_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.payments_status_enum AS ENUM (
+    'action-required',
+    'processing',
+    'success',
+    'failed',
+    'canceled',
+    'refunded'
+);
+
+
+--
+-- Name: priority_rules_priority_type_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.priority_rules_priority_type_enum AS ENUM (
+    'USD_PAYER',
+    'RAIL_AND_FORWARDING',
+    'GOVERNMENT_ACCOUNT',
+    'HIGH_VOLUME_SHIPMENT'
+);
+
+
+--
+-- Name: surcharges_calculation_method_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.surcharges_calculation_method_enum AS ENUM (
+    'PER_TON',
+    'FLAT_FEE',
+    'PERCENTAGE'
+);
+
+
+--
+-- Name: tracking_events_status_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.tracking_events_status_enum AS ENUM (
+    'PENDING',
+    'LOADED',
+    'IN_TRANSIT',
+    'AT_DESTINATION',
+    'DELIVERED',
+    'RETURNED'
+);
+
+
+--
+-- Name: train_status; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.train_status AS ENUM (
+    'AVAILABLE',
+    'SCHEDULED',
+    'IN_SERVICE',
+    'UNDER_MAINTENANCE',
+    'OUT_OF_SERVICE',
+    'DEACTIVATED'
+);
+
+
+--
+-- Name: vehicles_status_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.vehicles_status_enum AS ENUM (
+    'ACTIVE',
+    'FREE',
+    'BUSY',
+    'MAINTENANCE',
+    'RETIRED',
+    'OUT_OF_SERVICE'
+);
+
+
+--
+-- Name: weight_limit_rules_exceeded_action_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.weight_limit_rules_exceeded_action_enum AS ENUM (
+    'WARNING_ONLY',
+    'HARD_BLOCK'
+);
+
+
+--
+-- Name: weight_limit_rules_trade_direction_enum; Type: TYPE; Schema: freight; Owner: -
+--
+
+CREATE TYPE freight.weight_limit_rules_trade_direction_enum AS ENUM (
+    'IMPORT',
+    'EXPORT',
+    'BOTH',
+    'DOMESTIC'
+);
+
+
+SET default_tablespace = '';
+
+SET default_table_access_method = heap;
+
+--
+-- Name: approval_rules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.approval_rules (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    requires_director_approval boolean NOT NULL,
+    step_order smallint NOT NULL,
+    required_role character varying(64) NOT NULL,
+    action_label character varying(50) NOT NULL,
+    blocks_role character varying(64),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: asset_acquisitions; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.asset_acquisitions (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    vehicle_id uuid,
+    vendor_id uuid,
+    acquisition_type character varying NOT NULL,
+    acquisition_date date NOT NULL,
+    cost numeric(14,2),
+    useful_life_months integer,
+    salvage_value numeric(14,2),
+    lease_start date,
+    lease_end date,
+    monthly_payment numeric(14,2),
+    status character varying DEFAULT 'ACTIVE'::character varying NOT NULL,
+    notes text,
+    item_name character varying(200)
+);
+
+
+--
+-- Name: asset_disposals; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.asset_disposals (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    vehicle_id uuid NOT NULL,
+    disposal_date date NOT NULL,
+    method character varying NOT NULL,
+    sale_price numeric(14,2),
+    buyer character varying,
+    notes text
+);
+
+
+--
+-- Name: booking_batch_offers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_batch_offers (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    offered_wagons integer NOT NULL,
+    total_wagons integer NOT NULL,
+    offered_lines jsonb,
+    offered_weight_tons numeric(12,3) NOT NULL,
+    offered_amount numeric(14,2) NOT NULL,
+    offered_pricing_breakdown jsonb,
+    invoice_id uuid,
+    payment_deadline timestamp with time zone NOT NULL,
+    status character varying(10) DEFAULT 'OFFERED'::character varying NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: booking_cargo_modifier; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_cargo_modifier (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    booking_id uuid NOT NULL,
+    trigger_value numeric(14,4),
+    calculated_amount numeric(14,2) NOT NULL,
+    rate_snapshot_id uuid NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    rate_id uuid NOT NULL
+);
+
+
+--
+-- Name: booking_container; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_container (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    booking_id uuid NOT NULL,
+    container_type_id uuid,
+    quantity smallint NOT NULL,
+    vgm_per_unit_tons numeric(10,3) NOT NULL,
+    total_vgm_tons numeric(12,3) NOT NULL,
+    wagons_required numeric(6,2) NOT NULL,
+    weight_limit_rule_id uuid,
+    is_overweight boolean DEFAULT false NOT NULL,
+    overweight_excess_tons numeric(10,3),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    container_number character varying(64),
+    container_size character varying(10),
+    hazardous_quantity smallint DEFAULT 0,
+    reefer_quantity smallint DEFAULT 0,
+    return_quantity smallint DEFAULT 0 NOT NULL
+);
+
+
+--
+-- Name: booking_container_allocations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_container_allocations (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    container_id uuid NOT NULL,
+    vehicle_id uuid,
+    container_type text NOT NULL,
+    quantity integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: booking_container_units; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_container_units (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_container_id uuid NOT NULL,
+    container_number character varying(64) NOT NULL,
+    seal_number character varying(64),
+    vgm_tons numeric(10,3) NOT NULL,
+    is_hazardous boolean DEFAULT false,
+    is_reefer boolean DEFAULT false,
+    sort_order smallint DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    received_to_port boolean DEFAULT false NOT NULL,
+    received_at timestamp with time zone,
+    grn_number character varying(100),
+    is_return boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: booking_contract_signatures; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_contract_signatures (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    signer_role character varying(20) NOT NULL,
+    signer_user_id uuid,
+    signer_display_name character varying(200) NOT NULL,
+    signed_at timestamp with time zone DEFAULT now() NOT NULL,
+    signature_file_id uuid,
+    consent_text text,
+    ip_address character varying(64),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: booking_document_review; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_document_review (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    setting_code character varying(128) NOT NULL,
+    file_key character varying(128) NOT NULL,
+    file_record_id uuid,
+    status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    note text,
+    reviewed_by_staff_id uuid,
+    reviewed_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    contract_id uuid
+);
+
+
+--
+-- Name: booking_handovers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_handovers (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    truck_assignment_id uuid,
+    truck_plate character varying(32),
+    mile_type character varying(20) NOT NULL,
+    reference character varying(100) NOT NULL,
+    generated_at timestamp with time zone DEFAULT now() NOT NULL,
+    signed_at timestamp with time zone,
+    signed_by_user_id uuid,
+    delivered_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    signer_name character varying(160),
+    edr_assignment_id uuid,
+    signature_image_url text
+);
+
+
+--
+-- Name: booking_rate_snapshot; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_rate_snapshot (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    booking_id uuid NOT NULL,
+    rate_id uuid NOT NULL,
+    rate_type character varying(50) NOT NULL,
+    rate_value numeric(14,4) NOT NULL,
+    rate_unit character varying(30) NOT NULL,
+    currency character varying(5) NOT NULL,
+    snapshotted_at timestamp with time zone NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: booking_requests; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_requests (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    reference character varying(40) DEFAULT ''::character varying NOT NULL,
+    contract_id uuid NOT NULL,
+    requested_by_user_id uuid,
+    contract_route_id uuid,
+    scheduled_date timestamp with time zone,
+    status character varying(16) DEFAULT 'PENDING'::character varying NOT NULL,
+    requested_lines jsonb DEFAULT '{}'::jsonb NOT NULL,
+    notes text,
+    created_booking_id uuid,
+    reviewed_by_staff_id uuid,
+    reviewed_at timestamp with time zone,
+    review_note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    payment_currency character varying(5)
+);
+
+
+--
+-- Name: booking_review_note; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_review_note (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    author_id uuid,
+    note text NOT NULL,
+    type character varying(30) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: booking_wagon_cancellations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.booking_wagon_cancellations (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    rebooked_booking_id uuid,
+    wagons_cancelled numeric(6,2) NOT NULL,
+    weight_tons numeric(12,3) DEFAULT 0 NOT NULL,
+    cancelled_quantities jsonb NOT NULL,
+    credit_amount numeric(14,2) DEFAULT 0 NOT NULL,
+    fee_rate_id uuid,
+    fee_amount numeric(14,2) NOT NULL,
+    fee_currency character varying(8) DEFAULT 'ETB'::character varying NOT NULL,
+    fee_invoice_id uuid,
+    fee_paid_at timestamp with time zone,
+    status character varying(30) DEFAULT 'FEE_PENDING'::character varying NOT NULL,
+    reason text,
+    requested_by_user_id uuid,
+    rebooked_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    CONSTRAINT booking_wagon_cancellations_fee_amount_check CHECK ((fee_amount >= (0)::numeric)),
+    CONSTRAINT booking_wagon_cancellations_wagons_cancelled_check CHECK ((wagons_cancelled > (0)::numeric))
+);
+
+
+--
+-- Name: bookings; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.bookings (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    reference character varying(64) NOT NULL,
+    customer_id uuid,
+    train_id uuid,
+    status character varying(40) DEFAULT 'DRAFT'::character varying NOT NULL,
+    scheduled_date timestamp with time zone DEFAULT now(),
+    total_amount numeric(14,2) DEFAULT 0 NOT NULL,
+    payment_status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    contract_type character varying(20) DEFAULT 'SPOT'::character varying NOT NULL,
+    trade_direction character varying(10) DEFAULT 'IMPORT'::character varying NOT NULL,
+    equipment_return character varying(20) DEFAULT 'RETURN'::character varying NOT NULL,
+    first_mile_pickup_address text,
+    last_mile_delivery_address text,
+    cargo_total_weight_vgm numeric(12,3) DEFAULT 0 NOT NULL,
+    is_hazardous boolean DEFAULT false NOT NULL,
+    payment_currency character varying(5) DEFAULT 'USD'::character varying NOT NULL,
+    start_date date,
+    end_date date,
+    financial_terms text,
+    version_number integer DEFAULT 1 NOT NULL,
+    approved_by_staff_id uuid,
+    approved_by_staff_at timestamp with time zone,
+    signed_by_director_id uuid,
+    signed_by_director_at timestamp with time zone,
+    signed_by_ceo_id uuid,
+    signed_by_ceo_at timestamp with time zone,
+    priority_score integer DEFAULT 0 NOT NULL,
+    consolidation_partner_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    origin_yard_id uuid NOT NULL,
+    destination_yard_id uuid NOT NULL,
+    service_type_id uuid NOT NULL,
+    cargo_type_id uuid,
+    cargo_free_text character varying(200),
+    shipping_line_id uuid,
+    pnr_code character varying(50),
+    customer_signed_at timestamp with time zone,
+    fully_executed_at timestamp with time zone,
+    marketing_approved_by_id uuid,
+    marketing_approved_at timestamp with time zone,
+    contract_summary text,
+    locked_at timestamp with time zone,
+    freight_type character varying(20) NOT NULL,
+    contract_template_key character varying(80),
+    contract_generated_at timestamp with time zone,
+    pricing_breakdown jsonb,
+    company_id uuid NOT NULL,
+    wagons_required numeric(6,2),
+    scheduling_status character varying(30) DEFAULT 'NOT_SCHEDULED'::character varying NOT NULL,
+    hold_started_at timestamp with time zone,
+    hold_expires_at timestamp with time zone,
+    scheduled_at timestamp with time zone,
+    is_government boolean DEFAULT false NOT NULL,
+    government_institution character varying(255),
+    train_schedule_id uuid,
+    payment_deadline timestamp with time zone,
+    selected_for_batch_at timestamp with time zone,
+    company_profile_id uuid NOT NULL,
+    expires_at timestamp with time zone,
+    adjusted_total_amount numeric(14,2),
+    adjusted_by_staff_id uuid,
+    adjusted_at timestamp with time zone,
+    adjustment_reason text,
+    contract_validity_days integer,
+    contract_valid_from timestamp with time zone,
+    contract_valid_until timestamp with time zone,
+    first_mile_pickup_lat numeric(10,7),
+    first_mile_pickup_lng numeric(10,7),
+    last_mile_delivery_lat numeric(10,7),
+    last_mile_delivery_lng numeric(10,7),
+    customs_clearing_enabled boolean DEFAULT false NOT NULL,
+    customs_clearing_agent character varying(200),
+    is_reefer boolean DEFAULT false NOT NULL,
+    estimated_shipment_date timestamp with time zone,
+    contract_id uuid,
+    contract_route_id uuid,
+    created_by_role character varying(20) DEFAULT 'CUSTOMER'::character varying,
+    created_by_user_id uuid,
+    contract_kind character varying(20),
+    gl_station_yard_id uuid,
+    gl_assigned_staff_id uuid,
+    gl_assigned_at timestamp with time zone,
+    bulk_hazardous_quantity numeric(12,3) DEFAULT 0 NOT NULL,
+    bulk_reefer_quantity numeric(12,3) DEFAULT 0 NOT NULL,
+    clearance_current_phase character varying(40),
+    duty_required boolean,
+    vessel_departure_date date,
+    ro_amendment_requested_at timestamp with time zone,
+    ro_hold_reason text,
+    pre_clearance_finalized_at timestamp with time zone,
+    customer_truck_plate_number character varying(32),
+    customer_truck_driver_name character varying(120),
+    customer_truck_type character varying(60),
+    customer_truck_container_number character varying(16),
+    customer_truck_assigned_at timestamp with time zone,
+    customer_truck_arrived_at timestamp with time zone,
+    booking_type character varying(20) DEFAULT 'ONE_TIME'::character varying NOT NULL,
+    loaded_at timestamp with time zone,
+    loaded_by_user_id uuid,
+    arrived_at timestamp with time zone,
+    arrived_by_user_id uuid,
+    consolidation_resume_status character varying(40),
+    is_split boolean DEFAULT false NOT NULL,
+    pre_split_quantities jsonb,
+    double_handling boolean,
+    double_handling_set_at timestamp with time zone,
+    double_handling_set_by character varying(160),
+    vessel_arrival_date date,
+    do_collected_date date,
+    transit_assignee_requested_at timestamp with time zone,
+    transit_assignee_request_note text,
+    transit_assignee_name text,
+    transit_assignee_assigned_at timestamp with time zone,
+    requested_train_schedule_id uuid,
+    payment_reminder_sent_at timestamp with time zone,
+    bulk_total_weight_tons numeric(12,3),
+    export_handover_mode character varying(20),
+    CONSTRAINT chk_bookings_freight_type CHECK (((freight_type)::text = ANY (ARRAY[('CONTAINER'::character varying)::text, ('BULK'::character varying)::text])))
+);
+
+
+--
+-- Name: cargo_type_wagon_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.cargo_type_wagon_types (
+    cargo_type_id uuid NOT NULL,
+    wagon_type_id uuid NOT NULL
+);
+
+
+--
+-- Name: cargo_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.cargo_types (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    cargo_type_name character varying(255) NOT NULL,
+    parent_group_id uuid,
+    requires_director_approval boolean DEFAULT false NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    display_order integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    code character varying(50) NOT NULL,
+    unit_of_measure character varying(16),
+    has_lashing boolean DEFAULT false NOT NULL,
+    items_per_wagon_map jsonb,
+    tons_per_wagon_map jsonb,
+    has_contract_template boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: cargoes; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.cargoes (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    cargo_reference character varying NOT NULL,
+    shipment_id uuid NOT NULL,
+    container_id uuid,
+    cargo_type_id uuid,
+    description text,
+    quantity numeric(12,3) NOT NULL,
+    weight numeric(10,2) NOT NULL,
+    volume numeric(10,2),
+    status character varying DEFAULT 'PENDING'::character varying NOT NULL,
+    loaded_at timestamp without time zone,
+    unloaded_at timestamp without time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    wagon_booking_allocation_id uuid,
+    booking_id uuid,
+    load_type character varying(20),
+    receiver_name character varying,
+    delivered_at timestamp without time zone,
+    delivery_remarks text
+);
+
+
+--
+-- Name: clearance_incidents; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.clearance_incidents (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    incident_type character varying(32) NOT NULL,
+    description text NOT NULL,
+    photo_file_ids jsonb DEFAULT '[]'::jsonb NOT NULL,
+    reported_by_user_id uuid,
+    reported_at timestamp with time zone DEFAULT now() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: clearance_milestones; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.clearance_milestones (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid,
+    contract_id uuid,
+    clearance_cycle_id uuid,
+    milestone_code character varying(64) NOT NULL,
+    milestone_label character varying(255) NOT NULL,
+    status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    owner_region character varying(5),
+    triggered_by_doc boolean DEFAULT false,
+    triggered_at timestamp with time zone,
+    triggered_by_user_id uuid,
+    note text,
+    sort_order smallint DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    metadata jsonb
+);
+
+
+--
+-- Name: companies; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.companies (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    name character varying(200) NOT NULL,
+    type character varying(32) NOT NULL,
+    status character varying(32) DEFAULT 'pending'::character varying NOT NULL,
+    tin character varying(10) NOT NULL,
+    vat_number character varying(50),
+    fan_number character varying(16),
+    country character varying(32) DEFAULT 'Ethiopia'::character varying NOT NULL,
+    address text,
+    phone character varying(20),
+    email character varying(150),
+    website character varying(200),
+    attributes jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    contact_person_name character varying(100),
+    contact_person_phone character varying(20),
+    general_manager_name character varying(100),
+    general_manager_email character varying(150),
+    general_manager_phone character varying(20),
+    nationality character varying(32),
+    licence_number character varying(100),
+    status_description text,
+    date_registered character varying(50),
+    renewed_from character varying(50),
+    renewal_date character varying(50),
+    renewed_to character varying(50),
+    region character varying(100),
+    zone character varying(100),
+    woreda character varying(100),
+    kebele character varying(100),
+    house_no character varying(100),
+    etrade_phone character varying(20),
+    kind character varying(20) DEFAULT 'commercial'::character varying NOT NULL,
+    approved_at timestamp with time zone
+);
+
+
+--
+-- Name: company_change_request; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.company_change_request (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    company_id uuid NOT NULL,
+    snapshot jsonb NOT NULL,
+    documents jsonb,
+    status character varying(20) DEFAULT 'pending'::character varying NOT NULL,
+    note text,
+    submitted_by uuid,
+    submitted_at timestamp with time zone,
+    reviewed_by uuid,
+    reviewed_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: company_profiles; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.company_profiles (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    company_id uuid NOT NULL,
+    type character varying(32) NOT NULL,
+    reference character varying(20),
+    status character varying(32) DEFAULT 'pending'::character varying NOT NULL,
+    business_license character varying(100),
+    attributes jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    business_license_files jsonb,
+    review_note text,
+    reviewed_by uuid,
+    reviewed_at timestamp with time zone
+);
+
+
+--
+-- Name: company_revisions; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.company_revisions (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    company_id uuid NOT NULL,
+    actor_id uuid,
+    summary character varying(255) NOT NULL,
+    changes jsonb DEFAULT '[]'::jsonb NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: compliance_records; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.compliance_records (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    type character varying NOT NULL,
+    document_number character varying,
+    issued_date date,
+    expiry_date date NOT NULL,
+    status character varying DEFAULT 'VALID'::character varying NOT NULL,
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: consignments; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.consignments (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    tracking_number character varying(64) NOT NULL,
+    cargo_type freight.consignments_cargo_type_enum NOT NULL,
+    weight_kg numeric(12,2) NOT NULL,
+    status freight.consignments_status_enum DEFAULT 'PENDING'::freight.consignments_status_enum NOT NULL,
+    origin_station character varying(128) NOT NULL,
+    destination_station character varying(128) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: container_type_wagon_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.container_type_wagon_types (
+    container_type_id uuid NOT NULL,
+    wagon_type_id uuid NOT NULL
+);
+
+
+--
+-- Name: container_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.container_types (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    code character varying(20) NOT NULL,
+    label character varying(100),
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    size_ft smallint,
+    is_reefer boolean DEFAULT false NOT NULL,
+    is_open_top boolean DEFAULT false NOT NULL,
+    display_order integer DEFAULT 1 NOT NULL
+);
+
+
+--
+-- Name: containers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.containers (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    container_number character varying NOT NULL,
+    container_type_id uuid NOT NULL,
+    wagon_id uuid,
+    "position" integer,
+    tare_weight numeric(10,2) NOT NULL,
+    max_gross_weight numeric(10,2) NOT NULL,
+    seal_number character varying,
+    status character varying DEFAULT 'AVAILABLE'::character varying NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    booking_id uuid,
+    wagon_booking_allocation_id uuid,
+    booking_container_id uuid
+);
+
+
+--
+-- Name: contract_approval_steps; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_approval_steps (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    step_order smallint DEFAULT 0 NOT NULL,
+    required_role character varying(64) NOT NULL,
+    blocks_role character varying(64),
+    status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    acted_by_staff_id uuid,
+    acted_at timestamp with time zone,
+    note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: contract_cargo_scope; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_cargo_scope (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    container_size character varying(10),
+    cargo_type_id uuid,
+    cargo_free_text character varying(200),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    quantity_cap numeric(12,2)
+);
+
+
+--
+-- Name: contract_clearance_cycles; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_clearance_cycles (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    cycle_number integer NOT NULL,
+    status character varying(40) DEFAULT 'AWAITING_DOCUMENTS'::character varying NOT NULL,
+    booking_id uuid,
+    started_at timestamp with time zone DEFAULT now() NOT NULL,
+    clearance_ready_at timestamp with time zone,
+    completed_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    duty_required boolean,
+    vessel_departure_date date,
+    ro_amendment_requested_at timestamp with time zone,
+    ro_hold_reason text,
+    current_phase character varying(40),
+    pre_clearance_finalized_at timestamp with time zone,
+    transit_assignee_requested_at timestamp with time zone,
+    transit_assignee_requested_by_user_id uuid,
+    transit_assignee_request_note text,
+    transit_assignee_name text,
+    transit_assignee_assigned_at timestamp with time zone,
+    transit_assignee_assigned_by_user_id uuid,
+    vessel_arrival_date date,
+    do_collected_date date
+);
+
+
+--
+-- Name: contract_document_review; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_document_review (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    clearance_cycle_id uuid,
+    setting_code character varying(128) NOT NULL,
+    file_key character varying(128) NOT NULL,
+    file_record_id uuid,
+    status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    note text,
+    uploaded_by_role character varying(20) DEFAULT 'CUSTOMER'::character varying NOT NULL,
+    reviewed_by_staff_id uuid,
+    reviewed_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: contract_document_revisions; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_document_revisions (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    contract_id uuid NOT NULL,
+    actor_id uuid,
+    actor_role character varying(64),
+    step_id uuid,
+    summary character varying(255),
+    changes jsonb DEFAULT '[]'::jsonb NOT NULL,
+    actor_name character varying(200)
+);
+
+
+--
+-- Name: contract_rate_snapshots; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_rate_snapshots (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    rate_id uuid,
+    rate_code character varying(64) NOT NULL,
+    description character varying(255),
+    unit_price numeric(14,2) NOT NULL,
+    unit_of_measure character varying(32) NOT NULL,
+    currency character varying(5) NOT NULL,
+    container_size character varying(10),
+    is_surcharge boolean DEFAULT false,
+    conditional_on character varying(32),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    is_clearance boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: contract_review_notes; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_review_notes (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    note_type character varying(40) NOT NULL,
+    body text NOT NULL,
+    author_role character varying(20),
+    author_user_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: contract_routes; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_routes (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    origin_yard_id uuid NOT NULL,
+    destination_yard_id uuid NOT NULL,
+    km numeric(10,2),
+    sort_order smallint DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: contract_signatures; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_signatures (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    contract_id uuid NOT NULL,
+    role character varying(20) NOT NULL,
+    signer_display_name character varying(255) NOT NULL,
+    signature_file_id uuid,
+    consent_text text,
+    signed_at timestamp with time zone DEFAULT now() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    stamp_file_id uuid
+);
+
+
+--
+-- Name: contract_templates; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contract_templates (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    code character varying(80) NOT NULL,
+    name character varying(200) NOT NULL,
+    description text,
+    document_title character varying(300) NOT NULL,
+    whereas_clauses jsonb DEFAULT '[]'::jsonb NOT NULL,
+    articles jsonb DEFAULT '[]'::jsonb NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    cargo_type_id uuid,
+    with_customs boolean,
+    is_system boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: contracts; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.contracts (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    reference character varying(64) NOT NULL,
+    company_id uuid,
+    company_profile_id uuid,
+    is_government boolean DEFAULT false NOT NULL,
+    government_institution character varying(255),
+    contract_kind character varying(20) NOT NULL,
+    renewal_of_id uuid,
+    trade_direction character varying(10) NOT NULL,
+    freight_type character varying(20) NOT NULL,
+    service_type_id uuid NOT NULL,
+    payment_currency character varying(5) NOT NULL,
+    customs_clearing_enabled boolean DEFAULT false NOT NULL,
+    customs_clearing_agent character varying(200),
+    equipment_return character varying(20),
+    first_mile_pickup_address text,
+    first_mile_pickup_lat numeric(10,7),
+    first_mile_pickup_lng numeric(10,7),
+    last_mile_delivery_address text,
+    last_mile_delivery_lat numeric(10,7),
+    last_mile_delivery_lng numeric(10,7),
+    is_hazardous boolean DEFAULT false NOT NULL,
+    is_reefer boolean DEFAULT false NOT NULL,
+    estimated_shipment_date timestamp with time zone,
+    contract_validity_days integer,
+    contract_valid_from timestamp with time zone,
+    contract_valid_until timestamp with time zone,
+    expires_at timestamp with time zone,
+    status character varying(40) DEFAULT 'DRAFT'::character varying NOT NULL,
+    clearance_status character varying(40) DEFAULT 'NOT_APPLICABLE'::character varying NOT NULL,
+    clearance_cycle_number integer DEFAULT 0 NOT NULL,
+    pricing_breakdown jsonb,
+    pricing_display_mode character varying(20) DEFAULT 'UNIT_RATES'::character varying,
+    contract_type character varying(20),
+    contract_template_key character varying(128),
+    contract_generated_at timestamp with time zone,
+    contract_summary text,
+    version_number integer DEFAULT 1 NOT NULL,
+    financial_terms jsonb,
+    approved_by_staff_id uuid,
+    approved_by_staff_at timestamp with time zone,
+    signed_by_director_id uuid,
+    signed_by_director_at timestamp with time zone,
+    signed_by_ceo_id uuid,
+    signed_by_ceo_at timestamp with time zone,
+    customer_signed_at timestamp with time zone,
+    fully_executed_at timestamp with time zone,
+    locked_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    document_snapshot jsonb,
+    hazard_class character varying(16),
+    un_number character varying(16),
+    status_before_suspension character varying(40),
+    submitted_at timestamp with time zone
+);
+
+
+--
+-- Name: customer_truck_assignments; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.customer_truck_assignments (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    plate_number character varying(32) NOT NULL,
+    driver_name character varying(120) NOT NULL,
+    truck_type character varying(60) NOT NULL,
+    assigned_at timestamp with time zone DEFAULT now() NOT NULL,
+    arrived_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    gross_weight_kg numeric(14,2),
+    departed_at timestamp with time zone,
+    tare_weight_tons numeric(14,3),
+    net_weight_tons numeric(14,3),
+    planned_tons numeric(14,3),
+    planned_quantity integer
+);
+
+
+--
+-- Name: customer_truck_containers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.customer_truck_containers (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    assignment_id uuid NOT NULL,
+    booking_id uuid NOT NULL,
+    container_number character varying(64) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    loaded_at timestamp with time zone
+);
+
+
+--
+-- Name: customers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.customers (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    user_id uuid NOT NULL,
+    first_name character varying(100) NOT NULL,
+    last_name character varying(100) NOT NULL,
+    email character varying(150) NOT NULL,
+    phone character varying(20) NOT NULL,
+    company_name character varying(200) NOT NULL,
+    company_email character varying(150) NOT NULL,
+    company_phone character varying(20) NOT NULL,
+    company_location character varying(100) NOT NULL,
+    company_address text NOT NULL,
+    customer_type character varying(32),
+    status character varying(32),
+    contact_person_name character varying(100) NOT NULL,
+    contact_person_phone character varying(20) NOT NULL,
+    tin_number character varying(10) NOT NULL,
+    vat_number character varying(50),
+    fan_number character varying(16) NOT NULL,
+    general_manager_name character varying(100) NOT NULL,
+    general_manager_email character varying(150) NOT NULL,
+    general_manager_phone character varying(20) NOT NULL,
+    poa_name character varying(100),
+    poa_phone character varying(20),
+    poa_address text,
+    poa_email character varying(150),
+    poa_location character varying(100),
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: djibouti_import_incidents; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.djibouti_import_incidents (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    booking_id uuid NOT NULL,
+    container_number character varying(80),
+    cargo_id uuid,
+    facility character varying(120),
+    station character varying(120),
+    incident_type character varying(40) NOT NULL,
+    description text NOT NULL,
+    photos jsonb DEFAULT '[]'::jsonb NOT NULL,
+    reported_by character varying(120),
+    reported_at timestamp with time zone NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: drivers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.drivers (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    license_number character varying NOT NULL,
+    first_name character varying NOT NULL,
+    last_name character varying NOT NULL,
+    email character varying NOT NULL,
+    phone_number character varying NOT NULL,
+    date_of_birth date NOT NULL,
+    license_expiry_date date NOT NULL,
+    status character varying DEFAULT 'ACTIVE'::character varying NOT NULL,
+    vehicle_types_authorized character varying[],
+    address text,
+    emergency_contact character varying,
+    notes text,
+    total_trips integer DEFAULT 0,
+    rating numeric(3,2),
+    created_at timestamp without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    updated_at timestamp without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    deleted_at timestamp without time zone,
+    fayda_verified boolean DEFAULT false,
+    fayda_sub character varying,
+    gender character varying
+);
+
+
+--
+-- Name: dropdown_options; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.dropdown_options (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    setting_id uuid NOT NULL,
+    value character varying(256) NOT NULL,
+    label character varying(256) NOT NULL,
+    note text,
+    is_disabled boolean DEFAULT false NOT NULL,
+    display_order integer DEFAULT 0 NOT NULL,
+    meta jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: dropdown_settings; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.dropdown_settings (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    code character varying(128) NOT NULL,
+    label character varying(256) NOT NULL,
+    description text,
+    multiple boolean DEFAULT false NOT NULL,
+    meta jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: eims_system_state; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.eims_system_state (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    system_number character varying(32) NOT NULL,
+    next_invoice_counter bigint DEFAULT 1 NOT NULL,
+    previous_irn character varying(64),
+    in_flight_invoice_id uuid,
+    in_flight_counter bigint,
+    blocked_reason text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    next_document_number bigint DEFAULT 1 NOT NULL,
+    in_flight_document_number bigint
+);
+
+
+--
+-- Name: empty_container_returns; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.empty_container_returns (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    container_number character varying(80) NOT NULL,
+    booking_id uuid,
+    customer_id uuid,
+    return_date timestamp with time zone NOT NULL,
+    facility character varying(120),
+    yard character varying(120),
+    zone character varying(120),
+    condition text,
+    handover_note text,
+    status character varying(40) DEFAULT 'RETURNED'::character varying NOT NULL,
+    wagon_allocation_reference character varying(120),
+    performed_by character varying(120),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    returned_by character varying(20),
+    status_history jsonb DEFAULT '[]'::jsonb NOT NULL
+);
+
+
+--
+-- Name: exchange_settings; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.exchange_settings (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    fallback_rate numeric(18,6) NOT NULL,
+    fallback_source character varying(16) DEFAULT 'AUTO'::character varying NOT NULL,
+    last_synced_at timestamp with time zone,
+    updated_by_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: external_profiles; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.external_profiles (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    user_id uuid NOT NULL,
+    company_id uuid NOT NULL,
+    first_name character varying(100) NOT NULL,
+    last_name character varying(100) NOT NULL,
+    national_id character varying(50),
+    job_title character varying(100),
+    is_primary_contact boolean DEFAULT false NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    onboarding_step character varying(40),
+    onboarding_completed boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: facilities; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.facilities (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    code character varying(40) NOT NULL,
+    name character varying(160) NOT NULL,
+    description text,
+    facility_type character varying(32) NOT NULL,
+    facility_status character varying(32) DEFAULT 'ACTIVE'::character varying NOT NULL,
+    location_name character varying(200),
+    country character varying(100),
+    city character varying(100),
+    address text,
+    latitude numeric(10,8),
+    longitude numeric(11,8),
+    capacity numeric(14,3),
+    is_active boolean DEFAULT true NOT NULL,
+    notes text,
+    created_at timestamp without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    updated_at timestamp without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    deleted_at timestamp without time zone
+);
+
+
+--
+-- Name: facility_handling_events; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.facility_handling_events (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    yard_id uuid NOT NULL,
+    train_schedule_id uuid,
+    event_type character varying(10) NOT NULL,
+    grn_number character varying(60),
+    quantity numeric(14,3),
+    weight_tons numeric(14,3),
+    inventory_id uuid,
+    performed_by character varying(120),
+    occurred_at timestamp with time zone DEFAULT now() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: fayda_verification_sessions; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.fayda_verification_sessions (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    state character varying NOT NULL,
+    code_verifier character varying NOT NULL,
+    purpose character varying DEFAULT 'VERIFY'::character varying NOT NULL,
+    platform character varying DEFAULT 'WEB'::character varying NOT NULL,
+    save_to_account boolean DEFAULT false NOT NULL,
+    status character varying DEFAULT 'PENDING'::character varying NOT NULL,
+    error_code character varying,
+    error_description text,
+    iam_user_id uuid,
+    expires_at timestamp with time zone NOT NULL,
+    completed_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: ff_clients; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.ff_clients (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    forwarder_company_id uuid NOT NULL,
+    client_company_id uuid NOT NULL,
+    relationship_type character varying(32) DEFAULT 'managed_account'::character varying NOT NULL,
+    can_book_on_behalf boolean DEFAULT true NOT NULL,
+    can_view_documents boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: file_upload_fields; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.file_upload_fields (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    setting_id uuid NOT NULL,
+    file_key character varying(128) NOT NULL,
+    file_label character varying(256) NOT NULL,
+    help_text text,
+    is_required boolean DEFAULT false NOT NULL,
+    is_multiple boolean DEFAULT false NOT NULL,
+    max_files integer DEFAULT 1 NOT NULL,
+    allowed_extensions text[] DEFAULT '{}'::text[] NOT NULL,
+    max_size_mb integer DEFAULT 10 NOT NULL,
+    display_order integer DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    phase character varying(40),
+    owner_region character varying(5),
+    trade_direction character varying(10),
+    triggers_milestone_code character varying(64),
+    CONSTRAINT "CHK_file_upload_fields_max_files" CHECK ((max_files > 0)),
+    CONSTRAINT "CHK_file_upload_fields_max_size_mb" CHECK ((max_size_mb > 0))
+);
+
+
+--
+-- Name: file_upload_settings; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.file_upload_settings (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    code character varying(128) NOT NULL,
+    label character varying(256) NOT NULL,
+    description text,
+    entity character varying(32) DEFAULT 'other'::character varying NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: files; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.files (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    resource_id uuid NOT NULL,
+    resource character varying(100) NOT NULL,
+    code character varying(100) NOT NULL,
+    name character varying(500) NOT NULL,
+    url text NOT NULL,
+    size integer NOT NULL,
+    mime_type character varying(255) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    review_status character varying(32),
+    review_note text,
+    reviewed_by uuid,
+    reviewed_at timestamp with time zone,
+    replaced_by_user_id uuid,
+    replace_reason text,
+    title character varying(300),
+    visible_to_customer boolean DEFAULT false NOT NULL,
+    uploaded_by_user_id uuid,
+    uploaded_by_name character varying(200)
+);
+
+
+--
+-- Name: first_mile; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.first_mile (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    status character varying(30) DEFAULT 'PAYMENT_PENDING'::character varying NOT NULL,
+    advanced_payment numeric(14,2) DEFAULT 0 NOT NULL,
+    remaining_payment numeric(14,2) DEFAULT 0 NOT NULL,
+    estimated_km numeric(10,2),
+    exact_km numeric(10,2),
+    vehicle_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    paid boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: first_mile_container_allocations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.first_mile_container_allocations (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    first_mile_id uuid NOT NULL,
+    container_id uuid NOT NULL,
+    vehicle_id uuid,
+    container_type text NOT NULL,
+    quantity integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: first_mile_vehicle_assignments; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.first_mile_vehicle_assignments (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    first_mile_id uuid NOT NULL,
+    vehicle_id uuid NOT NULL,
+    container_number character varying,
+    distance_km numeric(10,2),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    tons numeric(14,3),
+    quantity integer
+);
+
+
+--
+-- Name: fleet_events; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.fleet_events (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    event_type character varying NOT NULL,
+    vehicle_id uuid,
+    driver_id uuid,
+    first_mile_id uuid,
+    last_mile_id uuid,
+    from_value character varying,
+    to_value character varying,
+    label character varying,
+    metadata jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: fuel_consumption; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.fuel_consumption (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    month date NOT NULL,
+    total_liters numeric(10,2) NOT NULL,
+    total_cost numeric(14,2) NOT NULL,
+    total_distance_km numeric(10,2) NOT NULL,
+    fuel_efficiency_km_per_l numeric(10,2),
+    number_of_purchases integer DEFAULT 0,
+    average_cost_per_liter numeric(10,2),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: fuel_purchases; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.fuel_purchases (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    purchase_date timestamp with time zone NOT NULL,
+    liters numeric(10,2) NOT NULL,
+    cost_per_liter numeric(10,2) NOT NULL,
+    total_cost numeric(14,2) NOT NULL,
+    fuel_station character varying(255),
+    payment_method character varying(50) DEFAULT 'CASH'::character varying,
+    odometer_reading numeric(10,2),
+    driver_id uuid,
+    receipt_number character varying(255),
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: gps_devices; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.gps_devices (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    imei character varying(20) NOT NULL,
+    name character varying,
+    vehicle_id uuid,
+    status character varying(16) DEFAULT 'REGISTERED'::character varying NOT NULL,
+    last_seen_at timestamp with time zone,
+    last_lat numeric(10,6),
+    last_lng numeric(10,6),
+    last_speed numeric(6,2),
+    last_course integer,
+    last_fix_at timestamp with time zone,
+    voltage_level integer,
+    gsm_level integer,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: gps_positions; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.gps_positions (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    device_id uuid NOT NULL,
+    imei character varying(20) NOT NULL,
+    vehicle_id uuid,
+    lat numeric(10,6) NOT NULL,
+    lng numeric(10,6) NOT NULL,
+    speed numeric(6,2) DEFAULT 0 NOT NULL,
+    course integer DEFAULT 0 NOT NULL,
+    satellites integer DEFAULT 0 NOT NULL,
+    positioned boolean DEFAULT false NOT NULL,
+    gps_time timestamp with time zone NOT NULL,
+    alarm integer DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: import_customs_finalizations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.import_customs_finalizations (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    booking_id uuid NOT NULL,
+    documents jsonb DEFAULT '{}'::jsonb NOT NULL,
+    declaration_serial_number character varying(120),
+    duties_taxes_notified_at timestamp with time zone,
+    duties_taxes_paid_at timestamp with time zone,
+    customs_risk character varying(12),
+    import_release_permitted_at timestamp with time zone,
+    completed_at timestamp with time zone,
+    performed_by character varying(120),
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: import_djibouti_operations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.import_djibouti_operations (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    documents jsonb DEFAULT '{}'::jsonb NOT NULL,
+    gatepass_granted_at timestamp with time zone,
+    ready_for_loading_at timestamp with time zone,
+    loaded_on_train_at timestamp with time zone,
+    departed_from_djibouti_at timestamp with time zone,
+    load_list_generated_at timestamp with time zone,
+    performed_by character varying(120),
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: incidents; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.incidents (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    vehicle_id uuid,
+    driver_id uuid,
+    booking_id uuid,
+    type character varying NOT NULL,
+    severity character varying NOT NULL,
+    occurred_at timestamp with time zone NOT NULL,
+    location character varying,
+    description text NOT NULL,
+    damage_estimate numeric(14,2),
+    status character varying DEFAULT 'REPORTED'::character varying NOT NULL,
+    insurance_claim_number character varying,
+    reported_by character varying
+);
+
+
+--
+-- Name: interchange_document_items; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.interchange_document_items (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    interchange_document_id uuid NOT NULL,
+    booking_id uuid,
+    booking_reference character varying(64),
+    item_type character varying(20) NOT NULL,
+    booking_container_id uuid,
+    booking_cargo_id uuid,
+    container_number character varying(64),
+    seal_number character varying(100),
+    cargo_id uuid,
+    cargo_type character varying(255),
+    cargo_description text,
+    weight numeric(14,3),
+    quantity numeric(12,3),
+    package_count integer,
+    wagon_number character varying(80),
+    condition_status character varying(20) DEFAULT 'GOOD'::character varying NOT NULL,
+    damage_description text,
+    remarks text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: interchange_documents; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.interchange_documents (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    document_no character varying(40) NOT NULL,
+    direction character varying(10) NOT NULL,
+    schedule_id uuid,
+    train_no character varying(40),
+    route_id uuid,
+    origin_facility_id uuid,
+    destination_facility_id uuid,
+    handover_location character varying(255) NOT NULL,
+    handover_from character varying(255) NOT NULL,
+    handover_to character varying(255) NOT NULL,
+    operator_name character varying(255),
+    port_operator_name character varying(255),
+    shipping_line_name character varying(255),
+    customs_reference character varying(120),
+    manifest_reference character varying(120),
+    status character varying(20) DEFAULT 'DRAFT'::character varying NOT NULL,
+    generated_at timestamp with time zone,
+    acknowledged_at timestamp with time zone,
+    generated_by character varying(120),
+    acknowledged_by character varying(120),
+    remarks text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: invoice_lines; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.invoice_lines (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    invoice_id uuid NOT NULL,
+    charge_type character varying NOT NULL,
+    description character varying(255),
+    quantity numeric(12,2) DEFAULT 1 NOT NULL,
+    unit_rate numeric(14,2) DEFAULT 0 NOT NULL,
+    amount numeric(14,2) NOT NULL,
+    currency character varying(8) DEFAULT 'ETB'::character varying NOT NULL,
+    metadata jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: invoices; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.invoices (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    invoice_number character varying(64) NOT NULL,
+    company_id uuid NOT NULL,
+    company_profile_id uuid NOT NULL,
+    total_amount numeric(14,2) NOT NULL,
+    currency character varying(8) DEFAULT 'ETB'::character varying NOT NULL,
+    status freight.invoices_status_enum DEFAULT 'DRAFT'::freight.invoices_status_enum NOT NULL,
+    source character varying(255) NOT NULL,
+    source_id character varying(255) NOT NULL,
+    type character varying(255) NOT NULL,
+    issued_at timestamp with time zone,
+    payment_id uuid,
+    due_at timestamp with time zone NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    subtotal_amount numeric(14,2) DEFAULT 0 NOT NULL,
+    tax_amount numeric(14,2) DEFAULT 0 NOT NULL,
+    paid_amount numeric(14,2) DEFAULT 0 NOT NULL,
+    balance_amount numeric(14,2) DEFAULT 0 NOT NULL,
+    paid_at timestamp with time zone,
+    payments jsonb DEFAULT '[]'::jsonb NOT NULL,
+    eims_status character varying(20) DEFAULT 'NOT_SUBMITTED'::character varying NOT NULL,
+    eims_irn character varying(64),
+    eims_invoice_counter bigint,
+    eims_submitted_at timestamp with time zone,
+    eims_ack_date character varying(64),
+    eims_last_error jsonb,
+    eims_document_number character varying(16)
+);
+
+
+--
+-- Name: last_mile; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.last_mile (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    status character varying(30) DEFAULT 'PAYMENT_PENDING'::character varying NOT NULL,
+    advanced_payment numeric(14,2) DEFAULT 0 NOT NULL,
+    remaining_payment numeric(14,2) DEFAULT 0 NOT NULL,
+    estimated_km numeric(10,2),
+    exact_km numeric(10,2),
+    vehicle_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    paid boolean DEFAULT false NOT NULL,
+    arrived_at timestamp with time zone,
+    delivered_at timestamp with time zone,
+    pod_recipient_name character varying(160),
+    pod_signature_file_id uuid,
+    pod_photo_file_ids text[] DEFAULT '{}'::text[] NOT NULL,
+    pod_notes text,
+    pod_captured_at timestamp with time zone
+);
+
+
+--
+-- Name: last_mile_container_allocations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.last_mile_container_allocations (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    last_mile_id uuid NOT NULL,
+    container_id uuid NOT NULL,
+    vehicle_id uuid,
+    container_type text NOT NULL,
+    quantity integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: last_mile_requests; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.last_mile_requests (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    booking_id uuid NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    status character varying(30) DEFAULT 'AWAITING_CONFIRMATION'::character varying NOT NULL,
+    requested_container_numbers text[],
+    reminder_sent_at timestamp with time zone,
+    submitted_by_user_id uuid,
+    submitted_at timestamp with time zone,
+    reviewed_by_staff_id uuid,
+    reviewed_at timestamp with time zone,
+    rejection_reason text,
+    resulting_last_mile_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    requested_delivery_date date,
+    approved_advance_amount numeric(14,2),
+    contract_summary jsonb,
+    contract_generated_at timestamp with time zone,
+    customer_signed_at timestamp with time zone,
+    signer_display_name character varying(160),
+    consent_text text
+);
+
+
+--
+-- Name: last_mile_vehicle_assignments; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.last_mile_vehicle_assignments (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    last_mile_id uuid NOT NULL,
+    vehicle_id uuid NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    container_number character varying,
+    distance_km numeric(10,2),
+    arrived_at timestamp with time zone,
+    departed_at timestamp with time zone,
+    gross_weight_tons numeric(14,3),
+    net_weight_tons numeric(14,3),
+    destination_arrived_at timestamp with time zone,
+    returned_at timestamp with time zone
+);
+
+
+--
+-- Name: last_mile_vehicle_containers; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.last_mile_vehicle_containers (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    assignment_id uuid NOT NULL,
+    last_mile_id uuid NOT NULL,
+    container_number character varying(32) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: locomotives; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.locomotives (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    code character varying(32) NOT NULL,
+    name character varying(100),
+    max_pull_weight_tons numeric(10,3) NOT NULL,
+    status character varying(20) DEFAULT 'AVAILABLE'::character varying NOT NULL,
+    available_from timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    locomotive_type character varying(20) DEFAULT 'DIESEL'::character varying NOT NULL,
+    max_train_length_meters numeric(10,3) DEFAULT 760 NOT NULL,
+    power_kw numeric(10,3),
+    traction_force_kn numeric(10,3),
+    max_speed_kmh numeric(10,3),
+    current_yard_id uuid,
+    overage_tolerance_tons numeric(10,3),
+    overage_tolerance_meters numeric(10,3)
+);
+
+
+--
+-- Name: maintenance_costs; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.maintenance_costs (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    maintenance_schedule_id uuid,
+    incurred_date timestamp with time zone NOT NULL,
+    cost_amount numeric(14,2) NOT NULL,
+    cost_type character varying NOT NULL,
+    description character varying NOT NULL,
+    service_provider character varying,
+    invoice_number character varying,
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: maintenance_intervals; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.maintenance_intervals (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    maintenance_type character varying NOT NULL,
+    interval_km numeric(14,2),
+    interval_days integer,
+    description text,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    service_item character varying(120)
+);
+
+
+--
+-- Name: maintenance_schedules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.maintenance_schedules (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    maintenance_type character varying NOT NULL,
+    description character varying NOT NULL,
+    scheduled_date timestamp with time zone NOT NULL,
+    completed_date timestamp with time zone,
+    estimated_cost numeric(14,2),
+    actual_cost numeric(14,2),
+    status character varying DEFAULT 'SCHEDULED'::character varying NOT NULL,
+    odometer_reading numeric,
+    service_provider character varying,
+    notes text,
+    next_due_km numeric,
+    next_due_date timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    due_notified_at timestamp with time zone,
+    service_item character varying(120)
+);
+
+
+--
+-- Name: migrations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.migrations (
+    id integer NOT NULL,
+    "timestamp" bigint NOT NULL,
+    name character varying NOT NULL
+);
+
+
+--
+-- Name: migrations_id_seq; Type: SEQUENCE; Schema: freight; Owner: -
+--
+
+CREATE SEQUENCE freight.migrations_id_seq
+    AS integer
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+
+--
+-- Name: migrations_id_seq; Type: SEQUENCE OWNED BY; Schema: freight; Owner: -
+--
+
+ALTER SEQUENCE freight.migrations_id_seq OWNED BY freight.migrations.id;
+
+
+--
+-- Name: notifications; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.notifications (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    recipient_user_id uuid NOT NULL,
+    audience character varying(20) NOT NULL,
+    type character varying(48) DEFAULT 'GENERIC'::character varying NOT NULL,
+    title character varying(200) NOT NULL,
+    body text NOT NULL,
+    link character varying,
+    data jsonb,
+    priority character varying(12) DEFAULT 'NORMAL'::character varying NOT NULL,
+    is_read boolean DEFAULT false NOT NULL,
+    read_at timestamp with time zone,
+    channels_sent jsonb,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: otp_verifications; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.otp_verifications (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    phone character varying,
+    otp character varying NOT NULL,
+    verified boolean DEFAULT false NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    email character varying
+);
+
+
+--
+-- Name: parts; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.parts (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    name character varying NOT NULL,
+    sku character varying,
+    category character varying,
+    quantity_in_stock integer DEFAULT 0 NOT NULL,
+    reorder_level integer DEFAULT 0 NOT NULL,
+    unit_cost numeric(14,2),
+    location character varying,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: payment_refunds; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.payment_refunds (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    payment_id uuid NOT NULL,
+    amount_minor integer NOT NULL,
+    reason character varying(255),
+    provider_refund_id character varying(255),
+    status character varying(50) NOT NULL,
+    created_at timestamp without time zone DEFAULT now() NOT NULL
+);
+
+
+--
+-- Name: payment_webhook_events; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.payment_webhook_events (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    provider freight.payment_webhook_method_enum NOT NULL,
+    external_event_id character varying(255) NOT NULL,
+    merchant_order_id character varying(255),
+    provider_txn_id character varying(255),
+    signature_valid boolean NOT NULL,
+    status character varying(100) NOT NULL,
+    payload jsonb NOT NULL,
+    received_at timestamp without time zone DEFAULT now() NOT NULL,
+    processed_at timestamp without time zone,
+    processing_error text
+);
+
+
+--
+-- Name: payments; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.payments (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    ref_id character varying(255) NOT NULL,
+    type character varying(50) NOT NULL,
+    method freight.payments_method_enum NOT NULL,
+    currency freight.payments_currency_enum NOT NULL,
+    amount numeric NOT NULL,
+    raw_initiation jsonb DEFAULT '{}'::jsonb NOT NULL,
+    client_action jsonb,
+    merchant_order_id character varying(255) NOT NULL,
+    transaction_id character varying(255),
+    status freight.payments_status_enum DEFAULT 'action-required'::freight.payments_status_enum NOT NULL,
+    paid_at timestamp without time zone,
+    refunded_at timestamp without time zone,
+    expires_at timestamp without time zone,
+    failer_code character varying(30),
+    failer_message character varying(255),
+    reason character varying(255),
+    created_at timestamp without time zone DEFAULT now() NOT NULL,
+    reference_type character varying(40)
+);
+
+
+--
+-- Name: priority_configs; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.priority_configs (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    type character varying(20) NOT NULL,
+    label character varying(100) NOT NULL,
+    currency character varying(5),
+    min_wagon_count integer NOT NULL,
+    max_wagon_count integer NOT NULL,
+    score_points integer DEFAULT 0 NOT NULL,
+    is_active boolean DEFAULT false NOT NULL,
+    display_order integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    CONSTRAINT chk_currency_for_type CHECK (((((type)::text = 'WAGON'::text) AND (currency IS NULL)) OR (((type)::text = 'CURRENCY'::text) AND (currency IS NOT NULL)) OR (((type)::text = 'CUSTOMS'::text) AND (currency IS NULL)))),
+    CONSTRAINT chk_wagon_range CHECK ((min_wagon_count <= max_wagon_count)),
+    CONSTRAINT priority_configs_type_check CHECK (((type)::text = ANY (ARRAY[('WAGON'::character varying)::text, ('CURRENCY'::character varying)::text, ('CUSTOMS'::character varying)::text])))
+);
+
+
+--
+-- Name: priority_rule_change_requests; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.priority_rule_change_requests (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    action character varying(10) NOT NULL,
+    priority_config_id uuid,
+    payload jsonb,
+    status character varying(10) DEFAULT 'PENDING'::character varying NOT NULL,
+    requested_by_user_id uuid,
+    decided_by_user_id uuid,
+    decided_at timestamp with time zone,
+    decision_note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: priority_rules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.priority_rules (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    is_active boolean DEFAULT false NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    code character varying(40) NOT NULL,
+    label character varying(100) NOT NULL,
+    score integer DEFAULT 0 NOT NULL,
+    condition_currency character varying(5)
+);
+
+
+--
+-- Name: rate_change_requests; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.rate_change_requests (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    rate_id uuid NOT NULL,
+    payload jsonb NOT NULL,
+    previous_values jsonb NOT NULL,
+    status character varying(10) DEFAULT 'PENDING'::character varying NOT NULL,
+    requested_by_user_id uuid,
+    decided_by_user_id uuid,
+    decided_at timestamp with time zone,
+    decision_note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: rates; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.rates (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    rate_type character varying(50) NOT NULL,
+    container_type_id uuid,
+    trade_direction character varying(10),
+    currency character varying(5) NOT NULL,
+    rate_value numeric(14,4) NOT NULL,
+    rate_unit character varying(30) NOT NULL,
+    status character varying(20) DEFAULT 'DRAFT'::character varying NOT NULL,
+    proposed_by_staff_id uuid NOT NULL,
+    approved_by_ceo_id uuid,
+    approved_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    applies_to character varying(20) DEFAULT 'OTHER'::character varying NOT NULL,
+    trigger character varying(20) DEFAULT 'ALWAYS'::character varying NOT NULL,
+    cargo_type_id uuid,
+    origin_yard_id uuid,
+    destination_yard_id uuid,
+    min_km numeric(10,2),
+    max_km numeric(10,2),
+    CONSTRAINT "CK_rates_km_band" CHECK (((max_km IS NULL) OR ((min_km IS NOT NULL) AND (max_km > min_km)))),
+    CONSTRAINT "CK_rates_yard_scope" CHECK (((deleted_at IS NOT NULL) OR ((status)::text = 'SUPERSEDED'::text) OR
+CASE
+    WHEN ((((trigger)::text = 'ALWAYS'::text) AND ((applies_to)::text = ANY (ARRAY[('BULK'::character varying)::text, ('CONTAINER'::character varying)::text, ('INTERCITY'::character varying)::text]))) OR ((trigger)::text = ANY (ARRAY[('CUSTOMS_CLEARANCE'::character varying)::text, ('WITH_RETURN'::character varying)::text]))) THEN ((origin_yard_id IS NOT NULL) AND (destination_yard_id IS NOT NULL))
+    ELSE ((origin_yard_id IS NULL) AND (destination_yard_id IS NULL))
+END))
+);
+
+
+--
+-- Name: route_milestones; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.route_milestones (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    route_id uuid NOT NULL,
+    yard_id uuid NOT NULL,
+    sequence_no integer NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    distance_km numeric(10,2)
+);
+
+
+--
+-- Name: routes; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.routes (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    origin_yard_id uuid NOT NULL,
+    destination_yard_id uuid NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    status character varying(32) DEFAULT 'AVAILABLE'::character varying NOT NULL,
+    direction character varying(10) NOT NULL,
+    CONSTRAINT chk_routes_direction CHECK (((direction)::text = ANY (ARRAY[('IMPORT'::character varying)::text, ('EXPORT'::character varying)::text, ('DOMESTIC'::character varying)::text])))
+);
+
+
+--
+-- Name: saved_signatures; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.saved_signatures (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    user_id uuid NOT NULL,
+    signer_display_name character varying(200) NOT NULL,
+    signature_file_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    stamp_file_id uuid
+);
+
+
+--
+-- Name: schedule_wagon_adjustment_logs; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.schedule_wagon_adjustment_logs (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    train_id uuid NOT NULL,
+    action character varying(10) NOT NULL,
+    wagon_id uuid NOT NULL,
+    wagon_number character varying(50) NOT NULL,
+    adjusted_by_user_id uuid,
+    occurred_at timestamp with time zone DEFAULT now() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    yard_id uuid
+);
+
+
+--
+-- Name: scheduling_events; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.scheduling_events (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    trigger character varying(40) NOT NULL,
+    actor_user_id uuid,
+    reason text,
+    plan_snapshot jsonb DEFAULT '{}'::jsonb NOT NULL,
+    displaced_booking_ids jsonb DEFAULT '[]'::jsonb NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: seq_company_profile_ex; Type: SEQUENCE; Schema: freight; Owner: -
+--
+
+CREATE SEQUENCE freight.seq_company_profile_ex
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+
+--
+-- Name: seq_company_profile_ffe; Type: SEQUENCE; Schema: freight; Owner: -
+--
+
+CREATE SEQUENCE freight.seq_company_profile_ffe
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+
+--
+-- Name: seq_company_profile_fwj; Type: SEQUENCE; Schema: freight; Owner: -
+--
+
+CREATE SEQUENCE freight.seq_company_profile_fwj
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+
+--
+-- Name: seq_company_profile_im; Type: SEQUENCE; Schema: freight; Owner: -
+--
+
+CREATE SEQUENCE freight.seq_company_profile_im
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+
+--
+-- Name: seq_company_profile_tr; Type: SEQUENCE; Schema: freight; Owner: -
+--
+
+CREATE SEQUENCE freight.seq_company_profile_tr
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+
+--
+-- Name: service_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.service_types (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    service_name character varying(255) NOT NULL,
+    description text,
+    can_be_booked_alone boolean DEFAULT true NOT NULL,
+    includes_first_mile boolean DEFAULT false NOT NULL,
+    includes_last_mile boolean DEFAULT false NOT NULL,
+    includes_customs boolean DEFAULT false NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    display_order integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    code character varying(50) NOT NULL
+);
+
+
+--
+-- Name: shipping_lines; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.shipping_lines (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    code character varying(20) NOT NULL,
+    label character varying(100) NOT NULL,
+    mapped_to_code character varying(20),
+    show_extra_fee_notice boolean DEFAULT false NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: support_conversations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.support_conversations (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    company_id uuid NOT NULL,
+    company_name character varying(200),
+    created_by_user_id uuid,
+    last_message_at timestamp with time zone,
+    last_message_preview character varying(280),
+    last_message_author_role character varying(12),
+    customer_last_read_at timestamp with time zone,
+    agent_last_read_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: support_document_versions; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.support_document_versions (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    document_id uuid NOT NULL,
+    version integer NOT NULL,
+    payload jsonb NOT NULL,
+    actor_id uuid,
+    note character varying(255),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: support_documents; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.support_documents (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    slug character varying(32) NOT NULL,
+    payload jsonb DEFAULT '{}'::jsonb NOT NULL,
+    version integer DEFAULT 1 NOT NULL,
+    updated_by_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: support_messages; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.support_messages (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    conversation_id uuid NOT NULL,
+    author_user_id uuid NOT NULL,
+    author_role character varying(12) NOT NULL,
+    author_name character varying(200),
+    body text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: tracking_events; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.tracking_events (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    consignment_id uuid NOT NULL,
+    location character varying(256) NOT NULL,
+    status freight.tracking_events_status_enum NOT NULL,
+    occurred_at timestamp with time zone NOT NULL,
+    description text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: train_checkpoint_events; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_checkpoint_events (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    yard_id uuid NOT NULL,
+    sequence_no integer NOT NULL,
+    kind character varying(20) NOT NULL,
+    occurred_at timestamp with time zone DEFAULT now() NOT NULL,
+    note text,
+    recorded_by_user_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: train_composition_removal_logs; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_composition_removal_logs (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    schedule_id uuid NOT NULL,
+    booking_id uuid NOT NULL,
+    booking_reference character varying(64),
+    removed_by_user_id uuid,
+    removed_at timestamp with time zone DEFAULT now() NOT NULL,
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: train_locomotives; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_locomotives (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    train_id uuid NOT NULL,
+    locomotive_id uuid NOT NULL,
+    sequence_no integer DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: train_schedule_bookings; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_schedule_bookings (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    train_schedule_id uuid NOT NULL,
+    booking_id uuid NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    loading_status character varying(20) DEFAULT 'UNLOADED'::character varying NOT NULL
+);
+
+
+--
+-- Name: train_schedules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_schedules (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    train_set_id uuid NOT NULL,
+    origin_station_id uuid NOT NULL,
+    destination_station_id uuid NOT NULL,
+    scheduled_departure_date timestamp with time zone NOT NULL,
+    scheduled_arrival_date timestamp with time zone,
+    status character varying(20) DEFAULT 'DRAFT'::character varying NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    route_id uuid,
+    train_number character varying(20),
+    direction character varying(10),
+    actual_departure_at timestamp with time zone,
+    actual_arrival_at timestamp with time zone,
+    prepared_by_user_id uuid,
+    checked_by_user_id uuid,
+    max_wagons integer DEFAULT 53 NOT NULL,
+    booking_window_status character varying(10) DEFAULT 'OPEN'::character varying NOT NULL,
+    window_phase character varying(20),
+    window_opens_at timestamp with time zone,
+    window_closes_at timestamp with time zone,
+    doc_review_ends_at timestamp with time zone,
+    doc_review_completed_at timestamp with time zone,
+    payment_phase_ends_at timestamp with time zone,
+    booking_cycle_no integer DEFAULT 0 NOT NULL,
+    rule_window_open_hour integer,
+    rule_window_duration_hours numeric(6,4),
+    rule_reopen_delay_minutes integer,
+    rule_import_window_lead_days integer,
+    rule_export_booking_lead_hours integer,
+    rule_window_close_hour integer,
+    reference character varying(20),
+    wagon_allocation_snapshot jsonb,
+    rule_import_close_offset_minutes integer,
+    rule_export_close_offset_minutes integer,
+    reverse_wagon_order boolean DEFAULT false NOT NULL,
+    rule_payment_window_minutes integer,
+    window_rule_custom boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: train_scheduling_global_rules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_scheduling_global_rules (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    max_train_length_meters numeric(10,2) DEFAULT 760 NOT NULL,
+    max_train_weight_tons numeric(10,3) DEFAULT 3500 NOT NULL,
+    max_wagons_per_train integer DEFAULT 53 NOT NULL,
+    max_20ft_container_weight_tons numeric(8,3) DEFAULT 30 NOT NULL,
+    max_20ft_pair_weight_diff_tons numeric(8,3) DEFAULT 10 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    import_window_lead_days integer DEFAULT 3 NOT NULL,
+    export_booking_lead_hours integer DEFAULT 24 NOT NULL,
+    window_open_hour integer DEFAULT 8 NOT NULL,
+    window_duration_hours numeric(6,4) DEFAULT 3 NOT NULL,
+    doc_review_minutes integer DEFAULT 30 NOT NULL,
+    payment_window_minutes integer DEFAULT 60 NOT NULL,
+    window_close_hour integer DEFAULT 17 NOT NULL,
+    import_close_offset_minutes integer,
+    export_close_offset_minutes integer,
+    export_payment_window_minutes integer DEFAULT 60 NOT NULL
+);
+
+
+--
+-- Name: train_set_locomotives; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_set_locomotives (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    train_set_id uuid NOT NULL,
+    locomotive_id uuid NOT NULL,
+    sequence_no integer DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: train_set_wagons; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_set_wagons (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    train_set_id uuid NOT NULL,
+    wagon_type_id uuid NOT NULL,
+    sequence_no integer NOT NULL,
+    capacity_tons numeric(10,3) NOT NULL,
+    length_meters numeric(10,3) NOT NULL,
+    assigned_weight_tons numeric(10,3) DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    physical_wagon_id uuid,
+    status character varying(20) DEFAULT 'PLANNED'::character varying NOT NULL,
+    board_yard_id uuid,
+    alight_yard_id uuid
+);
+
+
+--
+-- Name: train_sets; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.train_sets (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    locomotive_id uuid NOT NULL,
+    total_weight_tons numeric(10,3) NOT NULL,
+    total_length_meters numeric(10,3) NOT NULL,
+    wagon_count integer NOT NULL,
+    status character varying(20) DEFAULT 'DRAFT'::character varying NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    train_id uuid
+);
+
+
+--
+-- Name: trains; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.trains (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    code character varying(32) NOT NULL,
+    capacity_tons numeric(10,2) DEFAULT 0 NOT NULL,
+    status freight.train_status DEFAULT 'AVAILABLE'::freight.train_status NOT NULL,
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    train_number character varying(20),
+    train_name character varying(100),
+    route_id uuid,
+    origin_station_id uuid,
+    destination_station_id uuid,
+    departure_time timestamp with time zone,
+    arrival_time timestamp with time zone,
+    locomotive_number character varying(50),
+    remarks text,
+    current_yard_id uuid,
+    import_train_number character varying(20),
+    export_train_number character varying(20)
+);
+
+
+--
+-- Name: transit_agents; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.transit_agents (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    name character varying(150) NOT NULL,
+    valid_from date NOT NULL,
+    valid_to date NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: truck_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.truck_types (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    code character varying(32) NOT NULL,
+    name character varying(100) NOT NULL,
+    capacity_tons numeric(10,3),
+    has_trailer boolean DEFAULT false NOT NULL,
+    description text,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: user_trade_access; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.user_trade_access (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    user_id uuid NOT NULL,
+    directions text DEFAULT ''::text NOT NULL,
+    updated_by_id uuid,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: vehicles; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.vehicles (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    plate_number character varying NOT NULL,
+    registration_number character varying NOT NULL,
+    vehicle_type character varying NOT NULL,
+    manufacturer character varying NOT NULL,
+    model character varying NOT NULL,
+    year integer NOT NULL,
+    fuel_type character varying NOT NULL,
+    capacity numeric NOT NULL,
+    status character varying DEFAULT 'ACTIVE'::character varying NOT NULL,
+    description text,
+    created_at timestamp without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    updated_at timestamp without time zone DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    deleted_at timestamp without time zone,
+    assigned_driver_id uuid,
+    assigned_driver_name character varying,
+    code character varying,
+    power_plate_no character varying,
+    trailer_plate_no character varying,
+    estimated_distance_km numeric,
+    actual_distance_km numeric,
+    location_id uuid,
+    availability character varying DEFAULT 'FREE'::character varying,
+    vin character varying,
+    ownership character varying,
+    insurance_expiry date,
+    registration_expiry date,
+    next_inspection_date date,
+    price_per_km numeric(14,2),
+    currency character varying(8) DEFAULT 'ETB'::character varying NOT NULL,
+    truck_type_id uuid
+);
+
+
+--
+-- Name: vendors; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.vendors (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    name character varying NOT NULL,
+    type character varying,
+    contact_person character varying,
+    phone character varying,
+    email character varying,
+    address character varying,
+    is_active boolean DEFAULT true NOT NULL
+);
+
+
+--
+-- Name: wagon_allocation_bulk_loads; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_allocation_bulk_loads (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    wagon_booking_allocation_id uuid NOT NULL,
+    booking_id uuid NOT NULL,
+    cargo_type_id uuid,
+    cargo_description text,
+    pricing_unit character varying(20) DEFAULT 'PER_TON'::character varying NOT NULL,
+    quantity numeric(12,3) DEFAULT 0 NOT NULL,
+    weight_tons numeric(10,3) DEFAULT 0 NOT NULL,
+    truck_plate_number character varying(32),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: wagon_allocation_container_items; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_allocation_container_items (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    wagon_booking_allocation_id uuid NOT NULL,
+    booking_container_id uuid,
+    container_id uuid,
+    container_number character varying(64),
+    container_type_id uuid,
+    position_on_wagon smallint,
+    seal_number character varying(64),
+    chassis_number character varying(64),
+    gross_weight_tons numeric(10,3),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: wagon_booking_allocations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_booking_allocations (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    train_set_wagon_id uuid NOT NULL,
+    booking_id uuid NOT NULL,
+    allocated_weight_tons numeric(10,3) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    load_type character varying(20),
+    status character varying(20) DEFAULT 'PLANNED'::character varying NOT NULL,
+    confirmed_at timestamp with time zone,
+    confirmed_by_user_id uuid
+);
+
+
+--
+-- Name: wagon_movements; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_movements (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    wagon_id uuid NOT NULL,
+    from_yard_id uuid,
+    to_yard_id uuid NOT NULL,
+    train_schedule_id uuid,
+    booking_id uuid,
+    kind character varying(30) NOT NULL,
+    moved_by_user_id uuid,
+    occurred_at timestamp with time zone DEFAULT now() NOT NULL,
+    note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    transfer_request_id uuid
+);
+
+
+--
+-- Name: wagon_status_logs; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_status_logs (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    wagon_id uuid NOT NULL,
+    from_status character varying(30) NOT NULL,
+    to_status character varying(30) NOT NULL,
+    changed_by_user_id uuid,
+    note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: wagon_transfer_requests; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_transfer_requests (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    from_yard_id uuid NOT NULL,
+    to_yard_id uuid NOT NULL,
+    wagon_type_id uuid NOT NULL,
+    quantity integer NOT NULL,
+    status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    requested_by_user_id uuid,
+    fulfilled_by_user_id uuid,
+    fulfilled_at timestamp with time zone,
+    note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    reason text,
+    fulfilled_quantity integer DEFAULT 0 NOT NULL,
+    closed_short_at timestamp with time zone,
+    closed_short_by_user_id uuid,
+    CONSTRAINT chk_wtr_quantity CHECK ((quantity > 0))
+);
+
+
+--
+-- Name: wagon_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagon_types (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    code character varying(32) NOT NULL,
+    name character varying(100) NOT NULL,
+    capacity_tons numeric(10,3) NOT NULL,
+    length_meters numeric(10,3) NOT NULL,
+    supported_load_types text[] DEFAULT '{}'::text[] NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    equated_length_m numeric(10,3),
+    tare_weight_tons numeric(10,3) NOT NULL,
+    supports_container boolean DEFAULT false NOT NULL,
+    max_container_gross_t numeric(10,3)
+);
+
+
+--
+-- Name: wagons; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.wagons (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    wagon_number character varying NOT NULL,
+    wagon_type_id uuid NOT NULL,
+    train_id uuid,
+    sequence_number integer,
+    status character varying DEFAULT 'AVAILABLE'::character varying NOT NULL,
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    current_location_yard_id uuid,
+    train_set_wagon_id uuid,
+    current_train_schedule_id uuid,
+    current_yard_id uuid,
+    export_train_number character varying(20),
+    import_train_number character varying(20)
+);
+
+
+--
+-- Name: warehouse_accrual_acks; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_accrual_acks (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    inventory_id uuid NOT NULL,
+    acknowledged_by uuid,
+    acknowledged_at timestamp with time zone DEFAULT now() NOT NULL,
+    snooze_until timestamp with time zone,
+    note text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL
+);
+
+
+--
+-- Name: warehouse_activity_log; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_activity_log (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    inventory_id uuid,
+    warehouse_id uuid,
+    activity_type character varying(40) NOT NULL,
+    description text,
+    performed_by character varying(120),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: warehouse_allocation_rules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_allocation_rules (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    name character varying(160) NOT NULL,
+    priority integer DEFAULT 100 NOT NULL,
+    freight_type character varying(16),
+    trade_direction character varying(16),
+    cargo_type_code character varying(50),
+    container_status character varying(24),
+    requires_inspection boolean,
+    target_facility_code character varying(40),
+    target_yard_code character varying(40) NOT NULL,
+    target_warehouse_code character varying(40),
+    target_zone_code character varying(40),
+    storage_type character varying(80),
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: warehouse_fee_rules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_fee_rules (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    name character varying(160) NOT NULL,
+    rule_type character varying(20) NOT NULL,
+    priority integer DEFAULT 100 NOT NULL,
+    freight_type character varying(16),
+    trade_direction character varying(16),
+    cargo_type_code character varying(50),
+    container_type character varying(40),
+    facility_id uuid,
+    warehouse_id uuid,
+    yard_id uuid,
+    zone_id uuid,
+    free_days integer DEFAULT 0 NOT NULL,
+    rate_per_day numeric(14,2) DEFAULT 0 NOT NULL,
+    tiers jsonb DEFAULT '[]'::jsonb NOT NULL,
+    currency character varying(8) DEFAULT 'USD'::character varying NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    basis character varying(20),
+    free_hours integer,
+    vehicle_type character varying(32)
+);
+
+
+--
+-- Name: warehouse_inspection_reports; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_inspection_reports (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    inventory_id uuid NOT NULL,
+    booking_id uuid,
+    customer_id uuid,
+    report_type character varying(32) DEFAULT 'INSPECTION'::character varying NOT NULL,
+    inspection_status character varying(20) DEFAULT 'NEEDS_REVIEW'::character varying NOT NULL,
+    has_damage boolean DEFAULT false NOT NULL,
+    damage_description text,
+    has_weight_loss boolean DEFAULT false NOT NULL,
+    expected_weight numeric(14,3),
+    actual_weight numeric(14,3),
+    weight_loss numeric(14,3),
+    weight_loss_unit character varying(12),
+    has_missing_items boolean DEFAULT false NOT NULL,
+    missing_items_description text,
+    remarks text,
+    inspected_by_id uuid,
+    inspected_at timestamp with time zone,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: warehouse_inventory; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_inventory (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    warehouse_id uuid NOT NULL,
+    yard_id uuid NOT NULL,
+    zone_id uuid NOT NULL,
+    booking_id uuid,
+    cargo_id uuid,
+    container_id uuid,
+    goods_id uuid,
+    quantity numeric(12,3) DEFAULT 0 NOT NULL,
+    weight numeric(14,3) DEFAULT 0 NOT NULL,
+    volume numeric(12,3),
+    status character varying(32) DEFAULT 'RECEIVED'::character varying NOT NULL,
+    inspection_status character varying(20),
+    arrived_at timestamp with time zone,
+    inspected_at timestamp with time zone,
+    ready_for_loading_at timestamp with time zone,
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    stored_at timestamp with time zone,
+    reserved_at timestamp with time zone,
+    loaded_at timestamp with time zone,
+    dispatched_at timestamp with time zone,
+    inspection_started_at timestamp with time zone,
+    inspection_completed_at timestamp with time zone,
+    ready_for_pickup_at timestamp with time zone,
+    release_date timestamp with time zone,
+    gate_cleared_at timestamp with time zone,
+    release_order_reference character varying(100),
+    delivered_at timestamp with time zone,
+    unloaded_at timestamp with time zone,
+    grn_number character varying(100)
+);
+
+
+--
+-- Name: warehouse_inventory_movement; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_inventory_movement (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    inventory_id uuid NOT NULL,
+    from_warehouse_id uuid NOT NULL,
+    from_yard_id uuid NOT NULL,
+    from_zone_id uuid NOT NULL,
+    to_warehouse_id uuid NOT NULL,
+    to_yard_id uuid NOT NULL,
+    to_zone_id uuid NOT NULL,
+    remarks text,
+    moved_by character varying(120),
+    moved_at timestamp with time zone DEFAULT now() NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: warehouse_loadings; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_loadings (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    warehouse_inventory_id uuid NOT NULL,
+    booking_id uuid,
+    wagon_id uuid,
+    loaded_at timestamp with time zone DEFAULT now() NOT NULL,
+    loaded_by character varying(120),
+    loaded_weight numeric(14,3),
+    notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    train_schedule_id uuid
+);
+
+
+--
+-- Name: warehouse_yard_cargo_types; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_yard_cargo_types (
+    yard_id uuid NOT NULL,
+    cargo_type_id uuid NOT NULL
+);
+
+
+--
+-- Name: warehouse_yards; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_yards (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    warehouse_id uuid NOT NULL,
+    name character varying(160) NOT NULL,
+    code character varying(40) NOT NULL,
+    type character varying(32) NOT NULL,
+    capacity_weight numeric(14,3),
+    capacity_containers integer,
+    current_weight numeric(14,3) DEFAULT 0 NOT NULL,
+    current_containers integer DEFAULT 0 NOT NULL,
+    status character varying(16) DEFAULT 'ACTIVE'::character varying NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    max_weight numeric(14,3),
+    max_volume numeric(14,3),
+    current_volume numeric(14,3) DEFAULT 0 NOT NULL,
+    direction character varying(10)
+);
+
+
+--
+-- Name: warehouse_zones; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouse_zones (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    yard_id uuid NOT NULL,
+    name character varying(160) NOT NULL,
+    code character varying(40) NOT NULL,
+    type character varying(32) NOT NULL,
+    capacity_weight numeric(14,3),
+    capacity_containers integer,
+    current_weight numeric(14,3) DEFAULT 0 NOT NULL,
+    current_containers integer DEFAULT 0 NOT NULL,
+    status character varying(16) DEFAULT 'ACTIVE'::character varying NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    max_weight numeric(14,3),
+    max_volume numeric(14,3),
+    current_volume numeric(14,3) DEFAULT 0 NOT NULL
+);
+
+
+--
+-- Name: warehouses; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warehouses (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    name character varying(160) NOT NULL,
+    code character varying(40) NOT NULL,
+    type character varying(32) NOT NULL,
+    station_id uuid,
+    location_name character varying(200),
+    capacity_weight numeric(14,3),
+    capacity_containers integer,
+    current_weight numeric(14,3) DEFAULT 0 NOT NULL,
+    current_containers integer DEFAULT 0 NOT NULL,
+    status character varying(16) DEFAULT 'ACTIVE'::character varying NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    max_weight numeric(14,3),
+    max_volume numeric(14,3),
+    current_volume numeric(14,3) DEFAULT 0 NOT NULL,
+    facility_id uuid
+);
+
+
+--
+-- Name: warranties; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.warranties (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    component character varying NOT NULL,
+    provider character varying,
+    start_date date,
+    expiry_date date NOT NULL,
+    coverage_notes text,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: weight_limit_rules; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.weight_limit_rules (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    container_type_id uuid NOT NULL,
+    trade_direction freight.weight_limit_rules_trade_direction_enum NOT NULL,
+    max_vgm_tons numeric(8,3) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    max_capacity_tons numeric(8,3)
+);
+
+
+--
+-- Name: work_orders; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.work_orders (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    vehicle_id uuid NOT NULL,
+    title character varying NOT NULL,
+    description text,
+    status character varying DEFAULT 'OPEN'::character varying NOT NULL,
+    priority character varying DEFAULT 'MEDIUM'::character varying NOT NULL,
+    assigned_to character varying,
+    opened_at timestamp with time zone DEFAULT now() NOT NULL,
+    closed_at timestamp with time zone,
+    labor_cost numeric(14,2),
+    parts_cost numeric(14,2),
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: yard_distances; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.yard_distances (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    from_yard_id uuid NOT NULL,
+    to_yard_id uuid NOT NULL,
+    distance_km numeric(10,2) NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: yard_facilities; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.yard_facilities (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    yard_id uuid NOT NULL,
+    has_warehouse boolean DEFAULT false NOT NULL,
+    equipment_notes text,
+    is_active boolean DEFAULT true NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    handles_container boolean DEFAULT true NOT NULL,
+    handles_bulk boolean DEFAULT true NOT NULL,
+    has_container_facility_origin boolean DEFAULT false NOT NULL,
+    has_bulk_facility_origin boolean DEFAULT false NOT NULL,
+    has_container_facility_destination boolean DEFAULT false NOT NULL,
+    has_bulk_facility_destination boolean DEFAULT false NOT NULL
+);
+
+
+--
+-- Name: yard_locations; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.yard_locations (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    yard_id uuid NOT NULL,
+    latitude double precision NOT NULL,
+    longitude double precision NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone
+);
+
+
+--
+-- Name: yards; Type: TABLE; Schema: freight; Owner: -
+--
+
+CREATE TABLE freight.yards (
+    id uuid DEFAULT public.uuid_generate_v4() NOT NULL,
+    code character varying(40) NOT NULL,
+    label character varying(100) NOT NULL,
+    country character varying(50) NOT NULL,
+    is_active boolean DEFAULT true NOT NULL,
+    display_order integer DEFAULT 1 NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL,
+    deleted_at timestamp with time zone,
+    has_facility boolean DEFAULT false NOT NULL,
+    CONSTRAINT chk_yards_country CHECK (((country)::text = ANY (ARRAY[('Ethiopia'::character varying)::text, ('Djibouti'::character varying)::text])))
+);
+
+
+--
+-- Name: migrations id; Type: DEFAULT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.migrations ALTER COLUMN id SET DEFAULT nextval('freight.migrations_id_seq'::regclass);
+
+
+--
+-- Data for Name: approval_rules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.approval_rules VALUES
+	('81387cd7-ed52-42ed-ae87-5d02dc7aa3b0', true, 2, '-marketing-chief', 'Final Signature', NULL, '2026-07-27 11:31:59.766128+00', '2026-08-04 07:54:54.260045+00', NULL),
+	('650cf1bb-5979-42cc-9ded-16afcd86651b', true, 1, '-marketing-director-', 'Review & Approve', 'LINE_STAFF', '2026-07-27 11:31:59.766128+00', '2026-08-04 07:55:18.030364+00', NULL),
+	('03aed9fb-ef7f-4f61-b65d-cb5e73d33fcd', false, 1, '-marketing-officer-', 'Review & Approve', NULL, '2026-07-27 11:31:59.766128+00', '2026-08-04 07:55:55.39793+00', NULL),
+	('1b1d75c5-1bc2-47d4-9ee2-82a402cca7fd', false, 2, '-marketing-director-', 'Final Signature', 'LINE_STAFF', '2026-07-27 11:31:59.766128+00', '2026-08-04 07:56:12.788711+00', NULL);
+
+
+--
+-- Data for Name: asset_acquisitions; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: asset_disposals; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_batch_offers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_cargo_modifier; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_container; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.booking_container VALUES
+	('32c1db2c-8f1e-4b2b-ae38-803d6751b8a9', '346725c9-6075-4283-a59d-c0cfb58d2e52', '349072e7-8a90-4c03-b682-08976abfd7e8', 8, 28.000, 224.000, 8.00, NULL, false, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, 0, 0, 0),
+	('4342bb79-d2ef-4d48-b2f9-8a7f0466be7f', 'dc105e51-7acd-4706-a7a0-b77dc4b28059', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 12, 20.000, 240.000, 6.00, NULL, false, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, 0, 0, 0),
+	('240b0700-ecc9-4566-bbfb-791c57fc5579', 'd733c2dd-f5f0-4b88-b675-1447fc30d821', '349072e7-8a90-4c03-b682-08976abfd7e8', 6, 30.000, 180.000, 6.00, NULL, false, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, 0, 0, 0),
+	('071271bd-7584-4dca-b49b-a70387644a3e', 'd1d73d4d-c2c9-4025-af7c-5c2c5327e9f1', '349072e7-8a90-4c03-b682-08976abfd7e8', 7, 28.000, 196.000, 7.00, NULL, false, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, 0, 0, 0),
+	('1444e5eb-7821-4166-b8d3-1a4683b31837', '524ef40f-a1ee-401d-8ecb-f1ce9f5374e4', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 11, 20.000, 220.000, 5.50, NULL, false, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, 0, 0, 0),
+	('6368b06d-de96-470b-8b2a-d7ed53bb1d84', 'ec0da804-5163-4f1f-87a7-8a9215159146', '349072e7-8a90-4c03-b682-08976abfd7e8', 4, 32.000, 128.000, 4.00, NULL, false, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, 0, 0, 0);
+
+
+--
+-- Data for Name: booking_container_allocations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_container_units; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.booking_container_units VALUES
+	('493efbca-6da3-49c9-9b97-43b9b154bedb', '32c1db2c-8f1e-4b2b-ae38-803d6751b8a9', 'LMRT1234567', NULL, 28.000, false, false, 0, '2026-08-09 20:45:34.697299+00', '2026-08-09 20:45:34.697299+00', NULL, false, NULL, NULL, false);
+
+
+--
+-- Data for Name: booking_contract_signatures; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_document_review; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_handovers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_rate_snapshot; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_requests; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_review_note; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: booking_wagon_cancellations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: bookings; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.bookings VALUES
+	('346725c9-6075-4283-a59d-c0cfb58d2e52', 'PAID-IMP-001', NULL, NULL, 'APPROVED', '2026-07-01 08:00:00+00', 5600.00, 'PAID', 'NEW', 'IMPORT', 'WITHOUT_RETURN', NULL, 'Akaki Industrial Zone, Addis Ababa', 224.000, false, 'ETB', NULL, NULL, NULL, 1, NULL, '2026-08-09 20:15:36.225+00', NULL, NULL, NULL, NULL, 20, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, '7d1b9c9c-372a-41ea-8125-363163fc6351', '91c3912b-036a-4a09-b9f7-f70d0da0b717', '76ec1857-294d-4eef-95ab-84b0eff3261c', NULL, 'Demo container cargo', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'CONTAINER', NULL, NULL, NULL, '300d5510-e3a5-4858-bc28-6e3beda8ca80', 8.00, 'NOT_SCHEDULED', NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, '245bde93-5dfd-4adf-9b1a-5386169a46ec', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 8.8808000, 38.7876000, false, NULL, false, '2026-07-01 08:00:00+00', NULL, NULL, 'CUSTOMER', NULL, NULL, NULL, NULL, NULL, 0.000, 0.000, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'ONE_TIME', NULL, NULL, NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('dc105e51-7acd-4706-a7a0-b77dc4b28059', 'PAID-IMP-002', NULL, NULL, 'APPROVED', '2026-07-02 08:00:00+00', 6000.00, 'PAID', 'NEW', 'IMPORT', 'WITHOUT_RETURN', NULL, 'Kality Logistics Hub, Addis Ababa', 240.000, false, 'ETB', NULL, NULL, NULL, 1, NULL, '2026-08-09 20:15:36.241+00', NULL, NULL, NULL, NULL, 20, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, '7d1b9c9c-372a-41ea-8125-363163fc6351', '91c3912b-036a-4a09-b9f7-f70d0da0b717', '76ec1857-294d-4eef-95ab-84b0eff3261c', NULL, 'Demo container cargo', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'CONTAINER', NULL, NULL, NULL, '300d5510-e3a5-4858-bc28-6e3beda8ca80', 6.00, 'NOT_SCHEDULED', NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, '245bde93-5dfd-4adf-9b1a-5386169a46ec', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 8.9137000, 38.7815000, false, NULL, false, '2026-07-02 08:00:00+00', NULL, NULL, 'CUSTOMER', NULL, NULL, NULL, NULL, NULL, 0.000, 0.000, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'ONE_TIME', NULL, NULL, NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d733c2dd-f5f0-4b88-b675-1447fc30d821', 'PAID-IMP-003', NULL, NULL, 'APPROVED', '2026-07-03 08:00:00+00', 4500.00, 'PAID', 'NEW', 'IMPORT', 'WITHOUT_RETURN', NULL, 'Bole Lemi Industrial Park, Addis Ababa', 180.000, false, 'ETB', NULL, NULL, NULL, 1, NULL, '2026-08-09 20:15:36.249+00', NULL, NULL, NULL, NULL, 20, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, '7d1b9c9c-372a-41ea-8125-363163fc6351', '91c3912b-036a-4a09-b9f7-f70d0da0b717', '76ec1857-294d-4eef-95ab-84b0eff3261c', NULL, 'Demo container cargo', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'CONTAINER', NULL, NULL, NULL, '300d5510-e3a5-4858-bc28-6e3beda8ca80', 6.00, 'NOT_SCHEDULED', NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, '245bde93-5dfd-4adf-9b1a-5386169a46ec', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 8.9806000, 38.8736000, false, NULL, false, '2026-07-03 08:00:00+00', NULL, NULL, 'CUSTOMER', NULL, NULL, NULL, NULL, NULL, 0.000, 0.000, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'ONE_TIME', NULL, NULL, NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d1d73d4d-c2c9-4025-af7c-5c2c5327e9f1', 'PAID-EXP-001', NULL, NULL, 'APPROVED', '2026-07-01 10:00:00+00', 4900.00, 'PAID', 'NEW', 'EXPORT', 'WITHOUT_RETURN', 'Bole Lemi Industrial Park, Addis Ababa', NULL, 196.000, false, 'ETB', NULL, NULL, NULL, 1, NULL, '2026-08-09 20:15:36.258+00', NULL, NULL, NULL, NULL, 20, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, '91c3912b-036a-4a09-b9f7-f70d0da0b717', '7d1b9c9c-372a-41ea-8125-363163fc6351', '76ec1857-294d-4eef-95ab-84b0eff3261c', NULL, 'Demo container cargo', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'CONTAINER', NULL, NULL, NULL, '300d5510-e3a5-4858-bc28-6e3beda8ca80', 7.00, 'NOT_SCHEDULED', NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, '245bde93-5dfd-4adf-9b1a-5386169a46ec', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 8.9806000, 38.8736000, NULL, NULL, false, NULL, false, '2026-07-01 10:00:00+00', NULL, NULL, 'CUSTOMER', NULL, NULL, NULL, NULL, NULL, 0.000, 0.000, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'ONE_TIME', NULL, NULL, NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('524ef40f-a1ee-401d-8ecb-f1ce9f5374e4', 'PAID-EXP-002', NULL, NULL, 'APPROVED', '2026-07-02 10:00:00+00', 5500.00, 'PAID', 'NEW', 'EXPORT', 'WITHOUT_RETURN', 'Akaki Industrial Zone, Addis Ababa', NULL, 220.000, false, 'ETB', NULL, NULL, NULL, 1, NULL, '2026-08-09 20:15:36.267+00', NULL, NULL, NULL, NULL, 20, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, '91c3912b-036a-4a09-b9f7-f70d0da0b717', '7d1b9c9c-372a-41ea-8125-363163fc6351', '76ec1857-294d-4eef-95ab-84b0eff3261c', NULL, 'Demo container cargo', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'CONTAINER', NULL, NULL, NULL, '300d5510-e3a5-4858-bc28-6e3beda8ca80', 5.50, 'NOT_SCHEDULED', NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, '245bde93-5dfd-4adf-9b1a-5386169a46ec', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 8.8808000, 38.7876000, NULL, NULL, false, NULL, false, '2026-07-02 10:00:00+00', NULL, NULL, 'CUSTOMER', NULL, NULL, NULL, NULL, NULL, 0.000, 0.000, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'ONE_TIME', NULL, NULL, NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ec0da804-5163-4f1f-87a7-8a9215159146', 'PAID-EXP-003', NULL, NULL, 'APPROVED', '2026-07-03 10:00:00+00', 3200.00, 'PAID', 'NEW', 'EXPORT', 'WITHOUT_RETURN', 'Kality Logistics Hub, Addis Ababa', NULL, 128.000, false, 'ETB', NULL, NULL, NULL, 1, NULL, '2026-08-09 20:15:36.275+00', NULL, NULL, NULL, NULL, 20, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, '91c3912b-036a-4a09-b9f7-f70d0da0b717', '7d1b9c9c-372a-41ea-8125-363163fc6351', '76ec1857-294d-4eef-95ab-84b0eff3261c', NULL, 'Demo container cargo', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'CONTAINER', NULL, NULL, NULL, '300d5510-e3a5-4858-bc28-6e3beda8ca80', 4.00, 'NOT_SCHEDULED', NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, '245bde93-5dfd-4adf-9b1a-5386169a46ec', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 8.9137000, 38.7815000, NULL, NULL, false, NULL, false, '2026-07-03 10:00:00+00', NULL, NULL, 'CUSTOMER', NULL, NULL, NULL, NULL, NULL, 0.000, 0.000, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'ONE_TIME', NULL, NULL, NULL, NULL, NULL, false, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL);
+
+
+--
+-- Data for Name: cargo_type_wagon_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.cargo_type_wagon_types VALUES
+	('654618d6-a380-4e4c-aa60-2bb1c299066a', '8eec3a7d-8482-4397-96b6-59a028210722'),
+	('8291ccc3-0dd9-4d78-aa44-284d028a19ce', '8eec3a7d-8482-4397-96b6-59a028210722'),
+	('9afd8eb3-975b-4ea7-a7db-04eb2c20a04d', '8eec3a7d-8482-4397-96b6-59a028210722'),
+	('8942884d-9991-42bb-87f7-a70930f8c43c', 'efed186d-7062-4b0f-b3fe-6e793accc364'),
+	('8942884d-9991-42bb-87f7-a70930f8c43c', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc'),
+	('8291ccc3-0dd9-4d78-aa44-284d028a19ce', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7'),
+	('654618d6-a380-4e4c-aa60-2bb1c299066a', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7'),
+	('28bc4d22-5bc5-4917-b1af-bb08d28f2a05', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7');
+
+
+--
+-- Data for Name: cargo_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.cargo_types VALUES
+	('01819bdb-e8c5-4691-ab99-1b351c5dc5b8', 'Break Bulk', NULL, false, true, 3, '2026-07-17 08:11:10.616+00', '2026-07-17 08:11:10.616+00', NULL, 'BREAK_BULK', NULL, false, NULL, NULL, false),
+	('7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', 'Bulk', NULL, false, true, 2, '2026-07-17 08:10:31.902+00', '2026-07-21 06:42:40.053+00', NULL, 'BULK', NULL, false, NULL, NULL, false),
+	('eb5f5443-5801-48d1-8bb8-7494645c5e10', 'Edible Oil', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 5, '2026-07-17 08:12:08.784+00', '2026-07-22 13:30:11.083+00', NULL, 'EDIBLE_OIL', 'PER_TON', false, NULL, NULL, false),
+	('b92c7644-ac4c-46bf-80bb-6c5c07151e07', 'Cereal', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 7, '2026-07-17 08:12:42.731+00', '2026-07-22 13:30:14.763+00', NULL, 'CEREAL', 'PER_TON', false, NULL, NULL, false),
+	('ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', 'Rice', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 9, '2026-07-17 08:13:07.476+00', '2026-07-22 13:30:23.977+00', NULL, 'RICE', 'PER_TON', false, NULL, NULL, false),
+	('e08693a4-ce28-4f2d-aca3-58537d4cb8bb', 'Plastic Barrel', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 13, '2026-07-17 08:15:30.092+00', '2026-07-22 13:30:28.952+00', NULL, 'PLASTIC_BARREL', 'PER_TON', false, NULL, NULL, false),
+	('a5991d3a-d690-4b7e-98fd-ea3333aa16e7', 'Perishable', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 14, '2026-07-17 11:09:25.02+00', '2026-07-22 13:30:33.208+00', NULL, 'PERISHABLE', 'PER_TON', false, NULL, NULL, false),
+	('d700fe89-18f4-40ce-860a-7c6b17966929', 'Livestock', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 15, '2026-07-17 11:10:13.881+00', '2026-07-22 13:30:37.803+00', NULL, 'LIVESTOCK', 'PER_TON', false, NULL, NULL, false),
+	('b0de5ed1-6bc1-47b7-ab27-a519b27d4f02', 'Truck', '01819bdb-e8c5-4691-ab99-1b351c5dc5b8', true, true, 11, '2026-07-17 08:14:06.53+00', '2026-07-22 13:30:55.108+00', NULL, 'TRUCK', 'PER_ITEM', false, NULL, NULL, false),
+	('bc9989ca-878c-43a7-ad2b-2a6c7899c956', 'Automobile', '01819bdb-e8c5-4691-ab99-1b351c5dc5b8', true, true, 12, '2026-07-17 08:14:24.494+00', '2026-07-22 13:31:00.55+00', NULL, 'AUTOMOBILE', 'PER_ITEM', false, NULL, NULL, false),
+	('9afd8eb3-975b-4ea7-a7db-04eb2c20a04d', 'Beans', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 8, '2026-07-17 08:12:55.727+00', '2026-07-23 08:35:07.031+00', NULL, 'BEANS', 'PER_TON', false, NULL, NULL, false),
+	('8942884d-9991-42bb-87f7-a70930f8c43c', 'Sand', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', false, true, 16, '2026-08-04 13:16:23.713991+00', '2026-08-04 13:16:23.713991+00', NULL, 'SAND', 'PER_TON', false, NULL, NULL, false),
+	('9462ef16-5609-4d5c-8f0d-d0acdb0f8b06', 'Bagged material ', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 17, '2026-08-05 12:21:43.982192+00', '2026-08-05 12:21:43.982192+00', NULL, 'BAGGED_MATERIAL', 'PER_TON', false, NULL, NULL, false),
+	('700bbbb8-e31d-4860-8227-47a5496dd81b', 'Sugar', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 18, '2026-08-05 13:11:44.508815+00', '2026-08-05 13:11:44.508815+00', NULL, 'SUGAR', 'PER_TON', false, NULL, NULL, false),
+	('9c2bc39e-1fe8-418c-b187-c0b2329faeb9', 'Barley ', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 19, '2026-08-05 13:11:57.854525+00', '2026-08-05 13:11:57.854525+00', NULL, 'BARLEY', 'PER_TON', false, NULL, NULL, false),
+	('8291ccc3-0dd9-4d78-aa44-284d028a19ce', 'Steel Billet', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 4, '2026-07-17 08:11:46.837+00', '2026-08-05 21:41:38.88368+00', NULL, 'STEEL_BILLET', 'PER_TON', false, NULL, '{"8eec3a7d-8482-4397-96b6-59a028210722": 10, "8f717b09-eec1-46ad-be3d-2dc0a56e55e7": 40}', false),
+	('654618d6-a380-4e4c-aa60-2bb1c299066a', 'Wheat', '7b65e1a1-3ea2-4983-90a9-9f8c55b8e6a8', true, true, 6, '2026-07-17 08:12:27.364+00', '2026-08-07 08:02:34.071071+00', NULL, 'WHEAT', 'PER_TON', false, NULL, '{"8eec3a7d-8482-4397-96b6-59a028210722": 20, "8f717b09-eec1-46ad-be3d-2dc0a56e55e7": 30}', false),
+	('28bc4d22-5bc5-4917-b1af-bb08d28f2a05', 'Machinery', '01819bdb-e8c5-4691-ab99-1b351c5dc5b8', true, true, 10, '2026-07-17 08:13:36.728+00', '2026-08-07 13:35:47.802609+00', NULL, 'MACHINERY', 'PER_ITEM', false, '{"8f717b09-eec1-46ad-be3d-2dc0a56e55e7": 2}', NULL, false);
+
+
+--
+-- Data for Name: cargoes; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: clearance_incidents; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: clearance_milestones; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: companies; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.companies VALUES
+	('37f9df6c-95a8-41a6-81fc-4ece3c31a712', 'DROGA PHARMACY PLC', 'customer', 'pending', '0106791545', '4109476001', NULL, 'Ethiopia', '443/ሀ, 08, Yeka, Addis Ababa, Addis Ababa', '+251923495365', 'hilina@gmail.com', NULL, '{"gmName": null, "gmEmail": null, "gmPhone": null, "poaName": "Hilina Melese Argaw", "gmGender": null, "poaPhone": "+251983828931", "gmAddress": null, "ownerName": "Naod Zerihun Abasiessie", "poaGender": "Female", "gmFaydaSub": null, "ownerEmail": "hilina@gmail.com", "ownerPhone": "+251923495365", "poaAddress": "Woreda 09 , Gullele , Addis Ababa ", "gmBirthdate": null, "ownerGender": "Male", "poaFaydaSub": "346656481773876498640208713502828683", "ownerAddress": "Woreda 09 , Nifas Silk-Lafto , Addis Ababa ", "poaBirthdate": "1994/12/25", "gmSameAsOwner": null, "ownerFaydaSub": "289187692944872799283592982484991027", "ownerBirthdate": "1994/04/01", "contactPersonName": "Naod Zerihun Abasiessie", "gmFaydaVerifiedAt": null, "contactPersonEmail": "hilina@gmail.com", "contactPersonPhone": "+251923495365", "generalManagerName": null, "poaFaydaVerifiedAt": "2026-08-09T12:13:50.422Z", "generalManagerEmail": null, "generalManagerPhone": null, "ownerFaydaVerifiedAt": "2026-08-09T11:56:55.950Z"}', '2026-08-09 11:55:07.463423+00', '2026-08-09 14:03:01.699685+00', NULL, NULL, NULL, NULL, NULL, NULL, 'ethiopian', 'AACATB/14/672/50355147/2018', 'Is active', '4/22/2026', '4/22/2026', '4/22/2026', '12/31/2026', 'Addis Ababa', 'Addis Ababa', 'Yeka', '08', '443/ሀ', '+251913667537', 'commercial', NULL),
+	('300d5510-e3a5-4858-bc28-6e3beda8ca80', 'Paid Import/Export Mile Demo Customer', 'customer', 'active', 'PAIDMILE01', 'PAIDMILE01', 'PMD0000000000001', 'Ethiopia', 'Addis Ababa', '251900000202', 'paid-mile-demo@edr.local', NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, 'Paid Mile Demo', '251900000202', 'Demo Manager', 'paid-mile-demo@edr.local', '251900000202', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'commercial', NULL);
+
+
+--
+-- Data for Name: company_change_request; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: company_profiles; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.company_profiles VALUES
+	('532231d2-5be3-4aec-bacc-2d3a25fc5eb3', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', 'importer', NULL, 'pending', NULL, NULL, '2026-08-09 11:55:07.47001+00', '2026-08-09 11:55:07.47001+00', NULL, NULL, NULL, NULL, NULL),
+	('dfd3c985-79bb-487f-ac21-e68c6f91d06e', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', 'exporter', NULL, 'pending', NULL, NULL, '2026-08-09 11:55:07.471931+00', '2026-08-09 11:55:07.471931+00', NULL, NULL, NULL, NULL, NULL),
+	('0ef21f70-a710-4669-9c22-de7f2988177b', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', 'freight_forwarder', NULL, 'pending', NULL, NULL, '2026-08-09 11:55:21.399242+00', '2026-08-09 11:55:21.399242+00', NULL, NULL, NULL, NULL, NULL),
+	('245bde93-5dfd-4adf-9b1a-5386169a46ec', '300d5510-e3a5-4858-bc28-6e3beda8ca80', 'importer', NULL, 'active', 'PMD-LIC-0001', NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, NULL, NULL, NULL, NULL);
+
+
+--
+-- Data for Name: company_revisions; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.company_revisions VALUES
+	('a91bc6eb-d7f0-43cf-936b-7e1d6151341e', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', '70b7c52e-cd3c-4b74-89ea-3e4bd6c312c5', '12 fields changed', '[{"to": "DROGA PHARMACY PLC", "from": "Hilina''s company", "field": "name", "label": "Company name"}, {"to": "443/ሀ, 08, Yeka, Addis Ababa, Addis Ababa", "from": null, "field": "address", "label": "Address"}, {"to": "0106791545", "from": "D257513756", "field": "tin", "label": "TIN"}, {"to": "4109476001", "from": null, "field": "vatNumber", "label": "VAT number"}, {"to": "AACATB/14/672/50355147/2018", "from": null, "field": "licenceNumber", "label": "Licence number"}, {"to": "Addis Ababa", "from": null, "field": "region", "label": "Region"}, {"to": "Addis Ababa", "from": null, "field": "zone", "label": "Zone"}, {"to": "Yeka", "from": null, "field": "woreda", "label": "Woreda"}, {"to": "08", "from": null, "field": "kebele", "label": "Kebele"}, {"to": "443/ሀ", "from": null, "field": "houseNo", "label": "House No"}, {"to": "hilina@gmail.com", "from": null, "field": "email", "label": "Email"}, {"to": "+251923495365", "from": null, "field": "phone", "label": "Phone"}]', '2026-08-09 12:01:37.515024+00', '2026-08-09 12:01:37.515024+00', NULL),
+	('7a341d8a-2b30-4ac0-9dc7-b611d1dc9820', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', '70b7c52e-cd3c-4b74-89ea-3e4bd6c312c5', 'contact person name, contact person email, contact person phone changed', '[{"to": "Naod Zerihun Abasiessie", "from": null, "field": "contactPersonName", "label": "Contact person name"}, {"to": "hilina@gmail.com", "from": null, "field": "contactPersonEmail", "label": "Contact person email"}, {"to": "+251923495365", "from": null, "field": "contactPersonPhone", "label": "Contact person phone"}]', '2026-08-09 12:03:28.827201+00', '2026-08-09 12:03:28.827201+00', NULL),
+	('38ff2f0a-c2ab-4ac7-9eca-bb6db03dbf28', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', '70b7c52e-cd3c-4b74-89ea-3e4bd6c312c5', 'dars delegation paper changed', '[{"to": "sample (1).pdf", "from": null, "field": "document:poa_delegation_letter", "label": "DARS Delegation Paper", "toFileId": "cfbc6c70-fc9d-4fd4-81ba-acf07d5d713d", "fromFileId": null}]', '2026-08-09 12:14:15.139306+00', '2026-08-09 12:14:15.139306+00', NULL);
+
+
+--
+-- Data for Name: compliance_records; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: consignments; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: container_type_wagon_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.container_type_wagon_types VALUES
+	('77cf24ec-e74b-4bdb-b1cc-6f336379cc58', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7'),
+	('349072e7-8a90-4c03-b682-08976abfd7e8', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7'),
+	('77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc'),
+	('349072e7-8a90-4c03-b682-08976abfd7e8', 'efed186d-7062-4b0f-b3fe-6e793accc364'),
+	('349072e7-8a90-4c03-b682-08976abfd7e8', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc'),
+	('77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'efed186d-7062-4b0f-b3fe-6e793accc364'),
+	('349072e7-8a90-4c03-b682-08976abfd7e8', '4f65adc3-baf7-44de-88ad-0a4672fab669');
+
+
+--
+-- Data for Name: container_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.container_types VALUES
+	('77cf24ec-e74b-4bdb-b1cc-6f336379cc58', '20FT', '20FT', true, '2026-07-17 09:32:14.947+00', '2026-08-09 20:15:36.202428+00', NULL, 20, false, false, 1),
+	('349072e7-8a90-4c03-b682-08976abfd7e8', '40FT', '40FT', true, '2026-07-17 09:38:14.519+00', '2026-08-09 20:15:36.202428+00', NULL, 40, false, false, 2);
+
+
+--
+-- Data for Name: containers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_approval_steps; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_cargo_scope; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_clearance_cycles; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_document_review; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_document_revisions; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_rate_snapshots; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_review_notes; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_routes; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_signatures; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: contract_templates; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.contract_templates VALUES
+	('8a2b08fc-1c9d-44b3-aac2-8b268215314c', 'INTERCITY_CONTAINER', 'Container Intercity Contract', 'Domestic (intercity) container transport by railway between Ethiopian terminals — Galaan Multipurpose Port, Modjo dry port, and Dire Dawa — including empty repositioning.', 'Intercity Container Transport Service by Railway', '["The Client has requested and agreed to the transportation of container cargo between the agreed Ethiopian railway terminals (Galaan Multipurpose Port (GMP), Modjo dry port, and Dire Dawa), including the repositioning of empty containers between those terminals, using the Addis Ababa–Djibouti railway line within Ethiopia.", "The Service Provider has agreed to transport the container cargo as per the terms of this contract."]', '[{"id": "objective", "body": "To provide domestic railway transportation services for 40ft and/or 20ft full containers between the agreed Ethiopian terminals (Galaan Multipurpose Port (GMP), Modjo dry port, and Dire Dawa), and the repositioning of empty containers between those terminals.\nThe scope of the services comprises:\n- Railway transport service between the agreed origin and destination terminals.\n- Cargo handling at Galaan Multipurpose Port (GMP).", "order": 1, "title": "Objective and Scope of the Services"}, {"id": "client-obligations", "body": "Give written/email/electronic shipment instructions to the Service Provider for transportation of container cargo between the agreed terminals.\nPrepare all necessary documents and facilities for shipment.\nEnsure the minimum supply of containers per shipment agreed with the Service Provider for the selected loading terminal and destination.\nOne flat wagon must carry either one 40ft container or two 20ft containers.\nIf two 20ft containers are loaded on one flat wagon, their weight difference must not exceed 10 tons.\nEnsure timely loading and unloading of cargo.\nAssign representatives at both ends to oversee container handover and ensure the necessary arrangements for cargo reception at the destination upon arrival.\nMaintain and provide detailed cargo information (type, weight, destination, etc.).\nBe responsible for cargo handling, loading, and unloading of both empty and full containers at Modjo and Dire Dawa dry port.\nBook wagons at least five (5) days in advance.\nEnsure containers are ready one day before the planned loading date.\nCollect the full container from Galaan Multipurpose Port (GMP) within three (3) calendar days from the day following the arrival notice.\nIf the Client fails to collect the container within the specified period, the Service Provider shall have the right to reposition the container to any location it deems appropriate; in such case, the Service Provider shall not be held responsible for any damage or loss arising from such repositioning.\nIf the Client fails to collect the container from Galaan Multipurpose Port within the specified period, the Client shall be liable to pay demurrage charges of 15 USD per day per 20ft container and 27 USD per day per 40ft container, calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date of payment.\nIn the event the Client fails to collect the container(s) within the specified period, the Client shall be liable to pay double handling charges of 27 USD per 20ft container per handling or 40 USD per 40ft container per handling.\nCollect the containers within one day at Dire Dawa and Modjo dry port, or make the necessary payment to the dry port as per the standard of the dry port.\nOnce empty containers are returned from the Client''s premises and stored at a dry port while awaiting train allocation, any demurrage and/or storage charges incurred from the dry port thereafter shall be the sole responsibility of the Client.\nProvide clean empty containers that meet the receiving terminal''s standards; additional cleaning costs incurred due to non-compliance will be borne by the Client.\nEnsure containers are structurally intact and meet weight distribution requirements.\nProhibited cargo: cargo covered with tarpaulin is not allowed due to safety risks.\nNotify the Service Provider forty-eight (48) hours in advance before wagon booking if transporting hazardous or valuable goods.\nIf a booked wagon is not loaded due to Client-related issues, including but not limited to a damaged container, missing lock, unpaid demurrage, port system errors, or incomplete documentation and submission, the Client shall be charged 100% of the total price of the reserved wagon.\nRefund requests before wagon booking require an official request, with a 3% administrative fee deducted. If the refund is due to the Service Provider, the Client shall receive a full refund. Refunds not requested and completed within six months shall be considered waived.\nPay 100% of the transportation fee in advance for each train set.\nSettle additional penalties due to non-compliance within ten (10) days of invoice issuance.\nLate payment incurs a penalty of an additional 10%.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Assign the necessary voyage based on the operational schedule and cargo demand, and notify the train schedule 48 hours in advance.\nProvide a list of wagons/voyage or train number 24 hours in advance and update corrections 12 hours before arrival.\nProvide safe transportation of the containers.\nDeliver the cargo within two (2) days after train departure, provided that all required documents are submitted on time and no unforeseen circumstances or events occur.\nIn the event of export cargo operations, the Service Provider may prioritize the loading of export containers during the loading of empty containers and the unloading of containers from the train at Galaan Multipurpose Port.\nThe Service Provider reserves the right to refuse the transportation of any cargo classified as dangerous goods.\nIf any operational, technical, or mechanical problem occurs throughout the transit, notify the Client and the relevant authorities and arrange cargo transfer within four (4) days.\nProvide accident or defect reports if needed.\nBuy cargo liability insurance for each wagon.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "The applicable rate per 40ft container or per two (2) 20ft containers for the agreed route is set out in the Rate Schedule immediately below, expressed as a unit price per origin → destination lane and per container.\nIf cargo exceeds 40 tons per two 20ft containers of gross weight, additional charges apply proportionally.\nGross weight shall be the total sum of cargo, packing, and container tare weight.\nPayment for any additional tonnage shall be made in advance before the container is loaded onto the wagon.\nThe price of loading and unloading and container handling at Modjo and Dire Dawa dry port is not part of this contract; it is the Client''s responsibility.\nAdditional costs (if applicable):\n- Last-mile delivery service by truck from the destination terminal to the Client''s premises shall incur an additional cost, fully covered by the Client.\n- For clients utilizing EDR''s last-mile logistics services, the applicable charges shall vary based on the cargo movement route and shall be communicated to the Client by the Service Provider after receiving the necessary details regarding the cargo destination, type, and weight.\nAll payments shall be made one hundred percent (100%) in advance.\nPayment may be made in Ethiopian Birr based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date the wagon or train number is provided; if the exchange rate changes between the payment and the wagon assignment date, adjustments will be made accordingly.", "order": 5, "title": "Contract Price and Terms of Payment"}, {"id": "contract-documents", "body": "The following documents constitute this contract:\n- Amendments (if any).\n- This Contract Agreement.\n- Final minutes of negotiation (if any).\nIf there is any discrepancy between the documents, they shall be interpreted with priority in the order listed above.", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "Equipment Interchange Receipt, Railway Waybill, Container Carriage Acceptance Sheet, and incidental charges (if any).\nPayment summary as per the agreed contract price (if required).", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over and handing over of the container cargo on the Freight Carriage Acceptance Sheet of EDR in an appropriate manner and provide it to the Client.\nThe Freight Carriage Acceptance Sheet shall be prima facie evidence of the receipt of the container cargo by the Service Provider and of the kind, number, and weight of the goods.\nUpon delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 8, "title": "Consignment Notes"}, {"id": "amendment", "body": "This contract can be amended by mutual agreement.\nNotwithstanding the above, the Service Provider may revise transport tariffs due to operational and regulatory changes by providing at least five (5) working days'' prior written notice to the Client.", "order": 9, "title": "Amendment"}, {"id": "termination", "body": "The contract may be terminated:\n- By mutual agreement.\n- Upon completion of the contract period or agreed cargo shipments.\n- If either party breaches fundamental terms.", "order": 10, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "The contract is valid once signed by both parties.", "order": 11, "title": "Contract Effectiveness"}, {"id": "duration", "body": "Valid until August 31, {{contractYear}}, with a possible extension upon mutual agreement.", "order": 12, "title": "Contract Period"}, {"id": "disputes", "body": "Disputes shall be settled amicably.\nIf unresolved, disputes shall be taken to the Federal Court in Addis Ababa.", "order": 13, "title": "Settlement of Disputes"}]', true, '2026-07-27 11:32:03.38554+00', '2026-07-27 11:32:03.38554+00', NULL, NULL, NULL, true),
+	('c5c1537b-bf5a-4f5b-aa73-ddc086f798d3', 'IMPORT_CONTAINER_NO_CUSTOMS', 'Container Import Contract', 'Import container transport by railway from SGTD (Djibouti) to Dire Dawa, Modjo dry port, or Galaan Multipurpose Port, with empty-container return.', 'Import Container Transport Service by Railway', '["The Client has requested and agreed to the transportation of container cargo from SGTD railway freight station at Djibouti to Dire Dawa, Modjo dry port, and Galaan Multipurpose Port (GMP), and the return of empty containers from Dire Dawa, Modjo dry port, and Galaan Multipurpose Port (GMP) to SGTD railway freight station using the Addis Ababa–Djibouti railway line.", "The Service Provider has agreed to transport the container cargo as per the terms of this contract."]', '[{"id": "objective", "body": "To provide railway transportation services for 40ft and/or 20ft full containers from SGTD to Dire Dawa , Modjo dry port, Galaan Multipurpose port (GMP)  and Sebeta Railway Freight station and empty container return from Dire Dawa , Modjo dry port and Galaan Multipurpose port (GMP) and Sebeta Railway Station to SGTD.\nScope of the Services\n- Railway transport service.\n- Cargo handling at Galaan Multipurpose port and Sebeta Railway Station", "order": 1, "title": "Objective and Scope of the Services"}, {"id": "client-obligations", "body": "Give written/email/electronic shipment instructions to the Service Provider for transportation of container cargo from SGTD to Dire Dawa, Modjo dry port, Galaan Multipurpose Port (GMP) and Sebeta Railway Station.\nPrepare all necessary documents and facilities for shipment.\nEnsure the following minimum supply of containers per shipment based on the loading terminal and destination:\n- Minimum of twenty-five (25) 40ft containers or fifty (50) 20ft containers to Modjo dry port.\n- Minimum of ten (10) 40ft containers or twenty (20) 20ft containers to Dire Dawa dry port.\n- Minimum of one (1) 40ft container or two (2) TEU to Galaan Multipurpose Port (GMP).\n- Minimum of one (1) 40ft container or two (2) TEU to Sebeta Railway Station.\nOne flat wagon must carry either one 40ft container or two 20ft containers.\nIf two 20ft containers are loaded on one flat wagon, their weight difference must not exceed 10 tons.\nEnsure timely loading and unloading of cargo.\nAssign representatives at both ends to oversee container handover and ensure the necessary arrangements for cargo reception at the destination upon arrival.\nMaintain and provide detailed cargo information (type, weight, destination, etc.).\nBe responsible for cargo handling, loading, and unloading of both empty and full containers at Modjo, Dire Dawa dry port, and SGTD.\nBook wagons at least five (5) days in advance.\nEnsure containers are ready one day before the planned loading date.\nSubmit all required documents to the Djibouti Nagad station at least 24 hours in advance before starting to load. Failure to submit the documents within the stipulated time shall result in the following demurrage charges, calculated as a percentage of the booked wagon price:\n- Delay of up to twelve (12) hours: 20% of the booked wagon price.\n- Delay exceeding twelve (12) hours but not more than one (1) day: 50% of the booked wagon price.\n- Delay of more than one (1) day: 100% of the booked wagon price.\nCollect the full container from Galaan Multipurpose Port (GMP) within three (3) calendar days from the day following the arrival notice.\nIf the Client fails to collect the container within the specified period, the Service Provider shall have the right to reposition the container to any location it deems appropriate; in such case, the Service Provider shall not be held responsible for any damage or loss arising from such repositioning.\nIf the Client fails to collect the container from Galaan Multipurpose Port within the specified period, the Client shall be liable to pay demurrage charges of 15 USD per day per 20ft container and 27 USD per day per 40ft container, calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date of payment.\nIn the event the Client fails to collect the container(s) within the specified period, the Client shall be liable to pay double handling charges of 27 USD per 20ft container per handling or 40 USD per 40ft container per handling, calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date of payment.\nIf empty containers cannot be offloaded from the train upon arrival at SGTD due to any Client-related issue, the Client shall be liable for the applicable penalty charges.\nPenalty charges for delay at SGTD/Nagad upon train arrival: 20 USD per day per 20ft container; 33 USD per day per 40ft container.\nCollect the containers within one day at Dire Dawa and Modjo dry port, or make the necessary payment to the dry port as per the standard of the dry port.\nFor returning empty containers, deliver to Dire Dawa dry port, Modjo dry port,Galaan Multipurpose Port and Sebeta Railway Station.\nOnce the empty containers are returned from the Client''s premises and stored at Dire Dawa/Modjo dry port while awaiting train allocation for return to SGTD, any demurrage and/or storage charges incurred from the dry port thereafter shall not be the responsibility or liability of the Service Provider; the Client shall be solely responsible for settling such charges.\nProvide clean empty containers that meet SGTD standards. If the port refuses to take over an empty container because of inside cleanliness problems, additional cleaning costs incurred due to non-compliance will be borne by the Client.\nEnsure containers are structurally intact and meet weight distribution requirements.\nProhibited cargo: cargo covered with tarpaulin is not allowed due to safety risks.\nNotify the Service Provider forty-eight (48) hours in advance before wagon booking if transporting hazardous or valuable goods.\nIf a booked wagon is not loaded due to Client-related issues, including but not limited to a damaged container, missing lock, unpaid demurrage, port system errors, or incomplete documentation and submission, the Client shall be charged 100% of the total price of the reserved wagon.\nRefund requests before wagon booking require an official request, with a 3% administrative fee deducted. If the refund is due to the Service Provider, the Client shall receive a full refund. Refunds not requested and completed within six months shall be considered waived.\nPay 100% of the transportation fee in advance for each train set.\nSettle additional penalties due to non-compliance within ten (10) days of invoice issuance.\nLate payment incurs a penalty of an additional 10%.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Assign the necessary voyage based on the operational schedule and cargo demand, and notify the train schedule 48 hours in advance.\nProvide a list of wagons/voyage or train number 24 hours in advance and update corrections 12 hours before arrival.\nProvide safe transportation of the containers.\nDeliver the cargo within two (2) days after train departure, provided that all required documents are submitted on time and no unforeseen circumstances or events occur.\nReturn empty containers from Dire Dawa, Modjo, Galaan Multipurpose Port and Sebeta Railway Station to SGTD within seven (7) calendar days of receipt.\nIn the event of export cargo operations, the Service Provider may prioritize the loading of export containers during the loading of empty containers and the unloading of import containers from the train at Galaan Multipurpose Port.\nThe Service Provider reserves the right to refuse the transportation of any cargo classified as dangerous goods.\nIf any operational, technical, or mechanical problem occurs throughout the transit, notify customs and arrange cargo transfer within 4 days if the incident occurs in Ethiopia, or within 6 days if it occurs in Djibouti.\nProvide accident or defect reports if needed.\nBuy cargo liability insurance for each wagon.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "1. From {{schedule.originLabel}} to {{schedule.destinationLabel}} dry port the rate is USD 919 per one 40ft or USD 942 per two 20ft containers with empty return, USD 762 per one 40ft or USD 780 per two 20ft containers without empty return.\n1. From SGTD to Modjo, the rate is USD 1,781 per one 40ft or USD 1,808 per two 20ft containers with empty return, and USD 1,507 per 40 ft and or two 20ft containerswithout empty return.\n1. From SGTD to Gelan Multipurpose port, the rate is USD 1,916 per one 40ft or USD 1,944 per two 20ft containers with empty return, and USD 1,676 per one 40ft or USD 1,690 per two 20ft containers without empty return.\n1. From SGTD to Sebeta Railway Station, the rate is USD 1,993 per one 40ft or USD 2,021 per two 20ft containers with empty return, and USD 1,753 per one 40ft or USD 1,763 per two 20ft containers without empty return.\n1. If cargo exceeds 40 tons per 2*20ft of gross weight, additional charges apply proportionally.\n1. Gross weight shall be the total sum of Cargo, Packing and Container tare weight.\n1. Payment for any additional tonnage shall be made in advance before the container is loaded onto the wagon.\n1. The price of loading and unloading, and Container handling at Modjo , Diredawa dry port and SGTD container railway freight yard is not part of this contract, it is client’s responsibility.\n- Additional Costs (If Applicable):\n- Last mile delivery service by truck, from Galaan Multipurpose port or Modjo to Addis Ababa, Modjo, Sebeta and surrounding areas, shall incur an additional cost, which shall be fully covered by the client.\n- For clients utilizing EDR''s last mile logistics services, the applicable charges shall vary based on the cargo movement route.\n- The charge for last mile delivery-from Galaan Multipurpose port and Modjo dry port or Sebeta railway Station shall be communicated to the client by service provider after receiving the necessary details from the client regarding the cargo destination, type and weight.\n1. Terms of payment\n- All payments shall be made one hundred percent (100%) in advance in United States Dollars (USD).", "order": 5, "title": "Contract Price and Terms of Payment"}, {"id": "contract-documents", "body": "1. The following documents constitute this contract:\n- Amendments (if any)\n- This Contract Agreement\n- Final Minutes of Negotiation (if any)\n1. If there is any discrepancy between the documents, they shall be interpreted prioritized in the order they are listed above", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "Equipment Interchange Receipt of SGTD, Railway Waybill, Container Carriage Acceptance Sheet, and incidental charges (if any).\nPayment summary as per the agreed contract price (if required).", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "1. The service provider must certify the taking over and handing over of the container cargo on Freight Carriage Acceptance Sheet of EDR inappropriate manner and provide to the client.\n1. Freight Carriage Acceptance Sheet shall be prima facie evidence of the receipt of the container cargo by service provider, the kind, number, and weight of the goods.\n1. Upon delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 8, "title": "Consignment Notes"}, {"id": "amendment", "body": "This contract can be amended by mutual agreement.\nNotwithstanding the above, the Service Provider may revise transport tariffs due to operational and regulatory changes by providing at least five (5) working days'' prior written notice to the Client.", "order": 9, "title": "Amendment"}, {"id": "termination", "body": "The contract may be terminated:\n- By mutual agreement.\n- Upon completion of the contract period or agreed cargo shipments.\n- If either party breaches fundamental terms.", "order": 10, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "Valid until {{contractEndDate}} with a possible extension upon mutual agreement.", "order": 11, "title": "Contract Effectiveness"}, {"id": "duration", "body": "Valid until {{contractEndDate}} with a possible extension upon mutual agreement.", "order": 12, "title": "Contract Period"}, {"id": "disputes", "body": "1. Disputes shall be settled amicably.\n1. If unresolved, disputes shall be taken to the Federal Court in Addis Ababa.", "order": 13, "title": "Settlement of Disputes"}]', true, '2026-07-27 11:32:03.38554+00', '2026-08-06 06:34:05.034588+00', NULL, NULL, NULL, true),
+	('52a4ae5c-f5a6-4b24-b253-1d484d9fb7c2', 'EXPORT_CONTAINER_NO_CUSTOMS', 'Container Export Contract', 'Export container transport, freight forwarding, and customs clearing from Galaan Multipurpose Port or Modjo dry port to SGTD container freight station (Djibouti).', 'Export Container Transport, Freight Forwarding and Customs Clearing Service', '["The parties have agreed on the following services: rail transport, customs clearance, transit work, freight forwarding, and handling of container cargo."]', '[{"id": "objective", "body": "1. The objective of this Contract is to provide railway container transport services for 20ft and/or 40ft full containers from Galaan Multipurpose Port (GMP), Modjo Dry Port, Dire Dawa Dry Port, and/or Sebeta Railway Station, Ethiopia, to SGTD, Djibouti, through the Addis Ababa–Djibouti Standard Gauge Railway line.\n1. Scope of the Services\n- The Service Provider shall provide:\n- Railway transportation services for export containers;\n- Cargo handling services at Galaan Multipurpose Port (GMP) and Sebeta Railway station.", "order": 1, "title": "Objective and Scope of the Services"}, {"id": "client-obligations", "body": "1. Provide written instructions, including by email or other electronic means, to the Service Provider for the transportation of container cargo from Galaan Multipurpose Port, Dire Dawa Dry Port, Modjo Dry Port, and/or Sebeta Railway Station to SGTD.\n1. Supply a minimum of two (2) 20ft containers (or an equivalent load to fill one wagon).\n1. Booking requests must be submitted at least Seventy-Two (72) hours before the scheduled train departure and must align with the vessel cut-off time.\n1. Maintain and provide detailed cargo information (type, weight, destination, etc.).\n1. For clients requiring first-mile service, a first-mile service request notice must be submitted no less than seventy-two (72) hours in advance.\n1. All cargo and documents must be delivered to the designated loading station no later than 11:59 PM on the day before the scheduled loading or train departure date.\n1. Failure to meet the stated deadlines may result in cancellation of the booking and transfer arrangements. Any resulting delays, penalties, or additional costs shall be the sole responsibility of the Client.\n1. The Client shall mandatorily submit a valid Release Order prior to loading the cargo onto the train.\n1. Prepare necessary documents and facilities for shipment.\n1. Submit scanned soft copies of all original shipping and customs documents in advance to EDR, SGTD, and Djibouti Customs at least 24 hours before the train arrives in Djibouti.\n1. The Client shall email the soft copies of EX8/EX3 and T1 documents to Djibouti Customs (customkhaire-dj80@gmail.com), SGTD (abdoulkader.ismail@dct.dj), and to the Client’s Djibouti agent counterpart at least twenty-four (24) hours prior to the train’s arrival in Nagad, Djibouti.\n1. Containers must have 4 undamaged corners.\n1. One wagon must carry either one 40ft container or two 20ft containers.\n1. If two 20ft containers are loaded on one wagon, their weight difference must not exceed 10 tons.\n1. Prohibited Cargo: Cargo covered with tarpaulin is not allowed due to safety risks.\n1. The client shall complete gate pass processing and submit it to Nagad Station for each shipment within eighteen (18) hours after train departure. And ensure necessary arrangements for cargo reception at the destination (SGTD) upon arrival.\n1. If a delay occurs due to incomplete export documentation, customs clearance failure, or any omission attributable to the Client after the arrival of the train at the destination (SGTD), the Client shall pay demurrage charges at the rate of USD 1,690.00 per wagon per day.\n- Demurrage shall accrue as follows:\n- Delay up to twelve (12) hours: 25% of the applicable daily demurrage;\n- Delay exceeding twelve (12) hours but not exceeding twenty-four (24) hours: 50% of the applicable daily demurrage\n- Delay exceeding twelve (12) hours but not exceeding twenty-four (24) hours:100% of the applicable daily demurrage\n1. Demurrage charges shall continue to accrue for each additional calendar day until the cause of delay is rectified and the wagon is released.\n1. In addition to Clause 17, the client may bear additional costs for storage, document preparation, and loading or unloading containers, reimbursed by the client per official receipt.\n1. If the client fails to deliver the container, complete export documents as per Article 2, Sub-Article 6, or cancels after wagon reservation, they shall pay USD 150.00 per wagon as a penalty.\n1. Refund requests before wagon booking require an official request, with a 3% administrative fee deducted. If the refund is due to the service provider, the client shall receive a full refund. Refunds not requested and completed within six months shall be considered waived.\n1. The gross weight of the container must not exceed the standard loading capacity indicated on the container. The client is responsible for ensuring full compliance with the maximum allowable load.\n1. If the cargo to be transported is dangerous and/or valuable goods, the client shall notify the service provider 48 (Forty-eight) hours before the Wagon booking.\n1. 100% of the transportation fee must be paid in advance for each train set.\n1. Additional penalties due to non-compliance must be settled within 10 days of invoice issuance.\n1. Late payment shall incur a penalty of 10%.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "1. Provide the voyage number 24 hours in advance and update corrections 12 hours before departure.\n1. Assign necessary train and notify the train schedule 48 hours in advance.\n1. Provide safe transportation of the containers.\n1. Deliver the cargo within two days after train departure, assuming all required documents are submitted on time Under normal condition.\n1. If any operational, technical, or mechanical problem occurs to through out the transit , the Service Provider shall notify customs and arrange cargo transfer within 4 days if the incident occurs in Ethiopia, or within 6 days if it occurs in Djibouti.\n1. The Service Provider reserves the right to refuse the transportation of any cargo classified as dangerous good.\n1. The Service Provider reserves the right to unload or detach containers or wagons at Nagad station if the Client fails to submit the complete set of required documents necessary for port unloading.\n1. Provide accident or defect reports if needed.\n1. The Service Provider shall maintain reasonable railway carrier liability insurance coverage for cargoes, subject to the limitations, exclusions, and conditions of the applicable insurance policy\n1. The Service Provider shall not be liable for:\n- Inherent defects of the cargo;\n- Improper packing or loading conducted by the Client;\n- Customs-related delays;\n- Delays caused by force majeure events;\n- Losses arising from inaccurate cargo declarations made by the Client.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "1. contract Price\n- Gallan Multipurpose Port (GMP) to SGTD: USD 819.00 (Eight Hundred Nineteen United States Dollars) per 40ft container or USD 834.00 (Eight Hundred Thirty-Four United States Dollars) per two (2) 20ft containers.\n- Dire Dawa Dry Port to SGTD: USD 338.00 (Three Hundred Thirty-Eight United States Dollars) per 40ft container or per two (2) 20ft containers.\n- Modjo to SGTD: USD 725.00 (seven Hundred Twenty-Five) per 40ft container or per two 20ft containers.\n- Sebeta Railway Station to SGTD: USD 856.00 (Eight Hundred Fifty-Six) per 40ft container or 871 (USD Eight Hundred Seventy-One) per two 20ft containers.\n- If the cargo exceeds a gross weight of 50 tons per 2*20ft containers, an additional charge of USD 10 per ton will apply.\n- Gross weight shall be the total sum of Cargo, Packing and Container tare weight.\n- The price of container handling, loading and unloading at Modjo dry port and SGTD railway freight yards are not part of this agreement and are the sole responsibility of the client.\n1. Additional Costs (If Applicable):\n- First-mile delivery service by truck within Sebeta, Addis Ababa or Modjo and surrounding areas, originating from warehouses or any other places designated by client, shall incur an additional cost, which shall be fully covered by the client.\n- For clients utilizing EDR''s first or last mile logistics services, the applicable charges shall vary based on the cargo movement route.\n- The charge for First-mile delivery-to Gallan Multipurpose port and Modjo dry port shall be communicated to the client by service provider after receiving the necessary details from the client regarding the cargo origin, type and weight.\n1. Terms of payment\n- All transportation payments, including charges for any additional tonnage (if applicable), must be paid in advance prior to loading the container onto the train.\n- Payments shall be calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date the wagon or train number is provided.\n- If the exchange rate changes between payment and wagon assignment date, adjustments will be made accordingly.", "order": 5, "title": "Pricing and Payment Terms"}, {"id": "contract-documents", "body": "1. The following documents shall constitute the Contract between the Client and the Service Provider:\n- Any amendments made to this Contract (if applicable).\n- This Contract Agreement.\n- Final Minutes of Negotiation (if applicable).\n1. In the event of any discrepancy between these documents, they shall be interpreted with priority in the order listed", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "1. Consignment Note (cargo handover document).\n1. Payment summary prepared as per the agreed tariff if required.", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "1. The service provider must certify the taking over and handing over of the container cargo on Freight Carriage Acceptance Sheet of EDR inappropriate manners and provide to the client.\n1. Freight Carriage Acceptance Sheet shall be prima facie evidence of the receipt of the container cargo by service provider, the kind, number, and weight of the goods.\n1. Up on delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 8, "title": "Consignment Notes"}, {"id": "amendment", "body": "1. This contract may be amended only through written agreement signed by both parties.\n1. Notwithstanding Sub-Article 1, the Service Provider shall revise transport tariffs due to operational and regulatory changes by providing at least five (5) working days prior written notice to the Client.", "order": 9, "title": "Amendment"}, {"id": "termination", "body": "The contract may be terminated:\n- By mutual agreement.\n- Upon completion of the contract period or agreed cargo shipments.\n- If either party breaches fundamental terms.\n- If terminated for cause, the terminating party must issue a 15-day written notice specifying the breach, and allow opportunity to cure, if applicable.", "order": 10, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "This Contract shall be governed by and construed in accordance with the laws of the Federal Democratic Republic of Ethiopia", "order": 11, "title": "Governing Law"}, {"id": "duration", "body": "This contract shall remain valid until {{contractEndDate}} unless extended by mutual written agreement.", "order": 12, "title": "Contract Period"}, {"id": "26f21ab1-e529-4e13-a101-8bc88cc0d8ef", "body": "Each party shall maintain confidentiality concerning commercial, operational, technical, and shipment-related information obtained during execution of this Contract unless disclosure is required by law.", "order": 13, "title": "Confidentiality"}, {"id": "disputes", "body": "1. The parties shall endeavor to settle disputes amicably through good faith negotiation.\n1. Any dispute not resolved amicably within thirty (30) days shall be submitted to the Federal Courts of the Federal Democratic Republic of Ethiopia having jurisdiction in Addis Ababa.", "order": 14, "title": "Settlement of Disputes"}, {"id": "89247d94-ac42-4b46-a5e9-80057c174ef6", "body": "This Contract shall become effective on the date of signature by both parties.", "order": 15, "title": "Contract Effectiveness"}]', true, '2026-07-27 11:32:03.38554+00', '2026-08-06 06:35:36.337165+00', NULL, NULL, NULL, true),
+	('f6f9df81-bba2-4b5e-8171-eed8faff112e', 'EXPORT_CONTAINER_CUSTOMS', 'Container Export Contract (with customs clearing)', 'Export container transport, freight forwarding, and customs clearing from Galaan Multipurpose Port or Modjo dry port to SGTD container freight station (Djibouti). Customs clearing is performed by the Service Provider.', 'Export Container Transport, Freight Forwarding and Customs Clearing Service', '["The parties have agreed on the following services: rail transport, customs clearance, transit work, freight forwarding, and handling of container cargo."]', '[{"id": "objective", "body": "Customs clearance (Ethiopia side):\n- Processing of export declarations.\n- Coordination with the Ethiopian Customs Authority for clearance.\n- Ensuring compliance with all export regulations.\nRail transport:\n- Transportation of containers from Galaan Multipurpose Port (GMP) or Modjo dry port to SGTD container freight station.\nDjibouti transit and handling:\n- Customs clearance in Djibouti.\n- Coordination with Djibouti port and transit authorities.\n- Freight forwarding and last-mile facilitation as required.\nExcluded costs:\n- Shore handling.\n- Shifting of containers from SGTD to DMP or DMP to SGTD port.", "order": 1, "title": "Objective and Scope of the Services"}, {"id": "client-obligations", "body": "Give written/email instructions to the Service Provider for transportation of containers from Galaan Multipurpose Port (GMP) and/or Modjo to Djibouti.\nSupply a minimum of two (2) 20ft containers (or an equivalent load to fill one flat wagon).\nSubmit all forwarding service booking requests at least seventy-two (72) hours prior to the scheduled train departure and no later than 7 days before the vessel cut-off time, whichever is applicable.\nFor clients requiring first-mile service, submit a first-mile service request notice no less than seventy-two (72) hours in advance.\nComplete and submit accurate export documents as per the request of the Service Provider; payment must be submitted at least 36 hours before train departure.\nDeliver all cargo to the designated loading port or freight station at least three (3) hours prior to the scheduled train loading time.\nFailure to meet the stated deadlines may result in cancellation of the booking and transfer arrangements; any resulting delays, penalties, or additional costs shall be the sole responsibility of the Client.\nIf the Client fails to deliver the container, fails to provide the requested documents for completing export documents as instructed above, or cancels after wagon reservation, the Client shall pay USD 150.00 per wagon as a penalty, after notification.\nContainers must have four (4) undamaged corners.\nOne flat wagon must carry either one 40ft container or two 20ft containers.\nIf two 20ft containers are loaded on one flat wagon, their weight difference must not exceed 10 tons.\nThe gross weight of the container must not exceed the standard loading capacity indicated on the container; the Client is responsible for ensuring full compliance with the maximum allowable load.\nProhibited cargo: cargo covered with tarpaulin is not allowed due to safety risks.\nIf the cargo to be transported is dangerous and/or valuable goods, notify the Service Provider 48 (forty-eight) hours before the wagon booking for further discussion and decision.\nRefund requests before wagon booking require an official request, with a 3% administrative fee deducted. If the refund is due to the Service Provider, the Client shall receive a full refund. Refunds not requested and completed within six months shall be considered waived.\nAny delay caused by missing or incorrect documents shall be the Client''s responsibility.\n100% of the transportation and customs clearance fee must be paid in advance.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Complete gate pass processing and submit to Nagad Station for each shipment within eighteen (18) hours after train departure.\nThe Service Provider reserves the right to refuse the transportation of any cargo classified as dangerous goods.\nMaintain cargo liability insurance for railway transport; additional insurance for port handling or last-mile transport shall be the Client''s responsibility.\nThe Service Provider is not liable for customs penalties or demurrage due to delays beyond its control.\nNotify the Client immediately, in writing, of any delays, port issues, or customs holds.\nThe Service Provider shall not be liable for:\n- Inherent defects of the cargo.\n- Improper packing or loading conducted by the Client.\n- Customs-related delays.\n- Delays caused by force majeure events.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "Railway Transportation Charges\n- The Client shall pay the following railway transportation charges for the transportation of containers under this Agreement:\n- From GMP to SGTD: I. USD 819 (United States Dollars Eight Hundred Nineteen) per 40ft container; ii. USD 834 (United States Dollars Eight Hundred Thirty-Four) per two (2) 20ft containers\n- From Modjo to SGTD: i. USD 725 (United States Dollars Seven Hundred Twenty-Five) per 40ft container; ii. USD 725 (United States Dollars Seven Hundred Twenty-Five) per two (2) 20ft containers.\n- Where the total cargo weight exceeds fifty (50) metric tons per two (2) 20ft containers, an additional charge of USD 10 (United States Dollars Ten) shall apply for each excess metric ton.\n1. Freight Forwarding and Customs Clearance Charges\n- The Client shall pay the following freight forwarding and customs clearance service charges:\n- From GMPtoSGTD: i. USD540(United States Dollars Five Hundred Forty) per 40ft container;  ii. USD349(United States Dollars Three Hundred Forty-Nine) per 20ft container.\n- From Modjo to SGTD: i. USD569(United States Dollars Five Hundred Sixty-Nine) per 40ft container;  ii. USD389(United States Dollars Three Hundred Eighty-Nine) per 20ft container\n- For consolidated containers containing more than one (1) shipping document, the first document shall be included under the agreed contract rate. Any additional document within the same container shall be subject to an extra charge of USD50 per document.\n- Payment must be supported by an official receipt before cargo departs from Gelan Multipurpose Port /Mojo.\n- If the client uses PIL shipping Line, any Local charge incurred will be covered by the client as per the invoice issued from the shipping line.\n- If storage or demurrage occurs due to client-related issues (delay in document submission, payment delay, or any other client- related reason) the client will pay the payment.\n- Charges will apply per day after the free storage period, based on the invoice and SGTD tariff.\n- During export season, EDR may provide seasonal export support through the facilitation of empty containers.\n1. Additional Costs (If Applicable):\n- First-mile delivery service by truck within Addis Ababa or Modjo and surrounding areas, originating from warehouses or any other places designated by client, shall incur an additional cost, which shall be fully covered by the client.\n- For clients utilizing EDR''s first or last mile logistics services, the applicable charges shall vary based on the cargo movement route.\n- The charge for First-mile delivery-to Galaan Multipurpose Port and Modjo dry port shall be communicated to the client by service provider after receiving the necessary details from the client regarding the cargo origin, type and weight.\n- For any vessel outbound charges, IMO charges, or other fees not included in the port handling payment, the Service Provider shall request the Client to settle the required amount based on the official receipt issued by the port or the shipping line.\n1. Payment Terms:\n- All charges, including rail transport and customs clearance charges, remain 100% payable in advance.\n- Payments shall be calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date the wagon or train number is provided\n- If the exchange rate changes between payment and wagon assignment date, adjustments will be made accordingly.\n- Any additional costs incurred due to customs issues or port delays shall be borne by the Client, and will be paid based on actual costs, supported by official receipts within 10 days.\n- Latepayment shall incurs penalty of 10 %", "order": 5, "title": "Pricing and Payment Terms"}, {"id": "contract-documents", "body": "The following documents shall constitute the contract between the Client and the Service Provider:\n- Any amendments made to this contract (if applicable).\n- This Contract Agreement.\n- Final minutes of negotiation (if applicable).\n- In the event of any discrepancy between these documents, they shall be interpreted with priority in the order listed above.", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "Consignment Note (cargo handover document).\nPayment summary prepared as per the agreed tariff, if required.", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over and handing over of the container cargo on the Freight Carriage Acceptance Sheet of EDR in an appropriate manner and provide it to the Client.\nThe Freight Carriage Acceptance Sheet shall be prima facie evidence of the receipt of the container cargo by the Service Provider and of the kind, number, and weight of the goods.\nUpon delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 8, "title": "Consignment Notes"}, {"id": "amendment", "body": "1. This contract can be amended by mutual agreement.\n1. Notwithstanding Sub-Article 1, the Service Provider may revise transport tariffs due to operational and regulatory changes by providing at least five (5) working days prior written notice to the Client.", "order": 9, "title": "Amendment"}, {"id": "termination", "body": "The contract may be terminated:\n- Bymutualagreement.\n- Upon completion of the contract period or agreed cargo shipments.\n- If either party breaches fundamental terms.\n- If terminated for cause, the terminating party must issue a 15- day written notice specifying the breach, and allow opportunity to cure, if applicable", "order": 10, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "The contract is valid once signed by both parties.", "order": 11, "title": "Contract Effectiveness"}, {"id": "duration", "body": "Valid until {{contractEndDate}} with a possible extension upon mutual agreement.", "order": 12, "title": "Contract Period"}, {"id": "disputes", "body": "Disputes shall be settled amicably\nIf amicable settlement fails, disputes shall be submitted to the Federal Court located in Addis Ababa\nThe signatory confirms that they are fully authorized to sign and execute this contract Agreement. The power of Attorney of the signatories for the parties is enclosed with this contract agreement.", "order": 13, "title": "Settlement of Disputes"}]', true, '2026-08-04 10:03:50.67187+00', '2026-08-05 18:56:31.554451+00', NULL, NULL, NULL, true),
+	('ed5d984e-c0b4-4db5-9587-b5920ffe54d6', 'IMPORT_CONTAINER_CUSTOMS', 'Container Import Contract (with customs clearing)', 'Import container transport by railway from SGTD (Djibouti) to Dire Dawa, Modjo dry port, or Galaan Multipurpose Port, with empty-container return. Customs clearing is performed by the Service Provider.', 'Import Container Transport Service by Railway', '["The Client has requested and agreed to the transportation of container cargo from SGTD railway freight station at Djibouti to Dire Dawa, Modjo dry port, and Galaan Multipurpose Port (GMP), and the return of empty containers from Dire Dawa, Modjo dry port, and Galaan Multipurpose Port (GMP) to SGTD railway freight station using the Addis Ababa–Djibouti railway line.", "The Service Provider has agreed to transport the container cargo as per the terms of this contract."]', '[{"id": "objective", "body": "1. Customs Clearance (Djibouti side):\n- Customs clearance in Djibouti.\n- Coordination with Djibouti Port and Transit authorities.\n2. Rail Transport:\n- Transportation of containers from {{schedule.originLabel}} railway freight yard to {{schedule.destinationLabel}}\n3. Djibouti Transit and Handling:\n- Processing imports declarations.\n- Coordination with Ethiopian Customs Authority for clearance.\n- Ensuring compliance with all import regulations.\n- Freight forwarding and last-mile facilitation as required.\n4. Excluded costs\n- Shore handling\n- Shifting of containers from SGTD to DMP or DMP to SGTD port, Shifting of containers from free zone to DMP or SGTD.", "order": 1, "title": "Objective and Scope of the Services"}, {"id": "client-obligations", "body": "1. Give clear and written/email/electronic instructions to the Service Provider for transportation from Djibouti, SGTD container railway freight station to Dire Dawa, Modjo dry port and or Galaan Multipurpose Port (GMP).\n1. The Client must submit all required documents including but not limited to adequate number of original hard copy of bill of lading, certificate of origin, commercial invoice, packing list, soft copy of licenses, and other documents as per the requirement of the Service Provider at least 7 days prior to train booking.\n1. Provide a minimum of one (1) 40ft container or two (2) 20ft containers per shipment.\n1. If two 20ft containers are loaded on one flat wagon, their weight difference must not exceed 10 tons.\n1. The Client must collect the full container from Galaan Multipurpose port within Three (3) calendar days from the day following the arrival notice.\n1. If the Client fails to collect the container From Galaan Multipurpose port within the specified period, the Client shall be liable to pay demurrage charges per day as follows:\n- 15 USD per day per 20ft container or\n- 27 USD per day per 40ft container.\n- This charges, shall be calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date of the payment\n1. If the Client fails to collect the container within the specified period, the Service Provider shall have the right to reposition the container to any location it deems appropriate. In such case, the Service Provider shall not be held responsible for any damage or loss arising from such repositioning.\n1. In the event that the Client fails to collect the container(s) within the specified period, the Client shall be liable to pay double handling charges to the service providor for the affected container(s), as set out below:\n- 27 USD for 20ft container per handling or\n- 40 USD for 40ft container per handling.\n- This charges, shall be calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date of the payment\n1. The client must collect the container from Diredawa and Modjo dry port within one day after the service provider finalizes all the necessary formalities and gives the notification; otherwise pay the necessary demurrage and storage charges as per the standard of the port.\n1. If a booked wagon is not loaded due to client-related issues including but not limited to (damaged container, missing lock, unpaid demurrage, port system errors, or incomplete documentation and submition), the client shall be charged 100% of the total price for the reserved wagon.\n1. Refund requests before wagon booking require an official request, with a 3% administrative fee deducted. If the refund is due to the service provider, the client shall receive a full refund. Refunds not requested and completed within six months shall be considered waived.\n1. Clients shall return the empty containers to Galaan Multipurpose port , Modjo and Diredawa stations within two days after taking the full containers therefrom.\n1. If the empty containers cannot be offloaded from the train upon arrival at SGTD due to any client-related issue, the client shall be liable for the applicable penalty charges.\n1. Penalty Charges for Delay at SGTD/Nagad Upon Train Arrival:\n- 20 USD per day per 20ft container.\n- 33 USD per day per 40ft container.\n1. The Client must provide clean empty containers that meet SGTD standards. If SGTD refuse to take over the empty container because of inside cleanness problem, Additional cleaning costs incurred due to non compliance will be borne by the Client.\n1. The Client must ensure containers are structurally intact and meet weight distribution requirements.\n1. Any delay resulting from missing, incomplete, or incorrect documentation shall be the sole responsibility of the Client. All related costs incurred due to such delays shall be borne by the client upon presentation of valid receipts. If the payment is required in Djibouti, the Client shall settle the amount in USD based on the official receipt provided.\n1. The Client must notify the Service Provider (48) hours in Advance before wagon booking if transporting hazardous or valuable goods.\n1. Cargo covered with tarpaulin is not allowed due to safety risks.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "1. The service provider shall complete the customs clearance procedure for containers within 24 work hours of arrival at Gelan Multipurpose Port, Diredawa Railway Station and Modjo Dry port under normal conditions. Storage and handling fees will apply according to the service provider’s regulations for container import to Gelan Multipurpose Port, Diredawa and Modjo dry port’s regulation for container import shall be the responsibility of the client.\n1. If storage or any demurrage occurs due to client-related reasons resulting in delays or any other circumstances beyond the service provider’s control, the client shall bear the associated costs in USD as per the receipt provided.\n1. Transit time shall be within 7 days after submission of all necessary shipment documents from Djibouti to Gelaan Multipurpose Port , Diredawa railway station and Modjo Dry port under normal conditions.\n1. The Service Provider shall return empty containers from Dire Dawa , Modjo Dry port and and Gelan Multipurpose port to SGTD within seven (7) calendar days of receipt.\n1. In the event of export cargo operations, the Service Provider may prioritize the loading of export containers during the loading of empty containers return and unloading of import containers from train at Gaalan Multipurpose port.\n1. The Service Provider shall maintain cargo liability insurance for railway transport. Additional insurance for port handling or last- mile transport shall be the Client’s responsibility.\n1. The Service Provider reserves the right to refuse the transportation of any cargo classified as dangerous good.\n1. Provide accident or defect reports, if needed.\n1. Liability Limitations: The Service Provider is not liable for customs penalties or demurrage due to delays beyond its control.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "1. From SGTD to Galaan Multipurpose port (GMP), the rate is USD 1,916 per one 40ft or USD 1,944 per two 20ft containers with empty return, and USD 1,676 per one 40ft or USD 1,690 per two 20ft containers without empty return.\n1. From SGTD to Modjo Dry port , the rate is USD 1,781 per one 40ft or USD 1,808 per two 20ft containers with empty return, and USD 1,507 per one 40 ft and or per two 20ft containers without empty return.\n1. From SGTD to Dire Dawa dry port the rate is USD 919 per one 40ft or USD 942 per two 20ft containers with empty return, and USD 762 per one 40ft or USD 780 per two 20ft containers without empty return.\n1. If cargo exceeds 40 tons per two 20ft containers of gross weight, additional charges apply proportionally.\n1. The price for freight forwarding, customs clearance, and port handling services at both the Djibouti and Ethiopian sides from SGTD to Galaan Multipurpose Port, Diredawa and Modjo Dry port is fixed at USD 1,307 for one 40-foot container and USD 703 for one 20-foot container. This will only include\n- Port Due Fee\n- Local Charges (based on shipping line tariff)\n- Gate Pass\n- Djibouti Customs Processing\n- Documentation / File Cost\n- Transit Service Charge\n1. The price for freight forwarding, customs clearance, and port handling services at both the Djibouti and Ethiopian sides from the Free Zone to GMP/Modjo/Diredawa is fixed at USD 1,149 for one 40-foot container and USD 619 for one 20-foot container.\n1. The charge for last-mile delivery from Galaan Multipurpose Port shall be communicated to the client by the service provider after receiving the necessary details from the client regarding the cargo destination, type and weight.\nAdditional Costs (If Applicable)\n- The payment for additional tonnage (if any) shall be paid in advance before the container loaded on wagon.\nExcluded costs\n- Any charge related to the vessel (including freight, shipping line penalties, or vessel-side operations) is not included in this agreement.\nPayment Terms:\n- All payments shall be made one hundred percent (100%) in advance in United States Dollars (USD) including rail transportation and customs clearace charge.\n- Any additional costs incurred because of custom-related issues or port delays shall be the responsibility of the Client. Such costs shall be paid based on the actual amount and currency stated in the official receipts and must be settled within ten (10) days from the date of receipt.\n- The above rates are subject to adjustment based on the actual operational or storage costs incurred by the Service Provider, supported by the relevant invoices.\n- Additional charges may include: ◆ Advance demurrage ◆ Post demurrage ◆ Storage fees ◆ other related port charges\n1. All Additional charges must be settled within 10 days from invoice submission\n1. Late payment shall incur penality of 10%.", "order": 5, "title": "Contract Price and Terms of Payment"}, {"id": "contract-documents", "body": "The following documents constitute this contract:\n- Amendments (if any).\n- This Contract Agreement.\n- Final minutes of negotiation (if any).\nIf there is any discrepancy between the documents, they shall be interpreted with priority in the order listed above.", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "Equipment Interchange Receipt of SGTD, Railway Waybill, Container Carriage Acceptance Sheet, and incidental charges (if any).\nPayment summary as per the agreed contract price (if required).", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over and handing over of the container cargo on the Freight Carriage Acceptance Sheet of EDR in an appropriate manner and provide it to the Client.\nThe Freight Carriage Acceptance Sheet shall be prima facie evidence of the receipt of the container cargo by the Service Provider and of the kind, number, and weight of the goods.\nUpon delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 8, "title": "Consignment Notes"}, {"id": "amendment", "body": "This contract can be amended by mutual agreement.\nNotwithstanding the above, the Service Provider may revise transport tariffs due to operational and regulatory changes by providing at least five (5) working days'' prior written notice to the Client.", "order": 9, "title": "Amendment"}, {"id": "termination", "body": "1. The contract may be terminated:\n- By mutual agreement\n- Upon completion of the contract period or agreed cargo shipments.\n- If either party breaches fundamental terms.\n- If terminated for cause, the terminating party must issue a 15-day written notice specifying the breach, and allow opportunity to cure, if applicable", "order": 10, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "The contract is valid once signed by both parties.", "order": 11, "title": "Contract Effectiveness"}, {"id": "duration", "body": "Valid until {{contractEndDate}} with a possible extension upon mutual agreement.", "order": 12, "title": "Contract Period"}, {"id": "disputes", "body": "1. Disputes shall be settled amicably\n1. If amicable settlement fails, disputes shall be submitted to the Federal Court located in Addis Ababa\n1. The signatory confirms that they are fully authorized to sign and execute this contract Agreement. The power of Attorney of the signatories for the parties is enclosed with this contract agreement.", "order": 13, "title": "Settlement of Disputes"}]', true, '2026-08-04 10:03:50.67187+00', '2026-08-05 18:37:53.258284+00', NULL, NULL, NULL, true),
+	('22899e49-9466-4110-949c-ac767a3af2f8', 'EXPORT_BULK_NO_CUSTOMS', 'Bulk Export Contract', 'Export of bulk cargo (e.g. livestock) by railway from Ethiopian loading stations to Nagad railway freight yard, Djibouti.', 'Bulk Cargo Transportation Service by Railway', '["The Client has agreed to deliver bulk cargo to the Service Provider for transport from the agreed Ethiopian loading station to Nagad railway freight yard using the Addis Ababa–Djibouti railway line.", "The Service Provider has agreed to provide the service to transport the bulk cargo from the agreed loading station to Nagad railway freight yard."]', '[{"id": "objective", "body": "To undertake the railway transportation of bulk cargo from the agreed Ethiopian loading station to Nagad railway freight yard.", "order": 1, "title": "Objective of the Service"}, {"id": "client-obligations", "body": "Give written instruction to the Service Provider to transport a minimum of one wagon of cargo; the wagon request shall be made at least five (5) days in advance for each wagon.\nMaintain detailed information incorporating type, weight, and destination of the cargo ready for shipment, and notify the Service Provider or its nominated agent by notice, email, or fax.\nPrepare the necessary documents and facilities to make the cargo ready for transport.\nNote the allowable transport period of the cargo: the maximum time range during which the goods maintain their condition without any problem. The allowable transport period must be at least two (2) days longer than the delivery period.\nEnsure cargo is properly loaded and fastened in the wagons, provide the necessary lashing and barriers for loading as per the instruction of the departure station, and bear responsibility for the condition of the cargo during the transport period.\nSupply the necessary provisions for the cargo for each wagon and assign a responsible person to travel with the train to check the status of the cargo during transport, where the nature of the cargo so requires.\nSupply the minimum amount of cargo available for at least one wagon.\nExecute loading, lashing, and preparing barriers on wagons at the loading station and provide the complete documents/bill to the Service Provider within one (1) calendar day.\nFor each extra calendar day used for loading cargo and completing documents at the loading station, pay the wagon-occupied fee per the pricing article; the fee shall be paid within ten (10) calendar days from the date the Service Provider claims it, failing which compensation is payable calculated on the basis of the Commercial Bank of Ethiopia interest rate for the delay period.\nBe responsible for safety matters, and indemnify and hold the Service Provider harmless against all consequences resulting from accidents arising from or associated with the loading and unloading process.\nExecute and cover the cost of loading and unloading of cargo at both the loading station and Nagad railway freight yard.\nFollow up that the cargo is loaded and unloaded on time.\nDelegate representatives at both ends to consign and receive cargo with signature and stamp. Representatives shall hold a duly signed and stamped power of attorney and shall produce their ID or passport when consigning or receiving the cargo.\nPrepare the necessary facilities to take over the transported cargo at Nagad freight yard upon arrival by issuing handover documents.\nTake the transported cargo out of the wagons at Nagad freight yard within one (1) calendar day starting from the day following the notice of arrival.\nPay the wagon-occupied fee per the pricing article for delays of more than one (1) calendar day at Nagad railway freight yard due to the fault of the Client in resolving customs or third-party claims or any other causes.\nAfter the wagon list is submitted to the Client, if a wagon is not loaded due to the fault of the Client, pay 100% of the transportation price per wagon for each unloaded wagon.\nPay the Service Provider 100% of the contract price in advance for each wagon.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Provide the list and identification numbers of wagons with sequence and locomotives at least twenty-four (24) hours in advance to the Client, with any correction at least twelve (12) hours before arrival at destination.\nTransport the cargo from the loading station to Nagad railway freight yard.\nProvide safe transportation of the cargo throughout the transit.\nPresent customs clearance documents and mobilize the rolling stock as needed.\nProvide the wagons assigned for the freight at the agreed place and time, and follow up that the cargo is loaded on time.\nTransport and deliver the cargo taken over, in the condition received, within two (2) calendar days to Nagad railway freight yard.\nWhere a wagon carrying cargo stops due to accident or mechanical problem, promptly notify the nearby customs station, police office, and the Client. A wagon stopped in Ethiopia due to mechanical defect shall be maintained within four (4) calendar days; within Nagad (Djibouti) territory within twelve (12) calendar days. In case of accident where the problem cannot be solved within one (1) calendar day and the wagon is not operational, the Service Provider shall have the cargo carried and delivered by another wagon, and shall provide an accident or defect report issued by the local police office regarding the sustained damage.\nBuy a cargo liability insurance policy for each supplied wagon.\nProvide wagon cleaning service and charge the cleaning fee based on actual expenditure.\nIf the Client fails or refuses to receive the cargo beyond the allowable transport period, the Service Provider has the right to handle the cargo.\nNeither party shall be liable for any indirect or consequential loss sustained by the other in connection with this Agreement.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "The parties have no obligation to pay demurrage or any other compensation if they have failed to discharge their obligations due to force majeure.\nForce majeure shall be deemed to exist when the contract is not performed due to any event beyond the reasonable control of a party which prevents that party from complying with its obligations under this Agreement, including but not limited to:\n- Acts of God (such as, but not limited to, fires, explosions, earthquakes, drought, tidal waves, and floods).\n- War, hostilities (whether war is declared or not), invasion, acts of foreign enemies, mobilization, requisition, or embargo.\n- Rebellion, revolution, insurrection, military or usurped power, or civil war.\n- Contamination by radioactivity from any nuclear fuel or nuclear waste.\n- Riot, commotion, strikes, go-slows, lockouts, or disorder.\n- Acts of terrorism.\nA party wishing to claim protection in respect of a force majeure event shall, as soon as possible following the occurrence or commencement of the event, notify the other party of its nature and expected duration, and shall thereafter keep the other party informed until it is able to perform its obligations under this Agreement.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "The price of bulk cargo transportation from the loading station to Nagad, together with any applicable demurrage and surcharge rates, is set out in the Rate Schedule immediately below, expressed as unit prices per origin → destination lane and per wagon.\nPayment for transport services shall be made in Birr based on the selling price of USD to Birr on the date of payment set by the Commercial Bank of Ethiopia.\nIf there is an increment or decrement of the USD exchange rate to Birr between the date of payment and the date the wagon/train number is provided to the Client, either the Client shall make the additional payment to the Service Provider or the Service Provider shall refund the difference from the initial payment to the Client.\nThe cost of loading at the loading station and unloading at Nagad shall be covered by the Client and is not part of this contract agreement.\nThe Client shall pay 100% of the contract price in advance.\nThe Client shall pay a demurrage fee for occupied wagons at the rate set out in the Rate Schedule for the applicable occupancy band.\nDemurrage payment shall be made in Birr based on the selling price of USD to Birr set by the Commercial Bank of Ethiopia on the date of the demurrage occurrence.", "order": 5, "title": "Contract Price and Terms of Payment"}, {"id": "contract-documents", "body": "The following documents shall constitute the contract between the Client and the Service Provider:\n- Amendments made to this contract (if any).\n- This Contract Agreement.\n- Final minutes of negotiation (if any).\nIf there is any discrepancy between the documents, they shall be interpreted with priority in the order listed above.", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "The following documents shall be delivered to the Client upon request for settlement:\n- Consignment Note (cargo handover document to the Client).\n- Summary of payment request of the Service Provider prepared as per the agreed tariff.", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over of the goods on the duplicates of the consignment note in an appropriate manner and return the duplicate to the Client.\nA consignment note shall be prima facie evidence of the receipt of the goods by the Service Provider and of the kind, number, and weight of the goods.", "order": 8, "title": "Consignment Notes"}, {"id": "termination", "body": "The contract may be terminated:\n- Upon mutual consent of the parties.\n- Upon completion of the contract period.\n- If either or both parties breach a fundamental provision of the contract, upon prior legal notice delivered by either party.", "order": 9, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "The contract shall come into full force and effect on the date when all of the following are accomplished:\n- The contract is signed by the Client and the Service Provider.\n- The Service Provider has received the advance payment of 100% of the contract price for each train set of cargo.", "order": 10, "title": "Contract Effectiveness"}, {"id": "cargo-amount", "body": "The minimum cargo to be transported shall be one wagon.", "order": 11, "title": "Cargo Amount"}, {"id": "duration", "body": "The contract shall last for three (3) months starting from the date of contract signing, with possible extension upon mutual agreement.", "order": 12, "title": "Duration of Contract"}, {"id": "disputes", "body": "If a dispute arises between the parties, they shall exert efforts to settle their differences amicably.\nIf the parties fail to settle their disputes amicably, the case shall be taken to the competent Federal Court of law presiding in Addis Ababa.\nThe governing law shall be the laws of the Federal Democratic Republic of Ethiopia.", "order": 13, "title": "Settlement of Disputes"}]', true, '2026-07-27 11:32:03.38554+00', '2026-08-04 10:03:50.67187+00', '2026-08-09 18:49:32.843901+00', NULL, NULL, false),
+	('f96e3a2b-4fc6-4c7c-87b7-99dbbeb255c1', 'IMPORT_BULK_NO_CUSTOMS', 'Bulk Import Contract', 'Import of bulk cargo (e.g. steel billets) from Djibouti (DMP/Nagad) to Galaan Multipurpose Port with customs clearance and optional last-mile delivery.', 'Bulk Cargo Transportation and Customs Clearance Services', '["The Client has agreed to engage the Service Provider for transportation and customs clearance services for bulk cargo, including first-mile transport to the railway station at Djibouti, loading at either DMP or Nagad Railway Station (Djibouti), port/rail terminal handling, loading onto the train, railway transport to Galaan Multipurpose Port (GMP) in Ethiopia, unloading at the destination port from train to load directly on truck, onward transportation to the Client''s site (excluding truck loading at Djibouti and truck unloading at the Client destination where last-mile service is undertaken by the Service Provider), and all related documentation.", "The Service Provider has agreed to provide the requested services in accordance with the terms and conditions of this Agreement."]', '[{"id": "efc0442c-f7ae-4253-8cf3-bc64523f730b", "body": "Fist-Mile service: Truck transport from the designated cargo location to the designated railway freight station, including any required shifting of cargo within the designated facility at Djibouti.\n\nRailway terminal handling: Unloading from trucks, loading cargo on train wagons and lashing. \n\nRail transport: Railway transport from {{schedule.originLabel}} railway freight stations to {{schedule.destinationLabel}}. \n\nDocumentation and freight forwarding Customs clearance in Djibouti and Ethiopia. \n\nRail Terminal Handling: unloading Wagons to load on trucks at {{schedule.destinationLabel}}\n\nLast mile service: Truck transport from {{schedule.destinationLabel}} to the client’s compound if agreed between the parties. \n\nExcluded service from this contract: loading of the cargo on trucks at free zone, DMP or any other designated location of cargo at Djibouti, unloading at clients’ warehouse and any port handling which is not clearly stated above, including but not limited to (shifting of cargo from SGTD port to free zone or DMP and shore handling)", "order": 1, "title": "Scope of the Service"}, {"id": "objective", "body": "The objective of this contract is for the service provider to provide the Client with integrated logistics services for the transportation of\n{{schedule.cargoDescription}}, including {{schedule.serviceType}} and the client to make the necessary payment as per the agreement.", "order": 2, "title": "Objective of the Services"}, {"id": "client-obligations", "body": "Give written/email/electronic instructions to the Service Provider for transportation of cargo from Djibouti to Galaan Multipurpose Port. \n\nTimely Submission of Documents and the Cargo: The Client must submit all required shipping and customs documents at least 7 days prior to train departure. \n\nEnsure a minimum supply of at least 1/one {{schedule.cargoDescription}} per shipment. \n\nIf a booked wagon is not loaded due to client-related issues (e.g. unpaid demurrage, port system errors, or incomplete documentation), the client shall be charged 100% of the total price for the reserved wagon. \n\nRefund requests before wagon booking require an official request, with a 3% administrative fee deducted. If the refund is due to the service provider, the client shall receive a full refund. Refunds not requested and completed within six months shall be considered waived. \n\nResponsibility for Delays: Any delay caused by missing or incorrect documents shall be the Client’s responsibility. \n\nThe Client shall supply sufficient cargo to fully load at least one flat wagon. The specific quantity of cargo to be loaded per flat wagon shall be determined by the Service Provider based on the wagon’s loading capacity and operational standards. \n\nMake payment to the Service Provider for services rendered in accordance with the payment terms and conditions of this contract. \n\nEnsure timely follow-up so that the cargo is loaded and unloaded on schedule. \n\nAssign representatives at both the origin and destination to consign and receive the cargo. \n\nMaintain detailed information on the type, weight, and destination of the cargo ready for shipment. Notify the service provider or its nominated agent by written notice, email, or electronic communication. Detailed dimensional information about the cargo shall be sent at least one (1) week prior to the contractual commitment and booking request. \n\nPay demurrage for delays exceeding five (3) calendar days in removing cargo from Galaan Multipurpose Port due to the Client’s fault in resolving customs, third-party, inland transport issue or other claims. Demurrage rates shall be:\n13.1. USD 30 per day per heavy machinery (Equipment) or vehicle for storage between 4–6 days.\n13.2. USD 40 per day per heavy machinery (Equipment) or vehicle for storage between 7–9 days.\n13.3. USD 50 per day per heavy machinery (Equipment) or vehicle for storage exceeding 10 days\n13.4. The demurrage payment shall be made within ten (10) calendar days from the date of the Service Provider’s claim, calculated using the selling exchange rate of the Commercial Bank of Ethiopia on the date of payment.\n\nPay any other applicable charges and fees within ten (10) calendar days after the Service Provider submits a payment request document. \n\nLate payment shall incur a penalty of 10% of the outstanding invoice amount. \n\nThe Client shall obtain prior confirmation from the Service Provider before proceeding with any booking request or making any payment.", "order": 3, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "The Service Provider shall take over the machinery cargo at the Djibouti Free Zone,DMP or designated cargo location and transport it without loss or damage, delivering it directly to the Client’s designated destination. Should the Service Provider fail to deliver the cargo in the same condition as received, it shall bear full responsibility for any loss, damage, or discrepancy. \n\nThe Service Provider shall clear the cargo within 24 hours of its arrival at Galaan Multipurpose Port under Normal condition, and any delay beyond this period shall be the sole responsibility of the Service Provider. Where the last-mile service is agreed to be undertaken by the Service Provider, failure to provide such service upon arrival shall entitle the Client to independently arrange the service. In such case, if any payment has already been made for the last-mile service, the Service Provider shall promptly refund the amount paid for the specific service not rendered. \n\nIf storage occurs due to client-related delays or circumstances beyond the service provider’s control, the client shall bear the associated costs.\n\nInsurance: The Service Provider shall maintain cargo liability insurance for railway transport. Additional insurance for port handling or last-mile transport shall be the Client’s responsibility. \n\nThe Service Provider shall provide accident or defect reports, where applicable or upon request, in relation to cargo handling, loading, or transport operations.\n\nLiability Limitations: The Service Provider is not liable for customs penalties or demurrage due to delays beyond its control.", "order": 4, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\n\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 5, "title": "Force Majeure"}, {"id": "liability", "body": "Contract price\n\nThe price for transporting heavy machinery or vehicles shall be USD 3,800, (Three Thousand Eight Hundred USD) per wagon to the destination Galaan Multipurpose Port (GMP). \n\n3. The logistics and rail side handling Per unit shall be\n3.1. USD 2,500 per one Machine or truck if the cargo is to be loaded from DMP\n3.2. USD 2,300 Per one Machine or truck if the cargo is from free zone\n3.3. USD 2,600 Per one Machine or truck if the cargo is from SGDT/DMP (Containerized)\n3.4. USD 2,600 Per one Machine or truck if the cargo is from Old Port\n\nThis price includes customs clearance, first mile, loading to railway wagon at origin of cargo, unloading from wagon at destination port and Djibouti rail side handling and lashing labor cost on wagons. \n\nThe price for last mile shall be determined once the cargo departs from the loading point and shall be communicated to the client with an official email/electronic communication. \n\nThe price for Lashing Material shall be USD 100 per one Wagon.\n\nCargo Weight and size Limit: Verified Gross Mass (VGM) and the size must comply with railway restrictions. \n\n\nTerms of Payment \n\nPayment for transport and customs clearance services shall be made in USD. \n\nThe Client shall pay 100% of the transport and customs clearance price in advance. \n\nThe number of cargo per flat wagon shall be determined based on the machinery’s dimensions (L×W×H), with the exact number confirmed after consultation with the service provider.\n\nCosts related to loading on trucks, lashing labor, and other associated expenses at free zone, DMP and any designated location of cargo and unloading from truck at the final destination are not included in this contract and shall be borne by the Client.", "order": 6, "title": "Contract Price and Terms of Payment"}, {"id": "contract-documents", "body": "The following documents form part of this contract:\n- This Contract Agreement.\n- Any amendments made to this Agreement.\n- Minutes of negotiation (if any).\nIn the event of any discrepancy between these documents, they shall be interpreted with priority in the order listed above.", "order": 7, "title": "Contract Documents"}, {"id": "documentation", "body": "The following documents shall be provided to the Client upon request for settlement\n\nConsignment Note (handover document to the Client). \n\nSummary of the Service Provider’s payment request, prepared in accordance with the agreed tariff if required . \n\nDetails of any incidental charges, if applicable. Article 9- Consignment notes", "order": 8, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over of the goods on the duplicates of the consignment note in the appropriate manner and return the duplicate to the Client. \n\nThe consignment note shall serve as prima facie evidence of the receipt of the goods by the Service Provider, including their type, quantity, and weight. \n\nUpon delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 9, "title": "Consignment Notes"}, {"id": "termination", "body": "This contract can be amended by mutual agreement.\n\nThe service provider reserves the full right to amend the price or any provision of this contract during its validity period within 5 days of prior notification.", "order": 10, "title": "Amendment"}, {"id": "effectiveness", "body": "The Contract may be terminated under the following circumstances:\nBy mutual consent of both Parties. \n2. Upon completion of the contract period. \n3. By either Party giving one (1) month’s prior notice for any reason. 4. If either Party breaches a fundamental provision of the Contract, a legal prior notice of three (3) days shall be delivered by the non-breaching party", "order": 11, "title": "Termination of Contract"}, {"id": "duration", "body": "The Contract shall come into full force and effect on the date when the Contract is signed by the Client and the Service provider.", "order": 12, "title": "Contract Effectiveness"}, {"id": "disputes", "body": "If adispute arises between the parties, they shall exert efforts to settle their differences amicably.\n2. If the parties fail to settle their disputes amicably, the case shall be taken to the competent Federal Court of law presiding in Addis Ababa.\n3. Thegoverning law shall be the laws of the Federal democratic republic of Ethiopia.", "order": 13, "title": "settlement of Disputes"}]', true, '2026-07-27 11:32:03.38554+00', '2026-08-04 13:00:56.39198+00', '2026-08-09 18:49:32.843901+00', NULL, NULL, false),
+	('171cb4c1-a26b-41eb-b776-373d24d7d018', 'INTERCITY_BULK', 'Bulk Intercity Contract', 'Domestic (intercity) bulk cargo transportation by railway between Ethiopian freight yards, e.g. Dire Dawa to Sebeta.', 'Bulk Cargo Transportation Service by Railway (Intercity)', '["The Client has requested the Service Provider to transport bulk cargo between the agreed Ethiopian railway freight yards using the Ethio–Djibouti Railway.", "The Service Provider has accepted the Client''s request to render the said transportation service."]', '[{"id": "objective", "body": "The Service Provider shall undertake the railway transportation of {{schedule.cargoDescription}} from {{schedule.originLabel}} to {{schedule.destinationLabel}}", "order": 1, "title": "Objective of the Contract"}, {"id": "client-obligations", "body": "Provide written instructions to the Service Provider to transport a minimum of sixteen (16) wagons of cargo per consignment.\nPrepare all necessary documents, including laboratory tests from the pertinent organ and off-taking contract where applicable, and the facilities required to sign the contract and make the cargo ready for transport.\nAssign representatives at the origin yard and other stations, as required, to hand over the cargo to the Service Provider and handle transit clearance if required.\nTransport the cargo to the designated loading points at the origin yard.\nBe responsible for cargo handling: loading at the origin yard and unloading at the destination yard, in accordance with the standards set by the EDR operations and technical terms.\nMake advance payment to the Service Provider for services in accordance with the payment terms and conditions of this contract.\nFollow up to ensure that the cargo is loaded and unloaded on time.\nDelegate representatives at the cargo destination to immediately receive the transported cargo.\nEnsure representatives are duly authorized with a power of attorney, signed and stamped by the Client, and present valid identification (ID or passport) when consigning or receiving cargo.\nMaintain detailed information including item, weight, and destination of the cargo, and communicate the same to the Service Provider or its nominated agent via written notice, email, or fax.\nPrepare the necessary facilities to immediately take over the transported cargo at the destination upon arrival and provide sufficient trucks at the destination freight yard for unloading from railway wagons.\nUpon arrival of the train/wagon at the unloading site, sign the train arrival confirmation sheet to acknowledge the arrival time.\nInspect the loaded wagons jointly with the Service Provider and EDR at the loading yard, and again with the customs agent (if required) and the Service Provider at the destination yard.\nAfter receiving the cargo, sign the Freight Carriage Acceptance Sheet (copies II, III, and IV) immediately to confirm delivery.\nCompensate the Service Provider or any third party for actual loss or damage caused to persons, property, or wagons during unloading where such damage is attributable to the Client''s fault.\nEach consignment (train) shall be granted three (3) hours of free time at the loading station and one (1) day at the unloading station. For each additional 3 hours of loading or parking the Client shall pay ETB 5,000 (five thousand) per wagon, and for each additional day of unloading ETB 5,000 (five thousand) per wagon per day.\nBear demurrage charges of ETB 5,000 (five thousand) per wagon per 3 hours for delays exceeding three (3) hours at any station resulting from the Client''s failure to resolve customs or third-party claims.\nPay 100% of the transport price in advance. Any additional charges or fees shall be paid within ten (10) calendar days after submission of the Service Provider''s payment request.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Provide the necessary train(s) to execute the transportation service under this contract, and furnish the Client with the list and identification numbers of wagons and locomotives at least 24 hours in advance, with corrections (if any) communicated at least 12 hours before the expected time of arrival at destination.\nProvide pre-arrival notification including the train number to the discharging terminal and customs at least 24/12 hours before train arrival.\nTransport the cargo from origin to destination within two (2) days from completion of loading (time counting starts upon completion of documentation and loading).\nProvide safe transportation of the cargo throughout transit.\nDeliver the cargo to the Client at the destination railway freight yard in the same condition as received.\nPurchase a cargo liability insurance policy for each wagon transported.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable due to a force majeure event.\nFor the purposes of this contract, force majeure shall mean any unforeseeable event or circumstance beyond the reasonable control of the affected party which absolutely prevents the performance of the contract, including but not limited to natural disasters, war, civil commotion, strikes, government actions, epidemics, or interruption of railway operations due to accidents or infrastructure failure.\nThe affected party shall notify the other party in writing within a reasonable period not exceeding two (2) hours after the occurrence of the force majeure event, providing evidence and details of the impact on performance and the mitigating steps taken.", "order": 4, "title": "Force Majeure"}, {"id": "liability", "body": "The Service Provider will be responsible for any loss, shortage, or damage occurring to the cargo it has received.", "order": 5, "title": "Liabilities Related to Damages and Losses"}, {"id": "pricing", "body": "The price for transporting cargo from the origin freight yard to the destination freight yard is set out in the Rate Schedule immediately below, expressed as a unit price per origin → destination lane and per wagon.\nEach wagon shall be loaded with a maximum of 70 (seventy) metric tons.\nPayment for transport services may be made in Ethiopian Birr, based on the Commercial Bank of Ethiopia''s official selling exchange rate of USD to Birr on the date of payment.\nIf the exchange rate changes between the payment and the wagon assignment date, payment adjustments will be made accordingly.\nThe contract price shall include the cost of railway transportation from the origin freight yard to the destination freight yard.\nExcluded cost: cargo handling (loading and unloading) is not included in the contract price and shall remain the sole responsibility of the Client.", "order": 6, "title": "Contract Price"}, {"id": "contract-documents", "body": "The following documents shall constitute the contract between the Client and the Service Provider:\n- Amendments made to this contract (if any).\n- This Contract Agreement.\n- Final minutes of negotiation (if any).\nIf there is any discrepancy between the documents, they shall be interpreted with priority in the order listed above.", "order": 7, "title": "Contract Documents"}, {"id": "documentation", "body": "The following documents shall be delivered to the Client by the Service Provider to collect and settle payment:\n- Freight Carriage Acceptance Sheet of the Ethio-Djibouti Railway.\n- Notice of collecting transportation and miscellaneous charges of the Ethio-Djibouti Railway (if any).\n- Summary of payment request of the Service Provider prepared as per the agreed tariff.\n- Railway Waybill.", "order": 8, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over of the goods on copy III (kept by the consignee for future reference) of the Freight Carriage Acceptance Sheet of the Ethio-Djibouti Railway in an appropriate manner and provide it to the Client.\nThe Freight Carriage Acceptance Sheet shall be prima facie evidence of the receipt of the goods by the Service Provider and of the kind, number, and weight of the goods.", "order": 9, "title": "Consignment Notes"}, {"id": "termination", "body": "The contract may be terminated:\n- Upon mutual consent of the parties.\n- Upon completion of the contract period or amount of cargo, whichever comes first.\n- If either or both parties breach a fundamental provision of the contract, upon one-week prior legal notice delivered by either party.", "order": 10, "title": "Termination of Contract"}, {"id": "duration", "body": "The contract duration shall be {{contractDate}} from the date of effectiveness of the contract, with possible extension upon mutual agreement of the parties.", "order": 11, "title": "Duration of Contract"}, {"id": "disputes", "body": "1. If a dispute arises between the parties, they shall exert effort to settle their differences amicably.\n1. If the parties fail to settle their dispute amicably, the case shall be taken to the competent federal court of law presiding in Addis Ababa.\n1. The governing law shall be the laws of the FDRE.", "order": 12, "title": "Settlement of Disputes"}, {"id": "effectiveness", "body": "The contract shall come into full force and effect on the date when the contract is signed by both parties.", "order": 13, "title": "Contract Effectiveness"}]', true, '2026-07-27 11:32:03.38554+00', '2026-08-05 19:43:09.63909+00', '2026-08-09 18:49:32.843901+00', NULL, NULL, false),
+	('dfedaebc-9377-444e-aa8d-8de60059dd27', 'IMPORT_BULK_CUSTOMS', 'Bulk Import Contract (with customs clearing)', 'Import of bulk cargo (e.g. steel billets) from Djibouti (DMP/Nagad) to Galaan Multipurpose Port with customs clearance and optional last-mile delivery. Customs clearing is performed by the Service Provider.', 'Bulk Cargo Transportation and Customs Clearance Services', '["The Client has agreed to engage the Service Provider for transportation and customs clearance services for bulk cargo, including first-mile transport to the railway station at Djibouti, loading at either DMP or Nagad Railway Station (Djibouti), port/rail terminal handling, loading onto the train, railway transport to Galaan Multipurpose Port (GMP) in Ethiopia, unloading at the destination port from train to load directly on truck, onward transportation to the Client''s site (excluding truck loading at Djibouti and truck unloading at the Client destination where last-mile service is undertaken by the Service Provider), and all related documentation.", "The Service Provider has agreed to provide the requested services in accordance with the terms and conditions of this Agreement."]', '[{"id": "objective", "body": "The objective of this contract is to provide the Client with integrated logistics services for the transportation of bulk cargo, including:\n- First-mile transportation in Djibouti from the Client''s designated cargo location to the selected railway station (DMP or Nagad).\n- Port handling and loading onto railway wagons.\n- Railway transport from DMP and/or Nagad Railway freight station (Djibouti) to Galaan Multipurpose Port.\n- Customs clearance in Djibouti and Ethiopia.\n- Unloading from train at the destination port to load directly on truck.\n- Last-mile delivery by truck to the Client''s delivery site where the last-mile service is undertaken by the Service Provider.\nThe truck loading at Djibouti and the truck unloading at the Client''s delivery site shall be the responsibility of the Client.", "order": 1, "title": "Objective of the Services"}, {"id": "client-obligations", "body": "Provide written/email/electronic instructions specifying the cargo volume and the selected loading station (DMP or Nagad) for each shipment.\nPrepare and submit all necessary documents and permits to enable smooth service execution.\nEnsure cargo readiness in compliance with specifications (including weight, size, and contour restrictions).\nHandle truck loading at Djibouti Free Zone/Old Port/DMP and any other designated cargo location at Djibouti, and truck unloading at the delivery site.\nEnsure safety and proper securing of cargo during truck handling.\nSubmit all required documents necessary for customs clearance and cargo release within one (1) calendar day from the date of request or notification by the Service Provider.\nUpon receipt of the wagon allocation list and train schedule from the Service Provider, ensure that the cargo is transferred to the designated loading freight station and made ready for loading within two (2) days prior to wagon arrival. Any delay beyond this period resulting from Client-related issues shall be subject to a charge of USD 56 per wagon per day, or part thereof, until the cargo is made available for loading.\nUpon arrival of the train at Galaan Multipurpose Port (GMP), offload cargo from wagons within twenty-four (24) hours of train arrival. Where the Client undertakes last-mile transportation, the Client may arrange sufficient trucks at the time of train arrival to enable direct loading of cargo from wagons to trucks.\nIn the event the Client is unable to provide trucks for the collection of cargo within twenty-four (24) hours of train arrival, the Service Provider shall have the right to handle and reposition the cargo to any location it deems appropriate, and shall not be held responsible for any loss, shortage, or damage arising from such repositioning.\nAny additional handling, re-handling, or repeated loading operations performed by the Service Provider shall be charged as double handling fees at a rate of USD 4 per ton, payable by the Client.\nIf stored, the full cargo must be collected from the Galaan Multipurpose Port compound within three (3) days from the time of train arrival at the port.\nIf the Client fails to collect the cargo within the specified period, the Client shall be liable to pay demurrage charges of USD 2 per day per ton, calculated based on the Commercial Bank of Ethiopia''s daily selling exchange rate on the date of payment.\nWhere the last-mile service is provided by the Service Provider, unload the cargo from the truck at the delivery site within the agreed time frame.\nDesignate authorized representatives (with valid power of attorney) for handover at origin and destination.\nSettle demurrage payments within ten (10) calendar days from the date the Service Provider issues a claim.\nPay the Service Provider one hundred percent (100%) of the contract price in advance for each train set in accordance with the pricing article of this Agreement.\nContact the Service Provider to obtain confirmation prior to booking and proceeding with payment.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Provide first-mile transportation in Djibouti from the Client''s designated location to the selected railway station (DMP or Nagad).\nCarry out port handling and loading onto railway wagons.\nProvide railway transportation from DMP/Nagad (Djibouti) railway freight station to Galaan Multipurpose Port.\nPerform unloading at Galaan Multipurpose Port (GMP) to load directly on truck.\nPerform customs clearance in Djibouti and Ethiopia, including border station procedures.\nPrepare and submit all required transport documentation.\nProvide cargo insurance coverage for each supplied wagon.\nNotify the Client of train schedules, wagon numbers, and expected arrival times in advance.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "Neither party shall be liable for delays or non-performance caused by force majeure events beyond their reasonable control.\nForce majeure shall be interpreted in accordance with the Ethiopian Civil Code.", "order": 4, "title": "Force Majeure"}, {"id": "liability", "body": "The Service Provider shall be fully responsible for any loss, shortage, or damage to cargo that occurs after it has been taken over until delivery to the Client''s delivery site.\nCompensation shall be based on the market value of the cargo, in accordance with applicable laws.", "order": 5, "title": "Liabilities Related to Damages and Losses"}, {"id": "pricing", "body": "The applicable railway freight, Djibouti handling, and any additional service and surcharge rates for this contract are set out in the Rate Schedule immediately below, expressed as unit prices per origin → destination lane and per service.\nEach wagon shall be loaded up to a maximum of seventy (70) metric tons; for billing purposes one full wagon shall be deemed equivalent to this volume.\nWhere lashing materials and wood are provided by the Service Provider, they shall be charged at the applicable rate set out in the Rate Schedule; the provision continues until the cargo reaches and is fully unloaded at the designated destination station.\nThe price for last-mile delivery, where not listed in the Rate Schedule, shall be determined once the cargo departs from the loading point and shall be communicated to the Client by official email upon the Client''s request.\nPayments shall be made 100% in advance in USD.", "order": 6, "title": "Contract Price and Payment Terms"}, {"id": "contract-documents", "body": "The following documents form part of this contract:\n- This Contract Agreement.\n- Any amendments made to this Agreement.\n- Minutes of negotiation (if any).", "order": 7, "title": "Contract Documents"}, {"id": "documentation", "body": "The Service Provider shall deliver the following to the Client:\n- Freight Carriage Acceptance Sheet of the Addis Ababa–Djibouti Railway.\n- Notice of transportation and miscellaneous charges.\n- Summary of payment request as per the agreed tariff, if required.", "order": 8, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider shall certify the taking over of goods in the Freight Carriage Acceptance Sheet.\nThis document shall serve as prima facie evidence of receipt of the cargo.\nUpon delivery of the cargo to the Client, the Cargo Handover Out Voucher signed by both parties shall serve as evidence of cargo receipt.", "order": 9, "title": "Consignment Notes"}, {"id": "termination", "body": "This contract may be terminated:\n- By mutual consent.\n- Upon completion of the agreed contract period or cargo volume.\n- For breach of fundamental provisions, with one-week prior written notice.", "order": 10, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "This Agreement becomes effective on the date it is signed by both parties.", "order": 11, "title": "Contract Effectiveness"}, {"id": "duration", "body": "The contract is valid until August 31, {{contractYear}} from the date of effectiveness, extendable by mutual agreement.", "order": 12, "title": "Duration"}, {"id": "disputes", "body": "Disputes shall first be settled amicably.\nIf unresolved, disputes shall be referred to the competent Federal Court of Ethiopia in Addis Ababa.\nThe governing law shall be the laws of the Federal Democratic Republic of Ethiopia.", "order": 13, "title": "Settlement of Disputes"}, {"id": "customs-clearing", "body": "The Service Provider shall carry out customs clearing on behalf of the Client for the cargo covered by this Agreement, including declaration, lodgement, and follow-up at the customs stations of Djibouti and Ethiopia as applicable to the agreed corridor.\nThe Service Provider shall act only within the authority granted by the Client and shall not amend a declaration without the Client''s written instruction.\nCustoms duties, taxes, and any government charges assessed on the cargo remain payable by the Client and are not included in the freight price; the Service Provider shall settle them on the Client''s behalf only where the Client has placed the corresponding funds in advance.\nThe Service Provider shall hand over all customs documents obtained in the course of clearing to the Client upon completion of each shipment.", "order": 14, "title": "Customs Clearing Services"}, {"id": "customs-client-duties", "body": "Grant the Service Provider a duly signed and stamped power of attorney authorising it to act as the Client''s customs agent for the duration of this Agreement.\nSubmit every document required for declaration (commercial invoice, packing list, bill of lading or airway bill, permits, certificates of origin, and any authority-specific licence) within one (1) calendar day of the Service Provider''s request.\nWarrant that the declared description, quantity, value, and tariff classification of the cargo are complete and accurate.\nBear any penalty, demurrage, storage, or re-inspection cost arising from incorrect, incomplete, or late Client-supplied information or documentation.\nSettle assessed duties and taxes within the period notified by the Service Provider, failing which the Service Provider may suspend clearing and the cargo shall remain at the Client''s risk and cost.", "order": 15, "title": "Client Obligations for Customs Clearing"}]', true, '2026-08-04 10:03:50.67187+00', '2026-08-04 10:03:50.67187+00', '2026-08-09 18:49:32.843901+00', NULL, NULL, false),
+	('b3783928-3556-43dc-b518-a770174a9524', 'EXPORT_BULK_CUSTOMS', 'Bulk Export Contract (with customs clearing)', 'Export of bulk cargo (e.g. livestock) by railway from Ethiopian loading stations to Nagad railway freight yard, Djibouti. Customs clearing is performed by the Service Provider.', 'Bulk Cargo Transportation Service by Railway', '["The Client has agreed to deliver bulk cargo to the Service Provider for transport from the agreed Ethiopian loading station to Nagad railway freight yard using the Addis Ababa–Djibouti railway line.", "The Service Provider has agreed to provide the service to transport the bulk cargo from the agreed loading station to Nagad railway freight yard."]', '[{"id": "objective", "body": "To undertake the railway transportation of bulk cargo from the agreed Ethiopian loading station to Nagad railway freight yard.", "order": 1, "title": "Objective of the Service"}, {"id": "client-obligations", "body": "Give written instruction to the Service Provider to transport a minimum of one wagon of cargo; the wagon request shall be made at least five (5) days in advance for each wagon.\nMaintain detailed information incorporating type, weight, and destination of the cargo ready for shipment, and notify the Service Provider or its nominated agent by notice, email, or fax.\nPrepare the necessary documents and facilities to make the cargo ready for transport.\nNote the allowable transport period of the cargo: the maximum time range during which the goods maintain their condition without any problem. The allowable transport period must be at least two (2) days longer than the delivery period.\nEnsure cargo is properly loaded and fastened in the wagons, provide the necessary lashing and barriers for loading as per the instruction of the departure station, and bear responsibility for the condition of the cargo during the transport period.\nSupply the necessary provisions for the cargo for each wagon and assign a responsible person to travel with the train to check the status of the cargo during transport, where the nature of the cargo so requires.\nSupply the minimum amount of cargo available for at least one wagon.\nExecute loading, lashing, and preparing barriers on wagons at the loading station and provide the complete documents/bill to the Service Provider within one (1) calendar day.\nFor each extra calendar day used for loading cargo and completing documents at the loading station, pay the wagon-occupied fee per the pricing article; the fee shall be paid within ten (10) calendar days from the date the Service Provider claims it, failing which compensation is payable calculated on the basis of the Commercial Bank of Ethiopia interest rate for the delay period.\nBe responsible for safety matters, and indemnify and hold the Service Provider harmless against all consequences resulting from accidents arising from or associated with the loading and unloading process.\nExecute and cover the cost of loading and unloading of cargo at both the loading station and Nagad railway freight yard.\nFollow up that the cargo is loaded and unloaded on time.\nDelegate representatives at both ends to consign and receive cargo with signature and stamp. Representatives shall hold a duly signed and stamped power of attorney and shall produce their ID or passport when consigning or receiving the cargo.\nPrepare the necessary facilities to take over the transported cargo at Nagad freight yard upon arrival by issuing handover documents.\nTake the transported cargo out of the wagons at Nagad freight yard within one (1) calendar day starting from the day following the notice of arrival.\nPay the wagon-occupied fee per the pricing article for delays of more than one (1) calendar day at Nagad railway freight yard due to the fault of the Client in resolving customs or third-party claims or any other causes.\nAfter the wagon list is submitted to the Client, if a wagon is not loaded due to the fault of the Client, pay 100% of the transportation price per wagon for each unloaded wagon.\nPay the Service Provider 100% of the contract price in advance for each wagon.", "order": 2, "title": "Obligations of the Client"}, {"id": "provider-obligations", "body": "Provide the list and identification numbers of wagons with sequence and locomotives at least twenty-four (24) hours in advance to the Client, with any correction at least twelve (12) hours before arrival at destination.\nTransport the cargo from the loading station to Nagad railway freight yard.\nProvide safe transportation of the cargo throughout the transit.\nPresent customs clearance documents and mobilize the rolling stock as needed.\nProvide the wagons assigned for the freight at the agreed place and time, and follow up that the cargo is loaded on time.\nTransport and deliver the cargo taken over, in the condition received, within two (2) calendar days to Nagad railway freight yard.\nWhere a wagon carrying cargo stops due to accident or mechanical problem, promptly notify the nearby customs station, police office, and the Client. A wagon stopped in Ethiopia due to mechanical defect shall be maintained within four (4) calendar days; within Nagad (Djibouti) territory within twelve (12) calendar days. In case of accident where the problem cannot be solved within one (1) calendar day and the wagon is not operational, the Service Provider shall have the cargo carried and delivered by another wagon, and shall provide an accident or defect report issued by the local police office regarding the sustained damage.\nBuy a cargo liability insurance policy for each supplied wagon.\nProvide wagon cleaning service and charge the cleaning fee based on actual expenditure.\nIf the Client fails or refuses to receive the cargo beyond the allowable transport period, the Service Provider has the right to handle the cargo.\nNeither party shall be liable for any indirect or consequential loss sustained by the other in connection with this Agreement.", "order": 3, "title": "Obligations of the Service Provider"}, {"id": "force-majeure", "body": "The parties have no obligation to pay demurrage or any other compensation if they have failed to discharge their obligations due to force majeure.\nForce majeure shall be deemed to exist when the contract is not performed due to any event beyond the reasonable control of a party which prevents that party from complying with its obligations under this Agreement, including but not limited to:\n- Acts of God (such as, but not limited to, fires, explosions, earthquakes, drought, tidal waves, and floods).\n- War, hostilities (whether war is declared or not), invasion, acts of foreign enemies, mobilization, requisition, or embargo.\n- Rebellion, revolution, insurrection, military or usurped power, or civil war.\n- Contamination by radioactivity from any nuclear fuel or nuclear waste.\n- Riot, commotion, strikes, go-slows, lockouts, or disorder.\n- Acts of terrorism.\nA party wishing to claim protection in respect of a force majeure event shall, as soon as possible following the occurrence or commencement of the event, notify the other party of its nature and expected duration, and shall thereafter keep the other party informed until it is able to perform its obligations under this Agreement.", "order": 4, "title": "Force Majeure"}, {"id": "pricing", "body": "The price of bulk cargo transportation from the loading station to Nagad, together with any applicable demurrage and surcharge rates, is set out in the Rate Schedule immediately below, expressed as unit prices per origin → destination lane and per wagon.\nPayment for transport services shall be made in Birr based on the selling price of USD to Birr on the date of payment set by the Commercial Bank of Ethiopia.\nIf there is an increment or decrement of the USD exchange rate to Birr between the date of payment and the date the wagon/train number is provided to the Client, either the Client shall make the additional payment to the Service Provider or the Service Provider shall refund the difference from the initial payment to the Client.\nThe cost of loading at the loading station and unloading at Nagad shall be covered by the Client and is not part of this contract agreement.\nThe Client shall pay 100% of the contract price in advance.\nThe Client shall pay a demurrage fee for occupied wagons at the rate set out in the Rate Schedule for the applicable occupancy band.\nDemurrage payment shall be made in Birr based on the selling price of USD to Birr set by the Commercial Bank of Ethiopia on the date of the demurrage occurrence.", "order": 5, "title": "Contract Price and Terms of Payment"}, {"id": "contract-documents", "body": "The following documents shall constitute the contract between the Client and the Service Provider:\n- Amendments made to this contract (if any).\n- This Contract Agreement.\n- Final minutes of negotiation (if any).\nIf there is any discrepancy between the documents, they shall be interpreted with priority in the order listed above.", "order": 6, "title": "Contract Documents"}, {"id": "documentation", "body": "The following documents shall be delivered to the Client upon request for settlement:\n- Consignment Note (cargo handover document to the Client).\n- Summary of payment request of the Service Provider prepared as per the agreed tariff.", "order": 7, "title": "Documentation Requirements"}, {"id": "consignment-notes", "body": "The Service Provider must certify the taking over of the goods on the duplicates of the consignment note in an appropriate manner and return the duplicate to the Client.\nA consignment note shall be prima facie evidence of the receipt of the goods by the Service Provider and of the kind, number, and weight of the goods.", "order": 8, "title": "Consignment Notes"}, {"id": "termination", "body": "The contract may be terminated:\n- Upon mutual consent of the parties.\n- Upon completion of the contract period.\n- If either or both parties breach a fundamental provision of the contract, upon prior legal notice delivered by either party.", "order": 9, "title": "Termination of Contract"}, {"id": "effectiveness", "body": "The contract shall come into full force and effect on the date when all of the following are accomplished:\n- The contract is signed by the Client and the Service Provider.\n- The Service Provider has received the advance payment of 100% of the contract price for each train set of cargo.", "order": 10, "title": "Contract Effectiveness"}, {"id": "cargo-amount", "body": "The minimum cargo to be transported shall be one wagon.", "order": 11, "title": "Cargo Amount"}, {"id": "duration", "body": "The contract shall last for three (3) months starting from the date of contract signing, with possible extension upon mutual agreement.", "order": 12, "title": "Duration of Contract"}, {"id": "disputes", "body": "If a dispute arises between the parties, they shall exert efforts to settle their differences amicably.\nIf the parties fail to settle their disputes amicably, the case shall be taken to the competent Federal Court of law presiding in Addis Ababa.\nThe governing law shall be the laws of the Federal Democratic Republic of Ethiopia.", "order": 13, "title": "Settlement of Disputes"}, {"id": "customs-clearing", "body": "The Service Provider shall carry out customs clearing on behalf of the Client for the cargo covered by this Agreement, including declaration, lodgement, and follow-up at the customs stations of Djibouti and Ethiopia as applicable to the agreed corridor.\nThe Service Provider shall act only within the authority granted by the Client and shall not amend a declaration without the Client''s written instruction.\nCustoms duties, taxes, and any government charges assessed on the cargo remain payable by the Client and are not included in the freight price; the Service Provider shall settle them on the Client''s behalf only where the Client has placed the corresponding funds in advance.\nThe Service Provider shall hand over all customs documents obtained in the course of clearing to the Client upon completion of each shipment.", "order": 14, "title": "Customs Clearing Services"}, {"id": "customs-client-duties", "body": "Grant the Service Provider a duly signed and stamped power of attorney authorising it to act as the Client''s customs agent for the duration of this Agreement.\nSubmit every document required for declaration (commercial invoice, packing list, bill of lading or airway bill, permits, certificates of origin, and any authority-specific licence) within one (1) calendar day of the Service Provider''s request.\nWarrant that the declared description, quantity, value, and tariff classification of the cargo are complete and accurate.\nBear any penalty, demurrage, storage, or re-inspection cost arising from incorrect, incomplete, or late Client-supplied information or documentation.\nSettle assessed duties and taxes within the period notified by the Service Provider, failing which the Service Provider may suspend clearing and the cargo shall remain at the Client''s risk and cost.", "order": 15, "title": "Client Obligations for Customs Clearing"}]', true, '2026-08-04 10:03:50.67187+00', '2026-08-04 10:03:50.67187+00', '2026-08-09 18:49:32.843901+00', NULL, NULL, false);
+
+
+--
+-- Data for Name: contracts; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: customer_truck_assignments; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: customer_truck_containers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: customers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: djibouti_import_incidents; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: drivers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: dropdown_options; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.dropdown_options VALUES
+	('1d1498ba-b7f3-4f47-a59d-5244ad61c686', '98bd5f06-f4e3-440d-ba47-e19c144450e3', '3', '3 months', NULL, false, 0, NULL, '2026-07-27 11:32:01.485422+00', '2026-07-27 11:32:01.485422+00', NULL),
+	('3b034dda-71e4-4ddb-81d5-cbc3f06d6ef6', 'c47a2893-335c-4817-9328-fb9890a4b1d9', '180', '6 months', NULL, false, 0, NULL, '2026-07-27 11:32:01.491804+00', '2026-07-27 11:32:01.491804+00', NULL),
+	('629e5c65-c59a-47d1-aca1-81bf6affb55e', 'c47a2893-335c-4817-9328-fb9890a4b1d9', '365', '1 year', NULL, false, 1, NULL, '2026-07-27 11:32:01.491804+00', '2026-07-27 11:32:01.491804+00', NULL),
+	('7e65977a-ec35-47e7-aca4-3390199b8cfd', 'c47a2893-335c-4817-9328-fb9890a4b1d9', '730', '2 years', NULL, false, 2, NULL, '2026-07-27 11:32:01.491804+00', '2026-07-27 11:32:01.491804+00', NULL),
+	('da01bfc4-15d5-4945-94a0-3a51deb70e60', 'ce45706a-1179-4e8f-99d5-479fab15613e', '2', '2 days', NULL, false, 0, NULL, '2026-07-27 11:32:02.553783+00', '2026-07-27 11:32:02.553783+00', NULL),
+	('9cf87112-0fcd-41ab-b650-3e2d3124ce78', 'ce45706a-1179-4e8f-99d5-479fab15613e', '3', '3 days', NULL, false, 1, NULL, '2026-07-27 11:32:02.553783+00', '2026-07-27 11:32:02.553783+00', NULL),
+	('74acb78d-d173-4880-8806-14190b5cf495', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8002', '8002', NULL, false, 0, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('502b4864-577f-421b-9d90-e20be2028b7d', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8102', '8102', NULL, false, 1, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('08118cfb-c024-492d-9a56-fe8a5617b168', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8202', '8202', NULL, false, 2, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('301ead71-e0d7-4df4-af97-a158bf794314', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8302', '8302', NULL, false, 3, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('2b6e0ea2-83b0-4a04-8b16-77500bfdd518', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8402', '8402', NULL, false, 4, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('8fec2516-6d94-448f-be20-e79f4a4be55d', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8502', '8502', NULL, false, 5, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('51ead9ce-4f14-47d1-a8f0-1573d80835d3', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8602', '8602', NULL, false, 6, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('7fdd3fca-2f9a-4db8-ad6f-35b6e6d3b6fd', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8702', '8702', NULL, false, 7, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('849d5172-6191-4649-bbe5-13cf8a4f68b4', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8802', '8802', NULL, false, 8, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('7ac8d28d-4cf0-4ca4-aebe-52c79c4709bd', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '8902', '8902', NULL, false, 9, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('348c3355-80d9-4827-b10b-cb76baa53f79', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '9002', '9002', NULL, false, 10, NULL, '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL),
+	('43fb7b8c-ddd6-4376-aebf-847cc0cc00fb', 'c47a2893-335c-4817-9328-fb9890a4b1d9', '90', '3 months', NULL, false, 1, '{"color": "#00094"}', '2026-07-22 06:21:54.101+00', '2026-07-22 06:21:54.101+00', NULL),
+	('5c84104d-7427-4ef0-887f-5b8407671bd9', 'c47a2893-335c-4817-9328-fb9890a4b1d9', '60', '2 months', NULL, false, 2, NULL, '2026-07-22 06:21:54.101+00', '2026-07-22 06:21:54.101+00', NULL),
+	('19f26681-8f22-4d9d-ae50-e705da6abff4', 'c47a2893-335c-4817-9328-fb9890a4b1d9', '30', '1 month', NULL, false, 3, NULL, '2026-07-22 06:21:54.101+00', '2026-07-22 06:21:54.101+00', NULL),
+	('981397d5-b5fc-4371-92e0-150b881f849c', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '9008', '9008', NULL, false, 12, NULL, '2026-07-23 13:00:05.172+00', '2026-07-23 13:00:05.172+00', NULL),
+	('57414f87-4122-4814-9b2d-7bbe08e7361b', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '1014', '1014', 'BULK TRAIN', false, 13, '{"color": "#0EDF"}', '2026-07-23 13:00:05.172+00', '2026-07-23 13:00:05.172+00', NULL),
+	('8618306c-f4c8-40f1-ab62-922b4a39b07c', 'f64a70f6-30ec-49f6-88be-43e16756ae3d', '7002', '7002', 'Container', false, 14, '{"color": "#0EDF"}', '2026-07-23 13:00:05.172+00', '2026-07-23 13:00:05.172+00', NULL);
+
+
+--
+-- Data for Name: dropdown_settings; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.dropdown_settings VALUES
+	('98bd5f06-f4e3-440d-ba47-e19c144450e3', 'general_contract_period', 'General Contract Period (months)', 'How many months a general contract stays open for ordering after activation.', false, NULL, '2026-07-27 11:32:01.485422+00', '2026-07-27 11:32:01.485422+00', NULL),
+	('c47a2893-335c-4817-9328-fb9890a4b1d9', 'contract_validity_periods', 'Contract Validity Periods (days)', 'Validity durations (in days) a staff can choose when accepting a submitted contract.', false, NULL, '2026-07-27 11:32:01.491804+00', '2026-07-27 11:32:01.491804+00', NULL),
+	('ce45706a-1179-4e8f-99d5-479fab15613e', 'ro_vessel_min_days', 'RO vessel minimum lead time (days)', 'Minimum days between today and the vessel departure date on an export Release Order.', false, NULL, '2026-07-27 11:32:02.553783+00', '2026-07-27 11:32:02.553783+00', NULL),
+	('f64a70f6-30ec-49f6-88be-43e16756ae3d', 'import_train_numbers', 'Import train numbers', 'Even IMPORT run numbers (Djibouti → Ethiopia) selectable when building a train. The paired export number is derived automatically (import − 1).', false, '{"clearable": true, "searchable": true}', '2026-07-27 11:32:03.871542+00', '2026-07-27 11:32:03.871542+00', NULL);
+
+
+--
+-- Data for Name: eims_system_state; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: empty_container_returns; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: exchange_settings; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.exchange_settings VALUES
+	('02889b8a-8a21-4727-9410-bdd9ac9ec024', 162.824500, 'AUTO', '2026-08-07 08:57:41.31+00', NULL, '2026-08-05 07:47:36.666399+00', '2026-08-07 08:57:41.311509+00', NULL);
+
+
+--
+-- Data for Name: external_profiles; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.external_profiles VALUES
+	('9ae4aac8-7e8c-43f0-a707-d29b9767742a', '70b7c52e-cd3c-4b74-89ea-3e4bd6c312c5', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', 'Hilina', 'Regassa', NULL, NULL, true, '2026-08-09 11:55:07.46652+00', '2026-08-09 12:03:29.302612+00', NULL, 'poa', false);
+
+
+--
+-- Data for Name: facilities; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: facility_handling_events; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: fayda_verification_sessions; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.fayda_verification_sessions VALUES
+	('56cd07d8-be79-4809-a025-04ce745dfa65', 'iCKuTwzcpq2Gj1Rl2KUqb5Lsk2Tt0yLjWvudoklKDiY', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:10:23.625+00', '2026-08-09 11:56:55.948+00', '2026-08-09 11:55:23.627045+00', '2026-08-09 11:56:55.950093+00', NULL),
+	('de6bcd87-3422-4e01-8f01-5cf403898178', '4z92nDqxwtUYa6qdNrZ8e9s9rS_egN2b37N25XIA_-E', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:16:44.547+00', '2026-08-09 12:02:57.9+00', '2026-08-09 12:01:44.549122+00', '2026-08-09 12:02:57.903021+00', NULL),
+	('3d9347ec-e14a-4556-a9af-d2941ee94df9', '1y8PBJHJS_MVtXfbwc_I4MYVf86NqKk5kwVq-YcvApM', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:18:31.954+00', '2026-08-09 12:04:51.574+00', '2026-08-09 12:03:31.956729+00', '2026-08-09 12:04:51.576704+00', NULL),
+	('1be2605d-85f7-42e0-9e97-0c19b2e3409b', 'jRN_Yi9kqION5UTKlMiTNAhDlVBXcHdHGkTtBXXvFf0', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:23:49.136+00', '2026-08-09 12:09:34.621+00', '2026-08-09 12:08:49.139308+00', '2026-08-09 12:09:34.623765+00', NULL),
+	('960d964a-32ac-4ca4-95fc-bd2ce88faed3', 'Oj6cJTSRXHrqCJeahB5qIO7feFfTWS4sK3mpcNhC75Q', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:27:18.283+00', '2026-08-09 12:13:50.421+00', '2026-08-09 12:12:18.285552+00', '2026-08-09 12:13:50.423474+00', NULL),
+	('7d7f9042-cd0b-4873-ac62-d2eaefe80af3', 'NXE8OstTpO-5vc0KZSwlE5AynDzrk2I_wD8hWDedDGQ', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:30:43.275+00', '2026-08-09 12:16:54.466+00', '2026-08-09 12:15:43.276603+00', '2026-08-09 12:16:54.467576+00', NULL),
+	('39a7b2f9-a3d2-4286-993a-5f3650353ec3', 'fiH7KCIMhoicqOytynLj8rAaEfrlHr0kHJkkQCIAq20', '', 'VERIFY', 'PORTAL', false, 'COMPLETED', NULL, NULL, NULL, '2026-08-09 12:43:53.926+00', '2026-08-09 12:29:44.957+00', '2026-08-09 12:28:53.928086+00', '2026-08-09 12:29:44.958531+00', NULL),
+	('73fdac88-efba-489f-b191-edcac845de0d', 'ZP-yGtLoQzObob9elpW3wGU7dXlZv2iFV8-nuKGtKuw', 'qZ4U0SHbel3W5-OaWZ5SyuFdPVjP7nJ8VOcA3d6W_8IzFkDBwoQTy4KAhqYr2xG_RQgRWRXKXPVRb8zLty1svw', 'VERIFY', 'PORTAL', false, 'PENDING', NULL, NULL, NULL, '2026-08-09 14:18:03.474+00', NULL, '2026-08-09 14:03:03.476409+00', '2026-08-09 14:03:03.476409+00', NULL);
+
+
+--
+-- Data for Name: ff_clients; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: file_upload_fields; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.file_upload_fields VALUES
+	('ca04e1ea-e785-4655-b23f-27c9d5e19451', 'b568810c-b853-404e-95f0-8304a9ddc75e', 'Bill of Lading/Waybill', 'Bill of Lading/Waybill', NULL, true, false, 1, '{pdf}', 20, 1, '2026-08-04 10:20:34.974496+00', '2026-08-04 10:20:34.974496+00', NULL, NULL, NULL, NULL, NULL),
+	('be6cf792-5d1e-429c-a316-033f2043e78e', 'b568810c-b853-404e-95f0-8304a9ddc75e', 'Commercial Invoice', 'Commercial Invoice', NULL, true, true, 10, '{pdf}', 20, 2, '2026-08-04 10:20:34.974496+00', '2026-08-04 10:20:34.974496+00', NULL, NULL, NULL, NULL, NULL),
+	('b758736f-f83d-4231-b5b8-940d4229a5cf', 'b568810c-b853-404e-95f0-8304a9ddc75e', 'Packing List', 'Packing List', NULL, true, true, 10, '{pdf}', 20, 3, '2026-08-04 10:20:34.974496+00', '2026-08-04 10:20:34.974496+00', NULL, NULL, NULL, NULL, NULL),
+	('8bd784cb-1e56-4978-a3b8-348343eda220', 'b568810c-b853-404e-95f0-8304a9ddc75e', 'Certificate of Origin', 'Certificate of Origin', NULL, true, true, 5, '{pdf}', 20, 4, '2026-08-04 10:20:34.974496+00', '2026-08-04 10:20:34.974496+00', NULL, NULL, NULL, NULL, NULL),
+	('b5873ab6-7517-48b7-8ebd-1ffa377060ce', 'b568810c-b853-404e-95f0-8304a9ddc75e', 'Bank Permit/ Franco Valuta', 'Bank Permit/Franco Valuta', NULL, true, false, 1, '{pdf}', 20, 5, '2026-08-04 10:20:34.974496+00', '2026-08-04 10:20:34.974496+00', NULL, NULL, NULL, NULL, NULL),
+	('0118060a-eefe-4a08-a91b-0043ed4b616c', 'b568810c-b853-404e-95f0-8304a9ddc75e', 'Cargo Insurance', 'Cargo Insurance', NULL, false, false, 1, '{pdf}', 20, 6, '2026-08-04 10:20:34.974496+00', '2026-08-04 10:20:34.974496+00', NULL, NULL, NULL, NULL, NULL),
+	('838252c8-f376-4dd7-aadd-ac3e44c2b23c', 'cb1806df-7169-4dcc-8adb-801ff833f610', 'Bill of Lading/Waybill', 'Bill of Lading/Waybill', NULL, true, false, 1, '{pdf}', 20, 1, '2026-08-04 10:21:14.549605+00', '2026-08-04 10:21:14.549605+00', NULL, NULL, NULL, NULL, NULL),
+	('61b32e04-33eb-4a00-bc67-53951d88ecbc', 'cb1806df-7169-4dcc-8adb-801ff833f610', 'Bank permit/FV', 'Bank Permit/FV', NULL, true, false, 1, '{pdf}', 20, 2, '2026-08-04 10:21:14.549605+00', '2026-08-04 10:21:14.549605+00', NULL, NULL, NULL, NULL, NULL),
+	('2b677ec2-677d-4cca-a59d-f3bd3fac02ff', 'cb1806df-7169-4dcc-8adb-801ff833f610', 'Certificate of Origin', 'Certificate of Origin', NULL, true, false, 1, '{pdf}', 20, 3, '2026-08-04 10:21:14.549605+00', '2026-08-04 10:21:14.549605+00', NULL, NULL, NULL, NULL, NULL),
+	('e8af3fb7-c919-4750-adbd-7e0456e7dc39', 'cb1806df-7169-4dcc-8adb-801ff833f610', 'Commercial Invoice', 'Commercial Invoice', NULL, true, true, 5, '{pdf}', 20, 4, '2026-08-04 10:21:14.549605+00', '2026-08-04 10:21:14.549605+00', NULL, NULL, NULL, NULL, NULL),
+	('d159e493-46e8-4d75-aa27-f1c475baa51b', 'cb1806df-7169-4dcc-8adb-801ff833f610', 'Packing List', 'Packing List', NULL, true, true, 5, '{pdf}', 20, 5, '2026-08-04 10:21:14.549605+00', '2026-08-04 10:21:14.549605+00', NULL, NULL, NULL, NULL, NULL),
+	('8046903a-f7ab-4db4-bd52-2dc8144c4b66', 'cb1806df-7169-4dcc-8adb-801ff833f610', 'Cargo Insurance', 'Cargo Insurance', NULL, false, false, 1, '{pdf}', 20, 6, '2026-08-04 10:21:14.549605+00', '2026-08-04 10:21:14.549605+00', NULL, NULL, NULL, NULL, NULL),
+	('78529880-bc7e-4c7a-b16c-66bd138a6306', '1723498f-c8a8-4af8-a6cb-e80e74cacc22', 'Packing List', 'Packing List', NULL, true, true, 5, '{pdf}', 20, 1, '2026-08-04 10:26:49.082214+00', '2026-08-04 10:26:49.082214+00', NULL, NULL, NULL, NULL, NULL),
+	('b11ab134-f3a2-40cd-a05f-c0db73721cdd', '1723498f-c8a8-4af8-a6cb-e80e74cacc22', 'Import Declaration', 'Import declaration', NULL, false, true, 5, '{pdf}', 20, 2, '2026-08-04 10:26:49.082214+00', '2026-08-04 10:26:49.082214+00', NULL, NULL, NULL, NULL, NULL),
+	('6a077dc6-cb07-48ca-bc31-69a32e4bf43f', '1723498f-c8a8-4af8-a6cb-e80e74cacc22', 'Item Pictures', 'Photo of Items', NULL, false, true, 5, '{jpg,jpeg,png}', 100, 3, '2026-08-04 10:26:49.082214+00', '2026-08-04 10:26:49.082214+00', NULL, NULL, NULL, NULL, NULL),
+	('b70a7e21-15a7-4475-b1a4-59e699b5a697', '1723498f-c8a8-4af8-a6cb-e80e74cacc22', 'Bill of Lading/Waybill', 'Bill of Lading', NULL, true, false, 1, '{pdf}', 20, 4, '2026-08-04 10:26:49.082214+00', '2026-08-04 10:26:49.082214+00', NULL, NULL, NULL, NULL, NULL),
+	('43d91420-e4bc-4a63-ab2a-9fcceeef1483', '1723498f-c8a8-4af8-a6cb-e80e74cacc22', 'Ethiopia T1 and Djibouti T1', 'Ethiopia T1 and Djibouti T1', NULL, false, true, 10, '{pdf}', 30, 5, '2026-08-04 10:26:49.082214+00', '2026-08-04 10:26:49.082214+00', NULL, NULL, NULL, NULL, NULL),
+	('8e37a920-82ff-4b71-adf2-1d2e20030299', '08a29c8d-1480-41d6-b552-034c5ead4c93', 'Bill of Lading/Waybill', 'Bill of Lading/Waybill', NULL, true, false, 1, '{pdf}', 20, 1, '2026-08-04 10:29:36.693631+00', '2026-08-04 10:29:36.693631+00', NULL, NULL, NULL, NULL, NULL),
+	('843b736a-a0fe-4a53-9b37-43b039906304', '08a29c8d-1480-41d6-b552-034c5ead4c93', 'Packing List', 'Packing List', NULL, true, true, 10, '{pdf}', 20, 2, '2026-08-04 10:29:36.693631+00', '2026-08-04 10:29:36.693631+00', NULL, NULL, NULL, NULL, NULL),
+	('37a44809-8842-4bfa-9d92-9c2e516a35e0', '08a29c8d-1480-41d6-b552-034c5ead4c93', 'Import Declaration', 'Import declaration', NULL, false, true, 5, '{pdf}', 20, 3, '2026-08-04 10:29:36.693631+00', '2026-08-04 10:29:36.693631+00', NULL, NULL, NULL, NULL, NULL),
+	('641815b8-c4d5-45fa-b714-5705efde87d7', '08a29c8d-1480-41d6-b552-034c5ead4c93', 'Ethiopia T1 and Djibouti T1', 'Ethiopia T1 and Djibouti T1', NULL, false, true, 5, '{pdf}', 20, 4, '2026-08-04 10:29:36.693631+00', '2026-08-04 10:29:36.693631+00', NULL, NULL, NULL, NULL, NULL),
+	('921e0d91-6802-49a8-b0f3-bd76f757aeb8', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Booking Confirmation', 'Booking Confirmation', NULL, true, false, 1, '{pdf}', 20, 1, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('a75cedb3-d7b5-4d7d-bd84-1c9d40597f8b', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Shipping Instruction', 'Shipping Instruction', NULL, true, false, 1, '{pdf}', 20, 2, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('726b962d-97c0-4b62-860e-f2a20c150765', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Verified Gross Mass (VGM)', 'Verified Gross Mass (VGM)', NULL, true, false, 1, '{pdf}', 20, 3, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('7ed6024a-7498-4877-9af4-32d98a8a5f19', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Train Waybill', 'Train Waybill', NULL, true, false, 1, '{pdf}', 20, 4, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('015d6cfd-4740-4baa-880f-f081bd064a44', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Commercial Invoice', 'Commercial Invoice', NULL, true, true, 5, '{pdf}', 20, 5, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('600f2e27-9fba-4d6a-ac78-7b354413a6ae', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Packing List', 'Packing List', NULL, true, true, 5, '{pdf}', 20, 6, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('00e51737-12e5-4503-9ea6-3e4f8bc9ac3d', '85e1910c-25ba-4c48-a452-6fef6d39b10a', 'Bank Permit', 'Bank Permit', NULL, true, false, 1, '{pdf}', 20, 7, '2026-08-04 10:35:27.984353+00', '2026-08-04 10:35:27.984353+00', NULL, NULL, NULL, NULL, NULL),
+	('3ccceb6b-1e1f-4f13-a974-dd73f2c2d738', 'c1d7ae47-9703-4a1d-8cd3-0974d59acb3d', 'Release Order (RO)', 'Release Order (RO)', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 20, 1, '2026-08-04 10:38:04.440343+00', '2026-08-04 10:38:04.440343+00', NULL, NULL, NULL, NULL, NULL),
+	('9ea15c05-aebe-4133-b2ad-5f52bbbbdf58', 'c1d7ae47-9703-4a1d-8cd3-0974d59acb3d', 'Verified Gross Mass (VGM)', 'Verified Gross Mass (VGM)', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 20, 2, '2026-08-04 10:38:04.440343+00', '2026-08-04 10:38:04.440343+00', NULL, NULL, NULL, NULL, NULL),
+	('5635a410-3e82-411e-bd03-47abedcede6b', 'c1d7ae47-9703-4a1d-8cd3-0974d59acb3d', 'Export Declaration', 'Export declaration', NULL, false, true, 5, '{pdf}', 20, 3, '2026-08-04 10:38:04.440343+00', '2026-08-04 10:38:04.440343+00', NULL, NULL, NULL, NULL, NULL),
+	('5838b4a0-adfc-44ba-b648-b0ac5c17f63a', 'c1d7ae47-9703-4a1d-8cd3-0974d59acb3d', 'Export T1', 'Export T1', NULL, false, false, 1, '{pdf}', 10, 4, '2026-08-04 10:38:04.440343+00', '2026-08-04 10:38:04.440343+00', NULL, NULL, NULL, NULL, NULL),
+	('99a17b67-f198-4add-a778-10b338f75ada', '318aa395-9f14-4326-92dd-7af2ee960e00', 'Packing List', 'Packing List', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 20, 1, '2026-08-04 10:39:12.558482+00', '2026-08-04 10:39:12.558482+00', NULL, NULL, NULL, NULL, NULL),
+	('735b7cc7-586c-4f81-8fd2-c73184aa8497', '318aa395-9f14-4326-92dd-7af2ee960e00', 'Waybill', 'Waybill', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 20, 2, '2026-08-04 10:39:12.558482+00', '2026-08-04 10:39:12.558482+00', NULL, NULL, NULL, NULL, NULL),
+	('f34aeac3-657e-49a7-993b-a378434ad555', 'a017fb18-9c12-41c0-8d18-bff1b7cfd247', 'Drivers License', 'Drivers License', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 20, 1, '2026-08-04 10:41:11.331705+00', '2026-08-04 10:41:11.331705+00', NULL, NULL, NULL, NULL, NULL),
+	('8a817b47-e6c1-4dde-bcdc-8be16d5bcb99', 'a017fb18-9c12-41c0-8d18-bff1b7cfd247', 'Kebele ID', 'Kebele ID', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 10, 2, '2026-08-04 10:41:11.331705+00', '2026-08-04 10:41:11.331705+00', NULL, NULL, NULL, NULL, NULL),
+	('1b9d046c-48ea-4e93-9df1-cd8f0605ba61', 'a017fb18-9c12-41c0-8d18-bff1b7cfd247', 'Company ID', 'Company ID', NULL, false, false, 1, '{pdf,jpg,jpeg,png}', 20, 3, '2026-08-04 10:41:11.331705+00', '2026-08-04 10:41:11.331705+00', NULL, NULL, NULL, NULL, NULL),
+	('6475f9ef-dfd3-4639-b12c-b9f1fcbfb4e3', 'dbabef1b-9203-4fd3-9808-ba2cc1618c36', 'Commercial Registration', 'Commercial Registration', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 30, 1, '2026-08-04 10:43:25.014753+00', '2026-08-04 10:43:25.014753+00', NULL, NULL, NULL, NULL, NULL),
+	('efcab3cf-b166-47de-a795-e5c597df4ab1', 'dbabef1b-9203-4fd3-9808-ba2cc1618c36', 'TIN Certificate', 'TIN Certificate', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 30, 2, '2026-08-04 10:43:25.014753+00', '2026-08-04 10:43:25.014753+00', NULL, NULL, NULL, NULL, NULL),
+	('6e7b21e1-4c6a-4707-86c8-5a3039222739', 'dbabef1b-9203-4fd3-9808-ba2cc1618c36', 'Business License', 'Business License', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 30, 3, '2026-08-04 10:43:25.014753+00', '2026-08-04 10:43:25.014753+00', NULL, NULL, NULL, NULL, NULL),
+	('8e065892-e909-4635-bc88-2ef261c0e089', 'dbabef1b-9203-4fd3-9808-ba2cc1618c36', 'National ID', 'National ID', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 30, 4, '2026-08-04 10:43:25.014753+00', '2026-08-04 10:43:25.014753+00', NULL, NULL, NULL, NULL, NULL),
+	('f66e7795-749d-49b8-a34b-17bdc502a42e', 'a59d02bf-f46a-44b8-b5b5-2b88ef3f5116', 'Material Safety Data Sheet (MSDS)', 'Material Safety Data Sheet (MSDS)', NULL, true, true, 5, '{pdf}', 100, 1, '2026-08-04 10:44:03.967397+00', '2026-08-04 10:44:03.967397+00', NULL, NULL, NULL, NULL, NULL),
+	('018ec1b3-bc42-470b-984a-b670adb98d40', '14320fce-352c-4c45-aff3-2a1ac89f8e93', 'Commercial Registration', 'Commercial Registration', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 21, 1, '2026-08-04 10:50:46.395716+00', '2026-08-04 10:50:46.395716+00', NULL, NULL, NULL, NULL, NULL),
+	('27efd0e3-0152-408a-ac96-8d36231f0104', '14320fce-352c-4c45-aff3-2a1ac89f8e93', 'TIN Certificate', 'TIN Certificate', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 20, 2, '2026-08-04 10:50:46.395716+00', '2026-08-04 10:50:46.395716+00', NULL, NULL, NULL, NULL, NULL),
+	('8dc7b971-bf96-4248-b808-14dc1d9e91c5', '14320fce-352c-4c45-aff3-2a1ac89f8e93', 'Business License / Investment License', 'Business License / Investment License', NULL, true, true, 5, '{pdf,jpg,jpeg,png}', 20, 3, '2026-08-04 10:50:46.395716+00', '2026-08-04 10:50:46.395716+00', NULL, NULL, NULL, NULL, NULL),
+	('9dcccc5e-85fa-4fe3-82ab-e43528e63b82', '14320fce-352c-4c45-aff3-2a1ac89f8e93', 'Delegated person National ID', 'Delegated person National ID', NULL, true, false, 1, '{pdf,jpg,jpeg,png}', 10, 4, '2026-08-04 10:50:46.395716+00', '2026-08-04 10:50:46.395716+00', NULL, NULL, NULL, NULL, NULL),
+	('9220c51a-883f-4903-9a38-371a0f34ce70', '14320fce-352c-4c45-aff3-2a1ac89f8e93', 'Passport of Owner/Investor', 'Passport of Owner/Investor', NULL, false, false, 1, '{pdf,jpg,jpeg,png}', 21, 5, '2026-08-04 10:50:46.395716+00', '2026-08-04 10:50:46.395716+00', NULL, NULL, NULL, NULL, NULL),
+	('a5fe3255-7801-40f5-84ac-c0f28d5789f8', '8dd290f8-9ac7-466a-b754-b37ddf75a0d3', 'jj', 'j', NULL, false, false, 1, '{pdf,png,jpeg,jpg}', 10, 1, '2026-08-05 21:36:43.819425+00', '2026-08-05 21:36:43.819425+00', NULL, NULL, NULL, NULL, NULL);
+
+
+--
+-- Data for Name: file_upload_settings; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.file_upload_settings VALUES
+	('dbabef1b-9203-4fd3-9808-ba2cc1618c36', 'company_onboarding_documents_ethiopian', 'Ethiopian company onboarding documents', 'Required documents for external company onboarding, by company nationality.', 'customer', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('14320fce-352c-4c45-aff3-2a1ac89f8e93', 'company_onboarding_documents_foreign', 'Foreign company onboarding documents', 'Required documents for external company onboarding, by company nationality.', 'customer', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('b568810c-b853-404e-95f0-8304a9ddc75e', 'clearance_import_container_with_customs', 'Import container clearance documents (with customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('08a29c8d-1480-41d6-b552-034c5ead4c93', 'clearance_import_container_without_customs', 'Import container documents (without customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('85e1910c-25ba-4c48-a452-6fef6d39b10a', 'clearance_export_container_with_customs', 'Export container clearance documents (with customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('c1d7ae47-9703-4a1d-8cd3-0974d59acb3d', 'clearance_export_container_without_customs', 'Export container documents (without customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('cb1806df-7169-4dcc-8adb-801ff833f610', 'clearance_import_bulk_with_customs', 'Import bulk clearance documents (with customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('1723498f-c8a8-4af8-a6cb-e80e74cacc22', 'clearance_import_bulk_without_customs', 'Import bulk documents (without customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('520ab103-159c-4c87-adfe-32878ede33f5', 'clearance_export_bulk_with_customs', 'Export bulk clearance documents (with customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('8dd290f8-9ac7-466a-b754-b37ddf75a0d3', 'clearance_export_bulk_without_customs', 'Export bulk documents (without customs)', 'Operation/clearance documents collected after contract execution, by operation, freight type and customs.', 'booking_clearance', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('a017fb18-9c12-41c0-8d18-bff1b7cfd247', 'driver_docs', 'Driver documents', 'Documents uploaded against a driver profile (license, ID, contracts, etc.).', 'driver', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('a59d02bf-f46a-44b8-b5b5-2b88ef3f5116', 'hazardous_documents', 'Hazardous cargo documents', 'Documents required when a one-time contract''s cargo is flagged hazardous.', 'contract_intake', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL),
+	('318aa395-9f14-4326-92dd-7af2ee960e00', 'intercity_documents', 'Intercity documents', 'Intercity shipment documents — contract-level for ONE_TIME (after both signatures), per booking for GENERAL; reviewed by Operations.', 'booking', '2026-08-04 10:04:29.802713+00', '2026-08-04 10:04:29.802713+00', NULL);
+
+
+--
+-- Data for Name: files; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.files VALUES
+	('cfbc6c70-fc9d-4fd4-81ba-acf07d5d713d', '37f9df6c-95a8-41a6-81fc-4ece3c31a712', 'companies', 'poa_delegation_letter', 'sample (1).pdf', 'https://file.smartoffice.edrsc.com:443/edr-prod/companies/37f9df6c-95a8-41a6-81fc-4ece3c31a712/1786277655116_4ec4a41d_sample_1_.pdf', 18810, 'application/pdf', '2026-08-09 12:14:15.132835+00', '2026-08-09 12:14:15.132835+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, false, NULL, NULL);
+
+
+--
+-- Data for Name: first_mile; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.first_mile VALUES
+	('14752f25-e0d2-416f-95ab-f310a8b45e3a', 'd1d73d4d-c2c9-4025-af7c-5c2c5327e9f1', 'READY_TO_TRANSIT', 4900.00, 0.00, 18.00, NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, true),
+	('f8e18558-a5ce-4bd4-b14f-d1a28ec31964', '524ef40f-a1ee-401d-8ecb-f1ce9f5374e4', 'READY_TO_TRANSIT', 5500.00, 0.00, 18.00, NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, true),
+	('0bcc4de7-1957-4b98-91ef-87e6949c1fca', 'ec0da804-5163-4f1f-87a7-8a9215159146', 'READY_TO_TRANSIT', 3200.00, 0.00, 18.00, NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, true);
+
+
+--
+-- Data for Name: first_mile_container_allocations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: first_mile_vehicle_assignments; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: fleet_events; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: fuel_consumption; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: fuel_purchases; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: gps_devices; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: gps_positions; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: import_customs_finalizations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: import_djibouti_operations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.import_djibouti_operations VALUES
+	('7a3c4300-274b-4cdd-b743-0a2f6c4f93c1', '114535c3-880b-46b3-b6fc-7953a5d0de5b', '{}', NULL, NULL, NULL, '2026-08-09 20:18:31.327952+00', NULL, NULL, NULL, '2026-08-09 20:18:31.327952+00', '2026-08-09 20:18:31.327952+00', NULL);
+
+
+--
+-- Data for Name: incidents; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: interchange_document_items; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: interchange_documents; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: invoice_lines; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: invoices; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: last_mile; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.last_mile VALUES
+	('4b65f06f-1195-4eaf-85b1-fe4b8df63715', '346725c9-6075-4283-a59d-c0cfb58d2e52', 'READY_TO_TRANSIT', 5600.00, 0.00, 22.00, NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, true, NULL, NULL, NULL, NULL, '{}', NULL, NULL),
+	('d732104f-ee3c-482c-8c03-20a7067844d3', 'dc105e51-7acd-4706-a7a0-b77dc4b28059', 'READY_TO_TRANSIT', 6000.00, 0.00, 22.00, NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, true, NULL, NULL, NULL, NULL, '{}', NULL, NULL),
+	('3eea018d-9bf0-4ec6-9bc1-dc20a1fe7818', 'd733c2dd-f5f0-4b88-b675-1447fc30d821', 'READY_TO_TRANSIT', 4500.00, 0.00, 22.00, NULL, NULL, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, true, NULL, NULL, NULL, NULL, '{}', NULL, NULL);
+
+
+--
+-- Data for Name: last_mile_container_allocations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: last_mile_requests; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.last_mile_requests VALUES
+	('52d80132-826e-4683-8ec0-18e679fbeddf', '346725c9-6075-4283-a59d-c0cfb58d2e52', '114535c3-880b-46b3-b6fc-7953a5d0de5b', 'APPROVED', '{LMRT1234567}', '2026-08-09 20:20:00.023+00', '0270629a-1eea-43e3-adc4-fe6142d37bb3', '2026-08-09 20:45:49.576+00', 'f1534714-fa4a-4780-a081-05d4c1f6c25f', '2026-08-09 20:46:56.974+00', NULL, '4b65f06f-1195-4eaf-85b1-fe4b8df63715', '2026-08-09 20:20:00.02211+00', '2026-08-09 20:46:56.972191+00', NULL, '2026-08-15', 3500.00, '{"mode": null, "lines": [], "total": null, "currency": null, "estimatedKm": null, "advanceAmount": 3500}', '2026-08-09 20:46:56.974+00', NULL, NULL, NULL);
+
+
+--
+-- Data for Name: last_mile_vehicle_assignments; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: last_mile_vehicle_containers; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: locomotives; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.locomotives VALUES
+	('8e777b5a-2501-40d9-a138-4914d5f13cf9', 'LOCO-025', 'ERF-025', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:39:46.812+00', '2026-08-07 11:08:06.381337+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('b34a62e0-a4a9-4563-83d6-9e2206b74b10', 'LOCO-026', 'ERF-026', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:40:34.539+00', '2026-08-07 11:08:34.146585+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('dddc30d3-b60a-4344-bddd-71c9ad91ddec', 'LOCO-027', 'ERF-027', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:41:42.451+00', '2026-08-07 11:08:54.662291+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('b67b7043-d216-4392-8313-7b43452e612d', 'LOCO-001', 'ERF-001', 1750.000, 'AVAILABLE', NULL, '2026-07-17 09:08:46.44+00', '2026-08-07 11:11:18.931482+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('a752720a-46b5-4746-ad7e-8961479ba86c', 'LOCO-029', 'ERF-029', 1750.000, 'MAINTENANCE', NULL, '2026-07-17 13:44:44.639+00', '2026-08-07 11:13:43.814604+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 46.500, 10.000),
+	('18e7df4e-71ec-4928-bb51-d7ad4df6ee85', 'LOCO-021', 'ERF-021', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:00:54.921+00', '2026-08-07 11:07:06.625588+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 465.000, 10.000),
+	('a8142510-249a-491e-903f-1d05abb129f7', 'LOCO-002', 'ERF-002', 1750.000, 'AVAILABLE', NULL, '2026-07-17 09:08:58.583+00', '2026-08-07 11:01:22.208899+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('1e13bf8d-d01e-4438-993d-db77ce5203eb', 'LOCO-003', 'ERF-003', 1750.000, 'AVAILABLE', NULL, '2026-07-17 10:40:10.537+00', '2026-08-07 11:01:34.280629+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('d6907984-bcfb-4408-b823-0fecc284f393', 'LOCO-004', 'ERF-004', 1750.000, 'AVAILABLE', NULL, '2026-07-17 10:40:33.436+00', '2026-08-07 11:01:44.691011+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 93.000, 10.000),
+	('fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 'LOCO-005', 'ERF-005', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:11:12.903+00', '2026-08-07 11:01:58.985321+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 93.000, 10.000),
+	('884ec005-4ea4-4c9c-86db-7e1617faeeba', 'LOCO-006', 'ERF-006', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:11:28.008+00', '2026-08-07 11:02:10.446392+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('5eeb26b1-0631-4870-ab4f-352ac49cf8d1', 'LOCO-007', 'ERF-007', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:31:50.666+00', '2026-08-07 11:02:25.899819+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('87662a07-2c7b-45c5-a4ff-c89fb9bc105c', 'LOCO-008', 'ERF-008', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:32:15.854+00', '2026-08-07 11:02:41.024042+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 93.000, 10.000),
+	('c07ddf04-36c6-468f-a2c6-7fd2732d8782', 'LOCO-009', 'ERF-009', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:32:25.675+00', '2026-08-07 11:02:51.893978+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 93.000, 10.000),
+	('a2fc8e45-ec84-4771-ae60-25d20fda25b1', 'LOCO-010', 'ERF-010', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:32:34.829+00', '2026-08-07 11:03:17.549299+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 'LOCO-011', 'ERF-011', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:32:40.778+00', '2026-08-07 11:03:31.795372+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('48a8700a-8c1f-449d-b731-bcb11fc94995', 'LOCO-012', 'ERF-012', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:33:10.667+00', '2026-08-07 11:03:40.907856+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('ca503969-35b6-40d4-8787-690fd8715dda', 'LOCO-013', 'ERF-013', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:34:02.086+00', '2026-08-07 11:03:59.252301+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('028d9ac6-7a2f-42c7-9168-6165afacc3ab', 'LOCO-014', 'ERF-014', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:34:31.921+00', '2026-08-07 11:04:10.060609+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('2dd03327-d9d5-4a08-af02-e59916ccea97', 'LOCO-015', 'ERF-015', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:34:55.853+00', '2026-08-07 11:04:20.359382+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('1620633d-c8ce-4130-9fb7-80edf1d86641', 'LOCO-016', 'ERF-016', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:35:35.231+00', '2026-08-07 11:04:30.669375+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('0b48c5d6-0360-49b1-b4c9-433eb1cd1a87', 'LOCO-017', 'ERF-017', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:37:25.358+00', '2026-08-07 11:04:40.055947+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('22ccb1d9-adfd-4a04-bc37-a6d4bb2ee9b7', 'LOCO-018', 'ERF-018', 1750.000, 'AVAILABLE', NULL, '2026-07-17 11:37:46.651+00', '2026-08-07 11:04:52.578328+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 'LOCO-019', 'ERF-019', 1750.000, 'AVAILABLE', NULL, '2026-07-17 12:49:06.304+00', '2026-08-07 11:05:49.794033+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('38874f67-9563-438d-b1bb-ed61c6aedc84', 'LOCO-020', 'ERF-020', 1750.000, 'AVAILABLE', NULL, '2026-07-17 12:50:06.544+00', '2026-08-07 11:06:00.483915+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 93.000, 10.000),
+	('98d11eea-94bd-4c4a-8897-f17740ea094c', 'LOCO-022', 'ERF-022', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:27:32.594+00', '2026-08-07 11:06:57.136607+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('5d9e0a41-6b02-4f13-b431-a32bb854261c', 'LOCO-023', 'ERF-023', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:30:43.108+00', '2026-08-07 11:07:20.916649+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('dc23c9a3-5004-4145-807e-6240b415595e', 'LOCO-024', 'ERF-024', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:31:19.365+00', '2026-08-07 11:07:37.879341+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000),
+	('c691c3cc-cfa8-4fb8-b980-ec7e53d213af', 'LOCO-031', 'ERS-031', 1750.000, 'MAINTENANCE', NULL, '2026-07-17 13:46:02.204+00', '2026-08-04 13:18:20.576924+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 93.000, 10.000),
+	('479253a8-ab4d-4d1b-8fe3-eece22e08274', 'LOCO-032', 'ERS-032', 1750.000, 'MAINTENANCE', NULL, '2026-07-17 13:46:36.005+00', '2026-08-04 13:18:47.493009+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 93.000, 10.000),
+	('d0aa7d9f-18e9-492c-b55d-790f4ce08ff2', 'LOCO-030', 'ERS-030', 1750.000, 'MAINTENANCE', NULL, '2026-07-17 13:45:24.654+00', '2026-08-04 13:19:00.259551+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 93.000, 10.000),
+	('40a7b5a3-c107-4288-ba73-70ca9a735972', 'LOCO-028', 'ERF-028', 1750.000, 'AVAILABLE', NULL, '2026-07-17 13:44:17.682+00', '2026-08-07 20:02:32.538854+00', NULL, 'ELECTRIC', 760.000, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 46.500, 10.000);
+
+
+--
+-- Data for Name: maintenance_costs; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: maintenance_intervals; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: maintenance_schedules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: migrations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.migrations VALUES
+	(300, 3250000000000, 'FreightBaseline3250000000000'),
+	(301, 3260000000000, 'InvoicePaymentProcessingStatus3260000000000'),
+	(302, 3250000000000, 'CreateLastMileRequests3250000000000'),
+	(303, 3270000000000, 'YardGpsLocation3270000000000'),
+	(304, 3280000000000, 'LastMileRateBands3280000000000'),
+	(305, 3290000000000, 'LastMileRequestContract3290000000000'),
+	(306, 3300000000000, 'BookingWagonCancellations3300000000000'),
+	(307, 3310000000000, 'WagonStatusLogs3310000000000'),
+	(308, 3320000000000, 'BulkContractTemplates3320000000000'),
+	(309, 3330000000000, 'EimsInvoiceRegistration3330000000000'),
+	(310, 3340000000000, 'EimsDocumentNumberSequence3340000000000'),
+	(311, 3350000000000, 'SupportContent3350000000000'),
+	(312, 3360000000000, 'SupportHelpSections3360000000000'),
+	(313, 3370000000000, 'SupportHelpInlineMedia3370000000000'),
+	(314, 3370000000000, 'BookingExportHandoverMode3370000000000');
+
+
+--
+-- Data for Name: notifications; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.notifications VALUES
+	('1a42f47f-09c5-4a8f-83c4-a478216c2f1a', '0326574c-f81e-45b4-8b4f-cf578fa161dc', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"email": true}', '2026-08-09 20:20:00.040406+00', '2026-08-09 20:20:00.054716+00', NULL),
+	('6fafe0f4-fcc1-4e6f-8e8a-ce0ac2690e60', 'aaa04914-b7ee-47b3-9c63-4324046a26bd', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"sms": true, "email": true}', '2026-08-09 20:20:00.057377+00', '2026-08-09 20:20:00.07081+00', NULL),
+	('bdb3000c-87fa-4923-8b96-bb73a36c1495', '16357eab-47bd-4599-b048-53fc34f5462f', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"sms": true, "email": true}', '2026-08-09 20:20:00.076129+00', '2026-08-09 20:20:00.087579+00', NULL),
+	('5a818934-c214-4490-9f07-5e5661445c2c', 'f1534714-fa4a-4780-a081-05d4c1f6c25f', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"email": true}', '2026-08-09 20:20:00.090851+00', '2026-08-09 20:20:00.101123+00', NULL),
+	('6c9438cb-1c7f-4a00-8695-f283ad7b86cf', '3d3bf567-82de-46a3-9214-a1cd0621d2ee', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"sms": true, "email": true}', '2026-08-09 20:20:00.105244+00', '2026-08-09 20:20:00.119322+00', NULL),
+	('6732565f-8dae-4821-8844-7690999b2a57', 'ed741a64-6aa1-4bbd-bff7-1d1d143aac1c', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"sms": true, "email": true}', '2026-08-09 20:20:00.123918+00', '2026-08-09 20:20:00.138757+00', NULL),
+	('50b6a6ab-5bc1-4e84-8666-5b8ca29f4fb3', '66bba880-b46b-425e-a8c6-463ed61f725f', 'BACKOFFICE', 'SCHEDULE_UPDATE', 'Last-mile confirmation expected', 'train LMR-TEST-01 carrying booking PAID-IMP-001 has departed Djibouti — awaiting the customer''s last-mile confirmation.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'HIGH', false, NULL, '{"email": true}', '2026-08-09 20:20:00.14304+00', '2026-08-09 20:20:00.155759+00', NULL),
+	('feb08ee2-6d6a-4d13-8c9b-2eb55d11067c', '0326574c-f81e-45b4-8b4f-cf578fa161dc', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.585522+00', '2026-08-09 20:45:49.585522+00', NULL),
+	('b90458ca-a530-49bf-9a6b-387557f8434b', 'aaa04914-b7ee-47b3-9c63-4324046a26bd', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.592451+00', '2026-08-09 20:45:49.592451+00', NULL),
+	('7383758e-4d74-432c-ab61-ee792e98e4b5', '16357eab-47bd-4599-b048-53fc34f5462f', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.600261+00', '2026-08-09 20:45:49.600261+00', NULL),
+	('afe68ab8-64b0-4214-88d9-107a374ab595', 'f1534714-fa4a-4780-a081-05d4c1f6c25f', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.604792+00', '2026-08-09 20:45:49.604792+00', NULL),
+	('d42118c8-7cf0-4cad-8e2f-483d412c4247', '3d3bf567-82de-46a3-9214-a1cd0621d2ee', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.609172+00', '2026-08-09 20:45:49.609172+00', NULL),
+	('4dbb4a7c-e820-44fa-b260-6dc2a7f66995', 'ed741a64-6aa1-4bbd-bff7-1d1d143aac1c', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.613467+00', '2026-08-09 20:45:49.613467+00', NULL),
+	('2fd0b2ae-828d-4228-b86f-5d69d2295bea', '66bba880-b46b-425e-a8c6-463ed61f725f', 'BACKOFFICE', 'REQUEST_SUBMITTED', 'Last-mile request ready for review', 'Booking PAID-IMP-001 confirmed 1 container(s) for EDR last-mile.', '/dashboard/operations/last-mile?tab=requests', '{"bookingId": "346725c9-6075-4283-a59d-c0cfb58d2e52", "requestId": "52d80132-826e-4683-8ec0-18e679fbeddf"}', 'NORMAL', false, NULL, NULL, '2026-08-09 20:45:49.617206+00', '2026-08-09 20:45:49.617206+00', NULL);
+
+
+--
+-- Data for Name: otp_verifications; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: parts; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: payment_refunds; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: payment_webhook_events; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: payments; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: priority_configs; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.priority_configs VALUES
+	('1d0bf65b-24d0-44c9-9274-9f7545580944', 'CUSTOMS', 'With customs 1–10 wagons', NULL, 1, 10, 7, true, 1, '2026-07-27 11:32:03.224028+00', '2026-07-27 11:32:03.224028+00', NULL),
+	('55623761-0614-4f5f-9f4f-b66bd386f24d', 'WAGON', '1784277238848', NULL, 1, 4, 5, true, 3, '2026-07-17 08:34:02.653+00', '2026-07-17 08:34:02.653+00', NULL),
+	('db61041d-6294-4400-b2a2-a02d8e392c37', 'WAGON', '1784277274795', NULL, 5, 10, 7, true, 4, '2026-07-17 08:34:35.43+00', '2026-07-17 08:34:35.43+00', NULL),
+	('c5e33432-4c8e-4be8-83b9-68452c7bc672', 'WAGON', '1784277311022', NULL, 11, 15, 10, true, 5, '2026-07-17 08:35:11.976+00', '2026-07-17 08:35:11.976+00', NULL),
+	('98e63b88-a9cc-46c2-85fe-01cdfdf1c5ec', 'WAGON', '1784277346036', NULL, 16, 20, 12, true, 6, '2026-07-17 08:35:46.904+00', '2026-07-17 08:35:46.904+00', NULL),
+	('14d40ef2-a97f-4003-86c3-dc569e127855', 'WAGON', '1784277392144', NULL, 21, 30, 15, true, 7, '2026-07-17 08:36:32.835+00', '2026-07-17 08:36:32.835+00', NULL),
+	('b392b2f7-6c7c-4449-91e3-2e81b72314fc', 'WAGON', '1784277437088', NULL, 31, 40, 30, true, 8, '2026-07-17 08:37:18.01+00', '2026-07-17 08:37:18.01+00', NULL),
+	('6cd1e9e9-8c03-40dc-92f3-a3bfe5a63b4c', 'CURRENCY', '1784277766313', 'USD', 1, 25, 17, true, 10, '2026-07-17 08:42:47.741+00', '2026-07-17 08:42:47.741+00', NULL),
+	('985c2e4d-1d01-4634-9aec-57105367efe0', 'WAGON', '1784277554742', NULL, 41, 54, 50, true, 9, '2026-07-17 08:39:20.59+00', '2026-07-18 05:34:17.075+00', NULL),
+	('5aa6cb93-39f5-4954-ae5a-c9257951addd', 'CURRENCY', '1784278089451', 'USD', 26, 54, 35, true, 11, '2026-07-17 08:48:11.061+00', '2026-07-18 05:35:33.992+00', NULL),
+	('89f6ecdb-09d5-471c-847a-2411c3c622f8', 'CUSTOMS', 'With customs 11–53 wagons', NULL, 11, 54, 15, true, 2, '2026-07-27 11:32:03.224028+00', '2026-08-04 07:47:39.081638+00', NULL);
+
+
+--
+-- Data for Name: priority_rule_change_requests; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.priority_rule_change_requests VALUES
+	('200988a4-907a-4117-b5ff-7ee08c1a6d57', 'UPDATE', '89f6ecdb-09d5-471c-847a-2411c3c622f8', '{"type": "CUSTOMS", "label": "With customs 11–53 wagons", "isActive": true, "scorePoints": 15, "maxWagonCount": 54, "minWagonCount": 11}', 'APPROVED', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-04 07:47:39.082+00', NULL, '2026-08-04 07:47:33.389467+00', '2026-08-04 07:47:39.085002+00', NULL);
+
+
+--
+-- Data for Name: priority_rules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: rate_change_requests; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: rates; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.rates VALUES
+	('eaa9bb9f-54eb-4d1e-a59e-c81981aec213', 'CONTAINER_IMPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 845.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:57.82+00', '2026-08-05 11:30:04.445362+00', '2026-08-05 17:00:57.820623+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('d4066936-06a9-44e8-8d5c-884ff651e174', 'CONTAINER_IMPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 753.5000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:49.627+00', '2026-08-05 11:31:16.406767+00', '2026-08-05 17:00:49.628175+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('173ab9ac-9dad-474f-98b3-16129fe7df58', 'CONTAINER_IMPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 1507.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:55.444+00', '2026-08-05 11:30:38.084249+00', '2026-08-05 17:00:55.444438+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('7655da1f-51dc-48c3-b1f7-b32e0847e004', 'RETURN_SURCHARGE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 108.5000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:01.843+00', '2026-08-05 11:58:37.632036+00', '2026-08-05 17:00:01.843767+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('cef5e799-c0a7-4810-acfc-3ba8cfafd0b9', 'RETURN_SURCHARGE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 127.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:08.388+00', '2026-08-05 11:55:45.087401+00', '2026-08-05 17:00:08.388788+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('b6461912-f6ce-4407-9660-d0e5c31dca9b', 'RETURN_SURCHARGE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 240.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:13.802+00', '2026-08-05 11:53:39.1735+00', '2026-08-05 17:00:13.802488+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('768572e3-0b34-48f6-b476-a1cf8bf659f5', 'CONTAINER_EXPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 422.5000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:16.181+00', '2026-08-05 11:48:41.298291+00', '2026-08-05 17:00:16.181439+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('261c3464-1db0-433b-ae02-8ed584d88fa1', 'CONTAINER_IMPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 401.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:21.284+00', '2026-08-05 11:46:59.934116+00', '2026-08-05 17:00:21.285064+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('5ddf51ce-191b-46af-ac4c-f6dbaf6f4bb4', 'CONTAINER_IMPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 784.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:25.882+00', '2026-08-05 11:46:25.676389+00', '2026-08-05 17:00:25.882702+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('4a8c6ff1-0b63-4e9d-9c8b-add7971397c1', 'CONTAINER_EXPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 169.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:28.178+00', '2026-08-05 11:44:55.14852+00', '2026-08-05 17:00:28.179031+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d3ccfc65-5f54-498b-98e7-26e2a2ba6a15', 'CONTAINER_EXPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 362.5000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:32.026+00', '2026-08-05 11:41:00.797236+00', '2026-08-05 17:00:32.026662+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('7d5644e8-a87a-444a-a98a-250a00c6599b', 'CONTAINER_EXPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 338.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:33.27+00', '2026-08-05 11:41:40.439308+00', '2026-08-05 17:00:33.270849+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b06173b7-3fc8-48f4-ac97-0382335d52f7', 'CONTAINER_EXPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 417.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:38.039+00', '2026-08-05 11:40:00.071666+00', '2026-08-05 17:00:38.039567+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b3051840-0f40-4d6d-9324-05eae45ffa6d', 'CONTAINER_EXPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 819.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:40.994+00', '2026-08-05 11:39:31.511351+00', '2026-08-05 17:00:40.994702+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('f4478ee7-8ec6-45ab-bf81-27436f867ee6', 'CONTAINER_EXPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 830.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:18.849+00', '2026-08-05 11:47:31.026479+00', '2026-08-07 16:21:21.936406+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('84a9d3f8-4c10-4721-a2ad-6fe100991a36', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 39.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:53.484+00', '2026-08-05 12:54:02.253281+00', '2026-08-05 16:58:53.484339+00', NULL, 'BULK', 'ALWAYS', '654618d6-a380-4e4c-aa60-2bb1c299066a', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('35b75ebc-5b8d-4854-9b1c-ae371d7f95b8', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 38.1000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:56.217+00', '2026-08-05 12:53:43.309533+00', '2026-08-05 16:58:56.217864+00', NULL, 'BULK', 'ALWAYS', '654618d6-a380-4e4c-aa60-2bb1c299066a', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('576dd27c-e244-4fe5-bef0-baddf1f82574', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 42.6000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:02.034+00', '2026-08-05 12:53:20.494759+00', '2026-08-05 16:59:02.035111+00', NULL, 'BULK', 'ALWAYS', '654618d6-a380-4e4c-aa60-2bb1c299066a', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('4c27adbc-4bec-4d7b-8c27-e8fe84509346', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 40.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:04.355+00', '2026-08-05 12:52:59.542922+00', '2026-08-05 16:59:04.355631+00', NULL, 'BULK', 'ALWAYS', '654618d6-a380-4e4c-aa60-2bb1c299066a', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('2b917ac8-da8e-4312-9acb-672c5bcd5316', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 43.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:08.706+00', '2026-08-05 12:52:03.342591+00', '2026-08-05 16:59:08.706856+00', NULL, 'BULK', 'ALWAYS', 'eb5f5443-5801-48d1-8bb8-7494645c5e10', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('f1eabb0b-14d8-42d0-9af7-5098648cb147', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 43.5000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:11.2+00', '2026-08-05 12:51:42.976818+00', '2026-08-05 16:59:11.200785+00', NULL, 'BULK', 'ALWAYS', 'eb5f5443-5801-48d1-8bb8-7494645c5e10', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('86268882-94e3-4d2c-8842-ffc490fa6d6d', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 47.1600, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:13.61+00', '2026-08-05 12:51:20.559059+00', '2026-08-05 16:59:13.610997+00', NULL, 'BULK', 'ALWAYS', 'eb5f5443-5801-48d1-8bb8-7494645c5e10', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('52b3cb56-164b-4b7b-a8c4-2c0140c81512', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 47.7600, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:16.393+00', '2026-08-05 12:50:44.479822+00', '2026-08-05 16:59:16.393598+00', NULL, 'BULK', 'ALWAYS', 'eb5f5443-5801-48d1-8bb8-7494645c5e10', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('922d4a0d-b4c7-40cf-8c5e-990c0159e273', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 44.7500, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:18.935+00', '2026-08-05 12:50:23.641904+00', '2026-08-05 16:59:18.936162+00', NULL, 'BULK', 'ALWAYS', 'eb5f5443-5801-48d1-8bb8-7494645c5e10', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('f89402f0-c8ba-4eee-91dd-01dd79899a8e', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 42.8500, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:22.178+00', '2026-08-05 12:50:01.203144+00', '2026-08-05 16:59:22.178644+00', NULL, 'BULK', 'ALWAYS', 'eb5f5443-5801-48d1-8bb8-7494645c5e10', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('357d4864-9fb9-4191-ba81-e3473285430d', 'INTERCITY_BULK', NULL, NULL, 'USD', 1166.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:31.608+00', '2026-08-05 12:42:29.812388+00', '2026-08-05 16:59:31.609193+00', NULL, 'INTERCITY', 'ALWAYS', 'a5991d3a-d690-4b7e-98fd-ea3333aa16e7', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('5e2a8bbc-e24b-453d-9e68-536078defdd5', 'INTERCITY_BULK', NULL, NULL, 'USD', 1605.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:33.846+00', '2026-08-05 12:41:30.63642+00', '2026-08-05 16:59:33.847137+00', NULL, 'INTERCITY', 'ALWAYS', '9462ef16-5609-4d5c-8f0d-d0acdb0f8b06', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('4255cc89-9319-4826-a4a0-b4fc771a8b2e', 'INTERCITY_BULK', NULL, NULL, 'USD', 1297.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:36.085+00', '2026-08-05 12:14:06.495107+00', '2026-08-05 16:59:36.085453+00', NULL, 'INTERCITY', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('9557462b-e752-4410-9070-5be72367c8ae', 'BULK_EXPORT', NULL, 'EXPORT', 'USD', 696.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:38.257+00', '2026-08-05 12:12:42.008942+00', '2026-08-05 16:59:38.257483+00', NULL, 'BULK', 'ALWAYS', 'd700fe89-18f4-40ce-860a-7c6b17966929', '23fda607-6cc6-4923-b05b-56b7adb1626b', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', NULL, NULL),
+	('b85c0878-b4ae-4661-9279-31fd0ab68cf9', 'RETURN_SURCHARGE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 91.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:40.557+00', '2026-08-05 12:07:10.387+00', '2026-08-05 16:59:40.558121+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('fd5e8c6b-5569-4918-8673-6b18e09458ae', 'RETURN_SURCHARGE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 176.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:44.191+00', '2026-08-05 12:04:23.98986+00', '2026-08-05 16:59:44.191937+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('9a9d504e-7fc8-4eb2-8a76-e2a3436cf8b5', 'RETURN_SURCHARGE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 240.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:49.006+00', '2026-08-05 12:03:03.414831+00', '2026-08-05 16:59:49.00659+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '1e2fa308-c9eb-4480-840c-e486b1d98029', NULL, NULL),
+	('1d04e928-6d3d-49a1-bdf1-2967670eda49', 'CONTAINER_EXPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 435.5000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:51.279+00', '2026-08-05 12:01:12.797102+00', '2026-08-05 16:59:51.280133+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '1e2fa308-c9eb-4480-840c-e486b1d98029', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('789e418d-6c14-464d-9368-d7dc5e508e89', 'CONTAINER_EXPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 856.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:55.022+00', '2026-08-05 12:00:39.260862+00', '2026-08-05 16:59:55.022426+00', NULL, 'CONTAINER', 'ALWAYS', NULL, '1e2fa308-c9eb-4480-840c-e486b1d98029', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('734d679c-9f1f-4f0c-82f1-25132cfb9171', 'CONTAINER_IMPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 883.5000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:57.237+00', '2026-08-05 11:59:39.568807+00', '2026-08-05 16:59:57.238128+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '1e2fa308-c9eb-4480-840c-e486b1d98029', NULL, NULL),
+	('a57820e6-821a-4e43-9c7a-3f9b7a459979', 'CONTAINER_IMPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 1753.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:59.197+00', '2026-08-05 11:59:13.248122+00', '2026-08-05 16:59:59.197879+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '1e2fa308-c9eb-4480-840c-e486b1d98029', NULL, NULL),
+	('b73f5cbf-a08d-40f5-863f-04a9e99682b5', 'RETURN_SURCHARGE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 207.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:04.96+00', '2026-08-05 11:57:44.833563+00', '2026-08-05 17:00:04.960851+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('454f5e4f-44d6-4da6-8e57-5d42d3777862', 'LASHING', NULL, 'IMPORT', 'USD', 200.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 13:49:23.999+00', '2026-08-05 13:37:19.965186+00', '2026-08-05 13:49:23.99961+00', NULL, 'OTHER', 'LASHING', '8291ccc3-0dd9-4d78-aa44-284d028a19ce', NULL, NULL, NULL, NULL),
+	('99ec256a-2ce0-4a77-8219-73bef28d3551', 'CUSTOMS_CLEARANCE', NULL, 'IMPORT', 'USD', 20.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 13:50:14.997+00', '2026-08-05 13:34:31.710232+00', '2026-08-05 13:50:14.998153+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', '8291ccc3-0dd9-4d78-aa44-284d028a19ce', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('7f9c0ad0-e7ba-4f64-809b-be20be8180c3', 'CUSTOMS_CLEARANCE', NULL, 'IMPORT', 'USD', 2600.0000, 'PER_ITEM', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:36.443+00', '2026-08-05 13:33:22.661381+00', '2026-08-05 16:56:36.44417+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', '28bc4d22-5bc5-4917-b1af-bb08d28f2a05', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('92025b1b-963d-47ad-88cb-d0e6bb661533', 'CUSTOMS_CLEARANCE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 389.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:40.683+00', '2026-08-05 13:32:20.888202+00', '2026-08-05 16:56:40.683295+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('6461a106-3e1b-48c3-82e2-602c6391d280', 'CUSTOMS_CLEARANCE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 569.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:43.405+00', '2026-08-05 13:31:42.112267+00', '2026-08-05 16:56:43.405407+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1f1c4739-5188-442d-9956-36d82b8e11f5', 'CUSTOMS_CLEARANCE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 'USD', 349.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:46.232+00', '2026-08-05 13:31:06.597308+00', '2026-08-05 16:56:46.232493+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('682d921f-8ef3-4f71-a916-0c8d4edfd74f', 'CUSTOMS_CLEARANCE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 540.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:48.57+00', '2026-08-05 13:30:18.375767+00', '2026-08-05 16:56:48.571156+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('816f2328-b28b-4261-a549-c393434bfc7a', 'CUSTOMS_CLEARANCE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 703.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:51.659+00', '2026-08-05 13:28:34.606658+00', '2026-08-05 16:56:51.659575+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('3fe4ca8a-1f37-4a87-ba66-81beb09ed6be', 'CUSTOMS_CLEARANCE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 703.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:56:54.664+00', '2026-08-05 13:28:02.03346+00', '2026-08-05 16:56:54.66473+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('dba57a37-30d3-43a6-b0b8-91c454b1ac42', 'CUSTOMS_CLEARANCE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 1307.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:08.976+00', '2026-08-05 13:27:15.530503+00', '2026-08-05 16:57:08.976789+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('7dc6eec9-dbb9-498a-a058-5f95dd7e0ff7', 'CUSTOMS_CLEARANCE', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 1307.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:12.717+00', '2026-08-05 13:26:22.454508+00', '2026-08-05 16:57:12.717581+00', NULL, 'OTHER', 'CUSTOMS_CLEARANCE', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('51808179-6ade-4142-87d5-e531b9c3d146', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 937.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:16.048+00', '2026-08-05 13:25:14.6463+00', '2026-08-05 16:57:16.048634+00', NULL, 'BULK', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('913c11f8-66f3-4d52-9b48-37ddca7ba8d3', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 2080.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:18.954+00', '2026-08-05 13:24:23.313548+00', '2026-08-05 16:57:18.954521+00', NULL, 'BULK', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('702dd5c8-4d89-4bb3-9f74-2c84982deede', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 2270.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:22.133+00', '2026-08-05 13:23:57.272948+00', '2026-08-05 16:57:22.134045+00', NULL, 'BULK', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('770f6a10-dae7-49c3-8322-28a54206301b', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 1000.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:24.995+00', '2026-08-05 13:23:29.954853+00', '2026-08-05 16:57:24.99571+00', NULL, 'BULK', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('8bdb4ee9-fa4a-4480-a076-2213d5854259', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 2143.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:28.303+00', '2026-08-05 13:22:58.537224+00', '2026-08-05 16:57:28.303946+00', NULL, 'BULK', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('9bfdd103-00fc-4945-a7d6-32d0de2d9b2f', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 2334.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:30.901+00', '2026-08-05 13:21:16.88163+00', '2026-08-05 16:57:30.901714+00', NULL, 'BULK', 'ALWAYS', 'bc9989ca-878c-43a7-ad2b-2a6c7899c956', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('e9932ed0-3f5a-4e74-a2f6-7f3b6eea2f0e', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 3800.0000, 'PER_WAGON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:34.23+00', '2026-08-05 13:20:25.447417+00', '2026-08-05 16:57:34.231171+00', NULL, 'BULK', 'ALWAYS', '28bc4d22-5bc5-4917-b1af-bb08d28f2a05', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('fc8565fc-d3a2-466e-a719-e03a8ae45e90', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 47.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:37.564+00', '2026-08-05 13:19:42.475819+00', '2026-08-05 16:57:37.564313+00', NULL, 'BULK', 'ALWAYS', '9c2bc39e-1fe8-418c-b187-c0b2329faeb9', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('5cfc09cd-2fab-4d6a-babe-bec8dc3cf39b', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 40.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:42.042+00', '2026-08-05 13:19:17.704429+00', '2026-08-05 16:57:42.042846+00', NULL, 'BULK', 'ALWAYS', '9c2bc39e-1fe8-418c-b187-c0b2329faeb9', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('6006c4c3-6ab2-4b90-8ae5-0baac283cef3', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 39.4000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:44.704+00', '2026-08-05 13:18:55.762756+00', '2026-08-05 16:57:44.704515+00', NULL, 'BULK', 'ALWAYS', '9c2bc39e-1fe8-418c-b187-c0b2329faeb9', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('39001ca2-8663-416a-9941-0aef934d86f5', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 47.7600, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:47.729+00', '2026-08-05 13:18:23.16636+00', '2026-08-05 16:57:47.730025+00', NULL, 'BULK', 'ALWAYS', '9c2bc39e-1fe8-418c-b187-c0b2329faeb9', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('36f1a699-425a-41e7-a62a-c6662885d8a1', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 41.3400, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:50.967+00', '2026-08-05 13:17:55.777444+00', '2026-08-05 16:57:50.967246+00', NULL, 'BULK', 'ALWAYS', '9c2bc39e-1fe8-418c-b187-c0b2329faeb9', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('d884c66e-b8a9-45e5-b762-cfce0a8894f8', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 40.5000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:53.363+00', '2026-08-05 13:17:30.99085+00', '2026-08-05 16:57:53.363483+00', NULL, 'BULK', 'ALWAYS', '9c2bc39e-1fe8-418c-b187-c0b2329faeb9', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('2f46d36c-48bf-4838-8f59-1bd7f273cef4', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 50.5300, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:57:55.841+00', '2026-08-05 13:17:03.901612+00', '2026-08-05 16:57:55.841511+00', NULL, 'BULK', 'ALWAYS', '700bbbb8-e31d-4860-8227-47a5496dd81b', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('e6666684-dd5a-4ca0-a514-31690bb206ee', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 45.6000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:03.577+00', '2026-08-05 13:16:01.037466+00', '2026-08-05 16:58:03.577738+00', NULL, 'BULK', 'ALWAYS', '700bbbb8-e31d-4860-8227-47a5496dd81b', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('a101299e-fedd-4355-9773-f981987eadbe', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 51.2000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:06.493+00', '2026-08-05 13:15:30.649947+00', '2026-08-05 16:58:06.493364+00', NULL, 'BULK', 'ALWAYS', '700bbbb8-e31d-4860-8227-47a5496dd81b', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('59a668c7-416d-4059-a99c-99bb439dc4b7', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 48.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:09.308+00', '2026-08-05 13:14:54.814892+00', '2026-08-05 16:58:09.308703+00', NULL, 'BULK', 'ALWAYS', '700bbbb8-e31d-4860-8227-47a5496dd81b', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('54b0e98a-736f-44bb-bb79-accb44f6a9c4', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 46.9000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:13.158+00', '2026-08-05 13:14:32.038173+00', '2026-08-05 16:58:13.158852+00', NULL, 'BULK', 'ALWAYS', '700bbbb8-e31d-4860-8227-47a5496dd81b', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('4abf0f13-f92a-42ce-a38d-1bc746cb6438', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 47.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:15.652+00', '2026-08-05 13:06:27.850211+00', '2026-08-05 16:58:15.652564+00', NULL, 'BULK', 'ALWAYS', 'ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('9de1eb97-6e39-4204-bba3-b506c0a3cd4c', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 40.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:38.433+00', '2026-08-05 13:05:54.341024+00', '2026-08-05 16:58:38.434081+00', NULL, 'BULK', 'ALWAYS', 'ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('363fede1-a1fa-493b-ad72-9b975e24a71c', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 47.7600, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:43.024+00', '2026-08-05 13:04:42.988179+00', '2026-08-05 16:58:43.024866+00', NULL, 'BULK', 'ALWAYS', 'ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('a614d7e7-e55a-4336-ba87-1950bed1a8a7', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 44.1500, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:45.23+00', '2026-08-05 13:03:54.36318+00', '2026-08-05 16:58:45.23051+00', NULL, 'BULK', 'ALWAYS', 'ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('9cac7573-3a74-489a-90d1-e9c703714f03', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 43.8000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:47.996+00', '2026-08-05 12:56:14.000352+00', '2026-08-05 16:58:47.996685+00', NULL, 'BULK', 'ALWAYS', 'ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('1d84d386-9f6b-433f-8968-4a537dd96b75', 'OVERWEIGHT_PER_TON', NULL, NULL, 'USD', 10.0000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 13:49:27.021+00', '2026-08-05 13:35:39.8713+00', '2026-08-05 13:49:27.021974+00', NULL, 'OTHER', 'OVERWEIGHT', NULL, NULL, NULL, NULL, NULL),
+	('d2239b0e-4dee-4071-8d83-b1a7d8fc172a', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 46.6000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:00.143+00', '2026-08-05 13:16:39.42881+00', '2026-08-05 16:58:00.143849+00', NULL, 'BULK', 'ALWAYS', '700bbbb8-e31d-4860-8227-47a5496dd81b', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('f7e206ce-58db-47d8-8a3e-5488390f20f7', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 39.4000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:40.773+00', '2026-08-05 13:05:24.825393+00', '2026-08-05 16:58:40.774168+00', NULL, 'BULK', 'ALWAYS', 'ba24cc4b-f8a0-4e5e-b111-aebaaf96fd00', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('2c5cdce1-e2ca-4c30-b402-0af6c401a7c9', 'CONTAINER_EXPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 'USD', 725.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:35.826+00', '2026-08-05 11:40:33.442602+00', '2026-08-05 17:00:35.827084+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('bd399a79-3de5-40fb-a062-d188242ef283', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 42.1000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:58:50.75+00', '2026-08-05 12:54:23.926705+00', '2026-08-05 16:58:50.750938+00', NULL, 'BULK', 'ALWAYS', '654618d6-a380-4e4c-aa60-2bb1c299066a', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('c39101c7-ff2b-49b7-8452-3da78ace9e98', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 39.2000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:06.624+00', '2026-08-05 12:52:37.542535+00', '2026-08-05 16:59:06.624559+00', NULL, 'BULK', 'ALWAYS', '654618d6-a380-4e4c-aa60-2bb1c299066a', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL, NULL),
+	('91900e5a-992e-4ad8-a3f5-2cd8ea7b32a2', 'BULK_IMPORT', NULL, 'IMPORT', 'USD', 59.4000, 'PER_TON', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:24.671+00', '2026-08-05 12:48:30.532436+00', '2026-08-05 16:59:24.67219+00', NULL, 'BULK', 'ALWAYS', '8291ccc3-0dd9-4d78-aa44-284d028a19ce', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('0b4081aa-f087-4d98-8b7e-b59ea16f6f0d', 'REEFER_SURCHARGE', NULL, NULL, 'USD', 212.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:29.574+00', '2026-08-05 12:44:36.679766+00', '2026-08-05 16:59:29.574271+00', NULL, 'OTHER', 'REEFER', NULL, NULL, NULL, NULL, NULL),
+	('d86db2d8-860a-437b-9a75-b551161ece25', 'RETURN_SURCHARGE', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 127.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 16:59:46.655+00', '2026-08-05 12:03:32.003137+00', '2026-08-05 16:59:46.655292+00', NULL, 'OTHER', 'WITH_RETURN', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '1e2fa308-c9eb-4480-840c-e486b1d98029', NULL, NULL),
+	('39d18fad-7a60-4711-9d51-3ab0ddcf07ad', 'CONTAINER_IMPORT', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 'USD', 390.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:44.045+00', '2026-08-05 11:32:30.271067+00', '2026-08-05 17:00:44.045609+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('38ab107e-2051-4765-b93c-c6abddbf7700', 'CONTAINER_IMPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 762.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:00:46.443+00', '2026-08-05 11:31:56.49775+00', '2026-08-05 17:00:46.443725+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', NULL, NULL),
+	('d6d8e553-7f6e-44c5-9295-624e2945d854', 'CONTAINER_IMPORT', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 'USD', 1676.0000, 'PER_CONTAINER', 'LIVE', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', 'dff56e4a-750d-4e7a-9baa-0ba703b8a0f7', '2026-08-05 17:01:01.073+00', '2026-08-05 11:29:37.575294+00', '2026-08-05 17:01:01.073344+00', NULL, 'CONTAINER', 'ALWAYS', NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL);
+
+
+--
+-- Data for Name: route_milestones; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.route_milestones VALUES
+	('dcb9d9a3-3aef-4282-b0ad-e9fffbf39cb3', '63bfcd70-60bc-4c88-99f2-323549d16249', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 1, '2026-08-06 07:08:20.086899+00', '2026-08-06 07:08:20.086899+00', NULL, 0.00),
+	('6a2e0c88-5a0c-41a3-a99c-218304fc6c47', '63bfcd70-60bc-4c88-99f2-323549d16249', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 2, '2026-08-06 07:08:20.086899+00', '2026-08-06 07:08:20.086899+00', NULL, 880.00),
+	('abe0184a-d019-40bb-97d5-c6cb84b2c866', '22949d74-2f82-46bf-92b0-b0e566a1f0f2', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 1, '2026-08-07 06:52:03.962271+00', '2026-08-07 06:52:03.962271+00', NULL, 0.00),
+	('f6f3c54e-a100-48e4-9c53-60d821708bc8', '22949d74-2f82-46bf-92b0-b0e566a1f0f2', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 2, '2026-08-07 06:52:03.962271+00', '2026-08-07 06:52:03.962271+00', NULL, 55.40),
+	('382e3529-0f8a-48f2-ab8c-8f6e632cb57f', '22949d74-2f82-46bf-92b0-b0e566a1f0f2', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 3, '2026-08-07 06:52:03.962271+00', '2026-08-07 06:52:03.962271+00', NULL, 938.00),
+	('a1ef3b55-48e4-4e8f-bd7b-52546914f932', 'cc8dda89-d384-4220-a7e8-2cb55a145126', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 1, '2026-08-05 11:16:08.780895+00', '2026-08-05 11:16:08.780895+00', NULL, 0.00),
+	('f7691238-9d89-4f70-b24c-5dfef9289bd2', 'cc8dda89-d384-4220-a7e8-2cb55a145126', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 2, '2026-08-05 11:16:08.780895+00', '2026-08-05 11:16:08.780895+00', NULL, 938.00),
+	('e7a91b14-236d-48b8-9864-b93c7d301260', 'cc8dda89-d384-4220-a7e8-2cb55a145126', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 3, '2026-08-05 11:16:08.780895+00', '2026-08-05 11:16:08.780895+00', NULL, 55.40),
+	('e96cd761-b02e-4f66-aa90-91aed9998144', 'f7bb1230-458d-4d97-b0ee-d2721699ce2e', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 1, '2026-08-05 14:06:31.009187+00', '2026-08-05 14:06:31.009187+00', NULL, 0.00),
+	('6d241d83-d510-4cf3-933d-2268137f56b8', 'f7bb1230-458d-4d97-b0ee-d2721699ce2e', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 2, '2026-08-05 14:06:31.009187+00', '2026-08-05 14:06:31.009187+00', NULL, 869.00),
+	('2da377eb-9dad-47e6-ae95-0bd43bd967f7', '52be9a20-02fb-43dc-bc7f-25231726e20c', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 1, '2026-08-05 14:06:57.594416+00', '2026-08-05 14:06:57.594416+00', NULL, 0.00),
+	('67f2aeba-ddeb-459c-93cf-578efe7c036f', '52be9a20-02fb-43dc-bc7f-25231726e20c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 2, '2026-08-05 14:06:57.594416+00', '2026-08-05 14:06:57.594416+00', NULL, 819.00),
+	('dd0788a0-e63f-494c-acab-3687e2287a52', 'fed1f0a3-3dcf-4735-a358-ad2845160f8f', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 1, '2026-08-05 14:07:23.20218+00', '2026-08-05 14:07:23.20218+00', NULL, 0.00),
+	('c11c1530-21d3-4302-8835-3192c42a4710', 'fed1f0a3-3dcf-4735-a358-ad2845160f8f', '23fda607-6cc6-4923-b05b-56b7adb1626b', 2, '2026-08-05 14:07:23.20218+00', '2026-08-05 14:07:23.20218+00', NULL, 746.00),
+	('a741808c-0172-4d52-9465-7b76ac208c16', '23e26088-6c5a-454d-bf4e-d6f277011f52', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 1, '2026-08-05 14:07:36.296418+00', '2026-08-05 14:07:36.296418+00', NULL, 0.00),
+	('e5f38f9a-4f2e-4613-9228-535ddc924c04', '23e26088-6c5a-454d-bf4e-d6f277011f52', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 2, '2026-08-05 14:07:36.296418+00', '2026-08-05 14:07:36.296418+00', NULL, 319.00),
+	('120ec38a-3061-4cc5-ac4d-8d98206abd57', 'f1593e6a-bf3f-450a-be86-f78ceebd2589', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 1, '2026-08-05 14:07:51.131289+00', '2026-08-05 14:07:51.131289+00', NULL, 0.00),
+	('5f805b96-81e0-45f9-9e04-8eddaf67e9e0', 'f1593e6a-bf3f-450a-be86-f78ceebd2589', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 2, '2026-08-05 14:07:51.131289+00', '2026-08-05 14:07:51.131289+00', NULL, 880.00),
+	('3a8f878f-5517-4894-997f-c779de5d857e', 'f21497dc-e3e5-44a9-892e-19a385361298', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 1, '2026-08-05 14:08:09.370413+00', '2026-08-05 14:08:09.370413+00', NULL, 0.00),
+	('3178ea9f-d87a-4ece-8e68-d1747fb3a3d3', 'f21497dc-e3e5-44a9-892e-19a385361298', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 2, '2026-08-05 14:08:09.370413+00', '2026-08-05 14:08:09.370413+00', NULL, 938.00),
+	('1afba0ac-d6ea-40ec-abed-51798404d80a', '181baaef-17df-450e-9d88-62e0edb9d956', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 1, '2026-08-05 14:08:29.867502+00', '2026-08-05 14:08:29.867502+00', NULL, 0.00),
+	('aa98b1d0-80bd-4df2-92ba-228597762bb3', '181baaef-17df-450e-9d88-62e0edb9d956', '23fda607-6cc6-4923-b05b-56b7adb1626b', 2, '2026-08-05 14:08:29.867502+00', '2026-08-05 14:08:29.867502+00', NULL, 858.00),
+	('22919ae4-69e7-4399-8f12-ae011a01f666', 'f780d18f-73e0-4f7d-a039-a3e7d86f7235', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 1, '2026-08-05 14:09:05.906869+00', '2026-08-05 14:09:05.906869+00', NULL, 0.00),
+	('22d4b362-7429-419c-864f-44ff47ea79be', 'f780d18f-73e0-4f7d-a039-a3e7d86f7235', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 2, '2026-08-05 14:09:05.906869+00', '2026-08-05 14:09:05.906869+00', NULL, 334.00),
+	('d5750b0a-f87e-40f5-91f1-5f6b6d418f6b', '6f349546-d2f9-4c3d-84af-ad2c4de95962', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 1, '2026-08-05 14:09:32.74991+00', '2026-08-05 14:09:32.74991+00', NULL, 0.00),
+	('53b7dde9-2e84-4c88-813c-ad612dd44cab', '6f349546-d2f9-4c3d-84af-ad2c4de95962', '1e2fa308-c9eb-4480-840c-e486b1d98029', 2, '2026-08-05 14:09:32.74991+00', '2026-08-05 14:09:32.74991+00', NULL, 918.00),
+	('b28d2711-332d-492b-8f92-435923eb6cea', 'f5c5a87d-8857-45a3-b96b-dc247bf60825', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 1, '2026-08-05 14:09:51.98609+00', '2026-08-05 14:09:51.98609+00', NULL, 0.00),
+	('30321667-a380-4f39-bbe9-b896dcbe5eca', 'f5c5a87d-8857-45a3-b96b-dc247bf60825', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 2, '2026-08-05 14:09:51.98609+00', '2026-08-05 14:09:51.98609+00', NULL, 380.00),
+	('347efb52-fea8-45bd-a62a-045520cae78e', '3bd7be53-1dfe-4722-a4ad-312f9d348149', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 1, '2026-08-05 14:10:47.861587+00', '2026-08-05 14:10:47.861587+00', NULL, 0.00),
+	('4ed08991-e370-4654-93cc-d01203dfd979', '3bd7be53-1dfe-4722-a4ad-312f9d348149', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 2, '2026-08-05 14:10:47.861587+00', '2026-08-05 14:10:47.861587+00', NULL, 55.40),
+	('c6cfedc5-4e39-4871-beb5-a2318ccb14f5', '99adb2d0-a9c6-4843-acc4-5221de84c0b3', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 1, '2026-08-05 18:27:58.540829+00', '2026-08-05 18:27:58.540829+00', NULL, 0.00),
+	('464223fe-41ca-4113-b251-1677303f0940', '99adb2d0-a9c6-4843-acc4-5221de84c0b3', 'fc558b95-da28-4fc3-8348-311a290c34ae', 2, '2026-08-05 18:27:58.540829+00', '2026-08-05 18:27:58.540829+00', NULL, 817.00),
+	('933b6f0c-714b-4ee1-9b2c-2a794163c0e0', 'd5e84d21-9378-4ac0-a51d-a8a792074a29', 'fc558b95-da28-4fc3-8348-311a290c34ae', 1, '2026-08-05 18:31:16.11487+00', '2026-08-05 18:31:16.11487+00', NULL, 0.00),
+	('6f69b0fa-fdd5-4dda-86a4-b09615ec1e44', 'd5e84d21-9378-4ac0-a51d-a8a792074a29', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 2, '2026-08-05 18:31:16.11487+00', '2026-08-05 18:31:16.11487+00', NULL, 867.00),
+	('58b8286a-e27e-43ef-b681-58b7b22fe618', '5c3a27c3-1f0a-475f-ba5d-7ebb47680e80', 'fc558b95-da28-4fc3-8348-311a290c34ae', 1, '2026-08-05 18:31:39.026533+00', '2026-08-05 18:31:39.026533+00', NULL, 0.00),
+	('f5214cf8-ee87-468b-858d-712ce2e15467', '5c3a27c3-1f0a-475f-ba5d-7ebb47680e80', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 2, '2026-08-05 18:31:39.026533+00', '2026-08-05 18:31:39.026533+00', NULL, 817.00),
+	('2d121dcc-aa84-4c9f-8d75-8b4fcec10b8b', 'dc53225a-4dad-493d-a056-1e73a7942f46', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 1, '2026-08-05 18:33:27.682507+00', '2026-08-05 18:33:27.682507+00', NULL, 0.00),
+	('9efe4e8a-5db1-4afc-b10d-dbc4cb1f4e35', 'dc53225a-4dad-493d-a056-1e73a7942f46', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 2, '2026-08-05 18:33:27.682507+00', '2026-08-05 18:33:27.682507+00', NULL, 375.00),
+	('51efa9a9-6e1d-459e-b5e8-9b1236e3ea5e', 'f2af32aa-ad89-4b94-b91a-32eca30355ea', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 1, '2026-08-05 18:34:04.004295+00', '2026-08-05 18:34:04.004295+00', NULL, 0.00),
+	('2bc5768d-d9c2-460e-827c-edcb55a4de83', 'f2af32aa-ad89-4b94-b91a-32eca30355ea', 'fc558b95-da28-4fc3-8348-311a290c34ae', 2, '2026-08-05 18:34:04.004295+00', '2026-08-05 18:34:04.004295+00', NULL, 867.00),
+	('45db2e4c-330e-4f68-8d75-61a36fa84df5', '24450a51-c0e4-42fa-94ba-f3fec5c86ffe', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 1, '2026-08-05 18:45:52.116137+00', '2026-08-05 18:45:52.116137+00', NULL, 0.00),
+	('8a45df4e-57f4-4185-a13a-12c2c4e4a5bf', '24450a51-c0e4-42fa-94ba-f3fec5c86ffe', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 2, '2026-08-05 18:45:52.116137+00', '2026-08-05 18:45:52.116137+00', NULL, 938.00),
+	('915470f6-125a-4c0c-b554-22624eb86fa5', 'c870cbd4-a73d-47f8-8ff7-350d08e9f8fb', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 1, '2026-08-05 18:47:05.753193+00', '2026-08-05 18:47:05.753193+00', NULL, 0.00),
+	('d4a1a560-fca2-47aa-8f33-e6226ec6dd73', 'c870cbd4-a73d-47f8-8ff7-350d08e9f8fb', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 2, '2026-08-05 18:47:05.753193+00', '2026-08-05 18:47:05.753193+00', NULL, 869.00),
+	('3073c5c8-d8a6-48d5-87e7-c2c5dc7c0b05', 'cfae237c-37e7-4fe0-b3f7-97b156b4db15', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 1, '2026-08-05 18:51:10.910676+00', '2026-08-05 18:51:10.910676+00', NULL, 0.00),
+	('154dfb65-1c94-4d96-b9d1-7e9c54f683bd', 'cfae237c-37e7-4fe0-b3f7-97b156b4db15', '23fda607-6cc6-4923-b05b-56b7adb1626b', 2, '2026-08-05 18:51:10.910676+00', '2026-08-05 18:51:10.910676+00', NULL, 76.00),
+	('4704437b-c00f-4647-ad17-0193e8b286a4', '8978e3c6-0c68-4756-909a-5ac73596ecc8', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 1, '2026-08-07 20:53:47.427657+00', '2026-08-07 20:53:47.427657+00', NULL, 0.00),
+	('8e7f4a55-4dbb-45ab-bd21-4ee2049ac4b7', '8978e3c6-0c68-4756-909a-5ac73596ecc8', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 2, '2026-08-07 20:53:47.427657+00', '2026-08-07 20:53:47.427657+00', NULL, 380.00),
+	('a91018ba-e857-4693-8ea7-1edcbdcb247d', '8978e3c6-0c68-4756-909a-5ac73596ecc8', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 3, '2026-08-07 20:53:47.427657+00', '2026-08-07 20:53:47.427657+00', NULL, 334.00);
+
+
+--
+-- Data for Name: routes; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.routes VALUES
+	('cc8dda89-d384-4220-a7e8-2cb55a145126', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2026-08-05 11:16:08.780895+00', '2026-08-05 11:16:08.780895+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('f7bb1230-458d-4d97-b0ee-d2721699ce2e', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2026-08-05 14:06:31.009187+00', '2026-08-05 14:06:31.009187+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('52be9a20-02fb-43dc-bc7f-25231726e20c', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '2026-08-05 14:06:57.594416+00', '2026-08-05 14:06:57.594416+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('fed1f0a3-3dcf-4735-a358-ad2845160f8f', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', '2026-08-05 14:07:23.20218+00', '2026-08-05 14:07:23.20218+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('23e26088-6c5a-454d-bf4e-d6f277011f52', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '2026-08-05 14:07:36.296418+00', '2026-08-05 14:07:36.296418+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('f1593e6a-bf3f-450a-be86-f78ceebd2589', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2026-08-05 14:07:51.131289+00', '2026-08-05 14:07:51.131289+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('f21497dc-e3e5-44a9-892e-19a385361298', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '2026-08-05 14:08:09.370413+00', '2026-08-05 14:08:09.370413+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('181baaef-17df-450e-9d88-62e0edb9d956', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', '2026-08-05 14:08:29.867502+00', '2026-08-05 14:08:29.867502+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('f780d18f-73e0-4f7d-a039-a3e7d86f7235', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '2026-08-05 14:09:05.906869+00', '2026-08-05 14:09:05.906869+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('6f349546-d2f9-4c3d-84af-ad2c4de95962', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '1e2fa308-c9eb-4480-840c-e486b1d98029', '2026-08-05 14:09:32.74991+00', '2026-08-05 14:09:32.74991+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('f5c5a87d-8857-45a3-b96b-dc247bf60825', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2026-08-05 14:09:51.98609+00', '2026-08-05 14:09:51.98609+00', NULL, 'AVAILABLE', 'DOMESTIC'),
+	('3bd7be53-1dfe-4722-a4ad-312f9d348149', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2026-08-05 14:10:47.861587+00', '2026-08-05 14:10:47.861587+00', NULL, 'AVAILABLE', 'DOMESTIC'),
+	('99adb2d0-a9c6-4843-acc4-5221de84c0b3', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'fc558b95-da28-4fc3-8348-311a290c34ae', '2026-08-05 18:27:58.540829+00', '2026-08-05 18:27:58.540829+00', NULL, 'AVAILABLE', 'EXPORT'),
+	('d5e84d21-9378-4ac0-a51d-a8a792074a29', 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2026-08-05 18:31:16.11487+00', '2026-08-05 18:31:16.11487+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('5c3a27c3-1f0a-475f-ba5d-7ebb47680e80', 'fc558b95-da28-4fc3-8348-311a290c34ae', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '2026-08-05 18:31:39.026533+00', '2026-08-05 18:31:39.026533+00', NULL, 'AVAILABLE', 'IMPORT'),
+	('dc53225a-4dad-493d-a056-1e73a7942f46', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '2026-08-05 18:33:27.682507+00', '2026-08-05 18:33:27.682507+00', NULL, 'AVAILABLE', 'DOMESTIC'),
+	('f2af32aa-ad89-4b94-b91a-32eca30355ea', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'fc558b95-da28-4fc3-8348-311a290c34ae', '2026-08-05 18:34:04.004295+00', '2026-08-05 18:34:04.004295+00', NULL, 'AVAILABLE', 'EXPORT'),
+	('24450a51-c0e4-42fa-94ba-f3fec5c86ffe', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '2026-08-04 11:17:57.378645+00', '2026-08-05 18:45:52.116137+00', NULL, 'AVAILABLE', 'EXPORT'),
+	('c870cbd4-a73d-47f8-8ff7-350d08e9f8fb', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '2026-08-01 07:41:17.411558+00', '2026-08-05 18:47:05.753193+00', NULL, 'AVAILABLE', 'EXPORT'),
+	('cfae237c-37e7-4fe0-b3f7-97b156b4db15', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '23fda607-6cc6-4923-b05b-56b7adb1626b', '2026-07-22 06:42:53.719+00', '2026-08-05 18:51:10.910676+00', NULL, 'AVAILABLE', 'DOMESTIC'),
+	('63bfcd70-60bc-4c88-99f2-323549d16249', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '2026-08-06 07:08:20.086899+00', '2026-08-06 07:08:20.086899+00', NULL, 'AVAILABLE', 'EXPORT'),
+	('22949d74-2f82-46bf-92b0-b0e566a1f0f2', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '2026-08-04 11:20:00.592454+00', '2026-08-07 06:52:03.962271+00', NULL, 'AVAILABLE', 'EXPORT'),
+	('8978e3c6-0c68-4756-909a-5ac73596ecc8', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '2026-08-02 11:56:34.070422+00', '2026-08-07 20:53:47.427657+00', NULL, 'AVAILABLE', 'EXPORT');
+
+
+--
+-- Data for Name: saved_signatures; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: schedule_wagon_adjustment_logs; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: scheduling_events; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: service_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.service_types VALUES
+	('c652e3a9-73a5-404e-882f-55a64c5b195b', 'Rail Transport Only', NULL, true, false, false, false, true, 1, '2026-07-27 11:31:59.400905+00', '2026-07-27 11:31:59.400905+00', NULL, 'RAIL'),
+	('f60a0787-98d9-4ab1-9ad7-8f9bf8afdcac', 'Rail Transport with Customs', NULL, true, true, true, true, true, 1, '2026-07-17 08:23:05.206+00', '2026-08-04 09:23:32.063154+00', NULL, 'TRAIN_TRANSPORT_WITH_CUSTOMS'),
+	('76ec1857-294d-4eef-95ab-84b0eff3261c', 'Rail Container with Paid First/Last Mile', 'Demo service type for paid import/export bookings with a single mile leg', true, true, true, false, true, 11, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, 'RAIL_CONTAINER_PAID_MILE');
+
+
+--
+-- Data for Name: shipping_lines; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.shipping_lines VALUES
+	('3e0821c1-293b-4107-81f0-0fe364768168', 'PIL', 'PIL (Pacific International Lines)', NULL, false, true, '2026-08-04 11:16:01.544746+00', '2026-08-04 11:16:01.544746+00', NULL),
+	('56b36e3d-214b-4903-9a06-2f908ef24172', 'MSC', 'MSC (Mediterranean Shipping Company)', NULL, false, true, '2026-08-04 11:17:21.096097+00', '2026-08-04 11:17:21.096097+00', NULL),
+	('8fab083d-71bb-42b3-902d-56e248461cb4', 'CMA CGM', 'CMA CGM', NULL, false, true, '2026-08-04 11:17:50.562108+00', '2026-08-04 11:17:50.562108+00', NULL),
+	('2c157bca-2865-4d94-b615-86fcbe6b77a1', 'MAERSK', 'Maersk', NULL, false, true, '2026-08-04 11:18:26.243578+00', '2026-08-04 11:18:26.243578+00', NULL),
+	('e66f5330-de00-4a3d-b717-5cba53fba974', 'EVERGREEN', 'Evergreen', NULL, false, true, '2026-08-04 11:19:59.784698+00', '2026-08-04 11:19:59.784698+00', NULL);
+
+
+--
+-- Data for Name: support_conversations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: support_document_versions; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.support_document_versions VALUES
+	('1d978c47-db4c-480c-9645-e2b7eb59ddf7', 'aef07887-6a67-43e4-a267-3e457a049573', 1, '{"email": "support@edrfreight.com", "hours": "Monday – Saturday, 8:30 AM – 5:30 PM (EAT)", "phone": "+251 11 000 0000", "office": "Addis Ababa, Ethiopia"}', NULL, 'Initial content', '2026-08-09 18:50:22.738193+00', '2026-08-09 18:50:22.738193+00', NULL),
+	('c5c697c1-627a-4b3d-af68-a13425bf44cd', '9dc7987f-2d92-47f0-805f-1755ef904a3f', 1, '{"title": "Help & Support", "sections": [{"id": "help-walkthrough", "body": "A guided tour of the portal — registering your company, raising a booking against a contract, and settling an invoice.\n\n![](/assets/edr-portal-guide.webm)", "heading": "Portal walkthrough"}, {"id": "help-chat", "body": "Signed-in customers can open a support conversation from the headset button at the bottom right of every portal page. You can send screenshots and documents in the chat, and replies appear there and as a notification.\n\n[Open the portal](/portal)", "heading": "Chat with our team"}, {"id": "help-contact", "body": "- **Email** — [{{supportEmail}}](mailto:{{supportEmail}}). Best for document issues and anything needing an attachment.\n- **Phone** — [{{supportPhone}}](tel:{{supportPhoneTel}}). Best for urgent problems with cargo already in transit.\n- **Head office** — {{supportOffice}}. Walk-in support during working hours.\n- **Support hours** — {{supportHours}}. Outside these hours, email us and we reply the next working day.", "heading": "Contact us"}, {"id": "help-topics", "body": "- **[Account & onboarding](/faq)** — registering your company, uploading your trade licence and TIN, and getting an operational profile approved.\n- **[Contracts](/faq)** — requesting a freight contract, reviewing its terms and signing it with your saved signature and stamp.\n- **[Bookings & tracking](/faq)** — raising a booking against a contract, adding last-mile transport and following the consignment along the corridor.\n- **[Invoices & payments](/faq)** — finding invoices, paying through the bank channels and confirming a payment that has not yet settled.", "heading": "Common topics"}, {"id": "help-checklist", "body": "- Your company name and the email you sign in with.\n- The reference of the contract, booking or invoice involved.\n- What you expected to happen and what happened instead.\n- A screenshot of any error message the portal showed.", "heading": "What to include when you contact us"}], "subtitle": "Get answers fast — watch the walkthrough, browse the common topics, check the FAQ, or reach our team directly."}', NULL, 'Initial content', '2026-08-09 18:50:22.743044+00', '2026-08-09 18:50:22.743044+00', NULL),
+	('23b95137-0c23-443b-9731-ad7a058c46b8', '6cec5868-f597-49b3-a2c0-be0c3d46b802', 1, '{"title": "Frequently Asked Questions", "footer": {"body": "Our team is on {{supportEmail}} and {{supportPhone}}, or you can start a chat from the support button inside the portal.", "ctaTo": "/help", "heading": "Still need a hand?", "ctaLabel": "Go to Help & Support"}, "groups": [{"id": "faq-getting-started", "items": [{"id": "faq-open-account", "answer": "Sign up with your work email and verify the one-time code we send you. After you set a password, the onboarding wizard collects your company details, trade licence, TIN certificate and the operational services you need (importer, exporter, freight forwarder or transporter). Submit the wizard and our team reviews the application.", "question": "How do I open an account on EDR Freight?"}, {"id": "faq-approval-time", "answer": "Most complete applications are reviewed within two working days. You will see the status on your dashboard, and we email you when a profile is approved or when a document needs to be re-uploaded.", "question": "How long does account approval take?"}, {"id": "faq-rejected", "answer": "The rejection notice states the reason. Open Settings, correct the details or replace the document that was flagged, and re-apply — you do not need to create a new account.", "question": "My profile was rejected. What now?"}, {"id": "faq-multiple-services", "answer": "Yes. A company can hold importer, exporter, freight forwarder and transporter profiles at the same time. Each is approved separately, and the header lets you switch between the ones you hold.", "question": "Can one company hold several operational services?"}], "title": "Getting started"}, {"id": "faq-contracts-bookings", "items": [{"id": "faq-contract-vs-booking", "answer": "A contract is the commercial agreement covering a cargo movement — route, commodity, volume and rates. A booking is a single shipment executed under that contract. You create the contract once, then raise bookings against it for each consignment.", "question": "What is the difference between a contract and a booking?"}, {"id": "faq-create-booking", "answer": "Open the contract from the Contracts list and choose New Booking. Provide the consignment details, containers or tonnage, and the last-mile requirement if you need one. Bookings can also be started from the Bookings page, which routes you through contract selection first.", "question": "How do I create a booking?"}, {"id": "faq-sign-contract", "answer": "The contract document is the binding agreement for the movement. You must scroll to the end, accept the terms, and sign it with your saved signature and stamp before EDR schedules any wagon against it.", "question": "Why do I have to sign a contract before shipping?"}, {"id": "faq-signature-setup", "answer": "Under Signature & Stamp in the portal. It is saved once and reused for every contract you sign, so you do not have to upload it per document.", "question": "Where do I set up my signature and stamp?"}, {"id": "faq-change-booking", "answer": "You can edit a booking while it is still pending review. Once EDR has confirmed it and allocated capacity, changes go through our operations team — contact support with the booking reference.", "question": "Can I change a booking after submitting it?"}, {"id": "faq-track-consignment", "answer": "Open the booking and use the tracking panel, which shows the current milestone, the wagon or container assigned, and the timestamps recorded at each corridor point.", "question": "How do I track a consignment?"}], "title": "Contracts and bookings"}, {"id": "faq-invoices-payments", "items": [{"id": "faq-find-invoices", "answer": "The Invoices page lists every invoice raised against your company, with its status, due date and outstanding balance. Open any invoice to see its line items and download a PDF copy.", "question": "Where do I find my invoices?"}, {"id": "faq-payment-methods", "answer": "Payments are made through the integrated bank channels shown at checkout. After you complete the payment on the bank''s page you are returned to the portal, and the invoice status updates once the bank confirms the transaction.", "question": "Which payment methods are supported?"}, {"id": "faq-payment-not-settled", "answer": "Bank confirmations can lag by a few minutes. Use the Check Payment Status page linked from your receipt; if it still has not settled after an hour, email support with the invoice number and the bank reference and we will reconcile it.", "question": "My payment was deducted but the invoice still shows unpaid."}, {"id": "faq-rounding", "answer": "Some bank channels only accept whole-birr amounts, so invoices routed through them are rounded up to the nearest birr. The rounding is shown on the invoice detail page.", "question": "Why is my invoice amount rounded?"}], "title": "Invoices and payments"}, {"id": "faq-account-security", "items": [{"id": "faq-reset-password", "answer": "Use Forgot Password on the sign-in page. We email you a reset link that is valid for a limited time. If a member of our staff issued the link, it works the same way even if you are already signed in.", "question": "How do I reset my password?"}, {"id": "faq-add-colleagues", "answer": "Yes. Company administrators can invite additional users from Settings. Each user signs in with their own credentials, and actions are recorded against the individual who performed them.", "question": "Can I add colleagues to my company account?"}, {"id": "faq-update-company", "answer": "Edit them in Settings. Changes to regulated fields — trade licence, TIN, legal name — are re-verified by our team before they take effect.", "question": "How do I update company details after approval?"}], "title": "Account and security"}], "subtitle": "Answers to the questions customers ask most about registering, booking cargo and settling invoices on EDR Freight."}', NULL, 'Initial content', '2026-08-09 18:50:22.747104+00', '2026-08-09 18:50:22.747104+00', NULL),
+	('dfb3f456-7646-45f4-98fb-a0a97421c915', '9b4518c5-94b0-42c9-a275-e20156f584f4', 1, '{"title": "Privacy Policy", "sections": [{"id": "privacy-1", "body": "The Ethio-Djibouti Standard Gauge Rail Share Company (\"EDR\", \"we\", \"us\") operates the EDR Freight platform, which lets customers register their business, agree freight contracts, raise bookings, track consignments and settle invoices online.\n\nThis policy explains what personal and business information we collect through the platform, why we collect it, how long we keep it and what rights you have over it. It applies to the EDR Freight customer portal and the services reached through it.", "heading": "1. Introduction"}, {"id": "privacy-2", "body": "We collect information you give us, information generated by your use of the platform, and information we receive from the regulators and financial institutions we work with.\n\n- Account details — name, work email address, phone number and the credentials used to sign in.\n- Company and compliance records — legal name, trade licence, TIN certificate, VAT registration, ownership and manager details, and the operational services you apply for.\n- Identity verification data — where you verify through a national identity service, the verification result and the attributes that service returns to us.\n- Operational data — contracts, bookings, consignment and cargo details, container and wagon assignments, tracking events and delivery confirmations.\n- Financial data — invoices, payment references, transaction status and settlement confirmations received from banks. We do not store your card numbers or online banking credentials.\n- Support data — the messages and files you send us through the in-app support chat or by email.\n- Technical data — IP address, device and browser information, and event logs generated when you use the platform.", "heading": "2. Information we collect"}, {"id": "privacy-3", "body": "- To create and administer your account and verify that your company is entitled to the services it applies for.\n- To perform the freight contracts and bookings you place, including allocating capacity and coordinating rail and last-mile movements.\n- To issue invoices, process payments and keep the accounting records the law requires us to keep.\n- To provide customer support and respond to the questions and complaints you raise.\n- To keep the platform secure, detect misuse and investigate incidents.\n- To meet our legal, tax, customs and regulatory obligations in Ethiopia and Djibouti.\n- To improve the platform — measuring which features are used and where users encounter errors, using aggregated and pseudonymised data wherever that is sufficient.", "heading": "3. How we use your information"}, {"id": "privacy-4", "body": "We process your information because it is necessary to perform the contract between you and EDR, because we have a legal obligation to do so (customs, tax and transport regulation), or because we have a legitimate interest in operating and securing the platform. Where we rely on your consent — for example, optional marketing messages — you can withdraw it at any time.", "heading": "4. Legal basis for processing"}, {"id": "privacy-5", "body": "We do not sell your information. We share it only where it is necessary to deliver the service or where the law requires it.\n\n- Government and regulatory bodies — customs, revenue and transport authorities in Ethiopia and Djibouti, to the extent required for the movement of your cargo.\n- Ports, terminals and last-mile transporters involved in executing your bookings.\n- Banks and payment providers, to initiate and reconcile the payments you make.\n- Technology suppliers who host and maintain the platform on our behalf, under contracts that restrict them to processing data on our instructions.\n- Courts, law enforcement and other authorities where we are legally compelled to disclose.", "heading": "5. Sharing your information"}, {"id": "privacy-6", "body": "Cross-border freight inherently involves parties in more than one country, so consignment and clearance information is shared with counterparties and authorities in Djibouti as well as Ethiopia. Where we transfer information outside Ethiopia, we do so only as far as the movement requires or the law permits, and we require recipients to protect it to a comparable standard.", "heading": "6. International transfers"}, {"id": "privacy-7", "body": "We keep account and company records for as long as your account is active. Contract, booking, customs and financial records are kept for the period required by Ethiopian commercial, tax and customs law after the relevant transaction, because we are obliged to be able to produce them. Support conversations and technical logs are kept for a shorter period, sufficient to resolve disputes and investigate security incidents.", "heading": "7. Data retention"}, {"id": "privacy-8", "body": "Access to the platform requires authentication, and staff access to customer records is limited to what each role needs. Data is transmitted over encrypted connections and stored on systems protected by access controls and logging. No system is perfectly secure, so please keep your credentials confidential and tell us immediately if you believe your account has been compromised.", "heading": "8. Security"}, {"id": "privacy-9", "body": "Subject to Ethiopian law, you may ask us to give you a copy of the personal information we hold about you, correct it if it is inaccurate, restrict or object to certain processing, or delete it where we are not required to keep it. Requests are handled through the contact details below; we may need to verify your identity before acting.", "heading": "9. Your rights"}, {"id": "privacy-10", "body": "The platform uses cookies and browser storage to keep you signed in, remember your interface preferences and measure how the product is used so we can fix problems. Essential cookies cannot be turned off without breaking sign-in. You can clear or block the rest through your browser settings.", "heading": "10. Cookies and similar technologies"}, {"id": "privacy-11", "body": "The platform is a business service and is not directed at children. We do not knowingly collect information from anyone under 18.", "heading": "11. Children"}, {"id": "privacy-12", "body": "We may update this policy as the platform and the law change. Material changes are announced in the portal before they take effect, and the date at the top of this page always reflects the current version.", "heading": "12. Changes to this policy"}, {"id": "privacy-13", "body": "Questions about this policy or about how we handle your information can be sent to {{supportEmail}}, called in on {{supportPhone}}, or addressed to our head office in {{supportOffice}}.", "heading": "13. Contact us"}], "subtitle": "How EDR Freight collects, uses, shares and protects the information you provide when you use the platform.", "lastUpdated": "6 August 2026"}', NULL, 'Initial content', '2026-08-09 18:50:22.750948+00', '2026-08-09 18:50:22.750948+00', NULL),
+	('051f61a2-0c6f-4ae6-8f67-8d36ffb50df2', 'e6aaa986-cceb-4d99-a3e1-06f596b8474f', 1, '{"title": "Terms of Service", "sections": [{"id": "terms-1", "body": "These terms govern your use of the EDR Freight platform operated by the Ethio-Djibouti Standard Gauge Rail Share Company (\"EDR\"). By creating an account or using the platform, the company you represent agrees to them.\n\nThe platform is the channel through which you register, request and manage freight services. The commercial terms of each movement — routes, rates, volumes and payment terms — are set out in the freight contract you sign in the platform. Where a signed contract and these terms conflict, the signed contract governs that movement.", "heading": "1. These terms"}, {"id": "terms-2", "body": "- The platform is for registered businesses. You confirm that you are authorised to act for the company you register and to bind it to these terms.\n- The information and documents you submit — trade licence, TIN, VAT registration, ownership details — must be accurate, current and genuine.\n- Accounts and operational profiles are activated only after EDR has reviewed and approved them, and approval may be refused or withdrawn.\n- You are responsible for keeping credentials confidential and for everything done under your account. Tell us at once if you suspect unauthorised use.", "heading": "2. Eligibility and accounts"}, {"id": "terms-3", "body": "- A freight contract takes effect when it is signed in the platform by you and countersigned by EDR.\n- A booking is a request for a specific movement under a contract. It becomes binding when EDR confirms it and allocates capacity — submission alone does not reserve a wagon or container.\n- You are responsible for the accuracy of consignment data: commodity description, weight, dimensions, container numbers, hazardous classification and consignee details.\n- Capacity is finite. EDR may decline, defer or reschedule a booking where capacity, safety, operating conditions or regulatory direction require it.", "heading": "3. Contracts and bookings"}, {"id": "terms-4", "body": "- You must obtain and provide every permit, customs declaration and clearance document the movement requires, and you warrant that the cargo may lawfully be carried.\n- Prohibited and restricted goods may not be tendered without EDR''s prior written agreement and any licence the law requires.\n- Cargo must be packed, secured and, where applicable, labelled to the standard the mode of carriage requires. EDR may inspect, refuse or offload cargo that is misdeclared or unsafe.\n- You are liable for fines, demurrage, storage charges and losses arising from misdeclared cargo, missing documents or delays attributable to you.", "heading": "4. Cargo, documents and compliance"}, {"id": "terms-5", "body": "- Charges are calculated from the rates in your contract, the tariffs published in the platform, and any accessorial services actually rendered.\n- Invoices are issued in the platform and are payable by the due date shown on them, through the payment channels the platform offers.\n- Payment is confirmed when the funds are confirmed by the bank, not when payment is initiated.\n- Overdue amounts may attract interest and may result in suspension of new bookings or of the account until the balance is cleared.\n- Taxes and statutory duties are your responsibility unless the contract expressly says otherwise.", "heading": "5. Rates, invoicing and payment"}, {"id": "terms-6", "body": "Transit times shown in the platform are estimates based on planned schedules. They are not guarantees, and EDR is not liable for indirect or consequential loss, loss of profit or loss of market arising from delay.\n\nEDR''s liability for loss of or damage to cargo is limited to the extent set out in the applicable freight contract and in the transport law governing the carriage. Claims must be notified in writing within the period the contract specifies; late claims may be rejected.\n\nNeither party is liable for failure to perform caused by events beyond its reasonable control, including natural disasters, industrial action, civil unrest, infrastructure failure, or acts of government and regulatory authorities.", "heading": "6. Delivery, delay and liability"}, {"id": "terms-7", "body": "- Use the platform only for its intended purpose and in accordance with applicable law.\n- Do not attempt to gain unauthorised access, probe or disrupt the service, or interfere with other customers'' data.\n- Do not scrape, resell or redistribute platform content, rates or data without written permission.\n- Do not upload malware or content that infringes the rights of others.", "heading": "7. Acceptable use of the platform"}, {"id": "terms-8", "body": "You agree that contracts signed in the platform using your stored signature and stamp are validly executed, that the records the platform keeps of those signatures are admissible evidence of them, and that they carry the same effect as signatures on paper.", "heading": "8. Electronic signatures and records"}, {"id": "terms-9", "body": "We aim to keep the platform available, but it may be interrupted for maintenance, upgrades or reasons outside our control. We may add, change or withdraw features. Where a change materially affects how you use the platform, we will give reasonable notice in the portal.", "heading": "9. Availability and changes to the service"}, {"id": "terms-10", "body": "We may suspend or terminate access where these terms are breached, where documents prove to be false, where amounts remain unpaid, or where the law or a regulator requires it. You may stop using the platform at any time. Termination does not affect obligations already incurred — cargo in transit, invoices outstanding, or records we are required to retain.", "heading": "10. Suspension and termination"}, {"id": "terms-11", "body": "The platform, its software, design and content belong to EDR or its licensors. You are granted a non-exclusive, non-transferable right to use it for your own freight operations. Your commercial and consignment data remains yours; you grant us the right to process it as needed to deliver the service and as described in the Privacy Policy.", "heading": "11. Intellectual property"}, {"id": "terms-12", "body": "Each party will keep the other''s non-public commercial information confidential and use it only for the purposes of the services. Our handling of personal information is described in the Privacy Policy, which forms part of these terms.", "heading": "12. Confidentiality and data protection"}, {"id": "terms-13", "body": "These terms are governed by the laws of the Federal Democratic Republic of Ethiopia. The parties will first attempt to resolve any dispute amicably; failing that, the dispute is subject to the jurisdiction of the competent courts of Ethiopia, without prejudice to any arbitration clause agreed in a specific freight contract.", "heading": "13. Governing law and disputes"}, {"id": "terms-14", "body": "We may update these terms as the service and the law change. Updates are published here and announced in the portal. Continuing to use the platform after an update takes effect means you accept the revised terms.", "heading": "14. Changes to these terms"}, {"id": "terms-15", "body": "For questions about these terms, write to {{supportEmail}} or call {{supportPhone}}.", "heading": "15. Contact"}], "subtitle": "The terms on which EDR provides the EDR Freight platform and the freight services you request through it.", "lastUpdated": "6 August 2026"}', NULL, 'Initial content', '2026-08-09 18:50:22.755212+00', '2026-08-09 18:50:22.755212+00', NULL);
+
+
+--
+-- Data for Name: support_documents; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.support_documents VALUES
+	('aef07887-6a67-43e4-a267-3e457a049573', 'CONTACT', '{"email": "support@edrfreight.com", "hours": "Monday – Saturday, 8:30 AM – 5:30 PM (EAT)", "phone": "+251 11 000 0000", "office": "Addis Ababa, Ethiopia"}', 1, NULL, '2026-08-09 18:50:22.734138+00', '2026-08-09 18:50:22.734138+00', NULL),
+	('9dc7987f-2d92-47f0-805f-1755ef904a3f', 'HELP', '{"title": "Help & Support", "sections": [{"id": "help-walkthrough", "body": "A guided tour of the portal — registering your company, raising a booking against a contract, and settling an invoice.\n\n![](/assets/edr-portal-guide.webm)", "heading": "Portal walkthrough"}, {"id": "help-chat", "body": "Signed-in customers can open a support conversation from the headset button at the bottom right of every portal page. You can send screenshots and documents in the chat, and replies appear there and as a notification.\n\n[Open the portal](/portal)", "heading": "Chat with our team"}, {"id": "help-contact", "body": "- **Email** — [{{supportEmail}}](mailto:{{supportEmail}}). Best for document issues and anything needing an attachment.\n- **Phone** — [{{supportPhone}}](tel:{{supportPhoneTel}}). Best for urgent problems with cargo already in transit.\n- **Head office** — {{supportOffice}}. Walk-in support during working hours.\n- **Support hours** — {{supportHours}}. Outside these hours, email us and we reply the next working day.", "heading": "Contact us"}, {"id": "help-topics", "body": "- **[Account & onboarding](/faq)** — registering your company, uploading your trade licence and TIN, and getting an operational profile approved.\n- **[Contracts](/faq)** — requesting a freight contract, reviewing its terms and signing it with your saved signature and stamp.\n- **[Bookings & tracking](/faq)** — raising a booking against a contract, adding last-mile transport and following the consignment along the corridor.\n- **[Invoices & payments](/faq)** — finding invoices, paying through the bank channels and confirming a payment that has not yet settled.", "heading": "Common topics"}, {"id": "help-checklist", "body": "- Your company name and the email you sign in with.\n- The reference of the contract, booking or invoice involved.\n- What you expected to happen and what happened instead.\n- A screenshot of any error message the portal showed.", "heading": "What to include when you contact us"}], "subtitle": "Get answers fast — watch the walkthrough, browse the common topics, check the FAQ, or reach our team directly."}', 1, NULL, '2026-08-09 18:50:22.740709+00', '2026-08-09 18:50:22.740709+00', NULL),
+	('6cec5868-f597-49b3-a2c0-be0c3d46b802', 'FAQ', '{"title": "Frequently Asked Questions", "footer": {"body": "Our team is on {{supportEmail}} and {{supportPhone}}, or you can start a chat from the support button inside the portal.", "ctaTo": "/help", "heading": "Still need a hand?", "ctaLabel": "Go to Help & Support"}, "groups": [{"id": "faq-getting-started", "items": [{"id": "faq-open-account", "answer": "Sign up with your work email and verify the one-time code we send you. After you set a password, the onboarding wizard collects your company details, trade licence, TIN certificate and the operational services you need (importer, exporter, freight forwarder or transporter). Submit the wizard and our team reviews the application.", "question": "How do I open an account on EDR Freight?"}, {"id": "faq-approval-time", "answer": "Most complete applications are reviewed within two working days. You will see the status on your dashboard, and we email you when a profile is approved or when a document needs to be re-uploaded.", "question": "How long does account approval take?"}, {"id": "faq-rejected", "answer": "The rejection notice states the reason. Open Settings, correct the details or replace the document that was flagged, and re-apply — you do not need to create a new account.", "question": "My profile was rejected. What now?"}, {"id": "faq-multiple-services", "answer": "Yes. A company can hold importer, exporter, freight forwarder and transporter profiles at the same time. Each is approved separately, and the header lets you switch between the ones you hold.", "question": "Can one company hold several operational services?"}], "title": "Getting started"}, {"id": "faq-contracts-bookings", "items": [{"id": "faq-contract-vs-booking", "answer": "A contract is the commercial agreement covering a cargo movement — route, commodity, volume and rates. A booking is a single shipment executed under that contract. You create the contract once, then raise bookings against it for each consignment.", "question": "What is the difference between a contract and a booking?"}, {"id": "faq-create-booking", "answer": "Open the contract from the Contracts list and choose New Booking. Provide the consignment details, containers or tonnage, and the last-mile requirement if you need one. Bookings can also be started from the Bookings page, which routes you through contract selection first.", "question": "How do I create a booking?"}, {"id": "faq-sign-contract", "answer": "The contract document is the binding agreement for the movement. You must scroll to the end, accept the terms, and sign it with your saved signature and stamp before EDR schedules any wagon against it.", "question": "Why do I have to sign a contract before shipping?"}, {"id": "faq-signature-setup", "answer": "Under Signature & Stamp in the portal. It is saved once and reused for every contract you sign, so you do not have to upload it per document.", "question": "Where do I set up my signature and stamp?"}, {"id": "faq-change-booking", "answer": "You can edit a booking while it is still pending review. Once EDR has confirmed it and allocated capacity, changes go through our operations team — contact support with the booking reference.", "question": "Can I change a booking after submitting it?"}, {"id": "faq-track-consignment", "answer": "Open the booking and use the tracking panel, which shows the current milestone, the wagon or container assigned, and the timestamps recorded at each corridor point.", "question": "How do I track a consignment?"}], "title": "Contracts and bookings"}, {"id": "faq-invoices-payments", "items": [{"id": "faq-find-invoices", "answer": "The Invoices page lists every invoice raised against your company, with its status, due date and outstanding balance. Open any invoice to see its line items and download a PDF copy.", "question": "Where do I find my invoices?"}, {"id": "faq-payment-methods", "answer": "Payments are made through the integrated bank channels shown at checkout. After you complete the payment on the bank''s page you are returned to the portal, and the invoice status updates once the bank confirms the transaction.", "question": "Which payment methods are supported?"}, {"id": "faq-payment-not-settled", "answer": "Bank confirmations can lag by a few minutes. Use the Check Payment Status page linked from your receipt; if it still has not settled after an hour, email support with the invoice number and the bank reference and we will reconcile it.", "question": "My payment was deducted but the invoice still shows unpaid."}, {"id": "faq-rounding", "answer": "Some bank channels only accept whole-birr amounts, so invoices routed through them are rounded up to the nearest birr. The rounding is shown on the invoice detail page.", "question": "Why is my invoice amount rounded?"}], "title": "Invoices and payments"}, {"id": "faq-account-security", "items": [{"id": "faq-reset-password", "answer": "Use Forgot Password on the sign-in page. We email you a reset link that is valid for a limited time. If a member of our staff issued the link, it works the same way even if you are already signed in.", "question": "How do I reset my password?"}, {"id": "faq-add-colleagues", "answer": "Yes. Company administrators can invite additional users from Settings. Each user signs in with their own credentials, and actions are recorded against the individual who performed them.", "question": "Can I add colleagues to my company account?"}, {"id": "faq-update-company", "answer": "Edit them in Settings. Changes to regulated fields — trade licence, TIN, legal name — are re-verified by our team before they take effect.", "question": "How do I update company details after approval?"}], "title": "Account and security"}], "subtitle": "Answers to the questions customers ask most about registering, booking cargo and settling invoices on EDR Freight."}', 1, NULL, '2026-08-09 18:50:22.744919+00', '2026-08-09 18:50:22.744919+00', NULL),
+	('9b4518c5-94b0-42c9-a275-e20156f584f4', 'PRIVACY', '{"title": "Privacy Policy", "sections": [{"id": "privacy-1", "body": "The Ethio-Djibouti Standard Gauge Rail Share Company (\"EDR\", \"we\", \"us\") operates the EDR Freight platform, which lets customers register their business, agree freight contracts, raise bookings, track consignments and settle invoices online.\n\nThis policy explains what personal and business information we collect through the platform, why we collect it, how long we keep it and what rights you have over it. It applies to the EDR Freight customer portal and the services reached through it.", "heading": "1. Introduction"}, {"id": "privacy-2", "body": "We collect information you give us, information generated by your use of the platform, and information we receive from the regulators and financial institutions we work with.\n\n- Account details — name, work email address, phone number and the credentials used to sign in.\n- Company and compliance records — legal name, trade licence, TIN certificate, VAT registration, ownership and manager details, and the operational services you apply for.\n- Identity verification data — where you verify through a national identity service, the verification result and the attributes that service returns to us.\n- Operational data — contracts, bookings, consignment and cargo details, container and wagon assignments, tracking events and delivery confirmations.\n- Financial data — invoices, payment references, transaction status and settlement confirmations received from banks. We do not store your card numbers or online banking credentials.\n- Support data — the messages and files you send us through the in-app support chat or by email.\n- Technical data — IP address, device and browser information, and event logs generated when you use the platform.", "heading": "2. Information we collect"}, {"id": "privacy-3", "body": "- To create and administer your account and verify that your company is entitled to the services it applies for.\n- To perform the freight contracts and bookings you place, including allocating capacity and coordinating rail and last-mile movements.\n- To issue invoices, process payments and keep the accounting records the law requires us to keep.\n- To provide customer support and respond to the questions and complaints you raise.\n- To keep the platform secure, detect misuse and investigate incidents.\n- To meet our legal, tax, customs and regulatory obligations in Ethiopia and Djibouti.\n- To improve the platform — measuring which features are used and where users encounter errors, using aggregated and pseudonymised data wherever that is sufficient.", "heading": "3. How we use your information"}, {"id": "privacy-4", "body": "We process your information because it is necessary to perform the contract between you and EDR, because we have a legal obligation to do so (customs, tax and transport regulation), or because we have a legitimate interest in operating and securing the platform. Where we rely on your consent — for example, optional marketing messages — you can withdraw it at any time.", "heading": "4. Legal basis for processing"}, {"id": "privacy-5", "body": "We do not sell your information. We share it only where it is necessary to deliver the service or where the law requires it.\n\n- Government and regulatory bodies — customs, revenue and transport authorities in Ethiopia and Djibouti, to the extent required for the movement of your cargo.\n- Ports, terminals and last-mile transporters involved in executing your bookings.\n- Banks and payment providers, to initiate and reconcile the payments you make.\n- Technology suppliers who host and maintain the platform on our behalf, under contracts that restrict them to processing data on our instructions.\n- Courts, law enforcement and other authorities where we are legally compelled to disclose.", "heading": "5. Sharing your information"}, {"id": "privacy-6", "body": "Cross-border freight inherently involves parties in more than one country, so consignment and clearance information is shared with counterparties and authorities in Djibouti as well as Ethiopia. Where we transfer information outside Ethiopia, we do so only as far as the movement requires or the law permits, and we require recipients to protect it to a comparable standard.", "heading": "6. International transfers"}, {"id": "privacy-7", "body": "We keep account and company records for as long as your account is active. Contract, booking, customs and financial records are kept for the period required by Ethiopian commercial, tax and customs law after the relevant transaction, because we are obliged to be able to produce them. Support conversations and technical logs are kept for a shorter period, sufficient to resolve disputes and investigate security incidents.", "heading": "7. Data retention"}, {"id": "privacy-8", "body": "Access to the platform requires authentication, and staff access to customer records is limited to what each role needs. Data is transmitted over encrypted connections and stored on systems protected by access controls and logging. No system is perfectly secure, so please keep your credentials confidential and tell us immediately if you believe your account has been compromised.", "heading": "8. Security"}, {"id": "privacy-9", "body": "Subject to Ethiopian law, you may ask us to give you a copy of the personal information we hold about you, correct it if it is inaccurate, restrict or object to certain processing, or delete it where we are not required to keep it. Requests are handled through the contact details below; we may need to verify your identity before acting.", "heading": "9. Your rights"}, {"id": "privacy-10", "body": "The platform uses cookies and browser storage to keep you signed in, remember your interface preferences and measure how the product is used so we can fix problems. Essential cookies cannot be turned off without breaking sign-in. You can clear or block the rest through your browser settings.", "heading": "10. Cookies and similar technologies"}, {"id": "privacy-11", "body": "The platform is a business service and is not directed at children. We do not knowingly collect information from anyone under 18.", "heading": "11. Children"}, {"id": "privacy-12", "body": "We may update this policy as the platform and the law change. Material changes are announced in the portal before they take effect, and the date at the top of this page always reflects the current version.", "heading": "12. Changes to this policy"}, {"id": "privacy-13", "body": "Questions about this policy or about how we handle your information can be sent to {{supportEmail}}, called in on {{supportPhone}}, or addressed to our head office in {{supportOffice}}.", "heading": "13. Contact us"}], "subtitle": "How EDR Freight collects, uses, shares and protects the information you provide when you use the platform.", "lastUpdated": "6 August 2026"}', 1, NULL, '2026-08-09 18:50:22.749059+00', '2026-08-09 18:50:22.749059+00', NULL),
+	('e6aaa986-cceb-4d99-a3e1-06f596b8474f', 'TERMS', '{"title": "Terms of Service", "sections": [{"id": "terms-1", "body": "These terms govern your use of the EDR Freight platform operated by the Ethio-Djibouti Standard Gauge Rail Share Company (\"EDR\"). By creating an account or using the platform, the company you represent agrees to them.\n\nThe platform is the channel through which you register, request and manage freight services. The commercial terms of each movement — routes, rates, volumes and payment terms — are set out in the freight contract you sign in the platform. Where a signed contract and these terms conflict, the signed contract governs that movement.", "heading": "1. These terms"}, {"id": "terms-2", "body": "- The platform is for registered businesses. You confirm that you are authorised to act for the company you register and to bind it to these terms.\n- The information and documents you submit — trade licence, TIN, VAT registration, ownership details — must be accurate, current and genuine.\n- Accounts and operational profiles are activated only after EDR has reviewed and approved them, and approval may be refused or withdrawn.\n- You are responsible for keeping credentials confidential and for everything done under your account. Tell us at once if you suspect unauthorised use.", "heading": "2. Eligibility and accounts"}, {"id": "terms-3", "body": "- A freight contract takes effect when it is signed in the platform by you and countersigned by EDR.\n- A booking is a request for a specific movement under a contract. It becomes binding when EDR confirms it and allocates capacity — submission alone does not reserve a wagon or container.\n- You are responsible for the accuracy of consignment data: commodity description, weight, dimensions, container numbers, hazardous classification and consignee details.\n- Capacity is finite. EDR may decline, defer or reschedule a booking where capacity, safety, operating conditions or regulatory direction require it.", "heading": "3. Contracts and bookings"}, {"id": "terms-4", "body": "- You must obtain and provide every permit, customs declaration and clearance document the movement requires, and you warrant that the cargo may lawfully be carried.\n- Prohibited and restricted goods may not be tendered without EDR''s prior written agreement and any licence the law requires.\n- Cargo must be packed, secured and, where applicable, labelled to the standard the mode of carriage requires. EDR may inspect, refuse or offload cargo that is misdeclared or unsafe.\n- You are liable for fines, demurrage, storage charges and losses arising from misdeclared cargo, missing documents or delays attributable to you.", "heading": "4. Cargo, documents and compliance"}, {"id": "terms-5", "body": "- Charges are calculated from the rates in your contract, the tariffs published in the platform, and any accessorial services actually rendered.\n- Invoices are issued in the platform and are payable by the due date shown on them, through the payment channels the platform offers.\n- Payment is confirmed when the funds are confirmed by the bank, not when payment is initiated.\n- Overdue amounts may attract interest and may result in suspension of new bookings or of the account until the balance is cleared.\n- Taxes and statutory duties are your responsibility unless the contract expressly says otherwise.", "heading": "5. Rates, invoicing and payment"}, {"id": "terms-6", "body": "Transit times shown in the platform are estimates based on planned schedules. They are not guarantees, and EDR is not liable for indirect or consequential loss, loss of profit or loss of market arising from delay.\n\nEDR''s liability for loss of or damage to cargo is limited to the extent set out in the applicable freight contract and in the transport law governing the carriage. Claims must be notified in writing within the period the contract specifies; late claims may be rejected.\n\nNeither party is liable for failure to perform caused by events beyond its reasonable control, including natural disasters, industrial action, civil unrest, infrastructure failure, or acts of government and regulatory authorities.", "heading": "6. Delivery, delay and liability"}, {"id": "terms-7", "body": "- Use the platform only for its intended purpose and in accordance with applicable law.\n- Do not attempt to gain unauthorised access, probe or disrupt the service, or interfere with other customers'' data.\n- Do not scrape, resell or redistribute platform content, rates or data without written permission.\n- Do not upload malware or content that infringes the rights of others.", "heading": "7. Acceptable use of the platform"}, {"id": "terms-8", "body": "You agree that contracts signed in the platform using your stored signature and stamp are validly executed, that the records the platform keeps of those signatures are admissible evidence of them, and that they carry the same effect as signatures on paper.", "heading": "8. Electronic signatures and records"}, {"id": "terms-9", "body": "We aim to keep the platform available, but it may be interrupted for maintenance, upgrades or reasons outside our control. We may add, change or withdraw features. Where a change materially affects how you use the platform, we will give reasonable notice in the portal.", "heading": "9. Availability and changes to the service"}, {"id": "terms-10", "body": "We may suspend or terminate access where these terms are breached, where documents prove to be false, where amounts remain unpaid, or where the law or a regulator requires it. You may stop using the platform at any time. Termination does not affect obligations already incurred — cargo in transit, invoices outstanding, or records we are required to retain.", "heading": "10. Suspension and termination"}, {"id": "terms-11", "body": "The platform, its software, design and content belong to EDR or its licensors. You are granted a non-exclusive, non-transferable right to use it for your own freight operations. Your commercial and consignment data remains yours; you grant us the right to process it as needed to deliver the service and as described in the Privacy Policy.", "heading": "11. Intellectual property"}, {"id": "terms-12", "body": "Each party will keep the other''s non-public commercial information confidential and use it only for the purposes of the services. Our handling of personal information is described in the Privacy Policy, which forms part of these terms.", "heading": "12. Confidentiality and data protection"}, {"id": "terms-13", "body": "These terms are governed by the laws of the Federal Democratic Republic of Ethiopia. The parties will first attempt to resolve any dispute amicably; failing that, the dispute is subject to the jurisdiction of the competent courts of Ethiopia, without prejudice to any arbitration clause agreed in a specific freight contract.", "heading": "13. Governing law and disputes"}, {"id": "terms-14", "body": "We may update these terms as the service and the law change. Updates are published here and announced in the portal. Continuing to use the platform after an update takes effect means you accept the revised terms.", "heading": "14. Changes to these terms"}, {"id": "terms-15", "body": "For questions about these terms, write to {{supportEmail}} or call {{supportPhone}}.", "heading": "15. Contact"}], "subtitle": "The terms on which EDR provides the EDR Freight platform and the freight services you request through it.", "lastUpdated": "6 August 2026"}', 1, NULL, '2026-08-09 18:50:22.753243+00', '2026-08-09 18:50:22.753243+00', NULL);
+
+
+--
+-- Data for Name: support_messages; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: tracking_events; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: train_checkpoint_events; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: train_composition_removal_logs; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: train_locomotives; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_locomotives VALUES
+	('787b33ae-8a78-4057-abc6-1e1eedf799a4', '76671a28-3517-4f04-a903-32162959d615', 'd6907984-bcfb-4408-b823-0fecc284f393', 0, '2026-08-06 06:53:26.770184+00', '2026-08-06 06:53:26.770184+00', NULL),
+	('24a720d2-1d07-40ce-90ca-6ba4f68b8593', '76671a28-3517-4f04-a903-32162959d615', 'fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 1, '2026-08-06 06:53:26.770184+00', '2026-08-06 06:53:26.770184+00', NULL),
+	('15e6a66d-fb51-43ce-8ca4-4a835a854bb5', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 'b67b7043-d216-4392-8313-7b43452e612d', 0, '2026-08-07 07:18:16.026107+00', '2026-08-07 07:18:16.026107+00', NULL),
+	('351b4fd8-4e69-4d3c-b1a4-0b944a87c5eb', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 'a8142510-249a-491e-903f-1d05abb129f7', 1, '2026-08-07 07:18:16.026107+00', '2026-08-07 07:18:16.026107+00', NULL),
+	('68af1b56-e0f3-46ad-bd0b-8f0023bd17a2', '0da257e0-c825-4104-822b-82f27aa2c710', '87662a07-2c7b-45c5-a4ff-c89fb9bc105c', 0, '2026-08-07 07:57:18.217074+00', '2026-08-07 07:57:18.217074+00', NULL),
+	('dcfbbbc7-7e6e-44ee-a146-186a549ab97d', '0da257e0-c825-4104-822b-82f27aa2c710', 'c07ddf04-36c6-468f-a2c6-7fd2732d8782', 1, '2026-08-07 07:57:18.217074+00', '2026-08-07 07:57:18.217074+00', NULL),
+	('a6a410b0-5265-4c97-84b9-5b8597811179', '6de97a77-dbf1-4099-92ea-295416ab0d97', '1e13bf8d-d01e-4438-993d-db77ce5203eb', 0, '2026-08-07 08:41:48.883013+00', '2026-08-07 08:41:48.883013+00', NULL),
+	('8739ba65-a50e-4167-9c29-8f48f54676a3', '6de97a77-dbf1-4099-92ea-295416ab0d97', '884ec005-4ea4-4c9c-86db-7e1617faeeba', 1, '2026-08-07 08:41:48.883013+00', '2026-08-07 08:41:48.883013+00', NULL),
+	('1b35bd25-9e69-4a80-b7e7-fa6fe270127b', '7217d519-4204-43ca-aef1-3e86f3ec240b', '5eeb26b1-0631-4870-ab4f-352ac49cf8d1', 0, '2026-08-07 10:45:57.982977+00', '2026-08-07 10:45:57.982977+00', NULL),
+	('eda94226-015c-4057-bb0d-d2dfa97a1908', '7217d519-4204-43ca-aef1-3e86f3ec240b', 'a2fc8e45-ec84-4771-ae60-25d20fda25b1', 1, '2026-08-07 10:45:57.982977+00', '2026-08-07 10:45:57.982977+00', NULL),
+	('bc8d1ed3-d0b9-4968-9ece-2fa720a77d24', '1064cee0-359d-4fa6-9157-975be624f378', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-08-07 11:20:58.845314+00', '2026-08-07 11:20:58.845314+00', NULL),
+	('90a98589-98a2-4cc6-9ab3-3a2f48d3e47d', '1064cee0-359d-4fa6-9157-975be624f378', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-08-07 11:20:58.845314+00', '2026-08-07 11:20:58.845314+00', NULL),
+	('3cd63931-27f3-4fc0-8874-263f9182cbc3', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-07 12:33:42.219594+00', '2026-08-07 12:33:42.219594+00', NULL),
+	('41957df6-5ea5-48cc-bcca-5f4af7616f0d', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-07 12:33:42.219594+00', '2026-08-07 12:33:42.219594+00', NULL),
+	('807c25ae-a6ec-4f39-9d09-215d972536b5', '2012fe72-e966-404d-a5c4-f43ac0e5a767', '22ccb1d9-adfd-4a04-bc37-a6d4bb2ee9b7', 0, '2026-08-07 13:01:06.938962+00', '2026-08-07 13:01:06.938962+00', NULL),
+	('e375299d-b6dc-495d-a466-f1b2ba7e104e', '2012fe72-e966-404d-a5c4-f43ac0e5a767', '0b48c5d6-0360-49b1-b4c9-433eb1cd1a87', 1, '2026-08-07 13:01:06.938962+00', '2026-08-07 13:01:06.938962+00', NULL),
+	('d26ec9dd-c510-47ff-aec5-55d83913bb71', '91c02bb9-0f91-46ee-9272-9eecf28734d9', '2dd03327-d9d5-4a08-af02-e59916ccea97', 0, '2026-08-07 13:38:21.83353+00', '2026-08-07 13:38:21.83353+00', NULL),
+	('3bc4fabc-e1a5-4b8f-bcf8-b25eb03822ac', '91c02bb9-0f91-46ee-9272-9eecf28734d9', '1620633d-c8ce-4130-9fb7-80edf1d86641', 1, '2026-08-07 13:38:21.83353+00', '2026-08-07 13:38:21.83353+00', NULL),
+	('8fd86c5d-f271-4cc5-b6d4-c3d16efdf0f2', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 0, '2026-08-07 13:59:31.242735+00', '2026-08-07 13:59:31.242735+00', NULL),
+	('b7a36307-8631-495d-8b63-1cafdc639ca4', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', '38874f67-9563-438d-b1bb-ed61c6aedc84', 1, '2026-08-07 13:59:31.242735+00', '2026-08-07 13:59:31.242735+00', NULL);
+
+
+--
+-- Data for Name: train_schedule_bookings; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_schedule_bookings VALUES
+	('94f5b7c7-5d50-45ab-ac16-78802df4cad8', '114535c3-880b-46b3-b6fc-7953a5d0de5b', '346725c9-6075-4283-a59d-c0cfb58d2e52', '2026-08-09 20:18:31.414872+00', '2026-08-09 20:18:31.414872+00', NULL, 'LOADED');
+
+
+--
+-- Data for Name: train_schedules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_schedules VALUES
+	('114535c3-880b-46b3-b6fc-7953a5d0de5b', '45cd3f95-b00c-42a8-812a-2c945271c44c', '7d1b9c9c-372a-41ea-8125-363163fc6351', '91c3912b-036a-4a09-b9f7-f70d0da0b717', '2026-08-09 20:18:18.791138+00', NULL, 'DISPATCHED', '2026-08-09 20:18:18.791138+00', '2026-08-09 20:18:18.791138+00', NULL, NULL, 'LMR-TEST-01', 'IMPORT', NULL, NULL, NULL, NULL, 53, 'OPEN', NULL, NULL, NULL, NULL, NULL, NULL, 0, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, false, NULL, false);
+
+
+--
+-- Data for Name: train_scheduling_global_rules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_scheduling_global_rules VALUES
+	('e141950e-bdc7-4c2e-9069-d0a0b77379b0', 760.00, 3500.000, 53, 30.000, 10.000, '2026-07-27 11:32:00.19775+00', '2026-08-04 12:11:01.847296+00', NULL, 5, 24, 8, 0.0333, 1, 7200, 17, 120, 120, 7200);
+
+
+--
+-- Data for Name: train_set_locomotives; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_set_locomotives VALUES
+	('0d77437a-d010-41d2-aeff-d1f508891ab1', 'e877c44e-9292-453d-bb28-616075071bb3', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 0, '2026-07-23 07:51:41.716+00', '2026-07-23 07:51:41.716+00', NULL),
+	('957eef9a-fe23-4940-b576-fcc9043c2af7', 'e877c44e-9292-453d-bb28-616075071bb3', '38874f67-9563-438d-b1bb-ed61c6aedc84', 1, '2026-07-23 07:51:41.716+00', '2026-07-23 07:51:41.716+00', NULL),
+	('74f57812-9b0a-4be8-8e25-14837f2d3e08', '6d83b300-aa08-42bf-bcee-f0f1df37cde5', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 0, '2026-07-23 12:20:25.037+00', '2026-07-23 12:20:25.037+00', NULL),
+	('ebd7c1dc-8e8c-4029-9781-b4d45281426b', '6d83b300-aa08-42bf-bcee-f0f1df37cde5', '38874f67-9563-438d-b1bb-ed61c6aedc84', 1, '2026-07-23 12:20:25.037+00', '2026-07-23 12:20:25.037+00', NULL),
+	('803b3f85-177a-4922-a01d-360f945726a7', 'f3e40915-ff4c-4db3-9a45-ca4b2b56fce5', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-07-23 14:51:39.728+00', '2026-07-23 14:51:39.728+00', NULL),
+	('e26e0518-e6b0-41a3-8455-acb987a950a2', 'f3e40915-ff4c-4db3-9a45-ca4b2b56fce5', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-07-23 14:51:39.728+00', '2026-07-23 14:51:39.728+00', NULL),
+	('0994a3a7-b4f8-4e5c-b2b7-df998f3c3ec5', '8476735c-01cc-44b7-9c43-d59370f26f69', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-07-17 21:34:19.872+00', '2026-07-17 21:34:19.872+00', NULL),
+	('4ff3a2ca-612f-463d-940b-046f8c63bdbb', '8476735c-01cc-44b7-9c43-d59370f26f69', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-07-17 21:34:19.872+00', '2026-07-17 21:34:19.872+00', NULL),
+	('466526e9-547b-4f92-b994-c41a76b3dbec', '892ed0d9-60d8-4508-a33c-6e053cf7ddc2', 'b34a62e0-a4a9-4563-83d6-9e2206b74b10', 0, '2026-07-18 06:22:56.277+00', '2026-07-18 06:22:56.277+00', NULL),
+	('36ec494c-d4b2-45d9-98c3-57ba29ca5829', '892ed0d9-60d8-4508-a33c-6e053cf7ddc2', 'dddc30d3-b60a-4344-bddd-71c9ad91ddec', 1, '2026-07-18 06:22:56.277+00', '2026-07-18 06:22:56.277+00', NULL),
+	('5b8a6dff-1019-4e45-940a-c432d222dcd1', '21799060-5741-4416-81b8-0dda9e325e80', '2dd03327-d9d5-4a08-af02-e59916ccea97', 0, '2026-07-18 06:52:10.897+00', '2026-07-18 06:52:10.897+00', NULL),
+	('e4398bd8-ced8-46ac-ae54-dd280c27e3c6', '21799060-5741-4416-81b8-0dda9e325e80', '1620633d-c8ce-4130-9fb7-80edf1d86641', 1, '2026-07-18 06:52:10.897+00', '2026-07-18 06:52:10.897+00', NULL),
+	('4a055734-4d23-48ac-b814-93d6b7689ac7', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-07-18 17:16:00.198+00', '2026-07-18 17:16:00.198+00', NULL),
+	('63ac422c-93ba-412c-bbc4-44300efdcb32', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-07-18 17:16:00.198+00', '2026-07-18 17:16:00.198+00', NULL),
+	('01578201-72a0-4764-9b39-ea118a46e10d', 'b8827cf5-99d5-4ecf-8939-1e7ad7e660d0', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-07-19 18:49:42.372+00', '2026-07-19 18:49:42.372+00', NULL),
+	('d57b62f4-f4e8-4e1f-b466-13d1a9ee3e34', 'b8827cf5-99d5-4ecf-8939-1e7ad7e660d0', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-07-19 18:49:42.372+00', '2026-07-19 18:49:42.372+00', NULL),
+	('c6c4c706-cfaa-4c1d-b228-9f8054ec7ba1', '83a0229a-8975-4b9b-a97f-7b3004215aef', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-07-20 06:58:42.624+00', '2026-07-20 06:58:42.624+00', NULL),
+	('9b1d08ca-b51e-426d-a2f8-60a2ef6fdf04', '83a0229a-8975-4b9b-a97f-7b3004215aef', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-07-20 06:58:42.624+00', '2026-07-20 06:58:42.624+00', NULL),
+	('e9aaa39c-0f0a-4393-a60a-e692593d9031', 'd7604bf1-29ee-40f3-b054-b48f35b5f16f', '2dd03327-d9d5-4a08-af02-e59916ccea97', 0, '2026-07-20 11:11:12.51+00', '2026-07-20 11:11:12.51+00', NULL),
+	('293690d1-a525-47ed-a290-22ff768bcb19', 'd7604bf1-29ee-40f3-b054-b48f35b5f16f', '1620633d-c8ce-4130-9fb7-80edf1d86641', 1, '2026-07-20 11:11:12.51+00', '2026-07-20 11:11:12.51+00', NULL),
+	('5db80f65-3740-407c-9574-f3b0e9bee59f', 'fa0d99de-c596-44e0-a137-551cef7399b5', '0b48c5d6-0360-49b1-b4c9-433eb1cd1a87', 0, '2026-07-20 11:37:38.394+00', '2026-07-20 11:37:38.394+00', NULL),
+	('8cc68fe6-9558-4454-9a9a-1a5c17b91d66', 'fa0d99de-c596-44e0-a137-551cef7399b5', '22ccb1d9-adfd-4a04-bc37-a6d4bb2ee9b7', 1, '2026-07-20 11:37:38.394+00', '2026-07-20 11:37:38.394+00', NULL),
+	('9c920647-e7d2-46be-8fb4-fb8ba1723954', 'f9fdfe34-cad5-45c0-9d19-91bc0c89ebce', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-07-20 12:56:46.918+00', '2026-07-20 12:56:46.918+00', NULL),
+	('4210c90f-3d6c-46a1-8d00-ef474b414629', 'f9fdfe34-cad5-45c0-9d19-91bc0c89ebce', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-07-20 12:56:46.918+00', '2026-07-20 12:56:46.918+00', NULL),
+	('53efe324-9186-45c8-9318-7de8c60d44de', '065de839-5edb-4a08-ae6e-d1142579fd99', '5eeb26b1-0631-4870-ab4f-352ac49cf8d1', 0, '2026-07-21 05:57:50.914+00', '2026-07-21 05:57:50.914+00', NULL),
+	('65efbe29-20c5-4875-9d2f-3a1e389e2d24', '065de839-5edb-4a08-ae6e-d1142579fd99', '87662a07-2c7b-45c5-a4ff-c89fb9bc105c', 1, '2026-07-21 05:57:50.914+00', '2026-07-21 05:57:50.914+00', NULL),
+	('e572e71b-6c6d-4d57-9065-0eb0dd4e9b93', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 0, '2026-07-21 08:44:06.202+00', '2026-07-21 08:44:06.202+00', NULL),
+	('3dcd4d58-ba9b-4e96-b05f-2d2844fd9281', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '38874f67-9563-438d-b1bb-ed61c6aedc84', 1, '2026-07-21 08:44:06.202+00', '2026-07-21 08:44:06.202+00', NULL),
+	('b7e7b2c8-78c0-4022-be8f-689a59f76dec', '86f76fa6-bfc6-4c03-801c-c37e645c3010', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-07-21 13:25:30.605+00', '2026-07-21 13:25:30.605+00', NULL),
+	('fdd742af-98cc-4726-a4f5-d577126676a2', '86f76fa6-bfc6-4c03-801c-c37e645c3010', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-07-21 13:25:30.605+00', '2026-07-21 13:25:30.605+00', NULL),
+	('f777ea8b-55b1-423d-aa80-79d9da3492cb', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 0, '2026-07-22 06:29:45.056+00', '2026-07-22 06:29:45.056+00', NULL),
+	('6cbb62b3-b7c5-48ef-9eb8-5ae2ab443199', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '38874f67-9563-438d-b1bb-ed61c6aedc84', 1, '2026-07-22 06:29:45.056+00', '2026-07-22 06:29:45.056+00', NULL),
+	('6fa6f54d-512e-4ffe-9851-019648c30573', '3b753131-834f-4763-892e-a8f4a8ca837c', 'dc23c9a3-5004-4145-807e-6240b415595e', 0, '2026-07-22 07:50:00.012+00', '2026-07-22 07:50:00.012+00', NULL),
+	('cc562ae3-85de-4d88-ad48-16c607d9a4f3', '3b753131-834f-4763-892e-a8f4a8ca837c', 'c691c3cc-cfa8-4fb8-b980-ec7e53d213af', 1, '2026-07-22 07:50:00.012+00', '2026-07-22 07:50:00.012+00', NULL),
+	('e821b29e-2036-4b78-8e86-967c9ca55af4', 'dfb01a05-181d-4105-87be-d3e7d14bf31c', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0, '2026-07-22 11:01:10.338+00', '2026-07-22 11:01:10.338+00', NULL),
+	('5b5ec1e1-7bf9-4b54-949e-ac3a7123a742', 'dfb01a05-181d-4105-87be-d3e7d14bf31c', '48a8700a-8c1f-449d-b731-bcb11fc94995', 1, '2026-07-22 11:01:10.338+00', '2026-07-22 11:01:10.338+00', NULL),
+	('3dd4e15e-8748-4098-afd2-5b5d0535b0e6', '88857e3d-8002-43c2-ba69-6ef2f96f6de7', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-07-22 11:09:57.907+00', '2026-07-22 11:09:57.907+00', NULL),
+	('89c5a832-6e85-42bc-a1c9-75146bf11a68', '88857e3d-8002-43c2-ba69-6ef2f96f6de7', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-07-22 11:09:57.907+00', '2026-07-22 11:09:57.907+00', NULL),
+	('dc70701e-28a4-4e38-9ebb-b93164298a91', 'd226d18d-1a48-427b-8e51-236178d65a49', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-07-22 13:22:17.957+00', '2026-07-22 13:22:17.957+00', NULL),
+	('2bfc0999-0d50-4e7c-a13c-cff803531827', 'd226d18d-1a48-427b-8e51-236178d65a49', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-07-22 13:22:17.957+00', '2026-07-22 13:22:17.957+00', NULL),
+	('38520303-1551-4e57-a6c0-705430482cfa', '379c7434-f412-4a79-ae2d-e4740c63b49a', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 0, '2026-07-23 07:53:11.819+00', '2026-07-23 07:53:11.819+00', NULL),
+	('461add8c-aa5f-45b2-940f-cfab6adab7bd', '379c7434-f412-4a79-ae2d-e4740c63b49a', '38874f67-9563-438d-b1bb-ed61c6aedc84', 1, '2026-07-23 07:53:11.819+00', '2026-07-23 07:53:11.819+00', NULL),
+	('aaead3b5-1cef-4b67-8723-534a59dfe006', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '2dd03327-d9d5-4a08-af02-e59916ccea97', 0, '2026-08-01 07:46:34.634417+00', '2026-08-01 07:46:34.634417+00', NULL),
+	('81a9c6c9-49fc-4c97-8abd-205f8933d8d6', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '1620633d-c8ce-4130-9fb7-80edf1d86641', 1, '2026-08-01 07:46:34.634417+00', '2026-08-01 07:46:34.634417+00', NULL),
+	('5c750cec-08ce-44f7-ab9e-c09b63d75a41', '0c11098b-3d44-44f6-b90a-574e9fabfb40', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-01 08:12:08.843992+00', '2026-08-01 08:12:08.843992+00', NULL),
+	('6224b578-fa0b-4884-879c-4bc8f8af24e2', '0c11098b-3d44-44f6-b90a-574e9fabfb40', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-01 08:12:08.843992+00', '2026-08-01 08:12:08.843992+00', NULL),
+	('766af2b2-661b-4051-82d3-e20db54516e2', '6b113c6c-9f5c-4052-a61f-346a7746f641', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-01 13:03:45.741808+00', '2026-08-01 13:03:45.741808+00', NULL),
+	('415cce39-b323-4174-8731-7df51d43fc35', '6b113c6c-9f5c-4052-a61f-346a7746f641', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-01 13:03:45.741808+00', '2026-08-01 13:03:45.741808+00', NULL),
+	('e0d20803-fff8-4b6e-95e7-df999845ac35', '43be694a-48fc-4c14-8b13-cded4791ec63', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-02 11:57:57.394811+00', '2026-08-02 11:57:57.394811+00', NULL),
+	('6ddfe402-6c3e-4bf9-a693-5023670ecfa3', '43be694a-48fc-4c14-8b13-cded4791ec63', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-02 11:57:57.394811+00', '2026-08-02 11:57:57.394811+00', NULL),
+	('aeb18625-d90b-4fa4-973f-aff3fa879977', '13a077a6-56e8-4fc1-997c-342787f814bd', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-04 06:58:42.499476+00', '2026-08-04 06:58:42.499476+00', NULL),
+	('1d060340-5233-4a16-ad23-c9ce92c5e7e7', '13a077a6-56e8-4fc1-997c-342787f814bd', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-04 06:58:42.499476+00', '2026-08-04 06:58:42.499476+00', NULL),
+	('6328e10c-356c-47e2-8f39-e3e5a2fc3c99', 'ba774692-e3be-4107-a1e6-6a497950d371', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-04 11:28:19.986023+00', '2026-08-04 11:28:19.986023+00', NULL),
+	('eee7914b-712f-491b-8be7-9c8c069f6562', 'ba774692-e3be-4107-a1e6-6a497950d371', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-04 11:28:19.986023+00', '2026-08-04 11:28:19.986023+00', NULL),
+	('39302f74-ce16-4d01-8db5-938a4c8801c4', '37a3cdde-377c-4cbf-ae1f-9571034024e2', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-04 12:12:58.232085+00', '2026-08-04 12:12:58.232085+00', NULL),
+	('04a44acf-9ec9-47a9-b9a1-1a3b1ae4ea9c', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-04 12:12:58.232085+00', '2026-08-04 12:12:58.232085+00', NULL),
+	('2d441e84-b77f-4873-aa30-2e6163fe9681', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', 'ca503969-35b6-40d4-8787-690fd8715dda', 0, '2026-08-05 11:18:48.962975+00', '2026-08-05 11:18:48.962975+00', NULL),
+	('191e632f-9913-4882-adfb-d0f364dff45d', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '028d9ac6-7a2f-42c7-9168-6165afacc3ab', 1, '2026-08-05 11:18:48.962975+00', '2026-08-05 11:18:48.962975+00', NULL),
+	('ce30c7ca-78f7-4514-95d4-7848a23260f2', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', 'd6907984-bcfb-4408-b823-0fecc284f393', 0, '2026-08-06 07:07:10.980795+00', '2026-08-06 07:07:10.980795+00', NULL),
+	('52007832-9eb0-4e40-921c-73cbc2721a79', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', 'fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 1, '2026-08-06 07:07:10.980795+00', '2026-08-06 07:07:10.980795+00', NULL),
+	('7b11ea70-351e-42b0-a3d9-9b85e602b59d', '7e076f85-0f80-4edc-9787-01129e2e46c4', 'd6907984-bcfb-4408-b823-0fecc284f393', 0, '2026-08-06 07:09:19.925174+00', '2026-08-06 07:09:19.925174+00', NULL),
+	('7ca99bc4-495a-46c5-bd37-1140b44c0371', '7e076f85-0f80-4edc-9787-01129e2e46c4', 'fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 1, '2026-08-06 07:09:19.925174+00', '2026-08-06 07:09:19.925174+00', NULL),
+	('488b0054-ba1b-439a-8d87-ca988f1e365f', '45cd3f95-b00c-42a8-812a-2c945271c44c', 'b67b7043-d216-4392-8313-7b43452e612d', 0, '2026-08-07 07:54:42.670851+00', '2026-08-07 07:54:42.670851+00', NULL),
+	('eab28041-e8a6-42f4-8c77-42e5883b1de8', '45cd3f95-b00c-42a8-812a-2c945271c44c', 'a8142510-249a-491e-903f-1d05abb129f7', 1, '2026-08-07 07:54:42.670851+00', '2026-08-07 07:54:42.670851+00', NULL),
+	('6deb5158-8852-4a65-87c9-34d8e18f7a24', '6838d0a3-66da-434e-8ba1-3597e3948006', '87662a07-2c7b-45c5-a4ff-c89fb9bc105c', 0, '2026-08-07 07:59:41.542479+00', '2026-08-07 07:59:41.542479+00', NULL),
+	('c6642f82-b581-451b-b712-22cf138cdbed', '6838d0a3-66da-434e-8ba1-3597e3948006', 'c07ddf04-36c6-468f-a2c6-7fd2732d8782', 1, '2026-08-07 07:59:41.542479+00', '2026-08-07 07:59:41.542479+00', NULL),
+	('89373e2d-3778-448f-9254-2473b080b5c0', 'bd5ba4e0-ab2b-48d3-acd4-79dc73336793', 'd6907984-bcfb-4408-b823-0fecc284f393', 0, '2026-08-07 08:01:06.455736+00', '2026-08-07 08:01:06.455736+00', NULL),
+	('80ad6bc7-dd39-403a-a773-fda5a5f4962e', 'bd5ba4e0-ab2b-48d3-acd4-79dc73336793', 'fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 1, '2026-08-07 08:01:06.455736+00', '2026-08-07 08:01:06.455736+00', NULL),
+	('93019860-a7ad-4cf1-960b-3546f216c543', '7ae66722-c16f-43a2-aa0c-1c28c1c81898', 'd6907984-bcfb-4408-b823-0fecc284f393', 0, '2026-08-07 08:01:31.382496+00', '2026-08-07 08:01:31.382496+00', NULL),
+	('3815bf87-c34c-43f7-af76-9aa03661e30d', '7ae66722-c16f-43a2-aa0c-1c28c1c81898', 'fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 1, '2026-08-07 08:01:31.382496+00', '2026-08-07 08:01:31.382496+00', NULL),
+	('f0cc5d2a-1829-4919-91d6-ced622637388', '62a426ca-52e7-4359-8a43-a8ac038638db', 'd6907984-bcfb-4408-b823-0fecc284f393', 0, '2026-08-07 08:02:18.250869+00', '2026-08-07 08:02:18.250869+00', NULL),
+	('070bb1fa-8676-4737-a2ca-43ffea3fb06d', '62a426ca-52e7-4359-8a43-a8ac038638db', 'fdbb34fd-aa8a-4f55-b32d-c5629a6ae38f', 1, '2026-08-07 08:02:18.250869+00', '2026-08-07 08:02:18.250869+00', NULL);
+
+
+--
+-- Data for Name: train_set_wagons; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_set_wagons VALUES
+	('67a7f36f-1f82-4aca-9335-4c0b814d3a69', '892ed0d9-60d8-4508-a33c-6e053cf7ddc2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 28.000, '2026-07-18 06:34:32.389+00', '2026-07-18 06:34:32.389+00', NULL, '746dfb2c-9cc1-4475-b110-bd0d5efa31b8', 'RESERVED', NULL, NULL),
+	('4130fd03-d4ea-47f1-bf4d-0e4d3a229faa', 'e877c44e-9292-453d-bb28-616075071bb3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 21.000, '2026-07-23 09:13:32.47+00', '2026-07-23 09:13:32.47+00', NULL, 'ded1f6e9-8498-44b7-8d2d-ec56febc4b90', 'RESERVED', NULL, NULL),
+	('02559453-f816-4f88-8a94-a8809d40e953', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '8ecb831d-4d07-4c56-b46c-d8fb7aff20d2', 'RESERVED', NULL, NULL),
+	('b4d35e23-7046-4b53-835e-f60f47a93c9c', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'f8e2efe7-8f72-4ced-9485-760f7e16b816', 'RESERVED', NULL, NULL),
+	('49ea2dcd-b532-45f1-b9f6-f6198f261ace', 'f9fdfe34-cad5-45c0-9d19-91bc0c89ebce', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 28.000, '2026-07-20 13:13:15.741+00', '2026-07-20 13:13:15.741+00', NULL, '72122c32-6b76-4881-aa5d-d9cdf2b787e1', 'RESERVED', NULL, NULL),
+	('9f2fba91-01c9-4761-8dda-71da8b7f4d98', 'f9fdfe34-cad5-45c0-9d19-91bc0c89ebce', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 29.000, '2026-07-20 13:13:15.741+00', '2026-07-20 13:13:15.741+00', NULL, '49bfa4cc-5644-4ef3-b121-27ccea8d80b1', 'RESERVED', NULL, NULL),
+	('288365be-18f9-4e12-bcab-31dfc4b0fbc1', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 1, 70.000, 17.066, 70.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, '5157d855-6ff4-4d76-93e8-3ed09005f07a', 'RESERVED', NULL, NULL),
+	('2eef66b6-ad35-402d-b3a9-2fa2626d4d2f', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 21.610, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'c00f78c4-e526-4272-953d-4d8c62c464ac', 'RESERVED', NULL, NULL),
+	('6fc68a29-f52f-4953-8bf1-3b536f215550', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 19.660, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'f6463fb1-5e59-4eab-a3e5-dfb2ba9f51e0', 'RESERVED', NULL, NULL),
+	('e4e8dde9-66fb-4c50-b02a-75d425d0a85f', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 18.860, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'c9f2906d-4e11-464f-922a-1b37bc95de15', 'RESERVED', NULL, NULL),
+	('2c4d9694-4ee5-4126-9830-2414186df13d', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 24.210, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '72122c32-6b76-4881-aa5d-d9cdf2b787e1', 'RESERVED', NULL, NULL),
+	('2883ad7f-46c2-4af7-823a-4de450a3ea87', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 26.590, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '49bfa4cc-5644-4ef3-b121-27ccea8d80b1', 'RESERVED', NULL, NULL),
+	('75965127-17e5-4aba-9044-0cb83d23e2e5', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 25.160, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '273d5cdf-193f-494e-927a-f30e2e800ee3', 'RESERVED', NULL, NULL),
+	('ab6ca4cf-454e-4a9b-b247-efe5edd7f1ba', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 20.300, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '8de9ad3b-fae0-499a-98ef-e5d5d2ee41d8', 'RESERVED', NULL, NULL),
+	('1991500d-4645-4217-9165-ac00144a97e0', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 20.260, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'b034a5f5-8eff-4f31-bf89-945d920749fe', 'RESERVED', NULL, NULL),
+	('565f8eef-c8b8-4e9e-b198-70ade7b1969a', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 22.790, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'd3779672-5f85-4a03-a437-7ef6ec2097b2', 'RESERVED', NULL, NULL),
+	('58981af8-7aa8-4f6a-88df-6d6785157a8f', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 25.320, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'dcf8af0b-b95e-4e95-8d8e-75be6a3ea769', 'RESERVED', NULL, NULL),
+	('59101b61-ee47-4b48-8b08-c7ad7ac639e7', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 24.560, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '85e05351-b076-4121-b7b1-e07863f69f31', 'RESERVED', NULL, NULL),
+	('553782cd-f0a1-4101-a8ec-9e5bceab1aef', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 21.810, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '5424c729-723a-4606-9d2d-b73f2ba27b31', 'RESERVED', NULL, NULL),
+	('2607c437-2e0a-4b51-a8b1-7e67a904e9df', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 26.460, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '6ade91c0-d616-4ae3-b7c1-7f7cb2686961', 'RESERVED', NULL, NULL),
+	('c4447949-5311-4280-be63-c03995e0c8be', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 27.240, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'f5bf1b94-6dc1-4be2-89a5-538cc18f919a', 'RESERVED', NULL, NULL),
+	('7fe8888e-10eb-4c9a-b3e8-c4022af6703f', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 28.290, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'afda74c6-be11-4edc-9c1e-e35a597508df', 'RESERVED', NULL, NULL),
+	('bfc1bfe5-9938-40d9-912a-2b3c9700a5f4', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 25.680, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '0aff5aa8-c79f-4367-bfa3-10aedde7f1fb', 'RESERVED', NULL, NULL),
+	('ce9608d4-db32-4f4e-8408-5a9acadac705', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 22.510, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '8bd92ab9-9765-4eb7-a01a-6574097530fb', 'RESERVED', NULL, NULL),
+	('b684b709-2ff0-452b-8b2c-6194da5d1a7c', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 25.820, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'fd916ab4-21c6-4da8-b35f-8205eab50337', 'RESERVED', NULL, NULL),
+	('9e67ef89-ca0d-498b-a57b-14598a5a3640', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 21.270, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'a116907e-a06e-46f7-8d8e-3c0ab2e830b5', 'RESERVED', NULL, NULL),
+	('5de13b2b-2ad9-4b33-8f6a-367e096e9261', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 29.680, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'd599be9b-e15a-44f8-8f1a-b2fe1acf79a0', 'RESERVED', NULL, NULL),
+	('2faac3fb-ea98-4761-b494-9b579ecebed5', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 21, 70.000, 13.966, 28.020, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '46642c3a-54bc-4c89-b02e-e970ea9a03c1', 'RESERVED', NULL, NULL),
+	('c477ae00-635a-4c8e-bc06-3e59fe1601ca', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 22, 70.000, 13.966, 18.860, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'd33cc5dc-ca2d-4621-a641-15ec8bd2b762', 'RESERVED', NULL, NULL),
+	('e989e03d-da08-4570-98a9-4c5927d5824a', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 23, 70.000, 13.966, 19.250, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'dfb83a01-311b-449f-a1ec-c44ee5c9a581', 'RESERVED', NULL, NULL),
+	('c5b7bbf9-945f-4bfe-b41d-b75522f67600', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 24, 70.000, 13.966, 24.140, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '944af82a-1903-4a6e-a557-c939a1b64336', 'RESERVED', NULL, NULL),
+	('cb1f9c6c-f736-4579-8c99-33ca5235bd47', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 25, 70.000, 13.966, 20.080, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '61ca1aac-1a39-4192-99aa-4d00e3ea0bf4', 'RESERVED', NULL, NULL),
+	('d6b45f75-2a72-41f1-b780-7b55e6ac6115', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 26, 70.000, 13.966, 23.340, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '6224eb5f-d4f9-4c65-874c-47422057f597', 'RESERVED', NULL, NULL),
+	('bd3d6f64-c286-44c5-9340-2648059ba281', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 27, 70.000, 13.966, 29.250, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'db06d53b-b72b-44d5-9450-2fe197b21a6e', 'RESERVED', NULL, NULL),
+	('61ec87c3-e432-405d-9b55-dd2d47fbf7b6', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 28, 70.000, 13.966, 25.520, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '45779010-d372-4e43-8c95-9fb536fed71a', 'RESERVED', NULL, NULL),
+	('fcc5061a-31f6-4a6b-9c1f-f75f4fdc25ad', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 29, 70.000, 13.966, 24.690, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '4bd640e4-7537-4322-8933-76ded3507e67', 'RESERVED', NULL, NULL),
+	('eb50b779-c205-4c0c-aba0-df17730f9846', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 30, 70.000, 13.966, 25.130, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '9c7d4932-5e79-4e22-a641-d5a814379b00', 'RESERVED', NULL, NULL),
+	('a3eb7cb4-6a4e-4ad0-baeb-8a3870b56d3d', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 31, 70.000, 13.966, 19.410, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'd200843a-fe67-4e5f-994f-63c45d65efd4', 'RESERVED', NULL, NULL),
+	('74d0f67c-9a62-4762-912c-065386cac6b0', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 32, 70.000, 13.966, 23.580, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '33d00826-3a41-40f2-8ae0-002686a8e3e8', 'RESERVED', NULL, NULL),
+	('4960e5b3-18ab-4829-9e5a-5e775fe96bdf', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 2, 70.000, 17.066, 70.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, '0eaa23e0-287c-4f08-b867-fc4069756e15', 'RESERVED', NULL, NULL),
+	('78c13305-448e-4b87-b65c-fd99b9fbbd9e', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 3, 70.000, 17.066, 70.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, '5f35aef5-9f2d-40d6-ad7c-6e5ff4fe3963', 'RESERVED', NULL, NULL),
+	('f717bff8-84ae-49e5-9297-d20a09ab77bc', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 4, 70.000, 17.066, 70.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, '5b7b8423-d211-4538-96a8-8cf5cebe9974', 'RESERVED', NULL, NULL),
+	('2a56a252-1abe-4452-9b98-683433d97547', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 33, 70.000, 13.966, 20.880, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '8289cbc1-7dff-4288-a9a5-18a8929d8d2b', 'RESERVED', NULL, NULL),
+	('7f7bed5f-739d-4376-ab5a-dfc726f4125f', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 34, 70.000, 13.966, 27.600, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '0377dd35-bc94-4fea-9e02-9600e433e5ab', 'RESERVED', NULL, NULL),
+	('1d1cc736-ca00-49a4-a38a-ba9c4a5c7d5c', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 35, 70.000, 13.966, 26.670, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '501a9fd6-16bb-4bb8-8031-9b9bcb95ae08', 'RESERVED', NULL, NULL),
+	('e3cedb88-0441-48ad-99f6-b89d890ae083', '21799060-5741-4416-81b8-0dda9e325e80', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 45.000, '2026-07-20 06:40:00.499+00', '2026-07-20 06:40:00.499+00', NULL, 'b150fcda-ed35-4c2a-829e-6f5da2447b94', 'RESERVED', NULL, NULL),
+	('7d9c168a-4ad3-461a-b8ed-aacc730cbed6', '21799060-5741-4416-81b8-0dda9e325e80', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 28.000, '2026-07-20 06:40:00.499+00', '2026-07-20 06:40:00.499+00', NULL, '5daa57bd-10ee-4e5f-a73a-45357b43e0a8', 'RESERVED', NULL, NULL),
+	('00884609-6671-4f28-8ac6-60c793f3673c', '21799060-5741-4416-81b8-0dda9e325e80', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 28.000, '2026-07-20 06:40:00.499+00', '2026-07-20 06:40:00.499+00', NULL, 'b9e70323-4d3c-4d85-b37a-51408b20daef', 'RESERVED', NULL, NULL),
+	('54507d24-a390-49cd-b854-9f69a7fd50da', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'be750157-c923-4ac9-88b8-7c3e75644fcc', 'RESERVED', NULL, NULL),
+	('e06942f6-3d65-4d90-a57d-38cc47e6e5c3', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '700477c2-4c6c-4f81-8c5b-a7589c83704b', 'RESERVED', NULL, NULL),
+	('f34ca34e-ea5a-4f06-aa89-3c9c6d55e602', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '5cadc015-35dc-4f13-a1df-35bef3acd35f', 'RESERVED', NULL, NULL),
+	('604f9c70-9136-4c67-87e3-72960da0a6cc', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '27398588-df37-4408-bcec-69b408be2b4c', 'RESERVED', NULL, NULL),
+	('7857abfa-6374-4edc-a232-f06f7c711307', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '951904eb-60a6-44dd-aada-4be40146f2a0', 'RESERVED', NULL, NULL),
+	('205153be-fea5-4ad3-a524-a1c51de84502', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'f1197f64-5ed6-4ed7-8d5b-27ca631a3c56', 'RESERVED', NULL, NULL),
+	('e6c19331-8aba-4dee-9794-1af8bfe3eb93', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'cb4ec20c-14b5-49ae-b757-a213b5dd9fb5', 'RESERVED', NULL, NULL),
+	('7d586c5b-729c-4df6-872c-82aef5860f21', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'abb8d3c8-6456-4849-a046-abeed0d3892c', 'RESERVED', NULL, NULL),
+	('4f975f1a-a913-424d-9b21-d99473c94edd', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '40e42fd9-8f27-4ed8-b73b-57cb790907e9', 'RESERVED', NULL, NULL),
+	('cff19caf-044f-4b2e-8376-46084a7048a6', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '6b8f2e94-dc78-49c7-9c8b-b304a7946649', 'RESERVED', NULL, NULL),
+	('3a5c0a4e-cf01-4a8b-bd32-d8c6e181adab', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'b8dfa5f4-2e86-4e8c-a155-5d0f50809c1c', 'RESERVED', NULL, NULL),
+	('91fc5586-9de4-48ca-82a3-bdcedd06ce5d', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '0fd9c907-d37b-4538-99a7-819da34072c5', 'RESERVED', NULL, NULL),
+	('ee0f9ba7-02b4-486f-8f04-b63eec09dbb5', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 56.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '943ff7f7-7b0e-4488-86c0-b4426bf1abba', 'RESERVED', NULL, NULL),
+	('825eda47-1163-4eb2-99cb-27bd8ef3e39d', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 25.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'ea41d963-cd4e-4e62-b4c9-c4f0411f9131', 'RESERVED', NULL, NULL),
+	('d7316eda-b62b-452c-983e-cf82a4cbf99a', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '69df25fe-ef7e-452f-8439-92757bb98b7e', 'RESERVED', NULL, NULL),
+	('452c7bdd-d7cd-411c-b330-5dc939635662', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '875974ae-ee69-45ef-a951-b70a7ecda661', 'RESERVED', NULL, NULL),
+	('a0959f6e-53aa-4f7f-b798-350d2eccd95e', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '194b9a33-c4b6-4cec-a2ac-4c7dab9023df', 'RESERVED', NULL, NULL),
+	('9ce12be0-5e8f-4efb-96d9-7aaa125e95d2', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '77164c29-1535-421a-bb0f-e61295ec7966', 'RESERVED', NULL, NULL),
+	('92682bb2-7f2c-4a54-b4ff-5b932bd450ec', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 21, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'da9c8cca-10db-4aca-8cd3-c883a402f5c6', 'RESERVED', NULL, NULL),
+	('483c6959-8d5a-40ab-9b68-bf4d01f81e79', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 22, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'd84a87c7-285c-43b0-928f-f18adf312557', 'RESERVED', NULL, NULL),
+	('20f92263-cdf1-4157-b350-fee54708efbb', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 23, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '45e0a7d8-cf56-43a4-977b-869ab6a1d6a8', 'RESERVED', NULL, NULL),
+	('bb161cd5-4159-4f04-808b-e38f31a6fa33', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 24, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '1f9aa084-2778-4973-829d-68ca27665b3d', 'RESERVED', NULL, NULL),
+	('f81a7fd4-15db-47cc-a5bd-afc0b02605ac', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 25, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '9384462b-53ed-4db9-9267-87ba35af3454', 'RESERVED', NULL, NULL),
+	('defcf90e-e1a4-41ec-a50f-ea8ce54082e4', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 26, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '2b37d9aa-ca9f-4384-8b69-2bb9d71c2bb8', 'RESERVED', NULL, NULL),
+	('f6c82c8d-74c0-49b2-89d0-444fe4fde8d3', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 43, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '6418abb5-3057-45c3-ae8e-131dc5ca944b', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('aabafad2-8347-4da6-ad43-789dde9917b6', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 27, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '52278b48-c882-4a34-96a8-d937592a2cd8', 'RESERVED', NULL, NULL),
+	('6b1d7059-c491-4ad8-8eed-4c7df627fc4c', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 28, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '6f2ade5d-c8c0-4bba-9cf6-e813ecf5eb8e', 'RESERVED', NULL, NULL),
+	('0ead934f-bce9-4dca-a1b9-7a778021cb86', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 29, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'af828445-a3ab-4bae-8f8c-d23d1f88b247', 'RESERVED', NULL, NULL),
+	('5e5066d1-409e-413e-8673-c7d57d785f09', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 30, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '2d6b5c20-d9c0-435d-821b-56ac5e4de522', 'RESERVED', NULL, NULL),
+	('519b29ab-f170-476b-965d-7f9e1c6b0300', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 31, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'ed0fe2bf-e386-4dec-ba8e-d9f5d783df42', 'RESERVED', NULL, NULL),
+	('d06255b4-e9bc-4736-8c0d-3f189bbea666', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 32, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '0c63898a-3b42-48c2-a8fa-f777e2d6a28e', 'RESERVED', NULL, NULL),
+	('e6365226-c2c3-4d57-8853-dc27d7be8e45', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 33, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '33235c6c-5314-4adf-a369-0df725e50196', 'RESERVED', NULL, NULL),
+	('ae683d3c-4e32-4613-8399-e361ddaa4c17', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 34, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'c66f251f-9119-442c-a4d4-360ccf8c8c20', 'RESERVED', NULL, NULL),
+	('5225ebde-15e2-4fa4-a85d-66dc8ef427c0', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 35, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'fcef533e-028d-4f87-b236-6913a6e34343', 'RESERVED', NULL, NULL),
+	('8040d8b7-2cb1-4232-aee8-931b0e47adcd', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 36, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'daaaaf4a-6a25-4a5f-98f2-964d7b7baa73', 'RESERVED', NULL, NULL),
+	('dbbc2ce2-5486-432e-8aab-b20c94114bcd', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 37, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'd6baf04f-9f9d-4d0f-92d0-8e11c5e564ec', 'RESERVED', NULL, NULL),
+	('45efdbf9-78f4-410c-ad03-b13640c0e4b3', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 38, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '796c99be-a661-4116-a577-a0110841dc73', 'RESERVED', NULL, NULL),
+	('d90abf88-df7e-48ff-9198-01db740d739a', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 39, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '838e35b4-2942-4315-9d47-585784f18ba2', 'RESERVED', NULL, NULL),
+	('4eb4fe6c-4dde-4e24-886a-26e1a15c4f03', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 40, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'eddf627c-d875-4ffb-8a21-3f8998958b94', 'RESERVED', NULL, NULL),
+	('772f4c48-4067-45a0-9d5f-dc378f1d8dc0', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 41, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '13670cc8-ba75-4c2d-8061-c6c9d46ea4e9', 'RESERVED', NULL, NULL),
+	('59c2dbec-58e4-4f0c-a6a6-d60f3668c598', 'd7604bf1-29ee-40f3-b054-b48f35b5f16f', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 43.000, '2026-07-21 06:58:17.167+00', '2026-07-21 06:58:17.167+00', NULL, 'b150fcda-ed35-4c2a-829e-6f5da2447b94', 'RESERVED', NULL, NULL),
+	('2ac68acd-32b8-4d3e-ab72-5b8f1a7335bb', 'd7604bf1-29ee-40f3-b054-b48f35b5f16f', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 21.000, '2026-07-21 06:58:17.167+00', '2026-07-21 06:58:17.167+00', NULL, '5daa57bd-10ee-4e5f-a73a-45357b43e0a8', 'RESERVED', NULL, NULL),
+	('7654c1a4-4e43-4868-8137-05bcac31f6ae', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 42, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '51f43037-daaf-4478-b355-c23c17555dc3', 'RESERVED', NULL, NULL),
+	('a70cd5b0-8a0c-4827-97f0-1bacef8cef5a', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 43, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, 'ba1ba21f-f437-4626-bdad-a6466e5bd1a3', 'RESERVED', NULL, NULL),
+	('41d4d3bd-b866-4265-84d2-868ccc8e9d07', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 44, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '274df441-ac91-444a-a9e7-18c5332157a4', 'RESERVED', NULL, NULL),
+	('65b153d3-ba9f-4936-ac91-06525a7b8271', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 45, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '24404f54-03b6-45ec-9cbe-227447b92976', 'RESERVED', NULL, NULL),
+	('8ac0fe16-f7da-474f-9fc9-94545b37a138', '7b9d83fc-957d-4aed-85a2-7e9b5db111c3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 46, 70.000, 13.966, 28.000, '2026-07-21 12:26:30.644+00', '2026-07-21 12:26:30.644+00', NULL, '83cd6274-9dda-44fc-9324-c87c5e81b676', 'RESERVED', NULL, NULL),
+	('0dbec353-bb4d-4d6c-8677-670e7efaa894', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 36, 70.000, 13.966, 21.800, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'f73b25d9-6b6a-4d53-8033-0d36bd288f66', 'RESERVED', NULL, NULL),
+	('8bc0b394-22b6-4ac9-9fc5-096f2aeb35ac', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 37, 70.000, 13.966, 26.450, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '0dc6cc71-04e7-465e-a0f5-b227e6b0e3cc', 'RESERVED', NULL, NULL),
+	('79aa58c7-705e-495c-bb8f-7740e67d87c8', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 38, 70.000, 13.966, 28.080, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'cda2bb61-9145-488f-9525-ef4f751844d2', 'RESERVED', NULL, NULL),
+	('76ffeef0-b9fd-475a-8cf8-3c11fe53a258', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 39, 70.000, 13.966, 23.270, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '63d8f50e-43a0-4a6f-b0ce-93a5446fe747', 'RESERVED', NULL, NULL),
+	('0ca36721-e6f3-479a-8c14-536664de3f6b', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 40, 70.000, 13.966, 24.130, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '4d7aac68-33ef-40eb-be71-b82123419fa0', 'RESERVED', NULL, NULL),
+	('2233af2f-0341-49d1-ba1c-5d9691bafa97', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 41, 70.000, 13.966, 27.570, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '3ecc5c70-2441-476c-b0bb-2737d0f09ef3', 'RESERVED', NULL, NULL),
+	('d3fa560f-f726-4803-8376-ca16e2c1b164', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 42, 70.000, 13.966, 28.860, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'cc7cc87f-4bad-4d1a-9beb-a636663c128e', 'RESERVED', NULL, NULL),
+	('6e09952e-acf1-44ff-9268-4a8b67bdd8de', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 43, 70.000, 13.966, 24.870, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '711ccac0-5db6-4a40-87d8-fcd32a2b3acf', 'RESERVED', NULL, NULL),
+	('5d1d2840-c1eb-4599-802a-dd48ab0a8fd8', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 44, 70.000, 13.966, 27.600, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'af381508-3230-46fa-83ff-3f475f10f587', 'RESERVED', NULL, NULL),
+	('ae72c2ad-0770-4253-99bc-5ddee4ce3698', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 45, 70.000, 13.966, 19.960, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '48be7d38-c265-47d1-ba04-2a3bb6bc116f', 'RESERVED', NULL, NULL),
+	('60e6a0b7-05cc-4dd3-a161-398fc2f4dbad', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 46, 70.000, 13.966, 28.520, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '01908c99-7431-4e1d-811a-40826c16665d', 'RESERVED', NULL, NULL),
+	('5da7a396-f72c-4d87-90fc-dc299afe7a06', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 47, 70.000, 13.966, 23.350, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'e9ca94f1-c922-4ca7-bf4e-751020ffb45f', 'RESERVED', NULL, NULL),
+	('a1b6df3f-8449-4579-96ec-50cace0a87e5', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 48, 70.000, 13.966, 28.100, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, 'cda7dc57-2622-482d-84a4-df22f6063e3c', 'RESERVED', NULL, NULL),
+	('87c7f388-8331-4284-a85d-0449e1864155', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 49, 70.000, 13.966, 23.660, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '408b14c4-0660-4004-8beb-e0859debac28', 'RESERVED', NULL, NULL),
+	('36c2eca8-75bd-49d5-a911-cd5274e1e586', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 50, 70.000, 13.966, 21.340, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '6c5d7287-7744-4336-899d-de15ef5ee98e', 'RESERVED', NULL, NULL),
+	('5c292a88-8f8b-47b5-9733-f49afe4f80b3', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 1, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '5157d855-6ff4-4d76-93e8-3ed09005f07a', 'RESERVED', NULL, NULL),
+	('3523b2d1-397b-4f3c-97bf-53444c37dab1', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 2, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '0eaa23e0-287c-4f08-b867-fc4069756e15', 'RESERVED', NULL, NULL),
+	('b4012900-9b8f-40f4-8dc9-deb99ee3ea6c', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 3, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '5f35aef5-9f2d-40d6-ad7c-6e5ff4fe3963', 'RESERVED', NULL, NULL),
+	('a1d156fe-f36d-4637-827b-92e89f61167d', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 4, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '5b7b8423-d211-4538-96a8-8cf5cebe9974', 'RESERVED', NULL, NULL),
+	('0c01b6d8-bf6b-407c-8ac3-262e38042ba2', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 5, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '3e79907b-c2d3-41ab-80fc-e315abeae8af', 'RESERVED', NULL, NULL),
+	('387f1b63-d278-4029-bb5c-415518ed3d93', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 6, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'd40c1816-be56-4a13-8c52-a436ac20c8ab', 'RESERVED', NULL, NULL),
+	('cd2525e1-2751-4568-8880-3a03fe24096a', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 7, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '54ce9794-8949-424b-b2da-2ce1117f64d5', 'RESERVED', NULL, NULL),
+	('a32b3e64-107c-4c1e-b0e2-aebf6aa71678', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 8, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '41cef115-d5ce-4e37-a824-d356c9fe2a65', 'RESERVED', NULL, NULL),
+	('a98d57d4-5bdd-44e3-8b8e-c410441fa6d5', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 9, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '1ffe2c11-525c-4f4b-b510-986a976e4f66', 'RESERVED', NULL, NULL),
+	('3eaca077-1808-4654-8d6e-6c89ab82abdd', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 10, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'afc8372e-f69a-471e-b670-faf8ae208f9d', 'RESERVED', NULL, NULL),
+	('d48d0279-b24c-4c75-9396-3328b527c548', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 11, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '05801372-7f9e-4362-b55a-bae1f666eec2', 'RESERVED', NULL, NULL),
+	('4b8a87dd-c1c6-4a9f-a4ed-c06e686bcac9', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 12, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '5a8ef4df-c9e4-46e7-870b-8d991d92399c', 'RESERVED', NULL, NULL),
+	('9eafa736-e099-472e-b5ff-7a97d76c9a30', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 13, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'f7c19cb3-2ed8-4889-b528-2e2533502e1f', 'RESERVED', NULL, NULL),
+	('5bcedd28-d99d-4bdb-bc0a-41d68caeefa0', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 14, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'd040c962-0654-4728-9193-1130c88e4a62', 'RESERVED', NULL, NULL),
+	('576256e9-94de-4b81-bf19-9359e68bc437', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 15, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'b9d8a7f8-bc43-49aa-b3a6-0318b46e2910', 'RESERVED', NULL, NULL),
+	('668e573f-a4e4-4ff7-ba92-ed4c441c3845', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 16, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'f0848a37-c4d9-4d1f-bf4f-96cb5c9de452', 'RESERVED', NULL, NULL),
+	('62f62c24-b052-44d3-8afb-0f1a4339c663', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 17, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'c88396c0-3bed-4aff-a848-7f82f70b932f', 'RESERVED', NULL, NULL),
+	('f1b20293-6545-46c2-ba61-e4785cbc8ba6', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 18, 70.000, 17.066, 70.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, '1d3eada0-d635-4cce-8162-37ab335875d1', 'RESERVED', NULL, NULL),
+	('b5b5db51-642f-4bf8-bcfd-5c719e5465a6', 'f13ddc61-ec01-4991-bb1a-b8b525e2764e', '8eec3a7d-8482-4397-96b6-59a028210722', 19, 70.000, 17.066, 35.000, '2026-07-22 08:37:23.092+00', '2026-07-22 08:37:23.092+00', NULL, 'cf954164-7b60-4ec6-9b19-ffcd8349e73a', 'RESERVED', NULL, NULL),
+	('6353276f-e674-4c12-ade0-032cf6d86d83', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 51, 70.000, 13.966, 24.690, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '5c059ddf-a486-414a-81cf-aeb384ef7323', 'RESERVED', NULL, NULL),
+	('7a909384-8c37-4d19-8cb3-5884039621d1', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 52, 70.000, 13.966, 27.600, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '24125da0-7132-4b76-9bd5-cf6d7504bb8f', 'RESERVED', NULL, NULL),
+	('0627f1b2-0106-4d0e-b3f4-ad08dfad6870', 'd226d18d-1a48-427b-8e51-236178d65a49', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 53, 70.000, 13.966, 21.830, '2026-07-22 13:39:48.902+00', '2026-07-22 13:39:48.902+00', NULL, '4f2742fd-8f95-46d7-8b0b-cd6a451e4214', 'RESERVED', NULL, NULL),
+	('5008e2a1-3868-45b7-a35f-ffa44fea4272', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 5, 70.000, 17.066, 70.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, '3e79907b-c2d3-41ab-80fc-e315abeae8af', 'RESERVED', NULL, NULL),
+	('d9842f8c-c31d-4de6-bb44-fc3280cdcdd3', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 6, 70.000, 17.066, 70.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, 'd40c1816-be56-4a13-8c52-a436ac20c8ab', 'RESERVED', NULL, NULL),
+	('83cb0f00-efc1-4c20-97f1-659846a2971d', '379c7434-f412-4a79-ae2d-e4740c63b49a', '8eec3a7d-8482-4397-96b6-59a028210722', 7, 70.000, 17.066, 28.000, '2026-07-23 09:23:37.952+00', '2026-07-23 09:23:37.952+00', NULL, '54ce9794-8949-424b-b2da-2ce1117f64d5', 'RESERVED', NULL, NULL),
+	('01a3c551-107e-45be-a98b-6397bc42e9ab', '065de839-5edb-4a08-ae6e-d1142579fd99', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 24.000, '2026-07-23 14:02:20.291+00', '2026-07-23 14:02:20.291+00', NULL, '98407c31-ec00-4b57-a96d-637cec1ed273', 'RESERVED', NULL, NULL),
+	('d2cfd3b2-b405-421e-bcaa-95593b087afc', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 1, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '3ae733ed-b2ab-4b50-81ab-c7d67415c30f', 'RESERVED', NULL, NULL),
+	('b5c036cf-eb05-4a6e-8278-e661a0ce48b3', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 2, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'ea7c3b62-00a5-486f-b37b-5c876a8ef0be', 'RESERVED', NULL, NULL),
+	('81035b6a-68c9-49eb-8dc0-d90011c3fa6a', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 3, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '07e93df1-095c-442f-bda5-41bc74ad0ced', 'RESERVED', NULL, NULL),
+	('53240b26-fe61-4ad5-b025-55cf53542887', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 4, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '7a93e53e-861d-4e3a-bd4b-58bf39da6ee8', 'RESERVED', NULL, NULL),
+	('93d5a24e-cbeb-43a1-a96b-157eedac2b4d', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 5, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '7c2f5d1c-d9d5-44bd-b7ff-80f3e7bf52e5', 'RESERVED', NULL, NULL),
+	('1328cda4-082a-4365-9180-13e88f065134', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 6, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'ed72a1b9-d060-4699-b866-31a2c6bf2eb8', 'RESERVED', NULL, NULL),
+	('14a9c598-3b01-4bc6-8817-2fe4fbbc32a8', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 7, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '52c2faf6-80f1-40e8-97d1-d8ee82867198', 'RESERVED', NULL, NULL),
+	('82d38939-f038-4cd1-b5d5-1ca6eadd746c', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 40.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '5067bbde-7756-4ccd-b95f-654baba240c0', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('3ef9ab1c-86af-403c-a71c-88a2f6b12684', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '1c4f1919-2c79-497b-9c57-92bad167d443', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('8bfd98d2-2660-4fd4-87a0-1c956998049d', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'b0fd8345-e047-4869-ba3b-b5eee4d1509f', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('caa05bd0-4c14-46b8-9669-6ad9fe5b466b', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'd0ef971b-de9a-4444-8f9b-be65a73383a8', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('dd02d422-040b-47e3-b734-8b71ef36ca38', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'db81a283-27ef-470e-8697-bb99f2985e0c', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('25802de0-800b-4360-a570-8992e45b7ec5', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '367c3556-02c5-4734-993f-27b4ef8c894d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('137b3ef7-42cb-4cdc-830f-4b6e227a6bcb', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '6418abb5-3057-45c3-ae8e-131dc5ca944b', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('d7e54568-3d8a-41e0-91d9-ed38cbf879c6', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'b1848f29-5b8e-4af2-a633-e3979371881d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('b83f8dcd-bfb6-4350-adbf-2363b25f77c0', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'ac3442c2-05b9-4d13-a242-ee50caadeb9e', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('87ecd747-9fb6-462f-b68a-e9d0c245a45a', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '100fbb76-f62d-46a3-be30-ac79719f9ded', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('310b0e53-475f-4063-aaa1-38e9cc1ccc81', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '078db48b-a8ab-4acf-babc-0e5c8df538fa', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('d161a9ed-0637-4b35-9bd2-1764822b71d4', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'ebf5d985-02ee-4f64-a43c-c77c683e5479', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('5f112c5d-2092-4c5c-91c4-691c0001b609', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '9ad96e4c-285c-4b47-baec-ad9606680bff', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('24fc7968-b3a8-4ddc-abbe-799e1b9c2119', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '027c3412-c1ec-4f48-b65f-dc20b20db5c7', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('97b5ec8b-f4f5-470f-bb83-6023360a212c', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'a2c86830-5db4-4cd4-99e6-85cdbf9f6979', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('534611d9-bc55-4ef2-b876-f7fabb635a2c', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '8198f44f-fbf7-4c17-b4c4-b243a78b51c9', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('99f4396b-628e-4778-b9b3-ba424a3ce2b1', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '21ad7cf5-8720-48ab-b07c-457d659f10df', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('254e7a60-5349-488f-9048-6b2f49d862d1', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '343bd852-aaec-4858-a2ff-a3c126b0cb5b', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('8173a33d-c2c6-4988-9a25-207147af59b7', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '9db9bf3d-2a4c-43cd-976b-b6dafe140865', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('dc328856-2ce6-4907-96ec-08d3ce31a7c7', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 21, 70.000, 13.966, 20.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, 'e875642e-1a0c-4916-9c30-afedc2bf6058', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('31d65e9d-b63f-44c6-81f3-e85e75cc9893', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 8, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '46793bd2-c77b-43af-83f4-3cebca8f83fd', 'RESERVED', NULL, NULL),
+	('c0b64205-1932-4fc7-8c1f-d3dc57d6a893', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 9, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '10fa4f49-57d1-48e3-a7e3-46e2121f0ccc', 'RESERVED', NULL, NULL),
+	('846beb93-18af-47a7-a788-f053625fe5d6', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 10, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'df0824ca-b995-46a2-a153-ddbe7d2746ce', 'RESERVED', NULL, NULL),
+	('e05a7d7b-9eb7-432f-a099-9294f96352c8', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 11, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '36c7a12a-1bec-4600-b8d1-7d8b9e3bdaf2', 'RESERVED', NULL, NULL),
+	('6db8a1de-9618-4b6c-a849-a5b4ccf68bc7', 'f3af584a-51cb-4683-b9d0-f6ce3503894e', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 40.000, '2026-07-21 17:16:01.803+00', '2026-07-21 17:16:01.803+00', NULL, '4334b12e-103f-4499-8fe5-1ff8df234716', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('fd327cc5-cb58-4a97-b480-29c72eefa1f9', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 12, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'ab966ba3-0eb9-43b8-8a7b-c6a8bdc1b8b2', 'RESERVED', NULL, NULL),
+	('96898e73-b30a-435e-8840-5af053efaaee', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 13, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '873ccf9e-68f5-468a-ab6e-626a77511a26', 'RESERVED', NULL, NULL),
+	('756fa785-4530-4058-80e8-ffbf35c5a0da', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 14, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'da467171-ff66-4c8f-a8f0-da37dc7b7ea7', 'RESERVED', NULL, NULL),
+	('bc630d76-cf1b-4351-9fd3-62f3e8dc76cc', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 15, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '0ac8b72b-38a2-4fd8-ba6c-273edf69dd43', 'RESERVED', NULL, NULL),
+	('0df2be8d-34d0-4803-bbb5-55f96ea29d37', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 16, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'e83f2749-f195-4ecf-b158-d0f96a24493d', 'RESERVED', NULL, NULL),
+	('18ad406b-a46e-469c-b12a-a82e76afea87', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 17, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '0b652309-d605-4e20-84bd-974139462cc6', 'RESERVED', NULL, NULL),
+	('fc905cad-856b-4ff0-9ed1-a46de82b3e1d', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 18, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '7589b56c-a055-4592-a0ab-ac963c2e46df', 'RESERVED', NULL, NULL),
+	('14741d41-a1c4-40ee-8eea-8b7d635e891e', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 19, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'ba5376e4-bdab-4e4b-a3b0-c8ba6c2f2da9', 'RESERVED', NULL, NULL),
+	('0ee00b71-1e40-4b9c-bbee-2b3c5b91317c', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 20, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '4347bd49-f8c7-40a5-a963-c35f71e4551f', 'RESERVED', NULL, NULL),
+	('0ed7a9b6-2831-41b2-beb9-f15cc1ff90e5', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 21, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'ffef9238-7c91-499f-8d71-ac767d713615', 'RESERVED', NULL, NULL),
+	('a9f6a395-70c9-46af-ba33-b9c6a84c78dc', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 22, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '220877e0-fef1-42b6-90d9-48136749840f', 'RESERVED', NULL, NULL),
+	('18681340-edfc-4acb-9935-fc10c091eabc', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 23, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, 'd7be2a1f-521e-4548-97b2-dc19361a8c24', 'RESERVED', NULL, NULL),
+	('65028b9e-02e1-4cc0-86e1-9931f174d9f0', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 24, 70.000, 17.066, 70.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '7d90c6dc-a55c-4920-a5e2-3bc338263c77', 'RESERVED', NULL, NULL),
+	('562977f6-b1a1-4799-af4f-f892d166c7c8', '3b753131-834f-4763-892e-a8f4a8ca837c', '8eec3a7d-8482-4397-96b6-59a028210722', 25, 70.000, 17.066, 22.000, '2026-07-22 12:46:48.165+00', '2026-07-22 12:46:48.165+00', NULL, '2152baca-bdec-4f94-8e69-dbd0f5d14127', 'RESERVED', NULL, NULL),
+	('d68822fb-7665-4b87-9597-0704c855b379', '83a0229a-8975-4b9b-a97f-7b3004215aef', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 12.000, '2026-07-20 11:14:11.013+00', '2026-07-20 11:14:11.013+00', NULL, '4334b12e-103f-4499-8fe5-1ff8df234716', 'RESERVED', NULL, NULL),
+	('c1c40709-282f-4d7f-a4a2-d780e7546e42', '83a0229a-8975-4b9b-a97f-7b3004215aef', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 47.850, '2026-07-20 11:14:11.013+00', '2026-07-20 11:14:11.013+00', NULL, '5067bbde-7756-4ccd-b95f-654baba240c0', 'RESERVED', NULL, NULL),
+	('a7bdb1df-6cbf-4d8f-a633-b6b77c433ae8', '83a0229a-8975-4b9b-a97f-7b3004215aef', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 19.000, '2026-07-20 11:14:11.013+00', '2026-07-20 11:14:11.013+00', NULL, '1c4f1919-2c79-497b-9c57-92bad167d443', 'RESERVED', NULL, NULL),
+	('bd61afa6-3ff7-4b17-9b6d-f4323d9312d0', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '148b7a5b-c7e3-46a6-a621-61467233720c', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('ad46086e-cda6-447d-8e1d-cf9d853d8bf6', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '4334b12e-103f-4499-8fe5-1ff8df234716', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('3cb481e4-2202-4f23-bcc2-59d2b541c3d8', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '04feda04-6dcb-4d27-b6bf-458d9318e0c2', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('c0e7cbc9-d741-4ed8-a2e9-c2cbeef28637', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '4065b9e5-f6ce-4df5-b324-1081c0247d4c', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('7d5a0ed4-c3b1-4ec3-92e5-695969a23a84', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'd9f29503-3906-4d20-bff5-447ebe355b61', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('f8ad88b4-e2f3-4d23-a242-00d92aae80f5', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'aabc4d3e-ac83-42c3-b348-080db47539b7', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('ce4d1043-8155-4456-adf6-a0a87969de3f', '6d83b300-aa08-42bf-bcee-f0f1df37cde5', '8eec3a7d-8482-4397-96b6-59a028210722', 1, 70.000, 17.066, 70.000, '2026-07-23 12:57:09.86+00', '2026-07-23 12:57:09.86+00', NULL, '5157d855-6ff4-4d76-93e8-3ed09005f07a', 'RESERVED', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL),
+	('88acf021-ea7e-4418-b718-24572ff0f749', '6d83b300-aa08-42bf-bcee-f0f1df37cde5', '8eec3a7d-8482-4397-96b6-59a028210722', 2, 70.000, 17.066, 70.000, '2026-07-23 12:57:09.86+00', '2026-07-23 12:57:09.86+00', NULL, '0eaa23e0-287c-4f08-b867-fc4069756e15', 'RESERVED', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL),
+	('5badf08a-861a-4fb0-b3ec-24d768b6dc96', '6d83b300-aa08-42bf-bcee-f0f1df37cde5', '8eec3a7d-8482-4397-96b6-59a028210722', 3, 70.000, 17.066, 60.000, '2026-07-23 12:57:09.86+00', '2026-07-23 12:57:09.86+00', NULL, '5f35aef5-9f2d-40d6-ad7c-6e5ff4fe3963', 'RESERVED', '23fda607-6cc6-4923-b05b-56b7adb1626b', NULL),
+	('f343f000-9060-4837-a841-4a1268c0312f', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'e2bfa882-d653-4b30-aa33-e7b20698636d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('e2b5db87-43e5-4d02-be55-bbd36ab01e06', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'a83c2c28-b229-4275-aa45-7ba49e5e8042', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('bf5fa298-bb69-445f-810e-28f5b75ade86', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'de9ef3bd-712b-4f34-8f25-0d6a51833074', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('29e7b7cc-b183-433e-9081-9167255add77', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'b32de37c-e462-4a7b-aeb0-f7b73ddf68f0', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('d505e9b1-bef5-4e66-b7d1-166b2b81eb29', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '57c3f687-1c0d-4a29-9060-db38b3a533e6', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('51f778c9-f883-4342-a5d5-1f7ba038d4ac', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 21.640, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '5daa57bd-10ee-4e5f-a73a-45357b43e0a8', 'RESERVED', NULL, NULL),
+	('d80c4168-7a3e-4abc-896f-02fb2fdfab10', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 21.660, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'dcf8af0b-b95e-4e95-8d8e-75be6a3ea769', 'RESERVED', NULL, NULL),
+	('c9e66726-d1ea-4169-906a-f23ea252f1ba', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 21.050, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'e4f95edb-21b6-482b-9b51-1af97edc2341', 'RESERVED', NULL, NULL),
+	('d0fd8cf8-2ca5-433d-a621-b5f95662567f', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 25.320, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'a25bbcfd-a76c-47c4-80f4-5462f98eba3e', 'RESERVED', NULL, NULL),
+	('e3f5e663-f602-4006-8fb4-96fcb9c28c5a', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 26.490, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '5cadc015-35dc-4f13-a1df-35bef3acd35f', 'RESERVED', NULL, NULL),
+	('3817d0ff-97a5-4013-a08f-ad3cbe376acf', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 23.950, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '85e05351-b076-4121-b7b1-e07863f69f31', 'RESERVED', NULL, NULL),
+	('27f8c316-ecca-49b4-8768-ee16a9ac70a2', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 22.240, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '944cec65-290c-4adb-bf37-5bba91ecaab2', 'RESERVED', NULL, NULL),
+	('26c72cdb-6698-4a98-8d56-b0f59be8dc30', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 25.530, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '27398588-df37-4408-bcec-69b408be2b4c', 'RESERVED', NULL, NULL),
+	('477b3b91-a786-48e5-b746-10104d0f593f', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 21.540, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '5424c729-723a-4606-9d2d-b73f2ba27b31', 'RESERVED', NULL, NULL),
+	('4ba8ad09-d5eb-41cb-8811-433658c5b566', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 27.590, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '6ade91c0-d616-4ae3-b7c1-7f7cb2686961', 'RESERVED', NULL, NULL),
+	('c1cec7f7-c35f-4fed-a16f-ce5eac6e6d2b', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 24.550, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'RESERVED', NULL, NULL),
+	('6410b452-8445-4d56-912a-928ab4df5b15', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 22, 70.000, 13.966, 24.410, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '76e92779-2705-43b5-8e28-52fc9ad42ddd', 'RESERVED', NULL, NULL),
+	('43a0b62c-7edf-4818-b7ad-9eb19ddb6307', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 23, 70.000, 13.966, 20.420, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '951904eb-60a6-44dd-aada-4be40146f2a0', 'RESERVED', NULL, NULL),
+	('cf9ff8a7-d8e2-4b65-b81a-27cc6d134e79', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 24, 70.000, 13.966, 21.720, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'b9e70323-4d3c-4d85-b37a-51408b20daef', 'RESERVED', NULL, NULL),
+	('cc33fa43-b64d-44fb-9c77-1305037d9b76', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 25.000, '2026-08-01 09:40:07.41296+00', '2026-08-01 09:40:07.41296+00', NULL, '8ecb831d-4d07-4c56-b46c-d8fb7aff20d2', 'RESERVED', NULL, NULL),
+	('0fa89aee-c550-422f-ab07-7a798ade7608', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 28.000, '2026-08-01 09:40:07.41296+00', '2026-08-01 09:40:07.41296+00', NULL, 'c00f78c4-e526-4272-953d-4d8c62c464ac', 'RESERVED', NULL, NULL),
+	('20474978-2ed1-4f00-88b5-b4019f15b4b6', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 24.000, '2026-08-01 09:40:07.41296+00', '2026-08-01 09:40:07.41296+00', NULL, 'f8e2efe7-8f72-4ced-9485-760f7e16b816', 'RESERVED', NULL, NULL),
+	('ec2f51cc-f70f-43fd-9427-4e727b5fe767', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 23.000, '2026-08-01 09:40:07.41296+00', '2026-08-01 09:40:07.41296+00', NULL, 'f6463fb1-5e59-4eab-a3e5-dfb2ba9f51e0', 'RESERVED', NULL, NULL),
+	('09df696e-2290-4f88-93c4-208106b2ac2e', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 21.000, '2026-08-01 09:40:07.41296+00', '2026-08-01 09:40:07.41296+00', NULL, 'ae484bb2-59f3-4be3-b73e-3615ed8239fc', 'RESERVED', NULL, NULL),
+	('65b594ca-a753-4f84-b29b-317b19667bf1', 'e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 37.000, '2026-08-01 09:40:07.41296+00', '2026-08-01 09:40:07.41296+00', NULL, '746dfb2c-9cc1-4475-b110-bd0d5efa31b8', 'RESERVED', NULL, NULL),
+	('7eca46c2-5b10-418d-a5d3-1332e2209dbb', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 25, 70.000, 13.966, 22.350, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'c6e5e49c-01fd-4469-a215-e4b2f5ee6ad3', 'RESERVED', NULL, NULL),
+	('029e7137-537a-4941-8ab3-c843a6e39dfa', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 26, 70.000, 13.966, 22.120, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '1ab8f840-69cc-4d95-9bcc-2c3be1e8c85e', 'RESERVED', NULL, NULL),
+	('598a99df-312e-42e8-848a-80bafc191e78', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 27, 70.000, 13.966, 26.290, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'f5bf1b94-6dc1-4be2-89a5-538cc18f919a', 'RESERVED', NULL, NULL),
+	('595dd9e3-97c3-4741-852f-d6f8c77f44c2', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 28, 70.000, 13.966, 22.690, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'd25abbef-a7f0-4b6c-98ed-6931e074168b', 'RESERVED', NULL, NULL),
+	('941cae90-7d03-4a21-ad56-0eebb7e53e15', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 29, 70.000, 13.966, 26.040, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '04219cc7-ef3f-4b30-9e31-cb5a207631ae', 'RESERVED', NULL, NULL),
+	('e2b0f8e1-f329-4dd6-956b-933f50ea32ab', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 30, 70.000, 13.966, 23.180, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'afda74c6-be11-4edc-9c1e-e35a597508df', 'RESERVED', NULL, NULL),
+	('565ec1be-db81-44d4-9bfe-264783854063', '43be694a-48fc-4c14-8b13-cded4791ec63', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 10.000, '2026-08-02 21:48:51.413136+00', '2026-08-02 21:48:51.413136+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'RESERVED', NULL, NULL),
+	('ba993ca5-8ade-4d05-a60c-8907e6dc6746', '43be694a-48fc-4c14-8b13-cded4791ec63', '4f65adc3-baf7-44de-88ad-0a4672fab669', 2, 70.000, 18.560, 10.000, '2026-08-02 21:48:51.413136+00', '2026-08-02 21:48:51.413136+00', NULL, 'c0eafaa7-85f4-4568-a3cb-09754f196592', 'RESERVED', NULL, NULL),
+	('540ea941-0dfc-4107-bd66-ab026b7f76be', '43be694a-48fc-4c14-8b13-cded4791ec63', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 10.000, '2026-08-02 21:48:51.413136+00', '2026-08-02 21:48:51.413136+00', NULL, '6ade91c0-d616-4ae3-b7c1-7f7cb2686961', 'RESERVED', NULL, NULL),
+	('7232008e-99b7-4c89-9032-ed30d3beceac', '43be694a-48fc-4c14-8b13-cded4791ec63', '4f65adc3-baf7-44de-88ad-0a4672fab669', 4, 70.000, 18.560, 10.000, '2026-08-02 21:48:51.413136+00', '2026-08-02 21:48:51.413136+00', NULL, '9511df0b-87ea-4f19-a770-4ea9a27004dd', 'RESERVED', NULL, NULL),
+	('f301247f-ffe1-44ce-93a6-abb78e677d6c', '43be694a-48fc-4c14-8b13-cded4791ec63', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 10.000, '2026-08-02 21:48:51.413136+00', '2026-08-02 21:48:51.413136+00', NULL, '5424c729-723a-4606-9d2d-b73f2ba27b31', 'RESERVED', NULL, NULL),
+	('773f9793-1ec7-41d8-baed-89de0521037d', '62a426ca-52e7-4359-8a43-a8ac038638db', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 21.000, '2026-08-07 11:05:27.931018+00', '2026-08-07 11:05:27.931018+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'RESERVED', NULL, NULL),
+	('9d8a812d-2af4-4ad6-8d88-58b67d3ab37f', '62a426ca-52e7-4359-8a43-a8ac038638db', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 22.000, '2026-08-07 11:05:27.931018+00', '2026-08-07 11:05:27.931018+00', NULL, 'e4f95edb-21b6-482b-9b51-1af97edc2341', 'RESERVED', NULL, NULL),
+	('dce5f183-5d74-41d1-95c1-851fbb962995', '62a426ca-52e7-4359-8a43-a8ac038638db', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 22.000, '2026-08-07 11:05:27.931018+00', '2026-08-07 11:05:27.931018+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'RESERVED', NULL, NULL),
+	('0ea2a8f4-d26b-444b-bb2c-4e524cfc834b', '62a426ca-52e7-4359-8a43-a8ac038638db', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 21.000, '2026-08-07 11:05:27.931018+00', '2026-08-07 11:05:27.931018+00', NULL, 'd25abbef-a7f0-4b6c-98ed-6931e074168b', 'RESERVED', NULL, NULL),
+	('b9c95055-d74c-4b9e-813d-ea8550a6d93c', '62a426ca-52e7-4359-8a43-a8ac038638db', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 36.000, '2026-08-07 11:05:27.931018+00', '2026-08-07 11:05:27.931018+00', NULL, 'f8e2efe7-8f72-4ced-9485-760f7e16b816', 'RESERVED', NULL, NULL),
+	('c04b5cd0-873a-49c4-bd93-1b206211f959', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 24.500, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, 'ee187bcb-a21d-49db-9102-96361dd65aa5', 'RESERVED', NULL, NULL),
+	('4b7eb647-a75d-486e-b9df-6686407c2222', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 20.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, '273d5cdf-193f-494e-927a-f30e2e800ee3', 'RESERVED', NULL, NULL),
+	('90b0373e-50f4-4ceb-8b77-f16327bec26b', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 20.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, 'd4138cab-df2f-4a7d-89ad-b57bf0e00c13', 'RESERVED', NULL, NULL),
+	('26800d8b-b8ba-44d7-81cc-1fc6e3b7471a', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'RESERVED', NULL, NULL),
+	('db2ff554-dc2c-4566-821c-2327ea1d6d7e', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, '5852d1d2-0ae9-4e9d-923d-6e94e0978a25', 'RESERVED', NULL, NULL),
+	('05737b73-fa89-446a-ad15-9ab37f31e88a', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, '8de9ad3b-fae0-499a-98ef-e5d5d2ee41d8', 'RESERVED', NULL, NULL),
+	('e15b30e7-ec60-4e7e-be3b-a24defd3a1a9', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, 'b034a5f5-8eff-4f31-bf89-945d920749fe', 'RESERVED', NULL, NULL),
+	('4d657e4e-ed17-4b4f-9fa9-15d7e8c23ab4', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, '898628d2-7195-49aa-aa05-7289781725ac', 'RESERVED', NULL, NULL),
+	('3c1ae892-5bf7-49c9-a0be-9cdeee8ad17c', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, 'd3779672-5f85-4a03-a437-7ef6ec2097b2', 'RESERVED', NULL, NULL),
+	('a0eed35d-cea0-4942-ba80-35a0c31a2890', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 70.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, '5daa57bd-10ee-4e5f-a73a-45357b43e0a8', 'RESERVED', NULL, NULL),
+	('f1fa9a07-5031-4673-bc86-b54e58e4d33a', '37a3cdde-377c-4cbf-ae1f-9571034024e2', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 10.000, '2026-08-06 04:29:06.859628+00', '2026-08-06 04:29:06.859628+00', NULL, 'dcf8af0b-b95e-4e95-8d8e-75be6a3ea769', 'RESERVED', NULL, NULL),
+	('03e46bbf-53d3-4895-9fe2-f30cc366cb3f', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 20.260, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'ee187bcb-a21d-49db-9102-96361dd65aa5', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('10677ed1-c96e-4840-841c-4437bc37e533', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 24.680, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '273d5cdf-193f-494e-927a-f30e2e800ee3', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('666ba4c0-3e81-4634-b6be-91930e9451ca', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 21.730, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'd4138cab-df2f-4a7d-89ad-b57bf0e00c13', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('f23f9907-7f4f-49a9-ba86-eb28032f2589', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 21.400, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('dbb12e5e-dc8a-4579-bdcc-c9025a1424b6', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 21.580, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '5852d1d2-0ae9-4e9d-923d-6e94e0978a25', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('e3f3d0bf-485c-4e39-952c-64bd3edc2c25', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 21.880, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '8de9ad3b-fae0-499a-98ef-e5d5d2ee41d8', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('a219d3ae-af1d-458d-8a24-e353e946d626', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 21.910, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'b034a5f5-8eff-4f31-bf89-945d920749fe', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('ca477328-2ded-4993-926d-153da2b360fc', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 23.210, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '898628d2-7195-49aa-aa05-7289781725ac', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('aeccc934-d350-4a24-a1d0-6cca6bf6dea3', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 22.150, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'd3779672-5f85-4a03-a437-7ef6ec2097b2', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('4bbc20c0-a638-4e56-99dc-8a8396985f3d', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 20.300, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '5daa57bd-10ee-4e5f-a73a-45357b43e0a8', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('879bac12-b688-42e3-98e8-ae278df9be7b', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 26.930, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'dcf8af0b-b95e-4e95-8d8e-75be6a3ea769', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('1c775c81-8da2-49e2-8e9c-a028c703237c', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 21.680, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'e4f95edb-21b6-482b-9b51-1af97edc2341', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('b710ed75-8ec4-443a-8529-ffb09a3970a4', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 27.010, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'a25bbcfd-a76c-47c4-80f4-5462f98eba3e', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('60a5296b-cd62-4169-86da-c2642691cd0a', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 21.960, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '5cadc015-35dc-4f13-a1df-35bef3acd35f', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('95eaefe9-5fff-4430-a5ba-c99c02e7ad6c', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 20.850, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '85e05351-b076-4121-b7b1-e07863f69f31', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('83ed469f-15e3-4df7-ae1b-4fb58141cb45', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 26.100, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '944cec65-290c-4adb-bf37-5bba91ecaab2', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('cd6e29f8-0a11-42c2-8f9d-e9e43c184571', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 21.970, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '27398588-df37-4408-bcec-69b408be2b4c', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('db5d3470-b4d0-4ade-95cd-0e011728a829', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 21.310, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '5424c729-723a-4606-9d2d-b73f2ba27b31', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('1d4794ee-d81a-45f3-a390-f40a7a9201c4', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 21.990, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '6ade91c0-d616-4ae3-b7c1-7f7cb2686961', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('701e6216-611f-45ac-acb5-835ae7a8b63a', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 21.720, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('98ca5072-2d7f-4708-ba76-0d16ba788ee5', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 22, 70.000, 13.966, 21.560, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '76e92779-2705-43b5-8e28-52fc9ad42ddd', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('8da677ae-5640-4834-9a60-14637f7aa3d4', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 23, 70.000, 13.966, 27.490, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '951904eb-60a6-44dd-aada-4be40146f2a0', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('80f9671e-e43d-4562-a932-e5d9cb654243', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 24, 70.000, 13.966, 24.930, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'b9e70323-4d3c-4d85-b37a-51408b20daef', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('e398ea74-d175-4577-8918-1669925cb34f', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 25, 70.000, 13.966, 25.400, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'c6e5e49c-01fd-4469-a215-e4b2f5ee6ad3', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('07980cd4-4761-4920-8b65-ed602a05f346', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 26, 70.000, 13.966, 27.510, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '1ab8f840-69cc-4d95-9bcc-2c3be1e8c85e', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('0eddb71f-c6e2-4014-81d3-b10cd44fb7a9', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 27, 70.000, 13.966, 27.200, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'f5bf1b94-6dc1-4be2-89a5-538cc18f919a', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('11ed9de7-1484-408d-a5e1-464aebfcedb1', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 28, 70.000, 13.966, 25.340, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'd25abbef-a7f0-4b6c-98ed-6931e074168b', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('c506844b-c6ce-44d1-baa9-d2a3e8659cb6', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 29, 70.000, 13.966, 26.410, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, '04219cc7-ef3f-4b30-9e31-cb5a207631ae', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('6551a5fb-9229-4aae-80d1-1386aa7f6e01', 'd6f6c9ac-194a-4bd6-844c-667f26b49fea', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 30, 70.000, 13.966, 26.650, '2026-08-05 11:26:40.845492+00', '2026-08-05 11:47:28.821867+00', NULL, 'afda74c6-be11-4edc-9c1e-e35a597508df', 'DEPARTED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('4fd457c4-3cff-463c-830c-c6c6e4ee87b9', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 24.680, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'RESERVED', NULL, NULL),
+	('4560512e-2fb6-4c2e-b933-ba2aac61dbdd', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 21.730, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'e4f95edb-21b6-482b-9b51-1af97edc2341', 'RESERVED', NULL, NULL),
+	('daf7f3e0-da84-4e24-9c97-1d5b03e529a8', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 21.400, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'RESERVED', NULL, NULL),
+	('e93f2a72-36a8-4100-acdf-9e0dbc2596c9', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 21.580, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'd25abbef-a7f0-4b6c-98ed-6931e074168b', 'RESERVED', NULL, NULL),
+	('c59f0faf-648d-498a-823d-9bd55657cd7b', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 21.880, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'f8e2efe7-8f72-4ced-9485-760f7e16b816', 'RESERVED', NULL, NULL),
+	('5f4f6224-833c-46c5-87b5-8112e14af593', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 21.910, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'f6463fb1-5e59-4eab-a3e5-dfb2ba9f51e0', 'RESERVED', NULL, NULL),
+	('b4029ab2-7e71-4933-80a4-680f5892c323', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 23.210, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'ae484bb2-59f3-4be3-b73e-3615ed8239fc', 'RESERVED', NULL, NULL),
+	('a012c15f-0bbe-40df-a5b5-30689b3c04ab', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 22.150, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '746dfb2c-9cc1-4475-b110-bd0d5efa31b8', 'RESERVED', NULL, NULL),
+	('27f6f0c5-49ac-4c64-b4e3-4b4b575ed981', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 20.300, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '24404f54-03b6-45ec-9cbe-227447b92976', 'RESERVED', NULL, NULL),
+	('be8c1ca3-102c-4245-90a2-f41a246e302f', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 26.930, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'c9f2906d-4e11-464f-922a-1b37bc95de15', 'RESERVED', NULL, NULL),
+	('218431ed-8489-4805-857b-4b18fda34046', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 21.680, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '98407c31-ec00-4b57-a96d-637cec1ed273', 'RESERVED', NULL, NULL),
+	('2bb3a365-20c1-49e1-bf66-77bd00d56f21', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 27.010, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '3712c6f2-e1f1-42fa-b16a-e3fb33c3622e', 'RESERVED', NULL, NULL),
+	('ebef5117-01ad-4a2c-90d6-12d4ffe759d2', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 21.960, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'a8b86f98-50ad-4258-88b5-3e700dbdcb21', 'RESERVED', NULL, NULL),
+	('2cf901fe-cbae-414f-bbcb-2231b9cf3f06', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 20.850, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '1f4f4542-f4b8-47ea-a868-281c04fca0f8', 'RESERVED', NULL, NULL),
+	('5befcf78-9f01-45e7-9f9a-dc7cca07cd7a', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 26.100, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'f5bf1b94-6dc1-4be2-89a5-538cc18f919a', 'RESERVED', NULL, NULL),
+	('d12e2beb-3a37-4f1a-81b8-4bb8a840d5d2', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 21.970, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '1ab8f840-69cc-4d95-9bcc-2c3be1e8c85e', 'RESERVED', NULL, NULL),
+	('c77a980a-4851-4878-a547-c20caf29ac6f', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 21.310, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'b9e70323-4d3c-4d85-b37a-51408b20daef', 'RESERVED', NULL, NULL),
+	('919272e8-c322-4fca-93fe-c5e19f955ec3', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 21.990, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'c6e5e49c-01fd-4469-a215-e4b2f5ee6ad3', 'RESERVED', NULL, NULL),
+	('659398d8-9ce7-4629-9f61-de65dcb8a894', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 21.720, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '04219cc7-ef3f-4b30-9e31-cb5a207631ae', 'RESERVED', NULL, NULL),
+	('eec85e05-28c0-46aa-91a7-0f18225f8a2d', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 21, 70.000, 13.966, 24.480, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'afda74c6-be11-4edc-9c1e-e35a597508df', 'RESERVED', NULL, NULL),
+	('d2e8f402-a322-4421-81f6-fe60fd155c63', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 22, 70.000, 13.966, 21.560, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '951904eb-60a6-44dd-aada-4be40146f2a0', 'RESERVED', NULL, NULL),
+	('671abb61-b204-4408-90f6-c4c284ef1ee9', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 23, 70.000, 13.966, 27.490, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '76e92779-2705-43b5-8e28-52fc9ad42ddd', 'RESERVED', NULL, NULL),
+	('5c09f678-4bef-484e-b381-ba1e8ab05b1a', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 24, 70.000, 13.966, 24.930, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '6ade91c0-d616-4ae3-b7c1-7f7cb2686961', 'RESERVED', NULL, NULL),
+	('c348957f-1b46-4a3a-8891-f4af2dcd6930', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 25, 70.000, 13.966, 25.400, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '5424c729-723a-4606-9d2d-b73f2ba27b31', 'RESERVED', NULL, NULL),
+	('67ab3271-330c-4f5c-9a5c-7c86b9a27f64', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 26, 70.000, 13.966, 27.510, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '27398588-df37-4408-bcec-69b408be2b4c', 'RESERVED', NULL, NULL),
+	('2e6ab4be-248a-478c-95fa-583b87adfdc6', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 27, 70.000, 13.966, 27.200, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '944cec65-290c-4adb-bf37-5bba91ecaab2', 'RESERVED', NULL, NULL),
+	('e5ea7384-e12a-450e-ac1e-951b6989d67c', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 28, 70.000, 13.966, 25.340, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '5cadc015-35dc-4f13-a1df-35bef3acd35f', 'RESERVED', NULL, NULL),
+	('ae84f134-d92c-4751-a4b1-3a4198f012f7', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 29, 70.000, 13.966, 26.410, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, '85e05351-b076-4121-b7b1-e07863f69f31', 'RESERVED', NULL, NULL),
+	('47121f3e-90e9-43b9-ac22-0a541f594d54', '2a90debe-87e5-4d7f-b03b-ad0dc22899f3', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 30, 70.000, 13.966, 26.650, '2026-08-07 06:08:41.811777+00', '2026-08-07 06:08:41.811777+00', NULL, 'a25bbcfd-a76c-47c4-80f4-5462f98eba3e', 'RESERVED', NULL, NULL),
+	('f7c6407f-4e7a-47ad-9951-602fe3b72c07', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'RESERVED', NULL, NULL),
+	('ffb0f798-5dc2-4a55-95a1-f5c21ed39799', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'e4f95edb-21b6-482b-9b51-1af97edc2341', 'RESERVED', NULL, NULL),
+	('01c744b2-6905-411c-a3d3-21d3db9b5840', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'RESERVED', NULL, NULL),
+	('131a76f7-cafa-438e-bbd1-db115a27ffee', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'd25abbef-a7f0-4b6c-98ed-6931e074168b', 'RESERVED', NULL, NULL),
+	('42219ecc-dcef-45b2-888c-07ed72acaf79', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 30.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'f8e2efe7-8f72-4ced-9485-760f7e16b816', 'RESERVED', NULL, NULL),
+	('80025c87-d7ff-4ffe-a00f-1de48e9640fb', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 40.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'f6463fb1-5e59-4eab-a3e5-dfb2ba9f51e0', 'RESERVED', NULL, NULL),
+	('e90928dc-7cce-4b18-8db4-f5f923c012ed', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'ae484bb2-59f3-4be3-b73e-3615ed8239fc', 'RESERVED', NULL, NULL),
+	('086418da-392b-4bbd-a467-7eff2c34782e', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 40.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '746dfb2c-9cc1-4475-b110-bd0d5efa31b8', 'RESERVED', NULL, NULL),
+	('bb3e7c8e-6bee-4fe9-9c66-9bbbfaa34206', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 10, 70.000, 13.966, 40.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '24404f54-03b6-45ec-9cbe-227447b92976', 'RESERVED', NULL, NULL),
+	('f094738f-7a6a-4f5c-b090-e8ca0a79416a', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 11, 70.000, 13.966, 30.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'c9f2906d-4e11-464f-922a-1b37bc95de15', 'RESERVED', NULL, NULL),
+	('f3b0573f-6afa-47ed-921c-37f7848869da', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 30.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '98407c31-ec00-4b57-a96d-637cec1ed273', 'RESERVED', NULL, NULL),
+	('d2da6ace-e4f7-494d-9a1d-b985de091af8', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '3712c6f2-e1f1-42fa-b16a-e3fb33c3622e', 'RESERVED', NULL, NULL),
+	('11cf57bc-2923-4e38-ba57-e0a5ba5e8bc5', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'a8b86f98-50ad-4258-88b5-3e700dbdcb21', 'RESERVED', NULL, NULL),
+	('6bcb24e7-2c7a-47f0-9272-1aa37e047db8', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '1f4f4542-f4b8-47ea-a868-281c04fca0f8', 'RESERVED', NULL, NULL),
+	('d80bab50-b9bd-46b5-8071-76f617939ba6', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 30.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'f5bf1b94-6dc1-4be2-89a5-538cc18f919a', 'RESERVED', NULL, NULL),
+	('290889b3-d27e-4a9b-988d-e580c9962e51', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 30.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '1ab8f840-69cc-4d95-9bcc-2c3be1e8c85e', 'RESERVED', NULL, NULL),
+	('d3249f4a-eb72-4872-a608-b0ef7ce277d7', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 30.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'b9e70323-4d3c-4d85-b37a-51408b20daef', 'RESERVED', NULL, NULL),
+	('f2a106c6-f489-4ba2-9ada-9ed120251bd8', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'c6e5e49c-01fd-4469-a215-e4b2f5ee6ad3', 'RESERVED', NULL, NULL),
+	('ed540fb0-0200-431f-9120-c4b70ccb3f0c', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, '04219cc7-ef3f-4b30-9e31-cb5a207631ae', 'RESERVED', NULL, NULL),
+	('62c4e6b1-226f-4279-9b0a-a62c580d2b2a', '7e076f85-0f80-4edc-9787-01129e2e46c4', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 21, 70.000, 13.966, 20.000, '2026-08-07 12:19:49.496601+00', '2026-08-07 12:19:49.496601+00', NULL, 'afda74c6-be11-4edc-9c1e-e35a597508df', 'RESERVED', NULL, NULL),
+	('9f848d33-4b1d-475e-88a6-9e0effd29653', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 7, 70.000, 13.966, 24.310, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'b034a5f5-8eff-4f31-bf89-945d920749fe', 'RESERVED', NULL, NULL),
+	('09e49321-516b-44db-a366-b1ca270a08b2', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 8, 70.000, 13.966, 21.490, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '898628d2-7195-49aa-aa05-7289781725ac', 'RESERVED', NULL, NULL),
+	('e8e3cec7-235f-4229-8204-cad678f98e87', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 9, 70.000, 13.966, 22.520, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'd3779672-5f85-4a03-a437-7ef6ec2097b2', 'RESERVED', NULL, NULL),
+	('9d5e540f-8744-4493-9e2e-ceb7f98e5061', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 1, 70.000, 13.966, 26.090, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'ee187bcb-a21d-49db-9102-96361dd65aa5', 'RESERVED', NULL, NULL),
+	('beae985d-f915-42a8-868f-3255d240d457', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 2, 70.000, 13.966, 20.920, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '273d5cdf-193f-494e-927a-f30e2e800ee3', 'RESERVED', NULL, NULL),
+	('8c8b5486-f776-4ffb-8960-a2351f81f55f', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 3, 70.000, 13.966, 20.850, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, 'd4138cab-df2f-4a7d-89ad-b57bf0e00c13', 'RESERVED', NULL, NULL),
+	('477af531-649e-4da0-a923-396c084d4ef9', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 4, 70.000, 13.966, 25.170, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'RESERVED', NULL, NULL),
+	('a20d2ebb-75b2-4e97-9f75-d872dd78ff97', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 5, 70.000, 13.966, 20.320, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '5852d1d2-0ae9-4e9d-923d-6e94e0978a25', 'RESERVED', NULL, NULL),
+	('75f06c3b-930d-426b-a7e7-cda472bde0da', 'ba774692-e3be-4107-a1e6-6a497950d371', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 6, 70.000, 13.966, 28.750, '2026-08-04 12:27:17.75889+00', '2026-08-05 11:07:50.488901+00', NULL, '8de9ad3b-fae0-499a-98ef-e5d5d2ee41d8', 'RESERVED', NULL, NULL),
+	('fcb93f4c-a2a6-41b4-b6ba-123efc9cd2c4', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 44, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '367c3556-02c5-4734-993f-27b4ef8c894d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('2641a9ba-514c-4a2c-ab66-9e4d5365f753', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 45, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'db81a283-27ef-470e-8697-bb99f2985e0c', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('7659e1b6-c7e9-4d34-8de8-0ff8b3e13b80', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 46, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'd0ef971b-de9a-4444-8f9b-be65a73383a8', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('c419c97e-da33-4e7b-afcb-5c43a29032ca', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 47, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'b0fd8345-e047-4869-ba3b-b5eee4d1509f', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('889c9aab-acac-44e0-87c4-396d11511d7a', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 48, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '1c4f1919-2c79-497b-9c57-92bad167d443', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('654037d2-90fa-47c0-a15d-2f81b533c4f9', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 49, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '5067bbde-7756-4ccd-b95f-654baba240c0', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('50942783-c256-4388-819d-264924073872', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 50, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '806727f8-afe7-4bcd-8764-d0b8a336fc1d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('e898c34f-a689-4a3a-b784-0d1cfd5e9c9f', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 12, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '5315a1c0-352f-4529-b88f-137077263a1d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('54d6d694-30c3-428a-bcb6-6a61fbebf792', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 13, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '8b068c04-b5d1-4f63-b404-168fb57305af', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('fca25b69-ff6f-4696-9322-b6bd27557d56', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 14, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '2f1348ee-a228-4fdb-a791-d8827bab8fd8', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('d7b71ff8-ddb8-45de-8412-0e5da4c45310', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 15, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '15541cca-4457-4f16-9291-3032d008faa4', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('23b97d96-218b-4b9f-a537-eefb35fd59d0', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 16, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'e875642e-1a0c-4916-9c30-afedc2bf6058', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('ed643919-ca72-40e1-a0f9-d88340c05265', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 17, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '9db9bf3d-2a4c-43cd-976b-b6dafe140865', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('4a380d25-1380-4e4a-91ff-cd4b56732a9e', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 18, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '343bd852-aaec-4858-a2ff-a3c126b0cb5b', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('716fe838-c0b7-40d0-888d-15b34dc097f9', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 19, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '21ad7cf5-8720-48ab-b07c-457d659f10df', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('ca92c11b-6456-4b99-8336-65082eb7556f', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 20, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '8198f44f-fbf7-4c17-b4c4-b243a78b51c9', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('628cd73e-46e7-4b98-b220-515bd2f34114', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 21, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'a2c86830-5db4-4cd4-99e6-85cdbf9f6979', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('e04e9511-1247-485e-ab75-26b0050d14a6', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 22, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '027c3412-c1ec-4f48-b65f-dc20b20db5c7', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('1ec8ea50-2e20-4a29-8d00-dbe5f8e22c49', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 23, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '9ad96e4c-285c-4b47-baec-ad9606680bff', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('ff189a77-8a02-401f-81f7-70fab67701f3', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 24, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'ebf5d985-02ee-4f64-a43c-c77c683e5479', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('740684e1-0c12-4b69-bbb5-19bd8ca854bb', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 25, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '7b88bd46-2870-4176-b292-ee2fce6fcb44', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('bbdc26b2-d6b1-4ea9-916b-1e4a99e461cb', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 26, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '20e7c481-34ac-4603-bb38-357383c55a9b', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('078dc0d6-46bd-4700-97a6-a2553bcc44e0', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 27, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'e4f95edb-21b6-482b-9b51-1af97edc2341', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('af894629-7c8a-4cae-8520-5d55c83de0f7', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 28, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '5cac0077-63b0-4022-9b7e-228a0391c3f3', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('1ccd1677-5afb-43c7-a2a8-94e241b4b6ae', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 29, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'd25abbef-a7f0-4b6c-98ed-6931e074168b', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('32cd9b7f-43c0-4c97-9d8e-0ddeb7a6dd01', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 30, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'a9e82d5a-4f14-413d-b226-f83f44900f8e', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('253edbb0-bc70-4478-8096-fbe5ed5c3239', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 31, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'c6d96337-5426-494e-a621-1603b0355c6c', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('97093045-54bc-427c-90a2-17f01c1ebbe2', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 32, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '00c04e2a-05e3-4d3f-8da3-fff944605273', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('2333ed74-af01-4721-be04-fbda17af8c9f', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 33, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '57ae3cba-d8dd-4507-a028-c89ea4702f3f', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('e04194a9-c55f-4b51-8823-2ace858d952d', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 34, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '49ec0541-df20-41b4-804c-bbd5f5f96e2f', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('2ce82955-698f-4f69-9f02-a5ae80163438', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 35, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '9ca2928c-add3-4acb-9354-6407fd5c7cd4', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('1d70301e-e17a-47e2-af94-3374c3d9bc05', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 36, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'a8292022-9346-4ea1-837a-8b3d7354a62c', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('fdfb4954-ca92-4e20-9218-bc173b4836ae', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 37, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '8d08acbc-aa83-4a0f-a59f-dece78afd2f1', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('c95577ec-cd06-4a9d-87b1-88c3ba0e0768', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 38, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'a512fb55-b960-4781-8a63-131bdab1184d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('78525fe4-c5f2-4c6f-951a-548e2f1dbf29', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 39, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '078db48b-a8ab-4acf-babc-0e5c8df538fa', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('3adef761-d42b-4641-904a-8aaa9641b1a6', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 40, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, '100fbb76-f62d-46a3-be30-ac79719f9ded', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('b541cc8c-8cd7-4fdb-b1d2-c120c80807e4', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 41, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'ac3442c2-05b9-4d13-a242-ee50caadeb9e', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a'),
+	('74654d38-10ae-4707-b5e1-be5b43cfcbd6', '8476735c-01cc-44b7-9c43-d59370f26f69', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 42, 70.000, 13.966, 20.000, '2026-07-18 16:54:51.24+00', '2026-07-18 16:54:51.24+00', NULL, 'b1848f29-5b8e-4af2-a633-e3979371881d', 'RESERVED', NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a');
+
+
+--
+-- Data for Name: train_sets; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.train_sets VALUES
+	('45cd3f95-b00c-42a8-812a-2c945271c44c', 'b67b7043-d216-4392-8313-7b43452e612d', 1035.200, 642.460, 46, 'DRAFT', '2026-08-07 07:54:42.670851+00', '2026-08-07 08:38:55.927275+00', NULL, '56eec969-55ec-4bc5-aad6-f4b7b6d17292'),
+	('62a426ca-52e7-4359-8a43-a8ac038638db', 'd6907984-bcfb-4408-b823-0fecc284f393', 146.000, 83.796, 6, 'ASSIGNED', '2026-08-07 08:02:18.250869+00', '2026-08-07 11:05:27.931018+00', NULL, '76671a28-3517-4f04-a903-32162959d615'),
+	('7e076f85-0f80-4edc-9787-01129e2e46c4', 'd6907984-bcfb-4408-b823-0fecc284f393', 540.000, 293.286, 21, 'ASSIGNED', '2026-08-06 07:09:19.925174+00', '2026-08-07 12:19:49.496601+00', NULL, '76671a28-3517-4f04-a903-32162959d615'),
+	('6d83b300-aa08-42bf-bcee-f0f1df37cde5', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 200.000, 51.198, 3, 'DISPATCHED', '2026-07-23 12:20:25.037+00', '2026-07-23 12:57:29.218+00', NULL, NULL),
+	('379c7434-f412-4a79-ae2d-e4740c63b49a', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 448.000, 119.462, 7, 'COMPLETED', '2026-07-23 07:53:11.819+00', '2026-07-23 09:28:22.689+00', NULL, NULL),
+	('e877c44e-9292-453d-bb28-616075071bb3', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 21.000, 13.966, 1, 'COMPLETED', '2026-07-23 07:51:41.716+00', '2026-07-23 09:13:52.451+00', NULL, NULL),
+	('f13ddc61-ec01-4991-bb1a-b8b525e2764e', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 1295.000, 324.254, 19, 'ASSIGNED', '2026-07-22 06:29:45.056+00', '2026-07-22 08:37:23.092+00', NULL, NULL),
+	('7b9d83fc-957d-4aed-85a2-7e9b5db111c3', 'dd55e3cc-6acf-4f5d-b85e-2c27d3132db9', 840.000, 642.436, 46, 'COMPLETED', '2026-07-21 08:44:06.202+00', '2026-07-21 13:21:00.98+00', NULL, NULL),
+	('d7604bf1-29ee-40f3-b054-b48f35b5f16f', '2dd03327-d9d5-4a08-af02-e59916ccea97', 0.000, 27.932, 2, 'ASSIGNED', '2026-07-20 11:11:12.51+00', '2026-07-21 06:58:17.167+00', NULL, NULL),
+	('21799060-5741-4416-81b8-0dda9e325e80', '2dd03327-d9d5-4a08-af02-e59916ccea97', 0.000, 41.898, 3, 'COMPLETED', '2026-07-18 06:52:10.897+00', '2026-07-20 06:40:37.847+00', NULL, NULL),
+	('88857e3d-8002-43c2-ba69-6ef2f96f6de7', 'ca503969-35b6-40d4-8787-690fd8715dda', 0.000, 0.000, 0, 'DRAFT', '2026-07-22 11:09:57.907+00', '2026-07-22 11:09:57.907+00', NULL, NULL),
+	('d226d18d-1a48-427b-8e51-236178d65a49', 'ca503969-35b6-40d4-8787-690fd8715dda', 0.000, 740.198, 53, 'COMPLETED', '2026-07-22 13:22:17.957+00', '2026-07-22 13:41:42.795+00', NULL, NULL),
+	('f9fdfe34-cad5-45c0-9d19-91bc0c89ebce', 'ca503969-35b6-40d4-8787-690fd8715dda', 0.000, 27.932, 2, 'COMPLETED', '2026-07-20 12:56:46.918+00', '2026-07-22 11:25:04.125+00', NULL, NULL),
+	('86f76fa6-bfc6-4c03-801c-c37e645c3010', 'ca503969-35b6-40d4-8787-690fd8715dda', 0.000, 0.000, 0, 'DRAFT', '2026-07-21 13:25:30.605+00', '2026-07-22 06:03:06.877+00', NULL, NULL),
+	('065de839-5edb-4a08-ae6e-d1142579fd99', '5eeb26b1-0631-4870-ab4f-352ac49cf8d1', 24.000, 13.966, 1, 'ASSIGNED', '2026-07-21 05:57:50.914+00', '2026-07-23 14:02:20.291+00', NULL, NULL),
+	('fa0d99de-c596-44e0-a137-551cef7399b5', '0b48c5d6-0360-49b1-b4c9-433eb1cd1a87', 0.000, 0.000, 0, 'DRAFT', '2026-07-20 11:37:38.394+00', '2026-07-20 11:37:38.394+00', NULL, NULL),
+	('7ae66722-c16f-43a2-aa0c-1c28c1c81898', 'd6907984-bcfb-4408-b823-0fecc284f393', 0.000, 0.000, 0, 'DRAFT', '2026-08-07 08:01:31.382496+00', '2026-08-07 08:01:31.382496+00', NULL, '76671a28-3517-4f04-a903-32162959d615'),
+	('b8827cf5-99d5-4ecf-8939-1e7ad7e660d0', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0.000, 0.000, 0, 'DRAFT', '2026-07-19 18:49:42.372+00', '2026-07-19 18:49:42.372+00', NULL, NULL),
+	('8476735c-01cc-44b7-9c43-d59370f26f69', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 220.000, 698.300, 50, 'COMPLETED', '2026-07-17 21:34:19.872+00', '2026-07-18 16:58:50.735+00', NULL, NULL),
+	('dfb01a05-181d-4105-87be-d3e7d14bf31c', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0.000, 0.000, 0, 'DRAFT', '2026-07-22 11:01:10.338+00', '2026-07-22 11:01:10.338+00', NULL, NULL),
+	('83a0229a-8975-4b9b-a97f-7b3004215aef', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0.000, 41.898, 3, 'CANCELLED', '2026-07-20 06:58:42.624+00', '2026-07-20 11:16:16.322+00', NULL, NULL),
+	('f3af584a-51cb-4683-b9d0-f6ce3503894e', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0.000, 293.286, 21, 'ASSIGNED', '2026-07-18 17:16:00.198+00', '2026-07-21 17:16:01.803+00', NULL, NULL),
+	('f3e40915-ff4c-4db3-9a45-ca4b2b56fce5', 'a882b4bd-ef9c-4d0b-bba9-3a3197b1fe4b', 0.000, 0.000, 0, 'DRAFT', '2026-07-23 14:51:39.728+00', '2026-07-23 14:51:39.728+00', NULL, NULL),
+	('892ed0d9-60d8-4508-a33c-6e053cf7ddc2', 'b34a62e0-a4a9-4563-83d6-9e2206b74b10', 0.000, 13.966, 1, 'COMPLETED', '2026-07-18 06:22:56.277+00', '2026-07-18 06:44:29.418+00', NULL, NULL),
+	('e505ad7b-7d27-4d6b-bac6-c1ec7d3ca44d', '2dd03327-d9d5-4a08-af02-e59916ccea97', 158.000, 83.796, 6, 'ASSIGNED', '2026-08-01 07:46:34.634417+00', '2026-08-01 09:40:07.41296+00', NULL, NULL),
+	('2a90debe-87e5-4d7f-b03b-ad0dc22899f3', 'd6907984-bcfb-4408-b823-0fecc284f393', 707.580, 418.980, 30, 'ASSIGNED', '2026-08-06 07:07:10.980795+00', '2026-08-07 06:08:41.811777+00', NULL, '76671a28-3517-4f04-a903-32162959d615'),
+	('3b753131-834f-4763-892e-a8f4a8ca837c', 'dc23c9a3-5004-4145-807e-6240b415595e', 448.000, 279.320, 20, 'ASSIGNED', '2026-07-22 07:50:00.012+00', '2026-08-01 08:10:45.555755+00', NULL, NULL),
+	('0c11098b-3d44-44f6-b90a-574e9fabfb40', 'ca503969-35b6-40d4-8787-690fd8715dda', 0.000, 0.000, 0, 'DRAFT', '2026-08-01 08:12:08.843992+00', '2026-08-01 08:12:08.843992+00', NULL, NULL),
+	('6b113c6c-9f5c-4052-a61f-346a7746f641', 'ca503969-35b6-40d4-8787-690fd8715dda', 0.000, 0.000, 0, 'DRAFT', '2026-08-01 13:03:45.741808+00', '2026-08-01 13:03:45.741808+00', NULL, NULL),
+	('13a077a6-56e8-4fc1-997c-342787f814bd', 'ca503969-35b6-40d4-8787-690fd8715dda', 1195.900, 753.980, 53, 'DRAFT', '2026-08-04 06:58:42.499476+00', '2026-08-04 07:11:21.955621+00', NULL, NULL),
+	('43be694a-48fc-4c14-8b13-cded4791ec63', 'ca503969-35b6-40d4-8787-690fd8715dda', 50.000, 79.018, 5, 'ASSIGNED', '2026-08-02 11:57:57.394811+00', '2026-08-02 21:48:51.413136+00', NULL, NULL),
+	('d6f6c9ac-194a-4bd6-844c-667f26b49fea', 'ca503969-35b6-40d4-8787-690fd8715dda', 707.580, 418.980, 30, 'COMPLETED', '2026-08-05 11:18:48.962975+00', '2026-08-05 11:47:31.805259+00', NULL, NULL),
+	('ba774692-e3be-4107-a1e6-6a497950d371', 'ca503969-35b6-40d4-8787-690fd8715dda', 709.500, 418.980, 30, 'CANCELLED', '2026-08-04 11:28:19.986023+00', '2026-08-06 05:33:35.463539+00', NULL, NULL),
+	('37a3cdde-377c-4cbf-ae1f-9571034024e2', 'ca503969-35b6-40d4-8787-690fd8715dda', 564.500, 153.626, 11, 'CANCELLED', '2026-08-04 12:12:58.232085+00', '2026-08-06 05:33:38.619926+00', NULL, NULL),
+	('6838d0a3-66da-434e-8ba1-3597e3948006', '87662a07-2c7b-45c5-a4ff-c89fb9bc105c', 0.000, 0.000, 0, 'DRAFT', '2026-08-07 07:59:41.542479+00', '2026-08-07 07:59:41.542479+00', NULL, '0da257e0-c825-4104-822b-82f27aa2c710'),
+	('bd5ba4e0-ab2b-48d3-acd4-79dc73336793', 'd6907984-bcfb-4408-b823-0fecc284f393', 0.000, 0.000, 0, 'DRAFT', '2026-08-07 08:01:06.455736+00', '2026-08-07 08:01:06.455736+00', NULL, '76671a28-3517-4f04-a903-32162959d615');
+
+
+--
+-- Data for Name: trains; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.trains VALUES
+	('6de97a77-dbf1-4099-92ea-295416ab0d97', 'TR-00004', 3500.00, 'AVAILABLE', NULL, '2026-08-07 08:41:48.883013+00', '2026-08-07 08:41:48.883013+00', NULL, NULL, '498M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9002', '9001'),
+	('7217d519-4204-43ca-aef1-3e86f3ec240b', 'TR-00005', 3500.00, 'AVAILABLE', NULL, '2026-08-07 10:45:57.982977+00', '2026-08-07 10:45:57.982977+00', NULL, NULL, '507M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8202', '8201'),
+	('1064cee0-359d-4fa6-9157-975be624f378', 'TR-00006', 3500.00, 'AVAILABLE', NULL, '2026-08-07 11:20:58.845314+00', '2026-08-07 11:20:58.845314+00', NULL, NULL, '517M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8302', '8301'),
+	('0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 'TR-00007', 3500.00, 'AVAILABLE', NULL, '2026-08-07 12:33:42.219594+00', '2026-08-07 12:33:42.219594+00', NULL, NULL, '509M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8502', '8501'),
+	('2012fe72-e966-404d-a5c4-f43ac0e5a767', 'TR-00008', 3500.00, 'AVAILABLE', NULL, '2026-08-07 13:01:06.938962+00', '2026-08-07 13:01:06.938962+00', NULL, NULL, '496M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8602', '8601'),
+	('91c02bb9-0f91-46ee-9272-9eecf28734d9', 'TR-00009', 3500.00, 'AVAILABLE', NULL, '2026-08-07 13:38:21.83353+00', '2026-08-07 13:38:21.83353+00', NULL, NULL, 'V506M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8702', '8701'),
+	('56eec969-55ec-4bc5-aad6-f4b7b6d17292', 'TR-00002', 3500.00, 'AVAILABLE', NULL, '2026-08-07 07:18:16.026107+00', '2026-08-07 07:54:42.670851+00', NULL, NULL, '497M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8102', '8101'),
+	('0da257e0-c825-4104-822b-82f27aa2c710', 'TR-00003', 3500.00, 'AVAILABLE', NULL, '2026-08-07 07:57:18.217074+00', '2026-08-07 07:59:41.542479+00', NULL, NULL, '0099', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '8402', '8401'),
+	('76671a28-3517-4f04-a903-32162959d615', 'TR-00001', 3500.00, 'AVAILABLE', NULL, '2026-08-06 06:53:26.770184+00', '2026-08-07 08:02:18.250869+00', NULL, NULL, '8001', NULL, NULL, NULL, NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8002', '8001'),
+	('de4eac6f-3138-4cd7-a3a3-471fc8807fac', 'TR-00010', 3500.00, 'AVAILABLE', NULL, '2026-08-07 13:59:31.242735+00', '2026-08-07 19:54:54.21487+00', NULL, NULL, 'V531M', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8802', '8801');
+
+
+--
+-- Data for Name: transit_agents; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.transit_agents VALUES
+	('22183a4c-599d-4fcd-a6cc-4b2cbf6ed6de', 'Oriental Transit', '2026-08-06', '2026-12-31', true, '2026-08-06 16:16:11.954564+00', '2026-08-06 16:16:11.954564+00', NULL),
+	('bf658707-6480-4c47-addd-c7cb4e229f0c', 'Universal Cargo', '2026-08-06', '2026-12-31', true, '2026-08-06 16:16:33.630205+00', '2026-08-06 16:16:33.630205+00', NULL),
+	('f9ade730-3f12-412f-87fa-88fc3b6e2d65', 'Melidien Star', '2026-08-06', '2026-12-31', true, '2026-08-06 16:16:58.97166+00', '2026-08-06 16:16:58.97166+00', NULL),
+	('d20f5c7a-d985-4e75-a71a-9d9b2bd4a118', 'Go Transit', '2026-08-06', '2026-12-31', true, '2026-08-06 16:17:18.935579+00', '2026-08-06 16:17:18.935579+00', NULL),
+	('06f9cbb1-e7eb-45fa-8bd7-ad8500988e0f', 'Garani Transit', '2026-08-06', '2026-12-31', true, '2026-08-06 16:17:41.906199+00', '2026-08-06 16:17:41.906199+00', NULL),
+	('58622e22-3c82-442d-9859-1ed692c74c18', 'Houda Transit', '2026-08-06', '2026-12-31', true, '2026-08-06 16:18:02.86518+00', '2026-08-06 16:18:02.86518+00', NULL),
+	('1746df49-ebeb-4060-bed3-7ca8b2bac4c5', 'Djib Transit', '2026-08-06', '2026-12-31', true, '2026-08-06 16:18:27.227506+00', '2026-08-06 16:18:27.227506+00', NULL),
+	('ade2c660-df4f-4832-8fd7-f58e007ff391', 'Roukia Trasnit', '2026-08-06', '2026-12-31', true, '2026-08-06 16:18:44.920704+00', '2026-08-06 16:18:44.920704+00', NULL);
+
+
+--
+-- Data for Name: truck_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.truck_types VALUES
+	('222fa042-636e-4d72-8fe0-17f9ff850857', 'BUS', 'Bus', NULL, false, NULL, true, '2026-07-27 11:32:03.969479+00', '2026-08-04 08:24:14.32059+00', '2026-08-04 08:24:14.32059+00'),
+	('675bbcea-12e5-474e-b256-f2f914fbb885', 'CAR', 'Car', NULL, false, NULL, true, '2026-07-27 11:32:03.969479+00', '2026-08-04 08:24:18.956021+00', '2026-08-04 08:24:18.956021+00'),
+	('118c3347-e94f-4b72-95b8-d084419419fd', 'CASONI', 'Casoni (rigid, no trailer)', NULL, false, NULL, true, '2026-07-27 11:32:03.969479+00', '2026-08-04 08:24:27.95239+00', '2026-08-04 08:24:27.95239+00'),
+	('5ab50abe-c574-4a28-9c2a-4df2b42c736d', 'VAN', 'Van', NULL, false, NULL, true, '2026-07-27 11:32:03.969479+00', '2026-08-04 08:24:35.713145+00', '2026-08-04 08:24:35.713145+00'),
+	('77e54cee-d496-4ae6-8df5-1f320d27176b', 'FLATBED', 'Flatbed', NULL, true, NULL, true, '2026-07-27 11:32:03.969479+00', '2026-08-04 08:24:43.952177+00', '2026-08-04 08:24:43.952177+00'),
+	('04bf40e6-4a13-4e40-9f08-3c6a7c152ea8', 'TANKER', 'Tanker', NULL, true, NULL, true, '2026-07-27 11:32:03.969479+00', '2026-08-04 08:24:49.551548+00', '2026-08-04 08:24:49.551548+00'),
+	('1df6f451-aadf-4164-978c-8575305625bd', 'DOUBLE TRAILER TRUCK', 'Double Trailer Truck', NULL, true, 'It has extra trailer', true, '2026-07-27 11:32:03.969479+00', '2026-08-05 12:41:59.49181+00', '2026-08-05 12:41:59.49181+00'),
+	('6dec4dd6-49cd-4cad-b637-631296dd58dd', 'TRAILER TRUCK', 'Trailer Truck', NULL, false, 'A single trailer truck', true, '2026-07-27 11:32:03.969479+00', '2026-08-05 12:42:03.155022+00', '2026-08-05 12:42:03.155022+00'),
+	('826a6d51-379d-43d5-951a-8b2447f701c6', 'HEAVY', 'Heavy Truck', 50.000, true, NULL, true, '2026-08-05 12:43:56.050373+00', '2026-08-05 14:38:42.855394+00', NULL),
+	('c350f58b-d6a2-4c08-be11-ffa07c72de7c', 'HIGHBED', 'Highbed', 40.000, false, NULL, true, '2026-08-07 19:40:26.647308+00', '2026-08-07 19:42:20.571018+00', '2026-08-07 19:42:20.571018+00');
+
+
+--
+-- Data for Name: user_trade_access; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: vehicles; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.vehicles VALUES
+	('294bc25c-95ca-4675-bee6-e872fdf8b4fb', 'AA-45866', 'REG-HEAVY-1785940245891', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 14:30:45.891293', '2026-08-05 17:42:45.9581', NULL, NULL, NULL, '03-ET', NULL, 'AA-43470', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('92513375-9583-4744-81e6-e1e68ea7082d', 'AA-45853', 'REG-HEAVY-1785940417882', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 14:33:37.882901', '2026-08-05 17:43:09.646499', NULL, NULL, NULL, '03-ET', NULL, 'AA-43508', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('95e19092-3412-4458-a28b-c0572e0c2c42', 'AA-45842', 'REG-HEAVY-1785945951782', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:05:51.782353', '2026-08-05 16:05:51.782353', NULL, NULL, NULL, '03-ET', NULL, 'AA-43478', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('84ca7af7-b994-469a-b521-4db3f1963ba4', 'AA-45833', 'REG-HEAVY-1785947559192', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:32:39.192822', '2026-08-05 16:32:39.192822', NULL, NULL, NULL, '03-ET', NULL, 'AA-43466', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('c905c143-315f-4e2c-b6e8-cdb56f9b3088', 'AA-45858', 'REG-HEAVY-1785947735958', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:35:35.958595', '2026-08-05 16:35:35.958595', NULL, NULL, NULL, '03-ET', NULL, 'AA-43496', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('91bb9f54-77a8-47a5-b432-cb60440ba4ba', 'AA-45819', 'REG-HEAVY-1785947809032', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:36:49.032955', '2026-08-05 16:36:49.032955', NULL, NULL, NULL, '03-ET', NULL, 'AA-43474', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('7a33a5de-9da3-4d54-834b-6be2fc99b3a8', 'AA-45834', 'REG-HEAVY-1785947887849', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:38:07.849179', '2026-08-05 16:38:07.849179', NULL, NULL, NULL, '03-ET', NULL, 'AA-43502', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('ac8f6961-d6cf-46aa-b4d1-de0b87374f96', 'AA-45868', 'REG-HEAVY-1785947977832', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:39:37.832321', '2026-08-05 16:39:37.832321', NULL, NULL, NULL, '03-ET', NULL, 'AA-43469', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('33f63787-6f30-4dcd-a112-1cc544599c20', 'AA-45831', 'REG-HEAVY-1785948104873', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:41:44.874099', '2026-08-05 16:41:44.874099', NULL, NULL, NULL, '03-ET', NULL, 'AA-43488', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('c113c9b1-25ab-445a-b4bd-9c72bd22cfb2', 'AA-45828', 'REG-HEAVY-1785948218792', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:43:38.793298', '2026-08-05 16:43:38.793298', NULL, NULL, NULL, '03-ET', NULL, 'AA-43479', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('93df8793-a138-4c21-a807-34907ae051a5', 'AA-45850', 'REG-HEAVY-1785948296254', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:44:56.254752', '2026-08-05 16:44:56.254752', NULL, NULL, NULL, '03-ET', NULL, 'AA-43505', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('87b9e7e5-bc57-45a4-a934-c4f55224fbdc', 'AA-45823', 'REG-HEAVY-1785948343225', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:45:43.225759', '2026-08-05 16:45:43.225759', NULL, NULL, NULL, '03-ET', NULL, 'AA-43480', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('cb5e81f6-2211-4336-8431-6f37e37c0da4', 'AA-45838', 'REG-HEAVY-1785948388778', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:46:28.778481', '2026-08-05 16:46:28.778481', NULL, NULL, NULL, '03-ET', NULL, 'AA-43472', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('aaaa9f71-dcd8-452a-b911-44f18aa234c6', 'AA-45854', 'REG-HEAVY-1785948437778', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:47:17.778816', '2026-08-05 16:47:17.778816', NULL, NULL, NULL, '03-ET', NULL, 'AA-43500', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('5224eb6d-54e5-4c36-8505-ffbd074f3cbf', 'AA-45839', 'REG-HEAVY-1785948504740', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:48:24.741209', '2026-08-05 16:48:24.741209', NULL, NULL, NULL, '03-ET', NULL, 'AA-43486', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('4966dadd-bc41-4b15-a2e0-a31e9bd3c2d8', 'AA-45861', 'REG-HEAVY-1785948776746', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:52:56.746696', '2026-08-05 16:52:56.746696', NULL, NULL, NULL, '03-ET', NULL, 'AA-43513', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('d949060c-fea5-4961-959b-b3a2ac42087c', 'AA-45830', 'REG-HEAVY-1785948846938', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:54:06.938701', '2026-08-05 16:54:06.938701', NULL, NULL, NULL, '03-ET', NULL, 'AA-43501', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('8ca7c3ef-7fae-4b4c-a194-2f20bdd16130', 'AA-45826', 'REG-HEAVY-1785948896138', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:54:56.13877', '2026-08-05 16:54:56.13877', NULL, NULL, NULL, '03-ET', NULL, 'AA-43498', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('c571c4cc-2f86-4c08-8f69-dddf15ae945b', 'AA-45836', 'REG-HEAVY-1785949178249', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:59:38.249653', '2026-08-05 16:59:38.249653', NULL, NULL, NULL, '03-ET', NULL, 'AA-43467', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('a6278d2b-7cb7-4b6a-9983-c38702ded81d', 'AA-45822', 'REG-HEAVY-1785949414993', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:03:34.99402', '2026-08-05 17:03:34.99402', NULL, NULL, NULL, '03-ET', NULL, 'AA-43512', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('bc65640b-400e-4102-9847-93fe19dfda5f', 'AA-45821', 'REG-HEAVY-1785949471076', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:04:31.076688', '2026-08-05 17:04:31.076688', NULL, NULL, NULL, '03-ET', NULL, 'AA-43210', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('f3da22a3-b16a-4915-a5d6-81d8df259673', 'AA-45837', 'REG-HEAVY-1785949543305', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:05:43.306141', '2026-08-05 17:05:43.306141', NULL, NULL, NULL, '03-ET', NULL, 'AA-43475', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('7e64a16b-2ff1-4fef-b667-719f2a5006a6', 'AA-45860', 'REG-HEAVY-1785949604177', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:06:44.1779', '2026-08-05 17:06:44.1779', NULL, NULL, NULL, '03-ET', NULL, 'AA-43497', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('cffd972a-daed-4305-9c40-3fb5b917022d', 'AA-45863', 'REG-HEAVY-1785949681245', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:08:01.246008', '2026-08-05 17:08:01.246008', NULL, NULL, NULL, '03-ET', NULL, 'AA-43477', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('11341e3a-1002-45f3-9e18-f4ebfca88e7e', 'AA-45825', 'REG-HEAVY-1785949735443', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:08:55.443161', '2026-08-05 17:08:55.443161', NULL, NULL, NULL, '03-ET', NULL, 'AA-43483', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('913599ef-7e19-4b9a-92cd-36ec2f657bf5', 'AA-45829', 'REG-HEAVY-1785949786016', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:09:46.016391', '2026-08-05 17:09:46.016391', NULL, NULL, NULL, '03-ET', NULL, 'AA-43473', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('5a6b8e20-12b8-44ec-ada6-0ee1eea1cd8e', 'AA-45824', 'REG-HEAVY-1785949909688', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:11:49.68894', '2026-08-05 17:11:49.68894', NULL, NULL, NULL, '03-ET', NULL, 'AA-43491', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('49122e35-3c86-4dd1-893e-830372239adb', 'AA-45849', 'REG-HEAVY-1785941012270', 'HEAVY', 'Volvo Group', 'Volvo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 14:43:32.270726', '2026-08-05 17:44:12.176468', NULL, NULL, NULL, '03-ET', NULL, 'AA-43414', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('49f3a4f2-b177-4123-a7a9-871781ff663b', 'AA-45845', 'REG-HEAVY-1785945627614', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:00:27.615063', '2026-08-05 17:44:34.219249', NULL, NULL, NULL, '03-ET', NULL, 'AA-43492', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('ab8cc367-eb4a-4de8-8be3-7a2ca6df340a', 'AA-45820', 'REG-HEAVY-1785945856499', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:04:16.499977', '2026-08-05 17:44:56.314949', NULL, NULL, NULL, '03-ET', NULL, 'AA-43487', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('97491a2f-f511-48a9-a150-1d5e498ea89e', 'AA-45855', 'REG-HEAVY-1785947341353', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:29:01.35408', '2026-08-05 17:45:28.960114', NULL, NULL, NULL, '03-ET', NULL, 'AA-43485', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('a0733ec0-c636-49d5-a903-bda3ef3a2371', 'AA-45865', 'REG-HEAVY-1785946970131', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:22:50.131595', '2026-08-05 17:45:42.680673', NULL, NULL, NULL, '03-ET', NULL, 'AA-43490', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('06828fba-de91-4ec1-9664-037e5e9b3fd5', 'AA-45856', 'REG-HEAVY-1785946754244', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:19:14.244671', '2026-08-05 17:45:55.804217', NULL, NULL, NULL, '03-ET', NULL, 'AA-43510', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('04a31aab-2ad8-4b77-b1ec-8c5da70bdbe6', 'AA-45832', 'REG-HEAVY-1785946581009', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:16:21.01016', '2026-08-05 17:46:21.217077', NULL, NULL, NULL, '03-ET', NULL, 'AA-43504', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('fa416fbd-441d-4348-803f-b197527dad83', 'AA-45841', 'REG-HEAVY-1785946483432', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:14:43.432561', '2026-08-05 17:46:42.009675', NULL, NULL, NULL, '03-ET', NULL, 'AA-43515', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('d15a78d0-dead-4ccc-9e9b-3a32ed0926e3', 'AA-45840', 'REG-HEAVY-1785947406180', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:30:06.180913', '2026-08-05 17:47:15.727452', NULL, NULL, NULL, '03-ET', NULL, 'AA-43499', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('c2662107-ce84-4de1-b142-3fef6aea370a', 'AA-45867', 'REG-HEAVY-1785947474272', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 16:31:14.273117', '2026-08-05 17:47:35.236709', NULL, NULL, NULL, '03-ET', NULL, 'AA-43493', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('6ef488d3-4f44-47ad-b49d-3d9d851ff892', 'AA-45827', 'REG-HEAVY-1785950061004', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:14:21.004228', '2026-08-05 17:14:21.004228', NULL, NULL, NULL, '03-ET', NULL, 'AA-43468', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('5af07fa9-32b2-43e8-b30e-a2f90826f1b0', 'AA-45847', 'REG-HEAVY-1785950279277', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:17:59.278068', '2026-08-05 17:17:59.278068', NULL, NULL, NULL, '03-ET', NULL, 'AA-43511', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('42c60171-8b07-4019-a30a-9b4c48a6ba75', 'AA-45852', 'REG-HEAVY-1785950337333', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:18:57.333665', '2026-08-05 17:18:57.333665', NULL, NULL, NULL, '03-ET', NULL, 'AA-43484', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('39c84f4a-b615-420d-a0d1-8a4f33259864', 'AA-45835', 'REG-HEAVY-1785950434197', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:20:34.197992', '2026-08-05 17:20:34.197992', NULL, NULL, NULL, '03-ET', NULL, 'AA-43482', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('36ce4dc0-3d15-41e2-a4c9-a82262bb9cbe', 'AA-45864', 'REG-HEAVY-1785950509196', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:21:49.196196', '2026-08-05 17:21:49.196196', NULL, NULL, NULL, '03-ET', NULL, 'AA-43503', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('20ecc5a2-6c14-47b6-92ea-c12b15b636f0', 'AA-45862', 'REG-HEAVY-1785950652993', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:24:12.993877', '2026-08-05 17:24:12.993877', NULL, NULL, NULL, '03-ET', NULL, 'AA-43465', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('5264b2f3-447e-4406-9c4d-907f2034318e', 'AA-39097', 'REG-HEAVY-1785950970773', 'HEAVY', 'Volvo Group', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:29:30.773227', '2026-08-05 17:29:30.773227', NULL, NULL, NULL, '03-ET', NULL, 'AA-41226', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('2e9b8489-1196-4a42-a32f-e49348da5b49', 'AA-39104', 'REG-HEAVY-1785951021890', 'HEAVY', 'Volvo Group', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:30:21.89106', '2026-08-05 17:30:21.89106', NULL, NULL, NULL, '03-ET', NULL, 'AA-41225', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('83c05b69-2248-4a54-b3d1-eec4e1a42008', 'AA-39103', 'REG-HEAVY-1785951063602', 'HEAVY', 'Volvo Group', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:31:03.602472', '2026-08-05 17:31:03.602472', NULL, NULL, NULL, '03-ET', NULL, 'AA-41223', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('e36d1b03-048f-4d4d-810c-da79e9a4d054', 'AA-39106', 'REG-HEAVY-1785951110010', 'HEAVY', 'Volvo Group ', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:31:50.010618', '2026-08-05 17:31:50.010618', NULL, NULL, NULL, '03-ET', NULL, 'AA-41221', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('76bc369c-b36e-479b-b72c-35f0bb127c7f', 'AA-39107', 'REG-HEAVY-1785951166931', 'HEAVY', 'Volvo Group', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:32:46.932109', '2026-08-05 17:32:46.932109', NULL, NULL, NULL, '03-ET', NULL, 'AA-41215', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('5e400431-1829-4cf6-bdfa-9db95fec4244', 'AA-39094', 'REG-HEAVY-1785951215832', 'HEAVY', 'Volvo Group', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:33:35.832423', '2026-08-05 17:33:35.832423', NULL, NULL, NULL, '03-ET', NULL, 'AA-41222', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('9e02e13c-5b92-46e1-a749-38531079078c', 'AA-39099', 'REG-HEAVY-1785951298883', 'HEAVY', 'Volvo Group', 'Vovlo FH410', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:34:58.883876', '2026-08-05 17:34:58.883876', NULL, NULL, NULL, '03-ET', NULL, 'AA-41216', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('dad2ffc9-9bab-4e55-a761-e850bbe5f371', 'AA-39092', 'REG-HEAVY-1785951426439', 'HEAVY', 'Volvo Group', 'Vovlo FH410', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:37:06.439354', '2026-08-05 17:37:06.439354', NULL, NULL, NULL, '03-ET', NULL, 'AA-41224', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('f9e21b8a-fdce-4242-944c-e518f21fc0f9', 'AA-31801', 'REG-HEAVY-1785951502365', 'HEAVY', 'Volvo Group', 'Vovlo FH410', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:38:22.365604', '2026-08-05 17:38:22.365604', NULL, NULL, NULL, '03-ET', NULL, 'AA-41214', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('2c03bce2-6508-485c-b843-50b4fe2220d0', 'AA-39098', 'REG-HEAVY-1785950761306', 'HEAVY', 'Volvo Group', 'Vovlo FH400', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:26:01.306401', '2026-08-05 17:39:59.263282', NULL, NULL, NULL, '03-ET', NULL, 'AA-41220', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('8162f80b-70c1-4564-9e14-19b3354e1b32', 'AA-39105', 'REG-HEAVY-1785950715202', 'HEAVY', 'Volvo Group', 'Vovlo FH400', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:25:15.202682', '2026-08-05 17:40:40.607501', NULL, NULL, NULL, '03-ET', NULL, 'AA-41218', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('c6e0343a-56a0-432b-aa8f-b3b85626d81c', 'AA-45843', 'REG-HEAVY-1785940178746', 'HEAVY', 'Volvo Group', 'Vovol FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 14:29:38.746433', '2026-08-05 17:42:08.985513', NULL, NULL, NULL, '03-ET', NULL, 'AA-43495', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('d90a158b-09b0-43c6-ace4-beb337505d97', 'AA-45857', 'REG-HEAVY-1785949959720', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:12:39.720333', '2026-08-05 17:48:02.848168', NULL, NULL, NULL, '03-ET', NULL, 'AA-43481', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('14302866-dcf2-435a-8f9b-523559bfd88e', 'AA-45851', 'REG-HEAVY-1785950006234', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:13:26.234976', '2026-08-05 17:48:16.462785', NULL, NULL, NULL, '03-ET', NULL, 'AA-43509', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('dcf2910c-be05-4841-9b41-065d0179409e', 'AA-45844', 'REG-HEAVY-1785950379084', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:19:39.084165', '2026-08-05 17:49:18.334067', NULL, NULL, NULL, '03-ET', NULL, 'AA-43476', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('6ebd1d6b-6328-4534-9aca-f5b8bf9c6a60', 'AA-45848', 'REG-HEAVY-1785950601085', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:23:21.0854', '2026-08-05 17:49:32.328326', NULL, NULL, NULL, '03-ET', NULL, 'AA-43494', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('5a229b50-b651-40fc-a61a-cc461e2284c4', 'AA-29900', 'REG-HEAVY-1785950865626', 'HEAVY', 'Volvo Group', 'Vovlo FH440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:27:45.626988', '2026-08-05 18:05:11.063405', NULL, NULL, NULL, '03-ET', NULL, 'AA-41865', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('8b12b9c5-456d-47dd-aba8-f4e867a25053', 'AA-45846', 'REG-HEAVY-1785950233138', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:17:13.139035', '2026-08-05 18:05:46.668638', NULL, NULL, NULL, '03-ET', NULL, 'AA-43471', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6'),
+	('4da7a933-b753-4998-a2ea-811850568248', 'AA-45859', 'REG-HEAVY-1785950134405', 'HEAVY', 'Volvo Group', 'Vovlo FMX440', 2026, 'DIESEL', 50, 'ACTIVE', NULL, '2026-08-05 17:15:34.405988', '2026-08-05 18:06:21.42113', NULL, NULL, NULL, '03-ET', NULL, 'AA-43887', NULL, NULL, NULL, 'FREE', NULL, 'OWNED', NULL, NULL, NULL, 0.00, 'ETB', '826a6d51-379d-43d5-951a-8b2447f701c6');
+
+
+--
+-- Data for Name: vendors; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_allocation_bulk_loads; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_allocation_container_items; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_booking_allocations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_movements; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_status_logs; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_transfer_requests; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: wagon_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.wagon_types VALUES
+	('f4ba54be-002f-46cb-af7c-ff55ed84dcdd', 'NW7', 'Double deck sedan wagon', 22.000, 26.066, '{vehicles,sedan}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, NULL, 37.100, false, NULL),
+	('8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'NW5', 'Flat wagon', 70.000, 13.966, '{container,steel,machinery}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, 1.300, 22.400, true, 30.480),
+	('8eec3a7d-8482-4397-96b6-59a028210722', 'PW2', 'Box wagon', 70.000, 17.066, '{"general cargo","break bulk"}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, 1.600, 25.200, false, NULL),
+	('07c38e9a-7627-4be9-af41-7651957aca3d', 'GW2', 'Tank wagon', 70.000, 12.228, '{liquid,fuel}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, NULL, 23.000, false, NULL),
+	('efed186d-7062-4b0f-b3fe-6e793accc364', 'CW3', 'Gondola open wagon', 70.000, 13.976, '{"open bulk cargo"}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, 1.300, 23.400, false, NULL),
+	('df1708d4-35dd-4ce2-aa73-f5061e534df7', 'KW2', 'Hopper covered wagon', 69.000, 16.466, '{"bulk grains"}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, 1.500, 25.200, false, NULL),
+	('32b8a35f-5792-4c46-aa4f-ca22187faf18', 'KW3', 'Hopper wagon open', 70.000, 14.400, '{coal,"bulk cargo"}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, NULL, 24.000, false, NULL),
+	('4f65adc3-baf7-44de-88ad-0a4672fab669', 'NW6', 'Flat wagon (long)', 70.000, 18.560, '{"long cargo"}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, NULL, 25.300, false, NULL),
+	('c900bae3-cc3d-449b-9e8d-e66944ee74b0', 'BW1', 'Refrigerated wagon', 38.000, 21.996, '{"refrigerated cargo"}', true, '2026-07-27 11:31:59.903847+00', '2026-07-27 11:32:00.801951+00', NULL, NULL, 32.100, false, NULL),
+	('bcfcc533-01be-4e82-952c-26e20e7ecdfc', 'CW4', 'Gondola covered wagon', 70.000, 13.976, '{"covered bulk cargo"}', true, '2026-07-27 11:31:59.903847+00', '2026-08-05 12:59:33.82813+00', NULL, 1.300, 24.800, false, NULL);
+
+
+--
+-- Data for Name: wagons; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.wagons VALUES
+	('7589b56c-a055-4592-a0ab-ac963c2e46df', 'ER0064', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:32:54.850734+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('83cd6274-9dda-44fc-9324-c87c5e81b676', 'ER0399', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 54, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 07:00:11.969232+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '9001', '9002'),
+	('f1df3f40-9a47-4302-93af-417d3d4f941c', 'ER0812', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('9b64ee0a-adfc-4d82-a7c5-41166bce1ae2', 'ER0776', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('8ecb831d-4d07-4c56-b46c-d8fb7aff20d2', 'ER0391', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0da257e0-c825-4104-822b-82f27aa2c710', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:59:08.183485+00', NULL, NULL, NULL, NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '8401', '8402'),
+	('c00f78c4-e526-4272-953d-4d8c62c464ac', 'ER0392', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0da257e0-c825-4104-822b-82f27aa2c710', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:59:08.183485+00', NULL, NULL, NULL, NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '8401', '8402'),
+	('c78aa6de-de54-49ca-923f-ee70c4ed82d0', 'ER1061', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('76e2c47d-a2a2-4266-af1a-cd7f4ed1c568', 'ER0698', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('984a5545-0135-4220-9d78-c3f64809edb6', 'ER0662', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('17c88efc-8411-4bd1-8417-8cb00dff43a4', 'ER0888', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('2521705d-6dae-4515-8b38-0f2b3c53ee27', 'ER0918', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('aaf0da7f-0c43-44a6-bd9e-9f0f05f69674', 'ER0684', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('4ee289d0-aa53-45e8-bcfa-4523d27ae5e2', 'ER0907', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('be750157-c923-4ac9-88b8-7c3e75644fcc', 'ER0397', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:07:20.92502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('74946adf-0358-44d7-bc36-3e48e770293d', 'ER0839', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('c2049a62-06d5-4c21-aa26-45a0740cae52', 'ER0799', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('5cac0077-63b0-4022-9b7e-228a0391c3f3', 'ER0440', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:53:42.28848+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8001', '8002'),
+	('08337459-21c8-4fe3-97df-f956ec302a08', 'ER0833', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('e67c23fe-6a8f-4139-b67c-8114da07942e', 'ER0733', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('149369d2-4934-401e-92a8-fafc960ce908', 'ER0822', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('2c2c8388-1235-419f-ab5c-4ef78864f593', 'ER0845', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('6fa0b8bb-391d-4efe-a8db-1f78588aee7c', 'ER0771', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('e0c19bcb-2307-4d41-bedc-30a5365e6f00', 'ER0642', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('48f7254e-cc18-441f-8dc1-27dc40f08274', 'ER0794', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('64674c81-6883-4bcb-95cf-4f4ff511d66b', 'ER0906', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('64a5464f-e4c3-4da7-a430-4dd6fa511821', 'ER0933', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('a969568a-28f1-4739-8a5d-7eca54191f37', 'ER0560', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:50.129217+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('e32c1be3-1cf3-442d-9815-bcccb2bc950c', 'ER0665', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:49:30.893536+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('87dfa041-d705-49f2-a638-0ff6095416f1', 'ER0285', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '6de97a77-dbf1-4099-92ea-295416ab0d97', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('f8e2efe7-8f72-4ced-9485-760f7e16b816', 'ER0393', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('f6463fb1-5e59-4eab-a3e5-dfb2ba9f51e0', 'ER0394', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8701', '8702'),
+	('ae484bb2-59f3-4be3-b73e-3615ed8239fc', 'ER0395', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8501', '8502'),
+	('746dfb2c-9cc1-4475-b110-bd0d5efa31b8', 'ER0396', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8301', '8302'),
+	('f5bf1b94-6dc1-4be2-89a5-538cc18f919a', 'ER0446', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '9001', '9002'),
+	('26d88847-dc9b-4576-89ef-e40310e4945c', 'ER0298', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:56:11.67273+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('6a921f17-1659-4d8e-aa57-ecde72fa7a19', 'ER0398', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:37:04.758507+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('4270c552-247e-4db9-9238-10373eeafa12', 'ER0327', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:56:19.162876+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('0e09350d-9391-4c3c-8eb8-ae3d716acdcf', 'ER0337', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:56:20.845136+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('f2811697-8e8c-4a73-88aa-8794bc5fc2af', 'ER0259', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:56:00.383354+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('db06d53b-b72b-44d5-9450-2fe197b21a6e', 'ER0477', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:44.395814+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('7a9c1b32-476c-467d-9eba-effe7ace37fe', 'ER0270', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:56:01.985976+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('380475a8-bf43-4006-b5fb-46e33f91c1e8', 'ER1063', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:22.160926+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('d136d19c-2117-4981-8bb4-1491c7ebaa10', 'ER1071', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:27.451347+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('d92aa144-c48b-4f30-a7f3-524ce5b75ea2', 'ER1068', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:26.242867+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('b56b499d-0cde-4828-adb7-fb7bafe11927', 'ER1072', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:27.917251+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('48d741b2-c640-4956-83c8-2a7467bde43b', 'ER1066', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:25.044419+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('d1a2bde8-f7f6-44ed-a65c-10dd3ec843fa', 'ER1069', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:26.629759+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('15251738-b62d-406f-923e-b04c99b014d8', 'ER1064', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:22.965156+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('eabf854d-ea57-4564-947f-f34de60d8d96', 'ER1062', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:21.468745+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('7b58ef62-2f65-4568-aef4-a0a425833c7d', 'ER1070', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:27.075756+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('3e12631f-2d97-446e-8cb1-7255a1a2cc32', 'ER1067', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:25.704768+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('1105c370-3244-48cd-a994-5f2e9bfbc33e', 'ER1065', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:23.860881+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('5daa57bd-10ee-4e5f-a73a-45357b43e0a8', 'ER0430', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8201', '8202'),
+	('d3779672-5f85-4a03-a437-7ef6ec2097b2', 'ER0429', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8701', '8702'),
+	('c4283259-924e-45ea-9813-988b49b6b408', 'ER0420', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:40.372294+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8301', '8302'),
+	('f2f814f2-18ab-4ece-9ab2-2184c919b948', 'ER0418', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:40.372294+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8501', '8502'),
+	('a9501326-1a51-4791-a61d-01ae3deefec9', 'ER0417', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:40.372294+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8501', '8502'),
+	('ed6cddbf-950c-42b9-892c-d109951f09bc', 'ER0416', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:40.372294+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('271fef46-5a35-48ce-bdae-65608f4a66b2', 'ER0349', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:10:45.858773+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('1a29c026-8a2d-4fb2-ad6b-92d8a3058618', 'ER0747', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('590d477b-9751-4aba-838c-2a1a9dced6b8', 'ER0654', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('8ffd20fe-81a8-4de6-84bf-59b8070f5ce8', 'ER0752', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('23281ae2-8dee-4d45-a6d4-5f350d249185', 'ER0725', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('f076aed6-2aa5-4efc-b98b-e5d8a06fe959', 'ER0537', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('501a9fd6-16bb-4bb8-8031-9b9bcb95ae08', 'ER0490', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:51.504982+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('d4812df8-4b4c-4da5-8b89-51914bebe2fa', 'ER0570', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:54.83142+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('06b1543e-22cf-49f1-9f68-3d4dceed5942', 'ER0917', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('a48b2a69-327e-42d1-ba31-72c1040e3889', 'ER0766', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('fe1f224e-4bfe-4e6f-a14b-3593781b2048', 'ER0651', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:02.616217+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('9867529a-f3f6-4b4e-8d4c-58a989504488', 'ER0703', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:38:50.856073+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('5285d2f5-f84a-42b1-b5bc-0a82460c55a3', 'ER0728', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('da06f333-4919-4d50-97da-234b1e7c0819', 'ER0830', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('d6a107c7-3ab3-44de-b164-940495e0363c', 'ER0804', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('20fd7be1-d93f-4f3e-ab06-b35b7b3299e2', 'ER0935', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('9c8f2591-8800-4af1-8f0c-7782497fc08e', 'ER0898', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('b1bf9a27-65b1-4eed-ad32-75c461ad72f7', 'ER0577', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('6359bcab-6f2c-4709-b534-456e771d34ff', 'ER0762', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('5c059ddf-a486-414a-81cf-aeb384ef7323', 'ER0531', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 49, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:52:17.689086+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('fc05a483-69b4-4383-bfd2-c4a355a4476a', 'ER1077', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:30.227601+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('44b5f9b4-7cad-4395-af0c-4f47c136f117', 'ER1078', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:30.89219+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('ad3bb5de-2442-4c23-8bdd-afbcd897fb3f', 'ER0620', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:00.066443+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('2dc260e0-b0db-487e-8d14-f4657f43a38e', 'ER0668', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:03.734582+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('cd2b2696-b906-4ab1-89dc-308c1e82d8e8', 'ER0592', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:58.343161+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('7eaf1869-b77a-4f92-88ce-b41efcb2c692', 'ER0746', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('d3970a5c-2cf9-4fe6-98e9-9c3d97d4c349', 'ER0676', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('bba47e68-5078-4779-914c-bbea0bbf235b', 'ER0697', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('9511df0b-87ea-4f19-a770-4ea9a27004dd', 'ER1079', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('993f8b96-0ea7-4ff3-9f9b-c343fe193215', 'ER0723', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('0e3bd177-a865-4492-ae58-ade734cccf33', 'ER0574', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:56.416705+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('408b14c4-0660-4004-8beb-e0859debac28', 'ER0529', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:52.961017+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('0377dd35-bc94-4fea-9e02-9600e433e5ab', 'ER0489', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:49.753326+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('535c5201-6d10-4142-9e1e-c249b1f9d53f', 'ER0623', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:01.005029+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('9de95d0d-4a79-4afe-96f6-501ac942bf97', 'ER0631', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:01.782724+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('067ee0e2-a4d4-4e07-b621-624b163ad849', 'ER0617', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:59.274847+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('ce40f507-8d26-4ad3-bd59-c7e093910ecd', 'ER0576', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:01:57.402048+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('7b88bd46-2870-4176-b292-ee2fce6fcb44', 'ER0419', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('5067bbde-7756-4ccd-b95f-654baba240c0', 'ER0635', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('04feda04-6dcb-4d27-b6bf-458d9318e0c2', 'ER0650', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('4065b9e5-f6ce-4df5-b324-1081c0247d4c', 'ER0656', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('d9f29503-3906-4d20-bff5-447ebe355b61', 'ER0660', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('aabc4d3e-ac83-42c3-b348-080db47539b7', 'ER0663', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('e2bfa882-d653-4b30-aa33-e7b20698636d', 'ER0666', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('85e05351-b076-4121-b7b1-e07863f69f31', 'ER0435', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8101', '8102'),
+	('8b068c04-b5d1-4f63-b404-168fb57305af', 'ER0724', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('acf1bac1-9c4e-429e-999f-7c8e596dee6b', 'ER1073', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:28.392365+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('f910cc5c-33b3-4fd3-ae85-0f7bb6742ce0', 'ER0846', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('18f0bc2d-1ce6-4e4b-be1e-a5542b86afcf', 'ER0863', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('5e0d1098-804d-4f4a-a040-c1a4988a53e5', 'ER0925', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('0e7da7e1-2123-4391-9668-afc3f68b538e', 'ER1075', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:29.330576+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('72d8722d-a743-466a-b1c2-d6d8f976aa9d', 'ER0821', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('c09332f5-dc76-4778-8394-0fd37d5afbb1', 'ER0914', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('5f7b60b5-1680-466c-b4fd-fc32074d6e3d', 'ER1076', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:29.745184+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('357af64c-a831-4cc3-bb63-47debd125e1c', 'ER0768', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('06cdef17-d0e8-4588-b712-9eafd9a9ac02', 'ER0923', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('f0a0d86a-da0b-45d0-83ef-19b3fbaf0187', 'ER0800', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('e0e2003a-25d7-4a05-bd56-2e24ca1bf0ed', 'ER0844', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('a1194639-cfc0-472f-9b54-123eae6dee0c', 'ER0838', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('1aaeadd7-2f1a-4987-a552-477e84e3a239', 'ER0920', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('59397547-608d-4555-8e01-40be03e6abe9', 'ER0843', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('f87b1411-b079-4052-ab70-0ed1821393be', 'ER0760', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('86a04901-3c50-44ef-97f4-a97227741801', 'ER0517', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:45:00.720875+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('57c3f687-1c0d-4a29-9060-db38b3a533e6', 'ER0695', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:39:19.160283+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('c0eafaa7-85f4-4568-a3cb-09754f196592', 'ER1080', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('be722b60-e4b0-43e6-ab22-dea46593421e', 'ER0852', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:38:53.34555+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('c21f9988-2ec4-479a-9206-35d344580453', 'ER0880', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:38:55.927275+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('bf38dfda-c3b1-479b-b448-12b4a7755554', 'ER0536', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('a83c2c28-b229-4275-aa45-7ba49e5e8042', 'ER0674', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('de9ef3bd-712b-4f34-8f25-0d6a51833074', 'ER0692', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('b32de37c-e462-4a7b-aeb0-f7b73ddf68f0', 'ER0694', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('5315a1c0-352f-4529-b88f-137077263a1d', 'ER0712', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('2f1348ee-a228-4fdb-a791-d8827bab8fd8', 'ER0734', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('8d08acbc-aa83-4a0f-a59f-dece78afd2f1', 'ER0744', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('a512fb55-b960-4781-8a63-131bdab1184d', 'ER0764', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('15541cca-4457-4f16-9291-3032d008faa4', 'ER0782', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('e875642e-1a0c-4916-9c30-afedc2bf6058', 'ER0784', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('9db9bf3d-2a4c-43cd-976b-b6dafe140865', 'ER0786', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('343bd852-aaec-4858-a2ff-a3c126b0cb5b', 'ER0790', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('21ad7cf5-8720-48ab-b07c-457d659f10df', 'ER0791', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('7bf39d66-2919-4743-a70d-4a4ee0719c65', 'ER0937', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('414afe7b-789e-4690-8a04-470ec2f9704b', 'ER0939', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('dfb83a01-311b-449f-a1ec-c44ee5c9a581', 'ER0469', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:29:43.008495+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('6f4da6a8-4176-4c43-9aac-32607123f8bb', 'ER0331', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:06:36.090484+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0311af6a-aa38-4808-8b74-73cf20c1a1c2', 'ER0332', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:06:52.603571+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('40b43a95-8215-47b3-8346-afdf88acbc33', 'ER0226', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:32:47.584825+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('afb12540-474d-4ae0-8e0e-39ad24f0b628', 'ER0228', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:33:15.377355+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d1ede525-5022-4b2c-bf71-1a3fd2b2edf0', 'ER0230', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:33:41.357887+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b434f473-a43b-4a52-934e-308c464c37c7', 'ER0235', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:34:47.905852+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('32d6def4-b0ff-4c20-b1fa-a3074baa2cd0', 'ER0237', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:35:17.471978+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('70928e7a-b165-43fc-9744-b57b1929c92e', 'ER0238', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:35:27.963004+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e00588af-e652-456c-a8bd-85a58185f3ef', 'ER0239', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:35:40.104463+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('26457809-3c21-4c11-9848-03c6e268f733', 'ER0240', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:35:50.380368+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1b8b0a50-cc15-4679-8701-253edbaf4cb3', 'ER0242', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:36:05.419894+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ce2e48df-c783-4273-886e-dbfc9ec199d0', 'ER0476', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('b19b617b-93f1-4ecd-b49d-3107857545d2', 'ER0245', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:36:38.841294+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('da5dafe5-2df8-463e-bf3e-b53eea7583f7', 'ER0246', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:37:47.953274+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e2fd82cb-f1e2-4b2d-8125-3e85c618bcd5', 'ER0248', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:38:28.297052+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('2bfa1179-2c7a-43c6-93d6-6734a9e1cd21', 'ER0249', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:38:39.219371+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('50737f50-721a-4f0d-a56f-0ee636a9f99c', 'ER0252', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:40:17.432279+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('32e594f7-f4fe-4626-9d44-fd3c76eff104', 'ER0253', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:40:28.809741+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('a0f32cd3-2b0b-4644-8ac4-51a0fd361a15', 'ER0255', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:41:45.525796+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3ea530ac-397d-4f2b-8ed8-a95b2a838082', 'ER0464', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('72640cee-b20e-4398-9086-35f9ac5eb34f', 'ER0452', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('c512fda1-f529-4998-98d7-721754fb9caa', 'ER0456', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('1f7ad1ca-f9f7-4387-b6d5-9337253b7ce5', 'ER0151', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('fcfd3862-fbc7-431b-bae7-c7d27c6c3ac6', 'ER0244', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:45:08.93092+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('8deb34c6-801d-4253-9b78-81c899e446fe', 'ER0241', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:45:13.25235+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('071a6cca-e29a-4093-b43d-58829ea58076', 'ER0465', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('6df25284-ce09-46c1-8355-b8ee1207197c', 'ER0256', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:41:55.398338+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('372e8517-429e-46d9-93e4-24dc31d532ba', 'ER0258', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:42:30.704016+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5b3712e5-90a6-4952-856b-66eb501d6e9f', 'ER0260', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:43:27.340953+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ea06cf24-447b-499a-b057-e01b511789ff', 'ER0265', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:44:18.161212+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3f0c0b14-3198-4037-a83f-43c84b43d582', 'ER0267', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:44:52.296469+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('39e98b37-4872-4c76-9804-745aad49d250', 'ER0269', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:45:11.491099+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('bfb7f820-e01c-4fcc-82c6-b64ee59ba584', 'ER0272', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:45:39.744001+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9f87a7b5-8acf-43ff-bb5e-8a3619323031', 'ER0273', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:45:50.871004+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d33cc5dc-ca2d-4621-a641-15ec8bd2b762', 'ER0467', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:42:39.527544+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('4cb174c0-5808-494c-a3ab-36b117860505', 'ER0334', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:07:16.49306+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('6b9a7379-58a4-4527-892e-52bed1d97bdc', 'ER0335', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:07:28.492556+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b06426a7-829b-41d4-8644-d23c926af494', 'ER0336', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:07:46.570327+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1ea1a183-9a35-4611-858f-95b9f4e9493f', 'ER0338', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:08:11.722827+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('f985b0bb-e90a-4dff-b752-e43201dc7cef', 'ER0339', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:08:24.508105+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('519daf25-9bd9-4fc8-a49b-4b9513cb1514', 'ER0340', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:08:40.140275+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('730d8ad8-5580-4466-ac3e-797f9df3c2ef', 'ER0341', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:09:01.939097+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('37afc3f0-4143-4028-98eb-0428d2645158', 'ER0342', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:09:18.798003+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ba17ec6b-7953-4b93-88bd-5ed907052b86', 'ER0343', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:09:30.448499+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('08252d50-4e96-4923-b2e2-e82e3f2acfe9', 'ER0344', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:09:41.91299+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('c6874c8e-53f8-460a-b88d-fab58227cabf', 'ER0345', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:09:55.047605+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('bb84eafc-011f-454d-a31d-937e9766e3c4', 'ER0346', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:10:07.238251+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9a23ff89-921e-48ec-9e98-dbc03c17f2a2', 'ER0347', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:10:19.488175+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('bf133d9a-4593-4e4a-897c-febdd452c356', 'ER0350', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:11:02.878536+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0242f1f9-591c-42d0-856b-76069ee74af6', 'ER0247', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0aff5aa8-c79f-4367-bfa3-10aedde7f1fb', 'ER0450', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '9001', '9002'),
+	('46642c3a-54bc-4c89-b02e-e970ea9a03c1', 'ER0466', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '8701', '8702'),
+	('27398588-df37-4408-bcec-69b408be2b4c', 'ER0437', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('dcf8af0b-b95e-4e95-8d8e-75be6a3ea769', 'ER0431', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8101', '8102'),
+	('273d5cdf-193f-494e-927a-f30e2e800ee3', 'ER0422', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:37.064126+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8101', '8102'),
+	('0a809e95-cf09-4d8d-aa47-df508291508e', 'ER0309', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 47, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:45:21.752275+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b0fd8345-e047-4869-ba3b-b5eee4d1509f', 'ER0926', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:41:04.83575+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('4a20556e-5849-446a-be84-72c023c26945', 'ER0301', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:59:46.454156+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5f86c40c-4106-417a-aad4-918b566feda6', 'ER0302', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:59:56.781782+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ec6bd572-fe5d-499f-ab67-f474f2fbe149', 'ER0303', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:00:11.64283+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('c9255e88-15da-4ac1-bebf-333fc12a8322', 'ER0304', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:00:21.142133+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cfafa532-458f-4aad-a0a6-ce1ad61a2fd9', 'ER0305', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:00:31.12246+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('32fd1dcd-43b4-447f-9263-05730ef73988', 'ER0308', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:01:01.180237+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('8a8fa3e0-20d8-42c4-a63b-7f859b86f3cc', 'ER0312', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:01:30.250814+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e87cb8e2-aca2-4c4e-b4bf-9df5edf96651', 'ER0317', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:02:23.729453+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('930806a0-a2b3-4dc7-90d0-e9fc63f58ec2', 'ER0318', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:02:34.854129+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b0f774dc-8ba3-4116-b948-db6c079337c8', 'ER0319', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:02:44.929872+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d64d4a49-d283-4ed6-8ccd-7f4c29c1a7f7', 'ER0716', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('6418abb5-3057-45c3-ae8e-131dc5ca944b', 'ER0885', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('367c3556-02c5-4734-993f-27b4ef8c894d', 'ER0901', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('db81a283-27ef-470e-8697-bb99f2985e0c', 'ER0905', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('d0ef971b-de9a-4444-8f9b-be65a73383a8', 'ER0915', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('806727f8-afe7-4bcd-8764-d0b8a336fc1d', 'ER0410', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('4334b12e-103f-4499-8fe5-1ff8df234716', 'ER0825', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('24404f54-03b6-45ec-9cbe-227447b92976', 'ER0401', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('c9f2906d-4e11-464f-922a-1b37bc95de15', 'ER0402', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('98407c31-ec00-4b57-a96d-637cec1ed273', 'ER0403', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('3712c6f2-e1f1-42fa-b16a-e3fb33c3622e', 'ER0404', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8801', '8802'),
+	('a8b86f98-50ad-4258-88b5-3e700dbdcb21', 'ER0405', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8501', '8502'),
+	('1f4f4542-f4b8-47ea-a868-281c04fca0f8', 'ER0406', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('700477c2-4c6c-4f81-8c5b-a7589c83704b', 'ER0415', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:44.085785+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('027c3412-c1ec-4f48-b65f-dc20b20db5c7', 'ER0826', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('9ad96e4c-285c-4b47-baec-ad9606680bff', 'ER0835', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('ebf5d985-02ee-4f64-a43c-c77c683e5479', 'ER0840', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('078db48b-a8ab-4acf-babc-0e5c8df538fa', 'ER0850', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('100fbb76-f62d-46a3-be30-ac79719f9ded', 'ER0858', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('ac3442c2-05b9-4d13-a242-ee50caadeb9e', 'ER0868', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('b1848f29-5b8e-4af2-a633-e3979371881d', 'ER0879', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('dc805571-e020-42c6-9368-4a42a9e03cda', 'ER0414', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:44.085785+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('4e0c4c24-0158-437e-92c5-f8672d4bdcb0', 'ER0413', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 47, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:44.085785+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('49bfa4cc-5644-4ef3-b121-27ccea8d80b1', 'ER0412', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 48, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:44.085785+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8101', '8102'),
+	('b150fcda-ed35-4c2a-829e-6f5da2447b94', 'ER0411', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 49, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:55.822629+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8201', '8202'),
+	('3ea454cf-85b9-4820-baab-839a2e8d8ff0', 'ER0409', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 50, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:55.822629+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8701', '8702'),
+	('6ade91c0-d616-4ae3-b7c1-7f7cb2686961', 'ER0439', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('5424c729-723a-4606-9d2d-b73f2ba27b31', 'ER0438', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('a3117101-e97f-44d1-9415-7cdbb2b05003', 'ER0408', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 51, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:55.822629+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8501', '8502'),
+	('72122c32-6b76-4881-aa5d-d9cdf2b787e1', 'ER0407', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 52, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:55.822629+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8101', '8102'),
+	('b034a5f5-8eff-4f31-bf89-945d920749fe', 'ER0427', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('8de9ad3b-fae0-499a-98ef-e5d5d2ee41d8', 'ER0426', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', NULL, NULL),
+	('ba1a953c-e8e3-4b83-9737-1209a985f56a', 'ER0400', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 53, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:55.822629+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8301', '8302'),
+	('cda2bb61-9145-488f-9525-ef4f751844d2', 'ER0495', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:00.849828+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3ecc5c70-2441-476c-b0bb-2737d0f09ef3', 'ER0509', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:50:56.108352+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d4138cab-df2f-4a7d-89ad-b57bf0e00c13', 'ER0423', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:37.064126+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8701', '8702'),
+	('46e2cf00-eb19-408a-8e3e-ba25f3b386c9', 'ER0613', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('cc7cc87f-4bad-4d1a-9beb-a636663c128e', 'ER0510', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:30:15.428704+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('a2c86830-5db4-4cd4-99e6-85cdbf9f6979', 'ER0820', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('01908c99-7431-4e1d-811a-40826c16665d', 'ER0523', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('fd916ab4-21c6-4da8-b35f-8205eab50337', 'ER0457', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('f73b25d9-6b6a-4d53-8033-0d36bd288f66', 'ER0493', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9c7d4932-5e79-4e22-a641-d5a814379b00', 'ER0482', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:11:05.592043+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('8198f44f-fbf7-4c17-b4c4-b243a78b51c9', 'ER0816', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:41:14.661189+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('a9ffa28e-1937-46f8-934c-226622a799ad', 'ER0645', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('ff1f3cda-45ce-45db-a404-0f52bcbc862c', 'ER0593', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('eb2c0142-6e43-4bc7-83f1-89e2cff5d5e9', 'ER0525', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('89e30286-3d71-423e-b6d2-8f0bc588796a', 'ER0634', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('1b3ea2ee-ec63-4282-9fb2-c54fe222e74f', 'ER0919', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('c3d10861-d0f8-4a5c-9f61-9f793f800f2d', 'ER0647', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('06f877c2-6d82-408d-8d91-584bebe4a5f7', 'ER0823', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 47, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('6224eb5f-d4f9-4c65-874c-47422057f597', 'ER0472', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9a082ab4-ac24-494f-a11c-37683750b1da', 'ER0549', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:24:10.058725+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('54c516bf-848c-4d66-b8af-a93a0bfc7f5b', 'ER0534', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:53:34.457919+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b7f20435-2ec7-40f3-bef2-6c02984ecdf3', 'ER0586', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:03:18.059415+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('7d3c4ee9-6a27-4876-ad68-0eddd0732a6e', 'ER0581', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:03:59.604852+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5852d1d2-0ae9-4e9d-923d-6e94e0978a25', 'ER0425', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:37.064126+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8301', '8302'),
+	('13a74e04-28ef-4549-9a1d-b5bd3a4761a4', 'ER0595', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:22.432586+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('24125da0-7132-4b76-9bd5-cf6d7504bb8f', 'ER0532', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:05:26.626871+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('21f7b10c-ff34-475d-88e9-da3e0e158000', 'ER0579', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:10:46.259085+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cb781c9b-94e2-4ec3-a997-f0220b04db8f', 'ER0473', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('98eff0a7-234c-4be4-b70c-7ddfbeb25f2b', 'ER0543', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('93ce0ad8-13a9-483b-850e-769042a399c0', 'ER0535', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1eb3b6e9-7898-4478-a5ee-45b414003682', 'ER0652', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('e76864dc-ba37-4778-975d-371d048f3ac7', 'ER0546', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('b7d60af1-f9b3-47e4-abf6-a5fe2d802e88', 'ER0501', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('f199afb2-1f19-452e-bda6-de0d175fa0ba', 'ER0460', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('1b9d2f4c-ff5a-4c45-b235-86455ebec463', 'ER0717', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('9aa5180c-6dab-47cf-bf0d-75e13f975380', 'ER0601', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('44c02fcc-b95d-4fa7-a9cc-a23c41388b5a', 'ER0504', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('d89b0878-06d5-451b-876c-677e4419caad', 'ER0749', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('5b86e28f-8a4f-4e04-b440-918427b3f31b', 'ER0591', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('a8c27418-05a6-43a7-99f9-03852c7ed901', 'ER0552', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('243c08e7-86e5-43bf-82a1-7d512f0f7be1', 'ER0463', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('e94721f1-38fe-4be4-984c-eb9f090f52e9', 'ER0632', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:34:29.687487+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cf00f718-f395-4aa2-9ad7-f94e60e7c797', 'ER0611', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:37:34.073101+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('84a0792c-fb56-4115-bbae-1dacb8527154', 'ER0609', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:37:45.556668+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('146e0875-21d3-4ef9-9a2b-558e051afb56', 'ER0604', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:38:17.291058+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('4d6e2806-1f3b-4f70-85cd-d3793fc15d17', 'ER0657', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d2f2606d-ec2f-41ee-b4d1-d59c55c674c8', 'ER0639', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('338f6114-89c1-42e2-b6ea-0c62eb0bb385', 'ER0687', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:45:18.744543+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('24db4944-0d2e-4a33-b0d3-43f6a2691977', 'ER0688', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:46:12.082074+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('2d0f17d2-e552-4ea2-880d-69241c03f8b2', 'ER0696', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('089ca45b-eb24-46b9-b282-1dd6ed413c0f', 'ER0731', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:50:48.691476+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1b8c2cf4-b615-49d1-9d5d-c8367174fc46', 'ER0750', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('76992a46-b6a4-4142-9e5d-b9f0af8ad10b', 'ER0709', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:29.669349+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1db5c735-7c5c-4f95-ab27-3bdd3c67ff73', 'ER0722', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:10:05.839539+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('61688155-a97f-485d-bcb6-64f3d72ac3ca', 'ER0708', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0f880599-748c-4420-9f24-1cc4f5029119', 'ER0745', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:10:56.412112+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9697cde1-c943-4f96-b64d-35eac1dfd05f', 'ER0721', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:33.416499+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d743d6cc-e001-4ef8-99ab-c1a99e25be2b', 'ER0742', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1df08415-63fc-441b-b4b1-452b1a7d24b3', 'ER0727', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b777f7f6-5eae-4ac0-a49f-03848602f584', 'ER0710', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3c43662d-5492-4b95-a472-478ccffd638f', 'ER0690', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:30:21.076621+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('41f9499e-b398-44bd-a05b-d37a9e5517d7', 'ER0701', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:36:36.532418+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('79006d79-2f8a-48d3-8fa9-5339ee90f683', 'ER0719', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('4648d1bb-d0c5-4663-9f24-4b5538501472', 'ER0757', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:09:51.350881+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1e84127f-a21d-4bfb-ba4d-830e47fcb85e', 'ER0817', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:18:14.326592+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('36659634-60d8-420d-9fc7-a651a6443ab8', 'ER0792', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:19:13.074354+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('fd403042-a234-4ba4-bfc9-e4c3cfe5d47a', 'ER0779', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:46:45.263452+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('bafc7ab6-e71f-43c3-b207-a561a3803256', 'ER0783', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:47:46.148195+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1081fa15-b7c3-4277-9448-dd429b053a69', 'ER0793', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b25def76-601a-435d-ba70-21657d5e32ba', 'ER0813', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'DETAINED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:05:51.192063+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('3b353bd0-82da-4433-8bd6-60bab8db1cd5', 'ER0773', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:11:32.813591+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('45d23537-2f55-4833-8840-016223d5f99f', 'ER0892', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:33:40.250418+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5d6cb90a-9757-4390-8175-a87406c7f761', 'ER0862', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:38:04.110589+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('fdbcc005-28a9-44db-add2-ddd4f9b9a515', 'ER0860', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:38:24.325087+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('33edc37b-a7e7-4c73-9133-35a78518bb4f', 'ER0856', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:39:18.416234+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('555d31cf-f342-4ed8-9ceb-7a907f9e3622', 'ER0867', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'OUT_OF_SERVICE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:05:12.100586+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('c8506335-47a9-4641-abcc-d8214f03607d', 'ER0848', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:09.435013+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('063ae7d7-9113-4d63-b188-277e1ff7b9ec', 'ER0829', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:14.786644+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d42f1ab4-5e42-4044-bf78-390c802e9eaf', 'ER0869', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:02:20.819091+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('62b0a832-e016-4bf1-adcf-1b4bf0524366', 'ER0875', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:09:51.191223+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b0bbe619-93a2-49d1-84a5-4e323f86ea83', 'ER0871', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5fcbda7e-ddf8-449d-a83e-aa68a1aabd65', 'ER0834', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('bf6dea2b-5728-4d5e-960b-58612d0e54f9', 'ER0828', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:30:08.186969+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('099895c3-7158-42ce-9f03-0a421e331208', 'ER0932', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:48.096798+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('68060321-5de4-4921-8671-d70ac37d4087', 'ER0931', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:53.99454+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('6f269766-2d29-4e94-948c-54500471ef07', 'ER0938', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('61984e51-cecb-43e9-8b2e-6c5bba5e51a7', 'ER0774', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:05:41.438499+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('d7898180-e9ed-49a9-8e0b-89559c9d14d2', 'ER0841', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:07:14.196015+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('eaa53c72-7b64-474f-b8ac-d994589b1f1b', 'ER0778', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:07:24.261501+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('ded1f6e9-8498-44b7-8d2d-ec56febc4b90', 'ER0795', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:08:38.010757+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('df78b27e-67f6-4ab1-aba6-95e89818ed96', 'ER0808', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:20:01.764042+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('66481bd8-b34b-44c5-8764-4f15eebd5194', 'ER0785', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:20:16.133985+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('94f139e5-d95a-4e3c-b91e-c75570fa97ad', 'ER0705', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:23.26191+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('45753811-3d54-4b48-8e62-c4dca5a2e373', 'ER0700', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:19.316711+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('6bc26dad-03ae-44d1-b15b-5e7a9d5e7438', 'ER0706', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:40.364011+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('2c207a6b-0052-4aa7-bc6e-ece5f577cc8b', 'ER0718', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('ab532b9f-d42c-4b28-b478-1417c6311ab4', 'ER0693', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('afc8372e-f69a-471e-b670-faf8ae208f9d', 'ER0016', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:25:52.966705+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e833d05b-04b7-4f9a-a244-94a47df31bd3', 'ER0002', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:17:32.659478+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('51b83da8-9fee-4296-9851-c4e31a36406f', 'ER0003', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:17:47.104892+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('05801372-7f9e-4362-b55a-bae1f666eec2', 'ER0017', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:26:15.908575+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5a8ef4df-c9e4-46e7-870b-8d991d92399c', 'ER0018', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:26:25.503842+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('f7c19cb3-2ed8-4889-b528-2e2533502e1f', 'ER0019', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:26:41.114722+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3c6a816f-1238-4114-85e7-3f50cc8b0728', 'ER0030', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:05.064276+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('efc28cde-d1be-48f0-a50d-ece5d89c87ab', 'ER0031', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:16.638005+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('68d6cfb7-550c-4817-81a7-3fd12accd9c7', 'ER0032', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:30.005926+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9a785fbf-4743-4e10-807b-4d2a7b0f285b', 'ER0033', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:43.489413+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('a82021b6-697b-429b-aaa5-ea29acc14e4e', 'ER0034', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:01.105762+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('f3a2eb29-6fe8-45d5-8548-c65d3cb9f3bb', 'ER0035', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:11.181659+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1cd1ed87-7ee3-417b-9c08-11ba3da73687', 'ER0036', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:20.790553+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('c0fc858d-d15f-471e-b404-48602aa7567e', 'ER0037', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:30.908719+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3e145144-dddf-44fc-98a6-9daa53a915a9', 'ER0038', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:40.913341+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0eaa23e0-287c-4f08-b867-fc4069756e15', 'ER0039', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:28:50.951957+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5f35aef5-9f2d-40d6-ad7c-6e5ff4fe3963', 'ER0040', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:29:04.883646+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5b7b8423-d211-4538-96a8-8cf5cebe9974', 'ER0041', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:29:16.888708+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('873ccf9e-68f5-468a-ab6e-626a77511a26', 'ER0059', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:29:54.745697+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ab966ba3-0eb9-43b8-8a7b-c6a8bdc1b8b2', 'ER0058', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:30:04.376634+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ae0ba279-db43-4cc9-87d0-d8005c491ef9', 'ER0941', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('36c7a12a-1bec-4600-b8d1-7d8b9e3bdaf2', 'ER0057', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:30:26.019315+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('df0824ca-b995-46a2-a153-ddbe7d2746ce', 'ER0056', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:31:31.396945+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('2f598bc1-356b-40e6-8d34-542cbcc2716c', 'ER0042', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:29:27.297438+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1f58d505-caa1-42d1-b1fe-f36737093e06', 'ER0043', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:29:36.601867+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('09d74a8c-04b1-4514-aabe-dc1d93b414f4', 'ER0044', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:29:47.117104+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('9f8dda93-dfbc-49a6-afe5-2ec25d52027c', 'ER0045', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:29:57.446043+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('94eb0618-a98e-4dcb-af81-148f2826569e', 'ER0046', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:30:07.228775+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3ae733ed-b2ab-4b50-81ab-c7d67415c30f', 'ER0047', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:30:16.952384+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ea7c3b62-00a5-486f-b37b-5c876a8ef0be', 'ER0048', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:30:26.811653+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('07e93df1-095c-442f-bda5-41bc74ad0ced', 'ER0049', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:30:37.600127+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5f5c71bc-a7e9-4d14-96fe-be402c391006', 'ER0029', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:49:08.412411+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('10fa4f49-57d1-48e3-a7e3-46e2121f0ccc', 'ER0055', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:31:37.390809+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('46793bd2-c77b-43af-83f4-3cebca8f83fd', 'ER0054', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:31:44.801801+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('52c2faf6-80f1-40e8-97d1-d8ee82867198', 'ER0053', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:31:52.824676+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ed72a1b9-d060-4699-b866-31a2c6bf2eb8', 'ER0052', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:31:59.845094+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('7a93e53e-861d-4e3a-bd4b-58bf39da6ee8', 'ER0050', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:32:08.4062+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('7c2f5d1c-d9d5-44bd-b7ff-80f3e7bf52e5', 'ER0051', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:32:14.605069+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('da467171-ff66-4c8f-a8f0-da37dc7b7ea7', 'ER0060', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:32:25.322664+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0ac8b72b-38a2-4fd8-ba6c-273edf69dd43', 'ER0061', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:32:38.014884+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e83f2749-f195-4ecf-b158-d0f96a24493d', 'ER0062', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:32:46.755861+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cf4adeb3-39b8-471c-9c16-ef34d6b9bd93', 'ER0001', '8eec3a7d-8482-4397-96b6-59a028210722', '0da257e0-c825-4104-822b-82f27aa2c710', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:59:08.183485+00', NULL, NULL, NULL, NULL, 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', NULL, NULL),
+	('cd011374-5d21-46d1-bfa8-5f6cce8a3ca4', 'ER0004', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:17:54.900575+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ee37e8fc-a8a4-4405-bd7b-1c0312555d0b', 'ER0005', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:18:04.380484+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('6b960b60-1e24-4046-bbbb-61a392cae073', 'ER0006', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:18:11.505253+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ecd99a46-4a5e-4615-b715-9960046dc8ca', 'ER0007', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:18:18.309735+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d40c1816-be56-4a13-8c52-a436ac20c8ab', 'ER0009', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:18:37.241472+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('3e79907b-c2d3-41ab-80fc-e315abeae8af', 'ER0008', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:18:45.15842+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d040c962-0654-4728-9193-1130c88e4a62', 'ER0020', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:19:31.640213+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b9d8a7f8-bc43-49aa-b3a6-0318b46e2910', 'ER0021', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:19:37.647825+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('f0848a37-c4d9-4d1f-bf4f-96cb5c9de452', 'ER0022', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:19:42.700697+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('c88396c0-3bed-4aff-a848-7f82f70b932f', 'ER0023', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:19:47.548749+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1d3eada0-d635-4cce-8162-37ab335875d1', 'ER0024', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:19:52.751435+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cf954164-7b60-4ec6-9b19-ffcd8349e73a', 'ER0025', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:20:00.749912+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('23e0fda5-84a0-4d63-8d0b-5d3b84d7c64f', 'ER0026', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:20:05.832161+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('b15f6950-4fcd-478e-8d68-c1bf4fc3a333', 'ER0027', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:20:10.840034+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('79bdd006-31ca-427e-ac98-1bcd21e8d64c', 'ER0028', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:20:19.587276+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('adc1a56d-2d97-4293-80b0-054487d23ed1', 'ER0010', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:24:15.716013+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('58a75962-bb5e-4494-9eb6-92236284f7f8', 'ER0011', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:24:34.013481+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('54ce9794-8949-424b-b2da-2ce1117f64d5', 'ER0012', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:24:44.873919+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5157d855-6ff4-4d76-93e8-3ed09005f07a', 'ER0013', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:24:55.50671+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('41cef115-d5ce-4e37-a824-d356c9fe2a65', 'ER0014', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:25:06.115573+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1ffe2c11-525c-4f4b-b510-986a976e4f66', 'ER0015', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:25:35.741993+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0b652309-d605-4e20-84bd-974139462cc6', 'ER0063', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:33:03.285171+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ffef9238-7c91-499f-8d71-ac767d713615', 'ER0067', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:33:10.841698+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('4347bd49-f8c7-40a5-a963-c35f71e4551f', 'ER0066', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:33:21.531298+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('220877e0-fef1-42b6-90d9-48136749840f', 'ER0068', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:33:28.528003+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d7be2a1f-521e-4548-97b2-dc19361a8c24', 'ER0069', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:33:37.157909+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ba5376e4-bdab-4e4b-a3b0-c8ba6c2f2da9', 'ER0065', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:33:44.162446+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('da15e58e-3682-4261-a511-011ad1305ff9', 'ER0093', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3bee58cf-6c38-41ee-9a95-4f7c9c36c122', 'ER0155', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('91e8f209-a152-4c93-a14f-141027574fbe', 'ER0277', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:53:22.941657+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ee8671d7-497d-4d64-9a0d-9eab03878351', 'ER0278', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:53:32.939516+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('6d250421-7ae2-4978-acb2-fcb83a72e56f', 'ER0222', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:31:27.060219+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('da63a5d9-1ff7-4d84-96e5-d2aba5e4015e', 'ER0223', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:31:40.950191+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('48bf735a-65f5-4cc5-9ca2-b3f6fe32e301', 'ER0279', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:53:43.488857+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e931b7aa-3442-4354-8f97-fe6ac2465446', 'ER0280', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:53:52.799411+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('5527fa86-4fed-4f40-9af3-a44f5113de6f', 'ER0283', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:54:25.712688+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('c1a42770-9c6a-451b-ba5a-65aabb9b359a', 'ER0284', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:54:35.938274+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1608dcc6-d250-45f6-896c-696f6388f1df', 'ER0286', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:54:56.161229+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('e167a7a9-2506-4e5a-9a4d-b598a542ba60', 'ER0288', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:55:20.400958+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d91fd059-f818-48e5-a577-977fc7911eb7', 'ER0290', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:55:43.425414+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1a14dac0-e5cd-48fb-ad90-924e2c4383cb', 'ER0295', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:56:31.974699+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cf6aee8e-5f74-4174-9006-5f0123746de2', 'ER0296', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:56:41.02224+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('c9519e32-cdee-44db-a984-4d548a6d57d3', 'ER0297', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:56:50.870987+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('d13b2762-fed2-490f-9db0-af899cdec183', 'ER0299', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 06:57:10.117305+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('eb82e348-5a63-41ad-b863-42844dfabbd1', 'ER0320', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:03:01.643809+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('a84d3444-6d11-45c1-915d-981bfdc513a6', 'ER0323', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:03:25.879989+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('7f30c794-1511-4a22-84d3-4b508face952', 'ER0324', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:03:36.823479+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('ec331058-8f95-46ea-b58f-0553ac649d06', 'ER0325', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:03:47.278915+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('cc434d4b-9560-41e1-a2dc-2edf4e2072c0', 'ER0326', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:03:57.466165+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('623581de-ab08-4a00-9cd3-4a3f56a72f02', 'ER0328', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:04:20.318156+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('0258f83a-e405-41da-b596-9e286a5cb400', 'ER0329', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:04:30.026895+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('1eb8adc4-322e-4bec-bb62-50e32f942959', 'ER0330', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:04:40.276037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', NULL, NULL),
+	('335c4ddf-db1d-4d5b-8c94-e4c05ada00da', 'ER0220', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d1f64476-c09e-480f-8cb2-2e6cf792d604', 'ER0983', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6fd18d2e-e59b-4f76-9698-6800a178b728', 'ER0287', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:41:40.389022+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('9ca2928c-add3-4acb-9354-6407fd5c7cd4', 'ER0541', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:47:04.250703+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('1bcc716b-dcb3-4bf9-9e1a-4039bb8db9d9', 'ER0221', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:31:15.659738+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('69ba9d8c-7bbd-4ded-b924-4271490f382c', 'ER0271', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:00:20.046013+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('04219cc7-ef3f-4b30-9e31-cb5a207631ae', 'ER0448', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('76e92779-2705-43b5-8e28-52fc9ad42ddd', 'ER0441', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('898628d2-7195-49aa-aa05-7289781725ac', 'ER0428', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8901', '8902'),
+	('20e7c481-34ac-4603-bb38-357383c55a9b', 'ER0424', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:53:42.28848+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8001', '8002'),
+	('537f8f55-78f0-46a6-94b1-512b6903f021', 'ER0511', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('e4f95edb-21b6-482b-9b51-1af97edc2341', 'ER0432', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:53:42.28848+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8001', '8002'),
+	('c6d96337-5426-494e-a621-1603b0355c6c', 'ER0474', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('7f9635a8-22d5-46e9-9844-83807b18a310', 'ER0506', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('00c04e2a-05e3-4d3f-8da3-fff944605273', 'ER0479', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('78f56cbf-f56d-4f0c-b1ce-8f2224023016', 'ER0497', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('c0417d20-34f4-436c-9a82-4b2adc51b5aa', 'ER0468', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('ab39ae7b-1f29-4658-b98c-d458002e0884', 'ER0936', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:32:11.420342+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('57ae3cba-d8dd-4507-a028-c89ea4702f3f', 'ER0519', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('49ec0541-df20-41b4-804c-bbd5f5f96e2f', 'ER0539', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('5c16b8ef-e9aa-4ab7-97b5-f685b379395e', 'ER0453', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:34:00.704309+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('b836b7e4-7975-4120-9628-ada891845f41', 'ER0507', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:34:06.475823+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('a9e82d5a-4f14-413d-b226-f83f44900f8e', 'ER0462', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '8001', '8002'),
+	('d25abbef-a7f0-4b6c-98ed-6931e074168b', 'ER0447', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:53:42.28848+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8001', '8002'),
+	('f91d4f62-2185-4ca5-84d6-2ea9fd1e293d', 'ER0478', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('b2c9360b-7c3f-441f-9aa2-d4ff2ce35999', 'ER0310', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '6de97a77-dbf1-4099-92ea-295416ab0d97', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:30:31.542141+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('32f979ed-d94d-4ed5-8e83-e68d9d159aec', 'ER0227', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '6de97a77-dbf1-4099-92ea-295416ab0d97', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:35:19.110185+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('1b764fc2-151b-4e5a-915e-585e5e61a233', 'ER1074', '4f65adc3-baf7-44de-88ad-0a4672fab669', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-04 06:59:28.97998+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', NULL, NULL),
+	('148b7a5b-c7e3-46a6-a621-61467233720c', 'ER0544', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('a8292022-9346-4ea1-837a-8b3d7354a62c', 'ER0547', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('1c4f1919-2c79-497b-9c57-92bad167d443', 'ER0557', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:32:47.643593+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8001', '8002'),
+	('a116907e-a06e-46f7-8d8e-3c0ab2e830b5', 'ER0458', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('0175eb07-2012-44eb-ac4f-550d1aa83c60', 'ER0600', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('48be7d38-c265-47d1-ba04-2a3bb6bc116f', 'ER0521', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('76300a20-b249-4c27-ba73-4cba7a110ca7', 'ER0559', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('d599be9b-e15a-44f8-8f1a-b2fe1acf79a0', 'ER0459', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('944af82a-1903-4a6e-a557-c939a1b64336', 'ER0470', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('236d1cbc-4dee-4aca-a5b6-b563591676cb', 'ER0254', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('7040bd13-13bc-4f4b-8322-af03cea5c4c4', 'ER0555', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('cda7dc57-2622-482d-84a4-df22f6063e3c', 'ER0527', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('22821225-2949-4956-b445-69af2f523c69', 'ER0590', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('45779010-d372-4e43-8c95-9fb536fed71a', 'ER0480', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('5cb348c0-cb32-4bc8-921e-5a5060e3ab20', 'ER0316', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('30255c31-66eb-4b6c-bb3f-9b10b377406b', 'ER0567', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('af381508-3230-46fa-83ff-3f475f10f587', 'ER0520', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('711ccac0-5db6-4a40-87d8-fcd32a2b3acf', 'ER0515', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('1ab8f840-69cc-4d95-9bcc-2c3be1e8c85e', 'ER0445', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8201', '8202'),
+	('b9e70323-4d3c-4d85-b37a-51408b20daef', 'ER0443', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8201', '8202'),
+	('8bed3ece-ab52-4c39-a568-292173c6fcd9', 'ER0524', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:52:24.810458+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('c4c2be3c-90d1-47cb-bc60-06c4e8cd013b', 'ER0648', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('b0f91568-e627-43a3-801c-9bd48d76acee', 'ER0633', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('8d6dbb50-bc02-42ea-b710-7a9010660b10', 'ER0646', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8101', '8102'),
+	('43264a6d-d466-44db-9318-79cc3fcb6e07', 'ER0322', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '7217d519-4204-43ca-aef1-3e86f3ec240b', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('bfa1959d-1a81-42dc-ada3-fc1d37ed62fd', 'ER0314', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '7217d519-4204-43ca-aef1-3e86f3ec240b', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('4ae8c229-95a4-4809-88de-3fe8dfb1638c', 'ER0274', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '7217d519-4204-43ca-aef1-3e86f3ec240b', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('b4cecb8b-02ef-456f-a459-522869acba78', 'ER0514', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('a8220b03-c9f7-43cd-9953-7b5d364a795e', 'ER0505', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('5ee12fa9-460f-49c8-85be-79d61c4a9502', 'ER0618', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('8ee20396-4242-4470-8ca3-f8fafdac4ce4', 'ER0625', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('9a8a3239-b73c-4be4-b650-dbfd3fdb413a', 'ER0568', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('2472cae8-c8b3-473b-abd1-0354945713de', 'ER0596', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('5697d4e4-eb91-42e7-8167-336b385b150f', 'ER0231', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '7217d519-4204-43ca-aef1-3e86f3ec240b', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('c9278415-c9f5-42cd-8670-883380efeb80', 'ER0491', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('068179db-562b-4a91-89ba-07a160ecb7e3', 'ER0571', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('665e77d9-73da-4fe8-94a0-e46773e01a12', 'ER0606', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('ed5768ff-f773-4f63-8eaa-1ebd28d44df7', 'ER0542', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('f3d4405a-96ce-4045-a920-66666d35386f', 'ER0588', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('5b95f172-6175-4683-aea9-fce7d826d2c4', 'ER0585', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202');
+INSERT INTO freight.wagons VALUES
+	('f746652b-a4e5-4586-8c3f-3a4f3f302cad', 'ER0624', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('1fc8cbde-7e96-45fd-b246-2c26ea787dd2', 'ER0538', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('a0dd5f4e-0721-4d5d-ad96-1d8b59aba127', 'ER0564', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('47c05a8c-b148-45be-b2d7-6c603487b789', 'ER0348', 'efed186d-7062-4b0f-b3fe-6e793accc364', '7217d519-4204-43ca-aef1-3e86f3ec240b', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('4fd338a4-65d3-49d5-b796-2a8bc18902b4', 'ER0236', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '7217d519-4204-43ca-aef1-3e86f3ec240b', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('ee187bcb-a21d-49db-9102-96361dd65aa5', 'ER0421', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:37.064126+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8301', '8302'),
+	('db77b4cf-cfe4-47dc-8513-941f6adb7127', 'ER0558', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:23:39.468205+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('6724c97b-38a8-4bc4-b9bf-70d1255b8921', 'ER0612', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:23:49.408277+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('b23efaa0-1aa4-4b68-8e91-9c9aaf710a0d', 'ER0855', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:23:55.395619+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('341fd519-0318-4c86-abda-89a2698ab2c0', 'ER0566', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:24:00.291962+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('98d238f2-eb50-4390-b019-629c7eec9c4d', 'ER0528', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:24:17.344718+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('d0310dd3-e096-492a-968a-e9421cf6015c', 'ER0292', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '1064cee0-359d-4fa6-9157-975be624f378', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:24:21.60468+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('0837a255-cf38-44b3-9975-902e4bbd28d4', 'ER0484', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:47:36.414656+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('be83d3b4-37d4-4a07-869b-06f0950109a1', 'ER0761', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:14:40.397988+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('2a935be0-4315-48cc-a5cb-eb048a853f40', 'ER0578', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('0aba0d67-baf5-4abb-bed8-74bc27beacad', 'ER0232', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '1064cee0-359d-4fa6-9157-975be624f378', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('c61b4aca-0e57-4d54-a1d7-964283a3296f', 'ER0673', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('f2d12cb0-bb14-425b-a2cb-9d80ba39601f', 'ER0575', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('49d0aad7-b2c2-4e59-95bb-31ac7912b52e', 'ER0250', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '1064cee0-359d-4fa6-9157-975be624f378', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('cf7ca5ce-7bdc-43c7-8c69-413a62254f2a', 'ER0599', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('904ef6a7-8c02-434a-8474-8af1f3f9d37a', 'ER0622', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('ab7f1ba5-e9e2-4677-a885-106a79828b76', 'ER0801', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('a18c96c0-62a3-4f10-b608-7868d251eb8a', 'ER0806', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('2c0b0adc-e42c-4f7a-8a46-9fc03a6700cb', 'ER0594', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('935091f1-7ae6-423b-aad5-3a1b538b423e', 'ER0264', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '1064cee0-359d-4fa6-9157-975be624f378', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('d902aaed-658b-45d0-bcea-da86bf4788e5', 'ER0691', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('1d1d13ee-69f2-4fa1-a12c-5f6cbd87a184', 'ER0562', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('1c8317e0-96ec-41b5-8fd9-632be5c598eb', 'ER0686', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('af761acc-af3c-4c66-9eb4-af1841c14854', 'ER0475', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('0ca7d0b4-1ab5-48c8-b796-513b93cd5f09', 'ER0630', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'MAINTENANCE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:49:50.377355+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '8301', '8302'),
+	('d200843a-fe67-4e5f-994f-63c45d65efd4', 'ER0485', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:39:28.065038+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('397cd1c9-8d31-4f5d-bb2e-d4d7e76e52e0', 'ER0513', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:39:27.805901+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('d558caf1-772c-4c8b-98ad-fba00ca137f0', 'ER0780', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:39:35.783647+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('9c7dfc26-5845-4090-8e0d-9981ca0b5760', 'ER0928', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:41:23.1368+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8201', '8202'),
+	('13670cc8-ba75-4c2d-8061-c6c9d46ea4e9', 'ER0798', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:19:38.877828+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('796c99be-a661-4116-a577-a0110841dc73', 'ER0772', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:47:13.775781+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('40e42fd9-8f27-4ed8-b73b-57cb790907e9', 'ER0522', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:52:13.944854+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('6c5d7287-7744-4336-899d-de15ef5ee98e', 'ER0530', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:53:11.988373+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('6b8f2e94-dc78-49c7-9c8b-b304a7946649', 'ER0540', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:54:58.176862+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('fb9796da-c506-4fa7-b31f-b9e8e33d7e8f', 'ER0550', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:55:07.361004+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('45e0a7d8-cf56-43a4-977b-869ab6a1d6a8', 'ER0649', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:32:36.356068+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('d84a87c7-285c-43b0-928f-f18adf312557', 'ER0641', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:33:32.147243+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('ba1ba21f-f437-4626-bdad-a6466e5bd1a3', 'ER0884', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:34:42.526156+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('68effe36-ac54-4fa3-8d27-45694822afb6', 'ER0451', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('da9c8cca-10db-4aca-8cd3-c883a402f5c6', 'ER0636', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:34:08.888765+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('77164c29-1535-421a-bb0f-e61295ec7966', 'ER0616', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:37:01.468039+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('abb8d3c8-6456-4849-a046-abeed0d3892c', 'ER0502', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:50:14.851716+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('194b9a33-c4b6-4cec-a2ac-4c7dab9023df', 'ER0615', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:37:07.940214+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('875974ae-ee69-45ef-a951-b70a7ecda661', 'ER0614', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:37:15.475288+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('69509819-a586-49be-94b2-52a3efa4bde4', 'ER0876', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:24:12.751373+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('f1197f64-5ed6-4ed7-8d5b-27ca631a3c56', 'ER0454', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 05:34:08.177366+00', NULL, NULL, NULL, NULL, '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '8401', '8402'),
+	('951904eb-60a6-44dd-aada-4be40146f2a0', 'ER0442', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('5cadc015-35dc-4f13-a1df-35bef3acd35f', 'ER0434', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8401', '8402'),
+	('af828445-a3ab-4bae-8f8c-d23d1f88b247', 'ER0704', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:30:17.244448+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('71dab233-6875-4c9e-b6fc-c247c4036441', 'ER0849', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('b8a0540a-b9a2-40f6-ba5f-9de2e615c351', 'ER0870', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('231fd9fc-bd75-4c1b-ad81-116056fbdabf', 'ER0881', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('24be854c-67aa-49eb-ae29-ca992f96a891', 'ER0818', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('b8dfa5f4-2e86-4e8c-a155-5d0f50809c1c', 'ER0561', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:01.675925+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('cb4ec20c-14b5-49ae-b757-a213b5dd9fb5', 'ER0500', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:51:51.833626+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('69df25fe-ef7e-452f-8439-92757bb98b7e', 'ER0602', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:38:29.002392+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('9384462b-53ed-4db9-9267-87ba35af3454', 'ER0658', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:39:40.631309+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('52278b48-c882-4a34-96a8-d937592a2cd8', 'ER0678', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:42:45.869319+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('2b37d9aa-ca9f-4384-8b69-2bb9d71c2bb8', 'ER0664', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:45:41.459175+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('1f9aa084-2778-4973-829d-68ca27665b3d', 'ER0653', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:46:05.353527+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('c66f251f-9119-442c-a4d4-360ccf8c8c20', 'ER0739', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:50:24.134884+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('fcef533e-028d-4f87-b236-6913a6e34343', 'ER0740', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:50:29.652466+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('33235c6c-5314-4adf-a369-0df725e50196', 'ER0730', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:50:42.615435+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('0c63898a-3b42-48c2-a8fa-f777e2d6a28e', 'ER0729', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:51:15.490944+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('ed0fe2bf-e386-4dec-ba8e-d9f5d783df42', 'ER0720', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:52:20.433652+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('2d6b5c20-d9c0-435d-821b-56ac5e4de522', 'ER0715', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:53:24.953084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('ea41d963-cd4e-4e62-b4c9-c4f0411f9131', 'ER0573', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:02:07.935889+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('943ff7f7-7b0e-4488-86c0-b4426bf1abba', 'ER0565', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:02:40.116559+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('0fd9c907-d37b-4538-99a7-819da34072c5', 'ER0563', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:02:55.860491+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('6f2ade5d-c8c0-4bba-9cf6-e813ecf5eb8e', 'ER0682', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:07:37.989164+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('daaaaf4a-6a25-4a5f-98f2-964d7b7baa73', 'ER0755', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:09:31.885127+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('d6baf04f-9f9d-4d0f-92d0-8e11c5e564ec', 'ER0758', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:09:38.257549+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('eddf627c-d875-4ffb-8a21-3f8998958b94', 'ER0789', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:11:32.475749+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('838e35b4-2942-4315-9d47-585784f18ba2', 'ER0787', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:12:29.485236+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('236c1399-a540-414a-8ac1-020d06fc7b9f', 'ER0831', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:16:14.123611+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8301', '8302'),
+	('51f43037-daaf-4478-b355-c23c17555dc3', 'ER0819', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:18:00.37579+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('4c047115-c327-434d-932d-63ce141357bd', 'ER0508', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('d84a08e9-1289-40fc-b6b0-9224a478acba', 'ER0857', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:55:00.23204+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('60777341-9656-4766-9d37-ca61bc740e94', 'ER0756', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('274df441-ac91-444a-a9e7-18c5332157a4', 'ER0940', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:52.397379+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8401', '8402'),
+	('e851adea-3e95-48cb-98e4-91f2c374dbfd', 'ER0781', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:47:58.261716+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('a25bbcfd-a76c-47c4-80f4-5462f98eba3e', 'ER0433', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8501', '8502'),
+	('d13956c5-0131-497d-aa06-d6ca974dd3dc', 'ER0486', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:34:04.735171+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('8888ac2f-6479-460b-adb8-f1ed88f7d465', 'ER0637', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:34:19.946024+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('2b763bbc-9c3f-43da-a5ed-62321792c433', 'ER0736', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:34:19.946024+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('68bfa962-345b-47e2-9730-f3d470042ebb', 'ER0859', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:35:34.919204+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('919b8239-6111-4a55-a04d-2833511cd237', 'ER0483', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:35:45.615394+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('16afed54-73b4-4f63-8d0e-6924296e2714', 'ER0824', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:35:51.205636+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('0c058c2f-f848-4168-8496-eb94a2460307', 'ER0640', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:35:58.355879+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('1f858172-f7a7-4775-99f2-de4c8f1599b2', 'ER0714', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:36:13.414293+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('7dbfcca5-e448-4447-b9d2-80650e252d4e', 'ER0807', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:36:19.65968+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('2dd50754-60fd-47cc-8c6d-9c9c40e5de44', 'ER0289', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:36:29.022924+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('080e52a8-631d-437b-b850-35163d78b2f4', 'ER0587', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:36:41.955353+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('f3d658c3-8843-4095-89c0-a64ebf56b26b', 'ER0902', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:36:53.873848+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('1ed8cf1c-379a-432c-a394-4e38389ebc4b', 'ER0877', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:37:07.300235+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('e2a7ebf1-e9c0-4313-9dd8-e6a9ff138b46', 'ER0748', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:37:18.065988+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('c42e8dcc-a434-4baa-8cc9-741118d06e3c', 'ER0837', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:37:23.822968+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('a36ccca8-465f-4735-a0e8-ec628966bb24', 'ER0307', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:38:12.663759+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('e57a15ce-0c7c-4370-9ed6-9f3d882e21ac', 'ER0707', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:54:30.557466+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('b4a3ef3b-370e-49ec-8c8b-826d3a6f7bd6', 'ER0572', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:02:13.5618+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('e1290c54-fb43-4f12-9c5b-a459bc2aab0c', 'ER0759', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:38:24.55966+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('42f686cf-eb1c-4ca6-b6e1-b6f6d1f19a97', 'ER0847', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:38:32.258877+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('21f7faf3-b36e-4556-9ab2-69f26aeb3d54', 'ER0498', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:39:18.6391+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('3b5a2e8f-7e8d-4a41-807d-ee4d84551d44', 'ER0492', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:39:23.442894+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('316b3d47-e0be-4bc5-b3ba-b0f09d4ae5eb', 'ER0516', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:39:33.969516+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('f92dd7dc-4816-4dbc-b011-10651ae4a7a2', 'ER0735', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:39:40.007965+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('75d2efef-58ef-4d41-b9a7-e4fcba2d4c53', 'ER0503', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:39:58.484825+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('97459b0e-74d6-4153-bc33-620f9e87c39e', 'ER0461', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:40:41.275711+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('a81af5b7-6405-4ee5-9cc9-f38822ab097f', 'ER0243', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:40:54.260382+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('5a52c9f7-7a52-448c-9f7d-ead0f174ee68', 'ER0583', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:41:02.993141+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('0464fba2-8401-4165-b857-d6fbc52c7bb5', 'ER0924', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:41:33.024774+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('6fb151a0-8245-4ac2-bf86-35ae8d7f1a19', 'ER0796', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:34.646553+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('73e010e5-7795-436d-834e-d7bc88e62d24', 'ER0929', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:40.878226+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('8dccb45f-0998-43cf-bcc5-fab443892756', 'ER0713', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:47.99121+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('e3027d75-3682-4b20-9547-6aef2f9fa3d3', 'ER0603', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:42:54.894531+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('673deadd-2682-4dcf-899f-69da0173a09d', 'ER0814', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:43:03.727986+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('cce7dba1-7a8e-451e-a7c3-3e2b0717c400', 'ER0853', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:43:10.689745+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('e5f21090-74ee-489e-905e-d36884fb51aa', 'ER0276', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:43:16.501313+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('0762c3c6-c4e8-481c-8dba-d4e70fe55965', 'ER0262', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:04:40.637988+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('1af2ea11-fe1f-449f-ac06-576e760ee4da', 'ER0234', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:06:26.629054+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('9e2ed2fc-d1e6-474d-8f4d-36e42385af95', 'ER0268', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:08:47.603123+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('866d118c-615e-42cc-a1dc-4fe1a67d0fc0', 'ER0266', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:08:57.082023+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('57234ac6-fb81-43ad-84dd-cf06a50545d8', 'ER0702', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:09:11.073758+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8501', '8502'),
+	('40744a86-23b6-4218-ab1a-5da598f97c5e', 'ER0257', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:09:29.771656+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('f9943ab4-a93c-4bb5-abf1-191392be87ba', 'ER0293', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:19:28.396777+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('4bd640e4-7537-4322-8933-76ded3507e67', 'ER0481', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 41, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:49:54.38912+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('61ca1aac-1a39-4192-99aa-4d00e3ea0bf4', 'ER0471', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:50:09.452803+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('2e2347fe-96fd-48f2-80bf-a30b71f40fba', 'ER0582', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:50:19.269219+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('487faf82-6984-4066-b957-170283eb2502', 'ER0518', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:51:51.812467+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('0dc6cc71-04e7-465e-a0f5-b227e6b0e3cc', 'ER0494', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:27:14.105152+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('8bd92ab9-9765-4eb7-a01a-6574097530fb', 'ER0455', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('b3947e13-5d65-41d1-9797-a3c09dfab4d3', 'ER0553', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:41:56.061927+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('63d8f50e-43a0-4a6f-b0ce-93a5446fe747', 'ER0496', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:02:39.639982+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('c6e5e49c-01fd-4469-a215-e4b2f5ee6ad3', 'ER0444', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 19, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8701', '8702'),
+	('afda74c6-be11-4edc-9c1e-e35a597508df', 'ER0449', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8701', '8702'),
+	('47d7a9f2-aaab-4f69-ba41-5f0c6f49d8e3', 'ER0315', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('48c1be5a-be6d-4200-96b4-6491120d8d00', 'ER0679', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:02:53.561654+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('7302edf1-5fb5-4d3c-9449-a83c3e725157', 'ER0874', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:03:09.155138+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('e7401b73-d18b-4e9a-aa10-8cf873d151c2', 'ER0921', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:03:26.220424+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('efb8c983-9189-42b9-b430-a9379639f2b9', 'ER0910', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 6, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:04:02.537606+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('f31ed177-1e64-4359-9003-ecf58931a661', 'ER0233', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:34:20.19072+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('10f198d2-3b54-43d7-8aa5-9430de9082f0', 'ER0621', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:04:13.936244+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('ff23f5b1-5a1f-474a-98e5-f48dcd8b4b19', 'ER0667', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 8, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:04:24.304456+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('8289cbc1-7dff-4288-a9a5-18a8929d8d2b', 'ER0488', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:06:00.75268+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('68dee723-1260-4471-af9e-b6b375c73be4', 'ER0300', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:06:12.506659+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('bbba1c52-0ddb-41f1-baa4-4805e0f438bc', 'ER0711', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:06:37.566558+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('16f60693-f726-4742-8b47-04b01499fbcb', 'ER0605', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:06:53.014223+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('05bbeb6c-cc82-4ce0-a152-d2d23b7f9eb6', 'ER0897', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:07:04.024124+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('efbdce95-085f-425d-a01b-cbeb73373205', 'ER0769', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:07:32.958024+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('33d00826-3a41-40f2-8ae0-002686a8e3e8', 'ER0487', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:07:45.847164+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('4cadbf93-7b8e-48cf-a640-f4bdf4c37ad6', 'ER0556', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 22, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:08:01.479691+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('6ab7d4b4-cd6a-4987-a489-587e58e108cb', 'ER0580', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:03:04.9069+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('e9ca94f1-c922-4ca7-bf4e-751020ffb45f', 'ER0526', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:08:19.976195+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('4d7aac68-33ef-40eb-be71-b82123419fa0', 'ER0499', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:10:18.368598+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('b35d6dab-15fc-49dd-8add-e5f1f6e45070', 'ER0930', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:16:10.031795+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('0146d917-2f13-4db1-88e9-b93e0299ab92', 'ER0294', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:19:36.816269+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('2795f18c-5a8d-427c-a25b-8c9802755e4e', 'ER0677', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:19:44.681648+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('33084f87-8242-47b4-b631-2aeac1187971', 'ER0628', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:20:27.788097+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('665545ce-656e-4a18-9bda-ccbd5ff9059c', 'ER0545', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 43, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:20:59.4352+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('3616f4ae-7724-4c96-92a8-44b71c3b09a8', 'ER0551', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 44, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:21:08.935341+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('fea5a1ff-d8fa-43f7-9869-d5da233b4c51', 'ER0644', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:21:18.10289+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('8a6a494b-8f17-46f0-9f5d-78c6b2a5bfbd', 'ER0922', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:21:26.161242+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('75a63053-84cd-44f7-b4e9-957b3ef2b6df', 'ER0670', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 47, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:21:46.947497+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('5cb86fbe-971a-4223-a7fd-20020ff9a2df', 'ER0864', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 48, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:21:59.448511+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('a1401309-49bf-4f0e-96c3-8eab117d0ee5', 'ER0629', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 49, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:22:07.180165+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('055f3e4d-de1e-434d-8b87-805ac497a2ae', 'ER0306', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '2012fe72-e966-404d-a5c4-f43ac0e5a767', 50, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:22:17.52151+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8601', '8602'),
+	('ed7d89a6-13f0-406d-8ee9-507a04c82165', 'ER0554', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:42:56.529649+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('89471125-c938-4278-8096-e3ee051caf9c', 'ER0291', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:43:51.137056+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('6f49edbe-affb-40f2-84d9-fcf77fb036d7', 'ER0313', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:43:58.083961+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('663ee624-6a13-43e6-9eb8-32fbce075e48', 'ER0548', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:32.013962+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('75f73e7c-2319-48d2-97ab-c0a619e37738', 'ER0224', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:11.700878+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('4f2742fd-8f95-46d7-8b0b-cd6a451e4214', 'ER0533', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:49.097014+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('8b4d661a-71f6-434e-ab85-1bc1d5a3b0c3', 'ER0263', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:47:29.025325+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('b0b7e1be-b194-4995-885c-6e2958d843bf', 'ER0282', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:47:46.435863+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('80778777-179f-4e84-b1dd-cd5f675b6fae', 'ER0598', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 39, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:49:38.857637+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('18df0e60-b705-4d39-a33a-d0ec7e291f1a', 'ER0909', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:49:45.95559+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('98ff6466-85e7-46e5-85c0-89a69f1e825c', 'ER0854', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 42, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:50:02.041557+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('37b285b3-ae96-4df6-abfe-882592449063', 'ER0890', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 2, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('944cec65-290c-4adb-bf37-5bba91ecaab2', 'ER0436', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '76671a28-3517-4f04-a903-32162959d615', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-06 06:59:31.020502+00', NULL, NULL, NULL, NULL, '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '8801', '8802'),
+	('3e574d77-a75c-43b5-9a5d-e7eebf00c774', 'ER0333', 'efed186d-7062-4b0f-b3fe-6e793accc364', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 07:07:04.410174+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('99c4f48f-5003-4082-a6f2-3fe3ed15fad7', 'ER0878', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '7217d519-4204-43ca-aef1-3e86f3ec240b', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:00:08.066076+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('bd35eec6-c5fb-4c38-baea-fe7ba50962cd', 'ER0569', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('f3216718-a77c-4c42-a99f-9eb514da7396', 'ER0275', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', '6de97a77-dbf1-4099-92ea-295416ab0d97', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('afceec67-89d1-42d2-be9e-5fef516a3fcf', 'ER0788', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '1064cee0-359d-4fa6-9157-975be624f378', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 11:36:07.857037+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('f222881e-7c5b-40bc-b1f3-114a5e4358e5', 'ER0671', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 45, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:50:27.469174+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('57c8ab2a-8d1e-490b-89bd-3f96e974a4e4', 'ER0669', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 5, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:39:52.567764+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('6209ad6b-b6d9-4f9a-a8a2-17da74c3176d', 'ER0608', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:41:30.812272+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('e64fa847-4ec0-4e79-83b9-fa5afbae5418', 'ER0934', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 46, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:51:47.058931+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('58b1bd12-5ccc-4644-891f-5ef55932eaf7', 'ER0683', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 47, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:51:55.175489+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('9375c901-f6fb-4d35-b5bd-0c001edfeb1b', 'ER0610', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:37:39.818756+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('10dc8303-de89-4f10-a538-5ee0e981c14b', 'ER0680', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 48, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:52:04.17187+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('4f8451a0-677b-44c9-89c3-53d83eb73fa7', 'ER0900', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:41:39.251796+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('a0fa7cb0-4dea-4c21-8b51-ecc1a40ff744', 'ER0887', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 11:34:23.215532+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('f2957027-6d40-45a0-85b6-547b167298d6', 'ER0607', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 12, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:42:49.026152+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('48812caa-078b-40c5-963b-4c58582a8ffa', 'ER0726', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:43:05.079718+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('1d6a2e84-b74e-49b0-9155-33fb96861e21', 'ER0619', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:05.703767+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('1b3951e1-869c-4893-a8ec-ba19eab75283', 'ER0775', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 18, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:15.633835+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('c3b6e112-0737-412e-b629-d9cafe653f15', 'ER0891', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 21, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:40.44475+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('14002155-e706-4faa-9e6c-692b356ee8f4', 'ER0904', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:44:57.443494+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('fb79cf42-fc44-410f-b9e9-588e960cf3c8', 'ER0655', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:04.242304+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('e3f59448-8875-439e-ab9d-78c4e55e1848', 'ER0797', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 27, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:26.698979+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('fe723b64-d5e6-45fa-a9fa-45a66b820a5a', 'ER0861', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:46:56.711422+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('b9a5d4c2-a033-4381-b430-d4cd88a97646', 'ER0911', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 33, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:47:12.394628+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('9c9a36b0-ab41-4f71-b201-c0ca06f133f9', 'ER0626', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:47:20.825248+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('21268614-a312-4937-879c-f7e9a9bdd8fc', 'ER0661', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:47:38.289207+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('86bc5f24-7671-44df-baaf-b713a8244039', 'ER0675', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:42:21.29407+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('378faa3e-203e-49e4-90cd-b80bf95d14a5', 'ER0689', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 12:46:42.236405+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8701', '8702'),
+	('3cabfb38-988a-4605-997e-130040b93d0e', 'ER0643', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '56eec969-55ec-4bc5-aad6-f4b7b6d17292', 1, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:34:26.563317+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('55836859-9675-4f86-856a-c80073de52b5', 'ER0889', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '91c02bb9-0f91-46ee-9272-9eecf28734d9', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 13:39:43.569482+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('326d2a65-bf33-4d1e-a76c-0810d2036adc', 'ER0225', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:55:55.688698+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('7fb32462-53f7-4a3c-856d-4253590662f0', 'ER0229', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 08:55:58.611697+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('dd188b68-f0b7-43ff-8363-5cfe1f4055bd', 'ER0893', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 37, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:35:01.249615+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('f2c036bb-7c42-4686-b89a-5d8f906d610c', 'ER0811', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 7, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('291cf4eb-ad94-4652-a992-4b034263390a', 'ER0886', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('fa2538ea-43c4-4d8b-8bff-a3ea8c03a9bf', 'ER0832', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('7ab051e3-2b55-4d68-8921-36decea9b9b5', 'ER0894', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 14, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('9537076b-8a9a-437f-bdef-889a7b5de2b6', 'ER0805', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 16, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('4ff67d14-400d-43cc-b4b8-7660f68f8ae9', 'ER0777', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 20, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('2d271a42-77db-42d0-bd6b-5b45e8a77082', 'ER0827', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 23, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('74d2c682-2e7c-4958-bd96-d0d94952b964', 'ER0896', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 24, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('dbca54d0-c441-4158-a799-c2e841acb304', 'ER0903', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 25, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('e222ec86-744f-41cc-bfeb-37c928e90471', 'ER0895', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('61890424-b2de-41d9-9548-4f9761a1aecd', 'ER0627', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 38, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:35:10.666957+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('4aa20b5a-1b6a-4714-b7a2-beca1643b225', 'ER0908', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 40, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:36:17.486582+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('41b9ccf6-ba71-4e7a-a2b0-9c7ddd82585e', 'ER0809', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('9e05c236-b001-48d1-ac12-ef03b133d2a8', 'ER0659', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 3, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('b8ce6b80-a092-44cd-a0d1-10818fc0735a', 'ER0765', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 4, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('8d7987f2-f39f-4e0b-a6b7-6535e373a7a9', 'ER0743', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 9, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('b5cf14b3-08d8-4036-be39-20d3881f9b40', 'ER0597', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 15, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('9cbb6181-3efe-44e8-ae49-5b9f9e2cdd25', 'ER0913', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 26, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:30:26.315248+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('ed40d486-6625-4cf4-a508-1ab61c25fdcf', 'ER0873', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 28, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:30:37.961809+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('51fad6d7-19ad-4629-8619-7e1f41e1ff26', 'ER0763', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 29, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:31:34.330891+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('42291596-a2ac-45be-8149-ca9def38e038', 'ER0883', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', 'de4eac6f-3138-4cd7-a3a3-471fc8807fac', 34, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 14:16:17.149183+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('743ec23a-5e84-42ca-a6dc-4866c618f80e', 'ER0767', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 31, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:32:20.38135+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('d31e1fae-06d0-40ed-a1fa-79e9d3d4460e', 'ER0751', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-05 13:09:19.62863+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8801', '8802'),
+	('7608a57d-626c-4712-b841-989302584afc', 'ER0589', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 32, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:33:30.570544+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('977d61c0-c035-4da0-826c-5e5c4999ac87', 'ER0512', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 10, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('1d2b9978-bdd3-4447-b78e-012d0a6bbe3f', 'ER0916', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 11, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('54fe2abc-ec97-469e-9e34-0454a6aa7b32', 'ER0638', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 13, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('d1d449c7-2b7d-4775-8f8a-488a73479b92', 'ER0584', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 35, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:34:44.48747+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('fd2990f3-7ec8-4397-80b6-b23b94e94c74', 'ER0866', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 36, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:34:56.495722+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '8901', '8902'),
+	('eb6fc46f-3bf0-45f4-822f-07bf7d01e9fd', 'ER0803', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '0834fc83-c8d2-47e0-8ea3-9d330a054bc3', 30, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 12:41:47.048071+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('dae3c1e0-6b6d-47a2-96c0-0e03ee5c52d9', 'ER0681', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:05.953885+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('0690d5d8-be75-4283-9573-af174323fab7', 'ER0851', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:21.518469+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('9cfc891c-caf2-40d7-9139-68a905e12a3b', 'ER0927', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:32.791152+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('007303f5-d4cf-4637-9ca8-264e0acecac4', 'ER0912', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:34.102104+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('0a2ce50c-bf21-4981-8299-7d13fa3497b2', 'ER0899', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:35.003083+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('76a36173-8fa9-4ce4-ba36-c9ac09cc68e5', 'ER0882', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:36.508437+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('3b17430b-018b-4a98-992d-0f088a36501d', 'ER0810', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:15.758055+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('17bc723a-028b-4699-bf7e-815ba20d548a', 'ER0872', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:37.62904+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('ca1a5c47-1025-4346-a330-b0118bf8b757', 'ER0753', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:11.749403+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('71508fed-a930-4460-9bde-03e415b2694d', 'ER0738', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:10.030633+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('ff7c3c22-7dc3-49ba-ac7f-433791bf230c', 'ER0732', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:08.339289+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('99cfa733-16b2-438b-b4d3-9e1f81d32ea1', 'ER0802', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:14.035966+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('d687bc8e-15f5-433f-ae48-a581550706a0', 'ER0685', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:06.716674+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('e80c15f7-523d-40e3-a5f0-3a392c576422', 'ER0672', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:05.148039+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('39713945-dcae-4add-aca2-dc27134bf5f7', 'ER0836', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:17.244648+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('e49d57cf-ce59-40fb-a8fe-66215ee818ef', 'ER0770', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', '6de97a77-dbf1-4099-92ea-295416ab0d97', 17, 'ASSIGNED', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 10:28:24.970084+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('34d4a9b4-ebe4-4f76-b0cc-5a1acca7bd42', 'ER0754', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:12.426587+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('18913cc8-d661-47be-8f5e-3f9e05d7ca08', 'ER0842', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:18.031555+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('95675688-f08c-4fe1-a424-93fe4894a336', 'ER0741', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:10.864436+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('12ac04b3-e661-46c1-9160-4c0bc1ab2f7d', 'ER0865', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:29.767652+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('4bfced66-c757-4dbb-845a-56f8bbe765e8', 'ER0815', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:16.427655+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('5c4e268a-c656-447f-8dcd-1981c8f7cee0', 'ER0737', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:09.266252+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('8184b800-8425-4362-a4f2-308d73d93cee', 'ER0699', '8f717b09-eec1-46ad-be3d-2dc0a56e55e7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-08-07 09:02:07.564492+00', NULL, NULL, NULL, NULL, 'fc558b95-da28-4fc3-8348-311a290c34ae', '9001', '9002'),
+	('82a24ea2-601e-4045-ab17-538dc2272438', 'ER0152', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2352744b-c10d-4cf0-b36f-4ad36c2a0677', 'ER0153', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2666d867-4813-4daa-8dd7-ebc5f70a21ab', 'ER0261', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9a624605-f4f5-4238-861e-bdb6fbe19db7', 'ER0311', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('253ad40a-a50e-4a04-bb3a-dcc0e14e8abb', 'ER0376', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('11518ee8-fab4-4a1d-bd85-f6f07b7d0541', 'ER0377', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ce694206-518a-4f05-ac55-192ea519dd20', 'ER0378', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d9212a9c-91e4-4bf9-aadb-0982f68023ee', 'ER0379', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e81dc982-f5a9-48d9-a477-e3881cd97347', 'ER0380', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c675f3c3-05e1-482f-8be6-7626648984de', 'ER0381', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9119ecce-935f-489f-aa40-35c81a357637', 'ER0382', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6f442d43-8fdc-4a47-941b-897b8118adfe', 'ER0383', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d4b10557-60b6-4c78-b485-54e131668695', 'ER0384', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('148dc5c8-602d-4037-a5ed-bae92bf2fad6', 'ER0385', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4e2ce2b9-6818-402b-a50c-188995d4fe3a', 'ER0386', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d0a52258-1672-481d-87b4-818d445e27db', 'ER0387', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('86d7948a-a242-4fec-8440-f42a41f4a4b5', 'ER0388', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('921f9015-eb0f-44c6-bc1e-198f47a07354', 'ER0389', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f562ae3e-8c50-482e-8b51-9b7b41318101', 'ER0390', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f6217d1f-68f3-4ee0-b181-a2762cfe1a19', 'ER0942', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('17ea5bb4-8487-4ead-b8e4-89b8711d54b5', 'ER0943', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8f644fd0-62de-4ead-8adf-75320ab65470', 'ER0944', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2af78a0f-0fca-431d-a290-52887b0c2fcd', 'ER0945', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('0508f39e-c950-4602-8d7e-d42cabf175a1', 'ER0946', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9f137ed6-9a36-432a-b01c-3a40fb023beb', 'ER0947', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e55b7f84-285b-4c4a-8b70-70092969133e', 'ER0948', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('47526f83-9b57-4c08-9c6d-82732207234e', 'ER0949', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('0bedca03-367b-470c-bba8-0a7e168f92ae', 'ER0950', 'c900bae3-cc3d-449b-9e8d-e66944ee74b0', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f60950c1-f989-48cd-84ed-9d98732064a8', 'ER0951', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c64ec0ae-da1e-4d7c-af1d-2b9497041cee', 'ER0952', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('0b2dbb6a-5ed6-44f3-b7bb-5d8272a67bf9', 'ER0953', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e8fd5a94-a4d3-4913-8c0b-0a3dfc0a4971', 'ER0954', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4c7c5a2f-a8c9-4a5e-a05f-b6861d368f6b', 'ER0955', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6a3e4821-4e80-4508-bedd-d5b45cd48e04', 'ER0956', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5f4d69a2-d2bd-4bc5-ba7e-52b0f5d8148d', 'ER0957', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6b60f123-a53c-4a2e-a9e6-3cf930204556', 'ER0958', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2e037141-924e-4ad2-b3f7-6d5672a3e389', 'ER0959', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('da2595d2-13c0-4eed-b0e7-ca81d845c075', 'ER0960', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('16b92cd2-23cf-4da7-8fa0-8a13eb1942ff', 'ER0961', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('0434650c-823d-40f4-b504-418257364515', 'ER0962', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('776d0278-8ace-4f61-a206-c014d7b39ef0', 'ER0963', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8e91ac46-c56b-4497-b6c8-ddd64e667229', 'ER0964', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('04674748-3738-4ef1-a309-a682121a2ee2', 'ER0965', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8e5d21ae-5f67-47c1-8e2c-3ca9e20c5bc6', 'ER0966', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9b4d0300-6bf6-4aa6-8ce6-54916180a2f9', 'ER0967', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('39186290-b971-403b-a20e-e6b5eb59dba0', 'ER0968', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7d90c6dc-a55c-4920-a5e2-3bc338263c77', 'ER0070', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2152baca-bdec-4f94-8e69-dbd0f5d14127', 'ER0071', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4860e142-17f4-4cdd-bd47-66385e29841b', 'ER0072', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ec7e98eb-d11e-48b5-ad24-00cfa2d59c7c', 'ER0073', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d69b6e4d-d5d9-4a2b-8115-0f9187d64ae2', 'ER0074', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4e549e4f-345a-431e-bd52-e5a7f64382d3', 'ER0075', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('37cc2c46-29b4-471b-ac14-b477bba1c327', 'ER0076', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('356b53b3-96aa-4492-84af-c2bbb52efaea', 'ER0077', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a0eb134a-eba4-474a-b626-5bc8b36f227c', 'ER0078', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b2dff577-0936-4c18-9d0e-230a7a849961', 'ER0079', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6d16f4b1-2f75-45c1-b2c7-3f40904a1575', 'ER0080', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('10c05111-3911-4ccd-9c3c-37a0987d4173', 'ER0081', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f954b452-4e25-4264-bc13-eb16ca417ba2', 'ER0082', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a1fa9465-a47d-4b95-aa54-0b803e26f602', 'ER0083', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('bb024e14-18c9-406a-b3dc-c2dc307234a8', 'ER0084', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2a26eca4-dc74-4ba1-bf1b-443ea8c19164', 'ER0085', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('260e3c8c-7022-4e81-a70f-fb6d60d14b25', 'ER0086', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('439fd5ed-a5c8-47ee-aafd-a6fb79017983', 'ER0087', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a8608b11-3767-4c1c-834c-3fb11a4f9625', 'ER0088', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d28dcca0-79cf-44f9-bbcc-f05dfb3871d8', 'ER0089', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b345bc32-e194-4109-b05a-2d792f00c7ae', 'ER0090', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a2d5d82b-973b-4382-aba4-d4151d25927a', 'ER0091', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d71f0ea6-7662-4521-9b0e-d0e01af9ac26', 'ER0092', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ddbb0b22-28be-48fc-bc08-1f85f923d827', 'ER0094', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e1dcb1cf-a2aa-431f-afa1-cc24ae5b3302', 'ER0095', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9ac824d7-df2a-4be1-9a4b-b26911728a4a', 'ER0096', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5c30b86c-7ef0-4a5c-ba20-0dcea842c8c9', 'ER0097', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c883e7d4-39b8-4ce4-8d92-11e9985bcdb1', 'ER0098', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b3ccb0fb-b540-4edd-b20b-c600511507d8', 'ER0099', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('538ab731-707b-4b20-ae3e-344fc4b90f44', 'ER0100', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('19139af6-ff29-401f-a637-9ef3b50e6ea6', 'ER0101', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('32f1d7e2-3a53-48ba-a347-ef9164433465', 'ER0102', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3ec374ec-04c4-4e9f-b073-02283d98d944', 'ER0103', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('63ca48e7-7c69-45ea-91aa-623519e7653b', 'ER0104', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8be5aef4-41c2-4f11-95e1-708e74847d20', 'ER0105', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('723d54cc-cb65-431f-a83f-16a8e827fb5b', 'ER0106', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b6b7fed7-231a-4230-992f-6244d3e52bac', 'ER0107', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e47ccd47-3f33-4e50-af06-6ac4d339c411', 'ER0108', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6d217c67-cc0d-40af-ab5d-30c3036fa6be', 'ER0109', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('59999ba9-c609-4dde-9db5-61d7e18dae2d', 'ER0110', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('857396aa-1b93-438f-a1e4-0dacc515213e', 'ER0111', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f728c543-429f-4edf-98a1-3540012b0260', 'ER0112', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('af4ef229-a913-4c9e-a99b-bfa01462f21e', 'ER0113', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('75d100a5-81df-489b-97ca-457dfaf86ed9', 'ER0114', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('95812dc4-47e3-4413-9352-0a0fc8809684', 'ER0115', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('64b095ec-b141-42ad-b8b4-6c5a3b56d647', 'ER0116', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6964d051-7cae-4ea2-b46b-22807f63ad34', 'ER0117', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ac1a30d0-50e8-4471-8d06-0fd09267cec5', 'ER0118', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('cba88223-8555-4d67-821e-5545c8a2ade6', 'ER0119', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9fddbe77-b75c-4a44-b8b5-03d4e504d3c8', 'ER0120', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f902dfa7-b222-4c91-8b80-b926b2d27804', 'ER0121', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e4bca58a-fc36-4def-979f-c01ccf81a0fb', 'ER0122', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('23167608-94ed-4693-b632-ace98e265fc8', 'ER0123', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('dc15efc5-16e7-427e-8ad8-8ee9e77062e7', 'ER0124', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3cd95607-df36-431b-bdf3-b2e23a5ecce5', 'ER0125', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7c0c802d-c780-41c9-9cfc-93b257f919ce', 'ER0126', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5d7c4edb-2d9a-4fd8-bdad-0c27dd964ad5', 'ER0127', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('700eef99-d417-44cc-9117-c7b3e333f568', 'ER0128', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('1e00b5cf-3410-44fb-b9cb-3ae248c28dba', 'ER0129', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('776bc221-b33e-499c-8e4c-a3276c96f1a4', 'ER0130', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('aa9787e5-fe74-4446-bda7-f415e5d9356a', 'ER0131', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4cad29ea-04c3-43c7-8bca-73f2079003fc', 'ER0132', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7bd1d525-6cdd-4563-9869-6b37d57b0d05', 'ER0133', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5c1bbfd4-5c29-4f4e-93bd-8a987aade639', 'ER0134', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('dafc1ab9-6e06-48e9-b6eb-272334176097', 'ER0135', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('1967d81c-38b5-4bec-ab69-899f193325bb', 'ER0136', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6cff2b1c-3059-430a-bc92-f4bbe1f7b89c', 'ER0137', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d7811177-34ee-4b0c-838b-cff212e7dbc2', 'ER0138', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('59eebc43-1100-4d9c-ad44-3e33ed26e220', 'ER0139', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3827bc55-018c-4e63-b141-ae0c694cf912', 'ER0140', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('707cffae-d9e7-4d27-8416-a9402483c052', 'ER0141', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('79ad43db-b334-47e9-992b-753634e8f707', 'ER0142', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('bcb61e30-cfb9-4df9-be16-b2d8a2e60c87', 'ER0143', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2f9c8471-cff2-4831-b225-f52795b6bfb7', 'ER0144', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d167f5a3-89a9-42eb-bb95-a5184bea49c7', 'ER0145', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ca5e87e9-2778-4f8e-a437-f6157ab23d81', 'ER0146', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('16ea60b9-52c2-4835-96f3-195a6fb53338', 'ER0147', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b5fe5fca-e621-4d32-93d3-a1f175b04dd6', 'ER0148', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ed53a790-c644-4d9f-9489-94a4ef64930e', 'ER0149', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('738139c7-b791-4b62-ae15-f2c17142a918', 'ER0150', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('47761149-c4ea-4647-9f5e-08fc74d4534c', 'ER0154', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9b329f3a-469d-4feb-ad76-79650e345650', 'ER0156', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6f24f8e2-03d9-4180-8b50-85c96f5bbbdd', 'ER0157', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('bd9687a5-ccaa-40c0-a30f-5ec9a74faa01', 'ER0158', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5c3259dc-df54-4aa3-b61b-141f6a936956', 'ER0159', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('abdd2d1d-6f30-42a8-b991-7708bc9142b9', 'ER0160', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8f917b2f-201e-4827-816a-db71237ea7b7', 'ER0161', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ac50df2d-eb2b-45a7-93d2-5001fb492412', 'ER0162', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f73a02a7-c502-42b3-a24c-10c6ed56159d', 'ER0163', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c6a1b24e-ba64-437d-9447-de659c3f9ed0', 'ER0164', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('52f7f983-f3eb-4e8b-91ec-4963c050439d', 'ER0165', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('81fa66c6-ef6c-4519-9a56-3b792c6b809f', 'ER0166', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('2d073f4d-b48c-4f1b-b08c-176ad69bbcbf', 'ER0167', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f1f1ecb4-a14f-4eaf-8303-914a31d77758', 'ER0168', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f0742e58-60ef-4a29-830e-800a2e02baa0', 'ER0169', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('64816cec-9b89-4bfd-b3ab-9d141cdd9dea', 'ER0170', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('352d7b66-1bf6-4faa-8107-bdc64aaaf71f', 'ER0171', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('755e4179-018e-464d-a71a-6d8ec4616f38', 'ER0172', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6f52ceb5-a596-4146-a52d-b7e01b896032', 'ER0173', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e68f3425-5bca-44d0-a447-d78ed3107596', 'ER0174', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7b62b6c7-1fee-43c7-875c-70785748e1be', 'ER0175', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5217dd7a-99dd-48c9-8c75-6bb06f890935', 'ER0176', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7763c2c5-ef48-49ed-beec-066a81ba5491', 'ER0177', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('90e65e25-e41d-423d-b9a9-273f87f547d5', 'ER0178', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('57be43c1-7ef5-47db-884d-30b56ed3ef2e', 'ER0179', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d360522b-6747-48a7-abcf-4f85e43beabe', 'ER0180', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('789410cd-fede-4a06-988d-5834ae8580db', 'ER0181', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d44bfc70-5c4a-468c-8a77-f44a82923bb4', 'ER0182', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('80ea2c38-e963-43ff-b709-7a526c9ca492', 'ER0183', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('630e0bb1-3d42-4aca-83b6-7b70ea27a63f', 'ER0184', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8a0117ee-f843-4479-9d31-b0461333b804', 'ER0185', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8a3b746d-4a7d-4e99-be34-ba26e02aa170', 'ER0186', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8c266122-8c3e-47f6-a705-f398bb6af107', 'ER0187', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3c974e56-246b-43a9-b742-ceb8b9d96a93', 'ER0188', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5df59e3a-9ab4-4abd-aa12-47af57732759', 'ER0189', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('69b4bc4c-001c-47ed-9cfe-ce75a1fe094f', 'ER0190', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('945c6183-dc92-489e-a156-741df2f72852', 'ER0191', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b06b0650-4920-4bbe-bcbc-31b5e2c856ee', 'ER0192', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e597d2e8-c148-40aa-8dcf-f5106f332d45', 'ER0193', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('0d9e8732-4e29-44a8-aab0-22ba88a1c974', 'ER0194', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ab1b4606-d336-4d14-9b6c-375735d1993e', 'ER0195', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a4fc2297-dcb7-4e12-94a4-87336dc6daa0', 'ER0196', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('92539eb9-9983-4deb-93d0-d80087c1e36a', 'ER0197', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7c400f6d-5e8b-4b0d-b1e6-82706eb33f3d', 'ER0198', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5c46838e-fe94-4118-bb99-f5e31dcfa90a', 'ER0199', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('325da358-b778-4558-b420-c9a036a3cca5', 'ER0200', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e73b17fb-a74a-4cc5-b0a2-271f2e44c948', 'ER0201', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a69393be-1b43-4126-93a1-594153207d95', 'ER0202', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('863fdbe2-ca4a-42ef-a9de-1d00f7876149', 'ER0203', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9beea13d-25ec-4e55-bb50-4a1fb798bc24', 'ER0204', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('727d6f6d-8b57-469a-b8ab-ef4c049b4e6b', 'ER0205', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('af85bd80-6da7-4727-8247-d9881dfcd6c9', 'ER0206', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('be39365b-eb0d-4e13-ab47-fa78ad6354c9', 'ER0207', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('008b8b08-2556-483d-975f-59621d2dd2d0', 'ER0208', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('17472ed5-5b63-4368-80c9-97c2313c40e2', 'ER0209', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d2c10572-aa46-4d3c-a9d6-be35d0ef98f2', 'ER0210', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a5f04d27-31b0-4e0d-936f-0706f297420c', 'ER0211', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ccca0043-5d89-4eff-a984-43503a74f219', 'ER0212', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3a547c97-e0dc-4732-bd1e-8e0c846bc304', 'ER0213', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('007d5816-58d4-427d-b8b8-f8024fe1675b', 'ER0214', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f5e85a78-d94a-4145-9751-5592f771aaff', 'ER0215', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8fb01995-adf9-48dc-ba35-285c6bab549c', 'ER0216', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('cd1318bf-b81e-49f4-bcf0-7d634c2fe770', 'ER0217', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f6375f89-2072-4644-bfbb-bc6a1be37427', 'ER0218', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8561ed45-3ba4-40e4-9ea1-51a38dbba008', 'ER0219', '8eec3a7d-8482-4397-96b6-59a028210722', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ea7d7949-e359-4622-8c8e-4b55fcf7a979', 'ER0281', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c8979fd7-8098-41d5-a9ae-9a5e14d23a22', 'ER0321', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3b0c8f9c-9d94-4a40-b3ab-c2781ba5d912', 'ER0351', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('023d45a2-69b1-4892-add1-54c048c48b7f', 'ER0352', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d24be559-0ef5-4c3d-9425-9a61f3ddfd9c', 'ER0353', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ef462152-d889-495c-827a-6093bc82b14c', 'ER0354', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5d369e5a-e560-4be9-85d8-9fdcf24478d9', 'ER0355', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('74f29b27-31d6-4c1a-9946-ed1f0db13cc4', 'ER0356', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4bf3f0ed-c7db-49e4-a080-33c876703b99', 'ER0357', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c0df3452-0314-4046-ad36-085b64424cec', 'ER0358', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('94ef6e51-ec61-431f-b0be-39a3d92aa0b9', 'ER0359', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('47a4ee4d-4852-4bfb-8ad8-2834199a6c68', 'ER0360', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d155a909-c38c-40cc-9407-cfd96da9c14a', 'ER0361', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('763f38a9-8231-47c4-a5ad-6cf2cd4f55d1', 'ER0362', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c0ba94a3-8ca5-4591-b89c-e41cc4f0b4d6', 'ER0363', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8e47c26e-3152-4944-ae04-0add9e3450db', 'ER0364', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('68b5c423-bc1d-469a-9e94-b97384c63df1', 'ER0365', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a5d58f28-5804-45f7-8efb-c11b60105b21', 'ER0366', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('13b1a7f5-2f31-4a3d-aa8e-b403d8433bd7', 'ER0367', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('260c0a7a-e225-48f3-9e53-4e47640d0b2c', 'ER0368', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('1cbca24d-fab4-4bdb-a817-7b4228041727', 'ER0369', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('53568596-4b14-430f-ac61-6aaaf94a4550', 'ER0370', 'df1708d4-35dd-4ce2-aa73-f5061e534df7', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('29284c83-7dc9-495f-80b0-45d871922250', 'ER0371', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('58a17ba2-e515-4d69-8189-72392efbc62a', 'ER0372', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ef87c120-d1a4-4e96-aa10-c182bf5bfef3', 'ER0373', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c162a1e3-afb8-443f-8e84-3e25271f9804', 'ER0374', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ebab06d6-3700-4d0d-9edc-251b3761ee23', 'ER0375', '32b8a35f-5792-4c46-aa4f-ca22187faf18', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c3efe06c-f5c0-4414-9042-ecdb05f0a484', 'ER0969', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('67900c79-3d3a-4e5e-83f0-10433c4035e5', 'ER0970', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('af758500-8e0d-4568-827a-a845fbffb71f', 'ER0971', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f3f5b82f-5c8a-44c0-8c01-d03662ee8815', 'ER0972', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b82ae8fa-cdb5-44db-9789-e6cf9121e761', 'ER0973', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('398e15ea-80a7-44fc-894a-ccccf4c8ccdf', 'ER0974', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('310795ad-322c-42e0-9cc1-a27a45c34116', 'ER0975', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8bc227da-d4d1-486e-a497-1c29c03d8d08', 'ER0976', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('72619666-8b90-4c46-91a8-e6f64ee0ce54', 'ER0977', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a4cb83d7-6dd2-44bc-86fa-296f45adeef6', 'ER0978', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('5eacb9c8-1af0-4a6f-a6b0-5b2c95320ec7', 'ER0979', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('991d1fc6-1d79-448d-842b-4ef8524c6ef1', 'ER0980', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL);
+INSERT INTO freight.wagons VALUES
+	('29068caa-c1b9-47d2-bdd8-f4ff0d6faa4e', 'ER0981', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('77cfe49a-f4c9-4c86-a6ac-a2e72a64bac2', 'ER0982', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6aeb0e43-366d-43bf-ba06-95b5887b3b6e', 'ER0984', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e8870f2f-a790-4d3b-990b-f67a12324b20', 'ER0985', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('bbacfaa2-afd9-40f7-b067-56a77e4043db', 'ER0986', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('1dfabd43-cab1-4e34-8455-3d818d66d6f2', 'ER0987', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('1a38286e-ff9b-4e25-a813-960fb9f277f1', 'ER0988', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('83fa77d0-110e-4109-b5e4-e98081f8a9a7', 'ER0989', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7b32b1ff-281e-485d-8b84-4aab0c6533cf', 'ER0990', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f19ebc8a-39a3-4eb0-8fd1-aff36d2d7cad', 'ER0991', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7b355974-ece8-4984-8726-4844ed1d47ac', 'ER0992', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('017a8f86-f4e1-4719-ad21-698826eadc73', 'ER0993', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b9006420-6a1f-4858-9527-c23b7582b9c2', 'ER0994', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('66da1027-6612-4a65-abf6-2d2fa578352b', 'ER0995', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e9890831-5154-4362-b2e4-cf056d073cc1', 'ER0996', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3a5df2fa-406c-466a-8795-317cdb367b63', 'ER0997', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3414ae1a-a963-4e80-b3ad-2f5ab4b9928a', 'ER0998', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f92d6318-34dc-417d-be44-b9ad1d1c293e', 'ER0999', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('904a4532-f9b7-4d45-ab29-05088ec062b4', 'ER1000', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('471fce0e-f504-4d59-a772-62d265024038', 'ER1001', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8bd6a4a6-9c2d-4ba5-b1ff-e33054cdf6b4', 'ER1002', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8a23e93a-8cb0-4d8b-b8d7-a5366805c2ee', 'ER1003', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7a2ade8f-a1bb-4fd9-ba18-226d5d4d80e1', 'ER1004', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('678a6089-e99c-461d-94f6-eb9920567a56', 'ER1005', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('89f94aa8-97f8-412e-8c95-6599df312924', 'ER1006', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('7e60ea43-5bb3-40fc-825a-7861ee58b0b7', 'ER1007', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f3b0222a-46d9-4ebd-9426-9962540ec44f', 'ER1008', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a199f434-12d0-4ce4-978d-3aa5513f8ac6', 'ER1009', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('cd6a5f3c-60c1-4131-a4f2-e66fddf962eb', 'ER1010', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('941a85d3-0840-4d22-a6a1-478113c234d4', 'ER1011', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('be377f74-7604-444a-aaba-cd309d4f6b37', 'ER1012', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d8aa2d10-ff65-4983-846a-c5d1ac56e1ab', 'ER1013', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('16ad37a1-deca-480a-8698-a3d221044220', 'ER1014', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a65e87ef-6e64-4037-8be1-26fee6257ec4', 'ER1015', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ad4dce10-f40d-46b2-ae2e-4739a168abeb', 'ER1016', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('37969895-c798-4129-ad72-7b72e3c699fb', 'ER1017', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a7326afb-3662-436c-aade-0f9be262857f', 'ER1018', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('55d2bad0-d912-4cf5-ac94-fd7244be7194', 'ER1019', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8a466332-4a89-4981-8787-4cca90f38832', 'ER1020', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d1e41312-11b1-4e52-864f-5bcfdc9ce308', 'ER1021', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b9093e3d-f493-449b-bb01-868785acaba7', 'ER1022', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f6be1d0a-6396-424e-898e-ee09fbcca2b2', 'ER1023', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('94c37d67-51df-4bc4-9d05-35e2df11480d', 'ER1024', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d0a52769-71fc-4f9a-a536-878c2915078e', 'ER1025', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('53b6f431-3178-41f0-bebe-b1a44c32047d', 'ER1026', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a7197dd5-6c33-4e50-b098-2465b0580e26', 'ER1027', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('1011ad0e-b814-4df7-aa1a-fc3261f3211f', 'ER1028', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('430f2ef5-807a-4614-94cc-198918b8ec10', 'ER1029', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('889a8897-9d50-44c5-bc11-27bc1bfbc6e7', 'ER1030', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('e6314a38-a81d-4b18-935c-42944acf9907', 'ER1031', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('cb5079e8-2f7d-498d-96cb-89416aa74b40', 'ER1032', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('cd68e488-f1d5-4871-add5-50de8d68a6ee', 'ER1033', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('103d04d8-022e-4b55-974b-d1847be4ad32', 'ER1034', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('bb01453a-c6fa-477c-96a7-2f9050b207d1', 'ER1035', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('d2639563-06c7-4bb5-9378-0aba5fe92fcd', 'ER1036', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6e07f999-55a7-4e82-9fd6-bb58f4080678', 'ER1037', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('265ff8e6-0520-4b5e-a276-9511d61461ba', 'ER1038', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8e6cc4b0-ebb4-456b-9f08-95cc26e846ea', 'ER1039', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('871e6ce5-0cb1-47a9-a78c-0330182e69c1', 'ER1040', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('a61e343c-ea54-41b6-a82d-c84f32093d9a', 'ER1041', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('364119ac-6b89-4ab5-b35f-88dc1396d204', 'ER1042', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('23a36df1-9d31-44ec-babb-a3325013a466', 'ER1043', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('f7a5b48c-a156-455b-a13c-0cf7c6209aad', 'ER1044', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('0c49df63-df1e-454f-827d-0df0d2cbcdb8', 'ER1045', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('fba11112-6ba3-497f-b0ad-71da281c5a55', 'ER1046', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('b55ab787-8c46-4b31-b3be-c3e8037214ba', 'ER1047', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9ac80a38-a97e-43a6-b326-7d2eaba7f433', 'ER1048', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('73618289-ffb6-4a26-a3f5-8f5e1694cb68', 'ER1049', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('baa2700c-bdd2-462c-b883-13b0e763c750', 'ER1050', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('4fc785a0-3a11-48f3-b255-fbcb84f3da39', 'ER1051', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('931b6a3b-9818-4897-a8ea-52229fd57a8d', 'ER1052', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('80a44163-30b1-4578-9c5e-7cb21b3badf0', 'ER1053', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('300433d7-2d65-400a-908d-1d76d16bae52', 'ER1054', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('37a218fe-46b6-4c44-ab80-f7d34a4d16fa', 'ER1055', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('ef03a753-49b0-4946-8296-8062d907b788', 'ER1056', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c831ae05-1800-4a3d-bfbb-c03092d4e5dd', 'ER1057', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('16026fab-92b8-4081-aa11-4b4a5f9d627d', 'ER1058', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('259478c3-71e2-46ac-bfa3-a8e6bee5ad7a', 'ER1059', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('6c311954-96e5-446b-973e-79edb6a3533c', 'ER1060', '07c38e9a-7627-4be9-af41-7651957aca3d', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('8c30540e-2222-4d23-a2ec-0199316fc01a', 'ER1081', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('3a59336e-c0c4-486a-bdbc-2a736ef03ba1', 'ER1082', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('43f15463-4f31-4255-bc63-4a63dc127034', 'ER1083', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('998bb722-7344-421a-8401-3cba3035f999', 'ER1084', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('faced5a6-be31-4fa5-a514-2011ec137285', 'ER1085', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('208fa65d-456a-4c9e-b8e7-9a2691fc0bd7', 'ER1086', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('9f81b959-83e4-4c47-a7f6-82ec00265cdc', 'ER1087', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('fc535bb7-34d7-4b8b-ad12-38d4eb299bcc', 'ER1088', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('c2a8f33c-8a90-409a-be09-cc91f5009d10', 'ER1089', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('18c91bc8-3291-47e5-b5b0-9ee1aff8ff10', 'ER1090', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('92d92907-876d-4c12-8b9f-6721315021dd', 'ER1091', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('05507fd8-f9ff-497a-b33c-d689478edd29', 'ER1092', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('28e1a423-9180-4ea4-9d5a-9fcfbd006e7d', 'ER1093', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('28f8fa14-3a19-431e-a298-e6f1f60bcb73', 'ER1094', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('264a9721-bfbb-4c64-9b5a-860c7e52a626', 'ER1095', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('40bccad2-5129-4038-a5e8-4f5e0737dfb4', 'ER1096', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('20e26fc2-3f97-4a60-8e8e-8b568f7c8a52', 'ER1097', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('094d902a-dccb-4f95-b009-782ff629b4fc', 'ER1098', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('14327e40-f6e9-45ab-9c37-7c4d01536bfa', 'ER1099', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('92c22b8f-5105-4464-afb0-aea84c614c45', 'ER1100', 'f4ba54be-002f-46cb-af7c-ff55ed84dcdd', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, NULL, NULL),
+	('27b00c01-cee9-45ea-b01a-2cd951acb798', 'ER0251', 'bcfcc533-01be-4e82-952c-26e20e7ecdfc', NULL, NULL, 'AVAILABLE', NULL, '2026-07-27 11:32:03.580707+00', '2026-07-27 11:32:03.735237+00', NULL, NULL, NULL, NULL, NULL, '9001', '9002');
+
+
+--
+-- Data for Name: warehouse_accrual_acks; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_activity_log; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_allocation_rules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_fee_rules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_inspection_reports; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_inventory; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_inventory_movement; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_loadings; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_yard_cargo_types; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_yards; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouse_zones; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warehouses; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: warranties; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: weight_limit_rules; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.weight_limit_rules VALUES
+	('be79c917-0fea-4802-bb89-68dcf46b0baf', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'EXPORT', 25.000, '2026-07-18 05:32:03.767+00', '2026-08-04 07:50:53.320369+00', NULL, 30.500),
+	('7e42ab3a-8066-4e84-baaa-891158461ba3', '77cf24ec-e74b-4bdb-b1cc-6f336379cc58', 'IMPORT', 20.000, '2026-07-18 05:31:39.014+00', '2026-08-04 07:51:02.787452+00', NULL, 30.500),
+	('b1ae1430-dbf0-46ae-b9f2-fc76fc065742', '349072e7-8a90-4c03-b682-08976abfd7e8', 'IMPORT', 32.500, '2026-08-04 07:52:28.407742+00', '2026-08-04 07:52:28.407742+00', NULL, 32.500),
+	('876ba9f1-3566-47f9-bbd9-263a1d28377b', '349072e7-8a90-4c03-b682-08976abfd7e8', 'EXPORT', 32.500, '2026-08-04 07:54:08.35154+00', '2026-08-04 07:54:08.35154+00', NULL, 32.500);
+
+
+--
+-- Data for Name: work_orders; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: yard_distances; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.yard_distances VALUES
+	('0e41b970-624d-40ce-9916-d21df7971fd9', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 334.00, '2026-08-04 13:57:03.61038+00', '2026-08-04 13:57:03.61038+00', NULL),
+	('b4c6a03b-d76d-4d63-be02-533113f35cd9', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 869.00, '2026-08-04 13:54:27.291077+00', '2026-08-04 13:54:27.291077+00', NULL),
+	('b8838737-5a3c-4bdc-8a00-7cc2b7ded5f4', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 819.00, '2026-08-04 13:54:43.266791+00', '2026-08-04 13:54:43.266791+00', NULL),
+	('5885bdcc-cf11-430b-af4e-84caa7fb85c8', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', '23fda607-6cc6-4923-b05b-56b7adb1626b', 746.00, '2026-08-04 13:55:00.015441+00', '2026-08-04 13:55:00.015441+00', NULL),
+	('fa4ccacb-0639-4e94-adf8-963625be5a17', '2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 319.00, '2026-08-04 13:55:20.162112+00', '2026-08-04 13:55:20.162112+00', NULL),
+	('38868c91-0a14-4506-9de8-ed0092adc346', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 880.00, '2026-08-04 13:55:58.641536+00', '2026-08-04 13:55:58.641536+00', NULL),
+	('842a108e-abde-45c9-9d35-8548abb44e5c', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 938.00, '2026-08-04 13:56:25.050387+00', '2026-08-04 13:56:25.050387+00', NULL),
+	('6e3180ee-8109-4de9-8ae0-2f895452f73a', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '23fda607-6cc6-4923-b05b-56b7adb1626b', 858.00, '2026-08-04 13:56:42.61084+00', '2026-08-04 13:56:42.61084+00', NULL),
+	('8b6abac3-f031-4e60-bc95-106f75ec3db2', '7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', '1e2fa308-c9eb-4480-840c-e486b1d98029', 918.00, '2026-08-04 13:57:19.60419+00', '2026-08-04 13:57:19.60419+00', NULL),
+	('9e98f4a7-9389-4292-b0b8-59d21cf8a6dd', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 380.00, '2026-08-04 13:57:51.468721+00', '2026-08-04 13:57:51.468721+00', NULL),
+	('292f404c-42de-4d54-b96b-29e9618daa98', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', '1e2fa308-c9eb-4480-840c-e486b1d98029', 535.00, '2026-08-04 13:58:15.75051+00', '2026-08-04 13:58:15.75051+00', NULL),
+	('8801f07c-ae89-409d-aacd-d2e80e75dd58', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 55.40, '2026-08-05 11:13:59.377538+00', '2026-08-05 11:13:59.377538+00', NULL),
+	('47677f2f-f388-40b6-8f75-4801e79292d4', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'fc558b95-da28-4fc3-8348-311a290c34ae', 817.00, '2026-08-05 18:22:07.515643+00', '2026-08-05 18:22:07.515643+00', NULL),
+	('ae036e73-4ca4-4737-8a5c-46cb17482eb6', 'fc558b95-da28-4fc3-8348-311a290c34ae', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', 867.00, '2026-08-05 18:30:33.322191+00', '2026-08-05 18:30:33.322191+00', NULL),
+	('556b8184-59ba-4d18-a4ac-5f552f6c12d8', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 'cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 375.00, '2026-08-05 18:33:00.477338+00', '2026-08-05 18:33:00.477338+00', NULL),
+	('4ca36c39-c89d-4a91-a539-2264191a5393', 'fc558b95-da28-4fc3-8348-311a290c34ae', 'f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 316.00, '2026-08-05 18:35:30.574021+00', '2026-08-05 18:35:30.574021+00', NULL),
+	('f843c946-b905-4546-8817-48125321fe68', '61ae1e66-c229-4dcd-9851-b2b9424f3a95', '23fda607-6cc6-4923-b05b-56b7adb1626b', 76.00, '2026-08-05 18:50:16.919743+00', '2026-08-05 18:50:16.919743+00', NULL);
+
+
+--
+-- Data for Name: yard_facilities; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: yard_locations; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+
+
+--
+-- Data for Name: yards; Type: TABLE DATA; Schema: freight; Owner: -
+--
+
+INSERT INTO freight.yards VALUES
+	('61ae1e66-c229-4dcd-9851-b2b9424f3a95', 'KALITY', 'GMP (Gelan Multipurpose Port)', 'Ethiopia', true, 3, '2026-07-27 11:31:59.400905+00', '2026-08-04 08:45:07.898298+00', NULL, true),
+	('f7b1686f-d43e-42aa-bc6a-d3d5849296c9', 'DIRE_DAWA', 'Dire Dawa Port', 'Ethiopia', true, 12, '2026-07-27 11:31:59.400905+00', '2026-08-04 08:45:58.339151+00', NULL, true),
+	('2187ac77-1d23-4f6c-ada8-e12c9bacd88c', 'NAGAD', 'Nagad Port', 'Djibouti', true, 19, '2026-07-27 11:31:59.400905+00', '2026-08-04 08:46:30.596448+00', NULL, false),
+	('1e2fa308-c9eb-4480-840c-e486b1d98029', 'SEBETA', 'Sebeta', 'Ethiopia', true, 1, '2026-08-04 08:06:27.58091+00', '2026-08-04 08:18:17.610749+00', NULL, true),
+	('e944b82d-5ac0-4843-817b-2fcb6ddb5b06', 'LEBU', 'Lebu', 'Ethiopia', true, 2, '2026-07-17 11:04:12.618+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('6083a69b-d4ad-49bb-be45-95acaba6d197', 'BISHOFTU', 'Bishoftu', 'Ethiopia', true, 4, '2026-07-17 09:22:19.03+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('cea2955d-5da4-4e1c-a3fa-652d94d8df1a', 'MOJO', 'Mojo Dry Port', 'Ethiopia', true, 5, '2026-07-27 11:31:59.400905+00', '2026-08-04 08:18:17.610749+00', NULL, true),
+	('23fda607-6cc6-4923-b05b-56b7adb1626b', 'ADAMA', 'Adama', 'Ethiopia', true, 6, '2026-07-17 09:22:59.392+00', '2026-08-04 08:18:17.610749+00', NULL, true),
+	('6a372083-6f63-42f5-9bac-afd776559945', 'FETO', 'Feto', 'Ethiopia', true, 7, '2026-07-17 09:23:37.716+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('874aa661-2065-436d-b8a8-45238848d520', 'METEHARA', 'Metehara', 'Ethiopia', true, 8, '2026-07-17 09:24:09.157+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('25a0a1ec-dcd3-48cd-9af8-acd611b7bdcf', 'SIRBA', 'Sirba', 'Ethiopia', true, 9, '2026-07-17 09:24:19.496+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('73fccf2b-1eea-4772-a5fc-a4487219bf20', 'MEISO', 'Meiso', 'Ethiopia', true, 10, '2026-07-17 09:24:34.861+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('7c8c8909-be75-4cfa-995f-0e2c58bda71b', 'BIKE', 'Bike', 'Ethiopia', true, 11, '2026-07-17 09:24:51.596+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('65fccdcf-fbbf-42ad-80b1-4fd8f7403325', 'AREWA', 'Arewa', 'Ethiopia', true, 13, '2026-07-17 09:25:06.084+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('59e53178-ba1f-46c6-ae56-86d169a20829', 'ADIGALA', 'Adigala', 'Ethiopia', true, 14, '2026-07-17 09:25:20.638+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('4ca1f68a-be26-473d-ac49-99eeb417e789', 'AYSHAH', 'Ayshah', 'Ethiopia', true, 15, '2026-07-17 09:25:47.277+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('b4cbca40-4256-40cc-b10b-e2e30c7407b0', 'DEWALE', 'Dewale', 'Ethiopia', true, 16, '2026-07-17 09:26:03.099+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('34cd401c-9048-4ed1-b1e7-d1c61b6ecd1f', 'ALISABEH', 'Alisabeh', 'Djibouti', true, 17, '2026-07-17 09:26:43.682+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('5241fc9e-93ac-4844-a20f-c3153bde771c', 'HOLHOL', 'Holhol', 'Djibouti', true, 18, '2026-07-17 09:26:53.991+00', '2026-08-04 08:18:17.610749+00', NULL, false),
+	('fc558b95-da28-4fc3-8348-311a290c34ae', 'DORALEH_FREEZONE', 'DCT/SGTD', 'Djibouti', true, 22, '2026-07-23 07:06:17.982+00', '2026-08-04 13:54:00.862187+00', NULL, false),
+	('7b658678-ce2b-41aa-8dc5-b38ba4a76e9b', 'DORALEH_MULTIPURPOSE_PORT_DMP', 'DMP (Doraleh Multipurpose Port)', 'Djibouti', true, 21, '2026-07-23 07:05:36.326+00', '2026-08-05 21:28:16.030175+00', NULL, true),
+	('7d1b9c9c-372a-41ea-8125-363163fc6351', 'DJIBOUTI', 'Djibouti', 'Djibouti', true, 1, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, false),
+	('91c3912b-036a-4a09-b9f7-f70d0da0b717', 'ADDIS_ABABA', 'Addis Ababa', 'Ethiopia', true, 2, '2026-08-09 20:15:36.202428+00', '2026-08-09 20:15:36.202428+00', NULL, false);
+
+
+--
+-- Name: migrations_id_seq; Type: SEQUENCE SET; Schema: freight; Owner: -
+--
+
+SELECT pg_catalog.setval('freight.migrations_id_seq', 314, true);
+
+
+--
+-- Name: seq_company_profile_ex; Type: SEQUENCE SET; Schema: freight; Owner: -
+--
+
+SELECT pg_catalog.setval('freight.seq_company_profile_ex', 7, true);
+
+
+--
+-- Name: seq_company_profile_ffe; Type: SEQUENCE SET; Schema: freight; Owner: -
+--
+
+SELECT pg_catalog.setval('freight.seq_company_profile_ffe', 1, true);
+
+
+--
+-- Name: seq_company_profile_fwj; Type: SEQUENCE SET; Schema: freight; Owner: -
+--
+
+SELECT pg_catalog.setval('freight.seq_company_profile_fwj', 1, false);
+
+
+--
+-- Name: seq_company_profile_im; Type: SEQUENCE SET; Schema: freight; Owner: -
+--
+
+SELECT pg_catalog.setval('freight.seq_company_profile_im', 7, true);
+
+
+--
+-- Name: seq_company_profile_tr; Type: SEQUENCE SET; Schema: freight; Owner: -
+--
+
+SELECT pg_catalog.setval('freight.seq_company_profile_tr', 1, false);
+
+
+--
+-- Name: approval_rules PK_048d2ffdf7169337b4cc237d772; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.approval_rules
+    ADD CONSTRAINT "PK_048d2ffdf7169337b4cc237d772" PRIMARY KEY (id);
+
+
+--
+-- Name: company_change_request PK_0a57bba5aaf77b376e7fee5fcf8; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_change_request
+    ADD CONSTRAINT "PK_0a57bba5aaf77b376e7fee5fcf8" PRIMARY KEY (id);
+
+
+--
+-- Name: interchange_document_items PK_163803862ca83ef98678e39a43b; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.interchange_document_items
+    ADD CONSTRAINT "PK_163803862ca83ef98678e39a43b" PRIMARY KEY (id);
+
+
+--
+-- Name: company_profiles PK_1980200b310bd1e2ac86aa1ae4a; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_profiles
+    ADD CONSTRAINT "PK_1980200b310bd1e2ac86aa1ae4a" PRIMARY KEY (id);
+
+
+--
+-- Name: service_types PK_1dc93417a097cdee3491f39d7cc; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.service_types
+    ADD CONSTRAINT "PK_1dc93417a097cdee3491f39d7cc" PRIMARY KEY (id);
+
+
+--
+-- Name: train_composition_removal_logs PK_29f7cdb5e0ae32ef1b96155fc9a; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_composition_removal_logs
+    ADD CONSTRAINT "PK_29f7cdb5e0ae32ef1b96155fc9a" PRIMARY KEY (id);
+
+
+--
+-- Name: rates PK_2c804ed4019b80ce48eedba5cec; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.rates
+    ADD CONSTRAINT "PK_2c804ed4019b80ce48eedba5cec" PRIMARY KEY (id);
+
+
+--
+-- Name: facilities PK_2e6c685b2e1195e6d6394a22bc7; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facilities
+    ADD CONSTRAINT "PK_2e6c685b2e1195e6d6394a22bc7" PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_allocation_rules PK_2e7632f009769d4da579c14f151; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_allocation_rules
+    ADD CONSTRAINT "PK_2e7632f009769d4da579c14f151" PRIMARY KEY (id);
+
+
+--
+-- Name: shipping_lines PK_336306f24563d798ec54eedca0c; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.shipping_lines
+    ADD CONSTRAINT "PK_336306f24563d798ec54eedca0c" PRIMARY KEY (id);
+
+
+--
+-- Name: import_djibouti_operations PK_3456f58d03f6719b38c70018ab6; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.import_djibouti_operations
+    ADD CONSTRAINT "PK_3456f58d03f6719b38c70018ab6" PRIMARY KEY (id);
+
+
+--
+-- Name: yards PK_3aa7dacb4c4fb065b1e2f8dfb5a; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yards
+    ADD CONSTRAINT "PK_3aa7dacb4c4fb065b1e2f8dfb5a" PRIMARY KEY (id);
+
+
+--
+-- Name: booking_document_review PK_3d7705ea54a01cb4d6db5b743cd; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_document_review
+    ADD CONSTRAINT "PK_3d7705ea54a01cb4d6db5b743cd" PRIMARY KEY (id);
+
+
+--
+-- Name: exchange_settings PK_48f5730ce6881caf75f279d0a5d; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.exchange_settings
+    ADD CONSTRAINT "PK_48f5730ce6881caf75f279d0a5d" PRIMARY KEY (id);
+
+
+--
+-- Name: container_types PK_50e6b62fcd07ba58bdb6415d47c; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.container_types
+    ADD CONSTRAINT "PK_50e6b62fcd07ba58bdb6415d47c" PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_inspection_reports PK_625df1e3a62e5aa4c3f14e7172e; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inspection_reports
+    ADD CONSTRAINT "PK_625df1e3a62e5aa4c3f14e7172e" PRIMARY KEY (id);
+
+
+--
+-- Name: booking_requests PK_62c29ee249979fe0bcdcde33dae; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_requests
+    ADD CONSTRAINT "PK_62c29ee249979fe0bcdcde33dae" PRIMARY KEY (id);
+
+
+--
+-- Name: first_mile PK_72bc92607db5356f03c2aaeb6ec; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile
+    ADD CONSTRAINT "PK_72bc92607db5356f03c2aaeb6ec" PRIMARY KEY (id);
+
+
+--
+-- Name: first_mile_container_allocations PK_8be4b0df481f8a1555a4fb9d05d; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_container_allocations
+    ADD CONSTRAINT "PK_8be4b0df481f8a1555a4fb9d05d" PRIMARY KEY (id);
+
+
+--
+-- Name: last_mile PK_8be9fbd78fd39e78b6d30ab119b; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile
+    ADD CONSTRAINT "PK_8be9fbd78fd39e78b6d30ab119b" PRIMARY KEY (id);
+
+
+--
+-- Name: booking_rate_snapshot PK_8ca5cf692c4c3e95d91a7343117; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_rate_snapshot
+    ADD CONSTRAINT "PK_8ca5cf692c4c3e95d91a7343117" PRIMARY KEY (id);
+
+
+--
+-- Name: user_trade_access PK_94e21d7bfb20e57940e3255df87; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.user_trade_access
+    ADD CONSTRAINT "PK_94e21d7bfb20e57940e3255df87" PRIMARY KEY (id);
+
+
+--
+-- Name: priority_rules PK_95c73e8a6e80f29d81edf66dbe2; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.priority_rules
+    ADD CONSTRAINT "PK_95c73e8a6e80f29d81edf66dbe2" PRIMARY KEY (id);
+
+
+--
+-- Name: interchange_documents PK_95e5a5484c57ecc6f4a2927ddb4; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.interchange_documents
+    ADD CONSTRAINT "PK_95e5a5484c57ecc6f4a2927ddb4" PRIMARY KEY (id);
+
+
+--
+-- Name: last_mile_container_allocations PK_9d5180799a6dd494156ec980dfb; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_container_allocations
+    ADD CONSTRAINT "PK_9d5180799a6dd494156ec980dfb" PRIMARY KEY (id);
+
+
+--
+-- Name: last_mile_requests PK_be0bf389a4b0f01b05e5eded98b; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_requests
+    ADD CONSTRAINT "PK_be0bf389a4b0f01b05e5eded98b" PRIMARY KEY (id);
+
+
+--
+-- Name: booking_container PK_c1805410bccc51530297b2960ef; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container
+    ADD CONSTRAINT "PK_c1805410bccc51530297b2960ef" PRIMARY KEY (id);
+
+
+--
+-- Name: company_revisions PK_c8ed8b5e0e0d93edffd43c8c024; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_revisions
+    ADD CONSTRAINT "PK_c8ed8b5e0e0d93edffd43c8c024" PRIMARY KEY (id);
+
+
+--
+-- Name: cargo_type_wagon_types PK_cargo_type_wagon_types; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargo_type_wagon_types
+    ADD CONSTRAINT "PK_cargo_type_wagon_types" PRIMARY KEY (cargo_type_id, wagon_type_id);
+
+
+--
+-- Name: djibouti_import_incidents PK_cf3871f27f8bd0db9176f09bf95; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.djibouti_import_incidents
+    ADD CONSTRAINT "PK_cf3871f27f8bd0db9176f09bf95" PRIMARY KEY (id);
+
+
+--
+-- Name: container_type_wagon_types PK_container_type_wagon_types; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.container_type_wagon_types
+    ADD CONSTRAINT "PK_container_type_wagon_types" PRIMARY KEY (container_type_id, wagon_type_id);
+
+
+--
+-- Name: warehouse_fee_rules PK_d24f444e0cb6841c1b19342e134; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_fee_rules
+    ADD CONSTRAINT "PK_d24f444e0cb6841c1b19342e134" PRIMARY KEY (id);
+
+
+--
+-- Name: companies PK_d4bc3e82a314fa9e29f652c2c22; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.companies
+    ADD CONSTRAINT "PK_d4bc3e82a314fa9e29f652c2c22" PRIMARY KEY (id);
+
+
+--
+-- Name: weight_limit_rules PK_d82c70fa7e878ca301e2aaff709; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.weight_limit_rules
+    ADD CONSTRAINT "PK_d82c70fa7e878ca301e2aaff709" PRIMARY KEY (id);
+
+
+--
+-- Name: booking_cargo_modifier PK_d949ef8f1b862135ad7e4afdbf1; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_cargo_modifier
+    ADD CONSTRAINT "PK_d949ef8f1b862135ad7e4afdbf1" PRIMARY KEY (id);
+
+
+--
+-- Name: cargo_types PK_db1aa5f07b0c5ea996eaea03394; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargo_types
+    ADD CONSTRAINT "PK_db1aa5f07b0c5ea996eaea03394" PRIMARY KEY (id);
+
+
+--
+-- Name: dropdown_options PK_dropdown_options; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.dropdown_options
+    ADD CONSTRAINT "PK_dropdown_options" PRIMARY KEY (id);
+
+
+--
+-- Name: dropdown_settings PK_dropdown_settings; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.dropdown_settings
+    ADD CONSTRAINT "PK_dropdown_settings" PRIMARY KEY (id);
+
+
+--
+-- Name: ff_clients PK_eb91bf3ee74a361acee369dbda2; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.ff_clients
+    ADD CONSTRAINT "PK_eb91bf3ee74a361acee369dbda2" PRIMARY KEY (id);
+
+
+--
+-- Name: external_profiles PK_f01bade59a434fa68039620ccb9; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.external_profiles
+    ADD CONSTRAINT "PK_f01bade59a434fa68039620ccb9" PRIMARY KEY (id);
+
+
+--
+-- Name: import_customs_finalizations PK_f67c60e65b732153fc050dd166c; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.import_customs_finalizations
+    ADD CONSTRAINT "PK_f67c60e65b732153fc050dd166c" PRIMARY KEY (id);
+
+
+--
+-- Name: empty_container_returns PK_f82bda09e0ff411811193579948; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.empty_container_returns
+    ADD CONSTRAINT "PK_f82bda09e0ff411811193579948" PRIMARY KEY (id);
+
+
+--
+-- Name: booking_container_allocations PK_fb0dee3634a65d2ebd734ff46e3; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container_allocations
+    ADD CONSTRAINT "PK_fb0dee3634a65d2ebd734ff46e3" PRIMARY KEY (id);
+
+
+--
+-- Name: schedule_wagon_adjustment_logs PK_schedule_wagon_adjustment_logs; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.schedule_wagon_adjustment_logs
+    ADD CONSTRAINT "PK_schedule_wagon_adjustment_logs" PRIMARY KEY (id);
+
+
+--
+-- Name: train_locomotives PK_train_locomotives; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_locomotives
+    ADD CONSTRAINT "PK_train_locomotives" PRIMARY KEY (id);
+
+
+--
+-- Name: train_set_locomotives PK_train_set_locomotives; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_locomotives
+    ADD CONSTRAINT "PK_train_set_locomotives" PRIMARY KEY (id);
+
+
+--
+-- Name: companies UQ_1b3738f728d42fc9aca8d4ac19b; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.companies
+    ADD CONSTRAINT "UQ_1b3738f728d42fc9aca8d4ac19b" UNIQUE (tin);
+
+
+--
+-- Name: ff_clients UQ_4107fef2abf7128f890ef276244; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.ff_clients
+    ADD CONSTRAINT "UQ_4107fef2abf7128f890ef276244" UNIQUE (forwarder_company_id, client_company_id);
+
+
+--
+-- Name: company_profiles UQ_539ff8f8225951adb2ef76b0313; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_profiles
+    ADD CONSTRAINT "UQ_539ff8f8225951adb2ef76b0313" UNIQUE (reference);
+
+
+--
+-- Name: import_djibouti_operations UQ_6c3e3046300b152a13505bf8ffd; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.import_djibouti_operations
+    ADD CONSTRAINT "UQ_6c3e3046300b152a13505bf8ffd" UNIQUE (train_schedule_id);
+
+
+--
+-- Name: first_mile_vehicle_assignments UQ_FIRST_MILE_VEHICLE; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_vehicle_assignments
+    ADD CONSTRAINT "UQ_FIRST_MILE_VEHICLE" UNIQUE (first_mile_id, vehicle_id);
+
+
+--
+-- Name: last_mile_vehicle_assignments UQ_LAST_MILE_VEHICLE; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_vehicle_assignments
+    ADD CONSTRAINT "UQ_LAST_MILE_VEHICLE" UNIQUE (last_mile_id, vehicle_id);
+
+
+--
+-- Name: import_customs_finalizations UQ_ad87af234cc0068a05fa7bd2335; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.import_customs_finalizations
+    ADD CONSTRAINT "UQ_ad87af234cc0068a05fa7bd2335" UNIQUE (booking_id);
+
+
+--
+-- Name: approval_rules UQ_approval_rules_chain_step; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.approval_rules
+    ADD CONSTRAINT "UQ_approval_rules_chain_step" UNIQUE (requires_director_approval, step_order);
+
+
+--
+-- Name: interchange_documents UQ_b44369ad5b13e0d897487fc4284; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.interchange_documents
+    ADD CONSTRAINT "UQ_b44369ad5b13e0d897487fc4284" UNIQUE (document_no);
+
+
+--
+-- Name: facilities UQ_bf808b325b190fb9049254ba55e; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facilities
+    ADD CONSTRAINT "UQ_bf808b325b190fb9049254ba55e" UNIQUE (code);
+
+
+--
+-- Name: user_trade_access UQ_e54889f850f4db112a77b9e8431; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.user_trade_access
+    ADD CONSTRAINT "UQ_e54889f850f4db112a77b9e8431" UNIQUE (user_id);
+
+
+--
+-- Name: asset_acquisitions asset_acquisitions_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.asset_acquisitions
+    ADD CONSTRAINT asset_acquisitions_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: asset_disposals asset_disposals_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.asset_disposals
+    ADD CONSTRAINT asset_disposals_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_batch_offers booking_batch_offers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_batch_offers
+    ADD CONSTRAINT booking_batch_offers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_container_units booking_container_units_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container_units
+    ADD CONSTRAINT booking_container_units_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_contract_signatures booking_contract_signatures_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_contract_signatures
+    ADD CONSTRAINT booking_contract_signatures_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_handovers booking_handovers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_handovers
+    ADD CONSTRAINT booking_handovers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_review_note booking_review_note_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_review_note
+    ADD CONSTRAINT booking_review_note_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_wagon_cancellations booking_wagon_cancellations_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_wagon_cancellations
+    ADD CONSTRAINT booking_wagon_cancellations_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: bookings bookings_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT bookings_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: bookings bookings_reference_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT bookings_reference_key UNIQUE (reference);
+
+
+--
+-- Name: cargoes cargoes_cargo_reference_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargoes
+    ADD CONSTRAINT cargoes_cargo_reference_key UNIQUE (cargo_reference);
+
+
+--
+-- Name: cargoes cargoes_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargoes
+    ADD CONSTRAINT cargoes_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: clearance_incidents clearance_incidents_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.clearance_incidents
+    ADD CONSTRAINT clearance_incidents_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: clearance_milestones clearance_milestones_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.clearance_milestones
+    ADD CONSTRAINT clearance_milestones_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: compliance_records compliance_records_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.compliance_records
+    ADD CONSTRAINT compliance_records_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: containers containers_container_number_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT containers_container_number_key UNIQUE (container_number);
+
+
+--
+-- Name: containers containers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT containers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_approval_steps contract_approval_steps_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_approval_steps
+    ADD CONSTRAINT contract_approval_steps_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_cargo_scope contract_cargo_scope_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_cargo_scope
+    ADD CONSTRAINT contract_cargo_scope_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_clearance_cycles contract_clearance_cycles_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_clearance_cycles
+    ADD CONSTRAINT contract_clearance_cycles_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_document_review contract_document_review_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_document_review
+    ADD CONSTRAINT contract_document_review_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_document_revisions contract_document_revisions_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_document_revisions
+    ADD CONSTRAINT contract_document_revisions_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_rate_snapshots contract_rate_snapshots_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_rate_snapshots
+    ADD CONSTRAINT contract_rate_snapshots_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_review_notes contract_review_notes_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_review_notes
+    ADD CONSTRAINT contract_review_notes_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_routes contract_routes_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_routes
+    ADD CONSTRAINT contract_routes_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_signatures contract_signatures_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_signatures
+    ADD CONSTRAINT contract_signatures_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contract_templates contract_templates_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_templates
+    ADD CONSTRAINT contract_templates_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contracts contracts_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contracts
+    ADD CONSTRAINT contracts_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: contracts contracts_reference_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contracts
+    ADD CONSTRAINT contracts_reference_key UNIQUE (reference);
+
+
+--
+-- Name: customer_truck_assignments customer_truck_assignments_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customer_truck_assignments
+    ADD CONSTRAINT customer_truck_assignments_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: customer_truck_containers customer_truck_containers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customer_truck_containers
+    ADD CONSTRAINT customer_truck_containers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: customers customers_email_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customers
+    ADD CONSTRAINT customers_email_key UNIQUE (email);
+
+
+--
+-- Name: customers customers_fan_number_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customers
+    ADD CONSTRAINT customers_fan_number_key UNIQUE (fan_number);
+
+
+--
+-- Name: customers customers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customers
+    ADD CONSTRAINT customers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: customers customers_tin_number_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customers
+    ADD CONSTRAINT customers_tin_number_key UNIQUE (tin_number);
+
+
+--
+-- Name: drivers drivers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.drivers
+    ADD CONSTRAINT drivers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: eims_system_state eims_system_state_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.eims_system_state
+    ADD CONSTRAINT eims_system_state_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: eims_system_state eims_system_state_system_number_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.eims_system_state
+    ADD CONSTRAINT eims_system_state_system_number_key UNIQUE (system_number);
+
+
+--
+-- Name: facility_handling_events facility_handling_events_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facility_handling_events
+    ADD CONSTRAINT facility_handling_events_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: fayda_verification_sessions fayda_verification_sessions_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fayda_verification_sessions
+    ADD CONSTRAINT fayda_verification_sessions_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: fayda_verification_sessions fayda_verification_sessions_state_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fayda_verification_sessions
+    ADD CONSTRAINT fayda_verification_sessions_state_key UNIQUE (state);
+
+
+--
+-- Name: file_upload_fields file_upload_fields_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.file_upload_fields
+    ADD CONSTRAINT file_upload_fields_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: file_upload_settings file_upload_settings_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.file_upload_settings
+    ADD CONSTRAINT file_upload_settings_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: files files_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.files
+    ADD CONSTRAINT files_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: first_mile_vehicle_assignments first_mile_vehicle_assignments_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_vehicle_assignments
+    ADD CONSTRAINT first_mile_vehicle_assignments_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: fleet_events fleet_events_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fleet_events
+    ADD CONSTRAINT fleet_events_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: gps_devices gps_devices_imei_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.gps_devices
+    ADD CONSTRAINT gps_devices_imei_key UNIQUE (imei);
+
+
+--
+-- Name: gps_devices gps_devices_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.gps_devices
+    ADD CONSTRAINT gps_devices_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: gps_positions gps_positions_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.gps_positions
+    ADD CONSTRAINT gps_positions_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: incidents incidents_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.incidents
+    ADD CONSTRAINT incidents_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: last_mile_vehicle_assignments last_mile_vehicle_assignments_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_vehicle_assignments
+    ADD CONSTRAINT last_mile_vehicle_assignments_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: last_mile_vehicle_containers last_mile_vehicle_containers_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_vehicle_containers
+    ADD CONSTRAINT last_mile_vehicle_containers_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: locomotives locomotives_code_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.locomotives
+    ADD CONSTRAINT locomotives_code_key UNIQUE (code);
+
+
+--
+-- Name: locomotives locomotives_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.locomotives
+    ADD CONSTRAINT locomotives_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: maintenance_costs maintenance_costs_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.maintenance_costs
+    ADD CONSTRAINT maintenance_costs_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: maintenance_intervals maintenance_intervals_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.maintenance_intervals
+    ADD CONSTRAINT maintenance_intervals_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: maintenance_schedules maintenance_schedules_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.maintenance_schedules
+    ADD CONSTRAINT maintenance_schedules_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: migrations migrations_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.migrations
+    ADD CONSTRAINT migrations_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: notifications notifications_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.notifications
+    ADD CONSTRAINT notifications_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: otp_verifications otp_verifications_email_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.otp_verifications
+    ADD CONSTRAINT otp_verifications_email_key UNIQUE (email);
+
+
+--
+-- Name: parts parts_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.parts
+    ADD CONSTRAINT parts_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: consignments pk_consignments; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.consignments
+    ADD CONSTRAINT pk_consignments PRIMARY KEY (id);
+
+
+--
+-- Name: fuel_consumption pk_fuel_consumption; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fuel_consumption
+    ADD CONSTRAINT pk_fuel_consumption PRIMARY KEY (id);
+
+
+--
+-- Name: fuel_purchases pk_fuel_purchases; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fuel_purchases
+    ADD CONSTRAINT pk_fuel_purchases PRIMARY KEY (id);
+
+
+--
+-- Name: invoice_lines pk_invoice_lines; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoice_lines
+    ADD CONSTRAINT pk_invoice_lines PRIMARY KEY (id);
+
+
+--
+-- Name: invoices pk_invoices; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoices
+    ADD CONSTRAINT pk_invoices PRIMARY KEY (id);
+
+
+--
+-- Name: otp_verifications pk_otp_verifications; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.otp_verifications
+    ADD CONSTRAINT pk_otp_verifications PRIMARY KEY (id);
+
+
+--
+-- Name: payment_refunds pk_payment_refunds; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payment_refunds
+    ADD CONSTRAINT pk_payment_refunds PRIMARY KEY (id);
+
+
+--
+-- Name: payment_webhook_events pk_payment_webhook_events; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payment_webhook_events
+    ADD CONSTRAINT pk_payment_webhook_events PRIMARY KEY (id);
+
+
+--
+-- Name: payments pk_payments; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payments
+    ADD CONSTRAINT pk_payments PRIMARY KEY (id);
+
+
+--
+-- Name: tracking_events pk_tracking_events; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.tracking_events
+    ADD CONSTRAINT pk_tracking_events PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_transfer_requests pk_wagon_transfer_requests; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_transfer_requests
+    ADD CONSTRAINT pk_wagon_transfer_requests PRIMARY KEY (id);
+
+
+--
+-- Name: priority_configs priority_configs_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.priority_configs
+    ADD CONSTRAINT priority_configs_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: priority_rule_change_requests priority_rule_change_requests_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.priority_rule_change_requests
+    ADD CONSTRAINT priority_rule_change_requests_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: rate_change_requests rate_change_requests_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.rate_change_requests
+    ADD CONSTRAINT rate_change_requests_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: route_milestones route_milestones_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.route_milestones
+    ADD CONSTRAINT route_milestones_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: routes routes_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.routes
+    ADD CONSTRAINT routes_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: saved_signatures saved_signatures_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.saved_signatures
+    ADD CONSTRAINT saved_signatures_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: scheduling_events scheduling_events_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.scheduling_events
+    ADD CONSTRAINT scheduling_events_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: support_conversations support_conversations_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.support_conversations
+    ADD CONSTRAINT support_conversations_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: support_document_versions support_document_versions_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.support_document_versions
+    ADD CONSTRAINT support_document_versions_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: support_documents support_documents_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.support_documents
+    ADD CONSTRAINT support_documents_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: support_messages support_messages_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.support_messages
+    ADD CONSTRAINT support_messages_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: train_checkpoint_events train_checkpoint_events_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_checkpoint_events
+    ADD CONSTRAINT train_checkpoint_events_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: train_schedule_bookings train_schedule_bookings_booking_id_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedule_bookings
+    ADD CONSTRAINT train_schedule_bookings_booking_id_key UNIQUE (booking_id);
+
+
+--
+-- Name: train_schedule_bookings train_schedule_bookings_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedule_bookings
+    ADD CONSTRAINT train_schedule_bookings_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: train_schedules train_schedules_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedules
+    ADD CONSTRAINT train_schedules_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: train_schedules train_schedules_train_set_id_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedules
+    ADD CONSTRAINT train_schedules_train_set_id_key UNIQUE (train_set_id);
+
+
+--
+-- Name: train_scheduling_global_rules train_scheduling_global_rules_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_scheduling_global_rules
+    ADD CONSTRAINT train_scheduling_global_rules_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: train_set_wagons train_set_wagons_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT train_set_wagons_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: train_sets train_sets_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_sets
+    ADD CONSTRAINT train_sets_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: trains trains_code_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.trains
+    ADD CONSTRAINT trains_code_key UNIQUE (code);
+
+
+--
+-- Name: trains trains_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.trains
+    ADD CONSTRAINT trains_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: transit_agents transit_agents_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.transit_agents
+    ADD CONSTRAINT transit_agents_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: truck_types truck_types_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.truck_types
+    ADD CONSTRAINT truck_types_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: booking_container_units uq_booking_container_unit_number; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container_units
+    ADD CONSTRAINT uq_booking_container_unit_number UNIQUE (booking_container_id, container_number);
+
+
+--
+-- Name: booking_contract_signatures uq_booking_contract_signatures_role; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_contract_signatures
+    ADD CONSTRAINT uq_booking_contract_signatures_role UNIQUE (booking_id, signer_role);
+
+
+--
+-- Name: consignments uq_consignments_tracking_number; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.consignments
+    ADD CONSTRAINT uq_consignments_tracking_number UNIQUE (tracking_number);
+
+
+--
+-- Name: contract_clearance_cycles uq_contract_clearance_cycle; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_clearance_cycles
+    ADD CONSTRAINT uq_contract_clearance_cycle UNIQUE (contract_id, cycle_number);
+
+
+--
+-- Name: contract_cargo_scope uq_contract_container_size; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_cargo_scope
+    ADD CONSTRAINT uq_contract_container_size UNIQUE NULLS NOT DISTINCT (contract_id, container_size);
+
+
+--
+-- Name: contract_document_review uq_contract_document_review_doc; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_document_review
+    ADD CONSTRAINT uq_contract_document_review_doc UNIQUE NULLS NOT DISTINCT (contract_id, clearance_cycle_id, setting_code, file_key);
+
+
+--
+-- Name: contract_routes uq_contract_route; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_routes
+    ADD CONSTRAINT uq_contract_route UNIQUE (contract_id, origin_yard_id, destination_yard_id);
+
+
+--
+-- Name: fuel_consumption uq_fuel_consumption_vehicle_month; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fuel_consumption
+    ADD CONSTRAINT uq_fuel_consumption_vehicle_month UNIQUE (vehicle_id, month);
+
+
+--
+-- Name: invoices uq_invoices_invoice_number; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoices
+    ADD CONSTRAINT uq_invoices_invoice_number UNIQUE (invoice_number);
+
+
+--
+-- Name: otp_verifications uq_otp_verifications_phone; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.otp_verifications
+    ADD CONSTRAINT uq_otp_verifications_phone UNIQUE (phone);
+
+
+--
+-- Name: payment_webhook_events uq_payment_webhook_events_provider_event; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payment_webhook_events
+    ADD CONSTRAINT uq_payment_webhook_events_provider_event UNIQUE (provider, external_event_id);
+
+
+--
+-- Name: payments uq_payments_merchant_order_id; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payments
+    ADD CONSTRAINT uq_payments_merchant_order_id UNIQUE (merchant_order_id);
+
+
+--
+-- Name: payments uq_payments_transaction_id; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payments
+    ADD CONSTRAINT uq_payments_transaction_id UNIQUE (transaction_id);
+
+
+--
+-- Name: route_milestones uq_route_milestones_route_sequence; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.route_milestones
+    ADD CONSTRAINT uq_route_milestones_route_sequence UNIQUE (route_id, sequence_no);
+
+
+--
+-- Name: saved_signatures uq_saved_signatures_user_id; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.saved_signatures
+    ADD CONSTRAINT uq_saved_signatures_user_id UNIQUE (user_id);
+
+
+--
+-- Name: train_schedule_bookings uq_train_schedule_booking; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedule_bookings
+    ADD CONSTRAINT uq_train_schedule_booking UNIQUE (train_schedule_id, booking_id);
+
+
+--
+-- Name: train_set_wagons uq_train_set_wagons_sequence; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT uq_train_set_wagons_sequence UNIQUE (train_set_id, sequence_no);
+
+
+--
+-- Name: warehouse_yards uq_warehouse_yards_code; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_yards
+    ADD CONSTRAINT uq_warehouse_yards_code UNIQUE (warehouse_id, code);
+
+
+--
+-- Name: warehouse_zones uq_warehouse_zones_code; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_zones
+    ADD CONSTRAINT uq_warehouse_zones_code UNIQUE (yard_id, code);
+
+
+--
+-- Name: vehicles vehicles_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.vehicles
+    ADD CONSTRAINT vehicles_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: vehicles vehicles_plate_number_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.vehicles
+    ADD CONSTRAINT vehicles_plate_number_key UNIQUE (plate_number);
+
+
+--
+-- Name: vehicles vehicles_registration_number_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.vehicles
+    ADD CONSTRAINT vehicles_registration_number_key UNIQUE (registration_number);
+
+
+--
+-- Name: vendors vendors_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.vendors
+    ADD CONSTRAINT vendors_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_allocation_bulk_loads wagon_allocation_bulk_loads_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_bulk_loads
+    ADD CONSTRAINT wagon_allocation_bulk_loads_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_allocation_bulk_loads wagon_allocation_bulk_loads_wagon_booking_allocation_id_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_bulk_loads
+    ADD CONSTRAINT wagon_allocation_bulk_loads_wagon_booking_allocation_id_key UNIQUE (wagon_booking_allocation_id);
+
+
+--
+-- Name: wagon_allocation_container_items wagon_allocation_container_items_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_container_items
+    ADD CONSTRAINT wagon_allocation_container_items_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_booking_allocations wagon_booking_allocations_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_booking_allocations
+    ADD CONSTRAINT wagon_booking_allocations_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_movements wagon_movements_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT wagon_movements_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_status_logs wagon_status_logs_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_status_logs
+    ADD CONSTRAINT wagon_status_logs_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagon_types wagon_types_code_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_types
+    ADD CONSTRAINT wagon_types_code_key UNIQUE (code);
+
+
+--
+-- Name: wagon_types wagon_types_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_types
+    ADD CONSTRAINT wagon_types_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: wagons wagons_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT wagons_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_accrual_acks warehouse_accrual_acks_inventory_id_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_accrual_acks
+    ADD CONSTRAINT warehouse_accrual_acks_inventory_id_key UNIQUE (inventory_id);
+
+
+--
+-- Name: warehouse_accrual_acks warehouse_accrual_acks_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_accrual_acks
+    ADD CONSTRAINT warehouse_accrual_acks_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_activity_log warehouse_activity_log_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_activity_log
+    ADD CONSTRAINT warehouse_activity_log_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_inventory_movement warehouse_inventory_movement_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inventory_movement
+    ADD CONSTRAINT warehouse_inventory_movement_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_inventory warehouse_inventory_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inventory
+    ADD CONSTRAINT warehouse_inventory_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_loadings warehouse_loadings_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_loadings
+    ADD CONSTRAINT warehouse_loadings_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_yard_cargo_types warehouse_yard_cargo_types_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_yard_cargo_types
+    ADD CONSTRAINT warehouse_yard_cargo_types_pkey PRIMARY KEY (yard_id, cargo_type_id);
+
+
+--
+-- Name: warehouse_yards warehouse_yards_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_yards
+    ADD CONSTRAINT warehouse_yards_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouse_zones warehouse_zones_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_zones
+    ADD CONSTRAINT warehouse_zones_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warehouses warehouses_code_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouses
+    ADD CONSTRAINT warehouses_code_key UNIQUE (code);
+
+
+--
+-- Name: warehouses warehouses_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouses
+    ADD CONSTRAINT warehouses_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: warranties warranties_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warranties
+    ADD CONSTRAINT warranties_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: work_orders work_orders_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.work_orders
+    ADD CONSTRAINT work_orders_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: yard_distances yard_distances_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_distances
+    ADD CONSTRAINT yard_distances_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: yard_facilities yard_facilities_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_facilities
+    ADD CONSTRAINT yard_facilities_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: yard_locations yard_locations_pkey; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_locations
+    ADD CONSTRAINT yard_locations_pkey PRIMARY KEY (id);
+
+
+--
+-- Name: yard_locations yard_locations_yard_id_key; Type: CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_locations
+    ADD CONSTRAINT yard_locations_yard_id_key UNIQUE (yard_id);
+
+
+--
+-- Name: IDX_1101fbe8e745d91b6bd0747b58; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_1101fbe8e745d91b6bd0747b58" ON freight.ff_clients USING btree (forwarder_company_id);
+
+
+--
+-- Name: IDX_1b3738f728d42fc9aca8d4ac19; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_1b3738f728d42fc9aca8d4ac19" ON freight.companies USING btree (tin);
+
+
+--
+-- Name: IDX_1e57cd6c6afae8f303847f159d; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_1e57cd6c6afae8f303847f159d" ON freight.companies USING btree (type);
+
+
+--
+-- Name: IDX_26d2a16e263ab4fe0a4c8e9195; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_26d2a16e263ab4fe0a4c8e9195" ON freight.external_profiles USING btree (company_id);
+
+
+--
+-- Name: IDX_30228dd283a0f14486346e1db9; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_30228dd283a0f14486346e1db9" ON freight.company_profiles USING btree (company_id);
+
+
+--
+-- Name: IDX_CARGO_TYPES_DISPLAY_ORDER; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_CARGO_TYPES_DISPLAY_ORDER" ON freight.cargo_types USING btree (display_order);
+
+
+--
+-- Name: IDX_CARGO_TYPES_IS_ACTIVE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_CARGO_TYPES_IS_ACTIVE" ON freight.cargo_types USING btree (is_active);
+
+
+--
+-- Name: IDX_CARGO_TYPES_PARENT_GROUP_ID; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_CARGO_TYPES_PARENT_GROUP_ID" ON freight.cargo_types USING btree (parent_group_id);
+
+
+--
+-- Name: IDX_FAYDA_SESSIONS_EXPIRES_AT; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_FAYDA_SESSIONS_EXPIRES_AT" ON freight.fayda_verification_sessions USING btree (expires_at);
+
+
+--
+-- Name: IDX_FAYDA_SESSIONS_IAM_USER_ID; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_FAYDA_SESSIONS_IAM_USER_ID" ON freight.fayda_verification_sessions USING btree (iam_user_id);
+
+
+--
+-- Name: IDX_FILES_RESOURCE_LOOKUP; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_FILES_RESOURCE_LOOKUP" ON freight.files USING btree (resource, resource_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: IDX_FLEET_EVENTS_DRIVER; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_FLEET_EVENTS_DRIVER" ON freight.fleet_events USING btree (driver_id, created_at);
+
+
+--
+-- Name: IDX_FLEET_EVENTS_VEHICLE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_FLEET_EVENTS_VEHICLE" ON freight.fleet_events USING btree (vehicle_id, created_at);
+
+
+--
+-- Name: IDX_FM_VEHICLE_ASSIGNMENTS_VEHICLE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_FM_VEHICLE_ASSIGNMENTS_VEHICLE" ON freight.first_mile_vehicle_assignments USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_GPS_DEVICES_VEHICLE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_GPS_DEVICES_VEHICLE" ON freight.gps_devices USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_GPS_POSITIONS_DEVICE_TIME; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_GPS_POSITIONS_DEVICE_TIME" ON freight.gps_positions USING btree (device_id, gps_time);
+
+
+--
+-- Name: IDX_GPS_POSITIONS_VEHICLE_TIME; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_GPS_POSITIONS_VEHICLE_TIME" ON freight.gps_positions USING btree (vehicle_id, gps_time);
+
+
+--
+-- Name: IDX_INCIDENTS_DRIVER; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_INCIDENTS_DRIVER" ON freight.incidents USING btree (driver_id, occurred_at);
+
+
+--
+-- Name: IDX_INCIDENTS_VEHICLE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_INCIDENTS_VEHICLE" ON freight.incidents USING btree (vehicle_id, occurred_at);
+
+
+--
+-- Name: IDX_LM_VEHICLE_ASSIGNMENTS_VEHICLE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_LM_VEHICLE_ASSIGNMENTS_VEHICLE" ON freight.last_mile_vehicle_assignments USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_NOTIFICATIONS_RECIPIENT_CREATED; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_NOTIFICATIONS_RECIPIENT_CREATED" ON freight.notifications USING btree (recipient_user_id, created_at);
+
+
+--
+-- Name: IDX_NOTIFICATIONS_RECIPIENT_UNREAD; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_NOTIFICATIONS_RECIPIENT_UNREAD" ON freight.notifications USING btree (recipient_user_id, is_read);
+
+
+--
+-- Name: IDX_SERVICE_TYPES_DISPLAY_ORDER; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_SERVICE_TYPES_DISPLAY_ORDER" ON freight.service_types USING btree (display_order);
+
+
+--
+-- Name: IDX_SERVICE_TYPES_IS_ACTIVE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_SERVICE_TYPES_IS_ACTIVE" ON freight.service_types USING btree (is_active);
+
+
+--
+-- Name: IDX_SUPPORT_CONV_COMPANY; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "IDX_SUPPORT_CONV_COMPANY" ON freight.support_conversations USING btree (company_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: IDX_SUPPORT_CONV_LASTMSG; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_SUPPORT_CONV_LASTMSG" ON freight.support_conversations USING btree (last_message_at);
+
+
+--
+-- Name: IDX_SUPPORT_MSG_CONV_CREATED; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_SUPPORT_MSG_CONV_CREATED" ON freight.support_messages USING btree (conversation_id, created_at);
+
+
+--
+-- Name: IDX_af4d6bac2844d39095b2056e97; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_af4d6bac2844d39095b2056e97" ON freight.ff_clients USING btree (client_company_id);
+
+
+--
+-- Name: IDX_b658cd8f6876645a05c0366a56; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_b658cd8f6876645a05c0366a56" ON freight.external_profiles USING btree (user_id);
+
+
+--
+-- Name: IDX_booking_cargo_modifier_rate_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_booking_cargo_modifier_rate_id" ON freight.booking_cargo_modifier USING btree (rate_id);
+
+
+--
+-- Name: IDX_booking_container_allocations_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_booking_container_allocations_booking_id" ON freight.booking_container_allocations USING btree (booking_id);
+
+
+--
+-- Name: IDX_booking_container_allocations_vehicle_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_booking_container_allocations_vehicle_id" ON freight.booking_container_allocations USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_booking_container_units_grn; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_booking_container_units_grn" ON freight.booking_container_units USING btree (grn_number);
+
+
+--
+-- Name: IDX_booking_handovers_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_booking_handovers_booking" ON freight.booking_handovers USING btree (booking_id);
+
+
+--
+-- Name: IDX_cargo_types_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "IDX_cargo_types_code" ON freight.cargo_types USING btree (code);
+
+
+--
+-- Name: IDX_cargoes_container_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_cargoes_container_id" ON freight.cargoes USING btree (container_id);
+
+
+--
+-- Name: IDX_companies_kind; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_companies_kind" ON freight.companies USING btree (kind);
+
+
+--
+-- Name: IDX_container_types_is_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_container_types_is_active" ON freight.container_types USING btree (is_active);
+
+
+--
+-- Name: IDX_container_types_size_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "IDX_container_types_size_code" ON freight.container_types USING btree (code);
+
+
+--
+-- Name: IDX_containers_wagon_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_containers_wagon_id" ON freight.containers USING btree (wagon_id);
+
+
+--
+-- Name: IDX_customer_truck_assignments_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_customer_truck_assignments_booking" ON freight.customer_truck_assignments USING btree (booking_id);
+
+
+--
+-- Name: IDX_customer_truck_containers_assignment; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_customer_truck_containers_assignment" ON freight.customer_truck_containers USING btree (assignment_id);
+
+
+--
+-- Name: IDX_customer_truck_departed; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_customer_truck_departed" ON freight.customer_truck_assignments USING btree (booking_id, departed_at) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: IDX_dc808839c3d64c763cc7f6ff68; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_dc808839c3d64c763cc7f6ff68" ON freight.company_profiles USING btree (type);
+
+
+--
+-- Name: IDX_e669a91069a3aa982b2c99c256; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_e669a91069a3aa982b2c99c256" ON freight.train_composition_removal_logs USING btree (schedule_id);
+
+
+--
+-- Name: IDX_facility_handling_events_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_facility_handling_events_booking" ON freight.facility_handling_events USING btree (booking_id);
+
+
+--
+-- Name: IDX_facility_handling_events_grn; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_facility_handling_events_grn" ON freight.facility_handling_events USING btree (grn_number) WHERE (grn_number IS NOT NULL);
+
+
+--
+-- Name: IDX_facility_handling_events_yard; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_facility_handling_events_yard" ON freight.facility_handling_events USING btree (yard_id);
+
+
+--
+-- Name: IDX_files_open_change_request; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_files_open_change_request" ON freight.files USING btree (resource, resource_id) WHERE (((review_status)::text = 'change_requested'::text) AND (deleted_at IS NULL));
+
+
+--
+-- Name: IDX_files_version_history; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_files_version_history" ON freight.files USING btree (resource, resource_id, code, created_at DESC);
+
+
+--
+-- Name: IDX_first_mile_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_first_mile_booking_id" ON freight.first_mile USING btree (booking_id);
+
+
+--
+-- Name: IDX_first_mile_container_allocations_first_mile_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_first_mile_container_allocations_first_mile_id" ON freight.first_mile_container_allocations USING btree (first_mile_id);
+
+
+--
+-- Name: IDX_first_mile_container_allocations_vehicle_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_first_mile_container_allocations_vehicle_id" ON freight.first_mile_container_allocations USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_first_mile_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_first_mile_status" ON freight.first_mile USING btree (status);
+
+
+--
+-- Name: IDX_first_mile_vehicle_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_first_mile_vehicle_id" ON freight.first_mile USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_freight_customers_email; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_freight_customers_email" ON freight.customers USING btree (email);
+
+
+--
+-- Name: IDX_freight_files_resource; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_freight_files_resource" ON freight.files USING btree (resource_id, resource);
+
+
+--
+-- Name: IDX_freight_files_resource_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_freight_files_resource_code" ON freight.files USING btree (resource_id, resource, code);
+
+
+--
+-- Name: IDX_last_mile_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_booking_id" ON freight.last_mile USING btree (booking_id);
+
+
+--
+-- Name: IDX_last_mile_container_allocations_last_mile_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_container_allocations_last_mile_id" ON freight.last_mile_container_allocations USING btree (last_mile_id);
+
+
+--
+-- Name: IDX_last_mile_container_allocations_vehicle_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_container_allocations_vehicle_id" ON freight.last_mile_container_allocations USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_last_mile_requests_booking_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "IDX_last_mile_requests_booking_schedule" ON freight.last_mile_requests USING btree (booking_id, train_schedule_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: IDX_last_mile_requests_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_requests_status" ON freight.last_mile_requests USING btree (status);
+
+
+--
+-- Name: IDX_last_mile_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_status" ON freight.last_mile USING btree (status);
+
+
+--
+-- Name: IDX_last_mile_vehicle_containers_assignment; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_vehicle_containers_assignment" ON freight.last_mile_vehicle_containers USING btree (assignment_id);
+
+
+--
+-- Name: IDX_last_mile_vehicle_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_last_mile_vehicle_id" ON freight.last_mile USING btree (vehicle_id);
+
+
+--
+-- Name: IDX_locomotive_current_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_locomotive_current_yard_id" ON freight.locomotives USING btree (current_yard_id);
+
+
+--
+-- Name: IDX_maintenance_intervals_vehicle_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_maintenance_intervals_vehicle_type" ON freight.maintenance_intervals USING btree (vehicle_id, maintenance_type);
+
+
+--
+-- Name: IDX_parts_category; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_parts_category" ON freight.parts USING btree (category);
+
+
+--
+-- Name: IDX_priority_rules_is_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_priority_rules_is_active" ON freight.priority_rules USING btree (is_active);
+
+
+--
+-- Name: IDX_rates_destination_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_rates_destination_yard_id" ON freight.rates USING btree (destination_yard_id);
+
+
+--
+-- Name: IDX_rates_origin_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_rates_origin_yard_id" ON freight.rates USING btree (origin_yard_id);
+
+
+--
+-- Name: IDX_rates_trigger; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_rates_trigger" ON freight.rates USING btree (trigger);
+
+
+--
+-- Name: IDX_routes_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_routes_status" ON freight.routes USING btree (status);
+
+
+--
+-- Name: IDX_service_types_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "IDX_service_types_code" ON freight.service_types USING btree (code);
+
+
+--
+-- Name: IDX_swal_train_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_swal_train_id" ON freight.schedule_wagon_adjustment_logs USING btree (train_id);
+
+
+--
+-- Name: IDX_swal_train_schedule_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_swal_train_schedule_id" ON freight.schedule_wagon_adjustment_logs USING btree (train_schedule_id);
+
+
+--
+-- Name: IDX_train_sets_train_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_train_sets_train_id" ON freight.train_sets USING btree (train_id);
+
+
+--
+-- Name: IDX_trains_current_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_trains_current_yard_id" ON freight.trains USING btree (current_yard_id);
+
+
+--
+-- Name: IDX_wagon_current_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_wagon_current_yard_id" ON freight.wagons USING btree (current_yard_id);
+
+
+--
+-- Name: IDX_wagon_movements_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_wagon_movements_schedule" ON freight.wagon_movements USING btree (train_schedule_id);
+
+
+--
+-- Name: IDX_wagon_movements_wagon_occurred; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_wagon_movements_wagon_occurred" ON freight.wagon_movements USING btree (wagon_id, occurred_at);
+
+
+--
+-- Name: IDX_wagons_current_location_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_wagons_current_location_yard_id" ON freight.wagons USING btree (current_location_yard_id);
+
+
+--
+-- Name: IDX_wagons_train_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_wagons_train_id" ON freight.wagons USING btree (train_id);
+
+
+--
+-- Name: IDX_warranties_vehicle_id_expiry_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_warranties_vehicle_id_expiry_date" ON freight.warranties USING btree (vehicle_id, expiry_date);
+
+
+--
+-- Name: IDX_weight_limit_rules_container_type_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_weight_limit_rules_container_type_id" ON freight.weight_limit_rules USING btree (container_type_id);
+
+
+--
+-- Name: IDX_work_orders_vehicle_id_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX "IDX_work_orders_vehicle_id_status" ON freight.work_orders USING btree (vehicle_id, status);
+
+
+--
+-- Name: UQ_DRIVERS_EMAIL_ACTIVE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_DRIVERS_EMAIL_ACTIVE" ON freight.drivers USING btree (email) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_DRIVERS_FAYDA_SUB_ACTIVE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_DRIVERS_FAYDA_SUB_ACTIVE" ON freight.drivers USING btree (fayda_sub) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_DRIVERS_LICENSE_ACTIVE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_DRIVERS_LICENSE_ACTIVE" ON freight.drivers USING btree (license_number) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_DRIVERS_PHONE_ACTIVE; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_DRIVERS_PHONE_ACTIVE" ON freight.drivers USING btree (phone_number) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_booking_handovers_booking_edr_truck; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_booking_handovers_booking_edr_truck" ON freight.booking_handovers USING btree (booking_id, edr_assignment_id) WHERE ((deleted_at IS NULL) AND (edr_assignment_id IS NOT NULL));
+
+
+--
+-- Name: UQ_booking_handovers_booking_truck; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_booking_handovers_booking_truck" ON freight.booking_handovers USING btree (booking_id, truck_assignment_id) WHERE ((deleted_at IS NULL) AND (truck_assignment_id IS NOT NULL));
+
+
+--
+-- Name: UQ_customer_truck_containers_booking_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_customer_truck_containers_booking_number" ON freight.customer_truck_containers USING btree (booking_id, container_number) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_dropdown_options_setting_value; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_dropdown_options_setting_value" ON freight.dropdown_options USING btree (setting_id, value);
+
+
+--
+-- Name: UQ_dropdown_settings_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_dropdown_settings_code" ON freight.dropdown_settings USING btree (code);
+
+
+--
+-- Name: UQ_file_upload_fields_setting_file_key; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_file_upload_fields_setting_file_key" ON freight.file_upload_fields USING btree (setting_id, file_key);
+
+
+--
+-- Name: UQ_file_upload_settings_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_file_upload_settings_code" ON freight.file_upload_settings USING btree (code);
+
+
+--
+-- Name: UQ_last_mile_vehicle_container; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_last_mile_vehicle_container" ON freight.last_mile_vehicle_containers USING btree (last_mile_id, container_number) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_locomotives_name_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_locomotives_name_active" ON freight.locomotives USING btree (lower(btrim((name)::text))) WHERE ((deleted_at IS NULL) AND (name IS NOT NULL) AND (btrim((name)::text) <> ''::text));
+
+
+--
+-- Name: UQ_maintenance_intervals_vehicle_type_item; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_maintenance_intervals_vehicle_type_item" ON freight.maintenance_intervals USING btree (vehicle_id, maintenance_type, COALESCE(service_item, ''::character varying)) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_priority_rules_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_priority_rules_code" ON freight.priority_rules USING btree (code);
+
+
+--
+-- Name: UQ_rates_pattern; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_rates_pattern" ON freight.rates USING btree (rate_type, COALESCE(container_type_id, '00000000-0000-0000-0000-000000000000'::uuid), COALESCE(cargo_type_id, '00000000-0000-0000-0000-000000000000'::uuid), COALESCE(trade_direction, ''::character varying), COALESCE(origin_yard_id, '00000000-0000-0000-0000-000000000000'::uuid), COALESCE(destination_yard_id, '00000000-0000-0000-0000-000000000000'::uuid), rate_unit, COALESCE(min_km, '-1'::numeric)) WHERE ((deleted_at IS NULL) AND ((status)::text <> 'SUPERSEDED'::text));
+
+
+--
+-- Name: UQ_shipping_lines_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_shipping_lines_code" ON freight.shipping_lines USING btree (code);
+
+
+--
+-- Name: UQ_train_locomotives_train_loco; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_train_locomotives_train_loco" ON freight.train_locomotives USING btree (train_id, locomotive_id);
+
+
+--
+-- Name: UQ_train_set_locomotives_set_loco; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_train_set_locomotives_set_loco" ON freight.train_set_locomotives USING btree (train_set_id, locomotive_id);
+
+
+--
+-- Name: UQ_trains_export_train_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_trains_export_train_number" ON freight.trains USING btree (export_train_number) WHERE (export_train_number IS NOT NULL);
+
+
+--
+-- Name: UQ_trains_import_train_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_trains_import_train_number" ON freight.trains USING btree (import_train_number) WHERE (import_train_number IS NOT NULL);
+
+
+--
+-- Name: UQ_trains_train_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_trains_train_number" ON freight.trains USING btree (train_number) WHERE (train_number IS NOT NULL);
+
+
+--
+-- Name: UQ_wagons_wagon_number_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_wagons_wagon_number_active" ON freight.wagons USING btree (wagon_number) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_weight_limit_rules_pattern; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_weight_limit_rules_pattern" ON freight.weight_limit_rules USING btree (container_type_id, trade_direction) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_yard_facility_yard; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_yard_facility_yard" ON freight.yard_facilities USING btree (yard_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_yards_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_yards_code" ON freight.yards USING btree (code);
+
+
+--
+-- Name: UQ_yards_code_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_yards_code_active" ON freight.yards USING btree (lower(TRIM(BOTH FROM code))) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: UQ_yards_label_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX "UQ_yards_label_active" ON freight.yards USING btree (lower(TRIM(BOTH FROM label))) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: idx_asset_acquisitions_vehicle_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_asset_acquisitions_vehicle_date ON freight.asset_acquisitions USING btree (vehicle_id, acquisition_date);
+
+
+--
+-- Name: idx_asset_disposals_vehicle_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_asset_disposals_vehicle_date ON freight.asset_disposals USING btree (vehicle_id, disposal_date);
+
+
+--
+-- Name: idx_booking_batch_offers_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_batch_offers_booking ON freight.booking_batch_offers USING btree (booking_id);
+
+
+--
+-- Name: idx_booking_batch_offers_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_batch_offers_schedule ON freight.booking_batch_offers USING btree (train_schedule_id);
+
+
+--
+-- Name: idx_booking_batch_offers_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_batch_offers_status ON freight.booking_batch_offers USING btree (status);
+
+
+--
+-- Name: idx_booking_contract_signatures_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_contract_signatures_booking_id ON freight.booking_contract_signatures USING btree (booking_id);
+
+
+--
+-- Name: idx_booking_document_review_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_document_review_booking ON freight.booking_document_review USING btree (booking_id);
+
+
+--
+-- Name: idx_booking_document_review_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_document_review_status ON freight.booking_document_review USING btree (status);
+
+
+--
+-- Name: idx_booking_requests_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_requests_contract ON freight.booking_requests USING btree (contract_id);
+
+
+--
+-- Name: idx_booking_requests_contract_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_requests_contract_status ON freight.booking_requests USING btree (contract_id, status);
+
+
+--
+-- Name: idx_booking_requests_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_requests_status ON freight.booking_requests USING btree (status);
+
+
+--
+-- Name: idx_booking_review_note_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_booking_review_note_booking_id ON freight.booking_review_note USING btree (booking_id);
+
+
+--
+-- Name: idx_bookings_booking_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_booking_type ON freight.bookings USING btree (booking_type);
+
+
+--
+-- Name: idx_bookings_company_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_company_id ON freight.bookings USING btree (company_id);
+
+
+--
+-- Name: idx_bookings_company_profile_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_company_profile_id ON freight.bookings USING btree (company_profile_id);
+
+
+--
+-- Name: idx_bookings_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_contract ON freight.bookings USING btree (contract_id);
+
+
+--
+-- Name: idx_bookings_is_government; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_is_government ON freight.bookings USING btree (is_government) WHERE ((is_government = true) AND (deleted_at IS NULL));
+
+
+--
+-- Name: idx_bookings_route_day; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_route_day ON freight.bookings USING btree (origin_yard_id, destination_yard_id, scheduled_date, status) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: idx_bookings_scheduling_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_scheduling_status ON freight.bookings USING btree (scheduling_status);
+
+
+--
+-- Name: idx_bookings_train_schedule_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bookings_train_schedule_id ON freight.bookings USING btree (train_schedule_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: idx_bwc_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bwc_booking ON freight.booking_wagon_cancellations USING btree (booking_id);
+
+
+--
+-- Name: idx_bwc_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_bwc_status ON freight.booking_wagon_cancellations USING btree (status);
+
+
+--
+-- Name: idx_clearance_incidents_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_clearance_incidents_booking ON freight.clearance_incidents USING btree (booking_id);
+
+
+--
+-- Name: idx_clearance_milestones_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_clearance_milestones_booking ON freight.clearance_milestones USING btree (booking_id);
+
+
+--
+-- Name: idx_clearance_milestones_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_clearance_milestones_contract ON freight.clearance_milestones USING btree (contract_id);
+
+
+--
+-- Name: idx_clearance_milestones_region; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_clearance_milestones_region ON freight.clearance_milestones USING btree (owner_region, status);
+
+
+--
+-- Name: idx_company_change_request_company; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_company_change_request_company ON freight.company_change_request USING btree (company_id);
+
+
+--
+-- Name: idx_company_change_request_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_company_change_request_status ON freight.company_change_request USING btree (status);
+
+
+--
+-- Name: idx_company_revisions_company; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_company_revisions_company ON freight.company_revisions USING btree (company_id);
+
+
+--
+-- Name: idx_compliance_records_expiry_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_compliance_records_expiry_date ON freight.compliance_records USING btree (expiry_date);
+
+
+--
+-- Name: idx_compliance_records_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_compliance_records_type ON freight.compliance_records USING btree (type);
+
+
+--
+-- Name: idx_compliance_records_vehicle_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_compliance_records_vehicle_id ON freight.compliance_records USING btree (vehicle_id);
+
+
+--
+-- Name: idx_contract_approval_steps_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_approval_steps_contract ON freight.contract_approval_steps USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_cargo_scope_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_cargo_scope_contract ON freight.contract_cargo_scope USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_clearance_cycles_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_clearance_cycles_contract ON freight.contract_clearance_cycles USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_doc_review_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_doc_review_contract ON freight.contract_document_review USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_doc_review_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_doc_review_status ON freight.contract_document_review USING btree (status);
+
+
+--
+-- Name: idx_contract_document_revisions_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_document_revisions_contract ON freight.contract_document_revisions USING btree (contract_id, created_at DESC);
+
+
+--
+-- Name: idx_contract_rate_snapshots_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_rate_snapshots_contract ON freight.contract_rate_snapshots USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_review_notes_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_review_notes_contract ON freight.contract_review_notes USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_routes_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_routes_contract ON freight.contract_routes USING btree (contract_id);
+
+
+--
+-- Name: idx_contract_signatures_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contract_signatures_contract ON freight.contract_signatures USING btree (contract_id);
+
+
+--
+-- Name: idx_contracts_company; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contracts_company ON freight.contracts USING btree (company_id);
+
+
+--
+-- Name: idx_contracts_kind; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contracts_kind ON freight.contracts USING btree (contract_kind);
+
+
+--
+-- Name: idx_contracts_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contracts_status ON freight.contracts USING btree (status);
+
+
+--
+-- Name: idx_contracts_valid_until; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_contracts_valid_until ON freight.contracts USING btree (contract_valid_until);
+
+
+--
+-- Name: idx_djibouti_incidents_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_djibouti_incidents_booking ON freight.djibouti_import_incidents USING btree (booking_id);
+
+
+--
+-- Name: idx_djibouti_incidents_container; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_djibouti_incidents_container ON freight.djibouti_import_incidents USING btree (container_number);
+
+
+--
+-- Name: idx_djibouti_incidents_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_djibouti_incidents_type ON freight.djibouti_import_incidents USING btree (incident_type);
+
+
+--
+-- Name: idx_drivers_email; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_drivers_email ON freight.drivers USING btree (email);
+
+
+--
+-- Name: idx_drivers_license_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_drivers_license_number ON freight.drivers USING btree (license_number);
+
+
+--
+-- Name: idx_drivers_phone_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_drivers_phone_number ON freight.drivers USING btree (phone_number);
+
+
+--
+-- Name: idx_drivers_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_drivers_status ON freight.drivers USING btree (status);
+
+
+--
+-- Name: idx_empty_returns_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_empty_returns_booking ON freight.empty_container_returns USING btree (booking_id);
+
+
+--
+-- Name: idx_empty_returns_container; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_empty_returns_container ON freight.empty_container_returns USING btree (container_number);
+
+
+--
+-- Name: idx_empty_returns_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_empty_returns_status ON freight.empty_container_returns USING btree (status);
+
+
+--
+-- Name: idx_facilities_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX idx_facilities_code ON freight.facilities USING btree (code);
+
+
+--
+-- Name: idx_facilities_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_facilities_status ON freight.facilities USING btree (facility_status);
+
+
+--
+-- Name: idx_files_resource_lookup; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_files_resource_lookup ON freight.files USING btree (resource, resource_id);
+
+
+--
+-- Name: idx_fuel_consumption_vehicle_month; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_fuel_consumption_vehicle_month ON freight.fuel_consumption USING btree (vehicle_id, month);
+
+
+--
+-- Name: idx_fuel_purchases_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_fuel_purchases_date ON freight.fuel_purchases USING btree (purchase_date);
+
+
+--
+-- Name: idx_fuel_purchases_vehicle; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_fuel_purchases_vehicle ON freight.fuel_purchases USING btree (vehicle_id);
+
+
+--
+-- Name: idx_import_customs_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_import_customs_booking ON freight.import_customs_finalizations USING btree (booking_id);
+
+
+--
+-- Name: idx_import_customs_risk; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_import_customs_risk ON freight.import_customs_finalizations USING btree (customs_risk);
+
+
+--
+-- Name: idx_import_djibouti_operations_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_import_djibouti_operations_schedule ON freight.import_djibouti_operations USING btree (train_schedule_id);
+
+
+--
+-- Name: idx_interchange_documents_direction; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_interchange_documents_direction ON freight.interchange_documents USING btree (direction);
+
+
+--
+-- Name: idx_interchange_documents_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_interchange_documents_schedule ON freight.interchange_documents USING btree (schedule_id);
+
+
+--
+-- Name: idx_interchange_documents_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_interchange_documents_status ON freight.interchange_documents USING btree (status);
+
+
+--
+-- Name: idx_interchange_items_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_interchange_items_booking ON freight.interchange_document_items USING btree (booking_id);
+
+
+--
+-- Name: idx_interchange_items_document; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_interchange_items_document ON freight.interchange_document_items USING btree (interchange_document_id);
+
+
+--
+-- Name: idx_invoice_lines_invoice; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_invoice_lines_invoice ON freight.invoice_lines USING btree (invoice_id);
+
+
+--
+-- Name: idx_invoices_company; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_invoices_company ON freight.invoices USING btree (company_id);
+
+
+--
+-- Name: idx_invoices_company_profile; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_invoices_company_profile ON freight.invoices USING btree (company_profile_id);
+
+
+--
+-- Name: idx_invoices_source; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_invoices_source ON freight.invoices USING btree (source, source_id);
+
+
+--
+-- Name: idx_invoices_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_invoices_status ON freight.invoices USING btree (status);
+
+
+--
+-- Name: idx_locomotives_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_locomotives_status ON freight.locomotives USING btree (status);
+
+
+--
+-- Name: idx_maintenance_costs_vehicle_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_maintenance_costs_vehicle_date ON freight.maintenance_costs USING btree (vehicle_id, incurred_date);
+
+
+--
+-- Name: idx_maintenance_schedules_vehicle_date; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_maintenance_schedules_vehicle_date ON freight.maintenance_schedules USING btree (vehicle_id, scheduled_date);
+
+
+--
+-- Name: idx_payment_webhook_events_merchant_order_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_payment_webhook_events_merchant_order_id ON freight.payment_webhook_events USING btree (merchant_order_id);
+
+
+--
+-- Name: idx_prcr_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_prcr_status ON freight.priority_rule_change_requests USING btree (status);
+
+
+--
+-- Name: idx_priority_configs_currency_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_priority_configs_currency_type ON freight.priority_configs USING btree (currency, type);
+
+
+--
+-- Name: idx_priority_configs_type_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_priority_configs_type_active ON freight.priority_configs USING btree (type, is_active);
+
+
+--
+-- Name: idx_rcr_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_rcr_status ON freight.rate_change_requests USING btree (status);
+
+
+--
+-- Name: idx_route_milestones_route_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_route_milestones_route_id ON freight.route_milestones USING btree (route_id);
+
+
+--
+-- Name: idx_route_milestones_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_route_milestones_yard_id ON freight.route_milestones USING btree (yard_id);
+
+
+--
+-- Name: idx_routes_destination_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_routes_destination_yard_id ON freight.routes USING btree (destination_yard_id);
+
+
+--
+-- Name: idx_routes_origin_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_routes_origin_yard_id ON freight.routes USING btree (origin_yard_id);
+
+
+--
+-- Name: idx_scheduling_events_train_schedule_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_scheduling_events_train_schedule_id ON freight.scheduling_events USING btree (train_schedule_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: idx_support_doc_versions_document; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_support_doc_versions_document ON freight.support_document_versions USING btree (document_id);
+
+
+--
+-- Name: idx_train_checkpoint_events_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_checkpoint_events_schedule ON freight.train_checkpoint_events USING btree (train_schedule_id, sequence_no) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: idx_train_schedules_booking_window_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_schedules_booking_window_status ON freight.train_schedules USING btree (booking_window_status) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: idx_train_schedules_departure_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_schedules_departure_status ON freight.train_schedules USING btree (scheduled_departure_date, status);
+
+
+--
+-- Name: idx_train_schedules_route_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_schedules_route_id ON freight.train_schedules USING btree (route_id);
+
+
+--
+-- Name: idx_train_schedules_train_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_schedules_train_number ON freight.train_schedules USING btree (train_number);
+
+
+--
+-- Name: idx_train_schedules_window_phase; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_schedules_window_phase ON freight.train_schedules USING btree (window_phase) WHERE (window_phase IS NOT NULL);
+
+
+--
+-- Name: idx_train_set_wagons_physical_wagon; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_set_wagons_physical_wagon ON freight.train_set_wagons USING btree (physical_wagon_id);
+
+
+--
+-- Name: idx_train_sets_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_train_sets_status ON freight.train_sets USING btree (status);
+
+
+--
+-- Name: idx_user_trade_access_user_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_user_trade_access_user_id ON freight.user_trade_access USING btree (user_id);
+
+
+--
+-- Name: idx_vehicles_manufacturer; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_vehicles_manufacturer ON freight.vehicles USING btree (manufacturer);
+
+
+--
+-- Name: idx_vehicles_plate_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_vehicles_plate_number ON freight.vehicles USING btree (plate_number);
+
+
+--
+-- Name: idx_vehicles_registration_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_vehicles_registration_number ON freight.vehicles USING btree (registration_number);
+
+
+--
+-- Name: idx_vehicles_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_vehicles_status ON freight.vehicles USING btree (status);
+
+
+--
+-- Name: idx_vehicles_vehicle_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_vehicles_vehicle_type ON freight.vehicles USING btree (vehicle_type);
+
+
+--
+-- Name: idx_wabl_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wabl_booking ON freight.wagon_allocation_bulk_loads USING btree (booking_id);
+
+
+--
+-- Name: idx_waci_allocation; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_waci_allocation ON freight.wagon_allocation_container_items USING btree (wagon_booking_allocation_id);
+
+
+--
+-- Name: idx_wagon_booking_allocations_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wagon_booking_allocations_booking ON freight.wagon_booking_allocations USING btree (booking_id);
+
+
+--
+-- Name: idx_wagon_status_logs_wagon; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wagon_status_logs_wagon ON freight.wagon_status_logs USING btree (wagon_id, created_at DESC);
+
+
+--
+-- Name: idx_wagons_current_train_schedule_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wagons_current_train_schedule_id ON freight.wagons USING btree (current_train_schedule_id);
+
+
+--
+-- Name: idx_wagons_train_set_wagon_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wagons_train_set_wagon_id ON freight.wagons USING btree (train_set_wagon_id);
+
+
+--
+-- Name: idx_war_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_war_active ON freight.warehouse_allocation_rules USING btree (is_active);
+
+
+--
+-- Name: idx_war_priority; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_war_priority ON freight.warehouse_allocation_rules USING btree (priority);
+
+
+--
+-- Name: idx_warehouse_activity_log_activity_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_activity_log_activity_type ON freight.warehouse_activity_log USING btree (activity_type);
+
+
+--
+-- Name: idx_warehouse_activity_log_inventory_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_activity_log_inventory_id ON freight.warehouse_activity_log USING btree (inventory_id);
+
+
+--
+-- Name: idx_warehouse_activity_log_warehouse_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_activity_log_warehouse_id ON freight.warehouse_activity_log USING btree (warehouse_id);
+
+
+--
+-- Name: idx_warehouse_inventory_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_booking_id ON freight.warehouse_inventory USING btree (booking_id);
+
+
+--
+-- Name: idx_warehouse_inventory_cargo_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_cargo_id ON freight.warehouse_inventory USING btree (cargo_id);
+
+
+--
+-- Name: idx_warehouse_inventory_container_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_container_id ON freight.warehouse_inventory USING btree (container_id);
+
+
+--
+-- Name: idx_warehouse_inventory_goods_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_goods_id ON freight.warehouse_inventory USING btree (goods_id);
+
+
+--
+-- Name: idx_warehouse_inventory_grn_number; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_grn_number ON freight.warehouse_inventory USING btree (grn_number) WHERE (grn_number IS NOT NULL);
+
+
+--
+-- Name: idx_warehouse_inventory_inspection_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_inspection_status ON freight.warehouse_inventory USING btree (inspection_status);
+
+
+--
+-- Name: idx_warehouse_inventory_movement_inventory_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_movement_inventory_id ON freight.warehouse_inventory_movement USING btree (inventory_id);
+
+
+--
+-- Name: idx_warehouse_inventory_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_status ON freight.warehouse_inventory USING btree (status);
+
+
+--
+-- Name: idx_warehouse_inventory_warehouse_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_warehouse_id ON freight.warehouse_inventory USING btree (warehouse_id);
+
+
+--
+-- Name: idx_warehouse_inventory_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_yard_id ON freight.warehouse_inventory USING btree (yard_id);
+
+
+--
+-- Name: idx_warehouse_inventory_zone_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_inventory_zone_id ON freight.warehouse_inventory USING btree (zone_id);
+
+
+--
+-- Name: idx_warehouse_loadings_booking_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_loadings_booking_id ON freight.warehouse_loadings USING btree (booking_id);
+
+
+--
+-- Name: idx_warehouse_loadings_inventory_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_loadings_inventory_id ON freight.warehouse_loadings USING btree (warehouse_inventory_id);
+
+
+--
+-- Name: idx_warehouse_loadings_train_schedule; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_loadings_train_schedule ON freight.warehouse_loadings USING btree (train_schedule_id) WHERE (train_schedule_id IS NOT NULL);
+
+
+--
+-- Name: idx_warehouse_loadings_wagon_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_loadings_wagon_id ON freight.warehouse_loadings USING btree (wagon_id);
+
+
+--
+-- Name: idx_warehouse_yards_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_yards_status ON freight.warehouse_yards USING btree (status);
+
+
+--
+-- Name: idx_warehouse_yards_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_yards_type ON freight.warehouse_yards USING btree (type);
+
+
+--
+-- Name: idx_warehouse_yards_warehouse_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_yards_warehouse_id ON freight.warehouse_yards USING btree (warehouse_id);
+
+
+--
+-- Name: idx_warehouse_zones_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_zones_status ON freight.warehouse_zones USING btree (status);
+
+
+--
+-- Name: idx_warehouse_zones_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_zones_type ON freight.warehouse_zones USING btree (type);
+
+
+--
+-- Name: idx_warehouse_zones_yard_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouse_zones_yard_id ON freight.warehouse_zones USING btree (yard_id);
+
+
+--
+-- Name: idx_warehouses_station_id; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouses_station_id ON freight.warehouses USING btree (station_id);
+
+
+--
+-- Name: idx_warehouses_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouses_status ON freight.warehouses USING btree (status);
+
+
+--
+-- Name: idx_warehouses_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_warehouses_type ON freight.warehouses USING btree (type);
+
+
+--
+-- Name: idx_wfr_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wfr_active ON freight.warehouse_fee_rules USING btree (is_active);
+
+
+--
+-- Name: idx_wfr_type; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wfr_type ON freight.warehouse_fee_rules USING btree (rule_type);
+
+
+--
+-- Name: idx_wir_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wir_booking ON freight.warehouse_inspection_reports USING btree (booking_id);
+
+
+--
+-- Name: idx_wir_inventory; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wir_inventory ON freight.warehouse_inspection_reports USING btree (inventory_id);
+
+
+--
+-- Name: idx_wir_status; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wir_status ON freight.warehouse_inspection_reports USING btree (inspection_status);
+
+
+--
+-- Name: idx_wm_moved_by; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wm_moved_by ON freight.wagon_movements USING btree (moved_by_user_id);
+
+
+--
+-- Name: idx_wm_transfer_request; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wm_transfer_request ON freight.wagon_movements USING btree (transfer_request_id);
+
+
+--
+-- Name: idx_wtr_status_from_yard; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_wtr_status_from_yard ON freight.wagon_transfer_requests USING btree (status, from_yard_id);
+
+
+--
+-- Name: idx_yard_distances_from_yard; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_yard_distances_from_yard ON freight.yard_distances USING btree (from_yard_id);
+
+
+--
+-- Name: idx_yard_distances_to_yard; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX idx_yard_distances_to_yard ON freight.yard_distances USING btree (to_yard_id);
+
+
+--
+-- Name: ix_transit_agents_is_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX ix_transit_agents_is_active ON freight.transit_agents USING btree (is_active);
+
+
+--
+-- Name: ix_truck_types_is_active; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE INDEX ix_truck_types_is_active ON freight.truck_types USING btree (is_active);
+
+
+--
+-- Name: uq_booking_document_review_doc; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_booking_document_review_doc ON freight.booking_document_review USING btree (booking_id, setting_code, file_key);
+
+
+--
+-- Name: uq_clearance_milestone_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_clearance_milestone_booking ON freight.clearance_milestones USING btree (booking_id, milestone_code) WHERE (booking_id IS NOT NULL);
+
+
+--
+-- Name: uq_clearance_milestone_cycle; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_clearance_milestone_cycle ON freight.clearance_milestones USING btree (clearance_cycle_id, milestone_code) WHERE (clearance_cycle_id IS NOT NULL);
+
+
+--
+-- Name: uq_contract_templates_cargo_customs; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_contract_templates_cargo_customs ON freight.contract_templates USING btree (cargo_type_id, with_customs) WHERE ((deleted_at IS NULL) AND (cargo_type_id IS NOT NULL));
+
+
+--
+-- Name: uq_contract_templates_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_contract_templates_code ON freight.contract_templates USING btree (code) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: uq_interchange_active_schedule_direction; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_interchange_active_schedule_direction ON freight.interchange_documents USING btree (schedule_id, direction) WHERE ((schedule_id IS NOT NULL) AND ((status)::text <> 'CANCELLED'::text) AND (deleted_at IS NULL));
+
+
+--
+-- Name: uq_one_active_booking_per_one_time_contract; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_one_active_booking_per_one_time_contract ON freight.bookings USING btree (contract_id) WHERE (((status)::text <> ALL (ARRAY[('EXPIRED'::character varying)::text, ('CANCELLED'::character varying)::text, ('COMPLETED'::character varying)::text, ('REJECTED'::character varying)::text])) AND (contract_id IS NOT NULL) AND ((contract_kind)::text = 'ONE_TIME'::text));
+
+
+--
+-- Name: uq_open_wagon_cancellation_per_booking; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_open_wagon_cancellation_per_booking ON freight.booking_wagon_cancellations USING btree (booking_id) WHERE (((status)::text = 'FEE_PENDING'::text) AND (deleted_at IS NULL));
+
+
+--
+-- Name: uq_rcr_one_pending_per_rate; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_rcr_one_pending_per_rate ON freight.rate_change_requests USING btree (rate_id) WHERE (((status)::text = 'PENDING'::text) AND (deleted_at IS NULL));
+
+
+--
+-- Name: uq_support_doc_version; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_support_doc_version ON freight.support_document_versions USING btree (document_id, version);
+
+
+--
+-- Name: uq_support_documents_slug; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_support_documents_slug ON freight.support_documents USING btree (slug);
+
+
+--
+-- Name: uq_yard_distances_pair; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX uq_yard_distances_pair ON freight.yard_distances USING btree (from_yard_id, to_yard_id) WHERE (deleted_at IS NULL);
+
+
+--
+-- Name: ux_invoices_eims_irn; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX ux_invoices_eims_irn ON freight.invoices USING btree (eims_irn) WHERE (eims_irn IS NOT NULL);
+
+
+--
+-- Name: ux_train_schedules_reference; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX ux_train_schedules_reference ON freight.train_schedules USING btree (reference) WHERE (reference IS NOT NULL);
+
+
+--
+-- Name: ux_truck_types_code; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX ux_truck_types_code ON freight.truck_types USING btree (code);
+
+
+--
+-- Name: ux_vehicles_vin; Type: INDEX; Schema: freight; Owner: -
+--
+
+CREATE UNIQUE INDEX ux_vehicles_vin ON freight.vehicles USING btree (vin) WHERE (vin IS NOT NULL);
+
+
+--
+-- Name: last_mile_container_allocations FK_0bc28c4087bb0c6e435677a6fcb; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_container_allocations
+    ADD CONSTRAINT "FK_0bc28c4087bb0c6e435677a6fcb" FOREIGN KEY (last_mile_id) REFERENCES freight.last_mile(id) ON DELETE CASCADE;
+
+
+--
+-- Name: ff_clients FK_1101fbe8e745d91b6bd0747b582; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.ff_clients
+    ADD CONSTRAINT "FK_1101fbe8e745d91b6bd0747b582" FOREIGN KEY (forwarder_company_id) REFERENCES freight.companies(id);
+
+
+--
+-- Name: last_mile FK_173a865c0889b8c5564993c70ff; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile
+    ADD CONSTRAINT "FK_173a865c0889b8c5564993c70ff" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE SET NULL;
+
+
+--
+-- Name: external_profiles FK_26d2a16e263ab4fe0a4c8e91954; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.external_profiles
+    ADD CONSTRAINT "FK_26d2a16e263ab4fe0a4c8e91954" FOREIGN KEY (company_id) REFERENCES freight.companies(id);
+
+
+--
+-- Name: company_profiles FK_30228dd283a0f14486346e1db96; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_profiles
+    ADD CONSTRAINT "FK_30228dd283a0f14486346e1db96" FOREIGN KEY (company_id) REFERENCES freight.companies(id);
+
+
+--
+-- Name: first_mile_container_allocations FK_31dfdcea6bf62ec98f2e5428996; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_container_allocations
+    ADD CONSTRAINT "FK_31dfdcea6bf62ec98f2e5428996" FOREIGN KEY (first_mile_id) REFERENCES freight.first_mile(id) ON DELETE CASCADE;
+
+
+--
+-- Name: last_mile_requests FK_32653c7b15225addbafdaa297c1; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_requests
+    ADD CONSTRAINT "FK_32653c7b15225addbafdaa297c1" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: company_change_request FK_366962cebba507dd8b0146f7f47; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_change_request
+    ADD CONSTRAINT "FK_366962cebba507dd8b0146f7f47" FOREIGN KEY (company_id) REFERENCES freight.companies(id) ON DELETE CASCADE;
+
+
+--
+-- Name: warehouses FK_374ce3a1439d02d5ff97e479921; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouses
+    ADD CONSTRAINT "FK_374ce3a1439d02d5ff97e479921" FOREIGN KEY (facility_id) REFERENCES freight.facilities(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_container_allocations FK_4fa907f6cc2cfe181385dcd57c5; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container_allocations
+    ADD CONSTRAINT "FK_4fa907f6cc2cfe181385dcd57c5" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_requests FK_590f6298c3c3ae09d982f96fb9d; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_requests
+    ADD CONSTRAINT "FK_590f6298c3c3ae09d982f96fb9d" FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: import_djibouti_operations FK_6c3e3046300b152a13505bf8ffd; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.import_djibouti_operations
+    ADD CONSTRAINT "FK_6c3e3046300b152a13505bf8ffd" FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE CASCADE;
+
+
+--
+-- Name: bookings FK_6fa72e9c8fdfa587cffd9383470; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_6fa72e9c8fdfa587cffd9383470" FOREIGN KEY (destination_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: last_mile_container_allocations FK_825ceccffec68ac49c85bd75de0; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_container_allocations
+    ADD CONSTRAINT "FK_825ceccffec68ac49c85bd75de0" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE SET NULL;
+
+
+--
+-- Name: interchange_document_items FK_864508e9249279bd3e12dafdd21; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.interchange_document_items
+    ADD CONSTRAINT "FK_864508e9249279bd3e12dafdd21" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE SET NULL;
+
+
+--
+-- Name: company_revisions FK_8a17ca32f9e4624e1c55c51f7c7; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.company_revisions
+    ADD CONSTRAINT "FK_8a17ca32f9e4624e1c55c51f7c7" FOREIGN KEY (company_id) REFERENCES freight.companies(id) ON DELETE CASCADE;
+
+
+--
+-- Name: first_mile_container_allocations FK_8bba293eb2fd548433d28d97103; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_container_allocations
+    ADD CONSTRAINT "FK_8bba293eb2fd548433d28d97103" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_container FK_91946ca51ff65658f487eae1162; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container
+    ADD CONSTRAINT "FK_91946ca51ff65658f487eae1162" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_container_allocations FK_99c89fe4e4c3e3670fdc25ea9a9; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container_allocations
+    ADD CONSTRAINT "FK_99c89fe4e4c3e3670fdc25ea9a9" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_requests FK_9e49de0ed55d84d3f97627040cd; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_requests
+    ADD CONSTRAINT "FK_9e49de0ed55d84d3f97627040cd" FOREIGN KEY (created_booking_id) REFERENCES freight.bookings(id) ON DELETE SET NULL;
+
+
+--
+-- Name: cargo_types FK_CARGO_TYPES_PARENT_GROUP; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargo_types
+    ADD CONSTRAINT "FK_CARGO_TYPES_PARENT_GROUP" FOREIGN KEY (parent_group_id) REFERENCES freight.cargo_types(id) ON DELETE SET NULL;
+
+
+--
+-- Name: first_mile FK_a19b54ac3d426df8cc0e313be06; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile
+    ADD CONSTRAINT "FK_a19b54ac3d426df8cc0e313be06" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE SET NULL;
+
+
+--
+-- Name: first_mile FK_a2ae03360a02c61fdc2e8361ea8; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile
+    ADD CONSTRAINT "FK_a2ae03360a02c61fdc2e8361ea8" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: ff_clients FK_af4d6bac2844d39095b2056e978; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.ff_clients
+    ADD CONSTRAINT "FK_af4d6bac2844d39095b2056e978" FOREIGN KEY (client_company_id) REFERENCES freight.companies(id);
+
+
+--
+-- Name: booking_cargo_modifier FK_booking_cargo_modifier_booking_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_cargo_modifier
+    ADD CONSTRAINT "FK_booking_cargo_modifier_booking_id" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_cargo_modifier FK_booking_cargo_modifier_rate_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_cargo_modifier
+    ADD CONSTRAINT "FK_booking_cargo_modifier_rate_id" FOREIGN KEY (rate_id) REFERENCES freight.rates(id);
+
+
+--
+-- Name: booking_cargo_modifier FK_booking_cargo_modifier_rate_snapshot_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_cargo_modifier
+    ADD CONSTRAINT "FK_booking_cargo_modifier_rate_snapshot_id" FOREIGN KEY (rate_snapshot_id) REFERENCES freight.booking_rate_snapshot(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: booking_container FK_booking_container_container_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container
+    ADD CONSTRAINT "FK_booking_container_container_type_id" FOREIGN KEY (container_type_id) REFERENCES freight.container_types(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: booking_container FK_booking_container_weight_limit_rule_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container
+    ADD CONSTRAINT "FK_booking_container_weight_limit_rule_id" FOREIGN KEY (weight_limit_rule_id) REFERENCES freight.weight_limit_rules(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_rate_snapshot FK_booking_rate_snapshot_booking_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_rate_snapshot
+    ADD CONSTRAINT "FK_booking_rate_snapshot_booking_id" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_rate_snapshot FK_booking_rate_snapshot_rate_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_rate_snapshot
+    ADD CONSTRAINT "FK_booking_rate_snapshot_rate_id" FOREIGN KEY (rate_id) REFERENCES freight.rates(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: bookings FK_bookings_cargo_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_cargo_type_id" FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: bookings FK_bookings_company_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_company_id" FOREIGN KEY (company_id) REFERENCES freight.companies(id);
+
+
+--
+-- Name: bookings FK_bookings_company_profile_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_company_profile_id" FOREIGN KEY (company_profile_id) REFERENCES freight.company_profiles(id);
+
+
+--
+-- Name: bookings FK_bookings_consolidation_partner_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_consolidation_partner_id" FOREIGN KEY (consolidation_partner_id) REFERENCES freight.bookings(id) ON DELETE SET NULL;
+
+
+--
+-- Name: bookings FK_bookings_customer_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_customer_id" FOREIGN KEY (customer_id) REFERENCES freight.customers(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: bookings FK_bookings_service_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_service_type_id" FOREIGN KEY (service_type_id) REFERENCES freight.service_types(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: bookings FK_bookings_shipping_line_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_shipping_line_id" FOREIGN KEY (shipping_line_id) REFERENCES freight.shipping_lines(id) ON DELETE SET NULL;
+
+
+--
+-- Name: bookings FK_bookings_train_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_bookings_train_id" FOREIGN KEY (train_id) REFERENCES freight.trains(id) ON DELETE SET NULL;
+
+
+--
+-- Name: last_mile FK_c2d9331fda382ae3e92e6bf913a; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile
+    ADD CONSTRAINT "FK_c2d9331fda382ae3e92e6bf913a" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_document_review FK_c669c986810af3b82cf033a8d79; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_document_review
+    ADD CONSTRAINT "FK_c669c986810af3b82cf033a8d79" FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: last_mile_requests FK_c845afc4aeaf8f73e38a5b5483d; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_requests
+    ADD CONSTRAINT "FK_c845afc4aeaf8f73e38a5b5483d" FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE CASCADE;
+
+
+--
+-- Name: interchange_document_items FK_c9fba2c4a1631542a37ad5089d7; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.interchange_document_items
+    ADD CONSTRAINT "FK_c9fba2c4a1631542a37ad5089d7" FOREIGN KEY (interchange_document_id) REFERENCES freight.interchange_documents(id) ON DELETE CASCADE;
+
+
+--
+-- Name: bookings FK_cabe80a0c7b9e0144854a4f353d; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT "FK_cabe80a0c7b9e0144854a4f353d" FOREIGN KEY (origin_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: cargoes FK_cargoes_cargo_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargoes
+    ADD CONSTRAINT "FK_cargoes_cargo_type_id" FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id);
+
+
+--
+-- Name: cargoes FK_cargoes_container_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargoes
+    ADD CONSTRAINT "FK_cargoes_container_id" FOREIGN KEY (container_id) REFERENCES freight.containers(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: cargo_type_wagon_types FK_cgwt_cargo_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargo_type_wagon_types
+    ADD CONSTRAINT "FK_cgwt_cargo_type" FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id) ON DELETE CASCADE;
+
+
+--
+-- Name: cargo_type_wagon_types FK_cgwt_wagon_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargo_type_wagon_types
+    ADD CONSTRAINT "FK_cgwt_wagon_type" FOREIGN KEY (wagon_type_id) REFERENCES freight.wagon_types(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: containers FK_containers_container_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT "FK_containers_container_type_id" FOREIGN KEY (container_type_id) REFERENCES freight.container_types(id);
+
+
+--
+-- Name: containers FK_containers_wagon_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT "FK_containers_wagon_id" FOREIGN KEY (wagon_id) REFERENCES freight.wagons(id) ON DELETE SET NULL;
+
+
+--
+-- Name: container_type_wagon_types FK_ctwt_container_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.container_type_wagon_types
+    ADD CONSTRAINT "FK_ctwt_container_type" FOREIGN KEY (container_type_id) REFERENCES freight.container_types(id) ON DELETE CASCADE;
+
+
+--
+-- Name: container_type_wagon_types FK_ctwt_wagon_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.container_type_wagon_types
+    ADD CONSTRAINT "FK_ctwt_wagon_type" FOREIGN KEY (wagon_type_id) REFERENCES freight.wagon_types(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: last_mile_requests FK_d8e15175ed6471429295e2cd788; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_requests
+    ADD CONSTRAINT "FK_d8e15175ed6471429295e2cd788" FOREIGN KEY (resulting_last_mile_id) REFERENCES freight.last_mile(id) ON DELETE SET NULL;
+
+
+--
+-- Name: dropdown_options FK_dropdown_options_setting; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.dropdown_options
+    ADD CONSTRAINT "FK_dropdown_options_setting" FOREIGN KEY (setting_id) REFERENCES freight.dropdown_settings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: file_upload_fields FK_file_upload_fields_setting; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.file_upload_fields
+    ADD CONSTRAINT "FK_file_upload_fields_setting" FOREIGN KEY (setting_id) REFERENCES freight.file_upload_settings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: locomotives FK_locomotive_current_yard; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.locomotives
+    ADD CONSTRAINT "FK_locomotive_current_yard" FOREIGN KEY (current_yard_id) REFERENCES freight.yards(id) ON DELETE SET NULL;
+
+
+--
+-- Name: rates FK_rates_cargo_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.rates
+    ADD CONSTRAINT "FK_rates_cargo_type_id" FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id) ON DELETE SET NULL;
+
+
+--
+-- Name: rates FK_rates_destination_yard_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.rates
+    ADD CONSTRAINT "FK_rates_destination_yard_id" FOREIGN KEY (destination_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: rates FK_rates_origin_yard_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.rates
+    ADD CONSTRAINT "FK_rates_origin_yard_id" FOREIGN KEY (origin_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: train_locomotives FK_train_locomotives_locomotive; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_locomotives
+    ADD CONSTRAINT "FK_train_locomotives_locomotive" FOREIGN KEY (locomotive_id) REFERENCES freight.locomotives(id);
+
+
+--
+-- Name: train_locomotives FK_train_locomotives_train; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_locomotives
+    ADD CONSTRAINT "FK_train_locomotives_train" FOREIGN KEY (train_id) REFERENCES freight.trains(id) ON DELETE CASCADE;
+
+
+--
+-- Name: train_set_locomotives FK_train_set_locomotives_locomotive; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_locomotives
+    ADD CONSTRAINT "FK_train_set_locomotives_locomotive" FOREIGN KEY (locomotive_id) REFERENCES freight.locomotives(id);
+
+
+--
+-- Name: train_set_locomotives FK_train_set_locomotives_train_set; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_locomotives
+    ADD CONSTRAINT "FK_train_set_locomotives_train_set" FOREIGN KEY (train_set_id) REFERENCES freight.train_sets(id) ON DELETE CASCADE;
+
+
+--
+-- Name: train_sets FK_train_sets_train; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_sets
+    ADD CONSTRAINT "FK_train_sets_train" FOREIGN KEY (train_id) REFERENCES freight.trains(id) ON DELETE SET NULL;
+
+
+--
+-- Name: trains FK_trains_current_yard; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.trains
+    ADD CONSTRAINT "FK_trains_current_yard" FOREIGN KEY (current_yard_id) REFERENCES freight.yards(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagons FK_wagon_current_yard; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT "FK_wagon_current_yard" FOREIGN KEY (current_yard_id) REFERENCES freight.yards(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagons FK_wagons_current_location_yard_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT "FK_wagons_current_location_yard_id" FOREIGN KEY (current_location_yard_id) REFERENCES freight.yards(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagons FK_wagons_train_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT "FK_wagons_train_id" FOREIGN KEY (train_id) REFERENCES freight.trains(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagons FK_wagons_wagon_type_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT "FK_wagons_wagon_type_id" FOREIGN KEY (wagon_type_id) REFERENCES freight.wagon_types(id);
+
+
+--
+-- Name: warranties FK_warranties_vehicle_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warranties
+    ADD CONSTRAINT "FK_warranties_vehicle_id" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE CASCADE;
+
+
+--
+-- Name: weight_limit_rules FK_weight_limit_rules_container_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.weight_limit_rules
+    ADD CONSTRAINT "FK_weight_limit_rules_container_type" FOREIGN KEY (container_type_id) REFERENCES freight.container_types(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: work_orders FK_work_orders_vehicle_id; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.work_orders
+    ADD CONSTRAINT "FK_work_orders_vehicle_id" FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_batch_offers booking_batch_offers_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_batch_offers
+    ADD CONSTRAINT booking_batch_offers_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_batch_offers booking_batch_offers_train_schedule_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_batch_offers
+    ADD CONSTRAINT booking_batch_offers_train_schedule_id_fkey FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_container_units booking_container_units_booking_container_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_container_units
+    ADD CONSTRAINT booking_container_units_booking_container_id_fkey FOREIGN KEY (booking_container_id) REFERENCES freight.booking_container(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_contract_signatures booking_contract_signatures_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_contract_signatures
+    ADD CONSTRAINT booking_contract_signatures_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_contract_signatures booking_contract_signatures_signature_file_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_contract_signatures
+    ADD CONSTRAINT booking_contract_signatures_signature_file_id_fkey FOREIGN KEY (signature_file_id) REFERENCES freight.files(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_document_review booking_document_review_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_document_review
+    ADD CONSTRAINT booking_document_review_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id);
+
+
+--
+-- Name: booking_handovers booking_handovers_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_handovers
+    ADD CONSTRAINT booking_handovers_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_handovers booking_handovers_edr_assignment_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_handovers
+    ADD CONSTRAINT booking_handovers_edr_assignment_id_fkey FOREIGN KEY (edr_assignment_id) REFERENCES freight.last_mile_vehicle_assignments(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_handovers booking_handovers_truck_assignment_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_handovers
+    ADD CONSTRAINT booking_handovers_truck_assignment_id_fkey FOREIGN KEY (truck_assignment_id) REFERENCES freight.customer_truck_assignments(id) ON DELETE SET NULL;
+
+
+--
+-- Name: booking_review_note booking_review_note_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_review_note
+    ADD CONSTRAINT booking_review_note_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: booking_wagon_cancellations booking_wagon_cancellations_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_wagon_cancellations
+    ADD CONSTRAINT booking_wagon_cancellations_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id);
+
+
+--
+-- Name: booking_wagon_cancellations booking_wagon_cancellations_fee_invoice_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_wagon_cancellations
+    ADD CONSTRAINT booking_wagon_cancellations_fee_invoice_id_fkey FOREIGN KEY (fee_invoice_id) REFERENCES freight.invoices(id);
+
+
+--
+-- Name: booking_wagon_cancellations booking_wagon_cancellations_fee_rate_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_wagon_cancellations
+    ADD CONSTRAINT booking_wagon_cancellations_fee_rate_id_fkey FOREIGN KEY (fee_rate_id) REFERENCES freight.rates(id);
+
+
+--
+-- Name: booking_wagon_cancellations booking_wagon_cancellations_rebooked_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.booking_wagon_cancellations
+    ADD CONSTRAINT booking_wagon_cancellations_rebooked_booking_id_fkey FOREIGN KEY (rebooked_booking_id) REFERENCES freight.bookings(id);
+
+
+--
+-- Name: bookings bookings_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT bookings_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id);
+
+
+--
+-- Name: bookings bookings_contract_route_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.bookings
+    ADD CONSTRAINT bookings_contract_route_id_fkey FOREIGN KEY (contract_route_id) REFERENCES freight.contract_routes(id);
+
+
+--
+-- Name: clearance_incidents clearance_incidents_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.clearance_incidents
+    ADD CONSTRAINT clearance_incidents_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: clearance_milestones clearance_milestones_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.clearance_milestones
+    ADD CONSTRAINT clearance_milestones_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: clearance_milestones clearance_milestones_clearance_cycle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.clearance_milestones
+    ADD CONSTRAINT clearance_milestones_clearance_cycle_id_fkey FOREIGN KEY (clearance_cycle_id) REFERENCES freight.contract_clearance_cycles(id);
+
+
+--
+-- Name: clearance_milestones clearance_milestones_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.clearance_milestones
+    ADD CONSTRAINT clearance_milestones_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: compliance_records compliance_records_vehicle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.compliance_records
+    ADD CONSTRAINT compliance_records_vehicle_id_fkey FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id);
+
+
+--
+-- Name: contract_approval_steps contract_approval_steps_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_approval_steps
+    ADD CONSTRAINT contract_approval_steps_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_cargo_scope contract_cargo_scope_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_cargo_scope
+    ADD CONSTRAINT contract_cargo_scope_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_clearance_cycles contract_clearance_cycles_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_clearance_cycles
+    ADD CONSTRAINT contract_clearance_cycles_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_document_review contract_document_review_clearance_cycle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_document_review
+    ADD CONSTRAINT contract_document_review_clearance_cycle_id_fkey FOREIGN KEY (clearance_cycle_id) REFERENCES freight.contract_clearance_cycles(id);
+
+
+--
+-- Name: contract_document_review contract_document_review_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_document_review
+    ADD CONSTRAINT contract_document_review_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_document_revisions contract_document_revisions_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_document_revisions
+    ADD CONSTRAINT contract_document_revisions_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_rate_snapshots contract_rate_snapshots_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_rate_snapshots
+    ADD CONSTRAINT contract_rate_snapshots_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_review_notes contract_review_notes_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_review_notes
+    ADD CONSTRAINT contract_review_notes_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_routes contract_routes_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_routes
+    ADD CONSTRAINT contract_routes_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_signatures contract_signatures_contract_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_signatures
+    ADD CONSTRAINT contract_signatures_contract_id_fkey FOREIGN KEY (contract_id) REFERENCES freight.contracts(id) ON DELETE CASCADE;
+
+
+--
+-- Name: contract_templates contract_templates_cargo_type_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contract_templates
+    ADD CONSTRAINT contract_templates_cargo_type_id_fkey FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id);
+
+
+--
+-- Name: contracts contracts_renewal_of_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.contracts
+    ADD CONSTRAINT contracts_renewal_of_id_fkey FOREIGN KEY (renewal_of_id) REFERENCES freight.contracts(id);
+
+
+--
+-- Name: customer_truck_assignments customer_truck_assignments_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customer_truck_assignments
+    ADD CONSTRAINT customer_truck_assignments_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: customer_truck_containers customer_truck_containers_assignment_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customer_truck_containers
+    ADD CONSTRAINT customer_truck_containers_assignment_id_fkey FOREIGN KEY (assignment_id) REFERENCES freight.customer_truck_assignments(id) ON DELETE CASCADE;
+
+
+--
+-- Name: customer_truck_containers customer_truck_containers_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.customer_truck_containers
+    ADD CONSTRAINT customer_truck_containers_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE CASCADE;
+
+
+--
+-- Name: facility_handling_events facility_handling_events_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facility_handling_events
+    ADD CONSTRAINT facility_handling_events_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id);
+
+
+--
+-- Name: facility_handling_events facility_handling_events_inventory_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facility_handling_events
+    ADD CONSTRAINT facility_handling_events_inventory_id_fkey FOREIGN KEY (inventory_id) REFERENCES freight.warehouse_inventory(id);
+
+
+--
+-- Name: facility_handling_events facility_handling_events_train_schedule_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facility_handling_events
+    ADD CONSTRAINT facility_handling_events_train_schedule_id_fkey FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id);
+
+
+--
+-- Name: facility_handling_events facility_handling_events_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.facility_handling_events
+    ADD CONSTRAINT facility_handling_events_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: first_mile_vehicle_assignments first_mile_vehicle_assignments_first_mile_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_vehicle_assignments
+    ADD CONSTRAINT first_mile_vehicle_assignments_first_mile_id_fkey FOREIGN KEY (first_mile_id) REFERENCES freight.first_mile(id) ON DELETE CASCADE;
+
+
+--
+-- Name: first_mile_vehicle_assignments first_mile_vehicle_assignments_vehicle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.first_mile_vehicle_assignments
+    ADD CONSTRAINT first_mile_vehicle_assignments_vehicle_id_fkey FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id);
+
+
+--
+-- Name: cargoes fk_cargoes_booking; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargoes
+    ADD CONSTRAINT fk_cargoes_booking FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE SET NULL;
+
+
+--
+-- Name: cargoes fk_cargoes_wagon_allocation; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.cargoes
+    ADD CONSTRAINT fk_cargoes_wagon_allocation FOREIGN KEY (wagon_booking_allocation_id) REFERENCES freight.wagon_booking_allocations(id) ON DELETE SET NULL;
+
+
+--
+-- Name: containers fk_containers_booking; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT fk_containers_booking FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE SET NULL;
+
+
+--
+-- Name: containers fk_containers_booking_container; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT fk_containers_booking_container FOREIGN KEY (booking_container_id) REFERENCES freight.booking_container(id) ON DELETE SET NULL;
+
+
+--
+-- Name: containers fk_containers_wagon_allocation; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.containers
+    ADD CONSTRAINT fk_containers_wagon_allocation FOREIGN KEY (wagon_booking_allocation_id) REFERENCES freight.wagon_booking_allocations(id) ON DELETE SET NULL;
+
+
+--
+-- Name: fuel_consumption fk_fuel_consumption_vehicle; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fuel_consumption
+    ADD CONSTRAINT fk_fuel_consumption_vehicle FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE CASCADE;
+
+
+--
+-- Name: fuel_purchases fk_fuel_purchases_vehicle; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.fuel_purchases
+    ADD CONSTRAINT fk_fuel_purchases_vehicle FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE CASCADE;
+
+
+--
+-- Name: invoice_lines fk_invoice_lines_invoice; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoice_lines
+    ADD CONSTRAINT fk_invoice_lines_invoice FOREIGN KEY (invoice_id) REFERENCES freight.invoices(id) ON DELETE CASCADE;
+
+
+--
+-- Name: invoices fk_invoices_company; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoices
+    ADD CONSTRAINT fk_invoices_company FOREIGN KEY (company_id) REFERENCES freight.companies(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: invoices fk_invoices_company_profile; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoices
+    ADD CONSTRAINT fk_invoices_company_profile FOREIGN KEY (company_profile_id) REFERENCES freight.company_profiles(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: invoices fk_invoices_payment; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.invoices
+    ADD CONSTRAINT fk_invoices_payment FOREIGN KEY (payment_id) REFERENCES freight.payments(id) ON DELETE SET NULL;
+
+
+--
+-- Name: maintenance_costs fk_maintenance_schedule; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.maintenance_costs
+    ADD CONSTRAINT fk_maintenance_schedule FOREIGN KEY (maintenance_schedule_id) REFERENCES freight.maintenance_schedules(id) ON DELETE SET NULL;
+
+
+--
+-- Name: payment_refunds fk_payment_refunds_payment; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.payment_refunds
+    ADD CONSTRAINT fk_payment_refunds_payment FOREIGN KEY (payment_id) REFERENCES freight.payments(id) ON DELETE RESTRICT;
+
+
+--
+-- Name: train_schedule_bookings fk_train_schedule_bookings_booking; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedule_bookings
+    ADD CONSTRAINT fk_train_schedule_bookings_booking FOREIGN KEY (booking_id) REFERENCES freight.bookings(id);
+
+
+--
+-- Name: train_schedule_bookings fk_train_schedule_bookings_schedule; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedule_bookings
+    ADD CONSTRAINT fk_train_schedule_bookings_schedule FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE CASCADE;
+
+
+--
+-- Name: train_schedules fk_train_schedules_destination; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedules
+    ADD CONSTRAINT fk_train_schedules_destination FOREIGN KEY (destination_station_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: train_schedules fk_train_schedules_origin; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedules
+    ADD CONSTRAINT fk_train_schedules_origin FOREIGN KEY (origin_station_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: train_schedules fk_train_schedules_route; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedules
+    ADD CONSTRAINT fk_train_schedules_route FOREIGN KEY (route_id) REFERENCES freight.routes(id);
+
+
+--
+-- Name: train_schedules fk_train_schedules_train_set; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_schedules
+    ADD CONSTRAINT fk_train_schedules_train_set FOREIGN KEY (train_set_id) REFERENCES freight.train_sets(id);
+
+
+--
+-- Name: train_set_wagons fk_train_set_wagons_physical_wagon; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT fk_train_set_wagons_physical_wagon FOREIGN KEY (physical_wagon_id) REFERENCES freight.wagons(id) ON DELETE SET NULL;
+
+
+--
+-- Name: train_set_wagons fk_train_set_wagons_train_set; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT fk_train_set_wagons_train_set FOREIGN KEY (train_set_id) REFERENCES freight.train_sets(id) ON DELETE CASCADE;
+
+
+--
+-- Name: train_set_wagons fk_train_set_wagons_wagon_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT fk_train_set_wagons_wagon_type FOREIGN KEY (wagon_type_id) REFERENCES freight.wagon_types(id);
+
+
+--
+-- Name: train_sets fk_train_sets_locomotive; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_sets
+    ADD CONSTRAINT fk_train_sets_locomotive FOREIGN KEY (locomotive_id) REFERENCES freight.locomotives(id);
+
+
+--
+-- Name: vehicles fk_vehicles_truck_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.vehicles
+    ADD CONSTRAINT fk_vehicles_truck_type FOREIGN KEY (truck_type_id) REFERENCES freight.truck_types(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_allocation_bulk_loads fk_wabl_allocation; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_bulk_loads
+    ADD CONSTRAINT fk_wabl_allocation FOREIGN KEY (wagon_booking_allocation_id) REFERENCES freight.wagon_booking_allocations(id) ON DELETE CASCADE;
+
+
+--
+-- Name: wagon_allocation_bulk_loads fk_wabl_booking; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_bulk_loads
+    ADD CONSTRAINT fk_wabl_booking FOREIGN KEY (booking_id) REFERENCES freight.bookings(id);
+
+
+--
+-- Name: wagon_allocation_bulk_loads fk_wabl_cargo_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_bulk_loads
+    ADD CONSTRAINT fk_wabl_cargo_type FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_allocation_container_items fk_waci_allocation; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_container_items
+    ADD CONSTRAINT fk_waci_allocation FOREIGN KEY (wagon_booking_allocation_id) REFERENCES freight.wagon_booking_allocations(id) ON DELETE CASCADE;
+
+
+--
+-- Name: wagon_allocation_container_items fk_waci_booking_container; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_container_items
+    ADD CONSTRAINT fk_waci_booking_container FOREIGN KEY (booking_container_id) REFERENCES freight.booking_container(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_allocation_container_items fk_waci_container; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_container_items
+    ADD CONSTRAINT fk_waci_container FOREIGN KEY (container_id) REFERENCES freight.containers(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_allocation_container_items fk_waci_container_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_allocation_container_items
+    ADD CONSTRAINT fk_waci_container_type FOREIGN KEY (container_type_id) REFERENCES freight.container_types(id);
+
+
+--
+-- Name: wagon_booking_allocations fk_wagon_booking_allocations_booking; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_booking_allocations
+    ADD CONSTRAINT fk_wagon_booking_allocations_booking FOREIGN KEY (booking_id) REFERENCES freight.bookings(id);
+
+
+--
+-- Name: wagon_booking_allocations fk_wagon_booking_allocations_wagon; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_booking_allocations
+    ADD CONSTRAINT fk_wagon_booking_allocations_wagon FOREIGN KEY (train_set_wagon_id) REFERENCES freight.train_set_wagons(id) ON DELETE CASCADE;
+
+
+--
+-- Name: wagons fk_wagons_current_train_schedule; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT fk_wagons_current_train_schedule FOREIGN KEY (current_train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagons fk_wagons_train_set_wagon; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagons
+    ADD CONSTRAINT fk_wagons_train_set_wagon FOREIGN KEY (train_set_wagon_id) REFERENCES freight.train_set_wagons(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_movements fk_wm_transfer_request; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT fk_wm_transfer_request FOREIGN KEY (transfer_request_id) REFERENCES freight.wagon_transfer_requests(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_transfer_requests fk_wtr_from_yard; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_transfer_requests
+    ADD CONSTRAINT fk_wtr_from_yard FOREIGN KEY (from_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: wagon_transfer_requests fk_wtr_to_yard; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_transfer_requests
+    ADD CONSTRAINT fk_wtr_to_yard FOREIGN KEY (to_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: wagon_transfer_requests fk_wtr_wagon_type; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_transfer_requests
+    ADD CONSTRAINT fk_wtr_wagon_type FOREIGN KEY (wagon_type_id) REFERENCES freight.wagon_types(id);
+
+
+--
+-- Name: gps_devices gps_devices_vehicle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.gps_devices
+    ADD CONSTRAINT gps_devices_vehicle_id_fkey FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id);
+
+
+--
+-- Name: last_mile_vehicle_assignments last_mile_vehicle_assignments_last_mile_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_vehicle_assignments
+    ADD CONSTRAINT last_mile_vehicle_assignments_last_mile_id_fkey FOREIGN KEY (last_mile_id) REFERENCES freight.last_mile(id) ON DELETE CASCADE;
+
+
+--
+-- Name: last_mile_vehicle_assignments last_mile_vehicle_assignments_vehicle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_vehicle_assignments
+    ADD CONSTRAINT last_mile_vehicle_assignments_vehicle_id_fkey FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id);
+
+
+--
+-- Name: last_mile_vehicle_containers last_mile_vehicle_containers_assignment_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.last_mile_vehicle_containers
+    ADD CONSTRAINT last_mile_vehicle_containers_assignment_id_fkey FOREIGN KEY (assignment_id) REFERENCES freight.last_mile_vehicle_assignments(id) ON DELETE CASCADE;
+
+
+--
+-- Name: maintenance_intervals maintenance_intervals_vehicle_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.maintenance_intervals
+    ADD CONSTRAINT maintenance_intervals_vehicle_id_fkey FOREIGN KEY (vehicle_id) REFERENCES freight.vehicles(id) ON DELETE CASCADE;
+
+
+--
+-- Name: priority_rule_change_requests priority_rule_change_requests_priority_config_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.priority_rule_change_requests
+    ADD CONSTRAINT priority_rule_change_requests_priority_config_id_fkey FOREIGN KEY (priority_config_id) REFERENCES freight.priority_configs(id);
+
+
+--
+-- Name: rate_change_requests rate_change_requests_rate_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.rate_change_requests
+    ADD CONSTRAINT rate_change_requests_rate_id_fkey FOREIGN KEY (rate_id) REFERENCES freight.rates(id);
+
+
+--
+-- Name: route_milestones route_milestones_route_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.route_milestones
+    ADD CONSTRAINT route_milestones_route_id_fkey FOREIGN KEY (route_id) REFERENCES freight.routes(id) ON DELETE CASCADE;
+
+
+--
+-- Name: route_milestones route_milestones_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.route_milestones
+    ADD CONSTRAINT route_milestones_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: routes routes_destination_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.routes
+    ADD CONSTRAINT routes_destination_yard_id_fkey FOREIGN KEY (destination_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: routes routes_origin_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.routes
+    ADD CONSTRAINT routes_origin_yard_id_fkey FOREIGN KEY (origin_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: support_document_versions support_document_versions_document_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.support_document_versions
+    ADD CONSTRAINT support_document_versions_document_id_fkey FOREIGN KEY (document_id) REFERENCES freight.support_documents(id) ON DELETE CASCADE;
+
+
+--
+-- Name: train_checkpoint_events train_checkpoint_events_train_schedule_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_checkpoint_events
+    ADD CONSTRAINT train_checkpoint_events_train_schedule_id_fkey FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE CASCADE;
+
+
+--
+-- Name: train_set_wagons train_set_wagons_alight_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT train_set_wagons_alight_yard_id_fkey FOREIGN KEY (alight_yard_id) REFERENCES freight.yards(id) ON DELETE SET NULL;
+
+
+--
+-- Name: train_set_wagons train_set_wagons_board_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.train_set_wagons
+    ADD CONSTRAINT train_set_wagons_board_yard_id_fkey FOREIGN KEY (board_yard_id) REFERENCES freight.yards(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_movements wagon_movements_booking_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT wagon_movements_booking_id_fkey FOREIGN KEY (booking_id) REFERENCES freight.bookings(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_movements wagon_movements_from_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT wagon_movements_from_yard_id_fkey FOREIGN KEY (from_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: wagon_movements wagon_movements_to_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT wagon_movements_to_yard_id_fkey FOREIGN KEY (to_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: wagon_movements wagon_movements_train_schedule_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT wagon_movements_train_schedule_id_fkey FOREIGN KEY (train_schedule_id) REFERENCES freight.train_schedules(id) ON DELETE SET NULL;
+
+
+--
+-- Name: wagon_movements wagon_movements_wagon_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_movements
+    ADD CONSTRAINT wagon_movements_wagon_id_fkey FOREIGN KEY (wagon_id) REFERENCES freight.wagons(id) ON DELETE CASCADE;
+
+
+--
+-- Name: wagon_status_logs wagon_status_logs_wagon_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.wagon_status_logs
+    ADD CONSTRAINT wagon_status_logs_wagon_id_fkey FOREIGN KEY (wagon_id) REFERENCES freight.wagons(id);
+
+
+--
+-- Name: warehouse_inventory_movement warehouse_inventory_movement_inventory_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inventory_movement
+    ADD CONSTRAINT warehouse_inventory_movement_inventory_id_fkey FOREIGN KEY (inventory_id) REFERENCES freight.warehouse_inventory(id) ON DELETE CASCADE;
+
+
+--
+-- Name: warehouse_inventory warehouse_inventory_warehouse_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inventory
+    ADD CONSTRAINT warehouse_inventory_warehouse_id_fkey FOREIGN KEY (warehouse_id) REFERENCES freight.warehouses(id);
+
+
+--
+-- Name: warehouse_inventory warehouse_inventory_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inventory
+    ADD CONSTRAINT warehouse_inventory_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.warehouse_yards(id);
+
+
+--
+-- Name: warehouse_inventory warehouse_inventory_zone_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_inventory
+    ADD CONSTRAINT warehouse_inventory_zone_id_fkey FOREIGN KEY (zone_id) REFERENCES freight.warehouse_zones(id);
+
+
+--
+-- Name: warehouse_loadings warehouse_loadings_warehouse_inventory_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_loadings
+    ADD CONSTRAINT warehouse_loadings_warehouse_inventory_id_fkey FOREIGN KEY (warehouse_inventory_id) REFERENCES freight.warehouse_inventory(id) ON DELETE CASCADE;
+
+
+--
+-- Name: warehouse_yard_cargo_types warehouse_yard_cargo_types_cargo_type_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_yard_cargo_types
+    ADD CONSTRAINT warehouse_yard_cargo_types_cargo_type_id_fkey FOREIGN KEY (cargo_type_id) REFERENCES freight.cargo_types(id) ON DELETE CASCADE;
+
+
+--
+-- Name: warehouse_yard_cargo_types warehouse_yard_cargo_types_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_yard_cargo_types
+    ADD CONSTRAINT warehouse_yard_cargo_types_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.warehouse_yards(id) ON DELETE CASCADE;
+
+
+--
+-- Name: warehouse_yards warehouse_yards_warehouse_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_yards
+    ADD CONSTRAINT warehouse_yards_warehouse_id_fkey FOREIGN KEY (warehouse_id) REFERENCES freight.warehouses(id) ON DELETE CASCADE;
+
+
+--
+-- Name: warehouse_zones warehouse_zones_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.warehouse_zones
+    ADD CONSTRAINT warehouse_zones_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.warehouse_yards(id) ON DELETE CASCADE;
+
+
+--
+-- Name: yard_distances yard_distances_from_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_distances
+    ADD CONSTRAINT yard_distances_from_yard_id_fkey FOREIGN KEY (from_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: yard_distances yard_distances_to_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_distances
+    ADD CONSTRAINT yard_distances_to_yard_id_fkey FOREIGN KEY (to_yard_id) REFERENCES freight.yards(id);
+
+
+--
+-- Name: yard_facilities yard_facilities_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_facilities
+    ADD CONSTRAINT yard_facilities_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.yards(id) ON DELETE CASCADE;
+
+
+--
+-- Name: yard_locations yard_locations_yard_id_fkey; Type: FK CONSTRAINT; Schema: freight; Owner: -
+--
+
+ALTER TABLE ONLY freight.yard_locations
+    ADD CONSTRAINT yard_locations_yard_id_fkey FOREIGN KEY (yard_id) REFERENCES freight.yards(id) ON DELETE CASCADE;
+
+
+--
+-- PostgreSQL database dump complete
+--
+
+
diff --git a/freight-backup-20260809.dump b/freight-backup-20260809.dump
new file mode 100644
index 000000000..41e7a4870
Binary files /dev/null and b/freight-backup-20260809.dump differ
diff --git a/freight-backup-preswap-20260809.dump b/freight-backup-preswap-20260809.dump
new file mode 100644
index 000000000..435dbbb11
Binary files /dev/null and b/freight-backup-preswap-20260809.dump differ
diff --git a/infrastructure/docker/Dockerfile.web b/infrastructure/docker/Dockerfile.web
index 1e26bf643..714e49d33 100644
--- a/infrastructure/docker/Dockerfile.web
+++ b/infrastructure/docker/Dockerfile.web
@@ -30,6 +30,7 @@ ARG NEXT_PUBLIC_API_URL
 ARG VITE_GOOGLE_MAPS_API_KEY
 ARG VITE_POSTHOG_KEY
 ARG VITE_POSTHOG_HOST
+ARG VITE_ENV
 ENV VITE_API_URL=${VITE_API_URL}
 ENV VITE_BASE_API_URL=${VITE_BASE_API_URL}
 ENV VITE_USER_MANAGEMENT_BASE=${VITE_USER_MANAGEMENT_BASE}
@@ -37,6 +38,8 @@ ENV NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}
 ENV VITE_GOOGLE_MAPS_API_KEY=${VITE_GOOGLE_MAPS_API_KEY}
 ENV VITE_POSTHOG_KEY=${VITE_POSTHOG_KEY}
 ENV VITE_POSTHOG_HOST=${VITE_POSTHOG_HOST}
+# dev|staging only — gates the Fayda/OTP bypass. Unset in prod.
+ENV VITE_ENV=${VITE_ENV}
 
 RUN if [ -z "$VITE_API_URL" ] || [ -z "$VITE_BASE_API_URL" ] || [ -z "$VITE_USER_MANAGEMENT_BASE" ]; then \
       echo "ERROR: VITE_API_URL, VITE_BASE_API_URL, and VITE_USER_MANAGEMENT_BASE must all be set" && \
diff --git a/infrastructure/matrix/element/40-element-config.sh b/infrastructure/matrix/element/40-element-config.sh
new file mode 100644
index 000000000..9826a5fc7
--- /dev/null
+++ b/infrastructure/matrix/element/40-element-config.sh
@@ -0,0 +1,18 @@
+#!/bin/sh
+# Renders /app/config.json from config.json.tmpl at container start.
+#
+# The homeserver URL and server_name differ per environment, and config.json is
+# read by the browser rather than the build, so baking it into the image would
+# mean one image per environment. Dropped into /docker-entrypoint.d, which the
+# upstream nginx entrypoint runs (in lexical order) before starting nginx —
+# no ENTRYPOINT override, so the image's own startup work still happens.
+set -eu
+
+: "${MATRIX_PUBLIC_BASEURL:?MATRIX_PUBLIC_BASEURL is required}"
+: "${MATRIX_SERVER_NAME:?MATRIX_SERVER_NAME is required}"
+: "${ELEMENT_PUBLIC_URL:?ELEMENT_PUBLIC_URL is required}"
+
+envsubst '${MATRIX_PUBLIC_BASEURL} ${MATRIX_SERVER_NAME} ${ELEMENT_PUBLIC_URL}' \
+  < /app/config.json.tmpl > /app/config.json
+
+echo "element-config: homeserver ${MATRIX_PUBLIC_BASEURL} (${MATRIX_SERVER_NAME})"
diff --git a/infrastructure/matrix/element/Dockerfile b/infrastructure/matrix/element/Dockerfile
new file mode 100644
index 000000000..330098af6
--- /dev/null
+++ b/infrastructure/matrix/element/Dockerfile
@@ -0,0 +1,23 @@
+# syntax=docker/dockerfile:1
+#
+# EDR internal chat web client. Unmodified upstream Element Web + our public,
+# non-secret config (homeserver URL, branding) and the SSO handoff page.
+# Pin the tag; never float on `latest`.
+FROM ghcr.io/element-hq/element-web:v1.11.108
+
+COPY config.json.tmpl /app/config.json.tmpl
+COPY sso.html /app/sso.html
+# Replaces the upstream manifest, which names the app "Element" and advertises
+# the Play/App Store builds under related_applications. Those apps cannot log
+# in here — this deployment has no password login and no SSO provider, only the
+# JWT handoff from freight-api — so pointing staff at them is a dead end.
+COPY manifest.json /app/manifest.json
+COPY 40-element-config.sh /docker-entrypoint.d/40-element-config.sh
+
+# The image runs as uid 101 (nginx) but ships /app root-owned, so the startup
+# hook could not write the rendered config without this.
+USER root
+RUN chmod +x /docker-entrypoint.d/40-element-config.sh \
+    && touch /app/config.json \
+    && chown nginx:nginx /app/config.json
+USER nginx
diff --git a/infrastructure/matrix/element/config.json.tmpl b/infrastructure/matrix/element/config.json.tmpl
new file mode 100644
index 000000000..f08900601
--- /dev/null
+++ b/infrastructure/matrix/element/config.json.tmpl
@@ -0,0 +1,18 @@
+{
+  "default_server_config": {
+    "m.homeserver": {
+      "base_url": "${MATRIX_PUBLIC_BASEURL}",
+      "server_name": "${MATRIX_SERVER_NAME}"
+    }
+  },
+  "brand": "EDR Chat",
+  "permalink_prefix": "${ELEMENT_PUBLIC_URL}",
+  "disable_guests": true,
+  "disable_3pid_login": true,
+  "disable_custom_urls": true,
+  "default_theme": "light",
+  "mobile_guide_toast": false,
+  "settingDefaults": {
+    "UIFeature.registration": false
+  }
+}
diff --git a/infrastructure/matrix/element/manifest.json b/infrastructure/matrix/element/manifest.json
new file mode 100644
index 000000000..75f5f33e6
--- /dev/null
+++ b/infrastructure/matrix/element/manifest.json
@@ -0,0 +1,12 @@
+{
+  "name": "EDR Chat",
+  "short_name": "EDR Chat",
+  "display": "standalone",
+  "theme_color": "#0dbd8b",
+  "start_url": "index.html",
+  "icons": [
+    { "src": "/vector-icons/150.png", "sizes": "150x150", "type": "image/png" },
+    { "src": "/vector-icons/300.png", "sizes": "300x300", "type": "image/png" },
+    { "src": "/vector-icons/1024.png", "sizes": "1024x1024", "type": "image/png" }
+  ]
+}
diff --git a/infrastructure/matrix/element/sso.html b/infrastructure/matrix/element/sso.html
new file mode 100644
index 000000000..77f378122
--- /dev/null
+++ b/infrastructure/matrix/element/sso.html
@@ -0,0 +1,49 @@
+<!doctype html>
+<!--
+  Session handoff from freight-api into Element.
+
+  freight-api's chat-sso.service.ts links here as
+  https://chat.edr.et/sso.html#hs=<homeserver>&t=<access_token>&u=<user_id>&d=<device_id>
+  — a fragment, not a query, so the token is never sent to a server and never
+  lands in an access log. location.replace() below drops this URL from history
+  as well, so the token does not survive the redirect.
+
+  The keys written here are the ones Element reads on startup
+  (element-web src/Lifecycle.ts getStoredSessionVars/getStoredToken): the token
+  is looked up in IndexedDB first and falls back to localStorage, which Element
+  then migrates into IndexedDB itself. A plaintext token is accepted —
+  tryDecryptToken returns a string token as-is, and only decrypts when it finds
+  an encrypted payload.
+
+  This replaced a ?loginToken= handoff: POST /_matrix/client/v1/login/get_token
+  is capped at one call per user per minute by a limiter hardcoded in Synapse,
+  so clicking Chat twice in a minute failed.
+-->
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Signing in to EDR Chat…</title>
+  </head>
+  <body>
+    <script>
+      var params = new URLSearchParams(window.location.hash.slice(1));
+      var homeserver = params.get("hs");
+      var token = params.get("t");
+      var userId = params.get("u");
+      var deviceId = params.get("d");
+
+      if (homeserver && token && userId && deviceId) {
+        localStorage.setItem("mx_hs_url", homeserver);
+        localStorage.setItem("mx_user_id", userId);
+        localStorage.setItem("mx_device_id", deviceId);
+        localStorage.setItem("mx_access_token", token);
+        localStorage.setItem("mx_has_access_token", "true");
+        localStorage.setItem("mx_is_guest", "false");
+        window.location.replace("/");
+      } else {
+        document.body.textContent =
+          "Missing sign-in details. Go back to the EDR backoffice and click Chat again.";
+      }
+    </script>
+  </body>
+</html>
diff --git a/infrastructure/matrix/synapse/Dockerfile b/infrastructure/matrix/synapse/Dockerfile
new file mode 100644
index 000000000..ec424e41f
--- /dev/null
+++ b/infrastructure/matrix/synapse/Dockerfile
@@ -0,0 +1,15 @@
+# syntax=docker/dockerfile:1
+#
+# EDR internal chat homeserver. Unmodified upstream Synapse + our config
+# template — no source build. Pin the tag; never float on `latest`.
+FROM ghcr.io/element-hq/synapse:v1.140.0
+
+RUN apt-get update && apt-get install -y --no-install-recommends gettext-base \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY homeserver.yaml.tmpl /synapse/homeserver.yaml.tmpl
+COPY log.config /synapse/log.config
+COPY docker-entrypoint.sh /synapse/docker-entrypoint.sh
+RUN chmod +x /synapse/docker-entrypoint.sh
+
+ENTRYPOINT ["/synapse/docker-entrypoint.sh"]
diff --git a/infrastructure/matrix/synapse/docker-entrypoint.sh b/infrastructure/matrix/synapse/docker-entrypoint.sh
new file mode 100644
index 000000000..674bf7947
--- /dev/null
+++ b/infrastructure/matrix/synapse/docker-entrypoint.sh
@@ -0,0 +1,20 @@
+#!/bin/sh
+# Renders homeserver.yaml from the template using the runtime env (so
+# MATRIX_JWT_SECRET / DB password / registration_shared_secret come from the
+# service's .env file, never get baked into the image), then hands off to the
+# upstream Synapse image's own entrypoint.
+set -eu
+
+mkdir -p /data
+envsubst \
+  '${MATRIX_SERVER_NAME} ${MATRIX_PUBLIC_BASEURL} ${MATRIX_DB_USER} ${MATRIX_DB_PASSWORD} ${MATRIX_DB_NAME} ${MATRIX_DB_HOST} ${MATRIX_DB_PORT} ${MATRIX_JWT_SECRET} ${MATRIX_REGISTRATION_SHARED_SECRET}' \
+  < /synapse/homeserver.yaml.tmpl > /data/homeserver.yaml
+
+# start.py's `run` mode (the implicit default we hit below) gosu's straight
+# into uid 991 with no chown — it only chowns /data in its `generate` /
+# `migrate_config` modes, which we skip by providing our own pre-rendered
+# config. Without this, 991 can't write its signing key on first boot.
+chown -R 991:991 /data
+
+export SYNAPSE_CONFIG_PATH=/data/homeserver.yaml
+exec /start.py "$@"
diff --git a/infrastructure/matrix/synapse/homeserver.yaml.tmpl b/infrastructure/matrix/synapse/homeserver.yaml.tmpl
new file mode 100644
index 000000000..efb7372ac
--- /dev/null
+++ b/infrastructure/matrix/synapse/homeserver.yaml.tmpl
@@ -0,0 +1,113 @@
+# EDR internal chat — Synapse homeserver config.
+#
+# Rendered to /data/homeserver.yaml at container start by docker-entrypoint.sh
+# (envsubst over this template) so secrets come from the runtime env file,
+# never baked into the image — same convention as freight-api's .env.
+#
+# server_name is PERMANENT: it is baked into every user id and event and
+# cannot change without wiping the server. Do not repoint this at a
+# different value after go-live.
+server_name: "${MATRIX_SERVER_NAME}"
+public_baseurl: "${MATRIX_PUBLIC_BASEURL}"
+pid_file: /data/homeserver.pid
+
+listeners:
+  - port: 8008
+    tls: false
+    type: http
+    x_forwarded: true
+    resources:
+      - names: [client, federation]
+        compress: false
+
+database:
+  name: psycopg2
+  args:
+    user: "${MATRIX_DB_USER}"
+    password: "${MATRIX_DB_PASSWORD}"
+    dbname: "${MATRIX_DB_NAME}"
+    host: "${MATRIX_DB_HOST}"
+    port: ${MATRIX_DB_PORT}
+    cp_min: 5
+    cp_max: 10
+
+media_store_path: /data/media_store
+max_upload_size: 50M
+
+log_config: "/synapse/log.config"
+
+# Internal comms tool: no federation, no open registration, no E2EE-by-default.
+# ponytail: E2EE off — turn on per-room (HR/legal) if compliance asks.
+federation_domain_whitelist: []
+enable_registration: false
+encryption_enabled_by_default_for_room_type: "off"
+
+# Turning rooms' encryption off above is not enough on its own: Element still
+# bootstraps cross-signing on a user's first login, and from then on gates
+# EVERY later login behind "Verify this device" (MatrixChat: crossSigningIsSetUp
+# -> Views.COMPLETE_SECURITY). Nobody on this deployment can clear that gate —
+# each SSO click is a brand-new device, so there is never a second verified
+# device to accept the request, and resetting the identity needs UIA, which
+# password_config.enabled: false makes impossible.
+#
+# This tells Element encryption is off here, so it skips the bootstrap
+# (shouldSkipSetupEncryption) and the gate is never armed. Only helps accounts
+# that have no cross-signing keys yet — anyone already bootstrapped keeps
+# hitting the gate until their keys are cleared.
+extra_well_known_client_content:
+  io.element.e2ee:
+    default: false
+    force_disable: true
+    secure_backup_required: false
+
+# Employees authenticate via freight-api's SSO handoff, never a Matrix
+# password prompt. This is the entire auth story for this deployment.
+password_config:
+  enabled: false
+
+jwt_config:
+  enabled: true
+  secret: "${MATRIX_JWT_SECRET}"
+  algorithm: "HS256"
+  issuer: "edr-freight-api"
+  audiences: ["matrix"]
+  # Matches the `name` claim chat-sso.service.ts puts in the JWT — only read
+  # on first login (auto-registration), never updates it on later logins.
+  display_name_claim: "name"
+
+# Consumes the login_token minted by freight-api's SSO endpoint via
+# POST /_matrix/client/v1/login/get_token (issued against an existing,
+# already-JWT-authenticated session — not a bare password grant).
+login_via_existing_session:
+  enabled: true
+  require_ui_auth: false
+  token_timeout: 5m
+
+# Bootstrap-only: used once by ops to register the first admin account
+# (register_new_matrix_user against /_synapse/admin/v1/register), whose
+# access token becomes MATRIX_ADMIN_TOKEN for freight-api's provisioning
+# service. Rotate/remove after bootstrap if desired — nothing else depends
+# on shared-secret registration once the admin account exists.
+registration_shared_secret: "${MATRIX_REGISTRATION_SHARED_SECRET}"
+
+trusted_key_servers: []
+suppress_key_server_warning: true
+
+report_stats: false
+
+# Synapse's default rc_login is sized to defend against internet-facing
+# password brute-forcing. That threat doesn't exist on this deployment —
+# password login is off (see password_config above), and the only path in
+# requires a freight-api-signed JWT — so the default is mostly just
+# punishing legitimate rapid logins from the same office/NAT IP or normal
+# page-refresh retries. Loosened, not disabled, to keep some ceiling.
+rc_login:
+  address:
+    per_second: 100
+    burst_count: 200
+  account:
+    per_second: 100
+    burst_count: 200
+  failed_attempts:
+    per_second: 100
+    burst_count: 200
diff --git a/infrastructure/matrix/synapse/log.config b/infrastructure/matrix/synapse/log.config
new file mode 100644
index 000000000..0894e974f
--- /dev/null
+++ b/infrastructure/matrix/synapse/log.config
@@ -0,0 +1,25 @@
+# Log straight to stdout — the container runtime (docker compose logs / the
+# self-hosted runner's log collection) owns rotation and retention, matching
+# how every other app container in this repo logs.
+version: 1
+
+formatters:
+  precise:
+    format: "%(asctime)s - %(name)s - %(lineno)d - %(levelname)s - %(message)s"
+
+handlers:
+  console:
+    class: logging.StreamHandler
+    formatter: precise
+    stream: ext://sys.stdout
+
+loggers:
+  synapse.storage.SQL:
+    # SQL queries are DEBUG-only noise; leave at INFO unless diagnosing.
+    level: INFO
+
+root:
+  level: INFO
+  handlers: [console]
+
+disable_existing_loggers: false
diff --git a/infrastructure/nginx/spa.conf b/infrastructure/nginx/spa.conf
index 83629210c..0cc9b1de0 100644
--- a/infrastructure/nginx/spa.conf
+++ b/infrastructure/nginx/spa.conf
@@ -11,6 +11,11 @@ server {
     add_header Referrer-Policy "strict-origin-when-cross-origin" always;
     add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
 
+    # nginx defaults to 1m and answers anything larger with its own HTML 413
+    # before the request reaches an upstream. Kept in step with the 50MB
+    # per-document ceiling the API enforces (DOCUMENT_UPLOAD_MAX_BYTES).
+    client_max_body_size 50m;
+
     gzip on;
     gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/wasm;
     gzip_min_length 1024;
diff --git a/local-packages/tria-plc-iamapi-common-1.1.0.tgz b/local-packages/tria-plc-iamapi-common-1.1.0.tgz
new file mode 100644
index 000000000..8bbb76bf9
Binary files /dev/null and b/local-packages/tria-plc-iamapi-common-1.1.0.tgz differ
diff --git a/migrations-restore-299-rows.sql b/migrations-restore-299-rows.sql
new file mode 100644
index 000000000..5993e265e
--- /dev/null
+++ b/migrations-restore-299-rows.sql
@@ -0,0 +1,301 @@
+-- restore deleted pre-baseline migration rows
+INSERT INTO freight.migrations (timestamp, name) VALUES
+(1748427600000, 'AddServiceTypesAndCargoTypes1748427600000'),
+(1748514000000, 'AddRuleEngineTablesAndCodes1748514000000'),
+(1748550000000, 'CreateFreightLegacyBaseline1748550000000'),
+(1748600000000, 'ItmlsFullSchemaRewrite1748600000000'),
+(1748700000000, 'AddBookingsConfigForeignKeys1748700000000'),
+(1748800000000, 'AddBookingsRemainingForeignKeys1748800000000'),
+(1748900000000, 'MoveCustomersToFreightSchema1748900000000'),
+(1749000000000, 'NormalizeWeightLimitTradeDirectionBoth1749000000000'),
+(1749100000000, 'CreateFreightFilesTable1749100000000'),
+(1749200000000, 'CreateCompaniesModule1749200000000'),
+(1749200000000, 'BookingFlowRefactor1749200000000'),
+(1749300000000, 'AddFanNumberToCompanies1749300000000'),
+(1749300000000, 'AddBookingFreightType1749300000000'),
+(1749400000000, 'AddTrainScheduling1749400000000'),
+(1749400000000, 'AddContractSignatures1749400000000'),
+(1749500000000, 'AddCompanyIdToBookings1749500000000'),
+(1749600000000, 'AddBlocksRoleToApprovalStep1749600000000'),
+(1749700000000, 'SeedDefaultApprovalRules1749700000000'),
+(1749800000000, 'AddShippingLinesCodeUniqueIndex1749800000000'),
+(1749900000000, 'CreateFileUploadSettingsTables1749900000000'),
+(1750000000000, 'CreateFacilitiesTable1750000000000'),
+(1750000000000, 'AddTrainExtendedColumns1750000000000'),
+(1750000000000, 'AddCompanyContactColumns1750000000000'),
+(1750000000001, 'AddFacilityIdToWarehouses1750000000001'),
+(1750000000002, 'AddProofOfDeliveryToCargoes1750000000002'),
+(1750000000003, 'AddWarehouseInspection1750000000003'),
+(1750100000000, 'CreateFleetCrudTables1750100000000'),
+(1750100000000, 'AddRoutesAndExtendLocomotives1750100000000'),
+(1750200000000, 'SeedDefaultWagonTypes1750200000000'),
+(1750200000000, 'AddPhysicalWagonToTrainSetWagons1750200000000'),
+(1750300000000, 'AddRouteToTrainSchedules1750300000000'),
+(1750300000000, 'AddCurrentLocationToWagons1750300000000'),
+(1750400000000, 'SeedEdRWagonFleet1750400000000'),
+(1750400000000, 'AddSchedulingAllocationEnhancements1750400000000'),
+(1750500000000, 'AddWagonReadiness1750500000000'),
+(1750600000000, 'AddGovernmentBookingFields1750600000000'),
+(1750700000000, 'CreateSchedulingEvents1750700000000'),
+(1750800000000, 'FixContainerWagonsPerUnit1750800000000'),
+(1750900000000, 'AddContainerNumberToBookingContainer1750900000000'),
+(1751000000000, 'CreateTrainSchedulingGlobalRules1751000000000'),
+(1751000000001, 'AddDeletedAtToTrainSchedulingGlobalRules1751000000001'),
+(1752000000000, 'CreateCompanyProfiles1752000000000'),
+(1752000000001, 'MoveBusinessLicenseToProfile1752000000001'),
+(1770000000000, 'CreateVehiclesTable1770000000000'),
+(1775000000000, 'CreateDriversTable1775000000000'),
+(1780639311366, 'CreatePaymentTable1780639311366'),
+(1780639978834, 'AlterClientActionToJsonb1780639978834'),
+(1780644945086, 'UpdatePaymentTimestamp1780644945086'),
+(1781000000000, 'AddLocomotiveReadiness1781000000000'),
+(1781000000001, 'CreateTrainCheckpointEvents1781000000001'),
+(1781000000002, 'AddBatchBookingFields1781000000002'),
+(1781000000003, 'AddSelectedForBatchStatus1781000000003'),
+(1781000000004, 'AddDomesticWeightLimitTradeDirection1781000000004'),
+(1781000000005, 'CreateTrainCompositionRemovalLog1781000000005'),
+(1782000000000, 'WagonLocomotiveYardLink1782000000000'),
+(1782000000001, 'AddPaymentWebhookEventAndRefund1782000000001'),
+(1782000000002, 'ExtendPaymentMethodEnum1782000000002'),
+(1783000000000, 'ReplacePriorityRulesWithPriorityConfigs1783000000000'),
+(1784000000000, 'CreateSavedSignatures1784000000000'),
+(1784000000001, 'SeedWagonsWithYardAssignment1784000000001'),
+(1784100000000, 'AddBookingRouteDayIndex1784100000000'),
+(1790000000000, 'CreateWarehouseModule1790000000000'),
+(1790000000001, 'WarehouseBatch21790000000001'),
+(1790000000002, 'WarehouseBatch31790000000002'),
+(1791000000000, 'AddWarehouseAllocationAndFeeRules1791000000000'),
+(1791000000000, 'AddActiveModeAndOnboardingToExternalProfiles1791000000000'),
+(1791000000001, 'AddWarehouseFeeInvoices1791000000001'),
+(1791000000001, 'AddCompanyProfileIdToBookings1791000000001'),
+(1791000000002, 'AddNationalityToCompanies1791000000002'),
+(1791000000002, 'AddImportPickupDeliveryColumns1791000000002'),
+(1791000000003, 'AddInventoryUnloadedAt1791000000003'),
+(1791000000003, 'AddETradeFieldsToCompanies1791000000003'),
+(1791000000003, 'AddBusinessLicenseFilesToCompanyProfiles1791000000003'),
+(1791000000004, 'AddFacilityIdToWarehousesFix1791000000004'),
+(1791000000005, 'AddWarehouseInventoryInspectionStatusFix1791000000005'),
+(1791999999999, 'CreateDropdownSettings1791999999999'),
+(1792000000000, 'AddUnitOfMeasureToCargoTypes1792000000000'),
+(1792000000001, 'AddBookingTypeAndContractFields1792000000001'),
+(1792000000002, 'CreateBookingOrders1792000000002'),
+(1792000000003, 'SeedGeneralContractPeriod1792000000003'),
+(1792000000004, 'SeedContractValidityPeriods1792000000004'),
+(1800000000001, 'AddVehicleDriverAssignment1800000000001'),
+(1810000000000, 'CreateFirstMile1810000000000'),
+(1810000000001, 'CreateLastMile1810000000001'),
+(1810000000002, 'MakeCompanyProfileReferenceNullable1810000000002'),
+(1810000000002, 'CreateLastMileContainerAllocations1810000000002'),
+(1810000000002, 'AddVehicleCodeAndPlates1810000000002'),
+(1810000000003, 'CreateOtpVerifications1810000000003'),
+(1810000000004, 'AddPostPaymentCompletedColumn1810000000004'),
+(1820000000000, 'DropAllowConsolidation1820000000000'),
+(1820000000001, 'CreateContractRouteLines1820000000001'),
+(1820000000002, 'CreateBookingDocumentReview1820000000002'),
+(1820000000003, 'AddPriceAdjustment1820000000003'),
+(1820000000004, 'FoldSurchargeTypesIntoRates1820000000004'),
+(1820000000005, 'AddContractValidityWindow1820000000005'),
+(1820000000006, 'AddCustomsAgentAndMileCoordinates1820000000006'),
+(1820000000010, 'AddGeneralContractOrderFields1820000000010'),
+(1820000000011, 'DropEmailPhoneFromExternalProfiles1820000000011'),
+(1820000000011, 'AddTrainSetLocomotives1820000000011'),
+(1820000000012, 'AddEstimatedShipmentDate1820000000012'),
+(1821000000000, 'CreateInterchangeDocuments1821000000000'),
+(1821000000001, 'EnsureWarehouseInventoryInspectionStatus1821000000001'),
+(1821000000002, 'CreateInvoices1821000000002'),
+(1821000000002, 'AddDistanceColumnsToVehicles1821000000002'),
+(1821000000003, 'AddCompanyKindAndGovBookingLinks1821000000003'),
+(1821000000004, 'MakePaymentsTypeGeneric1821000000004'),
+(1822000000000, 'CreateImportDjiboutiOperations1822000000000'),
+(1822000000000, 'CreateContracts1822000000000'),
+(1823000000000, 'CreateImportOperationsTables1823000000000'),
+(1823000000000, 'BackfillContractsFromBookings1823000000000'),
+(1824000000000, 'DropLegacyContractTables1824000000000'),
+(1825000000000, 'CreateBookingContainerAllocations1825000000000'),
+(1825000000000, 'AddGlOperations1825000000000'),
+(1826000000000, 'AddCargoScopeQuantityCap1826000000000'),
+(1827000000000, 'CreateBookingRequests1827000000000'),
+(1828000000000, 'ExtendInvoicesForPartialPayment1828000000000'),
+(1828000000000, 'AddGrnNumberToWarehouseInventory1828000000000'),
+(1828000000000, 'AddBulkHazmatReeferQuantity1828000000000'),
+(1829000000000, 'PhasedClearanceCycleMeta1829000000000'),
+(1829000000000, 'CentralizeWarehouseInvoices1829000000000'),
+(1829000000001, 'SeedRoVesselMinDays1829000000001'),
+(1829000000002, 'BookingClearanceMeta1829000000002'),
+(1830000000000, 'DropCargoTypeShowFreeTextBox1830000000000'),
+(1830000000000, 'CreateFirstMileContainerAllocations1830000000000'),
+(1830000000000, 'AddExpiredInvoiceStatus1830000000000'),
+(1830000000001, 'RouteStatusAndSegmentKm1830000000001'),
+(1830000000002, 'PreClearanceFinalizedAt1830000000002'),
+(1831000000000, 'AddWarehouseFeeRuleTiers1831000000000'),
+(1832000000000, 'AddCustomerTruckAssignmentToBookings1832000000000'),
+(1840000000000, 'CreateFuelTables1840000000000'),
+(1850000000000, 'CreateMaintenanceTables1850000000000'),
+(1860000000000, 'AddPaidToFirstAndLastMile1860000000000'),
+(1861000000000, 'AddBookingWindowGlobalRules1861000000000'),
+(1861000000001, 'ReleaseStuckAssignedLocomotives1861000000001'),
+(1862000000000, 'AddScheduleWindowPhases1862000000000'),
+(1863000000000, 'CreateBookingBatchOffers1863000000000'),
+(1870000000000, 'RepairSynchronizeDrift1870000000000'),
+(1870000000000, 'AddLocationToVehicles1870000000000'),
+(1880000000000, 'AddVehicleStatuses1880000000000'),
+(1890000000000, 'SeparateVehicleAvailability1890000000000'),
+(1890000000001, 'AddVehicleCodeAndPlates1890000000001'),
+(1890000000002, 'AddFaydaVerificationSessions1890000000002'),
+(1890000000003, 'AddDriverFaydaVerification1890000000003'),
+(1890000000004, 'AddLastMileVehicleAssignments1890000000004'),
+(1890000000005, 'AddDriverGender1890000000005'),
+(1890000000006, 'AddDriverFaydaSubUnique1890000000006'),
+(1890000000007, 'DriverUniquePartialSoftDelete1890000000007'),
+(1890000000008, 'AddFleetEvents1890000000008'),
+(1890000000009, 'AddLastMileAssignmentContainerNumber1890000000009'),
+(1890000000010, 'AddLastMileAssignmentDistance1890000000010'),
+(1900000000000, 'SimplifyRatesAndWeightLimitRules1900000000000'),
+(1900000000000, 'AddLoadingStatusToTrainScheduleBookings1900000000000'),
+(1900000000000, 'AddEmailToOtpVerifications1900000000000'),
+(1910000000000, 'WidenWindowDurationHoursPrecision1910000000000'),
+(1920000000000, 'AddScheduleWindowRuleSnapshot1920000000000'),
+(1930000000000, 'AddMaxCapacityToWeightLimitRules1930000000000'),
+(1940000000000, 'AddWagonTypeFkToCargoAndContainerTypes1940000000000'),
+(1940000000000, 'AddFirstMileVehicleAssignments1940000000000'),
+(1950000000000, 'CreateNotifications1950000000000'),
+(1950000000000, 'AddWindowCloseHour1950000000000'),
+(1950000000000, 'AddVehicleCompliance1950000000000'),
+(1950000000000, 'AddCustomerTruckAssignments1950000000000'),
+(1960000000000, 'AddIncidents1960000000000'),
+(1960000000000, 'AddContainerReceiptToBookingContainerUnits1960000000000'),
+(1970000000000, 'AddMaintenanceDepth1970000000000'),
+(1970000000000, 'AddCustomerTruckDeparture1970000000000'),
+(1980000000000, 'YardCountryEnumAndRouteDirection1980000000000'),
+(1980000000000, 'AddProcurement1980000000000'),
+(1980000000000, 'AddBookingHandovers1980000000000'),
+(1990000000000, 'SegmentCorridorBookings1990000000000'),
+(1990000000000, 'AddVehiclePricePerKm1990000000000'),
+(1990000000000, 'AddDoubleHandlingBasisAndMachinery1990000000000'),
+(2000000000000, 'CreateCompanyChangeRequest2000000000000'),
+(2000000000000, 'AddTruckDetentionTiming2000000000000'),
+(2000000000000, 'AddGpsTracking2000000000000'),
+(2000000000000, 'AddCustomsPriorityConfig2000000000000'),
+(2000000000001, 'AddCompanyProfileReview2000000000001'),
+(2010000000000, 'AddFeeRuleVehicleType2010000000000'),
+(2010000000000, 'AddConsolidationResumeStatus2010000000000'),
+(2020000000000, 'WarehouseCapacityKgToTons2020000000000'),
+(2020000000000, 'RepairOtpEmailSchema2020000000000'),
+(2030000000000, 'AddTrainScheduleReference2030000000000'),
+(2040000000000, 'MigrateLicenseFilesToFileRecords2040000000000'),
+(2040000000000, 'AddLocomotiveOverageTolerance2040000000000'),
+(2050000000000, 'DropWagonTypeMaxWagonsPerTrain2050000000000'),
+(2050000000000, 'AddCustomerTruckContainerLoadedAt2050000000000'),
+(2060000000000, 'SeedRailWagonTypes2060000000000'),
+(2060000000000, 'CreateYardDistances2060000000000'),
+(2070000000000, 'MakeWagonTypeTareWeightRequired2070000000000'),
+(2080000000000, 'DropWagonSpecColumns2080000000000'),
+(2090000000000, 'RepairGrnNumberColumn2090000000000'),
+(2090000000000, 'CreateContractTemplates2090000000000'),
+(2100000000000, 'WarehouseLoadingTrainAssociation2100000000000'),
+(2100000000000, 'CompanyProfileDefaultPending2100000000000'),
+(2110000000000, 'RepairVehicleAvailabilityColumn2110000000000'),
+(2110000000000, 'AddBookingIsSplit2110000000000'),
+(2120000000000, 'AddScheduleWagonAllocationSnapshot2120000000000'),
+(2120000000000, 'AddLastMileProofOfDelivery2120000000000'),
+(2130000000000, 'AddHandoverSignerName2130000000000'),
+(2140000000000, 'CreateAccrualAcks2140000000000'),
+(2150000000000, 'TrainBuilder2150000000000'),
+(2160000000000, 'MultiWagonTypePerCargoAndContainer2160000000000'),
+(2170000000000, 'ScheduleWagonAdjustmentLogs2170000000000'),
+(2170000000000, 'CreateWagonTransferRequests2170000000000'),
+(2180000000000, 'LinkWagonMovementToTransferRequest2180000000000'),
+(2190000000000, 'DropReopenDelayMinutes2190000000000'),
+(2200000000000, 'TrainNumberPair2200000000000'),
+(2210000000000, 'ScheduleScopedWagonPins2210000000000'),
+(2220000000000, 'AddContractDocumentSnapshot2220000000000'),
+(2230000000000, 'RenameWagonStatusRetiredToDetained2230000000000'),
+(2240000000000, 'AddTransferRequestReason2240000000000'),
+(2250000000000, 'CreatePriorityRuleChangeRequests2250000000000'),
+(2260000000000, 'SeedEdrWagonFleetErNumbering2260000000000'),
+(2260000000000, 'AddLastMileTruckArrivalDeparture2260000000000'),
+(2260000000000, 'AddClearanceFeePayment2260000000000'),
+(2270000000000, 'AddWagonTrainNumbers2270000000000'),
+(2270000000000, 'AddContainerReturnQuantity2270000000000'),
+(2280000000000, 'WagonNumberPartialUnique2280000000000'),
+(2280000000000, 'SeedWagonRunNumbers2280000000000'),
+(2290000000000, 'YardFacilities2290000000000'),
+(2290000000000, 'SeedWagonYardDoraleh2290000000000'),
+(2290000000000, 'DropContainerWagonsPerUnit2290000000000'),
+(2300000000000, 'RepairGpsTrackingTables2300000000000'),
+(2300000000000, 'CreateRateChangeRequests2300000000000'),
+(2310000000000, 'CreateSupportChat2310000000000'),
+(2320000000000, 'YardFacilityFreightTypes2320000000000'),
+(2320000000000, 'SupportChatAttachments2320000000000'),
+(2320000000000, 'AddRateYardScope2320000000000'),
+(2330000000000, 'AddBookingCloseOffset2330000000000'),
+(2340000000000, 'AddReverseWagonOrder2340000000000'),
+(2340000000000, 'AddCargoTypeHasLashing2340000000000'),
+(2350000000000, 'RefreshContractPricingArticles2350000000000'),
+(2360000000000, 'RefreshContractPricingArticles2360000000000'),
+(2370000000000, 'AddContainerUnitReturnFlag2370000000000'),
+(2380000000000, 'AddTrainDeactivatedStatus2380000000000'),
+(2390000000000, 'WidenYardCodeForSoftDeleteSuffix2390000000000'),
+(2390000000000, 'SeedImportTrainNumbers2390000000000'),
+(2400000000000, 'NormalizeCompanyRegions2400000000000'),
+(2400000000000, 'AddCustomerTruckExitWeights2400000000000'),
+(2410000000000, 'DropBookingApprovalWidenRoles2410000000000'),
+(2420000000000, 'CreateContractDocumentRevisions2420000000000'),
+(2430000000000, 'UniqueLocomotiveName2430000000000'),
+(2430000000000, 'AddFileReviewStatus2430000000000'),
+(2440000000000, 'AddHandoverEdrAssignment2440000000000'),
+(2450000000000, 'DropActiveProfileTypeFromExternalProfiles2450000000000'),
+(2460000000000, 'AddCacBankPaymentMethod2460000000000'),
+(2470000000000, 'AddAcquisitionItemName2470000000000'),
+(2480000000000, 'AddMaintenanceDueNotifiedAt2480000000000'),
+(2800000000000, 'AddMaintenanceIntervals2800000000000'),
+(2800000000001, 'AddSignatureToHandover2800000000001'),
+(2810000000000, 'AddMaintenanceServiceItem2810000000000'),
+(2820000000000, 'CustomsClearanceRouteScope2820000000000'),
+(2820000000000, 'AddMileTonsQuantity2820000000000'),
+(2830000000000, 'ReturnSurchargeRouteScope2830000000000'),
+(2840000000000, 'AddTruckTypes2840000000000'),
+(2850000000000, 'AddBookingDoubleHandling2850000000000'),
+(2860000000000, 'DropClearanceFeePrepay2860000000000'),
+(2860000000000, 'AddPerTruckDetentionWindow2860000000000'),
+(2870000000000, 'CustomsClearancePerKind2870000000000'),
+(2880000000000, 'LashingPerKind2880000000000'),
+(2890000000000, 'LashingBulkOnlyPerDirection2890000000000'),
+(2900000000000, 'LivestockPerItem2900000000000'),
+(2910000000000, 'AddContractSignatureStamp2910000000000'),
+(2920000000000, 'AddRevisionActorName2920000000000'),
+(2930000000000, 'AddWagonTransferPartialFulfilment2930000000000'),
+(2940000000000, 'AddFileVersionHistory2940000000000'),
+(2950000000000, 'AddTransitAssigneeHandshake2950000000000'),
+(2960000000000, 'AddContractHazardDeclaration2960000000000'),
+(2970000000000, 'AddDoCollectionDates2970000000000'),
+(2980000000000, 'AddBookingRequestCurrency2980000000000'),
+(2990000000000, 'IndodeYardsAndCargoRouting2990000000000'),
+(3000000000000, 'AddContractSuspension3000000000000'),
+(3010000000000, 'AddBookingTransitAssignee3010000000000'),
+(3020000000000, 'AddContractSubmittedAt3020000000000'),
+(3030000000000, 'AddGlExchangeDocumentFields3030000000000'),
+(3040000000000, 'AddTransitAgents3040000000000'),
+(3050000000000, 'AddCbeBillPaymentMethod3050000000000'),
+(3050000000000, 'MergeDuplicateSebetaYards3050000000000'),
+(3060000000000, 'AddExportPaymentWindow3060000000000'),
+(3070000000000, 'AddBulkTotalWeightTons3070000000000'),
+(3080000000000, 'BackfillDireDawaMilestone3080000000000'),
+(3090000000000, 'AddSavedSignatureStamp3090000000000'),
+(3100000000000, 'PromoteDraftSchedulesToScheduled3100000000000'),
+(3110000000000, 'AddYardToScheduleWagonAdjustmentLogs3110000000000'),
+(3120000000000, 'AddApprovedAtToCompanies3120000000000'),
+(3120000000000, 'AddCargoTypeItemsPerWagonMap3120000000000'),
+(3130000000000, 'CreateCompanyRevisions3130000000000'),
+(3140000000000, 'SyncBulkRateUnitsToCargoUom3140000000000'),
+(3150000000000, 'CreateUserTradeAccess3150000000000'),
+(3150000000000, 'FixFaydaAddressShape3150000000000'),
+(3160000000000, 'FixPaymentPaidAtType3160000000000'),
+(3170000000000, 'YardFacilityOriginDestination3170000000000'),
+(3180000000000, 'PortYardFacilityRecords3180000000000'),
+(3190000000000, 'AddCargoTypeTonsPerWagonMap3190000000000'),
+(3200000000000, 'AddScheduleWindowRuleCustom3200000000000'),
+(3210000000000, 'EmptyContainerReturnedBy3210000000000'),
+(3220000000000, 'EmptyContainerReturnStatusHistory3220000000000'),
+(3230000000000, 'SplitContractTemplatesByCustoms3230000000000'),
+(3240000000000, 'CreateExchangeSettings3240000000000');
diff --git a/migrations-rows-backup-20260809.dump b/migrations-rows-backup-20260809.dump
new file mode 100644
index 000000000..338cca6f7
Binary files /dev/null and b/migrations-rows-backup-20260809.dump differ
diff --git a/packages/api-common/src/filters/http-exception.filter.ts b/packages/api-common/src/filters/http-exception.filter.ts
index 3dc301a0b..3015d239f 100644
--- a/packages/api-common/src/filters/http-exception.filter.ts
+++ b/packages/api-common/src/filters/http-exception.filter.ts
@@ -7,6 +7,8 @@ import {
   Logger,
 } from "@nestjs/common";
 
+import { logCtx } from "../logging/request-context";
+
 interface ErrorResponseBody {
   success: false;
   statusCode: number;
@@ -120,6 +122,18 @@ export class HttpExceptionFilter implements ExceptionFilter {
       path: request.url,
     };
 
+    // Land the failure on the request's canonical log line too — the middleware
+    // only sees a status code, not what threw. No-op outside a request.
+    logCtx(
+      {
+        name: exception instanceof Error ? exception.name : "Error",
+        message,
+        status,
+        stack: status >= 500 ? (exception as Error)?.stack : undefined,
+      },
+      { path: "error", mode: "set" },
+    );
+
     if (status >= 500) {
       this.logger.error(
         `${request.method} ${request.url} -> ${status}`,
diff --git a/packages/api-common/src/index.ts b/packages/api-common/src/index.ts
index 8561f3721..d71f026da 100644
--- a/packages/api-common/src/index.ts
+++ b/packages/api-common/src/index.ts
@@ -6,6 +6,10 @@ export * from "./decorators/public.decorator";
 // Filters
 export * from "./filters/http-exception.filter";
 
+// Logging
+export * from "./logging/request-context";
+export * from "./logging/request-log.middleware";
+
 // Interceptors
 export * from "./interceptors/response-transform.interceptor";
 
diff --git a/packages/api-common/src/logging/request-context.ts b/packages/api-common/src/logging/request-context.ts
new file mode 100644
index 000000000..0b41222ee
--- /dev/null
+++ b/packages/api-common/src/logging/request-context.ts
@@ -0,0 +1,109 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+/**
+ * Per-request bag of data points that end up on the canonical request log line
+ * (see request-log.middleware.ts). Anything written here is flattened into one
+ * JSON object at the end of the request, so keep it to values that are safe to
+ * ship to a log aggregator: ids, states, counts, outcomes — never secrets,
+ * tokens, or raw uploads.
+ */
+export type RequestLogContext = Record<string, unknown>;
+
+const storage = new AsyncLocalStorage<RequestLogContext>();
+
+export const getLogContext = (): RequestLogContext | undefined =>
+  storage.getStore();
+
+export const runWithLogContext = <T>(
+  seed: RequestLogContext,
+  fn: () => T,
+): T => storage.run(seed, fn);
+
+export interface LogCtxOptions {
+  /**
+   * Dot path to write under, e.g. "booking.transition". Namespacing is just a
+   * path with one segment ("payment"). Root object when omitted.
+   */
+  path?: string;
+  /**
+   * How the value lands:
+   * - `merge` (default) — shallow-merge objects into the target
+   * - `set` — overwrite the target
+   * - `push` — append to an array at the target
+   * - `count` — add the value (default 1) to a numeric counter at the target
+   */
+  mode?: "merge" | "set" | "push" | "count";
+}
+
+/** Escape hatch when the four modes don't fit: mutate the context yourself. */
+export type LogCtxMutator = (ctx: RequestLogContext, value: unknown) => void;
+
+// ponytail: fixed cap so a loop calling logCtx in `push` mode can't grow an
+// unbounded array in memory / a megabyte log line. Per-path caps if one ever
+// legitimately needs more.
+const MAX_PUSHED = 100;
+
+const isPlainObject = (v: unknown): v is Record<string, unknown> =>
+  typeof v === "object" && v !== null && !Array.isArray(v);
+
+/**
+ * Append a data point to the current request's canonical log line.
+ *
+ * No-op outside an HTTP request (bootstrap, cron, queue consumers) — callers
+ * never need to guard.
+ *
+ *   logCtx({ bookingId, status });                            // root merge
+ *   logCtx(intentId, { path: "payment.intentId", mode: "set" });
+ *   logCtx({ from, to }, { path: "booking.transition" });     // namespaced
+ *   logCtx({ wagonId }, { path: "wagons", mode: "push" });    // array
+ *   logCtx(1, { path: "smsSent", mode: "count" });            // counter
+ *   logCtx(err, (ctx, e) => { ctx.lastError = String(e); });  // custom
+ */
+export function logCtx(
+  value: unknown,
+  opts: LogCtxOptions | LogCtxMutator = {},
+): void {
+  const ctx = storage.getStore();
+  if (!ctx) return;
+
+  if (typeof opts === "function") {
+    opts(ctx, value);
+    return;
+  }
+
+  const { path, mode = "merge" } = opts;
+
+  if (!path) {
+    if (isPlainObject(value)) Object.assign(ctx, value);
+    return;
+  }
+
+  const keys = path.split(".");
+  const leaf = keys.pop() as string;
+  let node: Record<string, unknown> = ctx;
+  for (const key of keys) {
+    if (!isPlainObject(node[key])) node[key] = {};
+    node = node[key] as Record<string, unknown>;
+  }
+
+  switch (mode) {
+    case "set":
+      node[leaf] = value;
+      break;
+    case "push": {
+      const arr = Array.isArray(node[leaf]) ? (node[leaf] as unknown[]) : [];
+      if (arr.length < MAX_PUSHED) arr.push(value);
+      node[leaf] = arr;
+      break;
+    }
+    case "count":
+      node[leaf] =
+        ((node[leaf] as number) ?? 0) + (typeof value === "number" ? value : 1);
+      break;
+    default:
+      node[leaf] =
+        isPlainObject(node[leaf]) && isPlainObject(value)
+          ? Object.assign(node[leaf] as Record<string, unknown>, value)
+          : value;
+  }
+}
diff --git a/packages/api-common/src/logging/request-log.middleware.ts b/packages/api-common/src/logging/request-log.middleware.ts
new file mode 100644
index 000000000..4144e72c8
--- /dev/null
+++ b/packages/api-common/src/logging/request-log.middleware.ts
@@ -0,0 +1,213 @@
+import { randomUUID } from "node:crypto";
+import { Injectable, NestMiddleware } from "@nestjs/common";
+
+import {
+  RequestLogContext,
+  logCtx,
+  runWithLogContext,
+} from "./request-context";
+
+/**
+ * Structural request/response shapes — express types are not a dependency of
+ * this package (they arrive under @nestjs/platform-express in the apps).
+ */
+interface LoggedRequest {
+  method: string;
+  url: string;
+  originalUrl?: string;
+  baseUrl?: string;
+  route?: { path?: string };
+  headers: Record<string, string | string[] | undefined>;
+  ip?: string;
+  query?: Record<string, unknown>;
+  /** Set by the IAM JwtGuard AFTER this middleware runs — read at emit time. */
+  user?: AuthenticatedUser | null;
+  currentUnitId?: string;
+}
+
+/**
+ * The subset of `TCurrentUser` (@tria-plc/api-common) the log line reads.
+ * Everything here is an identifier, a key or a status — the personal fields on
+ * that type (name, email, username, phoneNumber) are deliberately absent so
+ * they cannot be picked up by accident.
+ */
+interface AuthenticatedUser {
+  id?: string;
+  sub?: string;
+  userId?: string;
+  sessionId?: string;
+  userType?: string;
+  status?: string;
+  roles?: { key?: string }[];
+  permissions?: unknown[];
+  employee?: {
+    id?: string;
+    organizationId?: string;
+    unitId?: string;
+    position?: {
+      id?: string;
+      key?: string;
+      employeePositionId?: string;
+      isDelegate?: boolean;
+      delegatorId?: string;
+      positionType?: { key?: string };
+    };
+  };
+}
+
+interface LoggedResponse {
+  statusCode: number;
+  writableEnded?: boolean;
+  setHeader(name: string, value: string): void;
+  on(event: string, listener: () => void): void;
+}
+
+const header = (req: LoggedRequest, name: string): string | undefined => {
+  const value = req.headers[name];
+  return Array.isArray(value) ? value[0] : value;
+};
+
+const userId = (req: LoggedRequest): string | undefined =>
+  req.user?.id ?? req.user?.sub ?? req.user?.userId;
+
+/**
+ * Who the caller was acting as — WITHOUT any personal data. Ids, role/position
+ * keys and statuses only: enough to answer "which desk did this", "was it a
+ * delegate", "which tenant", and to spot an authorization problem, with nothing
+ * that identifies the human behind the account beyond the opaque user id.
+ *
+ * `authenticated: false` with `hasBearer: true` is the signature of a rejected
+ * token (expired session, bad signature) as opposed to a missing one.
+ */
+const authContext = (req: LoggedRequest): Record<string, unknown> => {
+  const user = req.user;
+  const position = user?.employee?.position;
+  return {
+    authenticated: Boolean(user),
+    hasBearer: header(req, "authorization")?.startsWith("Bearer ") ?? false,
+    // Which frontend called — /auth/login rejects cross-audience credentials on it.
+    clientApp: header(req, "x-client-app"),
+    userId: userId(req),
+    sessionId: user?.sessionId,
+    userType: user?.userType,
+    userStatus: user?.status,
+    roles: user?.roles?.map((role) => role.key).filter(Boolean),
+    // Count only: the full grant list is hundreds of keys and would dwarf the line.
+    permissionCount: user?.permissions?.length,
+    employeeId: user?.employee?.id,
+    organizationId: user?.employee?.organizationId,
+    unitId: user?.employee?.unitId ?? req.currentUnitId,
+    positionId: position?.id,
+    positionKey: position?.key,
+    positionType: position?.positionType?.key,
+    employeePositionId: position?.employeePositionId,
+    // Acting on someone else's behalf — the first thing to check when a staff
+    // action lands under an unexpected desk.
+    isDelegate: position?.isDelegate,
+    delegatorId: position?.delegatorId,
+    // Tenant/scope headers the frontends send alongside the token.
+    projectId:
+      header(req, "current-project-id") ?? header(req, "x-current-project-id"),
+  };
+};
+
+/**
+ * Opens an AsyncLocalStorage context for the request (so anything downstream
+ * can `logCtx(...)` into it) and emits ONE canonical JSON line per request when
+ * the response ends — request metadata plus every data point collected during
+ * the flow, on the same Nest logger transport as the rest of the app.
+ *
+ * Base fields win over collected context on key collisions, so a stray
+ * `logCtx({ status })` can never corrupt the fields dashboards filter on.
+ *
+ * Apply FIRST in `configure()`: middleware registered before this one runs
+ * outside the context and its `logCtx` calls are silently dropped.
+ */
+@Injectable()
+export class RequestLogMiddleware implements NestMiddleware {
+  use(req: LoggedRequest, res: LoggedResponse, next: () => void): void {
+    const start = Date.now();
+    const requestId = header(req, "x-request-id") ?? randomUUID();
+    res.setHeader("x-request-id", requestId);
+
+    // Held by reference, NOT read back through the ALS at emit time: response
+    // "finish"/"close" listeners are plain EventEmitter callbacks, which Node
+    // does not bind to the async context they were registered in — getStore()
+    // there returns whatever context happened to call res.end().
+    const ctx: RequestLogContext = {};
+
+    runWithLogContext(ctx, () => {
+      logCtx({ requestId });
+
+      let emitted = false;
+      // "finish" covers normal responses; "close" catches client aborts, where
+      // "finish" never fires and the request would vanish from the logs.
+      const emit = () => {
+        if (emitted) return;
+        emitted = true;
+
+        const url = req.originalUrl ?? req.url;
+        const status = res.statusCode;
+        const durationMs = Date.now() - start;
+
+        const line = {
+          ...ctx,
+          // Fields the Nest console prefix used to carry. They are IN the JSON
+          // now because this line is written raw (see below) — a log shipper
+          // needs level and time as parsable fields, not as console decoration.
+          time: new Date().toISOString(),
+          level: status >= 500 ? "error" : status >= 400 ? "warn" : "info",
+          logger: "request",
+          type: "http_request",
+          requestId,
+          method: req.method,
+          route: req.route?.path
+            ? `${req.baseUrl ?? ""}${req.route.path}`
+            : undefined,
+          url,
+          status,
+          durationMs,
+          userId: userId(req),
+          // Read at emit time on purpose: the guard populates req.user long
+          // after this middleware handed control on.
+          auth: authContext(req),
+          ip: req.ip,
+          userAgent: header(req, "user-agent"),
+          query:
+            req.query && Object.keys(req.query).length ? req.query : undefined,
+          aborted: res.writableEnded === false ? true : undefined,
+        };
+        // A circular value pushed into the context must not throw inside a
+        // response listener — that would take the process down, not the log.
+        let json: string;
+        try {
+          json = JSON.stringify(line);
+        } catch {
+          json = JSON.stringify({
+            time: line.time,
+            level: line.level,
+            logger: "request",
+            type: "http_request",
+            requestId,
+            method: req.method,
+            url,
+            status,
+            durationMs,
+            contextSerializationFailed: true,
+          });
+        }
+
+        // Written raw, NOT through Nest's Logger: the console logger wraps every
+        // message in "[Nest] pid - date LEVEL [ctx] …", which makes the line
+        // un-parsable as JSON. Same destination the Nest logger writes to
+        // (stdout, stderr for errors) — only the decoration is dropped.
+        (status >= 500 ? process.stderr : process.stdout).write(`${json}\n`);
+      };
+
+      res.on("finish", emit);
+      res.on("close", emit);
+
+      next();
+    });
+  }
+}
diff --git a/packages/api-common/src/repositories/base.repository.ts b/packages/api-common/src/repositories/base.repository.ts
index 6374d84a7..c0cc7073b 100644
--- a/packages/api-common/src/repositories/base.repository.ts
+++ b/packages/api-common/src/repositories/base.repository.ts
@@ -7,9 +7,16 @@ import {
   Repository,
 } from "typeorm";
 
+import { logCtx } from "../logging/request-context";
+
 export abstract class BaseRepository<T extends ObjectLiteral> {
   protected constructor(protected readonly repository: Repository<T>) {}
 
+  /** Table name, for the write trail on the canonical request log line. */
+  private get table(): string {
+    return this.repository.metadata.tableName;
+  }
+
   /** Find a single entity by its primary key. */
   async findById(
     id: string,
@@ -34,22 +41,43 @@ export abstract class BaseRepository<T extends ObjectLiteral> {
   /** Create and persist a new entity. */
   async create(data: DeepPartial<T>): Promise<T> {
     const entity = this.repository.create(data);
-    return this.repository.save(entity);
+    const saved = await this.repository.save(entity);
+    logCtx(1, { path: `db.created.${this.table}`, mode: "count" });
+    return saved;
   }
 
-  /** Patch an entity in place and return the reloaded row. */
+  /**
+   * Patch an entity in place and return the reloaded row.
+   *
+   * Every domain status machine in this app (booking, contract, wagon,
+   * warehouse, transfer request…) lands here, so this is the one place that can
+   * record "what state did this request actually move" without every service
+   * remembering to log it.
+   */
   async update(id: string, data: DeepPartial<T>): Promise<T | null> {
     await this.repository.update(id, data as never);
+    logCtx(1, { path: `db.updated.${this.table}`, mode: "count" });
+    if (data && typeof data === "object" && "status" in data) {
+      logCtx(
+        { entity: this.table, id, status: (data as { status: unknown }).status },
+        { path: "statusChanges", mode: "push" },
+      );
+    }
     return this.findById(id);
   }
 
   /** Soft-delete an entity by primary key (sets deleted_at). */
   async softDelete(id: string): Promise<void> {
     await this.repository.softDelete(id);
+    logCtx({ entity: this.table, id }, { path: "deleted", mode: "push" });
   }
 
   /** Permanently delete an entity. Avoid in domain code; prefer softDelete. */
   async hardDelete(id: string): Promise<void> {
     await this.repository.delete(id);
+    logCtx(
+      { entity: this.table, id, hard: true },
+      { path: "deleted", mode: "push" },
+    );
   }
 }
diff --git a/packages/payment-providers/src/index.ts b/packages/payment-providers/src/index.ts
index 523d9fb03..05b21c235 100644
--- a/packages/payment-providers/src/index.ts
+++ b/packages/payment-providers/src/index.ts
@@ -60,6 +60,15 @@ export type {
   WaafiGetTranInfoResponse,
 } from './providers/waafi/waafi.types';
 
+// EbirrPay API-payment request/response types (same ASM envelope as Waafi — see ebirr.types.ts)
+export type {
+  EbirrState,
+  EbirrPurchaseRequest,
+  EbirrPurchaseResponse,
+  EbirrGetTranInfoRequest,
+  EbirrGetTranInfoResponse,
+} from './providers/ebirr/ebirr.types';
+
 // CAC Bank request/response types
 export type {
   CacSigninRequest,
@@ -76,7 +85,7 @@ export type {
 // Webhook payload types
 export type { TelebirrWebhookPayload } from './webhooks/telebirr-webhook.types';
 export type { CbeBirrWebhookPayload } from './webhooks/cbe-birr-webhook.types';
-export type { EBirrWebhookPayload } from './webhooks/ebirr-webhook.types';
+// (no eBirr webhook type: EbirrPay has no callback — the API_PURCHASE response is the result)
 export type { CardWebhookPayload } from './webhooks/card-webhook.types';
 export type {
   WaafiWebhookPayload,
@@ -88,5 +97,8 @@ export type {
 } from './webhooks/waafi-webhook.types';
 export type { DMoneyWebhookPayload } from './webhooks/dmoney-webhook.types';
 
+// Phone-number helpers
+export { normalizeEthiopianMsisdn, maskMsisdn } from './utils/msisdn';
+
 // DI token for injecting all providers as an array (future multi-provider wiring)
 export const PAYMENT_PROVIDERS = Symbol('PAYMENT_PROVIDERS');
diff --git a/packages/payment-providers/src/providers/dmoney/dmoney.provider.ts b/packages/payment-providers/src/providers/dmoney/dmoney.provider.ts
index 51e90381b..3af351e32 100644
--- a/packages/payment-providers/src/providers/dmoney/dmoney.provider.ts
+++ b/packages/payment-providers/src/providers/dmoney/dmoney.provider.ts
@@ -353,7 +353,7 @@ export class DMoneyProvider implements PaymentProvider {
     return this.config.get<string>("dmoney.returnUrl") ?? "";
   }
   private get timeoutExpress(): string {
-    return this.config.get<string>("dmoney.timeoutExpress") ?? "120m";
+    return this.config.get<string>("dmoney.timeoutExpress") ?? "5m";
   }
   private get language(): string {
     return this.config.get<string>("dmoney.language") ?? "en";
diff --git a/packages/payment-providers/src/providers/ebirr/ebirr.provider.ts b/packages/payment-providers/src/providers/ebirr/ebirr.provider.ts
index 2f8e954cf..d8d5e7cf1 100644
--- a/packages/payment-providers/src/providers/ebirr/ebirr.provider.ts
+++ b/packages/payment-providers/src/providers/ebirr/ebirr.provider.ts
@@ -1,4 +1,4 @@
-import { Injectable, Logger } from "@nestjs/common";
+import { Injectable, Logger, OnModuleInit } from "@nestjs/common";
 import { ConfigService } from "@nestjs/config";
 import { HttpService } from "@nestjs/axios";
 import {
@@ -12,225 +12,568 @@ import {
 import { AxiosError, AxiosRequestConfig } from "axios";
 import { firstValueFrom } from "rxjs";
 import * as crypto from "node:crypto";
+import * as https from "node:https";
+import { maskMsisdn, normalizeEthiopianMsisdn } from "../../utils/msisdn";
+import {
+  EbirrGetTranInfoRequest,
+  EbirrGetTranInfoResponse,
+  EbirrPurchaseRequest,
+  EbirrPurchaseResponse,
+} from "./ebirr.types";
 
-interface EBirrInitiateRequest {
-  merchantCode: string;
-  orderNo: string;
-  amount: number;
-  currency: string;
-  subject: string;
-  body: string;
-  notifyUrl: string;
-  returnUrl: string;
-  timestamp: number;
-  sign: string;
-}
+/** EbirrPay's "request processed" envelope code. Says nothing about the payment outcome. */
+const EBIRR_SUCCESS_CODE = "2001";
+/** Status queries are quick lookups — they must not inherit the long purchase timeout. */
+const EBIRR_QUERY_TIMEOUT_MS = 10_000;
 
-interface EBirrInitiateResponse {
-  code: string;
-  message: string;
-  data?: {
-    orderNo: string;
-    payUrl: string;
-    expireTime: number;
-  };
-}
-
-interface EBirrQueryResponse {
-  code: string;
-  message: string;
-  data?: {
-    orderNo: string;
-    tradeStatus: string;
-    tradeNo?: string;
-    totalAmount?: number;
-    payTime?: number;
-  };
-}
+/**
+ * Transport errors that prove the request **never reached eBirr**: a bad URL, DNS, the TCP
+ * connect and the TLS handshake all fail before a single byte of the body is written.
+ *
+ * This distinction is the whole reason the set exists. No debit can exist for a request that was
+ * never sent, so there is nothing for `API_GETTRANINFO` to find — reporting these as PROCESSING
+ * leaves the payer staring at "check your phone" for a prompt that was never pushed, until the
+ * intent expires. They are a payment failure, and the payer should be told immediately.
+ *
+ * Deliberately an allowlist. Anything not named here — notably `ECONNRESET` and `ECONNABORTED`,
+ * which can both fire *after* the body went out — falls through to PROCESSING, because vendor doc
+ * §10 is explicit that an ambiguous send must be resolved by querying, never by assuming failure.
+ */
+const EBIRR_UNDISPATCHED_CODES = new Set([
+  "ERR_INVALID_URL", // empty/misconfigured EBIRR_BASE_URL — no socket is ever opened
+  "ENOTFOUND", // DNS: host does not resolve
+  "EAI_AGAIN", // DNS: resolver timed out
+  "ECONNREFUSED", // TCP: port closed
+  "EHOSTUNREACH",
+  "ENETUNREACH",
+  "CERT_HAS_EXPIRED", // TLS: handshake fails before the request is written
+  "DEPTH_ZERO_SELF_SIGNED_CERT",
+  "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+  "ERR_TLS_CERT_ALTNAME_INVALID",
+]);
 
+/**
+ * EbirrPay — direct mobile-wallet debit (docs/ebirr/INTEGRATION.md).
+ *
+ * Unlike every other gateway in this package, eBirr has **no hosted page, no redirect and no
+ * webhook**. `API_PURCHASE` pushes a PIN prompt to the payer's handset over USSD and holds the
+ * HTTP connection open until they approve or decline it — the synchronous response *is* the
+ * settlement notification.
+ *
+ * The charge is therefore split in two:
+ *
+ *   - `initiate()` performs **no I/O**. It validates the payer account and builds the
+ *     `AWAIT_PUSH` client action used as the fallback when the debit outlives its timeout.
+ *   - `purchase()` issues the actual blocking debit. payment-api's IntentsService awaits it on
+ *     the request path (`settleEBirrPurchase`) so the payer gets the verdict in the initiate
+ *     response — there is no webhook, so this response *is* the settlement notification.
+ *
+ * The wait is bounded by `EBIRR_PURCHASE_TIMEOUT_MS` (45s), which has to stay under the chain's
+ * own limits — the passenger API's 60s `PAYMENT_API_HTTP_TIMEOUT_MS` and nginx's 60s default
+ * `proxy_read_timeout`. A payer slower than that yields PROCESSING and the intent falls back to
+ * `AWAIT_PUSH` for the client poll; the reconciliation sweep settles it via `queryStatus`
+ * (`API_GETTRANINFO`), which is the authority vendor doc §10 points at for missing or ambiguous
+ * responses. That path is rare but must not be removed: the money may already have moved.
+ */
 @Injectable()
-export class EBirrProvider implements PaymentProvider {
+export class EBirrProvider implements PaymentProvider, OnModuleInit {
   readonly method = ProviderMethod.EBIRR;
   private readonly logger = new Logger(EBirrProvider.name);
+  private readonly httpsAgent: https.Agent;
 
   constructor(
     private readonly config: ConfigService,
     private readonly http: HttpService,
-  ) {}
+  ) {
+    const insecure = this.config.get<boolean>("ebirr.insecureTls");
+    if (insecure) {
+      this.logger.warn(
+        "EBIRR_INSECURE_TLS=true — TLS verification disabled for eBirr calls. DEV ONLY.",
+      );
+    }
+    this.httpsAgent = new https.Agent({ rejectUnauthorized: !insecure });
+  }
 
+  /** Log the effective eBirr config once at startup (secrets masked) so misconfig is visible. */
+  onModuleInit(): void {
+    this.logger.log(
+      `eBirr config resolved: ${JSON.stringify(this.effectiveConfig())}`,
+    );
+  }
+
+  /** Snapshot of every resolved eBirr env value; secret fields are masked, not printed raw. */
+  private effectiveConfig(): Record<string, unknown> {
+    return {
+      EBIRR_BASE_URL: this.baseUrl || "(empty)",
+      EBIRR_MERCHANT_UID: this.merchantUid || "(empty)",
+      EBIRR_API_USER_ID: this.apiUserId || "(empty)",
+      EBIRR_API_KEY: this.mask(this.apiKey),
+      EBIRR_PAYMENT_METHOD: this.paymentMethod,
+      EBIRR_CHANNEL_NAME: this.channelName,
+      EBIRR_PURCHASE_TIMEOUT_MS: this.purchaseTimeoutMs,
+      EBIRR_PUSH_TTL_MS: this.pushTtlMs,
+      EBIRR_INSECURE_TLS:
+        this.config.get<boolean>("ebirr.insecureTls") ?? false,
+    };
+  }
+
+  /** Mask a secret to `set(len=N,…abcd)` / `(empty)` so presence & length are visible but not the value. */
+  private mask(value: string): string {
+    if (!value) return "(empty)";
+    const tail = value.length > 4 ? value.slice(-4) : "";
+    return `set(len=${value.length},…${tail})`;
+  }
+
+  /**
+   * Prepare the push debit. Deliberately does no network I/O — the charge itself is `purchase()`.
+   *
+   * `providerOrderId` is our own `merchantOrderId`: this flow mints no separate order id (the
+   * `orderId` the vendor doc §5.4 mentions belongs to the HPP family we don't use), and
+   * `queryStatus` looks the transaction up by `referenceId` anyway.
+   */
   async initiate(
     input: ProviderInitiationInput,
   ): Promise<ProviderInitiationResult> {
-    const amount = input.amountMinor / 100;
-    const timestamp = Date.now();
+    if (!input.payerAccount?.trim()) {
+      throw new Error(
+        "eBirr requires payerAccount (the customer's mobile-wallet number)",
+      );
+    }
+    // Throws on a malformed number rather than pushing a PIN prompt to the wrong handset.
+    const accountNo = normalizeEthiopianMsisdn(input.payerAccount);
 
-    const requestBody: EBirrInitiateRequest = {
-      merchantCode: this.merchantCode,
-      orderNo: input.merchantOrderId,
-      amount,
-      currency: input.currency,
-      subject: `EDR Ticket`,
-      body: `Order ${input.orderRef}`,
-      notifyUrl: this.notifyUrl,
-      // Per-transaction browser return target (each calling app has its own UI); config is fallback.
-      returnUrl: input.returnUrl ?? this.returnUrl,
-      timestamp,
-      sign: this.signRequest({
-        merchantCode: this.merchantCode,
-        orderNo: input.merchantOrderId,
-        amount,
-        timestamp,
-      }),
-    };
-
-    const response = await this.postJson<EBirrInitiateResponse>(
-      `${this.baseUrl}/gateway/api/pay/create`,
-      requestBody,
+    this.logger.log(
+      `eBirr initiate ref=${input.merchantOrderId} account=${maskMsisdn(accountNo)} ` +
+        `currency=${input.currency} amount=${this.toAmount(input.amountMinor)} ` +
+        `(amountMinorIn=${input.amountMinor})`,
     );
 
-    if (response.code !== "0000" || !response.data?.orderNo) {
-      throw new Error(`eBirr initiate failed: ${response.message}`);
-    }
-
-    const expiresAt = new Date(response.data.expireTime);
-
     return {
-      providerOrderId: response.data.orderNo,
-      clientAction: { type: "REDIRECT", url: response.data.payUrl },
-      expiresAt,
+      providerOrderId: input.merchantOrderId,
+      clientAction: {
+        type: "AWAIT_PUSH",
+        message:
+          "Check your phone and enter your eBirr PIN to approve the payment.",
+        payerAccountMasked: maskMsisdn(accountNo),
+      },
+      expiresAt: new Date(Date.now() + this.pushTtlMs),
       rawInitiation: {
-        request: this.sanitize(requestBody),
-        response,
+        request: this.sanitizeRequest(
+          this.buildPurchaseRequest(input, accountNo),
+        ),
       },
     };
   }
 
-  async queryStatus(merchantOrderId: string): Promise<ProviderStatus> {
-    const timestamp = Date.now();
-    const requestBody = {
-      merchantCode: this.merchantCode,
-      orderNo: merchantOrderId,
-      timestamp,
-      sign: this.signRequest({
-        merchantCode: this.merchantCode,
-        orderNo: merchantOrderId,
-        timestamp,
-      }),
-    };
+  /**
+   * Issue the debit. Blocks for as long as the payer takes to enter their PIN, so it must be
+   * called off the request path.
+   *
+   * Never throws: a transport failure or timeout is reported as PROCESSING, not FAILED. The money
+   * may well have moved, and the vendor doc §10 is explicit that a timeout must be resolved by
+   * querying, not by assuming failure and re-charging.
+   */
+  async purchase(input: ProviderInitiationInput): Promise<ProviderStatus> {
+    const accountNo = normalizeEthiopianMsisdn(input.payerAccount ?? "");
+    const requestBody = this.buildPurchaseRequest(input, accountNo);
+    const url = `${this.baseUrl}/asm`;
 
-    const response = await this.postJson<EBirrQueryResponse>(
-      `${this.baseUrl}/gateway/api/pay/query`,
-      requestBody,
+    this.logger.log(
+      `eBirr API_PURCHASE → ${url} ref=${input.merchantOrderId} ` +
+        `account=${maskMsisdn(accountNo)} amount=${requestBody.serviceParams.transactionInfo.amount} ` +
+        `${input.currency} (awaiting payer PIN, up to ${this.purchaseTimeoutMs}ms)`,
     );
 
-    if (response.code !== "0000" || !response.data) {
-      throw new Error(`eBirr query failed: ${response.message}`);
+    let response: EbirrPurchaseResponse;
+    try {
+      response = await this.postJson<EbirrPurchaseResponse>(
+        url,
+        requestBody,
+        this.purchaseTimeoutMs,
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const code = (err as { code?: string })?.code;
+
+      // Never sent: no debit exists, so there is nothing to reconcile and no reason to make the
+      // payer wait. Fail it now with a cause they can act on.
+      if (this.isUndispatched(err)) {
+        this.logger.error(
+          `eBirr API_PURCHASE ${input.merchantOrderId} was never dispatched (${code ?? "n/a"}: ` +
+            `${message}) — no debit exists, failing the intent instead of awaiting reconciliation`,
+        );
+        return {
+          status: ProviderPaymentStatus.FAILED,
+          failureCode: code ?? "EBIRR_UNREACHABLE",
+          failureMessage:
+            "Could not reach eBirr — no payment was taken. Please try again.",
+          rawResponse: { error: message, code, dispatched: false },
+        };
+      }
+
+      // Sent but unanswered: unresolved, NOT failed. The sweep settles it via API_GETTRANINFO.
+      this.logger.warn(
+        `eBirr API_PURCHASE ${input.merchantOrderId} did not return a verdict ` +
+          `(${message}) — leaving PROCESSING for reconciliation`,
+      );
+      return {
+        status: ProviderPaymentStatus.PROCESSING,
+        rawResponse: { error: message, code, dispatched: true },
+      };
     }
 
-    const mapped = this.mapStatus(response.data.tradeStatus);
+    const rawResponse = response as unknown as Record<string, unknown>;
+    const state = response.params?.state;
+    const mapped = this.resolveVerdict(response.responseCode, state);
+
+    if (mapped === ProviderPaymentStatus.FAILED) {
+      this.logger.error(
+        `eBirr API_PURCHASE ${input.merchantOrderId} rejected: ` +
+          `${response.responseCode}/${response.errorCode} ${response.responseMsg} ` +
+          `state=${state ?? "n/a"} (txn=${response.params?.transactionId ?? "n/a"})`,
+      );
+    } else {
+      this.logger.log(
+        `eBirr API_PURCHASE ${input.merchantOrderId} state=${state ?? "n/a"} → ${mapped} ` +
+          `(txn=${response.params?.transactionId ?? "n/a"}, order=${response.params?.orderId ?? "n/a"})`,
+      );
+    }
 
     return {
       status: mapped,
-      providerTxnId: response.data.tradeNo,
+      // Present on rejected responses too (eBirr records the failed attempt), so this is
+      // captured regardless of verdict — it is what reconciliation quotes back to eBirr.
+      providerTxnId: response.params?.transactionId,
       failureCode:
         mapped === ProviderPaymentStatus.FAILED
-          ? response.data.tradeStatus
+          ? response.errorCode || response.responseCode
           : undefined,
+      failureMessage:
+        mapped === ProviderPaymentStatus.FAILED
+          ? // `params.description` is the specific cause ("Invalid Credentials"); responseMsg is
+            // the generic wrapper ("Payment Failed (Invalid Credentials)").
+            (response.params?.description ?? response.responseMsg)
+          : undefined,
+      rawResponse,
+    };
+  }
+
+  /**
+   * Did this error happen *before* the request was written to the wire?
+   *
+   * Only errors we can prove were never dispatched may be reported as FAILED — everything else
+   * has to stay PROCESSING, because a request eBirr received may have moved money.
+   */
+  private isUndispatched(err: unknown): boolean {
+    // An HTTP response came back — whatever its status, eBirr received the request.
+    if (err instanceof AxiosError && err.response) return false;
+
+    const code = (err as { code?: string })?.code;
+    const message = err instanceof Error ? err.message : String(err);
+
+    // ETIMEDOUT is ambiguous and has to be read from the message. Node reports a TCP connect
+    // timeout as `connect ETIMEDOUT <ip>:<port>` — nothing was sent. Axios reports its own *read*
+    // timeout with the same code when `clarifyTimeoutError` is set, but phrases it
+    // "timeout of Nms exceeded" — that one was sent and is still in flight.
+    if (code === "ETIMEDOUT") return message.startsWith("connect ");
+
+    return !!code && EBIRR_UNDISPATCHED_CODES.has(code);
+  }
+
+  /**
+   * Decide the outcome from an eBirr response.
+   *
+   * Observed against the live sandbox: a *rejected* envelope still carries the authoritative
+   * verdict in `params.state` — e.g. `5206/E10205` with `state: DECLINED`, and `5001/4004`
+   * ("User Aborted") with `state: TIMEOUT`. So `state` wins whenever it is present; the envelope
+   * code is only the fallback for responses that carry no `params` at all.
+   *
+   * The one thing `state` may never do is promote a rejected envelope to SUCCEEDED — success
+   * requires both a 2001 envelope and an approving state.
+   */
+  private resolveVerdict(
+    responseCode: string,
+    state: string | undefined,
+  ): ProviderPaymentStatus {
+    const envelopeOk = responseCode === EBIRR_SUCCESS_CODE;
+    if (!state) {
+      return envelopeOk
+        ? ProviderPaymentStatus.PROCESSING
+        : ProviderPaymentStatus.FAILED;
+    }
+    const mapped = this.mapStatus(state);
+    if (mapped === ProviderPaymentStatus.SUCCEEDED && !envelopeOk) {
+      return ProviderPaymentStatus.FAILED;
+    }
+    return mapped;
+  }
+
+  async queryStatus(merchantOrderId: string): Promise<ProviderStatus> {
+    const response = await this.postJson<EbirrGetTranInfoResponse>(
+      `${this.baseUrl}/asm`,
+      this.buildGetTranInfoRequest(merchantOrderId),
+      EBIRR_QUERY_TIMEOUT_MS,
+    );
+
+    const rawState =
+      response.params?.status ??
+      response.params?.state ??
+      response.params?.tranStatusDesc;
+
+    // A rejected envelope that still carries a state is a real verdict — the purchase endpoint
+    // demonstrably does this (5206/DECLINED, 5001/TIMEOUT), so don't assume the query endpoint
+    // won't. Trust the state; only fall back to the envelope when there is none.
+    if (rawState) {
+      const mapped = this.resolveVerdict(response.responseCode, rawState);
+      this.logger.log(
+        `eBirr API_GETTRANINFO ${merchantOrderId} state=${rawState} → ${mapped} ` +
+          `(txn=${response.params?.transactionId ?? "n/a"}, order=${response.params?.orderId ?? "n/a"})`,
+      );
+      return {
+        status: mapped,
+        providerTxnId: response.params?.transactionId,
+        failureCode:
+          mapped === ProviderPaymentStatus.FAILED
+            ? response.errorCode || rawState
+            : undefined,
+        failureMessage:
+          mapped === ProviderPaymentStatus.FAILED
+            ? (response.params?.description ?? response.responseMsg)
+            : undefined,
+        rawResponse: response as unknown as Record<string, unknown>,
+      };
+    }
+
+    // No state at all. Same convention as waafi/cac-bank: eBirr returns a bare error envelope
+    // for a transaction it has no record of, which means the payer hasn't answered the prompt
+    // yet — that is REQUIRES_ACTION (still waiting on the handset), NOT PROCESSING. Persisting a
+    // PROCESSING guess would let the sweep strand a payer on a push they never touched. The
+    // intent still resolves: via purchase()'s verdict, or via expiresAt.
+    if (response.responseCode !== EBIRR_SUCCESS_CODE) {
+      this.logger.warn(
+        `eBirr API_GETTRANINFO ${merchantOrderId}: ${response.responseCode}/${response.errorCode} ` +
+          `${response.responseMsg} — no state returned, treating as still awaiting the payer`,
+      );
+      return {
+        status: ProviderPaymentStatus.REQUIRES_ACTION,
+        rawResponse: response as unknown as Record<string, unknown>,
+      };
+    }
+
+    return {
+      status: ProviderPaymentStatus.PROCESSING,
+      providerTxnId: response.params?.transactionId,
       rawResponse: response as unknown as Record<string, unknown>,
     };
   }
 
-  verifyWebhookSignature(payload: Record<string, unknown>): boolean {
-    const { sign, ...data } = payload;
-    if (!sign || typeof sign !== "string") return false;
-
-    const expectedSign = this.signRequest(data);
-    return crypto.timingSafeEqual(Buffer.from(sign), Buffer.from(expectedSign));
-  }
-
-  mapWebhookStatus(tradeStatus: string): ProviderPaymentStatus {
-    return this.mapStatus(tradeStatus);
-  }
-
-  private mapStatus(tradeStatus: string): ProviderPaymentStatus {
-    switch (tradeStatus?.toUpperCase()) {
-      case "TRADE_SUCCESS":
+  private mapStatus(raw: string | undefined): ProviderPaymentStatus {
+    switch (raw?.toUpperCase()) {
+      case "APPROVED":
       case "SUCCESS":
         return ProviderPaymentStatus.SUCCEEDED;
-      case "TRADE_CLOSED":
-      case "TRADE_FAILED":
+      case "CANCELED":
+      case "CANCELLED":
+        return ProviderPaymentStatus.CANCELLED;
+      case "DECLINED":
+      case "REJECTED":
       case "FAILED":
+      case "EXPIRED":
+      case "TIMEOUT":
         return ProviderPaymentStatus.FAILED;
-      case "WAIT_BUYER_PAY":
       case "PENDING":
+      case "INITIATED":
         return ProviderPaymentStatus.REQUIRES_ACTION;
-      case "PROCESSING":
-        return ProviderPaymentStatus.PROCESSING;
       default:
         return ProviderPaymentStatus.PROCESSING;
     }
   }
 
-  private signRequest(data: Record<string, unknown>): string {
-    const sortedKeys = Object.keys(data).sort();
-    const signString =
-      sortedKeys.map((key) => `${key}=${data[key]}`).join("&") +
-      `&key=${this.secretKey}`;
-
-    return crypto
-      .createHash("md5")
-      .update(signString)
-      .digest("hex")
-      .toUpperCase();
+  private buildPurchaseRequest(
+    input: ProviderInitiationInput,
+    accountNo: string,
+  ): EbirrPurchaseRequest {
+    return {
+      schemaVersion: "1.0",
+      requestId: crypto.randomUUID(),
+      timestamp: this.timestamp(),
+      channelName: this.channelName,
+      serviceName: "API_PURCHASE",
+      serviceParams: {
+        merchantUid: this.merchantUid,
+        apiKey: this.apiKey,
+        apiUserId: this.apiUserId,
+        paymentMethod: this.paymentMethod,
+        payerInfo: { accountNo },
+        transactionInfo: {
+          referenceId: input.merchantOrderId,
+          invoiceId: input.orderRef,
+          amount: this.toAmount(input.amountMinor),
+          // Charge exactly the currency the caller already converted to. The provider never
+          // relabels the currency.
+          currency: input.currency,
+          description: `${input.orderRef}`,
+        },
+      },
+    };
   }
 
-  private async postJson<T>(url: string, body: unknown): Promise<T> {
-    const config: AxiosRequestConfig = {
-      headers: {
-        "Content-Type": "application/json",
+  private buildGetTranInfoRequest(
+    merchantOrderId: string,
+  ): EbirrGetTranInfoRequest {
+    return {
+      schemaVersion: "1.0",
+      requestId: crypto.randomUUID(),
+      timestamp: this.timestamp(),
+      channelName: this.channelName,
+      serviceName: "API_GETTRANINFO",
+      serviceParams: {
+        merchantUid: this.merchantUid,
+        apiKey: this.apiKey,
+        apiUserId: this.apiUserId,
+        referenceId: merchantOrderId,
       },
-      timeout: 10_000,
     };
+  }
+
+  /**
+   * `amountMinor` is a misnomer inherited from the shared contract — it carries the *major*
+   * amount (see PaymentIntent.amountMinor: "real/major price; may be fractional"). Pass it
+   * through at 2dp. Never divide by 100 (the pre-rewrite code did, charging 1/100th), and don't
+   * borrow Waafi's `Math.trunc` — that is only correct for 0-decimal DJF and would drop ETB cents.
+   */
+  private toAmount(amountMinor: number): number {
+    return Number(amountMinor.toFixed(2));
+  }
+
+  /** eBirr expects `YYYY-MM-DD HH:mm:ss` — not the epoch seconds Waafi's `/asm` accepts. */
+  private timestamp(): string {
+    const d = new Date();
+    const pad = (n: number): string => String(n).padStart(2, "0");
+    return (
+      `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+      `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
+    );
+  }
+
+  /**
+   * Single funnel for every `/asm` call, so the full wire request and the full wire response are
+   * both logged for `API_PURCHASE` and `API_GETTRANINFO` alike — at `log`, not `debug`, because
+   * eBirr has no webhook and no dashboard we can see: when a payer disputes a debit these lines
+   * are the only record of what we sent and what came back. Bodies pass through `sanitize*` so the
+   * api key and the payer's full MSISDN never reach the log sink.
+   */
+  private async postJson<T>(
+    url: string,
+    body: unknown,
+    timeout: number,
+  ): Promise<T> {
+    const config: AxiosRequestConfig = {
+      headers: { "Content-Type": "application/json" },
+      timeout,
+      httpsAgent: this.httpsAgent,
+    };
+
+    const envelope = body as { serviceName?: string; requestId?: string };
+    const tag = `${envelope.serviceName ?? "UNKNOWN"} requestId=${envelope.requestId ?? "n/a"}`;
+
+    this.logger.log(
+      `eBirr → POST ${url} ${tag} request=${JSON.stringify(this.sanitizeRequest(body))}`,
+    );
 
     const started = Date.now();
     try {
       const res = await firstValueFrom(this.http.post<T>(url, body, config));
-      this.logger.debug(
-        `eBirr POST ${url} status=${res.status} latency=${Date.now() - started}ms`,
+      this.logger.log(
+        `eBirr ← ${tag} status=${res.status} latency=${Date.now() - started}ms ` +
+          `response=${JSON.stringify(this.sanitizeResponse(res.data))}`,
       );
       return res.data;
     } catch (err) {
+      const latency = Date.now() - started;
       if (err instanceof AxiosError) {
         this.logger.error(
-          `eBirr POST ${url} failed: status=${err.response?.status} body=${JSON.stringify(err.response?.data)}`,
+          `eBirr ← ${tag} failed after ${latency}ms: status=${err.response?.status} ` +
+            `response=${JSON.stringify(this.sanitizeResponse(err.response?.data))} ` +
+            `code=${err.code} message=${err.message}`,
         );
       } else {
         this.logger.error(
-          `eBirr POST ${url} threw: ${err instanceof Error ? err.message : err}`,
+          `eBirr ← ${tag} threw after ${latency}ms: ${err instanceof Error ? err.message : err}`,
         );
       }
       throw err;
     }
   }
 
-  private sanitize(body: EBirrInitiateRequest): Record<string, unknown> {
-    const { sign: _sign, ...rest } = body;
-    return rest;
+  /**
+   * Redact the api key and mask the payer MSISDN in an outbound envelope. Covers both service
+   * shapes: `API_PURCHASE` carries `payerInfo.accountNo`, `API_GETTRANINFO` carries neither.
+   */
+  private sanitizeRequest(body: unknown): Record<string, unknown> {
+    const envelope = body as EbirrPurchaseRequest;
+    const params = envelope?.serviceParams as
+      | (EbirrPurchaseRequest["serviceParams"] & Record<string, unknown>)
+      | undefined;
+    if (!params) return body as Record<string, unknown>;
+
+    return {
+      ...envelope,
+      serviceParams: {
+        ...params,
+        apiKey: "***REDACTED***",
+        ...(params.payerInfo
+          ? { payerInfo: { accountNo: maskMsisdn(params.payerInfo.accountNo) } }
+          : {}),
+      },
+    };
+  }
+
+  /**
+   * Responses carry no secret, but `params.accountNo` / `params.payerId` echo the payer's wallet
+   * number back — mask those the same way the request side does.
+   */
+  private sanitizeResponse(data: unknown): unknown {
+    if (!data || typeof data !== "object") return data;
+
+    const response = data as { params?: Record<string, unknown> };
+    if (!response.params) return data;
+
+    const params = { ...response.params };
+    for (const key of ["accountNo", "payerId"]) {
+      const value = params[key];
+      if (typeof value === "string" && value) params[key] = maskMsisdn(value);
+    }
+    return { ...response, params };
   }
 
   private get baseUrl(): string {
     return this.config.get<string>("ebirr.baseUrl") ?? "";
   }
-  private get merchantCode(): string {
-    return this.config.get<string>("ebirr.merchantCode") ?? "";
+  private get merchantUid(): string {
+    return this.config.get<string>("ebirr.merchantUid") ?? "";
   }
-  private get secretKey(): string {
-    return this.config.get<string>("ebirr.secretKey") ?? "";
+  private get apiKey(): string {
+    return this.config.get<string>("ebirr.apiKey") ?? "";
   }
-  private get notifyUrl(): string {
-    return this.config.get<string>("ebirr.notifyUrl") ?? "";
+  private get apiUserId(): string {
+    return this.config.get<string>("ebirr.apiUserId") ?? "";
   }
-  private get returnUrl(): string {
-    return this.config.get<string>("ebirr.returnUrl") ?? "";
+  private get paymentMethod(): string {
+    return this.config.get<string>("ebirr.paymentMethod") ?? "MWALLET_ACCOUNT";
+  }
+  private get channelName(): string {
+    return this.config.get<string>("ebirr.channelName") ?? "WEB";
+  }
+  /**
+   * How long `purchase()` waits for the payer's PIN. This is awaited on the request path (see
+   * IntentsService.settleEBirrPurchase), so it MUST stay below the passenger API's
+   * PAYMENT_API_HTTP_TIMEOUT_MS (60s) and any proxy read timeout in front of it.
+   */
+  private get purchaseTimeoutMs(): number {
+    return this.config.get<number>("ebirr.purchaseTimeoutMs") ?? 45_000;
+  }
+  private get pushTtlMs(): number {
+    return this.config.get<number>("ebirr.pushTtlMs") ?? 180_000;
   }
 }
diff --git a/packages/payment-providers/src/providers/ebirr/ebirr.types.ts b/packages/payment-providers/src/providers/ebirr/ebirr.types.ts
new file mode 100644
index 000000000..b62538d99
--- /dev/null
+++ b/packages/payment-providers/src/providers/ebirr/ebirr.types.ts
@@ -0,0 +1,143 @@
+/**
+ * EbirrPay (API Payment) request/response types — docs/ebirr/EbirrPay for API PAYMENT.md.
+ *
+ * EbirrPay is the same ASM platform as WaafiPay: every operation is multiplexed through a single
+ * `POST /asm`, discriminated by `serviceName`, with the identical envelope and the identical
+ * `responseCode === '2001'` convention. See `../waafi/waafi.types.ts`.
+ *
+ * We use the API family (`API_PURCHASE`, `API_GETTRANINFO`), which is a *direct wallet debit*:
+ * the purchase call pushes a PIN prompt to the payer's handset over USSD and blocks until they
+ * approve it. There is no hosted page, no redirect and no webhook — the vendor doc's §5 "Redirects
+ * the customer to a secure Hosted Payment Page" and §8.3 "EbirrPay returns APIUrl and orderId" are
+ * stale copy-paste from the HPP family, contradicted by §5.3's own response body. See
+ * docs/ebirr/INTEGRATION.md.
+ */
+
+/** Terminal/intermediate states reported by EbirrPay (`params.state` / `params.status`). */
+export type EbirrState =
+  | 'APPROVED'
+  | 'DECLINED'
+  | 'FAILED'
+  | 'CANCELLED'
+  | 'EXPIRED'
+  | 'TIMEOUT'
+  | string;
+
+/** Common request envelope shared by every `/asm` call (§3). */
+export interface EbirrRequestEnvelope<TServiceParams> {
+  schemaVersion: '1.0';
+  requestId: string;
+  timestamp: string;
+  channelName: string;
+  serviceName: string;
+  serviceParams: TServiceParams;
+}
+
+/** Common response envelope. `responseCode === '2001'` means the request was processed. */
+export interface EbirrResponseEnvelope<TParams> {
+  schemaVersion: string;
+  timestamp: string;
+  responseId: string;
+  responseCode: string;
+  errorCode: string;
+  responseMsg: string;
+  params?: TParams;
+}
+
+// --- API_PURCHASE -----------------------------------------------------------------------------
+
+export interface EbirrPurchaseServiceParams {
+  merchantUid: string;
+  /** Merchant API key (§4). The vendor doc also calls this `APIKey` in §6.2/§7.2 — same field. */
+  apiKey: string;
+  /** Doc §5.2 types this as a Number, but the live API accepts the string form. */
+  apiUserId: string;
+  paymentMethod: string;
+  /**
+   * The payer's wallet. Doc §5.2 names this `subscriptionId`, but the field the live sandbox
+   * actually accepts is `accountNo` — verified by hand against testpayments.ebirr.com.
+   */
+  payerInfo: {
+    accountNo: string;
+  };
+  transactionInfo: {
+    referenceId: string;
+    /** Not listed in §5.2 but accepted by the live API and echoed back by API_GETTRANINFO (§7.3). */
+    invoiceId?: string;
+    amount: number;
+    currency: string;
+    description?: string;
+  };
+}
+
+export type EbirrPurchaseRequest = EbirrRequestEnvelope<EbirrPurchaseServiceParams>;
+
+/**
+ * §5.3 plus the fields the live sandbox actually returns.
+ *
+ * `state` is the authoritative outcome. Critically, it is present on **rejected** envelopes too,
+ * so it must be read regardless of `responseCode` — observed live:
+ *
+ *   2001 / errorCode 0     → state APPROVED
+ *   5206 / errorCode E10205 → state DECLINED, description "Invalid Credentials"
+ *   5001 / errorCode 4004   → state TIMEOUT,  description "User Aborted"
+ *
+ * `transactionId` and `orderId` are issued even for failed attempts.
+ */
+export interface EbirrPurchaseParams {
+  accountNo?: string;
+  accountType?: string;
+  state?: EbirrState;
+  merchantCharges?: string;
+  referenceId?: string;
+  transactionId?: string;
+  /** EbirrPay's own order id (doc §11 "EbirrPay order tracking"). Not in §5.3's example. */
+  orderId?: string;
+  issuerTransactionId?: string;
+  txAmount?: string;
+  /** Specific failure cause, e.g. "Invalid Credentials" / "User Aborted". Not in §5.3. */
+  description?: string;
+}
+
+export type EbirrPurchaseResponse = EbirrResponseEnvelope<EbirrPurchaseParams>;
+
+// --- API_GETTRANINFO --------------------------------------------------------------------------
+
+export interface EbirrGetTranInfoServiceParams {
+  merchantUid: string;
+  apiKey: string;
+  apiUserId: string;
+  /** Either the merchant referenceId or the EbirrPay transactionId may be supplied. */
+  referenceId?: string;
+  transactionId?: string;
+}
+
+export type EbirrGetTranInfoRequest = EbirrRequestEnvelope<EbirrGetTranInfoServiceParams>;
+
+/**
+ * §7.3 — field-for-field the same set as `WaafiGetTranInfoParams`.
+ *
+ * The doc renders the first key as `tranStatETBesc`, which is `tranStat` + `usD` + `esc`: the
+ * vendor ran a global USD→ETB replace over the Waafi doc and corrupted `tranStatusDesc`. The real
+ * field is `tranStatusDesc`.
+ */
+export interface EbirrGetTranInfoParams {
+  tranStatusDesc?: string;
+  amount?: string;
+  payerId?: string;
+  paymentMethod?: string;
+  description?: string;
+  tranDate?: string;
+  currency?: string;
+  invoiceId?: string;
+  referenceId?: string;
+  tranAmount?: string;
+  transactionId?: string;
+  orderId?: string;
+  tranStatusId?: string;
+  status?: EbirrState;
+  /** Purchase responses use `state`; assume the query endpoint may too rather than betting on it. */
+  state?: EbirrState;
+}
+
+export type EbirrGetTranInfoResponse = EbirrResponseEnvelope<EbirrGetTranInfoParams>;
diff --git a/packages/payment-providers/src/providers/telebirr/telebirr.provider.ts b/packages/payment-providers/src/providers/telebirr/telebirr.provider.ts
index d732a51e3..32bf859b1 100644
--- a/packages/payment-providers/src/providers/telebirr/telebirr.provider.ts
+++ b/packages/payment-providers/src/providers/telebirr/telebirr.provider.ts
@@ -2,6 +2,8 @@ import { Injectable, Logger } from "@nestjs/common";
 import { ConfigService } from "@nestjs/config";
 import { HttpService } from "@nestjs/axios";
 import {
+  ClientAction,
+  PaymentPlatform,
   PaymentProvider,
   ProviderInitiationInput,
   ProviderInitiationResult,
@@ -67,15 +69,7 @@ export class TelebirrProvider implements PaymentProvider {
       requestBody.biz_content.timeout_express,
     );
     const platform = input.platform ?? "web";
-    const clientAction =
-      platform === "mobile"
-        ? {
-            type: "LAUNCH_APP" as const,
-            appId: this.merchantAppId,
-            receiveCode: response.biz_content?.receiveCode,
-            shortCode: this.merchantCode,
-          }
-        : { type: "REDIRECT" as const, url: this.buildCheckoutUrl(prepayId) };
+    const clientAction = this.buildClientAction(platform, prepayId, response);
 
     return {
       providerOrderId: prepayId,
@@ -199,6 +193,11 @@ export class TelebirrProvider implements PaymentProvider {
     input: ProviderInitiationInput,
   ): CreateOrderRequest {
     const totalAmount = String(input.amountMinor);
+    // In-app pays inside the SuperApp overlay and never navigates, so there is no browser
+    // to send back — telebirr's own in-app integration omits redirect_url entirely. Keep it
+    // absent rather than undefined: a signed-but-unsent field is what produced the earlier
+    // "verify sign failed" (see docs/payment-service + telebirr.crypto skip-undefined).
+    const wantsRedirect = input.platform !== "inapp" && !!input.redirectUrl;
     const req = {
       timestamp: createTimestamp(),
       nonce_str: createNonceStr(),
@@ -214,7 +213,7 @@ export class TelebirrProvider implements PaymentProvider {
         total_amount: totalAmount,
         trans_currency: input.currency,
         timeout_express: this.timeoutExpress,
-        ...(input.redirectUrl ? { redirect_url: input.redirectUrl } : {}),
+        ...(wantsRedirect ? { redirect_url: input.redirectUrl! } : {}),
       },
     };
     const sign = signRequestObject(
@@ -245,6 +244,68 @@ export class TelebirrProvider implements PaymentProvider {
     return { ...req, sign, sign_type: "SHA256WithRSA" };
   }
 
+  /**
+   * Telebirr exposes the same pre-order three ways; only the launch payload differs.
+   *
+   * - `mobile` — native app hands off to the wallet app with a receiveCode.
+   * - `inapp`  — the portal is running inside the telebirr SuperApp mini-app WebView. The
+   *              H5 checkout page is unusable there: it deep-links to `kcbconsumer://…`,
+   *              which the WebView cannot resolve (`net::ERR_UNKNOWN_URL_SCHEME`). The
+   *              signed rawRequest goes to the host JS bridge instead — no navigation.
+   * - `web`    — ordinary browser; redirect to the H5 checkout page.
+   */
+  private buildClientAction(
+    platform: PaymentPlatform,
+    prepayId: string,
+    response: CreateOrderResponse,
+  ): ClientAction {
+    switch (platform) {
+      case "mobile":
+        return {
+          type: "LAUNCH_APP",
+          appId: this.merchantAppId,
+          receiveCode: response.biz_content?.receiveCode,
+          shortCode: this.merchantCode,
+        };
+      case "inapp":
+        return {
+          type: "INVOKE_BRIDGE",
+          bridge: "TELEBIRR",
+          rawRequest: this.buildInAppRawRequest(prepayId),
+        };
+      default:
+        return { type: "REDIRECT", url: this.buildCheckoutUrl(prepayId) };
+    }
+  }
+
+  /**
+   * Signed request handed verbatim to the SuperApp bridge (`js_fun_start_pay`).
+   *
+   * Emits `appid, merch_code, nonce_str, prepay_id, timestamp, sign_type, sign` in that
+   * order — no `webBaseUrl` prefix and no `version`/`trade_type` tail, because the bridge
+   * takes the bare query string rather than a URL.
+   *
+   * `sign_type` sits in the map purely so it lands in the output in the right position;
+   * `buildCanonicalString` excludes it (as does telebirr's own reference implementation),
+   * so the signature covers the same five fields as the web checkout URL.
+   *
+   * Kept separate from `buildCheckoutUrl` rather than sharing a builder: the two payloads
+   * are consumed by different validators, and the web flow is live.
+   */
+  private buildInAppRawRequest(prepayId: string): string {
+    const map: Record<string, string> = {
+      appid: this.merchantAppId,
+      merch_code: this.merchantCode,
+      nonce_str: createNonceStr(),
+      prepay_id: prepayId,
+      timestamp: createTimestamp(),
+      sign_type: "SHA256WithRSA",
+    };
+    const sign = signRequestObject(map, this.privateKey);
+    const fields = Object.entries(map).map(([k, v]) => `${k}=${v}`);
+    return [...fields, `sign=${sign}`].join("&");
+  }
+
   private buildCheckoutUrl(prepayId: string): string {
     const map: Record<string, string> = {
       appid: this.merchantAppId,
diff --git a/packages/payment-providers/src/utils/msisdn.ts b/packages/payment-providers/src/utils/msisdn.ts
new file mode 100644
index 000000000..cb36d53dd
--- /dev/null
+++ b/packages/payment-providers/src/utils/msisdn.ts
@@ -0,0 +1,53 @@
+/**
+ * Ethiopian MSISDN normalisation.
+ *
+ * Passenger phone numbers are stored inconsistently — `+2519…`, `2519…` and local `09…` all
+ * appear (see the variant-building comment in the passenger API's bookings.service). Ethiopian
+ * mobile wallets want the bare international form with no `+` and no leading zero, e.g.
+ * `251923582676`.
+ *
+ * This is deliberately separate from `normalizeCacMobile` (cac-bank.json.ts), which does the
+ * opposite for Djibouti — it *strips* the 253 country code to a national number.
+ */
+
+/** Ethiopian mobile subscriber numbers are 9 digits and always start with 9 (or 7 for Safaricom). */
+const ET_NATIONAL_LENGTH = 9;
+const ET_COUNTRY_CODE = '251';
+
+/**
+ * Convert any accepted Ethiopian phone format to the bare `251XXXXXXXXX` form.
+ *
+ * Accepts `+251923582676`, `251923582676`, `0923582676` and `923582676`, plus spaces, dashes and
+ * parentheses anywhere. Throws on anything that isn't a plausible Ethiopian mobile number rather
+ * than silently sending a wrong account — a mistyped number would push a PIN prompt to a
+ * stranger's handset.
+ */
+export function normalizeEthiopianMsisdn(input: string): string {
+  const digits = (input ?? '').replace(/[\s()+-]/g, '');
+  if (!/^\d+$/.test(digits)) {
+    throw new Error(`Invalid Ethiopian mobile number: ${input}`);
+  }
+
+  let national: string;
+  if (digits.startsWith('00' + ET_COUNTRY_CODE)) {
+    national = digits.slice(2 + ET_COUNTRY_CODE.length);
+  } else if (digits.startsWith(ET_COUNTRY_CODE)) {
+    national = digits.slice(ET_COUNTRY_CODE.length);
+  } else if (digits.startsWith('0')) {
+    national = digits.slice(1);
+  } else {
+    national = digits;
+  }
+
+  if (national.length !== ET_NATIONAL_LENGTH || !/^[79]/.test(national)) {
+    throw new Error(`Invalid Ethiopian mobile number: ${input}`);
+  }
+
+  return `${ET_COUNTRY_CODE}${national}`;
+}
+
+/** Mask an MSISDN for display/logging: `251923582676` → `2519****2676`. */
+export function maskMsisdn(msisdn: string): string {
+  if (msisdn.length <= 8) return '****';
+  return `${msisdn.slice(0, 4)}****${msisdn.slice(-4)}`;
+}
diff --git a/packages/payment-providers/src/webhooks/ebirr-webhook.types.ts b/packages/payment-providers/src/webhooks/ebirr-webhook.types.ts
deleted file mode 100644
index 38516bf29..000000000
--- a/packages/payment-providers/src/webhooks/ebirr-webhook.types.ts
+++ /dev/null
@@ -1,12 +0,0 @@
-export interface EBirrWebhookPayload {
-  merchantCode: string;
-  orderNo: string;
-  tradeStatus: string;
-  tradeNo?: string;
-  totalAmount?: number;
-  currency?: string;
-  payTime?: number;
-  timestamp: number;
-  sign: string;
-  [key: string]: unknown;
-}
diff --git a/packages/types/src/common/payments.ts b/packages/types/src/common/payments.ts
index 04849f54d..430170548 100644
--- a/packages/types/src/common/payments.ts
+++ b/packages/types/src/common/payments.ts
@@ -32,7 +32,8 @@ export enum ProviderMethod {
   CBE_BILL = "CBE_BILL",
 }
 
-export type PaymentPlatform = "web" | "mobile";
+
+export type PaymentPlatform = "web" | "mobile" | "inapp";
 
 export type ClientAction =
   | { type: "REDIRECT"; url: string }
@@ -42,11 +43,32 @@ export type ClientAction =
       receiveCode?: string;
       shortCode: string;
     }
+  | {
+      type: "INVOKE_BRIDGE";
+      /** Which SuperApp host bridge the payload targets. */
+      bridge: "TELEBIRR";
+      /**
+       * Signed query string handed verbatim to the host bridge (`js_fun_start_pay`).
+       * NOT a URL — it has no scheme or host and must never be navigated to.
+       */
+      rawRequest: string;
+    }
   | {
       type: "COLLECT_OTP";
       providerOrderId: string;
       message?: string;
     }
+  | {
+      /**
+       * Wallet push-debit (eBirr): the provider has already prompted the payer on their own
+       * handset (USSD/app PIN). There is nothing to navigate to and nothing to collect —
+       * the client shows `message` and polls the intent until it turns terminal.
+       */
+      type: "AWAIT_PUSH";
+      message: string;
+      /** Masked MSISDN the prompt was pushed to, so the payer can confirm it's their phone. */
+      payerAccountMasked?: string;
+    }
   | {
       /** CBE_BILL: show the bill reference the customer pays at any CBE channel. */
       type: "SHOW_BILL_REFERENCE";
@@ -66,6 +88,8 @@ export interface ProviderInitiationInput {
    * Payer account identifier (e.g. mobile-wallet MSISDN in full international format).
    * Optional and provider-specific: some wallet providers (e.g. Waafi HPP with
    * MWALLET_ACCOUNT) require the payer's phone number up front to pre-fill the hosted page.
+   * For push-debit providers (eBirr, CAC Bank) it is mandatory — it is the account the PIN
+   * prompt is pushed to, so there is no hosted page that could collect it later.
    */
   payerAccount?: string;
   /** Optional caller-supplied redirect targets for redirect/HPP-style providers. */
diff --git a/packages/types/src/freight/clearance-files.catalog.ts b/packages/types/src/freight/clearance-files.catalog.ts
index cb4f976eb..8fa50cba4 100644
--- a/packages/types/src/freight/clearance-files.catalog.ts
+++ b/packages/types/src/freight/clearance-files.catalog.ts
@@ -156,6 +156,48 @@ export function transitPermitFileLabel(code: string, index?: number): string {
   return code;
 }
 
+/** Legacy single Delivery Order code (pre multi-file uploads). */
+export const LEGACY_DELIVERY_ORDER_CODE = "delivery_order";
+
+/** Multi-file Delivery Order uploads use `delivery_order_0`, `delivery_order_1`, … */
+export const DELIVERY_ORDER_FILE_PREFIX = "delivery_order_";
+
+export function isDeliveryOrderFileCode(code: string | null | undefined): boolean {
+  if (!code) return false;
+  const lower = code.toLowerCase();
+  return lower === LEGACY_DELIVERY_ORDER_CODE || lower.startsWith(DELIVERY_ORDER_FILE_PREFIX);
+}
+
+export function deliveryOrderFileLabel(code: string, index?: number): string {
+  const lower = code.toLowerCase();
+  if (lower === LEGACY_DELIVERY_ORDER_CODE) return "Delivery Order";
+  if (lower.startsWith(DELIVERY_ORDER_FILE_PREFIX)) {
+    return index != null ? `Delivery Order ${index + 1}` : "Delivery Order";
+  }
+  return code;
+}
+
+/** Legacy single Release Order code (pre multi-file uploads). */
+export const LEGACY_RELEASE_ORDER_CODE = "release_order";
+
+/** Multi-file Release Order uploads use `release_order_0`, `release_order_1`, … */
+export const RELEASE_ORDER_FILE_PREFIX = "release_order_";
+
+export function isReleaseOrderFileCode(code: string | null | undefined): boolean {
+  if (!code) return false;
+  const lower = code.toLowerCase();
+  return lower === LEGACY_RELEASE_ORDER_CODE || lower.startsWith(RELEASE_ORDER_FILE_PREFIX);
+}
+
+export function releaseOrderFileLabel(code: string, index?: number): string {
+  const lower = code.toLowerCase();
+  if (lower === LEGACY_RELEASE_ORDER_CODE) return "Release Order";
+  if (lower.startsWith(RELEASE_ORDER_FILE_PREFIX)) {
+    return index != null ? `Release Order ${index + 1}` : "Release Order";
+  }
+  return code;
+}
+
 /** Legacy single T1 code (GL post-booking uploader). */
 export const LEGACY_T1_TRANSPORT_CODE = "t1_transport_document";
 
diff --git a/packages/types/src/freight/etrade.ts b/packages/types/src/freight/etrade.ts
index 67a7de28b..c23492413 100644
--- a/packages/types/src/freight/etrade.ts
+++ b/packages/types/src/freight/etrade.ts
@@ -55,10 +55,25 @@ export interface ETradeCompanyInfo {
     RenewedFrom: string;
     RenewedTo: string;
     BusinessLicensingGroupMain: string | null;
-    SubGroups: string | null;
+    /** eTrade returns null entries in this array as well as a null array. */
+    SubGroups: Array<{ Code: number; Description: string | null } | null> | null;
   }>;
 }
 
+/**
+ * One business licence held under a TIN. A single owner routinely holds many
+ * (import of vehicles, export of coffee, freight forwarding…), all sharing the
+ * same trade name — the licensed activity is what tells them apart, so that is
+ * what the customer picks by.
+ */
+export interface ETradeBusinessOption {
+  licenceNumber: string;
+  tradeName: string;
+  /** The licensed activities ("Import trade in …"), joined. May be empty. */
+  activity: string;
+  renewedTo: string;
+}
+
 export interface CompanyRegistrationData {
   /**
    * The registered organization name — `ETradeCompanyInfo.BusinessName`, falling
@@ -84,4 +99,11 @@ export interface CompanyRegistrationData {
   managerPhone: string;
   /** True when this TIN is already registered to an existing company. */
   tinTaken?: boolean;
+  /**
+   * Every licence this TIN holds. More than one means the customer has to say
+   * which business they are acting as before the registration data above can be
+   * trusted — it describes whichever licence was selected (the first, by
+   * default).
+   */
+  businesses?: ETradeBusinessOption[];
 }
diff --git a/packages/types/src/freight/index.ts b/packages/types/src/freight/index.ts
index 0eab2cfbb..ae9fb7793 100644
--- a/packages/types/src/freight/index.ts
+++ b/packages/types/src/freight/index.ts
@@ -1,5 +1,9 @@
 import type { BaseEntity } from "../common";
-import { ClearanceNextAction, ContractDocPhase, IClearanceMilestone } from "./contracts";
+import {
+  ClearanceNextAction,
+  ContractDocPhase,
+  IClearanceMilestone,
+} from "./contracts";
 
 export * from "./dropdown_settings";
 export * from "./file_upload_settings";
@@ -11,6 +15,8 @@ export * from "./ethiopian-regions.catalog";
 export * from "./notifications";
 export * from "./booking-window-ws";
 export * from "./support-chat";
+export * from "./portal-content";
+export * from "./portal-content.defaults";
 
 export enum TradeDirection {
   IMPORT = "IMPORT",
@@ -181,7 +187,19 @@ export enum InvoiceSource {
   FirstMile = "firstmile",
   LastMile = "lastmile",
   /** Customs clearance service fee — billed on the booking invoice with the freight. */
-  Clearance = "clearance"
+  Clearance = "clearance",
+  /**
+   * Post-finalization clearance charge (port charges / miscellaneous) billed
+   * to the customer as its own payable invoice. `sourceId` is the charge id.
+   */
+  ClearanceCharge = "clearance_charge",
+  /**
+   * A batch of shipping-line credits billed together. Unlike every other
+   * source, `sourceId` is the shipping line's id rather than a single record's:
+   * the invoice covers many bookings, and the credits themselves carry the
+   * per-booking link.
+   */
+  ShippingLineCredit = "shipping_line_credit",
 }
 
 export enum SchedulingStatus {
@@ -442,8 +460,6 @@ export interface ICustomer extends BaseEntity {
   email: string;
   phone: string;
   companyName: string;
-  companyEmail: string;
-  companyPhone: string;
   companyLocation: string;
   companyAddress: string;
   contactPersonName: string;
@@ -469,8 +485,6 @@ export interface CreateCustomerDto {
   email: string;
   phone: string;
   companyName: string;
-  companyEmail: string;
-  companyPhone: string;
   companyLocation: string;
   companyAddress: string;
   contactPersonName: string;
@@ -715,6 +729,12 @@ export interface IBooking extends BaseEntity {
   selectedForBatchAt?: string | null;
   /** End of the pay window once the booking is SELECTED_FOR_BATCH. */
   paymentDeadline?: string | null;
+  /**
+   * End of the settlement drain tail that follows `paymentDeadline`. Between the
+   * two, an in-flight payment can still land, so the customer is shown a
+   * "payment processing" state instead of a pay action.
+   */
+  paymentDrainEndsAt?: string | null;
 
   containers?: Array<{ type: string; qty: number; vgm: number }> | null;
 
@@ -756,7 +776,10 @@ export interface IBooking extends BaseEntity {
    */
   isSplit?: boolean;
   /** What this booking carried before it was reduced by a split (bulk tons / units per size). */
-  preSplitQuantities?: { bulkTons?: number; bySize?: Record<string, number> } | null;
+  preSplitQuantities?: {
+    bulkTons?: number;
+    bySize?: Record<string, number>;
+  } | null;
 }
 
 export interface PricingBreakdownLineItem {
@@ -784,6 +807,65 @@ export interface PricingBreakdown {
 
 export type DocumentReviewStatus = "PENDING" | "APPROVED" | "QUERIED";
 
+// ── Clearance history (per-booking action trail, History tab) ───────────────
+
+/** One recorded clearance action — review, workflow step, or charge. */
+export interface ClearanceHistoryEvent {
+  id: string;
+  /** Stable machine code, e.g. DOC_APPROVED, DECLARATION_UPLOADED. */
+  action: string;
+  /** Human sentence, frozen at write time. */
+  label: string;
+  actorType: "STAFF" | "CUSTOMER" | "SYSTEM";
+  actorName: string | null;
+  metadata: Record<string, unknown> | null;
+  at: string;
+}
+
+// ── Clearance charges (post-finalization customer billing) ──────────────────
+
+export type ClearanceChargeType = "PORT_CHARGES" | "MISCELLANEOUS";
+
+/**
+ * DOC_UPLOADED: GL Djibouti uploaded the supporting document (port charges).
+ * BILLED: GL Ethiopia set amount + currency. SENT: invoice issued to the
+ * customer (ETB pays via gateway, other currencies via Finance's manual
+ * settlement). PAID: the invoice settled.
+ */
+export type ClearanceChargeStatus =
+  | "DOC_UPLOADED"
+  | "BILLED"
+  | "SENT"
+  | "PAID";
+
+/** One clearance charge level on a booking — at most one per type. */
+export interface ClearanceCharge {
+  id: string;
+  bookingId: string;
+  type: ClearanceChargeType;
+  status: ClearanceChargeStatus;
+  file: { id: string; name: string; url: string } | null;
+  amount: number | null;
+  currency: string | null;
+  invoiceId: string | null;
+  invoiceNumber: string | null;
+  uploadedByName: string | null;
+  uploadedAt: string | null;
+  billedByName: string | null;
+  billedAt: string | null;
+  paidAt: string | null;
+}
+
+/** One entry of a clearance document's audit trail, oldest first. */
+export interface ClearanceDocumentEvent {
+  type: "UPLOADED" | "RESUBMITTED" | "QUERIED" | "APPROVED";
+  at: string;
+  /** Actor display name (staff for reviews; null = the customer/unknown). */
+  byName: string | null;
+  /** Query reason, for QUERIED events. */
+  note: string | null;
+}
+
 /** One row of the clearance document grid (a required doc + its file + review). */
 export interface ClearanceDocument {
   fileKey: string;
@@ -795,6 +877,14 @@ export interface ClearanceDocument {
   file: { id: string; name: string; url: string } | null;
   reviewStatus: DocumentReviewStatus | null;
   note: string | null;
+  /** When the current file version was uploaded — a re-upload (query response) refreshes it. */
+  uploadedAt?: string | null;
+  /** When the latest review decision (approve/query) was recorded. */
+  reviewedAt?: string | null;
+  /** Display name of the staff member who recorded the decision. */
+  reviewedByName?: string | null;
+  /** Full audit trail: uploads, re-submissions, queries, approval. */
+  history?: ClearanceDocumentEvent[];
 }
 
 /**
@@ -834,6 +924,12 @@ export interface ClearanceView {
   documents: ClearanceDocument[];
   /** True once every required customer document is APPROVED (the 100% gate). */
   allApproved: boolean;
+  /**
+   * True while the customer may still attach documents and GL may still
+   * approve or query them — open until the shipment is paid, not merely until
+   * clearance is finalized.
+   */
+  documentsOpen?: boolean;
   /** Phased clearance (GENERAL + customs per-booking). */
   phase?: ContractDocPhase | null;
   milestones?: IClearanceMilestone[];
@@ -919,10 +1015,19 @@ export interface ClearanceView {
   importReleaseGranted?: boolean;
 }
 
-/** Company an invoice is billed to (minimal projection). */
+/**
+ * Company an invoice is billed to. `findById` returns the full `Company`
+ * relation, not a stripped projection — these extra fields are what the
+ * backoffice invoice detail page's recipient card shows.
+ */
 export interface IInvoiceCompany {
   id: string;
   name: string;
+  tin?: string | null;
+  vatNumber?: string | null;
+  phone?: string | null;
+  email?: string | null;
+  address?: string | null;
 }
 
 /** Company profile (importer/exporter/forwarder/…) an invoice is billed to. */
@@ -932,6 +1037,14 @@ export interface IInvoiceCompanyProfile {
   reference: string | null;
 }
 
+/** Shipping line an invoice is billed to, when `companyId` is null (see `IInvoice`). */
+export interface IInvoiceShippingLineCompany {
+  id: string;
+  name: string;
+  email?: string | null;
+  phoneNumber?: string | null;
+}
+
 /** A single billed line on an invoice. */
 export interface IInvoiceLine extends BaseEntity {
   invoiceId: string;
@@ -948,12 +1061,15 @@ export interface IInvoiceLine extends BaseEntity {
 
 export interface IInvoice extends BaseEntity {
   invoiceNumber: string;
-  /** Customer (company) the invoice is billed to. */
-  companyId: string;
+  /** Customer (company) the invoice is billed to. Null on a shipping-line invoice — see `shippingLineCompanyId`. */
+  companyId: string | null;
   company?: IInvoiceCompany;
   /** Specific company profile billed. */
   companyProfileId: string;
   companyProfile?: IInvoiceCompanyProfile;
+  /** The shipping line billed, when this invoice bills batched shipping-line credits. Mutually exclusive with `companyId`. */
+  shippingLineCompanyId?: string | null;
+  shippingLineCompany?: IInvoiceShippingLineCompany;
   totalAmount: number;
   /** Cumulative amount settled so far (supports partial payment). */
   paidAmount: number;
diff --git a/packages/types/src/freight/notifications.ts b/packages/types/src/freight/notifications.ts
index e3ca5b219..d51006c7f 100644
--- a/packages/types/src/freight/notifications.ts
+++ b/packages/types/src/freight/notifications.ts
@@ -90,13 +90,16 @@ export interface NotificationRecipients {
   companyProfileId?: string;
   /** Backoffice: all current employees of this organization. */
   organizationId?: string;
-  /** Backoffice: every current employee across all organizations. */
-  allBackoffice?: boolean;
   /**
    * Backoffice: current employees (any org) who hold ANY of these permission
-   * keys — e.g. notify only marketing, not every employee. Super/org admins
-   * are not implicitly included; add `allBackoffice`/explicit userIds too if
-   * admins should also see it.
+   * keys. Resolution mirrors the request-time guard `hasFreightPermission` —
+   * IAM role grants, direct position grants, position TYPE grants, delegated
+   * positions, and the `super_admin` bypass. `organization_admin` is NOT
+   * implicitly included (it only bypasses approval steps, not permission
+   * checks); grant it a key explicitly if it should be notified.
+   *
+   * Prefer the dedicated `<module>:get_notification` keys over reusing a domain
+   * key: they let ops tune who gets pinged without touching who has access.
    */
   permissionKeys?: string[];
 }
diff --git a/packages/types/src/freight/overview.ts b/packages/types/src/freight/overview.ts
index e3d98bc00..ede6d6b04 100644
--- a/packages/types/src/freight/overview.ts
+++ b/packages/types/src/freight/overview.ts
@@ -13,6 +13,7 @@ export interface IOverviewBookingKpis {
 export interface IOverviewOperationsKpis {
   trainsActive: number;
   wagonsAvailable: number;
+  wagonsTotal: number;
   containersInTransit: number;
   cargoesLoaded: number;
   schedulesUpcoming: number;
@@ -99,13 +100,60 @@ export interface IOverviewRecentContract {
   createdAt: string;
 }
 
+/** Bookings/revenue/tonnage totals for one range-wide window. */
+export interface IOverviewPeriodTotals {
+  bookingsCreated: number;
+  revenueEtb: number;
+  revenueUsd: number;
+  tons: number;
+}
+
+/** One label's revenue split, e.g. a trade direction or freight type. */
+export interface IOverviewRevenueSlice {
+  label: string;
+  amountEtb: number;
+  amountUsd: number;
+}
+
+export interface IOverviewTonsTrendPoint {
+  date: string;
+  tons: number;
+}
+
+/** One direction → freight-type revenue flow (Sankey link). */
+export interface IOverviewRevenueFlow {
+  direction: string;
+  freightType: string;
+  amountEtb: number;
+  amountUsd: number;
+}
+
+/** Booking arrivals for one weekday × 3-hour block. */
+export interface IOverviewHeatmapCell {
+  /** ISO weekday, 1 = Monday … 7 = Sunday. */
+  dow: number;
+  /** 3-hour block, 0 = 00–03 … 7 = 21–24. */
+  block: number;
+  count: number;
+}
+
 export interface IOverviewDashboard {
   kpis: IOverviewKpis;
   bookingTrend: IOverviewTrendPoint[];
   bookingsByStatus: IOverviewStatusCount[];
   bookingsByPipeline: IOverviewPipelineCount[];
   paymentTrend: IOverviewPaymentTrendPoint[];
-  recentBookings: IOverviewRecentBooking[];
+  /** Totals for the selected range, ending today. */
+  current: IOverviewPeriodTotals;
+  /** Totals for the immediately preceding range of the same length — the delta baseline. */
+  previous: IOverviewPeriodTotals;
+  revenueByDirection: IOverviewRevenueSlice[];
+  revenueByFreightType: IOverviewRevenueSlice[];
+  /** The preceding same-length window's daily revenue — ghost-line comparison. */
+  previousPaymentTrend: IOverviewPaymentTrendPoint[];
+  tonsTrend: IOverviewTonsTrendPoint[];
+  revenueFlows: IOverviewRevenueFlow[];
+  bookingHeatmap: IOverviewHeatmapCell[];
   generatedAt: string;
 }
 
@@ -170,6 +218,34 @@ export interface IOverviewTonnagePoint {
   tons: number;
 }
 
+/**
+ * One cell of a two-dimensional breakdown — `group` is the bucket on the
+ * category axis (wagon type, yard, port), `series` the stacked slice (status).
+ */
+export interface IOverviewMatrixCell {
+  group: string;
+  series: string;
+  count: number;
+}
+
+/** One scheduled train's wagon allocation and load against its own capacity. */
+export interface IOverviewTrainLoad {
+  scheduleId: string;
+  trainNumber: string;
+  /** Scheduled departure date, YYYY-MM-DD. */
+  date: string;
+  direction: string;
+  wagonsAllocated: number;
+  wagonsTotal: number;
+  tons: number;
+}
+
+/** Departure-to-departure gap for one train set, in hours. */
+export interface IOverviewTurnaround {
+  trainSet: string;
+  hours: number;
+}
+
 export interface IOverviewOperationsTab {
   kpis: IOverviewOperationsKpis;
   departureTrend: IOverviewDirectionTrendPoint[];
@@ -182,6 +258,36 @@ export interface IOverviewOperationsTab {
   wagonStatusBreakdown: IOverviewStatusCount[];
   containerStatusBreakdown: IOverviewStatusCount[];
   cargoStatusBreakdown: IOverviewStatusCount[];
+  /** Bookings per port yard (import → origin, export → destination). */
+  bookingsByPort: IOverviewLabelCount[];
+  /** Same ports, split by booking status. */
+  bookingStatusByPort: IOverviewMatrixCell[];
+  /** Recent/upcoming trains with their wagon fill and tonnage. */
+  trainLoads: IOverviewTrainLoad[];
+  generatedAt: string;
+}
+
+export interface IOverviewFleetTab {
+  wagonStatusBreakdown: IOverviewStatusCount[];
+  wagonStatusByType: IOverviewMatrixCell[];
+  wagonStatusByYard: IOverviewMatrixCell[];
+  locomotiveStatusBreakdown: IOverviewStatusCount[];
+  locomotivesByYard: IOverviewMatrixCell[];
+  locomotivesByType: IOverviewLabelCount[];
+  /** Mean departure-to-departure gap across all train sets, null when < 2 departures. */
+  avgTurnaroundHours: number | null;
+  turnaroundByTrain: IOverviewTurnaround[];
+  generatedAt: string;
+}
+
+/** Document and invoice queues the GL desks and marketing work through. */
+export interface IOverviewClearanceTab {
+  bookingDocumentsByStatus: IOverviewStatusCount[];
+  contractDocumentsByStatus: IOverviewStatusCount[];
+  invoicesByStatus: IOverviewStatusCount[];
+  invoicesByType: IOverviewLabelCount[];
+  /** Signed vs pending handover papers, per mile. */
+  handoversByMile: IOverviewMatrixCell[];
   generatedAt: string;
 }
 
@@ -190,6 +296,8 @@ export interface IOverviewCustomersTab {
   customerGrowthTrend: IOverviewTrendPoint[];
   customersByType: IOverviewLabelCount[];
   topCustomersByBookings: IOverviewLabelCount[];
+  /** Company profiles per type × status — active vs pending vs suspended. */
+  profilesByTypeStatus: IOverviewMatrixCell[];
   generatedAt: string;
 }
 
diff --git a/packages/types/src/freight/portal-content.defaults.ts b/packages/types/src/freight/portal-content.defaults.ts
new file mode 100644
index 000000000..bd3ffe204
--- /dev/null
+++ b/packages/types/src/freight/portal-content.defaults.ts
@@ -0,0 +1,364 @@
+import type { SupportDocPayloadMap } from "./portal-content";
+
+/**
+ * The copy the portal shipped with, transcribed from what used to be
+ * `edr-freight-web/portal/src/pages/support/content.ts` and the inline blocks
+ * of `HelpPage.tsx`.
+ *
+ * Two mechanical changes from the original:
+ *
+ * 1. `Section { body: string[]; bullets: string[] }` collapses to one markdown
+ *    string — paragraphs separated by a blank line, bullets as `- ` lines.
+ * 2. The support email/phone/office, previously string-interpolated into the
+ *    privacy and terms prose at build time, are now `{{supportEmail}}`-style
+ *    placeholders resolved against the CONTACT document at read time. That is
+ *    what stops the legal text keeping a stale phone number after an edit.
+ *
+ * It lives in the shared package because three consumers need the same bytes
+ * and any drift between them would only surface during an outage: the API
+ * seeds the database from it and serves it for any row still missing, and the
+ * portal renders it while the request is in flight or if the API is down.
+ * Once seeded, the database is authoritative and this is only a floor.
+ */
+export const SUPPORT_CONTENT_DEFAULTS: SupportDocPayloadMap = {
+  CONTACT: {
+    email: "support@edrfreight.com",
+    phone: "+251 11 000 0000",
+    office: "Addis Ababa, Ethiopia",
+    hours: "Monday – Saturday, 8:30 AM – 5:30 PM (EAT)",
+  },
+
+  HELP: {
+    title: "Help & Support",
+    subtitle:
+      "Get answers fast — watch the walkthrough, browse the common topics, check the FAQ, or reach our team directly.",
+    sections: [
+      {
+        id: "help-walkthrough",
+        heading: "Portal walkthrough",
+        // The video ships with the app rather than MinIO, so its path is used
+        // verbatim; the renderer picks <video> from the extension.
+        body: "A guided tour of the portal — registering your company, raising a booking against a contract, and settling an invoice.\n\n![](/assets/edr-portal-guide.webm)",
+      },
+      {
+        id: "help-chat",
+        heading: "Chat with our team",
+        body: "Signed-in customers can open a support conversation from the headset button at the bottom right of every portal page. You can send screenshots and documents in the chat, and replies appear there and as a notification.\n\n[Open the portal](/portal)",
+      },
+      {
+        id: "help-contact",
+        heading: "Contact us",
+        body: "- **Email** — [{{supportEmail}}](mailto:{{supportEmail}}). Best for document issues and anything needing an attachment.\n- **Phone** — [{{supportPhone}}](tel:{{supportPhoneTel}}). Best for urgent problems with cargo already in transit.\n- **Head office** — {{supportOffice}}. Walk-in support during working hours.\n- **Support hours** — {{supportHours}}. Outside these hours, email us and we reply the next working day.",
+      },
+      {
+        id: "help-topics",
+        heading: "Common topics",
+        body: "- **[Account & onboarding](/faq)** — registering your company, uploading your trade licence and TIN, and getting an operational profile approved.\n- **[Contracts](/faq)** — requesting a freight contract, reviewing its terms and signing it with your saved signature and stamp.\n- **[Bookings & tracking](/faq)** — raising a booking against a contract, adding last-mile transport and following the consignment along the corridor.\n- **[Invoices & payments](/faq)** — finding invoices, paying through the bank channels and confirming a payment that has not yet settled.",
+      },
+      {
+        id: "help-checklist",
+        heading: "What to include when you contact us",
+        body: "- Your company name and the email you sign in with.\n- The reference of the contract, booking or invoice involved.\n- What you expected to happen and what happened instead.\n- A screenshot of any error message the portal showed.",
+      },
+    ],
+  },
+
+  FAQ: {
+    title: "Frequently Asked Questions",
+    subtitle:
+      "Answers to the questions customers ask most about registering, booking cargo and settling invoices on EDR Freight.",
+    groups: [
+      {
+        id: "faq-getting-started",
+        title: "Getting started",
+        items: [
+          {
+            id: "faq-open-account",
+            question: "How do I open an account on EDR Freight?",
+            answer:
+              "Sign up with your work email and verify the one-time code we send you. After you set a password, the onboarding wizard collects your company details, trade licence, TIN certificate and the operational services you need (importer, exporter, freight forwarder or transporter). Submit the wizard and our team reviews the application.",
+          },
+          {
+            id: "faq-approval-time",
+            question: "How long does account approval take?",
+            answer:
+              "Most complete applications are reviewed within two working days. You will see the status on your dashboard, and we email you when a profile is approved or when a document needs to be re-uploaded.",
+          },
+          {
+            id: "faq-rejected",
+            question: "My profile was rejected. What now?",
+            answer:
+              "The rejection notice states the reason. Open Settings, correct the details or replace the document that was flagged, and re-apply — you do not need to create a new account.",
+          },
+          {
+            id: "faq-multiple-services",
+            question: "Can one company hold several operational services?",
+            answer:
+              "Yes. A company can hold importer, exporter, freight forwarder and transporter profiles at the same time. Each is approved separately, and the header lets you switch between the ones you hold.",
+          },
+        ],
+      },
+      {
+        id: "faq-contracts-bookings",
+        title: "Contracts and bookings",
+        items: [
+          {
+            id: "faq-contract-vs-booking",
+            question: "What is the difference between a contract and a booking?",
+            answer:
+              "A contract is the commercial agreement covering a cargo movement — route, commodity, volume and rates. A booking is a single shipment executed under that contract. You create the contract once, then raise bookings against it for each consignment.",
+          },
+          {
+            id: "faq-create-booking",
+            question: "How do I create a booking?",
+            answer:
+              "Open the contract from the Contracts list and choose New Booking. Provide the consignment details, containers or tonnage, and the last-mile requirement if you need one. Bookings can also be started from the Bookings page, which routes you through contract selection first.",
+          },
+          {
+            id: "faq-sign-contract",
+            question: "Why do I have to sign a contract before shipping?",
+            answer:
+              "The contract document is the binding agreement for the movement. You must scroll to the end, accept the terms, and sign it with your saved signature and stamp before EDR schedules any wagon against it.",
+          },
+          {
+            id: "faq-signature-setup",
+            question: "Where do I set up my signature and stamp?",
+            answer:
+              "Under Signature & Stamp in the portal. It is saved once and reused for every contract you sign, so you do not have to upload it per document.",
+          },
+          {
+            id: "faq-change-booking",
+            question: "Can I change a booking after submitting it?",
+            answer:
+              "You can edit a booking while it is still pending review. Once EDR has confirmed it and allocated capacity, changes go through our operations team — contact support with the booking reference.",
+          },
+          {
+            id: "faq-track-consignment",
+            question: "How do I track a consignment?",
+            answer:
+              "Open the booking and use the tracking panel, which shows the current milestone, the wagon or container assigned, and the timestamps recorded at each corridor point.",
+          },
+        ],
+      },
+      {
+        id: "faq-invoices-payments",
+        title: "Invoices and payments",
+        items: [
+          {
+            id: "faq-find-invoices",
+            question: "Where do I find my invoices?",
+            answer:
+              "The Invoices page lists every invoice raised against your company, with its status, due date and outstanding balance. Open any invoice to see its line items and download a PDF copy.",
+          },
+          {
+            id: "faq-payment-methods",
+            question: "Which payment methods are supported?",
+            answer:
+              "Payments are made through the integrated bank channels shown at checkout. After you complete the payment on the bank's page you are returned to the portal, and the invoice status updates once the bank confirms the transaction.",
+          },
+          {
+            id: "faq-payment-not-settled",
+            question:
+              "My payment was deducted but the invoice still shows unpaid.",
+            answer:
+              "Bank confirmations can lag by a few minutes. Use the Check Payment Status page linked from your receipt; if it still has not settled after an hour, email support with the invoice number and the bank reference and we will reconcile it.",
+          },
+          {
+            id: "faq-rounding",
+            question: "Why is my invoice amount rounded?",
+            answer:
+              "Some bank channels only accept whole-birr amounts, so invoices routed through them are rounded up to the nearest birr. The rounding is shown on the invoice detail page.",
+          },
+        ],
+      },
+      {
+        id: "faq-account-security",
+        title: "Account and security",
+        items: [
+          {
+            id: "faq-reset-password",
+            question: "How do I reset my password?",
+            answer:
+              "Use Forgot Password on the sign-in page. We email you a reset link that is valid for a limited time. If a member of our staff issued the link, it works the same way even if you are already signed in.",
+          },
+          {
+            id: "faq-add-colleagues",
+            question: "Can I add colleagues to my company account?",
+            answer:
+              "Yes. Company administrators can invite additional users from Settings. Each user signs in with their own credentials, and actions are recorded against the individual who performed them.",
+          },
+          {
+            id: "faq-update-company",
+            question: "How do I update company details after approval?",
+            answer:
+              "Edit them in Settings. Changes to regulated fields — trade licence, TIN, legal name — are re-verified by our team before they take effect.",
+          },
+        ],
+      },
+    ],
+    footer: {
+      heading: "Still need a hand?",
+      body: "Our team is on {{supportEmail}} and {{supportPhone}}, or you can start a chat from the support button inside the portal.",
+      ctaLabel: "Go to Help & Support",
+      ctaTo: "/help",
+    },
+  },
+
+  PRIVACY: {
+    title: "Privacy Policy",
+    subtitle:
+      "How EDR Freight collects, uses, shares and protects the information you provide when you use the platform.",
+    lastUpdated: "6 August 2026",
+    sections: [
+      {
+        id: "privacy-1",
+        heading: "1. Introduction",
+        body: 'The Ethio-Djibouti Standard Gauge Rail Share Company ("EDR", "we", "us") operates the EDR Freight platform, which lets customers register their business, agree freight contracts, raise bookings, track consignments and settle invoices online.\n\nThis policy explains what personal and business information we collect through the platform, why we collect it, how long we keep it and what rights you have over it. It applies to the EDR Freight customer portal and the services reached through it.',
+      },
+      {
+        id: "privacy-2",
+        heading: "2. Information we collect",
+        body: "We collect information you give us, information generated by your use of the platform, and information we receive from the regulators and financial institutions we work with.\n\n- Account details — name, work email address, phone number and the credentials used to sign in.\n- Company and compliance records — legal name, trade licence, TIN certificate, VAT registration, ownership and manager details, and the operational services you apply for.\n- Identity verification data — where you verify through a national identity service, the verification result and the attributes that service returns to us.\n- Operational data — contracts, bookings, consignment and cargo details, container and wagon assignments, tracking events and delivery confirmations.\n- Financial data — invoices, payment references, transaction status and settlement confirmations received from banks. We do not store your card numbers or online banking credentials.\n- Support data — the messages and files you send us through the in-app support chat or by email.\n- Technical data — IP address, device and browser information, and event logs generated when you use the platform.",
+      },
+      {
+        id: "privacy-3",
+        heading: "3. How we use your information",
+        body: "- To create and administer your account and verify that your company is entitled to the services it applies for.\n- To perform the freight contracts and bookings you place, including allocating capacity and coordinating rail and last-mile movements.\n- To issue invoices, process payments and keep the accounting records the law requires us to keep.\n- To provide customer support and respond to the questions and complaints you raise.\n- To keep the platform secure, detect misuse and investigate incidents.\n- To meet our legal, tax, customs and regulatory obligations in Ethiopia and Djibouti.\n- To improve the platform — measuring which features are used and where users encounter errors, using aggregated and pseudonymised data wherever that is sufficient.",
+      },
+      {
+        id: "privacy-4",
+        heading: "4. Legal basis for processing",
+        body: "We process your information because it is necessary to perform the contract between you and EDR, because we have a legal obligation to do so (customs, tax and transport regulation), or because we have a legitimate interest in operating and securing the platform. Where we rely on your consent — for example, optional marketing messages — you can withdraw it at any time.",
+      },
+      {
+        id: "privacy-5",
+        heading: "5. Sharing your information",
+        body: "We do not sell your information. We share it only where it is necessary to deliver the service or where the law requires it.\n\n- Government and regulatory bodies — customs, revenue and transport authorities in Ethiopia and Djibouti, to the extent required for the movement of your cargo.\n- Ports, terminals and last-mile transporters involved in executing your bookings.\n- Banks and payment providers, to initiate and reconcile the payments you make.\n- Technology suppliers who host and maintain the platform on our behalf, under contracts that restrict them to processing data on our instructions.\n- Courts, law enforcement and other authorities where we are legally compelled to disclose.",
+      },
+      {
+        id: "privacy-6",
+        heading: "6. International transfers",
+        body: "Cross-border freight inherently involves parties in more than one country, so consignment and clearance information is shared with counterparties and authorities in Djibouti as well as Ethiopia. Where we transfer information outside Ethiopia, we do so only as far as the movement requires or the law permits, and we require recipients to protect it to a comparable standard.",
+      },
+      {
+        id: "privacy-7",
+        heading: "7. Data retention",
+        body: "We keep account and company records for as long as your account is active. Contract, booking, customs and financial records are kept for the period required by Ethiopian commercial, tax and customs law after the relevant transaction, because we are obliged to be able to produce them. Support conversations and technical logs are kept for a shorter period, sufficient to resolve disputes and investigate security incidents.",
+      },
+      {
+        id: "privacy-8",
+        heading: "8. Security",
+        body: "Access to the platform requires authentication, and staff access to customer records is limited to what each role needs. Data is transmitted over encrypted connections and stored on systems protected by access controls and logging. No system is perfectly secure, so please keep your credentials confidential and tell us immediately if you believe your account has been compromised.",
+      },
+      {
+        id: "privacy-9",
+        heading: "9. Your rights",
+        body: "Subject to Ethiopian law, you may ask us to give you a copy of the personal information we hold about you, correct it if it is inaccurate, restrict or object to certain processing, or delete it where we are not required to keep it. Requests are handled through the contact details below; we may need to verify your identity before acting.",
+      },
+      {
+        id: "privacy-10",
+        heading: "10. Cookies and similar technologies",
+        body: "The platform uses cookies and browser storage to keep you signed in, remember your interface preferences and measure how the product is used so we can fix problems. Essential cookies cannot be turned off without breaking sign-in. You can clear or block the rest through your browser settings.",
+      },
+      {
+        id: "privacy-11",
+        heading: "11. Children",
+        body: "The platform is a business service and is not directed at children. We do not knowingly collect information from anyone under 18.",
+      },
+      {
+        id: "privacy-12",
+        heading: "12. Changes to this policy",
+        body: "We may update this policy as the platform and the law change. Material changes are announced in the portal before they take effect, and the date at the top of this page always reflects the current version.",
+      },
+      {
+        id: "privacy-13",
+        heading: "13. Contact us",
+        body: "Questions about this policy or about how we handle your information can be sent to {{supportEmail}}, called in on {{supportPhone}}, or addressed to our head office in {{supportOffice}}.",
+      },
+    ],
+  },
+
+  TERMS: {
+    title: "Terms of Service",
+    subtitle:
+      "The terms on which EDR provides the EDR Freight platform and the freight services you request through it.",
+    lastUpdated: "6 August 2026",
+    sections: [
+      {
+        id: "terms-1",
+        heading: "1. These terms",
+        body: 'These terms govern your use of the EDR Freight platform operated by the Ethio-Djibouti Standard Gauge Rail Share Company ("EDR"). By creating an account or using the platform, the company you represent agrees to them.\n\nThe platform is the channel through which you register, request and manage freight services. The commercial terms of each movement — routes, rates, volumes and payment terms — are set out in the freight contract you sign in the platform. Where a signed contract and these terms conflict, the signed contract governs that movement.',
+      },
+      {
+        id: "terms-2",
+        heading: "2. Eligibility and accounts",
+        body: "- The platform is for registered businesses. You confirm that you are authorised to act for the company you register and to bind it to these terms.\n- The information and documents you submit — trade licence, TIN, VAT registration, ownership details — must be accurate, current and genuine.\n- Accounts and operational profiles are activated only after EDR has reviewed and approved them, and approval may be refused or withdrawn.\n- You are responsible for keeping credentials confidential and for everything done under your account. Tell us at once if you suspect unauthorised use.",
+      },
+      {
+        id: "terms-3",
+        heading: "3. Contracts and bookings",
+        body: "- A freight contract takes effect when it is signed in the platform by you and countersigned by EDR.\n- A booking is a request for a specific movement under a contract. It becomes binding when EDR confirms it and allocates capacity — submission alone does not reserve a wagon or container.\n- You are responsible for the accuracy of consignment data: commodity description, weight, dimensions, container numbers, hazardous classification and consignee details.\n- Capacity is finite. EDR may decline, defer or reschedule a booking where capacity, safety, operating conditions or regulatory direction require it.",
+      },
+      {
+        id: "terms-4",
+        heading: "4. Cargo, documents and compliance",
+        body: "- You must obtain and provide every permit, customs declaration and clearance document the movement requires, and you warrant that the cargo may lawfully be carried.\n- Prohibited and restricted goods may not be tendered without EDR's prior written agreement and any licence the law requires.\n- Cargo must be packed, secured and, where applicable, labelled to the standard the mode of carriage requires. EDR may inspect, refuse or offload cargo that is misdeclared or unsafe.\n- You are liable for fines, demurrage, storage charges and losses arising from misdeclared cargo, missing documents or delays attributable to you.",
+      },
+      {
+        id: "terms-5",
+        heading: "5. Rates, invoicing and payment",
+        body: "- Charges are calculated from the rates in your contract, the tariffs published in the platform, and any accessorial services actually rendered.\n- Invoices are issued in the platform and are payable by the due date shown on them, through the payment channels the platform offers.\n- Payment is confirmed when the funds are confirmed by the bank, not when payment is initiated.\n- Overdue amounts may attract interest and may result in suspension of new bookings or of the account until the balance is cleared.\n- Taxes and statutory duties are your responsibility unless the contract expressly says otherwise.",
+      },
+      {
+        id: "terms-6",
+        heading: "6. Delivery, delay and liability",
+        body: "Transit times shown in the platform are estimates based on planned schedules. They are not guarantees, and EDR is not liable for indirect or consequential loss, loss of profit or loss of market arising from delay.\n\nEDR's liability for loss of or damage to cargo is limited to the extent set out in the applicable freight contract and in the transport law governing the carriage. Claims must be notified in writing within the period the contract specifies; late claims may be rejected.\n\nNeither party is liable for failure to perform caused by events beyond its reasonable control, including natural disasters, industrial action, civil unrest, infrastructure failure, or acts of government and regulatory authorities.",
+      },
+      {
+        id: "terms-7",
+        heading: "7. Acceptable use of the platform",
+        body: "- Use the platform only for its intended purpose and in accordance with applicable law.\n- Do not attempt to gain unauthorised access, probe or disrupt the service, or interfere with other customers' data.\n- Do not scrape, resell or redistribute platform content, rates or data without written permission.\n- Do not upload malware or content that infringes the rights of others.",
+      },
+      {
+        id: "terms-8",
+        heading: "8. Electronic signatures and records",
+        body: "You agree that contracts signed in the platform using your stored signature and stamp are validly executed, that the records the platform keeps of those signatures are admissible evidence of them, and that they carry the same effect as signatures on paper.",
+      },
+      {
+        id: "terms-9",
+        heading: "9. Availability and changes to the service",
+        body: "We aim to keep the platform available, but it may be interrupted for maintenance, upgrades or reasons outside our control. We may add, change or withdraw features. Where a change materially affects how you use the platform, we will give reasonable notice in the portal.",
+      },
+      {
+        id: "terms-10",
+        heading: "10. Suspension and termination",
+        body: "We may suspend or terminate access where these terms are breached, where documents prove to be false, where amounts remain unpaid, or where the law or a regulator requires it. You may stop using the platform at any time. Termination does not affect obligations already incurred — cargo in transit, invoices outstanding, or records we are required to retain.",
+      },
+      {
+        id: "terms-11",
+        heading: "11. Intellectual property",
+        body: "The platform, its software, design and content belong to EDR or its licensors. You are granted a non-exclusive, non-transferable right to use it for your own freight operations. Your commercial and consignment data remains yours; you grant us the right to process it as needed to deliver the service and as described in the Privacy Policy.",
+      },
+      {
+        id: "terms-12",
+        heading: "12. Confidentiality and data protection",
+        body: "Each party will keep the other's non-public commercial information confidential and use it only for the purposes of the services. Our handling of personal information is described in the Privacy Policy, which forms part of these terms.",
+      },
+      {
+        id: "terms-13",
+        heading: "13. Governing law and disputes",
+        body: "These terms are governed by the laws of the Federal Democratic Republic of Ethiopia. The parties will first attempt to resolve any dispute amicably; failing that, the dispute is subject to the jurisdiction of the competent courts of Ethiopia, without prejudice to any arbitration clause agreed in a specific freight contract.",
+      },
+      {
+        id: "terms-14",
+        heading: "14. Changes to these terms",
+        body: "We may update these terms as the service and the law change. Updates are published here and announced in the portal. Continuing to use the platform after an update takes effect means you accept the revised terms.",
+      },
+      {
+        id: "terms-15",
+        heading: "15. Contact",
+        body: "For questions about these terms, write to {{supportEmail}} or call {{supportPhone}}.",
+      },
+    ],
+  },
+};
diff --git a/packages/types/src/freight/portal-content.ts b/packages/types/src/freight/portal-content.ts
new file mode 100644
index 000000000..104236133
--- /dev/null
+++ b/packages/types/src/freight/portal-content.ts
@@ -0,0 +1,204 @@
+/**
+ * Customer-facing copy for the freight portal's public pages — /help, /faq,
+ * /terms and /privacy. Edited in the backoffice, served to the portal by one
+ * public endpoint, and versioned so a bad edit can be rolled back.
+ *
+ * Body copy is **markdown**. It is rendered with `react-markdown` and no
+ * `rehype-raw`, so raw HTML inside it is inert — the fields that actually need
+ * validating are the structured ones that land in `href`/`src` attributes.
+ */
+
+/** One editable document. Each is a row in `freight.support_documents`. */
+export const SUPPORT_DOC_SLUGS = [
+  "CONTACT",
+  "HELP",
+  "FAQ",
+  "PRIVACY",
+  "TERMS",
+] as const;
+
+export type SupportDocSlug = (typeof SUPPORT_DOC_SLUGS)[number];
+
+/** MinIO key prefix every uploaded help attachment is stored under. */
+export const SUPPORT_MEDIA_PREFIX = "support-content/";
+
+/**
+ * Marks a MinIO object reference inside markdown, e.g.
+ * `![Wagon](minio:support-content/abc.png)`.
+ *
+ * Stored copy always holds the *key*, never a signed URL: a presigned URL
+ * expires, so writing one into the saved markdown would silently rot every
+ * embedded image a few hours later. The API swaps these for freshly signed
+ * URLs on each read instead.
+ */
+export const PORTAL_MEDIA_URI_SCHEME = "minio:";
+
+/** 50 MB — walkthrough videos are the large case. */
+export const SUPPORT_MEDIA_MAX_BYTES = 50 * 1024 * 1024;
+
+export type PortalMediaKind = "image" | "video";
+
+/**
+ * Extensions the portal renders as a `<video>` rather than an `<img>`.
+ *
+ * Images and videos are both inserted with markdown's image syntax —
+ * `![caption](minio:support-content/clip.mp4)` — so an author drops media into
+ * the text in one flow and it stays where they put it. The renderer picks the
+ * element from the extension; nothing extra is stored.
+ */
+export const PORTAL_VIDEO_EXTENSIONS = [
+  ".mp4",
+  ".webm",
+  ".ogg",
+  ".ogv",
+  ".mov",
+  ".m4v",
+] as const;
+
+/** True when a media URL or key should render as a video. */
+export function isPortalVideoSrc(src: string): boolean {
+  const path = src.split(/[?#]/)[0].toLowerCase();
+  return PORTAL_VIDEO_EXTENSIONS.some((ext) => path.endsWith(ext));
+}
+
+/**
+ * Placeholders usable inside any markdown or link field. They are substituted
+ * against the CONTACT document when the portal reads the bundle, which is what
+ * keeps the support address in the privacy/terms prose from drifting out of
+ * sync with the contact cards.
+ *
+ * `supportPhoneTel` is the whitespace-stripped phone, for `tel:` hrefs.
+ */
+export const PORTAL_CONTENT_VARS = [
+  "supportEmail",
+  "supportPhone",
+  "supportPhoneTel",
+  "supportOffice",
+  "supportHours",
+] as const;
+
+export type PortalContentVar = (typeof PORTAL_CONTENT_VARS)[number];
+
+/** Slug `CONTACT`. The one place support contact details are edited. */
+export interface PortalSupportContact {
+  email: string;
+  phone: string;
+  office: string;
+  hours: string;
+}
+
+/** One numbered section of a legal document. `body` is markdown. */
+export interface PortalDocSection {
+  /** Stable per-section id — the React key, since headings can collide. */
+  id: string;
+  heading: string;
+  body: string;
+}
+
+/** Slugs `PRIVACY` and `TERMS` — same shape, separate documents. */
+export interface PortalLegalContent {
+  title: string;
+  subtitle: string;
+  /** Free text, e.g. "6 August 2026". Shown as "Last updated …". */
+  lastUpdated: string;
+  sections: PortalDocSection[];
+}
+
+export interface PortalFaqItem {
+  id: string;
+  question: string;
+  /** Markdown. */
+  answer: string;
+}
+
+export interface PortalFaqGroup {
+  id: string;
+  title: string;
+  items: PortalFaqItem[];
+}
+
+/** A call-to-action card closing a page. `body` is markdown. */
+export interface PortalCtaCard {
+  heading: string;
+  body: string;
+  ctaLabel: string;
+  /** In-app route (`/help`) or absolute URL. */
+  ctaTo: string;
+}
+
+/** Slug `FAQ`. */
+export interface PortalFaqContent {
+  title: string;
+  subtitle: string;
+  groups: PortalFaqGroup[];
+  /** The "Still need a hand?" card. Null hides it. */
+  footer: PortalCtaCard | null;
+}
+
+/**
+ * Slug `HELP`. Free-form: an ordered list of sections, each a heading plus a
+ * markdown body, with images and videos embedded in the body itself.
+ *
+ * Deliberately not a fixed set of typed blocks (video / channels / topics /
+ * checklist, as this once was). The help page is the one document whose shape
+ * genuinely changes with what support needs to explain that quarter, so it is
+ * built rather than filled in — and it shares {@link PortalDocSection} with the
+ * legal documents, so every tab is edited the same way.
+ */
+export interface PortalHelpContent {
+  title: string;
+  subtitle: string;
+  sections: PortalDocSection[];
+}
+
+/** Payload shape per slug — the jsonb column's type, keyed by document. */
+export interface SupportDocPayloadMap {
+  CONTACT: PortalSupportContact;
+  HELP: PortalHelpContent;
+  FAQ: PortalFaqContent;
+  PRIVACY: PortalLegalContent;
+  TERMS: PortalLegalContent;
+}
+
+export type SupportDocPayload = SupportDocPayloadMap[SupportDocSlug];
+
+/** What `GET /api/support-content` returns — everything the portal needs. */
+export interface PortalContentBundle {
+  contact: PortalSupportContact;
+  help: PortalHelpContent;
+  faq: PortalFaqContent;
+  privacy: PortalLegalContent;
+  terms: PortalLegalContent;
+}
+
+// ── Backoffice (staff) projections ─────────────────────────────────────────
+
+/** A document row without its payload — the admin list. */
+export interface SupportDocumentSummary {
+  id: string;
+  slug: SupportDocSlug;
+  version: number;
+  updatedAt: string;
+  updatedById: string | null;
+}
+
+export interface SupportDocumentDetail<
+  S extends SupportDocSlug = SupportDocSlug,
+> extends SupportDocumentSummary {
+  slug: S;
+  payload: SupportDocPayloadMap[S];
+}
+
+/** A history row without its payload — the version list. */
+export interface SupportDocVersionSummary {
+  id: string;
+  version: number;
+  actorId: string | null;
+  note: string | null;
+  createdAt: string;
+}
+
+/** A history row with its payload — fetched when a version is previewed. */
+export interface SupportDocVersionDetail extends SupportDocVersionSummary {
+  payload: SupportDocPayload;
+}
diff --git a/packages/ui-common/postcss.config.js b/packages/ui-common/postcss.config.js
index 6d2dcb075..1e8e9dbf9 100644
--- a/packages/ui-common/postcss.config.js
+++ b/packages/ui-common/postcss.config.js
@@ -1,7 +1,3 @@
-import { createRequire } from 'module';
-
-const require = createRequire(import.meta.url);
-
 // Optional PostCSS configuration for applications that need it
 export const postcssConfig = {
   plugins: {
diff --git a/packages/ui-common/src/components/CurrencySelector/CurrencySelector.tsx b/packages/ui-common/src/components/CurrencySelector/CurrencySelector.tsx
index 4d310efc0..f25a7b015 100644
--- a/packages/ui-common/src/components/CurrencySelector/CurrencySelector.tsx
+++ b/packages/ui-common/src/components/CurrencySelector/CurrencySelector.tsx
@@ -8,22 +8,27 @@ export interface CurrencySelectorProps {
   disabled?: boolean;
   /** Validation error shown under the cards. */
   error?: string;
+  /**
+   * Offer USD alongside ETB. Import shipments only — export and domestic
+   * traffic is invoiced in ETB, so the option stays hidden everywhere else.
+   * USD is settled by bank transfer, never through the online gateway.
+   */
+  allowUsd?: boolean;
 }
 
-const OPTIONS = [
-  {
-    code: "USD",
-    symbol: "$",
-    name: "US Dollar",
-    hint: "As quoted on the contract",
-  },
-  {
-    code: "ETB",
-    symbol: "Br",
-    name: "Ethiopian Birr",
-    hint: "Converted from the USD total",
-  },
-] as const;
+const ETB_OPTION = {
+  code: "ETB",
+  symbol: "Br",
+  name: "Ethiopian Birr",
+  hint: "Pay online through the payment gateway",
+} as const;
+
+const USD_OPTION = {
+  code: "USD",
+  symbol: "$",
+  name: "US Dollar",
+  hint: "Paid by bank transfer — send the slip to Finance",
+} as const;
 
 /**
  * Card-style USD/ETB billing-currency picker. Renders unselected when `value`
@@ -34,7 +39,9 @@ export function CurrencySelector({
   onChange,
   disabled = false,
   error,
+  allowUsd = false,
 }: CurrencySelectorProps) {
+  const options = allowUsd ? [ETB_OPTION, USD_OPTION] : [ETB_OPTION];
   return (
     <Box>
       <Box
@@ -44,7 +51,7 @@ export function CurrencySelector({
           gap: 10,
         }}
       >
-        {OPTIONS.map((o) => {
+        {options.map((o) => {
           const selected = value === o.code;
           return (
             <button
diff --git a/packages/ui-common/src/components/data-table/table.tsx b/packages/ui-common/src/components/data-table/table.tsx
index 957da3300..3dc2d5786 100644
--- a/packages/ui-common/src/components/data-table/table.tsx
+++ b/packages/ui-common/src/components/data-table/table.tsx
@@ -13,7 +13,10 @@ import { DataTableFooter } from "./footer";
 export function DataTable<TData, TValue>({
   columns,
   data,
-  status,
+  // The body only renders under "success", but the footer renders regardless —
+  // omitting status gave a blank table under a populated "Showing 1–N of N"
+  // footer. Having rows to draw is the default case, so default to success.
+  status = "success",
   onRowClick,
   rowStyle,
   rowClassName,
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 8e1d47c20..25037a2ae 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -99,9 +99,6 @@ importers:
       '@tria-plc/api-common':
         specifier: file:../../local-packages/tria-plc-api-common-1.6.0.tgz
         version: file:local-packages/tria-plc-api-common-1.6.0.tgz(ae9a56cc1c6d93629dd85f7605ccd5b6)
-      '@tria-plc/auditlog':
-        specifier: file:../../local-packages/tria-plc-auditlog-1.1.2.tgz
-        version: file:local-packages/tria-plc-auditlog-1.1.2.tgz(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(@nestjs/microservices@11.1.24)(@nestjs/swagger@11.4.4(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2))(@nestjs/typeorm@11.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3))))(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3)))
       '@tria-plc/iamapi-common':
         specifier: file:../../local-packages/tria-plc-iamapi-common-1.0.0.tgz
         version: file:local-packages/tria-plc-iamapi-common-1.0.0.tgz(d0be280d95adfc1b38e59bdc80c5dec5)
@@ -129,6 +126,9 @@ importers:
       dotenv-cli:
         specifier: ^11.0.0
         version: 11.0.0
+      exceljs:
+        specifier: ^4.4.0
+        version: 4.4.0
       handlebars:
         specifier: ^4.7.9
         version: 4.7.9
@@ -250,6 +250,9 @@ importers:
       '@mantine/hooks':
         specifier: ^9.3.0
         version: 9.3.0(react@19.2.6)
+      '@mdxeditor/editor':
+        specifier: ^4.2.0
+        version: 4.2.0(@codemirror/language@6.12.4)(@lezer/highlight@1.2.3)(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)(yjs@13.6.32)
       '@posthog/react':
         specifier: ^1.10.3
         version: 1.10.3(@types/react@18.3.31)(posthog-js@1.400.1)(react@19.2.6)
@@ -469,6 +472,9 @@ importers:
       react-intersection-observer:
         specifier: ^9.16.0
         version: 9.16.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      react-markdown:
+        specifier: ^9.1.0
+        version: 9.1.0(@types/react@18.3.31)(react@19.2.6)
       react-pdf:
         specifier: ^10.4.1
         version: 10.4.1(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
@@ -598,7 +604,7 @@ importers:
         version: 5.101.0(react@19.2.6)
       '@tria-plc/iamui':
         specifier: file:../../../local-packages/tria-plc-iamui-0.1.1.tgz
-        version: file:local-packages/tria-plc-iamui-0.1.1.tgz(0ce39b7e349029277dcd938d06eeb0f7)
+        version: file:local-packages/tria-plc-iamui-0.1.1.tgz(a5d0bdee55164ae56064fb273b530e00)
       '@vis.gl/react-google-maps':
         specifier: ^1.8.3
         version: 1.8.3(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
@@ -635,6 +641,9 @@ importers:
       react-hot-toast:
         specifier: ^2.6.0
         version: 2.6.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      react-markdown:
+        specifier: ^9.1.0
+        version: 9.1.0(@types/react@18.3.31)(react@19.2.6)
       react-phone-number-input:
         specifier: ^3.4.17
         version: 3.4.17(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
@@ -827,8 +836,8 @@ importers:
         specifier: file:../../local-packages/tria-plc-api-common-1.6.0.tgz
         version: file:local-packages/tria-plc-api-common-1.6.0.tgz(2b4e99ab22f78c34e7861d649f4ff29b)
       '@tria-plc/iamapi-common':
-        specifier: file:../../local-packages/tria-plc-iamapi-common-1.0.0.tgz
-        version: file:local-packages/tria-plc-iamapi-common-1.0.0.tgz(cc085a020c559b355f168432c579a024)
+        specifier: file:../../local-packages/tria-plc-iamapi-common-1.1.0.tgz
+        version: file:local-packages/tria-plc-iamapi-common-1.1.0.tgz(cc085a020c559b355f168432c579a024)
       '@types/bcrypt':
         specifier: ^6.0.0
         version: 6.0.0
@@ -974,6 +983,12 @@ importers:
       date-fns:
         specifier: ^3.0.0
         version: 3.6.0
+      exceljs:
+        specifier: ^4.4.0
+        version: 4.4.0
+      html-to-image:
+        specifier: ^1.11.11
+        version: 1.11.13
       lucide-react:
         specifier: ^0.446.0
         version: 0.446.0(react@18.3.1)
@@ -1744,6 +1759,99 @@ packages:
   '@borewit/text-codec@0.2.2':
     resolution: {integrity: sha512-DDaRehssg1aNrH4+2hnj1B7vnUGEjU6OIlyRdkMd0aUdIUvKXrJfXsy8LVtXAy7DRvYVluWbMspsRhz2lcW0mQ==}
 
+  '@codemirror/autocomplete@6.20.3':
+    resolution: {integrity: sha512-tlosUqb+3BbxCxZdu4tKeRghPFC+QM7q4X5YhKV2eCmPG+1r2F3f4AaSz5sCrFqUtX4Jh20VFTKecl16MgiV9g==}
+
+  '@codemirror/commands@6.10.4':
+    resolution: {integrity: sha512-Ryk9y9T0FFVF0cUGhAknveAyUOl/A1qReTFi+qPKtOh2Z9F4AUBz3XOrYD4ZEgZirdugVzHvd/2/Wcwy5OliTg==}
+
+  '@codemirror/lang-angular@0.1.4':
+    resolution: {integrity: sha512-oap+gsltb/fzdlTQWD6BFF4bSLKcDnlxDsLdePiJpCVNKWXSTAbiiQeYI3UmES+BLAdkmIC1WjyztC1pi/bX4g==}
+
+  '@codemirror/lang-cpp@6.0.3':
+    resolution: {integrity: sha512-URM26M3vunFFn9/sm6rzqrBzDgfWuDixp85uTY49wKudToc2jTHUrKIGGKs+QWND+YLofNNZpxcNGRynFJfvgA==}
+
+  '@codemirror/lang-css@6.3.1':
+    resolution: {integrity: sha512-kr5fwBGiGtmz6l0LSJIbno9QrifNMUusivHbnA1H6Dmqy4HZFte3UAICix1VuKo0lMPKQr2rqB+0BkKi/S3Ejg==}
+
+  '@codemirror/lang-go@6.0.1':
+    resolution: {integrity: sha512-7fNvbyNylvqCphW9HD6WFnRpcDjr+KXX/FgqXy5H5ZS0eC5edDljukm/yNgYkwTsgp2busdod50AOTIy6Jikfg==}
+
+  '@codemirror/lang-html@6.4.12':
+    resolution: {integrity: sha512-pw2ReWKUqSkbvh76RAT4NYxiogRu+PWkR2ukAwO9uOgrm8uipkzjtKKtNpyeAQwHOqxEeSvAXZ6vr3AfyB9y/w==}
+
+  '@codemirror/lang-java@6.0.2':
+    resolution: {integrity: sha512-m5Nt1mQ/cznJY7tMfQTJchmrjdjQ71IDs+55d1GAa8DGaB8JXWsVCkVT284C3RTASaY43YknrK2X3hPO/J3MOQ==}
+
+  '@codemirror/lang-javascript@6.2.5':
+    resolution: {integrity: sha512-zD4e5mS+50htS7F+TYjBPsiIFGanfVqg4HyUz6WNFikgOPf2BgKlx+TQedI1w6n/IqRBVBbBWmGFdLB/7uxO4A==}
+
+  '@codemirror/lang-jinja@6.0.1':
+    resolution: {integrity: sha512-P5kyHLObzjtbGj16h+hyvZTxJhSjBEeSx4wMjbnAf3b0uwTy2+F0zGjMZL4PQOm/mh2eGZ5xUDVZXgwP783Nsw==}
+
+  '@codemirror/lang-json@6.0.2':
+    resolution: {integrity: sha512-x2OtO+AvwEHrEwR0FyyPtfDUiloG3rnVTSZV1W8UteaLL8/MajQd8DpvUb2YVzC+/T18aSDv0H9mu+xw0EStoQ==}
+
+  '@codemirror/lang-less@6.0.2':
+    resolution: {integrity: sha512-EYdQTG22V+KUUk8Qq582g7FMnCZeEHsyuOJisHRft/mQ+ZSZ2w51NupvDUHiqtsOy7It5cHLPGfHQLpMh9bqpQ==}
+
+  '@codemirror/lang-liquid@6.3.2':
+    resolution: {integrity: sha512-6PDVU3ZnfeYyz1at1E/ttorErZvZFXXt1OPhtfe1EZJ2V2iDFa0CwPqPgG5F7NXN0yONGoBogKmFAafKTqlwIw==}
+
+  '@codemirror/lang-markdown@6.5.2':
+    resolution: {integrity: sha512-AwBOdkWYuA//WcM0xO5PfHPUcmz/O2i5o0Nsg1U69SII/loCJlFI1Romd9xp2HYb1kYJRGZotyqRghuHH5n8Kw==}
+
+  '@codemirror/lang-php@6.0.2':
+    resolution: {integrity: sha512-ZKy2v1n8Fc8oEXj0Th0PUMXzQJ0AIR6TaZU+PbDHExFwdu+guzOA4jmCHS1Nz4vbFezwD7LyBdDnddSJeScMCA==}
+
+  '@codemirror/lang-python@6.2.1':
+    resolution: {integrity: sha512-IRjC8RUBhn9mGR9ywecNhB51yePWCGgvHfY1lWN/Mrp3cKuHr0isDKia+9HnvhiWNnMpbGhWrkhuWOc09exRyw==}
+
+  '@codemirror/lang-rust@6.0.2':
+    resolution: {integrity: sha512-EZaGjCUegtiU7kSMvOfEZpaCReowEf3yNidYu7+vfuGTm9ow4mthAparY5hisJqOHmJowVH3Upu+eJlUji6qqA==}
+
+  '@codemirror/lang-sass@6.0.2':
+    resolution: {integrity: sha512-l/bdzIABvnTo1nzdY6U+kPAC51czYQcOErfzQ9zSm9D8GmNPD0WTW8st/CJwBTPLO8jlrbyvlSEcN20dc4iL0Q==}
+
+  '@codemirror/lang-sql@6.10.0':
+    resolution: {integrity: sha512-6ayPkEd/yRw0XKBx5uAiToSgGECo/GY2NoJIHXIIQh1EVwLuKoU8BP/qK0qH5NLXAbtJRLuT73hx7P9X34iO4w==}
+
+  '@codemirror/lang-vue@0.1.3':
+    resolution: {integrity: sha512-QSKdtYTDRhEHCfo5zOShzxCmqKJvgGrZwDQSdbvCRJ5pRLWBS7pD/8e/tH44aVQT6FKm0t6RVNoSUWHOI5vNug==}
+
+  '@codemirror/lang-wast@6.0.2':
+    resolution: {integrity: sha512-Imi2KTpVGm7TKuUkqyJ5NRmeFWF7aMpNiwHnLQe0x9kmrxElndyH0K6H/gXtWwY6UshMRAhpENsgfpSwsgmC6Q==}
+
+  '@codemirror/lang-xml@6.1.0':
+    resolution: {integrity: sha512-3z0blhicHLfwi2UgkZYRPioSgVTo9PV5GP5ducFH6FaHy0IAJRg+ixj5gTR1gnT/glAIC8xv4w2VL1LoZfs+Jg==}
+
+  '@codemirror/lang-yaml@6.1.3':
+    resolution: {integrity: sha512-AZ8DJBuXGVHybpBQhmZtgew5//4hv3tdkXnr3vDmOUMJRuB6vn/uuwtmTOTlqEaQFg3hQSVeA90NmvIQyUV6FQ==}
+
+  '@codemirror/language-data@6.5.2':
+    resolution: {integrity: sha512-CPkWBKrNS8stYbEU5kwBwTf3JB1kghlbh4FSAwzGW2TEscdeHHH4FGysREW86Mqnj3Qn09s0/6Ea/TutmoTobg==}
+
+  '@codemirror/language@6.12.4':
+    resolution: {integrity: sha512-1q4PaT+o6PbgpkJt4Q8Fv5XJxTy4FUZ4MWETtyiDw3J0Pyr9E2vqcKL+k9wcvjNTIsauxvE7OfmWj3FRPHQ76A==}
+
+  '@codemirror/legacy-modes@6.5.3':
+    resolution: {integrity: sha512-xCsmIzH78MyWkib9jlPaaun57XNkfbMIhagfaZVd0iLTqlpw3jXaIcbZm72MTmmn64eTZpBVNjbyYh+QXnxRsg==}
+
+  '@codemirror/lint@6.9.7':
+    resolution: {integrity: sha512-28/+iWLYxKxsvGYhSYL7zaCZqLz5+FFFDq9tVsvGv9kv8RY4fFAchJ5WX9M3YrrRlTIsECjsXPqeNgnSmNP2dg==}
+
+  '@codemirror/merge@6.12.2':
+    resolution: {integrity: sha512-V8JvyAPjHbPupqP7BeMcsdsYCbyPij74jxIbaIJDORI+VZzW44zFmon8bF+oxGWvOKhcRmkiUMXd8MxHr3YA2w==}
+
+  '@codemirror/search@6.7.1':
+    resolution: {integrity: sha512-uMe5UO6PamJtSHrXhhHOzSX3ReWtiJrva6GnPMwSOrZtiExb5X5eExhr2OUZQVvdxPsKpY3Ro2mFbQadpPWmHA==}
+
+  '@codemirror/state@6.7.1':
+    resolution: {integrity: sha512-9QzNDgE4EYDnAHfrTlR2lwiPciiOymLtwKK+8yHQzCc7GXhAP9xdEbEJFy2IWB1j9UGUl9BsgMmTo/ImA02T7A==}
+
+  '@codemirror/view@6.43.8':
+    resolution: {integrity: sha512-qtItTDssZ/5GFfi94hrILu9j/VUeFPDPkhovEfmWFj2ipTxnzPB8DdHgfbb8HYTzLTYhrndKmyQxXUz/PDLenw==}
+
   '@colors/colors@1.5.0':
     resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
     engines: {node: '>=0.1.90'}
@@ -2551,6 +2659,249 @@ packages:
   '@jridgewell/trace-mapping@0.3.9':
     resolution: {integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==}
 
+  '@lexical/a11y@0.48.0':
+    resolution: {integrity: sha512-18W4ehyipkUim4YVoDZitoH63Om3j6iCN4c84zdqE9RgkWf/PE4rvI/8BHTm6Ni7NkVE14nimXgkpaP5ok15zA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/clipboard@0.48.0':
+    resolution: {integrity: sha512-xO2trk6+yBl8XXa/VNe20kXczmPxFoWtUHjidbBLEtlGBj+mo63pJj6H5o/WlZsoMKmIOJxwxsn2ejrS8G0/7A==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/code-core@0.48.0':
+    resolution: {integrity: sha512-+O1Ge06AuSo6+r8R2Xk6SkWG07H5/e4K/Scw9aqCM/BRjITxgvFTHTNvgQbaobCsP0uBJiwW1+ZGeWAWcBCY4w==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/devtools-core@0.48.0':
+    resolution: {integrity: sha512-4kvKWW6ebgQnJNLXPLmw7dqgSChvzYIBNYtfuR6c48Sw+V/QXQTWqfIUbCIe5X4uG8EEXd5O/udXaJx7GBuP+w==}
+    peerDependencies:
+      react: '>=18.x'
+      react-dom: '>=18.x'
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/dragon@0.48.0':
+    resolution: {integrity: sha512-uPuu7fVca9vmL/Oz30CRZ7FIPIodwMrTgNsRmV8jE6Qd6a7RNiTW7r3+EhbhIdkLb/sjcWsYyOMyUR1TJAB0wQ==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/extension@0.48.0':
+    resolution: {integrity: sha512-4uBObgz84mVbQWiumndmIhkuJL0ojHiMwFSvSUM/FCo1YMVIZvpI56blI0y+2Vix/oLui9EgVQSJjjWV4NAszw==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/hashtag@0.48.0':
+    resolution: {integrity: sha512-hPQtdnbVoNAFsmfnCGfgY7mDbvk6mIznlCRmIR7tLeQKXqz/0Tb6eH3W24EESk9hAF8wFUYNKWE1/Kb3Hl2vEQ==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/history@0.48.0':
+    resolution: {integrity: sha512-NllvUfO+u3mfi5uC8k2CodwdzeeopFFVtMZ/NMifzFbZFysdWi9m9mqfO46NrEA1rSFOydyefv6oMzC8ULXInA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/html@0.48.0':
+    resolution: {integrity: sha512-uBxlgKl4YgSNEgHJSshdBqtGDzruWdx1ewop+u6faT67qHUdP3P0cUXIrG6NToDWvsL6fzCstAbN76PMER1Pnw==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/internal@0.48.0':
+    resolution: {integrity: sha512-sRwg53K7N0ZQ7KNAvcCY38LSwGizbXP1zlR1lIojZp0GoqHWNvR+vL49t1wYXu1nXx3Osf4ilHHm+aGcwq5hTw==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/link@0.48.0':
+    resolution: {integrity: sha512-E0UDmNLUXs/yMCnnE7hbFO0CvhWghmqa+qqPksFfzLkpMHdPpdS1yg59YEbYoNHLi/DXIu4cFRvpHIEuooxwNg==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/list@0.48.0':
+    resolution: {integrity: sha512-9Qe/Vur44v9F9enj55SUzf79FVsijcGOQug7SpiIU8ekLr7JNzcilKYBYcZ6etGEo7bqQHsYMHXeJcSBbCI2zA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/mark@0.48.0':
+    resolution: {integrity: sha512-DTtypWvnYSXyNUxEmsUnh4y0xXkmdk8Y72EZl8WDHcCwjqaLJlUakH7p/TuSJczs3uVSaoJzu0yh7oGkP1Vsvw==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/markdown@0.48.0':
+    resolution: {integrity: sha512-1WasBenW4bEsa5xtnycVo8G2hcxIqyYLn3/r98yD2Y+54ZyeFuIQfOeJYhIgCh4YkKpfqyrFwkMQwAOsQDqZjA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/overflow@0.48.0':
+    resolution: {integrity: sha512-1YEvMz2tW3EbwrON9mjrkjMVl/vdTcPYSn9P1j6mf5gj0LOoLDNI4TbvSD4SViy+TDghxNdG8YdCISyU2b4YKA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/plain-text@0.48.0':
+    resolution: {integrity: sha512-q4f/4VZKVgCrIW2FhDFR2RII1BU0ljedPgEmJ8XQn1zc+JOFPom8Lp0lV5nyEvZaAJYwM/TfoJ9g2V7ESFKznA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/react@0.48.0':
+    resolution: {integrity: sha512-uVh9/QSrbtjLjVbxfJ+sfiMyhUq/rv7H6uBEVDDIw1rkZJSDY1fvf/CX+dyKgwcDFjKQZ8/9i5f9UCVPeQ01hA==}
+    peerDependencies:
+      react: '>=18.x'
+      react-dom: '>=18.x'
+      typescript: '>=5.2'
+      yjs: '>=13.5.22'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+      yjs:
+        optional: true
+
+  '@lexical/rich-text@0.48.0':
+    resolution: {integrity: sha512-QMXFnwCKAQ4yzxvx5FwmANcx3K+NaBkGTxAVD8s8pOKDD/U5rzDS1iIvhH6TLWaFp7VzvLmLB+Sl1Ie/RnkaDQ==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/selection@0.48.0':
+    resolution: {integrity: sha512-Uc0wTrEtHcYK6z/aHHjkgH3vX/R4Bf8mO+qH3VbxfSAKYzNYktM0j+ZGdq5kIEL4frnw/9SulNCXlH7xpjuDgA==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/table@0.48.0':
+    resolution: {integrity: sha512-t9Mz7q6ODLUz0lG5Xn9EY/5YiVpTHCqlPQP4EtFXlnBQT3DuKeDS3cC0Cn8sGSZc11YY5OLDfWpB64Frs9BL3g==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/text@0.48.0':
+    resolution: {integrity: sha512-ktTMRbsX4wKxdG2OpZCkrqtt8k9Vg/ZpWdukOQ0r1xPRtCuL1T+q91l7cy2ywIuCfMGYS0aoZGB4LdpUMe/H1g==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/utils@0.48.0':
+    resolution: {integrity: sha512-W4k4P+y6jmRfna8+ad4X+iMd5h8es5PC3bUw5tbi7MRApxaaFG/0w+uJiZVSwbT2Q6JnA2xhBaqzPgt/Gn6djg==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lexical/yjs@0.48.0':
+    resolution: {integrity: sha512-fFsE8EnPM/2KK9rMJ0z6T+Da5UW5V4P+XiAA03LoHTY5YQ/Oy8Q0i7Wcmocv/B/SpsY2o8g07euZEfudl9MVKA==}
+    peerDependencies:
+      typescript: '>=5.2'
+      yjs: '>=13.5.22'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@lezer/common@1.5.2':
+    resolution: {integrity: sha512-sxQE460fPZyU3sdc8lafxiPwJHBzZRy/udNFynGQky1SePYBdhkBl1kOagA9uT3pxR8K09bOrmTUqA9wb/PjSQ==}
+
+  '@lezer/cpp@1.1.6':
+    resolution: {integrity: sha512-vh9gWWJOXFVY8HBHK3Twzq8MgwG2iN4GSyzBP9sCGTe37P15x2R14VaBQk0VA0ezTRN1KHYBBsHhvpGZ2Xy/pA==}
+
+  '@lezer/css@1.3.6':
+    resolution: {integrity: sha512-YJE78Wcg+zX8f10hiHWQ4Az48Qr/c13eId0VtRQYLBpxHDmDeSrXIlkbl+fJGW42rWC/uoUco9mhBZeVWP/A1g==}
+
+  '@lezer/go@1.0.1':
+    resolution: {integrity: sha512-xToRsYxwsgJNHTgNdStpcvmbVuKxTapV0dM0wey1geMMRc9aggoVyKgzYp41D2/vVOx+Ii4hmE206kvxIXBVXQ==}
+
+  '@lezer/highlight@1.2.3':
+    resolution: {integrity: sha512-qXdH7UqTvGfdVBINrgKhDsVTJTxactNNxLk7+UMwZhU13lMHaOBlJe9Vqp907ya56Y3+ed2tlqzys7jDkTmW0g==}
+
+  '@lezer/html@1.3.13':
+    resolution: {integrity: sha512-oI7n6NJml729m7pjm9lvLvmXbdoMoi2f+1pwSDJkl9d68zGr7a9Btz8NdHTGQZtW2DA25ybeuv/SyDb9D5tseg==}
+
+  '@lezer/java@1.1.3':
+    resolution: {integrity: sha512-yHquUfujwg6Yu4Fd1GNHCvidIvJwi/1Xu2DaKl/pfWIA2c1oXkVvawH3NyXhCaFx4OdlYBVX5wvz2f7Aoa/4Xw==}
+
+  '@lezer/javascript@1.5.4':
+    resolution: {integrity: sha512-vvYx3MhWqeZtGPwDStM2dwgljd5smolYD2lR2UyFcHfxbBQebqx8yjmFmxtJ/E6nN6u1D9srOiVWm3Rb4tmcUA==}
+
+  '@lezer/json@1.0.3':
+    resolution: {integrity: sha512-BP9KzdF9Y35PDpv04r0VeSTKDeox5vVr3efE7eBbx3r4s3oNLfunchejZhjArmeieBH+nVOpgIiBJpEAv8ilqQ==}
+
+  '@lezer/lr@1.4.10':
+    resolution: {integrity: sha512-rnCpTIBafOx4mRp43xOxDJbFipJm/c0cia/V5TiGlhmMa+wsSdoGmUN3w5Bqrks/09Q/D4tNAmWaT8p6NRi77A==}
+
+  '@lezer/markdown@1.7.2':
+    resolution: {integrity: sha512-iTkYvoVcKt3WkeL7qUDyXHONZEwLio4wj8KTNi2dnjQEXBZKMV63BpQrPqfsM+OkvuRbiSTAcycYAsQzLhRNoQ==}
+
+  '@lezer/php@1.0.5':
+    resolution: {integrity: sha512-W7asp9DhM6q0W6DYNwIkLSKOvxlXRrif+UXBMxzsJUuqmhE7oVU+gS3THO4S/Puh7Xzgm858UNaFi6dxTP8dJA==}
+
+  '@lezer/python@1.1.19':
+    resolution: {integrity: sha512-MhQIURHRytsNzP/YXnqpYKW6la6voAH3kyplTOOiCdjyFY6cWWGFVmYVdHIPrElqSDf4iCDktQCockB9FxuhzQ==}
+
+  '@lezer/rust@1.0.2':
+    resolution: {integrity: sha512-Lz5sIPBdF2FUXcWeCu1//ojFAZqzTQNRga0aYv6dYXqJqPfMdCAI0NzajWUd4Xijj1IKJLtjoXRPMvTKWBcqKg==}
+
+  '@lezer/sass@1.1.0':
+    resolution: {integrity: sha512-3mMGdCTUZ/84ArHOuXWQr37pnf7f+Nw9ycPUeKX+wu19b7pSMcZGLbaXwvD2APMBDOGxPmpK/O6S1v1EvLoqgQ==}
+
+  '@lezer/xml@1.0.6':
+    resolution: {integrity: sha512-CdDwirL0OEaStFue/66ZmFSeppuL6Dwjlk8qk153mSQwiSH/Dlri4GNymrNWnUmPl2Um7QfV1FO9KFUyX3Twww==}
+
+  '@lezer/yaml@1.0.4':
+    resolution: {integrity: sha512-2lrrHqxalACEbxIbsjhqGpSW8kWpUKuY6RHgnSAFZa6qK62wvnPxA8hGOwOoDbwHcOFs5M4o27mjGu+P7TvBmw==}
+
   '@lottiefiles/react-lottie-player@3.6.0':
     resolution: {integrity: sha512-WK5TriLJT93VF3w4IjSVyveiedraZCnDhKzCPhpbeLgQeMi6zufxa3dXNc4HmAFRXq+LULPAy+Idv1rAfkReMA==}
     peerDependencies:
@@ -2636,6 +2987,23 @@ packages:
     peerDependencies:
       react: ^18.x || ^19.x
 
+  '@marijn/find-cluster-break@1.0.3':
+    resolution: {integrity: sha512-FY+MKLBoTsLNJF/eLWaOsXGdz6uh3Iu1axjPf6TUq92IYumcTcXWHoS747JARLkcdlJ/Waiaxc5wQfFO8jC6NA==}
+
+  '@mdxeditor/editor@4.2.0':
+    resolution: {integrity: sha512-S/IPY8AjWTV2v1TGbEy5lsbQ5w+J2M2j2QDeswxP4FpNh2B49OPkpSqHbbX5GbV0YBlhfXJxtzwBJv/sQACufw==}
+    engines: {node: '>=16'}
+    peerDependencies:
+      react: '>= 18 || >= 19'
+      react-dom: '>= 18 || >= 19'
+
+  '@mdxeditor/gurx@1.2.4':
+    resolution: {integrity: sha512-9ZykIFYhKaXaaSPCs1cuI+FvYDegJjbKwmA4ASE/zY+hJY6EYqvoye4esiO85CjhOw9aoD/izD/CU78/egVqmg==}
+    engines: {node: '>=16'}
+    peerDependencies:
+      react: '>= 18 || >= 19'
+      react-dom: '>= 18 || >= 19'
+
   '@microsoft/tsdoc@0.15.1':
     resolution: {integrity: sha512-4aErSrCR/On/e5G2hDP0wjooqDdauzEbIq8hIkIe5pXV0rtWJZvdCEKL0ykZxex+IxIwBp0eGeV48hQN07dXtw==}
 
@@ -3361,6 +3729,9 @@ packages:
   '@posthog/types@1.394.0':
     resolution: {integrity: sha512-ifQ7p8o8hoHErlJmpzCFzHQcuRam0vXk8LBVhBu4BlPYP6S0tog4FSAFItnI/nwN6cHZI0WFQilr7sIqQa7Flg==}
 
+  '@preact/signals-core@1.14.4':
+    resolution: {integrity: sha512-HNB6HYeYKhQbJ1aKl+YRjrS4+QWHLKX6qKoUsfS/m0vqzsVaEBiZiaKbG/e+NKk2ch5ALQr/ihWaMHxiCuuWHA==}
+
   '@prisma/client@6.19.3':
     resolution: {integrity: sha512-mKq3jQFhjvko5LTJFHGilsuQs+W+T3Gm451NzuTDGQxwCzwXHYnIu2zGkRoW+Exq3Rob7yp2MfzSrdIiZVhrBg==}
     engines: {node: '>=18.18'}
@@ -3396,6 +3767,9 @@ packages:
     engines: {node: '>=18'}
     hasBin: true
 
+  '@radix-ui/colors@3.0.0':
+    resolution: {integrity: sha512-FUOsGBkHrYJwCSEtWRCIfQbZG7q1e6DgxCIOe1SUQzDe/7rXXeA47s8yCn6fuTNQAj1Zq4oTFi9Yjp3wzElcxg==}
+
   '@radix-ui/number@1.1.2':
     resolution: {integrity: sha512-ceTwaxc4I5IOi97DgCotl3pqiyRGvffcc0oOsE2dQYaJOFIDsDt4VWG6xEbg1QePv9QWausCEIppud/tJ1wNig==}
 
@@ -3646,6 +4020,11 @@ packages:
       '@types/react-dom':
         optional: true
 
+  '@radix-ui/react-icons@1.3.2':
+    resolution: {integrity: sha512-fyQIhGDhzfc9pK2kH6Pl9c4BDJGfMkPqkyIgYDthyNYoNg3wVhoJMMh19WS4Up/1KMPFVpNsT2q3WmXn2N1m6g==}
+    peerDependencies:
+      react: ^16.x || ^17.x || ^18.x || ^19.0.0 || ^19.0.0-rc
+
   '@radix-ui/react-id@1.1.2':
     resolution: {integrity: sha512-orBC88futVpqCmhX1p4cvquNHsELQ+w+vBJnuj3ftETI5bJb0bZn3Tqu3SWN2IOcPycTnMGnhwoermvISt72sA==}
     peerDependencies:
@@ -4650,19 +5029,6 @@ packages:
       rxjs: ^7.8.0
       typeorm: ^0.3.0
 
-  '@tria-plc/auditlog@file:local-packages/tria-plc-auditlog-1.1.2.tgz':
-    resolution: {integrity: sha512-3kRaAtETvM9wVRSbwd2jyrts9DCcSV9yFUDoEpxJfVQDsIGY2d9K0c+h1LAjfNNaogZ8eeBcroyCrnWjwBmkYA==, tarball: file:local-packages/tria-plc-auditlog-1.1.2.tgz}
-    version: 1.1.2
-    engines: {node: '>=18'}
-    peerDependencies:
-      '@nestjs/common': ^10.0.0 || ^11.0.0
-      '@nestjs/core': ^10.0.0 || ^11.0.0
-      '@nestjs/microservices': ^10.0.0 || ^11.0.0
-      '@nestjs/swagger': ^10.0.0 || ^11.0.0
-      '@nestjs/typeorm': ^10.0.0 || ^11.0.0
-      rxjs: ^7.0.0
-      typeorm: ^0.3.0
-
   '@tria-plc/iamapi-common@file:local-packages/tria-plc-iamapi-common-1.0.0.tgz':
     resolution: {integrity: sha512-rfHSXOm/0VUMTj7HrvYysrEAqxItqfPs4Rd35qWJyaAk+snF1wTKFRVz6cRGPoQNj8fhplkVAefnvuKBuHT+xQ==, tarball: file:local-packages/tria-plc-iamapi-common-1.0.0.tgz}
     version: 1.0.0
@@ -4685,6 +5051,28 @@ packages:
       rxjs: ^7.8.0
       typeorm: ^0.3.0
 
+  '@tria-plc/iamapi-common@file:local-packages/tria-plc-iamapi-common-1.1.0.tgz':
+    resolution: {integrity: sha512-MWsfKmd+6+LxMx6fpJR9+c9oFtxiaNwR3KW2ptRVGinnmHofmqAsC3nURhRqTyWQeUbdNrvRdoiZtRx/0936Pw==, tarball: file:local-packages/tria-plc-iamapi-common-1.1.0.tgz}
+    version: 1.1.0
+    engines: {node: '>=20'}
+    peerDependencies:
+      '@nestjs/axios': ^4.0.0
+      '@nestjs/common': ^11.0.0
+      '@nestjs/core': ^11.0.0
+      '@nestjs/jwt': ^11.0.0
+      '@nestjs/microservices': ^11.0.0
+      '@nestjs/passport': ^11.0.0
+      '@nestjs/swagger': ^11.0.0
+      '@nestjs/throttler': ^6.0.0
+      '@nestjs/typeorm': ^11.0.0
+      '@tria-plc/api-common': '*'
+      axios: ^1.9.0
+      class-transformer: ^0.5.1
+      class-validator: ^0.14.1
+      reflect-metadata: ^0.2.0
+      rxjs: ^7.8.0
+      typeorm: ^0.3.0
+
   '@tria-plc/iamui@file:local-packages/tria-plc-iamui-0.1.1.tgz':
     resolution: {integrity: sha512-FTihoH0lIqKV/0s+FTJZokQw8xX3XztXIqT8eEYEZgDM2xyzVSCHY8pHCUxw0MQtiR8R97zxZJ/o192eWt+E/g==, tarball: file:local-packages/tria-plc-iamui-0.1.1.tgz}
     version: 0.1.1
@@ -4804,6 +5192,9 @@ packages:
   '@types/d3-timer@3.0.2':
     resolution: {integrity: sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==}
 
+  '@types/debug@4.1.13':
+    resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
+
   '@types/dompurify@3.2.0':
     resolution: {integrity: sha512-Fgg31wv9QbLDA0SpTOXO3MaxySc4DKGLi8sna4/Utjo4r3ZRPdCt4UQee8BWr+Q5z21yifghREPJGYaEOEIACg==}
     deprecated: This is a stub types definition. dompurify provides its own type definitions, so you do not need this installed.
@@ -4814,6 +5205,9 @@ packages:
   '@types/eslint@9.6.1':
     resolution: {integrity: sha512-FXx2pKgId/WyYo2jXw63kk7/+TY7u7AziEJxJAnSFzHlqTAS3Ync6SvgYAN/k4/PQpnnVuzoMuVnByKK2qp0ag==}
 
+  '@types/estree-jsx@1.0.5':
+    resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
+
   '@types/estree@1.0.9':
     resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
 
@@ -4835,6 +5229,9 @@ packages:
   '@types/graceful-fs@4.1.9':
     resolution: {integrity: sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==}
 
+  '@types/hast@3.0.5':
+    resolution: {integrity: sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==}
+
   '@types/hoist-non-react-statics@3.3.7':
     resolution: {integrity: sha512-PQTyIulDkIDro8P+IHbKCsw7U2xxBYflVzW/FgWdCAePD9xGSidgA76/GeJ6lBKoblyhf9pBY763gbrN+1dI8g==}
     peerDependencies:
@@ -4879,6 +5276,9 @@ packages:
   '@types/luxon@3.7.1':
     resolution: {integrity: sha512-H3iskjFIAn5SlJU7OuxUmTEpebK6TKB8rxZShDslBMZJ5u9S//KM1sbdAisiSrqwLQncVjnpi2OK2J51h+4lsg==}
 
+  '@types/mdast@4.0.4':
+    resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
   '@types/methods@1.1.4':
     resolution: {integrity: sha512-ymXWVrDiCxTBE3+RIrrP533E70eA+9qu7zdWoHuOmGujkYtzf4HQF96b8nwHLqhuf4ykX61IGRIB38CC6/sImQ==}
 
@@ -4991,6 +5391,12 @@ packages:
   '@types/trusted-types@2.0.7':
     resolution: {integrity: sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==}
 
+  '@types/unist@2.0.11':
+    resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
+
+  '@types/unist@3.0.3':
+    resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
   '@types/use-sync-external-store@0.0.6':
     resolution: {integrity: sha512-zFDAD+tlpf2r4asuHEj0XH6pY6i0g5NeAHPn+15wk3BV6JA69eERFXC1gyGThDkVa1zCyKr5jox1+2LbV/AMLg==}
 
@@ -5814,6 +6220,9 @@ packages:
   babel-runtime@6.26.0:
     resolution: {integrity: sha512-ITKNuq2wKlW1fJg9sSW52eepoYgZBggvOAHC0u/CYu/qxQ9EVzThCgR69BnSXLHjy2f7SY5zaQ4yt7H9ZVxY2g==}
 
+  bail@2.0.2:
+    resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
+
   balanced-match@1.0.2:
     resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
 
@@ -6075,6 +6484,9 @@ packages:
   caseless@0.12.0:
     resolution: {integrity: sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==}
 
+  ccount@2.0.1:
+    resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==}
+
   cfb@1.2.2:
     resolution: {integrity: sha512-KfdUZsSOw19/ObEWasvBP/Ac4reZvAGauZhs6S/gqNhXhI7cKwvlH7ulj+dOEYnca4bm4SGo8C1bTAQvnTjgQA==}
     engines: {node: '>=0.8'}
@@ -6105,6 +6517,18 @@ packages:
     resolution: {integrity: sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==}
     engines: {node: '>=10'}
 
+  character-entities-html4@2.1.0:
+    resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
+
+  character-entities-legacy@3.0.0:
+    resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
+
+  character-entities@2.0.2:
+    resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==}
+
+  character-reference-invalid@2.0.1:
+    resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
+
   chardet@2.1.1:
     resolution: {integrity: sha512-PsezH1rqdV9VvyNhxxOW32/d75r01NY7TQCmOqomRo15ZSOKbpTFVsfjghxo6JloQUCGnH4k1LGu0R4yCLlWQQ==}
 
@@ -6227,6 +6651,14 @@ packages:
     resolution: {integrity: sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==}
     engines: {node: '>=6'}
 
+  cm6-theme-basic-light@0.2.0:
+    resolution: {integrity: sha512-1prg2gv44sYfpHscP26uLT/ePrh0mlmVwMSoSd3zYKQ92Ab3jPRLzyCnpyOCQLJbK+YdNs4HvMRqMNYdy4pMhA==}
+    peerDependencies:
+      '@codemirror/language': ^6.0.0
+      '@codemirror/state': ^6.0.0
+      '@codemirror/view': ^6.0.0
+      '@lezer/highlight': ^1.0.0
+
   cmdk@1.1.1:
     resolution: {integrity: sha512-Vsv7kFaXm+ptHDMZ7izaRsP70GgrW9NBNGswt9OZaVBLlE0SNpDq8eu/VGXyF9r7M0azK3Wy7OlYXsuyYLFzHg==}
     peerDependencies:
@@ -6244,6 +6676,9 @@ packages:
     resolution: {integrity: sha512-RpAVKQA5T63xEj6/giIbUEtZwJ4UFIc3ZtvEkiaUERylqe8xb5IvqcgOurZLahv93CLKfxcw5YI+DZcUBRyLXA==}
     engines: {node: '>=0.10.0'}
 
+  codemirror@6.0.2:
+    resolution: {integrity: sha512-VhydHotNW5w1UGK0Qj96BwSk/Zqbp9WbnyK2W/eVMv4QyF41INRGpjUhFJY7/uDNuudSc33a/PKr4iDqRduvHw==}
+
   codepage@1.15.0:
     resolution: {integrity: sha512-3g6NUTPd/YtuuGrhMnOMRjFc+LJw/bnMp3+0r/Wcz3IXUuCosKRJvMphm5+Q+bvTVGcJJuRvVLuYba+WojaFaA==}
     engines: {node: '>=0.8'}
@@ -6281,6 +6716,9 @@ packages:
     resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}
     engines: {node: '>= 0.8'}
 
+  comma-separated-tokens@2.0.3:
+    resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
+
   commander@11.1.0:
     resolution: {integrity: sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==}
     engines: {node: '>=16'}
@@ -6322,6 +6760,9 @@ packages:
     resolution: {integrity: sha512-D3uMHtGc/fcO1Gt1/L7i1e33VOvD4A9hfQLP+6ewd+BvG/gQ84Yh4oftEhAdjSMgBgwGL+jsppT7JYNpo6MHHg==}
     engines: {node: '>= 10'}
 
+  compute-scroll-into-view@2.0.4:
+    resolution: {integrity: sha512-y/ZA3BGnxoM/QHHQ2Uy49CLtnWPbt4tTPpEEZiEmmiWBFKjej7nEyH8Ryz54jH0MLXflUYA3Er2zUxPSJu5R+g==}
+
   concat-map@0.0.1:
     resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
 
@@ -6467,6 +6908,9 @@ packages:
   create-require@1.1.1:
     resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==}
 
+  crelt@1.0.7:
+    resolution: {integrity: sha512-aK6BbWfhf4U/wCcLHKPJl/xa6VkVstRaPywWtMKGwuOLc/wZTyQYuoxgvZnNsBvv7Kg3YTBQYYBCggcviQczuA==}
+
   cron@4.4.0:
     resolution: {integrity: sha512-fkdfq+b+AHI4cKdhZlppHveI/mgz2qpiYxcm+t5E5TsxX7QrLS1VE0+7GENEk9z0EeGPcpSciGv6ez24duWhwQ==}
     engines: {node: '>=18.x'}
@@ -6658,6 +7102,9 @@ packages:
   decimal.js@10.6.0:
     resolution: {integrity: sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==}
 
+  decode-named-character-reference@1.3.0:
+    resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
+
   decode-uri-component@0.2.2:
     resolution: {integrity: sha512-FqUYQ+8o158GyGTrMFJms9qh3CqTKvAqgqsTnkLI8sKu0028orqBhxNMFkFen0zGyg6epACD32pjVk58ngIErQ==}
     engines: {node: '>=0.10'}
@@ -6765,6 +7212,9 @@ packages:
   detect-node-es@1.1.0:
     resolution: {integrity: sha512-ypdmJU/TbBby2Dxibuv7ZLW3Bs1QEmM7nHjEANfohJLvE0XVujisn1qPJcZxg+qDucsr+bP6fLD1rPS3AhJ7EQ==}
 
+  devlop@1.1.0:
+    resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
+
   devtools-protocol@0.0.1608973:
     resolution: {integrity: sha512-Tpm17fxYzt+J7VrGdc1k8YdRqS3YV7se/M6KeemEqvUbq/n7At1rWVuXMxQgpWkdwSdIEKYbU//Bve+Shm4YNQ==}
 
@@ -6785,6 +7235,10 @@ packages:
     resolution: {integrity: sha512-X07nttJQkwkfKfvTPG/KSnE2OMdcUCao6+eXF3wmnIQRn2aPAHH3VxDbDOdegkd6JbPsXqShpvEOHfAT+nCNwQ==}
     engines: {node: '>=0.3.1'}
 
+  diff@5.2.2:
+    resolution: {integrity: sha512-vtcDfH3TOjP8UekytvnHH1o1P4FcUdt4eQ1Y+Abap1tk/OB2MWQvcwS2ClCd1zuIhc3JKOx6p3kod8Vfys3E+A==}
+    engines: {node: '>=0.3.1'}
+
   diff@8.0.4:
     resolution: {integrity: sha512-DPi0FmjiSU5EvQV0++GFDOJ9ASQUVFh5kD+OzOnYdi7n3Wpm9hWWGfB/O2blfHcMVTL5WkQXSnRiK9makhrcnw==}
     engines: {node: '>=0.3.1'}
@@ -6846,6 +7300,11 @@ packages:
     resolution: {integrity: sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==}
     engines: {node: '>=12'}
 
+  downshift@7.6.2:
+    resolution: {integrity: sha512-iOv+E1Hyt3JDdL9yYcOgW7nZ7GQ2Uz6YbggwXvKUSleetYhU2nXD482Rz6CzvM4lvI1At34BYruKAL4swRGxaA==}
+    peerDependencies:
+      react: '>=16.12.0'
+
   dunder-proto@1.0.1:
     resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
     engines: {node: '>= 0.4'}
@@ -7023,6 +7482,10 @@ packages:
     resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
     engines: {node: '>=10'}
 
+  escape-string-regexp@5.0.0:
+    resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+    engines: {node: '>=12'}
+
   escodegen@2.1.0:
     resolution: {integrity: sha512-2NlIDTwUWJN0mRPQOdtQBzbUHvdGY2P1VXSyU83Q3xKxM7WHX2Ql8dKq782Q9TgQUNOLEzEYu9bzLNj1q88I5w==}
     engines: {node: '>=6.0'}
@@ -7160,6 +7623,12 @@ packages:
     resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==}
     engines: {node: '>=4.0'}
 
+  estree-util-is-identifier-name@3.0.0:
+    resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
+
+  estree-util-visit@2.0.0:
+    resolution: {integrity: sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==}
+
   estree-walker@3.0.3:
     resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
 
@@ -7357,6 +7826,9 @@ packages:
   fastq@1.20.1:
     resolution: {integrity: sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==}
 
+  fault@2.0.1:
+    resolution: {integrity: sha512-WtySTkS4OKev5JtpHXnib4Gxiurzh5NCGvWrFaZ34m6JehfTUhKZvn9njTfw48t6JumVQOmrKqpmGcdwxnhqBQ==}
+
   fb-watchman@2.0.2:
     resolution: {integrity: sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==}
 
@@ -7494,6 +7966,10 @@ packages:
     resolution: {integrity: sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==}
     engines: {node: '>= 6'}
 
+  format@0.2.2:
+    resolution: {integrity: sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww==}
+    engines: {node: '>=0.4.x'}
+
   formdata-polyfill@4.0.10:
     resolution: {integrity: sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==}
     engines: {node: '>=12.20.0'}
@@ -7817,6 +8293,12 @@ packages:
     resolution: {integrity: sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==}
     engines: {node: '>= 0.4'}
 
+  hast-util-to-jsx-runtime@2.3.6:
+    resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==}
+
+  hast-util-whitespace@3.0.0:
+    resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
+
   he@1.2.0:
     resolution: {integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==}
     hasBin: true
@@ -7871,6 +8353,12 @@ packages:
     resolution: {integrity: sha512-XxzooSo6oBoxBEUazgjdXj7VwTn/iSTSZzTYKzYY6I916tkaYzypHxy+pbVU1h+0UQ9JlVf5XkNQyxOAiiQO1g==}
     engines: {node: '>=0.10.0'}
 
+  html-to-image@1.11.13:
+    resolution: {integrity: sha512-cuOPoI7WApyhBElTTb9oqsawRvZ0rHhaHwghRLlTuffoD1B2aDemlCruLeZrUIIdvG7gs9xeELEPm6PhuASqrg==}
+
+  html-url-attributes@3.0.1:
+    resolution: {integrity: sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==}
+
   html2canvas@1.4.1:
     resolution: {integrity: sha512-fPU6BHNpsyIhr8yyMpTLLxAbkaK8ArIBcmZIRiBLiDhjeqvXolaEmDGmELFuX9I4xDcaKKcJl+TKZLqruBbmWA==}
     engines: {node: '>=8.0.0'}
@@ -8012,6 +8500,9 @@ packages:
     resolution: {integrity: sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==}
     engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
 
+  inline-style-parser@0.2.7:
+    resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==}
+
   input-format@0.3.14:
     resolution: {integrity: sha512-gHMrgrbCgmT4uK5Um5eVDUohuV9lcs95ZUUN9Px2Y0VIfjTzT2wF8Q3Z4fwLFm7c5Z2OXCm53FHoovj6SlOKdg==}
     peerDependencies:
@@ -8053,6 +8544,12 @@ packages:
     resolution: {integrity: sha512-AIbwAcazqP3R65dGvqk1V+a+vE5Fg1yu/ZKMOiBWSUIXXiwQkYmXQcVa2O0nh0tSDKDFKxG2mY7dB1Sr4hEP1g==}
     engines: {node: '>= 0.4'}
 
+  is-alphabetical@2.0.1:
+    resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
+
+  is-alphanumerical@2.0.1:
+    resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
+
   is-arguments@1.2.0:
     resolution: {integrity: sha512-7bVbi0huj/wrIAOzb8U1aszg9kdi3KN/CyU19CTI7tAoZYEZoL9yCDXpbXN+uPsuWnP02cyug1gleqq+TU+YCA==}
     engines: {node: '>= 0.4'}
@@ -8106,6 +8603,9 @@ packages:
     resolution: {integrity: sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==}
     engines: {node: '>= 0.4'}
 
+  is-decimal@2.0.1:
+    resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
   is-descriptor@0.1.8:
     resolution: {integrity: sha512-SceYGWXvdqlWa/OnQ5FQuV+NxvNmMRhMw/w9AHkH71hTzveND4BTYgvp16g+oITK47qbOl/3D0bl0iygehWAWQ==}
     engines: {node: '>= 0.4'}
@@ -8172,6 +8672,9 @@ packages:
     resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
     engines: {node: '>=0.10.0'}
 
+  is-hexadecimal@2.0.1:
+    resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
+
   is-in-ssh@1.0.0:
     resolution: {integrity: sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==}
     engines: {node: '>=20'}
@@ -8369,6 +8872,9 @@ packages:
     resolution: {integrity: sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==}
     engines: {node: '>=0.10.0'}
 
+  isomorphic.js@0.2.5:
+    resolution: {integrity: sha512-PIeMbHqMt4DnUP3MA/Flc0HElYjMXArsw1qwJZcm9sqR8mq3l8NYizFMty0pWwE/tzIGH3EKK5+jes5mAr85yw==}
+
   isstream@0.1.2:
     resolution: {integrity: sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g==}
 
@@ -8600,6 +9106,10 @@ packages:
     resolution: {integrity: sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==}
     hasBin: true
 
+  js-yaml@4.3.0:
+    resolution: {integrity: sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==}
+    hasBin: true
+
   jsbn@0.1.1:
     resolution: {integrity: sha512-UVU9dibq2JcFWxQPA6KCqj5O42VOmAY3zQUfEKxU0KpTGXwNoCjkX1e13eHNvw/xPynt6pU0rZ1htjWTNTSXsg==}
 
@@ -8745,6 +9255,19 @@ packages:
     resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==}
     engines: {node: '>= 0.8.0'}
 
+  lexical@0.48.0:
+    resolution: {integrity: sha512-KK4Tyr/cPsleoZ7XvhGRiRmcrZidSmoFUdIXK9nPubIifoC+80Dc5THyc4xtGKtsW24S1TsHzk5gmfBU+TxmEg==}
+    peerDependencies:
+      typescript: '>=5.2'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  lib0@0.2.117:
+    resolution: {integrity: sha512-DeXj9X5xDCjgKLU/7RR+/HQEVzuuEUiwldwOGsHK/sfAfELGWEyTcf0x+uOvCvK3O2zPmZePXWL85vtia6GyZw==}
+    engines: {node: '>=16'}
+    hasBin: true
+
   libphonenumber-js@1.13.6:
     resolution: {integrity: sha512-NdB6O6QvlGMCoG003m0YIKG2+Xw7DjmCZhmc1RH+K6HncADUbRf8TZeLegxBBN1VFyPHcNpPTKpIhYLXzJVy1Q==}
 
@@ -9016,6 +9539,9 @@ packages:
     resolution: {integrity: sha512-qyIh2goLt1sOgQQrrIWuwkRjUx4NUcEqEGAcYqD8VOnOC6ItwkrVE8/tA4smGpjzyp4Svhc6RodDp9IO5ghpyA==}
     engines: {node: '>=0.10.0'}
 
+  longest-streak@3.1.0:
+    resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==}
+
   loose-envify@1.4.0:
     resolution: {integrity: sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==}
     hasBin: true
@@ -9105,10 +9631,58 @@ packages:
     resolution: {integrity: sha512-4y7uGv8bd2WdM9vpQsiQNo41Ln1NvhvDRuVt0k2JZQ+ezN2uaQes7lZeZ+QQUHOLQAtDaBJ+7wCbi+ab/KFs+w==}
     engines: {node: '>=0.10.0'}
 
+  markdown-table@3.0.4:
+    resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
+
   math-intrinsics@1.1.0:
     resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
     engines: {node: '>= 0.4'}
 
+  mdast-util-directive@3.1.0:
+    resolution: {integrity: sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q==}
+
+  mdast-util-from-markdown@2.0.3:
+    resolution: {integrity: sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==}
+
+  mdast-util-frontmatter@2.0.1:
+    resolution: {integrity: sha512-LRqI9+wdgC25P0URIJY9vwocIzCcksduHQ9OF2joxQoyTNVduwLAFUzjoopuRJbJAReaKrNQKAZKL3uCMugWJA==}
+
+  mdast-util-gfm-strikethrough@2.0.0:
+    resolution: {integrity: sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==}
+
+  mdast-util-gfm-table@2.0.0:
+    resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==}
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==}
+
+  mdast-util-highlight-mark@1.2.2:
+    resolution: {integrity: sha512-OYumVoytj+B9YgwzBhBcYUCLYHIPvJtAvwnMyKhUXbfUFuER5S+FDZyu9fadUxm2TCT5fRYK3jQXh2ioWAxrMw==}
+
+  mdast-util-mdx-expression@2.0.1:
+    resolution: {integrity: sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==}
+
+  mdast-util-mdx-jsx@3.2.0:
+    resolution: {integrity: sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==}
+
+  mdast-util-mdx@3.0.0:
+    resolution: {integrity: sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==}
+
+  mdast-util-mdxjs-esm@2.0.1:
+    resolution: {integrity: sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==}
+
+  mdast-util-phrasing@4.1.0:
+    resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
+
+  mdast-util-to-hast@13.2.1:
+    resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
+
+  mdast-util-to-markdown@2.1.2:
+    resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==}
+
+  mdast-util-to-string@4.0.0:
+    resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==}
+
   mdn-data@2.0.14:
     resolution: {integrity: sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==}
 
@@ -9160,6 +9734,108 @@ packages:
     resolution: {integrity: sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==}
     engines: {node: '>= 0.6'}
 
+  micromark-core-commonmark@2.0.3:
+    resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==}
+
+  micromark-extension-directive@3.0.2:
+    resolution: {integrity: sha512-wjcXHgk+PPdmvR58Le9d7zQYWy+vKEU9Se44p2CrCDPiLr2FMyiT4Fyb5UFKFC66wGB3kPlgD7q3TnoqPS7SZA==}
+
+  micromark-extension-frontmatter@2.0.0:
+    resolution: {integrity: sha512-C4AkuM3dA58cgZha7zVnuVxBhDsbttIMiytjgsM2XbHAB2faRVaHRle40558FBN+DJcrLNCoqG5mlrpdU4cRtg==}
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==}
+
+  micromark-extension-gfm-table@2.1.1:
+    resolution: {integrity: sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==}
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==}
+
+  micromark-extension-highlight-mark@1.2.0:
+    resolution: {integrity: sha512-huGtbd/9kQsMk8u7nrVMaS5qH/47yDG6ZADggo5Owz5JoY8wdfQjfuy118/QiYNCvdFuFDbzT0A7K7Hp2cBsXA==}
+
+  micromark-extension-mdx-expression@3.0.1:
+    resolution: {integrity: sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==}
+
+  micromark-extension-mdx-jsx@3.0.2:
+    resolution: {integrity: sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==}
+
+  micromark-extension-mdx-md@2.0.0:
+    resolution: {integrity: sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==}
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    resolution: {integrity: sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==}
+
+  micromark-extension-mdxjs@3.0.0:
+    resolution: {integrity: sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==}
+
+  micromark-factory-destination@2.0.1:
+    resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
+
+  micromark-factory-label@2.0.1:
+    resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
+
+  micromark-factory-mdx-expression@2.0.3:
+    resolution: {integrity: sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==}
+
+  micromark-factory-space@2.0.1:
+    resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==}
+
+  micromark-factory-title@2.0.1:
+    resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==}
+
+  micromark-factory-whitespace@2.0.1:
+    resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==}
+
+  micromark-util-character@2.1.1:
+    resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==}
+
+  micromark-util-chunked@2.0.1:
+    resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==}
+
+  micromark-util-classify-character@2.0.1:
+    resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==}
+
+  micromark-util-combine-extensions@2.0.1:
+    resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==}
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==}
+
+  micromark-util-decode-string@2.0.1:
+    resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==}
+
+  micromark-util-encode@2.0.1:
+    resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
+
+  micromark-util-events-to-acorn@2.0.3:
+    resolution: {integrity: sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==}
+
+  micromark-util-html-tag-name@2.0.1:
+    resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
+
+  micromark-util-normalize-identifier@2.0.1:
+    resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==}
+
+  micromark-util-resolve-all@2.0.1:
+    resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==}
+
+  micromark-util-sanitize-uri@2.0.1:
+    resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==}
+
+  micromark-util-subtokenize@2.1.0:
+    resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==}
+
+  micromark-util-symbol@2.0.1:
+    resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==}
+
+  micromark-util-types@2.0.2:
+    resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==}
+
+  micromark@4.0.2:
+    resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==}
+
   micromatch@3.1.10:
     resolution: {integrity: sha512-MWikgl9n9M3w+bpsY3He8L+w9eF9338xRl8IAO5viDizwSzziFEyUzo2xrrloB64ADbTf8uA8vRqqttDTOmccg==}
     engines: {node: '>=0.10.0'}
@@ -9611,6 +10287,9 @@ packages:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
 
+  parse-entities@4.0.2:
+    resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
+
   parse-json@5.2.0:
     resolution: {integrity: sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==}
     engines: {node: '>=8'}
@@ -9969,6 +10648,9 @@ packages:
   prop-types@15.8.1:
     resolution: {integrity: sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==}
 
+  property-information@7.2.0:
+    resolution: {integrity: sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==}
+
   proxy-addr@2.0.7:
     resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==}
     engines: {node: '>= 0.10'}
@@ -10190,12 +10872,21 @@ packages:
   react-is@16.13.1:
     resolution: {integrity: sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==}
 
+  react-is@17.0.2:
+    resolution: {integrity: sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==}
+
   react-is@18.3.1:
     resolution: {integrity: sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==}
 
   react-is@19.2.7:
     resolution: {integrity: sha512-kZFnouyVv7eP/Phmrlo9FK+zcAdriZJvzxXHF1Sl1P377WSGe2G/JxVolhTrB/jeV47lKImhNUsijjHAAbcl/A==}
 
+  react-markdown@9.1.0:
+    resolution: {integrity: sha512-xaijuJB0kzGiUdG7nc2MOMDUDBWPyGAjZtUrow9XxUeua8IqeP+VlIfAZ3bphpcLTnSZXz6z9jcVC/TCwbfgdw==}
+    peerDependencies:
+      '@types/react': '>=18'
+      react: '>=18'
+
   react-number-format@5.4.5:
     resolution: {integrity: sha512-y8O2yHHj3w0aE9XO8d2BCcUOOdQTRSVq+WIuMlLVucAm5XNjJAy+BoOJiuQMldVYVOKTMyvVNfnbl2Oqp+YxGw==}
     peerDependencies:
@@ -10453,6 +11144,12 @@ packages:
     resolution: {integrity: sha512-Q5W2qeYtY9GbiR8z1yHNZ1DGhyjb4AnLEjt8iE6XfcC1QIu+FAtj3HQaO0wH28H1mX6cqNLvAqWhP402dxJGyA==}
     engines: {node: '>= 0.8.0'}
 
+  remark-parse@11.0.0:
+    resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
+
+  remark-rehype@11.1.2:
+    resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==}
+
   remarkable@1.7.4:
     resolution: {integrity: sha512-e6NKUXgX95whv7IgddywbeN/ItCkWbISmc2DiqHJb0wTrqZIexqdco5b8Z3XZoo/48IdNVKM9ZCvTPJ4F5uvhg==}
     engines: {node: '>= 0.10.0'}
@@ -10615,6 +11312,10 @@ packages:
   rxjs@7.8.2:
     resolution: {integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==}
 
+  sade@1.8.1:
+    resolution: {integrity: sha512-xal3CZX1Xlo/k4ApwCFrHVACi9fBqJ7V+mwhBsuf/1IOKbBy098Fex+Wa/5QMubw09pSZ/u8EY8PWgevJsXp1A==}
+    engines: {node: '>=6'}
+
   safe-array-concat@1.1.4:
     resolution: {integrity: sha512-wtZlHyOje6OZTGqAoaDKxFkgRtkF9CnHAVnCHKfuj200wAgL+bSJhdsCD2l0Qx/2ekEXjPWcyKkfGb5CPboslg==}
     engines: {node: '>=0.4'}
@@ -10883,6 +11584,9 @@ packages:
     resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
     engines: {node: '>= 12'}
 
+  space-separated-tokens@2.0.2:
+    resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
+
   split-on-first@1.1.0:
     resolution: {integrity: sha512-43ZssAJaMusuKWL8sKUBQXHWOpq8d6CfN/u1p4gUzfJkM05C8rxTmYrkIPTXapZpORA6LkkzcUulJ8FqA7Uudw==}
     engines: {node: '>=6'}
@@ -11018,6 +11722,9 @@ packages:
   string_decoder@1.3.0:
     resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
 
+  stringify-entities@4.0.4:
+    resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
+
   stringify-object@5.0.0:
     resolution: {integrity: sha512-zaJYxz2FtcMb4f+g60KsRNFOpVMUyuJgA51Zi5Z1DOTC3S59+OQiVOzE9GZt0x72uBGWKsQIuBKeF9iusmKFsg==}
     engines: {node: '>=14.16'}
@@ -11072,9 +11779,18 @@ packages:
     resolution: {integrity: sha512-mKX8HA/cdBqMKUr0MMZAFssCkIGoZeSCMXgnt79yKxNFguMLVFgRe6wB+fsL0NmoHDbeyZXczy7vEPSoo3rkzg==}
     engines: {node: '>=16'}
 
+  style-mod@4.1.3:
+    resolution: {integrity: sha512-i/n8VsZydrugj3Iuzll8+x/00GH2vnYsk1eomD8QiRrSAeW6ItbCQDtfXCeJHd0iwiNagqjQkvpvREEPtW3IoQ==}
+
   style-object-to-css-string@1.1.3:
     resolution: {integrity: sha512-bISQoUsir/qGfo7vY8rw00ia9nnyE1jvYt3zZ2jhdkcXZ6dAEi74inMzQ6On57vFI+I4Fck6wOv5UI9BEwJDgw==}
 
+  style-to-js@1.1.21:
+    resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==}
+
+  style-to-object@1.0.14:
+    resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
+
   styled-components@5.3.11:
     resolution: {integrity: sha512-uuzIIfnVkagcVHv9nE0VPlHPSCmXIUGKfJ42LNjxCCTDTL5sgnJ8Z7GZBq0EnLYGln77tPpEpExt2+qa+cZqSw==}
     engines: {node: '>=10'}
@@ -11421,6 +12137,12 @@ packages:
   trim-canvas@0.1.2:
     resolution: {integrity: sha512-nd4Ga3iLFV94mdhW9JFMLpQbHUyCQuhFOD71PEAt1NjtMD5wbZctzhX8c3agHNybMR5zXD1XTGoIEWk995E6pQ==}
 
+  trim-lines@3.0.1:
+    resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
+
+  trough@2.2.0:
+    resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
+
   ts-api-utils@2.5.0:
     resolution: {integrity: sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==}
     engines: {node: '>=18.12'}
@@ -11682,10 +12404,34 @@ packages:
     resolution: {integrity: sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==}
     engines: {node: '>=18'}
 
+  unidiff@1.0.4:
+    resolution: {integrity: sha512-ynU0vsAXw0ir8roa+xPCUHmnJ5goc5BTM2Kuc3IJd8UwgaeRs7VSD5+eeaQL+xp1JtB92hu/Zy/Lgy7RZcr1pQ==}
+
+  unified@11.0.5:
+    resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
+
   union-value@1.0.1:
     resolution: {integrity: sha512-tJfXmxMeWYnczCVs7XAEvIV7ieppALdyepWMkHkwciRpZraG/xwT+s2JN8+pr1+8jCRf80FFzvr+MpQeeoF4Xg==}
     engines: {node: '>=0.10.0'}
 
+  unist-util-is@6.0.1:
+    resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
+
+  unist-util-position-from-estree@2.0.0:
+    resolution: {integrity: sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==}
+
+  unist-util-position@5.0.0:
+    resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
+
+  unist-util-stringify-position@4.0.0:
+    resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
+
+  unist-util-visit-parents@6.0.2:
+    resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
+
+  unist-util-visit@5.1.0:
+    resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
+
   universal-cookie@8.1.2:
     resolution: {integrity: sha512-kcKzTGNsxVytujrYOvQbvh//QyFrA53HrzCGyzh6i9ujCww5gfPrLK0tG+jJD40SIIldiEjBNPPSR8fBMS21GA==}
 
@@ -11826,6 +12572,11 @@ packages:
     deprecated: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).
     hasBin: true
 
+  uvu@0.5.6:
+    resolution: {integrity: sha512-+g8ENReyr8YsOc6fv/NVJs2vFdHBnBNdfE49rshrTzDWOlUx4Gq7KOS2GD8eqhy2j+Ejq29+SbKH8yjkAqXqoA==}
+    engines: {node: '>=8'}
+    hasBin: true
+
   v8-compile-cache-lib@3.0.1:
     resolution: {integrity: sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==}
 
@@ -11855,6 +12606,12 @@ packages:
     resolution: {integrity: sha512-ZZKSmDAEFOijERBLkmYfJ+vmk3w+7hOLYDNkRCuRuMJGEmqYNCNLyBBFwWKVMhfwaEF3WOd0Zlw86U/WC/+nYw==}
     engines: {'0': node >=0.6.0}
 
+  vfile-message@4.0.3:
+    resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+  vfile@6.0.3:
+    resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
   victory-vendor@36.9.2:
     resolution: {integrity: sha512-PnpQQMuxlwYdocC8fIJqVXvkeViHYzotI+NJrCuav0ZYFoq912ZHBk3mCeuj+5/VpodOjPe1z0Fk2ihgzlXqjQ==}
 
@@ -11934,6 +12691,9 @@ packages:
     resolution: {integrity: sha512-lYEhd75l75P3D1LKpm4KqdOSpNyNdDJ9ixEZmC5ZAZUKGy6JNexfMdQ9SNaT5pCHuzuXXRJQedJ+CdqNg/D4Kw==}
     engines: {iojs: '>= 1.0.0', node: '>= 0.10.0'}
 
+  w3c-keyname@2.2.8:
+    resolution: {integrity: sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==}
+
   w3c-xmlserializer@5.0.0:
     resolution: {integrity: sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==}
     engines: {node: '>=18'}
@@ -12192,6 +12952,10 @@ packages:
     resolution: {integrity: sha512-9GnJUZ0QM4OgXuOzsKNzTJ5EOkums1Xc+3YQXp+Q+UxFjf7zLucp9dQ8QMIft0Szs1E1hUiXFim1OYfEKFq97w==}
     engines: {node: '>=0.8'}
 
+  yjs@13.6.32:
+    resolution: {integrity: sha512-lfiJIIC4Xayt5ItynE407ehlE03pCjeOc4hkR4yxxvvNJ4kuiN25B0g+Qp8XagYz361LLL7DCzR5bvFJ81QKtQ==}
+    engines: {node: '>=16.0.0', npm: '>=8.0.0'}
+
   yn@3.1.1:
     resolution: {integrity: sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==}
     engines: {node: '>=6'}
@@ -12252,6 +13016,9 @@ packages:
       use-sync-external-store:
         optional: true
 
+  zwitch@2.0.4:
+    resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
+
 snapshots:
 
   '@alloc/quick-lru@5.2.0': {}
@@ -12314,11 +13081,11 @@ snapshots:
       '@babel/helpers': 7.29.7
       '@babel/parser': 7.29.7
       '@babel/template': 7.29.7
-      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7
       '@babel/types': 7.29.7
       '@jridgewell/remapping': 2.3.5
       convert-source-map: 2.0.0
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       gensync: 1.0.0-beta.2
       json5: 2.2.3
       semver: 6.3.1
@@ -12353,7 +13120,7 @@ snapshots:
       '@babel/helper-optimise-call-expression': 7.29.7
       '@babel/helper-replace-supers': 7.29.7(@babel/core@7.29.7)
       '@babel/helper-skip-transparent-expression-wrappers': 7.29.7
-      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7
       semver: 6.3.1
     transitivePeerDependencies:
       - supports-color
@@ -12362,7 +13129,14 @@ snapshots:
 
   '@babel/helper-member-expression-to-functions@7.29.7':
     dependencies:
-      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7
+      '@babel/types': 7.29.7
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-module-imports@7.29.7':
+    dependencies:
+      '@babel/traverse': 7.29.7
       '@babel/types': 7.29.7
     transitivePeerDependencies:
       - supports-color
@@ -12377,9 +13151,9 @@ snapshots:
   '@babel/helper-module-transforms@7.29.7(@babel/core@7.29.7)':
     dependencies:
       '@babel/core': 7.29.7
-      '@babel/helper-module-imports': 7.29.7(supports-color@5.5.0)
+      '@babel/helper-module-imports': 7.29.7
       '@babel/helper-validator-identifier': 7.29.7
-      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7
     transitivePeerDependencies:
       - supports-color
 
@@ -12394,13 +13168,13 @@ snapshots:
       '@babel/core': 7.29.7
       '@babel/helper-member-expression-to-functions': 7.29.7
       '@babel/helper-optimise-call-expression': 7.29.7
-      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7
     transitivePeerDependencies:
       - supports-color
 
   '@babel/helper-skip-transparent-expression-wrappers@7.29.7':
     dependencies:
-      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7
       '@babel/types': 7.29.7
     transitivePeerDependencies:
       - supports-color
@@ -12553,6 +13327,18 @@ snapshots:
       '@babel/parser': 7.29.7
       '@babel/types': 7.29.7
 
+  '@babel/traverse@7.29.7':
+    dependencies:
+      '@babel/code-frame': 7.29.7
+      '@babel/generator': 7.29.7
+      '@babel/helper-globals': 7.29.7
+      '@babel/parser': 7.29.7
+      '@babel/template': 7.29.7
+      '@babel/types': 7.29.7
+      debug: 4.4.3(supports-color@8.1.1)
+    transitivePeerDependencies:
+      - supports-color
+
   '@babel/traverse@7.29.7(supports-color@5.5.0)':
     dependencies:
       '@babel/code-frame': 7.29.7
@@ -12574,6 +13360,265 @@ snapshots:
 
   '@borewit/text-codec@0.2.2': {}
 
+  '@codemirror/autocomplete@6.20.3':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+
+  '@codemirror/commands@6.10.4':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+
+  '@codemirror/lang-angular@0.1.4':
+    dependencies:
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/lang-javascript': 6.2.5
+      '@codemirror/language': 6.12.4
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-cpp@6.0.3':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@lezer/cpp': 1.1.6
+
+  '@codemirror/lang-css@6.3.1':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/css': 1.3.6
+
+  '@codemirror/lang-go@6.0.1':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/go': 1.0.1
+
+  '@codemirror/lang-html@6.4.12':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/lang-css': 6.3.1
+      '@codemirror/lang-javascript': 6.2.5
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/css': 1.3.6
+      '@lezer/html': 1.3.13
+
+  '@codemirror/lang-java@6.0.2':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@lezer/java': 1.1.3
+
+  '@codemirror/lang-javascript@6.2.5':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/lint': 6.9.7
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/javascript': 1.5.4
+
+  '@codemirror/lang-jinja@6.0.1':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-json@6.0.2':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@lezer/json': 1.0.3
+
+  '@codemirror/lang-less@6.0.2':
+    dependencies:
+      '@codemirror/lang-css': 6.3.1
+      '@codemirror/language': 6.12.4
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-liquid@6.3.2':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-markdown@6.5.2':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/markdown': 1.7.2
+
+  '@codemirror/lang-php@6.0.2':
+    dependencies:
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/php': 1.0.5
+
+  '@codemirror/lang-python@6.2.1':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/python': 1.1.19
+
+  '@codemirror/lang-rust@6.0.2':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@lezer/rust': 1.0.2
+
+  '@codemirror/lang-sass@6.0.2':
+    dependencies:
+      '@codemirror/lang-css': 6.3.1
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/sass': 1.1.0
+
+  '@codemirror/lang-sql@6.10.0':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-vue@0.1.3':
+    dependencies:
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/lang-javascript': 6.2.5
+      '@codemirror/language': 6.12.4
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-wast@6.0.2':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@codemirror/lang-xml@6.1.0':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/xml': 1.0.6
+
+  '@codemirror/lang-yaml@6.1.3':
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+      '@lezer/yaml': 1.0.4
+
+  '@codemirror/language-data@6.5.2':
+    dependencies:
+      '@codemirror/lang-angular': 0.1.4
+      '@codemirror/lang-cpp': 6.0.3
+      '@codemirror/lang-css': 6.3.1
+      '@codemirror/lang-go': 6.0.1
+      '@codemirror/lang-html': 6.4.12
+      '@codemirror/lang-java': 6.0.2
+      '@codemirror/lang-javascript': 6.2.5
+      '@codemirror/lang-jinja': 6.0.1
+      '@codemirror/lang-json': 6.0.2
+      '@codemirror/lang-less': 6.0.2
+      '@codemirror/lang-liquid': 6.3.2
+      '@codemirror/lang-markdown': 6.5.2
+      '@codemirror/lang-php': 6.0.2
+      '@codemirror/lang-python': 6.2.1
+      '@codemirror/lang-rust': 6.0.2
+      '@codemirror/lang-sass': 6.0.2
+      '@codemirror/lang-sql': 6.10.0
+      '@codemirror/lang-vue': 0.1.3
+      '@codemirror/lang-wast': 6.0.2
+      '@codemirror/lang-xml': 6.1.0
+      '@codemirror/lang-yaml': 6.1.3
+      '@codemirror/language': 6.12.4
+      '@codemirror/legacy-modes': 6.5.3
+
+  '@codemirror/language@6.12.4':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+      style-mod: 4.1.3
+
+  '@codemirror/legacy-modes@6.5.3':
+    dependencies:
+      '@codemirror/language': 6.12.4
+
+  '@codemirror/lint@6.9.7':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      crelt: 1.0.7
+
+  '@codemirror/merge@6.12.2':
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/highlight': 1.2.3
+      style-mod: 4.1.3
+
+  '@codemirror/search@6.7.1':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      crelt: 1.0.7
+
+  '@codemirror/state@6.7.1':
+    dependencies:
+      '@marijn/find-cluster-break': 1.0.3
+
+  '@codemirror/view@6.43.8':
+    dependencies:
+      '@codemirror/state': 6.7.1
+      crelt: 1.0.7
+      style-mod: 4.1.3
+      w3c-keyname: 2.2.8
+
   '@colors/colors@1.5.0':
     optional: true
 
@@ -12778,7 +13823,7 @@ snapshots:
 
   '@emotion/babel-plugin@11.13.5':
     dependencies:
-      '@babel/helper-module-imports': 7.29.7(supports-color@5.5.0)
+      '@babel/helper-module-imports': 7.29.7
       '@babel/runtime': 7.29.7
       '@emotion/hash': 0.9.2
       '@emotion/memoize': 0.9.0
@@ -12944,7 +13989,7 @@ snapshots:
   '@eslint/eslintrc@2.1.4':
     dependencies:
       ajv: 6.15.0
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       espree: 9.6.1
       globals: 13.24.0
       ignore: 5.3.2
@@ -13104,7 +14149,7 @@ snapshots:
   '@humanwhocodes/config-array@0.13.0':
     dependencies:
       '@humanwhocodes/object-schema': 2.0.3
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       minimatch: 3.1.5
     transitivePeerDependencies:
       - supports-color
@@ -13516,6 +14561,329 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
+  '@lexical/a11y@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/clipboard@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/list': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      '@types/trusted-types': 2.0.7
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/code-core@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/devtools-core@0.48.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)':
+    dependencies:
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/link': 0.48.0(typescript@5.9.3)
+      '@lexical/mark': 0.48.0(typescript@5.9.3)
+      '@lexical/table': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+      react: 19.2.6
+      react-dom: 19.2.6(react@19.2.6)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/dragon@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/extension@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      '@preact/signals-core': 1.14.4
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/hashtag@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/text': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/history@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/html@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/internal@0.48.0(typescript@5.9.3)':
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/link@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/list@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/mark@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/markdown@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/code-core': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/link': 0.48.0(typescript@5.9.3)
+      '@lexical/list': 0.48.0(typescript@5.9.3)
+      '@lexical/rich-text': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      '@lexical/text': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/overflow@0.48.0(typescript@5.9.3)':
+    dependencies:
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/plain-text@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/clipboard': 0.48.0(typescript@5.9.3)
+      '@lexical/dragon': 0.48.0(typescript@5.9.3)
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/react@0.48.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)(yjs@13.6.32)':
+    dependencies:
+      '@floating-ui/react': 0.27.19(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@lexical/a11y': 0.48.0(typescript@5.9.3)
+      '@lexical/devtools-core': 0.48.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)
+      '@lexical/dragon': 0.48.0(typescript@5.9.3)
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/hashtag': 0.48.0(typescript@5.9.3)
+      '@lexical/history': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/link': 0.48.0(typescript@5.9.3)
+      '@lexical/list': 0.48.0(typescript@5.9.3)
+      '@lexical/mark': 0.48.0(typescript@5.9.3)
+      '@lexical/markdown': 0.48.0(typescript@5.9.3)
+      '@lexical/overflow': 0.48.0(typescript@5.9.3)
+      '@lexical/plain-text': 0.48.0(typescript@5.9.3)
+      '@lexical/rich-text': 0.48.0(typescript@5.9.3)
+      '@lexical/table': 0.48.0(typescript@5.9.3)
+      '@lexical/text': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      '@lexical/yjs': 0.48.0(typescript@5.9.3)(yjs@13.6.32)
+      lexical: 0.48.0(typescript@5.9.3)
+      react: 19.2.6
+      react-dom: 19.2.6(react@19.2.6)
+    optionalDependencies:
+      typescript: 5.9.3
+      yjs: 13.6.32
+
+  '@lexical/rich-text@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/clipboard': 0.48.0(typescript@5.9.3)
+      '@lexical/dragon': 0.48.0(typescript@5.9.3)
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/selection@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/table@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/clipboard': 0.48.0(typescript@5.9.3)
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/html': 0.48.0(typescript@5.9.3)
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/text@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/utils@0.48.0(typescript@5.9.3)':
+    dependencies:
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lexical/yjs@0.48.0(typescript@5.9.3)(yjs@13.6.32)':
+    dependencies:
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      lexical: 0.48.0(typescript@5.9.3)
+      yjs: 13.6.32
+    optionalDependencies:
+      typescript: 5.9.3
+
+  '@lezer/common@1.5.2': {}
+
+  '@lezer/cpp@1.1.6':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/css@1.3.6':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/go@1.0.1':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/highlight@1.2.3':
+    dependencies:
+      '@lezer/common': 1.5.2
+
+  '@lezer/html@1.3.13':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/java@1.1.3':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/javascript@1.5.4':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/json@1.0.3':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/lr@1.4.10':
+    dependencies:
+      '@lezer/common': 1.5.2
+
+  '@lezer/markdown@1.7.2':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+
+  '@lezer/php@1.0.5':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/python@1.1.19':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/rust@1.0.2':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/sass@1.1.0':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/xml@1.0.6':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
+  '@lezer/yaml@1.0.4':
+    dependencies:
+      '@lezer/common': 1.5.2
+      '@lezer/highlight': 1.2.3
+      '@lezer/lr': 1.4.10
+
   '@lottiefiles/react-lottie-player@3.6.0(react@19.2.6)':
     dependencies:
       lottie-web: 5.13.0
@@ -13640,6 +15008,83 @@ snapshots:
     dependencies:
       react: 19.2.6
 
+  '@marijn/find-cluster-break@1.0.3': {}
+
+  '@mdxeditor/editor@4.2.0(@codemirror/language@6.12.4)(@lezer/highlight@1.2.3)(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)(yjs@13.6.32)':
+    dependencies:
+      '@codemirror/commands': 6.10.4
+      '@codemirror/lang-markdown': 6.5.2
+      '@codemirror/language-data': 6.5.2
+      '@codemirror/merge': 6.12.2
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lexical/clipboard': 0.48.0(typescript@5.9.3)
+      '@lexical/extension': 0.48.0(typescript@5.9.3)
+      '@lexical/history': 0.48.0(typescript@5.9.3)
+      '@lexical/link': 0.48.0(typescript@5.9.3)
+      '@lexical/list': 0.48.0(typescript@5.9.3)
+      '@lexical/markdown': 0.48.0(typescript@5.9.3)
+      '@lexical/plain-text': 0.48.0(typescript@5.9.3)
+      '@lexical/react': 0.48.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)(yjs@13.6.32)
+      '@lexical/rich-text': 0.48.0(typescript@5.9.3)
+      '@lexical/selection': 0.48.0(typescript@5.9.3)
+      '@lexical/utils': 0.48.0(typescript@5.9.3)
+      '@mdxeditor/gurx': 1.2.4(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/colors': 3.0.0
+      '@radix-ui/react-dialog': 1.1.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-icons': 1.3.2(react@19.2.6)
+      '@radix-ui/react-popover': 1.1.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-popper': 1.3.0(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-select': 2.3.0(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-toggle-group': 1.1.12(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-toolbar': 1.1.12(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-tooltip': 1.2.9(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      classnames: 2.5.1
+      cm6-theme-basic-light: 0.2.0(@codemirror/language@6.12.4)(@codemirror/state@6.7.1)(@codemirror/view@6.43.8)(@lezer/highlight@1.2.3)
+      codemirror: 6.0.2
+      downshift: 7.6.2(react@19.2.6)
+      js-yaml: 4.3.0
+      lexical: 0.48.0(typescript@5.9.3)
+      mdast-util-directive: 3.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-frontmatter: 2.0.1
+      mdast-util-gfm-strikethrough: 2.0.0
+      mdast-util-gfm-table: 2.0.0
+      mdast-util-gfm-task-list-item: 2.0.0
+      mdast-util-highlight-mark: 1.2.2
+      mdast-util-mdx: 3.0.0
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-to-markdown: 2.1.2
+      micromark-extension-directive: 3.0.2
+      micromark-extension-frontmatter: 2.0.0
+      micromark-extension-gfm-strikethrough: 2.1.0
+      micromark-extension-gfm-table: 2.1.1
+      micromark-extension-gfm-task-list-item: 2.1.0
+      micromark-extension-highlight-mark: 1.2.0
+      micromark-extension-mdx-jsx: 3.0.2
+      micromark-extension-mdx-md: 2.0.0
+      micromark-extension-mdxjs: 3.0.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      react: 19.2.6
+      react-dom: 19.2.6(react@19.2.6)
+      react-hook-form: 7.77.0(react@19.2.6)
+      unidiff: 1.0.4
+    transitivePeerDependencies:
+      - '@codemirror/language'
+      - '@lezer/highlight'
+      - '@types/react'
+      - '@types/react-dom'
+      - supports-color
+      - typescript
+      - yjs
+
+  '@mdxeditor/gurx@1.2.4(react-dom@19.2.6(react@19.2.6))(react@19.2.6)':
+    dependencies:
+      react: 19.2.6
+      react-dom: 19.2.6(react@19.2.6)
+
   '@microsoft/tsdoc@0.15.1': {}
 
   '@microsoft/tsdoc@0.16.0': {}
@@ -14264,6 +15709,8 @@ snapshots:
 
   '@posthog/types@1.394.0': {}
 
+  '@preact/signals-core@1.14.4': {}
+
   '@prisma/client@6.19.3(prisma@6.19.3(typescript@5.9.3))(typescript@5.9.3)':
     optionalDependencies:
       prisma: 6.19.3(typescript@5.9.3)
@@ -14301,7 +15748,7 @@ snapshots:
 
   '@puppeteer/browsers@2.13.2':
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       extract-zip: 2.0.1
       progress: 2.0.3
       proxy-agent: 6.5.0
@@ -14314,6 +15761,8 @@ snapshots:
       - react-native-b4a
       - supports-color
 
+  '@radix-ui/colors@3.0.0': {}
+
   '@radix-ui/number@1.1.2': {}
 
   '@radix-ui/primitive@1.1.4': {}
@@ -14806,6 +16255,10 @@ snapshots:
       '@types/react': 18.3.31
       '@types/react-dom': 18.3.7(@types/react@18.3.31)
 
+  '@radix-ui/react-icons@1.3.2(react@19.2.6)':
+    dependencies:
+      react: 19.2.6
+
   '@radix-ui/react-id@1.1.2(@types/react@18.3.31)(react@18.3.1)':
     dependencies:
       '@radix-ui/react-use-layout-effect': 1.1.2(@types/react@18.3.31)(react@18.3.1)
@@ -16369,7 +17822,7 @@ snapshots:
 
   '@tokenizer/inflate@0.4.1':
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       token-types: 6.1.2
     transitivePeerDependencies:
       - supports-color
@@ -16464,19 +17917,7 @@ snapshots:
       - debug
       - supports-color
 
-  '@tria-plc/auditlog@file:local-packages/tria-plc-auditlog-1.1.2.tgz(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(@nestjs/microservices@11.1.24)(@nestjs/swagger@11.4.4(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2))(@nestjs/typeorm@11.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3))))(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3)))':
-    dependencies:
-      '@nestjs/common': 11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2)
-      '@nestjs/core': 11.1.24(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/microservices@11.1.24)(@nestjs/platform-express@11.1.24)(@nestjs/websockets@11.1.27)(reflect-metadata@0.2.2)(rxjs@7.8.2)
-      '@nestjs/microservices': 11.1.24(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(@nestjs/websockets@11.1.27)(amqp-connection-manager@5.0.0(amqplib@2.0.1))(amqplib@2.0.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)
-      '@nestjs/swagger': 11.4.4(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)
-      '@nestjs/typeorm': 11.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3)))
-      amqp-connection-manager: 5.0.0(amqplib@0.10.9)
-      amqplib: 0.10.9
-      rxjs: 7.8.2
-      typeorm: 0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3))
-
-  '@tria-plc/iamapi-common@file:local-packages/tria-plc-iamapi-common-1.0.0.tgz(cc085a020c559b355f168432c579a024)':
+  '@tria-plc/iamapi-common@file:local-packages/tria-plc-iamapi-common-1.0.0.tgz(d0be280d95adfc1b38e59bdc80c5dec5)':
     dependencies:
       '@nestjs/axios': 4.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(axios@1.17.0)(rxjs@7.8.2)
       '@nestjs/common': 11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2)
@@ -16484,10 +17925,10 @@ snapshots:
       '@nestjs/jwt': 11.0.2(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))
       '@nestjs/microservices': 11.1.24(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(@nestjs/websockets@11.1.27)(amqp-connection-manager@5.0.0(amqplib@2.0.1))(amqplib@2.0.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)
       '@nestjs/passport': 10.0.3(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(passport@0.7.0)
-      '@nestjs/swagger': 7.4.2(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)
+      '@nestjs/swagger': 11.4.4(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)
       '@nestjs/throttler': 6.5.0(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)
       '@nestjs/typeorm': 11.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3)))
-      '@tria-plc/api-common': file:local-packages/tria-plc-api-common-1.6.0.tgz(2b4e99ab22f78c34e7861d649f4ff29b)
+      '@tria-plc/api-common': file:local-packages/tria-plc-api-common-1.6.0.tgz(ae9a56cc1c6d93629dd85f7605ccd5b6)
       argon2: 0.43.1
       axios: 1.17.0
       class-transformer: 0.5.1
@@ -16510,7 +17951,7 @@ snapshots:
       - '@faker-js/faker'
       - supports-color
 
-  '@tria-plc/iamapi-common@file:local-packages/tria-plc-iamapi-common-1.0.0.tgz(d0be280d95adfc1b38e59bdc80c5dec5)':
+  '@tria-plc/iamapi-common@file:local-packages/tria-plc-iamapi-common-1.1.0.tgz(cc085a020c559b355f168432c579a024)':
     dependencies:
       '@nestjs/axios': 4.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(axios@1.17.0)(rxjs@7.8.2)
       '@nestjs/common': 11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2)
@@ -16518,10 +17959,10 @@ snapshots:
       '@nestjs/jwt': 11.0.2(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))
       '@nestjs/microservices': 11.1.24(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(@nestjs/websockets@11.1.27)(amqp-connection-manager@5.0.0(amqplib@2.0.1))(amqplib@2.0.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)
       '@nestjs/passport': 10.0.3(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(passport@0.7.0)
-      '@nestjs/swagger': 11.4.4(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)
+      '@nestjs/swagger': 7.4.2(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)
       '@nestjs/throttler': 6.5.0(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)
       '@nestjs/typeorm': 11.0.1(@nestjs/common@11.1.24(class-transformer@0.5.1)(class-validator@0.14.4)(reflect-metadata@0.2.2)(rxjs@7.8.2))(@nestjs/core@11.1.24)(reflect-metadata@0.2.2)(rxjs@7.8.2)(typeorm@0.3.30(babel-plugin-macros@3.1.0)(pg@8.21.0)(ts-node@10.9.2(@types/node@20.19.42)(typescript@5.9.3)))
-      '@tria-plc/api-common': file:local-packages/tria-plc-api-common-1.6.0.tgz(ae9a56cc1c6d93629dd85f7605ccd5b6)
+      '@tria-plc/api-common': file:local-packages/tria-plc-api-common-1.6.0.tgz(2b4e99ab22f78c34e7861d649f4ff29b)
       argon2: 0.43.1
       axios: 1.17.0
       class-transformer: 0.5.1
@@ -16668,6 +18109,130 @@ snapshots:
       - utf-8-validate
       - vite
 
+  '@tria-plc/iamui@file:local-packages/tria-plc-iamui-0.1.1.tgz(a5d0bdee55164ae56064fb273b530e00)':
+    dependencies:
+      '@emotion/react': 11.14.0(@types/react@18.3.31)(react@19.2.6)
+      '@emotion/styled': 11.14.1(@emotion/react@11.14.0(@types/react@18.3.31)(react@19.2.6))(@types/react@18.3.31)(react@19.2.6)
+      '@hookform/resolvers': 5.4.0(react-hook-form@7.77.0(react@19.2.6))
+      '@lottiefiles/react-lottie-player': 3.6.0(react@19.2.6)
+      '@mantine/charts': 7.17.8(@mantine/core@7.17.8(@mantine/hooks@7.17.8(react@19.2.6))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6))(@mantine/hooks@7.17.8(react@19.2.6))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(recharts@3.8.1(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6)(redux@5.0.1))
+      '@mantine/core': 7.17.8(@mantine/hooks@7.17.8(react@19.2.6))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@mantine/dates': 7.17.8(@mantine/core@7.17.8(@mantine/hooks@7.17.8(react@19.2.6))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6))(@mantine/hooks@7.17.8(react@19.2.6))(dayjs@1.11.21)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@mantine/hooks': 7.17.8(react@19.2.6)
+      '@mantine/notifications': 7.17.8(@mantine/core@7.17.8(@mantine/hooks@7.17.8(react@19.2.6))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6))(@mantine/hooks@7.17.8(react@19.2.6))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-accordion': 1.2.13(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-alert-dialog': 1.1.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-avatar': 1.1.12(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-checkbox': 1.3.4(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-collapsible': 1.1.13(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-context-menu': 2.3.0(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-dialog': 1.1.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-dropdown-menu': 2.1.17(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-hover-card': 1.1.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-label': 2.1.9(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-navigation-menu': 1.2.15(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-popover': 1.1.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-progress': 1.1.9(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-radio-group': 1.4.0(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-scroll-area': 1.2.11(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-select': 2.3.0(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-separator': 1.1.9(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-slot': 1.2.5(@types/react@18.3.31)(react@19.2.6)
+      '@radix-ui/react-switch': 1.3.0(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-tabs': 1.1.14(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-toast': 1.2.16(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@radix-ui/react-tooltip': 1.2.9(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@react-pdf-viewer/core': 3.12.0(pdfjs-dist@5.4.296)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@react-pdf-viewer/default-layout': 3.12.0(pdfjs-dist@5.4.296)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@react-pdf/renderer': 4.5.1(react@19.2.6)
+      '@reduxjs/toolkit': 2.12.0(react-redux@9.3.0(@types/react@18.3.31)(react@19.2.6)(redux@5.0.1))(react@19.2.6)
+      '@tabler/icons-react': 3.44.0(react@19.2.6)
+      '@tailwindcss/vite': 4.3.0(vite@5.4.21(@types/node@24.13.1)(lightningcss@1.32.0)(terser@5.48.0))
+      '@tanstack/react-query': 5.101.0(react@19.2.6)
+      '@tanstack/react-query-devtools': 5.101.0(@tanstack/react-query@5.101.0(react@19.2.6))(react@19.2.6)
+      '@tanstack/react-table': 8.21.3(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      '@tinymce/tinymce-react': 6.3.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(tinymce@7.9.3)
+      '@types/dompurify': 3.2.0
+      '@types/node': 24.13.1
+      '@types/tinymce': 4.6.9
+      axios: 1.17.0
+      class-variance-authority: 0.7.1
+      clsx: 2.1.1
+      cmdk: 1.1.1(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      date-fns: 3.6.0
+      dayjs: 1.11.21
+      dompurify: 3.4.8
+      ethiopian-calendar-date-converter: 2.1.6
+      ethiopian-calendar-new: 1.1.0
+      file-type: 18.7.0
+      framer-motion: 12.40.0(@emotion/is-prop-valid@1.4.0)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      html2canvas: 1.4.1
+      i18next: 25.10.10(typescript@5.9.3)
+      i18next-browser-languagedetector: 8.2.1
+      jquery: 3.7.1
+      js-cookie: 3.0.8
+      jspdf: 3.0.4
+      lodash: 4.18.1
+      lucide-react: 0.513.0(react@19.2.6)
+      mantine-react-table: 2.0.0-beta.9(@mantine/core@7.17.8(@mantine/hooks@7.17.8(react@19.2.6))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6))(@mantine/dates@7.17.8(@mantine/core@7.17.8(@mantine/hooks@7.17.8(react@19.2.6))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6))(@mantine/hooks@7.17.8(react@19.2.6))(dayjs@1.11.21)(react-dom@19.2.6(react@19.2.6))(react@19.2.6))(@mantine/hooks@7.17.8(react@19.2.6))(@tabler/icons-react@3.44.0(react@19.2.6))(clsx@2.1.1)(dayjs@1.11.21)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      mui-ethiopian-datepicker: 0.3.2(4b3af212eafdf0059f009b005d7e343d)
+      next-themes: 0.4.6(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      path: 0.12.7
+      pdf-lib: 1.17.1
+      qs: 6.15.2
+      react: 19.2.6
+      react-cookie: 8.1.2(@types/react@18.3.31)(react@19.2.6)
+      react-css-nocode-editor: 1.0.13(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6)
+      react-day-picker: 8.10.2(date-fns@3.6.0)(react@19.2.6)
+      react-dom: 19.2.6(react@19.2.6)
+      react-dropzone: 14.4.1(react@19.2.6)
+      react-hook-form: 7.77.0(react@19.2.6)
+      react-i18next: 15.7.4(i18next@25.10.10(typescript@5.9.3))(react-dom@19.2.6(react@19.2.6))(react@19.2.6)(typescript@5.9.3)
+      react-icons: 5.6.0(react@19.2.6)
+      react-image-crop: 11.0.10(react@19.2.6)
+      react-intersection-observer: 9.16.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      react-pdf: 10.4.1(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      react-pdf-html: 2.1.5(@react-pdf/renderer@4.5.1(react@19.2.6))(react@19.2.6)
+      react-redux: 9.3.0(@types/react@18.3.31)(react@19.2.6)(redux@5.0.1)
+      react-resizable-panels: 3.0.6(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      react-router-dom: 7.17.0(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      react-signature-canvas: 1.1.0-alpha.2(@types/prop-types@15.7.15)(@types/react@18.3.31)(prop-types@15.8.1)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      recharts: 3.8.1(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6)(redux@5.0.1)
+      rollup-plugin-visualizer: 7.0.1(rollup@4.61.1)
+      socket.io-client: 4.8.3
+      sonner: 2.0.7(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      tailwind-merge: 3.6.0
+      tailwind-scrollbar-hide: 4.0.0(tailwindcss@4.3.0)
+      tailwindcss: 4.3.0
+      tailwindcss-animate: 1.0.7(tailwindcss@4.3.0)
+      tinymce: 7.9.3
+      url: 0.11.4
+      vaul: 1.1.2(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6)
+      xlsx: 0.18.5
+      zod: 3.25.76
+    transitivePeerDependencies:
+      - '@babel/core'
+      - '@emotion/is-prop-valid'
+      - '@mui/icons-material'
+      - '@mui/material'
+      - '@mui/x-date-pickers'
+      - '@types/prop-types'
+      - '@types/react'
+      - '@types/react-dom'
+      - bufferutil
+      - debug
+      - pdfjs-dist
+      - prop-types
+      - react-is
+      - react-native
+      - redux
+      - rolldown
+      - rollup
+      - supports-color
+      - typescript
+      - utf-8-validate
+      - vite
+
   '@ts-morph/common@0.27.0':
     dependencies:
       fast-glob: 3.3.3
@@ -16779,6 +18344,10 @@ snapshots:
 
   '@types/d3-timer@3.0.2': {}
 
+  '@types/debug@4.1.13':
+    dependencies:
+      '@types/ms': 2.1.0
+
   '@types/dompurify@3.2.0':
     dependencies:
       dompurify: 3.4.8
@@ -16793,6 +18362,10 @@ snapshots:
       '@types/estree': 1.0.9
       '@types/json-schema': 7.0.15
 
+  '@types/estree-jsx@1.0.5':
+    dependencies:
+      '@types/estree': 1.0.9
+
   '@types/estree@1.0.9': {}
 
   '@types/express-serve-static-core@4.19.8':
@@ -16828,6 +18401,10 @@ snapshots:
     dependencies:
       '@types/node': 20.19.42
 
+  '@types/hast@3.0.5':
+    dependencies:
+      '@types/unist': 3.0.3
+
   '@types/hoist-non-react-statics@3.3.7(@types/react@18.3.31)':
     dependencies:
       '@types/react': 18.3.31
@@ -16871,6 +18448,10 @@ snapshots:
 
   '@types/luxon@3.7.1': {}
 
+  '@types/mdast@4.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
   '@types/methods@1.1.4': {}
 
   '@types/mime@1.3.5': {}
@@ -16994,8 +18575,11 @@ snapshots:
 
   '@types/tmp@0.2.6': {}
 
-  '@types/trusted-types@2.0.7':
-    optional: true
+  '@types/trusted-types@2.0.7': {}
+
+  '@types/unist@2.0.11': {}
+
+  '@types/unist@3.0.3': {}
 
   '@types/use-sync-external-store@0.0.6': {}
 
@@ -17046,7 +18630,7 @@ snapshots:
       '@typescript-eslint/types': 8.60.1
       '@typescript-eslint/typescript-estree': 8.60.1(typescript@5.9.3)
       '@typescript-eslint/visitor-keys': 8.60.1
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 8.57.1
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -17056,7 +18640,7 @@ snapshots:
     dependencies:
       '@typescript-eslint/tsconfig-utils': 8.60.1(typescript@5.9.3)
       '@typescript-eslint/types': 8.60.1
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
@@ -17075,7 +18659,7 @@ snapshots:
       '@typescript-eslint/types': 8.60.1
       '@typescript-eslint/typescript-estree': 8.60.1(typescript@5.9.3)
       '@typescript-eslint/utils': 8.60.1(eslint@8.57.1)(typescript@5.9.3)
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 8.57.1
       ts-api-utils: 2.5.0(typescript@5.9.3)
       typescript: 5.9.3
@@ -17090,7 +18674,7 @@ snapshots:
       '@typescript-eslint/tsconfig-utils': 8.60.1(typescript@5.9.3)
       '@typescript-eslint/types': 8.60.1
       '@typescript-eslint/visitor-keys': 8.60.1
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       minimatch: 10.2.5
       semver: 7.8.2
       tinyglobby: 0.2.17
@@ -17379,7 +18963,7 @@ snapshots:
 
   agent-base@6.0.2:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -17432,11 +19016,6 @@ snapshots:
       amqplib: 0.10.9
       promise-breaker: 6.0.0
 
-  amqp-connection-manager@5.0.0(amqplib@0.10.9):
-    dependencies:
-      amqplib: 0.10.9
-      promise-breaker: 6.0.0
-
   amqp-connection-manager@5.0.0(amqplib@2.0.1):
     dependencies:
       amqplib: 2.0.1
@@ -17893,6 +19472,16 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  babel-plugin-styled-components@2.3.0(styled-components@5.3.11(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6))(supports-color@5.5.0):
+    dependencies:
+      '@babel/helper-annotate-as-pure': 7.29.7
+      '@babel/helper-module-imports': 7.29.7(supports-color@5.5.0)
+      '@babel/plugin-syntax-jsx': 7.29.7(@babel/core@7.29.7)
+      picomatch: 4.0.4
+      styled-components: 5.3.11(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6)
+    transitivePeerDependencies:
+      - supports-color
+
   babel-polyfill@6.26.0:
     dependencies:
       babel-runtime: 6.26.0
@@ -17929,6 +19518,8 @@ snapshots:
       core-js: 2.6.12
       regenerator-runtime: 0.11.1
 
+  bail@2.0.2: {}
+
   balanced-match@1.0.2: {}
 
   balanced-match@4.0.4: {}
@@ -18046,7 +19637,7 @@ snapshots:
     dependencies:
       bytes: 3.1.2
       content-type: 1.0.5
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       http-errors: 2.0.1
       iconv-lite: 0.7.2
       on-finished: 2.4.1
@@ -18222,6 +19813,8 @@ snapshots:
 
   caseless@0.12.0: {}
 
+  ccount@2.0.1: {}
+
   cfb@1.2.2:
     dependencies:
       adler-32: 1.3.1
@@ -18258,6 +19851,14 @@ snapshots:
 
   char-regex@1.0.2: {}
 
+  character-entities-html4@2.1.0: {}
+
+  character-entities-legacy@3.0.0: {}
+
+  character-entities@2.0.2: {}
+
+  character-reference-invalid@2.0.1: {}
+
   chardet@2.1.1: {}
 
   check-error@2.1.3: {}
@@ -18385,6 +19986,13 @@ snapshots:
 
   clsx@2.1.1: {}
 
+  cm6-theme-basic-light@0.2.0(@codemirror/language@6.12.4)(@codemirror/state@6.7.1)(@codemirror/view@6.43.8)(@lezer/highlight@1.2.3):
+    dependencies:
+      '@codemirror/language': 6.12.4
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+      '@lezer/highlight': 1.2.3
+
   cmdk@1.1.1(@types/react-dom@18.3.7(@types/react@18.3.31))(@types/react@18.3.31)(react-dom@19.2.6(react@19.2.6))(react@19.2.6):
     dependencies:
       '@radix-ui/react-compose-refs': 1.1.3(@types/react@18.3.31)(react@19.2.6)
@@ -18403,6 +20011,16 @@ snapshots:
 
   code-point-at@1.1.0: {}
 
+  codemirror@6.0.2:
+    dependencies:
+      '@codemirror/autocomplete': 6.20.3
+      '@codemirror/commands': 6.10.4
+      '@codemirror/language': 6.12.4
+      '@codemirror/lint': 6.9.7
+      '@codemirror/search': 6.7.1
+      '@codemirror/state': 6.7.1
+      '@codemirror/view': 6.43.8
+
   codepage@1.15.0: {}
 
   collect-v8-coverage@1.0.3: {}
@@ -18433,6 +20051,8 @@ snapshots:
     dependencies:
       delayed-stream: 1.0.0
 
+  comma-separated-tokens@2.0.3: {}
+
   commander@11.1.0: {}
 
   commander@13.1.0: {}
@@ -18466,6 +20086,8 @@ snapshots:
       normalize-path: 3.0.0
       readable-stream: 3.6.2
 
+  compute-scroll-into-view@2.0.4: {}
+
   concat-map@0.0.1: {}
 
   concat-stream@2.0.0:
@@ -18603,6 +20225,8 @@ snapshots:
 
   create-require@1.1.1: {}
 
+  crelt@1.0.7: {}
+
   cron@4.4.0:
     dependencies:
       '@types/luxon': 3.7.1
@@ -18820,6 +20444,10 @@ snapshots:
 
   decimal.js@10.6.0: {}
 
+  decode-named-character-reference@1.3.0:
+    dependencies:
+      character-entities: 2.0.2
+
   decode-uri-component@0.2.2: {}
 
   dedent@1.7.2(babel-plugin-macros@3.1.0):
@@ -18902,6 +20530,10 @@ snapshots:
 
   detect-node-es@1.1.0: {}
 
+  devlop@1.1.0:
+    dependencies:
+      dequal: 2.0.3
+
   devtools-protocol@0.0.1608973: {}
 
   dezalgo@1.0.4:
@@ -18917,6 +20549,8 @@ snapshots:
 
   diff@4.0.4: {}
 
+  diff@5.2.2: {}
+
   diff@8.0.4: {}
 
   dijkstrajs@1.0.3: {}
@@ -18979,6 +20613,15 @@ snapshots:
 
   dotenv@17.4.2: {}
 
+  downshift@7.6.2(react@19.2.6):
+    dependencies:
+      '@babel/runtime': 7.29.7
+      compute-scroll-into-view: 2.0.4
+      prop-types: 15.8.1
+      react: 19.2.6
+      react-is: 17.0.2
+      tslib: 2.8.1
+
   dunder-proto@1.0.1:
     dependencies:
       call-bind-apply-helpers: 1.0.2
@@ -19043,7 +20686,7 @@ snapshots:
   engine.io-client@6.6.5:
     dependencies:
       '@socket.io/component-emitter': 3.1.2
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       engine.io-parser: 5.2.3
       ws: 8.20.1
       xmlhttprequest-ssl: 2.1.2
@@ -19063,7 +20706,7 @@ snapshots:
       base64id: 2.0.0
       cookie: 0.7.2
       cors: 2.8.6
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       engine.io-parser: 5.2.3
       ws: 8.21.0
     transitivePeerDependencies:
@@ -19249,6 +20892,8 @@ snapshots:
 
   escape-string-regexp@4.0.0: {}
 
+  escape-string-regexp@5.0.0: {}
+
   escodegen@2.1.0:
     dependencies:
       esprima: 4.0.1
@@ -19292,7 +20937,7 @@ snapshots:
   eslint-import-resolver-typescript@3.10.1(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.60.1(eslint@8.57.1)(typescript@5.9.3))(eslint@8.57.1))(eslint@8.57.1):
     dependencies:
       '@nolyfill/is-core-module': 1.0.39
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 8.57.1
       get-tsconfig: 4.14.0
       is-bun-module: 2.0.0
@@ -19420,7 +21065,7 @@ snapshots:
       ajv: 6.15.0
       chalk: 4.1.2
       cross-spawn: 7.0.6
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       doctrine: 3.0.0
       escape-string-regexp: 4.0.0
       eslint-scope: 7.2.2
@@ -19470,6 +21115,13 @@ snapshots:
 
   estraverse@5.3.0: {}
 
+  estree-util-is-identifier-name@3.0.0: {}
+
+  estree-util-visit@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/unist': 3.0.3
+
   estree-walker@3.0.3:
     dependencies:
       '@types/estree': 1.0.9
@@ -19650,7 +21302,7 @@ snapshots:
       content-type: 1.0.5
       cookie: 0.7.2
       cookie-signature: 1.2.2
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       depd: 2.0.0
       encodeurl: 2.0.0
       escape-html: 1.0.3
@@ -19703,7 +21355,7 @@ snapshots:
 
   extract-zip@2.0.1:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       get-stream: 5.2.0
       yauzl: 2.10.0
     optionalDependencies:
@@ -19774,6 +21426,10 @@ snapshots:
     dependencies:
       reusify: 1.1.0
 
+  fault@2.0.1:
+    dependencies:
+      format: 0.2.2
+
   fb-watchman@2.0.2:
     dependencies:
       bser: 2.1.1
@@ -19854,7 +21510,7 @@ snapshots:
 
   finalhandler@2.1.1:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       encodeurl: 2.0.0
       escape-html: 1.0.3
       on-finished: 2.4.1
@@ -19947,6 +21603,8 @@ snapshots:
       hasown: 2.0.4
       mime-types: 2.1.35
 
+  format@0.2.2: {}
+
   formdata-polyfill@4.0.10:
     dependencies:
       fetch-blob: 3.2.0
@@ -20100,7 +21758,7 @@ snapshots:
     dependencies:
       basic-ftp: 5.3.1
       data-uri-to-buffer: 6.0.2
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -20306,6 +21964,30 @@ snapshots:
     dependencies:
       function-bind: 1.1.2
 
+  hast-util-to-jsx-runtime@2.3.6:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/hast': 3.0.5
+      '@types/unist': 3.0.3
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      hast-util-whitespace: 3.0.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      style-to-js: 1.1.21
+      unist-util-position: 5.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  hast-util-whitespace@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.5
+
   he@1.2.0: {}
 
   headers-polyfill@5.0.1:
@@ -20365,6 +22047,10 @@ snapshots:
       is-self-closing: 1.0.1
       kind-of: 6.0.3
 
+  html-to-image@1.11.13: {}
+
+  html-url-attributes@3.0.1: {}
+
   html2canvas@1.4.1:
     dependencies:
       css-line-break: 2.1.0
@@ -20381,7 +22067,7 @@ snapshots:
   http-proxy-agent@7.0.2:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -20394,14 +22080,14 @@ snapshots:
   https-proxy-agent@5.0.1:
     dependencies:
       agent-base: 6.0.2
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
   https-proxy-agent@7.0.6:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -20486,6 +22172,8 @@ snapshots:
 
   ini@4.1.1: {}
 
+  inline-style-parser@0.2.7: {}
+
   input-format@0.3.14(react-dom@19.2.6(react@19.2.6))(react@19.2.6):
     dependencies:
       prop-types: 15.8.1
@@ -20528,6 +22216,13 @@ snapshots:
     dependencies:
       hasown: 2.0.4
 
+  is-alphabetical@2.0.1: {}
+
+  is-alphanumerical@2.0.1:
+    dependencies:
+      is-alphabetical: 2.0.1
+      is-decimal: 2.0.1
+
   is-arguments@1.2.0:
     dependencies:
       call-bound: 1.0.4
@@ -20589,6 +22284,8 @@ snapshots:
       call-bound: 1.0.4
       has-tostringtag: 1.0.2
 
+  is-decimal@2.0.1: {}
+
   is-descriptor@0.1.8:
     dependencies:
       is-accessor-descriptor: 1.0.2
@@ -20645,6 +22342,8 @@ snapshots:
     dependencies:
       is-extglob: 2.1.1
 
+  is-hexadecimal@2.0.1: {}
+
   is-in-ssh@1.0.0: {}
 
   is-inside-container@1.0.0:
@@ -20794,6 +22493,8 @@ snapshots:
 
   isobject@3.0.1: {}
 
+  isomorphic.js@0.2.5: {}
+
   isstream@0.1.2: {}
 
   istanbul-lib-coverage@3.2.2: {}
@@ -20826,7 +22527,7 @@ snapshots:
 
   istanbul-lib-source-maps@4.0.1:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       istanbul-lib-coverage: 3.2.2
       source-map: 0.6.1
     transitivePeerDependencies:
@@ -21221,6 +22922,10 @@ snapshots:
     dependencies:
       argparse: 2.0.1
 
+  js-yaml@4.3.0:
+    dependencies:
+      argparse: 2.0.1
+
   jsbn@0.1.1: {}
 
   jsdom@25.0.1:
@@ -21399,6 +23104,16 @@ snapshots:
       prelude-ls: 1.2.1
       type-check: 0.4.0
 
+  lexical@0.48.0(typescript@5.9.3):
+    dependencies:
+      '@lexical/internal': 0.48.0(typescript@5.9.3)
+    optionalDependencies:
+      typescript: 5.9.3
+
+  lib0@0.2.117:
+    dependencies:
+      isomorphic.js: 0.2.5
+
   libphonenumber-js@1.13.6: {}
 
   libreoffice-convert@1.8.1:
@@ -21472,7 +23187,7 @@ snapshots:
     dependencies:
       chalk: 5.6.2
       commander: 13.1.0
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       execa: 8.0.1
       lilconfig: 3.1.3
       listr2: 8.3.3
@@ -21648,6 +23363,8 @@ snapshots:
       isobject: 3.0.1
       log-utils: 0.2.1
 
+  longest-streak@3.1.0: {}
+
   loose-envify@1.4.0:
     dependencies:
       js-tokens: 4.0.0
@@ -21730,8 +23447,165 @@ snapshots:
     dependencies:
       object-visit: 1.0.1
 
+  markdown-table@3.0.4: {}
+
   math-intrinsics@1.1.0: {}
 
+  mdast-util-directive@3.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      parse-entities: 4.0.2
+      stringify-entities: 4.0.4
+      unist-util-visit-parents: 6.0.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-from-markdown@2.0.3:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      mdast-util-to-string: 4.0.0
+      micromark: 4.0.2
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-decode-string: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-stringify-position: 4.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-frontmatter@2.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      escape-string-regexp: 5.0.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      micromark-extension-frontmatter: 2.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-strikethrough@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-table@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      markdown-table: 3.0.4
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-highlight-mark@1.2.2:
+    dependencies:
+      micromark-extension-highlight-mark: 1.2.0
+
+  mdast-util-mdx-expression@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-jsx@3.2.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      parse-entities: 4.0.2
+      stringify-entities: 4.0.4
+      unist-util-stringify-position: 4.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx@3.0.0:
+    dependencies:
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdxjs-esm@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-phrasing@4.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      unist-util-is: 6.0.1
+
+  mdast-util-to-hast@13.2.1:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      '@ungap/structured-clone': 1.3.1
+      devlop: 1.1.0
+      micromark-util-sanitize-uri: 2.0.1
+      trim-lines: 3.0.1
+      unist-util-position: 5.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+
+  mdast-util-to-markdown@2.1.2:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      longest-streak: 3.1.0
+      mdast-util-phrasing: 4.1.0
+      mdast-util-to-string: 4.0.0
+      micromark-util-classify-character: 2.0.1
+      micromark-util-decode-string: 2.0.1
+      unist-util-visit: 5.1.0
+      zwitch: 2.0.4
+
+  mdast-util-to-string@4.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+
   mdn-data@2.0.14: {}
 
   media-engine@1.0.3: {}
@@ -21762,6 +23636,263 @@ snapshots:
 
   methods@1.1.2: {}
 
+  micromark-core-commonmark@2.0.3:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-factory-destination: 2.0.1
+      micromark-factory-label: 2.0.1
+      micromark-factory-space: 2.0.1
+      micromark-factory-title: 2.0.1
+      micromark-factory-whitespace: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-html-tag-name: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-directive@3.0.2:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-factory-whitespace: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      parse-entities: 4.0.2
+
+  micromark-extension-frontmatter@2.0.0:
+    dependencies:
+      fault: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-table@2.1.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-highlight-mark@1.2.0:
+    dependencies:
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      uvu: 0.5.6
+
+  micromark-extension-mdx-expression@3.0.1:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdx-jsx@3.0.2:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      vfile-message: 4.0.3
+
+  micromark-extension-mdx-md@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-extension-mdxjs@3.0.0:
+    dependencies:
+      acorn: 8.16.0
+      acorn-jsx: 5.3.2(acorn@8.16.0)
+      micromark-extension-mdx-expression: 3.0.1
+      micromark-extension-mdx-jsx: 3.0.2
+      micromark-extension-mdx-md: 2.0.0
+      micromark-extension-mdxjs-esm: 3.0.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-destination@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-label@2.0.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-mdx-expression@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-factory-space@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-title@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-whitespace@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-character@2.1.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-chunked@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-classify-character@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-combine-extensions@2.0.1:
+    dependencies:
+      micromark-util-chunked: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-decode-string@2.0.1:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      micromark-util-character: 2.1.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-encode@2.0.1: {}
+
+  micromark-util-events-to-acorn@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/unist': 3.0.3
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      vfile-message: 4.0.3
+
+  micromark-util-html-tag-name@2.0.1: {}
+
+  micromark-util-normalize-identifier@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-resolve-all@2.0.1:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-util-sanitize-uri@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-encode: 2.0.1
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-subtokenize@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-symbol@2.0.1: {}
+
+  micromark-util-types@2.0.2: {}
+
+  micromark@4.0.2:
+    dependencies:
+      '@types/debug': 4.1.13
+      debug: 4.4.3(supports-color@8.1.1)
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-encode: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+    transitivePeerDependencies:
+      - supports-color
+
   micromatch@3.1.10:
     dependencies:
       arr-diff: 4.0.0
@@ -22269,7 +24400,7 @@ snapshots:
     dependencies:
       '@tootallnate/quickjs-emscripten': 0.23.0
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       get-uri: 6.0.5
       http-proxy-agent: 7.0.2
       https-proxy-agent: 7.0.6
@@ -22297,6 +24428,16 @@ snapshots:
     dependencies:
       callsites: 3.1.0
 
+  parse-entities@4.0.2:
+    dependencies:
+      '@types/unist': 2.0.11
+      character-entities-legacy: 3.0.0
+      character-reference-invalid: 2.0.1
+      decode-named-character-reference: 1.3.0
+      is-alphanumerical: 2.0.1
+      is-decimal: 2.0.1
+      is-hexadecimal: 2.0.1
+
   parse-json@5.2.0:
     dependencies:
       '@babel/code-frame': 7.29.7
@@ -22599,6 +24740,8 @@ snapshots:
       object-assign: 4.1.1
       react-is: 16.13.1
 
+  property-information@7.2.0: {}
+
   proxy-addr@2.0.7:
     dependencies:
       forwarded: 0.2.0
@@ -22607,7 +24750,7 @@ snapshots:
   proxy-agent@6.5.0:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       http-proxy-agent: 7.0.2
       https-proxy-agent: 7.0.6
       lru-cache: 7.18.3
@@ -22636,7 +24779,7 @@ snapshots:
     dependencies:
       '@puppeteer/browsers': 2.13.2
       chromium-bidi: 14.0.0(devtools-protocol@0.0.1608973)
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       devtools-protocol: 0.0.1608973
       typed-query-selector: 2.12.2
       webdriver-bidi-protocol: 0.4.1
@@ -22889,6 +25032,15 @@ snapshots:
       - '@babel/core'
       - react-is
 
+  react-css-nocode-editor@1.0.13(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6):
+    dependencies:
+      react: 19.2.6
+      react-dom: 19.2.6(react@19.2.6)
+      styled-components: 5.3.11(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6)
+    transitivePeerDependencies:
+      - '@babel/core'
+      - react-is
+
   react-day-picker@8.10.2(date-fns@3.6.0)(react@19.2.6):
     dependencies:
       date-fns: 3.6.0
@@ -22980,10 +25132,30 @@ snapshots:
 
   react-is@16.13.1: {}
 
+  react-is@17.0.2: {}
+
   react-is@18.3.1: {}
 
   react-is@19.2.7: {}
 
+  react-markdown@9.1.0(@types/react@18.3.31)(react@19.2.6):
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      '@types/react': 18.3.31
+      devlop: 1.1.0
+      hast-util-to-jsx-runtime: 2.3.6
+      html-url-attributes: 3.0.1
+      mdast-util-to-hast: 13.2.1
+      react: 19.2.6
+      remark-parse: 11.0.0
+      remark-rehype: 11.1.2
+      unified: 11.0.5
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+    transitivePeerDependencies:
+      - supports-color
+
   react-number-format@5.4.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
     dependencies:
       react: 18.3.1
@@ -23327,6 +25499,23 @@ snapshots:
     dependencies:
       isobject: 2.1.0
 
+  remark-parse@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.0.3
+      micromark-util-types: 2.0.2
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-rehype@11.1.2:
+    dependencies:
+      '@types/hast': 3.0.5
+      '@types/mdast': 4.0.4
+      mdast-util-to-hast: 13.2.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
   remarkable@1.7.4:
     dependencies:
       argparse: 1.0.10
@@ -23462,7 +25651,7 @@ snapshots:
 
   router@2.2.0:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       depd: 2.0.0
       is-promise: 4.0.0
       parseurl: 1.3.3
@@ -23494,6 +25683,10 @@ snapshots:
     dependencies:
       tslib: 2.8.1
 
+  sade@1.8.1:
+    dependencies:
+      mri: 1.2.0
+
   safe-array-concat@1.1.4:
     dependencies:
       call-bind: 1.0.9
@@ -23580,7 +25773,7 @@ snapshots:
 
   send@1.2.1:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       encodeurl: 2.0.0
       escape-html: 1.0.3
       etag: 1.8.1
@@ -23796,7 +25989,7 @@ snapshots:
 
   socket.io-adapter@2.5.8:
     dependencies:
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       ws: 8.21.0
     transitivePeerDependencies:
       - bufferutil
@@ -23806,7 +25999,7 @@ snapshots:
   socket.io-client@4.8.3:
     dependencies:
       '@socket.io/component-emitter': 3.1.2
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       engine.io-client: 6.6.5
       socket.io-parser: 4.2.6
     transitivePeerDependencies:
@@ -23817,7 +26010,7 @@ snapshots:
   socket.io-parser@4.2.6:
     dependencies:
       '@socket.io/component-emitter': 3.1.2
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -23826,7 +26019,7 @@ snapshots:
       accepts: 1.3.8
       base64id: 2.0.0
       cors: 2.8.6
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       engine.io: 6.6.9
       socket.io-adapter: 2.5.8
       socket.io-parser: 4.2.6
@@ -23838,7 +26031,7 @@ snapshots:
   socks-proxy-agent@8.0.5:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       socks: 2.8.9
     transitivePeerDependencies:
       - supports-color
@@ -23883,6 +26076,8 @@ snapshots:
 
   source-map@0.7.6: {}
 
+  space-separated-tokens@2.0.2: {}
+
   split-on-first@1.1.0: {}
 
   split-string@3.1.0:
@@ -24053,6 +26248,11 @@ snapshots:
     dependencies:
       safe-buffer: 5.2.1
 
+  stringify-entities@4.0.4:
+    dependencies:
+      character-entities-html4: 2.1.0
+      character-entities-legacy: 3.0.0
+
   stringify-object@5.0.0:
     dependencies:
       get-own-enumerable-keys: 1.0.0
@@ -24096,8 +26296,18 @@ snapshots:
       '@tokenizer/token': 0.3.0
       peek-readable: 5.4.2
 
+  style-mod@4.1.3: {}
+
   style-object-to-css-string@1.1.3: {}
 
+  style-to-js@1.1.21:
+    dependencies:
+      style-to-object: 1.0.14
+
+  style-to-object@1.0.14:
+    dependencies:
+      inline-style-parser: 0.2.7
+
   styled-components@5.3.11(@babel/core@7.29.7)(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6):
     dependencies:
       '@babel/helper-module-imports': 7.29.7(supports-color@5.5.0)
@@ -24116,6 +26326,24 @@ snapshots:
     transitivePeerDependencies:
       - '@babel/core'
 
+  styled-components@5.3.11(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6):
+    dependencies:
+      '@babel/helper-module-imports': 7.29.7(supports-color@5.5.0)
+      '@babel/traverse': 7.29.7(supports-color@5.5.0)
+      '@emotion/is-prop-valid': 1.4.0
+      '@emotion/stylis': 0.8.5
+      '@emotion/unitless': 0.7.5
+      babel-plugin-styled-components: 2.3.0(styled-components@5.3.11(react-dom@19.2.6(react@19.2.6))(react-is@19.2.7)(react@19.2.6))(supports-color@5.5.0)
+      css-to-react-native: 3.2.0
+      hoist-non-react-statics: 3.3.2
+      react: 19.2.6
+      react-dom: 19.2.6(react@19.2.6)
+      react-is: 19.2.7
+      shallowequal: 1.1.0
+      supports-color: 5.5.0
+    transitivePeerDependencies:
+      - '@babel/core'
+
   styled-jsx@5.1.1(babel-plugin-macros@3.1.0)(react@18.3.1):
     dependencies:
       client-only: 0.0.1
@@ -24141,7 +26369,7 @@ snapshots:
     dependencies:
       component-emitter: 1.3.1
       cookiejar: 2.1.4
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       fast-safe-stringify: 2.1.1
       form-data: 4.0.5
       formidable: 3.5.4
@@ -24441,6 +26669,10 @@ snapshots:
 
   trim-canvas@0.1.2: {}
 
+  trim-lines@3.0.1: {}
+
+  trough@2.2.0: {}
+
   ts-api-utils@2.5.0(typescript@5.9.3):
     dependencies:
       typescript: 5.9.3
@@ -24650,7 +26882,7 @@ snapshots:
       app-root-path: 3.1.0
       buffer: 6.0.3
       dayjs: 1.11.21
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       dedent: 1.7.2(babel-plugin-macros@3.1.0)
       dotenv: 16.6.1
       glob: 10.5.0
@@ -24674,7 +26906,7 @@ snapshots:
       app-root-path: 3.1.0
       buffer: 6.0.3
       dayjs: 1.11.21
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       dedent: 1.7.2(babel-plugin-macros@3.1.0)
       dotenv: 16.6.1
       glob: 10.5.0
@@ -24727,6 +26959,20 @@ snapshots:
 
   unicorn-magic@0.3.0: {}
 
+  unidiff@1.0.4:
+    dependencies:
+      diff: 5.2.2
+
+  unified@11.0.5:
+    dependencies:
+      '@types/unist': 3.0.3
+      bail: 2.0.2
+      devlop: 1.1.0
+      extend: 3.0.2
+      is-plain-obj: 4.1.0
+      trough: 2.2.0
+      vfile: 6.0.3
+
   union-value@1.0.1:
     dependencies:
       arr-union: 3.1.0
@@ -24734,6 +26980,33 @@ snapshots:
       is-extendable: 0.1.1
       set-value: 2.0.1
 
+  unist-util-is@6.0.1:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-position-from-estree@2.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-stringify-position@4.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-visit-parents@6.0.2:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+
+  unist-util-visit@5.1.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
   universal-cookie@8.1.2:
     dependencies:
       cookie: 1.1.1
@@ -24905,6 +27178,13 @@ snapshots:
 
   uuid@8.3.2: {}
 
+  uvu@0.5.6:
+    dependencies:
+      dequal: 2.0.3
+      diff: 5.2.2
+      kleur: 4.1.5
+      sade: 1.8.1
+
   v8-compile-cache-lib@3.0.1: {}
 
   v8-to-istanbul@9.3.0:
@@ -24934,6 +27214,16 @@ snapshots:
       core-util-is: 1.0.2
       extsprintf: 1.3.0
 
+  vfile-message@4.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-stringify-position: 4.0.0
+
+  vfile@6.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      vfile-message: 4.0.3
+
   victory-vendor@36.9.2:
     dependencies:
       '@types/d3-array': 3.2.2
@@ -24977,7 +27267,7 @@ snapshots:
   vite-node@2.1.9(@types/node@22.20.1)(lightningcss@1.32.0)(terser@5.48.0):
     dependencies:
       cac: 6.7.14
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       es-module-lexer: 1.7.0
       pathe: 1.1.2
       vite: 5.4.21(@types/node@22.20.1)(lightningcss@1.32.0)(terser@5.48.0)
@@ -24995,7 +27285,7 @@ snapshots:
   vite-node@2.1.9(@types/node@24.13.1)(lightningcss@1.32.0)(terser@5.48.0):
     dependencies:
       cac: 6.7.14
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       es-module-lexer: 1.7.0
       pathe: 1.1.2
       vite: 5.4.21(@types/node@24.13.1)(lightningcss@1.32.0)(terser@5.48.0)
@@ -25042,7 +27332,7 @@ snapshots:
       '@vitest/spy': 2.1.9
       '@vitest/utils': 2.1.9
       chai: 5.3.3
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       expect-type: 1.3.0
       magic-string: 0.30.21
       pathe: 1.1.2
@@ -25078,7 +27368,7 @@ snapshots:
       '@vitest/spy': 2.1.9
       '@vitest/utils': 2.1.9
       chai: 5.3.3
-      debug: 4.4.3(supports-color@5.5.0)
+      debug: 4.4.3(supports-color@8.1.1)
       expect-type: 1.3.0
       magic-string: 0.30.21
       pathe: 1.1.2
@@ -25119,6 +27409,8 @@ snapshots:
       strip-ansi: 3.0.1
       wrap-ansi: 2.1.0
 
+  w3c-keyname@2.2.8: {}
+
   w3c-xmlserializer@5.0.0:
     dependencies:
       xml-name-validator: 5.0.0
@@ -25411,6 +27703,10 @@ snapshots:
 
   year@0.2.1: {}
 
+  yjs@13.6.32:
+    dependencies:
+      lib0: 0.2.117
+
   yn@3.1.1: {}
 
   yocto-queue@0.1.0: {}
@@ -25454,3 +27750,5 @@ snapshots:
       immer: 11.1.8
       react: 19.2.6
       use-sync-external-store: 1.6.0(react@19.2.6)
+
+  zwitch@2.0.4: {}
diff --git a/portal-content-contact.png b/portal-content-contact.png
new file mode 100644
index 000000000..dfbf73fc5
Binary files /dev/null and b/portal-content-contact.png differ
diff --git a/scripts/deploy/sync-env-from-env-manager.sh b/scripts/deploy/sync-env-from-env-manager.sh
index 6a405ab28..0835f86d9 100644
--- a/scripts/deploy/sync-env-from-env-manager.sh
+++ b/scripts/deploy/sync-env-from-env-manager.sh
@@ -29,6 +29,12 @@ declare -A SERVICE_ENV_TARGET=(
   ["passenger_portal"]="apps/edr-passenger-web/portal/.env"
   ["passenger_backoffice"]="apps/edr-passenger-web/backoffice/.env"
   ["payment_api"]="apps/edr-payment-api/.env"
+  ["synapse"]="infrastructure/matrix/synapse/.env"
+  # element_web holds no secrets, but its config.json is rendered at container
+  # start from MATRIX_PUBLIC_BASEURL / MATRIX_SERVER_NAME / ELEMENT_PUBLIC_URL
+  # (see infrastructure/matrix/element), so it needs an env file like the rest —
+  # plus the PORT line every service env is required to carry.
+  ["element_web"]="infrastructure/matrix/element/.env"
 )
 
 for service in "$@"; do
diff --git a/scripts/deploy/sync-env-from-server.sh b/scripts/deploy/sync-env-from-server.sh
index 69f7eef56..4fb7fbe6b 100644
--- a/scripts/deploy/sync-env-from-server.sh
+++ b/scripts/deploy/sync-env-from-server.sh
@@ -31,6 +31,11 @@ declare -A SERVICE_ENV_TARGET=(
   ["passenger-portal"]="apps/edr-passenger-web/portal/.env"
   ["passenger-backoffice"]="apps/edr-passenger-web/backoffice/.env"
   ["payment-api"]="apps/edr-payment-api/.env"
+  ["synapse"]="infrastructure/matrix/synapse/.env"
+  # element-web holds no secrets, but its config.json is rendered at container
+  # start from MATRIX_PUBLIC_BASEURL / MATRIX_SERVER_NAME / ELEMENT_PUBLIC_URL,
+  # and the sync step needs a PORT= line to compute ELEMENT_WEB_PORT anyway.
+  ["element-web"]="infrastructure/matrix/element/.env"
 )
 
 for service in "$@"; do